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

package/dist/decoders/type-decoders.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Type decoder functions for converting XML values to JavaScript types
+ */
+/**
+ * Parse float, handle null values and -999999 sentinel
+ */
+export declare function parseFloat(value: string | null | undefined): number | null;
+export declare function parseInt(value: string | null | undefined): number | null;
+export declare function parseBoolean(value: string | null | undefined): boolean | null;
+/**
+ * Normalize a BRO temporal value to a precision-preserving ISO 8601 string.
+ *
+ * BRO date/dateTime elements are a choice of full date (`YYYY-MM-DD`),
+ * year-month (`YYYY-MM`), year (`YYYY`), full `dateTime`, or a `voidReason`
+ * code (e.g. "onbekend") when the value is unknown. The exact lexical value is
+ * returned unchanged so no precision or timezone information is lost;
+ * `voidReason` codes and any unrecognized input yield `null`.
+ *
+ * Timezone handling (per BRO): `dateTime` values carry a mandatory offset, which
+ * for Dutch data is the seasonal `+01:00` (winter) / `+02:00` (summer) — never
+ * `Z`. BRO derives the calendar date from the *Dutch-local* time, so the
+ * intended date is simply the lexical `YYYY-MM-DD` prefix of the string. We keep
+ * the string verbatim precisely to avoid a UTC conversion silently shifting the
+ * date across midnight (BRO's own worked example of the pitfall). Consumers can
+ * build a `Date`/`Temporal` when needed, but beware: `new Date("YYYY-MM-DD")` on
+ * a date-only value is parsed as UTC midnight and can render as the previous day
+ * in negative-offset zones — treat date-only values as plain calendar dates.
+ * @see https://www.bro-productomgeving.nl/bpo/release-2.5_2024_Q4/informatie-voor-softwareleveranciers/het-afhandelen-van-tijdstippen
+ *
+ * Unlike the numeric decoders this does not warn on non-matching input,
+ * because `voidReason` is a legitimate and common value in archive data.
+ */
+export declare function parseDate(value: string | null | undefined): string | null;
+/**
+ * Parse quality class (handles "klasse2" or "2" format)
+ */
+export declare function parseQualityClass(value: string | null): number | null;
+//# sourceMappingURL=type-decoders.d.ts.map

package/dist/decoders/type-decoders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-decoders.d.ts","sourceRoot":"","sources":["../../src/decoders/type-decoders.ts"],"names":[],"mappings":"AAAA;;GAEG;AAeH;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAmB1E;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAiBxE;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAgB7E;AAgBD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAezE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,IAAI,CAcrE"}

package/dist/decoders/type-decoders.js

