quoxcli 0.2.0 → 0.4.0

package/vendor/dragonlab/design/lucid/recovery/render.mjs

@@ -0,0 +1,121 @@
+/** The SVG is the anatomy source. Q's existing sampler and packer stay intact. */
+import {movePoint} from './motion.mjs';
+import { makeField, fieldToCells } from '../../../vendor/quox-dragon/qart.js';
+import { flattenPath, sampleShape } from '../../stage3/svg-coverage.js';
+
+const CUTOUTS = new Set(['eye-socket', 'pupil', 'nostril', 'mouth-line']);
+const IRIS = new Set(['iris', 'iris-light']);
+const EYE = new Set(['eye-socket','eye-rim','iris','iris-light','pupil','eye-glint','lower-lid']);
+const attr = (tag, key) => tag.match(new RegExp(`(?:^|\\s)${key}="([^"]*)"`))?.[1];
+const rgb = hex => [1,3,5].map(i => parseInt(hex.slice(i,i+2),16));
+
+export function parseMaster(svg) {
+  if (!svg.includes('viewBox="0 0 800 480"')) throw new Error('Expected 800×480 master.');
+  const ids = new Set(), groups=new Map(), stack=[];
+  for(const [tag] of svg.matchAll(/<g\s[^>]*>|<\/g>|<path\s[^>]*\/>/g)){
+    if(tag.startsWith('<g '))stack.push(attr(tag,'id'));
+    else if(tag==='</g>')stack.pop();
+    else groups.set(attr(tag,'id'),stack.at(-1));
+  }
+  const paths = [...svg.matchAll(/<path\s[^>]*\/>/g)].map(([tag]) => {
+    const id = attr(tag,'id'), d = attr(tag,'d');
+    const stroke = attr(tag,'stroke'), fill = attr(tag,'fill');
+    if (!id || ids.has(id) || !d) throw new Error('Every path needs a unique id and geometry.');
+    ids.add(id);
+    const colour = stroke || fill;
+    if (!/^#[0-9a-f]{6}$/i.test(colour)) throw new Error(`Unsupported colour: ${id}`);
+    return {id, group:groups.get(id), polygons:flattenPath(d), rgb:rgb(colour), stroke:stroke ? Number(attr(tag,'stroke-width')) : 0};
+  });
+  if (!paths.length || !ids.has('iris') || !ids.has('tail-mass')) throw new Error('Incomplete master.');
+  return paths;
+}
+
+export function renderMaster(paths, {cols=39, rows=11, mono=false, eyes='white', face={}, motion=null}={}) {
+  if (![cols,rows].every(Number.isSafeInteger) || cols<28 || rows<10 || cols>200 || rows>72)
+    throw new RangeError('Full dragon requires 28–200 columns and 10–72 rows.');
+  if (!['white','violet'].includes(eyes)) throw new RangeError('Eyes must be white or violet.');
+  const W=cols*2, H=rows*4, field=makeField(W,H);
+  const colours=new Uint8Array(W*H*3), priorities=new Uint8Array(W*H);
+  const labels=new Array(W*H).fill('');
+  // Fit the authored ink bounds, rather than its generously padded SVG canvas.
+  const points=paths.flatMap(p=>p.polygons.flat());
+  const xs=points.map(p=>p[0]),ys=points.map(p=>p[1]);
+  const left=Math.min(...xs),top=Math.min(...ys);
+  const width=Math.max(...xs)-left,height=Math.max(...ys)-top;
+  const scale=Math.min((W-4)/width,(H-4)/height);
+  const geometry={W,H,scale,ox:(W-width*scale)/2-left*scale,oy:(H-height*scale)/2-top*scale};
+  const gx=face.gx??0,gy=face.gy??0,open=face.open??1;
+  if(![gx,gy,open].every(Number.isFinite)||Math.abs(gx)>1||Math.abs(gy)>1||open<0.1||open>1.25)throw new RangeError('Invalid eye pose.');
+  const coverage=path => {
+    const result=[];
+    let polygons=['iris','pupil'].includes(path.id) ? path.polygons.map(poly=>poly.map(([x,y])=>[x+(path.id==='pupil'?gx*12:0),177+(y-177)*open+(path.id==='pupil'?gy*5*open:0)])) : path.polygons;
+    if(motion)polygons=polygons.map(poly=>poly.map(([x,y])=>movePoint(path.group,x,y,motion)));
+    sampleShape(polygons,{...geometry,stroke:path.stroke},(x,y)=>result.push(y*W+x));
+    // At compact resolution a sub-dot pupil can otherwise disappear as the
+    // head moves between samples. Keep one centre dot inside the eye white.
+    if(path.id==='pupil'&&!result.length&&open>.3){
+      const [cx,cy]=movePoint(path.group,178+gx*12,177+gy*5*open,motion);
+      const px=geometry.ox+cx*scale,py=geometry.oy+cy*scale;
+      let best=-1,distance=Infinity;
+      for(let i=0;i<labels.length;i++)if(labels[i]==='iris'&&field.v[i]){
+        const d=(i%W+.5-px)**2+(Math.floor(i/W)+.5-py)**2;
+        if(d<distance){best=i;distance=d;}
+      }
+      if(best>=0)result.push(best);
+    }
+    return result;
+  };
+  const owned=new Set();
+  const socket=paths.find(p=>p.id==='eye-socket');
+  for (const i of coverage(socket)) owned.add(Math.floor((i%W)/2)+Math.floor(Math.floor(i/W)/4)*cols);
+  for (const path of paths) {
+    if (path.id==='eye-socket') {
+      // Same whole-cell ownership principle as Q's eyes: remove body under
+      // every socket cell before painting the eye; no purple body bleed.
+      for (const cell of owned) {
+        const x=(cell%cols)*2,y=Math.floor(cell/cols)*4;
+        for(let dy=0;dy<4;dy++)for(let dx=0;dx<2;dx++) {
+          const i=(y+dy)*W+x+dx;field.v[i]=0;labels[i]='';priorities[i]=0;
+        }
+      }
+    }
+    for (const i of coverage(path)) {
+      const erase=CUTOUTS.has(path.id);
+      field.v[i]=erase?0:1;
+      colours.set(IRIS.has(path.id) ? (eyes==='white' ? [242,246,255] : [182,107,255]) : path.id==='eye-rim' ? [242,246,255] : path.rgb,i*3);labels[i]=path.id;
+      priorities[i]=IRIS.has(path.id)?5:EYE.has(path.id)?3:1;
+    }
+  }
+  // Binary coverage means mono and colour produce identical Braille masks.
+  const frame=fieldToCells(field,{color:false,quant:false});
+  let irisCells=0, eyeCutoutDots=0, pupilDots=labels.filter(x=>x==='pupil').length, ink=0;
+  for(let y=0;y<rows;y++)for(let x=0;x<cols;x++) {
+    const cell=frame[y][x];cell.bg=null;
+    let winner=-1,rank=-1;
+    for(let dy=0;dy<4;dy++)for(let dx=0;dx<2;dx++) {
+      const i=(y*4+dy)*W+x*2+dx;
+      if(field.v[i] && priorities[i]>rank){winner=i;rank=priorities[i];}
+      if(owned.has(y*cols+x)&&!field.v[i])eyeCutoutDots++;
+    }
+    if(winner>=0) {
+      ink++;
+      if(IRIS.has(labels[winner]))irisCells++;
+      cell.rgb=mono?null:Array.from(colours.slice(winner*3,winner*3+3));
+    }
+  }
+  return {frame,metrics:{cols,rows,ink,irisCells,eyeOwnedCells:owned.size,eyeCutoutDots,pupilDots,scale},geometry};
+}
+
+/** Exact emitted Braille masks, not a font screenshot or a source SVG raster. */
+export function cellsSvg(frame, {label='Lucid · actual emitted dots',dot=4}={}) {
+  const cols=frame[0].length,rows=frame.length,width=cols*dot*2+48,height=rows*dot*4+76;
+  const bits=[[1,8],[2,16],[4,32],[64,128]];
+  let body=`<rect width="100%" height="100%" fill="#080d19"/><text x="24" y="27" fill="#a7b6cc" font-family="monospace" font-size="13">${label.replaceAll('&','&amp;').replaceAll('<','&lt;')}</text>`;
+  for(let y=0;y<rows;y++)for(let x=0;x<cols;x++) {
+    const cell=frame[y][x],mask=cell.ch===' '?0:cell.ch.codePointAt(0)-0x2800;
+    const fill=cell.rgb?`rgb(${cell.rgb.join(',')})`:'#d7e1ef';
+    for(let dy=0;dy<4;dy++)for(let dx=0;dx<2;dx++)if(mask&bits[dy][dx])
+      body+=`<circle cx="${24+(x*2+dx+.5)*dot}" cy="${50+(y*4+dy+.5)*dot}" r="${dot*.39}" fill="${fill}"/>`;
+  }
+  return `<svg xmlns="http://www.w3.org/2000/svg" width="${width}" height="${height}" viewBox="0 0 ${width} ${height}">${body}</svg>\n`;
+}

package/vendor/dragonlab/design/lucid/recovery/review.mjs

@@ -0,0 +1,68 @@
+#!/usr/bin/env node
+import {readFile,writeFile,mkdir} from 'node:fs/promises';
+import {resolve} from 'node:path';
+import {parseMaster,renderMaster,cellsSvg} from './render.mjs';
+import {LUCID_CLIPS,renderLucidCharacter,renderLucidStory,STORY_DURATION} from './character.mjs';
+import {artSlot,composeMessage} from './layout.mjs';
+import {cellsToAnsi} from '../../../vendor/quox-dragon/qart.js';
+
+const args=process.argv.slice(2);
+function option(name,fallback){const i=args.indexOf(name);return i<0?fallback:args[i+1];}
+const allowed=new Set(['--cols','--rows','--mono','--export','--verify','--help','--message','--eyes','--terminal-cols','--terminal-rows','--large','--intro','--scene','--at','--watch','--list','--still','--attach']);
+for(let i=0;i<args.length;i++) {
+  if(!allowed.has(args[i]))throw new Error(`Unknown option: ${args[i]}`);
+  if(['--cols','--rows','--export','--message','--eyes','--terminal-cols','--terminal-rows','--scene','--at'].includes(args[i])) {
+    if(!args[i+1]||args[i+1].startsWith('--'))throw new Error(`Missing value for ${args[i]}`);
+    i++;
+  }
+}
+if(args.includes('--help')) {
+  console.log('Lucid full-body SVG review (Node 20+, no install)\n  node design/lucid/recovery/review.mjs [--message "Your message"] [--eyes white|violet] [--mono]\n  --attach        Arrival followed by quiet idle, requires TTY\n  --still         Freeze the whole character at its scene pose\n  --large         Large still for deck review\n  --intro         Large animated story, requires TTY\n  --watch         Companion-sized story, requires TTY\n  --scene ID --at MS  Inspect one expression/power\n  --list          List clips\n  --export DIR   Write exact-cell SVG/JSON/TXT previews at compact and large sizes\n  --verify       Check deterministic masks, safe margins and white default eyes');
+  process.exit(0);
+}
+if(args.includes('--list')){console.log(LUCID_CLIPS.map(c=>c.id.padEnd(16)+c.title).join('\n'));process.exit(0);}
+const source=await readFile(new URL('./lucid-master.svg',import.meta.url),'utf8');
+const paths=parseMaster(source);
+if(args.includes('--verify')) {
+  const {verify}=await import('./verify.mjs');verify(paths);process.exit(0);
+}
+const destination=option('--export',null);
+if(destination) {
+  await mkdir(resolve(destination),{recursive:true});
+  const metrics=[];
+  for(const [cols,rows] of [[28,10],[36,10],[40,12],[48,14],[88,25]])for(const mono of [false,true]) {
+    const result=renderMaster(paths,{cols,rows,mono}),stem=`lucid-${cols}x${rows}-${mono?'mono':'colour'}`;
+    const label=`LUCID / ${cols}x${rows} / ${mono?'MONO':'COLOUR'} / exact emitted Braille dots`;
+    await writeFile(resolve(destination,stem+'.svg'),cellsSvg(result.frame,{label}));
+    await writeFile(resolve(destination,stem+'.json'),JSON.stringify(result,null,2)+'\n');
+    await writeFile(resolve(destination,stem+'.txt'),cellsToAnsi(result.frame).join('\n')+'\n');
+    metrics.push({...result.metrics,mono});
+  }
+  await writeFile(resolve(destination,'metrics.json'),JSON.stringify(metrics,null,2)+'\n');
+  console.log(`Exported actual cells to ${resolve(destination)}`);
+} else {
+  const terminalCols=Number(option('--terminal-cols',process.stdout.columns||80));
+  const terminalRows=Number(option('--terminal-rows',process.stdout.rows||24));
+  const slot=artSlot(terminalCols,terminalRows);
+  const large=args.includes('--large')||args.includes('--intro');
+  const cols=Number(option('--cols',large?Math.min(120,terminalCols-4):slot.cols)),rows=Number(option('--rows',large?Math.min(36,terminalRows-4):slot.rows));
+  const explicit=large||args.includes('--cols')||args.includes('--rows');
+  if(explicit&&(cols>terminalCols-4||rows>terminalRows-2))
+    throw new Error('Requested art exceeds terminal margins. Widen the terminal or reduce --cols/--rows.');
+  const message=option('--message','LUCID\nAware. Attentive. Present.');
+  if(!slot.showArt&&!explicit) {
+    console.log(composeMessage(null,message,{terminalCols}).join('\n'));
+  } else {
+    const opts={cols,rows,mono:args.includes('--mono'),eyes:option('--eyes','white'),still:args.includes('--still')};
+    const scene=option('--scene',args.includes('--attach')?(large?'deck-arrival':'attach'):'idle'),at=Number(option('--at',0));
+    const result=renderLucidCharacter(paths,scene,at,opts);
+    if(!result.ok)throw new Error(result.code);
+    if(args.includes('--watch')||args.includes('--intro')||args.includes('--attach')){
+      const {watch}=await import('./watch.mjs');
+      await watch(paths,opts,{terminalCols,terminalRows,scene:args.includes('--scene')||args.includes('--attach')?scene:null,arrival:args.includes('--attach'),large,message:args.includes('--message')?message:null});
+    }else{
+      const caption=args.includes('--message')?message:'LUCID\n'+result.caption;
+      console.log((large?[...cellsToAnsi(result.frame),caption]:composeMessage(result.frame,caption,{terminalCols})).join('\n'));
+    }
+  }
+}

package/vendor/dragonlab/design/lucid/recovery/verify.mjs

@@ -0,0 +1,84 @@
+import assert from 'node:assert/strict';
+import {artSlot,composeMessage,wrapMessage,cleanText} from './layout.mjs';
+import {LUCID_CLIPS,renderLucidCharacter,renderLucidStory,STORY_DURATION} from './character.mjs';
+import {motionAt,movePoint,MOTION_PERIOD} from './motion.mjs';
+import {renderMaster} from './render.mjs';
+
+export function verify(paths) {
+  for(const [cols,rows] of [[28,10],[36,10],[40,12],[48,14],[88,25]]) {
+    const colour=renderMaster(paths,{cols,rows}),mono=renderMaster(paths,{cols,rows,mono:true});
+    assert.deepEqual(colour,renderMaster(paths,{cols,rows}),'Deterministic render');
+    assert.deepEqual(colour.frame.map(r=>r.map(c=>c.ch)),mono.frame.map(r=>r.map(c=>c.ch)),'Mono must retain geometry');
+    assert(colour.metrics.irisCells>0,'Actual iris must survive rasterisation');
+    assert(colour.metrics.pupilDots>0,'Round pupil survives');
+    assert(colour.metrics.eyeCutoutDots>0,'Eye needs negative space');
+    assert(colour.frame.flat().some(c=>c.rgb&&c.rgb.every(v=>v>=240)),'Emitted white eye foreground');
+    for(let y=0;y<rows;y++)for(let x=0;x<cols;x++) {
+      const c=colour.frame[y][x];
+      assert(c.bg===null,'Transparent terminal background');
+      assert(c.ch===' '||(c.ch.codePointAt(0)>=0x2800&&c.ch.codePointAt(0)<=0x28ff),'Braille only');
+      const mask=c.ch===' '?0:c.ch.codePointAt(0)-0x2800;
+      if(x===0)assert.equal(mask&71,0,'Left dot margin');
+      if(x===cols-1)assert.equal(mask&184,0,'Right dot margin');
+      if(y===0)assert.equal(mask&9,0,'Top dot margin');
+      if(y===rows-1)assert.equal(mask&192,0,'Bottom dot margin');
+    }
+    console.log(`${cols}x${rows}: ${colour.metrics.ink} ink cells; ${colour.metrics.irisCells} iris cells; verified`);
+  }
+  for(const [w,h] of [[64,24],[80,24],[100,30],[120,40],[52,20],[80,18]]) {
+    const slot=artSlot(w,h);
+    assert(slot.cols*slot.rows<w*h/4,'Art allocation below quarter-screen');
+    const frame=slot.showArt?renderMaster(paths,slot).frame:null;
+    const message='Lucid is watching. A change needs your attention. The rest of your terminal stays available.';
+    const lines=composeMessage(frame,message,{terminalCols:w});
+    assert(lines.every(l=>cleanText(l).length<=w),'No line wrapping beyond viewport');
+    if(frame)assert(lines.length===slot.rows,'Short message fits beside dragon');
+    console.log(`Layout ${w}x${h}: ${slot.showArt?slot.cols+'x'+slot.rows:'text fallback'}`);
+  }
+  assert.equal(cleanText('hello\x1b[2Jworld'),'helloworld');
+  assert(wrapMessage('界界界',4).length===2,'Wide characters respect cells');
+  for(const [cols,rows] of [[31,11],[39,11],[49,14],[88,25],[120,36]]){
+    for(const clip of LUCID_CLIPS){
+      const r=renderLucidCharacter(paths,clip.id,clip.duration/2,{cols,rows});
+      assert(r.ok&&r.frame.length===rows&&r.frame.every(row=>row.length===cols));
+      if(clip.power)assert(r.effectCells>0,'Visible power study');
+    }
+  }
+  assert(renderLucidStory(paths,STORY_DURATION).ok);
+  assert(!renderLucidCharacter(paths,'missing',0).ok);
+  console.log(`${LUCID_CLIPS.length} acting clips verified at companion and intro sizes`);
+  assert.deepEqual(motionAt(0),motionAt(MOTION_PERIOD),'Seamless motion loop');
+  for(const t of [0,1200,2400,3200,5200,9000]){
+    const motion=motionAt(t);
+    for(const group of ['body','near-feet','far-feet'])assert.deepEqual(movePoint(group,300,380,motion),[300,380],'Planted torso and feet');
+    assert.deepEqual(movePoint('head',178,177,motion),movePoint('eye',178,177,motion),'Face stays attached');
+    for(const [cols,rows] of [[28,10],[31,11],[39,11],[49,14],[120,36]]){
+      const r=renderMaster(paths,{cols,rows,motion});
+      assert(r.metrics.pupilDots>0,`Pupil survives motion at ${cols}x${rows}, ${t}`);
+      assert.equal(r.metrics.scale,renderMaster(paths,{cols,rows}).metrics.scale,'No camera breathing');
+    }
+  }
+  for(const scene of ['attach','deck-arrival']){
+    const duration=scene==='attach'?3200:4400;
+    for(const [cols,rows] of [[31,11],[49,14],[120,36],[200,72]]){
+      const end=renderLucidCharacter(paths,scene,duration,{cols,rows});
+      assert.deepEqual(end.frame,renderLucidCharacter(paths,'idle',0,{cols,rows}).frame,'Exact idle handoff');
+      for(const t of [0,500,1000,1700,2400,3100]){
+        const r=renderLucidCharacter(paths,scene,t,{cols,rows});
+        assert(r.metrics.pupilDots>0,'Arrival pupil');
+        for(let y=0;y<rows;y++)for(let x=0;x<cols;x++){
+          const mask=r.frame[y][x].ch===' '?0:r.frame[y][x].ch.codePointAt(0)-0x2800;
+          if(x===0)assert.equal(mask&71,0);if(x===cols-1)assert.equal(mask&184,0);
+          if(y===0)assert.equal(mask&9,0);if(y===rows-1)assert.equal(mask&192,0);
+        }
+      }
+    }
+  }
+  for(const c of LUCID_CLIPS)assert.deepEqual(
+    renderLucidCharacter(paths,c.id,0,{still:true}).frame,
+    renderLucidCharacter(paths,c.id,c.duration*.7,{still:true}).frame,'Still freezes '+c.id);
+  assert.deepEqual(renderLucidStory(paths,0,{still:true}).frame,renderLucidStory(paths,11000,{still:true}).frame,'Still story');
+  console.log('Arrival bounds, pupils, idle handoff and complete still mode verified');
+  console.log('Quiet motion: loop, planted feet, attached eye and compact pupils verified');
+  console.log('Technical checks passed. Artistic acceptance remains a human judgment.');
+}

package/vendor/dragonlab/design/lucid/recovery/watch.mjs

@@ -0,0 +1,56 @@
+import {performance} from 'node:perf_hooks';
+import {LUCID_CLIPS,renderLucidCharacter,renderLucidStory,STORY_DURATION} from './character.mjs';
+import {composeMessage} from './layout.mjs';
+import {cellsToAnsi} from '../../../vendor/quox-dragon/qart.js';
+
+/** One bounded performance. No alternate screen or full-screen clearing. */
+export async function watch(paths,options,config){
+  if(!process.stdout.isTTY||!process.stdin.isTTY)throw new Error('--watch/--intro needs an interactive terminal. Use --scene and --at for snapshots.');
+  const {terminalCols,terminalRows,scene,large,message}=config;
+  const clip=scene?LUCID_CLIPS.find(c=>c.id===scene):null;
+  const duration=(clip?.duration??STORY_DURATION)+(config.arrival?6000:0);
+  const realCols=process.stdout.columns,realRows=process.stdout.rows;
+  const start=performance.now();
+  const render=t=>{
+    const r=scene?renderLucidCharacter(paths,scene,t,options):renderLucidStory(paths,t,options);
+    if(!r?.ok)throw new Error(r?.code??'Invalid story frame');
+    const caption=message??'LUCID · '+r.clip+'\n'+r.caption;
+    return large?[...cellsToAnsi(r.frame),...caption.split('\n')]:composeMessage(r.frame,caption,{terminalCols});
+  };
+  // Reserve enough lines for captions too; keep within the real terminal.
+  const height=options.rows+3;
+  if(height>=terminalRows)throw new Error('Animation needs room for its caption; reduce --rows.');
+  let ended=false,drawn=false,timer,resolveDone,rejectDone;
+  const wasRaw=Boolean(process.stdin.isRaw);
+  const done=new Promise((resolve,reject)=>{resolveDone=resolve;rejectDone=reject;});
+  const cleanup=(error)=>{
+    if(ended)return;ended=true;clearInterval(timer);
+    process.stdin.off('data',key);process.stdout.off('resize',resized);
+    process.off('SIGINT',sigint);process.off('SIGTERM',sigterm);
+    process.stdin.setRawMode(wasRaw);process.stdin.pause();
+    if(drawn)process.stdout.write(`\x1b[${height}B\r`);
+    process.stdout.write('\x1b[0m\x1b[?25h');
+    error?rejectDone(error):resolveDone();
+  };
+  const key=data=>{if(data.includes(3)||data.toString().includes('q'))cleanup();};
+  const sigint=()=>cleanup(),sigterm=()=>cleanup();
+  const resized=()=>cleanup(new Error('Terminal resized; rerun for the new art slot.'));
+  try{
+    process.stdin.setRawMode(true);process.stdin.resume();process.stdin.on('data',key);
+    process.stdout.on('resize',resized);process.on('SIGINT',sigint);process.on('SIGTERM',sigterm);
+    process.stdout.write('\x1b[?25l');
+    // Allocate the block once; each frame replaces only these lines.
+    process.stdout.write('\n'.repeat(height)+`\x1b[${height}A`);drawn=true;
+    const tick=()=>{
+      try{
+        if(process.stdout.columns!==realCols||process.stdout.rows!==realRows)return resized();
+        const t=Math.min(performance.now()-start,duration-1),lines=render(t);
+        if(lines.length>height)throw new Error('Message exceeds the animation block; use a shorter message or a static preview.');
+        process.stdout.write(Array.from({length:height},(_,i)=>'\r\x1b[2K'+(lines[i]??'')+'\n').join('')+`\x1b[${height}A`);
+        if(performance.now()-start>=duration)cleanup();
+      }catch(e){cleanup(e);}
+    };
+    tick();if(!ended)timer=setInterval(tick,1000/12);
+    await done;
+  }catch(e){cleanup(e);await done;}
+}

package/vendor/dragonlab/design/seer/v1/seer-master.svg

@@ -0,0 +1,53 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 480">
+<title>Seer — jade coil, golden belly and red mane</title>
+<g id="far-feet">
+<path id="far-front-leg" fill="#287c50" d="M562 253 Q605 244 616 267 L614 284 L631 287 Q641 297 630 302 L603 298 Q593 291 597 274 L575 279 Z"/>
+<path id="far-front-claws" fill="#ffe6a0" d="M613 286 L621 282 L624 296 L616 296 Z M624 289 L632 288 L636 300 L628 300 Z"/>
+<path id="far-back-leg" fill="#287c50" d="M257 303 Q230 279 205 291 L186 310 L173 307 Q161 310 168 320 L188 330 L218 310 L246 324 Z"/>
+<path id="far-back-claws" fill="#ffe6a0" d="M168 309 L181 307 L177 319 L168 319 Z M183 314 L194 312 L188 326 L180 323 Z"/>
+</g>
+<g id="body">
+<path id="spine-fins" fill="#dd5946" d="M488 197 L461 203 L490 220 L470 232 L510 243 L493 258 L537 268 L530 285 L562 280 L559 252 L532 229 Z M393 289 L373 265 L360 282 L336 259 L328 278 L300 258 L293 278 L268 263 L265 291 Z M188 318 L162 316 L169 340 L146 344 L160 367 L140 380 L170 394 L165 410 L194 416 Z"/>
+<path id="serpentine-body" fill="#42b66c" d="M480 177 C470 215 504 252 540 266 C568 280 559 302 528 306 C472 321 379 258 270 277 C177 293 125 350 169 403 C212 456 347 444 438 416 C506 394 544 351 589 353 C621 355 640 375 625 388 C610 399 591 388 603 377 C573 378 577 410 605 418 C654 431 693 396 662 365 C634 333 592 320 550 328 C486 339 444 391 355 408 C283 425 202 414 203 378 C201 344 252 320 293 322 C372 323 455 363 539 344 C597 331 620 299 594 264 C565 226 523 221 533 185 Z"/>
+<path id="back-highlight" fill="#80d77e" d="M487 194 C486 219 514 244 544 257 C590 279 577 309 542 316 C465 339 387 280 292 289 C218 295 166 337 170 370 C155 337 204 290 271 280 C374 260 466 326 530 308 C561 302 573 284 542 269 C505 255 477 222 480 195 Z"/>
+<path id="belly-ribbon" fill="#efc75b" d="M514 194 C515 231 552 243 575 270 C600 300 572 324 533 332 C455 349 369 308 291 309 C235 310 181 342 186 378 C188 423 274 435 360 418 C453 400 497 352 552 339 C594 329 625 343 647 365 C626 349 607 346 589 350 C540 347 502 393 435 415 C344 442 217 450 177 401 C141 355 192 305 266 289 C365 270 456 334 530 318 C565 312 579 292 557 276 C524 253 501 229 500 203 Z"/>
+<path id="belly-bands" stroke="#b49c42" stroke-width="4" fill="none" d="M510 222 L527 218 M522 245 L542 237 M546 265 L561 254 M567 285 L586 282 M563 306 L576 319 M537 318 L542 331 M500 321 L500 336 M460 315 L456 332 M420 305 L412 323 M378 295 L371 314 M336 290 L333 309 M292 294 L292 309 M249 302 L255 316 M212 322 L225 334 M184 352 L199 357 M185 383 L201 380 M205 410 L215 397 M244 426 L248 411 M284 431 L284 419 M326 427 L325 416 M370 417 L365 408 M409 404 L403 395 M450 385 L443 377 M489 361 L480 354 M529 345 L522 335"/>
+</g>
+<g id="tail">
+<path id="tail-tuft" fill="#d9503e" d="M598 379 Q590 366 607 350 L607 363 L626 352 L623 368 L641 365 Q633 384 615 389 Z"/>
+<path id="tail-tuft-light" fill="#f3924b" d="M603 379 L616 364 L613 378 L628 371 L616 385 Z"/>
+</g>
+<g id="near-feet">
+<path id="near-back-leg" fill="#4ebc70" d="M243 315 Q271 331 264 356 L247 371 L263 385 Q268 397 253 398 L227 384 Q220 376 229 363 L240 351 L222 337 Z"/>
+<path id="near-back-claws" fill="#ffe6a0" d="M244 382 L254 377 L258 391 L249 393 Z M230 378 L238 374 L242 388 L233 387 Z"/>
+<path id="near-front-leg" fill="#56c779" d="M527 275 Q503 283 491 306 Q483 322 496 331 L514 331 L514 345 Q522 355 532 342 L534 322 Q531 313 516 311 L538 293 Z"/>
+<path id="near-front-claws" fill="#ffe6a0" d="M516 331 L522 328 L525 343 L517 345 Z M526 328 L534 325 L534 341 L527 344 Z"/>
+</g>
+<g id="head">
+<path id="mane" fill="#d9503e" d="M480 104 Q462 85 439 87 L450 107 L421 105 L437 128 L412 136 L433 151 L410 166 L438 178 L429 199 L458 195 L455 216 L487 203 L514 184 Z"/>
+<path id="mane-light" fill="#f38848" d="M455 117 L439 116 L449 139 L431 141 L448 155 L433 171 L455 175 L449 191 L474 184 Z"/>
+<path id="far-horn" fill="#ebc76b" d="M551 108 Q546 82 562 61 L558 44 L568 38 L576 61 L566 82 L582 73 L591 81 L565 100 L565 116 Z"/>
+<path id="near-horn" fill="#ffdb7e" d="M480 112 Q465 91 477 67 L460 54 L464 44 L489 62 L494 40 L505 41 L500 73 Q485 93 496 111 Z"/>
+<path id="ear" fill="#59bb6c" d="M463 126 Q429 101 411 116 Q411 145 453 155 Z"/>
+<path id="ear-inner" fill="#e5bc58" d="M451 134 L423 119 Q427 139 451 146 Z"/>
+<path id="face" fill="#59c879" d="M460 116 C478 91 528 91 554 108 C581 112 595 135 593 156 L622 164 Q657 174 640 197 Q627 216 589 213 C574 235 525 240 489 218 C458 207 440 155 460 116 Z"/>
+<path id="forehead-light" fill="#9ce18b" d="M465 126 Q489 99 526 108 Q493 113 477 142 Z"/>
+<path id="muzzle" fill="#c4dd84" d="M558 169 Q591 153 626 174 Q648 185 629 199 Q600 212 563 199 Z"/>
+<path id="chin" fill="#f3d478" d="M496 201 Q523 218 555 205 Q571 214 591 211 Q569 233 534 225 Q509 219 496 201 Z"/>
+<path id="nostril" fill="#23664b" d="M621 175 Q631 171 631 179 Q627 186 621 181 Z"/>
+<path id="mouth" stroke="#317b4f" stroke-width="5" fill="none" d="M558 198 Q588 215 614 202"/>
+<path id="cheek" fill="#e5c263" d="M470 180 Q483 174 492 185 Q489 199 477 194 Z"/>
+</g>
+<g id="whiskers">
+<path id="far-whisker" stroke="#f7d786" stroke-width="6" fill="none" d="M619 187 C653 174 669 146 694 150 Q708 154 700 166"/>
+<path id="near-whisker" stroke="#ffe29b" stroke-width="7" fill="none" d="M592 200 C614 229 656 243 679 223 Q691 212 681 202"/>
+</g>
+<g id="eyes">
+<path id="far-eye-socket" fill="#080d19" d="M548 131 C552 113 572 113 580 130 C588 149 580 170 566 171 C550 169 544 149 548 131 Z"/>
+<path id="far-eye-white" fill="#ffffff" d="M552 132 C555 119 570 119 576 132 C582 147 577 165 566 166 C554 164 549 147 552 132 Z"/>
+<path id="far-pupil" fill="#080d19" d="M561 142 C561 132 572 131 575 141 C578 151 567 157 563 150 Z"/>
+<path id="near-eye-socket" fill="#080d19" d="M475 130 C482 110 509 109 521 128 C534 151 522 180 502 182 C479 181 466 153 475 130 Z"/>
+<path id="near-eye-white" fill="#ffffff" d="M480 132 C486 116 506 115 516 131 C527 151 517 175 502 176 C483 176 473 151 480 132 Z"/>
+<path id="near-pupil" fill="#080d19" d="M495 143 C495 132 508 128 514 140 C519 151 510 162 501 157 C497 155 495 149 495 143 Z"/>
+</g>
+</svg>

package/vendor/dragonlab/design/seer/v2/character.mjs

@@ -0,0 +1,88 @@
+import {renderSvgRig} from '../../../factory/svg-rig.mjs';
+const clamp=x=>Math.max(0,Math.min(1,x));
+const ease=x=>{x=clamp(x);return x*x*(3-2*x);};
+const pulse=(t,a,b)=>t<=a||t>=b?0:Math.sin(Math.PI*(t-a)/(b-a))**2;
+export const SEER_CLIPS=[
+ {id:'idle',title:'Quiet Watch',duration:14000},
+ {id:'attach',title:'A Closer Look',duration:3400},
+ {id:'curious',title:'Following a Detail',duration:3000},
+ {id:'focus',title:'Reading the Pattern',duration:3000},
+ {id:'concerned',title:'Something Does Not Fit',duration:3000},
+ {id:'proud',title:'There It Is',duration:2800},
+ {id:'standby',title:'Patient Company',duration:4000},
+ {id:'pattern',title:'Pattern Sight',duration:5200,power:true},
+];
+export const STORY=[['attach',3400],['idle',2200],['curious',3000],['focus',2400],['pattern',5200],['proud',2800],['standby',3000]];
+export const STORY_DURATION=STORY.reduce((s,b)=>s+b[1],0);
+const captions={idle:'Quietly watching.',attach:'Let me look closer.',curious:'Something caught my eye.',focus:'Following the details.',concerned:'This needs another look.',proud:'There it is · expression study',standby:'Take your time.',pattern:'Pattern Sight · visual demonstration'};
+export function bodyPose(ms){
+ const t=ms%14000;
+ return {turn:.018*pulse(t,800,4300)-.012*pulse(t,6500,9500),nod:2*pulse(t,1300,4600),coil:pulse(t,3200,8800),whisker:pulse(t,1600,5000)-.6*pulse(t,7300,10300)};
+}
+export function poseRig(rig,p,face){
+ const paths=rig.paths.map(path=>({...path,polygons:path.polygons.map(poly=>poly.map(([sx,sy])=>{
+  let x=sx,y=sy;
+  if(path.id.endsWith('-eye-white')||path.id.endsWith('-pupil')){
+   const cy=path.id.startsWith('near-')?146:143;
+   y=cy+(y-cy)*face.open;
+   if(path.id.endsWith('-pupil'))x+=face.gaze*4;
+  }
+  // The same spatial warp moves all anatomy, so neck, fins and feet stay joined.
+  const upper=ease((310-sy)/110),a=p.turn*upper;
+  const dx=x-520,dy=y-270;
+  x=520+dx*Math.cos(a)-dy*Math.sin(a);y=270+dx*Math.sin(a)+dy*Math.cos(a)+p.nod*upper;
+  // Compress inward instead of enlarging the envelope; leave the planted bottom still.
+  const coil=ease((sy-275)/55)*(1-ease((sy-385)/40));
+  x+=(395-sx)*.009*p.coil*coil;
+  y-=2*p.coil*coil;
+  if(path.group==='whiskers'){
+   const root=path.id==='far-whisker'?619:592;
+   const w=ease((sx-root)/90);y+=3*p.whisker*w;x-=1.5*Math.abs(p.whisker)*w;
+  }
+  return [x,y];
+ }))}));
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...rig,paths,eyes:rig.eyes.map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))};
+}
+function expression(scene,t){
+ const blink=pulse(t%7000,5400,5620);
+ switch(scene){
+ case 'curious':return {gaze:.7*ease(t/700),open:1.07};
+ case 'focus':return {gaze:.35,open:.72};
+ case 'concerned':return {gaze:-.35,open:.88};
+ case 'proud':return {gaze:0,open:1.1};
+ case 'standby':return {gaze:0,open:.85};
+ case 'pattern':return {gaze:-.65*ease(t/900),open:1};
+ default:return {gaze:.25*Math.sin(t/2300),open:1-.65*blink};
+ }
+}
+function pattern(frame,t,mono){
+ const h=frame.length,w=frame[0].length,nodes=[[.14,.28],[.24,.18],[.34,.29],[.40,.40]];
+ const progress=ease(t/3400),fade=1-ease((t-4300)/900);let count=0;
+ const put=(x,y,bright)=>{x=Math.round(x*w);y=Math.round(y*h);if(x<1||x>=w-1||y<1||y>=h-1||fade<.05||frame[y][x].ch!==' ')return;frame[y][x]={ch:bright?'⠿':'⠂',bg:null,rgb:mono?null:(bright?[255,235,156]:[229,186,83]).map(n=>Math.round(n*fade))};count++;};
+ for(let i=0;i<nodes.length;i++)if(progress>(i+1)*.09)put(...nodes[i],true);
+ for(let i=0;i<3;i++)for(let j=1;j<8;j++)if(progress>.42+(i+j/8)*.18){const a=nodes[i],b=nodes[i+1];put(a[0]+(b[0]-a[0])*j/8,a[1]+(b[1]-a[1])*j/8,false);}
+ return count;
+}
+export function renderSeer(rig,scene='idle',ms=0,options={}){
+ const clip=SEER_CLIPS.find(c=>c.id===scene);
+ if(!clip)return {ok:false,code:'UNKNOWN_CLIP'};
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ const t=options.still?(clip.power?3300:0):ms;
+ let face=expression(scene,t),pose=bodyPose(options.motionTime??t);
+ if(scene==='attach'){
+  const duration=options.deck?4400:3400;
+  if(t>=duration){pose=bodyPose(t-duration);face=expression('idle',t-duration);}
+  else{const u=t/duration;pose={turn:-.02*pulse(u,.1,.8),nod:3*pulse(u,.25,.9),coil:.8*pulse(u,.35,1),whisker:pulse(u,.3,.95)};face={gaze:-.5*pulse(u,0,.85),open:1};}
+ }
+ if(scene==='proud')pose={...pose,nod:pose.nod-1.5*pulse(t,0,2800)};
+ if(options.still)pose={turn:0,nod:0,coil:0,whisker:0};
+ const r=renderSvgRig(poseRig(rig,pose,face),options);
+ const effectCells=clip.power?pattern(r.frame,t,options.mono):0;
+ return {...r,scene,clip:clip.title,caption:captions[scene],pose,face,effectCells};
+}
+export function renderStory(rig,ms,options={}){
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ let t=options.still?0:Math.min(ms,STORY_DURATION-1);
+ for(const [scene,duration] of STORY){if(t<duration)return renderSeer(rig,scene,t,{...options,deck:false,motionTime:Math.max(0,ms-3400)});t-=duration;}
+}

