@ggts-sh/spec 0.43.0

package/dist/stat-reference.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat-reference.d.ts","sourceRoot":"","sources":["../src/stat-reference.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAe,KAAK,QAAQ,EAAE,KAAK,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGhF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC7C,iDAAiD;IACjD,QAAQ,CAAC,eAAe,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC9C,mDAAmD;IACnD,QAAQ,CAAC,eAAe,EAAE,SAAS,QAAQ,EAAE,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAuB,CAAC;AAElG,8EAA8E;AAC9E,wBAAgB,iBAAiB,IAAI,SAAS,kBAAkB,EAAE,CAEjE"}

package/dist/stat-reference.js

@@ -0,0 +1,19 @@
+/**
+ * STAT_REFERENCE — per-stat API docs for the docs site.
+ *
+ * Catalog data is precomputed (`scripts/gen-reference-catalogs.ts`) so
+ * reference pages never load TypeBox or the validate data-checks path.
+ * Stats are not Svelte components: set `stat` on a `<Geom*>` shell or JSON layer.
+ */
+import { KNOWN_STATS } from "./schema-catalog.js";
+import { STAT_REFERENCE_DATA } from "./generated/stat-reference-data.js";
+/**
+ * Complete per-stat API reference. Keys are exactly KNOWN_STATS.
+ * Precomputed at gen time from GEOM_REFERENCE + STAT_COLUMNS.
+ */
+export const STAT_REFERENCE = STAT_REFERENCE_DATA;
+/** Stable list order matching KNOWN_STATS (docs index, search, inventory). */
+export function statReferenceList() {
+    return KNOWN_STATS.map((stat) => STAT_REFERENCE[stat]);
+}
+//# sourceMappingURL=stat-reference.js.map

package/dist/stat-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stat-reference.js","sourceRoot":"","sources":["../src/stat-reference.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,WAAW,EAAgC,MAAM,qBAAqB,CAAC;AAChF,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAoBzE;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAmD,mBAAmB,CAAC;AAElG,8EAA8E;AAC9E,MAAM,UAAU,iBAAiB;IAC/B,OAAO,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/dist/structural-gate.d.ts

@@ -0,0 +1,15 @@
+/**
+ * TypeBox-free structural gates that always ran after schema shape success in
+ * validate(). Kept on the render path so pipeline/assemble drop only the
+ * Compile(PlotSpecSchema) tier, not color-scheme / binned-style / guide /
+ * coord-facet checks.
+ */
+import { type SpecError } from "./errors.js";
+/**
+ * Unconditional structural diagnostics from validate() (pre tier-2 options).
+ * Safe to call without TypeBox / schema-declarations.
+ */
+export declare function structuralGateErrors(input: unknown): SpecError[];
+/** Throw SpecValidationError when structuralGateErrors is non-empty. */
+export declare function assertStructuralGate(input: unknown): void;
+//# sourceMappingURL=structural-gate.d.ts.map

package/dist/structural-gate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-gate.d.ts","sourceRoot":"","sources":["../src/structural-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAuB,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAYlE;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,EAAE,CAahE;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAGzD"}

package/dist/structural-gate.js

@@ -0,0 +1,34 @@
+/**
+ * TypeBox-free structural gates that always ran after schema shape success in
+ * validate(). Kept on the render path so pipeline/assemble drop only the
+ * Compile(PlotSpecSchema) tier, not color-scheme / binned-style / guide /
+ * coord-facet checks.
+ */
+import { SpecValidationError } from "./errors.js";
+import { binnedStyleScaleStructuralErrors, colorScaleStructuralErrors, coordFacetStructuralErrors, guideStructuralErrors, } from "./validate-structure.js";
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+/**
+ * Unconditional structural diagnostics from validate() (pre tier-2 options).
+ * Safe to call without TypeBox / schema-declarations.
+ */
+export function structuralGateErrors(input) {
+    if (!isRecord(input))
+        return [];
+    const errors = [];
+    if (isRecord(input["scales"])) {
+        errors.push(...colorScaleStructuralErrors(input["scales"]), ...binnedStyleScaleStructuralErrors(input["scales"]));
+    }
+    const guides = isRecord(input["guides"]) ? input["guides"] : {};
+    const scales = isRecord(input["scales"]) ? input["scales"] : undefined;
+    errors.push(...guideStructuralErrors(guides, scales), ...coordFacetStructuralErrors(input));
+    return errors;
+}
+/** Throw SpecValidationError when structuralGateErrors is non-empty. */
+export function assertStructuralGate(input) {
+    const errors = structuralGateErrors(input);
+    if (errors.length > 0)
+        throw new SpecValidationError(errors);
+}
+//# sourceMappingURL=structural-gate.js.map

