@bendyline/squisq 2.0.1 → 2.2.0

package/src/__tests__/narrationTestSignals.ts

@@ -1,167 +0,0 @@
-/**
- * Synthetic PCM builders for narration-engine tests (test-only, not
- * exported from the package). Everything is seeded via SeededRandom —
- * the same arguments always produce the same samples.
- */
-
-import { SeededRandom } from '../random/SeededRandom.js';
-import { parseMarkdown } from '../markdown/index.js';
-import { markdownToDoc } from '../doc/markdownToDoc.js';
-import { buildNarrationScript } from '../narration/script.js';
-import type { NarrationScript } from '../narration/types.js';
-
-export function silence(sec: number, sampleRate: number): Float32Array {
-  return new Float32Array(Math.max(0, Math.round(sec * sampleRate)));
-}
-
-/** Seeded white noise at a target RMS (uniform noise: rms = amp/√3). */
-export function noise(sec: number, sampleRate: number, rms: number, seed: number): Float32Array {
-  const rng = new SeededRandom(seed);
-  const out = new Float32Array(Math.max(0, Math.round(sec * sampleRate)));
-  const amp = rms * Math.sqrt(3);
-  for (let i = 0; i < out.length; i++) {
-    out[i] = (rng.next() * 2 - 1) * amp;
-  }
-  return out;
-}
-
-/** Pure tone (for band-response tests). */
-export function tone(freqHz: number, sec: number, sampleRate: number, amp = 0.5): Float32Array {
-  const out = new Float32Array(Math.round(sec * sampleRate));
-  const w = (2 * Math.PI * freqHz) / sampleRate;
-  for (let i = 0; i < out.length; i++) {
-    out[i] = amp * Math.sin(w * i);
-  }
-  return out;
-}
-
-/**
- * A voiced burst: harmonics at 220/700/1400/2200 Hz under a Hann
- * envelope plus 10% seeded noise — enough speech-band energy to trip
- * the VAD and produce one envelope peak (one syllable nucleus).
- */
-export function speechBurst(
-  sec: number,
-  sampleRate: number,
-  seed: number,
-  amp = 0.35,
-): Float32Array {
-  const rng = new SeededRandom(seed);
-  const n = Math.round(sec * sampleRate);
-  const out = new Float32Array(n);
-  const freqs = [220, 700, 1400, 2200];
-  const gains = [0.5, 1, 0.6, 0.3];
-  for (let i = 0; i < n; i++) {
-    const env = 0.5 * (1 - Math.cos((2 * Math.PI * i) / Math.max(1, n - 1)));
-    let s = 0;
-    for (let f = 0; f < freqs.length; f++) {
-      s += gains[f] * Math.sin((2 * Math.PI * freqs[f] * i) / sampleRate);
-    }
-    out[i] = amp * env * (s / 2.4 + 0.1 * (rng.next() * 2 - 1));
-  }
-  return out;
-}
-
-/** Overlay `piece` onto `target` starting at `atSec` (adds samples). */
-export function overlay(
-  target: Float32Array,
-  piece: Float32Array,
-  atSec: number,
-  sampleRate: number,
-): void {
-  const start = Math.round(atSec * sampleRate);
-  for (let i = 0; i < piece.length && start + i < target.length; i++) {
-    target[start + i] += piece[i];
-  }
-}
-
-export interface SyllableTrainOptions {
-  burstSec?: number;
-  noiseRms?: number;
-  totalSec?: number;
-  seed?: number;
-}
-
-/** Bursts at each onset time over a quiet noise floor (≈ −50 dB). */
-export function syllableTrain(
-  onsetsSec: number[],
-  sampleRate: number,
-  options?: SyllableTrainOptions,
-): Float32Array {
-  const burstSec = options?.burstSec ?? 0.16;
-  const noiseRms = options?.noiseRms ?? 0.003;
-  const seed = options?.seed ?? 1;
-  const last = onsetsSec.length > 0 ? Math.max(...onsetsSec) : 0;
-  const totalSec = options?.totalSec ?? last + burstSec + 0.5;
-  const pcm = noise(totalSec, sampleRate, noiseRms, seed);
-  onsetsSec.forEach((t, i) => {
-    overlay(pcm, speechBurst(burstSec, sampleRate, seed + 100 + i), t, sampleRate);
-  });
-  return pcm;
-}
-
-/** Build a real NarrationScript through the production pipeline. */
-export function scriptFromMarkdown(markdown: string): NarrationScript {
-  return buildNarrationScript(markdownToDoc(parseMarkdown(markdown)));
-}
-
-export interface SyntheticTake {
-  pcm: Float32Array;
-  /** Burst start time of each token's first syllable. */
-  trueWordTimes: number[];
-  /** True block start times (first word of each script block). */
-  trueBlockStarts: number[];
-  durationSec: number;
-}
-
-/**
- * Synthesize a spoken take of a script: one burst per token syllable at
- * a steady rate, with pauses matching the token pause classes.
- */
-export function takeFromScript(
-  script: NarrationScript,
-  wpm: number,
-  sampleRate: number,
-  seed: number,
-  opts?: { leadInSec?: number; extraOnsets?: number[]; dropTokenSyllable?: number[] },
-): SyntheticTake {
-  const meanSylPerWord = Math.max(1, script.totalSyllables / Math.max(1, script.tokens.length));
-  const sylPeriod = 60 / wpm / meanSylPerWord;
-  const burstSec = Math.min(0.16, sylPeriod * 0.7);
-  const leadIn = opts?.leadInSec ?? 0.6;
-  const dropSet = new Set(opts?.dropTokenSyllable ?? []);
-
-  const onsets: number[] = [];
-  const trueWordTimes: number[] = [];
-  let cursor = leadIn;
-  for (let k = 0; k < script.tokens.length; k++) {
-    const token = script.tokens[k];
-    trueWordTimes.push(cursor);
-    for (let s = 0; s < token.syllables; s++) {
-      if (!dropSet.has(k * 1000 + s)) onsets.push(cursor);
-      cursor += sylPeriod;
-    }
-    if (token.pauseAfter === 1) cursor += 0.35;
-    else if (token.pauseAfter === 2) cursor += 0.9;
-    else if (token.pauseAfter === 3) cursor += 1.2;
-  }
-  for (const extra of opts?.extraOnsets ?? []) onsets.push(extra);
-  onsets.sort((a, b) => a - b);
-
-  const durationSec = cursor + 0.6;
-  const pcm = syllableTrain(onsets, sampleRate, { burstSec, totalSec: durationSec, seed });
-  const trueBlockStarts = script.blocks.map((b) => trueWordTimes[b.tokenStart]);
-  return { pcm, trueWordTimes, trueBlockStarts, durationSec };
-}
-
-export function concat(...segments: Float32Array[]): Float32Array {
-  let total = 0;
-  for (const s of segments) total += s.length;
-  const out = new Float32Array(total);
-  let offset = 0;
-  for (const s of segments) {
-    out.set(s, offset);
-    offset += s.length;
-  }
-  return out;
-}

