@ggts-sh/spec 0.43.0

package/dist/scale-reference-classify-style.js

@@ -0,0 +1,194 @@
+/**
+ * Style-family classification for the SCALE_REFERENCE builder (gen-only):
+ * numeric style channels (size/linewidth/alpha) and finite style channels
+ * (shape/linetype).
+ */
+import { aestheticFromHelper, guideFor, paramDocsFromSchema, styleSchemaFor, sugarParam, withValues, } from "./scale-reference-classify-support.js";
+// ---------------------------------------------------------------------------
+// Param key sets per options family (mirrors helper option Pick/Omit types)
+// ---------------------------------------------------------------------------
+const STYLE_SEQUENTIAL_KEYS = [
+    "domain",
+    "breaks",
+    "range",
+    "reverse",
+    "oob",
+    "naValue",
+    "unknownValue",
+    "labels",
+    "guide",
+];
+const STYLE_DISCRETE_KEYS = [
+    "domain",
+    "domainMode",
+    "range",
+    "reverse",
+    "naValue",
+    "unknownValue",
+    "onExhaust",
+    "guide",
+];
+const STYLE_MANUAL_KEYS = ["domain", "naValue", "unknownValue", "guide"];
+const STYLE_IDENTITY_KEYS = ["naValue", "unknownValue", "guide"];
+const FINITE_DISCRETE_KEYS = [
+    "domain",
+    "domainMode",
+    "range",
+    "reverse",
+    "naValue",
+    "unknownValue",
+    "onExhaust",
+    "guide",
+];
+const FINITE_BINNED_KEYS = [
+    "domain",
+    "breaks",
+    "range",
+    "reverse",
+    "naValue",
+    "unknownValue",
+    "labels",
+    "guide",
+];
+export function classifyStyleHelper(helper, family) {
+    return family === "numeric-style"
+        ? classifyNumericStyleHelper(helper)
+        : classifyFiniteStyleHelper(helper);
+}
+function classifyNumericStyleHelper(helper) {
+    const aes = aestheticFromHelper(helper);
+    const decl = styleSchemaFor(aes);
+    if (helper === "scaleSizeArea" || helper === "scaleSizeBinnedArea") {
+        const binned = helper.includes("Binned");
+        return {
+            optionsType: "SizeAreaScaleOptions",
+            scaleType: binned ? "binned" : "sequential",
+            params: [
+                ...paramDocsFromSchema(decl, STYLE_SEQUENTIAL_KEYS),
+                sugarParam("maxSize", "number", "Maximum area-mapped size (ggplot2 scale_size_area max_size)."),
+            ],
+            guide: guideFor(aes, binned ? "binned" : "sequential"),
+            summary: binned
+                ? "Binned size scale with area mapping (zero maps to zero area)."
+                : "Continuous size scale with area mapping (zero maps to zero area).",
+        };
+    }
+    if (helper === "scaleRadius") {
+        return {
+            optionsType: "SequentialStyleScaleOptions",
+            scaleType: "sequential",
+            params: paramDocsFromSchema(decl, STYLE_SEQUENTIAL_KEYS),
+            guide: guideFor("size", "sequential"),
+            summary: "Continuous size scale with radius (linear) mapping instead of area.",
+        };
+    }
+    if (helper.includes("Discrete") || helper.includes("Ordinal")) {
+        return {
+            optionsType: "DiscreteNumericStyleScaleOptions",
+            scaleType: "ordinal",
+            params: paramDocsFromSchema(decl, STYLE_DISCRETE_KEYS),
+            guide: guideFor(aes, "ordinal"),
+            summary: `Discrete ${aes} scale for categories (ordinal).`,
+        };
+    }
+    if (helper.includes("Manual")) {
+        return {
+            optionsType: "ManualNumericStyleScaleOptions",
+            scaleType: "manual",
+            params: withValues(paramDocsFromSchema(decl, STYLE_MANUAL_KEYS), "number[]", "Numeric range values paired with domain (required)."),
+            guide: guideFor(aes, "manual"),
+            summary: `Manual ${aes} mapping: domain values paired with explicit numbers.`,
+        };
+    }
+    if (helper.includes("Identity")) {
+        return {
+            optionsType: "IdentityNumericStyleScaleOptions",
+            scaleType: "identity",
+            params: paramDocsFromSchema(decl, STYLE_IDENTITY_KEYS),
+            guide: guideFor(aes, "identity"),
+            summary: `Identity ${aes} scale: source numbers used as mapped style values.`,
+        };
+    }
+    if (helper.includes("Datetime")) {
+        return {
+            optionsType: "TemporalNumericStyleScaleOptions",
+            scaleType: "sequential",
+            temporalKind: "datetime",
+            params: paramDocsFromSchema(decl, STYLE_SEQUENTIAL_KEYS),
+            guide: guideFor(aes, "sequential"),
+            summary: `Sequential ${aes} scale trained on datetime values.`,
+        };
+    }
+    if (helper.includes("Date")) {
+        return {
+            optionsType: "TemporalNumericStyleScaleOptions",
+            scaleType: "sequential",
+            temporalKind: "date",
+            params: paramDocsFromSchema(decl, STYLE_SEQUENTIAL_KEYS),
+            guide: guideFor(aes, "sequential"),
+            summary: `Sequential ${aes} scale trained on calendar dates.`,
+        };
+    }
+    if (helper.includes("Binned")) {
+        return {
+            optionsType: "SequentialStyleScaleOptions",
+            scaleType: "binned",
+            params: paramDocsFromSchema(decl, STYLE_SEQUENTIAL_KEYS),
+            guide: guideFor(aes, "binned"),
+            summary: `Binned ${aes} scale: continuous values → stepped numeric style.`,
+        };
+    }
+    if (helper.includes("Continuous")) {
+        return {
+            optionsType: "SequentialStyleScaleOptions",
+            scaleType: "sequential",
+            params: paramDocsFromSchema(decl, STYLE_SEQUENTIAL_KEYS),
+            guide: guideFor(aes, "sequential"),
+            summary: `Continuous sequential ${aes} scale.`,
+        };
+    }
+    throw new Error(`SCALE_REFERENCE: unhandled numeric-style helper "${helper}"`);
+}
+function classifyFiniteStyleHelper(helper) {
+    const aes = aestheticFromHelper(helper);
+    const decl = styleSchemaFor(aes);
+    const output = aes === "shape" ? "PointShapeName" : aes === "linetype" ? "LinetypeName" : "string";
+    if (helper.includes("Discrete") || helper.includes("Ordinal")) {
+        return {
+            optionsType: `DiscreteFiniteStyleScaleOptions<${output}>`,
+            scaleType: "ordinal",
+            params: paramDocsFromSchema(decl, FINITE_DISCRETE_KEYS),
+            guide: guideFor(aes, "ordinal"),
+            summary: `Discrete ${aes} scale for categories (named symbols).`,
+        };
+    }
+    if (helper.includes("Binned")) {
+        return {
+            optionsType: `BinnedFiniteStyleScaleOptions<${output}>`,
+            scaleType: "binned",
+            params: paramDocsFromSchema(decl, FINITE_BINNED_KEYS),
+            guide: guideFor(aes, "binned"),
+            summary: `Binned ${aes} scale: continuous values → finite named symbols.`,
+        };
+    }
+    if (helper.includes("Manual")) {
+        return {
+            optionsType: `ManualFiniteStyleScaleOptions<${output}>`,
+            scaleType: "manual",
+            params: withValues(paramDocsFromSchema(decl, STYLE_MANUAL_KEYS), `${output}[]`, "Named symbols paired with domain (required)."),
+            guide: guideFor(aes, "manual"),
+            summary: `Manual ${aes} mapping: domain values paired with named symbols.`,
+        };
+    }
+    if (helper.includes("Identity")) {
+        return {
+            optionsType: `IdentityFiniteStyleScaleOptions<${output}>`,
+            scaleType: "identity",
+            params: paramDocsFromSchema(decl, STYLE_IDENTITY_KEYS),
+            guide: guideFor(aes, "identity"),
+            summary: `Identity ${aes} scale: source names used as mapped symbols.`,
+        };
+    }
+    throw new Error(`SCALE_REFERENCE: unhandled finite-style helper "${helper}"`);
+}
+//# sourceMappingURL=scale-reference-classify-style.js.map

