@bendyline/squisq 1.0.1 → 1.1.0

package/dist/chunk-4CRBS35L.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/MemoryStorageAdapter.ts","../src/storage/LocalStorageAdapter.ts","../src/storage/LocalForageAdapter.ts","../src/storage/ContentContainer.ts","../src/storage/MediaProviderFromContainer.ts"],"sourcesContent":["/**\n * In-memory storage adapter for testing and SSR environments.\n * Data does not persist across page reloads.\n */\n\nimport type { StorageAdapter } from './Storage.js';\n\nexport class MemoryStorageAdapter implements StorageAdapter {\n  readonly supportsEnumeration = true;\n  private store = new Map<string, string>();\n\n  async get<T>(key: string): Promise<T | null> {\n    const val = this.store.get(key);\n    if (val === undefined) return null;\n    try {\n      return JSON.parse(val) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    this.store.set(key, JSON.stringify(value));\n  }\n\n  async remove(key: string): Promise<void> {\n    this.store.delete(key);\n  }\n\n  async clear(): Promise<void> {\n    this.store.clear();\n  }\n\n  async keys(): Promise<string[]> {\n    return Array.from(this.store.keys());\n  }\n}\n","/**\n * localStorage adapter for web browsers.\n * Supports a configurable key prefix to namespace stored data.\n */\n\nimport type { StorageAdapter } from './Storage.js';\n\nexport class LocalStorageAdapter implements StorageAdapter {\n  readonly supportsEnumeration = true;\n  private prefix: string;\n\n  constructor(prefix = '') {\n    this.prefix = prefix;\n  }\n\n  async get<T>(key: string): Promise<T | null> {\n    try {\n      const raw = localStorage.getItem(this.prefix + key);\n      if (raw === null) return null;\n      return JSON.parse(raw) as T;\n    } catch {\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    localStorage.setItem(this.prefix + key, JSON.stringify(value));\n  }\n\n  async remove(key: string): Promise<void> {\n    localStorage.removeItem(this.prefix + key);\n  }\n\n  async clear(): Promise<void> {\n    const keysToRemove: string[] = [];\n    for (let i = 0; i < localStorage.length; i++) {\n      const k = localStorage.key(i);\n      if (k && k.startsWith(this.prefix)) {\n        keysToRemove.push(k);\n      }\n    }\n    for (const k of keysToRemove) {\n      localStorage.removeItem(k);\n    }\n  }\n\n  async keys(): Promise<string[]> {\n    const result: string[] = [];\n    for (let i = 0; i < localStorage.length; i++) {\n      const k = localStorage.key(i);\n      if (k && k.startsWith(this.prefix)) {\n        result.push(k.slice(this.prefix.length));\n      }\n    }\n    return result;\n  }\n}\n","/**\n * LocalForage adapter - IndexedDB storage with automatic fallbacks.\n *\n * Uses localforage which provides IndexedDB storage with automatic\n * fallbacks to WebSQL and localStorage. This allows storing much more\n * data than raw localStorage (which is limited to ~5MB).\n *\n * Unlike LocalStorageAdapter, this adapter can store binary data\n * (ArrayBuffer, Blob, Uint8Array) natively without JSON serialization.\n *\n * Ported from qualla-internal/shared/services/StorageAdapters.ts with\n * configurable store name and key prefix.\n */\n\nimport localforage from 'localforage';\nimport type { StorageAdapter } from './Storage.js';\n\nexport interface LocalForageAdapterOptions {\n  /** IndexedDB database name (default: 'squisq') */\n  name?: string;\n  /** IndexedDB object store name (default: 'data') */\n  storeName?: string;\n  /** Key prefix for namespacing (default: '') */\n  prefix?: string;\n  /** Human-readable description (default: 'Squisq storage') */\n  description?: string;\n}\n\nexport class LocalForageAdapter implements StorageAdapter {\n  readonly supportsEnumeration = true;\n  private store: LocalForage;\n  private prefix: string;\n\n  constructor(options: LocalForageAdapterOptions = {}) {\n    const {\n      name = 'squisq',\n      storeName = 'data',\n      prefix = '',\n      description = 'Squisq storage',\n    } = options;\n\n    this.prefix = prefix;\n    this.store = localforage.createInstance({ name, storeName, description });\n  }\n\n  async get<T>(key: string): Promise<T | null> {\n    try {\n      const value = await this.store.getItem<T>(this.prefix + key);\n      return value;\n    } catch (e: unknown) {\n      console.warn('[Storage] get (IndexedDB) failed:', key, e);\n      return null;\n    }\n  }\n\n  async set<T>(key: string, value: T): Promise<void> {\n    try {\n      await this.store.setItem(this.prefix + key, value);\n    } catch (e: unknown) {\n      console.error('[Storage] set (IndexedDB) failed:', key, e);\n      throw e;\n    }\n  }\n\n  async remove(key: string): Promise<void> {\n    try {\n      await this.store.removeItem(this.prefix + key);\n    } catch (e: unknown) {\n      console.warn('[Storage] remove (IndexedDB) failed:', key, e);\n    }\n  }\n\n  async clear(): Promise<void> {\n    try {\n      if (this.prefix) {\n        // Only remove keys with our prefix\n        const keys = await this.store.keys();\n        const keysToRemove = keys.filter((k) => k.startsWith(this.prefix));\n        await Promise.all(keysToRemove.map((k) => this.store.removeItem(k)));\n      } else {\n        // No prefix — clear the entire store\n        await this.store.clear();\n      }\n    } catch (e: unknown) {\n      console.error('[Storage] clear (IndexedDB) failed:', e);\n    }\n  }\n\n  async keys(): Promise<string[]> {\n    try {\n      const allKeys = await this.store.keys();\n      if (this.prefix) {\n        return allKeys\n          .filter((k) => k.startsWith(this.prefix))\n          .map((k) => k.slice(this.prefix.length));\n      }\n      return allKeys;\n    } catch (e: unknown) {\n      console.warn('[Storage] keys (IndexedDB) failed:', e);\n      return [];\n    }\n  }\n}\n","/**\n * ContentContainer — virtual file system for document containers.\n *\n * A Squisq document is more than just markdown: it's a container of files\n * including the primary markdown document, images, audio, timing data, and\n * other media. ContentContainer provides an abstract async file system\n * interface for reading, writing, and listing these files.\n *\n * Paths are forward-slash separated strings relative to the container root\n * (e.g., 'images/hero.jpg', 'index.md'). No leading slash.\n *\n * Implementations:\n * - MemoryContentContainer — in-memory Map (for zip import, tests, transient use)\n * - SlotContentContainer — backed by IndexedDB slot storage (in the site package)\n */\n\n/**\n * Metadata about a file in a ContentContainer.\n */\nexport interface ContentEntry {\n  /** Relative path within the container (e.g., 'images/hero.jpg') */\n  path: string;\n  /** MIME type (e.g., 'image/jpeg') */\n  mimeType: string;\n  /** File size in bytes */\n  size: number;\n}\n\n/**\n * Abstract async file system for document containers.\n *\n * All paths are forward-slash separated, relative to the container root,\n * with no leading slash. Example: 'images/hero.jpg', 'index.md'.\n */\nexport interface ContentContainer {\n  /** Read a file's binary content. Returns null if the file does not exist. */\n  readFile(path: string): Promise<ArrayBuffer | null>;\n\n  /** Write a file. Creates or overwrites. */\n  writeFile(path: string, data: ArrayBuffer | Uint8Array, mimeType?: string): Promise<void>;\n\n  /** Remove a file. No-op if the file does not exist. */\n  removeFile(path: string): Promise<void>;\n\n  /**\n   * List files in the container.\n   * @param prefix — Optional path prefix to filter by (e.g., 'images/')\n   */\n  listFiles(prefix?: string): Promise<ContentEntry[]>;\n\n  /** Check whether a file exists. */\n  exists(path: string): Promise<boolean>;\n\n  /**\n   * Find the primary markdown document path.\n   *\n   * Discovery order: index.md → doc.md → document.md → first *.md at root.\n   * Returns null if no markdown file is found at the root level.\n   */\n  getDocumentPath(): Promise<string | null>;\n\n  /**\n   * Convenience: read the primary markdown document as a UTF-8 string.\n   * Returns null if no markdown file is found.\n   */\n  readDocument(): Promise<string | null>;\n\n  /**\n   * Convenience: write a markdown document.\n   * @param markdown — The markdown content\n   * @param filename — Filename to use (defaults to 'index.md')\n   */\n  writeDocument(markdown: string, filename?: string): Promise<void>;\n}\n\n// ============================================\n// Well-known markdown filenames in priority order\n// ============================================\n\nconst MARKDOWN_PRIORITY = ['index.md', 'doc.md', 'document.md'];\n\n/**\n * Find the primary markdown path from a list of file entries.\n * Exported for reuse by other ContentContainer implementations.\n */\nexport function findDocumentPath(entries: ContentEntry[]): string | null {\n  // Only consider root-level files (no '/' in path)\n  const rootFiles = entries.filter((e) => !e.path.includes('/'));\n\n  for (const name of MARKDOWN_PRIORITY) {\n    if (rootFiles.some((e) => e.path.toLowerCase() === name)) {\n      return name;\n    }\n  }\n\n  // Fallback: first .md file at root\n  const firstMd = rootFiles.find((e) => e.path.toLowerCase().endsWith('.md'));\n  return firstMd?.path ?? null;\n}\n\n// ============================================\n// MemoryContentContainer\n// ============================================\n\ninterface MemoryFile {\n  data: ArrayBuffer;\n  mimeType: string;\n}\n\n/**\n * In-memory ContentContainer backed by a Map.\n *\n * Used for zip import (deserialize into memory), tests, and transient operations.\n */\nexport class MemoryContentContainer implements ContentContainer {\n  private files = new Map<string, MemoryFile>();\n\n  async readFile(path: string): Promise<ArrayBuffer | null> {\n    return this.files.get(path)?.data ?? null;\n  }\n\n  async writeFile(path: string, data: ArrayBuffer | Uint8Array, mimeType?: string): Promise<void> {\n    const buffer = data instanceof ArrayBuffer ? data : data.slice().buffer;\n    this.files.set(path, {\n      data: buffer,\n      mimeType: mimeType ?? guessMimeType(path),\n    });\n  }\n\n  async removeFile(path: string): Promise<void> {\n    this.files.delete(path);\n  }\n\n  async listFiles(prefix?: string): Promise<ContentEntry[]> {\n    const entries: ContentEntry[] = [];\n    for (const [path, file] of this.files) {\n      if (prefix && !path.startsWith(prefix)) continue;\n      entries.push({\n        path,\n        mimeType: file.mimeType,\n        size: file.data.byteLength,\n      });\n    }\n    return entries;\n  }\n\n  async exists(path: string): Promise<boolean> {\n    return this.files.has(path);\n  }\n\n  async getDocumentPath(): Promise<string | null> {\n    return findDocumentPath(await this.listFiles());\n  }\n\n  async readDocument(): Promise<string | null> {\n    const docPath = await this.getDocumentPath();\n    if (!docPath) return null;\n    const data = await this.readFile(docPath);\n    if (!data) return null;\n    return new TextDecoder().decode(data);\n  }\n\n  async writeDocument(markdown: string, filename?: string): Promise<void> {\n    const name = filename ?? 'index.md';\n    const data = new TextEncoder().encode(markdown);\n    await this.writeFile(name, data, 'text/markdown');\n  }\n}\n\n// ============================================\n// MIME type guessing\n// ============================================\n\nconst EXTENSION_MIME_MAP: Record<string, string> = {\n  '.md': 'text/markdown',\n  '.txt': 'text/plain',\n  '.json': 'application/json',\n  '.jpg': 'image/jpeg',\n  '.jpeg': 'image/jpeg',\n  '.png': 'image/png',\n  '.gif': 'image/gif',\n  '.svg': 'image/svg+xml',\n  '.webp': 'image/webp',\n  '.avif': 'image/avif',\n  '.mp4': 'video/mp4',\n  '.webm': 'video/webm',\n  '.mp3': 'audio/mpeg',\n  '.wav': 'audio/wav',\n  '.ogg': 'audio/ogg',\n  '.css': 'text/css',\n  '.html': 'text/html',\n  '.js': 'application/javascript',\n};\n\nfunction guessMimeType(path: string): string {\n  const dot = path.lastIndexOf('.');\n  if (dot === -1) return 'application/octet-stream';\n  const ext = path.slice(dot).toLowerCase();\n  return EXTENSION_MIME_MAP[ext] ?? 'application/octet-stream';\n}\n","/**\n * MediaProviderFromContainer — bridges ContentContainer to MediaProvider.\n *\n * Creates a MediaProvider that resolves relative paths by reading binary data\n * from a ContentContainer and generating blob URLs. Blob URLs are cached and\n * revoked on dispose().\n *\n * This allows any ContentContainer (memory, slot-backed, zip-loaded) to be\n * used with existing rendering components (DocPlayer, ImageLayer, VideoLayer)\n * that consume MediaProvider.\n */\n\nimport type { MediaProvider, MediaEntry } from '../schemas/MediaProvider.js';\nimport type { ContentContainer } from './ContentContainer.js';\n\n/**\n * Create a MediaProvider backed by a ContentContainer.\n *\n * @param container — The ContentContainer to read/write media from\n * @returns A MediaProvider that resolves paths to blob URLs\n */\nexport function createMediaProviderFromContainer(container: ContentContainer): MediaProvider {\n  const blobUrlCache = new Map<string, string>();\n\n  return {\n    async resolveUrl(relativePath: string): Promise<string> {\n      const cached = blobUrlCache.get(relativePath);\n      if (cached) return cached;\n\n      const data = await container.readFile(relativePath);\n      if (!data) return relativePath;\n\n      const entries = await container.listFiles();\n      const entry = entries.find((e) => e.path === relativePath);\n      const mimeType = entry?.mimeType ?? 'application/octet-stream';\n\n      const blob = new Blob([data], { type: mimeType });\n      const url = URL.createObjectURL(blob);\n      blobUrlCache.set(relativePath, url);\n      return url;\n    },\n\n    async listMedia(): Promise<MediaEntry[]> {\n      const entries = await container.listFiles();\n      return entries\n        .filter((e) => !e.path.toLowerCase().endsWith('.md'))\n        .map((e) => ({\n          name: e.path,\n          mimeType: e.mimeType,\n          size: e.size,\n        }));\n    },\n\n    async addMedia(\n      name: string,\n      data: ArrayBuffer | Blob | Uint8Array,\n      mimeType: string,\n    ): Promise<string> {\n      // Invalidate any cached blob URL for this path before overwriting\n      const cached = blobUrlCache.get(name);\n      if (cached) {\n        URL.revokeObjectURL(cached);\n        blobUrlCache.delete(name);\n      }\n\n      let buffer: ArrayBuffer | Uint8Array;\n      if (data instanceof Blob) {\n        buffer = await data.arrayBuffer();\n      } else {\n        buffer = data;\n      }\n      await container.writeFile(name, buffer, mimeType);\n      return name;\n    },\n\n    async removeMedia(relativePath: string): Promise<void> {\n      const cached = blobUrlCache.get(relativePath);\n      if (cached) {\n        URL.revokeObjectURL(cached);\n        blobUrlCache.delete(relativePath);\n      }\n      await container.removeFile(relativePath);\n    },\n\n    dispose(): void {\n      for (const url of blobUrlCache.values()) {\n        URL.revokeObjectURL(url);\n      }\n      blobUrlCache.clear();\n    },\n  };\n}\n"],"mappings":"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","names":[]}

package/dist/storage/ContentContainer.d.ts

@@ -0,0 +1,87 @@
+/**
+ * ContentContainer — virtual file system for document containers.
+ *
+ * A Squisq document is more than just markdown: it's a container of files
+ * including the primary markdown document, images, audio, timing data, and
+ * other media. ContentContainer provides an abstract async file system
+ * interface for reading, writing, and listing these files.
+ *
+ * Paths are forward-slash separated strings relative to the container root
+ * (e.g., 'images/hero.jpg', 'index.md'). No leading slash.
+ *
+ * Implementations:
+ * - MemoryContentContainer — in-memory Map (for zip import, tests, transient use)
+ * - SlotContentContainer — backed by IndexedDB slot storage (in the site package)
+ */
+/**
+ * Metadata about a file in a ContentContainer.
+ */
+export interface ContentEntry {
+    /** Relative path within the container (e.g., 'images/hero.jpg') */
+    path: string;
+    /** MIME type (e.g., 'image/jpeg') */
+    mimeType: string;
+    /** File size in bytes */
+    size: number;
+}
+/**
+ * Abstract async file system for document containers.
+ *
+ * All paths are forward-slash separated, relative to the container root,
+ * with no leading slash. Example: 'images/hero.jpg', 'index.md'.
+ */
+export interface ContentContainer {
+    /** Read a file's binary content. Returns null if the file does not exist. */
+    readFile(path: string): Promise<ArrayBuffer | null>;
+    /** Write a file. Creates or overwrites. */
+    writeFile(path: string, data: ArrayBuffer | Uint8Array, mimeType?: string): Promise<void>;
+    /** Remove a file. No-op if the file does not exist. */
+    removeFile(path: string): Promise<void>;
+    /**
+     * List files in the container.
+     * @param prefix — Optional path prefix to filter by (e.g., 'images/')
+     */
+    listFiles(prefix?: string): Promise<ContentEntry[]>;
+    /** Check whether a file exists. */
+    exists(path: string): Promise<boolean>;
+    /**
+     * Find the primary markdown document path.
+     *
+     * Discovery order: index.md → doc.md → document.md → first *.md at root.
+     * Returns null if no markdown file is found at the root level.
+     */
+    getDocumentPath(): Promise<string | null>;
+    /**
+     * Convenience: read the primary markdown document as a UTF-8 string.
+     * Returns null if no markdown file is found.
+     */
+    readDocument(): Promise<string | null>;
+    /**
+     * Convenience: write a markdown document.
+     * @param markdown — The markdown content
+     * @param filename — Filename to use (defaults to 'index.md')
+     */
+    writeDocument(markdown: string, filename?: string): Promise<void>;
+}
+/**
+ * Find the primary markdown path from a list of file entries.
+ * Exported for reuse by other ContentContainer implementations.
+ */
+export declare function findDocumentPath(entries: ContentEntry[]): string | null;
+/**
+ * In-memory ContentContainer backed by a Map.
+ *
+ * Used for zip import (deserialize into memory), tests, and transient operations.
+ */
+export declare class MemoryContentContainer implements ContentContainer {
+    private files;
+    readFile(path: string): Promise<ArrayBuffer | null>;
+    writeFile(path: string, data: ArrayBuffer | Uint8Array, mimeType?: string): Promise<void>;
+    removeFile(path: string): Promise<void>;
+    listFiles(prefix?: string): Promise<ContentEntry[]>;
+    exists(path: string): Promise<boolean>;
+    getDocumentPath(): Promise<string | null>;
+    readDocument(): Promise<string | null>;
+    writeDocument(markdown: string, filename?: string): Promise<void>;
+}
+//# sourceMappingURL=ContentContainer.d.ts.map

package/dist/storage/ContentContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContentContainer.d.ts","sourceRoot":"","sources":["../../src/storage/ContentContainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;IACjB,yBAAyB;IACzB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC,CAAC;IAEpD,2CAA2C;IAC3C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1F,uDAAuD;IACvD,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAExC;;;OAGG;IACH,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;IAEpD,mCAAmC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;;;;OAKG;IACH,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEvC;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnE;AAQD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,GAAG,IAAI,CAavE;AAWD;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,gBAAgB;IAC7D,OAAO,CAAC,KAAK,CAAiC;IAExC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,GAAG,IAAI,CAAC;IAInD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,UAAU,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQzF,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvC,SAAS,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAanD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAItC,eAAe,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzC,YAAY,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQtC,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAKxE"}

package/dist/storage/ContentContainer.js

@@ -0,0 +1,122 @@
+/**
+ * ContentContainer — virtual file system for document containers.
+ *
+ * A Squisq document is more than just markdown: it's a container of files
+ * including the primary markdown document, images, audio, timing data, and
+ * other media. ContentContainer provides an abstract async file system
+ * interface for reading, writing, and listing these files.
+ *
+ * Paths are forward-slash separated strings relative to the container root
+ * (e.g., 'images/hero.jpg', 'index.md'). No leading slash.
+ *
+ * Implementations:
+ * - MemoryContentContainer — in-memory Map (for zip import, tests, transient use)
+ * - SlotContentContainer — backed by IndexedDB slot storage (in the site package)
+ */
+// ============================================
+// Well-known markdown filenames in priority order
+// ============================================
+const MARKDOWN_PRIORITY = ['index.md', 'doc.md', 'document.md'];
+/**
+ * Find the primary markdown path from a list of file entries.
+ * Exported for reuse by other ContentContainer implementations.
+ */
+export function findDocumentPath(entries) {
+    // Only consider root-level files (no '/' in path)
+    const rootFiles = entries.filter((e) => !e.path.includes('/'));
+    for (const name of MARKDOWN_PRIORITY) {
+        if (rootFiles.some((e) => e.path.toLowerCase() === name)) {
+            return name;
+        }
+    }
+    // Fallback: first .md file at root
+    const firstMd = rootFiles.find((e) => e.path.toLowerCase().endsWith('.md'));
+    return firstMd?.path ?? null;
+}
+/**
+ * In-memory ContentContainer backed by a Map.
+ *
+ * Used for zip import (deserialize into memory), tests, and transient operations.
+ */
+export class MemoryContentContainer {
+    constructor() {
+        this.files = new Map();
+    }
+    async readFile(path) {
+        return this.files.get(path)?.data ?? null;
+    }
+    async writeFile(path, data, mimeType) {
+        const buffer = data instanceof ArrayBuffer ? data : data.slice().buffer;
+        this.files.set(path, {
+            data: buffer,
+            mimeType: mimeType ?? guessMimeType(path),
+        });
+    }
+    async removeFile(path) {
+        this.files.delete(path);
+    }
+    async listFiles(prefix) {
+        const entries = [];
+        for (const [path, file] of this.files) {
+            if (prefix && !path.startsWith(prefix))
+                continue;
+            entries.push({
+                path,
+                mimeType: file.mimeType,
+                size: file.data.byteLength,
+            });
+        }
+        return entries;
+    }
+    async exists(path) {
+        return this.files.has(path);
+    }
+    async getDocumentPath() {
+        return findDocumentPath(await this.listFiles());
+    }
+    async readDocument() {
+        const docPath = await this.getDocumentPath();
+        if (!docPath)
+            return null;
+        const data = await this.readFile(docPath);
+        if (!data)
+            return null;
+        return new TextDecoder().decode(data);
+    }
+    async writeDocument(markdown, filename) {
+        const name = filename ?? 'index.md';
+        const data = new TextEncoder().encode(markdown);
+        await this.writeFile(name, data, 'text/markdown');
+    }
+}
+// ============================================
+// MIME type guessing
+// ============================================
+const EXTENSION_MIME_MAP = {
+    '.md': 'text/markdown',
+    '.txt': 'text/plain',
+    '.json': 'application/json',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.png': 'image/png',
+    '.gif': 'image/gif',
+    '.svg': 'image/svg+xml',
+    '.webp': 'image/webp',
+    '.avif': 'image/avif',
+    '.mp4': 'video/mp4',
+    '.webm': 'video/webm',
+    '.mp3': 'audio/mpeg',
+    '.wav': 'audio/wav',
+    '.ogg': 'audio/ogg',
+    '.css': 'text/css',
+    '.html': 'text/html',
+    '.js': 'application/javascript',
+};
+function guessMimeType(path) {
+    const dot = path.lastIndexOf('.');
+    if (dot === -1)
+        return 'application/octet-stream';
+    const ext = path.slice(dot).toLowerCase();
+    return EXTENSION_MIME_MAP[ext] ?? 'application/octet-stream';
+}
+//# sourceMappingURL=ContentContainer.js.map

package/dist/storage/ContentContainer.js.map

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

package/dist/storage/MediaProviderFromContainer.d.ts

@@ -0,0 +1,21 @@
+/**
+ * MediaProviderFromContainer — bridges ContentContainer to MediaProvider.
+ *
+ * Creates a MediaProvider that resolves relative paths by reading binary data
+ * from a ContentContainer and generating blob URLs. Blob URLs are cached and
+ * revoked on dispose().
+ *
+ * This allows any ContentContainer (memory, slot-backed, zip-loaded) to be
+ * used with existing rendering components (DocPlayer, ImageLayer, VideoLayer)
+ * that consume MediaProvider.
+ */
+import type { MediaProvider } from '../schemas/MediaProvider.js';
+import type { ContentContainer } from './ContentContainer.js';
+/**
+ * Create a MediaProvider backed by a ContentContainer.
+ *
+ * @param container — The ContentContainer to read/write media from
+ * @returns A MediaProvider that resolves paths to blob URLs
+ */
+export declare function createMediaProviderFromContainer(container: ContentContainer): MediaProvider;
+//# sourceMappingURL=MediaProviderFromContainer.d.ts.map

package/dist/storage/MediaProviderFromContainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"MediaProviderFromContainer.d.ts","sourceRoot":"","sources":["../../src/storage/MediaProviderFromContainer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAc,MAAM,6BAA6B,CAAC;AAC7E,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAE9D;;;;;GAKG;AACH,wBAAgB,gCAAgC,CAAC,SAAS,EAAE,gBAAgB,GAAG,aAAa,CAsE3F"}

package/dist/storage/MediaProviderFromContainer.js

@@ -0,0 +1,79 @@
+/**
+ * MediaProviderFromContainer — bridges ContentContainer to MediaProvider.
+ *
+ * Creates a MediaProvider that resolves relative paths by reading binary data
+ * from a ContentContainer and generating blob URLs. Blob URLs are cached and
+ * revoked on dispose().
+ *
+ * This allows any ContentContainer (memory, slot-backed, zip-loaded) to be
+ * used with existing rendering components (DocPlayer, ImageLayer, VideoLayer)
+ * that consume MediaProvider.
+ */
+/**
+ * Create a MediaProvider backed by a ContentContainer.
+ *
+ * @param container — The ContentContainer to read/write media from
+ * @returns A MediaProvider that resolves paths to blob URLs
+ */
+export function createMediaProviderFromContainer(container) {
+    const blobUrlCache = new Map();
+    return {
+        async resolveUrl(relativePath) {
+            const cached = blobUrlCache.get(relativePath);
+            if (cached)
+                return cached;
+            const data = await container.readFile(relativePath);
+            if (!data)
+                return relativePath;
+            const entries = await container.listFiles();
+            const entry = entries.find((e) => e.path === relativePath);
+            const mimeType = entry?.mimeType ?? 'application/octet-stream';
+            const blob = new Blob([data], { type: mimeType });
+            const url = URL.createObjectURL(blob);
+            blobUrlCache.set(relativePath, url);
+            return url;
+        },
+        async listMedia() {
+            const entries = await container.listFiles();
+            return entries
+                .filter((e) => !e.path.toLowerCase().endsWith('.md'))
+                .map((e) => ({
+                name: e.path,
+                mimeType: e.mimeType,
+                size: e.size,
+            }));
+        },
+        async addMedia(name, data, mimeType) {
+            // Invalidate any cached blob URL for this path before overwriting
+            const cached = blobUrlCache.get(name);
+            if (cached) {
+                URL.revokeObjectURL(cached);
+                blobUrlCache.delete(name);
+            }
+            let buffer;
+            if (data instanceof Blob) {
+                buffer = await data.arrayBuffer();
+            }
+            else {
+                buffer = data;
+            }
+            await container.writeFile(name, buffer, mimeType);
+            return name;
+        },
+        async removeMedia(relativePath) {
+            const cached = blobUrlCache.get(relativePath);
+            if (cached) {
+                URL.revokeObjectURL(cached);
+                blobUrlCache.delete(relativePath);
+            }
+            await container.removeFile(relativePath);
+        },
+        dispose() {
+            for (const url of blobUrlCache.values()) {
+                URL.revokeObjectURL(url);
+            }
+            blobUrlCache.clear();
+        },
+    };
+}
+//# sourceMappingURL=MediaProviderFromContainer.js.map

package/dist/storage/MediaProviderFromContainer.js.map

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

package/dist/storage/index.d.ts

@@ -3,4 +3,7 @@ export { MemoryStorageAdapter } from './MemoryStorageAdapter.js';
 export { LocalStorageAdapter } from './LocalStorageAdapter.js';
 export { LocalForageAdapter } from './LocalForageAdapter.js';
 export type { LocalForageAdapterOptions } from './LocalForageAdapter.js';
+export type { ContentContainer, ContentEntry } from './ContentContainer.js';
+export { MemoryContentContainer, findDocumentPath } from './ContentContainer.js';
+export { createMediaProviderFromContainer } from './MediaProviderFromContainer.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/storage/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,YAAY,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACzE,YAAY,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC"}

package/dist/storage/index.js

@@ -1,4 +1,6 @@
 export { MemoryStorageAdapter } from './MemoryStorageAdapter.js';
 export { LocalStorageAdapter } from './LocalStorageAdapter.js';
 export { LocalForageAdapter } from './LocalForageAdapter.js';
+export { MemoryContentContainer, findDocumentPath } from './ContentContainer.js';
+export { createMediaProviderFromContainer } from './MediaProviderFromContainer.js';
 //# sourceMappingURL=index.js.map

package/dist/storage/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/storage/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACjF,OAAO,EAAE,gCAAgC,EAAE,MAAM,iCAAiC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bendyline/squisq",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "description": "Headless utilities for doc/block rendering, spatial math, Markdown, and storage",
   "license": "MIT",
   "author": "Bendyline",