package/src/__tests__/narrationVad.test.ts

@@ -1,66 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { extractFrameFeatures } from '../narration/features';
-import { createVadState, vadStep } from '../narration/vad';
-import { concat, noise, speechBurst } from './narrationTestSignals';
-
-const SR = 48000;
-
-function runVad(pcm: Float32Array) {
-  const frames = extractFrameFeatures(pcm, SR);
-  let state = createVadState();
-  const flags: boolean[] = [];
-  for (const frame of frames) {
-    state = vadStep(state, frame);
-    flags.push(state.speaking);
-  }
-  return { frames, flags };
-}
-
-describe('vadStep', () => {
-  it('enters within 100 ms of speech onset and exits within hangover + 100 ms', () => {
-    const quiet = 0.004;
-    const pcm = concat(noise(1.0, SR, quiet, 1), speechBurst(0.8, SR, 2), noise(1.2, SR, quiet, 3));
-    const { frames, flags } = runVad(pcm);
-
-    const burstStart = 1.0;
-    const burstEnd = 1.8;
-    const enterIdx = flags.findIndex((f) => f);
-    expect(enterIdx).toBeGreaterThan(-1);
-    // Hann envelope reaches useful energy ~15% in, so allow 100 ms + ramp.
-    expect(frames[enterIdx].tSec).toBeGreaterThan(burstStart);
-    expect(frames[enterIdx].tSec).toBeLessThan(burstStart + 0.25);
-
-    let lastSpeaking = -1;
-    for (let i = 0; i < flags.length; i++) if (flags[i]) lastSpeaking = i;
-    expect(lastSpeaking).toBeGreaterThan(-1);
-    // Envelope tails off before burstEnd; exit must happen within
-    // (ramp-down ~0.15) + hangover 0.3 + margin 0.1 of the burst end.
-    expect(frames[lastSpeaking].tSec).toBeLessThan(burstEnd + 0.45);
-    expect(frames[lastSpeaking].tSec).toBeGreaterThan(burstEnd - 0.45);
-  });
-
-  it('detects no speech on steady noise', () => {
-    const { flags } = runVad(noise(3, SR, 0.01, 9));
-    expect(flags.some(Boolean)).toBe(false);
-  });
-
-  it('adapts the floor to a noise step without flapping', () => {
-    // −40 dB → −30 dB noise step: the step transient may read as speech,
-    // but the dip-starved rebaseline (1.5 s of zero dips) must adopt the
-    // new floor and settle back to silence — permanently.
-    const pcm = concat(noise(2, SR, 0.01, 4), noise(4, SR, 0.0316, 5));
-    const { frames, flags } = runVad(pcm);
-    const tail = flags.filter((_, i) => frames[i].tSec > 3.8);
-    expect(tail.length).toBeGreaterThan(0);
-    expect(tail.some(Boolean)).toBe(false);
-  });
-
-  it('still detects speech over the louder floor after adapting', () => {
-    const pcm = concat(noise(2, SR, 0.0316, 6), speechBurst(0.6, SR, 7), noise(0.8, SR, 0.0316, 8));
-    const { frames, flags } = runVad(pcm);
-    const speakingTimes = frames.filter((_, i) => flags[i]).map((f) => f.tSec);
-    expect(speakingTimes.length).toBeGreaterThan(0);
-    expect(Math.min(...speakingTimes)).toBeGreaterThan(1.9);
-    expect(Math.min(...speakingTimes)).toBeLessThan(2.3);
-  });
-});

