@ggts-sh/svelte 0.43.0

package/dist/zoom/zoom-state.svelte.js

@@ -0,0 +1,121 @@
+import { createScopedStore } from "../interaction/scoped-store.svelte.js";
+import { frozenZoomDomains } from "../scene/geometry.js";
+import { zoomAnnouncement } from "../assembly/labels.js";
+import { applyZoomToSpec, buildZoomEvent, continuousZoomDomainsFromScopes, filterScopeChannelsByZoomMode, filterZoomDomainsByMode, resolveBrushZoomFromModel, sanitizePartialZoomDomains, stableZoomDomains, } from "./zoom.js";
+// ---------------------------------------------------------------------------
+// Factory
+// ---------------------------------------------------------------------------
+/**
+ * Create the zoom controller. Construction registers only the
+ * construction-time `effectiveZoomDomains` / `effectiveSpec` deriveds (over
+ * earlier host bindings). Handlers may read later-declared bindings via
+ * deferred getters (`model`, `announce`).
+ */
+export function createPlotZoomState(context, options) {
+    // Memoize prior bag so selection/emphasis revisions do not retrain zoom.
+    let previousEffectiveZoomDomains = null;
+    const zoomDomains = createScopedStore({
+        initial: null,
+        empty: null,
+        controller: context.interaction,
+        scope: context.resolvedInteractionScope,
+        read: (controller, scope) => 
+        // Gate shared domains by this plot's resolved zoom mode (null when
+        // disabled / faceted-unsupported) so x-only plots ignore y domains.
+        filterZoomDomainsByMode(controller.zoom(scope), options.zoomConfig()?.mode ?? null),
+        write: (controller, next, scope, source) => {
+            // Match filterZoomDomainsByMode: x-only plots must not mutate shared y.
+            const mutationScope = filterScopeChannelsByZoomMode(scope, options.zoomConfig()?.mode ?? null);
+            if (next === null) {
+                const transition = controller.resetZoom({ scope: mutationScope, source });
+                return transition === null ? null : { value: null };
+            }
+            const transition = controller.setZoom(next, { scope: mutationScope, source });
+            if (transition === null)
+                return null;
+            return {
+                value: frozenZoomDomains(continuousZoomDomainsFromScopes(transition.snapshot.zoom, mutationScope.x, mutationScope.y)),
+            };
+        },
+        clearShared: (controller, scope, source) => controller.resetZoom({
+            scope: filterScopeChannelsByZoomMode(scope, options.zoomConfig()?.mode ?? null),
+            source,
+        }) !== null,
+    });
+    const effectiveZoomDomains = $derived.by(() => {
+        const next = stableZoomDomains(previousEffectiveZoomDomains, zoomDomains.value);
+        previousEffectiveZoomDomains = next;
+        return next;
+    });
+    function resolveEffectiveSpec() {
+        const assembled = options.assembled();
+        if (assembled === null || effectiveZoomDomains === null)
+            return assembled;
+        return applyZoomToSpec(assembled, effectiveZoomDomains);
+    }
+    const effectiveSpec = $derived.by(resolveEffectiveSpec);
+    function commitZoom(domains, source) {
+        const committed = zoomDomains.set(domains, source);
+        if (committed === null)
+            return;
+        const event = buildZoomEvent(committed.value, source);
+        context.announce(zoomAnnouncement(committed.value));
+        context.onzoom()?.(event);
+        context.oninteraction()?.(event);
+    }
+    function resetZoom(source = "programmatic") {
+        if (effectiveZoomDomains === null)
+            return;
+        commitZoom(null, source);
+    }
+    function setZoomDomains(domains) {
+        const next = sanitizePartialZoomDomains(domains, context.model()?.scales, effectiveZoomDomains);
+        if (next === null)
+            return;
+        commitZoom(frozenZoomDomains(next), "programmatic");
+    }
+    function onDblClick() {
+        if (options.zoomConfig() === null)
+            return;
+        resetZoom("pointer");
+    }
+    /**
+     * Brush-to-zoom = an intentional respec: invert the brushed plot-px rect
+     * through the trained scales into explicit continuous domains. Band axes
+     * and faceted plots are skipped (documented M2 limitation) inside
+     * `resolveBrushZoomFromModel`.
+     */
+    function applyBrushZoom(rect, source) {
+        // Pure owns null/multi-panel gate, invert, and freeze for commit.
+        const next = resolveBrushZoomFromModel({
+            model: context.model(),
+            rect,
+            mode: options.zoomConfig()?.mode ?? "xy",
+            current: effectiveZoomDomains,
+        });
+        if (next === null)
+            return;
+        commitZoom(next, source);
+    }
+    function resetForScales() {
+        // Silent path: no event / announcement. Prefer clear() so local and shared
+        // storage stay interchangeable without an interaction fork at the call site.
+        zoomDomains.clear("programmatic");
+    }
+    return {
+        get effectiveZoomDomains() {
+            return effectiveZoomDomains;
+        },
+        get effectiveSpec() {
+            // Svelte 5.33 SSR does not invalidate construction-time deriveds after
+            // declaration-only children register in the same server pass.
+            return typeof window === "undefined" ? resolveEffectiveSpec() : effectiveSpec;
+        },
+        commitZoom,
+        resetZoom,
+        setZoomDomains,
+        onDblClick,
+        applyBrushZoom,
+        resetForScales,
+    };
+}

