@ggts-sh/spec 0.43.0

package/dist/guide-reference-build.js

@@ -0,0 +1,180 @@
+/**
+ * GUIDE_REFERENCE builder. Gen-only: `scripts/gen-reference-catalogs.ts`.
+ * Runtime uses generated/guide-reference-data.ts.
+ */
+import { SpecDeclarations } from "./schema-declarations.js";
+// ---------------------------------------------------------------------------
+// Public types
+// ---------------------------------------------------------------------------
+/** Portable guide type literals (GuideSpec discriminators). */
+export const KNOWN_GUIDE_TYPES = ["legend", "colorbar", "colorsteps", "axis", "none"];
+/** Every aesthetic a guide can be keyed by (GuidesSpec keys). */
+export const GUIDE_CHANNELS = [
+    "x",
+    "y",
+    "color",
+    "fill",
+    "size",
+    "linewidth",
+    "alpha",
+    "shape",
+    "linetype",
+];
+// ---------------------------------------------------------------------------
+// Static catalog metadata
+// ---------------------------------------------------------------------------
+const GUIDE_SUMMARIES = Object.freeze({
+    legend: "Discrete legend for one non-position aesthetic: title, placement rank, position, direction, key size, and collision. Default guide for categorical color, fill, size, shape, and other style channels.",
+    colorbar: "Continuous color ramp for sequential color or fill scales. Shows ticks and labels along a vertical or horizontal bar; incompatible with discrete legends and binned colorsteps.",
+    colorsteps: "Binned color legend for binned color or fill scales. Step blocks with optional labels; use instead of legend or colorbar when the scale type is binned.",
+    axis: "Axis guide for positional aesthetics x and y: title, tick marks, labels, and collision. Not valid on color, fill, or other style channels.",
+    none: "Suppress the guide for one aesthetic entirely. Valid on every channel; useful to hide size or shape legends while keeping the mapping.",
+});
+const GUIDE_COMPONENTS = Object.freeze({
+    legend: "GuideLegend",
+    colorbar: "GuideColorbar",
+    colorsteps: "GuideColorsteps",
+    axis: "GuideAxis",
+    none: "GuideNone",
+});
+const GUIDE_SCHEMA_TYPES = Object.freeze({
+    legend: "LegendGuideSpec",
+    colorbar: "ColorbarGuideSpec",
+    colorsteps: "ColorstepsGuideSpec",
+    axis: "AxisGuideSpec",
+    none: "NoneGuideSpec",
+});
+const GUIDE_HELPERS = Object.freeze({
+    legend: { camel: "guideLegend", snake: "guide_legend" },
+    colorbar: { camel: "guideColorbar", snake: "guide_colorbar" },
+    colorsteps: { camel: "guideColorsteps", snake: "guide_colorsteps" },
+    axis: { camel: "guideAxis", snake: "guide_axis" },
+    none: { camel: "guideNone", snake: "guide_none" },
+});
+/** Aesthetic keys each guide type may bind (matches guideStructuralErrors). */
+const GUIDE_CHANNELS_FOR_TYPE = Object.freeze({
+    axis: ["x", "y"],
+    legend: ["color", "fill", "size", "linewidth", "alpha", "shape", "linetype"],
+    colorbar: ["color", "fill"],
+    colorsteps: ["color", "fill"],
+    none: [...GUIDE_CHANNELS],
+});
+/**
+ * Schema props often omit descriptions. Prefer SpecDeclarations text when
+ * present; fall back to these authoring notes so every param has prose.
+ */
+const PARAM_DESCRIPTION_FALLBACKS = Object.freeze({
+    title: "Optional guide title string (max 256 characters). Omit to use the scale or labs title.",
+    order: "Integer placement rank among sibling guides (−1024…1024). Lower values sort earlier. Not the plot-wide Legend entry-sort enum.",
+    position: 'Guide placement relative to the panel: "auto", "right", or "bottom". Auto picks a side from available space.',
+    direction: 'Layout of keys or the color ramp: "auto", "vertical", or "horizontal". Bottom placement usually forces horizontal.',
+    keySize: "Legend key glyph size in pixels (4…48).",
+    collision: "How long labels behave when they do not fit: ellipsis, wrap (legend only), preserve (axis), auto (axis), or error.",
+    force: "When true, keep this guide even if the scale would normally suppress it (for example a single-level discrete scale).",
+    showTicks: "When false, hide tick marks on the axis or colorbar.",
+    showLabels: "When false, hide tick or step labels on the axis, colorbar, or colorsteps guide.",
+    theme: "Bounded presentation overrides for this guide block (title/label size, gaps, colorbar size).",
+});
+// ---------------------------------------------------------------------------
+// Schema walkers
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function refName(node) {
+    const ref = node["$ref"];
+    return typeof ref === "string" ? ref : undefined;
+}
+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));
+        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 type === "integer" ? "integer" : "number";
+    if (type === "string")
+        return "string";
+    if (type === "boolean")
+        return "boolean";
+    if (type === "object")
+        return "object";
+    if (Array.isArray(type)) {
+        return type.filter((t) => t !== "null").join(" | ") || "unknown";
+    }
+    return "unknown";
+}
+function descriptionOf(node, name) {
+    if (isRecord(node) &&
+        typeof node["description"] === "string" &&
+        node["description"].trim() !== "") {
+        return node["description"];
+    }
+    return PARAM_DESCRIPTION_FALLBACKS[name] ?? "";
+}
+function guideParamsDocs(schemaType) {
+    if (!(schemaType in SpecDeclarations)) {
+        throw new Error(`GUIDE_REFERENCE: SpecDeclarations has no entry "${schemaType}"`);
+    }
+    const schema = SpecDeclarations[schemaType];
+    const props = schema.properties;
+    if (props === undefined) {
+        // NoneGuideSpec is `{ type: "none" }` only — no option props.
+        return Object.freeze([]);
+    }
+    const required = new Set(schema.required ?? []);
+    const docs = [];
+    for (const [name, propSchema] of Object.entries(props)) {
+        if (name === "type")
+            continue; // discriminant is fixed by the shell / helper
+        const description = descriptionOf(propSchema, name);
+        if (description.trim() === "") {
+            throw new Error(`GUIDE_REFERENCE: ${schemaType}.${name} has no schema description and no fallback`);
+        }
+        docs.push({
+            name,
+            description,
+            typeSummary: typeSummaryOf(propSchema),
+            required: required.has(name),
+        });
+    }
+    return Object.freeze(docs);
+}
+// ---------------------------------------------------------------------------
+// Build
+// ---------------------------------------------------------------------------
+function buildEntry(name) {
+    const helpers = GUIDE_HELPERS[name];
+    return Object.freeze({
+        name,
+        slug: name,
+        component: GUIDE_COMPONENTS[name],
+        typeLiteral: name,
+        schemaType: GUIDE_SCHEMA_TYPES[name],
+        helper: helpers.camel,
+        helperAlias: helpers.snake,
+        summary: GUIDE_SUMMARIES[name],
+        channels: GUIDE_CHANNELS_FOR_TYPE[name],
+        params: guideParamsDocs(GUIDE_SCHEMA_TYPES[name]),
+    });
+}
+export function buildGuideReference() {
+    const out = {};
+    for (const name of KNOWN_GUIDE_TYPES) {
+        out[name] = buildEntry(name);
+    }
+    return Object.freeze(out);
+}
+//# sourceMappingURL=guide-reference-build.js.map

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

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

