@ggts-sh/spec 0.43.0

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

@@ -0,0 +1,82 @@
+/**
+ * AUTO-GENERATED by scripts/gen-reference-catalogs.ts — do not edit by hand.
+ * Regenerate: bun run reference:catalogs:gen
+ *
+ * POSITION_REFERENCE — per-position API docs.
+ */
+export declare const POSITION_REFERENCE_DATA: {
+    readonly identity: {
+        readonly name: "identity";
+        readonly slug: "identity";
+        readonly summary: "Leave mark coordinates unchanged. Default for most geoms: each mark keeps its post-stat (x, y).";
+        readonly params: readonly [];
+        readonly compatibleGeoms: readonly ["point", "line", "path", "col", "bar", "histogram", "freqpoly", "area", "rule", "hline", "vline", "text", "label", "smooth", "quantile", "boxplot", "density", "errorbar", "linerange", "pointrange", "crossbar", "rect", "tile", "raster", "ribbon", "segment", "count", "violin", "function", "polygon", "hex", "bin_2d", "abline", "curve", "contour", "density_2d", "density_2d_filled", "dotplot", "map", "sf", "sf_text", "sf_label", "blank", "spoke", "rug", "step", "qq", "qq_line"];
+        readonly defaultForGeoms: readonly ["point", "line", "path", "freqpoly", "rule", "hline", "vline", "text", "label", "smooth", "quantile", "density", "errorbar", "linerange", "pointrange", "crossbar", "rect", "tile", "raster", "ribbon", "segment", "count", "function", "polygon", "hex", "bin_2d", "abline", "curve", "contour", "density_2d", "density_2d_filled", "dotplot", "map", "sf", "sf_text", "sf_label", "blank", "spoke", "rug", "step", "qq", "qq_line"];
+    };
+    readonly stack: {
+        readonly name: "stack";
+        readonly slug: "stack";
+        readonly summary: "Stack groups at each x slot so heights accumulate (positive up, negative down). Default for bar, col, histogram, and area; trains the scale on stacked totals.";
+        readonly params: readonly [];
+        readonly compatibleGeoms: readonly ["col", "bar", "histogram", "area"];
+        readonly defaultForGeoms: readonly ["col", "bar", "histogram", "area"];
+    };
+    readonly fill: {
+        readonly name: "fill";
+        readonly slug: "fill";
+        readonly summary: "Stack groups then rescale each x slot to proportions (positive and negative runs separately). Same geom set as stack; y domain becomes proportions.";
+        readonly params: readonly [];
+        readonly compatibleGeoms: readonly ["col", "bar", "histogram", "area"];
+        readonly defaultForGeoms: readonly [];
+    };
+    readonly dodge: {
+        readonly name: "dodge";
+        readonly slug: "dodge";
+        readonly summary: "Place groups side by side within each x band instead of overlapping. Default for boxplot and violin; used when comparing categories at the same x.";
+        readonly params: readonly [];
+        readonly compatibleGeoms: readonly ["col", "bar", "histogram", "area", "boxplot", "violin"];
+        readonly defaultForGeoms: readonly ["boxplot", "violin"];
+    };
+    readonly jitter: {
+        readonly name: "jitter";
+        readonly slug: "jitter";
+        readonly summary: "Add seeded random offsets so overplotted points separate. Configure with positionParams width/height/seed (always seeded for reproducibility).";
+        readonly params: readonly [{
+            readonly name: "width";
+            readonly description: "JITTER ONLY: maximum horizontal jitter amount — data units on continuous x, band-step fractions on discrete x. Default 40% of the data resolution.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "height";
+            readonly description: "JITTER ONLY: maximum vertical jitter amount — data units on continuous y, band-step fractions on discrete y. Default 40% of the data resolution.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "seed";
+            readonly description: "JITTER ONLY: RNG seed (a non-negative integer). Default 42. ggts jitter is ALWAYS seeded so renders are reproducible (deliberate divergence from random jitter).";
+            readonly typeSummary: "integer";
+            readonly required: false;
+        }];
+        readonly compatibleGeoms: readonly ["point", "count", "jitter"];
+        readonly defaultForGeoms: readonly ["jitter"];
+    };
+    readonly nudge: {
+        readonly name: "nudge";
+        readonly slug: "nudge";
+        readonly summary: "Apply a fixed offset (positionParams.x / y) per mark — useful for labels beside points. Offsets are data units or band-step fractions.";
+        readonly params: readonly [{
+            readonly name: "x";
+            readonly description: "NUDGE ONLY: horizontal offset — data units on continuous x, band-step fractions on discrete x. Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }, {
+            readonly name: "y";
+            readonly description: "NUDGE ONLY: vertical offset — data units on continuous y, band-step fractions on discrete y. Default 0.";
+            readonly typeSummary: "number";
+            readonly required: false;
+        }];
+        readonly compatibleGeoms: readonly ["point", "text", "label", "count"];
+        readonly defaultForGeoms: readonly [];
+    };
+};
+//# sourceMappingURL=position-reference-data.d.ts.map

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

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

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

