quoxcli 0.3.1 → 0.5.0

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

@@ -0,0 +1,87 @@
+import {renderSvgRig} from '../../../factory/svg-rig.mjs';
+import {poseDrago} from '../v1/character.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 DRAGO_CLIPS=Object.freeze([
+ {id:'idle',title:'Keeping Watch',duration:14000},
+ {id:'attach',title:'The Guardian Arrives',duration:3800},
+ {id:'active',title:'Locked On',duration:3600},
+ {id:'inspect',title:'Closer Inspection',duration:3800},
+ {id:'guard',title:'Hold the Line',duration:4200,power:true},
+ {id:'concerned',title:'Needs Attention',duration:3200},
+ {id:'acknowledge',title:'Understood',duration:2800},
+ {id:'standby',title:'Awaiting You',duration:3200}
+]);
+export const STORY=[['attach',3800],['idle',2400],['inspect',3800],['active',3600],['guard',4200],['concerned',3200],['acknowledge',2800],['standby',3200],['idle',2500]];
+export const STORY_DURATION=STORY.reduce((n,b)=>n+b[1],0);
+const captions={idle:'On guard.',attach:'At your side.',active:'Active expression study.',inspect:'Inspection expression study.',guard:'Shield-forward visual study.',concerned:'Concern expression study.',acknowledge:'Acknowledgement expression study.',standby:'Waiting expression study.'};
+export function bodyPose(ms){const t=ms%14000;return {
+ breath:1.8*pulse(t,500,6500),wing:.025*pulse(t,3000,6500),far:.019*pulse(t,3500,7000),tail:1.1*pulse(t,7500,12000),
+ turn:.009*pulse(t,900,3800),nod:1.8*pulse(t,900,3800),shield:0,grip:0,gaze:0,glare:false,eye:1
+};}
+function performance(scene,ms,options){
+ const t=options.still?0:ms;
+ let pose=bodyPose(options.still?0:(options.motionTime??t));
+ if(scene==='attach'){
+  const duration=options.deck?4800:3800;
+  if(t>=duration)return bodyPose(t-duration);
+  const u=t/duration;
+  pose={...bodyPose(0),gaze:.6*pulse(u,0,.55),turn:-.015*pulse(u,.1,.7),nod:5*pulse(u,.32,.9),
+   wing:.06*pulse(u,.16,.8),far:.045*pulse(u,.23,.88),shield:.65*pulse(u,.3,.86),grip:pulse(u,.3,.86),tail:pulse(u,.45,1),glare:u>.32&&u<.67};
+ }
+ if(scene==='active')pose={...pose,glare:true,nod:pose.nod+3,grip:.7,gaze:.2};
+ if(scene==='inspect')pose={...pose,gaze:.8*Math.sin(t/1100),turn:pose.turn+.018*Math.sin(t/1100),nod:pose.nod+1};
+ if(scene==='guard'){const p=options.still?1:pulse(t,0,4200);pose={...pose,glare:true,shield:p,grip:p,wing:pose.wing+.045*p,far:pose.far+.035*p,nod:pose.nod+5*p};}
+ if(scene==='concerned')pose={...pose,turn:pose.turn-.022,nod:pose.nod+2,gaze:-.5,eye:1.08};
+ if(scene==='acknowledge')pose={...pose,nod:pose.nod+6*pulse(t,300,2100),eye:1.05};
+ if(scene==='standby')pose={...pose,gaze:-.65,turn:pose.turn-.012,eye:.9};
+ if(options.still)pose={...pose,breath:0,wing:0,far:0,tail:0,nod:0,turn:0,gaze:0};
+ return pose;
+}
+const rotate=(x,y,cx,cy,a)=>[cx+(x-cx)*Math.cos(a)-(y-cy)*Math.sin(a),cy+(x-cx)*Math.sin(a)+(y-cy)*Math.cos(a)];
+export function poseRig(rig,pose){
+ const source=poseDrago(rig,pose.glare?'active':'idle');
+ const paths=source.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>{
+  if(p.id.endsWith('-eye-white')||p.id.endsWith('-pupil')){
+   y=127+(y-127)*pose.eye;
+   if(p.id.endsWith('-pupil'))x+=pose.gaze*3;
+  }
+  if(p.group==='head'||p.group==='eyes'){
+   const v=rotate(x,y,385,190,pose.turn);return [v[0],v[1]+pose.nod-pose.breath];
+  }
+  if(['neck','throat','throat-plates','spine'].includes(p.id)){
+   const w=ease((290-y)/100),v=rotate(x,y,385,190,pose.turn*w);return [v[0],v[1]+(pose.nod-pose.breath)*w];
+  }
+  if(p.group==='wings'){
+   const right=x>400,a=right?-pose.far:pose.wing;return rotate(x,y,right?455:335,290,a);
+  }
+  if(p.group==='tail'){
+   // Pin the upper-right attachment. Distal coil gathers inward with a small settling recoil.
+   const w=ease((y-360)/55)*ease((610-x)/160),recoil=pose.tail-.24*pose.tail*pose.tail;
+   return [x+(390-x)*.025*w*recoil,y-5*w*recoil];
+  }
+  if(p.group==='shield')return [390+(x-390)*(1+.06*pose.shield),350+(y-350)*(1+.06*pose.shield)-9*pose.shield-pose.breath*.3];
+  if(p.group==='hands'){
+   const w=ease((y-270)/40);return [x+(x<390?2:-2)*pose.grip*w+(x-390)*.06*pose.shield*w,y-(9*pose.shield+pose.breath*.3)*w];
+  }
+  return [x,y];
+ }))}));
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {...source,paths,bounds:{left:rig.bounds.left-10,top:rig.bounds.top-10,right:rig.bounds.right+10,bottom:rig.bounds.bottom+6},
+ eyes:source.eyes.map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))};
+}
+export function renderDrago(rig,scene='idle',ms=0,options={}){
+ const clip=DRAGO_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 pose=performance(scene,ms,options),posed=poseRig(rig,pose),r=renderSvgRig(posed,options);
+ // A local shield glow, never a claim about security posture or real authorisation.
+ if(scene==='guard'&&!options.mono){const brightness=options.still?.9:pulse(ms,0,4200);for(const row of r.frame)for(const cell of row)if(cell.rgb&&cell.rgb[0]===255&&cell.rgb[1]===112){cell.rgb=[255,Math.round(112+70*brightness),Math.round(88+50*brightness)];}}
+ return {...r,scene,clip:clip.title,caption:captions[scene],pose,staticStudy:false};
+}
+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 renderDrago(rig,scene,t,{...options,deck:false,motionTime:Math.max(0,ms-3800)});t-=duration;}
+}

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