package/dist/zoom/zoom.d.ts

@@ -0,0 +1 @@
+export { continuousZoomDomainsFromScopes, filterZoomDomainsByMode, filterScopeChannelsByZoomMode, sameZoomDomains, stableZoomDomains, applyZoomToSpec, sanitizePartialZoomDomains, buildZoomEvent, resolveBrushZoomDomains, resolveBrushZoomFromModel, } from "@ggts-sh/core/interaction";

package/dist/zoom/zoom.js

@@ -0,0 +1,2 @@
+// Shared pure behavior used by React and Svelte.
+export { continuousZoomDomainsFromScopes, filterZoomDomainsByMode, filterScopeChannelsByZoomMode, sameZoomDomains, stableZoomDomains, applyZoomToSpec, sanitizePartialZoomDomains, buildZoomEvent, resolveBrushZoomDomains, resolveBrushZoomFromModel, } from "@ggts-sh/core/interaction";

package/package.json

@@ -0,0 +1,83 @@
+{
+  "name": "@ggts-sh/svelte",
+  "version": "0.43.0",
+  "description": "ggts: a layered grammar of graphics for Svelte 5 — ggplot2 semantics, JSON-serializable specs, agent-friendly validation, and hybrid SVG/canvas rendering. The ggts render CLI ships separately as @ggts-sh/cli.",
+  "keywords": [
+    "charts",
+    "components",
+    "dataviz",
+    "ggplot2",
+    "grammar-of-graphics",
+    "interactive",
+    "plot",
+    "svelte",
+    "svelte5",
+    "visualization"
+  ],
+  "homepage": "https://ggts.sh/",
+  "bugs": "https://github.com/ggts-sh/ggts/issues",
+  "license": "MIT",
+  "author": "Liam O'Dea",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ggts-sh/ggts.git",
+    "directory": "packages/svelte"
+  },
+  "bin": {
+    "ggts-codemod": "bin/ggts-codemod.js"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ],
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./data": {
+      "types": "./dist/data/index.d.ts",
+      "default": "./dist/data/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "svelte-package -i src/lib -o dist",
+    "check": "svelte-check --fail-on-warnings",
+    "test": "bun run test:browser && bun run test:ssr",
+    "test:browser": "vitest run",
+    "test:ssr": "vitest run --config vitest.ssr.config.ts",
+    "test:coverage": "vitest run --coverage --project chromium && vitest run --coverage --config vitest.ssr.config.ts"
+  },
+  "dependencies": {
+    "@ggts-sh/compose": "^0.43.0",
+    "@ggts-sh/core": "^0.43.0",
+    "@ggts-sh/spec": "^0.43.0"
+  },
+  "devDependencies": {
+    "@sveltejs/package": "^2.5.8",
+    "@sveltejs/vite-plugin-svelte": "^7.3.0",
+    "@testing-library/svelte-core": "^1.1.3",
+    "@vitest/browser-playwright": "^4.1.11",
+    "@vitest/coverage-v8": "^4.1.11",
+    "axe-core": "^4.13.0",
+    "playwright": "1.61.1",
+    "svelte": "^5.56.10",
+    "svelte-check": "^4.7.4",
+    "typescript": "^6.0.3",
+    "vite": "^8.2.0",
+    "vitest": "^4.1.11"
+  },
+  "peerDependencies": {
+    "svelte": "^5.33.1"
+  },
+  "engines": {
+    "node": ">=22"
+  }
+}