@@ -0,0 +1,181 @@
+/**
+ * AUTO-GENERATED by scripts/gen-reference-catalogs.ts — do not edit by hand.
+ * Regenerate: bun run reference:catalogs:gen
+ *
+ * POSITION_REFERENCE — per-position API docs.
+ */
+export const POSITION_REFERENCE_DATA = {
+    identity: {
+        name: "identity",
+        slug: "identity",
+        summary: "Leave mark coordinates unchanged. Default for most geoms: each mark keeps its post-stat (x, y).",
+        params: [],
+        compatibleGeoms: [
+            "point",
+            "line",
+            "path",
+            "col",
+            "bar",
+            "histogram",
+            "freqpoly",
+            "area",
+            "rule",
+            "hline",
+            "vline",
+            "text",
+            "label",
+            "smooth",
+            "quantile",
+            "boxplot",
+            "density",
+            "errorbar",
+            "linerange",
+            "pointrange",
+            "crossbar",
+            "rect",
+            "tile",
+            "raster",
+            "ribbon",
+            "segment",
+            "count",
+            "violin",
+            "function",
+            "polygon",
+            "hex",
+            "bin_2d",
+            "abline",
+            "curve",
+            "contour",
+            "density_2d",
+            "density_2d_filled",
+            "dotplot",
+            "map",
+            "sf",
+            "sf_text",
+            "sf_label",
+            "blank",
+            "spoke",
+            "rug",
+            "step",
+            "qq",
+            "qq_line",
+        ],
+        defaultForGeoms: [
+            "point",
+            "line",
+            "path",
+            "freqpoly",
+            "rule",
+            "hline",
+            "vline",
+            "text",
+            "label",
+            "smooth",
+            "quantile",
+            "density",
+            "errorbar",
+            "linerange",
+            "pointrange",
+            "crossbar",
+            "rect",
+            "tile",
+            "raster",
+            "ribbon",
+            "segment",
+            "count",
+            "function",
+            "polygon",
+            "hex",
+            "bin_2d",
+            "abline",
+            "curve",
+            "contour",
+            "density_2d",
+            "density_2d_filled",
+            "dotplot",
+            "map",
+            "sf",
+            "sf_text",
+            "sf_label",
+            "blank",
+            "spoke",
+            "rug",
+            "step",
+            "qq",
+            "qq_line",
+        ],
+    },
+    stack: {
+        name: "stack",
+        slug: "stack",
+        summary: "Stack groups at each x slot so heights accumulate (positive up, negative down). Default for bar, col, histogram, and area; trains the scale on stacked totals.",
+        params: [],
+        compatibleGeoms: ["col", "bar", "histogram", "area"],
+        defaultForGeoms: ["col", "bar", "histogram", "area"],
+    },
+    fill: {
+        name: "fill",
+        slug: "fill",
+        summary: "Stack groups then rescale each x slot to proportions (positive and negative runs separately). Same geom set as stack; y domain becomes proportions.",
+        params: [],
+        compatibleGeoms: ["col", "bar", "histogram", "area"],
+        defaultForGeoms: [],
+    },
+    dodge: {
+        name: "dodge",
+        slug: "dodge",
+        summary: "Place groups side by side within each x band instead of overlapping. Default for boxplot and violin; used when comparing categories at the same x.",
+        params: [],
+        compatibleGeoms: ["col", "bar", "histogram", "area", "boxplot", "violin"],
+        defaultForGeoms: ["boxplot", "violin"],
+    },
+    jitter: {
+        name: "jitter",
+        slug: "jitter",
+        summary: "Add seeded random offsets so overplotted points separate. Configure with positionParams width/height/seed (always seeded for reproducibility).",
+        params: [
+            {
+                name: "width",
+                description: "JITTER ONLY: maximum horizontal jitter amount — data units on continuous x, band-step fractions on discrete x. Default 40% of the data resolution.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "height",
+                description: "JITTER ONLY: maximum vertical jitter amount — data units on continuous y, band-step fractions on discrete y. Default 40% of the data resolution.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "seed",
+                description: "JITTER ONLY: RNG seed (a non-negative integer). Default 42. ggts jitter is ALWAYS seeded so renders are reproducible (deliberate divergence from random jitter).",
+                typeSummary: "integer",
+                required: false,
+            },
+        ],
+        compatibleGeoms: ["point", "count", "jitter"],
+        defaultForGeoms: ["jitter"],
+    },
+    nudge: {
+        name: "nudge",
+        slug: "nudge",
+        summary: "Apply a fixed offset (positionParams.x / y) per mark — useful for labels beside points. Offsets are data units or band-step fractions.",
+        params: [
+            {
+                name: "x",
+                description: "NUDGE ONLY: horizontal offset — data units on continuous x, band-step fractions on discrete x. Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+            {
+                name: "y",
+                description: "NUDGE ONLY: vertical offset — data units on continuous y, band-step fractions on discrete y. Default 0.",
+                typeSummary: "number",
+                required: false,
+            },
+        ],
+        compatibleGeoms: ["point", "text", "label", "count"],
+        defaultForGeoms: [],
+    },
+};
+//# sourceMappingURL=position-reference-data.js.map

package/dist/generated/position-reference-data.js.map

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