@ggts-sh/spec 0.43.0

package/dist/validate-structure-layer-ribbon.js

@@ -0,0 +1,36 @@
+import { isRecord, pushMissingChannel } from "./validate-structure-layer-shared.js";
+export function ribbonStructuralErrors(layer, layerPath, mapped) {
+    const errors = [];
+    const params = isRecord(layer["params"]) ? layer["params"] : {};
+    const pinned = params["orientation"] === "x" || params["orientation"] === "y" ? params["orientation"] : null;
+    const xContract = mapped("x") !== undefined && mapped("ymin") !== undefined && mapped("ymax") !== undefined;
+    const yContract = mapped("y") !== undefined && mapped("xmin") !== undefined && mapped("xmax") !== undefined;
+    if (pinned === null && xContract && yContract) {
+        errors.push({
+            code: "ribbon-orientation-ambiguous",
+            path: `${layerPath}/params/orientation`,
+            message: 'This ribbon layer maps both x-orientation (x+ymin+ymax) and y-orientation (y+xmin+xmax) contracts. Set params.orientation to "x" or "y".',
+            fix: {
+                description: "Pin orientation explicitly.",
+                example: { params: { orientation: "x" } },
+            },
+        });
+        return errors;
+    }
+    const orientation = pinned === "x" || pinned === "y" ? pinned : xContract ? "x" : yContract ? "y" : null;
+    const usesYContract = orientation === "y" ||
+        (orientation === null &&
+            [mapped("y"), mapped("xmin"), mapped("xmax")].some((value) => value !== undefined));
+    const needed = usesYContract ? ["y", "xmin", "xmax"] : ["x", "ymin", "ymax"];
+    for (const channel of needed) {
+        if (mapped(channel) !== undefined)
+            continue;
+        const suffix = ribbonContractSuffix(orientation);
+        pushMissingChannel(errors, layerPath, channel, `The ribbon geom ${suffix} requires a "${channel}" channel; map it in the layer's aes or the plot-level aes.`);
+    }
+    return errors;
+}
+function ribbonContractSuffix(orientation) {
+    return orientation === null ? "for its interval contract" : `with orientation "${orientation}"`;
+}
+//# sourceMappingURL=validate-structure-layer-ribbon.js.map

package/dist/validate-structure-layer-ribbon.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure-layer-ribbon.js","sourceRoot":"","sources":["../src/validate-structure-layer-ribbon.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,MAAM,UAAU,sBAAsB,CACpC,KAA8B,EAC9B,SAAiB,EACjB,MAAyC;IAEzC,MAAM,MAAM,GAAgB,EAAE,CAAC;IAC/B,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAChE,MAAM,MAAM,GACV,MAAM,CAAC,aAAa,CAAC,KAAK,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAChG,MAAM,SAAS,GACb,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;IAC5F,MAAM,SAAS,GACb,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,SAAS,CAAC;IAE5F,IAAI,MAAM,KAAK,IAAI,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC9C,MAAM,CAAC,IAAI,CAAC;YACV,IAAI,EAAE,8BAA8B;YACpC,IAAI,EAAE,GAAG,SAAS,qBAAqB;YACvC,OAAO,EACL,0IAA0I;YAC5I,GAAG,EAAE;gBACH,WAAW,EAAE,6BAA6B;gBAC1C,OAAO,EAAE,EAAE,MAAM,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,EAAE;aAC1C;SACF,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,WAAW,GACf,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;IAEvF,MAAM,aAAa,GACjB,WAAW,KAAK,GAAG;QACnB,CAAC,WAAW,KAAK,IAAI;YACnB,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;IACxF,MAAM,MAAM,GAAkB,aAAa,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5F,KAAK,MAAM,OAAO,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,SAAS;YAAE,SAAS;QAC5C,MAAM,MAAM,GAAG,oBAAoB,CAAC,WAAW,CAAC,CAAC;QACjD,kBAAkB,CAChB,MAAM,EACN,SAAS,EACT,OAAO,EACP,mBAAmB,MAAM,gBAAgB,OAAO,6DAA6D,CAC9G,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,oBAAoB,CAAC,WAA6B;IACzD,OAAO,WAAW,KAAK,IAAI,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,qBAAqB,WAAW,GAAG,CAAC;AAClG,CAAC"}

