@ggts-sh/react 0.43.0

package/dist/plot-legends.js

@@ -0,0 +1,200 @@
+import { jsxs as _jsxs, jsx as _jsx } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+import { encodeKey } from "@ggts-sh/core";
+import { buildInteractiveLegendEntries, buildLegendEntryKeyIndexForPlot, isLegendValueVisible, legendIdentityKey, nextLegendFilterValues, samePropertyKeySet, } from "@ggts-sh/core/interaction";
+const same = (state, entry) => state !== null &&
+    state.scale === entry.legend.scale &&
+    state.value === encodeKey(entry.entry.value);
+export function usePlotLegends(input) {
+    const { model, registry, revision, props, scope, keyForRow, filters } = input;
+    const [committed, setCommitted] = useState(null);
+    const [preview, setPreview] = useState(null);
+    const capability = useMemo(() => {
+        const focus = new Map();
+        const filter = new Map();
+        for (const layer of registry.layers) {
+            if (layer.kind === "legendFocus" && layer.value !== null) {
+                focus.set(layer.value.channel, layer.value.input === true || layer.value.input.preview !== false);
+            }
+            if (layer.kind === "legendFilter" && layer.value !== null) {
+                const options = layer.value.input === true ? {} : layer.value.input;
+                if (options.mode !== undefined && options.mode !== "include" && options.mode !== "exclude")
+                    throw new TypeError("Legend filter mode must be include or exclude");
+                filter.set(layer.value.channel, {
+                    mode: options.mode ?? "exclude",
+                    multiple: options.multiple ?? true,
+                });
+            }
+        }
+        return { focus, filter };
+    }, [registry, revision]);
+    const allEntries = useMemo(() => (model === null ? [] : buildInteractiveLegendEntries(model.scene.legends)), [model]);
+    const entries = allEntries.filter((entry) => capability.focus.has(entry.legend.scale) ||
+        capability.filter.has(entry.legend.scale) ||
+        Boolean(props.legendFocus) ||
+        Boolean(props.legendFilter));
+    const index = useMemo(() => buildLegendEntryKeyIndexForPlot({
+        model: entries.length === 0 ? null : model,
+        semanticKey: keyForRow,
+    }), [model, keyForRow, entries.length]);
+    const focusEnabled = capability.focus.size > 0 || Boolean(props.legendFocus);
+    const selectedEntry = entries.find((entry) => same(preview, entry));
+    const controllerKeys = props.interaction?.emphasized(scope);
+    const localKeys = committed?.keys ?? [];
+    const previewKeys = selectedEntry === undefined
+        ? null
+        : (index.get(legendIdentityKey(selectedEntry.identity)) ?? []);
+    const emphasis = focusEnabled
+        ? (previewKeys ?? controllerKeys ?? localKeys)
+        : (controllerKeys ?? []);
+    const isPressed = (entry) => {
+        const keys = controllerKeys ?? localKeys;
+        return (keys.length > 0 &&
+            samePropertyKeySet(keys, index.get(legendIdentityKey(entry.identity)) ?? []));
+    };
+    const emit = (event) => {
+        props.onlegendfocus?.(event);
+        props.oninteraction?.(event);
+    };
+    const focusEntry = (entry, source, commit) => {
+        if (!capability.focus.has(entry.legend.scale) &&
+            (props.legendFocus === undefined || props.legendFocus === false))
+            return;
+        const previewAllowed = capability.focus.get(entry.legend.scale) ??
+            (typeof props.legendFocus === "object" ? (props.legendFocus.preview ?? true) : true);
+        if (!commit && !previewAllowed)
+            return;
+        const clear = commit && isPressed(entry);
+        const keys = clear ? [] : (index.get(legendIdentityKey(entry.identity)) ?? []);
+        const state = clear
+            ? null
+            : { scale: entry.legend.scale, value: encodeKey(entry.entry.value), keys };
+        if (commit) {
+            setCommitted(state);
+            setPreview(null);
+        }
+        else
+            setPreview(state);
+        if (commit)
+            props.interaction?.setEmphasis(keys, { scope, source });
+        emit(clear
+            ? { type: "legend-focus", phase: "clear", source }
+            : {
+                type: "legend-focus",
+                phase: "change",
+                state: commit ? "committed" : "transient",
+                source,
+                scale: entry.legend.scale,
+                value: entry.entry.value,
+                label: entry.entry.fullLabel ?? entry.entry.label,
+                keys,
+            });
+    };
+    const clearPreview = (source) => {
+        if (preview === null)
+            return;
+        setPreview(null);
+        if (committed === null)
+            emit({ type: "legend-focus", phase: "clear", source });
+    };
+    const clearFocus = (source = "programmatic") => {
+        setPreview(null);
+        setCommitted(null);
+        props.interaction?.clearEmphasis({ scope, source });
+        emit({ type: "legend-focus", phase: "clear", source });
+    };
+    const fieldFor = (entry) => model?.layerFields
+        .flat()
+        .find((field) => field.channel === entry.legend.scale && field.source !== "stat")?.field;
+    const filterEntry = (entry, source) => {
+        const field = fieldFor(entry);
+        if (field === undefined)
+            return;
+        const options = capability.filter.get(entry.legend.scale) ??
+            (typeof props.legendFilter === "object" ? props.legendFilter : {});
+        const mode = options.mode ?? "exclude";
+        const prior = filters.find((clause) => clause.scale === entry.legend.scale && clause.field === field);
+        const catalog = entry.legend.entries.map((value) => value.value);
+        const values = nextLegendFilterValues(prior?.values ?? (mode === "include" ? catalog : []), entry.entry.value, catalog, mode, options.multiple ?? true);
+        const clause = { scale: entry.legend.scale, field, values, mode };
+        input.setFilters([
+            ...filters.filter((value) => value.scale !== clause.scale || value.field !== field),
+            clause,
+        ]);
+        const event = { type: "legend-filter", phase: "change", source, clause };
+        props.onlegendfilter?.(event);
+        props.oninteraction?.(event);
+    };
+    useEffect(() => {
+        if (committed === null)
+            return;
+        const entry = entries.find((item) => same(committed, item));
+        const keys = entry === undefined ? [] : (index.get(legendIdentityKey(entry.identity)) ?? []);
+        if (!samePropertyKeySet(keys, committed.keys)) {
+            setCommitted(null);
+            if (props.interaction === undefined)
+                emit({ type: "legend-focus", phase: "clear", source: "programmatic" });
+        }
+    }, [model, index]);
+    useEffect(() => {
+        if (focusEnabled)
+            return;
+        setPreview(null);
+        setCommitted(null);
+    }, [focusEnabled]);
+    useEffect(() => {
+        if (filters.every((clause) => capability.filter.has(clause.scale) || Boolean(props.legendFilter)))
+            return;
+        // Reset atomically, matching the Svelte host: removed controls cannot
+        // leave hidden row filters behind, including when another guide remains.
+        input.setFilters([]);
+        const event = {
+            type: "legend-filter",
+            phase: "clear",
+            source: "programmatic",
+            clause: null,
+        };
+        props.onlegendfilter?.(event);
+        props.oninteraction?.(event);
+    }, [capability.filter, props.legendFilter, filters]);
+    return {
+        emphasis,
+        entries,
+        clearFocus,
+        controls: entries.length === 0 ? null : (_jsxs("div", { className: "gg-legend-controls", "aria-label": "Legend controls", style: { display: "flex", flexWrap: "wrap", gap: 8, lineHeight: 1.4 }, children: [entries.map((entry) => {
+                    const identity = legendIdentityKey(entry.identity);
+                    const filter = capability.filter.has(entry.legend.scale) || Boolean(props.legendFilter);
+                    const focus = capability.focus.has(entry.legend.scale) || Boolean(props.legendFocus);
+                    const field = fieldFor(entry);
+                    const clause = filters.find((value) => value.scale === entry.legend.scale && value.field === field);
+                    const visible = clause === undefined ||
+                        isLegendValueVisible(clause.values, entry.entry.value, clause.mode);
+                    return (_jsxs("div", { children: [focus && (_jsxs("button", { type: "button", "aria-pressed": isPressed(entry), onPointerEnter: () => {
+                                    focusEntry(entry, "pointer", false);
+                                }, onPointerLeave: () => {
+                                    clearPreview("pointer");
+                                }, onFocus: () => {
+                                    focusEntry(entry, "keyboard", false);
+                                }, onBlur: () => {
+                                    clearPreview("keyboard");
+                                }, onClick: (event) => {
+                                    focusEntry(entry, event.detail === 0 ? "keyboard" : "pointer", true);
+                                }, style: { minHeight: 44, minWidth: 44 }, children: ["Focus ", entry.entry.fullLabel ?? entry.entry.label] })), filter && field !== undefined && (_jsxs("label", { style: { display: "inline-flex", alignItems: "center", minHeight: 44, gap: 6 }, children: [_jsx("input", { type: "checkbox", checked: visible, onChange: (event) => {
+                                            filterEntry(entry, event.nativeEvent instanceof PointerEvent ? "pointer" : "keyboard");
+                                        } }), "Show ", entry.entry.fullLabel ?? entry.entry.label] }))] }, identity));
+                }), committed !== null && (_jsx("button", { type: "button", onClick: () => {
+                        clearFocus("pointer");
+                    }, children: "Clear legend focus" })), filters.length > 0 && (_jsx("button", { type: "button", onClick: () => {
+                        input.setFilters([]);
+                        const event = {
+                            type: "legend-filter",
+                            phase: "clear",
+                            source: "pointer",
+                            clause: null,
+                        };
+                        props.onlegendfilter?.(event);
+                        props.oninteraction?.(event);
+                    }, children: "Reset legend filters" }))] })),
+    };
+}
+//# sourceMappingURL=plot-legends.js.map