package/dist/structural-gate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structural-gate.js","sourceRoot":"","sources":["../src/structural-gate.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAkB,MAAM,aAAa,CAAC;AAClE,OAAO,EACL,gCAAgC,EAChC,0BAA0B,EAC1B,0BAA0B,EAC1B,qBAAqB,GACtB,MAAM,yBAAyB,CAAC;AAEjC,SAAS,QAAQ,CAAC,CAAU;IAC1B,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAChC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,IAAI,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CACT,GAAG,0BAA0B,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAC9C,GAAG,gCAAgC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CACrD,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,MAAM,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,0BAA0B,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5F,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,KAAc;IACjD,MAAM,MAAM,GAAG,oBAAoB,CAAC,KAAK,CAAC,CAAC;IAC3C,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,MAAM,IAAI,mBAAmB,CAAC,MAAM,CAAC,CAAC;AAC/D,CAAC"}

package/dist/temporal-column.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Column-level temporal inference and materialization.
+ *
+ * Classifies whole columns (auto parser selection + whole-column validation)
+ * and builds semantic/valid arrays. Value-level engines live in temporal-parse.ts.
+ */
+import { type TemporalKind, type TemporalParseOptions, type TemporalParserSpec, type TemporalPrecision } from "./temporal-parse.js";
+export interface TemporalFailure {
+    index: number;
+    value: string | number | boolean | null;
+    reason: string;
+}
+export interface TemporalDecision {
+    status: "temporal" | "nominal" | "ambiguous" | "invalid";
+    parser: string | null;
+    parserKey: string;
+    kind: TemporalKind | null;
+    precision: TemporalPrecision | null;
+    evidence: readonly (string | number | boolean | null)[];
+    nonNullCount: number;
+    validatedCount: number;
+    failedCount: number;
+    candidates: readonly string[];
+    failures?: readonly TemporalFailure[];
+}
+export interface ParsedTemporalColumn {
+    decision: TemporalDecision;
+    semantic: Float64Array;
+    valid: Uint8Array;
+}
+export declare function inferTemporalColumn(values: readonly unknown[], options?: TemporalParseOptions): TemporalDecision;
+export declare function parseTemporalColumn(values: readonly unknown[], parser?: TemporalParserSpec | "auto", options?: TemporalParseOptions): ParsedTemporalColumn;
+//# sourceMappingURL=temporal-column.d.ts.map

package/dist/temporal-column.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-column.d.ts","sourceRoot":"","sources":["../src/temporal-column.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAML,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAEzB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IACzD,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACpC,QAAQ,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IACxD,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,QAAQ,CAAC,EAAE,SAAS,eAAe,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,EAAE,YAAY,CAAC;IACvB,KAAK,EAAE,UAAU,CAAC;CACnB;AAiND,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,OAAO,GAAE,oBAAyB,GACjC,gBAAgB,CAElB;AAED,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,MAAM,GAAE,kBAAkB,GAAG,MAAe,EAC5C,OAAO,GAAE,oBAAyB,GACjC,oBAAoB,CA0DtB"}

package/dist/temporal-column.js

