@ggts-sh/spec 0.43.0

package/dist/geom-params.d.ts

@@ -0,0 +1,13 @@
+/**
+ * GEOM_PARAM_KEYS (#1039) — param-key whitelist per geom.
+ *
+ * Precomputed from SpecDeclarations (`scripts/gen-reference-catalogs.ts`) so
+ * createGeomLayer never loads TypeBox. Regenerate after schema param changes.
+ */
+import type { GeomName } from "./schema-catalog.js";
+/**
+ * Param property names per geom, derived from SpecDeclarations at gen time.
+ * Empty array means the geom has no params object properties (e.g. blank).
+ */
+export declare const GEOM_PARAM_KEYS: Readonly<Record<GeomName, readonly string[]>>;
+//# sourceMappingURL=geom-params.d.ts.map

package/dist/geom-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geom-params.d.ts","sourceRoot":"","sources":["../src/geom-params.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,CAAC,CAAwB,CAAC"}

package/dist/geom-params.js

@@ -0,0 +1,7 @@
+import { GEOM_PARAM_KEYS_DATA } from "./generated/geom-param-keys.js";
+/**
+ * Param property names per geom, derived from SpecDeclarations at gen time.
+ * Empty array means the geom has no params object properties (e.g. blank).
+ */
+export const GEOM_PARAM_KEYS = GEOM_PARAM_KEYS_DATA;
+//# sourceMappingURL=geom-params.js.map

package/dist/geom-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geom-params.js","sourceRoot":"","sources":["../src/geom-params.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,oBAAoB,EAAE,MAAM,gCAAgC,CAAC;AAEtE;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAAkD,oBAAoB,CAAC"}

package/dist/geom-reference-build.d.ts

@@ -0,0 +1,29 @@
+import { type AliasGeomName, type GeomName, type PositionName, type StatName } from "./schema-catalog.js";
+export interface GeomParamDoc {
+    readonly name: string;
+    readonly description: string;
+    /** Human type summary: number, string, boolean, union literals, ref name. */
+    readonly typeSummary: string;
+    readonly required: boolean;
+}
+export interface GeomReferenceEntry {
+    readonly name: GeomName;
+    /** Route slug — same as geom name (snake_case). */
+    readonly slug: string;
+    /** Svelte component export, e.g. GeomPoint. */
+    readonly component: string;
+    /** Short purpose text from the layer schema (geom literal description preferred). */
+    readonly summary: string;
+    readonly defaultStat: StatName;
+    readonly defaultPosition: PositionName;
+    readonly allowedStats: readonly StatName[];
+    readonly allowedPositions: readonly PositionName[];
+    /** Params type name in SpecDeclarations (e.g. PointParams). */
+    readonly paramsType: string;
+    /** Direct props on the Svelte shell / keys of layer.params. */
+    readonly params: readonly GeomParamDoc[];
+    /** Set when normalize() rewrites this geom to another. */
+    readonly aliasOf?: Exclude<GeomName, AliasGeomName>;
+}
+export declare function buildGeomReference(): Readonly<Record<GeomName, GeomReferenceEntry>>;
+//# sourceMappingURL=geom-reference-build.d.ts.map

package/dist/geom-reference-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"geom-reference-build.d.ts","sourceRoot":"","sources":["../src/geom-reference-build.ts"],"names":[],"mappings":"AAMA,OAAO,EAIL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAU7B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IACnD,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;CACrD;AA2OD,wBAAgB,kBAAkB,IAAI,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC,CAMnF"}

package/dist/geom-reference-build.js