package/dist/guide-reference.d.ts

@@ -0,0 +1,48 @@
+/** 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[];
+}
+/**
+ * Complete per-guide API reference. Keys are exactly KNOWN_GUIDE_TYPES.
+ * Precomputed at gen time.
+ */
+export declare const GUIDE_REFERENCE: Readonly<Record<GuideTypeName, GuideReferenceEntry>>;
+/** Stable list order matching KNOWN_GUIDE_TYPES (docs index, search, inventory). */
+export declare function guideReferenceList(): readonly GuideReferenceEntry[];
+//# sourceMappingURL=guide-reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"guide-reference.d.ts","sourceRoot":"","sources":["../src/guide-reference.ts"],"names":[],"mappings":"AASA,+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;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAC3D,CAAC;AAEvB,oFAAoF;AACpF,wBAAgB,kBAAkB,IAAI,SAAS,mBAAmB,EAAE,CAEnE"}

package/dist/guide-reference.js

@@ -0,0 +1,32 @@
+/**
+ * GUIDE_REFERENCE — per-guide API docs for the docs site.
+ *
+ * Catalog data is precomputed from SpecDeclarations
+ * (`scripts/gen-reference-catalogs.ts`) so reference pages never load TypeBox.
+ * Guides are declaration-only Svelte shells keyed by aesthetic channel.
+ */
+import { GUIDE_REFERENCE_DATA } from "./generated/guide-reference-data.js";
+/** Portable guide type literals (GuideSpec discriminators). */
+export const KNOWN_GUIDE_TYPES = ["legend", "colorbar", "colorsteps", "axis", "none"];
+/** Every aesthetic a guide can be keyed by (GuidesSpec keys). */
+export const GUIDE_CHANNELS = [
+    "x",
+    "y",
+    "color",
+    "fill",
+    "size",
+    "linewidth",
+    "alpha",
+    "shape",
+    "linetype",
+];
+/**
+ * Complete per-guide API reference. Keys are exactly KNOWN_GUIDE_TYPES.
+ * Precomputed at gen time.
+ */
+export const GUIDE_REFERENCE = GUIDE_REFERENCE_DATA;
+/** Stable list order matching KNOWN_GUIDE_TYPES (docs index, search, inventory). */
+export function guideReferenceList() {
+    return KNOWN_GUIDE_TYPES.map((name) => GUIDE_REFERENCE[name]);
+}
+//# sourceMappingURL=guide-reference.js.map