package/dist/scale-reference-classify-style.js.map

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

package/dist/scale-reference-classify-support.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Shared classification machinery for the SCALE_REFERENCE builder (gen-only):
+ * public scale types, schema walkers, param-doc sugar, and per-helper
+ * lookups. Family classifiers live in scale-reference-classify-*.ts.
+ */
+import type { ScaleCapability } from "./capabilities.js";
+import { SpecDeclarations } from "./schema-declarations.js";
+export interface ScaleParamDoc {
+    readonly name: string;
+    readonly description: string;
+    readonly typeSummary: string;
+    readonly required: boolean;
+}
+export type ScaleFamily = ScaleCapability["family"];
+/** Canonical aesthetic channel(s) this Scale* component configures. */
+export type ScaleAesthetic = "x" | "y" | "color" | "fill" | "size" | "linewidth" | "alpha" | "shape" | "linetype";
+export declare function paramDocsFromSchema(declName: keyof typeof SpecDeclarations, keys: readonly string[]): ScaleParamDoc[];
+export declare function sugarParam(name: string, typeSummary: string, description: string, required?: boolean): ScaleParamDoc;
+export interface HelperMeta {
+    optionsType: string;
+    scaleType: string;
+    transform?: "log10" | "sqrt";
+    temporalKind?: string;
+    params: readonly ScaleParamDoc[];
+    guide: string;
+    summary: string;
+}
+export declare function aestheticFromHelper(helper: string): ScaleAesthetic;
+export declare function styleSchemaFor(aes: ScaleAesthetic): keyof typeof SpecDeclarations;
+export declare function guideFor(aes: ScaleAesthetic, scaleType: string): string;
+export declare function withLimits(base: ScaleParamDoc[]): ScaleParamDoc[];
+export declare function withValues(base: ScaleParamDoc[], typeSummary: string, description: string): ScaleParamDoc[];
+export declare function withPaletteDirection(base: ScaleParamDoc[]): ScaleParamDoc[];
+export declare function withGradientStops(base: ScaleParamDoc[], kind: "2" | "n" | "steps" | "steps2" | "stepsn"): ScaleParamDoc[];
+export declare function withViridisOption(base: ScaleParamDoc[]): ScaleParamDoc[];
+export declare function withHueGrey(base: ScaleParamDoc[], kind: "hue" | "grey"): ScaleParamDoc[];
+//# sourceMappingURL=scale-reference-classify-support.d.ts.map

