@tikitaki_gagarinbefree/svelte 0.0.0-stage → 0.1.4

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 gagarinbefree
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,18 @@
-# Temporary Holding Version
+# @tikitaki_gagarinbefree/svelte
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Optional Svelte 5 adapter for TikiTaki. The core remains independent of Svelte.
+Create one `createSvelteCellAdapter<T>()` per engine view and pass `bridge.adapter`
+to `createSwipeEngine`. Subscribe to `bridge.cells` in a keyed template and apply
+`use:portal={cell.host}` to a framework-owned wrapper around each cell component.
+
+The bridge exposes a readonly Svelte store of frozen snapshots. Surviving cells
+retain their key, host, context, and component state when data changes. Removed
+cells leave the keyed template and release their component lifecycle. The portal
+action moves only its owned wrapper, cleans up idempotently, and never creates
+per-cell Svelte roots. The engine owns host elements; Svelte owns their descendants.
+
+Create the DOM engine in `onMount`, forward grid changes with `$effect`, and destroy
+it in the mount cleanup. Keep mutable controller resources outside deep proxies.
+See the [working demo](../../demos/svelte/EngineView.svelte) for complete ownership,
+reactive updates, parent context, and teardown. Use `tick()` before asserting
+framework content after engine operations.

package/dist/config.d.ts

@@ -0,0 +1,5 @@
+/** Vue adapter ownership validation messages. */
+export declare const ADAPTER_CONFIG: Readonly<{
+    duplicateHostMessage: "Host is already mounted";
+}>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,eAAO,MAAM,cAAc;;EAAqE,CAAC"}

package/dist/config.js