@@ -0,0 +1,134 @@
+/**
+ * Type decoder functions for converting XML values to JavaScript types
+ */
+import { SENTINEL } from "./constants.js";
+/**
+ * BRO uses two different missing-value conventions depending on the record
+ * type: CPT measurement CSVs use the -999999 sentinel, while the BHR-GT-BMA lab
+ * value tables (settlement/consolidation time-series) use the literal "NaN".
+ * The latter should resolve to null rather than being warned about as a parse
+ * error.
+ */
+function isMissingNumber(value) {
+    return value.trim().toLowerCase() === "nan";
+}
+/**
+ * Parse float, handle null values and -999999 sentinel
+ */
+export function parseFloat(value) {
+    // BRO encodes a missing numeric value as an empty string, the -999999
+    // sentinel, or the literal "NaN" (common in embedded measurement CSVs).
+    if (!value || value.trim() === "" || value === String(SENTINEL) || isMissingNumber(value)) {
+        return null;
+    }
+    try {
+        const num = Number.parseFloat(value);
+        if (isNaN(num)) {
+            console.warn(`Failed to parse float value: "${value}"`);
+            return null;
+        }
+        return num;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`Failed to parse float value: "${value}" - ${message}`);
+        return null;
+    }
+}
+export function parseInt(value) {
+    if (!value || value.trim() === "" || value === String(SENTINEL) || isMissingNumber(value)) {
+        return null;
+    }
+    try {
+        const num = Number.parseInt(value, 10);
+        if (isNaN(num)) {
+            console.warn(`Failed to parse integer value: "${value}"`);
+            return null;
+        }
+        return num;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.warn(`Failed to parse integer value: "${value}" - ${message}`);
+        return null;
+    }
+}
+export function parseBoolean(value) {
+    if (!value) {
+        return null;
+    }
+    const normalized = value.trim().toLowerCase();
+    if (normalized === "ja" || normalized === "true" || normalized === "1") {
+        return true;
+    }
+    if (normalized === "nee" || normalized === "false" || normalized === "0") {
+        return false;
+    }
+    return null;
+}
+/**
+ * BRO temporal lexical forms, ordered most-specific first.
+ *   xs:dateTime  YYYY-MM-DDThh:mm:ss(.sss)?(Z|±hh:mm)?
+ *   xs:date      YYYY-MM-DD
+ *   yearMonth    YYYY-MM
+ *   year         YYYY
+ */
+const BRO_DATE_FORMATS = [
+    /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:\d{2})?$/,
+    /^\d{4}-\d{2}-\d{2}$/,
+    /^\d{4}-\d{2}$/,
+    /^\d{4}$/,
+];
+/**
+ * Normalize a BRO temporal value to a precision-preserving ISO 8601 string.
+ *
+ * BRO date/dateTime elements are a choice of full date (`YYYY-MM-DD`),
+ * year-month (`YYYY-MM`), year (`YYYY`), full `dateTime`, or a `voidReason`
+ * code (e.g. "onbekend") when the value is unknown. The exact lexical value is
+ * returned unchanged so no precision or timezone information is lost;
+ * `voidReason` codes and any unrecognized input yield `null`.
+ *
+ * Timezone handling (per BRO): `dateTime` values carry a mandatory offset, which
+ * for Dutch data is the seasonal `+01:00` (winter) / `+02:00` (summer) — never
+ * `Z`. BRO derives the calendar date from the *Dutch-local* time, so the
+ * intended date is simply the lexical `YYYY-MM-DD` prefix of the string. We keep
+ * the string verbatim precisely to avoid a UTC conversion silently shifting the
+ * date across midnight (BRO's own worked example of the pitfall). Consumers can
+ * build a `Date`/`Temporal` when needed, but beware: `new Date("YYYY-MM-DD")` on
+ * a date-only value is parsed as UTC midnight and can render as the previous day
+ * in negative-offset zones — treat date-only values as plain calendar dates.
+ * @see https://www.bro-productomgeving.nl/bpo/release-2.5_2024_Q4/informatie-voor-softwareleveranciers/het-afhandelen-van-tijdstippen
+ *
+ * Unlike the numeric decoders this does not warn on non-matching input,
+ * because `voidReason` is a legitimate and common value in archive data.
+ */
+export function parseDate(value) {
+    if (!value) {
+        return null;
+    }
+    const trimmed = value.trim();
+    if (trimmed === "") {
+        return null;
+    }
+    if (BRO_DATE_FORMATS.some((format) => format.test(trimmed))) {
+        return trimmed;
+    }
+    return null;
+}
+/**
+ * Parse quality class (handles "klasse2" or "2" format)
+ */
+export function parseQualityClass(value) {
+    if (!value) {
+        return null;
+    }
+    // Handle "klasse2" format
+    const regex = /klasse(\d+)/i;
+    const match = regex.exec(value);
+    if (match?.[1]) {
+        return Number.parseInt(match[1], 10);
+    }
+    // Handle plain number
+    return parseInt(value);
+}
+//# sourceMappingURL=type-decoders.js.map

package/dist/decoders/type-decoders.js.map

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

package/dist/namespaces.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAqB5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAe3C,CAAC"}
+{"version":3,"file":"namespaces.d.ts","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,cAAc,EAAE,UAiC5B,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,aAAa,CAAC,MAAM,CAqB3C,CAAC"}

package/dist/namespaces.js

