@ggts-sh/spec 0.43.0

package/dist/scale-reference-build.js

@@ -0,0 +1,147 @@
+/**
+ * SCALE_REFERENCE builder (SpecDeclarations + capabilities). Gen-only:
+ * `scripts/gen-reference-catalogs.ts`. Runtime uses generated/scale-reference-data.ts.
+ */
+import { SCALE_CAPABILITIES, STYLE_ORDINAL_SCALE_HELPERS, scaleCapabilityCamelHelpers, } from "./capabilities.js";
+import { classifyColorFillHelper } from "./scale-reference-classify-color.js";
+import { classifyPositionHelper } from "./scale-reference-classify-position.js";
+import { classifyStyleHelper } from "./scale-reference-classify-style.js";
+import { aestheticFromHelper, } from "./scale-reference-classify-support.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();
+}
+// ---------------------------------------------------------------------------
+// Per-helper classification dispatch
+// ---------------------------------------------------------------------------
+function classifyHelper(helper, family) {
+    if (family === "position-continuous" ||
+        family === "position-binned" ||
+        family === "position-temporal" ||
+        family === "position-discrete") {
+        return classifyPositionHelper(helper, family);
+    }
+    if (family === "color-fill")
+        return classifyColorFillHelper(helper, family);
+    return classifyStyleHelper(helper, family);
+}
+// ---------------------------------------------------------------------------
+// Build catalog
+// ---------------------------------------------------------------------------
+function familyForHelper(helper) {
+    for (const cap of SCALE_CAPABILITIES) {
+        if (cap.helpers.includes(helper)) {
+            return cap.family;
+        }
+    }
+    // Ordinal style aliases live outside the main ledger helper arrays.
+    if (STYLE_ORDINAL_SCALE_HELPERS.includes(helper)) {
+        if (helper.includes("Shape") || helper.includes("Linetype"))
+            return "finite-style";
+        return "numeric-style";
+    }
+    // Colour spelling is on the ledger under color-fill.
+    if (helper.includes("Colour")) {
+        return "color-fill";
+    }
+    throw new Error(`SCALE_REFERENCE: helper "${helper}" not in SCALE_CAPABILITIES`);
+}
+function primaryHelperForAlias(helper) {
+    if (helper.includes("Colour")) {
+        return helper.replace("Colour", "Color");
+    }
+    // Style-channel *Ordinal shells re-export *Discrete (#830/#832). Color/fill
+    // scaleColorOrdinal / scaleFillOrdinal are distinct primary helpers.
+    if (STYLE_ORDINAL_SCALE_HELPERS.includes(helper)) {
+        return helper.replace(/Ordinal$/, "Discrete");
+    }
+    return undefined;
+}
+function buildAlsoExportedAs(primaryHelper) {
+    const aliases = [];
+    // Colour re-exports for color channel only
+    if (primaryHelper.startsWith("scaleColor")) {
+        aliases.push(componentNameForScaleHelper(primaryHelper.replace("Color", "Colour")));
+    }
+    // Ordinal re-exports for discrete style shells
+    if (primaryHelper.endsWith("Discrete") &&
+        (primaryHelper.startsWith("scaleSize") ||
+            primaryHelper.startsWith("scaleLinewidth") ||
+            primaryHelper.startsWith("scaleAlpha") ||
+            primaryHelper.startsWith("scaleShape"))) {
+        aliases.push(componentNameForScaleHelper(primaryHelper.replace(/Discrete$/, "Ordinal")));
+    }
+    return Object.freeze(aliases);
+}
+function buildEntry(helper) {
+    const family = familyForHelper(helper);
+    const aliasOfHelper = primaryHelperForAlias(helper);
+    const aes = aestheticFromHelper(helper);
+    const meta = aliasOfHelper === undefined
+        ? classifyHelper(helper, family)
+        : classifyHelper(aliasOfHelper, familyForHelper(aliasOfHelper));
+    const aesthetics = Object.freeze([aes]);
+    const alsoExportedAs = aliasOfHelper === undefined ? buildAlsoExportedAs(helper) : Object.freeze([]);
+    const summary = aliasOfHelper === undefined
+        ? meta.summary
+        : helper.includes("Colour")
+            ? `${meta.summary} British Colour spelling — same binding as ${componentNameForScaleHelper(aliasOfHelper)}.`
+            : `${meta.summary} ggplot2 *Ordinal alias — same binding as ${componentNameForScaleHelper(aliasOfHelper)}.`;
+    return Object.freeze({
+        helper,
+        slug: slugForScaleHelper(helper),
+        component: componentNameForScaleHelper(helper),
+        family,
+        aesthetics,
+        scaleType: meta.scaleType,
+        ...(meta.transform === undefined ? {} : { transform: meta.transform }),
+        ...(meta.temporalKind === undefined ? {} : { temporalKind: meta.temporalKind }),
+        summary,
+        optionsType: meta.optionsType,
+        params: Object.freeze([...meta.params]),
+        guide: meta.guide,
+        ...(aliasOfHelper === undefined ? {} : { aliasOf: slugForScaleHelper(aliasOfHelper) }),
+        alsoExportedAs,
+    });
+}
+/** 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();
+}
+export function buildScaleReference() {
+    const out = {};
+    for (const helper of allScaleHelpers()) {
+        const entry = buildEntry(helper);
+        if (out[entry.slug] !== undefined) {
+            throw new Error(`SCALE_REFERENCE: duplicate slug "${entry.slug}"`);
+        }
+        out[entry.slug] = entry;
+    }
+    return Object.freeze(out);
+}
+//# sourceMappingURL=scale-reference-build.js.map

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

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

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

@@ -0,0 +1,11 @@
+/**
+ * Color/fill-family classification for the SCALE_REFERENCE builder
+ * (gen-only): continuous, binned, ordinal, manual, identity, transformed,
+ * temporal, and gradient/brewer/distiller/fermenter/viridis/hue/grey
+ * variants.
+ */
+import { type HelperMeta } from "./scale-reference-classify-support.js";
+type ColorFillFamily = "color-fill";
+export declare function classifyColorFillHelper(helper: string, _family: ColorFillFamily): HelperMeta;
+export {};
+//# sourceMappingURL=scale-reference-classify-color.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scale-reference-classify-color.d.ts","sourceRoot":"","sources":["../src/scale-reference-classify-color.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EASL,KAAK,UAAU,EAChB,MAAM,uCAAuC,CAAC;AAoE/C,KAAK,eAAe,GAAG,YAAY,CAAC;AA+OpC,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,GAAG,UAAU,CAU5F"}

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

