npm - @bendyline/squisq-formats - Versions diffs - 1.2.3 → 1.3.1 - Mend

@bendyline/squisq-formats 1.2.3 → 1.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (166) hide show

package/dist/chunk-33YRFXZZ.js +1187 -0
package/dist/chunk-33YRFXZZ.js.map +1 -0
package/dist/{chunk-EUQQYBZZ.js → chunk-ERZ627GR.js} +4 -4
package/dist/chunk-ERZ627GR.js.map +1 -0
package/dist/{chunk-MEZF76JA.js → chunk-UDS45KUJ.js} +68 -25
package/dist/chunk-UDS45KUJ.js.map +1 -0
package/dist/{chunk-NGWHV77G.js → chunk-VN2KEOYB.js} +7 -6
package/dist/chunk-VN2KEOYB.js.map +1 -0
package/dist/container/index.d.ts +7 -5
package/dist/container/index.js +39 -70
package/dist/container/index.js.map +1 -1
package/dist/docx/index.d.ts +128 -15
package/dist/docx/index.js +17 -22
package/dist/docx/index.js.map +1 -1
package/dist/epub/index.d.ts +66 -11
package/dist/epub/index.js +10 -18
package/dist/epub/index.js.map +1 -1
package/dist/html/index.d.ts +278 -9
package/dist/html/index.js +26 -137
package/dist/html/index.js.map +1 -1
package/dist/index.d.ts +9 -38
package/dist/index.js +62 -37
package/dist/index.js.map +1 -1
package/dist/ooxml/index.d.ts +353 -14
package/dist/ooxml/index.js +116 -22
package/dist/ooxml/index.js.map +1 -1
package/dist/pdf/index.d.ts +143 -17
package/dist/pdf/index.js +16 -25
package/dist/pdf/index.js.map +1 -1
package/dist/pptx/index.d.ts +83 -8
package/dist/pptx/index.js +14 -34
package/dist/pptx/index.js.map +1 -1
package/dist/xlsx/index.d.ts +12 -9
package/dist/xlsx/index.js +12 -44
package/dist/xlsx/index.js.map +1 -1
package/package.json +3 -2
package/src/__tests__/html.test.ts +82 -4
package/src/__tests__/pdfExport.test.ts +1 -1
package/src/__tests__/plainHtml.test.ts +372 -0
package/src/__tests__/plainHtmlBundle.test.ts +235 -0
package/src/docx/export.ts +163 -22
package/src/epub/export.ts +3 -3
package/src/html/docsHtmlBundle.ts +369 -0
package/src/html/htmlTemplate.ts +40 -0
package/src/html/index.ts +32 -3
package/src/html/plainHtml.ts +736 -0
package/src/html/plainHtmlBundle.ts +419 -0
package/src/pptx/export.ts +10 -9
package/dist/__tests__/container.test.d.ts +0 -8
package/dist/__tests__/container.test.d.ts.map +0 -1
package/dist/__tests__/container.test.js +0 -147
package/dist/__tests__/container.test.js.map +0 -1
package/dist/__tests__/docxExport.test.d.ts +0 -8
package/dist/__tests__/docxExport.test.d.ts.map +0 -1
package/dist/__tests__/docxExport.test.js +0 -383
package/dist/__tests__/docxExport.test.js.map +0 -1
package/dist/__tests__/docxImport.test.d.ts +0 -8
package/dist/__tests__/docxImport.test.d.ts.map +0 -1
package/dist/__tests__/docxImport.test.js +0 -309
package/dist/__tests__/docxImport.test.js.map +0 -1
package/dist/__tests__/epub.test.d.ts +0 -8
package/dist/__tests__/epub.test.d.ts.map +0 -1
package/dist/__tests__/epub.test.js +0 -472
package/dist/__tests__/epub.test.js.map +0 -1
package/dist/__tests__/html.test.d.ts +0 -8
package/dist/__tests__/html.test.d.ts.map +0 -1
package/dist/__tests__/html.test.js +0 -243
package/dist/__tests__/html.test.js.map +0 -1
package/dist/__tests__/ooxml.test.d.ts +0 -5
package/dist/__tests__/ooxml.test.d.ts.map +0 -1
package/dist/__tests__/ooxml.test.js +0 -152
package/dist/__tests__/ooxml.test.js.map +0 -1
package/dist/__tests__/pdfExport.test.d.ts +0 -8
package/dist/__tests__/pdfExport.test.d.ts.map +0 -1
package/dist/__tests__/pdfExport.test.js +0 -275
package/dist/__tests__/pdfExport.test.js.map +0 -1
package/dist/__tests__/pdfImport.test.d.ts +0 -11
package/dist/__tests__/pdfImport.test.d.ts.map +0 -1
package/dist/__tests__/pdfImport.test.js +0 -254
package/dist/__tests__/pdfImport.test.js.map +0 -1
package/dist/__tests__/roundTrip.test.d.ts +0 -7
package/dist/__tests__/roundTrip.test.d.ts.map +0 -1
package/dist/__tests__/roundTrip.test.js +0 -173
package/dist/__tests__/roundTrip.test.js.map +0 -1
package/dist/chunk-EUQQYBZZ.js.map +0 -1
package/dist/chunk-MEZF76JA.js.map +0 -1
package/dist/chunk-NGWHV77G.js.map +0 -1
package/dist/chunk-UM5V2XZG.js +0 -242
package/dist/chunk-UM5V2XZG.js.map +0 -1
package/dist/container/index.d.ts.map +0 -1
package/dist/docx/export.d.ts +0 -69
package/dist/docx/export.d.ts.map +0 -1
package/dist/docx/export.js +0 -854
package/dist/docx/export.js.map +0 -1
package/dist/docx/import.d.ts +0 -65
package/dist/docx/import.d.ts.map +0 -1
package/dist/docx/import.js +0 -779
package/dist/docx/import.js.map +0 -1
package/dist/docx/index.d.ts.map +0 -1
package/dist/docx/styles.d.ts +0 -68
package/dist/docx/styles.d.ts.map +0 -1
package/dist/docx/styles.js +0 -125
package/dist/docx/styles.js.map +0 -1
package/dist/epub/export.d.ts +0 -72
package/dist/epub/export.d.ts.map +0 -1
package/dist/epub/export.js +0 -698
package/dist/epub/export.js.map +0 -1
package/dist/epub/index.d.ts.map +0 -1
package/dist/html/htmlTemplate.d.ts +0 -70
package/dist/html/htmlTemplate.d.ts.map +0 -1
package/dist/html/htmlTemplate.js +0 -239
package/dist/html/htmlTemplate.js.map +0 -1
package/dist/html/imageUtils.d.ts +0 -29
package/dist/html/imageUtils.d.ts.map +0 -1
package/dist/html/imageUtils.js +0 -63
package/dist/html/imageUtils.js.map +0 -1
package/dist/html/index.d.ts.map +0 -1
package/dist/index.d.ts.map +0 -1
package/dist/ooxml/index.d.ts.map +0 -1
package/dist/ooxml/namespaces.d.ts +0 -77
package/dist/ooxml/namespaces.d.ts.map +0 -1
package/dist/ooxml/namespaces.js +0 -104
package/dist/ooxml/namespaces.js.map +0 -1
package/dist/ooxml/reader.d.ts +0 -52
package/dist/ooxml/reader.d.ts.map +0 -1
package/dist/ooxml/reader.js +0 -190
package/dist/ooxml/reader.js.map +0 -1
package/dist/ooxml/types.d.ts +0 -82
package/dist/ooxml/types.d.ts.map +0 -1
package/dist/ooxml/types.js +0 -9
package/dist/ooxml/types.js.map +0 -1
package/dist/ooxml/writer.d.ts +0 -71
package/dist/ooxml/writer.d.ts.map +0 -1
package/dist/ooxml/writer.js +0 -200
package/dist/ooxml/writer.js.map +0 -1
package/dist/ooxml/xmlUtils.d.ts +0 -76
package/dist/ooxml/xmlUtils.d.ts.map +0 -1
package/dist/ooxml/xmlUtils.js +0 -108
package/dist/ooxml/xmlUtils.js.map +0 -1
package/dist/pdf/export.d.ts +0 -56
package/dist/pdf/export.d.ts.map +0 -1
package/dist/pdf/export.js +0 -768
package/dist/pdf/export.js.map +0 -1
package/dist/pdf/import.d.ts +0 -94
package/dist/pdf/import.d.ts.map +0 -1
package/dist/pdf/import.js +0 -796
package/dist/pdf/import.js.map +0 -1
package/dist/pdf/index.d.ts.map +0 -1
package/dist/pdf/styles.d.ts +0 -142
package/dist/pdf/styles.d.ts.map +0 -1
package/dist/pdf/styles.js +0 -145
package/dist/pdf/styles.js.map +0 -1
package/dist/pptx/export.d.ts +0 -75
package/dist/pptx/export.d.ts.map +0 -1
package/dist/pptx/export.js +0 -722
package/dist/pptx/export.js.map +0 -1
package/dist/pptx/index.d.ts.map +0 -1
package/dist/pptx/styles.d.ts +0 -54
package/dist/pptx/styles.d.ts.map +0 -1
package/dist/pptx/styles.js +0 -73
package/dist/pptx/styles.js.map +0 -1
package/dist/pptx/templates.d.ts +0 -24
package/dist/pptx/templates.d.ts.map +0 -1
package/dist/pptx/templates.js +0 -158
package/dist/pptx/templates.js.map +0 -1
package/dist/xlsx/index.d.ts.map +0 -1

