@ggts-sh/spec 0.43.0

package/dist/normalize-scales.js

@@ -0,0 +1,90 @@
+/**
+ * Scale canonicalization for normalize() — position type rewrites and color hex.
+ * Coord: normalize-coord.ts. Layer/aes orchestration: normalize.ts.
+ */
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function withGuide(scale) {
+    if (!("guide" in scale) || !isRecord(scale.guide))
+        return { ...scale };
+    const guide = {
+        ...scale.guide,
+        ...(isRecord(scale.guide["theme"]) && { theme: { ...scale.guide["theme"] } }),
+    };
+    return { ...scale, guide };
+}
+function normalizeHexColor(color) {
+    const match = /^#([0-9a-f]{3}|[0-9a-f]{6})$/i.exec(color);
+    if (match === null)
+        return color;
+    const digits = match[1].toLowerCase();
+    return digits.length === 3
+        ? `#${digits[0]}${digits[0]}${digits[1]}${digits[1]}${digits[2]}${digits[2]}`
+        : `#${digits}`;
+}
+function normalizeColorScale(scale) {
+    const fallbacks = {
+        ...(scale.naValue !== undefined && { naValue: normalizeHexColor(scale.naValue) }),
+        ...(scale.unknownValue !== undefined && {
+            unknownValue: normalizeHexColor(scale.unknownValue),
+        }),
+    };
+    if (scale.type === "identity")
+        return { ...withGuide(scale), ...fallbacks };
+    return {
+        ...withGuide(scale),
+        ...(Array.isArray(scale.range) && {
+            range: scale.range.map((color) => normalizeHexColor(color)),
+        }),
+        ...fallbacks,
+    };
+}
+function normalizePositionScale(scale) {
+    if (scale.type === "band") {
+        const { temporalKind: _, parse: __, parseFailure: ___, timezone: ____, disambiguation: _____, dateBreaks: ______, dateMinorBreaks: _______, dateLabels: ________, locale: _________, weekStart: __________, ...band } = scale;
+        return band;
+    }
+    // Canonical log10: an authored `type: "log"` (base-10) IS the linear family
+    // with the log10 transform. A conflicting explicit transform (identity/sqrt)
+    // is left uncanonicalized for pipeline preflight to reject as
+    // scale-type-transform-conflict. Pure normalize never throws.
+    if (scale.type === "log" && (scale.transform === undefined || scale.transform === "log10")) {
+        return { ...scale, type: "linear", transform: "log10" };
+    }
+    // Binned is a quantitative position family; it never requests a time scale.
+    // Contradictory temporal options are left for validate() to reject.
+    if (scale.type === "binned") {
+        return { ...scale };
+    }
+    const hasTemporalGuideOption = scale.dateBreaks !== undefined ||
+        scale.dateMinorBreaks !== undefined ||
+        scale.dateLabels !== undefined ||
+        scale.locale !== undefined ||
+        scale.weekStart !== undefined;
+    if ((scale.type === "linear" || scale.type === "log") && hasTemporalGuideOption) {
+        return { ...scale };
+    }
+    const requestsTime = scale.type === "time" ||
+        scale.temporalKind !== undefined ||
+        scale.parse !== undefined ||
+        scale.parseFailure !== undefined ||
+        scale.timezone !== undefined ||
+        scale.disambiguation !== undefined ||
+        hasTemporalGuideOption;
+    return requestsTime ? { ...scale, type: "time" } : { ...scale };
+}
+export function normalizeScales(scales) {
+    return {
+        ...(scales.x !== undefined && { x: withGuide(normalizePositionScale(scales.x)) }),
+        ...(scales.y !== undefined && { y: withGuide(normalizePositionScale(scales.y)) }),
+        ...(scales.color !== undefined && { color: normalizeColorScale(scales.color) }),
+        ...(scales.fill !== undefined && { fill: normalizeColorScale(scales.fill) }),
+        ...(scales.size !== undefined && { size: withGuide(scales.size) }),
+        ...(scales.linewidth !== undefined && { linewidth: withGuide(scales.linewidth) }),
+        ...(scales.alpha !== undefined && { alpha: withGuide(scales.alpha) }),
+        ...(scales.shape !== undefined && { shape: withGuide(scales.shape) }),
+        ...(scales.linetype !== undefined && { linetype: withGuide(scales.linetype) }),
+    };
+}
+//# sourceMappingURL=normalize-scales.js.map

