@welldot/core 0.4.0-next.20261014.26249fd → 0.4.0

package/dist/index.d.cts

@@ -15160,6 +15160,11 @@ declare function calculatedWellDepth(well: Well): number;
  * Serializes a {@link Well} object into a versioned JSON string suitable for
  * storage or transmission.
  *
+ * Root members the spec does not define (`x-` fields and blocks, foreign
+ * members) are written after the spec blocks, unchanged. Nested unknown
+ * members travel inside their objects. Legacy v1 keys (`lat`, `lng`,
+ * `elevation`, …) are never written.
+ *
  * @param well - The well profile to serialize.
  * @returns A JSON string containing the versioned well payload.
  */
@@ -15173,6 +15178,16 @@ declare function serializeWell(well: Well): string;
  * @returns `true` if the well is considered empty, `false` otherwise.
  */
 declare function isWellEmpty(well: Well | null | undefined): boolean;
+/**
+ * Returns `true` when the well holds any data at all: a profile (see
+ * {@link isWellEmpty}) or any other filled root member — identification,
+ * location, events, samples, permits, `x-` members, … A registry record
+ * with no construction or geology is not empty by this measure, while
+ * {@link isWellEmpty} (nothing to draw) still says it is.
+ *
+ * @param well - The well to check. `null` / `undefined` hold no data.
+ */
+declare function hasWellData(well: Well | null | undefined): boolean;
 /**
  * Returns a copy of `well` with hidden sections and fields cleared: array
  * fields become `[]` and optional fields become `undefined`, so the result
@@ -15184,6 +15199,10 @@ declare function isWellEmpty(well: Well | null | undefined): boolean;
  * hidden. Hiding a record type does not rewrite references to it held by
  * visible records (e.g. a production entry's `meter_id`).
  *
+ * Root members the spec does not define (`x-` fields and blocks) can hold
+ * anything, so they are kept only when nothing is hidden. Unknown members
+ * nested in a record follow that record.
+ *
  * @param well - The well profile to redact.
  * @param visibility - Section and/or field visibility. A {@link SectionVisibility} works as-is.
  * @returns A new {@link Well} with hidden parts emptied.
@@ -15535,4 +15554,4 @@ declare function turbidityCodeForUnit(unit: string): 'turbidity' | 'turbidity_nt
  */
 declare function expandedToStandardUncertainty(expanded: number, coverageFactor?: number): number;
 