package/vendor/dragonlab/design/seer/v3/character.mjs

@@ -0,0 +1,33 @@
+import {renderSeer as renderV2,SEER_CLIPS as V2_CLIPS} from '../v2/character.mjs';
+const ease=x=>{x=Math.max(0,Math.min(1,x));return x*x*(3-2*x);};
+export const SEER_CLIPS=[...V2_CLIPS,{id:'eight',title:'Eight · HI!',duration:10000}];
+export const STORY_DURATION=10000;
+import {flattenPath} from '../../stage3/svg-coverage.js';
+// Authored rest and entrance spines; transfer existing artwork along their arc length.
+const rest=flattenPath('M506 185 C500 225 565 245 576 280 C590 315 555 330 528 325 C460 345 370 285 286 300 C220 310 170 343 184 380 C200 430 280 439 357 420 C440 400 490 360 554 340 C600 324 635 349 650 376 C660 400 617 420 596 399 C586 389 593 381 603 377')[0];
+const target=flattenPath('M506 185 C490 215 410 235 350 270 C280 305 250 320 280 355 C320 405 414 405 450 355 C490 310 405 285 350 250 C285 215 245 195 275 155 C310 115 390 115 423 154 C453 187 420 220 385 222 C365 223 347 210 354 197')[0];
+function spine(points){let total=0;const segments=[];for(let i=1;i<points.length;i++){const a=points[i-1],b=points[i],dx=b[0]-a[0],dy=b[1]-a[1],len=Math.hypot(dx,dy);if(!len)continue;segments.push({a,dx,dy,len,start:total});total+=len;}return {segments,total};}
+const original=spine(rest),destination=spine(target),cache=new WeakMap();
+function mapPoint(x,y){
+ let nearest,dist=Infinity,along=0,offset=0;
+ for(const s of original.segments){const u=Math.max(0,Math.min(1,((x-s.a[0])*s.dx+(y-s.a[1])*s.dy)/(s.len*s.len)));const px=s.a[0]+u*s.dx,py=s.a[1]+u*s.dy,d=(x-px)**2+(y-py)**2;if(d<dist){dist=d;nearest=s;along=(s.start+u*s.len)/original.total;offset=((x-px)*-s.dy+(y-py)*s.dx)/s.len;}}
+ const at=along*destination.total,s=destination.segments.find(s=>at<=s.start+s.len)||destination.segments.at(-1),u=(at-s.start)/s.len;
+ return [s.a[0]+u*s.dx-offset*s.dy/s.len,s.a[1]+u*s.dy+offset*s.dx/s.len];
+}
+export function figureEight(rig,amount){
+ if(!cache.has(rig))cache.set(rig,rig.paths.map(p=>p.polygons.map(poly=>poly.map(([x,y])=>['head','eyes','whiskers'].includes(p.group)?[x,y]:mapPoint(x,y)))));
+ const mapped=cache.get(rig);
+ const paths=rig.paths.map((p,i)=>({...p,polygons:p.polygons.map((poly,j)=>poly.map(([x,y],k)=>[x+(mapped[i][j][k][0]-x)*amount,y+(mapped[i][j][k][1]-y)*amount]))}));
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...rig,paths,eyes:rig.eyes.map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))};
+}
+export function renderSeer(rig,scene='eight',ms=0,options={}){
+ if(scene!=='eight')return renderV2(rig,scene,ms,options);
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ const t=options.still?3000:ms;
+ if(t>=7000)return renderV2(rig,'idle',t-7000,options);
+ const amount=ease(t/2200)*(1-ease((t-4500)/2500));
+ const r=renderV2(figureEight(rig,amount),'idle',0,{...options,motionTime:0});
+ return {...r,scene:'eight',clip:'Eight · HI!',caption:t>=2200&&t<4500?'HI!':'A little twist…',amount};
+}
+export function renderStory(rig,ms,options={}){return renderSeer(rig,'eight',ms,options);}