@@ -19,11 +19,21 @@ export const BRO_NAMESPACES = {
     // BHR-G namespaces (dsbhrg/3.1)
     dsbhrg: "http://www.broservices.nl/xsd/dsbhrg/3.1",
     bhrgcom: "http://www.broservices.nl/xsd/bhrgcommon/3.1",
+    // GMW namespaces (Grondwatermonitoringput, dsgmw/1.1)
+    dsgmw: "http://www.broservices.nl/xsd/dsgmw/1.1",
+    gmwcommon: "http://www.broservices.nl/xsd/gmwcommon/1.1",
+    // GLD namespaces (Grondwaterstandonderzoek, dsgld/1.0)
+    dsgld: "http://www.broservices.nl/xsd/dsgld/1.0",
+    gldcommon: "http://www.broservices.nl/xsd/gldcommon/1.0",
     // Common geospatial namespaces
     gml: "http://www.opengis.net/gml/3.2",
     swe: "http://www.opengis.net/swe/2.0",
     om: "http://www.opengis.net/om/2.0",
     sampling: "http://www.opengis.net/sampling/2.0",
+    // OGC WaterML 2.0 - GLD groundwater level time-series (docs use prefix "waterml";
+    // XPath binds by URI, so "wml2" here resolves those elements regardless).
+    wml2: "http://www.opengis.net/waterml/2.0",
+    xlink: "http://www.w3.org/1999/xlink",
 };
 /**
  * List of known BRO namespace prefixes
@@ -44,5 +54,11 @@ export const KNOWN_BRO_PREFIXES = [
     "bhrgtcom",
     "dsbhrg",
     "bhrgcom",
+    "dsgmw",
+    "gmwcommon",
+    "dsgld",
+    "gldcommon",
+    "wml2",
+    "xlink",
 ];
 //# sourceMappingURL=namespaces.js.map

package/dist/namespaces.js.map

@@ -1 +1 @@
-{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,iBAAiB;IACjB,KAAK,EAAE,yCAAyC;IAChD,MAAM,EAAE,6CAA6C;IACrD,SAAS,EAAE,6CAA6C;IAExD,wCAAwC;IACxC,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,6CAA6C;IACxD,KAAK,EAAE,yCAAyC;IAChD,QAAQ,EAAE,+CAA+C;IAEzD,gCAAgC;IAChC,MAAM,EAAE,0CAA0C;IAClD,OAAO,EAAE,8CAA8C;IAEvD,+BAA+B;IAC/B,GAAG,EAAE,gCAAgC;IACrC,GAAG,EAAE,gCAAgC;IACrC,EAAE,EAAE,+BAA+B;IACnC,QAAQ,EAAE,qCAAqC;CAChD,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA0B;IACvD,OAAO;IACP,QAAQ;IACR,WAAW;IACX,KAAK;IACL,KAAK;IACL,IAAI;IACJ,UAAU;IACV,OAAO;IACP,SAAS;IACT,WAAW;IACX,OAAO;IACP,UAAU;IACV,QAAQ;IACR,SAAS;CACD,CAAC"}
+{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../src/namespaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAe;IACxC,iBAAiB;IACjB,KAAK,EAAE,yCAAyC;IAChD,MAAM,EAAE,6CAA6C;IACrD,SAAS,EAAE,6CAA6C;IAExD,wCAAwC;IACxC,OAAO,EAAE,4CAA4C;IACrD,SAAS,EAAE,6CAA6C;IACxD,KAAK,EAAE,yCAAyC;IAChD,QAAQ,EAAE,+CAA+C;IAEzD,gCAAgC;IAChC,MAAM,EAAE,0CAA0C;IAClD,OAAO,EAAE,8CAA8C;IAEvD,sDAAsD;IACtD,KAAK,EAAE,yCAAyC;IAChD,SAAS,EAAE,6CAA6C;IAExD,uDAAuD;IACvD,KAAK,EAAE,yCAAyC;IAChD,SAAS,EAAE,6CAA6C;IAExD,+BAA+B;IAC/B,GAAG,EAAE,gCAAgC;IACrC,GAAG,EAAE,gCAAgC;IACrC,EAAE,EAAE,+BAA+B;IACnC,QAAQ,EAAE,qCAAqC;IAC/C,kFAAkF;IAClF,0EAA0E;IAC1E,IAAI,EAAE,oCAAoC;IAC1C,KAAK,EAAE,8BAA8B;CACtC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA0B;IACvD,OAAO;IACP,QAAQ;IACR,WAAW;IACX,KAAK;IACL,KAAK;IACL,IAAI;IACJ,UAAU;IACV,OAAO;IACP,SAAS;IACT,WAAW;IACX,OAAO;IACP,UAAU;IACV,QAAQ;IACR,SAAS;IACT,OAAO;IACP,WAAW;IACX,OAAO;IACP,WAAW;IACX,MAAM;IACN,OAAO;CACC,CAAC"}

package/dist/node.d.ts

@@ -13,15 +13,25 @@
  */
 export { BROParser } from "./parser.js";
 export { NodeXMLAdapter as XMLAdapter } from "./adapters/node-adapter.js";