package/src/__tests__/plainHtml.test.ts ADDED Viewed

@@ -0,0 +1,372 @@
+/**
+ * Tests for markdownDocToPlainHtml — the player-free, semantic HTML export.
+ */
+import { describe, it, expect } from 'vitest';
+import { parseMarkdown } from '@bendyline/squisq/markdown';
+import { resolveTheme } from '@bendyline/squisq/schemas';
+import { markdownDocToPlainHtml } from '../html/plainHtml';
+function render(md: string, options?: Parameters<typeof markdownDocToPlainHtml>[1]): string {
+  return markdownDocToPlainHtml(parseMarkdown(md), options);
+}
+describe('markdownDocToPlainHtml', () => {
+  it('wraps output in a complete HTML document', () => {
+    const html = render('# Hello\n\nWorld');
+    expect(html.startsWith('<!DOCTYPE html>')).toBe(true);
+    expect(html).toContain('<html lang="en">');
+    expect(html).toContain('<head>');
+    expect(html).toContain('<body>');
+    expect(html.trim().endsWith('</html>')).toBe(true);
+  });
+  it('uses the title option and escapes it', () => {
+    const html = render('# x', { title: 'A <script> & more' });
+    expect(html).toContain('<title>A &lt;script&gt; &amp; more</title>');
+  });
+  it('renders headings at the correct depth', () => {
+    const html = render('# One\n\n## Two\n\n### Three\n\n#### Four\n\n##### Five\n\n###### Six');
+    expect(html).toContain('<h1>One</h1>');
+    expect(html).toContain('<h2>Two</h2>');
+    expect(html).toContain('<h3>Three</h3>');
+    expect(html).toContain('<h4>Four</h4>');
+    expect(html).toContain('<h5>Five</h5>');
+    expect(html).toContain('<h6>Six</h6>');
+  });
+  it('renders paragraphs, emphasis, strong, and links', () => {
+    const html = render('A *b* **c** [link](https://example.com).');
+    expect(html).toContain(
+      '<p>A <em>b</em> <strong>c</strong> <a href="https://example.com">link</a>.</p>',
+    );
+  });
+  it('renders ordered and unordered lists', () => {
+    const html = render('- one\n- two\n\n1. first\n2. second');
+    expect(html).toContain('<ul>');
+    expect(html).toContain('<li>');
+    expect(html).toContain('<ol>');
+  });
+  it('emits start attribute on ordered lists with non-default start', () => {
+    const html = render('3. third\n4. fourth');
+    expect(html).toContain('<ol start="3">');
+  });
+  it('renders fenced code blocks with a language class', () => {
+    const html = render('```ts\nconst x = 1;\n```');
+    expect(html).toContain('<pre><code class="language-ts">const x = 1;</code></pre>');
+  });
+  it('escapes HTML characters inside code blocks', () => {
+    const html = render('```\n<script>alert(1)</script>\n```');
+    expect(html).toContain('&lt;script&gt;alert(1)&lt;/script&gt;');
+  });
+  it('renders blockquotes and thematic breaks', () => {
+    const html = render('> quoted\n\n---\n\nafter');
+    expect(html).toContain('<blockquote>');
+    expect(html).toContain('<hr />');
+  });
+  it('renders GFM tables', () => {
+    const html = render('| H1 | H2 |\n| --- | --- |\n| a | b |\n| c | d |');
+    expect(html).toContain('<table>');
+    expect(html).toContain('<thead>');
+    expect(html).toContain('<th>H1</th>');
+    expect(html).toContain('<tbody>');
+    expect(html).toContain('<td>a</td>');
+  });
+  it('renders markdown images with src and alt', () => {
+    const html = render('![cat](cat.jpg)');
+    expect(html).toContain('<img src="cat.jpg" alt="cat" />');
+  });
+  it('substitutes image URLs through the images map', () => {
+    const html = render('![cat](cat.jpg)', {
+      images: new Map([['cat.jpg', 'blob:http://x/abcd']]),
+    });
+    expect(html).toContain('src="blob:http://x/abcd"');
+    expect(html).not.toContain('src="cat.jpg"');
+  });
+  it('passes URLs not in the images map through unchanged', () => {
+    const html = render('![ext](https://example.com/x.jpg)', {
+      images: new Map([['cat.jpg', 'unused']]),
+    });
+    expect(html).toContain('src="https://example.com/x.jpg"');
+  });
+  it('rewrites raw HTML <img src> through the images map (resize round-trip)', () => {
+    // The WYSIWYG editor serializes resized images as raw HTML because
+    // markdown shorthand has no width syntax. The renderer must walk
+    // the parsed htmlChildren so those images preview correctly.
+    const html = render('<img alt="resized" src="resized.png" width="194">', {
+      images: new Map([['resized.png', 'blob:http://x/resized']]),
+    });
+    expect(html).toContain('src="blob:http://x/resized"');
+    expect(html).toContain('width="194"');
+    expect(html).not.toContain('src="resized.png"');
+  });
+  it('escapes quotes in href and src attributes', () => {
+    const html = render('![a](a"b.jpg)\n\n[c](d"e)');
+    expect(html).toContain('&quot;');
+    expect(html).not.toContain('src="a"b.jpg"');
+  });
+  describe('feature template annotations', () => {
+    it('renders {[leftFeature]} headings as a two-column section with image left', () => {
+      const md = [
+        '# Mike Ammerlaan {[leftFeature]}',
+        '',
+        '![mike](mike.jpg)',
+        '',
+        'Builder of platforms.',
+        '',
+        '## Other section',
+        '',
+        'Unrelated.',
+      ].join('\n');
+      const html = render(md);
+      expect(html).toContain('<section class="squisq-feature squisq-feature--left">');
+      expect(html).toContain('<div class="squisq-feature__media"><img src="mike.jpg"');
+      expect(html).toContain('<h1>Mike Ammerlaan</h1>');
+      expect(html).toContain('<p>Builder of platforms.</p>');
+      // Closing section before the next heading
+      expect(html).toContain('</section>');
+      // Next heading lives OUTSIDE the section
+      const sectionClose = html.indexOf('</section>');
+      const otherHeading = html.indexOf('<h2>Other section');
+      expect(sectionClose).toBeLessThan(otherHeading);
+    });
+    it('renders {[rightFeature]} with image on the right (row-reverse class)', () => {
+      const html = render('## Projects {[rightFeature]}\n\n![p](p.png)\n\nList of stuff.');
+      expect(html).toContain('squisq-feature--right');
+      expect(html).toContain('<img src="p.png"');
+    });
+    it('keeps the image out of the body column to avoid double-rendering', () => {
+      const html = render('# Hello {[leftFeature]}\n\n![h](h.jpg)\n\nText body.');
+      // Exactly one <img>
+      expect(html.match(/<img /g)?.length).toBe(1);
+    });
+    it('still emits feature CSS when no feature blocks are present', () => {
+      // The CSS is part of the doc shell so themes pick up the rules
+      // when authored content adds a feature later; presence is fine.
+      const html = render('# Plain doc');
+      expect(html).toContain('.squisq-feature {');
+    });
+    it('handles raw HTML <img> as the feature image (resized round-trip)', () => {
+      const md = [
+        '# Mike {[rightFeature]}',
+        '',
+        '<img alt="m" src="m.jpg" width="194">',
+        '',
+        'Body.',
+      ].join('\n');
+      const html = render(md);
+      expect(html).toContain('squisq-feature--right');
+      expect(html).toContain('<img src="m.jpg"');
+    });
+    it('forwards explicit width/height on the feature image so CSS can center it', () => {
+      const md =
+        '# Mike {[leftFeature]}\n\n<img alt="m" src="m.jpg" width="194" height="220">\n\nBody.';
+      const html = render(md);
+      // The media wrapper gets a "sized" modifier class that the CSS
+      // uses to switch from stretch-to-fill to center-with-padding.
+      expect(html).toContain('squisq-feature__media--sized');
+      // And the image element carries the original dimensions.
+      expect(html).toContain('width="194"');
+      expect(html).toContain('height="220"');
+    });
+    it('omits the sized modifier on the media div when the image has no explicit dims', () => {
+      // The `--sized` class lives in the embedded stylesheet regardless
+      // (so future feature blocks get styled correctly). What we care
+      // about here is that no `<div class="squisq-feature__media …--sized">`
+      // is emitted for an un-resized image.
+      const html = render('# Mike {[leftFeature]}\n\n![m](m.jpg)\n\nBody.');
+      expect(html).toMatch(/<div class="squisq-feature__media"><img /);
+      expect(html).not.toMatch(/<div class="squisq-feature__media[^"]*--sized/);
+      expect(html).not.toMatch(/<img [^>]*width=/);
+    });
+    it('substitutes feature image src through the images map', () => {
+      const md = '# Mike {[leftFeature]}\n\n![m](mike.jpg)\n\nText.';
+      const html = render(md, { images: new Map([['mike.jpg', 'data:image/png;base64,AAA']]) });
+      expect(html).toContain('src="data:image/png;base64,AAA"');
+      expect(html).not.toContain('src="mike.jpg"');
+    });
+    it('falls back gracefully when a feature heading has no image', () => {
+      const html = render('# Just Words {[leftFeature]}\n\nNo image here.');
+      expect(html).toContain('squisq-feature--left');
+      expect(html).toContain('squisq-feature__media--empty');
+      expect(html).toContain('<p>No image here.</p>');
+    });
+    it('section ends at the next heading of any depth', () => {
+      // A feature is intentionally short — first body chunk only. Any
+      // following heading (even a deeper H3) closes the section so
+      // headings don't end up inside the side-by-side layout where
+      // they'd render awkwardly.
+      const md = [
+        '## Mike {[leftFeature]}',
+        '',
+        '![m](m.jpg)',
+        '',
+        'first paragraph',
+        '',
+        '### Sub',
+        '',
+        'outside section',
+      ].join('\n');
+      const html = render(md);
+      const sectionClose = html.indexOf('</section>');
+      const subHeading = html.indexOf('<h3>Sub');
+      expect(sectionClose).toBeLessThan(subHeading);
+    });
+  });
+  describe('link rewriting via `links` option', () => {
+    it('rewrites <a href> through the supplied map', () => {
+      const html = render('See [my CV](resume.md) for details.', {
+        links: new Map([['resume.md', 'resume.html']]),
+      });
+      expect(html).toContain('href="resume.html"');
+      expect(html).not.toContain('href="resume.md"');
+    });
+    it('leaves URLs not in the map unchanged', () => {
+      const html = render('[external](https://example.com)', {
+        links: new Map([['resume.md', 'resume.html']]),
+      });
+      expect(html).toContain('href="https://example.com"');
+    });
+    it('preserves the original behavior when no map is supplied', () => {
+      const html = render('[my CV](resume.md)');
+      expect(html).toContain('href="resume.md"');
+    });
+  });
+  describe('inline FontAwesome icons', () => {
+    it('renders an inline icon as <i class="fa-brands fa-github">', () => {
+      const html = render('Built with {[github]}');
+      expect(html).toContain('<i class="fa-brands fa-github"');
+      expect(html).toContain('data-icon="github"');
+    });
+    it('emits the FontAwesome CDN <link> when any icon is present', () => {
+      const html = render('Hello {[github]} world');
+      expect(html).toContain('href="https://cdnjs.cloudflare.com/ajax/libs/font-awesome/');
+      expect(html).toContain('integrity="sha512-');
+    });
+    it('omits the FontAwesome <link> when no icons appear', () => {
+      const html = render('# Just text\n\nNo icons here.');
+      expect(html).not.toContain('font-awesome');
+    });
+    it('renders qualified tokens with the correct family', () => {
+      const html = render('{[fa-solid:user]}');
+      expect(html).toContain('<i class="fa-solid fa-user"');
+      expect(html).toContain('data-icon="fa-solid:user"');
+    });
+  });
+  describe('with a theme', () => {
+    it('embeds the theme colors as CSS custom properties', () => {
+      const theme = resolveTheme('warm-earth');
+      const html = render('# Hello', { theme });
+      expect(html).toContain(`--plain-bg: ${theme.colors.background};`);
+      expect(html).toContain(`--plain-text: ${theme.colors.text};`);
+      expect(html).toContain(`--plain-primary: ${theme.colors.primary};`);
+    });
+    it('resolves the theme typography to CSS family strings', () => {
+      const theme = resolveTheme('documentary');
+      const html = render('# Hello', { theme });
+      // documentary uses playfair (title) + source-serif (body)
+      expect(html).toContain('--plain-title-font: "Playfair Display"');
+      expect(html).toContain('--plain-body-font: "Source Serif 4"');
+    });
+    it('emits a Google Fonts <link> for themes that reference google-hosted faces', () => {
+      const theme = resolveTheme('documentary');
+      const html = render('# Hello', { theme });
+      expect(html).toContain('<link rel="preconnect" href="https://fonts.googleapis.com">');
+      expect(html).toContain('https://fonts.googleapis.com/css2?');
+      expect(html).toContain('family=Playfair+Display:wght@400;700');
+      expect(html).toContain('family=Source+Serif+4:wght@400;700');
+      expect(html).toContain('display=swap');
+    });
+    it('omits the Google Fonts <link> for themes that use only system stacks', () => {
+      const theme = resolveTheme('standard');
+      const html = render('# Hello', { theme });
+      expect(html).not.toContain('fonts.googleapis.com');
+    });
+    it('uses default styles when no theme is provided', () => {
+      const html = render('# Hello');
+      expect(html).not.toContain('--plain-bg');
+      expect(html).not.toContain('fonts.googleapis.com');
+      expect(html).toContain('system-ui');
+    });
+    it('auto-resolves theme from frontmatter when no explicit theme is passed', () => {
+      // Without a theme option, the doc's themeId in frontmatter should
+      // pick up the theme automatically — callers like docblocks that
+      // render plain HTML straight from a parsed doc get themed output
+      // without having to wire theme resolution themselves.
+      const html = render('---\ntitle: x\nthemeId: warm-earth\n---\n\n# Hello');
+      const warm = resolveTheme('warm-earth');
+      expect(html).toContain(`--plain-bg: ${warm.colors.background};`);
+      expect(html).toContain(`--plain-text: ${warm.colors.text};`);
+    });
+    it('explicit theme option still wins over frontmatter themeId', () => {
+      // The site's export dialog lets the user override the doc's theme
+      // at export time — the option must take precedence over what the
+      // frontmatter encodes.
+      const cinematic = resolveTheme('cinematic');
+      const html = render('---\nthemeId: warm-earth\n---\n\n# Hello', { theme: cinematic });
+      expect(html).toContain(`--plain-bg: ${cinematic.colors.background};`);
+    });
+  });
+  describe('image sizing', () => {
+    it('lets explicit width/height attributes survive without CSS overriding them', () => {
+      // The WYSIWYG editor writes width/height after a resize. The CSS
+      // must not force `width: auto` or `height: auto` on imgs that
+      // carry explicit dims — otherwise the user's sizing is silently
+      // discarded.
+      const html = render('<img src="x.png" width="300" height="200">');
+      // No rule forcing height:auto unconditionally — the constrained
+      // variant only kicks in when neither attribute is present.
+      expect(html).toContain('img:not([width]):not([height])');
+      expect(html).not.toMatch(/^\s*img\s*\{[^}]*height:\s*auto/m);
+    });
+    it('feature media keeps width/height attrs untouched on resized images', () => {
+      const md = '# Hi {[leftFeature]}\n\n<img src="m.jpg" width="300" height="200">\n\nBody.';
+      const html = render(md);
+      // The image still carries its dimensions in the markup…
+      expect(html).toContain('width="300"');
+      expect(html).toContain('height="200"');
+      // …and the sized-media CSS rule no longer forces width:auto /
+      // height:auto, which would have overridden them.
+      expect(html).not.toMatch(/\.squisq-feature__media--sized\s+img\s*\{[^}]*width:\s*auto/);
+      expect(html).not.toMatch(/\.squisq-feature__media--sized\s+img\s*\{[^}]*height:\s*auto/);
+    });
+  });
+});