package/dist/plot-legends.js.map

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

package/dist/plot-overlay.d.ts

@@ -0,0 +1,15 @@
+import type { CandidateFacts, CellValue, PlotRect, RenderModel } from "@ggts-sh/core";
+import type { PlotInspectionChange } from "@ggts-sh/core/interaction";
+export declare function PlotOverlay({ model, inspection, seed, candidates, selected, emphasized, rectangles, flipped, }: {
+    model: RenderModel;
+    inspection: PlotInspectionChange<Record<string, CellValue>, PropertyKey> | null;
+    seed: CandidateFacts | null;
+    candidates: readonly (CandidateFacts & {
+        keys: readonly PropertyKey[];
+    })[];
+    selected: readonly PropertyKey[];
+    emphasized: readonly PropertyKey[];
+    rectangles: readonly PlotRect[];
+    flipped: boolean;
+}): import("react").JSX.Element | null;
+//# sourceMappingURL=plot-overlay.d.ts.map

package/dist/plot-overlay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot-overlay.d.ts","sourceRoot":"","sources":["../src/plot-overlay.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAYtF,OAAO,KAAK,EAAE,oBAAoB,EAAsB,MAAM,2BAA2B,CAAC;AA+E1F,wBAAgB,WAAW,CAAC,EAC1B,KAAK,EACL,UAAU,EACV,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,OAAO,GACR,EAAE;IACD,KAAK,EAAE,WAAW,CAAC;IACnB,UAAU,EAAE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,WAAW,CAAC,GAAG,IAAI,CAAC;IAChF,IAAI,EAAE,cAAc,GAAG,IAAI,CAAC;IAC5B,UAAU,EAAE,SAAS,CAAC,cAAc,GAAG;QAAE,IAAI,EAAE,SAAS,WAAW,EAAE,CAAA;KAAE,CAAC,EAAE,CAAC;IAC3E,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IACjC,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;IACnC,UAAU,EAAE,SAAS,QAAQ,EAAE,CAAC;IAChC,OAAO,EAAE,OAAO,CAAC;CAClB,sCAuDA"}

