@bedrock-engineer/bro-xml-parser 0.2.0 → 0.4.0

package/README.md

@@ -60,24 +60,33 @@ const bhr_g = parser.parseBHRG(xmlText);
 
 Extract only the fields you need:
 
+Build a schema from the `producers` combinators — a map of field name → producer.
+The return type is inferred from the map, so `result.depth` is `number | null`,
+`result.location` is `Location | null`, with no casts:
+
 ```typescript
-import { BROParser, XMLAdapter, resolvers } from "@bedrock-engineer/bro-xml-parser/node";
+import { BROParser, XMLAdapter, producers as p } from "@bedrock-engineer/bro-xml-parser/node";
 
 const parser = new BROParser(new XMLAdapter());
 
-const mySchema = {
-  id: { xpath: "brocom:broId" },
-  depth: { xpath: ".//cptcommon:finalDepth", resolver: resolvers.parseFloat },
-  location: {
-    xpath: "./dscpt:deliveredLocation/cptcommon:location",
-    resolver: resolvers.parseGMLLocation,
+const result = parser.parseCustom(
+  xmlText,
+  {
+    id: p.text("brocom:broId"),
+    depth: p.number_(".//cptcommon:finalDepth"),
+    location: p.gmlLocation("./dscpt:deliveredLocation/cptcommon:location"),
   },
-};
-
-const result = parser.parseCustom(xmlText, mySchema, "CPT");
-// { id: "CPT000000099543", depth: 25.5, location: { x: 155000, y: 463000, epsg: "28992" } }
+  "CPT",
+);
+// { id: "CPT000000099543", depth: 25.5, location: { x: 155000, y: 463000, epsg: "28992" }, meta: {…} }
 ```
 
+The `producers` namespace carries every building block the library uses internally:
+scalar combinators (`text`, `number_`, `integer`, `date`, `boolean_`, `qualityClass`),
+structural combinators (`object_`, `array`, `oneOf`, `custom`), the domain helpers
+(`gmlLocation`, `columns`), and the shared field-maps (`COMMON_REGISTRATION_PRODUCERS`,
+`REGISTRATION_HISTORY`) you can spread into a schema.
+
 ## API
 
 | Method                            | Returns     | Description                |
@@ -86,7 +95,7 @@ const result = parser.parseCustom(xmlText, mySchema, "CPT");
 | `parseCPT(xml)`                   | `CPTData`   | Parse CPT file             |
 | `parseBHRGT(xml)`                 | `BHRGTData` | Parse BHR-GT file          |
 | `parseBHRG(xml)`                  | `BHRGData`  | Parse BHR-G file           |
-| `parseCustom(xml, schema, type?)` | `T`         | Parse with custom schema   |
+| `parseCustom(xml, fields, type?)` | `T`         | Parse with a producer map  |
 
 See [`src/types/index.ts`](./src/types/index.ts) for full type definitions.
 

package/dist/browser.d.ts

@@ -13,15 +13,25 @@
  */
 export { BROParser } from "./parser.js";
 export { BrowserXMLAdapter as XMLAdapter } from "./adapters/browser-adapter.js";
-export type { CPTData, CPTMeasurement, BHRGTData, BHRGTLayer, Grainshape, BHRGData, BHRGLayer, BROData, BROFileType, Location, ParseMeta, Schema, SchemaField, ResolverFunction, ResolverContext, Namespaces, BoreholeSampleAnalysis, InvestigatedInterval, ParticleSizeDistributionDetermination, ConsistencyLimitsDetermination, SettlementCharacteristicsDetermination, SaturatedPermeabilityDetermination, SaturatedPermeabilityAtSpecificDensity, ShearStressChangeDuringLoadingDetermination, SettlementDeterminationStep, ShearStressAtSpecificStrain, MaximumUndrainedShearStrengthDetermination, ShearStressChangeDuringHorizontalDeformationDetermination, ConsolidationStageAtHorizontalDeformation, ConsolidationStepAtHorizontalDeformation, ShearStageAtHorizontalDeformation, HorizontalDeformationDataPoint, HeightAtSpecificConsolidationTime, DissipationTest, DissipationMeasurement, QualityRegime, PlasticityAtSpecificWaterContent, HeightAtSpecificTime, MembraneCorrection, DrainageStripCorrection, SaturationStageAtLoading, SaturationStageAtCompression, SpecimenMadeForLoading, StressAtSpecificSettlement, VolumeChangeAtSpecificTime, ConsolidationStageAtLoading, LoadStage, RemovedLayer, RegistrationHistory, ReportHistory, IntermediateEvent, BoredInterval, SamplerDetails, SampledInterval, CompletedInterval, NotDescribedInterval, WaterContentDetermination, VolumetricMassDensityDetermination, OrganicMatterContentDetermination, CarbonateContentDetermination, VolumetricMassDensityOfSolidsDetermination, } from "./types/index.js";
+export type { CPTData, CPTMeasurement, DissipationMeasurement, BHRGTData, BHRGData, GMWData, GLDData, BROData, BROFileType, Location, ParseMeta, Namespaces, QualityRegime, } from "./types/index.js";
+export type { RegistrationHistory } from "./schemas/common-fields.js";
 export { BROParseError } from "./types/index.js";
 export { SUPPORTED_VERSIONS } from "./core/version-detector.js";
 export type { DataType } from "./core/version-detector.js";
