@wells-nelson/interactions 0.0.0-stage → 1.0.0

package/dist/undo.svelte.d.ts

@@ -0,0 +1,25 @@
+/** Something that can be reversed. Capture whatever it needs in the closure. */
+export interface UndoEntry {
+    undo(): void | Promise<void>;
+}
+export interface UndoStackOptions {
+    /** How long the Undo button stays visible after the latest push or undo (ms). */
+    visibleMs?: number;
+    /** History is dropped after this long without a push (ms). */
+    idleMs?: number;
+}
+/**
+ * Stackable undo for quick, reversible actions (e.g. ticking items off). Do the action, then
+ * `push` how to reverse it. The Undo button shows for 5 seconds after the latest push or undo;
+ * the history survives 1 minute without pushes, so a new push can bring older entries back.
+ */
+export declare class UndoStack {
+    #private;
+    visible: boolean;
+    constructor({ visibleMs, idleMs }?: UndoStackOptions);
+    get size(): number;
+    push(entry: UndoEntry): void;
+    /** Reverse the latest entry. */
+    undo(): Promise<void>;
+    clear(): void;
+}

package/dist/undo.svelte.js

@@ -0,0 +1,53 @@
+/**
+ * Stackable undo for quick, reversible actions (e.g. ticking items off). Do the action, then
+ * `push` how to reverse it. The Undo button shows for 5 seconds after the latest push or undo;
+ * the history survives 1 minute without pushes, so a new push can bring older entries back.
+ */
+export class UndoStack {
+    visible = $state(false);
+    #stack = [];
+    #visibleMs;
+    #idleMs;
+    #hideTimer;
+    #dropTimer;
+    constructor({ visibleMs = 5_000, idleMs = 60_000 } = {}) {
+        this.#visibleMs = visibleMs;
+        this.#idleMs = idleMs;
+    }
+    get size() {
+        return this.#stack.length;
+    }
+    push(entry) {
+        this.#stack.push(entry);
+        this.#show();
+        clearTimeout(this.#dropTimer);
+        this.#dropTimer = setTimeout(() => (this.#stack = []), this.#idleMs);
+    }
+    /** Reverse the latest entry. */
+    async undo() {
+        const entry = this.#stack.pop();
+        if (!entry) {
+            this.#hide();
+            return;
+        }
+        if (this.#stack.length === 0)
+            this.#hide();
+        else
+            this.#show();
+        await entry.undo();
+    }
+    clear() {
+        this.#stack = [];
+        clearTimeout(this.#dropTimer);
+        this.#hide();
+    }
+    #show() {
+        this.visible = true;
+        clearTimeout(this.#hideTimer);
+        this.#hideTimer = setTimeout(() => (this.visible = false), this.#visibleMs);
+    }
+    #hide() {
+        clearTimeout(this.#hideTimer);
+        this.visible = false;
+    }
+}

package/dist/wipe.d.ts

@@ -0,0 +1,15 @@
+export interface WipeOptions {
+    /**
+     * App teardown to run first: unmount live queries, sign out locally, close and remove the
+     * app's databases. Errors are logged and the wipe continues.
+     */
+    beforeWipe?: () => void | Promise<void>;
+    /** Where to go afterwards (a full page load). Defaults to the site root. */
+    redirectTo?: string;
+}
+/**
+ * Development helper: delete every IndexedDB database, localStorage and sessionStorage entry on
+ * this origin, then reload at `redirectTo`. Nothing on the server is touched.
+ * Only wire this up in development builds.
+ */
+export declare function wipeAllData({ beforeWipe, redirectTo }?: WipeOptions): Promise<void>;

package/dist/wipe.js

@@ -0,0 +1,24 @@
+/**
+ * Development helper: delete every IndexedDB database, localStorage and sessionStorage entry on
+ * this origin, then reload at `redirectTo`. Nothing on the server is touched.
+ * Only wire this up in development builds.
+ */
+export async function wipeAllData({ beforeWipe, redirectTo = '/' } = {}) {
+    try {
+        await beforeWipe?.();
+    }
+    catch (err) {
+        console.warn('Teardown before wipe failed', err);
+    }
+    // Anything left over (e.g. other accounts' cloud databases).
+    const databases = (await indexedDB.databases?.()) ?? [];
+    await Promise.all(databases
+        .filter((d) => d.name)
+        .map((d) => new Promise((done) => {
+        const req = indexedDB.deleteDatabase(d.name);
+        req.onsuccess = req.onerror = req.onblocked = () => done();
+    })));
+    localStorage.clear();
+    sessionStorage.clear();
+    location.replace(redirectTo);
+}

package/package.json

@@ -1,6 +1,51 @@
 {
   "name": "@wells-nelson/interactions",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Svelte 5 inputs, actions (long-press, drag and drop), undo, and account/sharing UI shared by Wells Nelson apps.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bnelson729/wells-nelson-components.git",
+    "directory": "src/npm/interactions"
+  },
+  "homepage": "https://github.com/bnelson729/wells-nelson-components/tree/main/src/npm/interactions#readme",
+  "bugs": {
+    "url": "https://github.com/bnelson729/wells-nelson-components/issues"
+  },
+  "type": "module",
+  "svelte": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./account": {
+      "types": "./dist/account/index.d.ts",
+      "svelte": "./dist/account/index.js",
+      "default": "./dist/account/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "build": "svelte-package -i src/lib -o dist",
+    "check": "svelte-check --tsconfig ./tsconfig.json --fail-on-warnings",
+    "test": "vitest run",
+    "lint:package": "publint"
+  },
+  "peerDependencies": {
+    "@wells-nelson/displays": ">=1.0.0 <2.0.0",
+    "svelte": "^5.40.0"
+  },
+  "devDependencies": {
+    "@wells-nelson/displays": "*"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  }
+}