@@ -0,0 +1,221 @@
+import { GEOM_ALIASES, GEOM_DEFAULTS, KNOWN_GEOMS, } from "./schema-catalog.js";
+import { SpecDeclarations } from "./schema-declarations.js";
+// ---------------------------------------------------------------------------
+// Naming
+// ---------------------------------------------------------------------------
+/** snake_case geom → GeomPascalCase component name. */
+function componentNameForGeom(geom) {
+    const pascal = geom
+        .split("_")
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+    return `Geom${pascal}`;
+}
+// ---------------------------------------------------------------------------
+// Schema walkers
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function findRef(node, depth = 0) {
+    if (!isRecord(node) || depth > 8)
+        return undefined;
+    const ref = node["$ref"];
+    if (typeof ref === "string")
+        return ref;
+    for (const child of Object.values(node)) {
+        const found = findRef(child, depth + 1);
+        if (found !== undefined)
+            return found;
+    }
+    return undefined;
+}
+function resolveDeclaration(name, seen = new Set()) {
+    if (seen.has(name)) {
+        throw new Error(`GEOM_REFERENCE: cyclic SpecDeclarations ref involving "${name}"`);
+    }
+    if (!(name in SpecDeclarations)) {
+        throw new Error(`GEOM_REFERENCE: SpecDeclarations has no entry "${name}"`);
+    }
+    seen.add(name);
+    const schema = SpecDeclarations[name];
+    if (typeof schema.$ref === "string") {
+        return resolveDeclaration(schema.$ref, seen);
+    }
+    return schema;
+}
+function refName(node) {
+    const ref = node["$ref"];
+    return typeof ref === "string" ? ref : undefined;
+}
+function descriptionOf(node, depth = 0) {
+    if (!isRecord(node) || depth > 8)
+        return "";
+    const d = node["description"];
+    if (typeof d === "string" && d.trim() !== "")
+        return d;
+    // Type.Ref("Foo") without an inline description — fall back to the target type.
+    const ref = refName(node);
+    if (ref !== undefined) {
+        return descriptionOf(resolveDeclaration(ref), depth + 1);
+    }
+    return "";
+}
+/**
+ * Collect string const literals from a TypeBox union / literal / $ref node.
+ * Order follows schema declaration order (stable for docs).
+ */
+function collectStringConsts(node, depth = 0) {
+    if (!isRecord(node) || depth > 12)
+        return [];
+    const ref = refName(node);
+    if (ref !== undefined) {
+        return collectStringConsts(resolveDeclaration(ref), depth + 1);
+    }
+    if (typeof node["const"] === "string") {
+        return [node["const"]];
+    }
+    const anyOf = node["anyOf"];
+    if (Array.isArray(anyOf)) {
+        const out = [];
+        for (const branch of anyOf) {
+            out.push(...collectStringConsts(branch, depth + 1));
+        }
+        return out;
+    }
+    const oneOf = node["oneOf"];
+    if (Array.isArray(oneOf)) {
+        const out = [];
+        for (const branch of oneOf) {
+            out.push(...collectStringConsts(branch, depth + 1));
+        }
+        return out;
+    }
+    return [];
+}
+function typeSummaryOf(node, depth = 0) {
+    if (!isRecord(node) || depth > 8)
+        return "unknown";
+    const ref = refName(node);
+    if (ref !== undefined) {
+        return ref;
+    }
+    if (typeof node["const"] === "string" || typeof node["const"] === "number") {
+        return JSON.stringify(node["const"]);
+    }
+    const anyOf = node["anyOf"];
+    if (Array.isArray(anyOf)) {
+        const parts = anyOf.map((branch) => typeSummaryOf(branch, depth + 1));
+        // Collapse pure string-const unions to "a" | "b"
+        if (parts.every((p) => p.startsWith('"') || p.startsWith("'") || /^-?\d/.test(p))) {
+            return [...new Set(parts)].join(" | ");
+        }
+        return parts.join(" | ");
+    }
+    const type = node["type"];
+    if (type === "number" || type === "integer")
+        return "number";
+    if (type === "string")
+        return "string";
+    if (type === "boolean")
+        return "boolean";
+    if (type === "array") {
+        const items = node["items"];
+        return `Array<${typeSummaryOf(items, depth + 1)}>`;
+    }
+    if (type === "object")
+        return "object";
+    if (Array.isArray(type)) {
+        return type.filter((t) => t !== "null").join(" | ") || "unknown";
+    }
+    return "unknown";
+}
+function isRequiredProp(schema, name) {
+    return Array.isArray(schema.required) && schema.required.includes(name);
+}
+function layerForGeom(geom) {
+    for (const key of Object.keys(SpecDeclarations)) {
+        if (!key.endsWith("Layer"))
+            continue;
+        const layer = SpecDeclarations[key];
+        if (layer.properties?.geom?.const === geom) {
+            return { key, layer };
+        }
+    }
+    throw new Error(`GEOM_REFERENCE: no *Layer schema with geom const "${geom}"`);
+}
+function paramsTypeNameForLayer(layer, geom, key) {
+    const paramsNode = layer.properties?.params;
+    if (paramsNode === undefined) {
+        throw new Error(`GEOM_REFERENCE: layer ${key} has no params field for geom "${geom}"`);
+    }
+    const ref = findRef(paramsNode);
+    if (ref === undefined) {
+        throw new Error(`GEOM_REFERENCE: layer ${key} params has no $ref for geom "${geom}"`);
+    }
+    return ref;
+}
+function paramsDocsForType(paramsType) {
+    const resolved = resolveDeclaration(paramsType);
+    const props = resolved.properties;
+    if (props === undefined)
+        return Object.freeze([]);
+    const docs = [];
+    for (const [name, propSchema] of Object.entries(props)) {
+        docs.push({
+            name,
+            description: descriptionOf(propSchema),
+            typeSummary: typeSummaryOf(propSchema),
+            required: isRequiredProp(resolved, name),
+        });
+    }
+    return Object.freeze(docs);
+}
+function buildEntry(geom) {
+    const { key, layer } = layerForGeom(geom);
+    const geomNode = layer.properties?.geom;
+    const summary = (typeof geomNode?.description === "string" && geomNode.description.trim() !== ""
+        ? geomNode.description
+        : undefined) ??
+        (typeof layer.description === "string" && layer.description.trim() !== ""
+            ? layer.description
+            : undefined) ??
+        `${componentNameForGeom(geom)} layer (${geom}).`;
+    const allowedStats = collectStringConsts(layer.properties?.stat);
+    const allowedPositions = collectStringConsts(layer.properties?.position);
+    if (allowedStats.length === 0) {
+        throw new Error(`GEOM_REFERENCE: geom "${geom}" (${key}) has no allowed stats`);
+    }
+    if (allowedPositions.length === 0) {
+        throw new Error(`GEOM_REFERENCE: geom "${geom}" (${key}) has no allowed positions`);
+    }
+    const paramsType = paramsTypeNameForLayer(layer, geom, key);
+    const defaults = GEOM_DEFAULTS[geom];
+    const base = {
+        name: geom,
+        slug: geom,
+        component: componentNameForGeom(geom),
+        summary,
+        defaultStat: defaults.stat,
+        defaultPosition: defaults.position,
+        allowedStats: Object.freeze(allowedStats),
+        allowedPositions: Object.freeze(allowedPositions),
+        paramsType,
+        params: paramsDocsForType(paramsType),
+    };
+    if (Object.hasOwn(GEOM_ALIASES, geom)) {
+        return Object.freeze({
+            ...base,
+            aliasOf: GEOM_ALIASES[geom],
+        });
+    }
+    return Object.freeze(base);
+}
+export function buildGeomReference() {
+    const out = {};
+    for (const geom of KNOWN_GEOMS) {
+        out[geom] = buildEntry(geom);
+    }
+    return Object.freeze(out);
+}
+//# sourceMappingURL=geom-reference-build.js.map

