@bendyline/squisq 1.2.2 → 1.4.0

package/dist/__tests__/recommendTemplates.test.js

@@ -0,0 +1,158 @@
+import { describe, expect, it } from 'vitest';
+import { parseMarkdown } from '../markdown/parse.js';
+import { profileBlockContents, recommendTemplatesForBlock } from '../recommend/templates.js';
+const ALL_TEMPLATES = [
+    'title',
+    'sectionHeader',
+    'statHighlight',
+    'quote',
+    'factCard',
+    'twoColumn',
+    'dateEvent',
+    'imageWithCaption',
+    'leftFeature',
+    'rightFeature',
+    'map',
+    'fullBleedQuote',
+    'list',
+    'photoGrid',
+    'definitionCard',
+    'comparisonBar',
+    'pullQuote',
+    'videoWithCaption',
+    'videoPullQuote',
+    'dataTable',
+];
+function profileOf(source) {
+    const doc = parseMarkdown(source);
+    return profileBlockContents(doc.children);
+}
+describe('profileBlockContents', () => {
+    it('returns an empty profile for no nodes', () => {
+        const p = profileBlockContents([]);
+        expect(p.wordCount).toBe(0);
+        expect(p.hasImage).toBe(false);
+        expect(p.hasVideo).toBe(false);
+    });
+    it('detects a single markdown image', () => {
+        const p = profileOf('![alt](https://example.com/a.png)');
+        expect(p.imageCount).toBe(1);
+        expect(p.hasImage).toBe(true);
+    });
+    it('detects an HTML <img> tag', () => {
+        const p = profileOf('<img src="a.png" alt="x" />');
+        expect(p.imageCount).toBe(1);
+        expect(p.hasImage).toBe(true);
+    });
+    it('detects a blockquote', () => {
+        const p = profileOf('> The mountain was calling me.');
+        expect(p.hasBlockquote).toBe(true);
+    });
+    it('detects a bullet list', () => {
+        const p = profileOf('- one\n- two\n- three');
+        expect(p.hasList).toBe(true);
+    });
+    it('detects a GFM table', () => {
+        const p = profileOf('| a | b |\n| --- | --- |\n| 1 | 2 |');
+        expect(p.hasTable).toBe(true);
+    });
+    it('detects a date string in body text', () => {
+        const p = profileOf('Construction began in July 1899.');
+        expect(p.hasDate).toBe(true);
+    });
+    it('detects an ISO date', () => {
+        const p = profileOf('Launched on 2024-03-15.');
+        expect(p.hasDate).toBe(true);
+    });
+    it('detects a prominent number paragraph', () => {
+        const p = profileOf('$2.3M raised');
+        expect(p.hasNumberHighlight).toBe(true);
+    });
+    it('detects a YouTube embed via link', () => {
+        const p = profileOf('[Watch](https://www.youtube.com/watch?v=abc)');
+        expect(p.hasVideo).toBe(true);
+    });
+    it('detects a <video> tag', () => {
+        const p = profileOf('<video src="x.mp4"></video>');
+        expect(p.hasVideo).toBe(true);
+    });
+    it('counts multiple images', () => {
+        const p = profileOf('![a](a.png)\n\n![b](b.png)\n\n![c](c.png)');
+        expect(p.imageCount).toBe(3);
+    });
+});
+describe('recommendTemplatesForBlock', () => {
+    it('falls back to universal defaults when nothing is detected', () => {
+        const profile = profileBlockContents([]);
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(recommended).toEqual(['title', 'sectionHeader', 'factCard', 'twoColumn']);
+    });
+    it('keeps recommended ordering aligned with the input list', () => {
+        const profile = profileOf('![a](a.png)');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        // imageWithCaption comes before leftFeature/rightFeature in ALL_TEMPLATES
+        expect(recommended.indexOf('imageWithCaption')).toBeLessThan(recommended.indexOf('leftFeature'));
+    });
+    it('recommends image templates for blocks with one image (no photoGrid)', () => {
+        const profile = profileOf('![a](a.png)');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(recommended).toContain('imageWithCaption');
+        expect(recommended).toContain('leftFeature');
+        expect(recommended).toContain('rightFeature');
+        expect(recommended).not.toContain('photoGrid');
+    });
+    it('adds photoGrid when 2+ images present', () => {
+        const profile = profileOf('![a](a.png)\n\n![b](b.png)');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(recommended).toContain('photoGrid');
+    });
+    it('recommends quote templates for blocks with blockquotes', () => {
+        const profile = profileOf('> something memorable');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(recommended).toContain('quote');
+        expect(recommended).toContain('pullQuote');
+        expect(recommended).toContain('fullBleedQuote');
+    });
+    it('recommends dateEvent for blocks with date strings', () => {
+        const profile = profileOf('On March 5, 2024, the ribbon was cut.');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(recommended).toContain('dateEvent');
+    });
+    it('recommends statHighlight for blocks with prominent numbers', () => {
+        const profile = profileOf('$2.3M raised');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(recommended).toContain('statHighlight');
+    });
+    it('recommends dataTable + comparisonBar for blocks with tables', () => {
+        const profile = profileOf('| a | b |\n| --- | --- |\n| 1 | 2 |');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(recommended).toContain('dataTable');
+        expect(recommended).toContain('comparisonBar');
+    });
+    it('omits universal generics (factCard, twoColumn) when specific signal fires', () => {
+        const profile = profileOf('> something memorable');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        // title + sectionHeader still come along, but factCard/twoColumn do not
+        expect(recommended).toContain('title');
+        expect(recommended).toContain('sectionHeader');
+        expect(recommended).not.toContain('factCard');
+        expect(recommended).not.toContain('twoColumn');
+    });
+    it('combines multiple signals additively', () => {
+        const profile = profileOf('![a](a.png)\n\n> a great line\n\n- alpha\n- beta');
+        const { recommended } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(recommended).toContain('imageWithCaption');
+        expect(recommended).toContain('quote');
+        expect(recommended).toContain('list');
+    });
+    it('places unrecommended templates in the rest bucket', () => {
+        const profile = profileOf('![a](a.png)');
+        const { recommended, rest } = recommendTemplatesForBlock(profile, ALL_TEMPLATES);
+        expect(rest).toContain('map');
+        expect(rest).toContain('definitionCard');
+        // No template appears in both buckets
+        for (const name of recommended)
+            expect(rest).not.toContain(name);
+    });
+});
+//# sourceMappingURL=recommendTemplates.test.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=scopedContentContainer.test.d.ts.map

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

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