package/dist/plot-overlay.js

@@ -0,0 +1,69 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { anchorsFromCandidateKeys, applyEmphasisRingDensityGate, crosshairGapForBox, crosshairGlyphObstacles, glyphExtentsFromBatch, gappedCrosshairSegmentsWithObstacles, glyphHoverBox, hoverChromeForKind, HOVER_CROSSHAIR_GAP_RADIUS, } from "@ggts-sh/core/interaction";
+function Anchor({ anchor, className, radius, }) {
+    if (anchor.chrome === "none")
+        return null;
+    if (anchor.chrome === "ring")
+        return (_jsx("circle", { className: className, cx: anchor.x, cy: anchor.y, r: radius, fill: "none", stroke: "Highlight", strokeWidth: 2 }));
+    const box = glyphHoverBox(anchor, {
+        width: anchor.width,
+        height: anchor.height,
+        textAnchor: anchor.textAnchor,
+    });
+    return (_jsx("rect", { className: className, ...box, rx: 2, fill: "none", stroke: "Highlight", strokeWidth: 2 }));
+}
+function candidateExtent(model, candidate) {
+    const batch = model.scene.batches[candidate.batchIndex];
+    return batch?.kind === "glyphs" ? glyphExtentsFromBatch(batch, candidate.primitiveIndex) : null;
+}
+function hoverGuides(model, inspection, seed, flipped) {
+    if (inspection === null)
+        return { hover: null, lines: [] };
+    const focus = inspection.focus;
+    const panel = model.viewport.panelAtOrOnly(focus.anchor);
+    const chrome = hoverChromeForKind(seed?.kind);
+    const dimensions = seed === null ? null : candidateExtent(model, seed);
+    const hover = { ...focus.anchor, chrome, ...dimensions };
+    if (panel === null)
+        return { hover, lines: [] };
+    const obstacles = crosshairGlyphObstacles(model.scene.batches, model.scene.panels, panel.id);
+    const gap = chrome === "ring"
+        ? HOVER_CROSSHAIR_GAP_RADIUS
+        : chrome === "box"
+            ? crosshairGapForBox(dimensions?.width ?? 12, dimensions?.height ?? 12)
+            : 0;
+    const mode = inspection.mode;
+    const vertical = mode === "xy" || mode === (flipped ? "y" : "x");
+    const horizontal = mode === "xy" || mode === (flipped ? "x" : "y");
+    const bounds = {
+        x: panel.bounds.x0,
+        y: panel.bounds.y0,
+        width: panel.bounds.x1 - panel.bounds.x0,
+        height: panel.bounds.y1 - panel.bounds.y0,
+    };
+    const lines = [
+        ...(vertical
+            ? gappedCrosshairSegmentsWithObstacles("vertical", focus.anchor, bounds, gap, obstacles)
+            : []),
+        ...(horizontal
+            ? gappedCrosshairSegmentsWithObstacles("horizontal", focus.anchor, bounds, gap, obstacles)
+            : []),
+    ];
+    return { hover, lines };
+}
+export function PlotOverlay({ model, inspection, seed, candidates, selected, emphasized, rectangles, flipped, }) {
+    const presented = candidates.map((candidate) => ({
+        ...candidate,
+        ...candidateExtent(model, candidate),
+    }));
+    const anchors = anchorsFromCandidateKeys(presented, selected);
+    const emphasis = applyEmphasisRingDensityGate(anchorsFromCandidateKeys(presented, emphasized));
+    const { hover, lines } = hoverGuides(model, inspection, seed, flipped);
+    if (inspection === null &&
+        anchors.length === 0 &&
+        emphasis.length === 0 &&
+        rectangles.length === 0)
+        return null;
+    return (_jsxs("svg", { className: "gg-interaction-overlay", "aria-hidden": "true", width: model.scene.width, height: model.scene.height, style: { position: "absolute", inset: 0, pointerEvents: "none" }, children: [lines.map((line, index) => (_jsx("line", { className: "gg-crosshair", ...line, stroke: "currentColor", strokeOpacity: 0.5, strokeDasharray: "3 3" }, index))), hover !== null && _jsx(Anchor, { anchor: hover, className: "gg-hover-ring", radius: 6 }), anchors.map((anchor, index) => (_jsx(Anchor, { anchor: anchor, className: "gg-selected-ring", radius: 8 }, index))), emphasis.map((anchor, index) => (_jsx(Anchor, { anchor: anchor, className: "gg-emphasis-ring", radius: 7 }, index))), rectangles.map((rect, index) => (_jsx("rect", { className: "gg-brush", x: rect.x0, y: rect.y0, width: rect.x1 - rect.x0, height: rect.y1 - rect.y0, fill: "Highlight", fillOpacity: 0.12, stroke: "Highlight" }, index)))] }));
+}
+//# sourceMappingURL=plot-overlay.js.map

