Pipeline Presets
Architecture notes for @ucdjs/pipeline-presets
@ucdjs/pipeline-presets provides reusable parsers, routes, resolvers, transforms, and ready-made pipelines for Unicode data processing.
Role
- Encapsulates common UCD parsing strategies and route definitions.
- Lets authors build useful pipelines quickly without recreating the standard building blocks.
- Bridges raw Unicode text formats and the generic pipeline DSL.
Related Docs
Pipeline Core
Presets are composed entirely on top of the pipeline DSL.
Pipeline Executor
Preset pipelines are common runtime inputs to the executor.
Pipeline Playground
Playground examples import these presets for realistic sample pipelines.
Codegen
Both packages transform Unicode files, but presets target pipeline execution rather than TS code emission.
Mental Model
The package is a toolbox with three levels:
- low-level parsers and resolvers
- reusable route definitions and transforms
- complete preset pipelines like
createFullPipeline()
It exists so most pipeline authors can compose, not invent.
Method Flows
createFullPipeline()
Standard route processing
Transform composition
Design Notes
- Presets should encode common Unicode patterns, not every possible pipeline style.
- Ready-made pipelines like
createFullPipeline()are intentionally opinionated. - The package keeps raw-format knowledge close to the parser/resolver layer instead of scattering it across apps.
- Authors can always drop down to pipeline-core when presets are too constraining.
Testing Use
- parser correctness for common UCD file formats
- resolver output normalization
- ready-made pipeline assembly
- transform behavior in preset routes
- compatibility with executor and playground example pipelines