@litfamily/lithermes 1.0.8 → 1.0.9

package/assets/lithermes-plugin/skills/lit-typographic-motion/engine/presets.mjs

@@ -0,0 +1,170 @@
+// The three preset style bibles as data (MO-B-01..03), the auto-pick table
+// (MO-B-00), and the per-shot pass plan: seeds (MO-SH-01), event schedules
+// under the shared per-shot ceiling (MO-SH-03), and the one software-GL
+// downgrade formula (MO-SH-09).
+import { EVENTS, PASS_CAPS } from './constants.mjs';
+import { mulberry32, passSeed } from './util.mjs';
+
+export const PRESETS = Object.freeze({
+  'swiss-signal': {
+    id: 'swiss-signal',
+    palette: { background: '#E9EBE4', ink: '#0C0E13', bone: '#E9EBE4', signal: '#0F7A82', accent: '#D9A441', secondary: '#4B5058' },
+    roles: { text: 'ink', annotation: 'ink', emphasis: 'signal', rule: 'ink', accent: 'accent' },
+    passes: ['swiss-grid', 'dither'],
+    post: { bloom: 0.12, bloomThreshold: 0.85, bloomKnee: 0.4, bloomRadius: 0.6, halation: 0.04, ca: 0.6, grain: 0.035, vignette: 0.18 },
+    motion: { entrance: 'slam', entranceSec: 0.18, drift: 0 },
+    voices: { display: 'archivo', body: 'pretendard', machine: 'meslo', label: 'meslo' },
+  },
+  terminalcore: {
+    id: 'terminalcore',
+    palette: { background: '#05070A', panel: '#0C1116', ink: '#39FF6A', signal: '#39FF6A', alternate: '#2FB6FF', secondary: '#7C8B93' },
+    roles: { text: 'signal', annotation: 'secondary', emphasis: 'signal', rule: 'secondary', accent: null },
+    passes: ['terminal-ui', 'crt', 'dither', 'glitch'],
+    post: { bloom: 0.35, bloomThreshold: 0.8, bloomKnee: 0.5, bloomRadius: 0.55, halation: 0.06, ca: 0.9, grain: 0.03, vignette: 0.12 },
+    motion: { entrance: 'type-in', typeCps: 22, drift: 0 },
+    voices: { display: 'pixel', body: 'pixel', machine: 'meslo', label: 'silkscreen' },
+  },
+  tidal: {
+    id: 'tidal',
+    palette: { background: '#0E1420', ink: '#E8ECEF', stopA: '#124559', stopB: '#4C3B6E', accent: '#E07856', secondary: '#AEB7C0' },
+    roles: { text: 'ink', annotation: 'secondary', emphasis: 'ink', rule: 'secondary', accent: 'accent' },
+    passes: ['tidal-gradient', 'swiss-grid', 'glitch'],
+    post: { bloom: 0.2, bloomThreshold: 0.85, bloomKnee: 0.5, bloomRadius: 0.7, halation: 0.04, ca: 0.4, grain: 0.03, vignette: 0.22 },
+    motion: { entrance: 'drift', entranceSec: 2.4, drift: 1 },
+    voices: { display: 'archivo', body: 'pretendard', machine: 'meslo', label: 'meslo' },
+  },
+});
+
+// MO-B-00: first match wins; Latin at word boundaries, Korean at a token start.
+const PICK_ROWS = [
+  ['terminalcore', /\b(?:terminal|hacker|CRT)\b/i, /(?<![가-힣])(?:터미널|해커)/u],
+  ['tidal', /\b(?:gradient|wave|tide|calm)\b/i, /(?<![가-힣])(?:물결|파도|잔잔한|흐름)/u],
+];
+
+// A style counts as user-specified only when the user's own request names it;
+// a style the agent wrote into the brief is the agent's default choice.
+const STYLE_WORDS = { 'swiss-signal': /swiss[\s-]*signal|스위스/i, terminalcore: /terminal[\s-]*core|터미널\s*코어/i, tidal: /(?<![A-Za-z])tidal(?![A-Za-z])|타이달/i };
+
+export function pickPreset(brief, { request = '' } = {}) {
+  if (brief.style) {
+    if (!PRESETS[brief.style]) throw Object.assign(new Error(`unknown style "${brief.style}"; use swiss-signal, terminalcore or tidal`), { userError: true });
+    return { id: brief.style, reason: STYLE_WORDS[brief.style].test(request) ? 'user-specified' : 'agent default' };
+  }
+  const copy = [...(brief.text || []), brief.mood || '', brief.topic || ''].join(' ');
+  for (const [id, latin, korean] of PICK_ROWS) {
+    const hit = copy.match(latin) || copy.match(korean);
+    if (hit) return { id, reason: `agent default (the brief mentions "${hit[0]}"; auto-pick table, first match)` };
+  }
+  return { id: 'swiss-signal', reason: 'agent default (no terminal or tidal keyword in the brief)' };
+}
+
+export function terminalSignal(brief) {
+  return brief.signalHue === 'blue' ? '#2FB6FF' : '#39FF6A';
+}
+
+// Events that count toward MO-SH-03 for one shot, all inside the shot window.
+function scheduleShot(presetId, shot, index, shots, seedFor, fps) {
+  const events = [];
+  const hold = shot.end - shot.start;
+  const frameAt = (t) => Math.round(t * fps) / fps;
+  if (presetId === 'terminalcore') {
+    if (index === 0) events.push({ kind: 'boot-flicker', t: frameAt(shot.start), duration: 0.25 });
+    if (hold >= 1.8) {
+      const rng = mulberry32(seedFor('glitch'));
+      const t = frameAt(shot.start + hold * (0.45 + 0.2 * rng()));
+      events.push({ kind: 'glitch-hit', t, holdFrames: 2 });
+    }
+  }
+  if (presetId === 'tidal') {
+    events.push({ kind: 'surge', t: frameAt(shot.start + Math.min(0.1, hold / 4)), attack: 0.15, decay: 0.25 });
+    const longest = shots.reduce((best, s, i) => (s.end - s.start > shots[best].end - shots[best].start ? i : best), 0);
+    if (index === longest && hold >= 3 && shots.length > 1) {
+      const rng = mulberry32(seedFor('glitch'));
+      events.push({ kind: 'glitch-hit', t: frameAt(shot.start + hold * (0.55 + 0.15 * rng())), holdFrames: 2 });
+    }
+  }
+  return events;
+}
+
+export function maxEventsInWindow(events, windowSec = EVENTS.perShotWindowSec) {
+  const times = events.map((e) => e.t).sort((a, b) => a - b);
+  let worst = 0;
+  for (let i = 0; i < times.length; i++) {
+    let n = 0;
+    for (let j = i; j < times.length && times[j] - times[i] < windowSec - 1e-9; j++) n++;
+    worst = Math.max(worst, n);
+  }
+  return worst;
+}
+
+// Glitch hit geometry from the shot's PRNG, sampled once per hit (MO-SH-05).
+export function glitchHitGeometry(seed, hitIndex, areaCapPct = 12, sliceCount = 6) {
+  const rng = mulberry32((seed ^ Math.imul(hitIndex + 1, 0x9e3779b1)) >>> 0);
+  const slices = [];
+  const budget = (areaCapPct / 100) * 1080;
+  let used = 0;
+  for (let i = 0; i < sliceCount && used < budget; i++) {
+    const height = Math.min(budget - used, 8 + Math.floor(rng() * 34));
+    const y = 60 + Math.floor(rng() * (1080 - 120 - height));
+    const dx = (rng() < 0.5 ? -1 : 1) * (6 + Math.floor(rng() * 18));
+    slices.push([y, height, dx]);
+    used += height;
+  }
+  return { slices, areaPct: (used / 1080) * 100, rgbSplitPx: 2 };
+}
+
+export function planPasses({ presetId, timeline, runSeed, fps, software, brief = {} }) {
+  const preset = PRESETS[presetId];
+  const shots = timeline.filter((u) => u.kind === 'line' || u.kind === 'scene');
+  const passRanges = [];
+  const events = [];
+  const totalSec = shots.at(-1).end;
+  shots.forEach((shot, index) => {
+    const seedFor = (pass) => passSeed(runSeed, shot.sceneId, shot.shotIndex, pass);
+    const shotEvents = scheduleShot(presetId, shot, index, shots, seedFor, fps)
+      .map((e) => ({ ...e, sceneId: shot.sceneId, shotIndex: shot.shotIndex }));
+    if (maxEventsInWindow(shotEvents) > EVENTS.maxPerShotWindow) throw new Error(`event plan for ${shot.sceneId} exceeds MO-SH-03`);
+    events.push(...shotEvents);
+    const frameStart = Math.round(shot.start * fps);
+    const frameEnd = Math.round(shot.end * fps) - 1;
+    const hits = shotEvents.filter((e) => e.kind === 'glitch-hit');
+    const surges = shotEvents.filter((e) => e.kind === 'surge');
+    for (const pass of preset.passes) {
+      const seed = pass === 'swiss-grid' ? null : seedFor(pass);
+      let params;
+      if (pass === 'swiss-grid') params = { columns: 12, gutterPx: 24, marginPx: 96, baselinePx: 8, showGuides: false };
+      else if (pass === 'dither') params = { mode: 1, paletteSize: presetId === 'terminalcore' ? 6 : 12, pixelScale: presetId === 'terminalcore' ? 2 : 1, ditherStrength: presetId === 'terminalcore' ? 0.5 : 0.3 };
+      else if (pass === 'crt') {
+        const boot = shotEvents.some((e) => e.kind === 'boot-flicker');
+        params = {
+          scanlineFreq: 540, scanlineDepth: 0.22, curvature: 0.05, vignette: 0.3, triadMaskAmount: 0.12,
+          flickerAmp: 0.03, flickerFreqHz: 8, bootFlickerAmp: boot ? 0.06 : 0,
+          flickerAmpRealized: boot ? 0.06 : 0.03,
+          persistenceEnabled: !software, phosphorPersistence: software ? 0 : 0.15,
+        };
+      } else if (pass === 'glitch') {
+        const geometry = hits.map((_, i) => glitchHitGeometry(seed, i));
+        params = {
+          intensity: 0.35, sliceCount: 6, maxOffsetPx: 24, rgbSplitPx: 2, holdFrames: 2,
+          hitRatePerSec: presetId === 'tidal' ? 0.5 : 1.5, areaCapPct: 12,
+          hitRatePerSecRealized: Number((hits.length / Math.max(1e-6, shot.end - shot.start)).toFixed(4)),
+          hits: hits.map((h, i) => ({ t: h.t, frame: Math.round(h.t * fps), holdFrames: h.holdFrames, areaPct: Number(geometry[i].areaPct.toFixed(3)), slices: geometry[i].slices })),
+        };
+      } else if (pass === 'tidal-gradient') {
+        const octaves = software ? Math.max(3, Math.floor(4 / 2)) : 4;
+        params = {
+          paletteStopsHex: [preset.palette.stopA, preset.palette.stopB], flowSpeed: 0.06, warpAmount: 0.35, curlStrength: 0.4,
+          octaves, surgeOnHit: 0.5, surgeAttackSec: 0.15, surgeDecaySec: 0.25, surgeCapPerSec: 2,
+          ditherAmount: 0.02, surgeCountRealized: surges.length,
+          surges: surges.map((s) => ({ t: s.t, attack: s.attack, decay: s.decay })),
+        };
+      } else if (pass === 'terminal-ui') {
+        params = { layers: 1, compositedThrough: ['crt', 'dither'], meterCount: 2, logLineRateCharsPerSec: 22, wordTimingSource: 'reading-time', caretBlinkHz: 1.2 };
+      }
+      passRanges.push({ pass, frameStart, frameEnd, sceneId: shot.sceneId, shotIndex: shot.shotIndex, seed, params, downgraded: Boolean(software) });
+    }
+  });
+  return { passRanges, events, totalSec, signal: presetId === 'terminalcore' ? terminalSignal(brief) : preset.palette.signal };
+}
+
+export const GLITCH_CAPS = PASS_CAPS;

