@ggts-sh/spec 0.43.0

package/dist/error-prose-shared.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Shared summary/fix prose for diagnostic codes that both validation
+ * (ERROR_CATALOG) and the pipeline (PIPELINE_ERROR_CATALOG) can emit.
+ * One object per code — import into both catalogs so the strings cannot drift.
+ *
+ * #987: missing-channel vs missing-required-channel is intentionally NOT
+ * merged here (different public code strings; one rename per change).
+ */
+/** Prose body shared by dual-channel error codes. */
+export interface SharedErrorProse {
+    summary: string;
+    fix: string;
+}
+/**
+ * Dual-channel codes and their single prose source.
+ * Keep keys sorted; scripts/error-catalog-shared-prose.test.ts pins membership.
+ */
+export declare const DUAL_ERROR_PROSE: {
+    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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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 "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.";
+    };
+};
+//# sourceMappingURL=error-prose-shared.d.ts.map

package/dist/error-prose-shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-prose-shared.d.ts","sourceRoot":"","sources":["../src/error-prose-shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,qDAAqD;AACrD,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsFwB,CAAC"}

package/dist/error-prose-shared.js

@@ -0,0 +1,95 @@
+/**
+ * Shared summary/fix prose for diagnostic codes that both validation
+ * (ERROR_CATALOG) and the pipeline (PIPELINE_ERROR_CATALOG) can emit.
+ * One object per code — import into both catalogs so the strings cannot drift.
+ *
+ * #987: missing-channel vs missing-required-channel is intentionally NOT
+ * merged here (different public code strings; one rename per change).
+ */
+/**
+ * Dual-channel codes and their single prose source.
+ * Keep keys sorted; scripts/error-catalog-shared-prose.test.ts pins membership.
+ */
+export const DUAL_ERROR_PROSE = {
+    "all-null-column": {
+        summary: "A mapped column contains only null values.",
+        fix: "Map the channel to a column with actual values, or fix the data.",
+    },
+    "bin-center-and-boundary": {
+        summary: "A bin-stat layer sets BOTH params.center and params.boundary.",
+        fix: "Keep one bin-grid alignment parameter and remove the other.",
+    },
+    "channel-type-mismatch": {
+        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).",
+        fix: "Map a field of the type the geom/stat needs, or switch to a geom that fits the field (the message suggests one).",
+    },
+    "color-manual-domain-range": {
+        summary: "A manual color/fill scale has a different number of domain values and range colors.",
+        fix: "Provide exactly one range color for every domain value.",
+    },
+    "computed-y-mapped": {
+        summary: "A layer whose stat computes y (count, bin, density) maps aes.y to a data field.",
+        fix: 'Unset y with null — or, for pre-computed bar heights, switch the layer to geom "col".',
+    },
+    "coord-fixed-free-scales": {
+        summary: "Fixed-aspect coordinates cannot represent free positional facet scales truthfully.",
+        fix: 'Use facet.scales = "fixed", or remove coord_fixed / coord_sf.',
+    },
+    "facet-form-ambiguous": {
+        summary: "A facet sets BOTH the wrap form and the rows/cols grid form.",
+        fix: "Keep facet.wrap (and drop rows/cols), or keep rows/cols (and drop wrap).",
+    },
+    "facet-form-missing": {
+        summary: "A facet sets neither wrap nor rows/cols — nothing to partition by.",
+        fix: "Set facet.wrap (wrap form) or facet.rows/facet.cols (grid form).",
+    },
+    "guide-aesthetic-incompatible": {
+        summary: "A guide variant is incompatible with its aesthetic or trained scale family.",
+        fix: "Use axis for x/y, legend for discrete/style scales, colorbar for sequential color, or colorsteps for binned color.",
+    },
+    "manual-fun-required": {
+        summary: "A layer uses stat manual without params.fun.",
+        fix: "Set params.fun to one of first|last|mean|median|min|max|sum (portable named registry; #814).",
+    },
+    "summary-rolling-window-required": {
+        summary: "A layer uses stat summary_rolling without params.window.",
+        fix: "Set params.window to the rolling-window width in x data units (greater than 0).",
+    },
+    "summary-fun-unsupported": {
+        summary: "A summary stat uses params.fun first|last, which only stat manual implements.",
+        fix: "Use mean, median, or sum (min/max via funMin/funMax where supported); first|last belong to stat manual.",
+    },
+    "ribbon-orientation-ambiguous": {
+        summary: "A ribbon layer maps both x-orientation (x+ymin+ymax) and y-orientation (y+xmin+xmax) contracts without params.orientation.",
+        fix: 'Set params.orientation to "x" or "y", or map only one complete interval contract.',
+    },
+    "rule-both-axes": {
+        summary: "A data-driven rule layer maps BOTH aes.x and aes.y (pick one direction).",
+        fix: "Keep one direction (vertical: map x; horizontal: map y) and unset the other with null.",
+    },
+    "rule-form-ambiguous": {
+        summary: "A rule layer mixes the annotation form (params.xintercept/yintercept) with mapped aes.x/aes.y.",
+        fix: "Use fixed intercepts OR a data mapping, never both (unset the other with null).",
+    },
+    "rule-form-missing": {
+        summary: "A rule layer has neither intercept params nor a mapped aes.x/aes.y — nothing to draw.",
+        fix: "Set params.yintercept/xintercept (annotation) or map aes.x/aes.y (data-driven).",
+    },
+    "scale-type-transform-conflict": {
+        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).',
+        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.',
+    },
+    "unknown-field": {
+        summary: "A channel maps a field that does not exist in the data.",
+        fix: "Map the channel to one of the available fields (the error lists them, with a did-you-mean).",
+    },
+    "unknown-stat-column": {
+        summary: "A { stat } channel names a column the layer's stat does not generate.",
+        fix: "Use one of the columns the stat generates (the error lists them), or change the layer's stat.",
+    },
+    "unsupported-geom-aesthetic": {
+        summary: "A mapped style aesthetic is not consumed by the selected geom.",
+        fix: "Remove the mapping or move it to one of the compatible geoms listed in the error.",
+    },
+};
+//# sourceMappingURL=error-prose-shared.js.map

