@bendyline/squisq 2.0.1 → 2.2.0

package/dist/chunk-ZLQKNOZQ.js

@@ -1 +0,0 @@
-//# sourceMappingURL=chunk-ZLQKNOZQ.js.map

package/dist/chunk-ZLQKNOZQ.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/doc/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/generate/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/icons/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/icons/inlineIconMarker.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/imageEdit/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/jsonForm/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/markdown/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/narration/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/random/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/recommend/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/schemas/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/spatial/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/storage/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/timing/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/transform/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/versions/index.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/src/__tests__/animationUtils.test.ts

@@ -1,117 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import {
-  getAnimationStyle,
-  getDefaultAnimationDuration,
-  getTransitionClass,
-  getAnimationProgress,
-} from '../doc/utils/animationUtils';
-import { TRANSITION_TYPES } from '../schemas/Transitions';
-
-describe('getAnimationStyle', () => {
-  it('returns empty for undefined animation', () => {
-    const result = getAnimationStyle(undefined);
-    expect(result.className).toBe('');
-    expect(result.style).toEqual({});
-  });
-
-  it('returns empty for type "none"', () => {
-    const result = getAnimationStyle({ type: 'none' });
-    expect(result.className).toBe('');
-  });
-
-  it('returns correct class for fadeIn', () => {
-    const result = getAnimationStyle({ type: 'fadeIn' });
-    expect(result.className).toBe('anim-fadeIn');
-  });
-
-  it('returns correct class for slowZoom with pan', () => {
-    const result = getAnimationStyle({ type: 'slowZoom', panDirection: 'left' });
-    expect(result.className).toBe('anim-slowZoom-panLeft');
-  });
-
-  it('includes CSS custom properties for duration and delay', () => {
-    const result = getAnimationStyle({ type: 'fadeIn', duration: 2, delay: 0.5 });
-    expect(result.style['--anim-duration']).toBe('2s');
-    expect(result.style['--anim-delay']).toBe('0.5s');
-  });
-});
-
-describe('getDefaultAnimationDuration', () => {
-  it('returns 8 for slowZoom', () => {
-    expect(getDefaultAnimationDuration('slowZoom')).toBe(8);
-  });
-
-  it('returns 1 for fadeIn', () => {
-    expect(getDefaultAnimationDuration('fadeIn')).toBe(1);
-  });
-
-  it('returns 0.5 for zoomIn', () => {
-    expect(getDefaultAnimationDuration('zoomIn')).toBe(0.5);
-  });
-});
-
-describe('getTransitionClass', () => {
-  it('returns enter class', () => {
-    expect(getTransitionClass('fade', true)).toBe('transition-fade-enter');
-  });
-
-  it('returns exit class', () => {
-    expect(getTransitionClass('dissolve', false)).toBe('transition-dissolve-exit');
-  });
-
-  it('returns no class for cut', () => {
-    expect(getTransitionClass('cut', true)).toBe('');
-  });
-
-  it('maps PowerPoint-style transitions to supported visual classes', () => {
-    for (const type of TRANSITION_TYPES) {
-      if (type === 'cut') continue;
-      expect(getTransitionClass(type, true), type).toMatch(/^transition-.+-enter$/);
-      expect(getTransitionClass(type, false), type).toMatch(/^transition-.+-exit$/);
-    }
-  });
-
-  it('keeps the PowerPoint transition vocabulary visually expressive', () => {
-    const families = new Set(
-      TRANSITION_TYPES.flatMap((type) => {
-        const className = getTransitionClass(type, true);
-        const match = /^transition-(.+)-enter$/.exec(className);
-        return match ? [match[1]] : [];
-      }),
-    );
-
-    expect(families.size).toBeGreaterThanOrEqual(50);
-  });
-
-  it('maps aliases to stable visual families', () => {
-    expect(getTransitionClass('randomBars', true)).toBe('transition-randomBarsVertical-enter');
-    expect(getTransitionClass('flyThrough', true)).toBe('transition-flyThrough-enter');
-    expect(getTransitionClass('flythrough', true)).toBe('transition-flyThrough-enter');
-    expect(getTransitionClass('cube', true)).toBe('transition-cube-enter');
-    expect(getTransitionClass('ferris', true)).toBe('transition-ferrisWheel-enter');
-  });
-
-  it('honors transition directions for directional families', () => {
-    expect(getTransitionClass('wipe', true, 'right')).toBe('transition-wipeRight-enter');
-    expect(getTransitionClass('push', false, 'up')).toBe('transition-pushUp-exit');
-    expect(getTransitionClass('split', true, 'vertical')).toBe('transition-splitVertical-enter');
-    expect(getTransitionClass('blinds', false, 'vertical')).toBe('transition-blindsVertical-exit');
-  });
-});
-
-describe('getAnimationProgress', () => {
-  it('returns 0 before delay', () => {
-    const progress = getAnimationProgress({ type: 'fadeIn', delay: 1, duration: 2 }, 0.5, 5);
-    expect(progress).toBe(0);
-  });
-
-  it('returns 1 after completion', () => {
-    const progress = getAnimationProgress({ type: 'fadeIn', delay: 0, duration: 2 }, 3, 5);
-    expect(progress).toBe(1);
-  });
-
-  it('returns 0.5 at midpoint', () => {
-    const progress = getAnimationProgress({ type: 'fadeIn', delay: 0, duration: 2 }, 1, 5);
-    expect(progress).toBeCloseTo(0.5);
-  });
-});