-export type { CPTData, CPTMeasurement, BHRGTData, BHRGTLayer, BHRGTLayerBase, BHRGTSoilLayer, BHRGTRockLayer, Grainshape, BHRGData, BHRGLayer, MunsellColour, SandConstituent, SandFraction, ShellConstituent, ShellFraction, GravelConstituent, GravelFraction, PeatConstituent, PeatFraction, Chunk, FineFractionDistributionOrganicSoil, FineFractionDistributionShellySoil, FractionDistribution, Mottle, ThinStratum, BROData, BRORegistrationObject, 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, CoreRecovery, CompletedInterval, NotDescribedInterval, ExcavatedLayer, BoringVelocityMeasurement, FluidMudLayer, PostSedimentaryDiscontinuity, RockDescription, RockWeatheringDegree, SaturatedPermeabilityAtSpecificLoad, 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=node.d.ts.map

package/dist/node.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE1E,YAAY,EACV,OAAO,EACP,cAAc,EACd,SAAS,EACT,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,UAAU,EACV,QAAQ,EACR,SAAS,EACT,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,eAAe,EACf,YAAY,EACZ,KAAK,EACL,mCAAmC,EACnC,kCAAkC,EAClC,oBAAoB,EACpB,MAAM,EACN,WAAW,EACX,OAAO,EACP,qBAAqB,EACrB,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,YAAY,EACZ,iBAAiB,EACjB,oBAAoB,EACpB,cAAc,EACd,yBAAyB,EACzB,aAAa,EACb,4BAA4B,EAC5B,eAAe,EACf,oBAAoB,EACpB,mCAAmC,EACnC,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":"node.d.ts","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"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"}

package/dist/node.js

@@ -15,13 +15,15 @@ export { BROParser } from "./parser.js";
 export { NodeXMLAdapter as XMLAdapter } from "./adapters/node-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=node.js.map

package/dist/node.js.map