package/dist/validate-structure-layer-rule.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Rule / hline / vline annotation vs data-driven form checks.
+ * Orchestrated by validate-structure-layers.ts.
+ */
+import type { SpecError } from "./errors.js";
+import type { Aes } from "./schema.js";
+/** Asymmetric intercept presence for rule / hline / vline form checks. */
+export declare function hasGeomIntercepts(geom: string, layer: Record<string, unknown>): boolean;
+/**
+ * Structural errors for rule-family geoms. Caller returns these immediately
+ * (no further layer checks apply to the rule family).
+ */
+export declare function ruleFamilyStructuralErrors(layer: Record<string, unknown>, geom: string, layerPath: string, layerAes: Aes | undefined, mapped: (channel: "x" | "y") => unknown): SpecError[];
+//# sourceMappingURL=validate-structure-layer-rule.d.ts.map

package/dist/validate-structure-layer-rule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure-layer-rule.d.ts","sourceRoot":"","sources":["../src/validate-structure-layer-rule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAGvC,0EAA0E;AAC1E,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAMvF;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,GAAG,GAAG,SAAS,EACzB,MAAM,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,GAAG,KAAK,OAAO,GACtC,SAAS,EAAE,CAiDb"}

package/dist/validate-structure-layer-rule.js

@@ -0,0 +1,90 @@
+import { isRecord } from "./validate-structure-layer-shared.js";
+/** Asymmetric intercept presence for rule / hline / vline form checks. */
+export function hasGeomIntercepts(geom, layer) {
+    const params = layer["params"];
+    if (!isRecord(params))
+        return false;
+    if (geom === "hline")
+        return params["yintercept"] !== undefined;
+    if (geom === "vline")
+        return params["xintercept"] !== undefined;
+    return params["xintercept"] !== undefined || params["yintercept"] !== undefined;
+}
+/**
+ * Structural errors for rule-family geoms. Caller returns these immediately
+ * (no further layer checks apply to the rule family).
+ */
+export function ruleFamilyStructuralErrors(layer, geom, layerPath, layerAes, mapped) {
+    const errors = [];
+    const intercepts = hasGeomIntercepts(geom, layer);
+    // The annotation form inherits NO plot aes (normalize drops it, matching
+    // ggplot2's inherit.aes = FALSE) — only the layer's OWN x/y mappings
+    // conflict with intercepts. Data-driven hline/vline sugar also nulls the
+    // orthogonal axis during normalize; pre-normalize validation still sees
+    // raw layer aes here.
+    const own = (channel) => layerAes?.[channel] ?? undefined;
+    let x = intercepts ? own("x") : mapped("x");
+    let y = intercepts ? own("y") : mapped("y");
+    // Pre-normalize data-driven aliases: orthogonal axis is not part of the form.
+    if (!intercepts && geom === "hline")
+        x = undefined;
+    if (!intercepts && geom === "vline")
+        y = undefined;
+    const { interceptHint, dataHint } = ruleHints(geom);
+    if (intercepts && (x !== undefined || y !== undefined)) {
+        errors.push({
+            code: "rule-form-ambiguous",
+            path: layerPath,
+            message: `This ${geom} layer mixes the annotation form (${interceptHint}) with mapped ${dataHint}. Use fixed intercepts OR a data mapping, never both.`,
+            fix: {
+                description: "Remove the intercept params (data-driven form), or unset the position aes with null (annotation form).",
+                example: ruleExample(geom),
+            },
+        });
+    }
+    else if (!intercepts && x === undefined && y === undefined) {
+        errors.push({
+            code: "rule-form-missing",
+            path: layerPath,
+            message: `This ${geom} layer has neither fixed intercepts (${interceptHint}) nor a mapped ${dataHint} — nothing to draw.`,
+            fix: {
+                description: missingRuleDescription(geom),
+                example: ruleExample(geom),
+            },
+        });
+    }
+    else if (!intercepts && x !== undefined && y !== undefined) {
+        errors.push({
+            code: "rule-both-axes",
+            path: layerPath,
+            message: "This rule layer maps BOTH aes.x and aes.y; a data-driven rule is either vertical (map x) or horizontal (map y). Unset the other channel with null.",
+            fix: {
+                description: "Keep one direction and unset the other channel with null.",
+                example: { geom: "rule", aes: { y: null } },
+            },
+        });
+    }
+    return errors;
+}
+function ruleHints(geom) {
+    if (geom === "hline")
+        return { interceptHint: "params.yintercept", dataHint: "aes.y" };
+    if (geom === "vline")
+        return { interceptHint: "params.xintercept", dataHint: "aes.x" };
+    return { interceptHint: "params.xintercept/yintercept", dataHint: "aes.x/aes.y" };
+}
+function ruleExample(geom) {
+    if (geom === "vline")
+        return { geom: "vline", params: { xintercept: 0 } };
+    return { geom: geom === "hline" ? "hline" : "rule", params: { yintercept: 0 } };
+}
+function missingRuleDescription(geom) {
+    if (geom === "hline") {
+        return "Set params.yintercept for an annotation, or map aes.y for data-driven rules.";
+    }
+    if (geom === "vline") {
+        return "Set params.xintercept for an annotation, or map aes.x for data-driven rules.";
+    }
+    return "Set params.yintercept (or xintercept) for an annotation, or map aes.x/aes.y to a field for data-driven rules.";
+}
+//# sourceMappingURL=validate-structure-layer-rule.js.map