@@ -0,0 +1,247 @@
+/**
+ * Column-level temporal inference and materialization.
+ *
+ * Classifies whole columns (auto parser selection + whole-column validation)
+ * and builds semantic/valid arrays. Value-level engines live in temporal-parse.ts.
+ */
+import { DATE_ORDERS, TEMPORAL_PARSER_NAMES, canonicalTemporalParserKey, parseTemporal, temporalParseFailure, } from "./temporal-parse.js";
+const PRECISION_RANK = {
+    year: 0,
+    quarter: 1,
+    month: 2,
+    date: 3,
+    minute: 4,
+    second: 5,
+    millisecond: 6,
+};
+function finestPrecision(current, candidate) {
+    return current === null || PRECISION_RANK[candidate] > PRECISION_RANK[current]
+        ? candidate
+        : current;
+}
+function evidenceValue(value) {
+    if (value instanceof Date)
+        return Number.isFinite(value.getTime()) ? value.toISOString() : "Invalid Date";
+    if (typeof value === "string" ||
+        typeof value === "number" ||
+        typeof value === "boolean" ||
+        value === null) {
+        return value;
+    }
+    if (typeof value === "bigint")
+        return value.toString();
+    return JSON.stringify(value) ?? "unsupported value";
+}
+/**
+ * One full-column pass: non-null count, full-column number/boolean detection
+ * (not sample-relative), and a representative sample of at most 64 non-null
+ * values (all when ≤64; otherwise first 32 + last 32). Avoids allocating an
+ * O(n) non-null array just to take a bounded sample.
+ */
+function analyzeNonNull(values) {
+    let nonNullCount = 0;
+    let sawNumberOrBoolean = false;
+    const head = [];
+    const ring = Array.from({ length: 32 });
+    let ringWrite = 0;
+    let ringLen = 0;
+    for (const value of values) {
+        if (value === null || value === undefined)
+            continue;
+        nonNullCount++;
+        if (typeof value === "number" || typeof value === "boolean")
+            sawNumberOrBoolean = true;
+        if (head.length < 64)
+            head.push(value);
+        ring[ringWrite] = value;
+        ringWrite = (ringWrite + 1) % 32;
+        if (ringLen < 32)
+            ringLen++;
+    }
+    if (nonNullCount <= 64) {
+        return { sample: head, nonNullCount, sawNumberOrBoolean };
+    }
+    const first = head.slice(0, 32);
+    const last = [];
+    // When full, ringWrite points at the oldest slot.
+    for (let i = 0; i < 32; i++)
+        last.push(ring[(ringWrite + i) % 32]);
+    return { sample: [...first, ...last], nonNullCount, sawNumberOrBoolean };
+}
+const AUTO_ORDERED_PARSERS = TEMPORAL_PARSER_NAMES.filter((parser) => DATE_ORDERS.has(parser.split("_")[0]));
+function candidateParsers(sample, options) {
+    const strings = sample.filter((value) => typeof value === "string");
+    const nonDates = sample.filter((value) => !(value instanceof Date));
+    const mixedWithDates = strings.length > 0 && sample.some((value) => value instanceof Date);
+    if (strings.length === 0 && sample.every((value) => value instanceof Date))
+        return [];
+    if (strings.length !== nonDates.length)
+        return [];
+    if (strings.every((value) => parseTemporal(value, "iso", options).ok))
+        return ["iso"];
+    // Native Date values are instants. Mixing them with lower-precision year,
+    // month, quarter, or ordered-date strings has no coherent parser identity.
+    if (mixedWithDates)
+        return [];
+    for (const parser of ["year", "ym", "my", "yq"]) {
+        if (strings.every((value) => parseTemporal(value, parser, options).ok))
+            return [parser];
+    }
+    // Explicit ordered parsers may accept compact years, but automatic
+    // inference never assigns meaning to a two-digit year.
+    if (strings.some((value) => !/(?:^|[-/.])\d{4}(?:[-/.]|[T ]|$)/.test(value)))
+        return [];
+    return AUTO_ORDERED_PARSERS.filter((parser) => strings.every((value) => {
+        if (value.includes("-") && /^\d{4}-\d{2}-\d{2}/.test(value))
+            return false;
+        return parseTemporal(value, parser, options).ok;
+    }));
+}
+function nominalDecision(status, values, candidates = [], analyzed) {
+    const { sample, nonNullCount } = analyzed ?? analyzeNonNull(values);
+    return {
+        status,
+        parser: null,
+        parserKey: `auto:${status}`,
+        kind: null,
+        precision: null,
+        evidence: sample.slice(0, 8).map((value) => evidenceValue(value)),
+        nonNullCount,
+        validatedCount: 0,
+        failedCount: 0,
+        candidates,
+    };
+}
+function inferTemporalColumnInternal(values, options = {}, onSuccess) {
+    const analyzed = analyzeNonNull(values);
+    if (analyzed.nonNullCount === 0)
+        return nominalDecision("nominal", values, [], analyzed);
+    // Full-column fact (not sample-relative): any number/boolean forces nominal.
+    if (analyzed.sawNumberOrBoolean)
+        return nominalDecision("nominal", values, [], analyzed);
+    const { sample, nonNullCount } = analyzed;
+    if (sample.some((value) => !(value instanceof Date) && typeof value !== "string")) {
+        return nominalDecision("nominal", values, [], analyzed);
+    }
+    const candidates = candidateParsers(sample, options);
+    const allDates = sample.every((value) => value instanceof Date);
+    if (!allDates && candidates.length === 0)
+        return nominalDecision("nominal", values, [], analyzed);
+    if (candidates.length > 1)
+        return nominalDecision("ambiguous", values, candidates, analyzed);
+    const parser = allDates ? null : candidates[0];
+    const scan = scanTemporalValues(values, parser, options, onSuccess);
+    const failedCount = nonNullCount - scan.validatedCount;
+    if (failedCount > 0) {
+        return {
+            ...nominalDecision("invalid", values, parser === null ? ["native-date"] : [parser], analyzed),
+            parser,
+            parserKey: `auto:${parser ?? "native-date"}:invalid`,
+            validatedCount: scan.validatedCount,
+            failedCount,
+            failures: scan.failures,
+        };
+    }
+    return {
+        status: "temporal",
+        parser: parser ?? "native-date",
+        parserKey: `auto:${parser ?? "native-date"}`,
+        kind: scan.kind ?? "datetime",
+        precision: scan.precision ?? "millisecond",
+        evidence: sample.slice(0, 8).map((value) => evidenceValue(value)),
+        nonNullCount,
+        validatedCount: scan.validatedCount,
+        failedCount: 0,
+        candidates: parser === null ? ["native-date"] : [parser],
+    };
+}
+function scanTemporalValues(values, parser, options, onSuccess) {
+    let validatedCount = 0;
+    const failures = [];
+    let kind = null;
+    let precision = null;
+    for (let index = 0; index < values.length; index++) {
+        const value = values[index];
+        if (value === null || value === undefined)
+            continue;
+        const parsed = value instanceof Date
+            ? parseTemporal(value, "iso", options)
+            : parser === null
+                ? temporalParseFailure("mixed non-Date value in native Date column")
+                : parseTemporal(value, parser, options);
+        if (!parsed.ok) {
+            if (failures.length < 5)
+                failures.push({ index, value: evidenceValue(value), reason: parsed.reason });
+            continue;
+        }
+        validatedCount++;
+        onSuccess?.(index, parsed.epochMs);
+        kind = kind === "datetime" || parsed.kind === "datetime" ? "datetime" : "date";
+        precision = finestPrecision(precision, parsed.precision);
+    }
+    return { validatedCount, failures, kind, precision };
+}
+export function inferTemporalColumn(values, options = {}) {
+    return inferTemporalColumnInternal(values, options);
+}
+export function parseTemporalColumn(values, parser = "auto", options = {}) {
+    const semantic = new Float64Array(values.length);
+    semantic.fill(Number.NaN);
+    const valid = new Uint8Array(values.length);
+    if (parser === "auto") {
+        const decision = inferTemporalColumnInternal(values, options, (index, epochMs) => {
+            semantic[index] = epochMs;
+            valid[index] = 1;
+        });
+        if (decision.status !== "temporal") {
+            semantic.fill(Number.NaN);
+            valid.fill(0);
+        }
+        return { decision, semantic, valid };
+    }
+    let validatedCount = 0;
+    let nonNullCount = 0;
+    let kind = null;
+    let precision = null;
+    const failures = [];
+    const evidence = [];
+    for (let index = 0; index < values.length; index++) {
+        const value = values[index];
+        if (value === null || value === undefined)
+            continue;
+        nonNullCount++;
+        if (evidence.length < 8)
+            evidence.push(evidenceValue(value));
+        const result = parseTemporal(value, parser, options);
+        if (!result.ok) {
+            if (failures.length < 5)
+                failures.push({ index, value: evidenceValue(value), reason: result.reason });
+            continue;
+        }
+        semantic[index] = result.epochMs;
+        valid[index] = 1;
+        validatedCount++;
+        kind = kind === "datetime" || result.kind === "datetime" ? "datetime" : "date";
+        precision = finestPrecision(precision, result.precision);
+    }
+    const failedCount = nonNullCount - validatedCount;
+    const parserKey = canonicalTemporalParserKey(parser);
+    return {
+        semantic,
+        valid,
+        decision: {
+            status: failedCount === 0 ? "temporal" : "invalid",
+            parser: typeof parser === "string" ? parser : parserKey,
+            parserKey,
+            kind: kind ?? null,
+            precision: precision ?? null,
+            evidence,
+            nonNullCount,
+            validatedCount,
+            failedCount,
+            candidates: [parserKey],
+            ...(failures.length > 0 && { failures }),
+        },
+    };
+}
+//# sourceMappingURL=temporal-column.js.map