-export { CPT_SCHEMA } from "./schemas/cpt-schema.js";
-export { BORE_SCHEMA } from "./schemas/bore-schema.js";
-export { BHRG_SCHEMA } from "./schemas/bhrg-schema.js";
+export { CPT_PRODUCER } from "./schemas/cpt-schema.js";
+export type { DissipationTest, RemovedLayer } from "./schemas/cpt-schema.js";
+export { BORE_PRODUCER } from "./schemas/bore-schema.js";
+export type { BHRGTLayer, BHRGTLayerBase, BHRGTSoilLayer, BHRGTRockLayer, RockDescription, RockWeatheringDegree, Grainshape, BoredInterval, SampledInterval, SamplerDetails, CoreRecovery, CompletedInterval, PostSedimentaryDiscontinuity, ExcavatedLayer, BoringVelocityMeasurement, NotDescribedInterval, FluidMudLayer, } from "./schemas/bore-schema.js";
+export type { HeightAtSpecificTime, StressAtSpecificSettlement, VolumeChangeAtSpecificTime, ShearStressAtSpecificStrain, HorizontalDeformationDataPoint, BoreholeSampleAnalysis, InvestigatedInterval, WaterContentDetermination, VolumetricMassDensityDetermination, OrganicMatterContentDetermination, CarbonateContentDetermination, VolumetricMassDensityOfSolidsDetermination, MaximumUndrainedShearStrengthDetermination, ParticleSizeDistributionDetermination, ConsistencyLimitsDetermination, SettlementCharacteristicsDetermination, SettlementDeterminationStep, SaturationStageAtCompression, SaturatedPermeabilityDetermination, ShearStressChangeDuringLoadingDetermination, ConsolidationStepAtHorizontalDeformation, ShearStressChangeDuringHorizontalDeformationDetermination, PlasticityAtSpecificWaterContent, SaturatedPermeabilityAtSpecificDensity, SaturatedPermeabilityAtSpecificLoad, MembraneCorrection, DrainageStripCorrection, SpecimenMadeForLoading, SaturationStageAtLoading, ConsolidationStageAtLoading, LoadStage, ConsolidationStageAtHorizontalDeformation, ShearStageAtHorizontalDeformation, } from "./schemas/bhrgt-analysis.js";
+export type { GLDObservation, GLDObservationPoint, GroundwaterMonitoringTubeRef, } from "./schemas/gld-schema.js";
+export { BHRG_PRODUCER } from "./schemas/bhrg-schema.js";
+export type { BHRGLayer, MunsellColour, SandFraction, SandConstituent, ShellFraction, ShellConstituent, GravelFraction, GravelConstituent, PeatFraction, PeatConstituent, Chunk, FractionDistribution, FineFractionDistributionOrganicSoil, FineFractionDistributionShellySoil, Mottle, ThinStratum, ReportHistory, IntermediateEvent, } from "./schemas/bhrg-schema.js";
+export { GMW_PRODUCER } from "./schemas/gmw-schema.js";
+export type { MonitoringTube, GeoOhmCable, Electrode, GMWIntermediateEvent, } from "./schemas/gmw-schema.js";
+export { GLD_PRODUCER } from "./schemas/gld-schema.js";
 export { BRO_NAMESPACES, KNOWN_BRO_PREFIXES } from "./namespaces.js";
 export { BRO_SOIL_COLORS, getSoilColor, isValidSoilColor, getSoilColorNames } from "./colors.js";
-export * as resolvers from "./resolvers.js";
+export * as producers from "./producers.js";
+export type { Producer, NodeLens, Produced, ProducedFields } from "./core/producer.js";
 export * as presets from "./schema-presets.js";
 //# sourceMappingURL=browser.d.ts.map

