@ggts-sh/spec 0.43.0

package/dist/coord-reference.d.ts

@@ -0,0 +1,52 @@
+/** Portable coord type literals (CoordSpec discriminants + flip shell). */
+export declare const KNOWN_COORD_TYPES: readonly ["cartesian", "flip", "transform", "fixed", "sf", "radial"];
+export type CoordTypeName = (typeof KNOWN_COORD_TYPES)[number];
+export interface CoordParamDoc {
+    readonly name: string;
+    readonly description: string;
+    readonly typeSummary: string;
+    readonly required: boolean;
+}
+export interface CoordReferenceEntry {
+    readonly name: CoordTypeName;
+    /** Route slug — same as the portable type literal. */
+    readonly slug: string;
+    /** Svelte component export, e.g. CoordFixed. */
+    readonly component: string;
+    /** Portable `type` discriminant (same as name). */
+    readonly typeLiteral: CoordTypeName;
+    /** SpecDeclarations key for the coord options object. */
+    readonly schemaType: string;
+    /**
+     * Free-standing helper (e.g. coordFixed). Empty when only the Svelte shell
+     * and/or builder method exist (cartesian, flip).
+     */
+    readonly helper: string;
+    /** ggplot2-style snake_case alias (e.g. coord_fixed). Empty with helper. */
+    readonly helperAlias: string;
+    /** Extra free-standing helpers that produce the same JSON (coordEqual). */
+    readonly alsoHelpers: readonly string[];
+    /** Svelte re-export aliases of the shell (CoordEqual). */
+    readonly alsoExportedAs: readonly string[];
+    /** Builder methods that set this coord (e.g. coordFlip, coordFixed). */
+    readonly builderMethods: readonly string[];
+    /** Short purpose text for index + detail lede. */
+    readonly summary: string;
+    /**
+     * Options on the Svelte shell / JSON coord object, excluding the fixed
+     * `type` discriminant.
+     */
+    readonly params: readonly CoordParamDoc[];
+    /**
+     * Shared axis options for coord_transform x/y. Empty for other types.
+     */
+    readonly axisParams: readonly CoordParamDoc[];
+}
+/**
+ * Complete per-coord API reference. Keys are exactly KNOWN_COORD_TYPES.
+ * Precomputed at gen time.
+ */
+export declare const COORD_REFERENCE: Readonly<Record<CoordTypeName, CoordReferenceEntry>>;
+/** Stable list order matching KNOWN_COORD_TYPES (docs index, search, inventory). */
+export declare function coordReferenceList(): readonly CoordReferenceEntry[];
+//# sourceMappingURL=coord-reference.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coord-reference.d.ts","sourceRoot":"","sources":["../src/coord-reference.ts"],"names":[],"mappings":"AASA,2EAA2E;AAC3E,eAAO,MAAM,iBAAiB,sEAOpB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE/D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,gDAAgD;IAChD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,mDAAmD;IACnD,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,yDAAyD;IACzD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,2EAA2E;IAC3E,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,0DAA0D;IAC1D,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,wEAAwE;IACxE,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,kDAAkD;IAClD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;IAC1C;;OAEG;IACH,QAAQ,CAAC,UAAU,EAAE,SAAS,aAAa,EAAE,CAAC;CAC/C;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,aAAa,EAAE,mBAAmB,CAAC,CAC3D,CAAC;AAEvB,oFAAoF;AACpF,wBAAgB,kBAAkB,IAAI,SAAS,mBAAmB,EAAE,CAEnE"}

package/dist/coord-reference.js

@@ -0,0 +1,27 @@
+/**
+ * COORD_REFERENCE — per-coord API docs for the docs site.
+ *
+ * Catalog data is precomputed from SpecDeclarations
+ * (`scripts/gen-reference-catalogs.ts`) so reference pages never load TypeBox.
+ * Coord shells under packages/svelte/src/lib/coord/ are declaration-only.
+ */
+import { COORD_REFERENCE_DATA } from "./generated/coord-reference-data.js";
+/** Portable coord type literals (CoordSpec discriminants + flip shell). */
+export const KNOWN_COORD_TYPES = [
+    "cartesian",
+    "flip",
+    "transform",
+    "fixed",
+    "sf",
+    "radial",
+];
+/**
+ * Complete per-coord API reference. Keys are exactly KNOWN_COORD_TYPES.
+ * Precomputed at gen time.
+ */
+export const COORD_REFERENCE = COORD_REFERENCE_DATA;
+/** Stable list order matching KNOWN_COORD_TYPES (docs index, search, inventory). */
+export function coordReferenceList() {
+    return KNOWN_COORD_TYPES.map((name) => COORD_REFERENCE[name]);
+}
+//# sourceMappingURL=coord-reference.js.map