package/src/__tests__/annotationCoercion.test.ts

@@ -1,243 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import {
-  coerceAnnotationValues,
-  parseTimeSeconds,
-  parseConnectionList,
-  KNOWN_BLOCK_META_KEYS,
-  BLOCK_META_KEY_DESCRIPTORS,
-} from '../markdown/annotationCoercion.js';
-import { TRANSITION_TYPES, TRANSITION_DIRECTIONS } from '../schemas/Transitions.js';
-
-describe('parseTimeSeconds', () => {
-  it('accepts bare seconds (integer)', () => {
-    expect(parseTimeSeconds('5')).toBe(5);
-  });
-
-  it('accepts bare seconds (decimal)', () => {
-    expect(parseTimeSeconds('5.5')).toBe(5.5);
-  });
-
-  it('accepts mm:ss', () => {
-    expect(parseTimeSeconds('01:30')).toBe(90);
-    expect(parseTimeSeconds('0:05')).toBe(5);
-    expect(parseTimeSeconds('10:00')).toBe(600);
-  });
-
-  it('accepts mm:ss.ms (fractional seconds)', () => {
-    expect(parseTimeSeconds('01:30.500')).toBeCloseTo(90.5, 6);
-    expect(parseTimeSeconds('02:30.5')).toBeCloseTo(150.5, 6);
-  });
-
-  it('accepts Nms (milliseconds)', () => {
-    expect(parseTimeSeconds('1500ms')).toBe(1.5);
-    expect(parseTimeSeconds('0ms')).toBe(0);
-  });
-
-  it('trims leading/trailing whitespace', () => {
-    expect(parseTimeSeconds('  90  ')).toBe(90);
-  });
-
-  it('rejects malformed input', () => {
-    expect(parseTimeSeconds('not-a-time')).toBeNull();
-    expect(parseTimeSeconds('99:bad')).toBeNull();
-    expect(parseTimeSeconds('')).toBeNull();
-    expect(parseTimeSeconds('  ')).toBeNull();
-  });
-
-  it('rejects seconds field >= 60', () => {
-    expect(parseTimeSeconds('1:60')).toBeNull();
-    expect(parseTimeSeconds('1:75')).toBeNull();
-  });
-});
-
-describe('parseConnectionList', () => {
-  it('parses a single bare target', () => {
-    expect(parseConnectionList('foo')).toEqual({
-      list: [{ target: 'foo' }],
-      warning: null,
-    });
-  });
-
-  it('parses target:type pairs', () => {
-    expect(parseConnectionList('foo:flow')).toEqual({
-      list: [{ target: 'foo', type: 'flow' }],
-      warning: null,
-    });
-  });
-
-  it('parses mixed bare + typed entries', () => {
-    expect(parseConnectionList('foo:veryImportant,bar:requires,baz:requires')).toEqual({
-      list: [
-        { target: 'foo', type: 'veryImportant' },
-        { target: 'bar', type: 'requires' },
-        { target: 'baz', type: 'requires' },
-      ],
-      warning: null,
-    });
-  });
-
-  it('trims whitespace around items', () => {
-    expect(parseConnectionList('foo, bar:flow , baz').list).toEqual([
-      { target: 'foo' },
-      { target: 'bar', type: 'flow' },
-      { target: 'baz' },
-    ]);
-  });
-
-  it('returns empty list for empty input', () => {
-    expect(parseConnectionList('')).toEqual({ list: [], warning: null });
-    expect(parseConnectionList('   ')).toEqual({ list: [], warning: null });
-  });
-
-  it('filters empty segments and warns', () => {
-    const result = parseConnectionList('a,,b');
-    expect(result.list).toEqual([{ target: 'a' }, { target: 'b' }]);
-    expect(result.warning).toContain('empty');
-  });
-
-  it('drops entries with empty target before colon', () => {
-    const result = parseConnectionList(':flow,foo');
-    expect(result.list).toEqual([{ target: 'foo' }]);
-    expect(result.warning).toContain('empty');
-  });
-
-  it('treats target:<empty> as a bare target (no type)', () => {
-    expect(parseConnectionList('foo:').list).toEqual([{ target: 'foo' }]);
-  });
-});
-
-describe('coerceAnnotationValues', () => {
-  it('routes known keys to blockMeta, unknown to metadata', () => {
-    const result = coerceAnnotationValues({
-      x: '400',
-      y: '200',
-      priority: 'high',
-      caption: 'hello',
-    });
-    expect(result.blockMeta).toEqual({ x: 400, y: 200 });
-    expect(result.metadata).toEqual({ priority: 'high', caption: 'hello' });
-    expect(result.warnings).toEqual([]);
-  });
-
-  it('coerces startTime and duration to seconds', () => {
-    const result = coerceAnnotationValues({
-      startTime: '01:30',
-      duration: '00:15',
-    });
-    expect(result.blockMeta).toEqual({ startTime: 90, duration: 15 });
-  });
-
-  it('coerces connectsTo into a BlockConnection list', () => {
-    const result = coerceAnnotationValues({
-      connectsTo: 'foo:veryImportant,bar:requires,baz:requires',
-    });
-    expect(result.blockMeta.connectsTo).toEqual([
-      { target: 'foo', type: 'veryImportant' },
-      { target: 'bar', type: 'requires' },
-      { target: 'baz', type: 'requires' },
-    ]);
-  });
-
-  it('drops malformed numbers with a warning', () => {
-    const result = coerceAnnotationValues({ x: 'not-a-number' });
-    expect(result.blockMeta.x).toBeUndefined();
-    expect(result.metadata).toEqual({});
-    expect(result.warnings.length).toBe(1);
-    expect(result.warnings[0]).toContain('x');
-  });
-
-  it('drops malformed time values with a warning', () => {
-    const result = coerceAnnotationValues({ startTime: '99:bad' });
-    expect(result.blockMeta.startTime).toBeUndefined();
-    expect(result.warnings.length).toBe(1);
-  });
-
-  it('preserves empty connection list without warning', () => {
-    const result = coerceAnnotationValues({ connectsTo: '' });
-    expect(result.blockMeta.connectsTo).toEqual([]);
-    expect(result.warnings).toEqual([]);
-  });
-
-  it('coerces transition metadata', () => {
-    const result = coerceAnnotationValues({
-      transition: 'random-bars',
-      transitionDuration: '850ms',
-      transitionDirection: 'left',
-    });
-
-    expect(result.blockMeta.transition).toEqual({
-      type: 'randomBars',
-      duration: 0.85,
-      direction: 'left',
-    });
-    expect(result.metadata).toEqual({});
-    expect(result.warnings).toEqual([]);
-  });
-
-  it('drops malformed transition values with warnings', () => {
-    const result = coerceAnnotationValues({
-      transition: 'sideways-fold',
-      transitionDuration: 'fast',
-      transitionDirection: 'diagonal',
-    });
-
-    expect(result.blockMeta.transition).toBeUndefined();
-    expect(result.metadata).toEqual({});
-    expect(result.warnings).toHaveLength(3);
-  });
-
-  it('emits a warning for connectsTo with empty segments', () => {
-    const result = coerceAnnotationValues({ connectsTo: 'a,,b' });
-    expect(result.blockMeta.connectsTo).toEqual([{ target: 'a' }, { target: 'b' }]);
-    expect(result.warnings.length).toBe(1);
-  });
-
-  it('handles an empty input map', () => {
-    expect(coerceAnnotationValues({})).toEqual({
-      blockMeta: {},
-      metadata: {},
-      warnings: [],
-    });
-  });
-});
-
-describe('KNOWN_BLOCK_META_KEYS', () => {
-  it('lists the expected typed keys', () => {
-    expect(Object.keys(KNOWN_BLOCK_META_KEYS).sort()).toEqual([
-      'connectsTo',
-      'duration',
-      'startTime',
-      'transition',
-      'transitionDirection',
-      'transitionDuration',
-      'x',
-      'y',
-    ]);
-  });
-});
-
-describe('BLOCK_META_KEY_DESCRIPTORS', () => {
-  it('describes exactly the keys in KNOWN_BLOCK_META_KEYS', () => {
-    const described = BLOCK_META_KEY_DESCRIPTORS.map((d) => d.key).sort();
-    expect(described).toEqual(Object.keys(KNOWN_BLOCK_META_KEYS).sort());
-  });
-
-  it('has no duplicate keys', () => {
-    const keys = BLOCK_META_KEY_DESCRIPTORS.map((d) => d.key);
-    expect(new Set(keys).size).toBe(keys.length);
-  });
-
-  it('gives each key either a closed value set or a format hint, never both', () => {
-    for (const d of BLOCK_META_KEY_DESCRIPTORS) {
-      expect(Boolean(d.values) !== Boolean(d.valueHint)).toBe(true);
-      expect(d.description.length).toBeGreaterThan(0);
-    }
-  });
-
-  it('sources transition value sets from the canonical vocabulary', () => {
-    const transition = BLOCK_META_KEY_DESCRIPTORS.find((d) => d.key === 'transition');
-    const direction = BLOCK_META_KEY_DESCRIPTORS.find((d) => d.key === 'transitionDirection');
-    expect(transition?.values).toBe(TRANSITION_TYPES);
-    expect(direction?.values).toBe(TRANSITION_DIRECTIONS);
-  });
-});

