@ggts-sh/spec 0.43.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Liam O'Dea
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# @ggts-sh/spec
+
+[![codecov](https://codecov.io/gh/ggts-sh/ggts/branch/main/graph/badge.svg?component=packages-spec)](https://app.codecov.io/gh/ggts-sh/ggts/tree/main/packages%2Fspec)
+
+PortableSpec types, published JSON Schema, `normalize()`, two-tier
+`validate()` with the agent error contract
+(`{ code, path, message, allowed?, fix }`), `lintSpec()`, and the fluent
+`gg()` / `aes()` builder. No DOM, no d3. Pre-1.0.
+
+```sh
+bun add @ggts-sh/spec     # or: npm install @ggts-sh/spec
+```
+
+Install alone for validation and authoring without a renderer.
+[`@ggts-sh/svelte`](https://www.npmjs.com/package/@ggts-sh/svelte)
+re-exports this package.
+
+## Quick example
+
+```ts
+import { gg, aes, validate } from "@ggts-sh/spec";
+// constrained decoding / tool schemas
+import schema from "@ggts-sh/spec/schema/v0.json";
+
+const spec = gg(
+  [
+    { year: "1835", value: 12 },
+    { year: "2026", value: 31 },
+  ],
+  aes({ x: "year", y: "value" }),
+)
+  .geomLine()
+  .spec();
+
+const result = validate(spec, {
+  profile: {
+    fields: [
+      { name: "year", type: "temporal" },
+      { name: "value", type: "quantitative" },
+    ],
+  },
+  lint: true,
+});
+if (!result.ok) {
+  // Apply fix.example at path, then re-validate.
+  // { code, path, message, allowed?, fix: { description, example } }
+}
+```
+
+## Agent contract
+
+- `validate(spec)` — shape only.
+- `validate(spec, { profile })` — data-aware without shipping rows.
+- `validate(spec, { lint: true })` — advisories for valid-but-questionable specs.
+- Every error carries `fix.example`. Apply it at `path` and re-validate.
+- PortableSpec is JSON-only: no `Date`, callbacks, or regular expressions.
+  Builder `Date` values canonicalize to ISO strings.
+- JSON aes uses `{ field: "col" }` (bare strings are invalid in JSON). The
+  builder and Svelte props accept bare-string shorthand.
+
+## Render
+
+- Headless SVG: [`@ggts-sh/core`](https://www.npmjs.com/package/@ggts-sh/core)
+  (`renderToSVGString`)
+- CLI loop (validation + warnings on stderr):
+  [`@ggts-sh/cli`](https://www.npmjs.com/package/@ggts-sh/cli)
+  (`ggts render`)
+- Svelte 5:
+  [`@ggts-sh/svelte`](https://www.npmjs.com/package/@ggts-sh/svelte)
+
+Schema: [schema/v0.json](https://ggts.sh/schema/v0.json) · Docs:
+[ggts.sh](https://ggts.sh/) · Repo:
+[github.com/ggts-sh/ggts](https://github.com/ggts-sh/ggts)
+
+[MIT](https://github.com/ggts-sh/ggts/blob/main/LICENSE) © Liam O'Dea

package/dist/artifact.d.ts

@@ -0,0 +1,11 @@
+/** Version tag of the published schema artifact (`schema/v0.json`). */
+export declare const SCHEMA_VERSION = "v0";
+/**
+ * Build the publishable JSON Schema document (plain data, deterministic).
+ * The v0 schema remains explicitly unstable; served from the repo until
+ * hosting infrastructure exists (no $id URL is claimed yet).
+ */
+export declare function buildSchemaArtifact(): Record<string, unknown>;
+/** The artifact serialized exactly as `schema/v0.json` is committed. */
+export declare function schemaArtifactJSON(): string;
+//# sourceMappingURL=artifact.d.ts.map

package/dist/artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.d.ts","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"AAoDA,uEAAuE;AACvE,eAAO,MAAM,cAAc,OAAO,CAAC;AAEnC;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAe7D;AAED,wEAAwE;AACxE,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C"}

package/dist/artifact.js

@@ -0,0 +1,71 @@
+/**
+ * JSON Schema artifact builder (decision 0004: TypeBox `Type.Module`
+ * named-defs form is the shippable schema).
+ *
+ * Publish-time transforms applied here, exactly as the decision record
+ * prescribes:
+ *  1. `$ref: "Name"` (TypeBox $id-anchored refs) -> `#/$defs/Name`
+ *     (standard JSON Pointer form; strict provider subsets need it).
+ *  2. `patternProperties: { "^(.*)$": S }` (TypeBox `Type.Record` emission)
+ *     -> `additionalProperties: S` (semantically identical for that pattern,
+ *     and inside the portable keyword set).
+ *  3. Per-def `$id` markers removed (the artifact anchors defs under $defs).
+ *
+ * `scripts/emit-schema.ts` writes the result to `schema/v0.json`; a test
+ * asserts the committed artifact matches a fresh build (staleness guard).
+ */
+import { PlotSpecSchema } from "./schema.js";
+// TypeBox 0.x emitted `^(.*)$`; TypeBox 1.x emits `^.*$`. Both are
+// "match any property name" records and rewrite to additionalProperties.
+const RECORD_PATTERNS = new Set(["^(.*)$", "^.*$"]);
+function transform(node, defNames) {
+    if (Array.isArray(node))
+        return node.map((n) => transform(n, defNames));
+    if (typeof node !== "object" || node === null)
+        return node;
+    const out = {};
+    for (const [key, value] of Object.entries(node)) {
+        if (key === "$id" && typeof value === "string" && defNames.has(value))
+            continue;
+        if (key === "$ref" && typeof value === "string" && defNames.has(value)) {
+            out[key] = `#/$defs/${value}`;
+            continue;
+        }
+        if (key === "patternProperties" &&
+            typeof value === "object" &&
+            value !== null &&
+            Object.keys(value).length === 1) {
+            const pattern = Object.keys(value)[0];
+            if (RECORD_PATTERNS.has(pattern)) {
+                out["additionalProperties"] = transform(value[pattern], defNames);
+                continue;
+            }
+        }
+        out[key] = transform(value, defNames);
+    }
+    return out;
+}
+/** Version tag of the published schema artifact (`schema/v0.json`). */
+export const SCHEMA_VERSION = "v0";
+/**
+ * Build the publishable JSON Schema document (plain data, deterministic).
+ * The v0 schema remains explicitly unstable; served from the repo until
+ * hosting infrastructure exists (no $id URL is claimed yet).
+ */
+export function buildSchemaArtifact() {
+    // JSON round-trip drops TypeBox's symbol keys and proves JSON-plainness.
+    const raw = JSON.parse(JSON.stringify(PlotSpecSchema));
+    const defNames = new Set(Object.keys(raw.$defs));
+    const transformed = transform(raw, defNames);
+    return {
+        $schema: "https://json-schema.org/draft/2020-12/schema",
+        title: "ggts PortableSpec",
+        description: "A ggts plot specification (schema v0 — UNSTABLE; served from the repo until schema hosting exists).",
+        ...transformed,
+    };
+}
+/** The artifact serialized exactly as `schema/v0.json` is committed. */
+export function schemaArtifactJSON() {
+    return JSON.stringify(buildSchemaArtifact(), null, 2) + "\n";
+}
+//# sourceMappingURL=artifact.js.map

package/dist/artifact.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact.js","sourceRoot":"","sources":["../src/artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,mEAAmE;AACnE,yEAAyE;AACzE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;AAEpD,SAAS,SAAS,CAAC,IAAa,EAAE,QAA6B;IAC7D,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,CAAC;IACxE,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IAC3D,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAA+B,CAAC,EAAE,CAAC;QAC3E,IAAI,GAAG,KAAK,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;YAAE,SAAS;QAChF,IAAI,GAAG,KAAK,MAAM,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YACvE,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,KAAK,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QACD,IACE,GAAG,KAAK,mBAAmB;YAC3B,OAAO,KAAK,KAAK,QAAQ;YACzB,KAAK,KAAK,IAAI;YACd,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAC/B,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC;YACvC,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC;gBACjC,GAAG,CAAC,sBAAsB,CAAC,GAAG,SAAS,CACpC,KAAiC,CAAC,OAAO,CAAC,EAC3C,QAAQ,CACT,CAAC;gBACF,SAAS;YACX,CAAC;QACH,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,uEAAuE;AACvE,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,CAAC;AAEnC;;;;GAIG;AACH,MAAM,UAAU,mBAAmB;IACjC,yEAAyE;IACzE,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAGpD,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACjD,MAAM,WAAW,GAAG,SAAS,CAAC,GAAG,EAAE,QAAQ,CAA4B,CAAC;IACxE,OAAO;QACL,OAAO,EAAE,8CAA8C;QACvD,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,qGAAqG;QACvG,GAAG,WAAW;KACf,CAAC;AACJ,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,CAAC,SAAS,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC;AAC/D,CAAC"}

package/dist/builder-core.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Fluent builder core: state, layer/facet/coord/labs/theme/spec.
+ * Geom sugar mixin: builder-geoms.ts. Scale sugar mixin: builder-scales.ts.
+ * Public GGBuilder: builder.ts.
+ */
+import { type CoordFixedOptions, type CoordPolarOptions, type CoordRadialOptions, type CoordSfOptions, type CoordTransformOptions } from "./coord-helpers.js";
+import type { AesInput, FacetInput, LayerInput, SpecInput } from "./normalize.js";
+import { type AuthoringDataRef, type DataInput } from "./builder-data.js";
+import type { A11yMode, GuidesSpec, Labs, LegendSpec, PortableSpec, PositionParams, RenderBackend, Scales, ThemeName, ThemeSpec } from "./schema.js";
+import type { GGBuilder } from "./builder.js";
+interface BuilderState {
+    readonly data?: AuthoringDataRef;
+    readonly aes?: AesInput;
+    readonly layers: readonly LayerInput[];
+    readonly facet?: FacetInput;
+    readonly coord?: SpecInput["coord"];
+    readonly a11y?: A11yMode;
+    readonly scales?: Scales;
+    readonly guides?: GuidesSpec;
+    readonly legend?: LegendSpec;
+    readonly labs?: Labs;
+    readonly theme?: ThemeName | ThemeSpec;
+    readonly width?: number;
+    readonly height?: number;
+}
+/** Assemble a LayerInput from a geom name and sugar options. */
+export declare function layerFrom(geom: LayerInput["geom"], options: {
+    aes?: AesInput;
+    render?: RenderBackend;
+    position?: string;
+    positionParams?: PositionParams;
+    stat?: string;
+    data?: DataInput;
+    inspect?: false;
+}): LayerInput;
+/**
+ * Immutable plot builder core (layer/facet/coord/labs/theme/spec).
+ * Geom sugar: WithBuilderGeoms. Scale sugar: WithBuilderScales.
+ * Final public class is GGBuilder (builder.ts). Not a public package export.
+ */
+export declare class GGBuilderCore {
+    #private;
+    constructor(state: BuilderState);
+    /** Add a layer (canonical form — the geom* methods are sugar for this). */
+    layer(layer: LayerInput): GGBuilder;
+    /**
+     * Facet into small multiples: wrap form ({ wrap, ncol? }) or grid form
+     * ({ rows, cols }). Bare strings are field shorthand. Field objects accept
+     * closed `levels` order and a display `labels` map. `strip.position` is
+     * top/bottom/left/right (default top); `strip.show: false` hides strip
+     * chrome. scales controls per-panel positional-scale freedom ("fixed" default).
+     */
+    facet(facet: FacetInput): GGBuilder;
+    /** Set the coordinate system ("flip" is shorthand for { type: "flip" }). */
+    coord(coord: SpecInput["coord"] | "flip"): GGBuilder;
+    /** Sugar for .coord("flip") — THE horizontal-composition mechanism. */
+    coordFlip(): GGBuilder;
+    /** Configure a post-stat coordinate transform (distinct from scale transforms). */
+    coordTransform(options?: CoordTransformOptions): GGBuilder;
+    /** Preserve a physical y-unit/x-unit ratio in the fitted data rectangle. */
+    coordFixed(options?: CoordFixedOptions): GGBuilder;
+    /** Equal-unit spelling of coordFixed(). */
+    coordEqual(options?: CoordFixedOptions): GGBuilder;
+    /**
+     * Fixed-aspect coordinates for already-projected geom_sf maps (ggplot2
+     * coord_sf subset; #809). No CRS reproject in v1.
+     */
+    coordSf(options?: CoordSfOptions): GGBuilder;
+    /**
+     * Polar/radial coordinates (ggplot2 coord_radial). Pie charts use
+     * theta: "y" with expand: false on a stacked bar/col.
+     */
+    coordRadial(options?: CoordRadialOptions): GGBuilder;
+    /**
+     * ggplot2 coord_polar alias — emits type "radial" with polar defaults
+     * (clip on; direction -1 → reverse theta).
+     */
+    coordPolar(options?: CoordPolarOptions): GGBuilder;
+    /** Set the accessibility mode ("force-svg" keeps every layer in SVG). */
+    a11y(mode: A11yMode): GGBuilder;
+    /** Configure scales (merged per scale over previous calls). */
+    scales(scales: Scales): GGBuilder;
+    /** Configure appearance-only guides (merged per aesthetic over previous calls). */
+    guides(guides: GuidesSpec): GGBuilder;
+    /** Configure the legacy legend entry order (merged over previous calls). */
+    legend(legend: LegendSpec): GGBuilder;
+    /** Set the theme: a registered name or an object with role overrides. */
+    theme(theme: ThemeName | ThemeSpec): GGBuilder;
+    /** Set human-readable labels (merged over previously set labels). */
+    labs(labs: Labs): GGBuilder;
+    /**
+     * Normalize only: channel shorthand, geom defaults, aes inheritance.
+     * Does not load TypeBox — the render pipeline runs structural gates; agents
+     * that need full schema validation should call {@link spec} (full package)
+     * or `validate()` explicitly.
+     */
+    toPortable(): PortableSpec;
+}
+export {};
+//# sourceMappingURL=builder-core.d.ts.map

package/dist/builder-core.d.ts.map

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

package/dist/builder-core.js

@@ -0,0 +1,176 @@
+/**
+ * Fluent builder core: state, layer/facet/coord/labs/theme/spec.
+ * Geom sugar mixin: builder-geoms.ts. Scale sugar mixin: builder-scales.ts.
+ * Public GGBuilder: builder.ts.
+ */
+import { coordFixed, coordPolar, coordRadial, coordSf, coordTransform, } from "./coord-helpers.js";
+import { normalize } from "./normalize.js";
+import { calendarDateFields, toAuthoringDataRef, toDataRef, } from "./builder-data.js";
+/** Assemble a LayerInput from a geom name and sugar options. */
+export function layerFrom(geom, options) {
+    const { aes: layerAes, render, position, positionParams, stat, data, inspect, ...params } = options;
+    // Do not snapshot here: every geom sugar path is `this.layer(layerFrom(...))`,
+    // and `layer()` is the single defensive-copy point (#1280). Snapshotting in
+    // both places deep-copied every row twice on `geom*({ data })`.
+    const withData = data === undefined ? {} : { data: data };
+    return {
+        geom,
+        ...(stat !== undefined && { stat }),
+        ...(position !== undefined && { position }),
+        ...(positionParams !== undefined && { positionParams }),
+        ...(render !== undefined && { render }),
+        ...(inspect !== undefined && { inspect }),
+        ...(layerAes !== undefined && { aes: layerAes }),
+        ...withData,
+        ...(Object.keys(params).length > 0 && { params }),
+    };
+}
+/**
+ * Immutable plot builder core (layer/facet/coord/labs/theme/spec).
+ * Geom sugar: WithBuilderGeoms. Scale sugar: WithBuilderScales.
+ * Final public class is GGBuilder (builder.ts). Not a public package export.
+ */
+export class GGBuilderCore {
+    #state;
+    constructor(state) {
+        this.#state = state;
+    }
+    /**
+     * Clone with a state patch. Uses `this.constructor` so the WithBuilderScales
+     * subclass (GGBuilder) is preserved across immutable transitions.
+     */
+    #with(patch) {
+        return new this.constructor({
+            ...this.#state,
+            ...patch,
+        });
+    }
+    /** Add a layer (canonical form — the geom* methods are sugar for this). */
+    layer(layer) {
+        // Sole snapshot for layer data: geom sugar and direct `.layer({ data })`
+        // both land here. Later mutation of caller-owned arrays cannot leak into
+        // `.spec()`; portable Date→ISO conversion still happens in `toPortable`.
+        if (layer.data === undefined) {
+            return this.#with({ layers: [...this.#state.layers, layer] });
+        }
+        // layer.data may be raw DataInput (geom sugar) or an AuthoringDataRef
+        // already; toAuthoringDataRef accepts both.
+        const snapped = {
+            ...layer,
+            data: toAuthoringDataRef(layer.data),
+        };
+        return this.#with({ layers: [...this.#state.layers, snapped] });
+    }
+    /**
+     * Facet into small multiples: wrap form ({ wrap, ncol? }) or grid form
+     * ({ rows, cols }). Bare strings are field shorthand. Field objects accept
+     * closed `levels` order and a display `labels` map. `strip.position` is
+     * top/bottom/left/right (default top); `strip.show: false` hides strip
+     * chrome. scales controls per-panel positional-scale freedom ("fixed" default).
+     */
+    facet(facet) {
+        return this.#with({ facet });
+    }
+    /** Set the coordinate system ("flip" is shorthand for { type: "flip" }). */
+    coord(coord) {
+        return this.#with({ coord: coord === "flip" ? { type: "flip" } : coord });
+    }
+    /** Sugar for .coord("flip") — THE horizontal-composition mechanism. */
+    coordFlip() {
+        return this.coord("flip");
+    }
+    /** Configure a post-stat coordinate transform (distinct from scale transforms). */
+    coordTransform(options = {}) {
+        return this.coord(coordTransform(options));
+    }
+    /** Preserve a physical y-unit/x-unit ratio in the fitted data rectangle. */
+    coordFixed(options = {}) {
+        return this.coord(coordFixed(options));
+    }
+    /** Equal-unit spelling of coordFixed(). */
+    coordEqual(options = {}) {
+        return this.coord(coordFixed(options));
+    }
+    /**
+     * Fixed-aspect coordinates for already-projected geom_sf maps (ggplot2
+     * coord_sf subset; #809). No CRS reproject in v1.
+     */
+    coordSf(options = {}) {
+        return this.coord(coordSf(options));
+    }
+    /**
+     * Polar/radial coordinates (ggplot2 coord_radial). Pie charts use
+     * theta: "y" with expand: false on a stacked bar/col.
+     */
+    coordRadial(options = {}) {
+        return this.coord(coordRadial(options));
+    }
+    /**
+     * ggplot2 coord_polar alias — emits type "radial" with polar defaults
+     * (clip on; direction -1 → reverse theta).
+     */
+    coordPolar(options = {}) {
+        return this.coord(coordPolar(options));
+    }
+    /** Set the accessibility mode ("force-svg" keeps every layer in SVG). */
+    a11y(mode) {
+        return this.#with({ a11y: mode });
+    }
+    /** Configure scales (merged per scale over previous calls). */
+    scales(scales) {
+        return this.#with({ scales: { ...this.#state.scales, ...scales } });
+    }
+    /** Configure appearance-only guides (merged per aesthetic over previous calls). */
+    guides(guides) {
+        return this.#with({ guides: { ...this.#state.guides, ...guides } });
+    }
+    /** Configure the legacy legend entry order (merged over previous calls). */
+    legend(legend) {
+        return this.#with({ legend: { ...this.#state.legend, ...legend } });
+    }
+    /** Set the theme: a registered name or an object with role overrides. */
+    theme(theme) {
+        return this.#with({ theme });
+    }
+    /** Set human-readable labels (merged over previously set labels). */
+    labs(labs) {
+        return this.#with({ labs: { ...this.#state.labs, ...labs } });
+    }
+    /**
+     * Normalize only: channel shorthand, geom defaults, aes inheritance.
+     * Does not load TypeBox — the render pipeline runs structural gates; agents
+     * that need full schema validation should call {@link spec} (full package)
+     * or `validate()` explicitly.
+     */
+    toPortable() {
+        const { data, aes: plotAes, layers, facet, coord, a11y, scales, guides, legend, labs, theme, width, height, } = this.#state;
+        const calendarFields = calendarDateFields(this.#state);
+        const portableLayers = layers.map((layer) => {
+            if (layer.data === undefined)
+                return layer;
+            // layer() stores AuthoringDataRef snapshots as LayerInput.data; portable
+            // ISO conversion runs here with the final calendar-date field set.
+            return {
+                ...layer,
+                data: toDataRef(layer.data, calendarFields),
+            };
+        });
+        const input = {
+            ...(data !== undefined && { data: toDataRef(data, calendarFields) }),
+            ...(plotAes !== undefined && { aes: plotAes }),
+            layers: portableLayers,
+            ...(facet !== undefined && { facet }),
+            ...(coord !== undefined && { coord }),
+            ...(a11y !== undefined && { a11y }),
+            ...(scales !== undefined && { scales }),
+            ...(guides !== undefined && { guides }),
+            ...(legend !== undefined && { legend }),
+            ...(labs !== undefined && { labs }),
+            ...(theme !== undefined && { theme }),
+            ...(width !== undefined && { width }),
+            ...(height !== undefined && { height }),
+        };
+        return normalize(input);
+    }
+}
+//# sourceMappingURL=builder-core.js.map

package/dist/builder-core.js.map

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

package/dist/builder-data.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Builder/Svelte authoring data conversion.
+ *
+ * Accepts rows, columns, or named DataRef forms with Date cells; snapshots
+ * inputs immutably for `gg()`; and materializes portable CellValue data
+ * (ISO date/datetime strings) for `.spec()`. Geom sugar and GGBuilder live
+ * in builder.ts.
+ */
+import type { AesInput } from "./normalize.js";
+import type { CellValue, DataRef, Scales } from "./schema.js";
+/** A builder/Svelte data cell. Dates canonicalize to ISO before validation. */
+export type AuthoringCellValue = CellValue | Date;
+export type AuthoringRows = readonly Readonly<Record<string, AuthoringCellValue>>[];
+export type AuthoringColumns = Readonly<Record<string, readonly AuthoringCellValue[]>>;
+export type AuthoringDataRef = {
+    values: AuthoringRows;
+} | {
+    columns: AuthoringColumns;
+} | {
+    name: string;
+};
+/** Data accepted by gg(): authoring rows, columns, or a data reference. */
+export type DataInput = AuthoringRows | AuthoringColumns | AuthoringDataRef;
+export declare function toAuthoringDataRef(data: DataInput): AuthoringDataRef;
+export declare function toDataRef(data: AuthoringDataRef, calendarFields: ReadonlySet<string>): DataRef;
+/** Minimal state slice needed to decide calendar-date ISO truncation. */
+export interface BuilderCalendarSource {
+    readonly aes?: AesInput;
+    readonly layers: readonly {
+        readonly aes?: AesInput;
+    }[];
+    readonly scales?: Scales;
+}
+/** Fields mapped on scales with temporalKind "date" (calendar ISO date cells). */
+export declare function calendarDateFields(state: BuilderCalendarSource): ReadonlySet<string>;
+//# sourceMappingURL=builder-data.d.ts.map

package/dist/builder-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder-data.d.ts","sourceRoot":"","sources":["../src/builder-data.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE9D,+EAA+E;AAC/E,MAAM,MAAM,kBAAkB,GAAG,SAAS,GAAG,IAAI,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,EAAE,CAAC;AACpF,MAAM,MAAM,gBAAgB,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,kBAAkB,EAAE,CAAC,CAAC,CAAC;AACvF,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,aAAa,CAAA;CAAE,GACzB;IAAE,OAAO,EAAE,gBAAgB,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAErB,2EAA2E;AAC3E,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AA6C5E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,gBAAgB,CAQpE;AAsCD,wBAAgB,SAAS,CAAC,IAAI,EAAE,gBAAgB,EAAE,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,OAAO,CAI9F;AAOD,yEAAyE;AACzE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,SAAS;QAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAA;KAAE,EAAE,CAAC;IACxD,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,kFAAkF;AAClF,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,qBAAqB,GAAG,WAAW,CAAC,MAAM,CAAC,CAuBpF"}

package/dist/builder-data.js

@@ -0,0 +1,123 @@
+/**
+ * Builder/Svelte authoring data conversion.
+ *
+ * Accepts rows, columns, or named DataRef forms with Date cells; snapshots
+ * inputs immutably for `gg()`; and materializes portable CellValue data
+ * (ISO date/datetime strings) for `.spec()`. Geom sugar and GGBuilder live
+ * in builder.ts.
+ */
+function isDataRef(data) {
+    if (Array.isArray(data))
+        return false;
+    const keys = Object.keys(data);
+    if (keys.length !== 1)
+        return false;
+    const key = keys[0];
+    if (key === "name")
+        return typeof data.name === "string";
+    if (key === "values")
+        return Array.isArray(data.values);
+    if (key === "columns") {
+        const columns = data.columns;
+        return typeof columns === "object" && columns !== null && !Array.isArray(columns);
+    }
+    return false;
+}
+function snapshotCell(value) {
+    return value instanceof Date ? new Date(value.getTime()) : value;
+}
+/** True when any cell is a Date (needs clone-on-snapshot / ISO materialization). */
+function columnHasDate(values) {
+    for (let i = 0; i < values.length; i++) {
+        if (values[i] instanceof Date)
+            return true;
+    }
+    return false;
+}
+function snapshotRows(rows) {
+    return rows.map((row) => Object.fromEntries(Object.entries(row).map(([key, value]) => [key, snapshotCell(value)])));
+}
+function snapshotColumns(columns) {
+    return Object.fromEntries(Object.entries(columns).map(([key, values]) => {
+        // No Date cells: shallow-copy the column (slice) instead of per-cell map.
+        // Isolates length/index mutation; ~4× faster on 30k-point competitive data.
+        if (!columnHasDate(values))
+            return [key, values.slice()];
+        return [key, values.map((value) => snapshotCell(value))];
+    }));
+}
+export function toAuthoringDataRef(data) {
+    if (Array.isArray(data))
+        return { values: snapshotRows(data) };
+    if (isDataRef(data)) {
+        if ("name" in data)
+            return data;
+        if ("values" in data)
+            return { values: snapshotRows(data.values) };
+        return { columns: snapshotColumns(data.columns) };
+    }
+    return { columns: snapshotColumns(data) };
+}
+function portableCell(value, calendarDate) {
+    if (!(value instanceof Date))
+        return value;
+    const iso = value.toISOString();
+    return calendarDate ? iso.slice(0, 10) : iso;
+}
+function portableRows(rows, calendarFields) {
+    return rows.map((row) => Object.fromEntries(Object.entries(row).map(([key, value]) => [
+        key,
+        portableCell(value, calendarFields.has(key)),
+    ])));
+}
+function portableColumns(columns, calendarFields) {
+    return Object.fromEntries(Object.entries(columns).map(([key, values]) => {
+        // Already-snapshotted non-Date columns need no ISO rewrite — share the
+        // array. Second O(n) map was a top cost on line-3×10k toPortable().
+        if (!calendarFields.has(key) && !columnHasDate(values)) {
+            return [key, values];
+        }
+        return [key, values.map((value) => portableCell(value, calendarFields.has(key)))];
+    }));
+}
+export function toDataRef(data, calendarFields) {
+    if ("name" in data)
+        return data;
+    if ("values" in data)
+        return { values: portableRows(data.values, calendarFields) };
+    return { columns: portableColumns(data.columns, calendarFields) };
+}
+function mappedField(value) {
+    if (typeof value === "string")
+        return value;
+    return value !== undefined && value !== null && "field" in value ? value.field : null;
+}
+/** Fields mapped on scales with temporalKind "date" (calendar ISO date cells). */
+export function calendarDateFields(state) {
+    const fields = new Set();
+    const mappings = [
+        ["x", ["x", "xmin", "xmax", "xend"]],
+        ["y", ["y", "ymin", "ymax", "yend"]],
+        ["color", ["color"]],
+        ["fill", ["fill"]],
+        ["size", ["size"]],
+        ["linewidth", ["linewidth"]],
+        ["alpha", ["alpha"]],
+    ];
+    for (const [scale, channels] of mappings) {
+        if (state.scales?.[scale]?.temporalKind !== "date")
+            continue;
+        for (const channel of channels) {
+            const plotField = mappedField(state.aes?.[channel]);
+            if (plotField !== null)
+                fields.add(plotField);
+            for (const layer of state.layers) {
+                const layerField = mappedField(layer.aes?.[channel]);
+                if (layerField !== null)
+                    fields.add(layerField);
+            }
+        }
+    }
+    return fields;
+}
+//# sourceMappingURL=builder-data.js.map