@@ -0,0 +1,67 @@
+import {turnHead} from './profile.mjs';
+import {renderDrago as renderV2,poseRig,bodyPose,DRAGO_CLIPS as V2_CLIPS} from '../v2/character.mjs';
+import {renderSvgRig} from '../../../factory/svg-rig.mjs';
+import {flattenPath} from '../../stage3/svg-coverage.js';
+const clamp=x=>Math.max(0,Math.min(1,x));
+const ease=x=>{x=clamp(x);return x*x*(3-2*x);};
+const envelope=(t,a,b,c,d)=>ease((t-a)/(b-a))*(1-ease((t-c)/(d-c)));
+export const FIRE_DURATION=6800;
+export const DRAGO_CLIPS=Object.freeze([...V2_CLIPS,{id:'fire',title:'Scoped Inferno',duration:FIRE_DURATION,power:true}]);
+export const STORY=[['attach',3800],['idle',1400],['fire',FIRE_DURATION],['idle',2400]];
+export const STORY_DURATION=STORY.reduce((n,b)=>n+b[1],0);
+const path=(id,d,rgb,stroke=0)=>({id,group:'fire-effect',polygons:flattenPath(d),rgb,stroke,erase:rgb.every((v,i)=>v===[8,13,25][i])});
+const point=([x,y])=>`${x.toFixed(3)} ${y.toFixed(3)}`;
+export function fireRig(rig,ms,options={}){
+ const t=options.still?3000:ms;
+ const aim=envelope(t,0,900,5600,FIRE_DURATION),blast=envelope(t,1200,1700,4300,4800),embers=envelope(t,4400,4700,5200,5600);
+ const pose={...bodyPose(0),glare:aim>.2,grip:aim,shield:.25*aim,nod:2*aim,gaze:.5*aim,turn:.018*aim,wing:.012*aim,far:0};
+ const posed=poseRig(rig,pose);
+ // Lower the right sail so the line of fire clears its claw and membrane.
+ let paths=posed.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>p.group==='wings'&&x>400?[x,y+28*aim*ease((300-y)/160)]:[x,y]))}));
+ const turn=ease(Math.max(0,Math.min(1,(t-180)/720)))*(1-ease((t-5600)/1200));
+ paths=turnHead(paths,turn);
+ const mouth=[419+(502-419)*turn,169+(124-169)*turn],target=[650,57],dx=target[0]-mouth[0],dy=target[1]-mouth[1],length=Math.hypot(dx,dy),normal=[-dy/length,dx/length];
+ if(aim>.02){
+  // A visible target box describes the animation's scope; it is not an approval badge.
+  const c=blast>.1?[255,116,56]:[210,148,92];
+  paths.push(path('scope-brackets','M 634 24 L 619 24 L 619 39 M 665 24 L 681 24 L 681 39 M 619 75 L 619 91 L 635 91 M 665 91 L 681 91 L 681 75',c,5));
+  paths.push(path('scope-target','M 650 44 L 663 57 L 650 70 L 637 57 Z',[255,185,94],3));
+ }
+ if(blast>.01){
+  const reach=ease((t-1200)/500),tip=[mouth[0]+dx*reach,mouth[1]+dy*reach];
+  const flame=(id,width,rgb,phase)=>{
+   const sides=[[],[]];
+   for(let i=0;i<=24;i++){
+    const u=i/24,x=mouth[0]+(tip[0]-mouth[0])*u,y=mouth[1]+(tip[1]-mouth[1])*u;
+    const rip=.70+.30*Math.sin(u*33-t*.025+phase),w=(2+width*Math.sin(Math.PI*u*.76))*blast*rip;
+    for(let side=0;side<2;side++){const s=side?1:-1;sides[side].push([x+normal[0]*w*s,y+normal[1]*w*s]);}
+   }
+   paths.push(path(id,'M '+[...sides[0],...sides[1].reverse()].map(point).join(' L ')+' Z',rgb));
+  };
+  flame('fire-outer',20,[235,48,30],0);flame('fire-orange',13,[255,116,30],.5);flame('fire-gold',7,[255,211,70],1);flame('fire-core',2.5,[255,249,215],1.4);
+  if(reach>.95){
+   // Impact burst remains wholly within the target's fixed box.
+   const ring=[];for(let j=0;j<20;j++){const a=j*Math.PI/10,r=(j%2?9:19+4*Math.sin(t*.03+j))*blast;ring.push([650+Math.cos(a)*r,57+Math.sin(a)*r]);}
+   paths.push(path('fire-impact','M '+ring.map(point).join(' L ')+' Z',[255,176,45]));
+   paths.push(path('fire-impact-core','M 650 48 L 658 57 L 650 66 L 642 57 Z',[255,249,215]));
+  }
+ }
+ if(embers>.01)for(let i=0;i<7;i++){
+  const age=clamp((t-4400)/1200),x=632+i*5,y=45+((i*13)%22)+age*10;
+  paths.push(path('fire-ember-'+i,`M ${x} ${y} L ${x+2} ${y} L ${x+2} ${y+3} L ${x} ${y+3} Z`,[255,Math.round(110+80*embers),35]));
+ }
+ const byId=new Map(paths.map(p=>[p.id,p]));
+ return {rig:{...posed,paths,eyes:posed.eyes.filter(e=>turn<.95||e.name!=='far').map(e=>({...e,socket:byId.get(e.socket.id),white:byId.get(e.white.id),pupil:byId.get(e.pupil.id)}))},pose,phase:t<1200?'Aim':t<4800?'Directed fire':t<5600?'Embers':'Settle',blast,aim,mouth,target};
+}
+export function renderDrago(rig,scene='idle',ms=0,options={}){
+ if(scene!=='fire')return renderV2(rig,scene,ms,options);
+ if(!Number.isFinite(ms)||ms<0)return {ok:false,code:'INVALID_TIME'};
+ if(!options.still&&ms>=FIRE_DURATION)return renderV2(rig,'idle',ms-FIRE_DURATION,options);
+ const f=fireRig(rig,ms,options),r=renderSvgRig(f.rig,options);
+ return {...r,scene,clip:'Scoped Inferno',caption:`${f.phase} · visual rehearsal`,pose:f.pose,phase:f.phase,blast:f.blast,mouth:f.mouth,target:f.target,staticStudy:false};
+}
+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 renderDrago(rig,scene,t,{...options,deck:false,motionTime:Math.max(0,ms-3800)});t-=duration;}
+}

