@bedrock-engineer/bro-xml-parser 0.1.0

package/dist/types/index.d.ts

@@ -0,0 +1,917 @@
+/**
+ * Type definitions for BRO/XML parser
+ */
+/**
+ * Namespace mapping (prefix -> URI)
+ */
+export type Namespaces = Record<string, string>;
+/**
+ * Metadata about the parsed document
+ *
+ * Contains schema version information and any warnings
+ * encountered during parsing.
+ */
+export interface ParseMeta {
+    /**
+     * Schema version detected in the document (e.g., "1.1", "2.0")
+     */
+    schemaVersion: string;
+    /**
+     * Full namespace URI of the schema
+     */
+    schemaNamespace: string;
+    /**
+     * Data type detected (CPT, BHR-GT, BHR-G)
+     */
+    dataType: 'CPT' | 'BHR-GT' | 'BHR-G';
+    /**
+     * Warnings encountered during parsing
+     *
+     * Non-fatal issues like:
+     * - Parsing with older/newer minor version than supported
+     * - Optional fields with unexpected formats
+     */
+    warnings: string[];
+}
+/**
+ * XML adapter interface for cross-runtime compatibility
+ */
+export interface XMLAdapter {
+    parseXML(xmlText: string): Document;
+    evaluateXPath(doc: Document | Node, query: string, namespaceResolver: (prefix: string | null) => string | null): Node | null;
+    evaluateXPathAll(doc: Document | Node, query: string, namespaceResolver: (prefix: string | null) => string | null): Array<Node>;
+}
+/**
+ * Context passed to resolver functions
+ */
+export interface ResolverContext {
+    node: Node;
+    element: Node;
+    namespaces: Namespaces;
+    adapter: XMLAdapter;
+}
+/**
+ * Resolver function type
+ */
+export type ResolverFunction = (value: string | null, context: ResolverContext) => unknown;
+/**
+ * Schema field definition
+ */
+export interface SchemaField {
+    xpath: string;
+    resolver?: ResolverFunction;
+    attribute?: string;
+    required?: boolean;
+}
+/**
+ * Schema definition (field name -> field config)
+ */
+export type Schema = Record<string, SchemaField>;
+/**
+ * BRO quality regime
+ *
+ * IMBRO: Strict regime for new data (all mandatory fields required)
+ * IMBRO/A: Relaxed regime for historical/legacy data (allows missing fields)
+ */
+export type QualityRegime = 'IMBRO' | 'IMBRO/A';
+/**
+ * Geographic location with coordinates and EPSG code
+ */
+export interface Location {
+    x: number;
+    y: number;
+    epsg: string;
+}
+/**
+ * CPT measurement row (dynamic fields based on parameters)
+ */
+export interface CPTMeasurement {
+    penetrationLength: number;
+    depth?: number;
+    elapsedTime?: number;
+    coneResistance: number | null;
+    correctedConeResistance?: number | null;
+    netConeResistance?: number | null;
+    localFriction?: number | null;
+    frictionRatio?: number | null;
+    porePressureU1?: number | null;
+    porePressureU2?: number | null;
+    porePressureU3?: number | null;
+    poreRatio?: number | null;
+    inclinationX?: number | null;
+    inclinationY?: number | null;
+    inclinationEW?: number | null;
+    inclinationNS?: number | null;
+    inclinationResultant?: number | null;
+    magneticFieldStrengthX?: number | null;
+    magneticFieldStrengthY?: number | null;
+    magneticFieldStrengthZ?: number | null;
+    magneticFieldStrengthTotal?: number | null;
+    magneticInclination?: number | null;
+    magneticDeclination?: number | null;
+    electricalConductivity?: number | null;
+    temperature?: number | null;
+}
+/**
+ * Complete CPT data (metadata + measurements)
+ */
+export interface CPTData {
+    /**
+     * Metadata about the parsed document (schema version, warnings)
+     */
+    meta: ParseMeta;
+    bro_id: string | null;
+    /**
+     * User-defined identifier (not parsed from XML)
+     *
+     * Useful for tracking data that doesn't have a bro_id yet,
+     * such as during data collection or before BRO registration.
+     *
+     * @example
+     * ```typescript
+     * const cpt = parser.parseCPT(xmlString);
+     * cpt.alias = "Site A - Test 1";
+     * ```
+     */
+    alias?: string;
+    /**
+     * BRO quality regime
+     *
+     * - IMBRO: Strict regime (all mandatory fields required)
+     * - IMBRO/A: Relaxed regime for historical data (allows missing fields)
+     */
+    quality_regime: QualityRegime | null;
+    research_report_date: Date | null;
+    delivered_location: Location | null;
+    standardized_location: Location | null;
+    delivered_vertical_position_offset: number | null;
+    delivered_vertical_position_datum: string | null;
+    delivered_vertical_position_reference_point: string | null;
+    cpt_standard: string | null;
+    /** CPT method used (e.g., "elektrisch", "mechanisch") */
+    cpt_method: string | null;
+    /** Stop criterion for the test */
+    stop_criterion: string | null;
+    dissipationtest_performed: boolean | null;
+    quality_class: number | null;
+    predrilled_depth: number | null;
+    final_depth: number | null;
+    groundwater_level: number | null;
+    /** Date of final processing */
+    final_processing_date: Date | null;
+    /** Whether signal processing was performed */
+    signal_processing_performed: boolean | null;
+    /** Whether interruption processing was performed */
+    interruption_processing_performed: boolean | null;
+    /** Whether expert correction was performed */
+    expert_correction_performed: boolean | null;
+    cpt_description: string | null;
+    cpt_type: string | null;
+    cone_surface_area: number | null;
+    cone_diameter: number | null;
+    cone_surface_quotient: number | null;
+    cone_to_friction_sleeve_distance: number | null;
+    cone_to_friction_sleeve_surface_area: number | null;
+    cone_to_friction_sleeve_surface_quotient: number | null;
+    zlm_cone_resistance_before: number | null;
+    zlm_cone_resistance_after: number | null;
+    zlm_inclination_ew_before: number | null;
+    zlm_inclination_ew_after: number | null;
+    zlm_inclination_ns_before: number | null;
+    zlm_inclination_ns_after: number | null;
+    zlm_inclination_resultant_before: number | null;
+    zlm_inclination_resultant_after: number | null;
+    zlm_local_friction_before: number | null;
+    zlm_local_friction_after: number | null;
+    zlm_pore_pressure_u1_before: number | null;
+    zlm_pore_pressure_u2_before: number | null;
+    zlm_pore_pressure_u3_before: number | null;
+    zlm_pore_pressure_u1_after: number | null;
+    zlm_pore_pressure_u2_after: number | null;
+    zlm_pore_pressure_u3_after: number | null;
+    data: Array<CPTMeasurement>;
+}
+/**
+ * Grain shape properties for sand/gravel fractions
+ */
+export interface Grainshape {
+    /** Size fraction this shape applies to (e.g., "zand", "grind") */
+    sizeFraction: string | null;
+    /** Angularity of grains (e.g., "hoekig", "subhoekig", "afgerond") */
+    angularity: string | null;
+    /** Sphericity of grains (e.g., "bol", "plat", "langwerpig") */
+    sphericity: string | null;
+}
+/**
+ * BHR-GT (Borehole Research Geotechnical) layer data
+ *
+ * Contains all fields from the BRO BHR-GT schema for a single soil layer.
+ */
+export interface BHRGTLayer {
+    upperBoundary: number;
+    lowerBoundary: number;
+    upperBoundaryDetermination?: string | null;
+    lowerBoundaryDetermination?: string | null;
+    /** Whether the layer is anthropogenic (man-made) */
+    anthropogenic?: boolean | null;
+    geotechnicalSoilName: string;
+    /** Tertiary soil constituent (e.g., "schelpMateriaal", "plantenresten") */
+    tertiaryConstituent?: string | null;
+    /** Soil color code */
+    color?: string;
+    /** Dispersed inhomogeneity presence */
+    dispersedInhomogeneity?: boolean | null;
+    /** Organic matter content classification */
+    organicMatterContentClass?: string | null;
+    /** Carbonate content classification */
+    carbonateContentClass?: string | null;
+    /** Sand median grain size classification */
+    sandMedianClass?: string | null;
+    /** Grain shape properties (for sand/gravel) */
+    grainshape?: Grainshape;
+    /** Whether the layer boundary is slanted */
+    slant?: boolean | null;
+    /** Whether the layer is bedded/stratified */
+    bedded?: boolean | null;
+    /** Whether the internal structure is intact (undisturbed) */
+    internalStructureIntact?: boolean | null;
+    /** Whether the soil is mixed */
+    mixed?: boolean | null;
+    /** Whether the soil has mottled appearance */
+    mottled?: boolean | null;
+    /** Consistency of fine-grained soils (e.g., "slap", "stevig", "vast") */
+    fineSoilConsistency?: string | null;
+    /** Consistency of organic soils */
+    organicSoilConsistency?: string | null;
+    /** Texture of organic soils (e.g., "vezeligGrof", "vezeligFijn") */
+    organicSoilTexture?: string | null;
+    /** Tensile strength of peat */
+    peatTensileStrength?: string | null;
+}
+/**
+ * Complete Bore data (metadata + layers)
+ *
+ * Note: BHRGTData represents BHR-GT-BMB (Boormonsterbeschrijving - visual/textural description)
+ * For laboratory analysis data, see the optional `analysis` field (BHR-GT-BMA)
+ */
+export interface BHRGTData {
+    /**
+     * Metadata about the parsed document (schema version, warnings)
+     */
+    meta: ParseMeta;
+    bro_id: string | null;
+    /**
+     * User-defined identifier (not parsed from XML)
+     *
+     * Useful for tracking data that doesn't have a bro_id yet,
+     * such as during data collection or before BRO registration.
+     *
+     * @example
+     * ```typescript
+     * const bore = parser.parseBHRGT(xmlString);
+     * bore.alias = "Borehole 7 - North Field";
+     * ```
+     */
+    alias?: string;
+    /**
+     * BRO quality regime
+     *
+     * - IMBRO: Strict regime (all mandatory fields required)
+     * - IMBRO/A: Relaxed regime for historical data (allows missing fields)
+     */
+    quality_regime: QualityRegime | null;
+    research_report_date: Date | null;
+    delivered_location: Location | null;
+    standardized_location: Location | null;
+    delivered_vertical_position_offset: number | null;
+    delivered_vertical_position_datum: string | null;
+    delivered_vertical_position_reference_point: string | null;
+    description_procedure: string | null;
+    groundwater_level: number | null;
+    bore_rock_reached: boolean | null;
+    final_bore_depth: number | null;
+    final_sample_depth: number | null;
+    bore_hole_completed: boolean | null;
+    /** Start date of the boring operation */
+    boring_start_date: Date | null;
+    /** End date of the boring operation */
+    boring_end_date: Date | null;
+    /** Boring procedure standard used (e.g., "EN1997d2v2007") */
+    boring_procedure: string | null;
+    /** Boring technique used (e.g., "gestoken", "mechanischGestoken") */
+    boring_technique: string | null;
+    /** Whether the trajectory was excavated */
+    trajectory_excavated: boolean | null;
+    /** Whether the subsurface is contaminated */
+    subsurface_contaminated: boolean | null;
+    /** Stop criterion for boring */
+    stop_criterion: string | null;
+    /** Type of sampler used */
+    sampler_type: string | null;
+    /** Sampling procedure standard */
+    sampling_procedure: string | null;
+    /** Sampling method used */
+    sampling_method: string | null;
+    /** Sampling quality assessment */
+    sampling_quality: string | null;
+    /** Whether the sample was orientated */
+    orientated_sampled: boolean | null;
+    /** Sample container diameter in mm */
+    sample_container_diameter: number | null;
+    /** Sample container length in mm */
+    sample_container_length: number | null;
+    /** Piston presence in sampler */
+    piston_present: boolean | null;
+    /** Core catcher presence */
+    core_catcher_present: boolean | null;
+    /** Stocking used in sampling */
+    stocking_used: boolean | null;
+    /** Lubrication fluid used */
+    lubrication_fluid_used: boolean | null;
+    /** Right-angled cutting shoe */
+    right_angled_cutting_shoe: boolean | null;
+    /** Cutting shoe inside diameter in mm */
+    cutting_shoe_inside_diameter: number | null;
+    /** Cutting shoe outside diameter in mm */
+    cutting_shoe_outside_diameter: number | null;
+    /** Taper angle of cutting shoe */
+    taper_angle: number | null;
+    /** Whether the borehole log was checked */
+    borehole_log_checked: boolean | null;
+    /** Description quality assessment */
+    description_quality: string | null;
+    /** Description location (field/lab) */
+    description_location: string | null;
+    /** Date of description report */
+    description_report_date: Date | null;
+    /** Described material type */
+    described_material: string | null;
+    /** Whether sampling was continuous */
+    continuously_sampled: boolean | null;
+    /** Sample moistness during description */
+    sample_moistness: string | null;
+    data: Array<BHRGTLayer>;
+    analysis?: BoreholeSampleAnalysis;
+    /** Array of bored intervals with technique and diameter */
+    bored_intervals: Array<BoredInterval>;
+    /** Array of sampled intervals with method and quality */
+    sampled_intervals: Array<SampledInterval>;
+    /** Array of completed/backfilled intervals */
+    completed_intervals: Array<CompletedInterval>;
+    /** Array of intervals not described (with reason) */
+    not_described_intervals: Array<NotDescribedInterval>;
+    /** BRO registration history */
+    registration_history: RegistrationHistory | null;
+    /** Report history with events */
+    report_history: ReportHistory | null;
+    /** Delivery context (e.g., "publiekeTaak") */
+    delivery_context: string | null;
+    /** Survey purpose (e.g., "bouwwerk") */
+    survey_purpose: string | null;
+    /** Discipline (e.g., "geotechniek") */
+    discipline: string | null;
+    /** Survey procedure standard (e.g., "EN1997d2v2007") */
+    survey_procedure: string | null;
+    /** Whether site characteristics were determined */
+    site_characteristic_determined: boolean | null;
+}
+/**
+ * BHR-G (Geological Borehole) layer data
+ *
+ * Contains all fields from the BRO BHR-G schema for a single soil layer.
+ */
+export interface BHRGLayer {
+    upperBoundary: number;
+    lowerBoundary: number;
+    upperBoundaryDetermination?: string | null;
+    lowerBoundaryDetermination?: string | null;
+    soilNameNEN5104: string;
+    color?: string;
+    /** Whether the layer is anthropogenic (man-made) - uses string codes in BHR-G (ja/nee/onbekend) */
+    anthropogenic?: string | null;
+    /** Whether the layer is rooted - uses string codes in BHR-G (ja/nee/onbekend) */
+    rooted?: string | null;
+    organicMatterContentClassNEN5104?: string | null;
+    gravelContentClass?: string | null;
+    carbonateContentClass?: string | null;
+    sandMedianClass?: string | null;
+}
+/**
+ * Complete BHR-G (Geological Borehole) data (metadata + layers)
+ */
+export interface BHRGData {
+    /**
+     * Metadata about the parsed document (schema version, warnings)
+     */
+    meta: ParseMeta;
+    bro_id: string | null;
+    /**
+     * User-defined identifier (not parsed from XML)
+     */
+    alias?: string;
+    /**
+     * BRO quality regime
+     *
+     * - IMBRO: Strict regime (all mandatory fields required)
+     * - IMBRO/A: Relaxed regime for historical data (allows missing fields)
+     */
+    quality_regime: QualityRegime | null;
+    research_report_date: Date | null;
+    delivered_location: Location | null;
+    standardized_location: Location | null;
+    delivered_vertical_position_offset: number | null;
+    delivered_vertical_position_datum: string | null;
+    delivered_vertical_position_reference_point: string | null;
+    description_procedure: string | null;
+    bore_rock_reached: boolean | null;
+    final_bore_depth: number | null;
+    final_sample_depth: number | null;
+    bore_hole_completed: string | null;
+    /** Start date of the boring operation */
+    boring_start_date: Date | null;
+    /** End date of the boring operation */
+    boring_end_date: Date | null;
+    /** Boring procedure standard used */
+    boring_procedure: string | null;
+    /** Boring technique used */
+    boring_technique: string | null;
+    /** Whether the trajectory was excavated */
+    trajectory_excavated: boolean | null;
+    /** Whether the subsurface is contaminated */
+    subsurface_contaminated: boolean | null;
+    /** Stop criterion for boring */
+    stop_criterion: string | null;
+    /** Sampling procedure standard */
+    sampling_procedure: string | null;
+    /** Sampling method used */
+    sampling_method: string | null;
+    /** Sampling quality assessment */
+    sampling_quality: string | null;
+    /** Description quality assessment */
+    description_quality: string | null;
+    /** Described samples quality */
+    described_samples_quality: string | null;
+    /** Description location (field/lab) */
+    description_location: string | null;
+    /** Date of description report */
+    description_report_date: Date | null;
+    /** Described material type */
+    described_material: string | null;
+    /** Whether sampling was continuous */
+    continuously_sampled: boolean | null;
+    /** Sample moistness during description */
+    sample_moistness: string | null;
+    data: Array<BHRGLayer>;
+    /** Array of bored intervals with technique and diameter */
+    bored_intervals: Array<BoredInterval>;
+    /** Array of sampled intervals with method and quality */
+    sampled_intervals: Array<SampledInterval>;
+    /** BRO registration history */
+    registration_history: RegistrationHistory | null;
+    /** Report history with events */
+    report_history: ReportHistory | null;
+    /** Delivery context (e.g., "archiefoverdracht") */
+    delivery_context: string | null;
+    /** Survey purpose */
+    survey_purpose: string | null;
+    /** Discipline (e.g., "geologie") */
+    discipline: string | null;
+    /** Survey procedure standard */
+    survey_procedure: string | null;
+    /** NITG code (legacy identifier) */
+    nitg_code: string | null;
+}
+/**
+ * Bored interval - records boring technique and diameter at specific depth ranges
+ */
+export interface BoredInterval {
+    beginDepth: number;
+    endDepth: number;
+    boringTechnique: string | null;
+    boredDiameter: number | null;
+}
+/**
+ * Sampler equipment details within a sampled interval
+ */
+export interface SamplerDetails {
+    samplerType: string | null;
+    sampleContainerDiameter: number | null;
+    sampleContainerLength: number | null;
+    cuttingShoeInsideDiameter: number | null;
+    cuttingShoeOutsideDiameter: number | null;
+    stockingUsed: boolean | null;
+    rightAngledCuttingShoe: boolean | null;
+    taperAngle: number | null;
+    lubricationFluidUsed: boolean | null;
+    coreCatcherPresent: boolean | null;
+    pistonPresent: boolean | null;
+}
+/**
+ * Sampled interval - records sampling method and quality at specific depth ranges
+ */
+export interface SampledInterval {
+    beginDepth: number;
+    endDepth: number;
+    preTreatment: string | null;
+    samplingMethod: string | null;
+    samplingQuality: string | null;
+    orientatedSampled: boolean | null;
+    sampler?: SamplerDetails;
+}
+/**
+ * Completed interval - records how the borehole was completed/backfilled
+ */
+export interface CompletedInterval {
+    beginDepth: number;
+    endDepth: number;
+    permanentCasingPresent: boolean | null;
+    backfillMaterial: string | null;
+    backfillMaterialWashed: boolean | null;
+    backfillMaterialCertified: boolean | null;
+}
+/**
+ * Not described interval - records depth ranges that were not described and why
+ */
+export interface NotDescribedInterval {
+    beginDepth: number;
+    endDepth: number;
+    noDescriptionReason: string | null;
+}
+/**
+ * Intermediate event in report history
+ */
+export interface IntermediateEvent {
+    eventName: string | null;
+    eventDate: Date | null;
+}
+/**
+ * Registration history - BRO administrative registration information
+ */
+export interface RegistrationHistory {
+    objectRegistrationTime: Date | null;
+    registrationStatus: string | null;
+    registrationCompletionTime: Date | null;
+    corrected: boolean | null;
+    underReview: boolean | null;
+    deregistered: boolean | null;
+    reregistered: boolean | null;
+}
+/**
+ * Report history - records when and how data was reported
+ */
+export interface ReportHistory {
+    reportStartDate: Date | null;
+    reportEndDate: Date | null;
+    intermediateEvents: Array<IntermediateEvent>;
+}
+/**
+ * BHR-GT-BMA (Borehole Sample Analysis) - Laboratory Determinations
+ */
+/**
+ * Water content determination result
+ */
+export interface WaterContentDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    sampleMoistness: string | null;
+    removedMaterial: string | null;
+    waterContent: number | null;
+    dryingTemperature: string | null;
+    dryingPeriod: string | null;
+    saltCorrectionMethod: string | null;
+}
+/**
+ * Volumetric mass density (bulk density) determination result
+ */
+export interface VolumetricMassDensityDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    sampleMoistness: string | null;
+    volumetricMassDensity: number | null;
+}
+/**
+ * Organic matter content determination result
+ */
+export interface OrganicMatterContentDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    removedMaterial: string | null;
+    organicMatterContent: number | null;
+}
+/**
+ * Carbonate content determination result
+ */
+export interface CarbonateContentDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    removedMaterial: string | null;
+    carbonateContent: number | null;
+}
+/**
+ * Volumetric mass density of solids determination result
+ */
+export interface VolumetricMassDensityOfSolidsDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    liquidUsed: string | null;
+    volumetricMassDensityOfSolids: number | null;
+}
+/**
+ * Particle size distribution determination result
+ * Contains detailed grain size fractions
+ */
+export interface ParticleSizeDistributionDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    fractionDistribution: string | null;
+    dispersionMethod: string | null;
+    removedMaterial: string | null;
+    equivalentMassDeterminationMethod: string | null;
+    equivalentMass: number | null;
+    fractionSmaller63um: number | null;
+    fractionLarger63um: number | null;
+    fraction0to2um?: number | null;
+    fraction2to4um?: number | null;
+    fraction4to8um?: number | null;
+    fraction8to16um?: number | null;
+    fraction16to32um?: number | null;
+    fraction32to50um?: number | null;
+    fraction50to63um?: number | null;
+    fraction63to90um?: number | null;
+    fraction90to125um?: number | null;
+    fraction125to180um?: number | null;
+    fraction180to250um?: number | null;
+    fraction250to355um?: number | null;
+    fraction355to500um?: number | null;
+    fraction500to710um?: number | null;
+    fraction710to1000um?: number | null;
+    fraction1000to1400um?: number | null;
+    fraction1400umto2mm?: number | null;
+    fraction2to4mm?: number | null;
+    fraction4to8mm?: number | null;
+    fraction8to16mm?: number | null;
+    fraction16to31_5mm?: number | null;
+    fraction31_5to63mm?: number | null;
+    fractionLarger63mm?: number | null;
+}
+/**
+ * Plasticity data point for Atterberg limits test
+ * Used to construct the plasticity curve (Casagrande)
+ */
+export interface PlasticityAtSpecificWaterContent {
+    waterContent: number;
+    numberOfFalls: number;
+}
+/**
+ * Consistency limits determination (Atterberg limits)
+ * Used to determine soil plasticity characteristics
+ */
+export interface ConsistencyLimitsDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    fractionLarger500um: number | null;
+    usedMedium: string | null;
+    performanceIrregularity: string | null;
+    liquidLimit: number | null;
+    plasticLimit: number | null;
+    plasticityIndex: number | null;
+    plasticityAtSpecificWaterContent: Array<PlasticityAtSpecificWaterContent>;
+}
+/**
+ * Height measurement at specific time during settlement test
+ * Used to construct compression/consolidation curves
+ */
+export interface HeightAtSpecificTime {
+    time: number;
+    height: number;
+}
+/**
+ * Single loading step in settlement characteristics test
+ * Represents one stress increment in oedometer/consolidation test
+ */
+export interface SettlementDeterminationStep {
+    stepNumber: number;
+    wetPerformed: boolean | null;
+    swellObserved: boolean | null;
+    strainPoint24hours: number | null;
+    stepType: string | null;
+    verticalStress: number | null;
+    heightChangeDuringSettlement: Array<HeightAtSpecificTime>;
+}
+/**
+ * Settlement characteristics determination (oedometer/consolidation test)
+ * Used to determine soil compressibility and consolidation behavior
+ */
+export interface SettlementCharacteristicsDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    ringDiameter: number | null;
+    sampleMoistness: string | null;
+    filterPaperUsed: boolean | null;
+    temperature: number | null;
+    wallFrictionCorrectionMethod: string | null;
+    apparatusDeformationApplied: boolean | null;
+    bearingFrictionCorrectionApplied: boolean | null;
+    irregularResult: boolean | null;
+    determinationSteps: Array<SettlementDeterminationStep>;
+}
+/**
+ * Permeability at specific density measurement
+ */
+export interface SaturatedPermeabilityAtSpecificDensity {
+    dryVolumetricMassDensity: number | null;
+    saturatedPermeability: number | null;
+}
+/**
+ * Saturated permeability determination (hydraulic conductivity)
+ * Used to determine water flow characteristics through soil
+ */
+export interface SaturatedPermeabilityDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    specimenMade: boolean | null;
+    saturatedWithCO2: boolean | null;
+    verticallyDetermined: boolean | null;
+    currentDownwards: boolean | null;
+    usedMedium: string | null;
+    waterDegassed: boolean | null;
+    temperature: number | null;
+    maximumGradient: number | null;
+    saturatedPermeabilityAtSpecificDensity: Array<SaturatedPermeabilityAtSpecificDensity>;
+}
+/**
+ * Membrane correction data for triaxial test
+ * Corrects for membrane stiffness effects during testing
+ */
+export interface MembraneCorrection {
+    correctionMethod: string | null;
+    thickness: number | null;
+    stiffnessClass: string | null;
+}
+/**
+ * Drainage strip correction data for triaxial test
+ * Corrects for drainage strip effects during testing
+ */
+export interface DrainageStripCorrection {
+    correctionMethod: string | null;
+    orientation: string | null;
+    coverage: string | null;
+}
+/**
+ * Saturation stage data for triaxial test
+ * Documents sample saturation process before testing
+ */
+export interface SaturationStageAtLoading {
+    porousDiscWet: boolean | null;
+    porousDiscRough: boolean | null;
+    usedMedium: string | null;
+    constantHeight: boolean | null;
+    cellPressureAutomaticallyControlled: boolean | null;
+    backPressure: number | null;
+    effectivePressure: number | null;
+    skemptonB_Coefficient: number | null;
+    disturbanceInduced: boolean | null;
+}
+/**
+ * Volume change measurement at specific time during consolidation
+ */
+export interface VolumeChangeAtSpecificTime {
+    time: number;
+    volumeChange: number;
+}
+/**
+ * Consolidation stage data for triaxial test
+ * Documents specimen consolidation under specified stresses
+ */
+export interface ConsolidationStageAtLoading {
+    drainageTwoSided: boolean | null;
+    consolidationMethod: string | null;
+    verticalConsolidationStress: number | null;
+    horizontalConsolidationStress: number | null;
+    verticalStrain: number | null;
+    lateralEarthPressureCoefficient: number | null;
+    volumeChangeDuringConsolidation: Array<VolumeChangeAtSpecificTime>;
+}
+/**
+ * Shear stress measurement at specific strain during loading
+ * Used to construct stress-strain curves for soil strength analysis
+ */
+export interface ShearStressAtSpecificStrain {
+    time: number;
+    axialStrain: number;
+    deviatorStress: number;
+    cellPressure: number;
+    porePressure?: number | null;
+    volumeChange?: number | null;
+}
+/**
+ * Load stage data for triaxial test
+ * Documents the shearing/loading phase of the test
+ */
+export interface LoadStage {
+    deformationRate: number | null;
+    specimenShape: string | null;
+    shearStressChangeDuringLoading: Array<ShearStressAtSpecificStrain>;
+}
+/**
+ * Shear stress change during loading determination (triaxial/direct shear test)
+ * ISO 17892-9 (triaxial) or ISO 17892-10 (direct shear)
+ *
+ * Measures soil shear strength and stress-strain behavior under controlled loading.
+ * Common test types:
+ * - CU: Consolidated Undrained (belastenGeconsolideerdOngedraineerd)
+ * - CD: Consolidated Drained (belastenGeconsolideerdGedraineerd)
+ * - UU: Unconsolidated Undrained (belastenOngeconsolideerdOngedraineerd)
+ */
+export interface ShearStressChangeDuringLoadingDetermination {
+    determinationProcedure: string | null;
+    determinationMethod: string | null;
+    specimenDisturbed: boolean | null;
+    specimenTrimmed: boolean | null;
+    sampleMoistness: string | null;
+    beginDiameter: number | null;
+    beginHeight: number | null;
+    topCapTiltable: boolean | null;
+    filterPaperUsed: boolean | null;
+    drainageStripsUsed: boolean | null;
+    membraneSaturatedBefore: boolean | null;
+    apparatusDeformationApplied: boolean | null;
+    cellDeformationApplied: boolean | null;
+    stopCriterion: string | null;
+    membraneCorrection?: MembraneCorrection;
+    drainageStripCorrection?: DrainageStripCorrection;
+    saturationStageAtLoading?: SaturationStageAtLoading;
+    consolidationStageAtLoading?: ConsolidationStageAtLoading;
+    loadStage?: LoadStage;
+}
+/**
+ * Investigated interval with laboratory determinations
+ * Each interval represents a depth range with analysis results
+ */
+export interface InvestigatedInterval {
+    beginDepth: number;
+    endDepth: number;
+    sampleQuality: string | null;
+    analysisType: string | null;
+    waterContentDetermined: boolean | null;
+    organicMatterContentDetermined: boolean | null;
+    carbonateContentDetermined: boolean | null;
+    volumetricMassDensityDetermined: boolean | null;
+    volumetricMassDensitySolidsDetermined: boolean | null;
+    described: boolean | null;
+    waterContentDetermination?: WaterContentDetermination;
+    organicMatterContentDetermination?: OrganicMatterContentDetermination;
+    carbonateContentDetermination?: CarbonateContentDetermination;
+    volumetricMassDensityDetermination?: VolumetricMassDensityDetermination;
+    volumetricMassDensityOfSolidsDetermination?: VolumetricMassDensityOfSolidsDetermination;
+    particleSizeDistributionDetermination?: ParticleSizeDistributionDetermination;
+    consistencyLimitsDetermination?: ConsistencyLimitsDetermination;
+    settlementCharacteristicsDetermination?: SettlementCharacteristicsDetermination;
+    saturatedPermeabilityDetermination?: SaturatedPermeabilityDetermination;
+    shearStressChangeDuringLoadingDetermination?: Array<ShearStressChangeDuringLoadingDetermination>;
+}
+/**
+ * Borehole sample analysis data (BHR-GT-BMA)
+ * Contains laboratory test results for soil samples
+ */
+export interface BoreholeSampleAnalysis {
+    analysisReportDate: Date | null;
+    analysisProcedure: string | null;
+    investigatedIntervals: Array<InvestigatedInterval>;
+}
+/**
+ * Configuration for determination type parsing in registry pattern
+ */
+export interface DeterminationConfig<T> {
+    xpath: string;
+    propertyName: keyof InvestigatedInterval;
+    parser: (node: Node, adapter: XMLAdapter, namespaces: Namespaces) => T;
+}
+/**
+ * Union type for all BRO data types
+ *
+ * Use the `meta.dataType` field to discriminate between types:
+ * ```typescript
+ * const data = parser.parse(xmlText);
+ * if (data.meta.dataType === 'CPT') {
+ *   // data is CPTData
+ * }
+ * ```
+ */
+export type BROData = CPTData | BHRGTData | BHRGData;
+/**
+ * BRO file type identifier
+ */
+export type BROFileType = 'CPT' | 'BHR-GT' | 'BHR-G';
+/**
+ * Parse error with context
+ */
+export declare class BROParseError extends Error {
+    readonly code: string;
+    readonly details: Record<string, unknown>;
+    constructor(message: string, details: {
+        code: string;
+        [key: string]: unknown;
+    });
+}
+//# sourceMappingURL=index.d.ts.map