package/dist/browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,iBAAiB,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAEhF,YAAY,EACV,OAAO,EACP,cAAc,EACd,SAAS,EACT,UAAU,EACV,UAAU,EACV,QAAQ,EACR,SAAS,EACT,OAAO,EACP,WAAW,EACX,QAAQ,EACR,SAAS,EACT,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,sBAAsB,EACtB,oBAAoB,EACpB,qCAAqC,EACrC,8BAA8B,EAC9B,sCAAsC,EACtC,kCAAkC,EAClC,sCAAsC,EACtC,2CAA2C,EAC3C,2BAA2B,EAC3B,2BAA2B,EAC3B,0CAA0C,EAC1C,yDAAyD,EACzD,yCAAyC,EACzC,wCAAwC,EACxC,iCAAiC,EACjC,8BAA8B,EAC9B,iCAAiC,EACjC,eAAe,EACf,sBAAsB,EACtB,aAAa,EACb,gCAAgC,EAChC,oBAAoB,EACpB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,4BAA4B,EAC5B,sBAAsB,EACtB,0BAA0B,EAC1B,0BAA0B,EAC1B,2BAA2B,EAC3B,SAAS,EACT,YAAY,EACZ,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,cAAc,EACd,eAAe,EACf,iBAAiB,EACjB,oBAAoB,EACpB,yBAAyB,EACzB,kCAAkC,EAClC,iCAAiC,EACjC,6BAA6B,EAC7B,0CAA0C,GAC3C,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,YAAY,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAC;AAE3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGjG,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAG5C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"browser.d.ts","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"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"}

package/dist/browser.js

@@ -15,13 +15,15 @@ export { BROParser } from "./parser.js";
 export { BrowserXMLAdapter as XMLAdapter } from "./adapters/browser-adapter.js";
 export { BROParseError } from "./types/index.js";
 export { SUPPORTED_VERSIONS } from "./core/version-detector.js";
-export { CPT_SCHEMA } from "./schemas/cpt-schema.js";
-export { BORE_SCHEMA } from "./schemas/bore-schema.js";
-export { BHRG_SCHEMA } from "./schemas/bhrg-schema.js";
+export { CPT_PRODUCER } from "./schemas/cpt-schema.js";
+export { BORE_PRODUCER } from "./schemas/bore-schema.js";
+export { BHRG_PRODUCER } from "./schemas/bhrg-schema.js";
+export { GMW_PRODUCER } from "./schemas/gmw-schema.js";
+export { GLD_PRODUCER } from "./schemas/gld-schema.js";
 export { BRO_NAMESPACES, KNOWN_BRO_PREFIXES } from "./namespaces.js";
 export { BRO_SOIL_COLORS, getSoilColor, isValidSoilColor, getSoilColorNames } from "./colors.js";
-// Export resolvers for custom schema definitions
-export * as resolvers from "./resolvers.js";
+// The authoring surface for custom schemas (combinators + domain helpers).
+export * as producers from "./producers.js";
 // Export schema presets for common use cases
 export * as presets from "./schema-presets.js";
 //# sourceMappingURL=browser.js.map

package/dist/browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,iBAAiB,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAkEhF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjG,iDAAiD;AACjD,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAE5C,6CAA6C;AAC7C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"browser.js","sourceRoot":"","sources":["../src/browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,iBAAiB,IAAI,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAmBhF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAGhE,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AA4DzD,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAqBzD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAOvD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErE,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjG,2EAA2E;AAC3E,OAAO,KAAK,SAAS,MAAM,gBAAgB,CAAC;AAK5C,6CAA6C;AAC7C,OAAO,KAAK,OAAO,MAAM,qBAAqB,CAAC"}

package/dist/core/columns.d.ts