@@ -0,0 +1,3 @@
+/** Vue adapter ownership validation messages. */
+export const ADAPTER_CONFIG = Object.freeze({ duplicateHostMessage: 'Host is already mounted' });
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,oBAAoB,EAAE,yBAAyB,EAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,25 @@
+import { type Readable } from 'svelte/store';
+import type { Position } from 'tikitaki';
+import type { CellAdapter } from 'tikitaki/dom';
+/** Immutable host record retaining the identity of user-owned content. */
+export interface SvelteCell<T> {
+    readonly key: string;
+    readonly host: HTMLElement;
+    readonly item: T;
+    readonly position: Position;
+}
+/** Readonly store consumed by keyed components under the owning Svelte application. */
+export interface SvelteCellBridge<T> {
+    readonly adapter: CellAdapter<T>;
+    readonly cells: Readable<readonly SvelteCell<T>[]>;
+}
+/** Create one bridge per engine view; render its keyed cells with the portal action. */
+export declare function createSvelteCellAdapter<T>(): SvelteCellBridge<T>;
+/** Move a framework-owned wrapper into its host without creating another Svelte root. */
+export declare function portal(node: HTMLElement, target: HTMLElement): {
+    /** Move the same component subtree when its host changes. */
+    update(next: HTMLElement): void;
+    /** Remove only the owned wrapper and leave unrelated host content untouched. */
+    destroy(): void;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,KAAK,QAAQ,EAAE,MAAM,cAAc,CAAC;AAEjE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,cAAc,CAAC;AAE7D,0EAA0E;AAC1E,MAAM,WAAW,UAAU,CAAC,CAAC;IAC3B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AACD,uFAAuF;AACvF,MAAM,WAAW,gBAAgB,CAAC,CAAC;IACjC,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACjC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,SAAS,UAAU,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;CACpD;AAKD,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAkChE;AACD,yFAAyF;AACzF,wBAAgB,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,WAAW;IAKzD,6DAA6D;iBAChD,WAAW;IAKxB,gFAAgF;;EAOnF"}

package/dist/index.js

@@ -0,0 +1,69 @@
+import { readonly, writable } from 'svelte/store';
+import { ADAPTER_CONFIG } from "./config.js";
+/** Copy coordinates without cloning or freezing user-owned data. */
+function entry(key, host, item, position) {
+    return Object.freeze({ key, host, item, position: Object.freeze({ row: position.row, col: position.col }) });
+}
+/** Create one bridge per engine view; render its keyed cells with the portal action. */
+export function createSvelteCellAdapter() {
+    let cells = Object.freeze([]);
+    const store = writable(cells);
+    let id = 0;
+    /** Publish an immutable snapshot to active component subscriptions. */
+    function publish(next) {
+        cells = Object.freeze(next);
+        store.set(cells);
+    }
+    return {
+        cells: readonly(store),
+        adapter: {
+            /** Own one host while letting Svelte manage its descendants and lifecycle. */
+            mount(host, item, position) {
+                if (cells.some((cell) => cell.host === host))
+                    throw new TypeError(ADAPTER_CONFIG.duplicateHostMessage);
+                const key = String(++id);
+                publish([...cells, entry(key, host, item, position)]);
+                let mounted = true;
+                return {
+                    /** Retain the key so component state survives item updates. */
+                    update(next, coordinates) {
+                        if (!mounted)
+                            return;
+                        publish(cells.map((cell) => (cell.key === key ? entry(key, host, next, coordinates) : cell)));
+                    },
+                    /** Release once; stale operations cannot revive a removed component. */
+                    unmount() {
+                        if (!mounted)
+                            return;
+                        mounted = false;
+                        publish(cells.filter((cell) => cell.key !== key));
+                    },
+                };
+            },
+        },
+    };
+}
+/** Move a framework-owned wrapper into its host without creating another Svelte root. */
+export function portal(node, target) {
+    let host = target;
+    let active = true;
+    host.append(node);
+    return {
+        /** Move the same component subtree when its host changes. */
+        update(next) {
+            if (!active || next === host)
+                return;
+            host = next;
+            host.append(node);
+        },
+        /** Remove only the owned wrapper and leave unrelated host content untouched. */
+        destroy() {
+            if (!active)
+                return;
+            active = false;
+            if (node.parentNode === host)
+                node.remove();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,44 @@
 {
   "name": "@tikitaki_gagarinbefree/svelte",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.4",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "tikitaki": "^0.1.4",
+    "svelte": "^5.57.2"
+  },
+  "license": "MIT",
+  "author": "gagarinbefree",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/gagarinbefree/TikiTaki.git",
+    "directory": "packages/svelte"
+  },
+  "homepage": "https://github.com/gagarinbefree/TikiTaki#readme",
+  "bugs": {
+    "url": "https://github.com/gagarinbefree/TikiTaki/issues"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "swipe",
+    "gestures",
+    "typescript",
+    "ragged-grid"
+  ],
+  "description": "svelte rendering adapter for the TikiTaki swipe engine"
+}

package/src/config.ts

@@ -0,0 +1,2 @@
+/** Vue adapter ownership validation messages. */
+export const ADAPTER_CONFIG = Object.freeze({ duplicateHostMessage: 'Host is already mounted' });

package/src/index.ts

@@ -0,0 +1,77 @@
+import { readonly, writable, type Readable } from 'svelte/store';
+import { ADAPTER_CONFIG } from './config';
+import type { Position } from 'tikitaki';
+import type { CellAdapter, MountedCell } from 'tikitaki/dom';
+
+/** Immutable host record retaining the identity of user-owned content. */
+export interface SvelteCell<T> {
+  readonly key: string;
+  readonly host: HTMLElement;
+  readonly item: T;
+  readonly position: Position;
+}
+/** Readonly store consumed by keyed components under the owning Svelte application. */
+export interface SvelteCellBridge<T> {
+  readonly adapter: CellAdapter<T>;
+  readonly cells: Readable<readonly SvelteCell<T>[]>;
+}
+/** Copy coordinates without cloning or freezing user-owned data. */
+function entry<T>(key: string, host: HTMLElement, item: T, position: Position): SvelteCell<T> {
+  return Object.freeze({ key, host, item, position: Object.freeze({ row: position.row, col: position.col }) });
+}
+/** Create one bridge per engine view; render its keyed cells with the portal action. */
+export function createSvelteCellAdapter<T>(): SvelteCellBridge<T> {
+  let cells: readonly SvelteCell<T>[] = Object.freeze([]);
+  const store = writable(cells);
+  let id = 0;
+  /** Publish an immutable snapshot to active component subscriptions. */
+  function publish(next: readonly SvelteCell<T>[]) {
+    cells = Object.freeze(next);
+    store.set(cells);
+  }
+  return {
+    cells: readonly(store),
+    adapter: {
+      /** Own one host while letting Svelte manage its descendants and lifecycle. */
+      mount(host: HTMLElement, item: T, position: Position): MountedCell<T> {
+        if (cells.some((cell) => cell.host === host)) throw new TypeError(ADAPTER_CONFIG.duplicateHostMessage);
+        const key = String(++id);
+        publish([...cells, entry(key, host, item, position)]);
+        let mounted = true;
+        return {
+          /** Retain the key so component state survives item updates. */
+          update(next, coordinates) {
+            if (!mounted) return;
+            publish(cells.map((cell) => (cell.key === key ? entry(key, host, next, coordinates) : cell)));
+          },
+          /** Release once; stale operations cannot revive a removed component. */
+          unmount() {
+            if (!mounted) return;
+            mounted = false;
+            publish(cells.filter((cell) => cell.key !== key));
+          },
+        };
+      },
+    },
+  };
+}
+/** Move a framework-owned wrapper into its host without creating another Svelte root. */
+export function portal(node: HTMLElement, target: HTMLElement) {
+  let host = target;
+  let active = true;
+  host.append(node);
+  return {
+    /** Move the same component subtree when its host changes. */
+    update(next: HTMLElement) {
+      if (!active || next === host) return;
+      host = next;
+      host.append(node);
+    },
+    /** Remove only the owned wrapper and leave unrelated host content untouched. */
+    destroy() {
+      if (!active) return;
+      active = false;
+      if (node.parentNode === host) node.remove();
+    },
+  };
+}