package/dist/scale-reference-classify-support.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scale-reference-classify-support.d.ts","sourceRoot":"","sources":["../src/scale-reference-classify-support.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAM5D,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,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAEpD,uEAAuE;AACvE,MAAM,MAAM,cAAc,GACtB,GAAG,GACH,GAAG,GACH,OAAO,GACP,MAAM,GACN,MAAM,GACN,WAAW,GACX,OAAO,GACP,OAAO,GACP,UAAU,CAAC;AAoFf,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,OAAO,gBAAgB,EACvC,IAAI,EAAE,SAAS,MAAM,EAAE,GACtB,aAAa,EAAE,CAqBjB;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,QAAQ,UAAQ,GACf,aAAa,CAEf;AAMD,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAWlE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,cAAc,GAAG,MAAM,OAAO,gBAAgB,CAMjF;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAcvE;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CASjE;AAED,wBAAgB,UAAU,CACxB,IAAI,EAAE,aAAa,EAAE,EACrB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,GAClB,aAAa,EAAE,CAEjB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CAU3E;AAED,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,aAAa,EAAE,EACrB,IAAI,EAAE,GAAG,GAAG,GAAG,GAAG,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAC9C,aAAa,EAAE,CAkCjB;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,aAAa,EAAE,CASxE;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,aAAa,EAAE,EAAE,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG,aAAa,EAAE,CAexF"}