package/dist/temporal-column.js.map

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

package/dist/temporal-guides.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Temporal guides facade — portable intervals/labels and tick generation.
+ *
+ * Implementation:
+ *  - temporal-interval.ts — units, parse, label tokens, locale checks
+ *  - temporal-ticks.ts — calendar-aligned interval ticks
+ */
+export { MAX_TEMPORAL_CANDIDATES, MAX_TEMPORAL_MAJOR_TICKS, MAX_TEMPORAL_MINOR_TICKS, MIN_TEMPORAL_LABEL_GAP_PX, parseTemporalInterval, TEMPORAL_INTERVAL_UNITS, TEMPORAL_LABEL_TOKENS, TEMPORAL_WEEKDAYS, TemporalIntervalError, temporalLabelConfigurationError, temporalLocaleConfigurationError, type TemporalInterval, type TemporalIntervalSpec, type TemporalIntervalUnit, type TemporalWeekStart, } from "./temporal-interval.js";
+export { TemporalIntervalSpecSchema, TemporalLabelSpecSchema, TemporalWeekStartSchema, } from "./temporal-interval-schema.js";
+export { temporalIntervalTicks } from "./temporal-ticks.js";
+//# sourceMappingURL=temporal-guides.d.ts.map

package/dist/temporal-guides.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-guides.d.ts","sourceRoot":"","sources":["../src/temporal-guides.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,+BAA+B,EAC/B,gCAAgC,EAChC,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,GACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/temporal-guides.js