package/dist/plot-overlay.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot-overlay.js","sourceRoot":"","sources":["../src/plot-overlay.tsx"],"names":[],"mappings":";AACA,OAAO,EACL,wBAAwB,EACxB,4BAA4B,EAC5B,kBAAkB,EAClB,uBAAuB,EACvB,qBAAqB,EACrB,oCAAoC,EACpC,aAAa,EACb,kBAAkB,EAClB,0BAA0B,GAC3B,MAAM,2BAA2B,CAAC;AAGnC,SAAS,MAAM,CAAC,EACd,MAAM,EACN,SAAS,EACT,MAAM,GAKP;IACC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;QAC1B,OAAO,CACL,iBACE,SAAS,EAAE,SAAS,EACpB,EAAE,EAAE,MAAM,CAAC,CAAC,EACZ,EAAE,EAAE,MAAM,CAAC,CAAC,EACZ,CAAC,EAAE,MAAM,EACT,IAAI,EAAC,MAAM,EACX,MAAM,EAAC,WAAW,EAClB,WAAW,EAAE,CAAC,GACd,CACH,CAAC;IACJ,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE;QAChC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,UAAU,EAAE,MAAM,CAAC,UAAU;KAC9B,CAAC,CAAC;IACH,OAAO,CACL,eAAM,SAAS,EAAE,SAAS,KAAM,GAAG,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAC,MAAM,EAAC,MAAM,EAAC,WAAW,EAAC,WAAW,EAAE,CAAC,GAAI,CAC9F,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAkB,EAAE,SAAyB;IACpE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;IACxD,OAAO,KAAK,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AAClG,CAAC;AAED,SAAS,WAAW,CAClB,KAAkB,EAClB,UAA+E,EAC/E,IAA2B,EAC3B,OAAgB;IAEhB,IAAI,UAAU,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC;IAC/B,MAAM,KAAK,GAAG,KAAK,CAAC,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACvE,MAAM,KAAK,GAAG,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,UAAU,EAAE,CAAC;IACzD,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IAChD,MAAM,SAAS,GAAG,uBAAuB,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC;IAC7F,MAAM,GAAG,GACP,MAAM,KAAK,MAAM;QACf,CAAC,CAAC,0BAA0B;QAC5B,CAAC,CAAC,MAAM,KAAK,KAAK;YAChB,CAAC,CAAC,kBAAkB,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE,EAAE,UAAU,EAAE,MAAM,IAAI,EAAE,CAAC;YACvE,CAAC,CAAC,CAAC,CAAC;IACV,MAAM,IAAI,GAAG,UAAU,CAAC,IAAI,CAAC;IAC7B,MAAM,QAAQ,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACjE,MAAM,UAAU,GAAG,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG;QACb,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;QAClB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;QAClB,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE;QACxC,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,CAAC,EAAE;KAC1C,CAAC;IACF,MAAM,KAAK,GAAG;QACZ,GAAG,CAAC,QAAQ;YACV,CAAC,CAAC,oCAAoC,CAAC,UAAU,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC;YACxF,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,UAAU;YACZ,CAAC,CAAC,oCAAoC,CAAC,YAAY,EAAE,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,SAAS,CAAC;YAC1F,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IACF,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,EAC1B,KAAK,EACL,UAAU,EACV,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,UAAU,EACV,UAAU,EACV,OAAO,GAUR;IACC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QAC/C,GAAG,SAAS;QACZ,GAAG,eAAe,CAAC,KAAK,EAAE,SAAS,CAAC;KACrC,CAAC,CAAC,CAAC;IACJ,MAAM,OAAO,GAAG,wBAAwB,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,QAAQ,GAAG,4BAA4B,CAAC,wBAAwB,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC,CAAC;IAC/F,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,GAAG,WAAW,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACvE,IACE,UAAU,KAAK,IAAI;QACnB,OAAO,CAAC,MAAM,KAAK,CAAC;QACpB,QAAQ,CAAC,MAAM,KAAK,CAAC;QACrB,UAAU,CAAC,MAAM,KAAK,CAAC;QAEvB,OAAO,IAAI,CAAC;IACd,OAAO,CACL,eACE,SAAS,EAAC,wBAAwB,iBACtB,MAAM,EAClB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,KAAK,EACxB,MAAM,EAAE,KAAK,CAAC,KAAK,CAAC,MAAM,EAC1B,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,EAAE,aAAa,EAAE,MAAM,EAAE,aAE/D,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC1B,eAEE,SAAS,EAAC,cAAc,KACpB,IAAI,EACR,MAAM,EAAC,cAAc,EACrB,aAAa,EAAE,GAAG,EAClB,eAAe,EAAC,KAAK,IALhB,KAAK,CAMV,CACH,CAAC,EACD,KAAK,KAAK,IAAI,IAAI,KAAC,MAAM,IAAC,MAAM,EAAE,KAAK,EAAE,SAAS,EAAC,eAAe,EAAC,MAAM,EAAE,CAAC,GAAI,EAChF,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAC9B,KAAC,MAAM,IAAa,MAAM,EAAE,MAAM,EAAE,SAAS,EAAC,kBAAkB,EAAC,MAAM,EAAE,CAAC,IAA7D,KAAK,CAA4D,CAC/E,CAAC,EACD,QAAQ,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,CAC/B,KAAC,MAAM,IAAa,MAAM,EAAE,MAAM,EAAE,SAAS,EAAC,kBAAkB,EAAC,MAAM,EAAE,CAAC,IAA7D,KAAK,CAA4D,CAC/E,CAAC,EACD,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAC/B,eAEE,SAAS,EAAC,UAAU,EACpB,CAAC,EAAE,IAAI,CAAC,EAAE,EACV,CAAC,EAAE,IAAI,CAAC,EAAE,EACV,KAAK,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,EACxB,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,EACzB,IAAI,EAAC,WAAW,EAChB,WAAW,EAAE,IAAI,EACjB,MAAM,EAAC,WAAW,IARb,KAAK,CASV,CACH,CAAC,IACE,CACP,CAAC;AACJ,CAAC"}

