@disclosureos/records 1.0.0

package/dist/source/sensor/index.d.ts

@@ -0,0 +1,170 @@
+import { z } from 'zod';
+
+declare const DetectionMethodSchema: z.ZodEnum<{
+    unknown: "unknown";
+    other: "other";
+    radar_primary: "radar_primary";
+    radar_secondary: "radar_secondary";
+    radar_doppler: "radar_doppler";
+    radar_phased_array: "radar_phased_array";
+    infrared_flir: "infrared_flir";
+    infrared_other: "infrared_other";
+    electro_optical: "electro_optical";
+    visual_camera: "visual_camera";
+    satellite_imagery: "satellite_imagery";
+    sonar_active: "sonar_active";
+    sonar_passive: "sonar_passive";
+    electromagnetic: "electromagnetic";
+    radiation_detector: "radiation_detector";
+    magnetometer: "magnetometer";
+    gravimeter: "gravimeter";
+    acoustic: "acoustic";
+    seismic: "seismic";
+    lidar: "lidar";
+    spectroscopic: "spectroscopic";
+    radio_frequency: "radio_frequency";
+    multiple: "multiple";
+}>;
+type DetectionMethod = z.infer<typeof DetectionMethodSchema>;
+declare const SensorTypeSchema: z.ZodEnum<{
+    other: "other";
+    military_radar: "military_radar";
+    civilian_radar: "civilian_radar";
+    airborne_radar: "airborne_radar";
+    shipborne_radar: "shipborne_radar";
+    ground_radar: "ground_radar";
+    flir: "flir";
+    eo_sensor: "eo_sensor";
+    satellite: "satellite";
+    sonar: "sonar";
+    electromagnetic_sensor: "electromagnetic_sensor";
+    radiation_sensor: "radiation_sensor";
+    civilian_camera: "civilian_camera";
+    security_camera: "security_camera";
+    dashcam: "dashcam";
+    phone_camera: "phone_camera";
+}>;
+type SensorType = z.infer<typeof SensorTypeSchema>;
+declare const SensorReadingSchema: z.ZodObject<{
+    id: z.ZodString;
+    sensorType: z.ZodEnum<{
+        other: "other";
+        military_radar: "military_radar";
+        civilian_radar: "civilian_radar";
+        airborne_radar: "airborne_radar";
+        shipborne_radar: "shipborne_radar";
+        ground_radar: "ground_radar";
+        flir: "flir";
+        eo_sensor: "eo_sensor";
+        satellite: "satellite";
+        sonar: "sonar";
+        electromagnetic_sensor: "electromagnetic_sensor";
+        radiation_sensor: "radiation_sensor";
+        civilian_camera: "civilian_camera";
+        security_camera: "security_camera";
+        dashcam: "dashcam";
+        phone_camera: "phone_camera";
+    }>;
+    detectionMethod: z.ZodEnum<{
+        unknown: "unknown";
+        other: "other";
+        radar_primary: "radar_primary";
+        radar_secondary: "radar_secondary";
+        radar_doppler: "radar_doppler";
+        radar_phased_array: "radar_phased_array";
+        infrared_flir: "infrared_flir";
+        infrared_other: "infrared_other";
+        electro_optical: "electro_optical";
+        visual_camera: "visual_camera";
+        satellite_imagery: "satellite_imagery";
+        sonar_active: "sonar_active";
+        sonar_passive: "sonar_passive";
+        electromagnetic: "electromagnetic";
+        radiation_detector: "radiation_detector";
+        magnetometer: "magnetometer";
+        gravimeter: "gravimeter";
+        acoustic: "acoustic";
+        seismic: "seismic";
+        lidar: "lidar";
+        spectroscopic: "spectroscopic";
+        radio_frequency: "radio_frequency";
+        multiple: "multiple";
+    }>;
+    platform: z.ZodOptional<z.ZodString>;
+    operator: z.ZodOptional<z.ZodString>;
+    timestamp: z.ZodOptional<z.ZodString>;
+    duration: z.ZodOptional<z.ZodNumber>;
+    rawDataAvailable: z.ZodOptional<z.ZodBoolean>;
+    calibrated: z.ZodOptional<z.ZodBoolean>;
+    readings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    notes: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type SensorReading = z.infer<typeof SensorReadingSchema>;
+declare const SensorEvidenceDataSchema: z.ZodObject<{
+    sensors: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        sensorType: z.ZodEnum<{
+            other: "other";
+            military_radar: "military_radar";
+            civilian_radar: "civilian_radar";
+            airborne_radar: "airborne_radar";
+            shipborne_radar: "shipborne_radar";
+            ground_radar: "ground_radar";
+            flir: "flir";
+            eo_sensor: "eo_sensor";
+            satellite: "satellite";
+            sonar: "sonar";
+            electromagnetic_sensor: "electromagnetic_sensor";
+            radiation_sensor: "radiation_sensor";
+            civilian_camera: "civilian_camera";
+            security_camera: "security_camera";
+            dashcam: "dashcam";
+            phone_camera: "phone_camera";
+        }>;
+        detectionMethod: z.ZodEnum<{
+            unknown: "unknown";
+            other: "other";
+            radar_primary: "radar_primary";
+            radar_secondary: "radar_secondary";
+            radar_doppler: "radar_doppler";
+            radar_phased_array: "radar_phased_array";
+            infrared_flir: "infrared_flir";
+            infrared_other: "infrared_other";
+            electro_optical: "electro_optical";
+            visual_camera: "visual_camera";
+            satellite_imagery: "satellite_imagery";
+            sonar_active: "sonar_active";
+            sonar_passive: "sonar_passive";
+            electromagnetic: "electromagnetic";
+            radiation_detector: "radiation_detector";
+            magnetometer: "magnetometer";
+            gravimeter: "gravimeter";
+            acoustic: "acoustic";
+            seismic: "seismic";
+            lidar: "lidar";
+            spectroscopic: "spectroscopic";
+            radio_frequency: "radio_frequency";
+            multiple: "multiple";
+        }>;
+        platform: z.ZodOptional<z.ZodString>;
+        operator: z.ZodOptional<z.ZodString>;
+        timestamp: z.ZodOptional<z.ZodString>;
+        duration: z.ZodOptional<z.ZodNumber>;
+        rawDataAvailable: z.ZodOptional<z.ZodBoolean>;
+        calibrated: z.ZodOptional<z.ZodBoolean>;
+        readings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        notes: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    multiSensorCorrelation: z.ZodOptional<z.ZodBoolean>;
+    dataRetentionStatus: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        available: "available";
+        archived: "archived";
+        destroyed: "destroyed";
+        classified: "classified";
+    }>>;
+    anomalies: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+type SensorEvidenceData = z.infer<typeof SensorEvidenceDataSchema>;
+
+export { type DetectionMethod, DetectionMethodSchema, type SensorEvidenceData, SensorEvidenceDataSchema, type SensorReading, SensorReadingSchema, type SensorType, SensorTypeSchema };

package/dist/source/sensor/index.js

@@ -0,0 +1,69 @@
+import { z } from 'zod';
+
+// src/source/sensor/types.ts
+var DetectionMethodSchema = z.enum([
+  "radar_primary",
+  "radar_secondary",
+  "radar_doppler",
+  "radar_phased_array",
+  "infrared_flir",
+  "infrared_other",
+  "electro_optical",
+  "visual_camera",
+  "satellite_imagery",
+  "sonar_active",
+  "sonar_passive",
+  "electromagnetic",
+  "radiation_detector",
+  "magnetometer",
+  "gravimeter",
+  "acoustic",
+  "seismic",
+  "lidar",
+  "spectroscopic",
+  "radio_frequency",
+  "multiple",
+  "other",
+  "unknown"
+]).describe("How a sensor detected the object.");
+var SensorTypeSchema = z.enum([
+  "military_radar",
+  "civilian_radar",
+  "airborne_radar",
+  "shipborne_radar",
+  "ground_radar",
+  "flir",
+  "eo_sensor",
+  "satellite",
+  "sonar",
+  "electromagnetic_sensor",
+  "radiation_sensor",
+  "civilian_camera",
+  "security_camera",
+  "dashcam",
+  "phone_camera",
+  "other"
+]).describe("Class of sensor that produced a reading.");
+var SensorReadingSchema = z.object({
+  id: z.string().min(1).describe('Stable id, addressable by a claim `evidenceRef` ("sensor:<id>").'),
+  sensorType: SensorTypeSchema,
+  detectionMethod: DetectionMethodSchema,
+  platform: z.string().optional().describe('Platform carrying the sensor (e.g. "USS Princeton", "F/A-18F").'),
+  operator: z.string().optional().describe("Person or unit operating the sensor."),
+  timestamp: z.string().optional().describe("When the reading was recorded (ISO timestamp)."),
+  duration: z.number().optional().describe("How long the sensor held contact, in seconds."),
+  rawDataAvailable: z.boolean().optional().describe("Whether the raw sensor data still exists and is obtainable."),
+  calibrated: z.boolean().optional().describe("Whether the sensor was calibrated at the time of the reading."),
+  readings: z.record(z.string(), z.unknown()).optional().describe("Sensor-specific measured values, keyed by measurement name."),
+  notes: z.string().optional().describe("Free-text context about the reading.")
+}).meta({ id: "SensorReading" }).describe("A single sensor reading and its provenance.");
+var SensorEvidenceDataSchema = z.object({
+  sensors: z.array(SensorReadingSchema),
+  multiSensorCorrelation: z.boolean().optional().describe("Whether independent sensors corroborated the same object."),
+  dataRetentionStatus: z.enum(["available", "archived", "destroyed", "classified", "unknown"]).optional().describe("Current status of the underlying sensor data."),
+  anomalies: z.array(z.string()).optional().describe('Anomalies in the sensor data itself (e.g. "jamming indications", "signal dropout").')
+}).meta({ id: "SensorEvidenceData" }).describe("Instrument-recorded evidence for an observation (radar, FLIR, EO, etc.).");
+
+export { DetectionMethodSchema, SensorEvidenceDataSchema, SensorReadingSchema, SensorTypeSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/source/sensor/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/source/sensor/types.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod';\n\nexport const DetectionMethodSchema = z\n  .enum([\n    'radar_primary',\n    'radar_secondary',\n    'radar_doppler',\n    'radar_phased_array',\n    'infrared_flir',\n    'infrared_other',\n    'electro_optical',\n    'visual_camera',\n    'satellite_imagery',\n    'sonar_active',\n    'sonar_passive',\n    'electromagnetic',\n    'radiation_detector',\n    'magnetometer',\n    'gravimeter',\n    'acoustic',\n    'seismic',\n    'lidar',\n    'spectroscopic',\n    'radio_frequency',\n    'multiple',\n    'other',\n    'unknown',\n  ])\n  .describe('How a sensor detected the object.');\n\nexport type DetectionMethod = z.infer<typeof DetectionMethodSchema>;\n\nexport const SensorTypeSchema = z\n  .enum([\n    'military_radar',\n    'civilian_radar',\n    'airborne_radar',\n    'shipborne_radar',\n    'ground_radar',\n    'flir',\n    'eo_sensor',\n    'satellite',\n    'sonar',\n    'electromagnetic_sensor',\n    'radiation_sensor',\n    'civilian_camera',\n    'security_camera',\n    'dashcam',\n    'phone_camera',\n    'other',\n  ])\n  .describe('Class of sensor that produced a reading.');\n\nexport type SensorType = z.infer<typeof SensorTypeSchema>;\n\nexport const SensorReadingSchema = z\n  .object({\n    id: z.string().min(1).describe('Stable id, addressable by a claim `evidenceRef` (\"sensor:<id>\").'),\n    sensorType: SensorTypeSchema,\n    detectionMethod: DetectionMethodSchema,\n    platform: z\n      .string()\n      .optional()\n      .describe('Platform carrying the sensor (e.g. \"USS Princeton\", \"F/A-18F\").'),\n    operator: z.string().optional().describe('Person or unit operating the sensor.'),\n    timestamp: z.string().optional().describe('When the reading was recorded (ISO timestamp).'),\n    duration: z.number().optional().describe('How long the sensor held contact, in seconds.'),\n    rawDataAvailable: z.boolean().optional().describe('Whether the raw sensor data still exists and is obtainable.'),\n    calibrated: z.boolean().optional().describe('Whether the sensor was calibrated at the time of the reading.'),\n    readings: z\n      .record(z.string(), z.unknown())\n      .optional()\n      .describe('Sensor-specific measured values, keyed by measurement name.'),\n    notes: z.string().optional().describe('Free-text context about the reading.'),\n  })\n  .meta({ id: 'SensorReading' })\n  .describe('A single sensor reading and its provenance.');\n\nexport type SensorReading = z.infer<typeof SensorReadingSchema>;\n\nexport const SensorEvidenceDataSchema = z\n  .object({\n    sensors: z.array(SensorReadingSchema),\n    multiSensorCorrelation: z\n      .boolean()\n      .optional()\n      .describe('Whether independent sensors corroborated the same object.'),\n    dataRetentionStatus: z\n      .enum(['available', 'archived', 'destroyed', 'classified', 'unknown'])\n      .optional()\n      .describe('Current status of the underlying sensor data.'),\n    anomalies: z\n      .array(z.string())\n      .optional()\n      .describe('Anomalies in the sensor data itself (e.g. \"jamming indications\", \"signal dropout\").'),\n  })\n  .meta({ id: 'SensorEvidenceData' })\n  .describe('Instrument-recorded evidence for an observation (radar, FLIR, EO, etc.).');\n\nexport type SensorEvidenceData = z.infer<typeof SensorEvidenceDataSchema>;\n"]}

package/dist/temporal/index.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export { D as DateGranularity, a as DateGranularitySchema, b as DateRange, c as DateRangeSchema, d as DateRangeType, e as DateRangeTypeSchema, F as FuzzyDate, f as FuzzyDateSchema, R as RelativeDate, g as RelativeDateSchema, T as TimeOfDay, h as TimeOfDaySchema } from '../time-of-day-DLDBwTrn.js';
+export { T as TemporalData, a as TemporalDataSchema } from '../temporal-data-t8Mzu8Ui.js';
+
+/**
+ * How confident we are in a date or time value.
+ *
+ * The single certainty scale for all temporal values in the model —
+ * `TemporalData.date`/`time`, `FuzzyDate`, `DateRange` bounds, and testimony
+ * dates all use it.
+ */
+declare const TemporalCertaintySchema: z.ZodEnum<{
+    exact: "exact";
+    approximate: "approximate";
+    estimated: "estimated";
+    unknown: "unknown";
+}>;
+type TemporalCertainty = z.infer<typeof TemporalCertaintySchema>;
+
+export { type TemporalCertainty, TemporalCertaintySchema };

package/dist/temporal/index.js

@@ -0,0 +1,78 @@
+import { z } from 'zod';
+
+// src/temporal/certainty.ts
+var TemporalCertaintySchema = z.enum(["exact", "approximate", "estimated", "unknown"]).describe("Confidence in a date or time value \u2014 the single certainty scale for all temporal values.");
+var TimeOfDaySchema = z.enum([
+  "astronomical_dawn",
+  "nautical_dawn",
+  "civil_dawn",
+  "sunrise",
+  "morning",
+  "noon",
+  "afternoon",
+  "sunset",
+  "civil_dusk",
+  "nautical_dusk",
+  "astronomical_dusk",
+  "night",
+  "unknown"
+]).describe("Twilight-aware time-of-day bucket for an observation.");
+var DateGranularitySchema = z.enum(["exact", "month", "quarter", "year", "decade", "century", "unknown"]).describe("Precision of a date value, from calendar-day (`exact`) to `century`.");
+var DateRangeTypeSchema = z.enum(["span", "uncertainty", "active_period", "investigation_period", "observation_window"]).describe("What a DateRange represents (a true span vs. an uncertainty window, etc.).");
+var FuzzyDateSchema = z.object({
+  value: z.string().describe("Machine-comparable anchor (ISO-like, as precise as known, e.g. `1947`, `1947-07`)."),
+  granularity: DateGranularitySchema,
+  certainty: TemporalCertaintySchema,
+  quarter: z.union([z.literal(1), z.literal(2), z.literal(3), z.literal(4)]).optional().describe("Calendar quarter (1\u20134) when granularity is `quarter`."),
+  display: z.string().optional().describe('Human display override, e.g. "Summer 1947".'),
+  notes: z.string().optional().describe("Free-text caveats about how this date was determined.")
+}).meta({ id: "FuzzyDate" }).describe('A date whose precision is coarser than a calendar day (e.g. "summer 1947").');
+var DateRangeSchema = z.object({
+  start: FuzzyDateSchema,
+  end: FuzzyDateSchema,
+  type: DateRangeTypeSchema,
+  display: z.string().optional().describe('Human display override, e.g. "July\u2013August 1952".'),
+  inclusive: z.boolean().optional().describe("Whether the end date is included in the range. Defaults to true.")
+}).meta({ id: "DateRange" }).describe("A period or uncertainty window bounded by two FuzzyDates.");
+var RelativeDateSchema = z.object({
+  referenceEvent: z.string().describe('The event this date is anchored to (e.g. "the crash").'),
+  referenceDate: FuzzyDateSchema.optional(),
+  relation: z.enum(["before", "after", "during", "around"]).describe("How this date relates to the reference event."),
+  offset: z.object({
+    value: z.number(),
+    unit: z.enum(["minutes", "hours", "days", "weeks", "months", "years"]),
+    approximate: z.boolean().optional()
+  }).optional().describe('Distance from the reference event (e.g. value 3, unit "days").'),
+  display: z.string().optional().describe('Human display override, e.g. "three days after the crash".')
+}).meta({ id: "RelativeDate" }).describe('A date known only relative to another event (e.g. "3 days after the crash").');
+
+// src/temporal/temporal-data.ts
+var TemporalDataSchema = z.object({
+  date: z.string().regex(/^\d{4}-\d{2}-\d{2}$/, "must be a valid ISO date (YYYY-MM-DD)").describe(
+    "Canonical, machine-sortable date anchor in ISO YYYY-MM-DD form. ALWAYS present, even when the true date is fuzzy or a range \u2014 set it to the best single representative. Express nuance via dateGranularity, dateRange, or relativeDate."
+  ),
+  dateCertainty: TemporalCertaintySchema,
+  dateGranularity: DateGranularitySchema.optional().describe(
+    'Precision of `date`. Defaults to day-level when omitted (e.g. "July 1947" \u2192 date "1947-07-01", dateGranularity "month").'
+  ),
+  time: z.string().optional().describe("Local clock time of the observation (HH:MM or HH:MM:SS, 24-hour)."),
+  timezone: z.string().optional().describe('IANA timezone of the local time (e.g. "America/Los_Angeles").'),
+  utcTime: z.string().optional().describe("Observation time converted to UTC, when known."),
+  timeCertainty: TemporalCertaintySchema.optional(),
+  durationSeconds: z.number().optional().describe("How long the observation lasted, in seconds."),
+  durationDescription: z.string().optional().describe('Duration as reported when not precisely known (e.g. "several minutes").'),
+  timeOfDay: TimeOfDaySchema.optional(),
+  isDaylightSaving: z.boolean().optional().describe("Whether daylight saving time was in effect at the local time."),
+  moonPhase: z.number().optional().describe("Moon phase at the time of observation (0 = new moon, 0.5 = full, 1 = new)."),
+  moonIllumination: z.number().optional().describe("Fraction of the moon illuminated at the time of observation (0\u20131)."),
+  dateRange: DateRangeSchema.optional().describe(
+    "For events spanning a period or with a genuine uncertainty window. `date` should still anchor within/at the range."
+  ),
+  relativeDate: RelativeDateSchema.optional().describe(
+    'For dates known only relative to another event (e.g. "3 days after the crash").'
+  )
+}).meta({ id: "TemporalData" }).describe("When an observation occurred \u2014 a sortable anchor date plus optional fuzzy/range/relative nuance.");
+
+export { DateGranularitySchema, DateRangeSchema, DateRangeTypeSchema, FuzzyDateSchema, RelativeDateSchema, TemporalCertaintySchema, TemporalDataSchema, TimeOfDaySchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/temporal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/temporal/certainty.ts","../../src/temporal/time-of-day.ts","../../src/temporal/date-range.ts","../../src/temporal/temporal-data.ts"],"names":["z"],"mappings":"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","file":"index.js","sourcesContent":["import { z } from 'zod';\n\n/**\n * How confident we are in a date or time value.\n *\n * The single certainty scale for all temporal values in the model —\n * `TemporalData.date`/`time`, `FuzzyDate`, `DateRange` bounds, and testimony\n * dates all use it.\n */\nexport const TemporalCertaintySchema = z\n  .enum(['exact', 'approximate', 'estimated', 'unknown'])\n  .describe('Confidence in a date or time value — the single certainty scale for all temporal values.');\n\nexport type TemporalCertainty = z.infer<typeof TemporalCertaintySchema>;\n","import { z } from 'zod';\n\n/** Twilight-aware time-of-day bucket for an observation. */\nexport const TimeOfDaySchema = z\n  .enum([\n    'astronomical_dawn',\n    'nautical_dawn',\n    'civil_dawn',\n    'sunrise',\n    'morning',\n    'noon',\n    'afternoon',\n    'sunset',\n    'civil_dusk',\n    'nautical_dusk',\n    'astronomical_dusk',\n    'night',\n    'unknown',\n  ])\n  .describe('Twilight-aware time-of-day bucket for an observation.');\n\nexport type TimeOfDay = z.infer<typeof TimeOfDaySchema>;\n","import { z } from 'zod';\nimport { TemporalCertaintySchema } from './certainty';\n\nexport const DateGranularitySchema = z\n  .enum(['exact', 'month', 'quarter', 'year', 'decade', 'century', 'unknown'])\n  .describe('Precision of a date value, from calendar-day (`exact`) to `century`.');\n\nexport type DateGranularity = z.infer<typeof DateGranularitySchema>;\n\nexport const DateRangeTypeSchema = z\n  .enum(['span', 'uncertainty', 'active_period', 'investigation_period', 'observation_window'])\n  .describe('What a DateRange represents (a true span vs. an uncertainty window, etc.).');\n\nexport type DateRangeType = z.infer<typeof DateRangeTypeSchema>;\n\n/**\n * A single date whose precision is coarser than a calendar day (e.g. \"summer 1947\").\n * Used as the bounds of a {@link DateRange}; for a top-level observation date,\n * prefer `TemporalData.date` + `dateGranularity` (the flattened form).\n */\nexport const FuzzyDateSchema = z\n  .object({\n    value: z\n      .string()\n      .describe('Machine-comparable anchor (ISO-like, as precise as known, e.g. `1947`, `1947-07`).'),\n    granularity: DateGranularitySchema,\n    certainty: TemporalCertaintySchema,\n    quarter: z\n      .union([z.literal(1), z.literal(2), z.literal(3), z.literal(4)])\n      .optional()\n      .describe('Calendar quarter (1–4) when granularity is `quarter`.'),\n    display: z.string().optional().describe('Human display override, e.g. \"Summer 1947\".'),\n    notes: z.string().optional().describe('Free-text caveats about how this date was determined.'),\n  })\n  .meta({ id: 'FuzzyDate' })\n  .describe('A date whose precision is coarser than a calendar day (e.g. \"summer 1947\").');\n\nexport type FuzzyDate = z.infer<typeof FuzzyDateSchema>;\n\nexport const DateRangeSchema = z\n  .object({\n    start: FuzzyDateSchema,\n    end: FuzzyDateSchema,\n    type: DateRangeTypeSchema,\n    display: z.string().optional().describe('Human display override, e.g. \"July–August 1952\".'),\n    inclusive: z.boolean().optional().describe('Whether the end date is included in the range. Defaults to true.'),\n  })\n  .meta({ id: 'DateRange' })\n  .describe('A period or uncertainty window bounded by two FuzzyDates.');\n\nexport type DateRange = z.infer<typeof DateRangeSchema>;\n\nexport const RelativeDateSchema = z\n  .object({\n    referenceEvent: z.string().describe('The event this date is anchored to (e.g. \"the crash\").'),\n    referenceDate: FuzzyDateSchema.optional(),\n    relation: z\n      .enum(['before', 'after', 'during', 'around'])\n      .describe('How this date relates to the reference event.'),\n    offset: z\n      .object({\n        value: z.number(),\n        unit: z.enum(['minutes', 'hours', 'days', 'weeks', 'months', 'years']),\n        approximate: z.boolean().optional(),\n      })\n      .optional()\n      .describe('Distance from the reference event (e.g. value 3, unit \"days\").'),\n    display: z.string().optional().describe('Human display override, e.g. \"three days after the crash\".'),\n  })\n  .meta({ id: 'RelativeDate' })\n  .describe('A date known only relative to another event (e.g. \"3 days after the crash\").');\n\nexport type RelativeDate = z.infer<typeof RelativeDateSchema>;\n","import { z } from 'zod';\nimport { TemporalCertaintySchema } from './certainty';\nimport { TimeOfDaySchema } from './time-of-day';\nimport { DateGranularitySchema, DateRangeSchema, RelativeDateSchema } from './date-range';\n\nexport const TemporalDataSchema = z\n  .object({\n    date: z\n      .string()\n      .regex(/^\\d{4}-\\d{2}-\\d{2}$/, 'must be a valid ISO date (YYYY-MM-DD)')\n      .describe(\n        'Canonical, machine-sortable date anchor in ISO YYYY-MM-DD form. ALWAYS present, even when the true date is fuzzy or a range — set it to the best single representative. Express nuance via dateGranularity, dateRange, or relativeDate.',\n      ),\n    dateCertainty: TemporalCertaintySchema,\n    dateGranularity: DateGranularitySchema.optional().describe(\n      'Precision of `date`. Defaults to day-level when omitted (e.g. \"July 1947\" → date \"1947-07-01\", dateGranularity \"month\").',\n    ),\n    time: z.string().optional().describe('Local clock time of the observation (HH:MM or HH:MM:SS, 24-hour).'),\n    timezone: z.string().optional().describe('IANA timezone of the local time (e.g. \"America/Los_Angeles\").'),\n    utcTime: z.string().optional().describe('Observation time converted to UTC, when known.'),\n    timeCertainty: TemporalCertaintySchema.optional(),\n    durationSeconds: z.number().optional().describe('How long the observation lasted, in seconds.'),\n    durationDescription: z\n      .string()\n      .optional()\n      .describe('Duration as reported when not precisely known (e.g. \"several minutes\").'),\n    timeOfDay: TimeOfDaySchema.optional(),\n    isDaylightSaving: z\n      .boolean()\n      .optional()\n      .describe('Whether daylight saving time was in effect at the local time.'),\n    moonPhase: z\n      .number()\n      .optional()\n      .describe('Moon phase at the time of observation (0 = new moon, 0.5 = full, 1 = new).'),\n    moonIllumination: z\n      .number()\n      .optional()\n      .describe('Fraction of the moon illuminated at the time of observation (0–1).'),\n    dateRange: DateRangeSchema.optional().describe(\n      'For events spanning a period or with a genuine uncertainty window. `date` should still anchor within/at the range.',\n    ),\n    relativeDate: RelativeDateSchema.optional().describe(\n      'For dates known only relative to another event (e.g. \"3 days after the crash\").',\n    ),\n  })\n  .meta({ id: 'TemporalData' })\n  .describe('When an observation occurred — a sortable anchor date plus optional fuzzy/range/relative nuance.');\n\nexport type TemporalData = z.infer<typeof TemporalDataSchema>;\n"]}

package/dist/temporal-data-t8Mzu8Ui.d.ts

@@ -0,0 +1,148 @@
+import { z } from 'zod';
+
+declare const TemporalDataSchema: z.ZodObject<{
+    date: z.ZodString;
+    dateCertainty: z.ZodEnum<{
+        exact: "exact";
+        approximate: "approximate";
+        estimated: "estimated";
+        unknown: "unknown";
+    }>;
+    dateGranularity: z.ZodOptional<z.ZodEnum<{
+        exact: "exact";
+        unknown: "unknown";
+        month: "month";
+        quarter: "quarter";
+        year: "year";
+        decade: "decade";
+        century: "century";
+    }>>;
+    time: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+    utcTime: z.ZodOptional<z.ZodString>;
+    timeCertainty: z.ZodOptional<z.ZodEnum<{
+        exact: "exact";
+        approximate: "approximate";
+        estimated: "estimated";
+        unknown: "unknown";
+    }>>;
+    durationSeconds: z.ZodOptional<z.ZodNumber>;
+    durationDescription: z.ZodOptional<z.ZodString>;
+    timeOfDay: z.ZodOptional<z.ZodEnum<{
+        unknown: "unknown";
+        astronomical_dawn: "astronomical_dawn";
+        nautical_dawn: "nautical_dawn";
+        civil_dawn: "civil_dawn";
+        sunrise: "sunrise";
+        morning: "morning";
+        noon: "noon";
+        afternoon: "afternoon";
+        sunset: "sunset";
+        civil_dusk: "civil_dusk";
+        nautical_dusk: "nautical_dusk";
+        astronomical_dusk: "astronomical_dusk";
+        night: "night";
+    }>>;
+    isDaylightSaving: z.ZodOptional<z.ZodBoolean>;
+    moonPhase: z.ZodOptional<z.ZodNumber>;
+    moonIllumination: z.ZodOptional<z.ZodNumber>;
+    dateRange: z.ZodOptional<z.ZodObject<{
+        start: z.ZodObject<{
+            value: z.ZodString;
+            granularity: z.ZodEnum<{
+                exact: "exact";
+                unknown: "unknown";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+                decade: "decade";
+                century: "century";
+            }>;
+            certainty: z.ZodEnum<{
+                exact: "exact";
+                approximate: "approximate";
+                estimated: "estimated";
+                unknown: "unknown";
+            }>;
+            quarter: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+            display: z.ZodOptional<z.ZodString>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        end: z.ZodObject<{
+            value: z.ZodString;
+            granularity: z.ZodEnum<{
+                exact: "exact";
+                unknown: "unknown";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+                decade: "decade";
+                century: "century";
+            }>;
+            certainty: z.ZodEnum<{
+                exact: "exact";
+                approximate: "approximate";
+                estimated: "estimated";
+                unknown: "unknown";
+            }>;
+            quarter: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+            display: z.ZodOptional<z.ZodString>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        type: z.ZodEnum<{
+            span: "span";
+            uncertainty: "uncertainty";
+            active_period: "active_period";
+            investigation_period: "investigation_period";
+            observation_window: "observation_window";
+        }>;
+        display: z.ZodOptional<z.ZodString>;
+        inclusive: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+    relativeDate: z.ZodOptional<z.ZodObject<{
+        referenceEvent: z.ZodString;
+        referenceDate: z.ZodOptional<z.ZodObject<{
+            value: z.ZodString;
+            granularity: z.ZodEnum<{
+                exact: "exact";
+                unknown: "unknown";
+                month: "month";
+                quarter: "quarter";
+                year: "year";
+                decade: "decade";
+                century: "century";
+            }>;
+            certainty: z.ZodEnum<{
+                exact: "exact";
+                approximate: "approximate";
+                estimated: "estimated";
+                unknown: "unknown";
+            }>;
+            quarter: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>>;
+            display: z.ZodOptional<z.ZodString>;
+            notes: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        relation: z.ZodEnum<{
+            before: "before";
+            after: "after";
+            during: "during";
+            around: "around";
+        }>;
+        offset: z.ZodOptional<z.ZodObject<{
+            value: z.ZodNumber;
+            unit: z.ZodEnum<{
+                minutes: "minutes";
+                hours: "hours";
+                days: "days";
+                weeks: "weeks";
+                months: "months";
+                years: "years";
+            }>;
+            approximate: z.ZodOptional<z.ZodBoolean>;
+        }, z.core.$strip>>;
+        display: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type TemporalData = z.infer<typeof TemporalDataSchema>;
+
+export { type TemporalData as T, TemporalDataSchema as a };