package/src/__tests__/plainHtmlBundle.test.ts ADDED Viewed

@@ -0,0 +1,235 @@
+/**
+ * Tests for the recursive plain-HTML bundle export
+ * (`markdownDocsToPlainHtmlBundle`).
+ *
+ * Each test sets up an in-memory "container" — a `Map<path, string>`
+ * for markdown sources and a `Map<path, ArrayBuffer>` for binary
+ * assets — wires it up as the `readDocument` / `readBinary` callbacks,
+ * exports the bundle, and inspects the resulting JSZip.
+ */
+import { describe, it, expect } from 'vitest';
+import JSZip from 'jszip';
+import { markdownDocsToPlainHtmlBundle } from '../html/plainHtmlBundle';
+/** Helper to read a Blob as Uint8Array (works in jsdom). */
+async function blobToUint8Array(blob: Blob): Promise<Uint8Array> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader();
+    reader.onload = () => resolve(new Uint8Array(reader.result as ArrayBuffer));
+    reader.onerror = () => reject(reader.error);
+    reader.readAsArrayBuffer(blob);
+  });
+}
+function makeContainer(docs: Record<string, string>, binaries: Record<string, ArrayBuffer> = {}) {
+  return {
+    readDocument: async (p: string) => (p in docs ? docs[p] : null),
+    readBinary: async (p: string) => (p in binaries ? binaries[p] : null),
+  };
+}
+async function readZipPath(blob: Blob, path: string): Promise<string | null> {
+  const zip = await JSZip.loadAsync(await blobToUint8Array(blob));
+  const file = zip.file(path);
+  return file ? file.async('text') : null;
+}
+async function listZipPaths(blob: Blob): Promise<string[]> {
+  const zip = await JSZip.loadAsync(await blobToUint8Array(blob));
+  // JSZip emits implicit directory entries (paths ending in `/`) when
+  // any file lives in a subfolder. We're testing file content; the
+  // directory placeholders are noise.
+  return Object.keys(zip.files)
+    .filter((p) => !p.endsWith('/'))
+    .sort();
+}
+describe('markdownDocsToPlainHtmlBundle', () => {
+  it('exports a single doc with no links to a 1-file html', async () => {
+    const c = makeContainer({ 'home.md': '# Home\n\nJust a single page.' });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      ...c,
+    });
+    const paths = await listZipPaths(blob);
+    expect(paths).toEqual(['home.html']);
+    const html = await readZipPath(blob, 'home.html');
+    expect(html).toContain('<h1>Home</h1>');
+  });
+  it('follows a linear chain home.md → resume.md and bundles both', async () => {
+    const c = makeContainer({
+      'home.md': '# Home\n\nMy [resume](resume.md) is here.',
+      'resume.md': '# Resume\n\nWork history.',
+    });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      ...c,
+    });
+    const paths = await listZipPaths(blob);
+    expect(paths).toContain('home.html');
+    expect(paths).toContain('resume.html');
+    const home = await readZipPath(blob, 'home.html');
+    // The .md link is rewritten to .html
+    expect(home).toContain('href="resume.html"');
+    expect(home).not.toContain('href="resume.md"');
+    const resume = await readZipPath(blob, 'resume.html');
+    expect(resume).toContain('<h1>Resume</h1>');
+  });
+  it('cycle-detects so a.md ↔ b.md does not loop', async () => {
+    const c = makeContainer({
+      'a.md': '# A\n\n[b](b.md)',
+      'b.md': '# B\n\n[a](a.md)',
+    });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'a.md',
+      ...c,
+    });
+    const paths = await listZipPaths(blob);
+    expect(paths.sort()).toEqual(['a.html', 'b.html']);
+  });
+  it('does NOT follow ../parent.md (scope rule)', async () => {
+    const c = makeContainer({
+      'subdir/intro.md': '# Intro\n\nLink to [parent](../outside.md).',
+      'outside.md': '# Outside',
+    });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'subdir/intro.md',
+      ...c,
+    });
+    const paths = await listZipPaths(blob);
+    // `outside.md` lives ABOVE the entry doc's directory → out of scope.
+    expect(paths).toEqual(['subdir/intro.html']);
+    const intro = await readZipPath(blob, 'subdir/intro.html');
+    // The link is not rewritten to .html — it stays as authored.
+    expect(intro).toContain('href="../outside.md"');
+  });
+  it('follows links into subfolders (still in scope)', async () => {
+    const c = makeContainer({
+      'home.md': '# Home\n\n[chapter 1](chapters/one.md)',
+      'chapters/one.md': '# Chapter 1\n\nContent.',
+    });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      ...c,
+    });
+    const paths = await listZipPaths(blob);
+    expect(paths).toContain('home.html');
+    expect(paths).toContain('chapters/one.html');
+    const home = await readZipPath(blob, 'home.html');
+    expect(home).toContain('href="chapters/one.html"');
+  });
+  it('preserves #anchor fragments when rewriting .md → .html', async () => {
+    const c = makeContainer({
+      'home.md': '# Home\n\nJump to [exp](resume.md#experience).',
+      'resume.md': '# Resume\n\n## Experience',
+    });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      ...c,
+    });
+    const home = await readZipPath(blob, 'home.html');
+    expect(home).toContain('href="resume.html#experience"');
+  });
+  it('aborts with an error when a linked doc cannot be read', async () => {
+    const c = makeContainer({
+      'home.md': '# Home\n\n[missing](does-not-exist.md)',
+    });
+    await expect(markdownDocsToPlainHtmlBundle({ entryPath: 'home.md', ...c })).rejects.toThrow(
+      /failed to read.*does-not-exist\.md/i,
+    );
+  });
+  it('emits image assets at their authored relative paths inside the zip', async () => {
+    const png = new Uint8Array([0x89, 0x50, 0x4e, 0x47]).buffer;
+    const c = makeContainer(
+      { 'home.md': '# Home\n\n![hero](home_files/hero.png)' },
+      { 'home_files/hero.png': png },
+    );
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      ...c,
+    });
+    const paths = await listZipPaths(blob);
+    expect(paths).toContain('home_files/hero.png');
+    const home = await readZipPath(blob, 'home.html');
+    expect(home).toContain('src="home_files/hero.png"');
+  });
+  it('linked sub-folder docs reference parent assets via ../', async () => {
+    // The doc lives in subdir/, the image in home_files/, so the
+    // rewritten src should walk up one level.
+    const png = new Uint8Array([0x89]).buffer;
+    const c = makeContainer(
+      {
+        'home.md': '# Home\n\n[deep](chapters/one.md)',
+        'chapters/one.md': '# One\n\n![shared](../home_files/hero.png)',
+      },
+      { 'home_files/hero.png': png },
+    );
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      ...c,
+    });
+    const paths = await listZipPaths(blob);
+    expect(paths).toContain('home_files/hero.png');
+    const one = await readZipPath(blob, 'chapters/one.html');
+    expect(one).toContain('src="../home_files/hero.png"');
+  });
+  it('passes the entry title through; sibling docs derive title from the shallowest heading', async () => {
+    const c = makeContainer({
+      'home.md': '# Home\n\n[resume](resume.md)\n\n[notes](notes.md)',
+      'resume.md': '# Resume',
+      'notes.md': 'Just a paragraph.',
+    });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      title: 'My Home Page',
+      ...c,
+    });
+    const home = await readZipPath(blob, 'home.html');
+    expect(home).toContain('<title>My Home Page</title>');
+    // Heading-bearing sibling uses its heading text, not the filename.
+    const resume = await readZipPath(blob, 'resume.html');
+    expect(resume).toContain('<title>Resume</title>');
+    // Heading-less sibling falls back to the filename.
+    const notes = await readZipPath(blob, 'notes.html');
+    expect(notes).toContain('<title>notes</title>');
+  });
+  it('respects maxDepth — depth 0 means entry only, no link following', async () => {
+    const c = makeContainer({
+      'home.md': '# Home\n\n[resume](resume.md)',
+      'resume.md': '# Resume',
+    });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      maxDepth: 0,
+      ...c,
+    });
+    const paths = await listZipPaths(blob);
+    expect(paths).toEqual(['home.html']);
+  });
+  it('does not rewrite external links (http://) or fragment-only links', async () => {
+    const c = makeContainer({
+      'home.md':
+        '[google](https://google.com)\n\n[#section](#somewhere)\n\n[email](mailto:me@example.com)',
+    });
+    const blob = await markdownDocsToPlainHtmlBundle({
+      entryPath: 'home.md',
+      ...c,
+    });
+    const home = await readZipPath(blob, 'home.html');
+    expect(home).toContain('href="https://google.com"');
+    expect(home).toContain('href="#somewhere"');
+    expect(home).toContain('href="mailto:me@example.com"');
+  });
+});