package/src/__tests__/pandocAttrParse.test.ts

@@ -1,187 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { parseMarkdown, stringifyMarkdown } from '../markdown/index.js';
-
-function getHeading(md: string) {
-  const doc = parseMarkdown(md);
-  const heading = doc.children[0];
-  if (heading.type !== 'heading') throw new Error('expected heading');
-  return heading;
-}
-
-describe('Pandoc heading attribute parse', () => {
-  it('extracts an id-only block', () => {
-    const h = getHeading('## Section title {#intro}');
-    expect(h.attributes).toEqual({ id: 'intro' });
-    expect(h.templateAnnotation).toBeUndefined();
-  });
-
-  it('extracts classes', () => {
-    const h = getHeading('## X {.alpha .beta}');
-    expect(h.attributes?.classes).toEqual(['alpha', 'beta']);
-  });
-
-  it('extracts id + classes + params', () => {
-    const h = getHeading('## X {#abc .v1 .v2 x=400 y=200}');
-    expect(h.attributes?.id).toBe('abc');
-    expect(h.attributes?.classes).toEqual(['v1', 'v2']);
-    expect(h.attributes?.params).toEqual({ x: '400', y: '200' });
-    expect(h.attributes?.blockMeta).toEqual({ x: 400, y: 200 });
-  });
-
-  it('coerces connectsTo to a typed list', () => {
-    const h = getHeading('## X {connectsTo=foo:veryImportant,bar:requires,baz:requires}');
-    expect(h.attributes?.blockMeta?.connectsTo).toEqual([
-      { target: 'foo', type: 'veryImportant' },
-      { target: 'bar', type: 'requires' },
-      { target: 'baz', type: 'requires' },
-    ]);
-  });
-
-  it('coerces startTime/duration to seconds', () => {
-    const h = getHeading('## X {startTime=01:30 duration=00:45}');
-    expect(h.attributes?.blockMeta?.startTime).toBe(90);
-    expect(h.attributes?.blockMeta?.duration).toBe(45);
-  });
-
-  it('routes unknown keys to metadata', () => {
-    const h = getHeading('## X {#a priority=high level=info}');
-    expect(h.attributes?.metadata).toEqual({ priority: 'high', level: 'info' });
-    expect(h.attributes?.blockMeta).toBeUndefined();
-  });
-
-  it('handles quoted values with spaces', () => {
-    const h = getHeading('## X {caption="hello world"}');
-    expect(h.attributes?.params).toEqual({ caption: 'hello world' });
-    expect(h.attributes?.metadata).toEqual({ caption: 'hello world' });
-  });
-
-  it('preserves commas inside quoted values', () => {
-    const h = getHeading('## X {caption="hello, friend"}');
-    expect(h.attributes?.metadata).toEqual({ caption: 'hello, friend' });
-  });
-
-  it('escaped quotes inside quoted values', () => {
-    const h = getHeading('## X {label="he said \\"hi\\""}');
-    expect(h.attributes?.metadata?.label).toBe('he said "hi"');
-  });
-
-  it('handles single-quoted values with spaces', () => {
-    const h = getHeading("## X {caption='hello world'}");
-    expect(h.attributes?.params).toEqual({ caption: 'hello world' });
-  });
-
-  it('allows } inside a quoted value', () => {
-    const h = getHeading('## X {caption="a } b"}');
-    expect(h.attributes?.params).toEqual({ caption: 'a } b' });
-  });
-
-  it('treats an apostrophe inside an unquoted value as literal', () => {
-    const h = getHeading("## X {name=O'Brien x=4}");
-    expect(h.attributes?.metadata).toEqual({ name: "O'Brien" });
-    expect(h.attributes?.blockMeta?.x).toBe(4);
-  });
-
-  it('duplicate id: last wins', () => {
-    const h = getHeading('## X {#a #b}');
-    expect(h.attributes?.id).toBe('b');
-  });
-
-  it('duplicate key: last wins', () => {
-    const h = getHeading('## X {x=1 x=2}');
-    expect(h.attributes?.blockMeta?.x).toBe(2);
-  });
-
-  it('does NOT match a non-trailing brace block', () => {
-    const h = getHeading('## The {#wrong} section');
-    expect(h.attributes).toBeUndefined();
-  });
-
-  it('does NOT collide with {[…]} template annotation', () => {
-    const h = getHeading('## X {[chart]}');
-    expect(h.templateAnnotation).toEqual({ template: 'chart' });
-    expect(h.attributes).toBeUndefined();
-  });
-});
-
-describe('Coexistence of {#…} and {[…]}', () => {
-  it('Pandoc first, then template', () => {
-    const h = getHeading('## X {#abc} {[chart]}');
-    expect(h.attributes?.id).toBe('abc');
-    expect(h.templateAnnotation?.template).toBe('chart');
-  });
-
-  it('Template first, then Pandoc (order-agnostic)', () => {
-    const h = getHeading('## X {[chart]} {#abc}');
-    expect(h.attributes?.id).toBe('abc');
-    expect(h.templateAnnotation?.template).toBe('chart');
-  });
-
-  it('both with params on each side', () => {
-    const h = getHeading('## X {#a x=400 y=200} {[chart colorScheme=blue]}');
-    expect(h.attributes?.id).toBe('a');
-    expect(h.attributes?.blockMeta?.x).toBe(400);
-    expect(h.attributes?.blockMeta?.y).toBe(200);
-    expect(h.templateAnnotation?.template).toBe('chart');
-    expect(h.templateAnnotation?.params).toEqual({ colorScheme: 'blue' });
-  });
-
-  it('Pandoc block-meta does not leak into templateOverrides', () => {
-    const h = getHeading('## X {#a x=400} {[chart colorScheme=blue]}');
-    expect(h.templateAnnotation?.params).toEqual({ colorScheme: 'blue' });
-    expect(h.attributes?.params).toEqual({ x: '400' });
-  });
-});
-
-describe('Markdown round-trip with attributes', () => {
-  it('Pandoc-only id round-trips', () => {
-    const src = '## Section title {#intro}\n';
-    const md = parseMarkdown(src);
-    expect(stringifyMarkdown(md).trim()).toBe(src.trim());
-  });
-
-  it('canonicalizes order: Pandoc first, then template', () => {
-    const input = '## X {[chart]} {#abc}\n';
-    const md = parseMarkdown(input);
-    const out = stringifyMarkdown(md).trim();
-    expect(out).toBe('## X {#abc} {[chart]}');
-  });
-
-  it('full attribute set round-trips', () => {
-    const src =
-      '## Architecture {#arch x=600 y=300 connectsTo=foo:veryImportant,bar:requires,baz:requires} {[diagramNode]}\n';
-    const md = parseMarkdown(src);
-    const out = stringifyMarkdown(md).trim();
-    expect(out).toBe(src.trim());
-  });
-
-  it('quoted value round-trips with quoting preserved', () => {
-    const src = '## X {caption="hello world"}\n';
-    const md = parseMarkdown(src);
-    const out = stringifyMarkdown(md).trim();
-    expect(out).toBe(src.trim());
-  });
-
-  it('existing {[…]}-only docs are unchanged', () => {
-    const src = '## Getting Started {[chart colorScheme=blue]}\n';
-    const md = parseMarkdown(src);
-    const out = stringifyMarkdown(md).trim();
-    expect(out).toBe(src.trim());
-  });
-
-  it('single-quoted values canonicalize to double quotes', () => {
-    const md = parseMarkdown("## X {caption='hello world'}");
-    expect(stringifyMarkdown(md).trim()).toBe('## X {caption="hello world"}');
-  });
-
-  it('a value containing a double quote round-trips via single quotes', () => {
-    const src = '## X {label=\'say "hi"\'}';
-    const md = parseMarkdown(src);
-    expect(stringifyMarkdown(md).trim()).toBe(src);
-  });
-
-  it('a quoted } round-trips', () => {
-    const src = '## X {caption="a } b"}';
-    const md = parseMarkdown(src);
-    expect(stringifyMarkdown(md).trim()).toBe(src);
-  });
-});