@@ -0,0 +1,11 @@
+/**
+ * Temporal guides facade — portable intervals/labels and tick generation.
+ *
+ * Implementation:
+ *  - temporal-interval.ts — units, parse, label tokens, locale checks
+ *  - temporal-ticks.ts — calendar-aligned interval ticks
+ */
+export { MAX_TEMPORAL_CANDIDATES, MAX_TEMPORAL_MAJOR_TICKS, MAX_TEMPORAL_MINOR_TICKS, MIN_TEMPORAL_LABEL_GAP_PX, parseTemporalInterval, TEMPORAL_INTERVAL_UNITS, TEMPORAL_LABEL_TOKENS, TEMPORAL_WEEKDAYS, TemporalIntervalError, temporalLabelConfigurationError, temporalLocaleConfigurationError, } from "./temporal-interval.js";
+export { TemporalIntervalSpecSchema, TemporalLabelSpecSchema, TemporalWeekStartSchema, } from "./temporal-interval-schema.js";
+export { temporalIntervalTicks } from "./temporal-ticks.js";
+//# sourceMappingURL=temporal-guides.js.map

package/dist/temporal-guides.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-guides.js","sourceRoot":"","sources":["../src/temporal-guides.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,uBAAuB,EACvB,wBAAwB,EACxB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,EACrB,uBAAuB,EACvB,qBAAqB,EACrB,iBAAiB,EACjB,qBAAqB,EACrB,+BAA+B,EAC/B,gCAAgC,GAKjC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,GACxB,MAAM,+BAA+B,CAAC;AAEvC,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/temporal-interval-schema.d.ts