package/dist/geom-reference-build.js.map

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

package/dist/geom-reference.d.ts

@@ -0,0 +1,52 @@
+/**
+ * GEOM_REFERENCE — per-geom API docs for the docs site.
+ *
+ * Catalog data is precomputed from SpecDeclarations
+ * (`scripts/gen-reference-catalogs.ts`) so reference pages never load TypeBox.
+ * Shells under packages/svelte/src/lib/geoms/ are declaration-only; document
+ * this catalog instead of TypeDoc.
+ */
+import { type AliasGeomName, type GeomName, type PositionName, type StatName } from "./schema-catalog.js";
+export interface GeomParamDoc {
+    readonly name: string;
+    readonly description: string;
+    /** Human type summary: number, string, boolean, union literals, ref name. */
+    readonly typeSummary: string;
+    readonly required: boolean;
+}
+export interface SharedLayerPropDoc {
+    readonly name: string;
+    readonly description: string;
+    readonly typeSummary: string;
+}
+export interface GeomReferenceEntry {
+    readonly name: GeomName;
+    /** Route slug — same as geom name (snake_case). */
+    readonly slug: string;
+    /** Svelte component export, e.g. GeomPoint. */
+    readonly component: string;
+    /** Short purpose text from the layer schema (geom literal description preferred). */
+    readonly summary: string;
+    readonly defaultStat: StatName;
+    readonly defaultPosition: PositionName;
+    readonly allowedStats: readonly StatName[];
+    readonly allowedPositions: readonly PositionName[];
+    /** Params type name in SpecDeclarations (e.g. PointParams). */
+    readonly paramsType: string;
+    /** Direct props on the Svelte shell / keys of layer.params. */
+    readonly params: readonly GeomParamDoc[];
+    /** Set when normalize() rewrites this geom to another. */
+    readonly aliasOf?: Exclude<GeomName, AliasGeomName>;
+}
+/** Props common to every `<Geom*>` shell and JSON layer, outside geom params. */
+export declare const SHARED_LAYER_PROPS: readonly SharedLayerPropDoc[];
+/** snake_case geom → GeomPascalCase component name. */
+export declare function componentNameForGeom(geom: string): string;
+/**
+ * Complete per-geom API reference derived from SpecDeclarations at gen time.
+ * Keys are exactly KNOWN_GEOMS; a missing geom is a generate-time throw.
+ */
+export declare const GEOM_REFERENCE: Readonly<Record<GeomName, GeomReferenceEntry>>;
+/** Stable list order matching KNOWN_GEOMS (docs index, search, inventory). */
+export declare function geomReferenceList(): readonly GeomReferenceEntry[];
+//# sourceMappingURL=geom-reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"geom-reference.d.ts","sourceRoot":"","sources":["../src/geom-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,QAAQ,EACd,MAAM,qBAAqB,CAAC;AAO7B,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,mDAAmD;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+CAA+C;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,qFAAqF;IACrF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC;IAC/B,QAAQ,CAAC,eAAe,EAAE,YAAY,CAAC;IACvC,QAAQ,CAAC,YAAY,EAAE,SAAS,QAAQ,EAAE,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;IACnD,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,+DAA+D;IAC/D,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,0DAA0D;IAC1D,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;CACrD;AAMD,iFAAiF;AACjF,eAAO,MAAM,kBAAkB,EAAE,SAAS,kBAAkB,EA0C1D,CAAC;AAMH,uDAAuD;AACvD,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMzD;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/geom-reference.js