package/dist/validate-structure-layer-rule.js.map

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

package/dist/validate-structure-layer-shared.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared helpers for layer structural grammar checks.
+ */
+import type { SpecError } from "./errors.js";
+import type { ChannelName } from "./schema.js";
+/** Same shape as sibling validate-structure-* modules (local, not schema-walk). */
+export declare function isRecord(v: unknown): v is Record<string, unknown>;
+export declare const CHANNEL_FIX_EXAMPLE: {
+    field: string;
+};
+export declare function pushMissingChannel(errors: SpecError[], layerPath: string, channel: ChannelName, message: string): void;
+//# sourceMappingURL=validate-structure-layer-shared.d.ts.map

package/dist/validate-structure-layer-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure-layer-shared.d.ts","sourceRoot":"","sources":["../src/validate-structure-layer-shared.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,mFAAmF;AACnF,wBAAgB,QAAQ,CAAC,CAAC,EAAE,OAAO,GAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEjE;AAED,eAAO,MAAM,mBAAmB;;CAA2B,CAAC;AAE5D,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,SAAS,EAAE,EACnB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,MAAM,GACd,IAAI,CAUN"}

package/dist/validate-structure-layer-shared.js

@@ -0,0 +1,17 @@
+/** Same shape as sibling validate-structure-* modules (local, not schema-walk). */
+export function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+export const CHANNEL_FIX_EXAMPLE = { field: "column_name" };
+export function pushMissingChannel(errors, layerPath, channel, message) {
+    errors.push({
+        code: "missing-required-channel",
+        path: `${layerPath}/aes/${channel}`,
+        message,
+        fix: {
+            description: `Map "${channel}" to a data field.`,
+            example: { [channel]: CHANNEL_FIX_EXAMPLE },
+        },
+    });
+}
+//# sourceMappingURL=validate-structure-layer-shared.js.map