package/dist/normalize-scales.js.map

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

package/dist/normalize.d.ts

@@ -0,0 +1,46 @@
+/**
+ * normalize() — the canonicalizer (plan: "One canonical form per concept").
+ *
+ * Input: a SpecInput, the TS/builder-level convenience form where channels may
+ * be bare strings ('displ' means { field: 'displ' }). The JSON Schema does NOT
+ * admit bare strings — the shorthand exists only here and in the Svelte props.
+ * Input types live in normalize-input.ts.
+ *
+ * Output: a canonical PortableSpec. Canonicalization performed:
+ *  1. Bare-string channels -> { field } (in plot aes and layer aes).
+ *  2. Geom defaults filled (GEOM_DEFAULTS): bar -> stat count + position
+ *     stack; col/area -> identity + stack; everything else identity/identity.
+ *  3. Bar layers with no y channel get the count stat's default mapping
+ *     y: { stat: "count" } (ggplot2's after_stat default aes).
+ *  4. Aes inheritance RESOLVED into each layer with null-unset semantics
+ *     (layer channel null removes the inherited channel), and the plot-level
+ *     `aes` removed from the output. Every normalized layer is self-contained.
+ *     (Resolving at normalize time is what makes normalize idempotent: keeping
+ *     plot aes AND merged layers would re-inherit null-unset channels on a
+ *     second pass.)
+ *  5. Theme names stay strings; theme objects are cloned (both canonical).
+ *  6. Deterministic key order for every object it constructs.
+ *
+ * Scale-type inference needs data, so it lives in @ggts-sh/core (pipeline);
+ * normalize only fills structural defaults. Normalized output is itself a
+ * valid PortableSpec, and normalize(normalize(s)) deep-equals normalize(s).
+ *
+ * Scale and coord canonicalization live in normalize-scales.ts and
+ * normalize-coord.ts; this module owns channels, layers, facet, theme, and
+ * the top-level normalize() walk.
+ */
+import type { ChannelValue, NormalizedSpec } from "./schema.js";
+import type { ChannelInput, SpecInput } from "./normalize-input.js";
+export type { AesInput, AreaLayerInput, BarLayerInput, BoxplotLayerInput, ChannelInput, ColLayerInput, DensityLayerInput, ErrorbarLayerInput, LinerangeLayerInput, PointrangeLayerInput, CrossbarLayerInput, FacetFieldInput, FacetInput, HistogramLayerInput, FreqpolyLayerInput, HlineLayerInput, JitterLayerInput, RibbonLayerInput, SegmentLayerInput, CountLayerInput, ViolinLayerInput, FunctionLayerInput, PolygonLayerInput, AblineLayerInput, ContourLayerInput, Density2dLayerInput, Density2dFilledLayerInput, DotplotLayerInput, BlankLayerInput, MapLayerInput, SpokeLayerInput, SfLayerInput, SfTextLayerInput, SfLabelLayerInput, CurveLayerInput, RugLayerInput, StepLayerInput, QqLayerInput, QqLineLayerInput, LayerInput, LineLayerInput, PathLayerInput, PointLayerInput, RasterLayerInput, HexLayerInput, RectLayerInput, RuleLayerInput, QuantileLayerInput, SmoothLayerInput, SpecInput, TextLayerInput, LabelLayerInput, TileLayerInput, Bin2dLayerInput, VlineLayerInput, } from "./normalize-input.js";
+/** Canonicalize one channel: bare string -> { field }; clone canonical forms. */
+export declare function normalizeChannel(input: ChannelInput): ChannelValue;
+/**
+ * Canonicalize a SpecInput into a normalized PortableSpec (see module docs).
+ *
+ * The NormalizedSpec return type promises one thing the runtime enforces —
+ * canonicalGeom() has rewritten every alias geom. It promises nothing about an
+ * unknown geom: normalize() deliberately never throws on one (see below), so
+ * the type is only sound once validate() has passed on the result.
+ */
+export declare function normalize(input: SpecInput): NormalizedSpec;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../src/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EAGV,YAAY,EAMZ,cAAc,EAGf,MAAM,aAAa,CAAC;AAKrB,OAAO,KAAK,EAEV,YAAY,EAGZ,SAAS,EACV,MAAM,sBAAsB,CAAC;AAI9B,YAAY,EACV,QAAQ,EACR,cAAc,EACd,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,aAAa,EACb,iBAAiB,EACjB,kBAAkB,EAClB,mBAAmB,EACnB,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,iBAAiB,EACjB,mBAAmB,EACnB,yBAAyB,EACzB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,aAAa,EACb,cAAc,EACd,YAAY,EACZ,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,gBAAgB,EAChB,SAAS,EACT,cAAc,EACd,eAAe,EACf,cAAc,EACd,eAAe,EACf,eAAe,GAChB,MAAM,sBAAsB,CAAC;AAE9B,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,CAUlE;AAiPD;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CA0B1D"}