package/vendor/dragonlab/design/seer/v4/character.mjs

@@ -0,0 +1,66 @@
+import {renderSeer as previous,SEER_CLIPS as previousClips} from '../v3/character.mjs';
+import {flattenPath} from '../../stage3/svg-coverage.js';
+import {renderSvgRig} from '../../../factory/svg-rig.mjs';
+const TAU=2*Math.PI;
+const ease=x=>{x=Math.max(0,Math.min(1,x));return x*x*(3-2*x);};
+export const SEER_CLIPS=[...previousClips,{id:'swim',title:'Swimming Eight · HI!',duration:11000}];
+export const STORY_DURATION=11000;
+export const arrivalDuration=deck=>deck?8500:5800;
+const rest=flattenPath('M506 185 C500 225 565 245 576 280 C590 315 555 330 528 325 C460 345 370 285 286 300 C220 310 170 343 184 380 C200 430 280 439 357 420 C440 400 490 360 554 340 C600 324 635 349 650 376 C660 400 617 420 596 399 C586 389 593 381 603 377')[0];
+let length=0;
+const segments=rest.slice(1).map((b,i)=>{const a=rest[i],dx=b[0]-a[0],dy=b[1]-a[1],n=Math.hypot(dx,dy),s={a,dx,dy,n,start:length};length+=n;return s;}).filter(s=>s.n);
+const cache=new WeakMap();
+function bind(x,y){
+ let distance=Infinity,binding;
+ for(const s of segments){const u=Math.max(0,Math.min(1,((x-s.a[0])*s.dx+(y-s.a[1])*s.dy)/s.n**2));
+ const px=s.a[0]+u*s.dx,py=s.a[1]+u*s.dy,d=(x-px)**2+(y-py)**2;
+ if(d<distance){distance=d;binding={along:(s.start+u*s.n)/length,offset:((x-px)*-s.dy+(y-py)*s.dx)/s.n};}}
+ return binding;
+}
+// Upright eight. Arc-length lookup makes skin sections travel at equal speed.
+const track=Array.from({length:721},(_,i)=>{const a=i/720*TAU;return [390+100*Math.sin(2*a),277-81*Math.cos(a)];});
+const lengths=[0];for(let i=1;i<track.length;i++)lengths.push(lengths.at(-1)+Math.hypot(track[i][0]-track[i-1][0],track[i][1]-track[i-1][1]));
+function sample(u){
+ const d=((u%1)+1)%1*lengths.at(-1);let lo=0,hi=720;
+ while(hi-lo>1){const m=(lo+hi)>>1;if(lengths[m]<d)lo=m;else hi=m;}
+ const f=(d-lengths[lo])/(lengths[hi]-lengths[lo]),a=track[lo],b=track[hi],n=Math.hypot(b[0]-a[0],b[1]-a[1]);
+ return {x:a[0]+f*(b[0]-a[0]),y:a[1]+f*(b[1]-a[1]),nx:-(b[1]-a[1])/n,ny:(b[0]-a[0])/n};
+}
+export function swimRig(rig,ms,{deck=false,still=false}={}){
+ const duration=arrivalDuration(deck),t=still?duration*.69:Math.min(ms,duration),u=t/duration;
+ // Slow into a greeting at the top; settle with zero endpoint velocity.
+ const amount=ease(u/.18)*(1-ease((u-.78)/.22));
+ const phase=1-ease((u-.13)/.54),head=sample(phase);
+ const angle=.13*Math.sin(TAU*phase),c=Math.cos(angle),s=Math.sin(angle);
+ if(!cache.has(rig))cache.set(rig,rig.paths.map(p=>p.polygons.map(poly=>poly.map(([x,y])=>bind(x,y)))));
+ const bindings=cache.get(rig);
+ const paths=rig.paths.map((p,i)=>({...p,polygons:p.polygons.map((poly,j)=>poly.map(([x,y],k)=>{
+  const b=bindings[i][j][k];let tx,ty;
+  if(['head','eyes','whiskers'].includes(p.group)){
+   tx=head.x+(x-506)*c-(y-185)*s;ty=head.y+(x-506)*s+(y-185)*c;
+   if(p.group==='whiskers'){
+    const root=p.id==='far-whisker'?619:592,w=ease((x-root)/85);
+    ty+=7*w*Math.sin(TAU*phase-.8)*Math.sin(Math.PI*ease(u/.78));
+   }
+  }else{
+   const q=sample(phase+b.along*.9);
+   tx=q.x+q.nx*b.offset*.85;ty=q.y+q.ny*b.offset*.85;
+   // Blend the neck root into the same rigid face transform.
+   const root=1-ease(b.along/.055);
+   tx=tx*(1-root)+(head.x+(x-506)*c-(y-185)*s)*root;
+   ty=ty*(1-root)+(head.y+(x-506)*s+(y-185)*c)*root;
+  }
+  return [x+(tx-x)*amount,y+(ty-y)*amount];
+ }))}));
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...rig,paths,eyes:rig.eyes.map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)})),flight:{amount,phase,head,u}};
+}
+export function renderSeer(rig,scene='swim',ms=0,options={}){
+ if(scene!=='swim')return previous(rig,scene,ms,options);
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ const end=arrivalDuration(options.deck);
+ if(!options.still&&ms>=end)return previous(rig,'idle',ms-end,options);
+ const posed=swimRig(rig,ms,options),r=renderSvgRig(posed,options),u=posed.flight.u;
+ return {...r,scene:'swim',clip:'Swimming Eight · HI!',caption:u>=.67&&u<.83?'HI!':u<.67?'Following my own trail…':'Right here with you.',flight:posed.flight};
+}
+export function renderStory(rig,ms,options={}){return renderSeer(rig,'swim',ms,options);}