-export { AQUIFER_ANALYSIS_METHODS, type AirliftEvent, AirliftEventSchema, type AquiferAnalysis, type AquiferAnalysisMethod, AquiferAnalysisSchema, type Attachment, type AttachmentDocumentType, AttachmentSchema, BLANK_SAMPLE_TYPES, BR_GM_MS_888_2021, type BoreHole, BoreHoleSchema, CEMENT_PAD_TYPES, CENTRALIZER_TYPES, CONDITION_CATEGORIES, CONSTRUCTION_MATERIALS, type Cave, CaveSchema, type CementPad, CementPadSchema, type CementPadType, type Centralizer, CentralizerSchema, type CentralizerType, type ConcentrationUnits, type ConditionCategory, type ConditionFulfillment, ConditionFulfillmentSchema, type ConstantRateEvent, ConstantRateEventSchema, type ConstructionMaterial, type Constructive, DOCUMENT_TYPES, DOCUMENT_TYPE_SUGGESTIONS, DRILLING_METHODS, type DiameterUnits, type DmsCoordinate, type DocumentTypeContext, type DrillingMethod, ESTIMATION_METHODS, EU_2020_2184, type EstimatedVolume, EstimatedVolumeSchema, type EstimationMethod, FGDC_TEXTURES_OPTIONS, FILTRATION_LOCATION_VALUES, FRACTION_VALUES, type Filtration, FiltrationSchema, type FlowUnits, type Fracture, FractureSchema, type Geologic, HISTORY_LOG_CATEGORIES, HISTORY_LOG_SEVERITIES, HYDRODYNAMIC_EVENT_TYPES, type HistoryLogCategory, type HistoryLogEntry, HistoryLogEntrySchema, type HistoryLogSeverity, type HoleFill, HoleFillSchema, type HydrodynamicEvent, type HydrodynamicEventBase, HydrodynamicEventBaseSchema, HydrodynamicEventSchema, type Laboratory, LaboratorySchema, type LanguageText, type LanguageTextInput, type LengthUnits, type LevelReading, LevelReadingSchema, type Limit, type LimitBasis, type LimitSet, type Lithology, LithologySchema, type Location, type LocationProperties, LocationPropertiesSchema, LocationSchema, MAINTENANCE_TYPES, MEASURED_IN_VALUES, MEASUREMENT_LOCATIONS, MEASUREMENT_METHODS, METER_TYPES, type MaintenanceType, type MeasurementMethod, type Meter, type MeterReading, MeterReadingSchema, MeterSchema, type MeterType, type MonthlyGrant, MonthlyGrantSchema, NEPHELOMETRIC_TURBIDITY_CODES, NUMERIC_QUALIFIERS, type OpenVocab, type OperatingRegime, OperatingRegimeSchema, PARAMETER_GROUPS, PARAMETER_GROUP_VALUES, PARENT_SAMPLE_TYPES, PERMIT_ADMINISTRATIVE_STATUSES, PERMIT_ADMINISTRATIVE_STATUS_VALUES, PERMIT_HISTORY_TYPES, PERMIT_TYPES, POWER_SOURCES, PRODUCTION_ENTRY_TYPES, PUMP_TYPES, type Parameter, type ParameterDefinition, type ParameterForm, type ParameterGroup, ParameterSchema, type ParameterUnit, type Permit, type PermitAdministrativeStatus, PermitAdministrativeStatusSchema, type PermitCondition, PermitConditionSchema, type PermitHistoryEntry, PermitHistoryEntrySchema, type PermitHistoryType, PermitSchema, type PermitType, type PowerSource, type PowerUnits, type ProductionEntry, type ProductionEntryBase, ProductionEntryBaseSchema, ProductionEntrySchema, type Well as Profile, type PumpElectrical, PumpElectricalSchema, type PumpInstallation, PumpInstallationSchema, type PumpType, type PumpingStep, PumpingStepSchema, type Purge, type PurgeReading, PurgeReadingSchema, PurgeSchema, QUALIFIER_VALUES, READING_SOURCES, RESULT_FRACTIONS, RESULT_QUALIFIERS, type ReadingSource, type RecoveryOnlyEvent, RecoveryOnlyEventSchema, type RecoveryPhase, RecoveryPhaseSchema, type Reduction, ReductionSchema, type ResultQualifier, ResultQualifierSchema, type ResultValidation, ResultValidationSchema, SAMPLE_TYPES, SAMPLING_DEVICES, SAMPLING_METHODS, SAMPLING_POINT_TYPES, SCREEN_SLOT_TYPES, SECTION_KEYS, type SampleType, type SamplingDevice, type SamplingMethod, type SamplingPoint, SamplingPointSchema, type SamplingPointType, type ScreenSlotType, type SectionKey, type SectionVisibility, type SpotMeasurementEvent, SpotMeasurementEventSchema, type StepDrawdownEvent, StepDrawdownEventSchema, type SurfaceCase, SurfaceCaseSchema, type Texture, type TextureCode, type TextureOption, TextureSchema, type TimeResolution, TimeResolutionSchema, type Units, type UnitsTypes, VALIDATION_STATUSES, VALIDATION_STATUS_VALUES, VISIBILITY_LEAF_KEYS, VISIBILITY_TREE, VOLUME_LIMIT_PERIODS, type VisibilityFieldKey, type VisibilityKey, type VocabEntry, type VolumeLimit, VolumeLimitSchema, type VolumeUnits, WATER_QUALITY_LIMIT_SETS, WATER_QUALITY_PARAMETERS, WATER_QUALITY_UNITS, WATER_QUALITY_VOCABULARY_VERSION, WATER_USES, WELL_PURPOSES, WELL_STATUSES, WELL_STATUS_VALUES, WELL_TYPES, WHO_GDWQ_2022, type WaterQualityResult, WaterQualityResultSchema, type WaterSample, WaterSampleSchema, type WaterUse, type Well, type WellCase, WellCaseSchema, type WellId, WellIdSchema, type WellPurpose, WellSchema, type WellScreen, WellScreenSchema, type WellStatus, WellStatusSchema, type WellType, type WellVisibility, calculatedWellDepth, checkIfProfileIsEmpty, concentrationFromCanonical, concentrationToCanonical, convertProfileFromJSON, cubicFeetToCubicMeters, cubicMeterPerHourToLitersPerSecond, cubicMeterPerHourToUsGallonsPerMinute, cubicMetersToCubicFeet, cubicMetersToLiters, cubicMetersToUsGallons, cvToKilowatts, decimalDegreesToDms, deserializeWell, dmsToDecimalDegrees, expandedToStandardUncertainty, feetToMeters, flowFromCanonical, flowToCanonical, formatVocabList, getLimitSet, getParameterDefinition, getParameterLabel, getVocabEntry, getVocabLabel, hoursToMinutes, hpToKilowatts, inchesToMm, isKnownParameter, isVocabValue, isWellEmpty, kilopascalToPsi, kilowattsToCv, kilowattsToHp, litersPerSecondToCubicMeterPerHour, litersToCubicMeters, metersToFeet, milliSiemensPerCmToMicroSiemensPerCm, milliSiemensPerMeterToMicroSiemensPerCm, minutesToHours, mmToInches, mmToSlotNumber, normalizeColorUnit, parameterKey, parseWell, powerFromCanonical, powerToCanonical, profileToWell, psiToKilopascal, redactWell, resolveLanguageText, serializeWell, slotNumberToMm, squareMeterPerDayToSquareMeterPerSecond, squareMeterPerSecondToSquareMeterPerDay, turbidityCodeForUnit, usGallonsPerMinuteToCubicMeterPerHour, usGallonsToCubicMeters, vocabValues, volumeFromCanonical, volumeToCanonical };
+export { AQUIFER_ANALYSIS_METHODS, type AirliftEvent, AirliftEventSchema, type AquiferAnalysis, type AquiferAnalysisMethod, AquiferAnalysisSchema, type Attachment, type AttachmentDocumentType, AttachmentSchema, BLANK_SAMPLE_TYPES, BR_GM_MS_888_2021, type BoreHole, BoreHoleSchema, CEMENT_PAD_TYPES, CENTRALIZER_TYPES, CONDITION_CATEGORIES, CONSTRUCTION_MATERIALS, type Cave, CaveSchema, type CementPad, CementPadSchema, type CementPadType, type Centralizer, CentralizerSchema, type CentralizerType, type ConcentrationUnits, type ConditionCategory, type ConditionFulfillment, ConditionFulfillmentSchema, type ConstantRateEvent, ConstantRateEventSchema, type ConstructionMaterial, type Constructive, DOCUMENT_TYPES, DOCUMENT_TYPE_SUGGESTIONS, DRILLING_METHODS, type DiameterUnits, type DmsCoordinate, type DocumentTypeContext, type DrillingMethod, ESTIMATION_METHODS, EU_2020_2184, type EstimatedVolume, EstimatedVolumeSchema, type EstimationMethod, FGDC_TEXTURES_OPTIONS, FILTRATION_LOCATION_VALUES, FRACTION_VALUES, type Filtration, FiltrationSchema, type FlowUnits, type Fracture, FractureSchema, type Geologic, HISTORY_LOG_CATEGORIES, HISTORY_LOG_SEVERITIES, HYDRODYNAMIC_EVENT_TYPES, type HistoryLogCategory, type HistoryLogEntry, HistoryLogEntrySchema, type HistoryLogSeverity, type HoleFill, HoleFillSchema, type HydrodynamicEvent, type HydrodynamicEventBase, HydrodynamicEventBaseSchema, HydrodynamicEventSchema, type Laboratory, LaboratorySchema, type LanguageText, type LanguageTextInput, type LengthUnits, type LevelReading, LevelReadingSchema, type Limit, type LimitBasis, type LimitSet, type Lithology, LithologySchema, type Location, type LocationProperties, LocationPropertiesSchema, LocationSchema, MAINTENANCE_TYPES, MEASURED_IN_VALUES, MEASUREMENT_LOCATIONS, MEASUREMENT_METHODS, METER_TYPES, type MaintenanceType, type MeasurementMethod, type Meter, type MeterReading, MeterReadingSchema, MeterSchema, type MeterType, type MonthlyGrant, MonthlyGrantSchema, NEPHELOMETRIC_TURBIDITY_CODES, NUMERIC_QUALIFIERS, type OpenVocab, type OperatingRegime, OperatingRegimeSchema, PARAMETER_GROUPS, PARAMETER_GROUP_VALUES, PARENT_SAMPLE_TYPES, PERMIT_ADMINISTRATIVE_STATUSES, PERMIT_ADMINISTRATIVE_STATUS_VALUES, PERMIT_HISTORY_TYPES, PERMIT_TYPES, POWER_SOURCES, PRODUCTION_ENTRY_TYPES, PUMP_TYPES, type Parameter, type ParameterDefinition, type ParameterForm, type ParameterGroup, ParameterSchema, type ParameterUnit, type Permit, type PermitAdministrativeStatus, PermitAdministrativeStatusSchema, type PermitCondition, PermitConditionSchema, type PermitHistoryEntry, PermitHistoryEntrySchema, type PermitHistoryType, PermitSchema, type PermitType, type PowerSource, type PowerUnits, type ProductionEntry, type ProductionEntryBase, ProductionEntryBaseSchema, ProductionEntrySchema, type Well as Profile, type PumpElectrical, PumpElectricalSchema, type PumpInstallation, PumpInstallationSchema, type PumpType, type PumpingStep, PumpingStepSchema, type Purge, type PurgeReading, PurgeReadingSchema, PurgeSchema, QUALIFIER_VALUES, READING_SOURCES, RESULT_FRACTIONS, RESULT_QUALIFIERS, type ReadingSource, type RecoveryOnlyEvent, RecoveryOnlyEventSchema, type RecoveryPhase, RecoveryPhaseSchema, type Reduction, ReductionSchema, type ResultQualifier, ResultQualifierSchema, type ResultValidation, ResultValidationSchema, SAMPLE_TYPES, SAMPLING_DEVICES, SAMPLING_METHODS, SAMPLING_POINT_TYPES, SCREEN_SLOT_TYPES, SECTION_KEYS, type SampleType, type SamplingDevice, type SamplingMethod, type SamplingPoint, SamplingPointSchema, type SamplingPointType, type ScreenSlotType, type SectionKey, type SectionVisibility, type SpotMeasurementEvent, SpotMeasurementEventSchema, type StepDrawdownEvent, StepDrawdownEventSchema, type SurfaceCase, SurfaceCaseSchema, type Texture, type TextureCode, type TextureOption, TextureSchema, type TimeResolution, TimeResolutionSchema, type Units, type UnitsTypes, VALIDATION_STATUSES, VALIDATION_STATUS_VALUES, VISIBILITY_LEAF_KEYS, VISIBILITY_TREE, VOLUME_LIMIT_PERIODS, type VisibilityFieldKey, type VisibilityKey, type VocabEntry, type VolumeLimit, VolumeLimitSchema, type VolumeUnits, WATER_QUALITY_LIMIT_SETS, WATER_QUALITY_PARAMETERS, WATER_QUALITY_UNITS, WATER_QUALITY_VOCABULARY_VERSION, WATER_USES, WELL_PURPOSES, WELL_STATUSES, WELL_STATUS_VALUES, WELL_TYPES, WHO_GDWQ_2022, type WaterQualityResult, WaterQualityResultSchema, type WaterSample, WaterSampleSchema, type WaterUse, type Well, type WellCase, WellCaseSchema, type WellId, WellIdSchema, type WellPurpose, WellSchema, type WellScreen, WellScreenSchema, type WellStatus, WellStatusSchema, type WellType, type WellVisibility, calculatedWellDepth, checkIfProfileIsEmpty, concentrationFromCanonical, concentrationToCanonical, convertProfileFromJSON, cubicFeetToCubicMeters, cubicMeterPerHourToLitersPerSecond, cubicMeterPerHourToUsGallonsPerMinute, cubicMetersToCubicFeet, cubicMetersToLiters, cubicMetersToUsGallons, cvToKilowatts, decimalDegreesToDms, deserializeWell, dmsToDecimalDegrees, expandedToStandardUncertainty, feetToMeters, flowFromCanonical, flowToCanonical, formatVocabList, getLimitSet, getParameterDefinition, getParameterLabel, getVocabEntry, getVocabLabel, hasWellData, hoursToMinutes, hpToKilowatts, inchesToMm, isKnownParameter, isVocabValue, isWellEmpty, kilopascalToPsi, kilowattsToCv, kilowattsToHp, litersPerSecondToCubicMeterPerHour, litersToCubicMeters, metersToFeet, milliSiemensPerCmToMicroSiemensPerCm, milliSiemensPerMeterToMicroSiemensPerCm, minutesToHours, mmToInches, mmToSlotNumber, normalizeColorUnit, parameterKey, parseWell, powerFromCanonical, powerToCanonical, profileToWell, psiToKilopascal, redactWell, resolveLanguageText, serializeWell, slotNumberToMm, squareMeterPerDayToSquareMeterPerSecond, squareMeterPerSecondToSquareMeterPerDay, turbidityCodeForUnit, usGallonsPerMinuteToCubicMeterPerHour, usGallonsToCubicMeters, vocabValues, volumeFromCanonical, volumeToCanonical };