package/dist/plot-props.d.ts

@@ -0,0 +1,49 @@
+import type { CompositionDiagnostic } from "@ggts-sh/compose";
+import type { ReactNode } from "react";
+import type { CellValue, RenderModel } from "@ggts-sh/core";
+import type { InteractionDiagnostic, LegendFocusEvent, LegendFocusInput, LegendFilterEvent, LegendFilterInput } from "@ggts-sh/core/interaction";
+import type { A11yMode, AesInput, DataInput, LayerInput, PortableSpec, SpecInput } from "@ggts-sh/spec";
+import type { InspectInput, InteractionTool, PlotInteractionController, PlotInteractionEvent, PlotInteractionScope, PlotSelection, SelectInput, ZoomDomains, ZoomEvent, ZoomInput } from "./interaction.js";
+import type { PlotInspection } from "./interaction.js";
+export interface GGPlotHandle {
+    resetScales(): void;
+    setZoom(domains: Partial<ZoomDomains>): void;
+}
+export interface GGPlotProps<Row extends Record<string, CellValue> = Record<string, CellValue>> {
+    spec?: SpecInput;
+    data?: DataInput | readonly Row[];
+    aes?: AesInput;
+    layers?: LayerInput[];
+    a11y?: A11yMode;
+    width?: number | "container";
+    height?: number;
+    /**
+     * Durable row identity. Use this in JSX — React does not pass `key` through
+     * as a plot prop. Inspect / select / createPlotInteraction identity still win.
+     */
+    identity?: PropertyKey | ((row: Row, index: number) => PropertyKey);
+    /** @deprecated since 0.21.0 — React strips JSX `key`; use `identity`. */
+    key?: PropertyKey | ((row: Row, index: number) => PropertyKey);
+    inspect?: InspectInput<Row>;
+    /** Legacy shorthand; prefer <GuideLegend focus>. */
+    legendFocus?: LegendFocusInput;
+    /** Legacy shorthand; prefer <GuideLegend filter>. */
+    legendFilter?: LegendFilterInput;
+    select?: SelectInput;
+    zoom?: ZoomInput;
+    tool?: InteractionTool;
+    interaction?: PlotInteractionController;
+    interactionScope?: PlotInteractionScope;
+    oninspect?: (inspection: PlotInspection<Row>) => void;
+    onselect?: (selection: PlotSelection) => void;
+    onzoom?: (event: ZoomEvent) => void;
+    oninteraction?: (event: PlotInteractionEvent<Row>) => void;
+    onlegendfocus?: (event: LegendFocusEvent) => void;
+    onlegendfilter?: (event: LegendFilterEvent) => void;
+    ontoolchange?: (tool: InteractionTool) => void;
+    ondiagnostic?: (diagnostic: InteractionDiagnostic | CompositionDiagnostic) => void;
+    onrender?: (model: RenderModel, spec: PortableSpec) => void;
+    ariaLabel?: string;
+    children?: ReactNode;
+}
+//# sourceMappingURL=plot-props.d.ts.map

