@bendyline/squisq-formats 1.2.3 → 1.3.1

package/src/html/plainHtmlBundle.ts

@@ -0,0 +1,419 @@
+/**
+ * Recursive plain-HTML bundle export.
+ *
+ * `markdownDocsToPlainHtmlBundle` starts from a single entry markdown
+ * file, walks its relative `[…](other.md)` links, recursively pulls in
+ * any sibling/child documents (scope-limited to the entry doc's
+ * directory tree), renders every visited file via
+ * `markdownDocToPlainHtml`, rewrites cross-doc references from `.md`
+ * to `.html`, and ships everything as a single ZIP.
+ *
+ * The function is provider-agnostic — callers pass `readDocument` and
+ * `readBinary` callbacks that resolve relative paths against whatever
+ * storage they use (`FileSystemContentContainer`, `MemoryContent-
+ * Container`, in-memory map for tests, …). Failure to read any
+ * discovered file aborts the whole export with a thrown error.
+ */
+
+import JSZip from 'jszip';
+import { parseMarkdown, inferDocumentTitle } from '@bendyline/squisq/markdown';
+import type { MarkdownDocument, HtmlNode } from '@bendyline/squisq/markdown';
+import type { Theme } from '@bendyline/squisq/schemas';
+import { resolveTheme } from '@bendyline/squisq/schemas';
+import { markdownDocToPlainHtml } from './plainHtml.js';
+
+// ── Public Types ───────────────────────────────────────────────────
+
+export interface PlainHtmlBundleOptions {
+  /** Entry document path relative to the container root (e.g. `'home.md'`). */
+  entryPath: string;
+  /** Reads a UTF-8 markdown file from the container. Returns null when absent. */
+  readDocument: (path: string) => Promise<string | null>;
+  /** Reads a binary asset (image) from the container. Returns null when absent. */
+  readBinary: (path: string) => Promise<ArrayBuffer | null>;
+  /** Optional document title for the entry. Others derive from filename. */
+  title?: string;
+  /** Optional theme applied uniformly to every page. Overrides {@link themeId}. */
+  theme?: Theme;
+  /**
+   * Optional theme id (e.g. `'warm-earth'`, `'gezellig'`). Resolved via
+   * `resolveTheme` and applied to every page. Convenient for callers
+   * that track themes by id (like the host export dialog) without
+   * having to resolve to a `Theme` object first. When both `theme` and
+   * `themeId` are supplied, `theme` wins.
+   */
+  themeId?: string;
+  /** Maximum recursion depth (default: unlimited; cycles always handled). */
+  maxDepth?: number;
+  /**
+   * Emit the entry doc as `index.html` (preserving its parent directory)
+   * instead of `<basename>.html`. Cross-doc links pointing at the entry
+   * also rewrite to `index.html`, so a sibling `resume.md → home.md`
+   * link doesn't 404 after the rename. Convenient for static-site
+   * deploys where the landing page must be named `index.html`.
+   * Default: false.
+   */
+  entryAsIndex?: boolean;
+}
+
+// ── Public API ─────────────────────────────────────────────────────
+
+/**
+ * Render an entry markdown document and every reachable sibling/child
+ * `.md` document it links to, bundled as a single ZIP with plain-HTML
+ * pages, per-document asset folders, and cross-doc `<a href>`
+ * references rewritten from `.md` to `.html`.
+ */
+export async function markdownDocsToPlainHtmlBundle(
+  options: PlainHtmlBundleOptions,
+): Promise<Blob> {
+  const {
+    entryPath,
+    readDocument,
+    readBinary,
+    title,
+    theme,
+    themeId,
+    maxDepth = Infinity,
+    entryAsIndex = false,
+  } = options;
+  const resolvedTheme = theme ?? (themeId ? resolveTheme(themeId) : undefined);
+  const entry = normalizePath(entryPath);
+  if (!entry) {
+    throw new Error('markdownDocsToPlainHtmlBundle: entryPath is required');
+  }
+  const scopeRoot = posixDirname(entry); // '' for root-level files
+  // When `entryAsIndex`, the entry doc writes to `<entryDir>/index.html`
+  // and every cross-doc link pointing at it rewrites to that path too.
+  // Other docs keep the `<basename>.html` convention.
+  const entryHtmlPath = entryAsIndex
+    ? scopeRoot
+      ? `${scopeRoot}/index.html`
+      : 'index.html'
+    : entry.slice(0, -3) + '.html';
+  const htmlPathFor = (mdPath: string): string =>
+    mdPath === entry ? entryHtmlPath : mdPath.slice(0, -3) + '.html';
+
+  const zip = new JSZip();
+  const visited = new Set<string>();
+  const queue: Array<{ path: string; depth: number }> = [{ path: entry, depth: 0 }];
+
+  while (queue.length > 0) {
+    const { path, depth } = queue.shift()!;
+    if (visited.has(path)) continue;
+    visited.add(path);
+
+    const source = await readDocument(path);
+    if (source === null) {
+      throw new Error(`markdownDocsToPlainHtmlBundle: failed to read "${path}"`);
+    }
+    const mdDoc = parseMarkdown(source);
+
+    // Discover this doc's relative .md links — both for enqueueing new
+    // targets and for building the per-doc link rewrite map. We resolve
+    // each link to a canonical container-relative path so the same doc
+    // referenced two different ways (./resume.md vs resume.md) is
+    // visited once and rewritten consistently.
+    const docDir = posixDirname(path);
+    const linkMap = new Map<string, string>();
+    for (const raw of collectLinkRefs(mdDoc)) {
+      const parsed = parseLinkRef(raw);
+      if (!parsed) continue;
+      const resolved = resolveRelative(docDir, parsed.path);
+      if (resolved === null) continue; // escaped via ..
+      if (!isInScope(resolved, scopeRoot)) continue;
+      if (!resolved.toLowerCase().endsWith('.md')) continue;
+
+      // Compute the .html replacement relative to the current doc so
+      // the rewritten href stays local (e.g. `subdir/notes.html`, not
+      // an absolute container path). `htmlPathFor` also handles the
+      // entry-as-index case so a sibling linking to the entry lands
+      // on `index.html` after rename.
+      const htmlTarget = htmlPathFor(resolved);
+      const relHref = relativeFrom(docDir, htmlTarget) + parsed.fragment;
+      linkMap.set(raw, relHref);
+
+      if (depth + 1 <= maxDepth && !visited.has(resolved)) {
+        queue.push({ path: resolved, depth: depth + 1 });
+      }
+    }
+
+    // Walk images, fetch each one, write at the original relative path
+    // resolved against the container root (so `resume_files/hero.png`
+    // sits next to `resume.html` in the zip). Failures here are *not*
+    // fatal — images can be missing without breaking the document
+    // structure — but we surface them as console warnings.
+    const images = await readImagesForDoc(mdDoc, docDir, readBinary);
+    for (const [, { data, zipPath }] of images) {
+      const safe = sanitizeZipPath(zipPath);
+      if (!safe) continue;
+      zip.file(safe, data);
+    }
+
+    // Render the document. The image rewrite map keys are the URLs
+    // exactly as authored (so `markdownDocToPlainHtml` can match them
+    // verbatim), and the values are paths relative to the rendered
+    // doc's own location — so `<img src>` works after unzip without
+    // any post-processing.
+    const imageRewriteMap = new Map<string, string>();
+    for (const [authored, { zipPath }] of images) {
+      imageRewriteMap.set(authored, relativeFrom(docDir, zipPath));
+    }
+
+    const docTitle = depth === 0 ? title : undefined;
+    const html = markdownDocToPlainHtml(mdDoc, {
+      title: docTitle ?? titleForFilename(path, mdDoc),
+      images: imageRewriteMap,
+      links: linkMap,
+      theme: resolvedTheme,
+    });
+
+    const htmlPath = htmlPathFor(path);
+    zip.file(htmlPath, html);
+  }
+
+  return zip.generateAsync({
+    type: 'blob',
+    compression: 'DEFLATE',
+    compressionOptions: { level: 6 },
+  });
+}
+
+// ── Link discovery ─────────────────────────────────────────────────
+
+/**
+ * Collect every `<a>`-style link URL referenced in a document. Markdown
+ * `link` nodes plus any raw HTML `<a href>` tags. Returns the raw URLs
+ * as authored, so callers can use them as both the linkMap *key* and
+ * the basis for resolution.
+ */
+export function collectLinkRefs(doc: MarkdownDocument): Set<string> {
+  const refs = new Set<string>();
+
+  function visitHtml(nodes: HtmlNode[]): void {
+    for (const n of nodes) {
+      if (n.type !== 'htmlElement') continue;
+      if (n.tagName.toLowerCase() === 'a') {
+        const href = n.attributes.href;
+        if (typeof href === 'string' && href) refs.add(href);
+      }
+      visitHtml(n.children);
+    }
+  }
+
+  function visit(node: unknown): void {
+    if (!node || typeof node !== 'object') return;
+    const n = node as Record<string, unknown>;
+    if (n.type === 'link' && typeof n.url === 'string' && n.url) {
+      refs.add(n.url);
+    }
+    if ((n.type === 'htmlBlock' || n.type === 'htmlInline') && Array.isArray(n.htmlChildren)) {
+      visitHtml(n.htmlChildren as HtmlNode[]);
+    }
+    if (Array.isArray(n.children)) {
+      for (const child of n.children) visit(child);
+    }
+  }
+
+  for (const child of doc.children) visit(child);
+  return refs;
+}
+
+function collectImageRefs(doc: MarkdownDocument): Set<string> {
+  const refs = new Set<string>();
+  function visitHtml(nodes: HtmlNode[]): void {
+    for (const n of nodes) {
+      if (n.type !== 'htmlElement') continue;
+      const tag = n.tagName.toLowerCase();
+      // <img>/<video>/<audio>/<source> all reference media via `src`;
+      // we feed them into the same `images` map (effectively a generic
+      // media map — see header comment) so the export pipeline rewrites
+      // and bundles each one the same way.
+      if (tag === 'img' || tag === 'video' || tag === 'audio' || tag === 'source') {
+        const src = n.attributes.src;
+        if (typeof src === 'string' && src) refs.add(src);
+      }
+      if (tag === 'video' || tag === 'audio') {
+        const poster = n.attributes.poster;
+        if (typeof poster === 'string' && poster) refs.add(poster);
+      }
+      visitHtml(n.children);
+    }
+  }
+  function visit(node: unknown): void {
+    if (!node || typeof node !== 'object') return;
+    const n = node as Record<string, unknown>;
+    if (n.type === 'image' && typeof n.url === 'string' && n.url) refs.add(n.url);
+    if ((n.type === 'htmlBlock' || n.type === 'htmlInline') && Array.isArray(n.htmlChildren)) {
+      visitHtml(n.htmlChildren as HtmlNode[]);
+    }
+    if (Array.isArray(n.children)) for (const c of n.children) visit(c);
+  }
+  for (const child of doc.children) visit(child);
+  return refs;
+}
+
+interface ParsedLinkRef {
+  /** Pathname portion before any `#` or `?`. */
+  path: string;
+  /** `#fragment` suffix (with leading `#`) or empty string. */
+  fragment: string;
+}
+
+/**
+ * Split an authored URL into path + fragment, returning null for
+ * external / non-document references (http(s), mailto, data, blob,
+ * absolute paths, fragment-only). The fragment is preserved so a
+ * link like `resume.md#experience` rewrites cleanly to
+ * `resume.html#experience`.
+ */
+function parseLinkRef(url: string): ParsedLinkRef | null {
+  if (!url) return null;
+  if (url.startsWith('#')) return null; // intra-doc anchor
+  if (
+    /^[a-z][a-z0-9+.-]*:/.test(url) || // http:, https:, mailto:, ftp:, …
+    url.startsWith('//') ||
+    url.startsWith('/')
+  ) {
+    return null;
+  }
+  const hashIdx = url.indexOf('#');
+  const queryIdx = url.indexOf('?');
+  const cut =
+    hashIdx >= 0 && queryIdx >= 0 ? Math.min(hashIdx, queryIdx) : hashIdx >= 0 ? hashIdx : queryIdx;
+  const path = cut >= 0 ? url.slice(0, cut) : url;
+  const fragment = hashIdx >= 0 ? url.slice(hashIdx) : '';
+  return { path, fragment };
+}
+
+// ── Image gathering ────────────────────────────────────────────────
+
+/**
+ * Resolve every image referenced by a document to container-relative
+ * paths and fetch their bytes. The returned map keys are the authored
+ * URLs (so the renderer's `images` map can substitute them); the values
+ * are tuples of `[bytes, zipPath]` where `zipPath` is the path used
+ * inside the zip.
+ *
+ * Images that can't be read are silently dropped — the rendered HTML
+ * will keep its `<img src>` pointing at the authored URL, which a
+ * reader's browser will 404. That matches the user-facing "abort on
+ * missing linked doc" rule which applies to `.md` links only.
+ */
+async function readImagesForDoc(
+  mdDoc: MarkdownDocument,
+  docDir: string,
+  readBinary: (path: string) => Promise<ArrayBuffer | null>,
+): Promise<Map<string, { data: ArrayBuffer; zipPath: string }>> {
+  const out = new Map<string, { data: ArrayBuffer; zipPath: string }>();
+  for (const authored of collectImageRefs(mdDoc)) {
+    if (/^[a-z][a-z0-9+.-]*:/.test(authored) || authored.startsWith('//')) continue;
+    const cleanAuthored = authored.replace(/[#?].*$/, '');
+    const resolved = resolveRelative(docDir, cleanAuthored);
+    if (resolved === null) continue;
+    const data = await readBinary(resolved);
+    if (!data) continue;
+    out.set(authored, { data, zipPath: resolved });
+  }
+  return out;
+}
+
+// ── Path helpers (POSIX-style, no Node `path`) ─────────────────────
+
+/**
+ * Strip a path to its parent directory (POSIX-style). Returns `''`
+ * for root-level files so subsequent joins read like a fresh path.
+ */
+export function posixDirname(p: string): string {
+  const idx = p.lastIndexOf('/');
+  return idx < 0 ? '' : p.slice(0, idx);
+}
+
+/**
+ * Normalize a POSIX path: collapse `./`, resolve `..`, drop trailing
+ * slashes, never produce a leading `/`. Returns null when the path
+ * escapes the start ("..").
+ */
+export function normalizePath(p: string): string | null {
+  const parts = p.split('/');
+  const out: string[] = [];
+  for (const segment of parts) {
+    if (segment === '' || segment === '.') continue;
+    if (segment === '..') {
+      if (out.length === 0) return null;
+      out.pop();
+      continue;
+    }
+    out.push(segment);
+  }
+  return out.join('/');
+}
+
+/**
+ * Resolve `rel` against `baseDir`. Returns null when the result
+ * escapes the container root via `..`.
+ */
+export function resolveRelative(baseDir: string, rel: string): string | null {
+  if (rel.startsWith('/')) return null; // absolute paths are out of scope
+  const joined = baseDir ? `${baseDir}/${rel}` : rel;
+  return normalizePath(joined);
+}
+
+/**
+ * True when `target` is inside `root` (or equal to it). Empty root
+ * means "entire container is in scope".
+ */
+export function isInScope(target: string, root: string): boolean {
+  if (!root) return true;
+  return target === root || target.startsWith(root + '/');
+}
+
+/**
+ * Compute a relative path from `fromDir` to `toPath` (both POSIX-
+ * normalized, container-relative). Used to emit hrefs that work after
+ * unzipping anywhere — `home.md → subfolder/notes.md` becomes
+ * `subfolder/notes.html`; `subfolder/intro.md → resume.md` becomes
+ * `../resume.html`.
+ */
+export function relativeFrom(fromDir: string, toPath: string): string {
+  const fromParts = fromDir ? fromDir.split('/') : [];
+  const toParts = toPath.split('/');
+  let common = 0;
+  while (
+    common < fromParts.length &&
+    common < toParts.length - 1 &&
+    fromParts[common] === toParts[common]
+  ) {
+    common++;
+  }
+  const up = fromParts.length - common;
+  const down = toParts.slice(common);
+  const prefix = Array(up).fill('..').join('/');
+  if (!prefix) return down.join('/');
+  return `${prefix}/${down.join('/')}`;
+}
+
+/**
+ * Sanitize a path for use as a zip entry. Strips leading slashes,
+ * normalizes backslashes (Windows-authored paths), and rejects any
+ * path containing `..` segments after normalization (defensive — the
+ * resolver above already filters those out for links).
+ */
+function sanitizeZipPath(path: string): string | null {
+  const normalized = path.replace(/\\/g, '/').replace(/^\/+/, '');
+  if (!normalized) return null;
+  if (normalized.split('/').some((seg) => seg === '..')) return null;
+  return normalized;
+}
+
+/**
+ * Derive a default page title for a non-entry doc: prefer frontmatter
+ * `title`, fall back to the shallowest heading text, then the filename
+ * without extension.
+ */
+function titleForFilename(path: string, mdDoc: MarkdownDocument): string {
+  const inferred = inferDocumentTitle(mdDoc);
+  if (inferred) return inferred;
+  const base = path.split('/').pop() ?? path;
+  return base.replace(/\.md$/i, '');
+}

package/src/pptx/export.ts

@@ -28,7 +28,7 @@
  */
 
 import type { Doc } from '@bendyline/squisq/schemas';
-import { resolveTheme } from '@bendyline/squisq/schemas';
+import { resolveTheme, resolveFontFamily } from '@bendyline/squisq/schemas';
 import type { Theme } from '@bendyline/squisq/schemas';
 import { docToMarkdown } from '@bendyline/squisq/doc';
 import type {
@@ -48,6 +48,7 @@ import type {
   MarkdownLink,
   MarkdownImage,
 } from '@bendyline/squisq/markdown';
+import { readFrontmatterThemeId } from '@bendyline/squisq/markdown';
 
 import { createPackage } from '../ooxml/writer.js';
 import { xmlDeclaration, escapeXml } from '../ooxml/xmlUtils.js';
@@ -137,11 +138,11 @@ export async function markdownDocToPptx(
   doc: MarkdownDocument,
   options: PptxExportOptions = {},
 ): Promise<ArrayBuffer> {
-  // Resolve theme from options or frontmatter
-  const themeId =
-    options.themeId ??
-    (doc.frontmatter?.themeId as string | undefined) ??
-    (doc.frontmatter?.theme as string | undefined);
+  // Resolve theme from options or frontmatter. The frontmatter lookup
+  // accepts the editor's canonical `squisq-theme` key as well as the
+  // shorter legacy `themeId` / `theme` aliases — see
+  // `readFrontmatterThemeId` for the precedence.
+  const themeId = options.themeId ?? readFrontmatterThemeId(doc.frontmatter);
   const style = resolveSlideStyle(themeId, options);
 
   const slides = segmentIntoSlides(doc.children, options.slideBreak ?? 'h2');
@@ -218,9 +219,9 @@ function resolveSlideStyle(themeId: string | undefined, options: PptxExportOptio
     text: stripHash(c.text),
     titleColor: stripHash(c.highlight || c.secondary || c.text),
     mutedColor: stripHash(c.textMuted || c.text),
-    titleFont: theme.typography?.titleFontFamily || DEFAULT_TITLE_FONT,
-    bodyFont: theme.typography?.bodyFontFamily || options.defaultFont || DEFAULT_FONT,
-    codeFont: theme.typography?.monoFontFamily || DEFAULT_CODE_FONT,
+    titleFont: resolveFontFamily(theme.typography?.titleFont, DEFAULT_TITLE_FONT),
+    bodyFont: resolveFontFamily(theme.typography?.bodyFont, options.defaultFont || DEFAULT_FONT),
+    codeFont: resolveFontFamily(theme.typography?.monoFont, DEFAULT_CODE_FONT),
     codeColor: stripHash(c.textMuted || c.text),
     hasTheme: true,
   };

package/dist/__tests__/container.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * Tests for container ZIP serialization: containerToZip, zipToContainer.
- *
- * Verifies round-trip fidelity: write files to a container, serialize to ZIP,
- * deserialize back, and confirm all files are intact.
- */
-export {};
-//# sourceMappingURL=container.test.d.ts.map

package/dist/__tests__/container.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"container.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/container.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/__tests__/container.test.js

@@ -1,147 +0,0 @@
-/**
- * Tests for container ZIP serialization: containerToZip, zipToContainer.
- *
- * Verifies round-trip fidelity: write files to a container, serialize to ZIP,
- * deserialize back, and confirm all files are intact.
- */
-import { describe, it, expect } from 'vitest';
-import JSZip from 'jszip';
-import { MemoryContentContainer } from '@bendyline/squisq/storage';
-import { containerToZip, zipToContainer } from '../container/index';
-// ============================================
-// Helpers
-// ============================================
-/** Helper to read a Blob as ArrayBuffer (works in jsdom) */
-async function blobToArrayBuffer(blob) {
-    return new Promise((resolve, reject) => {
-        const reader = new FileReader();
-        reader.onload = () => resolve(reader.result);
-        reader.onerror = () => reject(reader.error);
-        reader.readAsArrayBuffer(blob);
-    });
-}
-// ============================================
-// containerToZip
-// ============================================
-describe('containerToZip', () => {
-    it('creates a valid ZIP from an empty container', async () => {
-        const container = new MemoryContentContainer();
-        const blob = await containerToZip(container);
-        expect(blob).toBeInstanceOf(Blob);
-        expect(blob.size).toBeGreaterThan(0);
-        // Should be parseable as a ZIP with no files
-        const zip = await JSZip.loadAsync(await blobToArrayBuffer(blob));
-        expect(Object.keys(zip.files)).toHaveLength(0);
-    });
-    it('includes all files from the container', async () => {
-        const container = new MemoryContentContainer();
-        await container.writeDocument('# Hello World');
-        await container.writeFile('images/hero.jpg', new Uint8Array([0xff, 0xd8, 0xff]), 'image/jpeg');
-        await container.writeFile('timing.json', new TextEncoder().encode('{"duration":10}'));
-        const blob = await containerToZip(container);
-        const zip = await JSZip.loadAsync(await blobToArrayBuffer(blob));
-        const filenames = Object.keys(zip.files)
-            .filter((f) => !zip.files[f].dir)
-            .sort();
-        expect(filenames).toEqual(['images/hero.jpg', 'index.md', 'timing.json']);
-    });
-    it('preserves file content', async () => {
-        const container = new MemoryContentContainer();
-        const markdown = '# Test Document\n\nSome content.';
-        await container.writeDocument(markdown);
-        const blob = await containerToZip(container);
-        const zip = await JSZip.loadAsync(await blobToArrayBuffer(blob));
-        const content = await zip.file('index.md').async('string');
-        expect(content).toBe(markdown);
-    });
-    it('preserves binary content', async () => {
-        const container = new MemoryContentContainer();
-        const binaryData = new Uint8Array([0x89, 0x50, 0x4e, 0x47, 0x0d, 0x0a, 0x1a, 0x0a]);
-        await container.writeFile('image.png', binaryData, 'image/png');
-        const blob = await containerToZip(container);
-        const zip = await JSZip.loadAsync(await blobToArrayBuffer(blob));
-        const data = await zip.file('image.png').async('uint8array');
-        expect(data).toEqual(binaryData);
-    });
-});
-// ============================================
-// zipToContainer
-// ============================================
-describe('zipToContainer', () => {
-    it('loads files from a ZIP', async () => {
-        const zip = new JSZip();
-        zip.file('index.md', '# Hello');
-        zip.file('images/photo.jpg', new Uint8Array([0xff, 0xd8]));
-        const zipBlob = await zip.generateAsync({ type: 'blob' });
-        const container = await zipToContainer(zipBlob);
-        const entries = await container.listFiles();
-        expect(entries.map((e) => e.path).sort()).toEqual(['images/photo.jpg', 'index.md']);
-    });
-    it('preserves text content', async () => {
-        const zip = new JSZip();
-        zip.file('index.md', '# My Document\n\nParagraph.');
-        const zipBlob = await zip.generateAsync({ type: 'blob' });
-        const container = await zipToContainer(zipBlob);
-        expect(await container.readDocument()).toBe('# My Document\n\nParagraph.');
-    });
-    it('preserves binary content', async () => {
-        const original = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8]);
-        const zip = new JSZip();
-        zip.file('data.bin', original);
-        const zipBlob = await zip.generateAsync({ type: 'blob' });
-        const container = await zipToContainer(zipBlob);
-        const data = await container.readFile('data.bin');
-        expect(new Uint8Array(data)).toEqual(original);
-    });
-    it('skips directory entries', async () => {
-        const zip = new JSZip();
-        zip.folder('images');
-        zip.file('images/photo.jpg', new Uint8Array([0xff]));
-        const zipBlob = await zip.generateAsync({ type: 'blob' });
-        const container = await zipToContainer(zipBlob);
-        const entries = await container.listFiles();
-        // Only the file, not the directory
-        expect(entries).toHaveLength(1);
-        expect(entries[0].path).toBe('images/photo.jpg');
-    });
-    it('works with ArrayBuffer input', async () => {
-        const zip = new JSZip();
-        zip.file('readme.md', '# Read me');
-        const ab = await zip.generateAsync({ type: 'arraybuffer' });
-        const container = await zipToContainer(ab);
-        expect(await container.readDocument()).toBe('# Read me');
-    });
-});
-// ============================================
-// Round-trip
-// ============================================
-describe('containerToZip / zipToContainer round-trip', () => {
-    it('round-trips a container with markdown and media', async () => {
-        // Create original container
-        const original = new MemoryContentContainer();
-        const markdown = '# Round Trip Test\n\n![hero](images/hero.jpg)\n\nSome text.';
-        await original.writeDocument(markdown);
-        await original.writeFile('images/hero.jpg', new Uint8Array([0xff, 0xd8, 0xff, 0xe0]), 'image/jpeg');
-        await original.writeFile('audio/narration.mp3', new Uint8Array([0x49, 0x44, 0x33]), 'audio/mpeg');
-        await original.writeFile('timing.json', new TextEncoder().encode('{"segments":[]}'));
-        // Serialize to ZIP
-        const zipBlob = await containerToZip(original);
-        // Deserialize back
-        const restored = await zipToContainer(zipBlob);
-        // Verify document
-        expect(await restored.readDocument()).toBe(markdown);
-        expect(await restored.getDocumentPath()).toBe('index.md');
-        // Verify all files present
-        const entries = (await restored.listFiles()).map((e) => e.path).sort();
-        expect(entries).toEqual(['audio/narration.mp3', 'images/hero.jpg', 'index.md', 'timing.json']);
-        // Verify binary content
-        const heroData = new Uint8Array((await restored.readFile('images/hero.jpg')));
-        expect(heroData).toEqual(new Uint8Array([0xff, 0xd8, 0xff, 0xe0]));
-        const audioData = new Uint8Array((await restored.readFile('audio/narration.mp3')));
-        expect(audioData).toEqual(new Uint8Array([0x49, 0x44, 0x33]));
-        // Verify JSON sidecar
-        const timingData = new TextDecoder().decode((await restored.readFile('timing.json')));
-        expect(timingData).toBe('{"segments":[]}');
-    });
-});
-//# sourceMappingURL=container.test.js.map

package/dist/__tests__/container.test.js.map

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

package/dist/__tests__/docxExport.test.d.ts

@@ -1,8 +0,0 @@
-/**
- * Tests for DOCX export: markdownDocToDocx, docToDocx.
- *
- * Exports a MarkdownDocument to .docx, then unzips and inspects
- * the OOXML structure to verify correctness.
- */
-export {};
-//# sourceMappingURL=docxExport.test.d.ts.map

package/dist/__tests__/docxExport.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"docxExport.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/docxExport.test.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}