quoxcli 0.3.1 → 0.5.0

package/vendor/dragonlab/design/quoxperticus/v2/quoxperticus-master.svg

@@ -0,0 +1,59 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 480">
+<title>Quoxperticus — the white, crimson and obsidian skill keeper</title>
+<g id="wings">
+<path id="left-wing" fill="#a92339" d="M 322 298 Q 252 207 137 92 L 161 209 L 114 182 L 148 279 L 112 291 L 243 337 Z"/>
+<path id="right-wing" fill="#c12b42" d="M 444 296 Q 510 133 621 78 L 608 192 L 666 170 L 634 269 L 677 277 L 533 338 Z"/>
+<path id="wing-ribs" fill="none" stroke="#666777" stroke-width="12" d="M 322 298 L 137 92 L 161 209 L 148 279 M 322 298 L 161 209 M 444 296 L 621 78 L 608 192 L 634 269 M 444 296 L 608 192"/>
+<path id="wing-tips" fill="#f6f0f2" d="M 126 105 L 137 76 L 165 103 L 145 98 Z M 600 91 L 629 66 L 642 99 L 622 86 Z"/>
+</g>
+<g id="tail">
+<path id="tail-coil" fill="#555763" d="M 447 353 C 521 330 611 352 631 391 C 655 437 576 454 521 432 C 578 438 610 413 593 395 Q 566 368 461 387 Z"/>
+<path id="tail-edge" fill="none" stroke="#eeecef" stroke-width="10" d="M 468 367 C 537 346 611 376 619 404 Q 617 428 563 433"/>
+<path id="tail-blade" fill="#e8374d" d="M 523 431 L 494 406 L 504 443 L 543 447 Z"/>
+</g>
+<g id="body">
+<path id="obsidian-body" fill="#55545f" d="M 315 237 Q 393 210 448 257 L 479 347 Q 475 403 431 418 L 311 413 Q 272 378 292 312 Z"/>
+<path id="chest-armour" fill="#e9e4ea" d="M 340 231 L 407 237 L 436 304 L 415 369 L 367 395 L 324 350 L 319 287 Z"/>
+<path id="chest-joints" fill="none" stroke="#8d8696" stroke-width="7" d="M 325 275 L 417 280 M 324 305 L 430 312 M 336 339 L 419 344 M 351 367 L 399 374"/>
+<path id="legs" fill="#666370" d="M 301 341 L 340 367 L 325 407 L 350 435 L 271 435 L 261 414 Z M 425 360 L 465 345 L 483 410 L 500 434 L 420 434 L 405 413 Z"/>
+<path id="feet-armour" fill="#f1edf1" d="M 273 409 L 319 407 L 342 429 L 271 429 Z M 424 408 L 475 408 L 493 428 L 420 429 Z"/>
+<path id="talons" fill="#161923" d="M 282 416 L 278 432 L 290 427 L 300 415 L 300 432 L 312 428 L 318 417 L 325 433 L 337 428 M 433 416 L 430 432 L 442 428 L 451 415 L 453 432 L 465 428 L 472 417 L 480 432 L 490 428"/>
+</g>
+<g id="neck">
+<path id="neck-black" fill="#53515d" d="M 334 166 L 400 160 Q 437 211 433 267 L 389 292 L 335 261 L 348 214 Z"/>
+<path id="neck-white" fill="#f5eef2" d="M 344 186 L 371 187 Q 384 227 409 261 L 386 281 L 353 252 L 360 216 Z"/>
+<path id="neck-spines" fill="#ede6ef" d="M 399 178 L 442 177 L 423 196 L 450 211 L 428 221 L 457 241 L 432 247 L 449 268 L 416 265 Z"/>
+</g>
+<g id="head">
+<path id="horn-far" fill="#faf4f4" d="M 324 117 L 297 76 L 300 26 L 315 65 L 346 105 Z"/>
+<path id="horn-near" fill="#ffffff" d="M 380 108 L 401 59 L 446 22 L 425 71 L 411 124 Z"/>
+<path id="horn-bands" fill="none" stroke="#292b35" stroke-width="9" d="M 300 65 L 321 69 M 312 91 L 334 89 M 408 66 L 430 61 M 397 90 L 417 91"/>
+<path id="face-armour" fill="#e9e5ed" d="M 304 128 L 339 99 L 384 100 L 419 127 L 409 173 L 381 201 L 326 193 L 293 165 Z"/>
+<path id="crown" fill="#e8334e" d="M 337 113 L 341 73 L 358 96 L 376 60 L 379 101 L 397 85 L 392 125 L 365 116 Z"/>
+<path id="cheek-fins" fill="#faf5f7" d="M 393 143 L 455 114 L 427 151 L 457 148 L 426 174 L 438 186 L 399 190 Z"/>
+<path id="muzzle" fill="#ffffff" d="M 313 163 Q 286 153 271 170 L 280 192 L 323 204 L 358 188 L 352 174 Z"/>
+<path id="nostril" fill="#20212b" d="M 282 172 L 293 168 L 290 180 Z"/>
+<path id="mouth" fill="none" stroke="#6a5265" stroke-width="5" d="M 281 187 Q 314 204 347 184"/>
+</g>
+<g id="panel">
+<path id="panel-shell" fill="#6d626f" d="M 186 309 L 416 309 L 442 367 L 211 367 Z"/>
+<path id="panel-screen" fill="#242333" d="M 199 317 L 406 317 L 425 354 L 218 354 Z"/>
+<path id="panel-rim" fill="none" stroke="#ff6475" stroke-width="7" d="M 186 309 L 416 309 L 442 367 L 211 367 Z"/>
+<path id="skill-cards" fill="#f0e9ee" d="M 224 326 L 258 326 L 264 344 L 230 344 Z M 281 326 L 315 326 L 321 344 L 287 344 Z"/>
+<path id="selected-skill" fill="#ff344f" d="M 341 326 L 379 326 L 385 344 L 347 344 Z"/>
+</g>
+<g id="arms">
+<path id="far-arm" fill="#e5dfe8" d="M 319 248 Q 288 235 267 263 L 251 290 L 228 294 L 223 312 L 272 315 L 287 284 L 325 277 Z"/>
+<path id="near-arm" fill="#f7eff2" d="M 412 250 Q 448 247 451 276 L 417 304 L 382 311 L 369 299 L 389 282 L 411 277 Z"/>
+<path id="finger-claws" fill="#20212b" d="M 232 297 L 225 316 L 240 308 L 249 298 L 245 317 L 260 309 M 377 296 L 367 313 L 385 308 L 393 295 L 390 312 L 407 303"/>
+<path id="arm-scales" fill="none" stroke="#a699ac" stroke-width="6" d="M 281 259 L 298 275 M 421 261 L 438 277"/>
+</g>
+<g id="eyes">
+<path id="far-eye-socket" fill="#080d19" d="M 304 147 C 304 137.0588745 312.0588745 129 322 129 C 331.9411255 129 340 137.0588745 340 147 C 340 156.9411255 331.9411255 165 322 165 C 312.0588745 165 304 156.9411255 304 147 Z"/>
+<path id="far-eye-white" fill="#ffffff" d="M 310 147 C 310 140.372583 315.372583 135 322 135 C 328.627417 135 334 140.372583 334 147 C 334 153.627417 328.627417 159 322 159 C 315.372583 159 310 153.627417 310 147 Z"/>
+<path id="far-pupil" fill="#080d19" d="M 318 145 C 318 138 326 138 326 145 C 326 153 318 153 318 145 Z"/>
+<path id="near-eye-socket" fill="#080d19" d="M 349 147 C 349 134.8497355 358.8497355 125 371 125 C 383.1502645 125 393 134.8497355 393 147 C 393 159.1502645 383.1502645 169 371 169 C 358.8497355 169 349 159.1502645 349 147 Z"/>
+<path id="near-eye-white" fill="#ffffff" d="M 356 147 C 356 138.71572875 362.71572875 132 371 132 C 379.28427125 132 386 138.71572875 386 147 C 386 155.28427125 379.28427125 162 371 162 C 362.71572875 162 356 155.28427125 356 147 Z"/>
+<path id="near-pupil" fill="#080d19" d="M 364 145 C 364 137 373 137 373 145 C 373 154 364 154 364 145 Z"/>
+</g>
+</svg>

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