package/dist/coord-reference.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coord-reference.js","sourceRoot":"","sources":["../src/coord-reference.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAE3E,2EAA2E;AAC3E,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW;IACX,MAAM;IACN,WAAW;IACX,OAAO;IACP,IAAI;IACJ,QAAQ;CACA,CAAC;AA+CX;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAC1B,oBAAoB,CAAC;AAEvB,oFAAoF;AACpF,MAAM,UAAU,kBAAkB;IAChC,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AAChE,CAAC"}

package/dist/error-catalog.d.ts

@@ -0,0 +1,258 @@
+/**
+ * Validation error catalog — stable codes for agent diagnostics and docs.
+ * Dual-channel codes (also emitable by the pipeline) pull summary/fix from
+ * error-prose-shared.ts (#987). SpecError instance types and didYouMean live
+ * in errors.ts. Pipeline-only codes live in pipeline-error-catalog.ts.
+ */
+/** One entry of the validation error catalog (docs render straight from it). */
+export interface ErrorCatalogEntry {
+    /** 1 = schema shape / structural (no data needed); 2 = data-aware (opt-in). */
+    tier: 1 | 2;
+    /** What went wrong, in one sentence. */
+    summary: string;
+    /** How to fix it, prescriptively (instances carry a concrete fix.example). */
+    fix: string;
+}
+/**
+ * The stable catalog of validation error codes — THE single source for the
+ * docs error-reference page and llms-full.txt for validation. Dual-channel
+ * prose is shared with PIPELINE_ERROR_CATALOG via DUAL_ERROR_PROSE.
+ * Audited M3: every code has a prescriptive summary + fix; a coverage test
+ * asserts every code is exercised by a snapshot test.
+ */
+export declare const ERROR_CATALOG: {
+    readonly "invalid-spec-root": {
+        readonly tier: 1;
+        readonly summary: "The spec is not a JSON object.";
+        readonly fix: "Provide an object with at least one layer: {\"layers\": [{\"geom\": \"point\", ...}]}.";
+    };
+    readonly "missing-layers": {
+        readonly tier: 1;
+        readonly summary: "`layers` is missing or not an array.";
+        readonly fix: "Add a layers array with at least one layer object.";
+    };
+    readonly "empty-layers": {
+        readonly tier: 1;
+        readonly summary: "`layers` is present but empty (a plot needs at least one layer).";
+        readonly fix: "Add a layer, e.g. {\"geom\": \"point\"}.";
+    };
+    readonly "invalid-layer": {
+        readonly tier: 1;
+        readonly summary: "A layer is not an object.";
+        readonly fix: "Replace the entry with a layer object carrying a \"geom\".";
+    };
+    readonly "missing-geom": {
+        readonly tier: 1;
+        readonly summary: "A layer has no \"geom\" discriminator.";
+        readonly fix: "Add a geom name to the layer, e.g. {\"geom\": \"point\"}.";
+    };
+    readonly "unknown-geom": {
+        readonly tier: 1;
+        readonly summary: "A layer's \"geom\" is not a known geom name.";
+        readonly fix: "Use one of the allowed geoms (the error lists them, with a did-you-mean).";
+    };
+    readonly "invalid-channel-value": {
+        readonly tier: 1;
+        readonly summary: "A channel value is not one of the canonical forms {field}/{value}/{stat}/null (bare strings are builder-only shorthand).";
+        readonly fix: "Wrap field mappings as {\"field\": \"column_name\"} and constants as {\"value\": ...}.";
+    };
+    readonly "unexpected-property": {
+        readonly tier: 1;
+        readonly summary: "An object carries a property the schema does not allow.";
+        readonly fix: "Remove or rename the property (the error suggests the closest allowed name).";
+    };
+    readonly "missing-property": {
+        readonly tier: 1;
+        readonly summary: "A required property is missing.";
+        readonly fix: "Add the named property.";
+    };
+    readonly "invalid-enum-value": {
+        readonly tier: 1;
+        readonly summary: "A value is outside its declared enum/literal set.";
+        readonly fix: "Use one of the allowed values (the error lists them, with a did-you-mean).";
+    };
+    readonly "value-out-of-range": {
+        readonly tier: 1;
+        readonly summary: "A numeric value is outside its declared bounds.";
+        readonly fix: "Set the value inside the bounds stated by the error message.";
+    };
+    readonly "invalid-data": {
+        readonly tier: 1;
+        readonly summary: "`data` (or a dataset entry) matches none of the data forms.";
+        readonly fix: "Use {\"values\": [...rows]}, {\"columns\": {...arrays}}, or {\"name\": \"dataset\"}.";
+    };
+    readonly "invalid-type": {
+        readonly tier: 1;
+        readonly summary: "Fallback: a value has the wrong JSON type.";
+        readonly fix: "Give the property the JSON type the message names.";
+    };
+    readonly "scale-scheme-type": {
+        readonly tier: 1;
+        readonly summary: "A named color scheme is incompatible with the configured color scale type.";
+        readonly fix: "Use a categorical scheme with \"ordinal\" (or a sequential-family scheme like \"viridis\" for discrete viridis), or \"viridis\"/hex stops with \"sequential\". Cyclic *O schemes are sequential only.";
+    };
+    readonly "scale-scheme-oob": {
+        readonly tier: 1;
+        readonly summary: "The out-of-bounds policy is incompatible with the named color scheme or scale type.";
+        readonly fix: "Use oob \"wrap\" with a cyclic *O scheme. Do not set wrap on a binned color scale.";
+    };
+    readonly "scale-cyclic-domain": {
+        readonly tier: 1;
+        readonly summary: "A cyclic color scheme is missing the explicit two-value domain period.";
+        readonly fix: "Set domain to one period, for example [0, 360] for angles in degrees.";
+    };
+    readonly "scale-range-color": {
+        readonly tier: 1;
+        readonly summary: "A custom color range contains a color outside the supported hex syntax.";
+        readonly fix: "Replace each custom color with #rgb or #rrggbb syntax.";
+    };
+    readonly "scale-type-transform-conflict": {
+        readonly summary: "A scale declares an incompatible type/family with its transform (temporal/discrete/manual/identity with a non-identity transform, or type: \"log\" with a non-log10 transform).";
+        readonly fix: "Use identity for temporal/discrete/manual/identity scales; for base-10 log use type: \"linear\" with transform: \"log10\"; or choose a quantitative family that admits the transform.";
+        readonly tier: 1;
+    };
+    readonly "color-manual-domain-range": {
+        readonly summary: "A manual color/fill scale has a different number of domain values and range colors.";
+        readonly fix: "Provide exactly one range color for every domain value.";
+        readonly tier: 1;
+    };
+    readonly "scale-binned-breaks": {
+        readonly tier: 1;
+        readonly summary: "A binned style scale's authored breaks are missing, non-finite after parsing, duplicated, or not strictly increasing.";
+        readonly fix: "Provide 2+ strictly increasing boundaries (numeric, or temporal strings that parse under the scale's parser).";
+    };
+    readonly "scale-binned-domain": {
+        readonly tier: 1;
+        readonly summary: "A binned style scale's explicit domain does not match the first and last authored breaks.";
+        readonly fix: "Set domain to the first and last break values, or omit domain and let breaks define it.";
+    };
+    readonly "guide-aesthetic-incompatible": {
+        readonly summary: "A guide variant is incompatible with its aesthetic or trained scale family.";
+        readonly fix: "Use axis for x/y, legend for discrete/style scales, colorbar for sequential color, or colorsteps for binned color.";
+        readonly tier: 1;
+    };
+    readonly "coord-fixed-free-scales": {
+        readonly summary: "Fixed-aspect coordinates cannot represent free positional facet scales truthfully.";
+        readonly fix: "Use facet.scales = \"fixed\", or remove coord_fixed / coord_sf.";
+        readonly tier: 1;
+    };
+    readonly "missing-required-channel": {
+        readonly tier: 2;
+        readonly summary: "A geom is missing a required aesthetic channel (x, y, label, ...).";
+        readonly fix: "Map the named channel to a data field in the layer's aes or the plot-level aes.";
+    };
+    readonly "rule-form-ambiguous": {
+        readonly summary: "A rule layer mixes the annotation form (params.xintercept/yintercept) with mapped aes.x/aes.y.";
+        readonly fix: "Use fixed intercepts OR a data mapping, never both (unset the other with null).";
+        readonly tier: 2;
+    };
+    readonly "rule-form-missing": {
+        readonly summary: "A rule layer has neither intercept params nor a mapped aes.x/aes.y — nothing to draw.";
+        readonly fix: "Set params.yintercept/xintercept (annotation) or map aes.x/aes.y (data-driven).";
+        readonly tier: 2;
+    };
+    readonly "rule-both-axes": {
+        readonly summary: "A data-driven rule layer maps BOTH aes.x and aes.y (pick one direction).";
+        readonly fix: "Keep one direction (vertical: map x; horizontal: map y) and unset the other with null.";
+        readonly tier: 2;
+    };
+    readonly "computed-y-mapped": {
+        readonly summary: "A layer whose stat computes y (count, bin, density) maps aes.y to a data field.";
+        readonly fix: "Unset y with null — or, for pre-computed bar heights, switch the layer to geom \"col\".";
+        readonly tier: 2;
+    };
+    readonly "bin-center-and-boundary": {
+        readonly summary: "A bin-stat layer sets BOTH params.center and params.boundary.";
+        readonly fix: "Keep one bin-grid alignment parameter and remove the other.";
+        readonly tier: 2;
+    };
+    readonly "facet-form-ambiguous": {
+        readonly summary: "A facet sets BOTH the wrap form and the rows/cols grid form.";
+        readonly fix: "Keep facet.wrap (and drop rows/cols), or keep rows/cols (and drop wrap).";
+        readonly tier: 2;
+    };
+    readonly "facet-form-missing": {
+        readonly summary: "A facet sets neither wrap nor rows/cols — nothing to partition by.";
+        readonly fix: "Set facet.wrap (wrap form) or facet.rows/facet.cols (grid form).";
+        readonly tier: 2;
+    };
+    readonly "facet-ncol-without-wrap": {
+        readonly tier: 2;
+        readonly summary: "facet.ncol only applies to the wrap form.";
+        readonly fix: "Remove ncol, or switch to the wrap form.";
+    };
+    readonly "unsupported-geom-aesthetic": {
+        readonly summary: "A mapped style aesthetic is not consumed by the selected geom.";
+        readonly fix: "Remove the mapping or move it to one of the compatible geoms listed in the error.";
+        readonly tier: 2;
+    };
+    readonly "ribbon-orientation-ambiguous": {
+        readonly summary: "A ribbon layer maps both x-orientation (x+ymin+ymax) and y-orientation (y+xmin+xmax) contracts without params.orientation.";
+        readonly fix: "Set params.orientation to \"x\" or \"y\", or map only one complete interval contract.";
+        readonly tier: 2;
+    };
+    readonly "paint-stops-unordered": {
+        readonly tier: 2;
+        readonly summary: "A gradient paint's color stops are not in non-decreasing offset order.";
+        readonly fix: "Sort stops by offset ascending (each offset between 0 and 1 inclusive).";
+    };
+    readonly "paint-scale-conflict": {
+        readonly tier: 2;
+        readonly summary: "Within-mark fillPaint/strokePaint cannot combine with a data-mapped fill/color scale channel.";
+        readonly fix: "Remove the data-mapped fill/color aesthetic, or remove the paint and keep the scale.";
+    };
+    readonly "unknown-field": {
+        readonly summary: "A channel maps a field that does not exist in the data.";
+        readonly fix: "Map the channel to one of the available fields (the error lists them, with a did-you-mean).";
+        readonly tier: 2;
+    };
+    readonly "all-null-column": {
+        readonly summary: "A mapped column contains only null values.";
+        readonly fix: "Map the channel to a column with actual values, or fix the data.";
+        readonly tier: 2;
+    };
+    readonly "scale-type-mismatch": {
+        readonly tier: 2;
+        readonly summary: "A configured scale type is incompatible with the mapped field's type.";
+        readonly fix: "Change the scale type to match the field (band for categories, time for temporal), or map a compatible field.";
+    };
+    readonly "channel-type-mismatch": {
+        readonly summary: "A mapped field's type is incompatible with the layer's geom/stat (e.g. a nominal x on smooth/bin/density, a continuous x on boxplot).";
+        readonly fix: "Map a field of the type the geom/stat needs, or switch to a geom that fits the field (the message suggests one).";
+        readonly tier: 2;
+    };
+    readonly "unknown-stat-column": {
+        readonly summary: "A { stat } channel names a column the layer's stat does not generate.";
+        readonly fix: "Use one of the columns the stat generates (the error lists them), or change the layer's stat.";
+        readonly tier: 2;
+    };
+    readonly "manual-fun-required": {
+        readonly summary: "A layer uses stat manual without params.fun.";
+        readonly fix: "Set params.fun to one of first|last|mean|median|min|max|sum (portable named registry; #814).";
+        readonly tier: 2;
+    };
+    readonly "summary-rolling-window-required": {
+        readonly summary: "A layer uses stat summary_rolling without params.window.";
+        readonly fix: "Set params.window to the rolling-window width in x data units (greater than 0).";
+        readonly tier: 2;
+    };
+    readonly "summary-fun-unsupported": {
+        readonly summary: "A summary stat uses params.fun first|last, which only stat manual implements.";
+        readonly fix: "Use mean, median, or sum (min/max via funMin/funMax where supported); first|last belong to stat manual.";
+        readonly tier: 2;
+    };
+    readonly "invalid-data-profile": {
+        readonly tier: 2;
+        readonly summary: "The provided DataProfile is malformed.";
+        readonly fix: "Provide { fields: [{ name, type: \"quantitative\"|\"temporal\"|\"ordinal\"|\"nominal\" }], rowCount? }.";
+    };
+    readonly "validation-limit": {
+        readonly tier: 2;
+        readonly summary: "Validation input exceeded a documented limit (rows/bytes/depth/diagnostics).";
+        readonly fix: "Validate with a DataProfile instead of huge inline data, or raise the limit via options.limits.";
+    };
+};
+export type SpecErrorCode = keyof typeof ERROR_CATALOG;
+/** The stable list of validation error codes (keys of ERROR_CATALOG). */
+export declare const ERROR_CODES: readonly SpecErrorCode[];
+//# sourceMappingURL=error-catalog.d.ts.map