package/assets/lithermes-plugin/skills/lit-typographic-motion/engine/scenes.mjs

@@ -0,0 +1,242 @@
+// Original starter scenes. Each render(f) is a pure function of the frame
+// (shot-local time f.lt, progress f.p, beat length f.beat and the timeline's
+// own reveal units) and returns a display list in logical 1920x1080 px:
+// text elements, stroke text, flat graphics, hairline rules and post overrides.
+// Beats are anchored to the shot window and reveal starts, never to literal
+// frame numbers (MO-A-06). Only number-counter carries state (MO-A-05).
+import { clamp, ease, lerp, prog } from './util.mjs';
+import { eojeols } from './type.mjs';
+import { listItems } from './timeline.mjs';
+
+const LEFT = 120;
+const CONTENT_W = 1680;
+
+// Motion tokens per preset (MO-B-01..03), expressed against the shot window.
+function entrance(f, token) {
+  if (f.still) return { alpha: 1, scale: 1, dy: 0, landed: true };
+  if (token === 'drift') {
+    const alpha = prog(f.lt, 0, Math.min(1.2, f.hold * 0.4), ease.inOutSine);
+    const dy = lerp(24, 0, prog(f.lt, 0, Math.min(2.4, f.hold * 0.8), ease.inOutSine));
+    return { alpha, scale: 1, dy, landed: f.lt >= Math.min(1.2, f.hold * 0.4) };
+  }
+  const dur = f.tokens.entranceSec ?? 0.18;
+  const k = prog(f.lt, 0, dur, ease.slam);
+  return { alpha: k, scale: lerp(0.96, 1, k), dy: 0, landed: f.lt >= dur };
+}
+
+function typedCount(f, text) {
+  if (f.still) return Array.from(text).length;
+  const cps = f.tokens.typeCps || 22;
+  const chars = Array.from(text);
+  const shown = Math.floor(Math.max(0, f.lt) * cps);
+  if (!/[가-힣]/u.test(text)) return Math.min(chars.length, shown);
+  // Hangul types a whole 어절 at a time so a word never appears half-built.
+  let count = 0, typed = 0;
+  for (const word of text.split(/(\s+)/u)) {
+    const n = Array.from(word).length;
+    if (typed + n <= shown || /^\s+$/u.test(word)) { count += n; typed += n; } else break;
+  }
+  return count;
+}
+
+function annotation(f, text, x, y, extra = {}) {
+  return { id: `${f.shot.id}:note`, text, voice: 'machine', role: 'annotation', size: 24, weight: 400, x, y, align: 'left', alpha: extra.alpha ?? 1, trackingEm: 0.02 };
+}
+
+// One window title for the whole film: a label that changes at a cut leaves a
+// CRT-persistence ghost of the old text under the new one. The title is the
+// film's own name or nothing, and the shot index shows only when the brief asks.
+function terminalChrome(f) {
+  const status = f.showIndex ? `${String(f.shotNumber).padStart(2, '0')}/${String(f.shotCount).padStart(2, '0')}` : '';
+  return { window: [72, 64, 1776, 952], titleBar: 46, title: f.windowTitle, status, meters: [clamp(f.p), clamp((f.t) / f.duration)], caret: null };
+}
+
+function accentMark(f, x, y) {
+  if (!f.accent || f.still) return [];
+  const on = f.lt >= f.accent.from && f.lt < f.accent.to;
+  return on ? [{ id: `${f.shot.id}:accent`, x, y, w: 28, h: 28, role: 'accent', alpha: 1 }] : [];
+}
+
+const titleSlam = {
+  id: 'title-slam',
+  render(f) {
+    const text = f.shot.text;
+    const hangul = /[가-힣]/u.test(text);
+    const out = { texts: [], strokes: [], rects: [], rules: [], overrides: {} };
+    if (f.preset.id === 'terminalcore') {
+      const typed = typedCount(f, text);
+      out.terminal = terminalChrome(f);
+      out.texts.push({ id: f.shot.id, text, voice: 'display', role: 'text', fit: { maxWidth: 1540, max: hangul ? 108 : 150, min: 54, pixelGrid: hangul ? 9 : 0 }, x: 200, y: 560, align: 'left', alpha: 1, visibleChars: typed, trackingEm: 0 });
+      out.texts.push({ id: `${f.shot.id}:prompt`, text: '>', voice: 'machine', role: 'annotation', size: 72, weight: 400, x: 120, y: 540, alpha: 1, trackingEm: 0 });
+      out.terminal.caret = { after: f.shot.id, blinkHz: 1.2, t: f.lt, visibleAfterType: typed >= Array.from(text).length };
+      return out;
+    }
+    const e = entrance(f, f.tokens.entrance);
+    const widthStep = f.preset.id === 'swiss-signal' && !f.still && f.lt < (f.tokens.entranceSec ?? 0.18) / 2 ? 125 : 100;
+    out.texts.push({
+      id: f.shot.id, text, voice: 'display', role: 'text', weight: f.preset.id === 'tidal' ? 700 : 900, widthStep,
+      fit: { maxWidth: CONTENT_W, max: f.preset.id === 'tidal' ? 150 : (hangul ? 150 : 190), min: 64 },
+      x: LEFT, y: 590 + e.dy, align: 'left', alpha: e.alpha, scale: e.scale, trackingEm: hangul ? 0 : -0.02,
+    });
+    if (f.showIndex) out.texts.push(annotation(f, `${String(f.shotNumber).padStart(2, '0')} — ${String(f.shotCount).padStart(2, '0')}`, LEFT, 150, { alpha: e.alpha }));
+    if (f.preset.passes.includes('swiss-grid')) {
+      const len = f.still ? 1 : prog(f.lt, 0, 2 * f.beat, ease.outCubic);
+      out.rules.push({ id: `${f.shot.id}:rule`, x0: LEFT, y0: 660, x1: LEFT + 960 * len, y1: 660, width: 2, role: 'rule', alpha: 1 });
+      out.rules.push({ id: `${f.shot.id}:tick`, x0: LEFT, y0: 104, x1: LEFT + 64, y1: 104, width: 2, role: 'rule', alpha: 1 });
+    }
+    out.rects.push(...accentMark(f, LEFT + 980, 646));
+    return out;
+  },
+};
+
+const karaokeLine = {
+  id: 'karaoke-line',
+  render(f) {
+    const text = f.shot.text;
+    const words = eojeols(text);
+    const reveals = f.reveals;
+    const out = { texts: [], strokes: [], rects: [], rules: [], overrides: {} };
+    const starts = reveals.length === words.length ? reveals.map((r) => r.start - f.shot.start) : words.map((_, i) => (i * f.hold * 0.6) / words.length);
+    const wordState = words.map((_, i) => {
+      if (f.still) return { alpha: 1, dy: 0, current: false };
+      const k = prog(f.lt, starts[i], starts[i] + 0.12, ease.outCubic);
+      const next = i + 1 < starts.length ? starts[i + 1] : Infinity;
+      return { alpha: k, dy: lerp(14, 0, k), current: f.lt >= starts[i] && f.lt < next && i < words.length - 1 };
+    });
+    const terminal = f.preset.id === 'terminalcore';
+    if (terminal) out.terminal = terminalChrome(f);
+    out.texts.push({
+      id: f.shot.id, text, voice: terminal ? 'display' : 'body', role: 'text', weight: 700,
+      fit: { maxWidth: terminal ? 1560 : CONTENT_W - 40, max: terminal ? 90 : 128, min: 48, maxLines: 3, pixelGrid: terminal ? 9 : 0 },
+      x: terminal ? 200 : LEFT + 40, y: 570, align: 'left', alpha: 1, trackingEm: 0,
+      words: wordState.map((w) => ({ alpha: w.alpha, dy: w.dy, role: w.current ? 'emphasis' : 'text' })),
+    });
+    if (f.preset.passes.includes('swiss-grid')) {
+      out.rules.push({ id: `${f.shot.id}:margin`, x0: LEFT, y0: 430, x1: LEFT, y1: 430 + 190 * (f.still ? 1 : prog(f.lt, 0, f.beat, ease.outCubic)), width: 2, role: 'rule', alpha: 1 });
+    }
+    return out;
+  },
+};
+
+const kineticList = {
+  id: 'kinetic-list',
+  render(f) {
+    const items = listItems(f.shot.text);
+    const out = { texts: [], strokes: [], rects: [], rules: [], overrides: {} };
+    const terminal = f.preset.id === 'terminalcore';
+    if (terminal) out.terminal = terminalChrome(f);
+    const starts = f.reveals.length === items.length ? f.reveals.map((r) => r.start - f.shot.start) : items.map((_, i) => i * f.beat);
+    const rows = items.length;
+    const rowSize = Math.min(104, Math.floor(760 / (rows * 1.6)));
+    const top = 540 - ((rows - 1) * rowSize * 1.6) / 2;
+    out.block = { id: f.shot.id, lines: rows, lineHeight: 1.6 };
+    items.forEach((item, i) => {
+      const k = f.still ? 1 : prog(f.lt, starts[i], starts[i] + (f.tokens.entranceSec ?? 0.2), ease.slam);
+      const y = top + i * rowSize * 1.6 + rowSize * 0.35;
+      out.texts.push({ id: `${f.shot.id}:n${i}`, text: String(i + 1).padStart(2, '0'), voice: 'machine', role: 'annotation', size: 26, weight: 400, x: LEFT, y, alpha: k, trackingEm: 0.02 });
+      out.texts.push({ id: `${f.shot.id}:i${i}`, text: item, voice: terminal ? 'display' : 'body', role: i === rows - 1 && !f.still && f.lt < starts[i] + f.beat ? 'emphasis' : 'text', weight: 700, fit: { maxWidth: 1520, max: rowSize, min: 40, pixelGrid: terminal ? 9 : 0 }, x: 220 + lerp(-24, 0, k), y, alpha: k, trackingEm: 0, blockId: f.shot.id });
+      if (f.preset.passes.includes('swiss-grid') && i < rows - 1) {
+        out.rules.push({ id: `${f.shot.id}:sep${i}`, x0: LEFT, y0: y + rowSize * 0.55, x1: LEFT + 1560 * k, y1: y + rowSize * 0.55, width: 1.5, role: 'rule', alpha: k });
+      }
+    });
+    return out;
+  },
+};
+
+// Counts toward the brief's own number with a critically damped spring,
+// integrated on a fixed 1/fps grid from the shot start so a seek re-derives
+// exactly the state a sequential render carried (MO-A-05, MO-A-25).
+const numberCounter = {
+  id: 'number-counter',
+  stateful: true,
+  prerollMax: Infinity,
+  reset() { return { steps: 0, x: 0, v: 0 }; },
+  // Settles inside about 0.8 s; once within half a displayed unit it snaps, so
+  // the final number is exact and holds for the rest of the shot.
+  step(state, target, fps, decimals = 0) {
+    if (state.done) return { ...state, steps: state.steps + 1 };
+    const dt = 1 / fps, w = 10;
+    const a = w * w * (target - state.x) - 2 * w * state.v;
+    const v = state.v + a * dt;
+    const x = state.x + v * dt;
+    const close = Math.abs(target - x) < 0.5 * 10 ** -decimals && Math.abs(v) < 10 ** -decimals * fps;
+    return close ? { steps: state.steps + 1, x: target, v: 0, done: true } : { steps: state.steps + 1, x, v };
+  },
+  render(f) {
+    const { raw, target, decimals, suffix } = counterTarget(f.shot.text);
+    const value = f.still ? target : Math.min(target, Math.max(0, f.state?.x ?? 0));
+    const shown = formatLike(raw, value, decimals) + suffix;
+    const label = f.shot.text.replace(raw + suffix, '').replace(/\s+/g, ' ').trim();
+    const out = { texts: [], strokes: [], rects: [], rules: [], overrides: {} };
+    const terminal = f.preset.id === 'terminalcore';
+    if (terminal) out.terminal = terminalChrome(f);
+    const e = terminal ? { alpha: 1, scale: 1, dy: 0 } : entrance(f, f.tokens.entrance === 'drift' ? 'drift' : 'slam');
+    out.texts.push({ id: `${f.shot.id}:num`, text: shown, voice: 'display', role: 'text', weight: 900, fit: { maxWidth: 1400, max: 220, min: 80, sample: formatLike(raw, target, decimals) + suffix, pixelGrid: 0 }, x: LEFT, y: 520 + e.dy, align: 'left', alpha: e.alpha, trackingEm: 0 });
+    if (label) out.texts.push({ id: `${f.shot.id}:label`, text: label, voice: 'body', role: 'text', weight: 400, fit: { maxWidth: CONTENT_W, max: 64, min: 36, pixelGrid: terminal ? 9 : 0 }, x: LEFT, y: 680 + e.dy, align: 'left', alpha: e.alpha, trackingEm: 0 });
+    const ratio = target > 0 ? clamp(value / target) : 1;
+    out.rects.push({ id: `${f.shot.id}:bar`, x: LEFT, y: 760, w: Math.max(2, 1200 * ratio), h: 10, role: 'emphasis', alpha: e.alpha });
+    return out;
+  },
+};
+
+export function counterTarget(text) {
+  const match = String(text).match(/(\d[\d,]*(?:\.\d+)?)(%?)/);
+  const raw = match ? match[1] : '0';
+  return { raw, suffix: match ? match[2] : '', target: Number(raw.replace(/,/g, '')) || 0, decimals: (raw.split('.')[1] || '').length };
+}
+
+function formatLike(raw, value, decimals) {
+  const fixed = value.toFixed(decimals);
+  if (!raw.includes(',')) return fixed;
+  const [int, frac] = fixed.split('.');
+  return int.replace(/\B(?=(\d{3})+(?!\d))/g, ',') + (frac ? `.${frac}` : '');
+}
+
+const strokeSignature = {
+  id: 'stroke-signature',
+  render(f) {
+    const out = { texts: [], strokes: [], rects: [], rules: [], overrides: {} };
+    const chars = Array.from(f.shot.text);
+    const writeSec = Math.max(0.6, f.hold - f.beat);
+    const per = writeSec / Math.max(1, chars.length);
+    const charTimes = chars.map((_, i) => [f.shot.start + i * per, f.shot.start + (i + 1) * per]);
+    out.strokes.push({ id: f.shot.id, text: f.shot.text, font: 'script', size: 200, x: LEFT + 40, y: 600, width: 4, role: 'text', alpha: 1, charTimes, t: f.still ? Infinity : f.t });
+    if (f.preset.passes.includes('swiss-grid')) out.rules.push({ id: `${f.shot.id}:base`, x0: LEFT, y0: 660, x1: LEFT + 720, y1: 660, width: 1.5, role: 'rule', alpha: 1 });
+    if (f.preset.id === 'terminalcore') out.terminal = terminalChrome(f);
+    return out;
+  },
+};
+
+const endCard = {
+  id: 'end-card',
+  render(f) {
+    const text = f.shot.text;
+    const out = { texts: [], strokes: [], rects: [], rules: [], overrides: {} };
+    const terminal = f.preset.id === 'terminalcore';
+    const hangul = /[가-힣]/u.test(text);
+    if (terminal) {
+      out.terminal = terminalChrome(f);
+      const typed = typedCount(f, text);
+      out.texts.push({ id: f.shot.id, text, voice: 'display', role: 'text', fit: { maxWidth: 1540, max: hangul ? 90 : 120, min: 54, maxLines: 2, pixelGrid: hangul ? 9 : 0 }, x: 200, y: 560, align: 'left', alpha: 1, visibleChars: typed, trackingEm: 0 });
+      out.texts.push({ id: `${f.shot.id}:prompt`, text: '>', voice: 'machine', role: 'annotation', size: 64, weight: 400, x: 120, y: 544, alpha: 1, trackingEm: 0 });
+      out.terminal.caret = { after: f.shot.id, blinkHz: 1.2, t: f.lt, visibleAfterType: typed >= Array.from(text).length };
+    } else {
+      const e = entrance(f, f.tokens.entrance);
+      out.texts.push({ id: f.shot.id, text, voice: 'display', role: 'text', weight: 700, fit: { maxWidth: CONTENT_W, max: hangul ? 120 : 132, min: 56, maxLines: 2 }, x: LEFT, y: 600 + e.dy, align: 'left', alpha: e.alpha, scale: e.scale, trackingEm: hangul ? 0 : -0.01 });
+      if (f.reduced && f.firstLine && f.firstLine !== text) {
+        out.texts.push({ id: `${f.shot.id}:title`, text: f.firstLine, voice: 'body', role: 'annotation', weight: 700, fit: { maxWidth: CONTENT_W, max: 44, min: 32 }, x: LEFT, y: 360, align: 'left', alpha: 1, trackingEm: 0 });
+      }
+      if (f.preset.passes.includes('swiss-grid')) out.rules.push({ id: `${f.shot.id}:rule`, x0: LEFT, y0: 420, x1: LEFT + 240, y1: 420, width: 2, role: 'rule', alpha: 1 });
+    }
+    return out;
+  },
+};
+
+export const SCENE_MODULES = Object.freeze({
+  'title-slam': titleSlam,
+  'karaoke-line': karaokeLine,
+  'kinetic-list': kineticList,
+  'number-counter': numberCounter,
+  'stroke-signature': strokeSignature,
+  'end-card': endCard,
+});