@@ -0,0 +1,43 @@
+import {renderSvgRig} from '../../../factory/svg-rig-contour.mjs';
+export const QUOXPERTICUS_CLIPS=Object.freeze([{id:'idle',title:'Quiet Expertise',duration:12000},{id:'attach',title:'At Your Command',duration:3000},{id:'skill',title:'Select a Skill',duration:6000}]);
+export const STORY_DURATION=12000;
+const pulse=(t,a,b)=>t<=a||t>=b?0:Math.sin(Math.PI*(t-a)/(b-a))**2;
+const ease=x=>{x=Math.max(0,Math.min(1,x));return x*x*(3-2*x);};
+export function poseRig(rig,scene,ms){
+ const t=scene==='attach'?ms:ms%(scene==='skill'?6000:12000);
+ const look=scene==='skill'?pulse(t,0,3000):scene==='attach'?pulse(t,200,1900):.25*pulse(t,2000,5500);
+ const tap=scene==='skill'?(t<1800?ease((t-800)/1000):1-ease((t-2200)/1000)):0;
+ const follow=scene==='attach'?pulse(t,700,2800):scene==='idle'?.4*pulse(t,3000,8500):.25*pulse(t,3000,5800);
+ const paths=rig.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>{
+  if(p.group==='head'||p.group==='eyes')return [x-2*look,y+7*look];
+  if(p.group==='neck'){const w=Math.max(0,Math.min(1,(285-y)/75));return [x-2*look*w,y+7*look*w];}
+  if(p.id==='near-arm'||p.id==='finger-claws'&&x>350||p.id==='arm-scales'&&x>350){const w=Math.max(0,Math.min(1,(y-250)/45));return [x-12*tap*w,y+20*tap*w];}
+  if(p.group==='wings'){const w=Math.max(0,Math.min(1,(330-y)/240));return [x+(x<380?4:-4)*follow*w,y+5*follow*w];}
+  if(p.group==='tail'){const w=Math.max(0,Math.min(1,(x-460)/150));return [x,y-6*follow*w];}
+  return [x,y];
+ }))}));
+ const active=scene==='skill'&&t>=1800&&t<5000;
+ for(const p of paths)if(p.id==='selected-skill')p.rgb=active?[255,Math.round(70+100*pulse(t,1800,5000)),105]:[145,35,55];
+ if(active){
+  // Trace along the panel's own lower edge, clear of face and claws.
+  const u=Math.min(1,(t-1800)/1800),x=222+204*u,y=359;
+  paths.push({id:'skill-pulse',group:'effect',rgb:[255,230,240],stroke:0,erase:false,polygons:[[[x-4,y],[x,y-4],[x+4,y],[x,y+4]]]});
+ }
+ const map=new Map(paths.map(p=>[p.id,p]));
+ return {...rig,paths,eyes:rig.eyes.map(e=>({...e,socket:map.get(e.socket.id),white:map.get(e.white.id),pupil:map.get(e.pupil.id)}))};
+}
+export function renderQuoxperticus(rig,scene='idle',ms=0,options={}){
+ if(!QUOXPERTICUS_CLIPS.some(c=>c.id===scene))return {ok:false,code:'UNKNOWN_CLIP'};
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(scene==='attach'&&ms>=3000&&!options.still)return renderQuoxperticus(rig,'idle',ms-3000,options);
+ const t=options.still?({idle:4000,attach:1200,skill:2200}[scene]):ms;
+ const caption=scene==='attach'?'Skills at your command.':scene==='skill'?'Select. Illuminate. Connect.':'Ready when you are.';
+ return {...renderSvgRig(poseRig(rig,scene,t),options),clip:scene,scene,caption};
+}
+export function renderStory(rig,ms,options={}){
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(options.still)return renderQuoxperticus(rig,'skill',2200,options);
+ if(ms<3000)return renderQuoxperticus(rig,'attach',ms,options);
+ if(ms<9000)return renderQuoxperticus(rig,'skill',ms-3000,options);
+ return renderQuoxperticus(rig,'idle',ms-9000,options);
+}

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