package/dist/error-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-catalog.d.ts","sourceRoot":"","sources":["../src/error-catalog.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,gFAAgF;AAChF,MAAM,WAAW,iBAAiB;IAChC,+EAA+E;IAC/E,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;IACZ,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAC;IAChB,8EAA8E;IAC9E,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA6N4B,CAAC;AAEvD,MAAM,MAAM,aAAa,GAAG,MAAM,OAAO,aAAa,CAAC;AAEvD,yEAAyE;AACzE,eAAO,MAAM,WAAW,EAAiC,SAAS,aAAa,EAAE,CAAC"}

package/dist/error-catalog.js

@@ -0,0 +1,235 @@
+/**
+ * Validation error catalog — stable codes for agent diagnostics and docs.
+ * Dual-channel codes (also emitable by the pipeline) pull summary/fix from
+ * error-prose-shared.ts (#987). SpecError instance types and didYouMean live
+ * in errors.ts. Pipeline-only codes live in pipeline-error-catalog.ts.
+ */
+import { DUAL_ERROR_PROSE } from "./error-prose-shared.js";
+/**
+ * The stable catalog of validation error codes — THE single source for the
+ * docs error-reference page and llms-full.txt for validation. Dual-channel
+ * prose is shared with PIPELINE_ERROR_CATALOG via DUAL_ERROR_PROSE.
+ * Audited M3: every code has a prescriptive summary + fix; a coverage test
+ * asserts every code is exercised by a snapshot test.
+ */
+export const ERROR_CATALOG = {
+    // --- tier 1 (schema shape, no data needed) -------------------------------
+    "invalid-spec-root": {
+        tier: 1,
+        summary: "The spec is not a JSON object.",
+        fix: 'Provide an object with at least one layer: {"layers": [{"geom": "point", ...}]}.',
+    },
+    "missing-layers": {
+        tier: 1,
+        summary: "`layers` is missing or not an array.",
+        fix: "Add a layers array with at least one layer object.",
+    },
+    "empty-layers": {
+        tier: 1,
+        summary: "`layers` is present but empty (a plot needs at least one layer).",
+        fix: 'Add a layer, e.g. {"geom": "point"}.',
+    },
+    "invalid-layer": {
+        tier: 1,
+        summary: "A layer is not an object.",
+        fix: 'Replace the entry with a layer object carrying a "geom".',
+    },
+    "missing-geom": {
+        tier: 1,
+        summary: 'A layer has no "geom" discriminator.',
+        fix: 'Add a geom name to the layer, e.g. {"geom": "point"}.',
+    },
+    "unknown-geom": {
+        tier: 1,
+        summary: 'A layer\'s "geom" is not a known geom name.',
+        fix: "Use one of the allowed geoms (the error lists them, with a did-you-mean).",
+    },
+    "invalid-channel-value": {
+        tier: 1,
+        summary: "A channel value is not one of the canonical forms {field}/{value}/{stat}/null (bare strings are builder-only shorthand).",
+        fix: 'Wrap field mappings as {"field": "column_name"} and constants as {"value": ...}.',
+    },
+    "unexpected-property": {
+        tier: 1,
+        summary: "An object carries a property the schema does not allow.",
+        fix: "Remove or rename the property (the error suggests the closest allowed name).",
+    },
+    "missing-property": {
+        tier: 1,
+        summary: "A required property is missing.",
+        fix: "Add the named property.",
+    },
+    "invalid-enum-value": {
+        tier: 1,
+        summary: "A value is outside its declared enum/literal set.",
+        fix: "Use one of the allowed values (the error lists them, with a did-you-mean).",
+    },
+    "value-out-of-range": {
+        tier: 1,
+        summary: "A numeric value is outside its declared bounds.",
+        fix: "Set the value inside the bounds stated by the error message.",
+    },
+    "invalid-data": {
+        tier: 1,
+        summary: "`data` (or a dataset entry) matches none of the data forms.",
+        fix: 'Use {"values": [...rows]}, {"columns": {...arrays}}, or {"name": "dataset"}.',
+    },
+    "invalid-type": {
+        tier: 1,
+        summary: "Fallback: a value has the wrong JSON type.",
+        fix: "Give the property the JSON type the message names.",
+    },
+    "scale-scheme-type": {
+        tier: 1,
+        summary: "A named color scheme is incompatible with the configured color scale type.",
+        fix: 'Use a categorical scheme with "ordinal" (or a sequential-family scheme like "viridis" for discrete viridis), or "viridis"/hex stops with "sequential". Cyclic *O schemes are sequential only.',
+    },
+    "scale-scheme-oob": {
+        tier: 1,
+        summary: "The out-of-bounds policy is incompatible with the named color scheme or scale type.",
+        fix: 'Use oob "wrap" with a cyclic *O scheme. Do not set wrap on a binned color scale.',
+    },
+    "scale-cyclic-domain": {
+        tier: 1,
+        summary: "A cyclic color scheme is missing the explicit two-value domain period.",
+        fix: "Set domain to one period, for example [0, 360] for angles in degrees.",
+    },
+    "scale-range-color": {
+        tier: 1,
+        summary: "A custom color range contains a color outside the supported hex syntax.",
+        fix: "Replace each custom color with #rgb or #rrggbb syntax.",
+    },
+    "scale-type-transform-conflict": {
+        tier: 1,
+        ...DUAL_ERROR_PROSE["scale-type-transform-conflict"],
+    },
+    "color-manual-domain-range": {
+        tier: 1,
+        ...DUAL_ERROR_PROSE["color-manual-domain-range"],
+    },
+    "scale-binned-breaks": {
+        tier: 1,
+        summary: "A binned style scale's authored breaks are missing, non-finite after parsing, duplicated, or not strictly increasing.",
+        fix: "Provide 2+ strictly increasing boundaries (numeric, or temporal strings that parse under the scale's parser).",
+    },
+    "scale-binned-domain": {
+        tier: 1,
+        summary: "A binned style scale's explicit domain does not match the first and last authored breaks.",
+        fix: "Set domain to the first and last break values, or omit domain and let breaks define it.",
+    },
+    "guide-aesthetic-incompatible": {
+        tier: 1,
+        ...DUAL_ERROR_PROSE["guide-aesthetic-incompatible"],
+    },
+    "coord-fixed-free-scales": {
+        tier: 1,
+        ...DUAL_ERROR_PROSE["coord-fixed-free-scales"],
+    },
+    // --- tier 1 structural (grammar rules the schema alone cannot express) ---
+    "missing-required-channel": {
+        tier: 2,
+        summary: "A geom is missing a required aesthetic channel (x, y, label, ...).",
+        fix: "Map the named channel to a data field in the layer's aes or the plot-level aes.",
+    },
+    "rule-form-ambiguous": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["rule-form-ambiguous"],
+    },
+    "rule-form-missing": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["rule-form-missing"],
+    },
+    "rule-both-axes": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["rule-both-axes"],
+    },
+    "computed-y-mapped": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["computed-y-mapped"],
+    },
+    "bin-center-and-boundary": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["bin-center-and-boundary"],
+    },
+    "facet-form-ambiguous": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["facet-form-ambiguous"],
+    },
+    "facet-form-missing": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["facet-form-missing"],
+    },
+    "facet-ncol-without-wrap": {
+        tier: 2,
+        summary: "facet.ncol only applies to the wrap form.",
+        fix: "Remove ncol, or switch to the wrap form.",
+    },
+    "unsupported-geom-aesthetic": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["unsupported-geom-aesthetic"],
+    },
+    "ribbon-orientation-ambiguous": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["ribbon-orientation-ambiguous"],
+    },
+    "paint-stops-unordered": {
+        tier: 2,
+        summary: "A gradient paint's color stops are not in non-decreasing offset order.",
+        fix: "Sort stops by offset ascending (each offset between 0 and 1 inclusive).",
+    },
+    "paint-scale-conflict": {
+        tier: 2,
+        summary: "Within-mark fillPaint/strokePaint cannot combine with a data-mapped fill/color scale channel.",
+        fix: "Remove the data-mapped fill/color aesthetic, or remove the paint and keep the scale.",
+    },
+    // --- tier 2 (data-aware; needs inline data or a DataProfile) -------------
+    "unknown-field": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["unknown-field"],
+    },
+    "all-null-column": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["all-null-column"],
+    },
+    "scale-type-mismatch": {
+        tier: 2,
+        summary: "A configured scale type is incompatible with the mapped field's type.",
+        fix: "Change the scale type to match the field (band for categories, time for temporal), or map a compatible field.",
+    },
+    "channel-type-mismatch": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["channel-type-mismatch"],
+    },
+    "unknown-stat-column": {
+        tier: 2,
+        ...DUAL_ERROR_PROSE["unknown-stat-column"],
+    },
+    "manual-fun-required": {
+        // Structural grammar (layerStructuralErrors) — opt-in tier-2 only; not plain validate().
+        tier: 2,
+        ...DUAL_ERROR_PROSE["manual-fun-required"],
+    },
+    "summary-rolling-window-required": {
+        // Structural grammar (layerStructuralErrors) — opt-in tier-2 only; not plain validate().
+        tier: 2,
+        ...DUAL_ERROR_PROSE["summary-rolling-window-required"],
+    },
+    "summary-fun-unsupported": {
+        // Structural grammar (layerStructuralErrors) — opt-in tier-2 only; not plain validate().
+        tier: 2,
+        ...DUAL_ERROR_PROSE["summary-fun-unsupported"],
+    },
+    "invalid-data-profile": {
+        tier: 2,
+        summary: "The provided DataProfile is malformed.",
+        fix: 'Provide { fields: [{ name, type: "quantitative"|"temporal"|"ordinal"|"nominal" }], rowCount? }.',
+    },
+    "validation-limit": {
+        tier: 2,
+        summary: "Validation input exceeded a documented limit (rows/bytes/depth/diagnostics).",
+        fix: "Validate with a DataProfile instead of huge inline data, or raise the limit via options.limits.",
+    },
+};
+/** The stable list of validation error codes (keys of ERROR_CATALOG). */
+export const ERROR_CODES = Object.keys(ERROR_CATALOG);
+//# sourceMappingURL=error-catalog.js.map

package/dist/error-catalog.js.map

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