@ggts-sh/spec 0.43.0

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

@@ -0,0 +1,2377 @@
+/**
+ * AUTO-GENERATED by scripts/gen-reference-catalogs.ts — do not edit by hand.
+ * Regenerate: bun run reference:catalogs:gen
+ *
+ * GEOM_REFERENCE — per-geom API docs from SpecDeclarations.
+ */
+export declare const GEOM_REFERENCE_DATA: {
+    readonly point: {
+        readonly name: "point";
+        readonly slug: "point";
+        readonly component: "GeomPoint";
+        readonly summary: "Point geometry: one mark per data row. Use for scatter plots, dot plots, bubbles, and correlation views.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique", "summary_bin", "summary_rolling", "manual", "sum"];
+        readonly allowedPositions: readonly ["identity", "jitter", "nudge"];
+        readonly paramsType: "PointParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Point radius in px. Must be greater than 0. Default 2.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "shape";
+            readonly description: "Point shape. One of \"circle\", \"triangle\", \"square\", \"diamond\", \"plus\", \"cross\", \"circle-open\". Default \"circle\".";
+            readonly typeSummary: "\"circle\" | \"triangle\" | \"square\" | \"diamond\" | \"plus\" | \"cross\" | \"circle-open\"";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: \"right\" (default) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }, {
+            readonly name: "window";
+            readonly description: "STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is \"summary_rolling\".";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "SUMMARY_BIN / SUMMARY_ROLLING center fun (mean/median/sum;) or MANUAL named transform (first|last|mean|median|min|max|sum;). Required when stat is \"manual\".";
+            readonly typeSummary: "\"first\" | \"last\" | \"mean\" | \"median\" | \"min\" | \"max\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }];
+    };
+    readonly line: {
+        readonly name: "line";
+        readonly slug: "line";
+        readonly component: "GeomLine";
+        readonly summary: "Line geometry: connects points in x order, one line per group (groups derive from discrete aesthetics such as color, or from aes.group). Use for time series, trends, and line charts. With stat ecdf, pair with step curves; with stat bin (freqpoly alias), y is computed from counts/density; with stat connect, successive points expand into connection vertices.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique", "bin", "align", "connect", "summary_bin", "summary_rolling", "manual", "ecdf"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "LineParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "curve";
+            readonly description: "Interpolation: \"linear\" (default), \"step\" (mid-x corners), \"step-hv\" (horizontal then vertical — correct for ECDF), or \"step-vh\".";
+            readonly typeSummary: "\"linear\" | \"step\" | \"step-hv\" | \"step-vh\"";
+            readonly required: false;
+        }, {
+            readonly name: "pad";
+            readonly description: "With stat ecdf: when true (default), prepend (xmin, 0) so step stairs start at zero. Finite-clamped.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "n";
+            readonly description: "With stat ecdf: evaluate on n equally spaced x in [min, max] per group; omit for one point per unique x.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "connection";
+            readonly description: "STAT CONNECT ONLY: how successive points join — \"hv\" (default), \"vh\", \"mid\", or \"linear\". Ignored for other stats.";
+            readonly typeSummary: "\"hv\" | \"vh\" | \"mid\" | \"linear\"";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT BIN / SUMMARY_BIN: number of bins (integer ≥ 1). Default 30 — an advisory reminds you to pick a real value. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT BIN / SUMMARY_BIN: bin width in data units (must be greater than 0). Takes precedence over bins.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT BIN / SUMMARY_BIN: align a bin EDGE with this x value. Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT BIN / SUMMARY_BIN: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT BIN / SUMMARY_BIN: which edge of each bin is inclusive: \"right\" (default) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }, {
+            readonly name: "window";
+            readonly description: "STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is \"summary_rolling\".";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "SUMMARY_BIN / SUMMARY_ROLLING center fun (mean/median/sum;) or MANUAL named transform (first|last|mean|median|min|max|sum;). Required when stat is \"manual\".";
+            readonly typeSummary: "\"first\" | \"last\" | \"mean\" | \"median\" | \"min\" | \"max\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly path: {
+        readonly name: "path";
+        readonly slug: "path";
+        readonly component: "GeomPath";
+        readonly summary: "Path geometry: connects points in data (row) order within each group — unlike line, which sorts by x. Use for trajectories, loops, connected scatterplots, and ellipse rings (stat ellipse). With stat connect, successive points expand into connection vertices.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique", "connect", "manual", "ellipse"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "PathParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Path opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "curve";
+            readonly description: "Interpolation between points: \"linear\" (straight segments, default) or \"step\" (horizontal-then-vertical steps).";
+            readonly typeSummary: "\"linear\" | \"step\"";
+            readonly required: false;
+        }, {
+            readonly name: "connection";
+            readonly description: "STAT CONNECT ONLY: how successive points join — \"hv\" (default), \"vh\", \"mid\", or \"linear\". Ignored for other stats.";
+            readonly typeSummary: "\"hv\" | \"vh\" | \"mid\" | \"linear\"";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "STAT MANUAL ONLY: portable named transform (first|last|mean|median|min|max|sum). Required when stat is \"manual\".";
+            readonly typeSummary: "\"first\" | \"last\" | \"mean\" | \"median\" | \"min\" | \"max\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "level";
+            readonly description: "STAT ELLIPSE ONLY: confidence level of the bivariate normal ellipse, strictly between 0 and 1. Default 0.95.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "type";
+            readonly description: "STAT ELLIPSE ONLY: construction type. Only \"norm\" (bivariate normal) is supported in v1.";
+            readonly typeSummary: "\"norm\"";
+            readonly required: false;
+        }, {
+            readonly name: "segments";
+            readonly description: "STAT ELLIPSE ONLY: number of perimeter samples before the closing duplicate (output length = segments + 1). Default 51.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly col: {
+        readonly name: "col";
+        readonly slug: "col";
+        readonly component: "GeomCol";
+        readonly summary: "Column geometry: one rectangle per data row, from the y baseline (zero) to the row's y value. Use when the data already contains the bar heights — prefer over GeomBar, which counts or bins.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "stack";
+        readonly allowedStats: readonly ["identity", "unique"];
+        readonly allowedPositions: readonly ["stack", "fill", "dodge", "identity"];
+        readonly paramsType: "ColParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Bar opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "width";
+            readonly description: "Bar width as a fraction of the band step. Must be greater than 0 and at most 1. Default 0.9.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly bar: {
+        readonly name: "bar";
+        readonly slug: "bar";
+        readonly component: "GeomBar";
+        readonly summary: "Bar geometry with counting or binning: one rectangle per distinct x value (stat count, discrete x) or per bin (stat bin, continuous x). Do not map aes.y — the stat computes it. Prefer GeomCol when bar heights are already in the data.";
+        readonly defaultStat: "count";
+        readonly defaultPosition: "stack";
+        readonly allowedStats: readonly ["count", "bin"];
+        readonly allowedPositions: readonly ["stack", "fill", "dodge", "identity"];
+        readonly paramsType: "BarParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Bar opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "width";
+            readonly description: "Bar width as a fraction of the band step (count-stat bars only; binned bars span their bin). Must be greater than 0 and at most 1. Default 0.9.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT BIN ONLY: number of bins (an integer of at least 1). Default 30 — an advisory reminds you to pick a real value. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins. Usually the better knob: pick a width meaningful for the data.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT BIN ONLY: align a bin EDGE with this x value (e.g. 0 puts bin edges at multiples of the width). Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT BIN ONLY: which edge of each bin is inclusive: \"right\" (default, matches) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly histogram: {
+        readonly name: "histogram";
+        readonly slug: "histogram";
+        readonly component: "GeomHistogram";
+        readonly summary: "Histogram geometry: a continuous x variable divided into bins, one bar per bin whose height is the count of rows (or the sum of aes.weight). Do not map aes.y — the bin stat computes it. Canonicalized by normalize() to a bar layer with stat bin.";
+        readonly defaultStat: "bin";
+        readonly defaultPosition: "stack";
+        readonly allowedStats: readonly ["bin"];
+        readonly allowedPositions: readonly ["stack", "fill", "dodge", "identity"];
+        readonly paramsType: "BarParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Bar opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "width";
+            readonly description: "Bar width as a fraction of the band step (count-stat bars only; binned bars span their bin). Must be greater than 0 and at most 1. Default 0.9.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT BIN ONLY: number of bins (an integer of at least 1). Default 30 — an advisory reminds you to pick a real value. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins. Usually the better knob: pick a width meaningful for the data.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT BIN ONLY: align a bin EDGE with this x value (e.g. 0 puts bin edges at multiples of the width). Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT BIN ONLY: which edge of each bin is inclusive: \"right\" (default, matches) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+        readonly aliasOf: "bar";
+    };
+    readonly freqpoly: {
+        readonly name: "freqpoly";
+        readonly slug: "freqpoly";
+        readonly component: "GeomFreqpoly";
+        readonly summary: "Frequency polygon: continuous x binned like a histogram, drawn as a line through bin centers. Do not map aes.y — the bin stat computes it. Canonicalized by normalize() to a line layer with stat bin.";
+        readonly defaultStat: "bin";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["bin"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "LineParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "curve";
+            readonly description: "Interpolation: \"linear\" (default), \"step\" (mid-x corners), \"step-hv\" (horizontal then vertical — correct for ECDF), or \"step-vh\".";
+            readonly typeSummary: "\"linear\" | \"step\" | \"step-hv\" | \"step-vh\"";
+            readonly required: false;
+        }, {
+            readonly name: "pad";
+            readonly description: "With stat ecdf: when true (default), prepend (xmin, 0) so step stairs start at zero. Finite-clamped.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "n";
+            readonly description: "With stat ecdf: evaluate on n equally spaced x in [min, max] per group; omit for one point per unique x.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "connection";
+            readonly description: "STAT CONNECT ONLY: how successive points join — \"hv\" (default), \"vh\", \"mid\", or \"linear\". Ignored for other stats.";
+            readonly typeSummary: "\"hv\" | \"vh\" | \"mid\" | \"linear\"";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT BIN / SUMMARY_BIN: number of bins (integer ≥ 1). Default 30 — an advisory reminds you to pick a real value. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT BIN / SUMMARY_BIN: bin width in data units (must be greater than 0). Takes precedence over bins.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT BIN / SUMMARY_BIN: align a bin EDGE with this x value. Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT BIN / SUMMARY_BIN: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT BIN / SUMMARY_BIN: which edge of each bin is inclusive: \"right\" (default) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }, {
+            readonly name: "window";
+            readonly description: "STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is \"summary_rolling\".";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "SUMMARY_BIN / SUMMARY_ROLLING center fun (mean/median/sum;) or MANUAL named transform (first|last|mean|median|min|max|sum;). Required when stat is \"manual\".";
+            readonly typeSummary: "\"first\" | \"last\" | \"mean\" | \"median\" | \"min\" | \"max\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+        readonly aliasOf: "line";
+    };
+    readonly area: {
+        readonly name: "area";
+        readonly slug: "area";
+        readonly component: "GeomArea";
+        readonly summary: "Area geometry: a filled region from the y baseline (zero) to the y value, connected in x order per group. Use for stacked composition-over-time charts. With stat align, series with different x samples share a common grid for stack/fill.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "stack";
+        readonly allowedStats: readonly ["identity", "unique", "align"];
+        readonly allowedPositions: readonly ["stack", "fill", "dodge", "identity"];
+        readonly paramsType: "AreaParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Area fill opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly rule: {
+        readonly name: "rule";
+        readonly slug: "rule";
+        readonly component: "GeomRule";
+        readonly summary: "Rule geometry: reference lines spanning the panel. Two forms: (1) annotation — set params.xintercept and/or params.yintercept to fixed data values and map neither aes.x nor aes.y; (2) data-driven — map exactly one of aes.x (vertical rules) or aes.y (horizontal rules) to a field. Never mix the forms in one layer.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "RuleParams";
+        readonly params: readonly [{
+            readonly name: "xintercept";
+            readonly description: "ANNOTATION FORM ONLY: draw a vertical rule at each of these fixed x positions. Mutually exclusive with mapping aes.x/aes.y on this layer.";
+            readonly typeSummary: "RuleIntercept";
+            readonly required: false;
+        }, {
+            readonly name: "yintercept";
+            readonly description: "ANNOTATION FORM ONLY: draw a horizontal rule at each of these fixed y positions. Mutually exclusive with mapping aes.x/aes.y on this layer.";
+            readonly typeSummary: "RuleIntercept";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Rule opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly hline: {
+        readonly name: "hline";
+        readonly slug: "hline";
+        readonly component: "GeomHline";
+        readonly summary: "Horizontal reference-line alias. Canonicalized by normalize() to a rule layer. Annotation form: set params.yintercept. Data-driven form: map aes.y (inherited plot x is dropped so the one-axis rule contract holds).";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "HlineParams";
+        readonly params: readonly [{
+            readonly name: "yintercept";
+            readonly description: "ANNOTATION FORM ONLY: draw a horizontal rule at each of these fixed y positions. Mutually exclusive with mapping aes.y on this layer.";
+            readonly typeSummary: "RuleIntercept";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Rule opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+        readonly aliasOf: "rule";
+    };
+    readonly vline: {
+        readonly name: "vline";
+        readonly slug: "vline";
+        readonly component: "GeomVline";
+        readonly summary: "Vertical reference-line alias. Canonicalized by normalize() to a rule layer. Annotation form: set params.xintercept. Data-driven form: map aes.x (inherited plot y is dropped so the one-axis rule contract holds).";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "VlineParams";
+        readonly params: readonly [{
+            readonly name: "xintercept";
+            readonly description: "ANNOTATION FORM ONLY: draw a vertical rule at each of these fixed x positions. Mutually exclusive with mapping aes.x on this layer.";
+            readonly typeSummary: "RuleIntercept";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Rule opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+        readonly aliasOf: "rule";
+    };
+    readonly text: {
+        readonly name: "text";
+        readonly slug: "text";
+        readonly component: "GeomText";
+        readonly summary: "Text geometry: one label per data row at (x, y). No collision detection — labels draw exactly where placed. Requires x, y, and label channels.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique"];
+        readonly allowedPositions: readonly ["identity", "nudge"];
+        readonly paramsType: "TextParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Text opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Font size in px. Must be greater than 0. Default 11.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "anchor";
+            readonly description: "Horizontal text anchor relative to the (x, y) position: \"start\", \"middle\" (default), or \"end\".";
+            readonly typeSummary: "\"start\" | \"middle\" | \"end\"";
+            readonly required: false;
+        }, {
+            readonly name: "dx";
+            readonly description: "Horizontal offset in px applied after positioning. Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "dy";
+            readonly description: "Vertical offset in px applied after positioning (positive = down). Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly label: {
+        readonly name: "label";
+        readonly slug: "label";
+        readonly component: "GeomLabel";
+        readonly summary: "Label geometry: text with a rounded rectangular background box. Requires x, y, and label channels. No collision detection.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity", "nudge"];
+        readonly paramsType: "LabelParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Label opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Font size in px. Must be greater than 0. Default 11.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "anchor";
+            readonly description: "Horizontal text anchor relative to the (x, y) position: \"start\", \"middle\" (default), or \"end\".";
+            readonly typeSummary: "\"start\" | \"middle\" | \"end\"";
+            readonly required: false;
+        }, {
+            readonly name: "dx";
+            readonly description: "Horizontal offset in px applied after positioning. Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "dy";
+            readonly description: "Vertical offset in px applied after positioning (positive = down). Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "padding";
+            readonly description: "Uniform box padding around the text in px. Default 3.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "radius";
+            readonly description: "Corner radius of the background box in px. Default 3.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Box outline stroke width in px. Default 0.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly smooth: {
+        readonly name: "smooth";
+        readonly slug: "smooth";
+        readonly component: "GeomSmooth";
+        readonly summary: "Smooth geometry: a fitted trend line (with an optional confidence ribbon) over an x/y scatter, one fit per group. Use to reveal trends.";
+        readonly defaultStat: "smooth";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["smooth"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "SmoothParams";
+        readonly params: readonly [{
+            readonly name: "method";
+            readonly description: "Smoothing method: \"lm\" (least-squares line) or \"loess\" (local polynomial regression). Omit to infer: loess for fewer than 1000 rows, lm above (an advisory reports the choice).";
+            readonly typeSummary: "\"lm\" | \"loess\"";
+            readonly required: false;
+        }, {
+            readonly name: "se";
+            readonly description: "Draw the confidence-interval ribbon around the fit. Default true.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "level";
+            readonly description: "Confidence level of the ribbon, strictly between 0 and 1. Default 0.95.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "span";
+            readonly description: "LOESS ONLY: fraction of points in each local neighborhood, greater than 0 and at most 1. Default 0.75. Smaller = wigglier.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "degree";
+            readonly description: "LOESS ONLY: degree of the local polynomial, 1 or 2. Default 2 (the R default).";
+            readonly typeSummary: "1 | 2";
+            readonly required: false;
+        }, {
+            readonly name: "n";
+            readonly description: "Number of evaluation points along x (an integer between 2 and 5000). Default 80.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width of the fitted line in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint for the fitted line (not a data scale).";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly quantile: {
+        readonly name: "quantile";
+        readonly slug: "quantile";
+        readonly component: "GeomQuantile";
+        readonly summary: "Quantile geometry: linear quantile regression lines (y ~ x) at one or more conditional quantiles of y, one line per quantile per group.";
+        readonly defaultStat: "quantile";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["quantile"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "QuantileParams";
+        readonly params: readonly [{
+            readonly name: "quantiles";
+            readonly description: "Conditional quantiles of y to fit and draw. Each entry must be in (0, 1). Default [0.25, 0.5, 0.75].";
+            readonly typeSummary: "Array<number>";
+            readonly required: false;
+        }, {
+            readonly name: "n";
+            readonly description: "Number of evaluation points along x (integer 2–5000). Default 80. Linear fits need only endpoints; denser grids help nonlinear coords.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width of quantile lines in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint for quantile lines (not a data scale).";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly boxplot: {
+        readonly name: "boxplot";
+        readonly slug: "boxplot";
+        readonly component: "GeomBoxplot";
+        readonly summary: "Box-and-whisker geometry: one box per x category (per group) summarizing the y distribution — hinges at the quartiles, whiskers to the furthest points within coef × IQR, outliers drawn individually.";
+        readonly defaultStat: "boxplot";
+        readonly defaultPosition: "dodge";
+        readonly allowedStats: readonly ["boxplot"];
+        readonly allowedPositions: readonly ["dodge", "identity"];
+        readonly paramsType: "BoxplotParams";
+        readonly params: readonly [{
+            readonly name: "width";
+            readonly description: "Box width as a fraction of the band step. Must be greater than 0 and at most 1. Default 0.75. When omitted, width is also capped at 15% of the panel so few categories do not read as slabs.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "coef";
+            readonly description: "Whisker length as a multiple of the IQR (values beyond it are outliers). Must be at least 0. Default 1.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width of the box, whiskers, and median line in px (the median draws at twice this). Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "outlierSize";
+            readonly description: "Outlier point radius in px. Must be greater than 0. Default 1.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Layer opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly density: {
+        readonly name: "density";
+        readonly slug: "density";
+        readonly component: "GeomDensity";
+        readonly summary: "Density geometry: a smooth kernel density estimate of a continuous x variable, drawn as a filled area — a smoothed histogram alternative. One curve per group. Do NOT map aes.y — the density stat computes it.";
+        readonly defaultStat: "density";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["density"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "DensityParams";
+        readonly params: readonly [{
+            readonly name: "bw";
+            readonly description: "Kernel bandwidth in data units (must be greater than 0). Omit for R's bw.nrd0 rule-of-thumb default.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "adjust";
+            readonly description: "Bandwidth multiplier (must be greater than 0). Default 1. 0.5 = half the default bandwidth (wigglier), 2 = double (smoother).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "n";
+            readonly description: "Number of grid points the density is evaluated at (an integer between 2 and 4096). Default 512 (the R default).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "cut";
+            readonly description: "The grid extends cut * bandwidth beyond the data extremes (at least 0). Default 3 (the R default).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Area fill opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly errorbar: {
+        readonly name: "errorbar";
+        readonly slug: "errorbar";
+        readonly component: "GeomErrorbar";
+        readonly summary: "Errorbar geometry: a vertical range with caps at ymin and ymax, one per data row (identity stat) or per x group (summary stat).";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique", "summary", "summary_bin"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "ErrorbarParams";
+        readonly params: readonly [{
+            readonly name: "width";
+            readonly description: "Cap width as a fraction of the band step. Must be greater than 0 and at most 1. Default 0.9.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Errorbar opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "STAT SUMMARY ONLY: the center summary of y per x group: \"mean\" (default), \"median\", or \"sum\". With \"mean\" and no funMin/funMax, the bounds default to mean ± standard error.";
+            readonly typeSummary: "\"mean\" | \"median\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY ONLY: summary function for the lower bound (ymin). Overrides the mean_se default.";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY / SUMMARY_BIN: summary function for the upper bound (ymax). Overrides the mean_se default.";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: \"right\" (default) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }];
+    };
+    readonly linerange: {
+        readonly name: "linerange";
+        readonly slug: "linerange";
+        readonly component: "GeomLinerange";
+        readonly summary: "Linerange geometry: a vertical stem from ymin to ymax without end caps.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "summary"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "LinerangeParams";
+        readonly params: readonly [{
+            readonly name: "width";
+            readonly description: "Cap width as a fraction of the band step. Must be greater than 0 and at most 1. Default 0.9.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Errorbar opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "STAT SUMMARY ONLY: the center summary of y per x group: \"mean\" (default), \"median\", or \"sum\". With \"mean\" and no funMin/funMax, the bounds default to mean ± standard error.";
+            readonly typeSummary: "\"mean\" | \"median\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY ONLY: summary function for the lower bound (ymin). Overrides the mean_se default.";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY / SUMMARY_BIN: summary function for the upper bound (ymax). Overrides the mean_se default.";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: \"right\" (default) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }];
+    };
+    readonly pointrange: {
+        readonly name: "pointrange";
+        readonly slug: "pointrange";
+        readonly component: "GeomPointrange";
+        readonly summary: "Pointrange geometry: vertical stem from ymin to ymax plus a point at (x, y).";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "summary"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "PointrangeParams";
+        readonly params: readonly [{
+            readonly name: "linewidth";
+            readonly description: "Stem stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Opacity for stem and point. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Mid-point radius in px. Default 2.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "shape";
+            readonly description: "Mid-point shape. Default \"circle\".";
+            readonly typeSummary: "\"circle\" | \"triangle\" | \"square\" | \"diamond\" | \"plus\" | \"cross\" | \"circle-open\"";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "STAT SUMMARY ONLY: center summary of y per x group. Default \"mean\" (mean_se when funMin/funMax omitted).";
+            readonly typeSummary: "\"mean\" | \"median\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY ONLY: summary function for the lower bound (ymin). Overrides the mean_se default.";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY ONLY: summary function for the upper bound (ymax). Overrides the mean_se default.";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }];
+    };
+    readonly crossbar: {
+        readonly name: "crossbar";
+        readonly slug: "crossbar";
+        readonly component: "GeomCrossbar";
+        readonly summary: "Crossbar geometry: a vertical interval box from ymin to ymax with a mid horizontal line at y.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "summary"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "CrossbarParams";
+        readonly params: readonly [{
+            readonly name: "width";
+            readonly description: "Box width: band-step fraction (band x) or fraction of continuous resolution (same rule as errorbar caps). Default 0.9.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fatten";
+            readonly description: "Multiplier for the mid-line linewidth relative to params.linewidth / aes.linewidth. Default 2.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Outline and base mid-line stroke width in px. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Box and mid-line opacity. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "STAT SUMMARY ONLY: center summary. Default \"mean\".";
+            readonly typeSummary: "\"mean\" | \"median\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY ONLY: summary function for the lower bound (ymin). Overrides the mean_se default.";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY ONLY: summary function for the upper bound (ymax). Overrides the mean_se default.";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }];
+    };
+    readonly rect: {
+        readonly name: "rect";
+        readonly slug: "rect";
+        readonly component: "GeomRect";
+        readonly summary: "Rectangle geometry: one rectangle per data row from mapped xmin/xmax/ymin/ymax edges. Use for arbitrary shaded regions and time bands.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "RectParams";
+        readonly params: readonly [{
+            readonly name: "linewidth";
+            readonly description: "Outline stroke width in px when color is set. Must be greater than 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Rectangle opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient outline paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly tile: {
+        readonly name: "tile";
+        readonly slug: "tile";
+        readonly component: "GeomTile";
+        readonly summary: "Tile geometry: center-sized cells at (x, y) with optional width/height. Use for heatmaps and gridded categorical cells; supports stroke outlines.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "TileParams";
+        readonly params: readonly [{
+            readonly name: "width";
+            readonly description: "Constant tile width in data units after position transform (band axes: fraction of the band step). Default: resolution of unique x centers (continuous) or 1 (band).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "height";
+            readonly description: "Constant tile height in data units after position transform (band axes: fraction of the band step). Default: resolution of unique y centers (continuous) or 1 (band).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Outline stroke width in px when color is set. Must be greater than 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Tile opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient outline paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly raster: {
+        readonly name: "raster";
+        readonly slug: "raster";
+        readonly component: "GeomRaster";
+        readonly summary: "Raster geometry: equal-cell grid at (x, y) with fill; optimized dense heatmaps without per-cell strokes. Irregular spacing warns and suggests geom tile.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "RasterParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Raster opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "hjust";
+            readonly description: "Horizontal justification of each cell over its x center (0–1). Default 0.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "vjust";
+            readonly description: "Vertical justification of each cell over its y center (0–1). Default 0.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "interpolate";
+            readonly description: "Interpolation between cells. Only false (nearest / no interpolation) is supported.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }];
+    };
+    readonly ribbon: {
+        readonly name: "ribbon";
+        readonly slug: "ribbon";
+        readonly component: "GeomRibbon";
+        readonly summary: "Ribbon geometry: a filled interval between two varying boundaries along a running coordinate. Map x+ymin+ymax (x orientation) or y+xmin+xmax (y orientation). Not a zero-baseline area.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "RibbonParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Ribbon fill opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Outline stroke width in px when an outline is drawn. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "outline";
+            readonly description: "Which edges receive an outline stroke: \"both\" (default — upper and lower), \"upper\", \"lower\", or \"full\" (closed outline of the band). Strokes appear when aes.color / a color constant is set, or when strokePaint is set.";
+            readonly typeSummary: "\"both\" | \"upper\" | \"lower\" | \"full\"";
+            readonly required: false;
+        }, {
+            readonly name: "orientation";
+            readonly description: "Running-coordinate orientation: \"x\" (map x + ymin + ymax) or \"y\" (map y + xmin + xmax). When omitted, inferred from the complete channel contract; set explicitly if both contracts are mapped.";
+            readonly typeSummary: "\"x\" | \"y\"";
+            readonly required: false;
+        }, {
+            readonly name: "lineend";
+            readonly description: "SVG stroke-linecap for outlines. Default \"butt\".";
+            readonly typeSummary: "\"butt\" | \"round\" | \"square\"";
+            readonly required: false;
+        }, {
+            readonly name: "linejoin";
+            readonly description: "SVG stroke-linejoin for outlines. Default \"round\".";
+            readonly typeSummary: "\"miter\" | \"round\" | \"bevel\"";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient outline paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly segment: {
+        readonly name: "segment";
+        readonly slug: "segment";
+        readonly component: "GeomSegment";
+        readonly summary: "Segment geometry: one finite line per data row from (x, y) to (xend, yend). Unlike rule, endpoints are data-mapped and do not span the panel.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity", "unique"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "SegmentParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Segment opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "lineend";
+            readonly description: "SVG stroke-linecap for segment ends. Default \"butt\".";
+            readonly typeSummary: "\"butt\" | \"round\" | \"square\"";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly count: {
+        readonly name: "count";
+        readonly slug: "count";
+        readonly component: "GeomCount";
+        readonly summary: "Count geometry: point marks at unique (x, y) with size scaled by after_stat n (stat sum). Use for overplotting density on discrete or rounded coordinates.";
+        readonly defaultStat: "sum";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["sum"];
+        readonly allowedPositions: readonly ["identity", "jitter", "nudge"];
+        readonly paramsType: "PointParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Point radius in px. Must be greater than 0. Default 2.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "shape";
+            readonly description: "Point shape. One of \"circle\", \"triangle\", \"square\", \"diamond\", \"plus\", \"cross\", \"circle-open\". Default \"circle\".";
+            readonly typeSummary: "\"circle\" | \"triangle\" | \"square\" | \"diamond\" | \"plus\" | \"cross\" | \"circle-open\"";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: \"right\" (default) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }, {
+            readonly name: "window";
+            readonly description: "STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is \"summary_rolling\".";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "SUMMARY_BIN / SUMMARY_ROLLING center fun (mean/median/sum;) or MANUAL named transform (first|last|mean|median|min|max|sum;). Required when stat is \"manual\".";
+            readonly typeSummary: "\"first\" | \"last\" | \"mean\" | \"median\" | \"min\" | \"max\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }];
+    };
+    readonly violin: {
+        readonly name: "violin";
+        readonly slug: "violin";
+        readonly component: "GeomViolin";
+        readonly summary: "Violin geometry: mirrored kernel density of continuous y at each discrete x (stat ydensity). One polygon per x×group. Default position dodge.";
+        readonly defaultStat: "ydensity";
+        readonly defaultPosition: "dodge";
+        readonly allowedStats: readonly ["ydensity"];
+        readonly allowedPositions: readonly ["dodge", "identity"];
+        readonly paramsType: "ViolinParams";
+        readonly params: readonly [{
+            readonly name: "bw";
+            readonly description: "Kernel bandwidth in data units (must be greater than 0). Omit for R's bw.nrd0 rule-of-thumb default.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "adjust";
+            readonly description: "Bandwidth multiplier (must be greater than 0). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "n";
+            readonly description: "Number of density grid points (2–4096). Default 512.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "trim";
+            readonly description: "When true (default), trim the density to the data range; when false, extend cut·bw tails like density().";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "scale";
+            readonly description: "Relative violin max-width scaling: \"area\" (default), \"count\", or \"width\" (equal max width).";
+            readonly typeSummary: "\"area\" | \"count\" | \"width\"";
+            readonly required: false;
+        }, {
+            readonly name: "width";
+            readonly description: "Max violin width as a fraction of the discrete x band (like boxplot). Default 0.75.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Fill opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Outline stroke width in px. Must be greater than 0. Default 0.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly function: {
+        readonly name: "function";
+        readonly slug: "function";
+        readonly component: "GeomFunction";
+        readonly summary: "Function geometry: evaluate a named portable function y = f(x) on a grid and draw a path. Requires params.fun; domain from params.xlim, mapped x, or peer layers.";
+        readonly defaultStat: "function";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["function"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "FunctionParams";
+        readonly params: readonly [{
+            readonly name: "fun";
+            readonly description: "Required named function from the portable registry.";
+            readonly typeSummary: "FunctionRegistryName";
+            readonly required: true;
+        }, {
+            readonly name: "n";
+            readonly description: "Number of evaluation grid points (2–10000). Default 101.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "xlim";
+            readonly description: "Evaluation domain [min, max] (min < max). When omitted, uses continuous aes.x extent or peer-layer x domain.";
+            readonly typeSummary: "Array<number>";
+            readonly required: false;
+        }, {
+            readonly name: "args";
+            readonly description: "Optional named arguments for the registry function (e.g. mean and sd for dnorm). Keys and values must be portable JSON.";
+            readonly typeSummary: "FunctionArgs";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Path opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly polygon: {
+        readonly name: "polygon";
+        readonly slug: "polygon";
+        readonly component: "GeomPolygon";
+        readonly summary: "Polygon geometry: closed filled paths from (x, y) vertices in data/row order within each group. Groups form separate polygons. No x-sort (unlike line/area). Holes/subgroup omitted in v1.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "PolygonParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Polygon fill/stroke opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Outline stroke width in px. Must be greater than 0. Default matches line (1.5).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly hex: {
+        readonly name: "hex";
+        readonly slug: "hex";
+        readonly component: "GeomHex";
+        readonly summary: "Hexagonal bin heatmap: partitions continuous x×y into a hexagonal lattice and maps fill to bin count by default.";
+        readonly defaultStat: "bin_hex";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["bin_hex"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "HexParams";
+        readonly params: readonly [{
+            readonly name: "bins";
+            readonly description: "Approximate number of hex bins across the x range. Default 30.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "drop";
+            readonly description: "When true (default), omit zero-count hexes from the output.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Hex opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Outline stroke width in px when color is set. Default 0 (no outline).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly bin_2d: {
+        readonly name: "bin_2d";
+        readonly slug: "bin_2d";
+        readonly component: "GeomBin2d";
+        readonly summary: "2D rectangular bin heatmap: partitions continuous x×y into a grid and maps fill to bin count by default. Empty bins are dropped unless params.drop is false.";
+        readonly defaultStat: "bin_2d";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["bin_2d"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "Bin2dParams";
+        readonly params: readonly [{
+            readonly name: "bins";
+            readonly description: "Number of bins on each axis. Default 30. Applies equally to x and y in v1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "Shared bin width in data units for both axes (overrides bins). Prefer when the scale units are meaningful.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "drop";
+            readonly description: "When true (default), omit zero-count bins from the output.";
+            readonly typeSummary: "boolean";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Cell opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Outline stroke width in px when color is set. Must be greater than 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly abline: {
+        readonly name: "abline";
+        readonly slug: "abline";
+        readonly component: "GeomAbline";
+        readonly summary: "Abline geometry: one infinite reference line y = intercept + slope · x, clipped to the panel. Annotation form: fixed slope/intercept in params; does not inherit plot aes.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "AblineParams";
+        readonly params: readonly [{
+            readonly name: "slope";
+            readonly description: "Line slope (rise/run). Default 1 (identity line when intercept is 0).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "intercept";
+            readonly description: "Y-intercept in data units. Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly curve: {
+        readonly name: "curve";
+        readonly slug: "curve";
+        readonly component: "GeomCurve";
+        readonly summary: "Curve geometry: one curved connector per row from (x, y) to (xend, yend). Tessellated as a quadratic Bezier (curvature/angle/ncp). Requires field-mapped x, y, xend, and yend.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "CurveParams";
+        readonly params: readonly [{
+            readonly name: "curvature";
+            readonly description: "Amount of bend away from the straight chord. 0 is a straight line; default 0.5. Positive bows to the right of the start→end direction when angle is 90.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "angle";
+            readonly description: "Control-point direction relative to the chord, in degrees. default 90 (perpendicular).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "ncp";
+            readonly description: "Smoothness density knob. Maps to tessellation sample count = max(8, ncp×8); not multi-control xspline. Default 5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Curve opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "lineend";
+            readonly description: "SVG stroke-linecap for curve ends. Default \"butt\".";
+            readonly typeSummary: "\"butt\" | \"round\" | \"square\"";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly contour: {
+        readonly name: "contour";
+        readonly slug: "contour";
+        readonly component: "GeomContour";
+        readonly summary: "Contour geometry: isolines of a continuous z surface over a regular x×y grid. v1 draws open path polylines only (not filled bands).";
+        readonly defaultStat: "contour";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["contour"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "ContourParams";
+        readonly params: readonly [{
+            readonly name: "bins";
+            readonly description: "Number of evenly spaced contour levels from min(z) to max(z) inclusive (integer ≥ 1). Default 10. Overridden by breaks or binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "Contour level step in z units (must be greater than 0). Takes precedence over bins; overridden by breaks.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "breaks";
+            readonly description: "Explicit contour levels (finite numbers). Overrides bins and binwidth when non-empty.";
+            readonly typeSummary: "Array<number>";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width of contour lines in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly density_2d: {
+        readonly name: "density_2d";
+        readonly slug: "density_2d";
+        readonly component: "GeomDensity2d";
+        readonly summary: "2D density geometry: bivariate KDE isolines over continuous x and y. Open path contours.";
+        readonly defaultStat: "density_2d";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["density_2d"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "Density2dParams";
+        readonly params: readonly [{
+            readonly name: "h";
+            readonly description: "Kernel bandwidth: one positive number for both axes, or [hx, hy]. Omit for MASS bandwidth.nrd per axis (then kde2d h/4 scaling).";
+            readonly typeSummary: "number | Array<number>";
+            readonly required: false;
+        }, {
+            readonly name: "adjust";
+            readonly description: "Bandwidth multiplier (must be greater than 0). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "n";
+            readonly description: "Grid resolution per axis for the KDE surface (integer 10–200). Default 100.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "Number of contour levels of the density surface (integer ≥ 1). Default 10. Overridden by breaks.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "Contour level step in density units. Overridden by breaks.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "breaks";
+            readonly description: "Explicit density contour levels. Overrides bins and binwidth.";
+            readonly typeSummary: "Array<number>";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width of density contours in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly density_2d_filled: {
+        readonly name: "density_2d_filled";
+        readonly slug: "density_2d_filled";
+        readonly component: "GeomDensity2dFilled";
+        readonly summary: "2D density filled bands: bivariate KDE closed isoline rings filled by density level. Open rings dropped. Defaults fill to after_stat(level).";
+        readonly defaultStat: "density_2d_filled";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["density_2d_filled"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "Density2dParams";
+        readonly params: readonly [{
+            readonly name: "h";
+            readonly description: "Kernel bandwidth: one positive number for both axes, or [hx, hy]. Omit for MASS bandwidth.nrd per axis (then kde2d h/4 scaling).";
+            readonly typeSummary: "number | Array<number>";
+            readonly required: false;
+        }, {
+            readonly name: "adjust";
+            readonly description: "Bandwidth multiplier (must be greater than 0). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "n";
+            readonly description: "Grid resolution per axis for the KDE surface (integer 10–200). Default 100.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "Number of contour levels of the density surface (integer ≥ 1). Default 10. Overridden by breaks.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "Contour level step in density units. Overridden by breaks.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "breaks";
+            readonly description: "Explicit density contour levels. Overrides bins and binwidth.";
+            readonly typeSummary: "Array<number>";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width of density contours in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly dotplot: {
+        readonly name: "dotplot";
+        readonly slug: "dotplot";
+        readonly component: "GeomDotplot";
+        readonly summary: "Dotplot geometry: stacked dots along a continuous x axis (histodot subset). Do not map aes.y — the bindot stat computes stack positions.";
+        readonly defaultStat: "bindot";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["bindot"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "DotplotParams";
+        readonly params: readonly [{
+            readonly name: "bins";
+            readonly description: "Number of bins (integer ≥ 1). Default 30 — advisory when neither bins nor binwidth is set. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "Histodot bin width in data units (must be greater than 0). Takes precedence over bins. Also drives default point diameter via the x scale.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "Align a bin edge to this value (mutually exclusive with center).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "Align a bin center to this value (mutually exclusive with boundary).";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "Which side of each bin is closed: \"right\" (default, (lo, hi]) or \"left\" ([lo, hi)).";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }, {
+            readonly name: "stackdir";
+            readonly description: "Stack direction: \"up\" (default), \"down\", \"center\", or \"centerwhole\" (integer-aligned center).";
+            readonly typeSummary: "\"up\" | \"down\" | \"center\" | \"centerwhole\"";
+            readonly required: false;
+        }, {
+            readonly name: "stackratio";
+            readonly description: "Relative spacing between stacked dots (must be greater than 0). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "dotsize";
+            readonly description: "Multiplier on diameter derived from binwidth × x-scale (must be greater than 0). Default 1. Ignored when params.size is set.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Point radius in px (must be greater than 0). When set, overrides binwidth-derived sizing.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "shape";
+            readonly description: "Point shape. One of \"circle\", \"triangle\", \"square\", \"diamond\", \"plus\", \"cross\", \"circle-open\". Default \"circle\".";
+            readonly typeSummary: "\"circle\" | \"triangle\" | \"square\" | \"diamond\" | \"plus\" | \"cross\" | \"circle-open\"";
+            readonly required: false;
+        }];
+    };
+    readonly map: {
+        readonly name: "map";
+        readonly slug: "map";
+        readonly component: "GeomMap";
+        readonly summary: "Map geometry: join fortified region borders to value rows via aes.map_id and params.map. Renders closed filled paths per region.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "MapParams";
+        readonly params: readonly [{
+            readonly name: "map";
+            readonly description: "Fortified map coordinates ({ values }, { columns }, or { name } against spec.datasets). Must include long+lat or x+y, plus a region id column.";
+            readonly typeSummary: "DataRef";
+            readonly required: true;
+        }, {
+            readonly name: "mapId";
+            readonly description: "Join column name in the map data (matched to aes.map_id). Default: \"region\", then \"id\".";
+            readonly typeSummary: "string";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Region fill opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Region outline stroke width in px. Must be greater than 0. Default 1.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (not a data scale).";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale).";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly sf: {
+        readonly name: "sf";
+        readonly slug: "sf";
+        readonly component: "GeomSf";
+        readonly summary: "Simple-features geometry: already-projected GeoJSON Geometry JSON strings in a data column. Point/line/polygon families (incl. GeometryCollection of one family) with even-odd holes; use coord_sf for fixed-aspect (CRS reproject deferred).";
+        readonly defaultStat: "sf";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["sf"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "SfParams";
+        readonly params: readonly [{
+            readonly name: "geometry";
+            readonly description: "Name of the data column holding GeoJSON Geometry JSON strings. Default \"geometry\". Already-projected coordinates only.";
+            readonly typeSummary: "string";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Mark opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px for lines/polygon outlines. Must be greater than 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Point radius in px when geometries are Point/MultiPoint.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fillPaint";
+            readonly description: "Within-mark gradient fill paint (polygon family; not a data scale).";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale).";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly sf_text: {
+        readonly name: "sf_text";
+        readonly slug: "sf_text";
+        readonly component: "GeomSfText";
+        readonly summary: "Simple-features text labels: places aes.label at representative geometry points (Multi* → one label per part; stat_sf_coordinates).";
+        readonly defaultStat: "sf_coordinates";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["sf_coordinates"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "SfTextParams";
+        readonly params: readonly [{
+            readonly name: "geometry";
+            readonly description: "Name of the data column holding GeoJSON Geometry JSON strings. Default \"geometry\".";
+            readonly typeSummary: "string";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Text opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Font size in px. Must be greater than 0. Default 11.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "anchor";
+            readonly description: "Horizontal text anchor relative to the representative point: \"start\", \"middle\" (default), or \"end\".";
+            readonly typeSummary: "\"start\" | \"middle\" | \"end\"";
+            readonly required: false;
+        }, {
+            readonly name: "dx";
+            readonly description: "Horizontal offset in px applied after positioning. Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "dy";
+            readonly description: "Vertical offset in px applied after positioning (positive = down). Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly sf_label: {
+        readonly name: "sf_label";
+        readonly slug: "sf_label";
+        readonly component: "GeomSfLabel";
+        readonly summary: "Simple-features labels with background boxes: places aes.label at representative geometry points with a measured rounded rect (Multi* → one label per part). color=ink+box stroke; fill=box background.";
+        readonly defaultStat: "sf_coordinates";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["sf_coordinates"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "SfLabelParams";
+        readonly params: readonly [{
+            readonly name: "geometry";
+            readonly description: "Name of the data column holding GeoJSON Geometry JSON strings. Default \"geometry\".";
+            readonly typeSummary: "string";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Label opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Font size in px. Must be greater than 0. Default 11.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "anchor";
+            readonly description: "Horizontal text anchor relative to the representative point: \"start\", \"middle\" (default), or \"end\".";
+            readonly typeSummary: "\"start\" | \"middle\" | \"end\"";
+            readonly required: false;
+        }, {
+            readonly name: "dx";
+            readonly description: "Horizontal offset in px applied after positioning. Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "dy";
+            readonly description: "Vertical offset in px applied after positioning (positive = down). Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "padding";
+            readonly description: "Box padding around the text in px. Default 3.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "radius";
+            readonly description: "Box corner radius in px. Default 3.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Box stroke width in px. Default 0.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly blank: {
+        readonly name: "blank";
+        readonly slug: "blank";
+        readonly component: "GeomBlank";
+        readonly summary: "Blank geometry: contributes mapped aesthetics to scale training and layout without drawing marks or hit targets. No channels are required; whatever is mapped trains its scale.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "BlankParams";
+        readonly params: readonly [];
+    };
+    readonly jitter: {
+        readonly name: "jitter";
+        readonly slug: "jitter";
+        readonly component: "GeomJitter";
+        readonly summary: "Jittered point alias. Canonicalized by normalize() to a point layer with position jitter. Configure jitter amount via positionParams.width/height/seed.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "jitter";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["jitter"];
+        readonly paramsType: "PointParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Point radius in px. Must be greater than 0. Default 2.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "shape";
+            readonly description: "Point shape. One of \"circle\", \"triangle\", \"square\", \"diamond\", \"plus\", \"cross\", \"circle-open\". Default \"circle\".";
+            readonly typeSummary: "\"circle\" | \"triangle\" | \"square\" | \"diamond\" | \"plus\" | \"cross\" | \"circle-open\"";
+            readonly required: false;
+        }, {
+            readonly name: "bins";
+            readonly description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "binwidth";
+            readonly description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "boundary";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "center";
+            readonly description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "closed";
+            readonly description: "STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: \"right\" (default) or \"left\".";
+            readonly typeSummary: "\"right\" | \"left\"";
+            readonly required: false;
+        }, {
+            readonly name: "window";
+            readonly description: "STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is \"summary_rolling\".";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "fun";
+            readonly description: "SUMMARY_BIN / SUMMARY_ROLLING center fun (mean/median/sum;) or MANUAL named transform (first|last|mean|median|min|max|sum;). Required when stat is \"manual\".";
+            readonly typeSummary: "\"first\" | \"last\" | \"mean\" | \"median\" | \"min\" | \"max\" | \"sum\"";
+            readonly required: false;
+        }, {
+            readonly name: "funMin";
+            readonly description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }, {
+            readonly name: "funMax";
+            readonly description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).";
+            readonly typeSummary: "SummaryFun";
+            readonly required: false;
+        }];
+        readonly aliasOf: "point";
+    };
+    readonly spoke: {
+        readonly name: "spoke";
+        readonly slug: "spoke";
+        readonly component: "GeomSpoke";
+        readonly summary: "Spoke geometry: one finite segment per row from (x, y) in direction angle (radians) with length radius. Endpoints are derived as xend = x + radius·cos(angle), yend = y + radius·sin(angle) in data space, then transformed like x/y. Requires continuous x and y.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "SpokeParams";
+        readonly params: readonly [{
+            readonly name: "angle";
+            readonly description: "Constant spoke direction in radians when aes.angle is not mapped. 0 = +x, π/2 = +y.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "radius";
+            readonly description: "Constant spoke length in data units when aes.radius is not mapped. Must be greater than 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Spoke opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "lineend";
+            readonly description: "SVG stroke-linecap for spoke ends. Default \"butt\".";
+            readonly typeSummary: "\"butt\" | \"round\" | \"square\"";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly rug: {
+        readonly name: "rug";
+        readonly slug: "rug";
+        readonly component: "GeomRug";
+        readonly summary: "Rug geometry: short ticks along panel edges for each observation. Map aes.x for bottom/top sides and/or aes.y for left/right sides.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "RugParams";
+        readonly params: readonly [{
+            readonly name: "sides";
+            readonly description: "Which panel edges get ticks: any non-empty combination of \"b\" (bottom), \"l\" (left), \"t\" (top), \"r\" (right). Default \"bl\". Duplicates are treated as a set. Sides b/t require aes.x; sides l/r require aes.y.";
+            readonly typeSummary: "string";
+            readonly required: false;
+        }, {
+            readonly name: "length";
+            readonly description: "Tick length as a fraction of the panel size along the tick axis (panel-fraction npc analogue of unit(0.03, \"npc\")). Default 0.03.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "alpha";
+            readonly description: "Tick opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+    readonly step: {
+        readonly name: "step";
+        readonly slug: "step";
+        readonly component: "GeomStep";
+        readonly summary: "Step-line geometry: connect points with hv/vh/mid stairs. Same channels as line; ordered by x within groups.";
+        readonly defaultStat: "identity";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["identity"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "StepParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Step-line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.5.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "direction";
+            readonly description: "Step corner placement: \"hv\" horizontal then vertical (default), \"vh\" vertical then horizontal, \"mid\" change at the midpoint between x positions.";
+            readonly typeSummary: "\"hv\" | \"vh\" | \"mid\"";
+            readonly required: false;
+        }, {
+            readonly name: "strokePaint";
+            readonly description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.";
+            readonly typeSummary: "GradientPaint";
+            readonly required: false;
+        }, {
+            readonly name: "glow";
+            readonly description: "Bounded within-mark glow treatment (not theme decoration).";
+            readonly typeSummary: "GlowSpec";
+            readonly required: false;
+        }];
+    };
+    readonly qq: {
+        readonly name: "qq";
+        readonly slug: "qq";
+        readonly component: "GeomQq";
+        readonly summary: "Q–Q scatter: sample quantiles vs theoretical normal quantiles. Requires aes.sample.";
+        readonly defaultStat: "qq";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["qq"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "QqParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "size";
+            readonly description: "Point size in px. Must be greater than 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "shape";
+            readonly description: "Point shape. One of \"circle\", \"triangle\", \"square\", \"diamond\", \"plus\", \"cross\", \"circle-open\". Default \"circle\".";
+            readonly typeSummary: "\"circle\" | \"triangle\" | \"square\" | \"diamond\" | \"plus\" | \"cross\" | \"circle-open\"";
+            readonly required: false;
+        }];
+    };
+    readonly qq_line: {
+        readonly name: "qq_line";
+        readonly slug: "qq_line";
+        readonly component: "GeomQqLine";
+        readonly summary: "Q–Q reference line: line through sample/theoretical quartile match, spanning the theoretical range of the Q–Q cloud. Requires aes.sample.";
+        readonly defaultStat: "qq_line";
+        readonly defaultPosition: "identity";
+        readonly allowedStats: readonly ["qq_line"];
+        readonly allowedPositions: readonly ["identity"];
+        readonly paramsType: "QqLineParams";
+        readonly params: readonly [{
+            readonly name: "alpha";
+            readonly description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "linewidth";
+            readonly description: "Stroke width in px. Must be greater than 0. Default 1.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+    };
+};
+//# sourceMappingURL=geom-reference-data.d.ts.map