package/vendor/dragonlab/design/drago/v4/profile.mjs

@@ -0,0 +1,35 @@
+import {flattenPath} from '../../stage3/svg-coverage.js';
+// Authored right-facing head: swept-back horns, one visible eye, elongated muzzle and open jaw.
+const shapes={
+ 'far-horn':'M 380 101 Q 330 87 313 51 Q 353 77 405 77 Z',
+ 'near-horn':'M 403 92 Q 362 59 346 23 Q 391 59 435 72 Z',
+ 'skull':'M 365 123 Q 356 91 398 84 Q 434 78 456 99 L 486 98 L 505 110 L 500 120 L 446 139 Q 422 171 383 167 Z',
+ 'brow-armour':'M 376 100 L 393 79 L 413 84 L 430 71 L 448 95 L 430 109 Z',
+ 'cheek-blades':'M 386 118 L 344 105 L 362 131 L 339 142 L 376 152 L 357 173 L 400 161 Z',
+ 'muzzle':'M 427 120 L 491 99 L 506 109 L 502 118 L 443 139 Z M 402 145 L 443 145 L 493 130 L 503 137 Q 458 164 420 170 L 393 159 Z',
+ 'nose':'M 483 107 L 496 106 L 492 113 L 484 114 Z',
+ 'mouth-line':'M 425 144 L 500 119',
+ 'mouth':'M 425 144 L 500 119',
+ 'fangs':'M 465 129 L 474 140 L 477 125 Z M 487 120 L 493 132 L 498 117 Z',
+ 'near-eye-socket':'M 397 110 L 439 103 L 440 126 Q 421 143 400 131 Z',
+ 'near-eye-white':'M 403 115 L 434 109 L 434 124 Q 422 135 405 128 Z',
+ 'near-pupil':'M 422 121 C 422 112 430 112 430 121 C 430 130 422 130 422 121 Z'
+};
+function samples(polys,n=72){
+ const p=polys[0],edges=p.map((v,i)=>{const q=p[(i+1)%p.length];return Math.hypot(q[0]-v[0],q[1]-v[1]);}),total=edges.reduce((a,b)=>a+b,0);
+ return Array.from({length:n},(_,i)=>{let s=i*total/n,j=0;while(j<edges.length-1&&s>edges[j])s-=edges[j++];const a=p[j],b=p[(j+1)%p.length],f=edges[j]?s/edges[j]:0;return [a[0]+(b[0]-a[0])*f,a[1]+(b[1]-a[1])*f];});
+}
+export function turnHead(paths,amount){
+ return paths.map(p=>{
+  if(p.group!=='head'&&p.group!=='eyes'&&!['neck','throat','throat-plates','spine'].includes(p.id))return p;
+  if(p.group!=='head'&&p.group!=='eyes')return {...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>[x+22*amount*Math.max(0,Math.min(1,(290-y)/110)),y]))};
+  if(p.id.startsWith('far-eye')||p.id==='far-pupil'){
+   return {...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>[390+(x-390)*(1-amount),122+(y-122)*(1-amount)]))};
+  }
+  const d=shapes[p.id];if(!d)return p;
+  const target=flattenPath(d);if(amount>=.999)return {...p,polygons:target};
+  if(amount<=0)return p;
+  const a=samples(p.polygons),b=samples(target);
+  return {...p,polygons:[a.map(([x,y],i)=>[x+(b[i][0]-x)*amount,y+(b[i][1]-y)*amount])]};
+ });
+}