package/dist/__tests__/scopedContentContainer.test.js

@@ -0,0 +1,74 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { MemoryContentContainer } from '../storage/ContentContainer';
+import { ScopedContentContainer, scopeContainer } from '../storage/ScopedContentContainer';
+const enc = (s) => new TextEncoder().encode(s);
+const dec = (b) => (b ? new TextDecoder().decode(b) : null);
+describe('ScopedContentContainer', () => {
+    let parent;
+    beforeEach(() => {
+        parent = new MemoryContentContainer();
+    });
+    it('writeFile + readFile route through the prefix', async () => {
+        const scoped = scopeContainer(parent, 'image_files');
+        await scoped.writeFile('state.json', enc('{}'), 'application/json');
+        expect(dec(await parent.readFile('image_files/state.json'))).toBe('{}');
+        expect(dec(await scoped.readFile('state.json'))).toBe('{}');
+    });
+    it('exists + removeFile honor the prefix', async () => {
+        const scoped = scopeContainer(parent, 'image_files');
+        await scoped.writeFile('a.txt', enc('a'));
+        expect(await scoped.exists('a.txt')).toBe(true);
+        expect(await parent.exists('image_files/a.txt')).toBe(true);
+        await scoped.removeFile('a.txt');
+        expect(await scoped.exists('a.txt')).toBe(false);
+        expect(await parent.exists('image_files/a.txt')).toBe(false);
+    });
+    it('listFiles returns prefix-stripped paths and ignores siblings', async () => {
+        const scoped = scopeContainer(parent, 'image_files');
+        await parent.writeFile('outside.txt', enc('x'));
+        await parent.writeFile('image_files_sibling/peek.txt', enc('y')); // not in scope
+        await scoped.writeFile('a.txt', enc('1'));
+        await scoped.writeFile('sub/b.txt', enc('2'));
+        const list = await scoped.listFiles();
+        const paths = list.map((e) => e.path).sort();
+        expect(paths).toEqual(['a.txt', 'sub/b.txt']);
+    });
+    it('listFiles with prefix joins the scope prefix', async () => {
+        const scoped = scopeContainer(parent, 'sidecar');
+        await scoped.writeFile('assets/a.png', enc('a'));
+        await scoped.writeFile('assets/b.png', enc('b'));
+        await scoped.writeFile('state.json', enc('{}'));
+        const list = await scoped.listFiles('assets/');
+        expect(list.map((e) => e.path).sort()).toEqual(['assets/a.png', 'assets/b.png']);
+    });
+    it('nested scopes compose', async () => {
+        const a = scopeContainer(parent, 'a');
+        const ab = scopeContainer(a, 'b');
+        await ab.writeFile('c.txt', enc('hi'));
+        expect(dec(await parent.readFile('a/b/c.txt'))).toBe('hi');
+        expect(dec(await ab.readFile('c.txt'))).toBe('hi');
+    });
+    it('normalizes leading/trailing slashes in prefix and paths', async () => {
+        const scoped = scopeContainer(parent, '/sidecar/');
+        expect(scoped.prefix).toBe('sidecar');
+        await scoped.writeFile('/x.txt', enc('x'));
+        expect(dec(await parent.readFile('sidecar/x.txt'))).toBe('x');
+    });
+    it('rejects empty / dotted prefixes', () => {
+        expect(() => scopeContainer(parent, '')).toThrow();
+        expect(() => scopeContainer(parent, '/')).toThrow();
+        expect(() => scopeContainer(parent, 'a/../b')).toThrow();
+        expect(() => scopeContainer(parent, './a')).toThrow();
+    });
+    it('getDocumentPath / readDocument always return null', async () => {
+        const scoped = scopeContainer(parent, 'sidecar');
+        await scoped.writeFile('index.md', enc('# hi'));
+        expect(await scoped.getDocumentPath()).toBeNull();
+        expect(await scoped.readDocument()).toBeNull();
+    });
+    it('writeDocument throws', async () => {
+        const scoped = new ScopedContentContainer(parent, 'sidecar');
+        await expect(scoped.writeDocument()).rejects.toThrow();
+    });
+});
+//# sourceMappingURL=scopedContentContainer.test.js.map

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

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

