sh3-core 0.8.0 → 0.8.2

package/dist/shell-shard/verbs/views.js

@@ -1,8 +1,29 @@
 import ViewsTable from '../rich/ViewsTable.svelte';
 export const viewsVerb = {
     name: 'views',
-    summary: 'List views currently mounted in the active layout.',
-    async run(ctx) {
+    summary: 'List views currently mounted. Pass --standalone to list summonable views instead.',
+    async run(ctx, args) {
+        if (args.includes('--standalone')) {
+            const standalones = ctx.shell.listStandaloneViews();
+            if (standalones.length === 0) {
+                ctx.scrollback.push({
+                    kind: 'status',
+                    text: 'shell: no standalone views are currently available.',
+                    level: 'info',
+                    ts: Date.now(),
+                });
+                return;
+            }
+            ctx.scrollback.push({
+                kind: 'status',
+                text: standalones
+                    .map((v) => `  ${v.viewId.padEnd(32)} ${v.label}`)
+                    .join('\n'),
+                level: 'info',
+                ts: Date.now(),
+            });
+            return;
+        }
         const views = ctx.shell.listViewsInCurrentLayout();
         ctx.scrollback.push({
             kind: 'rich',
@@ -62,6 +83,86 @@ export const openVerb = {
         }
     },
 };
+export const popoutVerb = {
+    name: 'popout',
+    summary: 'Pop a docked view out into a float by slot id.',
+    async run(ctx, args) {
+        var _a;
+        const slotId = args[0];
+        if (!slotId) {
+            ctx.scrollback.push({
+                kind: 'status',
+                text: 'usage: popout <slotId>',
+                level: 'warn',
+                ts: Date.now(),
+            });
+            return;
+        }
+        const result = ctx.shell.popoutSlot(slotId);
+        if (!result.ok) {
+            ctx.scrollback.push({
+                kind: 'status',
+                text: `shell: popout failed — ${(_a = result.error) !== null && _a !== void 0 ? _a : 'unknown'}`,
+                level: 'error',
+                ts: Date.now(),
+            });
+        }
+        else {
+            ctx.scrollback.push({
+                kind: 'status',
+                text: `shell: popped out ${slotId} → ${result.floatId}`,
+                level: 'info',
+                ts: Date.now(),
+            });
+        }
+    },
+};
+export const dockVerb = {
+    name: 'dock',
+    summary: 'Dock a float back into the current layout by float id. Run with no args to list floats.',
+    async run(ctx, args) {
+        var _a;
+        const floatId = args[0];
+        if (!floatId) {
+            const floats = ctx.shell.listFloats();
+            if (floats.length === 0) {
+                ctx.scrollback.push({
+                    kind: 'status',
+                    text: 'shell: no active floats.',
+                    level: 'info',
+                    ts: Date.now(),
+                });
+                return;
+            }
+            ctx.scrollback.push({
+                kind: 'status',
+                text: floats
+                    .map((f) => { var _a; return `  ${f.floatId.padEnd(24)} ${(_a = f.viewId) !== null && _a !== void 0 ? _a : '-'}\t${f.label}`; })
+                    .join('\n'),
+                level: 'info',
+                ts: Date.now(),
+            });
+            return;
+        }
+        const result = ctx.shell.dockFloat(floatId);
+        if (!result.ok) {
+            ctx.scrollback.push({
+                kind: 'status',
+                text: `shell: dock failed — ${(_a = result.error) !== null && _a !== void 0 ? _a : 'unknown'}`,
+                level: 'error',
+                ts: Date.now(),
+            });
+        }
+        else {
+            ctx.scrollback.push({
+                kind: 'status',
+                text: `shell: docked ${floatId}`,
+                level: 'info',
+                ts: Date.now(),
+            });
+        }
+    },
+};
 export const closeVerb = {
     name: 'close',
     summary: 'Close a view by slot id.',

package/dist/testing.d.ts

@@ -0,0 +1,3 @@
+import type { DocumentBackend } from './documents/types';
+/** Factory wrapper so test code can call createMemoryDocumentBackend() without new. */
+export declare function createMemoryDocumentBackend(): DocumentBackend;

package/dist/testing.js

@@ -0,0 +1,77 @@
+// src/documents/backends.ts
+function compositeKey(tenantId, shardId, path) {
+  return `${tenantId}/${shardId}/${path}`;
+}
+function keyPrefix(tenantId, shardId) {
+  return `${tenantId}/${shardId}/`;
+}
+var MemoryDocumentBackend = class {
+  #store = /* @__PURE__ */ new Map();
+  async read(tenantId, shardId, path) {
+    const entry = this.#store.get(compositeKey(tenantId, shardId, path));
+    return entry ? entry.content : null;
+  }
+  async write(tenantId, shardId, path, content) {
+    const size = typeof content === "string" ? new Blob([content]).size : content.byteLength;
+    this.#store.set(compositeKey(tenantId, shardId, path), {
+      content,
+      size,
+      lastModified: Date.now()
+    });
+  }
+  async delete(tenantId, shardId, path) {
+    this.#store.delete(compositeKey(tenantId, shardId, path));
+  }
+  async list(tenantId, shardId) {
+    const prefix = keyPrefix(tenantId, shardId);
+    const out = [];
+    for (const [key, entry] of this.#store) {
+      if (key.startsWith(prefix)) {
+        out.push({
+          path: key.slice(prefix.length),
+          size: entry.size,
+          lastModified: entry.lastModified
+        });
+      }
+    }
+    return out;
+  }
+  async exists(tenantId, shardId, path) {
+    return this.#store.has(compositeKey(tenantId, shardId, path));
+  }
+  async listAllShards(tenantId) {
+    const prefix = `${tenantId}/`;
+    const shards = /* @__PURE__ */ new Set();
+    for (const key of this.#store.keys()) {
+      if (!key.startsWith(prefix)) continue;
+      const rest = key.slice(prefix.length);
+      const slash = rest.indexOf("/");
+      if (slash < 0) continue;
+      shards.add(rest.slice(0, slash));
+    }
+    return [...shards];
+  }
+  async listAllDocuments(tenantId) {
+    const prefix = `${tenantId}/`;
+    const out = [];
+    for (const [key, entry] of this.#store) {
+      if (!key.startsWith(prefix)) continue;
+      const rest = key.slice(prefix.length);
+      const slash = rest.indexOf("/");
+      if (slash < 0) continue;
+      const shardId = rest.slice(0, slash);
+      const path = rest.slice(slash + 1);
+      out.push({ shardId, path, size: entry.size, lastModified: entry.lastModified });
+    }
+    return out;
+  }
+};
+
+// src/testing.ts
+function createMemoryDocumentBackend() {
+  return new MemoryDocumentBackend();
+}
+export {
+  createMemoryDocumentBackend
+};
+//# sourceMappingURL=testing.js.map

package/dist/testing.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/documents/backends.ts", "../src/testing.ts"],
+  "sourcesContent": ["/*\n * Document zone backends \u2014 concrete storage implementations.\n *\n * MemoryDocumentBackend: Map-based, for tests and ephemeral use.\n * IndexedDBDocumentBackend: The web default. Lazy-inits on first\n *   operation to avoid blocking bootstrap.\n */\n\nimport type { DocumentBackend, DocumentMeta } from './types';\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction compositeKey(tenantId: string, shardId: string, path: string): string {\n  return `${tenantId}/${shardId}/${path}`;\n}\n\nfunction keyPrefix(tenantId: string, shardId: string): string {\n  return `${tenantId}/${shardId}/`;\n}\n\n// ---------------------------------------------------------------------------\n// MemoryDocumentBackend\n// ---------------------------------------------------------------------------\n\ninterface MemoryEntry {\n  content: string | ArrayBuffer;\n  size: number;\n  lastModified: number;\n}\n\nexport class MemoryDocumentBackend implements DocumentBackend {\n  #store = new Map<string, MemoryEntry>();\n\n  async read(\n    tenantId: string,\n    shardId: string,\n    path: string,\n  ): Promise<string | ArrayBuffer | null> {\n    const entry = this.#store.get(compositeKey(tenantId, shardId, path));\n    return entry ? entry.content : null;\n  }\n\n  async write(\n    tenantId: string,\n    shardId: string,\n    path: string,\n    content: string | ArrayBuffer,\n  ): Promise<void> {\n    const size =\n      typeof content === 'string' ? new Blob([content]).size : content.byteLength;\n    this.#store.set(compositeKey(tenantId, shardId, path), {\n      content,\n      size,\n      lastModified: Date.now(),\n    });\n  }\n\n  async delete(tenantId: string, shardId: string, path: string): Promise<void> {\n    this.#store.delete(compositeKey(tenantId, shardId, path));\n  }\n\n  async list(tenantId: string, shardId: string): Promise<DocumentMeta[]> {\n    const prefix = keyPrefix(tenantId, shardId);\n    const out: DocumentMeta[] = [];\n    for (const [key, entry] of this.#store) {\n      if (key.startsWith(prefix)) {\n        out.push({\n          path: key.slice(prefix.length),\n          size: entry.size,\n          lastModified: entry.lastModified,\n        });\n      }\n    }\n    return out;\n  }\n\n  async exists(tenantId: string, shardId: string, path: string): Promise<boolean> {\n    return this.#store.has(compositeKey(tenantId, shardId, path));\n  }\n\n  async listAllShards(tenantId: string): Promise<string[]> {\n    const prefix = `${tenantId}/`;\n    const shards = new Set<string>();\n    for (const key of this.#store.keys()) {\n      if (!key.startsWith(prefix)) continue;\n      const rest = key.slice(prefix.length);\n      const slash = rest.indexOf('/');\n      if (slash < 0) continue;\n      shards.add(rest.slice(0, slash));\n    }\n    return [...shards];\n  }\n\n  async listAllDocuments(\n    tenantId: string,\n  ): Promise<Array<DocumentMeta & { shardId: string }>> {\n    const prefix = `${tenantId}/`;\n    const out: Array<DocumentMeta & { shardId: string }> = [];\n    for (const [key, entry] of this.#store) {\n      if (!key.startsWith(prefix)) continue;\n      const rest = key.slice(prefix.length);\n      const slash = rest.indexOf('/');\n      if (slash < 0) continue;\n      const shardId = rest.slice(0, slash);\n      const path = rest.slice(slash + 1);\n      out.push({ shardId, path, size: entry.size, lastModified: entry.lastModified });\n    }\n    return out;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// IndexedDBDocumentBackend\n// ---------------------------------------------------------------------------\n\nconst IDB_NAME = 'sh3-documents';\nconst IDB_STORE = 'docs';\nconst IDB_VERSION = 2;\n\ninterface IDBEntry {\n  content: string | ArrayBuffer;\n  size: number;\n  lastModified: number;\n}\n\nexport class IndexedDBDocumentBackend implements DocumentBackend {\n  #dbPromise: Promise<IDBDatabase> | null = null;\n\n  /**\n   * Lazy-open the database on first use. The promise is cached so\n   * subsequent calls await the same open.\n   */\n  #db(): Promise<IDBDatabase> {\n    if (!this.#dbPromise) {\n      this.#dbPromise = new Promise<IDBDatabase>((resolve, reject) => {\n        const req = indexedDB.open(IDB_NAME, IDB_VERSION);\n        req.onupgradeneeded = () => {\n          const db = req.result;\n          if (!db.objectStoreNames.contains(IDB_STORE)) {\n            db.createObjectStore(IDB_STORE);\n          }\n        };\n        req.onsuccess = () => resolve(req.result);\n        req.onerror = () => reject(req.error);\n      });\n    }\n    return this.#dbPromise;\n  }\n\n  /** Run a single-store transaction and return the request result. */\n  async #tx<T>(\n    mode: IDBTransactionMode,\n    fn: (store: IDBObjectStore) => IDBRequest<T>,\n  ): Promise<T> {\n    const db = await this.#db();\n    return new Promise<T>((resolve, reject) => {\n      const tx = db.transaction(IDB_STORE, mode);\n      const store = tx.objectStore(IDB_STORE);\n      const req = fn(store);\n      req.onsuccess = () => resolve(req.result);\n      req.onerror = () => reject(req.error);\n    });\n  }\n\n  async read(\n    tenantId: string,\n    shardId: string,\n    path: string,\n  ): Promise<string | ArrayBuffer | null> {\n    const key = compositeKey(tenantId, shardId, path);\n    const entry = await this.#tx<IDBEntry | undefined>('readonly', (s) => s.get(key));\n    return entry ? entry.content : null;\n  }\n\n  async write(\n    tenantId: string,\n    shardId: string,\n    path: string,\n    content: string | ArrayBuffer,\n  ): Promise<void> {\n    const key = compositeKey(tenantId, shardId, path);\n    const size =\n      typeof content === 'string' ? new Blob([content]).size : content.byteLength;\n    const entry: IDBEntry = { content, size, lastModified: Date.now() };\n    await this.#tx('readwrite', (s) => s.put(entry, key));\n  }\n\n  async delete(tenantId: string, shardId: string, path: string): Promise<void> {\n    const key = compositeKey(tenantId, shardId, path);\n    await this.#tx('readwrite', (s) => s.delete(key));\n  }\n\n  async list(tenantId: string, shardId: string): Promise<DocumentMeta[]> {\n    const prefix = keyPrefix(tenantId, shardId);\n    const db = await this.#db();\n    return new Promise<DocumentMeta[]>((resolve, reject) => {\n      const tx = db.transaction(IDB_STORE, 'readonly');\n      const store = tx.objectStore(IDB_STORE);\n      // IDBKeyRange.bound selects all keys that start with the prefix.\n      // The upper bound appends a character beyond '/' to capture all\n      // sub-paths without over-selecting.\n      const range = IDBKeyRange.bound(prefix, prefix + '\\uffff', false, false);\n      const req = store.openCursor(range);\n      const out: DocumentMeta[] = [];\n      req.onsuccess = () => {\n        const cursor = req.result;\n        if (cursor) {\n          const entry = cursor.value as IDBEntry;\n          out.push({\n            path: (cursor.key as string).slice(prefix.length),\n            size: entry.size,\n            lastModified: entry.lastModified,\n          });\n          cursor.continue();\n        } else {\n          resolve(out);\n        }\n      };\n      req.onerror = () => reject(req.error);\n    });\n  }\n\n  async exists(tenantId: string, shardId: string, path: string): Promise<boolean> {\n    const key = compositeKey(tenantId, shardId, path);\n    // getKey is cheaper than get \u2014 avoids deserializing the value.\n    const result = await this.#tx<IDBValidKey | undefined>(\n      'readonly',\n      (s) => s.getKey(key),\n    );\n    return result !== undefined;\n  }\n\n  async listAllShards(tenantId: string): Promise<string[]> {\n    const prefix = `${tenantId}/`;\n    const db = await this.#db();\n    return new Promise<string[]>((resolve, reject) => {\n      const tx = db.transaction(IDB_STORE, 'readonly');\n      const store = tx.objectStore(IDB_STORE);\n      const range = IDBKeyRange.bound(prefix, prefix + '\\uffff', false, false);\n      const req = store.openKeyCursor(range);\n      const shards = new Set<string>();\n      req.onsuccess = () => {\n        const cursor = req.result;\n        if (cursor) {\n          const rest = (cursor.key as string).slice(prefix.length);\n          const slash = rest.indexOf('/');\n          if (slash >= 0) shards.add(rest.slice(0, slash));\n          cursor.continue();\n        } else {\n          resolve([...shards]);\n        }\n      };\n      req.onerror = () => reject(req.error);\n    });\n  }\n\n  async listAllDocuments(\n    tenantId: string,\n  ): Promise<Array<DocumentMeta & { shardId: string }>> {\n    const prefix = `${tenantId}/`;\n    const db = await this.#db();\n    return new Promise<Array<DocumentMeta & { shardId: string }>>((resolve, reject) => {\n      const tx = db.transaction(IDB_STORE, 'readonly');\n      const store = tx.objectStore(IDB_STORE);\n      const range = IDBKeyRange.bound(prefix, prefix + '\\uffff', false, false);\n      const req = store.openCursor(range);\n      const out: Array<DocumentMeta & { shardId: string }> = [];\n      req.onsuccess = () => {\n        const cursor = req.result;\n        if (cursor) {\n          const rest = (cursor.key as string).slice(prefix.length);\n          const slash = rest.indexOf('/');\n          if (slash >= 0) {\n            const entry = cursor.value as IDBEntry;\n            out.push({\n              shardId: rest.slice(0, slash),\n              path: rest.slice(slash + 1),\n              size: entry.size,\n              lastModified: entry.lastModified,\n            });\n          }\n          cursor.continue();\n        } else {\n          resolve(out);\n        }\n      };\n      req.onerror = () => reject(req.error);\n    });\n  }\n}\n", "/*\n * Testing utilities subpath entry \u2014 exports in-memory helpers for use\n * in sh3-server and shard tests without pulling in browser-only code.\n */\n\nimport { MemoryDocumentBackend } from './documents/backends';\nimport type { DocumentBackend } from './documents/types';\n\n/** Factory wrapper so test code can call createMemoryDocumentBackend() without new. */\nexport function createMemoryDocumentBackend(): DocumentBackend {\n  return new MemoryDocumentBackend();\n}\n"],
+  "mappings": ";AAcA,SAAS,aAAa,UAAkB,SAAiB,MAAsB;AAC7E,SAAO,GAAG,QAAQ,IAAI,OAAO,IAAI,IAAI;AACvC;AAEA,SAAS,UAAU,UAAkB,SAAyB;AAC5D,SAAO,GAAG,QAAQ,IAAI,OAAO;AAC/B;AAYO,IAAM,wBAAN,MAAuD;AAAA,EAC5D,SAAS,oBAAI,IAAyB;AAAA,EAEtC,MAAM,KACJ,UACA,SACA,MACsC;AACtC,UAAM,QAAQ,KAAK,OAAO,IAAI,aAAa,UAAU,SAAS,IAAI,CAAC;AACnE,WAAO,QAAQ,MAAM,UAAU;AAAA,EACjC;AAAA,EAEA,MAAM,MACJ,UACA,SACA,MACA,SACe;AACf,UAAM,OACJ,OAAO,YAAY,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,OAAO,QAAQ;AACnE,SAAK,OAAO,IAAI,aAAa,UAAU,SAAS,IAAI,GAAG;AAAA,MACrD;AAAA,MACA;AAAA,MACA,cAAc,KAAK,IAAI;AAAA,IACzB,CAAC;AAAA,EACH;AAAA,EAEA,MAAM,OAAO,UAAkB,SAAiB,MAA6B;AAC3E,SAAK,OAAO,OAAO,aAAa,UAAU,SAAS,IAAI,CAAC;AAAA,EAC1D;AAAA,EAEA,MAAM,KAAK,UAAkB,SAA0C;AACrE,UAAM,SAAS,UAAU,UAAU,OAAO;AAC1C,UAAM,MAAsB,CAAC;AAC7B,eAAW,CAAC,KAAK,KAAK,KAAK,KAAK,QAAQ;AACtC,UAAI,IAAI,WAAW,MAAM,GAAG;AAC1B,YAAI,KAAK;AAAA,UACP,MAAM,IAAI,MAAM,OAAO,MAAM;AAAA,UAC7B,MAAM,MAAM;AAAA,UACZ,cAAc,MAAM;AAAA,QACtB,CAAC;AAAA,MACH;AAAA,IACF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,MAAM,OAAO,UAAkB,SAAiB,MAAgC;AAC9E,WAAO,KAAK,OAAO,IAAI,aAAa,UAAU,SAAS,IAAI,CAAC;AAAA,EAC9D;AAAA,EAEA,MAAM,cAAc,UAAqC;AACvD,UAAM,SAAS,GAAG,QAAQ;AAC1B,UAAM,SAAS,oBAAI,IAAY;AAC/B,eAAW,OAAO,KAAK,OAAO,KAAK,GAAG;AACpC,UAAI,CAAC,IAAI,WAAW,MAAM,EAAG;AAC7B,YAAM,OAAO,IAAI,MAAM,OAAO,MAAM;AACpC,YAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,UAAI,QAAQ,EAAG;AACf,aAAO,IAAI,KAAK,MAAM,GAAG,KAAK,CAAC;AAAA,IACjC;AACA,WAAO,CAAC,GAAG,MAAM;AAAA,EACnB;AAAA,EAEA,MAAM,iBACJ,UACoD;AACpD,UAAM,SAAS,GAAG,QAAQ;AAC1B,UAAM,MAAiD,CAAC;AACxD,eAAW,CAAC,KAAK,KAAK,KAAK,KAAK,QAAQ;AACtC,UAAI,CAAC,IAAI,WAAW,MAAM,EAAG;AAC7B,YAAM,OAAO,IAAI,MAAM,OAAO,MAAM;AACpC,YAAM,QAAQ,KAAK,QAAQ,GAAG;AAC9B,UAAI,QAAQ,EAAG;AACf,YAAM,UAAU,KAAK,MAAM,GAAG,KAAK;AACnC,YAAM,OAAO,KAAK,MAAM,QAAQ,CAAC;AACjC,UAAI,KAAK,EAAE,SAAS,MAAM,MAAM,MAAM,MAAM,cAAc,MAAM,aAAa,CAAC;AAAA,IAChF;AACA,WAAO;AAAA,EACT;AACF;;;ACtGO,SAAS,8BAA+C;AAC7D,SAAO,IAAI,sBAAsB;AACnC;",
+  "names": []
+}

package/dist/verbs/types.d.ts

@@ -29,6 +29,25 @@ export interface ShellApi {
         ok: boolean;
         error?: string;
     };
+    listStandaloneViews(): Array<{
+        shardId: string;
+        viewId: string;
+        label: string;
+    }>;
+    popoutSlot(slotId: string): {
+        ok: boolean;
+        error?: string;
+        floatId?: string;
+    };
+    dockFloat(floatId: string): {
+        ok: boolean;
+        error?: string;
+    };
+    listFloats(): Array<{
+        floatId: string;
+        viewId: string | null;
+        label: string;
+    }>;
     listZones(shardId?: string): Array<{
         shardId: string;
         zones: string[];

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export declare const VERSION = "0.8.0";
+export declare const VERSION = "0.8.2";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Auto-generated from package.json — do not edit manually. */
-export const VERSION = '0.8.0';
+export const VERSION = '0.8.2';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sh3-core",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "type": "module",
   "files": [
     "dist"
@@ -26,10 +26,18 @@
     "./build": {
       "types": "./dist/build.d.ts",
       "default": "./dist/build.js"
+    },
+    "./server-sync": {
+      "types": "./dist/server-sync.d.ts",
+      "default": "./dist/server-sync.js"
+    },
+    "./testing": {
+      "types": "./dist/testing.d.ts",
+      "default": "./dist/testing.js"
     }
   },
   "scripts": {
-    "build": "node --import tsx scripts/sync-version.ts && svelte-package -i src -o dist && node --import tsx scripts/generate-api-docs.ts",
+    "build": "node --import tsx scripts/sync-version.ts && svelte-package -i src -o dist && node --import tsx scripts/bundle-node-entries.ts && node --import tsx scripts/generate-api-docs.ts",
     "check": "svelte-check --tsconfig ./tsconfig.json",
     "pack": "npm run build && npm pack",
     "test": "vitest run --passWithNoTests",