package/vendor/dragonlab/design/drago/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 {renderDrago,DRAGO_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('Drago V4 scoped fire 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(DRAGO_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','DRAGO\nOn guard.');
+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/drago-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=renderDrago(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
+ console.log((large?[...cellsToAnsi(r.frame),...composeMessage(null,message,{terminalCols:w})]:composeMessage(r.frame,message,{terminalCols:w})).join('\n'));
+}

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

@@ -0,0 +1,56 @@
+import {performance} from 'node:perf_hooks';
+import {DRAGO_CLIPS,renderDrago,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?DRAGO_CLIPS.find(c=>c.id===scene):null;
+  const duration=(config.arrival&&options.deck?4800: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?renderDrago(paths,scene,t,options):renderStory(paths,t,options);
+    if(!r?.ok)throw new Error(r?.code??'Invalid story frame');
+    const caption=message??'DRAGO · '+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/hyperion/v1/hyperion-master.svg

@@ -0,0 +1,56 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 800 480">
+<title>Hyperion — gentle bronze guardian, first terminal anatomy</title>
+<g id="far-wing">
+<path id="far-wing-membrane" fill="#a66b32" d="M 298 288 C 242 247 206 210 182 157 C 151 99 130 61 111 32 C 115 127 94 227 51 326 C 90 292 110 271 130 268 C 145 280 155 291 162 307 C 190 272 220 269 242 297 L 298 323 Z"/>
+<path id="far-wing-spar" fill="none" stroke="#e9b966" stroke-width="10" d="M 294 294 C 210 224 158 125 111 32 M 111 32 C 118 141 96 238 51 326 M 120 123 C 134 199 145 256 162 307 M 153 179 C 195 210 220 249 242 297"/>
+<path id="far-wing-claw" fill="#f7dfac" d="M 106 55 C 98 35 104 18 127 16 C 121 30 115 45 106 55 Z"/>
+</g>
+<g id="near-wing">
+<path id="near-wing-membrane" fill="#bf813e" d="M 409 280 C 470 241 507 187 540 118 C 561 71 582 43 608 28 C 611 134 665 223 718 310 C 677 281 644 270 623 282 C 599 291 589 307 582 326 C 552 294 524 285 499 304 C 474 325 462 344 459 362 L 412 324 Z"/>
+<path id="near-wing-spar" fill="none" stroke="#edb967" stroke-width="11" d="M 420 293 C 500 227 541 112 608 28 M 608 28 C 609 142 660 228 718 310 M 608 28 C 559 142 563 233 582 326 M 555 134 C 519 188 504 246 499 304"/>
+<path id="near-wing-claw" fill="#ffe6b0" d="M 600 47 C 582 31 597 11 624 16 C 617 25 611 36 600 47 Z"/>
+</g>
+<g id="tail">
+<path id="tail-mass" fill="#b77935" d="M 421 363 C 477 386 523 410 590 413 C 652 416 716 401 733 362 C 753 317 735 277 703 270 C 670 261 645 277 641 302 C 635 327 650 348 671 349 C 694 351 705 335 701 320 C 696 336 678 336 671 326 C 659 311 674 293 691 299 C 710 304 714 331 699 351 C 676 378 626 382 580 368 C 522 351 486 326 440 321 Z"/>
+<path id="tail-belly" fill="#e2c18a" d="M 438 370 C 509 404 557 425 622 417 C 665 414 707 396 720 377 C 672 399 625 403 586 396 C 528 387 489 362 448 342 Z"/>
+<path id="tail-ridges" fill="#e9b968" d="M 503 349 L 516 330 L 529 361 M 548 365 L 563 346 L 576 376 M 596 380 L 612 363 L 624 382 M 651 375 L 665 354 L 676 368 M 699 348 L 719 343 L 707 365"/>
+</g>
+<g id="rear-feet">
+<path id="far-rear-leg" fill="#80532d" d="M 409 333 C 447 321 486 343 497 378 L 510 410 C 525 421 522 440 502 442 L 452 440 C 440 428 444 406 429 392 Z"/>
+<path id="far-foot" fill="#d5ad72" d="M 448 420 Q 460 406 469 424 Q 477 405 487 424 Q 501 410 510 431 L 453 434 Z"/>
+</g>
+<g id="body">
+<path id="body-mass" fill="#b97f3c" d="M 299 223 C 260 242 245 300 262 355 C 280 404 332 422 401 404 C 454 412 483 370 466 327 C 452 289 415 272 391 244 Z"/>
+<path id="shoulder-light" fill="#dba04f" d="M 363 236 C 399 243 431 280 437 317 C 413 300 395 291 373 301 L 331 270 Z"/>
+<path id="belly" fill="#f4dcb0" d="M 290 220 C 270 262 269 310 288 350 C 301 378 331 392 361 383 C 387 375 395 342 385 308 C 375 274 368 244 356 219 Z"/>
+<path id="belly-bands" fill="none" stroke="#b89159" stroke-width="5" d="M 281 254 Q 325 277 370 252 M 277 285 Q 323 309 379 281 M 280 319 Q 328 340 386 314 M 295 350 Q 337 371 382 345"/>
+</g>
+<g id="front-feet">
+<path id="far-front-leg" fill="#a76e34" d="M 274 296 C 248 300 241 341 239 378 C 224 393 212 412 222 432 C 235 447 276 446 289 434 C 299 421 287 400 290 379 L 306 332 Z"/>
+<path id="far-front-toes" fill="#efd6a5" d="M 220 424 C 218 411 231 404 238 421 C 240 400 253 402 258 422 C 266 403 278 411 278 433 L 225 435 Z"/>
+<path id="near-front-leg" fill="#cf9247" d="M 385 289 C 358 291 352 321 356 351 C 363 376 349 402 338 414 C 325 433 335 451 357 454 L 403 454 C 423 448 428 434 417 416 C 407 398 421 369 423 343 C 425 315 411 292 385 289 Z"/>
+<path id="near-front-toes" fill="#ffe4ae" d="M 339 441 C 337 423 349 417 357 438 C 359 412 374 412 380 438 C 387 417 401 418 405 442 C 409 431 416 432 417 445 Q 380 458 339 449 Z"/>
+<path id="toe-cuts" fill="none" stroke="#080d19" stroke-width="4" d="M 357 438 L 358 451 M 380 438 L 381 452 M 405 442 L 405 448"/>
+</g>
+<g id="head">
+<path id="far-horn" fill="#e7cf9a" d="M 283 124 C 254 101 243 76 246 53 C 262 70 282 80 304 89 Z"/>
+<path id="neck" fill="#c98c43" d="M 290 173 C 263 209 265 247 280 264 C 302 280 356 278 380 254 C 390 233 379 201 369 174 Z"/>
+<path id="throat" fill="#f8deb0" d="M 284 188 C 271 212 277 242 293 254 C 314 263 344 252 353 232 L 351 192 Z"/>
+<path id="head-mass" fill="#d39b50" d="M 271 113 C 278 82 318 73 353 91 C 381 105 391 131 386 158 C 385 188 366 212 339 220 C 306 229 273 210 262 186 C 251 162 257 137 271 113 Z"/>
+<path id="near-horn" fill="#ffe7b7" d="M 350 112 C 360 86 383 76 402 69 C 425 62 436 49 446 33 C 449 64 428 91 405 106 C 385 119 367 123 350 112 Z"/>
+<path id="crest" fill="#efc57e" d="M 291 98 L 298 64 L 315 86 L 335 55 L 342 87 L 361 70 L 365 102 Z"/>
+<path id="cheek-fin" fill="#e9b86b" d="M 372 148 Q 403 128 421 155 Q 399 154 384 170 Q 411 172 414 192 Q 393 182 377 188 Z"/>
+<path id="muzzle" fill="#efd09a" d="M 261 166 C 241 166 235 180 242 195 C 250 211 283 216 310 214 C 340 215 360 201 358 189 C 338 196 318 193 304 181 C 289 169 273 166 261 166 Z"/>
+<path id="nostril" fill="#080d19" d="M 256 180 C 256 173 267 173 268 179 C 269 185 257 186 256 180 Z"/>
+<path id="mouth-line" fill="none" stroke="#080d19" stroke-width="4" d="M 252 199 Q 299 219 347 196"/>
+</g>
+<g id="eyes">
+<path id="far-eye-socket" fill="#080d19" d="M 271 139 C 271 121 282 112 293 122 C 303 131 302 150 295 161 C 280 173 270 158 271 139 Z"/>
+<path id="far-eye-white" fill="#f8faff" d="M 276 140 C 276 125 284 119 291 127 C 298 136 297 150 291 157 C 281 163 275 153 276 140 Z"/>
+<path id="far-pupil" fill="#080d19" d="M 283 143 C 283 133 293 133 293 143 C 293 153 283 153 283 143 Z"/>
+<path id="near-eye-socket" fill="#080d19" d="M 314 144 C 314 121 334 109 351 121 C 368 134 365 157 353 172 C 335 185 314 171 314 144 Z"/>
+<path id="near-eye-white" fill="#f8faff" d="M 320 144 C 320 126 334 117 347 128 C 360 139 356 157 348 165 C 335 175 320 163 320 144 Z"/>
+<path id="near-pupil" fill="#080d19" d="M 331 146 C 331 133 346 133 346 146 C 346 159 331 159 331 146 Z"/>
+<path id="near-brow" fill="none" stroke="#f0bf71" stroke-width="5" d="M 315 116 Q 336 102 355 117"/>
+</g>
+</svg>

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

@@ -0,0 +1,79 @@
+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 HYPERION_CLIPS=Object.freeze([
+ {id:'idle',title:'Steady Company',duration:12000},
+ {id:'attach',title:'At Your Service',duration:3400},
+ {id:'curious',title:'Let Me Look',duration:2600},
+ {id:'focus',title:'Careful Work',duration:2800},
+ {id:'concerned',title:'Something Needs Care',duration:2600},
+ {id:'proud',title:'A Job Well Done',duration:2600},
+ {id:'standby',title:'Keeping Watch',duration:3000},
+ {id:'cluster',title:'Cluster Forge',duration:4800,power:true},
+]);
+export const STORY=[['attach',3400],['idle',1800],['curious',2200],['focus',2200],['cluster',4800],['proud',2200],['concerned',2200],['standby',2200],['idle',3000]];
+export const STORY_DURATION=STORY.reduce((n,b)=>n+b[1],0);
+const captions={idle:'Steady company.',attach:'I am here.',curious:'Let me take a closer look.',focus:'One careful step at a time.',concerned:'This needs attention.',proud:'A satisfying result · expression demo',standby:'Keeping watch.',cluster:'Cluster Forge · visual demonstration'};
+export function bodyPose(ms){const t=ms%12000;return {wing:.018*pulse(t,2200,5400),far:.012*pulse(t,2600,5800),tail:.65*pulse(t,5500,9500),nod:2*pulse(t,800,3700),turn:.012*pulse(t,800,3700)};}
+function performance(scene,t){
+ const base={gx:0,open:t%6000>4500&&t%6000<4680?.18:1};
+ switch(scene){
+ case 'curious':return {gx:-.65*ease(t/700),open:1.12};
+ case 'focus':return {gx:.6,open:.65};
+ case 'concerned':return {gx:.45*Math.sin(t/600),open:.85};
+ case 'proud':return {gx:0,open:1.15};
+ case 'standby':return {gx:0,open:.8};
+ default:return base;
+ }
+}
+const rot=(x,y,cx,cy,a)=>[cx+(x-cx)*Math.cos(a)-(y-cy)*Math.sin(a),cy+(x-cx)*Math.sin(a)+(y-cy)*Math.cos(a)];
+export function poseRig(rig,pose,face){
+ const paths=rig.paths.map(p=>({...p,polygons:p.polygons.map(poly=>poly.map(([x,y])=>{
+  if(p.id.endsWith('-eye-white')||p.id.endsWith('-pupil')){
+   const cy=p.id.startsWith('far-')?141:145;y=cy+(y-cy)*face.open;
+   if(p.id.endsWith('-pupil'))x+=face.gx*5;
+  }
+  if(p.group==='near-wing')return rot(x,y,420,293,pose.wing);
+  if(p.group==='far-wing')return rot(x,y,294,294,-pose.far);
+  if(p.group==='tail'){const w=ease((x-490)/210);return [x-4*pose.tail*w,y-5*pose.tail*w];}
+  if(p.group==='head'||p.group==='eyes'){
+   const w=p.id==='neck'||p.id==='throat'?ease((275-y)/85):1;
+   const [rx,ry]=rot(x,y,330,255,pose.turn*w);return [rx,ry+pose.nod*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 cluster(frame,t,mono){
+ // Ordered points in the empty gap above the right shoulder, never over ink.
+ const rows=frame.length,cols=frame[0].length;
+ const nodes=[[.51,.22],[.57,.12],[.64,.22]],progress=ease(t/3300),fade=1-ease((t-3900)/900);let count=0;
+ const put=(x,y,bright=false)=>{x=Math.round(x*cols);y=Math.round(y*rows);if(x<1||x>=cols-1||y<1||y>=rows-1||frame[y][x].ch!==' '||fade<.05)return;frame[y][x]={ch:bright?'⠿':'⠂',bg:null,rgb:mono?null:(bright?[246,247,255]:[104,211,229]).map(v=>Math.round(v*fade))};count++;};
+ for(let i=0;i<3;i++)if(progress>(i+1)/8)put(...nodes[i],true);
+ for(let e=0;e<3;e++){const a=nodes[e],b=nodes[(e+1)%3];for(let j=1;j<8;j++)if(progress>.45+(e+j/8)*.16)put(a[0]+(b[0]-a[0])*j/8,a[1]+(b[1]-a[1])*j/8);}
+ return count;
+}
+export function renderHyperion(rig,scene='idle',ms=0,options={}){
+ const clip=HYPERION_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?clip.duration*.65:0):ms;
+ let face=performance(scene,t),pose=bodyPose(options.motionTime??t);
+ if(scene==='attach'){
+  const duration=options.deck?4400:3400;
+  if(t>=duration){pose=bodyPose(t-duration);face=performance('idle',t-duration);}
+  else{const u=t/duration;pose={wing:.025*pulse(u,.15,.85),far:.018*pulse(u,.22,.92),tail:.55*pulse(u,.25,1),nod:4*pulse(u,.35,.9),turn:.016*pulse(u,0,.8)};face={gx:.5*pulse(u,0,.85),open:1+.1*pulse(u,.1,.85)};}
+ }
+ if(scene==='proud')pose={...pose,nod:pose.nod-2*pulse(t,0,2600)};
+ if(options.still)pose={wing:0,far:0,tail:0,nod:0,turn:0};
+ const posed=poseRig(rig,pose,face),r=renderSvgRig(posed,options);
+ const effectCells=clip.power?cluster(r.frame,t,options.mono):0;
+ return {...r,scene,clip:clip.title,caption:captions[scene],pose,face,effectCells,staticStudy:false};
+}
+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 renderHyperion(rig,scene,t,{...options,deck:false,motionTime:Math.max(0,ms-3400)});t-=duration;}
+}

package/vendor/dragonlab/design/hyperion/v2/review.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import fs from 'node:fs/promises';
+import {parseSvgRig} from '../../../factory/svg-rig.mjs';
+import {renderHyperion,HYPERION_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('Hyperion V2 acting 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(HYPERION_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):slot.cols)),rows=Number(value('--rows',large?Math.min(36,h-4):slot.rows));
+const message=value('--message','HYPERION\nSteady company.');
+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/hyperion-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=renderHyperion(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
+ console.log((large?[...cellsToAnsi(r.frame),...composeMessage(null,message,{terminalCols:w})]:composeMessage(r.frame,message,{terminalCols:w})).join('\n'));
+}

package/vendor/dragonlab/design/hyperion/v2/watch.mjs

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

@@ -0,0 +1,22 @@
+/** Notice → acknowledge → settle. Pure authored timing; no visibility wipe. */
+import {motionAt} from './motion.mjs';
+export const ARRIVAL_DURATION=3200;
+export const DECK_ARRIVAL_DURATION=4400;
+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 function arrivalPose(ms,{deck=false}={}){
+  if(!Number.isFinite(ms)||ms<0)throw new RangeError('Arrival time must be nonnegative.');
+  const duration=deck?DECK_ARRIVAL_DURATION:ARRIVAL_DURATION;
+  if(ms>=duration)return {face:null,motion:motionAt(ms-duration),phase:'present',duration};
+  const t=ms/duration*ARRIVAL_DURATION,gain=deck?1.12:1;
+  const attention=pulse(t,100,2300),welcome=pulse(t,650,2750);
+  return {
+    phase:t<700?'notice':t<1800?'acknowledge':'settle',duration,
+    face:{gx:.65*ease(t/450)*(1-ease((t-1700)/1100)),gy:-.18*attention,
+      open:1+.15*welcome},
+    motion:{tail:gain*(.82*pulse(t,150,1850)-.32*pulse(t,1800,3050)),
+      wing:gain*.052*pulse(t,650,2650),farWing:gain*.032*pulse(t,850,2850),
+      neck:gain*.031*attention,nod:gain*(-2*attention+4*pulse(t,1400,2800))},
+  };
+}