@@ -0,0 +1,9 @@
+/**
+ * TypeBox schemas for temporal intervals and labels (schema graph / validate only).
+ * Runtime parse + label checks live in temporal-interval.ts without typebox.
+ */
+import Type from "typebox";
+export declare const TemporalIntervalSpecSchema: Type.TString;
+export declare const TemporalWeekStartSchema: Type.TUnion<[Type.TLiteral<"monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday">, ...Type.TLiteral<"monday" | "tuesday" | "wednesday" | "thursday" | "friday" | "saturday" | "sunday">[]]>;
+export declare const TemporalLabelSpecSchema: Type.TString;
+//# sourceMappingURL=temporal-interval-schema.d.ts.map

package/dist/temporal-interval-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-interval-schema.d.ts","sourceRoot":"","sources":["../src/temporal-interval-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,IAAuB,MAAM,SAAS,CAAC;AAe9C,eAAO,MAAM,0BAA0B,cAMrC,CAAC;AAEH,eAAO,MAAM,uBAAuB,0NAElC,CAAC;AAIH,eAAO,MAAM,uBAAuB,cAMlC,CAAC"}

package/dist/temporal-interval-schema.js

@@ -0,0 +1,25 @@
+/**
+ * TypeBox schemas for temporal intervals and labels (schema graph / validate only).
+ * Runtime parse + label checks live in temporal-interval.ts without typebox.
+ */
+import Type, {} from "typebox";
+import { TEMPORAL_LABEL_TOKENS, TEMPORAL_WEEKDAYS, } from "./temporal-interval.js";
+const WEEKDAY_SCHEMAS = TEMPORAL_WEEKDAYS.map((weekday) => Type.Literal(weekday));
+const TEMPORAL_INTERVAL_STEP_PATTERN = "(?:[1-9][0-9]{0,5}|1000000)";
+export const TemporalIntervalSpecSchema = Type.String({
+    minLength: 1,
+    maxLength: 128,
+    pattern: `^[ ]*${TEMPORAL_INTERVAL_STEP_PATTERN}[ ]+(?:millisecond|second|minute|hour|day|week|month|quarter|year)s?[ ]*$`,
+    description: 'A positive integer calendar interval such as "2 weeks", "3 months", or "10 years". Canonical units are millisecond, second, minute, hour, day, week, month, quarter, and year.',
+});
+export const TemporalWeekStartSchema = Type.Union(WEEKDAY_SCHEMAS, {
+    description: 'Week boundary used by temporal interval breaks. Default "monday".',
+});
+const TEMPORAL_LABEL_PATTERN = `^(?:[^%]|%(?:${TEMPORAL_LABEL_TOKENS.join("|")}))+$`;
+export const TemporalLabelSpecSchema = Type.String({
+    minLength: 1,
+    maxLength: 128,
+    pattern: TEMPORAL_LABEL_PATTERN,
+    description: "Strict temporal label format. Supported tokens: %Y %y %m %b %B %d %e %a %A %H %I %M %S %L %p %q %z %Z %%.",
+});
+//# sourceMappingURL=temporal-interval-schema.js.map

package/dist/temporal-interval-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-interval-schema.js","sourceRoot":"","sources":["../src/temporal-interval-schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,IAAI,EAAE,EAAiB,MAAM,SAAS,CAAC;AAE9C,OAAO,EACL,qBAAqB,EACrB,iBAAiB,GAElB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,eAAe,GAAG,iBAAiB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAG/E,CAAC;AAEF,MAAM,8BAA8B,GAAG,6BAA6B,CAAC;AAErE,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC,MAAM,CAAC;IACpD,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,QAAQ,8BAA8B,2EAA2E;IAC1H,WAAW,EACT,gLAAgL;CACnL,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,KAAK,CAAC,eAAe,EAAE;IACjE,WAAW,EAAE,mEAAmE;CACjF,CAAC,CAAC;AAEH,MAAM,sBAAsB,GAAG,gBAAgB,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;AAErF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,CAAC,MAAM,CAAC;IACjD,SAAS,EAAE,CAAC;IACZ,SAAS,EAAE,GAAG;IACd,OAAO,EAAE,sBAAsB;IAC/B,WAAW,EACT,2GAA2G;CAC9G,CAAC,CAAC"}