@@ -0,0 +1,80 @@
+/**
+ * `decodeColumns` — decode BRO's column time-series (space-separated rows of
+ * comma-delimited columns: settlement steps, triaxial/direct-shear loading
+ * stages, the CPT measurement block).
+ *
+ * A caller declares a typed column spec and gets typed rows back; the −999999 /
+ * "NaN" sentinel→null rule lives here. Decodes the *content* of one leaf's CSV
+ * text; the {@link columns} producer bridges it into the tree-shaped
+ * {@link Producer} DSL.
+ */
+import type { CustomProducer } from "./producer.js";
+/** Parse one CSV cell into a typed value. */
+export type ColumnParser<V> = (raw: string) => V;
+/** One column of a CSV time-series. */
+export interface ColumnSpec<Name extends string = string, V = unknown> {
+    /** Output property name on each row object. */
+    name: Name;
+    /** Cell parser (see `col`). */
+    parse: ColumnParser<V>;
+    /**
+     * When true, a row missing this (trailing) column is still kept. By default a
+     * row with fewer cells than the number of required columns is dropped.
+     */
+    optional?: boolean;
+}
+/** Flatten an intersection into a single object literal for legible hovers. */
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/**
+ * The row object inferred from a `const` column-spec tuple. Every non-`null`
+ * column contributes a **required** key (the decoder always assigns it — `null`
+ * when the cell is absent), typed as that column's cell-parser return type.
+ * A `null` spec entry (a skipped position) contributes nothing.
+ */
+export type RowOf<Spec extends ReadonlyArray<ColumnSpec | null>> = Simplify<{
+    [S in Extract<Spec[number], ColumnSpec> as S["name"]]: ReturnType<S["parse"]>;
+}>;
+export interface DecodeColumnsOptions {
+    /** Row delimiter (default: any run of whitespace). */
+    rowSeparator?: string | RegExp;
+    /** Column delimiter within a row (default: `,`). */
+    colSeparator?: string;
+}
+/**
+ * Standard cell parsers. The −999999 sentinel and the literal "NaN" both decode
+ * to `null`.
+ */
+export declare const col: {
+    /** Decimal number, or `null` for empty / sentinel / NaN. */
+    num: (raw: string) => number | null;
+    /** Integer, or `null` for empty / sentinel / NaN. */
+    int: (raw: string) => number | null;
+    /** Trimmed string, or `null` when empty. */
+    str: (raw: string) => string | null;
+    /** Boolean, understanding BRO's `ja`/`nee`. */
+    bool: (raw: string) => boolean | null;
+};
+/**
+ * Decode CSV text into typed row objects per a column spec.
+ *
+ * Rows are split on {@link DecodeColumnsOptions.rowSeparator} (default:
+ * whitespace) and cells on {@link DecodeColumnsOptions.colSeparator} (default:
+ * `,`). Each column is parsed positionally (a missing trailing cell yields
+ * `null`); a `null` entry in `columns` skips that position (for column masks
+ * where only some positions are wanted). A row with fewer cells than the number
+ * of required (non-`optional`, non-skipped) columns is dropped as malformed.
+ */
+export declare function decodeColumns<T>(text: string | null | undefined, columns: ReadonlyArray<ColumnSpec | null>, options?: DecodeColumnsOptions): Array<T>;
+/**
+ * A {@link Producer} that reads the CSV text at `valuesAt` (relative to the
+ * enclosing node) and decodes it with `decodeColumns`. Yields `[]` when the
+ * values element is absent.
+ *
+ * The row type is **inferred** from the (`as const`) `spec` — each column's name
+ * and cell-parser return type — so callers no longer declare it by hand.
+ */
+export declare function columns<const Spec extends ReadonlyArray<ColumnSpec | null>>(valuesAt: string, spec: Spec, options?: DecodeColumnsOptions): CustomProducer<Array<RowOf<Spec>>>;
+export {};
+//# sourceMappingURL=columns.d.ts.map

package/dist/core/columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.d.ts","sourceRoot":"","sources":["../../src/core/columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAGpD,6CAA6C;AAC7C,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,KAAK,CAAC,CAAC;AAEjD,uCAAuC;AACvC,MAAM,WAAW,UAAU,CAAC,IAAI,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,GAAG,OAAO;IACnE,+CAA+C;IAC/C,IAAI,EAAE,IAAI,CAAC;IACX,+BAA+B;IAC/B,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,+EAA+E;AAC/E,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAAE,GAAG,EAAE,CAAC;AAEjD;;;;;GAKG;AACH,MAAM,MAAM,KAAK,CAAC,IAAI,SAAS,aAAa,CAAC,UAAU,GAAG,IAAI,CAAC,IAAI,QAAQ,CAAC;KACzE,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;CAC9E,CAAC,CAAC;AAEH,MAAM,WAAW,oBAAoB;IACnC,sDAAsD;IACtD,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC/B,oDAAoD;IACpD,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,eAAO,MAAM,GAAG;IACd,4DAA4D;eACjD,MAAM,KAAG,MAAM,GAAG,IAAI;IAQjC,qDAAqD;eAC1C,MAAM,KAAG,MAAM,GAAG,IAAI;IAQjC,4CAA4C;eACjC,MAAM,KAAG,MAAM,GAAG,IAAI;IAIjC,+CAA+C;gBACnC,MAAM,KAAG,OAAO,GAAG,IAAI;CACpC,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAC/B,OAAO,EAAE,aAAa,CAAC,UAAU,GAAG,IAAI,CAAC,EACzC,OAAO,GAAE,oBAAyB,GACjC,KAAK,CAAC,CAAC,CAAC,CAiCV;AAED;;;;;;;GAOG;AACH,wBAAgB,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,aAAa,CAAC,UAAU,GAAG,IAAI,CAAC,EACzE,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,IAAI,EACV,OAAO,CAAC,EAAE,oBAAoB,GAC7B,cAAc,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAIpC"}