package/dist/validate-structure-layer-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure-layer-shared.js","sourceRoot":"","sources":["../src/validate-structure-layer-shared.ts"],"names":[],"mappings":"AAMA,mFAAmF;AACnF,MAAM,UAAU,QAAQ,CAAC,CAAU;IACjC,OAAO,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAClE,CAAC;AAED,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC;AAE5D,MAAM,UAAU,kBAAkB,CAChC,MAAmB,EACnB,SAAiB,EACjB,OAAoB,EACpB,OAAe;IAEf,MAAM,CAAC,IAAI,CAAC;QACV,IAAI,EAAE,0BAA0B;QAChC,IAAI,EAAE,GAAG,SAAS,QAAQ,OAAO,EAAE;QACnC,OAAO;QACP,GAAG,EAAE;YACH,WAAW,EAAE,QAAQ,OAAO,oBAAoB;YAChD,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,mBAAmB,EAAE;SAC5C;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/validate-structure-layers.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Data-free structural grammar checks for layers (required channels, rule forms,
+ * computed-y bans, bin center/boundary, errorbar stat channels).
+ * Color-scheme rules: validate-structure-scales.ts. Facet form: validate-structure-facet.ts.
+ * Form families: validate-structure-layer-{rule,ribbon,computed-y,shared}.ts.
+ * Barrel: validate-structure.ts.
+ */
+import type { SpecError } from "./errors.js";
+import type { Aes } from "./schema.js";
+/** Grammar checks for one schema-valid layer. */
+export declare function layerStructuralErrors(layer: Record<string, unknown>, geom: string, index: number, plotAes: Aes | undefined): SpecError[];
+//# sourceMappingURL=validate-structure-layers.d.ts.map

package/dist/validate-structure-layers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure-layers.d.ts","sourceRoot":"","sources":["../src/validate-structure-layers.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAyB,MAAM,aAAa,CAAC;AAyE9D,iDAAiD;AACjD,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,GAAG,SAAS,GACvB,SAAS,EAAE,CAsCb"}

package/dist/validate-structure-layers.js