package/vendor/dragonlab/design/seer/v4/review.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import {parseSvgRig} from '../../../factory/svg-rig.mjs';
+import {renderSeer,SEER_CLIPS} from './character.mjs';
+import {artSlot,composeMessage} from '../../lucid/recovery/layout.mjs';
+import {cellsToAnsi} from '../../../vendor/quox-dragon/qart.js';
+const args=process.argv.slice(2),values=new Set(['--cols','--rows','--terminal-cols','--terminal-rows','--message','--scene','--at']);
+for(let i=0;i<args.length;i++){
+ if(values.has(args[i])){if(!args[i+1]||args[i+1].startsWith('--'))throw Error('Missing option value');i++;}
+ else if(!['--large','--mono','--help','--watch','--attach','--intro','--still','--list'].includes(args[i]))throw Error('Unknown option: '+args[i]);
+}
+const value=(name,fallback)=>args.includes(name)?args[args.indexOf(name)+1]:fallback;
+if(args.includes('--help')){console.log('Seer V4 flowing figure-eight entrance. --watch --attach --intro --still --scene ID --at MS --list --large --mono --message TEXT --cols N --rows N --terminal-cols N --terminal-rows N');process.exit(0);}
+if(args.includes('--list')){console.log(SEER_CLIPS.map(c=>c.id+' · '+c.title).join('\n'));process.exit(0);}
+const w=Number(value('--terminal-cols',process.stdout.columns||80)),h=Number(value('--terminal-rows',process.stdout.rows||24));
+if(!Number.isSafeInteger(w)||!Number.isSafeInteger(h)||w<1||h<1)throw Error('Invalid terminal size');
+const slot=artSlot(w,h),large=args.includes('--large')||args.includes('--intro'),explicit=large||args.includes('--cols')||args.includes('--rows');
+const cols=Number(value('--cols',large?Math.min(120,w-4):Math.min(39,slot.cols))),rows=Number(value('--rows',large?Math.min(36,h-4):Math.min(11,slot.rows)));
+const message=value('--message','SEER\nLet me look closer.');
+if(!slot.showArt&&!explicit){console.log(composeMessage(null,message,{terminalCols:w}).join('\n'));}
+else{
+ if(cols>w-4||rows>h-2)throw Error('Requested art exceeds terminal margins');
+ const rig=parseSvgRig(await fs.readFile(new URL('../v1/seer-master.svg',import.meta.url),'utf8'));
+ const opts={cols,rows,mono:args.includes('--mono'),still:args.includes('--still'),deck:large};
+ const scene=value('--scene','swim');
+ const r=renderSeer(rig,scene,Number(value('--at',0)),opts);
+ if(!r.ok)throw Error(r.code);
+ if(args.includes('--watch')||args.includes('--attach')||args.includes('--intro')){
+  const {watch}=await import('./watch.mjs');
+  await watch(rig,opts,{terminalCols:w,terminalRows:h,large,scene:args.includes('--scene')||args.includes('--attach')?scene:null,arrival:args.includes('--attach')&&scene==='attach',message:args.includes('--message')?message:null});
+ }else
+ console.log((large?[...cellsToAnsi(r.frame),...composeMessage(null,message,{terminalCols:w})]:composeMessage(r.frame,message,{terminalCols:w})).join('\n'));
+}