package/dist/core/columns.js

@@ -0,0 +1,100 @@
+/**
+ * `decodeColumns` — decode BRO's column time-series (space-separated rows of
+ * comma-delimited columns: settlement steps, triaxial/direct-shear loading
+ * stages, the CPT measurement block).
+ *
+ * A caller declares a typed column spec and gets typed rows back; the −999999 /
+ * "NaN" sentinel→null rule lives here. Decodes the *content* of one leaf's CSV
+ * text; the {@link columns} producer bridges it into the tree-shaped
+ * {@link Producer} DSL.
+ */
+import { SENTINEL } from "../decoders/constants.js";
+import { parseBoolean } from "../decoders/type-decoders.js";
+import { custom } from "./producer.js";
+/**
+ * Standard cell parsers. The −999999 sentinel and the literal "NaN" both decode
+ * to `null`.
+ */
+export const col = {
+    /** Decimal number, or `null` for empty / sentinel / NaN. */
+    num: (raw) => {
+        const trimmed = raw.trim();
+        if (trimmed === "") {
+            return null;
+        }
+        const n = Number.parseFloat(trimmed);
+        return n === SENTINEL || isNaN(n) ? null : n;
+    },
+    /** Integer, or `null` for empty / sentinel / NaN. */
+    int: (raw) => {
+        const trimmed = raw.trim();
+        if (trimmed === "") {
+            return null;
+        }
+        const n = Number.parseInt(trimmed, 10);
+        return n === SENTINEL || isNaN(n) ? null : n;
+    },
+    /** Trimmed string, or `null` when empty. */
+    str: (raw) => {
+        const trimmed = raw.trim();
+        return trimmed === "" ? null : trimmed;
+    },
+    /** Boolean, understanding BRO's `ja`/`nee`. */
+    bool: (raw) => parseBoolean(raw),
+};
+/**
+ * Decode CSV text into typed row objects per a column spec.
+ *
+ * Rows are split on {@link DecodeColumnsOptions.rowSeparator} (default:
+ * whitespace) and cells on {@link DecodeColumnsOptions.colSeparator} (default:
+ * `,`). Each column is parsed positionally (a missing trailing cell yields
+ * `null`); a `null` entry in `columns` skips that position (for column masks
+ * where only some positions are wanted). A row with fewer cells than the number
+ * of required (non-`optional`, non-skipped) columns is dropped as malformed.
+ */
+export function decodeColumns(text, columns, options = {}) {
+    if (!text) {
+        return [];
+    }
+    const trimmed = text.trim();
+    if (trimmed === "") {
+        return [];
+    }
+    const rowSeparator = options.rowSeparator ?? /\s+/;
+    const colSeparator = options.colSeparator ?? ",";
+    const requiredCount = columns.filter((c) => c && !c.optional).length;
+    const out = [];
+    for (const row of trimmed.split(rowSeparator)) {
+        if (row.trim() === "") {
+            continue;
+        }
+        const cells = row.split(colSeparator);
+        if (cells.length < requiredCount) {
+            continue;
+        }
+        const record = {};
+        columns.forEach((spec, i) => {
+            if (!spec) {
+                return;
+            }
+            const cell = cells[i];
+            record[spec.name] = cell === undefined ? null : spec.parse(cell);
+        });
+        out.push(record);
+    }
+    return out;
+}
+/**
+ * A {@link Producer} that reads the CSV text at `valuesAt` (relative to the
+ * enclosing node) and decodes it with `decodeColumns`. Yields `[]` when the
+ * values element is absent.
+ *
+ * The row type is **inferred** from the (`as const`) `spec` — each column's name
+ * and cell-parser return type — so callers no longer declare it by hand.
+ */
+export function columns(valuesAt, spec, options) {
+    return custom({
+        produce: (lens) => decodeColumns(lens.textAt(valuesAt), spec, options),
+    });
+}
+//# sourceMappingURL=columns.js.map