@@ -0,0 +1,292 @@
+/**
+ * Color/fill-family classification for the SCALE_REFERENCE builder
+ * (gen-only): continuous, binned, ordinal, manual, identity, transformed,
+ * temporal, and gradient/brewer/distiller/fermenter/viridis/hue/grey
+ * variants.
+ */
+import { aestheticFromHelper, guideFor, paramDocsFromSchema, withGradientStops, withHueGrey, withPaletteDirection, withValues, withViridisOption, } from "./scale-reference-classify-support.js";
+// ---------------------------------------------------------------------------
+// Param key sets per options family (mirrors helper option Pick/Omit types)
+// ---------------------------------------------------------------------------
+const COLOR_SEQUENTIAL_KEYS = [
+    "domain",
+    "breaks",
+    "range",
+    "scheme",
+    "reverse",
+    "transform",
+    "oob",
+    "naValue",
+    "unknownValue",
+    "labels",
+    "guide",
+];
+const COLOR_TRANSFORMED_KEYS = [
+    "domain",
+    "breaks",
+    "range",
+    "scheme",
+    "reverse",
+    "oob",
+    "naValue",
+    "unknownValue",
+    "labels",
+    "guide",
+];
+const COLOR_DISCRETE_KEYS = [
+    "domain",
+    "domainMode",
+    "range",
+    "scheme",
+    "reverse",
+    "naValue",
+    "unknownValue",
+    "onExhaust",
+    "guide",
+];
+const COLOR_MANUAL_KEYS = ["domain", "naValue", "unknownValue", "guide"];
+const COLOR_IDENTITY_KEYS = ["naValue", "unknownValue", "guide"];
+const COLOR_TEMPORAL_KEYS = [
+    "domain",
+    "breaks",
+    "range",
+    "scheme",
+    "reverse",
+    "oob",
+    "naValue",
+    "unknownValue",
+    "labels",
+    "guide",
+    "parse",
+    "parseFailure",
+    "timezone",
+    "disambiguation",
+];
+const colorParams = (keys) => paramDocsFromSchema("ColorScaleSpec", keys);
+function classifyPalette(helper) {
+    const aes = aestheticFromHelper(helper);
+    if (helper.includes("Viridis")) {
+        const kind = helper.endsWith("D") ? "ordinal" : helper.endsWith("B") ? "binned" : "sequential";
+        const label = kind === "ordinal"
+            ? "discrete (viridis_d)"
+            : kind === "binned"
+                ? "binned (viridis_b)"
+                : "continuous (viridis_c)";
+        return {
+            optionsType: "ViridisScaleOptions",
+            scaleType: kind,
+            params: withViridisOption(colorParams(COLOR_SEQUENTIAL_KEYS.filter((k) => k !== "scheme"))),
+            guide: guideFor(aes, kind),
+            summary: `Viridis-family ${aes} scale — ${label}.`,
+        };
+    }
+    if (helper.includes("Brewer")) {
+        return {
+            optionsType: "ColorBrewerScaleOptions",
+            scaleType: "ordinal",
+            params: withPaletteDirection(colorParams(COLOR_DISCRETE_KEYS)),
+            guide: guideFor(aes, "ordinal"),
+            summary: `ColorBrewer qualitative ${aes} scale (discrete categories).`,
+        };
+    }
+    if (helper.includes("Distiller")) {
+        return {
+            optionsType: "ColorDistillerScaleOptions",
+            scaleType: "sequential",
+            params: withPaletteDirection(colorParams(COLOR_SEQUENTIAL_KEYS)),
+            guide: guideFor(aes, "sequential"),
+            summary: `ColorBrewer sequential/diverging ${aes} ramp (distiller).`,
+        };
+    }
+    if (helper.includes("Fermenter")) {
+        return {
+            optionsType: "ColorFermenterScaleOptions",
+            scaleType: "binned",
+            params: withPaletteDirection(colorParams(COLOR_SEQUENTIAL_KEYS)),
+            guide: guideFor(aes, "binned"),
+            summary: `ColorBrewer binned ${aes} steps (fermenter).`,
+        };
+    }
+    return undefined;
+}
+function classifyGradient2(helper) {
+    const aes = aestheticFromHelper(helper);
+    if (helper.includes("Gradient2") || helper.includes("Steps2")) {
+        const binned = helper.includes("Steps");
+        return {
+            optionsType: binned ? "Steps2ScaleOptions" : "Gradient2ScaleOptions",
+            scaleType: binned ? "binned" : "sequential",
+            params: withGradientStops(colorParams(COLOR_SEQUENTIAL_KEYS), binned ? "steps2" : "2"),
+            guide: guideFor(aes, binned ? "binned" : "sequential"),
+            summary: binned
+                ? `Three-stop diverging binned ${aes} steps (low/mid/high).`
+                : `Three-stop diverging continuous ${aes} gradient (low/mid/high).`,
+        };
+    }
+    return undefined;
+}
+function classifyGradient(helper) {
+    const aes = aestheticFromHelper(helper);
+    if (helper.includes("Gradientn") || helper.includes("Stepsn")) {
+        const binned = helper.includes("Steps");
+        return {
+            optionsType: binned ? "StepsnScaleOptions" : "GradientnScaleOptions",
+            scaleType: binned ? "binned" : "sequential",
+            params: withGradientStops(colorParams(COLOR_SEQUENTIAL_KEYS), binned ? "stepsn" : "n"),
+            guide: guideFor(aes, binned ? "binned" : "sequential"),
+            summary: binned
+                ? `N-stop binned ${aes} steps from an ordered color list.`
+                : `N-stop continuous ${aes} gradient from an ordered color list.`,
+        };
+    }
+    if (helper.includes("Gradient") || helper.endsWith("Steps")) {
+        const binned = helper.endsWith("Steps");
+        return {
+            optionsType: binned ? "StepsScaleOptions" : "GradientScaleOptions",
+            scaleType: binned ? "binned" : "sequential",
+            params: withGradientStops(colorParams(COLOR_SEQUENTIAL_KEYS), binned ? "steps" : "steps"),
+            guide: guideFor(aes, binned ? "binned" : "sequential"),
+            summary: binned
+                ? `Two-stop binned ${aes} steps (low/high).`
+                : `Two-stop continuous ${aes} gradient (low/high).`,
+        };
+    }
+    return undefined;
+}
+function classifyNamedPalette(helper) {
+    const aes = aestheticFromHelper(helper);
+    if (helper.includes("Hue")) {
+        return {
+            optionsType: "HueScaleOptions",
+            scaleType: "ordinal",
+            params: withHueGrey(colorParams(COLOR_DISCRETE_KEYS), "hue"),
+            guide: guideFor(aes, "ordinal"),
+            summary: `Evenly spaced hue ${aes} palette for discrete categories.`,
+        };
+    }
+    if (helper.includes("Grey") || helper.includes("Gray")) {
+        return {
+            optionsType: "GreyScaleOptions",
+            scaleType: "ordinal",
+            params: withHueGrey(colorParams(COLOR_DISCRETE_KEYS), "grey"),
+            guide: guideFor(aes, "ordinal"),
+            summary: `Grey ramp ${aes} palette for discrete categories.`,
+        };
+    }
+    if (helper.includes("Ordinal")) {
+        return {
+            optionsType: "OrdinalColorScaleOptions",
+            scaleType: "ordinal",
+            params: colorParams(COLOR_DISCRETE_KEYS),
+            guide: guideFor(aes, "ordinal"),
+            summary: `Explicit ordinal ${aes} scale (categories → colors).`,
+        };
+    }
+    return undefined;
+}
+function classifyBaseColor(helper) {
+    const aes = aestheticFromHelper(helper);
+    if (helper.includes("Log10")) {
+        return {
+            optionsType: "TransformedColorScaleOptions",
+            scaleType: "sequential",
+            transform: "log10",
+            params: colorParams(COLOR_TRANSFORMED_KEYS),
+            guide: guideFor(aes, "sequential"),
+            summary: `Sequential ${aes} scale with log10 pre-training transform.`,
+        };
+    }
+    if (helper.includes("Sqrt")) {
+        return {
+            optionsType: "TransformedColorScaleOptions",
+            scaleType: "sequential",
+            transform: "sqrt",
+            params: colorParams(COLOR_TRANSFORMED_KEYS),
+            guide: guideFor(aes, "sequential"),
+            summary: `Sequential ${aes} scale with sqrt pre-training transform.`,
+        };
+    }
+    if (helper.includes("Datetime")) {
+        return {
+            optionsType: "TemporalColorScaleOptions",
+            scaleType: "sequential",
+            temporalKind: "datetime",
+            params: colorParams(COLOR_TEMPORAL_KEYS),
+            guide: guideFor(aes, "sequential"),
+            summary: `Sequential ${aes} scale trained on datetime values.`,
+        };
+    }
+    if (helper.includes("Date")) {
+        return {
+            optionsType: "TemporalColorScaleOptions",
+            scaleType: "sequential",
+            temporalKind: "date",
+            params: colorParams(COLOR_TEMPORAL_KEYS),
+            guide: guideFor(aes, "sequential"),
+            summary: `Sequential ${aes} scale trained on calendar dates.`,
+        };
+    }
+    if (helper.includes("Manual")) {
+        return {
+            optionsType: "ManualColorScaleOptions",
+            scaleType: "manual",
+            params: withValues(colorParams(COLOR_MANUAL_KEYS), "string[]", "Colors paired positionally with the explicit or trained domain (required)."),
+            guide: guideFor(aes, "manual"),
+            summary: `Manual ${aes} mapping: domain values paired with explicit colors.`,
+        };
+    }
+    if (helper.includes("Identity")) {
+        return {
+            optionsType: "IdentityColorScaleOptions",
+            scaleType: "identity",
+            params: colorParams(COLOR_IDENTITY_KEYS),
+            guide: guideFor(aes, "identity"),
+            summary: `Identity ${aes} scale: source values are validated #rgb/#rrggbb colors used as-is.`,
+        };
+    }
+    if (helper.includes("Binned")) {
+        return {
+            optionsType: "BinnedColorScaleOptions",
+            scaleType: "binned",
+            params: colorParams(COLOR_SEQUENTIAL_KEYS),
+            guide: guideFor(aes, "binned"),
+            summary: `Binned ${aes} scale: continuous values → ordered color steps.`,
+        };
+    }
+    if (helper.includes("Discrete")) {
+        return {
+            optionsType: "DiscreteColorScaleOptions",
+            scaleType: "ordinal",
+            params: colorParams(COLOR_DISCRETE_KEYS),
+            guide: guideFor(aes, "ordinal"),
+            summary: `Discrete ${aes} scale for categorical data (default ordinal family).`,
+        };
+    }
+    if (helper.includes("Continuous")) {
+        return {
+            optionsType: "SequentialColorScaleOptions",
+            scaleType: "sequential",
+            params: colorParams(COLOR_SEQUENTIAL_KEYS),
+            guide: guideFor(aes, "sequential"),
+            summary: `Continuous sequential ${aes} scale (default continuous color family).`,
+        };
+    }
+    return undefined;
+}
+const COLOR_HANDLERS = [
+    classifyPalette,
+    classifyGradient2,
+    classifyGradient,
+    classifyNamedPalette,
+    classifyBaseColor,
+];
+export function classifyColorFillHelper(helper, _family) {
+    for (const handler of COLOR_HANDLERS) {
+        const meta = handler(helper);
+        if (meta !== undefined)
+            return meta;
+    }
+    const stem = helper.replace(/^scale(Colour|Color|Fill|X|Y|Size|Linewidth|Alpha|Shape|Linetype|Radius)/, "");
+    throw new Error(`SCALE_REFERENCE: unhandled color/fill helper "${helper}" (stem ${stem})`);
+}
+//# sourceMappingURL=scale-reference-classify-color.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Position-family classification for the SCALE_REFERENCE builder (gen-only):
+ * continuous/binned linear, transformed, temporal, and discrete (band) x/y
+ * position scales.
+ */
+import { type HelperMeta } from "./scale-reference-classify-support.js";
+type PositionFamily = "position-continuous" | "position-binned" | "position-temporal" | "position-discrete";
+export declare function classifyPositionHelper(helper: string, family: PositionFamily): HelperMeta;
+export {};
+//# sourceMappingURL=scale-reference-classify-position.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scale-reference-classify-position.d.ts","sourceRoot":"","sources":["../src/scale-reference-classify-position.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,uCAAuC,CAAC;AA2D/C,KAAK,cAAc,GACf,qBAAqB,GACrB,iBAAiB,GACjB,mBAAmB,GACnB,mBAAmB,CAAC;AAExB,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,GAAG,UAAU,CAuFzF"}

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