package/dist/error-prose-shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-prose-shared.js","sourceRoot":"","sources":["../src/error-prose-shared.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAQH;;;GAGG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,iBAAiB,EAAE;QACjB,OAAO,EAAE,4CAA4C;QACrD,GAAG,EAAE,kEAAkE;KACxE;IACD,yBAAyB,EAAE;QACzB,OAAO,EAAE,+DAA+D;QACxE,GAAG,EAAE,6DAA6D;KACnE;IACD,uBAAuB,EAAE;QACvB,OAAO,EACL,uIAAuI;QACzI,GAAG,EAAE,kHAAkH;KACxH;IACD,2BAA2B,EAAE;QAC3B,OAAO,EAAE,qFAAqF;QAC9F,GAAG,EAAE,yDAAyD;KAC/D;IACD,mBAAmB,EAAE;QACnB,OAAO,EAAE,iFAAiF;QAC1F,GAAG,EAAE,uFAAuF;KAC7F;IACD,yBAAyB,EAAE;QACzB,OAAO,EAAE,oFAAoF;QAC7F,GAAG,EAAE,+DAA+D;KACrE;IACD,sBAAsB,EAAE;QACtB,OAAO,EAAE,8DAA8D;QACvE,GAAG,EAAE,0EAA0E;KAChF;IACD,oBAAoB,EAAE;QACpB,OAAO,EAAE,oEAAoE;QAC7E,GAAG,EAAE,kEAAkE;KACxE;IACD,8BAA8B,EAAE;QAC9B,OAAO,EAAE,6EAA6E;QACtF,GAAG,EAAE,oHAAoH;KAC1H;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE,8CAA8C;QACvD,GAAG,EAAE,8FAA8F;KACpG;IACD,iCAAiC,EAAE;QACjC,OAAO,EAAE,0DAA0D;QACnE,GAAG,EAAE,iFAAiF;KACvF;IACD,yBAAyB,EAAE;QACzB,OAAO,EAAE,+EAA+E;QACxF,GAAG,EAAE,yGAAyG;KAC/G;IACD,8BAA8B,EAAE;QAC9B,OAAO,EACL,4HAA4H;QAC9H,GAAG,EAAE,mFAAmF;KACzF;IACD,gBAAgB,EAAE;QAChB,OAAO,EAAE,0EAA0E;QACnF,GAAG,EAAE,wFAAwF;KAC9F;IACD,qBAAqB,EAAE;QACrB,OAAO,EACL,gGAAgG;QAClG,GAAG,EAAE,iFAAiF;KACvF;IACD,mBAAmB,EAAE;QACnB,OAAO,EACL,uFAAuF;QACzF,GAAG,EAAE,iFAAiF;KACvF;IACD,+BAA+B,EAAE;QAC/B,OAAO,EACL,+KAA+K;QACjL,GAAG,EAAE,mLAAmL;KACzL;IACD,eAAe,EAAE;QACf,OAAO,EAAE,yDAAyD;QAClE,GAAG,EAAE,6FAA6F;KACnG;IACD,qBAAqB,EAAE;QACrB,OAAO,EAAE,uEAAuE;QAChF,GAAG,EAAE,+FAA+F;KACrG;IACD,4BAA4B,EAAE;QAC5B,OAAO,EAAE,gEAAgE;QACzE,GAAG,EAAE,mFAAmF;KACzF;CACkD,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Agent-facing error contract (plan: "Validation for agents") + helpers.
+ * Every validation diagnostic is a SpecError:
+ *
+ *   { code, path, message, allowed?, fix? }
+ *
+ * The stable ERROR_CATALOG lives in error-catalog.ts and is re-exported here
+ * so package and deep imports keep the ./errors.js path.
+ *
+ * "Did you mean" suggestions use a small Levenshtein distance so agents get a
+ * concrete correction for typo'd geoms/channels/params.
+ */
+import type { JSONValue } from "./portability.js";
+import type { SpecErrorCode } from "./error-catalog.js";
+export { ERROR_CATALOG, ERROR_CODES, type ErrorCatalogEntry, type SpecErrorCode, } from "./error-catalog.js";
+export interface SpecErrorFix {
+    description: string;
+    example?: JSONValue;
+}
+export interface SpecError {
+    code: SpecErrorCode;
+    path: string;
+    message: string;
+    allowed?: string[];
+    fix?: SpecErrorFix;
+}
+/** Thrown by builder .spec() / render entry points when validation fails. */
+export declare class SpecValidationError extends Error {
+    readonly errors: readonly SpecError[];
+    constructor(errors: readonly SpecError[]);
+}
+/** Classic dynamic-programming Levenshtein distance (small inputs only). */
+export declare function levenshtein(a: string, b: string): number;
+/**
+ * The closest candidate within an input-length-scaled distance budget
+ * (<= max(1, floor(len/3)) edits, case-insensitive), or undefined.
+ */
+export declare function didYouMean(input: string, candidates: readonly string[]): string | undefined;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,OAAO,EACL,aAAa,EACb,WAAW,EACX,KAAK,iBAAiB,EACtB,KAAK,aAAa,GACnB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,SAAS,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,aAAa,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,GAAG,CAAC,EAAE,YAAY,CAAC;CACpB;AAED,6EAA6E;AAC7E,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,SAAS,SAAS,EAAE,CAAC;gBAE1B,MAAM,EAAE,SAAS,SAAS,EAAE;CASzC;AAED,4EAA4E;AAC5E,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAiBxD;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAY3F"}