@@ -0,0 +1,72 @@
+/**
+ * GEOM_REFERENCE — per-geom API docs for the docs site.
+ *
+ * Catalog data is precomputed from SpecDeclarations
+ * (`scripts/gen-reference-catalogs.ts`) so reference pages never load TypeBox.
+ * Shells under packages/svelte/src/lib/geoms/ are declaration-only; document
+ * this catalog instead of TypeDoc.
+ */
+import { KNOWN_GEOMS, } from "./schema-catalog.js";
+import { GEOM_REFERENCE_DATA } from "./generated/geom-reference-data.js";
+// ---------------------------------------------------------------------------
+// Shared layer props (every Geom* shell + every *Layer schema)
+// ---------------------------------------------------------------------------
+/** Props common to every `<Geom*>` shell and JSON layer, outside geom params. */
+export const SHARED_LAYER_PROPS = Object.freeze([
+    {
+        name: "data",
+        typeSummary: "DataInput | readonly Record<string, unknown>[]",
+        description: "Optional layer-local data. When omitted, the layer inherits plot-level data. Inline rows, inline columns, or a named dataset.",
+    },
+    {
+        name: "aes",
+        typeSummary: "Aes",
+        description: "Optional aesthetic mapping for this layer. Merges over plot-level aes; set a channel to null to unset an inherited mapping.",
+    },
+    {
+        name: "stat",
+        typeSummary: "StatName (geom-specific)",
+        description: "Statistical transform applied before drawing. Omit to use the geom default (see defaultStat). Only values listed in allowedStats validate.",
+    },
+    {
+        name: "position",
+        typeSummary: "PositionName (geom-specific)",
+        description: "Position adjustment for how marks share coordinate space. Omit to use the geom default. Only values listed in allowedPositions validate.",
+    },
+    {
+        name: "positionParams",
+        typeSummary: "PositionParams",
+        description: "Parameters for jitter (width, height, seed) or nudge (x, y). Valid only when the layer allows those positions.",
+    },
+    {
+        name: "render",
+        typeSummary: '"svg" | "canvas" | "auto"',
+        description: "Optional per-layer render backend override. When omitted, the plot chooses.",
+    },
+    {
+        name: "inspect",
+        typeSummary: "false",
+        description: "Set false to exclude this layer from inspection: its marks never become tooltip, hover, or keyboard-traversal candidates. For decorative layers whose marks would otherwise capture the pointer.",
+    },
+]);
+// ---------------------------------------------------------------------------
+// Naming
+// ---------------------------------------------------------------------------
+/** snake_case geom → GeomPascalCase component name. */
+export function componentNameForGeom(geom) {
+    const pascal = geom
+        .split("_")
+        .map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+        .join("");
+    return `Geom${pascal}`;
+}
+/**
+ * Complete per-geom API reference derived from SpecDeclarations at gen time.
+ * Keys are exactly KNOWN_GEOMS; a missing geom is a generate-time throw.
+ */
+export const GEOM_REFERENCE = GEOM_REFERENCE_DATA;
+/** Stable list order matching KNOWN_GEOMS (docs index, search, inventory). */
+export function geomReferenceList() {
+    return KNOWN_GEOMS.map((geom) => GEOM_REFERENCE[geom]);
+}
+//# sourceMappingURL=geom-reference.js.map