package/dist/scale-reference-classify-support.js

@@ -0,0 +1,206 @@
+import { SpecDeclarations } from "./schema-declarations.js";
+// ---------------------------------------------------------------------------
+// Schema walkers (param docs)
+// ---------------------------------------------------------------------------
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+function descriptionOf(node) {
+    if (!isRecord(node))
+        return "";
+    const d = node["description"];
+    return typeof d === "string" ? d : "";
+}
+function typeSummaryOf(node, depth = 0) {
+    if (!isRecord(node) || depth > 8)
+        return "unknown";
+    const ref = node["$ref"];
+    if (typeof ref === "string")
+        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 === "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 propertiesOf(declName) {
+    const schema = SpecDeclarations[declName];
+    if (!isRecord(schema)) {
+        throw new Error(`SCALE_REFERENCE: SpecDeclarations.${declName} is not an object`);
+    }
+    // Intersect schemas put properties on allOf[0].properties
+    const direct = schema["properties"];
+    if (isRecord(direct))
+        return direct;
+    const allOf = schema["allOf"];
+    if (Array.isArray(allOf)) {
+        for (const branch of allOf) {
+            if (isRecord(branch) && isRecord(branch["properties"])) {
+                return branch["properties"];
+            }
+        }
+    }
+    throw new Error(`SCALE_REFERENCE: SpecDeclarations.${declName} has no properties`);
+}
+/** Fallback prose when a schema node has no description (shared style fields). */
+const PARAM_DESCRIPTION_FALLBACKS = Object.freeze({
+    domain: "Explicit semantic domain. Continuous scales use [min, max]; ordinal uses ordered values.",
+    domainMode: 'Ordinal domain stability: "grow" (default) preserves assignments across filters; "data" rebuilds from current data.',
+    breaks: "Explicit reference ticks or bin boundaries in data units.",
+    range: "Explicit output range for the mapped aesthetic.",
+    reverse: "Reverse the scale's output direction. Default false.",
+    oob: 'Out-of-bounds policy for values outside an explicit domain: "censor" (default) or "squish".',
+    naValue: "Replacement for missing/null source values.",
+    unknownValue: "Replacement for invalid, out-of-domain, or unmapped values.",
+    onExhaust: 'Ordinal palette exhaustion policy: "cycle" (default) with a warning, or "error".',
+    labels: "Guide label format string (numeric or temporal).",
+    guide: "Guide presentation override (legend, colorbar, colorsteps, or none).",
+    transform: 'Pre-training quantitative transform: "identity" (default), "log10", or "sqrt".',
+    scheme: "Named color scheme (categorical or sequential family).",
+});
+export function paramDocsFromSchema(declName, keys) {
+    const props = propertiesOf(declName);
+    const docs = [];
+    for (const name of keys) {
+        const prop = props[name];
+        if (prop === undefined) {
+            throw new Error(`SCALE_REFERENCE: ${declName} missing property "${name}"`);
+        }
+        const fromSchema = descriptionOf(prop).trim();
+        const description = fromSchema === ""
+            ? (PARAM_DESCRIPTION_FALLBACKS[name] ?? `Authoring option \`${name}\` for this scale.`)
+            : fromSchema;
+        docs.push({
+            name,
+            description,
+            typeSummary: typeSummaryOf(prop),
+            required: false,
+        });
+    }
+    return docs;
+}
+export function sugarParam(name, typeSummary, description, required = false) {
+    return { name, typeSummary, description, required };
+}
+export function aestheticFromHelper(helper) {
+    if (helper.startsWith("scaleX"))
+        return "x";
+    if (helper.startsWith("scaleY"))
+        return "y";
+    if (helper.startsWith("scaleColor") || helper.startsWith("scaleColour"))
+        return "color";
+    if (helper.startsWith("scaleFill"))
+        return "fill";
+    if (helper.startsWith("scaleSize") || helper === "scaleRadius")
+        return "size";
+    if (helper.startsWith("scaleLinewidth"))
+        return "linewidth";
+    if (helper.startsWith("scaleAlpha"))
+        return "alpha";
+    if (helper.startsWith("scaleShape"))
+        return "shape";
+    if (helper.startsWith("scaleLinetype"))
+        return "linetype";
+    throw new Error(`SCALE_REFERENCE: cannot derive aesthetic from "${helper}"`);
+}
+export function styleSchemaFor(aes) {
+    if (aes === "alpha")
+        return "AlphaScaleSpec";
+    if (aes === "shape")
+        return "ShapeScaleSpec";
+    if (aes === "linetype")
+        return "LinetypeScaleSpec";
+    if (aes === "size" || aes === "linewidth")
+        return "PositiveStyleScaleSpec";
+    throw new Error(`SCALE_REFERENCE: no style schema for aesthetic ${aes}`);
+}
+export function guideFor(aes, scaleType) {
+    if (aes === "x" || aes === "y") {
+        return 'Axis guide on the position channel (band axis guide when type is band). Set guide to customize ticks/labels or guide: "none" to hide.';
+    }
+    if (aes === "color" || aes === "fill") {
+        if (scaleType === "sequential") {
+            return 'Colorbar guide by default for continuous ramps. Use guide helpers or guide: "none" to suppress.';
+        }
+        if (scaleType === "binned") {
+            return 'Colorsteps guide by default for binned color. Use guide helpers or guide: "none" to suppress.';
+        }
+        return 'Legend guide for discrete/manual/identity color. Set guide: "none" to hide.';
+    }
+    return 'Legend guide for the mapped style channel. Set guide: "none" to hide.';
+}
+export function withLimits(base) {
+    return [
+        sugarParam("limits", "DomainValue[]", "Pin the scale to [min, max] in source units (authoring sugar for domain). Supplying both limits and domain throws."),
+        ...base,
+    ];
+}
+export function withValues(base, typeSummary, description) {
+    return [...base, sugarParam("values", typeSummary, description, true)];
+}
+export function withPaletteDirection(base) {
+    return [
+        ...base,
+        sugarParam("palette", "string", "Named palette (ColorBrewer / distiller / fermenter family). Maps onto scheme."),
+        sugarParam("direction", "1 | -1", "Palette direction: 1 (default) or -1 (reverse)."),
+    ];
+}
+export function withGradientStops(base, kind) {
+    const extra = [];
+    if (kind === "2" || kind === "steps2") {
+        extra.push(sugarParam("low", "string", "Low-end #rgb/#rrggbb color."), sugarParam("mid", "string", "Midpoint #rgb/#rrggbb color."), sugarParam("high", "string", "High-end #rgb/#rrggbb color."), sugarParam("midpoint", "number", "Data value mapped to mid (default 0 for diverging helpers)."));
+    }
+    else if (kind === "n" || kind === "stepsn") {
+        extra.push(sugarParam("colours", "string[]", "Ordered #rgb/#rrggbb stops (British spelling alias of colors)."), sugarParam("colors", "string[]", "Ordered #rgb/#rrggbb stops."), sugarParam("values", "number[]", "Optional stop positions in [0, 1] (or data units for some helpers)."));
+    }
+    else {
+        extra.push(sugarParam("low", "string", "Low-end #rgb/#rrggbb color."), sugarParam("high", "string", "High-end #rgb/#rrggbb color."));
+    }
+    return [...base.filter((p) => p.name !== "scheme" && p.name !== "range"), ...extra];
+}
+export function withViridisOption(base) {
+    return [
+        sugarParam("option", '"viridis" | "magma" | "plasma" | "inferno" | "cividis" | "turbo"', "Viridis family option (default viridis)."),
+        ...base.filter((p) => p.name !== "scheme"),
+    ];
+}
+export function withHueGrey(base, kind) {
+    if (kind === "hue") {
+        return [
+            ...base.filter((p) => p.name !== "scheme" && p.name !== "range"),
+            sugarParam("h", "[number, number]", "Hue range in degrees (ggplot2 scale_colour_hue)."),
+            sugarParam("c", "number", "Chroma."),
+            sugarParam("l", "number", "Luminance."),
+            sugarParam("direction", "1 | -1", "Wheel direction."),
+        ];
+    }
+    return [
+        ...base.filter((p) => p.name !== "scheme" && p.name !== "range"),
+        sugarParam("start", "number", "Grey start (0–1)."),
+        sugarParam("end", "number", "Grey end (0–1)."),
+    ];
+}
+//# sourceMappingURL=scale-reference-classify-support.js.map