package/dist/errors.js

@@ -0,0 +1,52 @@
+export { ERROR_CATALOG, ERROR_CODES, } from "./error-catalog.js";
+/** Thrown by builder .spec() / render entry points when validation fails. */
+export class SpecValidationError extends Error {
+    errors;
+    constructor(errors) {
+        const lines = errors.map((e) => `  [${e.code}] ${e.path || "/"}: ${e.message}`);
+        super(`Invalid plot spec (${errors.length} error${errors.length === 1 ? "" : "s"}):\n` +
+            lines.join("\n"));
+        this.name = "SpecValidationError";
+        this.errors = errors;
+    }
+}
+/** Classic dynamic-programming Levenshtein distance (small inputs only). */
+export function levenshtein(a, b) {
+    if (a === b)
+        return 0;
+    const m = a.length;
+    const n = b.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    let prev = Array.from({ length: n + 1 }, (_, j) => j);
+    let curr = Array.from({ length: n + 1 }, () => 0);
+    for (let i = 1; i <= m; i++) {
+        curr[0] = i;
+        for (let j = 1; j <= n; j++) {
+            const cost = a[i - 1] === b[j - 1] ? 0 : 1;
+            curr[j] = Math.min(prev[j] + 1, curr[j - 1] + 1, prev[j - 1] + cost);
+        }
+        [prev, curr] = [curr, prev];
+    }
+    return prev[n];
+}
+/**
+ * The closest candidate within an input-length-scaled distance budget
+ * (<= max(1, floor(len/3)) edits, case-insensitive), or undefined.
+ */
+export function didYouMean(input, candidates) {
+    const budget = Math.max(1, Math.floor(input.length / 3));
+    let best;
+    let bestDist = budget + 1;
+    for (const candidate of candidates) {
+        const d = levenshtein(input.toLowerCase(), candidate.toLowerCase());
+        if (d < bestDist) {
+            bestDist = d;
+            best = candidate;
+        }
+    }
+    return best;
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/generated/coord-reference-data.d.ts

@@ -0,0 +1,189 @@
+/**
+ * AUTO-GENERATED by scripts/gen-reference-catalogs.ts — do not edit by hand.
+ * Regenerate: bun run reference:catalogs:gen
+ *
+ * COORD_REFERENCE — per-coord API docs.
+ */
+export declare const COORD_REFERENCE_DATA: {
+    readonly cartesian: {
+        readonly name: "cartesian";
+        readonly slug: "cartesian";
+        readonly component: "CoordCartesian";
+        readonly typeLiteral: "cartesian";
+        readonly schemaType: "CoordCartesianSpec";
+        readonly helper: "";
+        readonly helperAlias: "";
+        readonly alsoHelpers: readonly [];
+        readonly alsoExportedAs: readonly [];
+        readonly builderMethods: readonly ["coord"];
+        readonly summary: "Default Cartesian coordinates. Omit coord or use CoordCartesian to clear a prior REPLACE-family coord; normalize() drops bare { type: \"cartesian\" }.";
+        readonly params: readonly [];
+        readonly axisParams: readonly [];
+    };
+    readonly flip: {
+        readonly name: "flip";
+        readonly slug: "flip";
+        readonly component: "CoordFlip";
+        readonly typeLiteral: "flip";
+        readonly schemaType: "CoordCartesianSpec";
+        readonly helper: "";
+        readonly helperAlias: "";
+        readonly alsoHelpers: readonly [];
+        readonly alsoExportedAs: readonly [];
+        readonly builderMethods: readonly ["coordFlip", "coord"];
+        readonly summary: "Swap display axes so semantic x paints vertically and y horizontally. The mechanism for horizontal bar charts; stack, dodge, and hit-testing follow the flip.";
+        readonly params: readonly [];
+        readonly axisParams: readonly [];
+    };
+    readonly transform: {
+        readonly name: "transform";
+        readonly slug: "transform";
+        readonly component: "CoordTransform";
+        readonly typeLiteral: "transform";
+        readonly schemaType: "CoordTransformSpec";
+        readonly helper: "coordTransform";
+        readonly helperAlias: "coord_transform";
+        readonly alsoHelpers: readonly [];
+        readonly alsoExportedAs: readonly [];
+        readonly builderMethods: readonly ["coordTransform", "coord"];
+        readonly summary: "Post-stat coordinate projection with independent x/y transforms (identity, log10, sqrt), semantic viewport limits, reverse, and panel clipping. Distinct from pre-stat scale transforms.";
+        readonly params: readonly [{
+            readonly name: "x";
+            readonly description: "Optional x-axis projector: transform, semantic limits, reverse, and expand. Accepts a transform name string or an axis options object on the helper/shell.";
+            readonly typeSummary: "CoordTransformAxisSpec";
+            readonly required: false;
+        }, {
+            readonly name: "y";
+            readonly description: "Optional y-axis projector: transform, semantic limits, reverse, and expand. Accepts a transform name string or an axis options object on the helper/shell.";
+            readonly typeSummary: "CoordTransformAxisSpec";
+            readonly required: false;
+        }, {
+            readonly name: "clip";
+            readonly description: "Clip marks to the panel rectangle (default true). Set false only when intentional overflow should remain visible.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }];
+        readonly axisParams: readonly [{
+            readonly name: "transform";
+            readonly description: "Post-stat coordinate transform for this axis: identity, base-10 logarithm, or square root.";
+            readonly typeSummary: "\"identity\" | \"log10\" | \"sqrt\"";
+            readonly required: true;
+        }, {
+            readonly name: "limits";
+            readonly description: "Optional coordinate viewport [min, max] in semantic/source units. Exactly two numbers. Unlike scale limits, coordinate limits do not remove rows or recompute statistics.";
+            readonly typeSummary: "[number, number]";
+            readonly required: false;
+        }, {
+            readonly name: "reverse";
+            readonly description: "Reverse this coordinate axis after its transform without changing stat inputs or the trained semantic scale domain.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "expand";
+            readonly description: "Whether explicit coordinate limits receive the default 5% transformed-space display expansion (default true). Set false for exact viewport limits.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }];
+    };
+    readonly fixed: {
+        readonly name: "fixed";
+        readonly slug: "fixed";
+        readonly component: "CoordFixed";
+        readonly typeLiteral: "fixed";
+        readonly schemaType: "CoordFixedSpec";
+        readonly helper: "coordFixed";
+        readonly helperAlias: "coord_fixed";
+        readonly alsoHelpers: readonly ["coordEqual", "coord_equal"];
+        readonly alsoExportedAs: readonly ["CoordEqual"];
+        readonly builderMethods: readonly ["coordFixed", "coordEqual", "coord"];
+        readonly summary: "Fixed physical data-unit aspect ratio (y-unit length / x-unit length). Layout fits the largest centered data rectangle after chart chrome; rejects free positional facet scales.";
+        readonly params: readonly [{
+            readonly name: "ratio";
+            readonly description: "Physical y-unit length divided by physical x-unit length (default 1, equal units).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+        readonly axisParams: readonly [];
+    };
+    readonly sf: {
+        readonly name: "sf";
+        readonly slug: "sf";
+        readonly component: "CoordSf";
+        readonly typeLiteral: "sf";
+        readonly schemaType: "CoordSfSpec";
+        readonly helper: "coordSf";
+        readonly helperAlias: "coord_sf";
+        readonly alsoHelpers: readonly [];
+        readonly alsoExportedAs: readonly [];
+        readonly builderMethods: readonly ["coordSf", "coord"];
+        readonly summary: "Fixed-aspect coordinates for already-projected geom_sf maps. Same layout as fixed; no CRS reproject or graticules in v1 — data must already be in plot space.";
+        readonly params: readonly [{
+            readonly name: "ratio";
+            readonly description: "Physical y-unit length divided by physical x-unit length (default 1, equal projected units).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+        readonly axisParams: readonly [];
+    };
+    readonly radial: {
+        readonly name: "radial";
+        readonly slug: "radial";
+        readonly component: "CoordRadial";
+        readonly typeLiteral: "radial";
+        readonly schemaType: "CoordRadialSpec";
+        readonly helper: "coordRadial";
+        readonly helperAlias: "coord_radial";
+        readonly alsoHelpers: readonly ["coordPolar", "coord_polar"];
+        readonly alsoExportedAs: readonly [];
+        readonly builderMethods: readonly ["coordRadial", "coordPolar", "coord"];
+        readonly summary: "Polar/radial coordinates (ggplot2 coord_radial). Maps one aesthetic to angle and the other to radius for pie charts, coxcombs, and polar scatter. coord_polar is a helper alias with clip on.";
+        readonly params: readonly [{
+            readonly name: "theta";
+            readonly description: "Which aesthetic maps to angle: \"x\" (default) or \"y\". The other aesthetic maps to radius. Pie charts use theta: \"y\".";
+            readonly typeSummary: "\"x\" | \"y\"";
+            readonly required: false;
+        }, {
+            readonly name: "start";
+            readonly description: "Offset of the starting angle from 12 o'clock, in radians (default 0). Positive angles proceed clockwise when reverse does not flip theta.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "end";
+            readonly description: "Angle where the plot ends, in radians measured from 12 o'clock. Default is start + 2π (full circle). Use with start for partial polar plots.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "innerRadius";
+            readonly description: "Size of the inner radius hole as a fraction of the outer radius (0–1, default 0). Values above 0 produce a donut.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "expand";
+            readonly description: "When true (default), add a small expansion so data does not sit on the axes. When false, limits come directly from the scale (typical for pie/coxcomb).";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "clip";
+            readonly description: "Clip marks to the panel. ggplot2 coord_radial defaults to clip off; coord_polar defaults to clip on. ggts stores the effective boolean (default false for type \"radial\").";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "reverse";
+            readonly description: "Which directions to reverse: \"none\" (default), \"theta\", \"r\", or \"thetar\" (both). coord_polar(direction = -1) maps to reverse: \"theta\".";
+            readonly typeSummary: "\"none\" | \"theta\" | \"r\" | \"thetar\"";
+            readonly required: false;
+        }, {
+            readonly name: "thetaLimits";
+            readonly description: "Optional [min, max] limits for the theta (angle) aesthetic in semantic units. Exactly two numbers.";
+            readonly typeSummary: "[number, number]";
+            readonly required: false;
+        }, {
+            readonly name: "rLimits";
+            readonly description: "Optional [min, max] limits for the radius aesthetic in semantic units. Exactly two numbers.";
+            readonly typeSummary: "[number, number]";
+            readonly required: false;
+        }];
+        readonly axisParams: readonly [];
+    };
+};
+//# sourceMappingURL=coord-reference-data.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coord-reference-data.d.ts","sourceRoot":"","sources":["../../src/generated/coord-reference-data.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoOvB,CAAC"}