package/dist/index.d.ts

@@ -15160,6 +15160,11 @@ declare function calculatedWellDepth(well: Well): number;
  * Serializes a {@link Well} object into a versioned JSON string suitable for
  * storage or transmission.
  *
+ * Root members the spec does not define (`x-` fields and blocks, foreign
+ * members) are written after the spec blocks, unchanged. Nested unknown
+ * members travel inside their objects. Legacy v1 keys (`lat`, `lng`,
+ * `elevation`, …) are never written.
+ *
  * @param well - The well profile to serialize.
  * @returns A JSON string containing the versioned well payload.
  */
@@ -15173,6 +15178,16 @@ declare function serializeWell(well: Well): string;
  * @returns `true` if the well is considered empty, `false` otherwise.
  */
 declare function isWellEmpty(well: Well | null | undefined): boolean;
+/**
+ * Returns `true` when the well holds any data at all: a profile (see
+ * {@link isWellEmpty}) or any other filled root member — identification,
+ * location, events, samples, permits, `x-` members, … A registry record
+ * with no construction or geology is not empty by this measure, while
+ * {@link isWellEmpty} (nothing to draw) still says it is.
+ *
+ * @param well - The well to check. `null` / `undefined` hold no data.
+ */
+declare function hasWellData(well: Well | null | undefined): boolean;
 /**
  * Returns a copy of `well` with hidden sections and fields cleared: array
  * fields become `[]` and optional fields become `undefined`, so the result
@@ -15184,6 +15199,10 @@ declare function isWellEmpty(well: Well | null | undefined): boolean;
  * hidden. Hiding a record type does not rewrite references to it held by
  * visible records (e.g. a production entry's `meter_id`).
  *
+ * Root members the spec does not define (`x-` fields and blocks) can hold
+ * anything, so they are kept only when nothing is hidden. Unknown members
+ * nested in a record follow that record.
+ *
  * @param well - The well profile to redact.
  * @param visibility - Section and/or field visibility. A {@link SectionVisibility} works as-is.
  * @returns A new {@link Well} with hidden parts emptied.
@@ -15535,4 +15554,4 @@ declare function turbidityCodeForUnit(unit: string): 'turbidity' | 'turbidity_nt
  */
 declare function expandedToStandardUncertainty(expanded: number, coverageFactor?: number): number;
 