package/src/__tests__/applyNarrationTiming.test.ts

@@ -1,190 +0,0 @@
-import { describe, it, expect } from 'vitest';
-import { parseMarkdown } from '../markdown/parse';
-import { markdownToDoc, flattenRenderableBlocks } from '../doc/markdownToDoc';
-import { applyNarrationTiming } from '../doc/applyNarrationTiming';
-import { resolveAudioMapping } from '../doc/audioMapping';
-import { buildNarrationScript } from '../narration/script';
-import type { NarrationTimingJsonV3 } from '../narration/sidecar';
-import { MemoryContentContainer } from '../storage/ContentContainer';
-import type { Doc } from '../schemas/Doc';
-
-const MD = `{[audio src=audio/take.webm anchor=document]}
-
-# Intro
-
-Alpha beta gamma delta epsilon words for the intro block.
-
-# Middle
-
-Zeta eta theta iota kappa words for the middle block.
-
-# Ending
-
-Lambda mu nu xi omicron words for the ending block.
-`;
-
-function makeDoc(markdown = MD): Doc {
-  return markdownToDoc(parseMarkdown(markdown));
-}
-
-/** A v3 sidecar whose block ranges use the doc's real block ids. */
-function makeSidecar(doc: Doc, overrides?: Partial<NarrationTimingJsonV3>): NarrationTimingJsonV3 {
-  const script = buildNarrationScript(doc);
-  const bounds = [0, 10, 22, 30];
-  return {
-    version: 3,
-    sourceText: script.sourceText,
-    duration: 30,
-    bookmarks: [],
-    blocks: script.blocks.map((range, i) => ({
-      blockId: range.blockId,
-      ...(range.heading !== undefined ? { heading: range.heading } : {}),
-      blockIndex: i,
-      charStart: range.charStart,
-      charEnd: range.charEnd,
-      startSec: bounds[i],
-      endSec: bounds[i + 1],
-    })),
-    ...overrides,
-  };
-}
-
-async function containerWith(sidecar: NarrationTimingJsonV3, path = 'audio/take.webm') {
-  const container = new MemoryContentContainer();
-  await container.writeFile(path, new Uint8Array([1, 2, 3]), 'audio/webm');
-  await container.writeFile(
-    `${path}.timing.json`,
-    new TextEncoder().encode(JSON.stringify(sidecar)),
-    'application/json',
-  );
-  return container;
-}
-
-describe('applyNarrationTiming', () => {
-  it('re-times blocks from v3 sidecar ranges and owns doc.duration', async () => {
-    const doc = makeDoc();
-    const container = await containerWith(makeSidecar(doc));
-    const result = await applyNarrationTiming(doc, container);
-
-    expect(result.applied).toBe(true);
-    expect(result.clipSrc).toBe('audio/take.webm');
-    const flat = flattenRenderableBlocks(result.doc.blocks);
-    expect(flat[0].startTime).toBe(0);
-    expect(flat[0].duration).toBe(10);
-    expect(flat[1].startTime).toBe(10);
-    expect(flat[1].duration).toBe(12);
-    expect(flat[2].startTime).toBe(22);
-    expect(flat[2].duration).toBe(8);
-    expect(result.doc.duration).toBe(30);
-    // Input doc untouched.
-    expect(doc.blocks[0].startTime).not.toBe(10);
-  });
-
-  it('returns the doc unchanged when no narration clip or sidecar exists', async () => {
-    const doc = makeDoc('# Just\n\nSome text.\n');
-    const container = new MemoryContentContainer();
-    const result = await applyNarrationTiming(doc, container);
-    expect(result.applied).toBe(false);
-    expect(result.doc).toBe(doc);
-  });
-
-  it('honors author pins and records an info diagnostic on real conflict', async () => {
-    const pinned = makeDoc(MD.replace('# Middle', '# Middle {duration=3}'));
-    const container = await containerWith(makeSidecar(pinned));
-    const result = await applyNarrationTiming(pinned, container);
-
-    expect(result.applied).toBe(true);
-    const flat = flattenRenderableBlocks(result.doc.blocks);
-    // Pin wins (narration said 12s, pin says 3s).
-    expect(flat[1].duration).toBe(3);
-    const conflict = result.doc.diagnostics?.find((d) => d.code === 'narration-pin-conflict');
-    expect(conflict).toBeTruthy();
-    expect(conflict!.severity).toBe('info');
-    expect(conflict!.blockId).toBe(flat[1].id);
-  });
-
-  it('matches a renamed heading through text similarity', async () => {
-    const original = makeDoc();
-    const sidecar = makeSidecar(original);
-    // Author renames the middle heading after recording: id + heading drift,
-    // but the body text still matches.
-    const edited = makeDoc(MD.replace('# Middle', '# Renamed Midsection'));
-    const container = await containerWith(sidecar);
-    const result = await applyNarrationTiming(edited, container);
-
-    expect(result.applied).toBe(true);
-    const flat = flattenRenderableBlocks(result.doc.blocks);
-    expect(flat[1].startTime).toBe(10);
-    expect(flat[1].duration).toBe(12);
-  });
-
-  it('falls back to proportional timing for v1 sidecars narrating this doc', async () => {
-    const doc = makeDoc();
-    const script = buildNarrationScript(doc);
-    const container = await containerWith({
-      version: 3,
-      sourceText: script.sourceText,
-      duration: 30,
-      bookmarks: [],
-      blocks: [],
-    });
-    const result = await applyNarrationTiming(doc, container);
-
-    expect(result.applied).toBe(true);
-    const flat = flattenRenderableBlocks(result.doc.blocks);
-    expect(flat[0].startTime).toBe(0);
-    expect(flat[1].startTime).toBeGreaterThan(0);
-    expect(flat[2].startTime).toBeGreaterThan(flat[1].startTime);
-    const last = flat[flat.length - 1];
-    expect(last.startTime + last.duration).toBeCloseTo(30, 5);
-  });
-
-  it('does not apply a v1 sidecar from an unrelated take', async () => {
-    const doc = makeDoc();
-    const container = await containerWith({
-      version: 3,
-      sourceText: 'completely different narration about sailboats and harbors and tides',
-      duration: 30,
-      bookmarks: [],
-      blocks: [],
-    });
-    const result = await applyNarrationTiming(doc, container);
-    expect(result.applied).toBe(false);
-  });
-});
-
-describe('resolveAudioMapping with a narration take', () => {
-  it('applies narration timing and never double-maps the take into segments', async () => {
-    const doc = makeDoc();
-    const container = await containerWith(makeSidecar(doc));
-    const resolved = await resolveAudioMapping(doc, container);
-
-    const flat = flattenRenderableBlocks(resolved.blocks);
-    expect(flat[1].startTime).toBe(10);
-    expect(resolved.duration).toBe(30);
-    // The take plays through the media schedule (documentMedia), so it must
-    // NOT also appear as an audio segment — that would play it twice.
-    expect(resolved.audio.segments.some((s) => s.src === 'audio/take.webm')).toBe(false);
-  });
-
-  it('keeps classic per-block segment mapping for docs without narration', async () => {
-    const doc = makeDoc('# Intro\n\nAlpha beta gamma delta epsilon words for the intro block.\n');
-    const container = new MemoryContentContainer();
-    await container.writeFile('audio/clip.mp3', new Uint8Array([9]), 'audio/mpeg');
-    await container.writeFile(
-      'audio/clip.mp3.timing.json',
-      new TextEncoder().encode(
-        JSON.stringify({
-          sourceText: 'Alpha beta gamma delta epsilon words for the intro block.',
-          duration: 7,
-          bookmarks: [],
-        }),
-      ),
-      'application/json',
-    );
-    const resolved = await resolveAudioMapping(doc, container);
-    expect(resolved.audio.segments.length).toBe(1);
-    expect(resolved.audio.segments[0].src).toBe('audio/clip.mp3');
-    expect(resolved.duration).toBe(7);
-  });
-});