@ggts-sh/spec 0.43.0

package/dist/generated/geom-reference-data.js

@@ -0,0 +1,2790 @@
+/**
+ * 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 const GEOM_REFERENCE_DATA = {
+    point: {
+        name: "point",
+        slug: "point",
+        component: "GeomPoint",
+        summary: "Point geometry: one mark per data row. Use for scatter plots, dot plots, bubbles, and correlation views.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "unique", "summary_bin", "summary_rolling", "manual", "sum"],
+        allowedPositions: ["identity", "jitter", "nudge"],
+        paramsType: "PointParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Point radius in px. Must be greater than 0. Default 2.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "shape",
+                description: 'Point shape. One of "circle", "triangle", "square", "diamond", "plus", "cross", "circle-open". Default "circle".',
+                typeSummary: '"circle" | "triangle" | "square" | "diamond" | "plus" | "cross" | "circle-open"',
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: "right" (default) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+            {
+                name: "window",
+                description: 'STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is "summary_rolling".',
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fun",
+                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".',
+                typeSummary: '"first" | "last" | "mean" | "median" | "min" | "max" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+        ],
+    },
+    line: {
+        name: "line",
+        slug: "line",
+        component: "GeomLine",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: [
+            "identity",
+            "unique",
+            "bin",
+            "align",
+            "connect",
+            "summary_bin",
+            "summary_rolling",
+            "manual",
+            "ecdf",
+        ],
+        allowedPositions: ["identity"],
+        paramsType: "LineParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "curve",
+                description: 'Interpolation: "linear" (default), "step" (mid-x corners), "step-hv" (horizontal then vertical — correct for ECDF), or "step-vh".',
+                typeSummary: '"linear" | "step" | "step-hv" | "step-vh"',
+                required: false,
+            },
+            {
+                name: "pad",
+                description: "With stat ecdf: when true (default), prepend (xmin, 0) so step stairs start at zero. Finite-clamped.",
+                typeSummary: "boolean",
+                required: false,
+            },
+            {
+                name: "n",
+                description: "With stat ecdf: evaluate on n equally spaced x in [min, max] per group; omit for one point per unique x.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "connection",
+                description: 'STAT CONNECT ONLY: how successive points join — "hv" (default), "vh", "mid", or "linear". Ignored for other stats.',
+                typeSummary: '"hv" | "vh" | "mid" | "linear"',
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "STAT BIN / SUMMARY_BIN: number of bins (integer ≥ 1). Default 30 — an advisory reminds you to pick a real value. Overridden by binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "STAT BIN / SUMMARY_BIN: bin width in data units (must be greater than 0). Takes precedence over bins.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                description: "STAT BIN / SUMMARY_BIN: align a bin EDGE with this x value. Mutually exclusive with center.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT BIN / SUMMARY_BIN: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT BIN / SUMMARY_BIN: which edge of each bin is inclusive: "right" (default) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+            {
+                name: "window",
+                description: 'STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is "summary_rolling".',
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fun",
+                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".',
+                typeSummary: '"first" | "last" | "mean" | "median" | "min" | "max" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    path: {
+        name: "path",
+        slug: "path",
+        component: "GeomPath",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "unique", "connect", "manual", "ellipse"],
+        allowedPositions: ["identity"],
+        paramsType: "PathParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Path opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "curve",
+                description: 'Interpolation between points: "linear" (straight segments, default) or "step" (horizontal-then-vertical steps).',
+                typeSummary: '"linear" | "step"',
+                required: false,
+            },
+            {
+                name: "connection",
+                description: 'STAT CONNECT ONLY: how successive points join — "hv" (default), "vh", "mid", or "linear". Ignored for other stats.',
+                typeSummary: '"hv" | "vh" | "mid" | "linear"',
+                required: false,
+            },
+            {
+                name: "fun",
+                description: 'STAT MANUAL ONLY: portable named transform (first|last|mean|median|min|max|sum). Required when stat is "manual".',
+                typeSummary: '"first" | "last" | "mean" | "median" | "min" | "max" | "sum"',
+                required: false,
+            },
+            {
+                name: "level",
+                description: "STAT ELLIPSE ONLY: confidence level of the bivariate normal ellipse, strictly between 0 and 1. Default 0.95.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "type",
+                description: 'STAT ELLIPSE ONLY: construction type. Only "norm" (bivariate normal) is supported in v1.',
+                typeSummary: '"norm"',
+                required: false,
+            },
+            {
+                name: "segments",
+                description: "STAT ELLIPSE ONLY: number of perimeter samples before the closing duplicate (output length = segments + 1). Default 51.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    col: {
+        name: "col",
+        slug: "col",
+        component: "GeomCol",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "stack",
+        allowedStats: ["identity", "unique"],
+        allowedPositions: ["stack", "fill", "dodge", "identity"],
+        paramsType: "ColParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Bar opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "width",
+                description: "Bar width as a fraction of the band step. Must be greater than 0 and at most 1. Default 0.9.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    bar: {
+        name: "bar",
+        slug: "bar",
+        component: "GeomBar",
+        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.",
+        defaultStat: "count",
+        defaultPosition: "stack",
+        allowedStats: ["count", "bin"],
+        allowedPositions: ["stack", "fill", "dodge", "identity"],
+        paramsType: "BarParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Bar opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "width",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "bins",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT BIN ONLY: which edge of each bin is inclusive: "right" (default, matches) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    histogram: {
+        name: "histogram",
+        slug: "histogram",
+        component: "GeomHistogram",
+        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.",
+        defaultStat: "bin",
+        defaultPosition: "stack",
+        allowedStats: ["bin"],
+        allowedPositions: ["stack", "fill", "dodge", "identity"],
+        paramsType: "BarParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Bar opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "width",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "bins",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT BIN ONLY: which edge of each bin is inclusive: "right" (default, matches) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+        aliasOf: "bar",
+    },
+    freqpoly: {
+        name: "freqpoly",
+        slug: "freqpoly",
+        component: "GeomFreqpoly",
+        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.",
+        defaultStat: "bin",
+        defaultPosition: "identity",
+        allowedStats: ["bin"],
+        allowedPositions: ["identity"],
+        paramsType: "LineParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "curve",
+                description: 'Interpolation: "linear" (default), "step" (mid-x corners), "step-hv" (horizontal then vertical — correct for ECDF), or "step-vh".',
+                typeSummary: '"linear" | "step" | "step-hv" | "step-vh"',
+                required: false,
+            },
+            {
+                name: "pad",
+                description: "With stat ecdf: when true (default), prepend (xmin, 0) so step stairs start at zero. Finite-clamped.",
+                typeSummary: "boolean",
+                required: false,
+            },
+            {
+                name: "n",
+                description: "With stat ecdf: evaluate on n equally spaced x in [min, max] per group; omit for one point per unique x.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "connection",
+                description: 'STAT CONNECT ONLY: how successive points join — "hv" (default), "vh", "mid", or "linear". Ignored for other stats.',
+                typeSummary: '"hv" | "vh" | "mid" | "linear"',
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "STAT BIN / SUMMARY_BIN: number of bins (integer ≥ 1). Default 30 — an advisory reminds you to pick a real value. Overridden by binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "STAT BIN / SUMMARY_BIN: bin width in data units (must be greater than 0). Takes precedence over bins.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                description: "STAT BIN / SUMMARY_BIN: align a bin EDGE with this x value. Mutually exclusive with center.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT BIN / SUMMARY_BIN: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT BIN / SUMMARY_BIN: which edge of each bin is inclusive: "right" (default) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+            {
+                name: "window",
+                description: 'STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is "summary_rolling".',
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fun",
+                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".',
+                typeSummary: '"first" | "last" | "mean" | "median" | "min" | "max" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+        aliasOf: "line",
+    },
+    area: {
+        name: "area",
+        slug: "area",
+        component: "GeomArea",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "stack",
+        allowedStats: ["identity", "unique", "align"],
+        allowedPositions: ["stack", "fill", "dodge", "identity"],
+        paramsType: "AreaParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Area fill opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    rule: {
+        name: "rule",
+        slug: "rule",
+        component: "GeomRule",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "unique"],
+        allowedPositions: ["identity"],
+        paramsType: "RuleParams",
+        params: [
+            {
+                name: "xintercept",
+                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.",
+                typeSummary: "RuleIntercept",
+                required: false,
+            },
+            {
+                name: "yintercept",
+                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.",
+                typeSummary: "RuleIntercept",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Rule opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    hline: {
+        name: "hline",
+        slug: "hline",
+        component: "GeomHline",
+        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).",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "HlineParams",
+        params: [
+            {
+                name: "yintercept",
+                description: "ANNOTATION FORM ONLY: draw a horizontal rule at each of these fixed y positions. Mutually exclusive with mapping aes.y on this layer.",
+                typeSummary: "RuleIntercept",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Rule opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+        aliasOf: "rule",
+    },
+    vline: {
+        name: "vline",
+        slug: "vline",
+        component: "GeomVline",
+        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).",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "VlineParams",
+        params: [
+            {
+                name: "xintercept",
+                description: "ANNOTATION FORM ONLY: draw a vertical rule at each of these fixed x positions. Mutually exclusive with mapping aes.x on this layer.",
+                typeSummary: "RuleIntercept",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Rule opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+        aliasOf: "rule",
+    },
+    text: {
+        name: "text",
+        slug: "text",
+        component: "GeomText",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "unique"],
+        allowedPositions: ["identity", "nudge"],
+        paramsType: "TextParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Text opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Font size in px. Must be greater than 0. Default 11.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "anchor",
+                description: 'Horizontal text anchor relative to the (x, y) position: "start", "middle" (default), or "end".',
+                typeSummary: '"start" | "middle" | "end"',
+                required: false,
+            },
+            {
+                name: "dx",
+                description: "Horizontal offset in px applied after positioning. Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "dy",
+                description: "Vertical offset in px applied after positioning (positive = down). Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    label: {
+        name: "label",
+        slug: "label",
+        component: "GeomLabel",
+        summary: "Label geometry: text with a rounded rectangular background box. Requires x, y, and label channels. No collision detection.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity", "nudge"],
+        paramsType: "LabelParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Label opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Font size in px. Must be greater than 0. Default 11.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "anchor",
+                description: 'Horizontal text anchor relative to the (x, y) position: "start", "middle" (default), or "end".',
+                typeSummary: '"start" | "middle" | "end"',
+                required: false,
+            },
+            {
+                name: "dx",
+                description: "Horizontal offset in px applied after positioning. Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "dy",
+                description: "Vertical offset in px applied after positioning (positive = down). Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "padding",
+                description: "Uniform box padding around the text in px. Default 3.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "radius",
+                description: "Corner radius of the background box in px. Default 3.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Box outline stroke width in px. Default 0.5.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    smooth: {
+        name: "smooth",
+        slug: "smooth",
+        component: "GeomSmooth",
+        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.",
+        defaultStat: "smooth",
+        defaultPosition: "identity",
+        allowedStats: ["smooth"],
+        allowedPositions: ["identity"],
+        paramsType: "SmoothParams",
+        params: [
+            {
+                name: "method",
+                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).',
+                typeSummary: '"lm" | "loess"',
+                required: false,
+            },
+            {
+                name: "se",
+                description: "Draw the confidence-interval ribbon around the fit. Default true.",
+                typeSummary: "boolean",
+                required: false,
+            },
+            {
+                name: "level",
+                description: "Confidence level of the ribbon, strictly between 0 and 1. Default 0.95.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "span",
+                description: "LOESS ONLY: fraction of points in each local neighborhood, greater than 0 and at most 1. Default 0.75. Smaller = wigglier.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "degree",
+                description: "LOESS ONLY: degree of the local polynomial, 1 or 2. Default 2 (the R default).",
+                typeSummary: "1 | 2",
+                required: false,
+            },
+            {
+                name: "n",
+                description: "Number of evaluation points along x (an integer between 2 and 5000). Default 80.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width of the fitted line in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint for the fitted line (not a data scale).",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    quantile: {
+        name: "quantile",
+        slug: "quantile",
+        component: "GeomQuantile",
+        summary: "Quantile geometry: linear quantile regression lines (y ~ x) at one or more conditional quantiles of y, one line per quantile per group.",
+        defaultStat: "quantile",
+        defaultPosition: "identity",
+        allowedStats: ["quantile"],
+        allowedPositions: ["identity"],
+        paramsType: "QuantileParams",
+        params: [
+            {
+                name: "quantiles",
+                description: "Conditional quantiles of y to fit and draw. Each entry must be in (0, 1). Default [0.25, 0.5, 0.75].",
+                typeSummary: "Array<number>",
+                required: false,
+            },
+            {
+                name: "n",
+                description: "Number of evaluation points along x (integer 2–5000). Default 80. Linear fits need only endpoints; denser grids help nonlinear coords.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width of quantile lines in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint for quantile lines (not a data scale).",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    boxplot: {
+        name: "boxplot",
+        slug: "boxplot",
+        component: "GeomBoxplot",
+        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.",
+        defaultStat: "boxplot",
+        defaultPosition: "dodge",
+        allowedStats: ["boxplot"],
+        allowedPositions: ["dodge", "identity"],
+        paramsType: "BoxplotParams",
+        params: [
+            {
+                name: "width",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "coef",
+                description: "Whisker length as a multiple of the IQR (values beyond it are outliers). Must be at least 0. Default 1.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "outlierSize",
+                description: "Outlier point radius in px. Must be greater than 0. Default 1.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Layer opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    density: {
+        name: "density",
+        slug: "density",
+        component: "GeomDensity",
+        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.",
+        defaultStat: "density",
+        defaultPosition: "identity",
+        allowedStats: ["density"],
+        allowedPositions: ["identity"],
+        paramsType: "DensityParams",
+        params: [
+            {
+                name: "bw",
+                description: "Kernel bandwidth in data units (must be greater than 0). Omit for R's bw.nrd0 rule-of-thumb default.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "adjust",
+                description: "Bandwidth multiplier (must be greater than 0). Default 1. 0.5 = half the default bandwidth (wigglier), 2 = double (smoother).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "n",
+                description: "Number of grid points the density is evaluated at (an integer between 2 and 4096). Default 512 (the R default).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "cut",
+                description: "The grid extends cut * bandwidth beyond the data extremes (at least 0). Default 3 (the R default).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Area fill opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    errorbar: {
+        name: "errorbar",
+        slug: "errorbar",
+        component: "GeomErrorbar",
+        summary: "Errorbar geometry: a vertical range with caps at ymin and ymax, one per data row (identity stat) or per x group (summary stat).",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "unique", "summary", "summary_bin"],
+        allowedPositions: ["identity"],
+        paramsType: "ErrorbarParams",
+        params: [
+            {
+                name: "width",
+                description: "Cap width as a fraction of the band step. Must be greater than 0 and at most 1. Default 0.9.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Errorbar opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fun",
+                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.',
+                typeSummary: '"mean" | "median" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY ONLY: summary function for the lower bound (ymin). Overrides the mean_se default.",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY / SUMMARY_BIN: summary function for the upper bound (ymax). Overrides the mean_se default.",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: "right" (default) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+        ],
+    },
+    linerange: {
+        name: "linerange",
+        slug: "linerange",
+        component: "GeomLinerange",
+        summary: "Linerange geometry: a vertical stem from ymin to ymax without end caps.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "summary"],
+        allowedPositions: ["identity"],
+        paramsType: "LinerangeParams",
+        params: [
+            {
+                name: "width",
+                description: "Cap width as a fraction of the band step. Must be greater than 0 and at most 1. Default 0.9.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Errorbar opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fun",
+                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.',
+                typeSummary: '"mean" | "median" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY ONLY: summary function for the lower bound (ymin). Overrides the mean_se default.",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY / SUMMARY_BIN: summary function for the upper bound (ymax). Overrides the mean_se default.",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: "right" (default) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+        ],
+    },
+    pointrange: {
+        name: "pointrange",
+        slug: "pointrange",
+        component: "GeomPointrange",
+        summary: "Pointrange geometry: vertical stem from ymin to ymax plus a point at (x, y).",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "summary"],
+        allowedPositions: ["identity"],
+        paramsType: "PointrangeParams",
+        params: [
+            {
+                name: "linewidth",
+                description: "Stem stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Opacity for stem and point. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Mid-point radius in px. Default 2.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "shape",
+                description: 'Mid-point shape. Default "circle".',
+                typeSummary: '"circle" | "triangle" | "square" | "diamond" | "plus" | "cross" | "circle-open"',
+                required: false,
+            },
+            {
+                name: "fun",
+                description: 'STAT SUMMARY ONLY: center summary of y per x group. Default "mean" (mean_se when funMin/funMax omitted).',
+                typeSummary: '"mean" | "median" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY ONLY: summary function for the lower bound (ymin). Overrides the mean_se default.",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY ONLY: summary function for the upper bound (ymax). Overrides the mean_se default.",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+        ],
+    },
+    crossbar: {
+        name: "crossbar",
+        slug: "crossbar",
+        component: "GeomCrossbar",
+        summary: "Crossbar geometry: a vertical interval box from ymin to ymax with a mid horizontal line at y.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "summary"],
+        allowedPositions: ["identity"],
+        paramsType: "CrossbarParams",
+        params: [
+            {
+                name: "width",
+                description: "Box width: band-step fraction (band x) or fraction of continuous resolution (same rule as errorbar caps). Default 0.9.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fatten",
+                description: "Multiplier for the mid-line linewidth relative to params.linewidth / aes.linewidth. Default 2.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Outline and base mid-line stroke width in px. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Box and mid-line opacity. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fun",
+                description: 'STAT SUMMARY ONLY: center summary. Default "mean".',
+                typeSummary: '"mean" | "median" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY ONLY: summary function for the lower bound (ymin). Overrides the mean_se default.",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY ONLY: summary function for the upper bound (ymax). Overrides the mean_se default.",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+        ],
+    },
+    rect: {
+        name: "rect",
+        slug: "rect",
+        component: "GeomRect",
+        summary: "Rectangle geometry: one rectangle per data row from mapped xmin/xmax/ymin/ymax edges. Use for arbitrary shaded regions and time bands.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "unique"],
+        allowedPositions: ["identity"],
+        paramsType: "RectParams",
+        params: [
+            {
+                name: "linewidth",
+                description: "Outline stroke width in px when color is set. Must be greater than 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Rectangle opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient outline paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    tile: {
+        name: "tile",
+        slug: "tile",
+        component: "GeomTile",
+        summary: "Tile geometry: center-sized cells at (x, y) with optional width/height. Use for heatmaps and gridded categorical cells; supports stroke outlines.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "TileParams",
+        params: [
+            {
+                name: "width",
+                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).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "height",
+                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).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Outline stroke width in px when color is set. Must be greater than 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Tile opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient outline paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    raster: {
+        name: "raster",
+        slug: "raster",
+        component: "GeomRaster",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "RasterParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Raster opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "hjust",
+                description: "Horizontal justification of each cell over its x center (0–1). Default 0.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "vjust",
+                description: "Vertical justification of each cell over its y center (0–1). Default 0.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "interpolate",
+                description: "Interpolation between cells. Only false (nearest / no interpolation) is supported.",
+                typeSummary: "boolean",
+                required: false,
+            },
+        ],
+    },
+    ribbon: {
+        name: "ribbon",
+        slug: "ribbon",
+        component: "GeomRibbon",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "unique"],
+        allowedPositions: ["identity"],
+        paramsType: "RibbonParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Ribbon fill opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Outline stroke width in px when an outline is drawn. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "outline",
+                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.',
+                typeSummary: '"both" | "upper" | "lower" | "full"',
+                required: false,
+            },
+            {
+                name: "orientation",
+                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.',
+                typeSummary: '"x" | "y"',
+                required: false,
+            },
+            {
+                name: "lineend",
+                description: 'SVG stroke-linecap for outlines. Default "butt".',
+                typeSummary: '"butt" | "round" | "square"',
+                required: false,
+            },
+            {
+                name: "linejoin",
+                description: 'SVG stroke-linejoin for outlines. Default "round".',
+                typeSummary: '"miter" | "round" | "bevel"',
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient outline paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    segment: {
+        name: "segment",
+        slug: "segment",
+        component: "GeomSegment",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity", "unique"],
+        allowedPositions: ["identity"],
+        paramsType: "SegmentParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Segment opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "lineend",
+                description: 'SVG stroke-linecap for segment ends. Default "butt".',
+                typeSummary: '"butt" | "round" | "square"',
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    count: {
+        name: "count",
+        slug: "count",
+        component: "GeomCount",
+        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.",
+        defaultStat: "sum",
+        defaultPosition: "identity",
+        allowedStats: ["sum"],
+        allowedPositions: ["identity", "jitter", "nudge"],
+        paramsType: "PointParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Point radius in px. Must be greater than 0. Default 2.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "shape",
+                description: 'Point shape. One of "circle", "triangle", "square", "diamond", "plus", "cross", "circle-open". Default "circle".',
+                typeSummary: '"circle" | "triangle" | "square" | "diamond" | "plus" | "cross" | "circle-open"',
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: "right" (default) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+            {
+                name: "window",
+                description: 'STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is "summary_rolling".',
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fun",
+                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".',
+                typeSummary: '"first" | "last" | "mean" | "median" | "min" | "max" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+        ],
+    },
+    violin: {
+        name: "violin",
+        slug: "violin",
+        component: "GeomViolin",
+        summary: "Violin geometry: mirrored kernel density of continuous y at each discrete x (stat ydensity). One polygon per x×group. Default position dodge.",
+        defaultStat: "ydensity",
+        defaultPosition: "dodge",
+        allowedStats: ["ydensity"],
+        allowedPositions: ["dodge", "identity"],
+        paramsType: "ViolinParams",
+        params: [
+            {
+                name: "bw",
+                description: "Kernel bandwidth in data units (must be greater than 0). Omit for R's bw.nrd0 rule-of-thumb default.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "adjust",
+                description: "Bandwidth multiplier (must be greater than 0). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "n",
+                description: "Number of density grid points (2–4096). Default 512.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "trim",
+                description: "When true (default), trim the density to the data range; when false, extend cut·bw tails like density().",
+                typeSummary: "boolean",
+                required: false,
+            },
+            {
+                name: "scale",
+                description: 'Relative violin max-width scaling: "area" (default), "count", or "width" (equal max width).',
+                typeSummary: '"area" | "count" | "width"',
+                required: false,
+            },
+            {
+                name: "width",
+                description: "Max violin width as a fraction of the discrete x band (like boxplot). Default 0.75.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Fill opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Outline stroke width in px. Must be greater than 0. Default 0.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    function: {
+        name: "function",
+        slug: "function",
+        component: "GeomFunction",
+        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.",
+        defaultStat: "function",
+        defaultPosition: "identity",
+        allowedStats: ["function"],
+        allowedPositions: ["identity"],
+        paramsType: "FunctionParams",
+        params: [
+            {
+                name: "fun",
+                description: "Required named function from the portable registry.",
+                typeSummary: "FunctionRegistryName",
+                required: true,
+            },
+            {
+                name: "n",
+                description: "Number of evaluation grid points (2–10000). Default 101.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "xlim",
+                description: "Evaluation domain [min, max] (min < max). When omitted, uses continuous aes.x extent or peer-layer x domain.",
+                typeSummary: "Array<number>",
+                required: false,
+            },
+            {
+                name: "args",
+                description: "Optional named arguments for the registry function (e.g. mean and sd for dnorm). Keys and values must be portable JSON.",
+                typeSummary: "FunctionArgs",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Path opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    polygon: {
+        name: "polygon",
+        slug: "polygon",
+        component: "GeomPolygon",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "PolygonParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Polygon fill/stroke opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Outline stroke width in px. Must be greater than 0. Default matches line (1.5).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    hex: {
+        name: "hex",
+        slug: "hex",
+        component: "GeomHex",
+        summary: "Hexagonal bin heatmap: partitions continuous x×y into a hexagonal lattice and maps fill to bin count by default.",
+        defaultStat: "bin_hex",
+        defaultPosition: "identity",
+        allowedStats: ["bin_hex"],
+        allowedPositions: ["identity"],
+        paramsType: "HexParams",
+        params: [
+            {
+                name: "bins",
+                description: "Approximate number of hex bins across the x range. Default 30.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "drop",
+                description: "When true (default), omit zero-count hexes from the output.",
+                typeSummary: "boolean",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Hex opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Outline stroke width in px when color is set. Default 0 (no outline).",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    bin_2d: {
+        name: "bin_2d",
+        slug: "bin_2d",
+        component: "GeomBin2d",
+        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.",
+        defaultStat: "bin_2d",
+        defaultPosition: "identity",
+        allowedStats: ["bin_2d"],
+        allowedPositions: ["identity"],
+        paramsType: "Bin2dParams",
+        params: [
+            {
+                name: "bins",
+                description: "Number of bins on each axis. Default 30. Applies equally to x and y in v1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "Shared bin width in data units for both axes (overrides bins). Prefer when the scale units are meaningful.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "drop",
+                description: "When true (default), omit zero-count bins from the output.",
+                typeSummary: "boolean",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Cell opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Outline stroke width in px when color is set. Must be greater than 0.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    abline: {
+        name: "abline",
+        slug: "abline",
+        component: "GeomAbline",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "AblineParams",
+        params: [
+            {
+                name: "slope",
+                description: "Line slope (rise/run). Default 1 (identity line when intercept is 0).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "intercept",
+                description: "Y-intercept in data units. Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    curve: {
+        name: "curve",
+        slug: "curve",
+        component: "GeomCurve",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "CurveParams",
+        params: [
+            {
+                name: "curvature",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "angle",
+                description: "Control-point direction relative to the chord, in degrees. default 90 (perpendicular).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "ncp",
+                description: "Smoothness density knob. Maps to tessellation sample count = max(8, ncp×8); not multi-control xspline. Default 5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Curve opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "lineend",
+                description: 'SVG stroke-linecap for curve ends. Default "butt".',
+                typeSummary: '"butt" | "round" | "square"',
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    contour: {
+        name: "contour",
+        slug: "contour",
+        component: "GeomContour",
+        summary: "Contour geometry: isolines of a continuous z surface over a regular x×y grid. v1 draws open path polylines only (not filled bands).",
+        defaultStat: "contour",
+        defaultPosition: "identity",
+        allowedStats: ["contour"],
+        allowedPositions: ["identity"],
+        paramsType: "ContourParams",
+        params: [
+            {
+                name: "bins",
+                description: "Number of evenly spaced contour levels from min(z) to max(z) inclusive (integer ≥ 1). Default 10. Overridden by breaks or binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "Contour level step in z units (must be greater than 0). Takes precedence over bins; overridden by breaks.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "breaks",
+                description: "Explicit contour levels (finite numbers). Overrides bins and binwidth when non-empty.",
+                typeSummary: "Array<number>",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width of contour lines in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    density_2d: {
+        name: "density_2d",
+        slug: "density_2d",
+        component: "GeomDensity2d",
+        summary: "2D density geometry: bivariate KDE isolines over continuous x and y. Open path contours.",
+        defaultStat: "density_2d",
+        defaultPosition: "identity",
+        allowedStats: ["density_2d"],
+        allowedPositions: ["identity"],
+        paramsType: "Density2dParams",
+        params: [
+            {
+                name: "h",
+                description: "Kernel bandwidth: one positive number for both axes, or [hx, hy]. Omit for MASS bandwidth.nrd per axis (then kde2d h/4 scaling).",
+                typeSummary: "number | Array<number>",
+                required: false,
+            },
+            {
+                name: "adjust",
+                description: "Bandwidth multiplier (must be greater than 0). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "n",
+                description: "Grid resolution per axis for the KDE surface (integer 10–200). Default 100.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "Number of contour levels of the density surface (integer ≥ 1). Default 10. Overridden by breaks.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "Contour level step in density units. Overridden by breaks.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "breaks",
+                description: "Explicit density contour levels. Overrides bins and binwidth.",
+                typeSummary: "Array<number>",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width of density contours in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    density_2d_filled: {
+        name: "density_2d_filled",
+        slug: "density_2d_filled",
+        component: "GeomDensity2dFilled",
+        summary: "2D density filled bands: bivariate KDE closed isoline rings filled by density level. Open rings dropped. Defaults fill to after_stat(level).",
+        defaultStat: "density_2d_filled",
+        defaultPosition: "identity",
+        allowedStats: ["density_2d_filled"],
+        allowedPositions: ["identity"],
+        paramsType: "Density2dParams",
+        params: [
+            {
+                name: "h",
+                description: "Kernel bandwidth: one positive number for both axes, or [hx, hy]. Omit for MASS bandwidth.nrd per axis (then kde2d h/4 scaling).",
+                typeSummary: "number | Array<number>",
+                required: false,
+            },
+            {
+                name: "adjust",
+                description: "Bandwidth multiplier (must be greater than 0). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "n",
+                description: "Grid resolution per axis for the KDE surface (integer 10–200). Default 100.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "Number of contour levels of the density surface (integer ≥ 1). Default 10. Overridden by breaks.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "Contour level step in density units. Overridden by breaks.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "breaks",
+                description: "Explicit density contour levels. Overrides bins and binwidth.",
+                typeSummary: "Array<number>",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width of density contours in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    dotplot: {
+        name: "dotplot",
+        slug: "dotplot",
+        component: "GeomDotplot",
+        summary: "Dotplot geometry: stacked dots along a continuous x axis (histodot subset). Do not map aes.y — the bindot stat computes stack positions.",
+        defaultStat: "bindot",
+        defaultPosition: "identity",
+        allowedStats: ["bindot"],
+        allowedPositions: ["identity"],
+        paramsType: "DotplotParams",
+        params: [
+            {
+                name: "bins",
+                description: "Number of bins (integer ≥ 1). Default 30 — advisory when neither bins nor binwidth is set. Overridden by binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                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.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                description: "Align a bin edge to this value (mutually exclusive with center).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "Align a bin center to this value (mutually exclusive with boundary).",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'Which side of each bin is closed: "right" (default, (lo, hi]) or "left" ([lo, hi)).',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+            {
+                name: "stackdir",
+                description: 'Stack direction: "up" (default), "down", "center", or "centerwhole" (integer-aligned center).',
+                typeSummary: '"up" | "down" | "center" | "centerwhole"',
+                required: false,
+            },
+            {
+                name: "stackratio",
+                description: "Relative spacing between stacked dots (must be greater than 0). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "dotsize",
+                description: "Multiplier on diameter derived from binwidth × x-scale (must be greater than 0). Default 1. Ignored when params.size is set.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Point radius in px (must be greater than 0). When set, overrides binwidth-derived sizing.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "shape",
+                description: 'Point shape. One of "circle", "triangle", "square", "diamond", "plus", "cross", "circle-open". Default "circle".',
+                typeSummary: '"circle" | "triangle" | "square" | "diamond" | "plus" | "cross" | "circle-open"',
+                required: false,
+            },
+        ],
+    },
+    map: {
+        name: "map",
+        slug: "map",
+        component: "GeomMap",
+        summary: "Map geometry: join fortified region borders to value rows via aes.map_id and params.map. Renders closed filled paths per region.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "MapParams",
+        params: [
+            {
+                name: "map",
+                description: "Fortified map coordinates ({ values }, { columns }, or { name } against spec.datasets). Must include long+lat or x+y, plus a region id column.",
+                typeSummary: "DataRef",
+                required: true,
+            },
+            {
+                name: "mapId",
+                description: 'Join column name in the map data (matched to aes.map_id). Default: "region", then "id".',
+                typeSummary: "string",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Region fill opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Region outline stroke width in px. Must be greater than 0. Default 1.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (not a data scale).",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale).",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    sf: {
+        name: "sf",
+        slug: "sf",
+        component: "GeomSf",
+        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).",
+        defaultStat: "sf",
+        defaultPosition: "identity",
+        allowedStats: ["sf"],
+        allowedPositions: ["identity"],
+        paramsType: "SfParams",
+        params: [
+            {
+                name: "geometry",
+                description: 'Name of the data column holding GeoJSON Geometry JSON strings. Default "geometry". Already-projected coordinates only.',
+                typeSummary: "string",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Mark opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px for lines/polygon outlines. Must be greater than 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Point radius in px when geometries are Point/MultiPoint.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fillPaint",
+                description: "Within-mark gradient fill paint (polygon family; not a data scale).",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale).",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    sf_text: {
+        name: "sf_text",
+        slug: "sf_text",
+        component: "GeomSfText",
+        summary: "Simple-features text labels: places aes.label at representative geometry points (Multi* → one label per part; stat_sf_coordinates).",
+        defaultStat: "sf_coordinates",
+        defaultPosition: "identity",
+        allowedStats: ["sf_coordinates"],
+        allowedPositions: ["identity"],
+        paramsType: "SfTextParams",
+        params: [
+            {
+                name: "geometry",
+                description: 'Name of the data column holding GeoJSON Geometry JSON strings. Default "geometry".',
+                typeSummary: "string",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Text opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Font size in px. Must be greater than 0. Default 11.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "anchor",
+                description: 'Horizontal text anchor relative to the representative point: "start", "middle" (default), or "end".',
+                typeSummary: '"start" | "middle" | "end"',
+                required: false,
+            },
+            {
+                name: "dx",
+                description: "Horizontal offset in px applied after positioning. Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "dy",
+                description: "Vertical offset in px applied after positioning (positive = down). Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    sf_label: {
+        name: "sf_label",
+        slug: "sf_label",
+        component: "GeomSfLabel",
+        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.",
+        defaultStat: "sf_coordinates",
+        defaultPosition: "identity",
+        allowedStats: ["sf_coordinates"],
+        allowedPositions: ["identity"],
+        paramsType: "SfLabelParams",
+        params: [
+            {
+                name: "geometry",
+                description: 'Name of the data column holding GeoJSON Geometry JSON strings. Default "geometry".',
+                typeSummary: "string",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Label opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Font size in px. Must be greater than 0. Default 11.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "anchor",
+                description: 'Horizontal text anchor relative to the representative point: "start", "middle" (default), or "end".',
+                typeSummary: '"start" | "middle" | "end"',
+                required: false,
+            },
+            {
+                name: "dx",
+                description: "Horizontal offset in px applied after positioning. Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "dy",
+                description: "Vertical offset in px applied after positioning (positive = down). Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "padding",
+                description: "Box padding around the text in px. Default 3.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "radius",
+                description: "Box corner radius in px. Default 3.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Box stroke width in px. Default 0.5.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    blank: {
+        name: "blank",
+        slug: "blank",
+        component: "GeomBlank",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "BlankParams",
+        params: [],
+    },
+    jitter: {
+        name: "jitter",
+        slug: "jitter",
+        component: "GeomJitter",
+        summary: "Jittered point alias. Canonicalized by normalize() to a point layer with position jitter. Configure jitter amount via positionParams.width/height/seed.",
+        defaultStat: "identity",
+        defaultPosition: "jitter",
+        allowedStats: ["identity"],
+        allowedPositions: ["jitter"],
+        paramsType: "PointParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Point radius in px. Must be greater than 0. Default 2.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "shape",
+                description: 'Point shape. One of "circle", "triangle", "square", "diamond", "plus", "cross", "circle-open". Default "circle".',
+                typeSummary: '"circle" | "triangle" | "square" | "diamond" | "plus" | "cross" | "circle-open"',
+                required: false,
+            },
+            {
+                name: "bins",
+                description: "STAT SUMMARY_BIN ONLY: number of bins (integer ≥ 1). Default 30 — advisory. Overridden by binwidth.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "binwidth",
+                description: "STAT SUMMARY_BIN ONLY: bin width in data units (must be greater than 0). Takes precedence over bins.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "boundary",
+                description: "STAT SUMMARY_BIN ONLY: align a bin EDGE with this x value. Mutually exclusive with center.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "center",
+                description: "STAT SUMMARY_BIN ONLY: align a bin CENTER with this x value. Mutually exclusive with boundary.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "closed",
+                description: 'STAT SUMMARY_BIN ONLY: which edge of each bin is inclusive: "right" (default) or "left".',
+                typeSummary: '"right" | "left"',
+                required: false,
+            },
+            {
+                name: "window",
+                description: 'STAT SUMMARY_ROLLING ONLY: centered rolling-window width in x data units (must be greater than 0). Required when stat is "summary_rolling".',
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "fun",
+                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".',
+                typeSummary: '"first" | "last" | "mean" | "median" | "min" | "max" | "sum"',
+                required: false,
+            },
+            {
+                name: "funMin",
+                description: "STAT SUMMARY_BIN ONLY: lower bound summary (ymin).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+            {
+                name: "funMax",
+                description: "STAT SUMMARY_BIN ONLY: upper bound summary (ymax).",
+                typeSummary: "SummaryFun",
+                required: false,
+            },
+        ],
+        aliasOf: "point",
+    },
+    spoke: {
+        name: "spoke",
+        slug: "spoke",
+        component: "GeomSpoke",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "SpokeParams",
+        params: [
+            {
+                name: "angle",
+                description: "Constant spoke direction in radians when aes.angle is not mapped. 0 = +x, π/2 = +y.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "radius",
+                description: "Constant spoke length in data units when aes.radius is not mapped. Must be greater than 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Spoke opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "lineend",
+                description: 'SVG stroke-linecap for spoke ends. Default "butt".',
+                typeSummary: '"butt" | "round" | "square"',
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    rug: {
+        name: "rug",
+        slug: "rug",
+        component: "GeomRug",
+        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.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "RugParams",
+        params: [
+            {
+                name: "sides",
+                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.',
+                typeSummary: "string",
+                required: false,
+            },
+            {
+                name: "length",
+                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.',
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "alpha",
+                description: "Tick opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+    step: {
+        name: "step",
+        slug: "step",
+        component: "GeomStep",
+        summary: "Step-line geometry: connect points with hv/vh/mid stairs. Same channels as line; ordered by x within groups.",
+        defaultStat: "identity",
+        defaultPosition: "identity",
+        allowedStats: ["identity"],
+        allowedPositions: ["identity"],
+        paramsType: "StepParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Step-line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.5.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "direction",
+                description: 'Step corner placement: "hv" horizontal then vertical (default), "vh" vertical then horizontal, "mid" change at the midpoint between x positions.',
+                typeSummary: '"hv" | "vh" | "mid"',
+                required: false,
+            },
+            {
+                name: "strokePaint",
+                description: "Within-mark gradient stroke paint (not a data scale). Requires a solid fallback.",
+                typeSummary: "GradientPaint",
+                required: false,
+            },
+            {
+                name: "glow",
+                description: "Bounded within-mark glow treatment (not theme decoration).",
+                typeSummary: "GlowSpec",
+                required: false,
+            },
+        ],
+    },
+    qq: {
+        name: "qq",
+        slug: "qq",
+        component: "GeomQq",
+        summary: "Q–Q scatter: sample quantiles vs theoretical normal quantiles. Requires aes.sample.",
+        defaultStat: "qq",
+        defaultPosition: "identity",
+        allowedStats: ["qq"],
+        allowedPositions: ["identity"],
+        paramsType: "QqParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Point opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "size",
+                description: "Point size in px. Must be greater than 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "shape",
+                description: 'Point shape. One of "circle", "triangle", "square", "diamond", "plus", "cross", "circle-open". Default "circle".',
+                typeSummary: '"circle" | "triangle" | "square" | "diamond" | "plus" | "cross" | "circle-open"',
+                required: false,
+            },
+        ],
+    },
+    qq_line: {
+        name: "qq_line",
+        slug: "qq_line",
+        component: "GeomQqLine",
+        summary: "Q–Q reference line: line through sample/theoretical quartile match, spanning the theoretical range of the Q–Q cloud. Requires aes.sample.",
+        defaultStat: "qq_line",
+        defaultPosition: "identity",
+        allowedStats: ["qq_line"],
+        allowedPositions: ["identity"],
+        paramsType: "QqLineParams",
+        params: [
+            {
+                name: "alpha",
+                description: "Line opacity. Must be between 0 and 1 (inclusive). Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "linewidth",
+                description: "Stroke width in px. Must be greater than 0. Default 1.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+    },
+};
+//# sourceMappingURL=geom-reference-data.js.map