@mdzip/editor 1.4.0 → 1.4.5

package/dist/mermaid.js

@@ -74,10 +74,68 @@ async function withBodyCleanup(doc, run) {
 export function mdzipMermaidExtension(options = {}) {
     const load = options.loadMermaid ?? loadDefaultMermaid;
     let counter = 0;
+    // Split so a chunk with no mermaid blocks returns synchronously instead of
+    // through a Promise. Every markdown render extension's transformHtml runs
+    // for every chunk regardless of content — declaring this whole thing async
+    // (as an earlier version did) meant calling it always returned a Promise,
+    // even on this trivial no-op path, forcing the *entire* chunk-render
+    // pipeline (marked's `chainRenderStage`) onto a microtask chain for every
+    // chunk in every document once mermaid is registered, mermaid or not. That
+    // extra always-async hop was implicated in a real, visible per-keystroke
+    // flash in mdzip-studio: it delayed a reconciled chunk's replacement DOM
+    // landing just long enough, on top of everything else already sharing the
+    // event loop, to widen the window where the old chunk's DOM was already
+    // torn down but the new one hadn't landed yet.
+    async function renderMermaidBlocks(template, blocks, context) {
+        const doc = requireDocument();
+        const mermaid = await load();
+        if (context.signal.aborted) {
+            return template.innerHTML;
+        }
+        mermaid.initialize({
+            startOnLoad: false,
+            securityLevel: 'strict',
+            // Render labels as SVG <text> rather than HTML inside <foreignObject>.
+            // The bundled sanitizer keeps the SVG but strips foreignObject HTML, so
+            // html labels would otherwise vanish — this keeps the emitted SVG
+            // self-consistent with the policy without re-allowing HTML in labels.
+            htmlLabels: false,
+            flowchart: { htmlLabels: false },
+            theme: resolveTheme(options.theme ?? 'auto', context.colorScheme),
+            // Stops mermaid from injecting its own error diagram into the DOM on
+            // failure; this extension renders its own error block instead.
+            suppressErrorRendering: true
+        });
+        for (const code of blocks) {
+            const pre = code.parentElement;
+            if (!pre) {
+                continue;
+            }
+            const source = code.textContent ?? '';
+            const container = doc.createElement('div');
+            try {
+                const { svg } = await withBodyCleanup(doc, () => mermaid.render(`mdzip-mermaid-${(counter += 1)}`, source));
+                container.className = 'mdzip-mermaid';
+                container.innerHTML = sanitizeMdzipHtml(svg, [MERMAID_SANITIZE]);
+            }
+            catch (error) {
+                container.className = 'mdzip-mermaid-error';
+                container.textContent = mermaidErrorMessage(error);
+            }
+            pre.replaceWith(container);
+            if (context.signal.aborted) {
+                return template.innerHTML;
+            }
+        }
+        return template.innerHTML;
+    }
     return {
         name: 'mermaid',
         sanitize: MERMAID_SANITIZE,
-        async transformHtml(html, context) {
+        shouldIsolateChunk(token) {
+            return token.type === 'code' && token.lang?.trim().toLowerCase() === 'mermaid';
+        },
+        transformHtml(html, context) {
             const doc = requireDocument();
             const template = doc.createElement('template');
             template.innerHTML = html;
@@ -85,46 +143,7 @@ export function mdzipMermaidExtension(options = {}) {
             if (blocks.length === 0) {
                 return html;
             }
-            const mermaid = await load();
-            if (context.signal.aborted) {
-                return html;
-            }
-            mermaid.initialize({
-                startOnLoad: false,
-                securityLevel: 'strict',
-                // Render labels as SVG <text> rather than HTML inside <foreignObject>.
-                // The bundled sanitizer keeps the SVG but strips foreignObject HTML, so
-                // html labels would otherwise vanish — this keeps the emitted SVG
-                // self-consistent with the policy without re-allowing HTML in labels.
-                htmlLabels: false,
-                flowchart: { htmlLabels: false },
-                theme: resolveTheme(options.theme ?? 'auto', context.colorScheme),
-                // Stops mermaid from injecting its own error diagram into the DOM on
-                // failure; this extension renders its own error block instead.
-                suppressErrorRendering: true
-            });
-            for (const code of blocks) {
-                const pre = code.parentElement;
-                if (!pre) {
-                    continue;
-                }
-                const source = code.textContent ?? '';
-                const container = doc.createElement('div');
-                try {
-                    const { svg } = await withBodyCleanup(doc, () => mermaid.render(`mdzip-mermaid-${(counter += 1)}`, source));
-                    container.className = 'mdzip-mermaid';
-                    container.innerHTML = sanitizeMdzipHtml(svg, [MERMAID_SANITIZE]);
-                }
-                catch (error) {
-                    container.className = 'mdzip-mermaid-error';
-                    container.textContent = mermaidErrorMessage(error);
-                }
-                pre.replaceWith(container);
-                if (context.signal.aborted) {
-                    return html;
-                }
-            }
-            return template.innerHTML;
+            return renderMermaidBlocks(template, blocks, context);
         }
     };
 }

package/dist/mermaid.js.map

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

package/dist/metadata.d.ts

@@ -2,7 +2,7 @@
 export declare function firstMarkdownHeading(markdown: string): string | undefined;
 /** Derive the file base name, without extension, from a path string. */
 export declare function fileBaseNameFromPath(path: string): string;
-/** Resolve a stable title fallback from markdown heading or filename. */
+/** Resolve a stable title fallback from front matter `title:`, markdown heading, or filename. */
 export declare function suggestedTitleFromMarkdown(markdown: string, fileBaseName: string): string;
 /** Resolve display title from manifest title with filename fallback. */
 export declare function displayTitleFromManifest(manifestTitle: string | undefined, fileBaseName: string): string;

package/dist/metadata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,yEAAyE;AACzE,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR"}
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAEA,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAGzE;AAYD,wEAAwE;AACxE,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAIzD;AAED,iGAAiG;AACjG,wBAAgB,0BAA0B,CAAC,QAAQ,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAEzF;AAED,wEAAwE;AACxE,wBAAgB,wBAAwB,CACtC,aAAa,EAAE,MAAM,GAAG,SAAS,EACjC,YAAY,EAAE,MAAM,GACnB,MAAM,CAGR"}

package/dist/metadata.js

@@ -1,17 +1,27 @@
+import { parseFrontMatter } from './front-matter.js';
 /** Extract the first ATX heading, for example `# Title`, from markdown text. */
 export function firstMarkdownHeading(markdown) {
     const match = markdown.match(/^\s{0,3}#{1,6}\s+(.+?)\s*#*\s*$/m);
     return match?.[1]?.trim();
 }
+/** Extract a non-empty string `title:` from a leading front matter block, if any. */
+function frontMatterTitle(markdown) {
+    const title = parseFrontMatter(markdown)?.data.title;
+    if (typeof title !== 'string') {
+        return undefined;
+    }
+    const trimmed = title.trim();
+    return trimmed || undefined;
+}
 /** Derive the file base name, without extension, from a path string. */
 export function fileBaseNameFromPath(path) {
     const slashIndex = path.lastIndexOf('/');
     const fileName = slashIndex >= 0 ? path.slice(slashIndex + 1) : path;
     return fileName.replace(/\.[^.]+$/, '') || 'document';
 }
-/** Resolve a stable title fallback from markdown heading or filename. */
+/** Resolve a stable title fallback from front matter `title:`, markdown heading, or filename. */
 export function suggestedTitleFromMarkdown(markdown, fileBaseName) {
-    return firstMarkdownHeading(markdown) || fileBaseName;
+    return frontMatterTitle(markdown) || firstMarkdownHeading(markdown) || fileBaseName;
 }
 /** Resolve display title from manifest title with filename fallback. */
 export function displayTitleFromManifest(manifestTitle, fileBaseName) {

package/dist/metadata.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC;AACxD,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,0BAA0B,CAAC,QAAgB,EAAE,YAAoB;IAC/E,OAAO,oBAAoB,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC;AACxD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,wBAAwB,CACtC,aAAiC,EACjC,YAAoB;IAEpB,MAAM,OAAO,GAAG,aAAa,EAAE,IAAI,EAAE,CAAC;IACtC,OAAO,OAAO,IAAI,YAAY,CAAC;AACjC,CAAC"}
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../src/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAErD,gFAAgF;AAChF,MAAM,UAAU,oBAAoB,CAAC,QAAgB;IACnD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACjE,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,qFAAqF;AACrF,SAAS,gBAAgB,CAAC,QAAgB;IACxC,MAAM,KAAK,GAAG,gBAAgB,CAAC,QAAQ,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;IACrD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,SAAS,CAAC;IACnB,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,IAAI,SAAS,CAAC;AAC9B,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IACzC,MAAM,QAAQ,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACrE,OAAO,QAAQ,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,IAAI,UAAU,CAAC;AACxD,CAAC;AAED,iGAAiG;AACjG,MAAM,UAAU,0BAA0B,CAAC,QAAgB,EAAE,YAAoB;IAC/E,OAAO,gBAAgB,CAAC,QAAQ,CAAC,IAAI,oBAAoB,CAAC,QAAQ,CAAC,IAAI,YAAY,CAAC;AACtF,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,wBAAwB,CACtC,aAAiC,EACjC,YAAoB;IAEpB,MAAM,OAAO,GAAG,aAAa,EAAE,IAAI,EAAE,CAAC;IACtC,OAAO,OAAO,IAAI,YAAY,CAAC;AACjC,CAAC"}

package/dist/preview.d.ts

@@ -2,6 +2,7 @@ export type { MdzWorkspace, MdzWorkspaceAsset } from '@mdzip/core-js';
 export * from './archive-utils.js';
 export * from './browser.js';
 export * from './diff.js';
+export * from './front-matter.js';
 export * from './metadata.js';
 export * from './rendering.js';
 export * from './theme.js';

package/dist/preview.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"preview.d.ts","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACtE,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}

package/dist/preview.js

@@ -1,6 +1,7 @@
 export * from './archive-utils.js';
 export * from './browser.js';
 export * from './diff.js';
+export * from './front-matter.js';
 export * from './metadata.js';
 export * from './rendering.js';
 export * from './theme.js';

package/dist/preview.js.map

@@ -1 +1 @@
-{"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"preview.js","sourceRoot":"","sources":["../src/preview.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC;AAC7B,cAAc,WAAW,CAAC;AAC1B,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC"}

package/dist/rendering.d.ts

@@ -110,6 +110,19 @@ export interface MdzipMarkdownRenderExtension {
     transformMarkdown?(markdown: string, context: MdzipMarkdownRenderContext): string | Promise<string>;
     transformHtml?(html: string, context: MdzipMarkdownRenderContext): string | Promise<string>;
     mount?(container: HTMLElement, context: MdzipMarkdownRenderContext): void | MdzipRenderHandle | Promise<void | MdzipRenderHandle>;
+    /**
+     * Marks a top-level block token as expensive enough to isolate into its own
+     * chunk for {@link groupTokensIntoChunks}, regardless of the char/token
+     * budget — e.g. a mermaid extension claiming its own ` ```mermaid ` fence.
+     * Without this, a token this extension will re-render on every mount
+     * (diagram layout, not just syntax highlighting) shares a chunk with
+     * whatever nearby text the budget happened to group it with; editing any
+     * of that unrelated text still invalidates the whole chunk's source key,
+     * forcing an expensive re-render the edit had nothing to do with — most
+     * visible on a short document that fits within one or two chunks anyway,
+     * where *every* edit ends up re-rendering the diagram.
+     */
+    shouldIsolateChunk?(token: Token): boolean;
 }
 /**
  * Context handed to entry renderers for the currently selected archive entry.
@@ -167,6 +180,29 @@ export interface MdzipRenderRequest {
 export interface MdzipRenderResult {
     html: string;
 }
+/**
+ * Rendered heading ids carry this prefix (GitHub does the same) so a heading
+ * like "## Images" or "## Title" can never collide with a document/form
+ * property, which DOMPurify would otherwise strip the id for. Links written
+ * against the bare slug (`#images`) still resolve — see the preview click handler.
+ */
+export declare const MDZIP_HEADING_ID_PREFIX = "user-content-";
+/**
+ * GitHub-style heading slug: lowercased, everything but letters, marks,
+ * numbers, `_`, `-` and spaces removed, spaces turned into hyphens.
+ */
+export declare function slugifyMdzipHeading(text: string): string;
+/**
+ * Gives every heading token (including ones nested in blockquotes and lists)
+ * the id its rendered `<hN>` will carry, in document order, disambiguating
+ * repeats GitHub-style (`intro`, `intro-1`, `intro-2`). Has to run over the
+ * whole document's tokens before they are split into chunks — a chunk rendered
+ * on its own can't know how many earlier chunks already used a slug. A heading
+ * whose text slugifies to nothing (e.g. only punctuation) gets no id.
+ */
+export declare function assignMdzipHeadingIds(tokens: readonly Token[]): void;
+/** The ids {@link assignMdzipHeadingIds} gave the headings in `tokens`, in order. */
+export declare function collectMdzipHeadingIds(tokens: readonly Token[]): string[];
 export declare const defaultSafeMarkdownRenderer: MdzipMarkdownRenderer;
 export declare class MdzipRenderingService {
     private readonly renderer;
@@ -223,7 +259,45 @@ export interface MdzipChunkOptions {
     tokenCap?: number;
     /** Approximate max raw markdown chars per chunk (via each token's `.raw.length`). Default 2000. */
     charBudget?: number;
+    /**
+     * When a token matches, it's isolated into its own chunk regardless of the
+     * budget: any chunk-in-progress is closed first, the matching token forms
+     * a chunk by itself, and accumulation resumes fresh after it. Callers
+     * combine every registered extension's {@link MdzipMarkdownRenderExtension.shouldIsolateChunk}
+     * into one predicate — see that doc comment for why this matters.
+     */
+    shouldIsolate?: (token: Token) => boolean;
+    /**
+     * When a token matches, any chunk-in-progress is closed first and the
+     * matching token starts a fresh one (unlike `shouldIsolate`, later tokens
+     * keep accumulating into that new chunk under the normal budget — the
+     * matching token doesn't get a chunk to itself). Used to keep unrelated
+     * sections from sharing a chunk: without this, a document short enough to
+     * fit several headings' worth of content under the budget lets an edit in
+     * one section's prose invalidate a sibling section's untouched heading and
+     * content too, tearing them out of the DOM and back in — a real, visible
+     * flash for content that never changed.
+     */
+    shouldStartChunk?: (token: Token) => boolean;
 }
+/**
+ * True when a token's raw source embeds an image (Markdown `![]()` syntax or
+ * a raw `<img>` tag). Used to isolate the token into its own chunk: without
+ * this, a short document can put an image in the same budget-sized chunk as
+ * unrelated surrounding prose, so an edit anywhere in that prose tears the
+ * image out of the DOM and reinserts it — a real, visible flash, since the
+ * browser has to redo layout for a freshly-inserted `<img>` even when its
+ * source is a cache hit.
+ */
+export declare function tokenEmbedsImage(token: Token): boolean;
+/**
+ * True for a heading token — used as {@link MdzipChunkOptions.shouldStartChunk}
+ * so a heading always begins a fresh chunk instead of merging with whatever
+ * content (and sibling headings) happened to precede it under the size
+ * budget. See that option's doc comment for why: it keeps an edit in one
+ * section from also tearing down an untouched sibling section.
+ */
+export declare function tokenIsHeading(token: Token): boolean;
 /**
  * Groups top-level block tokens from {@link MdzipRenderingService.tokenizeMarkdown}
  * into chunks suitable for incremental rendering — a token-count cap and a
@@ -231,7 +305,26 @@ export interface MdzipChunkOptions {
  * tiny tokens (e.g. a chat export's one-line-paragraph-per-message shape)
  * doesn't end up with one chunk per token. A single token larger than the
  * budget still gets its own chunk on its own (a chunk boundary can never
- * split a token).
+ * split a token). `shouldIsolate` overrides the budget in one direction —
+ * forcing a matching token into its own chunk even when the budget would
+ * have happily grouped it with neighbors; `shouldStartChunk` overrides it in
+ * the other — forcing a boundary before a matching token even when the
+ * budget would have merged it with what came before.
  */
 export declare function groupTokensIntoChunks(tokens: readonly Token[], options?: MdzipChunkOptions): Token[][];
+/**
+ * Stable identity key for a chunk: the exact source text `marked` consumed
+ * for it (concatenation of each token's `.raw`). Two chunks with the same key
+ * are guaranteed to have identical source text, since `.raw` slices tile the
+ * whole input contiguously — safe to use as a plain string equality key (no
+ * hashing needed; chunks are budget-capped ~2000 chars, and a render involves
+ * at most a few dozen of them).
+ *
+ * Deliberately keys on SOURCE text only, never on rendered output: an
+ * extension's `transformHtml` can be side-effecting per call (e.g. the
+ * mermaid extension's per-call SVG id counter), so identical keys must never
+ * be treated as license to re-run rendering — only as license to skip it and
+ * reuse whatever is already mounted for that chunk.
+ */
+export declare function chunkSourceKey(chunk: readonly Token[]): string;
 //# sourceMappingURL=rendering.d.ts.map

package/dist/rendering.d.ts.map

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

package/dist/rendering.js

@@ -1,5 +1,5 @@
 import DOMPurify from 'dompurify';
-import hljs from 'highlight.js';
+import hljs from './highlight-core.js';
 import { Marked } from 'marked';
 // In browsers the dompurify default export is already bound to the global
 // window. In Node it is an unbound factory, so bind it to a host-provided DOM
@@ -67,8 +67,105 @@ export function mdzipExtensionMatcher(...extensions) {
         return wanted.some((ext) => lower.endsWith(ext));
     };
 }
+/**
+ * Rendered heading ids carry this prefix (GitHub does the same) so a heading
+ * like "## Images" or "## Title" can never collide with a document/form
+ * property, which DOMPurify would otherwise strip the id for. Links written
+ * against the bare slug (`#images`) still resolve — see the preview click handler.
+ */
+export const MDZIP_HEADING_ID_PREFIX = 'user-content-';
+function decodeBasicEntities(text) {
+    return text
+        .replace(/&#x([0-9a-f]+);/gi, (_, hex) => String.fromCodePoint(parseInt(hex, 16)))
+        .replace(/&#(\d+);/g, (_, dec) => String.fromCodePoint(parseInt(dec, 10)))
+        .replace(/"/g, '"')
+        .replace(/'|'/g, "'")
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&amp;/g, '&')
+        // Any other named entity (&copy; etc.) decodes to a symbol the slug
+        // pass would strip anyway.
+        .replace(/&[a-z][a-z0-9]*;/gi, '');
+}
+function inlineTokensPlainText(tokens) {
+    let text = '';
+    for (const token of tokens ?? []) {
+        const inline = token;
+        if (inline.type === 'br') {
+            text += ' ';
+        }
+        else if (inline.type === 'html') {
+            // Tag markers only — their inner text arrives as sibling text tokens.
+        }
+        else if (inline.tokens) {
+            text += inlineTokensPlainText(inline.tokens);
+        }
+        else if (typeof inline.text === 'string') {
+            text += inline.text;
+        }
+    }
+    return decodeBasicEntities(text);
+}
+/**
+ * GitHub-style heading slug: lowercased, everything but letters, marks,
+ * numbers, `_`, `-` and spaces removed, spaces turned into hyphens.
+ */
+export function slugifyMdzipHeading(text) {
+    return text.toLowerCase().replace(/[^\p{L}\p{M}\p{N}\p{Pc}\- ]/gu, '').replace(/ /g, '-');
+}
+function forEachHeadingToken(tokens, visit) {
+    for (const token of tokens) {
+        if (token.type === 'heading') {
+            visit(token);
+        }
+        else if (token.type === 'blockquote' || token.type === 'list' || token.type === 'list_item') {
+            const container = token;
+            forEachHeadingToken(container.tokens ?? container.items ?? [], visit);
+        }
+    }
+}
+/**
+ * Gives every heading token (including ones nested in blockquotes and lists)
+ * the id its rendered `<hN>` will carry, in document order, disambiguating
+ * repeats GitHub-style (`intro`, `intro-1`, `intro-2`). Has to run over the
+ * whole document's tokens before they are split into chunks — a chunk rendered
+ * on its own can't know how many earlier chunks already used a slug. A heading
+ * whose text slugifies to nothing (e.g. only punctuation) gets no id.
+ */
+export function assignMdzipHeadingIds(tokens) {
+    const used = new Map();
+    forEachHeadingToken(tokens, (token) => {
+        const base = slugifyMdzipHeading(inlineTokensPlainText(token.tokens));
+        if (!base) {
+            delete token.mdzipAnchorId;
+            return;
+        }
+        let candidate = base;
+        while (used.has(candidate)) {
+            const next = (used.get(base) ?? 0) + 1;
+            used.set(base, next);
+            candidate = `${base}-${next}`;
+        }
+        used.set(candidate, 0);
+        token.mdzipAnchorId = candidate;
+    });
+}
+/** The ids {@link assignMdzipHeadingIds} gave the headings in `tokens`, in order. */
+export function collectMdzipHeadingIds(tokens) {
+    const ids = [];
+    forEachHeadingToken(tokens, (token) => {
+        if (token.mdzipAnchorId) {
+            ids.push(token.mdzipAnchorId);
+        }
+    });
+    return ids;
+}
 const marked = new Marked({
     renderer: {
+        heading(token) {
+            const id = token.mdzipAnchorId ? ` id="${MDZIP_HEADING_ID_PREFIX}${escapeHtml(token.mdzipAnchorId)}"` : '';
+            return `<h${token.depth}${id}>${this.parser.parseInline(token.tokens)}</h${token.depth}>\n`;
+        },
         code(token) {
             const requestedLanguage = token.lang || '';
             const language = requestedLanguage === 'vue' ? 'html' : requestedLanguage;
@@ -106,7 +203,9 @@ const marked = new Marked({
     }
 });
 function renderDefaultMarkdownUnsanitized(markdown) {
-    const rendered = marked.parse(markdown, { async: false });
+    const tokens = marked.lexer(markdown);
+    assignMdzipHeadingIds(tokens);
+    const rendered = marked.parser(tokens);
     return typeof rendered === 'string' ? rendered : escapeHtml(markdown);
 }
 export const defaultSafeMarkdownRenderer = {
@@ -228,10 +327,14 @@ export class MdzipRenderingService {
                 if (context.signal.aborted) {
                     throw createAbortError();
                 }
-                return marked.lexer(resolved);
+                const tokens = marked.lexer(resolved);
+                assignMdzipHeadingIds(tokens);
+                return tokens;
             });
         }
-        return marked.lexer(value);
+        const tokens = marked.lexer(value);
+        assignMdzipHeadingIds(tokens);
+        return tokens;
     }
     /**
      * Renders a subset of tokens from {@link tokenizeMarkdown} through
@@ -261,6 +364,31 @@ export class MdzipRenderingService {
 }
 const DEFAULT_CHUNK_TOKEN_CAP = 40;
 const DEFAULT_CHUNK_CHAR_BUDGET = 2000;
+const IMAGE_MARKDOWN_PATTERN = /!\[[^\]]*\]\([^)]*\)/;
+const IMAGE_HTML_PATTERN = /<img\b/i;
+/**
+ * True when a token's raw source embeds an image (Markdown `![]()` syntax or
+ * a raw `<img>` tag). Used to isolate the token into its own chunk: without
+ * this, a short document can put an image in the same budget-sized chunk as
+ * unrelated surrounding prose, so an edit anywhere in that prose tears the
+ * image out of the DOM and reinserts it — a real, visible flash, since the
+ * browser has to redo layout for a freshly-inserted `<img>` even when its
+ * source is a cache hit.
+ */
+export function tokenEmbedsImage(token) {
+    const raw = token.raw ?? '';
+    return IMAGE_MARKDOWN_PATTERN.test(raw) || IMAGE_HTML_PATTERN.test(raw);
+}
+/**
+ * True for a heading token — used as {@link MdzipChunkOptions.shouldStartChunk}
+ * so a heading always begins a fresh chunk instead of merging with whatever
+ * content (and sibling headings) happened to precede it under the size
+ * budget. See that option's doc comment for why: it keeps an edit in one
+ * section from also tearing down an untouched sibling section.
+ */
+export function tokenIsHeading(token) {
+    return token.type === 'heading';
+}
 /**
  * Groups top-level block tokens from {@link MdzipRenderingService.tokenizeMarkdown}
  * into chunks suitable for incremental rendering — a token-count cap and a
@@ -268,7 +396,11 @@ const DEFAULT_CHUNK_CHAR_BUDGET = 2000;
  * tiny tokens (e.g. a chat export's one-line-paragraph-per-message shape)
  * doesn't end up with one chunk per token. A single token larger than the
  * budget still gets its own chunk on its own (a chunk boundary can never
- * split a token).
+ * split a token). `shouldIsolate` overrides the budget in one direction —
+ * forcing a matching token into its own chunk even when the budget would
+ * have happily grouped it with neighbors; `shouldStartChunk` overrides it in
+ * the other — forcing a boundary before a matching token even when the
+ * budget would have merged it with what came before.
  */
 export function groupTokensIntoChunks(tokens, options = {}) {
     const tokenCap = options.tokenCap ?? DEFAULT_CHUNK_TOKEN_CAP;
@@ -277,6 +409,20 @@ export function groupTokensIntoChunks(tokens, options = {}) {
     let current = [];
     let currentChars = 0;
     for (const token of tokens) {
+        if (options.shouldIsolate?.(token)) {
+            if (current.length > 0) {
+                chunks.push(current);
+                current = [];
+                currentChars = 0;
+            }
+            chunks.push([token]);
+            continue;
+        }
+        if (options.shouldStartChunk?.(token) && current.length > 0) {
+            chunks.push(current);
+            current = [];
+            currentChars = 0;
+        }
         current.push(token);
         currentChars += token.raw?.length ?? 0;
         if (current.length >= tokenCap || currentChars >= charBudget) {
@@ -290,6 +436,28 @@ export function groupTokensIntoChunks(tokens, options = {}) {
     }
     return chunks;
 }
+/**
+ * Stable identity key for a chunk: the exact source text `marked` consumed
+ * for it (concatenation of each token's `.raw`). Two chunks with the same key
+ * are guaranteed to have identical source text, since `.raw` slices tile the
+ * whole input contiguously — safe to use as a plain string equality key (no
+ * hashing needed; chunks are budget-capped ~2000 chars, and a render involves
+ * at most a few dozen of them).
+ *
+ * Deliberately keys on SOURCE text only, never on rendered output: an
+ * extension's `transformHtml` can be side-effecting per call (e.g. the
+ * mermaid extension's per-call SVG id counter), so identical keys must never
+ * be treated as license to re-run rendering — only as license to skip it and
+ * reuse whatever is already mounted for that chunk.
+ */
+export function chunkSourceKey(chunk) {
+    const raw = chunk.map((token) => token.raw ?? '').join('');
+    // A heading's id depends on the whole document (an earlier duplicate
+    // shifts `intro` to `intro-1`), not just this chunk's own text — so a chunk
+    // whose source is unchanged but whose ids moved must not be reused as-is.
+    const ids = collectMdzipHeadingIds(chunk);
+    return ids.length > 0 ? `${raw}\u0000${ids.join('\u0001')}` : raw;
+}
 function rewriteAssetSources(markdown, resolver) {
     return markdown.replace(/!\[([^\]]*)\]\(([^)\s]+)(?:\s+"([^"]*)")?\)/g, (match, alt, rawPath, title) => {
         const path = rawPath.replace(/^<|>$/g, '');