@@ -0,0 +1,137 @@
+/**
+ * Position-family classification for the SCALE_REFERENCE builder (gen-only):
+ * continuous/binned linear, transformed, temporal, and discrete (band) x/y
+ * position scales.
+ */
+import { aestheticFromHelper, guideFor, paramDocsFromSchema, withLimits, } from "./scale-reference-classify-support.js";
+// ---------------------------------------------------------------------------
+// Param key sets per options family (mirrors helper option Pick/Omit types)
+// ---------------------------------------------------------------------------
+const POSITION_CONTINUOUS_KEYS = [
+    "domain",
+    "nice",
+    "zero",
+    "reverse",
+    "breaks",
+    "labels",
+    "expand",
+    "oob",
+    "naValue",
+    "minorBreaks",
+    "transform",
+    "guide",
+];
+const POSITION_TRANSFORMED_KEYS = POSITION_CONTINUOUS_KEYS.filter((k) => k !== "transform");
+const POSITION_DISCRETE_KEYS = [
+    "domain",
+    "reverse",
+    "breaks",
+    "labels",
+    "expand",
+    "naValue",
+    "guide",
+];
+const POSITION_TEMPORAL_KEYS = [
+    "domain",
+    "nice",
+    "reverse",
+    "breaks",
+    "labels",
+    "expand",
+    "oob",
+    "naValue",
+    "minorBreaks",
+    "parse",
+    "parseFailure",
+    "timezone",
+    "disambiguation",
+    "dateBreaks",
+    "dateMinorBreaks",
+    "dateLabels",
+    "locale",
+    "weekStart",
+    "guide",
+];
+export function classifyPositionHelper(helper, family) {
+    const aes = aestheticFromHelper(helper);
+    // --- position -----------------------------------------------------------
+    if (family === "position-continuous" || family === "position-binned") {
+        const posParams = paramDocsFromSchema("PositionScaleSpec", POSITION_CONTINUOUS_KEYS);
+        if (helper.includes("Log10")) {
+            return {
+                optionsType: "TransformedPositionScaleOptions",
+                scaleType: "linear",
+                transform: "log10",
+                params: withLimits(paramDocsFromSchema("PositionScaleSpec", POSITION_TRANSFORMED_KEYS)),
+                guide: guideFor(aes, "linear"),
+                summary: `Base-10 log ${aes} position scale (pre-stat log10 transform on a linear scale).`,
+            };
+        }
+        if (helper.includes("Sqrt")) {
+            return {
+                optionsType: "TransformedPositionScaleOptions",
+                scaleType: "linear",
+                transform: "sqrt",
+                params: withLimits(paramDocsFromSchema("PositionScaleSpec", POSITION_TRANSFORMED_KEYS)),
+                guide: guideFor(aes, "linear"),
+                summary: `Square-root ${aes} position scale (pre-stat sqrt transform on a linear scale).`,
+            };
+        }
+        if (helper.includes("Reverse")) {
+            return {
+                optionsType: 'Omit<ContinuousPositionScaleOptions, "transform" | "reverse">',
+                scaleType: "linear",
+                params: withLimits(paramDocsFromSchema("PositionScaleSpec", POSITION_CONTINUOUS_KEYS.filter((k) => k !== "transform" && k !== "reverse"))),
+                guide: guideFor(aes, "linear"),
+                summary: `Continuous ${aes} position scale with reverse: true (output direction flipped).`,
+            };
+        }
+        if (family === "position-binned" || helper.includes("Binned")) {
+            return {
+                optionsType: "ContinuousPositionScaleOptions",
+                scaleType: "binned",
+                params: withLimits(posParams),
+                guide: guideFor(aes, "binned"),
+                summary: `Binned ${aes} position scale: quantitative values map to ordered bins (breaks are bin boundaries).`,
+            };
+        }
+        return {
+            optionsType: "ContinuousPositionScaleOptions",
+            scaleType: "linear",
+            params: withLimits(posParams),
+            guide: guideFor(aes, "linear"),
+            summary: `Continuous linear ${aes} position scale (default numeric family).`,
+        };
+    }
+    if (family === "position-temporal") {
+        let temporalKind = "date";
+        if (helper.includes("Datetime"))
+            temporalKind = "datetime";
+        else if (helper.includes("Time") && !helper.includes("Date"))
+            temporalKind = "time";
+        else if (helper.includes("MonthDay"))
+            temporalKind = "monthDay";
+        const label = temporalKind === "monthDay"
+            ? "month-day (year collapsed)"
+            : temporalKind === "time"
+                ? "time-of-day"
+                : temporalKind;
+        return {
+            optionsType: "TemporalScaleOptions",
+            scaleType: "time",
+            temporalKind,
+            params: paramDocsFromSchema("PositionScaleSpec", POSITION_TEMPORAL_KEYS),
+            guide: guideFor(aes, "time"),
+            summary: `Temporal ${aes} position scale (${label}).`,
+        };
+    }
+    // Remaining position family: discrete (band).
+    return {
+        optionsType: "DiscretePositionScaleOptions",
+        scaleType: "band",
+        params: paramDocsFromSchema("PositionScaleSpec", POSITION_DISCRETE_KEYS),
+        guide: guideFor(aes, "band"),
+        summary: `Discrete (band) ${aes} position scale for categories.`,
+    };
+}
+//# sourceMappingURL=scale-reference-classify-position.js.map

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

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

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

@@ -0,0 +1,10 @@
+/**
+ * Style-family classification for the SCALE_REFERENCE builder (gen-only):
+ * numeric style channels (size/linewidth/alpha) and finite style channels
+ * (shape/linetype).
+ */
+import { type HelperMeta } from "./scale-reference-classify-support.js";
+type StyleFamily = "numeric-style" | "finite-style";
+export declare function classifyStyleHelper(helper: string, family: StyleFamily): HelperMeta;
+export {};
+//# sourceMappingURL=scale-reference-classify-style.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scale-reference-classify-style.d.ts","sourceRoot":"","sources":["../src/scale-reference-classify-style.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAOL,KAAK,UAAU,EAChB,MAAM,uCAAuC,CAAC;AA0D/C,KAAK,WAAW,GAAG,eAAe,GAAG,cAAc,CAAC;AAEpD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,UAAU,CAInF"}