package/dist/scale-reference-classify-support.js.map

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

package/dist/scale-reference.d.ts

@@ -0,0 +1,80 @@
+/**
+ * SCALE_REFERENCE — per-Scale* component API docs for the docs site.
+ *
+ * Catalog data is precomputed from SCALE_CAPABILITIES + SpecDeclarations
+ * (`scripts/gen-reference-catalogs.ts`) so reference pages never load TypeBox.
+ * Shells under packages/svelte/src/lib/scale/ are declaration-only; document
+ * this catalog instead of TypeDoc.
+ */
+import { type ScaleCapability } from "./capabilities.js";
+export interface ScaleParamDoc {
+    readonly name: string;
+    readonly description: string;
+    readonly typeSummary: string;
+    readonly required: boolean;
+}
+export type ScaleFamily = ScaleCapability["family"];
+/** Canonical aesthetic channel(s) this Scale* component configures. */
+export type ScaleAesthetic = "x" | "y" | "color" | "fill" | "size" | "linewidth" | "alpha" | "shape" | "linetype";
+export interface ScaleReferenceEntry {
+    /** Helper name, e.g. scaleXContinuous (Colour aliases use Colour spelling). */
+    readonly helper: string;
+    /** Route slug — snake_case stem without the scale prefix (e.g. x_continuous). */
+    readonly slug: string;
+    /** Svelte component export, e.g. ScaleXContinuous. */
+    readonly component: string;
+    readonly family: ScaleFamily;
+    /** Aesthetic channels written by this helper (usually one). */
+    readonly aesthetics: readonly ScaleAesthetic[];
+    /** Canonical post-normalize scale type(s) this helper authors. */
+    readonly scaleType: string;
+    /** Forced transform when the helper pins one (log10/sqrt); else undefined. */
+    readonly transform?: "log10" | "sqrt";
+    /** Forced temporalKind when the helper pins one. */
+    readonly temporalKind?: string;
+    /** Short purpose text for index + detail lede. */
+    readonly summary: string;
+    /** TypeScript options type name (or Omit expression) for the shell props. */
+    readonly optionsType: string;
+    /** Authoring props (schema-derived + helper sugar). */
+    readonly params: readonly ScaleParamDoc[];
+    /**
+     * How this scale interacts with guides: axis for position; legend/colorbar/
+     * colorsteps for style; "none" when guide: "none" is typical.
+     */
+    readonly guide: string;
+    /**
+     * When set, this component is a binding-identical re-export of another
+     * (British Colour spelling or *Ordinal → *Discrete).
+     */
+    readonly aliasOf?: string;
+    /** Alternate component names that re-export this shell. */
+    readonly alsoExportedAs: readonly string[];
+}
+/** scaleXContinuous → ScaleXContinuous */
+export declare function componentNameForScaleHelper(helper: string): string;
+/** scaleXContinuous → x_continuous; scaleColorViridisC → color_viridis_c */
+export declare function slugForScaleHelper(helper: string): string;
+/** Primary Scale* helpers (no Colour / Ordinal-only aliases). */
+export declare function primaryScaleHelpers(): readonly string[];
+/**
+ * Every public Scale* surface: primary shells + Colour aliases + Ordinal
+ * style aliases (binding-identical re-exports).
+ */
+export declare function allScaleHelpers(): readonly string[];
+/**
+ * Complete per-scale API reference. Keys are route slugs
+ * (e.g. color_continuous, x_log10). Precomputed at gen time.
+ */
+export declare const SCALE_REFERENCE: Readonly<Record<string, ScaleReferenceEntry>>;
+/** Stable sorted list for docs index, search, and inventory. */
+export declare function scaleReferenceList(): readonly ScaleReferenceEntry[];
+/** Primary (non-alias) entries only. */
+export declare function scaleReferencePrimaries(): readonly ScaleReferenceEntry[];
+/** Group primaries by family for the landing page. */
+export declare function scaleReferenceByFamily(): Readonly<Record<ScaleFamily, readonly ScaleReferenceEntry[]>>;
+/** Display labels for capability families on the index page. */
+export declare const SCALE_FAMILY_LABELS: Readonly<Record<ScaleFamily, string>>;
+/** Known scale reference slugs (for route entry generation). */
+export declare function knownScaleSlugs(): readonly string[];
+//# sourceMappingURL=scale-reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scale-reference.d.ts","sourceRoot":"","sources":["../src/scale-reference.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAIL,KAAK,eAAe,EACrB,MAAM,mBAAmB,CAAC;AAO3B,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,MAAM,WAAW,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;AAEpD,uEAAuE;AACvE,MAAM,MAAM,cAAc,GACtB,GAAG,GACH,GAAG,GACH,OAAO,GACP,MAAM,GACN,MAAM,GACN,WAAW,GACX,OAAO,GACP,OAAO,GACP,UAAU,CAAC;AAEf,MAAM,WAAW,mBAAmB;IAClC,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,+DAA+D;IAC/D,QAAQ,CAAC,UAAU,EAAE,SAAS,cAAc,EAAE,CAAC;IAC/C,kEAAkE;IAClE,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACtC,oDAAoD;IACpD,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,6EAA6E;IAC7E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,uDAAuD;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C;;;OAGG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C;AAMD,0CAA0C;AAC1C,wBAAgB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAKlE;AAED,4EAA4E;AAC5E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAMzD;AAED,iEAAiE;AACjE,wBAAgB,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAEvD;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,SAAS,MAAM,EAAE,CAMnD;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAwB,CAAC;AAEnG,gEAAgE;AAChE,wBAAgB,kBAAkB,IAAI,SAAS,mBAAmB,EAAE,CAEnE;AAED,wCAAwC;AACxC,wBAAgB,uBAAuB,IAAI,SAAS,mBAAmB,EAAE,CAExE;AAED,sDAAsD;AACtD,wBAAgB,sBAAsB,IAAI,QAAQ,CAChD,MAAM,CAAC,WAAW,EAAE,SAAS,mBAAmB,EAAE,CAAC,CACpD,CAcA;AAED,gEAAgE;AAChE,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAQpE,CAAC;AAEH,gEAAgE;AAChE,wBAAgB,eAAe,IAAI,SAAS,MAAM,EAAE,CAEnD"}