-export { AQUIFER_ANALYSIS_METHODS, type AirliftEvent, AirliftEventSchema, type AquiferAnalysis, type AquiferAnalysisMethod, AquiferAnalysisSchema, type Attachment, type AttachmentDocumentType, AttachmentSchema, BLANK_SAMPLE_TYPES, BR_GM_MS_888_2021, type BoreHole, BoreHoleSchema, CEMENT_PAD_TYPES, CENTRALIZER_TYPES, CONDITION_CATEGORIES, CONSTRUCTION_MATERIALS, type Cave, CaveSchema, type CementPad, CementPadSchema, type CementPadType, type Centralizer, CentralizerSchema, type CentralizerType, type ConcentrationUnits, type ConditionCategory, type ConditionFulfillment, ConditionFulfillmentSchema, type ConstantRateEvent, ConstantRateEventSchema, type ConstructionMaterial, type Constructive, DOCUMENT_TYPES, DOCUMENT_TYPE_SUGGESTIONS, DRILLING_METHODS, type DiameterUnits, type DmsCoordinate, type DocumentTypeContext, type DrillingMethod, ESTIMATION_METHODS, EU_2020_2184, type EstimatedVolume, EstimatedVolumeSchema, type EstimationMethod, FGDC_TEXTURES_OPTIONS, FILTRATION_LOCATION_VALUES, FRACTION_VALUES, type Filtration, FiltrationSchema, type FlowUnits, type Fracture, FractureSchema, type Geologic, HISTORY_LOG_CATEGORIES, HISTORY_LOG_SEVERITIES, HYDRODYNAMIC_EVENT_TYPES, type HistoryLogCategory, type HistoryLogEntry, HistoryLogEntrySchema, type HistoryLogSeverity, type HoleFill, HoleFillSchema, type HydrodynamicEvent, type HydrodynamicEventBase, HydrodynamicEventBaseSchema, HydrodynamicEventSchema, type Laboratory, LaboratorySchema, type LanguageText, type LanguageTextInput, type LengthUnits, type LevelReading, LevelReadingSchema, type Limit, type LimitBasis, type LimitSet, type Lithology, LithologySchema, type Location, type LocationProperties, LocationPropertiesSchema, LocationSchema, MAINTENANCE_TYPES, MEASURED_IN_VALUES, MEASUREMENT_LOCATIONS, MEASUREMENT_METHODS, METER_TYPES, type MaintenanceType, type MeasurementMethod, type Meter, type MeterReading, MeterReadingSchema, MeterSchema, type MeterType, type MonthlyGrant, MonthlyGrantSchema, NEPHELOMETRIC_TURBIDITY_CODES, NUMERIC_QUALIFIERS, type OpenVocab, type OperatingRegime, OperatingRegimeSchema, PARAMETER_GROUPS, PARAMETER_GROUP_VALUES, PARENT_SAMPLE_TYPES, PERMIT_ADMINISTRATIVE_STATUSES, PERMIT_ADMINISTRATIVE_STATUS_VALUES, PERMIT_HISTORY_TYPES, PERMIT_TYPES, POWER_SOURCES, PRODUCTION_ENTRY_TYPES, PUMP_TYPES, type Parameter, type ParameterDefinition, type ParameterForm, type ParameterGroup, ParameterSchema, type ParameterUnit, type Permit, type PermitAdministrativeStatus, PermitAdministrativeStatusSchema, type PermitCondition, PermitConditionSchema, type PermitHistoryEntry, PermitHistoryEntrySchema, type PermitHistoryType, PermitSchema, type PermitType, type PowerSource, type PowerUnits, type ProductionEntry, type ProductionEntryBase, ProductionEntryBaseSchema, ProductionEntrySchema, type Well as Profile, type PumpElectrical, PumpElectricalSchema, type PumpInstallation, PumpInstallationSchema, type PumpType, type PumpingStep, PumpingStepSchema, type Purge, type PurgeReading, PurgeReadingSchema, PurgeSchema, QUALIFIER_VALUES, READING_SOURCES, RESULT_FRACTIONS, RESULT_QUALIFIERS, type ReadingSource, type RecoveryOnlyEvent, RecoveryOnlyEventSchema, type RecoveryPhase, RecoveryPhaseSchema, type Reduction, ReductionSchema, type ResultQualifier, ResultQualifierSchema, type ResultValidation, ResultValidationSchema, SAMPLE_TYPES, SAMPLING_DEVICES, SAMPLING_METHODS, SAMPLING_POINT_TYPES, SCREEN_SLOT_TYPES, SECTION_KEYS, type SampleType, type SamplingDevice, type SamplingMethod, type SamplingPoint, SamplingPointSchema, type SamplingPointType, type ScreenSlotType, type SectionKey, type SectionVisibility, type SpotMeasurementEvent, SpotMeasurementEventSchema, type StepDrawdownEvent, StepDrawdownEventSchema, type SurfaceCase, SurfaceCaseSchema, type Texture, type TextureCode, type TextureOption, TextureSchema, type TimeResolution, TimeResolutionSchema, type Units, type UnitsTypes, VALIDATION_STATUSES, VALIDATION_STATUS_VALUES, VISIBILITY_LEAF_KEYS, VISIBILITY_TREE, VOLUME_LIMIT_PERIODS, type VisibilityFieldKey, type VisibilityKey, type VocabEntry, type VolumeLimit, VolumeLimitSchema, type VolumeUnits, WATER_QUALITY_LIMIT_SETS, WATER_QUALITY_PARAMETERS, WATER_QUALITY_UNITS, WATER_QUALITY_VOCABULARY_VERSION, WATER_USES, WELL_PURPOSES, WELL_STATUSES, WELL_STATUS_VALUES, WELL_TYPES, WHO_GDWQ_2022, type WaterQualityResult, WaterQualityResultSchema, type WaterSample, WaterSampleSchema, type WaterUse, type Well, type WellCase, WellCaseSchema, type WellId, WellIdSchema, type WellPurpose, WellSchema, type WellScreen, WellScreenSchema, type WellStatus, WellStatusSchema, type WellType, type WellVisibility, calculatedWellDepth, checkIfProfileIsEmpty, concentrationFromCanonical, concentrationToCanonical, convertProfileFromJSON, cubicFeetToCubicMeters, cubicMeterPerHourToLitersPerSecond, cubicMeterPerHourToUsGallonsPerMinute, cubicMetersToCubicFeet, cubicMetersToLiters, cubicMetersToUsGallons, cvToKilowatts, decimalDegreesToDms, deserializeWell, dmsToDecimalDegrees, expandedToStandardUncertainty, feetToMeters, flowFromCanonical, flowToCanonical, formatVocabList, getLimitSet, getParameterDefinition, getParameterLabel, getVocabEntry, getVocabLabel, hoursToMinutes, hpToKilowatts, inchesToMm, isKnownParameter, isVocabValue, isWellEmpty, kilopascalToPsi, kilowattsToCv, kilowattsToHp, litersPerSecondToCubicMeterPerHour, litersToCubicMeters, metersToFeet, milliSiemensPerCmToMicroSiemensPerCm, milliSiemensPerMeterToMicroSiemensPerCm, minutesToHours, mmToInches, mmToSlotNumber, normalizeColorUnit, parameterKey, parseWell, powerFromCanonical, powerToCanonical, profileToWell, psiToKilopascal, redactWell, resolveLanguageText, serializeWell, slotNumberToMm, squareMeterPerDayToSquareMeterPerSecond, squareMeterPerSecondToSquareMeterPerDay, turbidityCodeForUnit, usGallonsPerMinuteToCubicMeterPerHour, usGallonsToCubicMeters, vocabValues, volumeFromCanonical, volumeToCanonical };
+export { AQUIFER_ANALYSIS_METHODS, type AirliftEvent, AirliftEventSchema, type AquiferAnalysis, type AquiferAnalysisMethod, AquiferAnalysisSchema, type Attachment, type AttachmentDocumentType, AttachmentSchema, BLANK_SAMPLE_TYPES, BR_GM_MS_888_2021, type BoreHole, BoreHoleSchema, CEMENT_PAD_TYPES, CENTRALIZER_TYPES, CONDITION_CATEGORIES, CONSTRUCTION_MATERIALS, type Cave, CaveSchema, type CementPad, CementPadSchema, type CementPadType, type Centralizer, CentralizerSchema, type CentralizerType, type ConcentrationUnits, type ConditionCategory, type ConditionFulfillment, ConditionFulfillmentSchema, type ConstantRateEvent, ConstantRateEventSchema, type ConstructionMaterial, type Constructive, DOCUMENT_TYPES, DOCUMENT_TYPE_SUGGESTIONS, DRILLING_METHODS, type DiameterUnits, type DmsCoordinate, type DocumentTypeContext, type DrillingMethod, ESTIMATION_METHODS, EU_2020_2184, type EstimatedVolume, EstimatedVolumeSchema, type EstimationMethod, FGDC_TEXTURES_OPTIONS, FILTRATION_LOCATION_VALUES, FRACTION_VALUES, type Filtration, FiltrationSchema, type FlowUnits, type Fracture, FractureSchema, type Geologic, HISTORY_LOG_CATEGORIES, HISTORY_LOG_SEVERITIES, HYDRODYNAMIC_EVENT_TYPES, type HistoryLogCategory, type HistoryLogEntry, HistoryLogEntrySchema, type HistoryLogSeverity, type HoleFill, HoleFillSchema, type HydrodynamicEvent, type HydrodynamicEventBase, HydrodynamicEventBaseSchema, HydrodynamicEventSchema, type Laboratory, LaboratorySchema, type LanguageText, type LanguageTextInput, type LengthUnits, type LevelReading, LevelReadingSchema, type Limit, type LimitBasis, type LimitSet, type Lithology, LithologySchema, type Location, type LocationProperties, LocationPropertiesSchema, LocationSchema, MAINTENANCE_TYPES, MEASURED_IN_VALUES, MEASUREMENT_LOCATIONS, MEASUREMENT_METHODS, METER_TYPES, type MaintenanceType, type MeasurementMethod, type Meter, type MeterReading, MeterReadingSchema, MeterSchema, type MeterType, type MonthlyGrant, MonthlyGrantSchema, NEPHELOMETRIC_TURBIDITY_CODES, NUMERIC_QUALIFIERS, type OpenVocab, type OperatingRegime, OperatingRegimeSchema, PARAMETER_GROUPS, PARAMETER_GROUP_VALUES, PARENT_SAMPLE_TYPES, PERMIT_ADMINISTRATIVE_STATUSES, PERMIT_ADMINISTRATIVE_STATUS_VALUES, PERMIT_HISTORY_TYPES, PERMIT_TYPES, POWER_SOURCES, PRODUCTION_ENTRY_TYPES, PUMP_TYPES, type Parameter, type ParameterDefinition, type ParameterForm, type ParameterGroup, ParameterSchema, type ParameterUnit, type Permit, type PermitAdministrativeStatus, PermitAdministrativeStatusSchema, type PermitCondition, PermitConditionSchema, type PermitHistoryEntry, PermitHistoryEntrySchema, type PermitHistoryType, PermitSchema, type PermitType, type PowerSource, type PowerUnits, type ProductionEntry, type ProductionEntryBase, ProductionEntryBaseSchema, ProductionEntrySchema, type Well as Profile, type PumpElectrical, PumpElectricalSchema, type PumpInstallation, PumpInstallationSchema, type PumpType, type PumpingStep, PumpingStepSchema, type Purge, type PurgeReading, PurgeReadingSchema, PurgeSchema, QUALIFIER_VALUES, READING_SOURCES, RESULT_FRACTIONS, RESULT_QUALIFIERS, type ReadingSource, type RecoveryOnlyEvent, RecoveryOnlyEventSchema, type RecoveryPhase, RecoveryPhaseSchema, type Reduction, ReductionSchema, type ResultQualifier, ResultQualifierSchema, type ResultValidation, ResultValidationSchema, SAMPLE_TYPES, SAMPLING_DEVICES, SAMPLING_METHODS, SAMPLING_POINT_TYPES, SCREEN_SLOT_TYPES, SECTION_KEYS, type SampleType, type SamplingDevice, type SamplingMethod, type SamplingPoint, SamplingPointSchema, type SamplingPointType, type ScreenSlotType, type SectionKey, type SectionVisibility, type SpotMeasurementEvent, SpotMeasurementEventSchema, type StepDrawdownEvent, StepDrawdownEventSchema, type SurfaceCase, SurfaceCaseSchema, type Texture, type TextureCode, type TextureOption, TextureSchema, type TimeResolution, TimeResolutionSchema, type Units, type UnitsTypes, VALIDATION_STATUSES, VALIDATION_STATUS_VALUES, VISIBILITY_LEAF_KEYS, VISIBILITY_TREE, VOLUME_LIMIT_PERIODS, type VisibilityFieldKey, type VisibilityKey, type VocabEntry, type VolumeLimit, VolumeLimitSchema, type VolumeUnits, WATER_QUALITY_LIMIT_SETS, WATER_QUALITY_PARAMETERS, WATER_QUALITY_UNITS, WATER_QUALITY_VOCABULARY_VERSION, WATER_USES, WELL_PURPOSES, WELL_STATUSES, WELL_STATUS_VALUES, WELL_TYPES, WHO_GDWQ_2022, type WaterQualityResult, WaterQualityResultSchema, type WaterSample, WaterSampleSchema, type WaterUse, type Well, type WellCase, WellCaseSchema, type WellId, WellIdSchema, type WellPurpose, WellSchema, type WellScreen, WellScreenSchema, type WellStatus, WellStatusSchema, type WellType, type WellVisibility, calculatedWellDepth, checkIfProfileIsEmpty, concentrationFromCanonical, concentrationToCanonical, convertProfileFromJSON, cubicFeetToCubicMeters, cubicMeterPerHourToLitersPerSecond, cubicMeterPerHourToUsGallonsPerMinute, cubicMetersToCubicFeet, cubicMetersToLiters, cubicMetersToUsGallons, cvToKilowatts, decimalDegreesToDms, deserializeWell, dmsToDecimalDegrees, expandedToStandardUncertainty, feetToMeters, flowFromCanonical, flowToCanonical, formatVocabList, getLimitSet, getParameterDefinition, getParameterLabel, getVocabEntry, getVocabLabel, hasWellData, hoursToMinutes, hpToKilowatts, inchesToMm, isKnownParameter, isVocabValue, isWellEmpty, kilopascalToPsi, kilowattsToCv, kilowattsToHp, litersPerSecondToCubicMeterPerHour, litersToCubicMeters, metersToFeet, milliSiemensPerCmToMicroSiemensPerCm, milliSiemensPerMeterToMicroSiemensPerCm, minutesToHours, mmToInches, mmToSlotNumber, normalizeColorUnit, parameterKey, parseWell, powerFromCanonical, powerToCanonical, profileToWell, psiToKilopascal, redactWell, resolveLanguageText, serializeWell, slotNumberToMm, squareMeterPerDayToSquareMeterPerSecond, squareMeterPerSecondToSquareMeterPerDay, turbidityCodeForUnit, usGallonsPerMinuteToCubicMeterPerHour, usGallonsToCubicMeters, vocabValues, volumeFromCanonical, volumeToCanonical };