package/dist/temporal-interval.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Portable temporal interval grammar, label token contract, and locale checks.
+ * Tick generation lives in temporal-ticks.ts; facade re-exports in temporal-guides.ts.
+ */
+import type { TemporalScaleKind } from "./temporal-parse-core.js";
+export declare const TEMPORAL_INTERVAL_UNITS: readonly ["millisecond", "second", "minute", "hour", "day", "week", "month", "quarter", "year"];
+export type TemporalIntervalUnit = (typeof TEMPORAL_INTERVAL_UNITS)[number];
+export declare const TEMPORAL_WEEKDAYS: readonly ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"];
+export type TemporalWeekStart = (typeof TEMPORAL_WEEKDAYS)[number];
+/** Portable interval string (schema-validated by TypeBox on the agent path). */
+export type TemporalIntervalSpec = string;
+export interface TemporalInterval {
+    unit: TemporalIntervalUnit;
+    step: number;
+    key: string;
+}
+export declare const MAX_TEMPORAL_CANDIDATES = 128;
+export declare const MAX_TEMPORAL_MAJOR_TICKS = 64;
+export declare const MAX_TEMPORAL_MINOR_TICKS = 256;
+export declare const MIN_TEMPORAL_LABEL_GAP_PX = 6;
+export declare class TemporalIntervalError extends Error {
+    readonly value: string;
+    constructor(value: string, reason: string);
+}
+export declare function parseTemporalInterval(value: string): TemporalInterval;
+export declare const TEMPORAL_LABEL_TOKENS: readonly ["Y", "y", "m", "b", "B", "d", "e", "a", "A", "H", "I", "M", "S", "L", "p", "q", "z", "Z", "%"];
+export declare function temporalLabelConfigurationError(pattern: string, kind?: TemporalScaleKind): string | null;
+export declare function temporalLocaleConfigurationError(locale: string): string | null;
+//# sourceMappingURL=temporal-interval.d.ts.map

package/dist/temporal-interval.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"temporal-interval.d.ts","sourceRoot":"","sources":["../src/temporal-interval.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAElE,eAAO,MAAM,uBAAuB,iGAU1B,CAAC;AACX,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE5E,eAAO,MAAM,iBAAiB,yFAQpB,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAInE,gFAAgF;AAChF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC;AAE1C,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,oBAAoB,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;gBAEX,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAK1C;AAMD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAAC;AAoBvE,eAAO,MAAM,qBAAqB,0GAoBxB,CAAC;AAWX,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,iBAAiB,GACvB,MAAM,GAAG,IAAI,CAef;AAED,wBAAgB,gCAAgC,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkB9E"}

package/dist/temporal-interval.js