package/dist/scale-reference.js

@@ -0,0 +1,85 @@
+/**
+ * SCALE_REFERENCE — per-Scale* component API docs for the docs site.
+ *
+ * Catalog data is precomputed from SCALE_CAPABILITIES + SpecDeclarations
+ * (`scripts/gen-reference-catalogs.ts`) so reference pages never load TypeBox.
+ * Shells under packages/svelte/src/lib/scale/ are declaration-only; document
+ * this catalog instead of TypeDoc.
+ */
+import { SCALE_CAPABILITIES, STYLE_ORDINAL_SCALE_HELPERS, scaleCapabilityCamelHelpers, } from "./capabilities.js";
+import { SCALE_REFERENCE_DATA } from "./generated/scale-reference-data.js";
+// ---------------------------------------------------------------------------
+// Naming
+// ---------------------------------------------------------------------------
+/** scaleXContinuous → ScaleXContinuous */
+export function componentNameForScaleHelper(helper) {
+    if (!helper.startsWith("scale")) {
+        throw new Error(`SCALE_REFERENCE: expected scale* helper, got "${helper}"`);
+    }
+    return "S" + helper.slice(1);
+}
+/** scaleXContinuous → x_continuous; scaleColorViridisC → color_viridis_c */
+export function slugForScaleHelper(helper) {
+    const stem = helper.startsWith("scale") ? helper.slice(5) : helper;
+    return stem
+        .replaceAll(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .replaceAll(/([A-Z]+)([A-Z][a-z])/g, "$1_$2")
+        .toLowerCase();
+}
+/** Primary Scale* helpers (no Colour / Ordinal-only aliases). */
+export function primaryScaleHelpers() {
+    return scaleCapabilityCamelHelpers();
+}
+/**
+ * Every public Scale* surface: primary shells + Colour aliases + Ordinal
+ * style aliases (binding-identical re-exports).
+ */
+export function allScaleHelpers() {
+    const primary = scaleCapabilityCamelHelpers();
+    const colour = primary
+        .filter((h) => h.startsWith("scaleColor"))
+        .map((h) => h.replace("Color", "Colour"));
+    return [...new Set([...primary, ...colour, ...STYLE_ORDINAL_SCALE_HELPERS])].toSorted();
+}
+/**
+ * Complete per-scale API reference. Keys are route slugs
+ * (e.g. color_continuous, x_log10). Precomputed at gen time.
+ */
+export const SCALE_REFERENCE = SCALE_REFERENCE_DATA;
+/** Stable sorted list for docs index, search, and inventory. */
+export function scaleReferenceList() {
+    return Object.values(SCALE_REFERENCE).toSorted((a, b) => a.slug.localeCompare(b.slug));
+}
+/** Primary (non-alias) entries only. */
+export function scaleReferencePrimaries() {
+    return scaleReferenceList().filter((e) => e.aliasOf === undefined);
+}
+/** Group primaries by family for the landing page. */
+export function scaleReferenceByFamily() {
+    const groups = {};
+    for (const cap of SCALE_CAPABILITIES) {
+        groups[cap.family] = [];
+    }
+    for (const entry of scaleReferencePrimaries()) {
+        groups[entry.family].push(entry);
+    }
+    for (const family of Object.keys(groups)) {
+        groups[family] = Object.freeze(groups[family].toSorted((a, b) => a.slug.localeCompare(b.slug)));
+    }
+    return Object.freeze(groups);
+}
+/** Display labels for capability families on the index page. */
+export const SCALE_FAMILY_LABELS = Object.freeze({
+    "position-continuous": "Position — continuous",
+    "position-binned": "Position — binned",
+    "position-temporal": "Position — temporal",
+    "position-discrete": "Position — discrete",
+    "color-fill": "Color and fill",
+    "numeric-style": "Size, linewidth, and alpha",
+    "finite-style": "Shape and linetype",
+});
+/** Known scale reference slugs (for route entry generation). */
+export function knownScaleSlugs() {
+    return scaleReferenceList().map((e) => e.slug);
+}
+//# sourceMappingURL=scale-reference.js.map

package/dist/scale-reference.js.map

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