package/src/__tests__/recommendTemplates.test.ts

@@ -1,183 +0,0 @@
-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: string) {
-  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);
-  });
-});

package/src/__tests__/resolveDocTheme.test.ts

@@ -1,69 +0,0 @@
-/**
- * resolveThemeForDoc — pure, doc-scoped theme resolution.
- *
- * The theme analog of buildRegistry: an inline custom theme resolves from the
- * doc's own `customThemes` list. Explicit caller registries and built-ins are
- * fallback sources for non-inline ids.
- */
-
-import { describe, it, expect } from 'vitest';
-import { resolveThemeForDoc } from '../doc/resolveDocTheme';
-import { compileTheme } from '../schemas/themeCompile';
-import { createThemeRegistry } from '../schemas/Theme';
-import { DEFAULT_THEME } from '../schemas/themeLibrary';
-import type { Doc } from '../schemas/Doc.js';
-
-const brand = compileTheme({
-  id: 'my-brand',
-  name: 'My Brand',
-  seedColors: { primary: '#3182ce' },
-});
-
-function docWith(partial: Partial<Doc>): Doc {
-  return {
-    articleId: 'd',
-    duration: 0,
-    blocks: [],
-    audio: { segments: [] },
-    ...partial,
-  } as Doc;
-}
-
-describe('resolveThemeForDoc', () => {
-  it('resolves an inline custom theme doc-scoped (no global registration)', () => {
-    const doc = docWith({ customThemes: [brand], frontmatter: { 'squisq-theme': 'my-brand' } });
-    expect(resolveThemeForDoc(doc)).toEqual(brand);
-  });
-
-  it('honors an explicit id over the frontmatter selection', () => {
-    const doc = docWith({ customThemes: [brand], frontmatter: { 'squisq-theme': 'cinematic' } });
-    expect(resolveThemeForDoc(doc, 'my-brand')).toEqual(brand);
-  });
-
-  it('falls back to a built-in when the id is not an inline theme', () => {
-    const doc = docWith({ customThemes: [brand], frontmatter: { 'squisq-theme': 'cinematic' } });
-    expect(resolveThemeForDoc(doc).id).toBe('cinematic');
-  });
-
-  it('uses Doc.themeId when there is no explicit or frontmatter id', () => {
-    const doc = docWith({ customThemes: [brand], themeId: 'my-brand' });
-    expect(resolveThemeForDoc(doc)).toEqual(brand);
-  });
-
-  it('returns the default theme for a null doc', () => {
-    expect(resolveThemeForDoc(null).id).toBe(DEFAULT_THEME.id);
-  });
-
-  it('uses an explicit registry only after document-scoped definitions', () => {
-    const external = compileTheme({
-      id: 'external-brand',
-      name: 'External Brand',
-      seedColors: { primary: '#8844aa' },
-    });
-    const registry = createThemeRegistry([external]);
-    const doc = docWith({ themeId: 'external-brand' });
-
-    expect(resolveThemeForDoc(doc)).toBe(DEFAULT_THEME);
-    expect(resolveThemeForDoc(doc, undefined, registry)).toEqual(external);
-  });
-});