package/dist/plot-props.d.ts.map

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

package/dist/plot-props.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=plot-props.js.map

package/dist/plot-props.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot-props.js","sourceRoot":"","sources":["../src/plot-props.ts"],"names":[],"mappings":""}

package/dist/plot-runtime.d.ts

@@ -0,0 +1,15 @@
+import type { RenderModel, RuntimeRowFilterClause } from "@ggts-sh/core";
+import type { PortableSpec } from "@ggts-sh/spec";
+/** The pipeline is memoized by chart inputs, never by transient UI state. */
+export declare function usePlotModel(input: {
+    spec: PortableSpec | null;
+    baselineSpec: PortableSpec | null;
+    width: number;
+    height: number;
+    rowFilters: readonly RuntimeRowFilterClause[];
+}): {
+    model: RenderModel | null;
+    strata: import("@ggts-sh/core").Stratum[];
+    resetScales(): void;
+};
+//# sourceMappingURL=plot-runtime.d.ts.map

package/dist/plot-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot-runtime.d.ts","sourceRoot":"","sources":["../src/plot-runtime.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,sBAAsB,EAAc,MAAM,eAAe,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAIlD,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE;IAClC,IAAI,EAAE,YAAY,GAAG,IAAI,CAAC;IAC1B,YAAY,EAAE,YAAY,GAAG,IAAI,CAAC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,SAAS,sBAAsB,EAAE,CAAC;CAC/C;;;;EAqDA"}