package/dist/index.js

@@ -7,6 +7,16 @@ var mergeWell = createDefu((obj, key, value) => {
     return true;
   }
 });
+var isPlainObject = (v) => typeof v === "object" && v !== null && !Array.isArray(v);
+var mergeParsed = createDefu((obj, key, value) => {
+  if (Array.isArray(value)) {
+    const raw = obj[key];
+    obj[key] = Array.isArray(raw) && raw.length === value.length ? value.map(
+      (item, i) => isPlainObject(item) && isPlainObject(raw[i]) ? mergeParsed(item, raw[i]) : item
+    ) : value;
+    return true;
+  }
+});
 var RFC3339_WITH_OFFSET = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})$/;
 var rfc3339 = () => z.string().regex(RFC3339_WITH_OFFSET, "datetime must be RFC 3339 with UTC offset");
 var CALENDAR_DATE = /^\d{4}-\d{2}-\d{2}$/;
@@ -638,7 +648,7 @@ function parseWell(json) {
     }
     if (version === 1) {
       const normalized = normalizeV1Fields(raw);
-      return mergeWell(
+      return mergeParsed(
         WellSchema.parse(normalized),
         normalized
       );
@@ -648,12 +658,20 @@ function parseWell(json) {
   } else {
     raw.version = 2;
   }
-  return mergeWell(WellSchema.parse(raw), raw);
+  return mergeParsed(WellSchema.parse(raw), raw);
 }
 
 // src/utils/well.utils.ts
 var WELL_FORMAT_VERSION = 2;
 var INCHES_TO_MM = 25.4;
+var LEGACY_ROOT_KEYS = /* @__PURE__ */ new Set([
+  "lat",
+  "lng",
+  "elevation",
+  "bole_hole",
+  "constructive",
+  "geologic"
+]);
 var SECTION_KEYS = [
   "general",
   "constructive",
@@ -898,6 +916,11 @@ function normalizeGeologic(raw) {
     caves: raw.caves ?? []
   };
 }
+function unknownRootKeys(well) {
+  return Object.keys(well).filter(
+    (key) => !(key in WellSchema.shape) && !LEGACY_ROOT_KEYS.has(key)
+  );
+}
 function serializeWell(well) {
   const payload = {
     version: WELL_FORMAT_VERSION,
@@ -950,6 +973,10 @@ function serializeWell(well) {
       water_samples: well.water_samples
     }
   };
+  for (const key of unknownRootKeys(well)) {
+    const value = well[key];
+    if (value !== void 0) payload[key] = value;
+  }
   return JSON.stringify(payload);
 }
 function isWellEmpty(well) {
@@ -958,6 +985,22 @@ function isWellEmpty(well) {
   if (raw.constructive || raw.geologic) return false;
   return well.lithology?.length === 0 && well.fractures?.length === 0 && well.caves?.length === 0 && well.bore_hole?.length === 0 && well.hole_fill?.length === 0 && well.well_case?.length === 0 && well.well_screen?.length === 0;
 }
+function isFilled(value) {
+  if (value === void 0 || value === null) return false;
+  if (typeof value === "string") return value.trim() !== "";
+  if (typeof value === "number") return value !== 0;
+  if (Array.isArray(value)) return value.length > 0;
+  if (typeof value === "object") return Object.values(value).some(isFilled);
+  return true;
+}
+var NON_DATA_ROOT_KEYS = /* @__PURE__ */ new Set(["version", "$schema", "@context"]);
+function hasWellData(well) {
+  if (!well) return false;
+  if (!isWellEmpty(well)) return true;
+  return Object.entries(well).some(
+    ([key, value]) => !NON_DATA_ROOT_KEYS.has(key) && isFilled(value)
+  );
+}
 function redactWell(well, visibility) {
   const v = visibility;
   const redacted = { ...well };
@@ -1001,6 +1044,10 @@ function redactWell(well, visibility) {
   if (hidden("production")) delete redacted.production;
   if (hidden("permits")) delete redacted.permits;
   if (hidden("water_quality")) delete redacted.water_samples;
+  if (Object.values(v).some((shown) => shown === false)) {
+    for (const key of unknownRootKeys(redacted))
+      delete redacted[key];
+  }
   return redacted;
 }
 function deserializeWell(jsonString) {
@@ -3190,6 +3237,7 @@ export {
   getParameterLabel,
   getVocabEntry,
   getVocabLabel,
+  hasWellData,
   hoursToMinutes,
   hpToKilowatts,
   inchesToMm,