package/dist/normalize.js

@@ -0,0 +1,279 @@
+import { normalizeCoord } from "./normalize-coord.js";
+import { normalizeLayerParamsPaint } from "./normalize-paint.js";
+import { normalizeScales } from "./normalize-scales.js";
+import { CHANNELS, CURRENT_EDITION, GEOM_ALIASES, GEOM_DEFAULTS } from "./schema-catalog.js";
+/** Canonicalize one channel: bare string -> { field }; clone canonical forms. */
+export function normalizeChannel(input) {
+    if (typeof input === "string")
+        return { field: input };
+    if (input === null)
+        return null;
+    if ("field" in input)
+        return { field: input.field };
+    if ("value" in input) {
+        return input.scale === undefined
+            ? { value: input.value }
+            : { value: input.value, scale: input.scale };
+    }
+    return { stat: input.stat };
+}
+function normalizeAes(input) {
+    if (input === undefined)
+        return undefined;
+    const out = {};
+    for (const channel of CHANNELS) {
+        const v = input[channel];
+        if (v === undefined)
+            continue;
+        out[channel] = normalizeChannel(v);
+    }
+    return out;
+}
+/**
+ * Merge plot-level aes into a layer's aes with null-unset semantics:
+ * layer channels override; a layer channel of null REMOVES the inherited
+ * channel (and does not survive into the resolved mapping).
+ */
+function resolveLayerAes(plotAes, layerAes) {
+    const out = {};
+    for (const channel of CHANNELS) {
+        const own = layerAes?.[channel];
+        if (own === null)
+            continue; // explicit unset
+        const inherited = plotAes?.[channel];
+        const chosen = own ?? inherited;
+        if (chosen === undefined || chosen === null)
+            continue;
+        out[channel] = chosen;
+    }
+    return Object.keys(out).length === 0 ? undefined : out;
+}
+/** Annotation-form rule / hline / vline layers (fixed intercepts) inherit NO
+ *  plot aes — ggplot2's `inherit.aes = FALSE` on geom_vline/hline (Hadley
+ *  lesson 15: honest, separate signatures for the two rule forms).
+ *  Asymmetric: hline is annotation only when yintercept is set; vline only
+ *  when xintercept is set; rule when either intercept is set. */
+function isAnnotationRule(layer) {
+    const params = layer.params;
+    if (layer.geom === "hline")
+        return params?.yintercept !== undefined;
+    if (layer.geom === "vline")
+        return params?.xintercept !== undefined;
+    if (layer.geom !== "rule")
+        return false;
+    return params?.xintercept !== undefined || params?.yintercept !== undefined;
+}
+/** Abline is always annotation-style (fixed slope/intercept; no plot aes). */
+function isAnnotationAbline(layer) {
+    return layer.geom === "abline";
+}
+/**
+ * Convenience geom aliases (#818 / histogram / freqpoly): rewrite to the
+ * canonical geom name. Pure renames only — no cross-field params surgery.
+ *
+ * The rewrite is GEOM_ALIASES, so the alias set is one table core can key its
+ * pipeline records off (#1042) rather than a fact buried in this branch.
+ */
+function canonicalGeom(geom) {
+    // Own-key check, not `in`: `in` walks the prototype chain, so a geom named
+    // "constructor" or "toString" would read as an alias and rewrite to a
+    // function. Unknown names must pass through for validate() to reject.
+    return Object.hasOwn(GEOM_ALIASES, geom)
+        ? GEOM_ALIASES[geom]
+        : geom;
+}
+function normalizeLayer(layer, plotAes) {
+    // Data-driven hline/vline are one-axis rules: drop the orthogonal position
+    // channel from inheritance so plot-level x+y does not trigger rule-both-axes.
+    const layerAesInput = normalizeRuleAesInput(layer);
+    const inherited = isAnnotationRule(layer) || isAnnotationAbline(layer) ? undefined : plotAes;
+    let aes = resolveLayerAes(inherited, normalizeAes(layerAesInput));
+    // Unknown geoms fall back to identity defaults so normalize never throws —
+    // validate() rejects them right after with the proper did-you-mean error.
+    // Own-key check for the same reason as canonicalGeom: plain `[…]` on a geom
+    // named "constructor" returns a function, which is truthy, so `??` would not
+    // fire and the layer would lose stat and position.
+    const defaults = Object.hasOwn(GEOM_DEFAULTS, layer.geom)
+        ? GEOM_DEFAULTS[layer.geom]
+        : { stat: "identity", position: "identity" };
+    // geom_sf: public stat_sf (#809 phase 7). Rewrite legacy portable
+    // `stat: "identity"` so re-normalize stays additive (draw path unchanged).
+    const rawStat = layer.stat ?? defaults.stat;
+    const stat = layer.geom === "sf" && rawStat === "identity" ? "sf" : rawStat;
+    // Stat default mappings (ggplot2's `after_stat()` default aes): the count
+    // and bin stats map y to their count column; the density stat maps y to
+    // its density column.
+    aes = normalizeStatAes(aes, stat, layer.geom);
+    const geom = canonicalGeom(layer.geom);
+    const positionParams = "positionParams" in layer && layer.positionParams !== undefined
+        ? { ...layer.positionParams }
+        : undefined;
+    const rawParams = layer.params === undefined ? undefined : { ...layer.params };
+    const params = rawParams === undefined ? undefined : normalizeLayerParamsPaint(rawParams);
+    // "auto" is the render default — one canonical form per concept, so it
+    // canonicalizes away (same rule as coord "cartesian" / a11y "auto").
+    const render = layer.render === "auto" ? undefined : layer.render;
+    // Jitter alias has no position field on the input type; always use defaults.
+    const position = normalizeLayerPosition(layer, defaults.position);
+    const out = {
+        geom,
+        stat,
+        position,
+        ...(positionParams !== undefined && { positionParams }),
+        ...(render !== undefined && { render }),
+        ...(aes !== undefined && { aes }),
+        ...(layer.data !== undefined && { data: layer.data }),
+        // Only `false` is expressible. Read as unknown so a raw JSON `inspect: true`
+        // is not rewritten to false — validate rejects non-false; typed input only
+        // admits false (#1065).
+        ...(layer.inspect === false && {
+            inspect: false,
+        }),
+        ...(params !== undefined && { params }),
+    };
+    return out;
+}
+function normalizeRuleAesInput(layer) {
+    if (layer.geom === "hline" && !isAnnotationRule(layer))
+        return { ...layer.aes, x: null };
+    if (layer.geom === "vline" && !isAnnotationRule(layer))
+        return { ...layer.aes, y: null };
+    return layer.aes;
+}
+function normalizeStatAes(aes, stat, geom) {
+    let normalized = normalizeStatPositionAes(aes, stat);
+    normalized = normalizeStatStyleAes(normalized, stat, geom);
+    return normalized;
+}
+function normalizeStatPositionAes(aes, stat) {
+    if ((stat === "count" || stat === "bin") && aes?.y === undefined) {
+        return { ...aes, y: { stat: "count" } };
+    }
+    if (stat === "density" && aes?.y === undefined)
+        return { ...aes, y: { stat: "density" } };
+    if (stat === "function" && aes?.y === undefined)
+        return { ...aes, y: { stat: "y" } };
+    if (stat === "ecdf" && aes?.y === undefined)
+        return { ...aes, y: { stat: "ecdf" } };
+    if (stat === "bindot" && aes?.y === undefined)
+        return { ...aes, y: { stat: "stackpos" } };
+    return aes;
+}
+function normalizeStatStyleAes(aes, stat, geom) {
+    if (stat === "sum" && aes?.size === undefined)
+        return { ...aes, size: { stat: "n" } };
+    if (stat === "bin_hex" && aes?.fill === undefined)
+        return { ...aes, fill: { stat: "count" } };
+    if ((stat === "density_2d_filled" || geom === "density_2d_filled") && aes?.fill === undefined) {
+        return { ...aes, fill: { stat: "level" } };
+    }
+    if (stat === "bin_2d" && aes?.fill === undefined)
+        return { ...aes, fill: { stat: "count" } };
+    return aes;
+}
+function normalizeLayerPosition(layer, defaultPosition) {
+    if (layer.geom === "jitter")
+        return defaultPosition;
+    return "position" in layer && layer.position !== undefined ? layer.position : defaultPosition;
+}
+/** Canonicalize one facet field: bare string -> { field }; clone levels/labels. */
+function normalizeFacetField(v) {
+    if (v === undefined)
+        return undefined;
+    if (typeof v === "string")
+        return { field: v };
+    const levels = v.levels === undefined
+        ? undefined
+        : [...v.levels];
+    const labels = v.labels === undefined ? undefined : { ...v.labels };
+    return {
+        field: v.field,
+        ...(levels !== undefined && { levels }),
+        ...(labels !== undefined && { labels }),
+    };
+}
+/** Canonicalize facet strip chrome (position + show). */
+function normalizeFacetStrip(strip) {
+    const out = {
+        ...(strip.position !== undefined && { position: strip.position }),
+        ...(strip.show !== undefined && { show: strip.show }),
+    };
+    return out;
+}
+/** Canonicalize a facet input: bare-string fields -> { field }. */
+function normalizeFacet(facet) {
+    const wrap = normalizeFacetField(facet.wrap);
+    const rows = normalizeFacetField(facet.rows);
+    const cols = normalizeFacetField(facet.cols);
+    const strip = facet.strip === undefined ? undefined : normalizeFacetStrip(facet.strip);
+    return {
+        ...(wrap !== undefined && { wrap }),
+        ...(rows !== undefined && { rows }),
+        ...(cols !== undefined && { cols }),
+        ...(facet.ncol !== undefined && { ncol: facet.ncol }),
+        ...(facet.scales !== undefined && { scales: facet.scales }),
+        ...(strip !== undefined && Object.keys(strip).length > 0 && { strip }),
+    };
+}
+function normalizeTheme(theme) {
+    return typeof theme === "string" ? theme : { ...theme };
+}
+function normalizeGuide(guide) {
+    return {
+        ...guide,
+        ...(guide.type !== "none" && guide.theme !== undefined && { theme: { ...guide.theme } }),
+    };
+}
+const GUIDE_ORDER = [
+    "x",
+    "y",
+    "color",
+    "fill",
+    "size",
+    "linewidth",
+    "alpha",
+    "shape",
+    "linetype",
+];
+function normalizeGuides(guides) {
+    return Object.fromEntries(GUIDE_ORDER.flatMap((aesthetic) => {
+        const guide = guides[aesthetic];
+        return guide === undefined ? [] : [[aesthetic, normalizeGuide(guide)]];
+    }));
+}
+/**
+ * Canonicalize a SpecInput into a normalized PortableSpec (see module docs).
+ *
+ * The NormalizedSpec return type promises one thing the runtime enforces —
+ * canonicalGeom() has rewritten every alias geom. It promises nothing about an
+ * unknown geom: normalize() deliberately never throws on one (see below), so
+ * the type is only sound once validate() has passed on the result.
+ */
+export function normalize(input) {
+    const plotAes = normalizeAes(input.aes);
+    // Defaults canonicalize away: Cartesian/identity coord and a11y "auto" ARE
+    // the absent forms (one canonical form per concept).
+    const coord = normalizeCoord(input.coord);
+    const a11y = input.a11y === "force-svg" ? input.a11y : undefined;
+    const out = {
+        ...(input.$schema !== undefined && { $schema: input.$schema }),
+        // Defaults-edition stamping (Hadley lesson 13): absent -> current, so the
+        // spec's default look is frozen at authoring time (schema description).
+        edition: input.edition ?? CURRENT_EDITION,
+        ...(input.data !== undefined && { data: input.data }),
+        ...(input.datasets !== undefined && { datasets: input.datasets }),
+        layers: input.layers.map((layer) => normalizeLayer(layer, plotAes)),
+        ...(input.facet !== undefined && { facet: normalizeFacet(input.facet) }),
+        ...(coord !== undefined && { coord }),
+        ...(input.scales !== undefined && { scales: normalizeScales(input.scales) }),
+        ...(input.guides !== undefined && { guides: normalizeGuides(input.guides) }),
+        ...(input.legend !== undefined && { legend: { ...input.legend } }),
+        ...(input.labs !== undefined && { labs: { ...input.labs } }),
+        ...(input.theme !== undefined && { theme: normalizeTheme(input.theme) }),
+        ...(input.width !== undefined && { width: input.width }),
+        ...(input.height !== undefined && { height: input.height }),
+        ...(a11y !== undefined && { a11y }),
+    };
+    return out;
+}
+//# sourceMappingURL=normalize.js.map