package/dist/guide-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"guide-reference.js","sourceRoot":"","sources":["../src/guide-reference.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,+DAA+D;AAC/D,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,CAAU,CAAC;AAI/F,iEAAiE;AACjE,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,GAAG;IACH,GAAG;IACH,OAAO;IACP,MAAM;IACN,MAAM;IACN,WAAW;IACX,OAAO;IACP,OAAO;IACP,UAAU;CACF,CAAC;AAwCX;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,oBAAoB,CAAC;AAEvB,oFAAoF;AACpF,MAAM,UAAU,kBAAkB;IAChC,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/hue-grey-palettes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Hue / grey discrete palettes for scale_*_hue and scale_*_grey (#829).
+ * Clean-room HSL greys and even-hue stops (not ggplot2 R source).
+ */
+/** HSL → #rrggbb (s,l in 0–1; h in degrees). */
+export declare function hslToHex(h: number, s: number, l: number): string;
+/** n even hues over [h0, h1); c/l are ggplot2-like 0–100 scales. */
+export declare function buildHuePalette(n: number, h?: readonly [number, number], c?: number, l?: number): string[];
+/** n greys from start→end in [0, 1]. */
+export declare function buildGreyPalette(n: number, start?: number, end?: number): string[];
+/** Default 10-stop hue scheme (matches scale_*_hue with no overrides). */
+export declare const HUE_PALETTE_10: readonly string[];
+/** Default 10-stop grey scheme (start 0.2, end 0.8). */
+export declare const GREY_PALETTE_10: readonly string[];
+//# sourceMappingURL=hue-grey-palettes.d.ts.map

package/dist/hue-grey-palettes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hue-grey-palettes.d.ts","sourceRoot":"","sources":["../src/hue-grey-palettes.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,gDAAgD;AAChD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAgChE;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAC7B,CAAC,EAAE,MAAM,EACT,CAAC,GAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAa,EACxC,CAAC,SAAM,EACP,CAAC,SAAK,GACL,MAAM,EAAE,CAYV;AAED,wCAAwC;AACxC,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,SAAM,EAAE,GAAG,SAAM,GAAG,MAAM,EAAE,CAc5E;AAED,0EAA0E;AAC1E,eAAO,MAAM,cAAc,EAAE,SAAS,MAAM,EAAuC,CAAC;AAEpF,wDAAwD;AACxD,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAAwC,CAAC"}

package/dist/hue-grey-palettes.js

@@ -0,0 +1,77 @@
+/**
+ * Hue / grey discrete palettes for scale_*_hue and scale_*_grey (#829).
+ * Clean-room HSL greys and even-hue stops (not ggplot2 R source).
+ */
+/** HSL → #rrggbb (s,l in 0–1; h in degrees). */
+export function hslToHex(h, s, l) {
+    const hh = ((h % 360) + 360) % 360;
+    const c = (1 - Math.abs(2 * l - 1)) * s;
+    const x = c * (1 - Math.abs(((hh / 60) % 2) - 1));
+    const m = l - c / 2;
+    let r = 0;
+    let g = 0;
+    let b = 0;
+    if (hh < 60) {
+        r = c;
+        g = x;
+    }
+    else if (hh < 120) {
+        r = x;
+        g = c;
+    }
+    else if (hh < 180) {
+        g = c;
+        b = x;
+    }
+    else if (hh < 240) {
+        g = x;
+        b = c;
+    }
+    else if (hh < 300) {
+        r = x;
+        b = c;
+    }
+    else {
+        r = c;
+        b = x;
+    }
+    const to2 = (n) => Math.round((n + m) * 255)
+        .toString(16)
+        .padStart(2, "0");
+    return `#${to2(r)}${to2(g)}${to2(b)}`;
+}
+/** n even hues over [h0, h1); c/l are ggplot2-like 0–100 scales. */
+export function buildHuePalette(n, h = [15, 375], c = 100, l = 65) {
+    const count = Math.max(1, Math.floor(n));
+    const s = Math.min(1, Math.max(0, c / 100));
+    const light = Math.min(1, Math.max(0, l / 100));
+    const [h0, h1] = h;
+    const span = h1 - h0;
+    const out = [];
+    for (let i = 0; i < count; i++) {
+        const t = count === 1 ? 0 : i / count;
+        out.push(hslToHex(h0 + span * t, s, light));
+    }
+    return out;
+}
+/** n greys from start→end in [0, 1]. */
+export function buildGreyPalette(n, start = 0.2, end = 0.8) {
+    const count = Math.max(1, Math.floor(n));
+    const s0 = Math.min(1, Math.max(0, start));
+    const s1 = Math.min(1, Math.max(0, end));
+    const out = [];
+    for (let i = 0; i < count; i++) {
+        const t = count === 1 ? 0 : i / (count - 1);
+        const g = s0 + (s1 - s0) * t;
+        const ch = Math.round(g * 255)
+            .toString(16)
+            .padStart(2, "0");
+        out.push(`#${ch}${ch}${ch}`);
+    }
+    return out;
+}
+/** Default 10-stop hue scheme (matches scale_*_hue with no overrides). */
+export const HUE_PALETTE_10 = Object.freeze(buildHuePalette(10));
+/** Default 10-stop grey scheme (start 0.2, end 0.8). */
+export const GREY_PALETTE_10 = Object.freeze(buildGreyPalette(10));
+//# sourceMappingURL=hue-grey-palettes.js.map

package/dist/hue-grey-palettes.js.map

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