@@ -0,0 +1,292 @@
+import { GEOM_DEFAULTS } from "./schema-catalog.js";
+import { STYLE_AESTHETIC_GEOMS } from "./capabilities.js";
+import { effectiveChannel } from "./validate-data.js";
+import { paintStructuralErrors } from "./validate-structure-paint.js";
+import { computedYMappedErrors } from "./validate-structure-layer-computed-y.js";
+import { hasGeomIntercepts, ruleFamilyStructuralErrors } from "./validate-structure-layer-rule.js";
+import { ribbonStructuralErrors } from "./validate-structure-layer-ribbon.js";
+import { CHANNEL_FIX_EXAMPLE, isRecord, pushMissingChannel, } from "./validate-structure-layer-shared.js";
+/**
+ * Channels every geom needs mapped (after plot-aes inheritance).
+ * Total over GeomName — a missing geom is a type error, not a silent `?? []`
+ * (#1078). Empty lists are deliberate (form-checked elsewhere or annotation-only).
+ */
+const REQUIRED_CHANNELS = {
+    point: ["x", "y"],
+    count: ["x", "y"],
+    jitter: ["x", "y"],
+    line: ["x", "y"],
+    path: ["x", "y"], // data-order polylines (#788); same channels as line
+    step: ["x", "y"],
+    col: ["x", "y"],
+    bar: ["x"],
+    histogram: ["x"],
+    freqpoly: ["x"],
+    area: ["x", "y"],
+    rule: [], // form-checked separately
+    hline: [], // form-checked like rule (yintercept / aes.y)
+    vline: [], // form-checked like rule (xintercept / aes.x)
+    text: ["x", "y", "label"],
+    label: ["x", "y", "label"], // same contract as text (#1078)
+    sf_text: ["label"], // x/y come from stat_sf_coordinates (#809 phase 2)
+    sf_label: ["label"],
+    sf: [], // geometry column, not aes
+    smooth: ["x", "y"],
+    boxplot: ["x", "y"],
+    density: ["x"],
+    errorbar: ["x"], // ymin/ymax vs y are stat-dependent, checked separately
+    linerange: ["x"],
+    pointrange: ["x"],
+    crossbar: ["x"],
+    rect: ["xmin", "xmax", "ymin", "ymax"],
+    segment: ["x", "y", "xend", "yend"],
+    violin: ["x", "y"],
+    function: [], // domain from xlim / peer / optional x; y is after_stat
+    polygon: ["x", "y"],
+    spoke: ["x", "y"], // angle/radius: aes or params — checked below
+    curve: ["x", "y", "xend", "yend"],
+    rug: [], // sides-dependent; checked separately
+    tile: ["x", "y"],
+    raster: ["x", "y"],
+    ribbon: [], // orientation-dependent; checked separately
+    contour: ["x", "y", "z"],
+    quantile: ["x", "y"],
+    density_2d: ["x", "y"],
+    density_2d_filled: ["x", "y"],
+    hex: ["x", "y"],
+    bin_2d: ["x", "y"],
+    abline: [], // annotation-only: slope/intercept in params
+    qq: ["sample"],
+    qq_line: ["sample"],
+    dotplot: ["x"],
+    map: ["map_id"],
+    blank: [], // trains whatever is mapped; nothing required
+};
+/** Grammar checks for one schema-valid layer. */
+export function layerStructuralErrors(layer, geom, index, plotAes) {
+    const errors = [];
+    const layerAes = isRecord(layer["aes"]) ? layer["aes"] : undefined;
+    const layerPath = `/layers/${index}`;
+    const mapped = (channel) => effectiveChannel(plotAes, layerAes, channel);
+    // Annotation-form rules / hline / vline (fixed intercepts) inherit NO plot
+    // aes — normalize drops it — so a plot-level style meant for other layers
+    // must not trip the geom-capability check here. Match the rule-form x/y
+    // handling below by consulting only the layer's OWN aes for these layers.
+    const isRuleFamily = geom === "rule" || geom === "hline" || geom === "vline";
+    const annotationRule = isRuleFamily && hasGeomIntercepts(geom, layer);
+    errors.push(...styleAestheticErrors(layerAes, geom, annotationRule, mapped, layerPath));
+    if (isRuleFamily) {
+        // Keep unsupported-geom-aesthetic errors already pushed above; rule form
+        // checks append. Returning only the form-check array would drop them.
+        errors.push(...ruleFamilyStructuralErrors(layer, geom, layerPath, layerAes, mapped));
+        return errors;
+    }
+    const stat = typeof layer["stat"] === "string"
+        ? layer["stat"]
+        : (GEOM_DEFAULTS[geom]?.stat ?? "identity");
+    errors.push(...computedYMappedErrors(geom, stat, layerPath, mapped), ...binAlignmentErrors(layer, geom, stat, layerPath), ...intervalChannelErrors(geom, stat, layerPath, mapped), ...(geom === "ribbon" ? ribbonStructuralErrors(layer, layerPath, mapped) : []), ...statParameterErrors(layer, stat, layerPath), ...spokeStructuralErrors(layer, geom, layerPath, mapped), ...rugStructuralErrors(layer, geom, layerPath, mapped), ...paintStructuralErrors(layer, layerPath, plotAes), ...requiredChannelErrors(geom, stat, layerPath, mapped));
+    return errors;
+}
+function binAlignmentErrors(layer, geom, stat, layerPath) {
+    const binnedGeom = ["bar", "histogram", "freqpoly", "dotplot"].includes(geom);
+    const binnedLayer = binnedGeom ||
+        (geom === "line" && (stat === "bin" || stat === "summary_bin")) ||
+        ((geom === "point" || geom === "errorbar") && stat === "summary_bin") ||
+        stat === "summary_bin" ||
+        stat === "bindot";
+    if (!binnedLayer)
+        return [];
+    const params = isRecord(layer["params"]) ? layer["params"] : {};
+    const binStat = ["histogram", "freqpoly", "dotplot"].includes(geom) ||
+        ["bin", "summary_bin", "bindot"].includes(stat);
+    if (!binStat || params["center"] === undefined || params["boundary"] === undefined)
+        return [];
+    return [
+        {
+            code: "bin-center-and-boundary",
+            path: `${layerPath}/params`,
+            message: `The ${stat === "summary_bin" ? "summary_bin" : "bin"} stat accepts params.center OR params.boundary (both align the bin grid), never both.`,
+            fix: {
+                description: "Keep one alignment parameter and remove the other.",
+                example: { params: { binwidth: 1, boundary: 0 } },
+            },
+        },
+    ];
+}
+function intervalChannelErrors(geom, stat, layerPath, mapped) {
+    if (!["errorbar", "linerange", "pointrange", "crossbar"].includes(geom))
+        return [];
+    const needed = stat === "summary" || stat === "summary_bin"
+        ? ["y"]
+        : geom === "pointrange" || geom === "crossbar"
+            ? ["y", "ymin", "ymax"]
+            : ["ymin", "ymax"];
+    return needed.flatMap((channel) => mapped(channel) === undefined
+        ? [
+            {
+                code: "missing-required-channel",
+                path: `${layerPath}/aes/${channel}`,
+                message: `The ${geom} geom with the ${stat} stat requires a "${channel}" channel; map it in the layer's aes or the plot-level aes.`,
+                fix: {
+                    description: `Map "${channel}" to a data field.`,
+                    example: { [channel]: CHANNEL_FIX_EXAMPLE },
+                },
+            },
+        ]
+        : []);
+}
+function statParameterErrors(layer, stat, layerPath) {
+    const errors = [];
+    const params = isRecord(layer["params"]) ? layer["params"] : {};
+    const fun = params["fun"];
+    if (["summary", "summary_bin", "summary_rolling"].includes(stat) &&
+        (fun === "first" || fun === "last")) {
+        errors.push({
+            code: "summary-fun-unsupported",
+            path: `${layerPath}/params/fun`,
+            message: `The ${stat} stat summarizes with the registry funs mean|median|sum|min|max; params.fun "${fun}" is a manual-stat keep transform and has no meaning here.`,
+            fix: {
+                description: "Use mean, median, or sum for the center summary (min/max via funMin/funMax where supported).",
+                example: { params: { fun: "median" } },
+            },
+        });
+    }
+    const window = params["window"];
+    if (stat === "summary_rolling" && (window === undefined || window === null || window === "")) {
+        errors.push({
+            code: "summary-rolling-window-required",
+            path: `${layerPath}/params/window`,
+            message: "The summary_rolling stat requires params.window (rolling-window width in x data units, greater than 0). There is no silent default width.",
+            fix: {
+                description: "Set params.window to the window width in x units (e.g. 30 for a 30-year running summary).",
+                example: { params: { window: 30 } },
+            },
+        });
+    }
+    if (stat === "manual" && (fun === undefined || fun === null || fun === "")) {
+        errors.push({
+            code: "manual-fun-required",
+            path: `${layerPath}/params/fun`,
+            message: "The manual stat requires params.fun (one of first|last|mean|median|min|max|sum). There is no silent identity default (ggplot2 divergence; #814).",
+            fix: {
+                description: "Set params.fun to a registered portable transform name.",
+                example: { params: { fun: "mean" } },
+            },
+        });
+    }
+    return errors;
+}
+function spokeStructuralErrors(layer, geom, layerPath, mapped) {
+    if (geom !== "spoke")
+        return [];
+    const errors = [];
+    const params = isRecord(layer["params"]) ? layer["params"] : {};
+    for (const channel of ["angle", "radius"]) {
+        const fromAes = mapped(channel);
+        const fromParams = params[channel];
+        if (fromAes === undefined && fromParams === undefined) {
+            errors.push(spokeChannelError(channel, layerPath, false));
+        }
+        if (fromAes !== undefined && !("field" in fromAes) && fromParams === undefined) {
+            errors.push(spokeChannelError(channel, layerPath, true));
+        }
+    }
+    return errors;
+}
+function spokeChannelError(channel, layerPath, invalidAesConstant) {
+    const message = invalidAesConstant
+        ? `The spoke geom requires aes.${channel} to map a data field (not a constant or stat). Use params.${channel} for a fixed value.`
+        : `The spoke geom requires "${channel}" via aes.${channel} or params.${channel}.`;
+    return {
+        code: "missing-required-channel",
+        path: `${layerPath}/aes/${channel}`,
+        message,
+        fix: {
+            description: `Map aes.${channel} to a field, or set params.${channel} to a constant.`,
+            example: channel === "angle"
+                ? { geom: "spoke", params: { angle: 0, radius: 1 } }
+                : { geom: "spoke", params: { radius: 1, angle: 0 } },
+        },
+    };
+}
+function rugStructuralErrors(layer, geom, layerPath, mapped) {
+    if (geom !== "rug")
+        return [];
+    const errors = [];
+    const params = isRecord(layer["params"]) ? layer["params"] : {};
+    const sides = typeof params["sides"] === "string" ? params["sides"] : "bl";
+    if (/[bt]/.test(sides) && mapped("x") === undefined) {
+        pushMissingChannel(errors, layerPath, "x", `The rug geom with sides "${sides}" requires an "x" channel for bottom/top ticks; map aes.x or narrow params.sides.`);
+    }
+    if (/[lr]/.test(sides) && mapped("y") === undefined) {
+        pushMissingChannel(errors, layerPath, "y", `The rug geom with sides "${sides}" requires a "y" channel for left/right ticks; map aes.y or narrow params.sides.`);
+    }
+    return errors;
+}
+function styleAestheticErrors(layerAes, geom, annotationRule, mapped, layerPath) {
+    const errors = [];
+    for (const aesthetic of Object.keys(STYLE_AESTHETIC_GEOMS)) {
+        const value = annotationRule ? (layerAes?.[aesthetic] ?? undefined) : mapped(aesthetic);
+        if (value === undefined)
+            continue;
+        const compatible = STYLE_AESTHETIC_GEOMS[aesthetic];
+        if (compatible.includes(geom))
+            continue;
+        errors.push({
+            code: "unsupported-geom-aesthetic",
+            path: `${layerPath}/aes/${aesthetic}`,
+            message: `The ${geom} geom does not consume aes.${aesthetic}; supported geoms: ${compatible.join(", ")}.`,
+            fix: {
+                description: `Remove aes.${aesthetic} or move it to a compatible ${compatible[0]} layer.`,
+            },
+        });
+    }
+    return errors;
+}
+function requiredChannelErrors(geom, stat, layerPath, mapped) {
+    const errors = [];
+    for (const channel of REQUIRED_CHANNELS[geom]) {
+        if (computedPositionChannel(geom, stat, channel))
+            continue;
+        const value = mapped(channel);
+        if (value === undefined) {
+            errors.push(missingChannelError(geom, layerPath, channel));
+            continue;
+        }
+        if (requiresFieldMapping(geom, channel) && !("field" in value)) {
+            errors.push({
+                code: "missing-required-channel",
+                path: `${layerPath}/aes/${channel}`,
+                message: `The ${geom} geom requires aes.${channel} to map a data field (not a constant or stat).`,
+                fix: {
+                    description: `Map "${channel}" to a data field.`,
+                    example: { [channel]: CHANNEL_FIX_EXAMPLE },
+                },
+            });
+        }
+    }
+    return errors;
+}
+function computedPositionChannel(geom, stat, channel) {
+    if (channel === "x")
+        return false;
+    return (["bar", "histogram", "freqpoly", "density", "dotplot"].includes(geom) ||
+        (geom === "line" && stat === "bin"));
+}
+function requiresFieldMapping(geom, channel) {
+    const endpoint = channel === "x" || channel === "y" || channel === "xend" || channel === "yend";
+    return (((geom === "segment" || geom === "curve") && endpoint) ||
+        (geom === "spoke" && (channel === "x" || channel === "y")));
+}
+function missingChannelError(geom, layerPath, channel) {
+    return {
+        code: "missing-required-channel",
+        path: `${layerPath}/aes/${channel}`,
+        message: `The ${geom} geom requires a "${channel}" channel; map it in the layer's aes or the plot-level aes.`,
+        fix: {
+            description: `Map "${channel}" to a data field.`,
+            example: { [channel]: CHANNEL_FIX_EXAMPLE },
+        },
+    };
+}
+//# sourceMappingURL=validate-structure-layers.js.map