@@ -0,0 +1,122 @@
+/**
+ * Portable temporal interval grammar, label token contract, and locale checks.
+ * Tick generation lives in temporal-ticks.ts; facade re-exports in temporal-guides.ts.
+ */
+export const TEMPORAL_INTERVAL_UNITS = [
+    "millisecond",
+    "second",
+    "minute",
+    "hour",
+    "day",
+    "week",
+    "month",
+    "quarter",
+    "year",
+];
+export const TEMPORAL_WEEKDAYS = [
+    "monday",
+    "tuesday",
+    "wednesday",
+    "thursday",
+    "friday",
+    "saturday",
+    "sunday",
+];
+const TEMPORAL_INTERVAL_STEP_PATTERN = "(?:[1-9][0-9]{0,5}|1000000)";
+export const MAX_TEMPORAL_CANDIDATES = 128;
+export const MAX_TEMPORAL_MAJOR_TICKS = 64;
+export const MAX_TEMPORAL_MINOR_TICKS = 256;
+export const MIN_TEMPORAL_LABEL_GAP_PX = 6;
+export class TemporalIntervalError extends Error {
+    value;
+    constructor(value, reason) {
+        super(`Invalid temporal interval ${JSON.stringify(value)}: ${reason}.`);
+        this.name = "TemporalIntervalError";
+        this.value = value;
+    }
+}
+const INTERVAL_RE = new RegExp(`^(${TEMPORAL_INTERVAL_STEP_PATTERN}) +(millisecond|second|minute|hour|day|week|month|quarter|year)(s?)$`);
+export function parseTemporalInterval(value) {
+    if (typeof value !== "string" || value.length > 128) {
+        throw new TemporalIntervalError(String(value), "expected a string of at most 128 characters");
+    }
+    const match = INTERVAL_RE.exec(value.replaceAll(/^ +| +$/g, ""));
+    if (match === null) {
+        throw new TemporalIntervalError(value, 'expected "<positive integer> <unit>" using a canonical calendar unit');
+    }
+    const step = Number(match[1]);
+    if (!Number.isSafeInteger(step) || step < 1 || step > 1_000_000) {
+        throw new TemporalIntervalError(value, "step must be an integer from 1 through 1,000,000");
+    }
+    const unit = match[2];
+    return { unit, step, key: `${step} ${unit}${step === 1 ? "" : "s"}` };
+}
+export const TEMPORAL_LABEL_TOKENS = [
+    "Y",
+    "y",
+    "m",
+    "b",
+    "B",
+    "d",
+    "e",
+    "a",
+    "A",
+    "H",
+    "I",
+    "M",
+    "S",
+    "L",
+    "p",
+    "q",
+    "z",
+    "Z",
+    "%",
+];
+const LABEL_TOKEN_SET = new Set(TEMPORAL_LABEL_TOKENS);
+/**
+ * Tokens a month-day axis can fill truthfully: those the month and the day
+ * determine. A year is absent by construction; the clock and zone would print
+ * the same midnight-UTC zeros for every tick; and the weekday belongs to the
+ * reference year, not to the observation — 1 April fell on different weekdays
+ * in 812 and 2001, so printing one would invent a fact.
+ */
+const MONTH_DAY_LABEL_TOKENS = new Set(["m", "b", "B", "d", "e", "q", "%"]);
+export function temporalLabelConfigurationError(pattern, kind) {
+    if (pattern.length === 0 || pattern.length > 128) {
+        return "dateLabels must contain 1 through 128 characters";
+    }
+    for (let index = 0; index < pattern.length; index++) {
+        if (pattern[index] !== "%")
+            continue;
+        const token = pattern[++index];
+        if (token === undefined || !LABEL_TOKEN_SET.has(token)) {
+            return `unsupported dateLabels token %${token ?? ""}`;
+        }
+        if (kind === "monthDay" && !MONTH_DAY_LABEL_TOKENS.has(token)) {
+            return `dateLabels token %${token} has no meaning on a monthDay axis, which knows only a month and a day; use one of %m %b %B %d %e %q`;
+        }
+    }
+    return null;
+}
+export function temporalLocaleConfigurationError(locale) {
+    if (locale.length === 0 || locale.length > 128) {
+        return "locale must contain 1 through 128 characters";
+    }
+    try {
+        const canonical = Intl.getCanonicalLocales(locale);
+        if (canonical.length !== 1)
+            return `invalid or unsupported locale ${JSON.stringify(locale)}`;
+        const supported = Intl.DateTimeFormat.supportedLocalesOf(canonical, {
+            localeMatcher: "lookup",
+        });
+        if (supported.length !== 1) {
+            return `invalid or unsupported locale ${JSON.stringify(locale)}`;
+        }
+        new Intl.DateTimeFormat(canonical[0], { timeZone: "UTC", year: "numeric" }).format(0);
+        return null;
+    }
+    catch {
+        return `invalid or unsupported locale ${JSON.stringify(locale)}`;
+    }
+}
+//# sourceMappingURL=temporal-interval.js.map

package/dist/temporal-interval.js.map

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