package/dist/__tests__/slideshowGenerator.test.js

@@ -30,7 +30,7 @@ describe('generateSlideshow', () => {
         expect(doc.articleId).toBe('Mount Rainier');
         const first = doc.blocks[0];
         if (isTemplateBlock(first)) {
-            expect(first.template).toBe('titleBlock');
+            expect(first.template).toBe('title');
         }
     });
     it('embeds themeId in the Doc', () => {

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=surface.test.d.ts.map

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

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

package/dist/__tests__/surface.test.js

@@ -0,0 +1,57 @@
+import { describe, it, expect } from 'vitest';
+import { applySurface, DARK_SURFACE, DEFAULT_THEME, LIGHT_SURFACE, } from '../schemas/index.js';
+describe('SurfaceScheme', () => {
+    it('LIGHT_SURFACE and DARK_SURFACE expose the full field set', () => {
+        for (const s of [LIGHT_SURFACE, DARK_SURFACE]) {
+            expect(typeof s.id).toBe('string');
+            expect(typeof s.background).toBe('string');
+            expect(typeof s.backgroundLight).toBe('string');
+            expect(typeof s.text).toBe('string');
+            expect(typeof s.textMuted).toBe('string');
+        }
+    });
+});
+describe('applySurface', () => {
+    it('overlays surface fields onto a theme', () => {
+        const out = applySurface(DEFAULT_THEME, LIGHT_SURFACE);
+        expect(out.colors.background).toBe(LIGHT_SURFACE.background);
+        expect(out.colors.backgroundLight).toBe(LIGHT_SURFACE.backgroundLight);
+        expect(out.colors.text).toBe(LIGHT_SURFACE.text);
+        expect(out.colors.textMuted).toBe(LIGHT_SURFACE.textMuted);
+    });
+    it('leaves editorial colors (primary, highlight, warning) untouched', () => {
+        const out = applySurface(DEFAULT_THEME, DARK_SURFACE);
+        expect(out.colors.primary).toBe(DEFAULT_THEME.colors.primary);
+        expect(out.colors.secondary).toBe(DEFAULT_THEME.colors.secondary);
+        expect(out.colors.highlight).toBe(DEFAULT_THEME.colors.highlight);
+        expect(out.colors.warning).toBe(DEFAULT_THEME.colors.warning);
+    });
+    it('leaves typography, style, renderStyle, colorSchemes untouched', () => {
+        const out = applySurface(DEFAULT_THEME, LIGHT_SURFACE);
+        expect(out.typography).toBe(DEFAULT_THEME.typography);
+        expect(out.style).toBe(DEFAULT_THEME.style);
+        expect(out.renderStyle).toBe(DEFAULT_THEME.renderStyle);
+        expect(out.colorSchemes).toBe(DEFAULT_THEME.colorSchemes);
+    });
+    it('returns a new theme (does not mutate the base)', () => {
+        const frozenTheme = DEFAULT_THEME;
+        const originalBg = frozenTheme.colors.background;
+        const out = applySurface(frozenTheme, DARK_SURFACE);
+        expect(out).not.toBe(frozenTheme);
+        expect(out.colors).not.toBe(frozenTheme.colors);
+        expect(frozenTheme.colors.background).toBe(originalBg);
+    });
+    it('accepts custom SurfaceScheme objects', () => {
+        const custom = {
+            id: 'parchment',
+            background: '#f4ecd8',
+            backgroundLight: '#e8dfc4',
+            text: '#2b2b2b',
+            textMuted: '#6b6b6b',
+        };
+        const out = applySurface(DEFAULT_THEME, custom);
+        expect(out.colors.background).toBe('#f4ecd8');
+        expect(out.colors.textMuted).toBe('#6b6b6b');
+    });
+});
+//# sourceMappingURL=surface.test.js.map

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

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

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

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=templateAnnotationParse.test.d.ts.map

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

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

package/dist/__tests__/templateAnnotationParse.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect } from 'vitest';
+import { parseMarkdown } from '../markdown/parse.js';
+import { markdownToDoc } from '../doc/markdownToDoc.js';
+describe('Template annotation in Heading parse path', () => {
+    it('parseMarkdown extracts {[template]} from a heading', () => {
+        const md = '## Getting Started {[comparisonBar]}';
+        const doc = parseMarkdown(md);
+        const heading = doc.children[0];
+        expect(heading.type).toBe('heading');
+        if (heading.type !== 'heading')
+            return;
+        expect(heading.templateAnnotation).toEqual({ template: 'comparisonBar' });
+    });
+    it('markdownToDoc preserves templateAnnotation on the resulting block', () => {
+        const md = '# Title\n\n## Getting Started {[comparisonBar]}\n\nBody.';
+        const parsed = parseMarkdown(md);
+        const doc = markdownToDoc(parsed, { articleId: 'test' });
+        // The h1 is the root; first child is the h2 with annotation
+        const h1 = doc.blocks[0];
+        expect(h1.sourceHeading?.depth).toBe(1);
+        const h2 = h1.children?.[0];
+        expect(h2?.sourceHeading?.depth).toBe(2);
+        expect(h2?.sourceHeading?.templateAnnotation).toEqual({ template: 'comparisonBar' });
+    });
+    it('tolerates accidentally-doubled trailing `]}` (user typo)', () => {
+        const md = '## Getting Started {[comparisonBar]}]}';
+        const doc = parseMarkdown(md);
+        const heading = doc.children[0];
+        if (heading.type !== 'heading')
+            throw new Error('expected heading');
+        expect(heading.templateAnnotation).toEqual({ template: 'comparisonBar' });
+    });
+    it('still rejects non-trailing annotations (regex stays anchored)', () => {
+        const md = '## The {[chart]} section'; // word continues after — not an annotation
+        const doc = parseMarkdown(md);
+        const heading = doc.children[0];
+        if (heading.type !== 'heading')
+            throw new Error('expected heading');
+        expect(heading.templateAnnotation).toBeUndefined();
+    });
+});
+//# sourceMappingURL=templateAnnotationParse.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"templateAnnotationParse.test.js","sourceRoot":"","sources":["../../src/__tests__/templateAnnotationParse.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAExD,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,oDAAoD,EAAE,GAAG,EAAE;QAC5D,MAAM,EAAE,GAAG,sCAAsC,CAAC;QAClD,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACrC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,OAAO;QACvC,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,mEAAmE,EAAE,GAAG,EAAE;QAC3E,MAAM,EAAE,GAAG,0DAA0D,CAAC;QACtE,MAAM,MAAM,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;QACjC,MAAM,GAAG,GAAG,aAAa,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAC;QACzD,4DAA4D;QAC5D,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACzB,MAAM,CAAC,EAAE,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,EAAE,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5B,MAAM,CAAC,EAAE,EAAE,aAAa,EAAE,KAAK,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzC,MAAM,CAAC,EAAE,EAAE,aAAa,EAAE,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;IACvF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,EAAE,GAAG,wCAAwC,CAAC;QACpD,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACpE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAC,EAAE,QAAQ,EAAE,eAAe,EAAE,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,EAAE,GAAG,0BAA0B,CAAC,CAAC,2CAA2C;QAClF,MAAM,GAAG,GAAG,aAAa,CAAC,EAAE,CAAC,CAAC;QAC9B,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,OAAO,CAAC,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAC;QACpE,MAAM,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC,aAAa,EAAE,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/templates.test.js

@@ -3,17 +3,19 @@ import { expandTemplateBlock, expandDocBlocks, getAvailableTemplates, hasTemplat
 describe('templateRegistry', () => {
     it('contains all expected templates', () => {
         const expected = [
-            'titleBlock',
+            'title',
             'sectionHeader',
             'statHighlight',
-            'quoteBlock',
+            'quote',
             'factCard',
             'twoColumn',
             'dateEvent',
             'imageWithCaption',
-            'mapBlock',
+            'leftFeature',
+            'rightFeature',
+            'map',
             'fullBleedQuote',
-            'listBlock',
+            'list',
             'photoGrid',
             'definitionCard',
             'comparisonBar',
@@ -31,14 +33,14 @@ describe('templateRegistry', () => {
 describe('getAvailableTemplates', () => {
     it('returns array of template names', () => {
         const templates = getAvailableTemplates();
-        expect(templates).toContain('titleBlock');
+        expect(templates).toContain('title');
         expect(templates).toContain('sectionHeader');
         expect(templates.length).toBeGreaterThanOrEqual(15);
     });
 });
 describe('hasTemplate', () => {
     it('returns true for existing templates', () => {
-        expect(hasTemplate('titleBlock')).toBe(true);
+        expect(hasTemplate('title')).toBe(true);
         expect(hasTemplate('statHighlight')).toBe(true);
     });
     it('returns false for unknown templates', () => {
@@ -48,7 +50,7 @@ describe('hasTemplate', () => {
 describe('expandTemplateBlock', () => {
     it('expands titleSlide template into layers', () => {
         const block = {
-            template: 'titleBlock',
+            template: 'title',
             id: 'title-1',
             duration: 10,
             audioSegment: 0,
@@ -62,6 +64,85 @@ describe('expandTemplateBlock', () => {
         expect(result.layers ?? []).toBeInstanceOf(Array);
         expect((result.layers ?? []).length).toBeGreaterThan(0);
     });
+    it('expands leftFeature template with image on the left half and left-aligned text right', () => {
+        const block = {
+            template: 'leftFeature',
+            id: 'lf-1',
+            duration: 6,
+            audioSegment: 0,
+            imageSrc: 'hero.jpg',
+            imageAlt: 'hero',
+            title: 'Product Builder',
+            body: 'I love building software platforms.',
+        };
+        const context = createTemplateContext(DEFAULT_THEME, 0, 1, VIEWPORT_PRESETS.landscape);
+        const result = expandTemplateBlock(block, context);
+        const layers = result.layers ?? [];
+        const imageLayer = layers.find((l) => l.type === 'image');
+        expect(imageLayer).toBeDefined();
+        expect(imageLayer.position.x).toBe('0');
+        expect(imageLayer.position.width).toBe('50%');
+        // Text column sits just past the 50% divider, top-left anchored,
+        // so the title and body share a left edge with comfortable padding.
+        const textLayers = layers.filter((l) => l.type === 'text');
+        expect(textLayers.length).toBeGreaterThanOrEqual(1);
+        for (const t of textLayers) {
+            expect(t.position.x).toBe('54%');
+            expect(t.position.anchor).toBe('top-left');
+            expect(t.content.style.textAlign).toBe('left');
+        }
+    });
+    it('respects explicit image dimensions: contained + padded inside the half', () => {
+        // When the user resizes an image in the WYSIWYG editor it round-
+        // trips as `<img width …>`. Feature blocks should treat that as a
+        // hint to NOT stretch the image — render it centered with padding
+        // around it.
+        const block = {
+            template: 'leftFeature',
+            id: 'lf-sized',
+            duration: 6,
+            audioSegment: 0,
+            imageSrc: 'hero.jpg',
+            imageAlt: 'hero',
+            imageWidth: 194,
+            title: 'Sized',
+        };
+        const context = createTemplateContext(DEFAULT_THEME, 0, 1, VIEWPORT_PRESETS.landscape);
+        const result = expandTemplateBlock(block, context);
+        const imageLayer = (result.layers ?? []).find((l) => l.type === 'image');
+        expect(imageLayer).toBeDefined();
+        expect(imageLayer.content.fit).toBe('contain');
+        // Image is inset from the half's edges rather than filling them.
+        expect(imageLayer.position.x).toBe('5%');
+        expect(imageLayer.position.width).toBe('40%');
+        expect(imageLayer.position.y).toBe('5%');
+        expect(imageLayer.position.height).toBe('90%');
+    });
+    it('expands rightFeature template with image on the right half and right-aligned text left', () => {
+        const block = {
+            template: 'rightFeature',
+            id: 'rf-1',
+            duration: 6,
+            audioSegment: 0,
+            imageSrc: 'hero.jpg',
+            imageAlt: 'hero',
+            title: 'Projects',
+            body: 'A list of things.',
+        };
+        const context = createTemplateContext(DEFAULT_THEME, 0, 1, VIEWPORT_PRESETS.landscape);
+        const result = expandTemplateBlock(block, context);
+        const layers = result.layers ?? [];
+        const imageLayer = layers.find((l) => l.type === 'image');
+        expect(imageLayer).toBeDefined();
+        expect(imageLayer.position.x).toBe('50%');
+        expect(imageLayer.position.width).toBe('50%');
+        const textLayers = layers.filter((l) => l.type === 'text');
+        for (const t of textLayers) {
+            expect(t.position.x).toBe('46%');
+            expect(t.position.anchor).toBe('top-right');
+            expect(t.content.style.textAlign).toBe('right');
+        }
+    });
     it('expands statHighlight template', () => {
         const block = {
             template: 'statHighlight',
@@ -141,7 +222,7 @@ describe('expandTemplateBlock', () => {
 describe('expandDocBlocks', () => {
     it('expands array of template blocks with cumulative timing', () => {
         const blocks = [
-            { template: 'titleBlock', id: 'slide-1', duration: 5, audioSegment: 0, title: 'Hello' },
+            { template: 'title', id: 'slide-1', duration: 5, audioSegment: 0, title: 'Hello' },
             {
                 template: 'factCard',
                 id: 'slide-2',
@@ -186,7 +267,7 @@ describe('expandDocBlocks', () => {
     });
     it('supports landscape and portrait viewports', () => {
         const blocks = [
-            { template: 'titleBlock', id: 'title-1', duration: 5, audioSegment: 0, title: 'Test' },
+            { template: 'title', id: 'title-1', duration: 5, audioSegment: 0, title: 'Test' },
         ];
         const landscape = expandDocBlocks(blocks, { viewport: VIEWPORT_PRESETS.landscape });
         const portrait = expandDocBlocks(blocks, { viewport: VIEWPORT_PRESETS.portrait });