package/dist/geom-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"geom-reference.js","sourceRoot":"","sources":["../src/geom-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,WAAW,GAKZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAwCzE,8EAA8E;AAC9E,+DAA+D;AAC/D,8EAA8E;AAE9E,iFAAiF;AACjF,MAAM,CAAC,MAAM,kBAAkB,GAAkC,MAAM,CAAC,MAAM,CAAC;IAC7E;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,gDAAgD;QAC7D,WAAW,EACT,+HAA+H;KAClI;IACD;QACE,IAAI,EAAE,KAAK;QACX,WAAW,EAAE,KAAK;QAClB,WAAW,EACT,6HAA6H;KAChI;IACD;QACE,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,0BAA0B;QACvC,WAAW,EACT,4IAA4I;KAC/I;IACD;QACE,IAAI,EAAE,UAAU;QAChB,WAAW,EAAE,8BAA8B;QAC3C,WAAW,EACT,0IAA0I;KAC7I;IACD;QACE,IAAI,EAAE,gBAAgB;QACtB,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EACT,gHAAgH;KACnH;IACD;QACE,IAAI,EAAE,QAAQ;QACd,WAAW,EAAE,2BAA2B;QACxC,WAAW,EAAE,6EAA6E;KAC3F;IACD;QACE,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,OAAO;QACpB,WAAW,EACT,kMAAkM;KACrM;CACF,CAAC,CAAC;AAEH,8EAA8E;AAC9E,SAAS;AACT,8EAA8E;AAE9E,uDAAuD;AACvD,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,MAAM,GAAG,IAAI;SAChB,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC3D,IAAI,CAAC,EAAE,CAAC,CAAC;IACZ,OAAO,OAAO,MAAM,EAAE,CAAC;AACzB,CAAC;AAED;;;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/guide-helpers.d.ts

@@ -0,0 +1,20 @@
+import type { AxisGuideSpec, ColorbarGuideSpec, ColorstepsGuideSpec, GuidesSpec, LegendGuideSpec, NoneGuideSpec } from "./schema.js";
+export type AxisGuideOptions = Omit<AxisGuideSpec, "type">;
+export type LegendGuideOptions = Omit<LegendGuideSpec, "type">;
+export type ColorbarGuideOptions = Omit<ColorbarGuideSpec, "type">;
+export type ColorstepsGuideOptions = Omit<ColorstepsGuideSpec, "type">;
+export declare function guideAxis(options?: AxisGuideOptions): AxisGuideSpec;
+export declare function guideLegend(options?: LegendGuideOptions): LegendGuideSpec;
+export declare function guideColorbar(options?: ColorbarGuideOptions): ColorbarGuideSpec;
+export declare function guideColorsteps(options?: ColorstepsGuideOptions): ColorstepsGuideSpec;
+export declare function guideNone(): NoneGuideSpec;
+/** Portable top-level guide fragment, mirroring scale helper fragments. */
+export declare function guides(value: GuidesSpec): {
+    guides: GuidesSpec;
+};
+export declare const guide_axis: typeof guideAxis;
+export declare const guide_legend: typeof guideLegend;
+export declare const guide_colorbar: typeof guideColorbar;
+export declare const guide_colorsteps: typeof guideColorsteps;
+export declare const guide_none: typeof guideNone;
+//# sourceMappingURL=guide-helpers.d.ts.map

package/dist/guide-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-helpers.d.ts","sourceRoot":"","sources":["../src/guide-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,aAAa,EACb,iBAAiB,EACjB,mBAAmB,EACnB,UAAU,EACV,eAAe,EACf,aAAa,EACd,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,gBAAgB,GAAG,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;AAC/D,MAAM,MAAM,oBAAoB,GAAG,IAAI,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;AACnE,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAEvE,wBAAgB,SAAS,CAAC,OAAO,GAAE,gBAAqB,GAAG,aAAa,CAEvE;AAED,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,eAAe,CAE7E;AAED,wBAAgB,aAAa,CAAC,OAAO,GAAE,oBAAyB,GAAG,iBAAiB,CAEnF;AAED,wBAAgB,eAAe,CAAC,OAAO,GAAE,sBAA2B,GAAG,mBAAmB,CAEzF;AAED,wBAAgB,SAAS,IAAI,aAAa,CAEzC;AAED,2EAA2E;AAC3E,wBAAgB,MAAM,CAAC,KAAK,EAAE,UAAU,GAAG;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,CAEhE;AAED,eAAO,MAAM,UAAU,kBAAY,CAAC;AACpC,eAAO,MAAM,YAAY,oBAAc,CAAC;AACxC,eAAO,MAAM,cAAc,sBAAgB,CAAC;AAC5C,eAAO,MAAM,gBAAgB,wBAAkB,CAAC;AAChD,eAAO,MAAM,UAAU,kBAAY,CAAC"}

package/dist/guide-helpers.js

@@ -0,0 +1,25 @@
+export function guideAxis(options = {}) {
+    return { type: "axis", ...options };
+}
+export function guideLegend(options = {}) {
+    return { type: "legend", ...options };
+}
+export function guideColorbar(options = {}) {
+    return { type: "colorbar", ...options };
+}
+export function guideColorsteps(options = {}) {
+    return { type: "colorsteps", ...options };
+}
+export function guideNone() {
+    return { type: "none" };
+}
+/** Portable top-level guide fragment, mirroring scale helper fragments. */
+export function guides(value) {
+    return { guides: { ...value } };
+}
+export const guide_axis = guideAxis;
+export const guide_legend = guideLegend;
+export const guide_colorbar = guideColorbar;
+export const guide_colorsteps = guideColorsteps;
+export const guide_none = guideNone;
+//# sourceMappingURL=guide-helpers.js.map

package/dist/guide-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-helpers.js","sourceRoot":"","sources":["../src/guide-helpers.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,SAAS,CAAC,UAA4B,EAAE;IACtD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,EAAE,CAAC;AACtC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE;IAC1D,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,OAAO,EAAE,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,UAAgC,EAAE;IAC9D,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,eAAe,CAAC,UAAkC,EAAE;IAClE,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,OAAO,EAAE,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC1B,CAAC;AAED,2EAA2E;AAC3E,MAAM,UAAU,MAAM,CAAC,KAAiB;IACtC,OAAO,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,CAAC,MAAM,YAAY,GAAG,WAAW,CAAC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,aAAa,CAAC;AAC5C,MAAM,CAAC,MAAM,gBAAgB,GAAG,eAAe,CAAC;AAChD,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC"}

package/dist/guide-reference-build.d.ts

@@ -0,0 +1,42 @@
+/** Portable guide type literals (GuideSpec discriminators). */
+export declare const KNOWN_GUIDE_TYPES: readonly ["legend", "colorbar", "colorsteps", "axis", "none"];
+export type GuideTypeName = (typeof KNOWN_GUIDE_TYPES)[number];
+/** Every aesthetic a guide can be keyed by (GuidesSpec keys). */
+export declare const GUIDE_CHANNELS: readonly ["x", "y", "color", "fill", "size", "linewidth", "alpha", "shape", "linetype"];
+export type GuideChannelName = (typeof GUIDE_CHANNELS)[number];
+export interface GuideParamDoc {
+    readonly name: string;
+    readonly description: string;
+    readonly typeSummary: string;
+    readonly required: boolean;
+}
+export interface GuideReferenceEntry {
+    readonly name: GuideTypeName;
+    /** Route slug — same as the portable type literal. */
+    readonly slug: string;
+    /** Svelte component export, e.g. GuideLegend. */
+    readonly component: string;
+    /** Portable `type` discriminant (same as name). */
+    readonly typeLiteral: GuideTypeName;
+    /** SpecDeclarations key for the guide options object. */
+    readonly schemaType: string;
+    /** Fluent helper, e.g. guideLegend. */
+    readonly helper: string;
+    /** ggplot2-style snake_case alias, e.g. guide_legend. */
+    readonly helperAlias: string;
+    /** Short purpose text for the guide variant. */
+    readonly summary: string;
+    /**
+     * Aesthetics this guide type may key. Subset of GUIDE_CHANNELS; scale family
+     * constraints (sequential → colorbar, binned → colorsteps) are prose on the
+     * page, not a separate field.
+     */
+    readonly channels: readonly GuideChannelName[];
+    /**
+     * Options on the Svelte shell / JSON guide object, excluding the fixed
+     * `type` discriminant. The shell also takes `channel` (not part of *GuideSpec).
+     */
+    readonly params: readonly GuideParamDoc[];
+}
+export declare function buildGuideReference(): Readonly<Record<GuideTypeName, GuideReferenceEntry>>;
+//# sourceMappingURL=guide-reference-build.d.ts.map

package/dist/guide-reference-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-reference-build.d.ts","sourceRoot":"","sources":["../src/guide-reference-build.ts"],"names":[],"mappings":"AAUA,+DAA+D;AAC/D,eAAO,MAAM,iBAAiB,+DAAgE,CAAC;AAE/F,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,iEAAiE;AACjE,eAAO,MAAM,cAAc,yFAUjB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,uCAAuC;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gDAAgD;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAC;IAC/C;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAC3C;AAkLD,wBAAgB,mBAAmB,IAAI,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAAC,CAM1F"}