@@ -0,0 +1,57 @@
+import {renderSvgRig} from '../../../factory/svg-rig-contour.mjs';
+import {poseRig as previousPose,renderQuoxperticus as previous,QUOXPERTICUS_CLIPS as clips} from '../v3/character.mjs';
+export const QUOXPERTICUS_CLIPS=Object.freeze([...clips,{id:'orchestrate',title:'Fleet Conductor',duration:10000}]);
+export const STORY_DURATION=13000;
+const clamp=x=>Math.max(0,Math.min(1,x));
+const ease=x=>{x=clamp(x);return x*x*(3-2*x);};
+const fit=rig=>({...rig,bounds:{left:12,top:0,right:790,bottom:460}});
+export function poseRig(rig,ms,{deck=false}={}){
+ const t=ms%10000,energy=ease(t/1400)*(1-ease((t-7800)/2200));
+ const base=previousPose(fit(rig),'idle',t);
+ const beat=energy*(.75+.25*Math.sin(t/380));
+ const paths=base.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>{
+  if(p.id==='near-arm'||p.id==='finger-claws'&&x>350||p.id==='arm-scales'&&x>350){const w=clamp((450-x)/70);return [x+14*energy*w,y-65*beat*w];}
+  return [x,y];
+ }))}));
+ const back=[],front=[];
+ const shape=(list,id,rgb,points,stroke=0)=>list.push({id,group:'orchestration',rgb,polygons:[points],stroke,erase:false});
+ const light=(v)=>[Math.round(160+95*v),Math.round(36+170*v),Math.round(65+170*v)];
+ const anchor=[390,288-50*beat];
+ if(energy>.01){
+  const count=deck?6:3;
+  for(let i=0;i<count;i++){
+   const left=i<3,x=left?55:742,y=110+(i%3)*100;
+   const phase=((t-1400-i*230)/2200%1+1)%1;
+   const bright=energy*(phase>.78?1:.3);
+   shape(back,'rack-'+i,light(bright),[[x-28,y-20],[x+28,y-20],[x+28,y+20],[x-28,y+20],[x-28,y-20]],4);
+   shape(back,'rack-divider-'+i,light(bright),[[x-26,y],[x+26,y]],3);
+   for(let j=0;j<2;j++)shape(back,'rack-led-'+i+'-'+j,[255,Math.round(130*energy),Math.round(150*energy)],[[x-17,y-12+j*20],[x-11,y-12+j*20],[x-11,y-7+j*20],[x-17,y-7+j*20]]);
+   // Curved command threads arch through the space above the wings.
+   const control=[left?170:600,25+i%3*22];
+   const point=u=>[(1-u)**2*anchor[0]+2*(1-u)*u*control[0]+u*u*x,(1-u)**2*anchor[1]+2*(1-u)*u*control[1]+u*u*y];
+   const thread=Array.from({length:31},(_,j)=>point(j/30));
+   shape(back,'thread-'+i,[Math.round(180*energy),Math.round(38*energy),Math.round(65*energy)],thread,3);
+   if(t>1400+i*230&&t<8500){
+    const [wx,wy]=point(phase),r=deck?6:7;
+    shape(front,'worker-'+i,light(energy),[[wx-r,wy],[wx,wy-r],[wx+r,wy],[wx,wy+r]]);
+    // Short comet tail makes outbound travel readable.
+    shape(front,'worker-tail-'+i,[240,65,105],[point(Math.max(0,phase-.055)),[wx,wy]],3);
+   }
+  }
+  // A ring at the conducting claw keeps the origin visible.
+  shape(front,'command-halo',light(energy),Array.from({length:33},(_,i)=>[anchor[0]+17*Math.cos(i*Math.PI/16),anchor[1]+9*Math.sin(i*Math.PI/16)]),3);
+ }
+ return {...base,paths:[...back,...paths,...front]};
+}
+export function renderQuoxperticus(rig,scene='idle',ms=0,options={}){
+ if(scene!=='orchestrate')return previous(fit(rig),scene,ms,options);
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ const t=options.still?4600:ms%10000;
+ return {...renderSvgRig(poseRig(rig,t,options),options),clip:scene,scene,caption:t<1400?'Raise the command.':t<7800?'Dispatch workers. Conduct the fleet.':'Workers settle. The mission continues.',visualOnly:true,demo:true};
+}
+export function renderStory(rig,ms,options={}){
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(options.still)return renderQuoxperticus(rig,'orchestrate',4600,options);
+ if(ms<3000)return renderQuoxperticus(rig,'attach',ms,options);
+ return renderQuoxperticus(rig,'orchestrate',ms-3000,options);
+}

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

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import {parseSvgRig} from '../../../factory/svg-rig.mjs';
+import {renderQuoxperticus,QUOXPERTICUS_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('Quoxperticus V4 forge studio. --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(QUOXPERTICUS_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','QUOXPERTICUS\nSkills at your command.');
+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('../v2/quoxperticus-master.svg',import.meta.url),'utf8'));
+ const opts={cols,rows,mono:args.includes('--mono'),still:args.includes('--still'),deck:large};
+ const scene=value('--scene',args.includes('--attach')?'attach':'idle');
+ const r=renderQuoxperticus(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'),message:args.includes('--message')?message:null});
+ }else{
+ const shownMessage=args.includes('--message')?message:'QUOXPERTICUS\n'+r.caption;
+ console.log((large?[...cellsToAnsi(r.frame),...composeMessage(null,shownMessage,{terminalCols:w})]:composeMessage(r.frame,shownMessage,{terminalCols:w})).join('\n'));
+}
+}

package/vendor/dragonlab/design/quoxperticus/v4/watch.mjs

@@ -0,0 +1,56 @@
+import {performance} from 'node:perf_hooks';
+import {QUOXPERTICUS_CLIPS,renderQuoxperticus,renderStory,STORY_DURATION} from './character.mjs';
+import {composeMessage} from '../../lucid/recovery/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?QUOXPERTICUS_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?renderQuoxperticus(paths,scene,t,options):renderStory(paths,t,options);
+    if(!r?.ok)throw new Error(r?.code??'Invalid story frame');
+    const caption=message??'QUOXPERTICUS · '+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/6);
+    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'));
+}

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

@@ -0,0 +1,56 @@
+import {performance} from 'node:perf_hooks';
+import {SEER_CLIPS,renderSeer,renderStory,STORY_DURATION} from './character.mjs';
+import {composeMessage} from '../../lucid/recovery/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?SEER_CLIPS.find(c=>c.id===scene):null;
+  const duration=(config.arrival&&options.deck?4400: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?renderSeer(paths,scene,t,options):renderStory(paths,t,options);
+    if(!r?.ok)throw new Error(r?.code??'Invalid story frame');
+    const caption=message??'SEER · '+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;}
+}