package/dist/core/columns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"columns.js","sourceRoot":"","sources":["../../src/core/columns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAE5D,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAsCvC;;;GAGG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG;IACjB,4DAA4D;IAC5D,GAAG,EAAE,CAAC,GAAW,EAAiB,EAAE;QAClC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QACrC,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,qDAAqD;IACrD,GAAG,EAAE,CAAC,GAAW,EAAiB,EAAE;QAClC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;YACnB,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;QACvC,OAAO,CAAC,KAAK,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,4CAA4C;IAC5C,GAAG,EAAE,CAAC,GAAW,EAAiB,EAAE;QAClC,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QAC3B,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;IACzC,CAAC;IACD,+CAA+C;IAC/C,IAAI,EAAE,CAAC,GAAW,EAAkB,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC;CACzD,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,UAAU,aAAa,CAC3B,IAA+B,EAC/B,OAAyC,EACzC,UAAgC,EAAE;IAElC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC5B,IAAI,OAAO,KAAK,EAAE,EAAE,CAAC;QACnB,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,KAAK,CAAC;IACnD,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,IAAI,GAAG,CAAC;IACjD,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC;IAErE,MAAM,GAAG,GAAa,EAAE,CAAC;IACzB,KAAK,MAAM,GAAG,IAAI,OAAO,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9C,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YACtB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;QACtC,IAAI,KAAK,CAAC,MAAM,GAAG,aAAa,EAAE,CAAC;YACjC,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAA4B,EAAE,CAAC;QAC3C,OAAO,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;YAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,OAAO;YACT,CAAC;YACD,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACnE,CAAC,CAAC,CAAC;QACH,GAAG,CAAC,IAAI,CAAC,MAAW,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,OAAO,CACrB,QAAgB,EAChB,IAAU,EACV,OAA8B;IAE9B,OAAO,MAAM,CAAqB;QAChC,OAAO,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAc,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC;KACpF,CAAC,CAAC;AACL,CAAC"}

package/dist/core/producer.d.ts