package/dist/normalize.js.map

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

package/dist/paint-helpers.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Within-mark paint authoring helpers (#591).
+ * Closed portable gradients + bounded glow — not theme decoration.
+ */
+import type { ColorStop, GlowSpec, LinearGradientPaint, PaintSpace, RadialGradientPaint } from "./schema.js";
+export type ColorStopInput = ColorStop;
+export type LinearPaintOptions = {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    /** Gradient coordinate space. Default "mark" (object bounding box). */
+    space?: PaintSpace;
+    stops: ColorStopInput[];
+    /** Required solid #rgb/#rrggbb fallback for a11y / reduced-effects paths. */
+    fallback: string;
+};
+export type RadialPaintOptions = {
+    cx: number;
+    cy: number;
+    r: number;
+    /** Gradient coordinate space. Default "mark" (object bounding box). */
+    space?: PaintSpace;
+    stops: ColorStopInput[];
+    /** Required solid #rgb/#rrggbb fallback for a11y / reduced-effects paths. */
+    fallback: string;
+};
+export type GlowOptions = {
+    color: string;
+    /** Blur radius in CSS px (exclusive minimum 0, maximum 32). */
+    radius: number;
+    /** Glow opacity 0–1. */
+    opacity: number;
+};
+/** Build a deterministic linear gradient paint for fillPaint / strokePaint. */
+export declare function fillPaintLinear(options: LinearPaintOptions): LinearGradientPaint;
+/** Build a deterministic radial gradient paint for fillPaint. */
+export declare function fillPaintRadial(options: RadialPaintOptions): RadialGradientPaint;
+/** Build a deterministic linear gradient paint for strokePaint. */
+export declare function strokePaintLinear(options: LinearPaintOptions): LinearGradientPaint;
+/** Build a deterministic radial gradient paint for strokePaint. */
+export declare function strokePaintRadial(options: RadialPaintOptions): RadialGradientPaint;
+/** Build a bounded glow treatment (color, radius ≤ 32px, opacity). */
+export declare function glow(options: GlowOptions): GlowSpec;
+//# sourceMappingURL=paint-helpers.d.ts.map

package/dist/paint-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-helpers.d.ts","sourceRoot":"","sources":["../src/paint-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,EACV,SAAS,EACT,QAAQ,EACR,mBAAmB,EACnB,UAAU,EACV,mBAAmB,EACpB,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,cAAc,GAAG,SAAS,CAAC;AAEvC,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,uEAAuE;IACvE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,EAAE,MAAM,CAAC;IACV,uEAAuE;IACvE,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,KAAK,EAAE,MAAM,CAAC;IACd,+DAA+D;IAC/D,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AA2BF,+EAA+E;AAC/E,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,CAEhF;AAED,iEAAiE;AACjE,wBAAgB,eAAe,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,CAEhF;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,CAElF;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,mBAAmB,CAElF;AAED,sEAAsE;AACtE,wBAAgB,IAAI,CAAC,OAAO,EAAE,WAAW,GAAG,QAAQ,CAMnD"}

package/dist/paint-helpers.js

@@ -0,0 +1,48 @@
+function linear(options) {
+    return {
+        type: "linear",
+        x1: options.x1,
+        y1: options.y1,
+        x2: options.x2,
+        y2: options.y2,
+        space: options.space ?? "mark",
+        stops: options.stops.map((stop) => ({ ...stop })),
+        fallback: options.fallback,
+    };
+}
+function radial(options) {
+    return {
+        type: "radial",
+        cx: options.cx,
+        cy: options.cy,
+        r: options.r,
+        space: options.space ?? "mark",
+        stops: options.stops.map((stop) => ({ ...stop })),
+        fallback: options.fallback,
+    };
+}
+/** Build a deterministic linear gradient paint for fillPaint / strokePaint. */
+export function fillPaintLinear(options) {
+    return linear(options);
+}
+/** Build a deterministic radial gradient paint for fillPaint. */
+export function fillPaintRadial(options) {
+    return radial(options);
+}
+/** Build a deterministic linear gradient paint for strokePaint. */
+export function strokePaintLinear(options) {
+    return linear(options);
+}
+/** Build a deterministic radial gradient paint for strokePaint. */
+export function strokePaintRadial(options) {
+    return radial(options);
+}
+/** Build a bounded glow treatment (color, radius ≤ 32px, opacity). */
+export function glow(options) {
+    return {
+        color: options.color,
+        radius: options.radius,
+        opacity: options.opacity,
+    };
+}
+//# sourceMappingURL=paint-helpers.js.map

package/dist/paint-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paint-helpers.js","sourceRoot":"","sources":["../src/paint-helpers.ts"],"names":[],"mappings":"AA6CA,SAAS,MAAM,CAAC,OAA2B;IACzC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACjD,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,MAAM,CAAC,OAA2B;IACzC,OAAO;QACL,IAAI,EAAE,QAAQ;QACd,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,EAAE,EAAE,OAAO,CAAC,EAAE;QACd,CAAC,EAAE,OAAO,CAAC,CAAC;QACZ,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,MAAM;QAC9B,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;QACjD,QAAQ,EAAE,OAAO,CAAC,QAAQ;KAC3B,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,eAAe,CAAC,OAA2B;IACzD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,OAA2B;IACzD,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,iBAAiB,CAAC,OAA2B;IAC3D,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,IAAI,CAAC,OAAoB;IACvC,OAAO;QACL,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;AACJ,CAAC"}