package/dist/plot-runtime.js

@@ -0,0 +1,59 @@
+import { useMemo, useRef, useState } from "react";
+import { planStrata, runPipeline } from "@ggts-sh/core";
+import { useHostLayoutEffect } from "./host-effect.js";
+/** The pipeline is memoized by chart inputs, never by transient UI state. */
+export function usePlotModel(input) {
+    const scales = useRef(null);
+    const [epoch, setEpoch] = useState(0);
+    const model = useMemo(() => {
+        if (input.spec === null)
+            return null;
+        let previous = scales.current ?? undefined;
+        let baselineDomains;
+        if (input.baselineSpec !== null && input.baselineSpec !== input.spec) {
+            const baseline = runPipeline(input.baselineSpec, {
+                width: input.width,
+                height: input.height,
+                ...(previous !== undefined && { prevScales: previous }),
+                ...(input.rowFilters.length > 0 && { rowFilters: input.rowFilters }),
+            });
+            baselineDomains = baseline.domains.effective;
+            previous = baseline.scales.state;
+            baseline.dispose();
+        }
+        return runPipeline(input.spec, {
+            width: input.width,
+            height: input.height,
+            ...(previous !== undefined && { prevScales: previous }),
+            ...(baselineDomains !== undefined && { baselineDomains }),
+            ...(input.rowFilters.length > 0 && { rowFilters: input.rowFilters }),
+        });
+    }, [input.spec, input.baselineSpec, input.width, input.height, input.rowFilters, epoch]);
+    const strata = useMemo(() => (model === null ? [] : planStrata(model.scene, model.layerBackends)), [model]);
+    const pendingDisposal = useRef(new Set());
+    useHostLayoutEffect(() => {
+        if (model === null)
+            return () => { };
+        pendingDisposal.current.delete(model);
+        scales.current = model.scales.state;
+        return () => {
+            const pending = pendingDisposal.current;
+            pending.add(model);
+            // StrictMode replays effect setup without remounting the memoized model.
+            // The second setup cancels disposal; a replaced/unmounted model is released.
+            queueMicrotask(() => {
+                if (pending.delete(model))
+                    model.dispose();
+            });
+        };
+    }, [model]);
+    return {
+        model,
+        strata,
+        resetScales() {
+            scales.current = null;
+            setEpoch((value) => value + 1);
+        },
+    };
+}
+//# sourceMappingURL=plot-runtime.js.map

package/dist/plot-runtime.js.map

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

package/dist/plot-surface.d.ts

@@ -0,0 +1,3 @@
+import { type SurfaceProps } from "./plot-inputs.js";
+export declare function PlotSurface(props: SurfaceProps): import("react").JSX.Element;
+//# sourceMappingURL=plot-surface.d.ts.map

package/dist/plot-surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plot-surface.d.ts","sourceRoot":"","sources":["../src/plot-surface.tsx"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,kBAAkB,CAAC;AAuV1B,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,+BAE9C"}