@@ -0,0 +1,216 @@
+/**
+ * The Producer schema DSL.
+ *
+ * A {@link Producer} describes how to turn one XML node into one typed value. It
+ * is the single recursive unit of a schema: an object producer's fields are
+ * themselves producers, an array producer's item is a producer, and so on all
+ * the way down. {@link SchemaParser.produce} interprets this tree.
+ *
+ * Five kinds, each built by a combinator:
+ *   - `scalar`  — a leaf: text (or an attribute) decoded into `T`.
+ *   - `object`  — a fixed set of named fields, each a producer.
+ *   - `array`   — a repeated subtree: `each` selects item nodes, `item` produces one.
+ *   - `oneOf`   — an honest discriminated union (shared `base` + tagged `branches`).
+ *   - `custom`  — the sole escape hatch, handed a narrow {@link NodeLens}.
+ *
+ * Absence model (see CONTEXT.md): a `required` field that is missing nulls its
+ * *nearest enclosing object*; arrays *drop* null items (recording a warning);
+ * only the document root throws. `required` is opt-in, so nothing cascades unless
+ * a schema author asks for it.
+ */
+/** How a producer behaves when it finds no data. */
+export type Presence = 
+/** Missing → `null` (or `[]` for arrays). The default. */
+"optional"
+/** Missing → the nearest enclosing object becomes `null` (root throws). */
+ | "required"
+/** Missing → the key is omitted entirely (needs `exactOptionalPropertyTypes`). */
+ | "omit";
+/**
+ * The narrow, relative-only surface a `CustomProducer` receives.
+ *
+ * A custom producer never sees the raw {@link XMLAdapter} or escapes its subtree —
+ * it reads text and child nodes relative to the node it was mounted on.
+ */
+export interface NodeLens {
+    /** Local (namespace-stripped) name of this lens' own node (`null` if none). */
+    name(): string | null;
+    /** Trimmed text content of this lens' own node (`null` if empty). */
+    text(): string | null;
+    /** Trimmed text at a relative XPath (`null` if the node is absent/empty). */
+    textAt(xpath: string): string | null;
+    /** Value of an attribute reached by a relative XPath ending in `/@name`. */
+    attr(xpath: string): string | null;
+    /** A lens per node matching a relative XPath. */
+    all(xpath: string): Array<NodeLens>;
+}
+/**
+ * Fields common to every producer kind. `presence` lives on each producer
+ * interface instead (typed as the literal `P`), so its value can be recovered at
+ * the type level.
+ */
+interface ProducerMeta {
+    /** Relative XPath from the enclosing node to this producer's node. */
+    at?: string;
+    /** Docstring carried into generated types as `/** *\/`. */
+    doc?: string;
+    /** Group name carried into generated types as `@group`. */
+    group?: string;
+}
+/**
+ * A producer carries two type params: its output type `T`, and its
+ * {@link Presence} `P`. `P` is the literal type of the runtime `presence` field —
+ * the same value drives both parsing and {@link ProducedFields} (which reads `P`
+ * to decide whether a field's key is required or `omit` → optional). One field,
+ * one source of truth; no phantom to keep in sync.
+ */
+export interface ScalarProducer<T, P extends Presence = "optional"> extends ProducerMeta {
+    kind: "scalar";
+    decode: (raw: string | null) => T;
+    /** Absence behaviour (default `"optional"`). */
+    presence?: P;
+    /** Phantom output type — never present at runtime. */
+    readonly _out?: T;
+}
+export interface ObjectProducer<T, P extends Presence = "optional"> extends ProducerMeta {
+    kind: "object";
+    fields: Record<string, Producer<unknown, Presence>>;
+    presence?: P;
+    readonly _out?: T;
+}
+export interface ArrayProducer<T, P extends Presence = "optional"> extends ProducerMeta {
+    kind: "array";
+    /** Relative XPath selecting each item node. */
+    each: string;
+    item: Producer<unknown, Presence>;
+    presence?: P;
+    readonly _out?: T;
+}
+export interface CustomProducer<T, P extends Presence = "optional"> extends ProducerMeta {
+    kind: "custom";
+    produce: (lens: NodeLens) => T;
+    presence?: P;
+    readonly _out?: T;
+}
+/** One tagged branch of a {@link OneOfProducer}. */
+export interface OneOfBranch {
+    /** XPath whose existence selects this branch (first match wins). */
+    when: string;
+    /** Relative XPath to the branch's node (defaults to the oneOf node). */
+    at?: string;
+    /** Literal discriminant value written under the oneOf's `tagAs` key. */
+    tag: string;
+    fields: Record<string, Producer<unknown, Presence>>;
+}
+export interface OneOfProducer<T, P extends Presence = "optional"> extends ProducerMeta {
+    kind: "oneOf";
+    /** Field name that carries each branch's literal `tag`. */
+    tagAs: string;
+    /** Fields parsed once and merged into every branch. */
+    base: Record<string, Producer<unknown, Presence>>;
+    branches: ReadonlyArray<OneOfBranch>;
+    presence?: P;
+    readonly _out?: T;
+}
+export type Producer<T, P extends Presence = "optional"> = ScalarProducer<T, P> | ObjectProducer<T, P> | ArrayProducer<T, P> | CustomProducer<T, P> | OneOfProducer<T, P>;
+/** Flatten an intersection into a single object literal for legible hovers. */
+type Simplify<T> = {
+    [K in keyof T]: T[K];
+} & {};
+/** Recover a producer's output type. Recurses in parallel with the runtime. */
+export type Produced<P> = P extends {
+    readonly _out?: infer T;
+} ? T : never;
+/** Recover a producer's {@link Presence} (absent → the `"optional"` default). */
+type PresenceOf<X> = X extends {
+    presence?: infer P;
+} ? (P extends Presence ? P : "optional") : "optional";
+type OmitPresenceKeys<F> = {
+    [K in keyof F]: PresenceOf<F[K]> extends "omit" ? K : never;
+}[keyof F];
+/**
+ * The output type of an object built from a fields map. A field whose producer
+ * has `presence: "omit"` becomes an **optional** key (`key?:`); every other
+ * field is a required key. Under `exactOptionalPropertyTypes` this exactly
+ * mirrors the runtime absence model.
+ */
+export type ProducedFields<F> = Simplify<{
+    [K in Exclude<keyof F, OmitPresenceKeys<F>>]: Produced<F[K]>;
+} & {
+    [K in OmitPresenceKeys<F>]?: Produced<F[K]>;
+}>;
+/** Meta accepted by every combinator, minus `presence` (captured generically). */
+interface BaseMeta {
+    at?: string;
+    doc?: string;
+    group?: string;
+}
+type LeafOpts<P extends Presence = "optional"> = BaseMeta & {
+    presence?: P;
+};
+type ScalarOpts<T, P extends Presence = "optional"> = LeafOpts<P> & {
+    decode: (raw: string | null) => T;
+};
+/** A leaf producer with an explicit decoder. */
+export declare function scalar<T, P extends Presence = "optional">(opts: ScalarOpts<T, P>): ScalarProducer<T, P>;
+/** Raw trimmed text (`string | null`). */
+export declare function text<P extends Presence = "optional">(at?: string, opts?: LeafOpts<P>): ScalarProducer<string | null, P>;
+/** Precision-preserving ISO date/dateTime string (`string | null`). */
+export declare function date<P extends Presence = "optional">(at?: string, opts?: LeafOpts<P>): ScalarProducer<string | null, P>;
+/** Decimal number (`number | null`). */
+export declare function number_<P extends Presence = "optional">(at?: string, opts?: LeafOpts<P>): ScalarProducer<number | null, P>;
+/** Integer (`number | null`). */
+export declare function integer<P extends Presence = "optional">(at?: string, opts?: LeafOpts<P>): ScalarProducer<number | null, P>;
+/** Boolean (`boolean | null`), understanding BRO's `ja`/`nee`. */
+export declare function boolean_<P extends Presence = "optional">(at?: string, opts?: LeafOpts<P>): ScalarProducer<boolean | null, P>;
+/** BRO quality class (`number | null`), understanding `"klasse2"` and `"2"`. */
+export declare function qualityClass<P extends Presence = "optional">(at?: string, opts?: LeafOpts<P>): ScalarProducer<number | null, P>;
+/** A fixed set of named fields. Output type is inferred from `fields`. */
+export declare function object_<F extends Record<string, Producer<unknown, Presence>>, P extends Presence = "optional">(opts: {
+    fields: F;
+    presence?: P;
+} & BaseMeta): ObjectProducer<ProducedFields<F>, P>;
+/** A repeated subtree. `each` selects item nodes; `item` produces one value. */
+export declare function array<E, P extends Presence = "optional">(opts: {
+    each: string;
+    item: Producer<E, Presence>;
+    presence?: P;
+} & BaseMeta): ArrayProducer<Array<E>, P>;
+/** The escape hatch: a decoder handed a relative-only {@link NodeLens}. */
+export declare function custom<T, P extends Presence = "optional">(opts: {
+    produce: (lens: NodeLens) => T;
+    presence?: P;
+} & BaseMeta): CustomProducer<T, P>;
+/** A branch as written at the `oneOf` call site (captured for type inference). */
+interface BranchInput<Tag extends string = string, F extends Record<string, Producer<unknown, Presence>> = Record<string, Producer<unknown, Presence>>> {
+    when: string;
+    at?: string;
+    tag: Tag;
+    fields: F;
+}
+/** Output type of one branch: shared base ∪ branch fields ∪ the tag literal. */
+type BranchOut<TagKey extends string, Base, B> = B extends {
+    tag: infer Tag extends string;
+    fields: infer F;
+} ? Simplify<ProducedFields<Base> & ProducedFields<F> & Record<TagKey, Tag>> : never;
+/** The discriminated union over all branches (mapped tuple → indexed union). */
+type OneOfOut<TagKey extends string, Base, Branches extends ReadonlyArray<unknown>> = {
+    [I in keyof Branches]: BranchOut<TagKey, Base, Branches[I]>;
+}[number];
+/**
+ * An honest discriminated union. `base` fields are parsed once; the first branch
+ * whose `when` XPath exists is parsed and merged, with its literal `tag` written
+ * under `tagAs`.
+ *
+ * The output type is **inferred**: a discriminated union keyed on `tagAs`, each
+ * member being the shared `base` fields plus that branch's `fields` plus the
+ * literal `tag`. Presence is honoured throughout (`omit` → optional key).
+ */
+export declare function oneOf<TagKey extends string, const Base extends Record<string, Producer<unknown, Presence>>, const Branches extends ReadonlyArray<BranchInput>, P extends Presence = "optional">(opts: {
+    tagAs: TagKey;
+    base?: Base;
+    branches: Branches;
+    presence?: P;
+} & BaseMeta): OneOfProducer<OneOfOut<TagKey, Base, Branches>, P>;
+export {};
+//# sourceMappingURL=producer.d.ts.map

package/dist/core/producer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"producer.d.ts","sourceRoot":"","sources":["../../src/core/producer.ts"],"names":[],"mappings":"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"}