package/dist/validate-structure-layers.js.map

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

package/dist/validate-structure-paint.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Structural validation for within-mark paint (#591): stop order and
+ * data-mapped fill/color conflicts. Schema already rejects empty stops,
+ * out-of-range offsets, non-hex colors, and excessive glow radii.
+ */
+import type { SpecError } from "./errors.js";
+import type { Aes } from "./schema.js";
+/**
+ * Paint structural checks for one layer (opt-in tier-2 via validate options).
+ */
+export declare function paintStructuralErrors(layer: Record<string, unknown>, layerPath: string, plotAes: Aes | undefined): SpecError[];
+//# sourceMappingURL=validate-structure-paint.d.ts.map

package/dist/validate-structure-paint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-structure-paint.d.ts","sourceRoot":"","sources":["../src/validate-structure-paint.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,GAAG,EAAgB,MAAM,aAAa,CAAC;AA6CrD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,GAAG,GAAG,SAAS,GACvB,SAAS,EAAE,CA0Cb"}

package/dist/validate-structure-paint.js

@@ -0,0 +1,87 @@
+import { effectiveChannel } from "./validate-data.js";
+function isRecord(v) {
+    return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function isDataMapped(channel) {
+    if (channel === undefined || channel === null)
+        return false;
+    if ("field" in channel)
+        return true;
+    if ("value" in channel && channel.scale === true)
+        return true;
+    return false;
+}
+function stopOrderErrors(paint, path) {
+    if (!isRecord(paint) || !Array.isArray(paint["stops"]))
+        return [];
+    const stops = paint["stops"];
+    let prev = -Infinity;
+    for (let i = 0; i < stops.length; i++) {
+        const stop = stops[i];
+        if (!isRecord(stop) || typeof stop["offset"] !== "number")
+            continue;
+        const offset = stop["offset"];
+        if (offset < prev) {
+            return [
+                {
+                    code: "paint-stops-unordered",
+                    path: `${path}/stops/${String(i)}/offset`,
+                    message: `Gradient stop offsets must be non-decreasing; stop ${String(i)} has offset ${String(offset)} after ${String(prev)}.`,
+                    fix: {
+                        description: "Sort stops by offset ascending (each between 0 and 1).",
+                        example: {
+                            stops: [
+                                { offset: 0, color: "#000000" },
+                                { offset: 1, color: "#ffffff" },
+                            ],
+                        },
+                    },
+                },
+            ];
+        }
+        prev = offset;
+    }
+    return [];
+}
+/**
+ * Paint structural checks for one layer (opt-in tier-2 via validate options).
+ */
+export function paintStructuralErrors(layer, layerPath, plotAes) {
+    const errors = [];
+    const params = isRecord(layer["params"]) ? layer["params"] : null;
+    if (params === null)
+        return errors;
+    const layerAes = isRecord(layer["aes"]) ? layer["aes"] : undefined;
+    const fill = effectiveChannel(plotAes, layerAes, "fill");
+    const color = effectiveChannel(plotAes, layerAes, "color");
+    if (params["fillPaint"] !== undefined) {
+        errors.push(...stopOrderErrors(params["fillPaint"], `${layerPath}/params/fillPaint`));
+        if (isDataMapped(fill)) {
+            errors.push({
+                code: "paint-scale-conflict",
+                path: `${layerPath}/params/fillPaint`,
+                message: "params.fillPaint cannot combine with a data-mapped fill channel (field or scaled constant).",
+                fix: {
+                    description: "Remove aes.fill field mapping, or remove fillPaint and keep the scale.",
+                    example: { params: { fillPaint: { type: "linear" } } },
+                },
+            });
+        }
+    }
+    if (params["strokePaint"] !== undefined) {
+        errors.push(...stopOrderErrors(params["strokePaint"], `${layerPath}/params/strokePaint`));
+        if (isDataMapped(color)) {
+            errors.push({
+                code: "paint-scale-conflict",
+                path: `${layerPath}/params/strokePaint`,
+                message: "params.strokePaint cannot combine with a data-mapped color channel (field or scaled constant).",
+                fix: {
+                    description: "Remove aes.color field mapping, or remove strokePaint and keep the scale.",
+                    example: { params: { strokePaint: { type: "linear" } } },
+                },
+            });
+        }
+    }
+    return errors;
+}
+//# sourceMappingURL=validate-structure-paint.js.map