@@ -1 +1 @@
-{"version":3,"file":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AA6F1E,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":"node.js","sourceRoot":"","sources":["../src/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,OAAO,EAAE,cAAc,IAAI,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAmB1E,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/parser.d.ts

@@ -5,7 +5,8 @@
  * The adapter is provided at construction time, making testing and
  * environment-specific behavior explicit.
  */
-import type { XMLAdapter, Namespaces, CPTData, BHRGTData, BHRGData, BROData, ParseMeta, Schema, BROFileType } from "./types/index.js";
+import type { XMLAdapter, Namespaces, CPTData, BHRGTData, BHRGData, GMWData, GLDData, BROData, ParseMeta, BROFileType } from "./types/index.js";
+import type { Producer, ProducedFields, Presence } from "./core/producer.js";
 /**
  * Main BRO Parser class
  *
@@ -105,6 +106,55 @@ export declare class BROParser {
      * ```
      */
     parseBHRG(xmlText: string): BHRGData;
+    /**
+     * Parse GMW (groundwater monitoring well) data from BRO/XML string
+     *
+     * Extracts well metadata and its monitoring tubes following the IMBRO GMW
+     * schema (dsgmw/1.1). Works on the public dispatch document (`GMW_PPO`) as
+     * well as the `GMW_PO` / `GMW_O` variants, which share one leaf surface.
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed GMW data with metadata and monitoring tubes
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const gmw = parser.parseGMW(xmlString);
+     *
+     * console.log(gmw.broId);                         // "GMW000000048066"
+     * console.log(gmw.numberOfMonitoringTubes);       // 1
+     * console.log(gmw.monitoringTubes[0].screenLength); // 1.0
+     * console.log(gmw.meta.schemaVersion);            // "1.1"
+     * ```
+     */
+    parseGMW(xmlText: string): GMWData;
+    /**
+     * Parse GLD (groundwater level research) data from BRO/XML string
+     *
+     * Extracts the monitoring-point reference, monitoring-net membership and the
+     * groundwater level observation time-series following the IMBRO GLD schema
+     * (dsgld/1.0).
+     *
+     * Note: full GLD dispatch documents can be very large (years of time-series
+     * measurements). Consider requesting a bounded observation period from the BRO
+     * REST API before parsing.
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed GLD data with metadata and observation series
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const gld = parser.parseGLD(xmlString);
+     *
+     * console.log(gld.broId);                       // "GLD000000010000"
+     * console.log(gld.monitoringPoint?.broId);      // "GMW000000020142"
+     * console.log(gld.observations[0].points.length); // 8760
+     * ```
+     */
+    parseGLD(xmlText: string): GLDData;
     /**
      * Parse any BRO XML document, auto-detecting the data type
      *
@@ -140,35 +190,35 @@ export declare class BROParser {
      * This allows you to extract only the fields you need, which can be
      * more efficient and gives you full control over the output structure.
      *
+     * Pass a bare map of field name → {@link Producer}, built from the `producers`
+     * authoring surface. The return type is inferred from the map: each field's
+     * type is its producer's output type, plus a `meta` block. Author the map as
+     * an inline literal (or with `satisfies Record<string, Producer<unknown>>`) so
+     * the field types are preserved for inference.
+     *
      * @param xmlText - BRO/XML document as string
-     * @param schema - Custom schema defining fields to extract
+     * @param fields - Field name → producer map defining what to extract
      * @param dataType - The BRO data type (for version validation)
-     * @returns Object with extracted fields matching your schema
+     * @returns Object with extracted fields matching your map, plus `meta`
      *
      * @example
      * ```typescript
-     * import { BROParser, resolvers } from '@bedrock-engineer/bro-xml-parser';
+     * import { BROParser, producers as p } from '@bedrock-engineer/bro-xml-parser';
      *
      * const parser = new BROParser(new XMLAdapter());
      *
      * // Define only the fields you need
-     * 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, mySchema, 'CPT');
-     * // { id: "CPT000000099543", depth: 25.5, location: { x: 155000, y: 463000, epsg: "EPSG:28992" } }
+     * const result = parser.parseCustom(xmlText, {
+     *   id: p.text('brocom:broId'),                                       // string | null
+     *   depth: p.number_('./dscpt:conePenetrometerSurvey/cptcommon:trajectory/cptcommon:finalDepth'),
+     *   location: p.gmlLocation('./dscpt:deliveredLocation/cptcommon:location'),
+     * }, 'CPT');
+     *
+     * result.depth;    // number | null — inferred, no casts
+     * result.location; // Location | null
      * ```
      */
-    parseCustom(xmlText: string, schema: Schema, dataType?: BROFileType): Record<string, unknown> & {
+    parseCustom<const F extends Record<string, Producer<unknown, Presence>>>(xmlText: string, fields: F, dataType?: BROFileType): ProducedFields<F> & {
         meta: ParseMeta;
     };
     /**

package/dist/parser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,SAAS,EACT,MAAM,EACN,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAe;IAE7B;;;;;OAKG;gBACS,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU;IAKxD;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAWlC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAWtC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAWpC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAoB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,WAAW,CACT,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,MAAM,EACd,QAAQ,CAAC,EAAE,WAAW,GACrB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE;IA6BhD;;;OAGG;IACH,UAAU,IAAI,UAAU;CAGzB"}
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAcH,OAAO,KAAK,EACV,UAAU,EACV,UAAU,EACV,OAAO,EACP,SAAS,EACT,QAAQ,EACR,OAAO,EACP,OAAO,EACP,OAAO,EACP,SAAS,EACT,WAAW,EACZ,MAAM,kBAAkB,CAAC;AAG1B,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAE7E;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAe;IAE7B;;;;;OAKG;gBACS,OAAO,EAAE,UAAU,EAAE,UAAU,CAAC,EAAE,UAAU;IAKxD;;OAEG;IACH,OAAO,CAAC,UAAU;IAclB;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYlC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS;IAYtC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,QAAQ;IAYpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYlC;;;;;;;;;;;;;;;;;;;;;;;;OAwBG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAYlC;;;;;;;;;;;;;;;;;;;;;;;;;;;OA2BG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO;IAwB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAiCG;IACH,WAAW,CAAC,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,EACrE,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,CAAC,EACT,QAAQ,CAAC,EAAE,WAAW,GACrB,cAAc,CAAC,CAAC,CAAC,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE;IA8B1C;;;OAGG;IACH,UAAU,IAAI,UAAU;CAGzB"}

package/dist/parser.js

@@ -7,11 +7,14 @@
  */
 import { SchemaParser } from "./core/schema-parser.js";
 import { detectAndValidateVersion, getVersionInfo, } from "./core/version-detector.js";
-import { CPT_SCHEMA } from "./schemas/cpt-schema.js";
-import { BORE_SCHEMA } from "./schemas/bore-schema.js";
-import { BHRG_SCHEMA } from "./schemas/bhrg-schema.js";
+import { CPT_PRODUCER } from "./schemas/cpt-schema.js";
+import { BORE_PRODUCER } from "./schemas/bore-schema.js";
+import { BHRG_PRODUCER } from "./schemas/bhrg-schema.js";
+import { GMW_PRODUCER } from "./schemas/gmw-schema.js";
+import { GLD_PRODUCER } from "./schemas/gld-schema.js";
 import { BRO_NAMESPACES } from "./namespaces.js";
 import { BROParseError } from "./types/index.js";
+import { object_ } from "./core/producer.js";
 /**
  * Main BRO Parser class
  *
@@ -82,8 +85,9 @@ export class BROParser {
         const doc = this.adapter.parseXML(xmlText);
         const versionResult = detectAndValidateVersion(doc, "CPT");
         const meta = this.createMeta(versionResult);
-        const data = this.parser.parse(doc, CPT_SCHEMA, "dispatchDocument");
-        return { meta, ...data };
+        const { value, warnings } = this.parser.produce(doc, CPT_PRODUCER, "dispatchDocument");
+        meta.warnings.push(...warnings);
+        return { meta, ...value };
     }
     /**
      * Parse Bore (borehole) data from BRO/XML string
@@ -111,8 +115,9 @@ export class BROParser {
         const doc = this.adapter.parseXML(xmlText);
         const versionResult = detectAndValidateVersion(doc, "BHR-GT");
         const meta = this.createMeta(versionResult);
-        const data = this.parser.parse(doc, BORE_SCHEMA, "dispatchDocument");
-        return { meta, ...data };
+        const { value, warnings } = this.parser.produce(doc, BORE_PRODUCER, "dispatchDocument");
+        meta.warnings.push(...warnings);
+        return { meta, ...value };
     }
     /**
      * Parse BHR-G (Geological Borehole) data from BRO/XML string
@@ -140,8 +145,72 @@ export class BROParser {
         const doc = this.adapter.parseXML(xmlText);
         const versionResult = detectAndValidateVersion(doc, "BHR-G");
         const meta = this.createMeta(versionResult);
-        const data = this.parser.parse(doc, BHRG_SCHEMA, "dispatchDocument");
-        return { meta, ...data };
+        const { value, warnings } = this.parser.produce(doc, BHRG_PRODUCER, "dispatchDocument");
+        meta.warnings.push(...warnings);
+        return { meta, ...value };
+    }
+    /**
+     * Parse GMW (groundwater monitoring well) data from BRO/XML string
+     *
+     * Extracts well metadata and its monitoring tubes following the IMBRO GMW
+     * schema (dsgmw/1.1). Works on the public dispatch document (`GMW_PPO`) as
+     * well as the `GMW_PO` / `GMW_O` variants, which share one leaf surface.
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed GMW data with metadata and monitoring tubes
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const gmw = parser.parseGMW(xmlString);
+     *
+     * console.log(gmw.broId);                         // "GMW000000048066"
+     * console.log(gmw.numberOfMonitoringTubes);       // 1
+     * console.log(gmw.monitoringTubes[0].screenLength); // 1.0
+     * console.log(gmw.meta.schemaVersion);            // "1.1"
+     * ```
+     */
+    parseGMW(xmlText) {
+        const doc = this.adapter.parseXML(xmlText);
+        const versionResult = detectAndValidateVersion(doc, "GMW");
+        const meta = this.createMeta(versionResult);
+        const { value, warnings } = this.parser.produce(doc, GMW_PRODUCER, "dispatchDocument");
+        meta.warnings.push(...warnings);
+        return { meta, ...value };
+    }
+    /**
+     * Parse GLD (groundwater level research) data from BRO/XML string
+     *
+     * Extracts the monitoring-point reference, monitoring-net membership and the
+     * groundwater level observation time-series following the IMBRO GLD schema
+     * (dsgld/1.0).
+     *
+     * Note: full GLD dispatch documents can be very large (years of time-series
+     * measurements). Consider requesting a bounded observation period from the BRO
+     * REST API before parsing.
+     *
+     * @param xmlText - BRO/XML document as string
+     * @returns Parsed GLD data with metadata and observation series
+     * @throws {BROParseError} If parsing fails or required fields are missing
+     *
+     * @example
+     * ```typescript
+     * const parser = new BROParser(new XMLAdapter());
+     * const gld = parser.parseGLD(xmlString);
+     *
+     * console.log(gld.broId);                       // "GLD000000010000"
+     * console.log(gld.monitoringPoint?.broId);      // "GMW000000020142"
+     * console.log(gld.observations[0].points.length); // 8760
+     * ```
+     */
+    parseGLD(xmlText) {
+        const doc = this.adapter.parseXML(xmlText);
+        const versionResult = detectAndValidateVersion(doc, "GLD");
+        const meta = this.createMeta(versionResult);
+        const { value, warnings } = this.parser.produce(doc, GLD_PRODUCER, "dispatchDocument");
+        meta.warnings.push(...warnings);
+        return { meta, ...value };
     }
     /**
      * Parse any BRO XML document, auto-detecting the data type
@@ -186,6 +255,10 @@ export class BROParser {
                 return this.parseBHRGT(xmlText);
             case "BHR-G":
                 return this.parseBHRG(xmlText);
+            case "GMW":
+                return this.parseGMW(xmlText);
+            case "GLD":
+                return this.parseGLD(xmlText);
         }
     }
     /**
@@ -194,35 +267,35 @@ export class BROParser {
      * This allows you to extract only the fields you need, which can be
      * more efficient and gives you full control over the output structure.
      *
+     * Pass a bare map of field name → {@link Producer}, built from the `producers`
+     * authoring surface. The return type is inferred from the map: each field's
+     * type is its producer's output type, plus a `meta` block. Author the map as
+     * an inline literal (or with `satisfies Record<string, Producer<unknown>>`) so
+     * the field types are preserved for inference.
+     *
      * @param xmlText - BRO/XML document as string
-     * @param schema - Custom schema defining fields to extract
+     * @param fields - Field name → producer map defining what to extract
      * @param dataType - The BRO data type (for version validation)
-     * @returns Object with extracted fields matching your schema
+     * @returns Object with extracted fields matching your map, plus `meta`
      *
      * @example
      * ```typescript
-     * import { BROParser, resolvers } from '@bedrock-engineer/bro-xml-parser';
+     * import { BROParser, producers as p } from '@bedrock-engineer/bro-xml-parser';
      *
      * const parser = new BROParser(new XMLAdapter());
      *
      * // Define only the fields you need
-     * 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, mySchema, 'CPT');
-     * // { id: "CPT000000099543", depth: 25.5, location: { x: 155000, y: 463000, epsg: "EPSG:28992" } }
+     * const result = parser.parseCustom(xmlText, {
+     *   id: p.text('brocom:broId'),                                       // string | null
+     *   depth: p.number_('./dscpt:conePenetrometerSurvey/cptcommon:trajectory/cptcommon:finalDepth'),
+     *   location: p.gmlLocation('./dscpt:deliveredLocation/cptcommon:location'),
+     * }, 'CPT');
+     *
+     * result.depth;    // number | null — inferred, no casts
+     * result.location; // Location | null
      * ```
      */
-    parseCustom(xmlText, schema, dataType) {
+    parseCustom(xmlText, fields, dataType) {
         const doc = this.adapter.parseXML(xmlText);
         // Validate version if dataType is provided
         let meta;
@@ -246,8 +319,9 @@ export class BROParser {
                 };
             }
         }
-        const data = this.parser.parse(doc, schema, "dispatchDocument");
-        return { meta, ...data };
+        const { value, warnings } = this.parser.produce(doc, object_({ fields }), "dispatchDocument");
+        meta.warnings.push(...warnings);
+        return { meta, ...value };
     }
     /**
      * Get the underlying XML adapter