@yunhozz/arc 0.2.0 → 0.2.1

package/lib/tui/render.mjs

@@ -4,18 +4,40 @@ export function escapeTerminalText(value=''){
   const code=character.codePointAt(0);return code<=255?'\\x'+code.toString(16).padStart(2,'0'):'\\u{'+code.toString(16)+'}';
  });
 }
-function width(character){return /[\p{Mark}]/u.test(character)?0:character.codePointAt(0)>=0x1100?2:1;}
+function width(character){return /[\p{Mark}]/u.test(character)?0:/[\u2190-\u2193\u2500-\u257f\u2588]/u.test(character)?1:character.codePointAt(0)>=0x1100?2:1;}
 function fit(text,columns){let used=0,result='';for(const character of text){const size=width(character);if(used+size>columns)return{text:result,complete:false};result+=character;used+=size;}return{text:result,complete:true};}
+export function navigationHint(mode='menu',{backLabel='back',hasNext=false}={}){
+ if(mode==='text')return'Type/Paste Input · ← Delete · Enter Continue · Esc/Backspace Back';
+ if(mode==='busy')return'Ctrl+C Interrupt';
+ if(mode==='page'||mode==='reviewPage')return'↑/↓: Scroll · Enter '+(mode==='page'?'Back':hasNext?'Next':'Continue')+' · Esc Back';
+ return'↑/↓: Select · Enter Continue · Esc '+(backLabel==='exit'?'Exit':'Back');
+}
+export function wrapDetailRows(rows,columns){
+ const available=Math.max(2,Math.floor(Number(columns)||80)-3),result=[];
+ for(const row of rows){const escaped=escapeTerminalText(row);let line='',used=0;for(const character of escaped){const size=width(character);if(used+size>available){result.push(line);line='';used=0;}line+=character;used+=size;}result.push(line);}
+ return result;
+}
+const wordmark=['  █████    ███████     ███████ ','██     ██  ██    ██   ██       ','█████████  ███████    ██       ','██     ██  ██   ██    ██       ','██     ██  ██    ██    ███████ '];
+const logoStart=Math.min(...wordmark.map(row=>row.indexOf('█'))),logoEnd=Math.max(...wordmark.map(row=>row.lastIndexOf('█')));
+const logoStops=[[183,228,199],[116,198,157],[64,145,108]];
+function logoColor(column){const position=(column-logoStart)/(logoEnd-logoStart)*2,segment=Math.min(1,Math.floor(position)),fraction=position-segment;return logoStops[segment].map((value,index)=>Math.round(value+(logoStops[segment+1][index]-value)*fraction));}
+
 export function renderScreen(screen={}, {columns=80,rows=24}={}){
  // Leave the last column unused to avoid terminal autowrap at the right edge.
  columns=Math.max(1,Math.floor(Number(columns)||80)-1);rows=Math.max(1,Math.floor(Number(rows)||24));
- const entries=screen.rows??[],hint=screen.hint??'Up/Down: select | Enter: continue | Esc: back';
- const lines=[escapeTerminalText(screen.title),...entries.map((row,index)=>(index===screen.selected?'> ':'  ')+escapeTerminalText(row)),escapeTerminalText(hint)];
+ const entries=screen.rows??[],hint=screen.hint??navigationHint('menu');
+ const heading=screen.wordmark?[...wordmark,'─'.repeat(Math.min(columns,34))]:[escapeTerminalText(screen.title)],position=screen.position?[escapeTerminalText(screen.position)]:[];
+ const lines=[...heading,...entries.map((row,index)=>(index===screen.selected?'> ':'  ')+escapeTerminalText(row)),...position,escapeTerminalText(hint)];
  const fitted=lines.map(line=>fit(line,columns));
  const required=screen.requiredRows??entries.map((_,index)=>index);
- const requiredVisible=required.every(index=>Number.isInteger(index)&&index>=0&&index<entries.length&&index+1<rows-1&&fitted[index+1].complete);
- const applyEnabled=!screen.requiresConfirmation||(requiredVisible&&fitted[0].complete&&lines.length<=rows&&fitted.at(-1).complete);
+ const requiredVisible=required.every(index=>Number.isInteger(index)&&index>=0&&index<entries.length&&index+heading.length<rows-1-position.length&&fitted[index+heading.length].complete);
+ const applyEnabled=!screen.requiresConfirmation||(requiredVisible&&heading.every((_,index)=>fitted[index].complete)&&lines.length<=rows&&fitted.at(-1).complete&&position.every((_,index)=>fitted[lines.length-2-index].complete));
  const visible=fitted.slice(0,rows).map(line=>line.text);
  if(!applyEnabled)visible[visible.length-1]=fit('Resize terminal to review before applying.',columns).text;
- return{text:visible.join('\n'),applyEnabled};
+ const styles=[];
+ if(screen.wordmark){for(let index=0;index<Math.min(wordmark.length,visible.length);index++){if(visible[index]===fitted[index].text)styles.push({line:index,color:'logo',cells:[...visible[index]].flatMap((character,column)=>character==='█'?[{column,rgb:logoColor(column)}]:[])});}if(visible.length>wordmark.length&&visible[wordmark.length]===fitted[wordmark.length].text)styles.push({line:wordmark.length,color:'green'});}
+ const selectedLine=heading.length+screen.selected;
+ if(Number.isInteger(screen.selected)&&screen.selected>=0&&screen.selected<entries.length&&selectedLine<visible.length&&!(screen.requiresConfirmation&&!applyEnabled&&selectedLine===visible.length-1)){const used=[...visible[selectedLine]].reduce((sum,character)=>sum+width(character),0);visible[selectedLine]+=' '.repeat(Math.max(0,Math.min(columns,34)-used));styles.push({line:selectedLine,color:'selected'});}
+
+ return{text:visible.join('\n'),applyEnabled,styles};
 }

package/lib/tui/setup.mjs

@@ -3,12 +3,13 @@ export function initialSettings(statuses){return Object.fromEntries(['codex','cl
 export function setupOptions(draft,target){if(target==='all'&&JSON.stringify(draft.codex)!==JSON.stringify(draft.claude))throw Error('Target settings differ. Explicitly select common values before applying to both.');return{...draft[target==='all'?'codex':target],target};}
 export async function runSetup({ui,statuses,draft,kind,prepare}){
  for(const[key,value]of Object.entries(initialSettings(statuses)))draft[key]??=value;
- while(true){const targetIndex=await ui.menu(kind==='preset'?'Change Preset':'Install / Reconfigure',['Codex','Claude','Both targets']);if(targetIndex===null)return null;const target=['codex','claude','all'][targetIndex];
+ let selectedTarget=0;
+ while(true){const targetIndex=await ui.menu(kind==='preset'?'Change Preset':'Install / Reconfigure',['Codex','Claude','Both targets'],{selected:selectedTarget});if(targetIndex===null)return null;selectedTarget=targetIndex;const target=['codex','claude','all'][targetIndex];
   if(target==='all'&&JSON.stringify(draft.codex)!==JSON.stringify(draft.claude)){
    const choice=await ui.menu('Target settings differ',['Back','Use Codex values for both','Use Claude values for both'],{info:['Codex: '+summary(draft.codex),'Claude: '+summary(draft.claude),'Choosing common values replaces the other target values.']});if(choice===null||choice===0)continue;const source=choice===1?'codex':'claude';draft.codex={...draft[source]};draft.claude={...draft[source]};
   }
-  const settings=draft[target==='all'?'codex':target];let editing=true;
-  while(editing){const labels=kind==='preset'?['Preset: '+settings.preset,'Review changes']:['Preset: '+settings.preset,'Harness language: '+settings.language,'Total subagents: '+settings.maxTotalSubagents,'Concurrent subagents: '+settings.maxConcurrentSubagents,'Apply global settings: '+!settings.skipGlobal,'Review changes'];const field=await ui.menu('Settings — '+target,labels);if(field===null)break;
+  const settings=draft[target==='all'?'codex':target];let editing=true,selectedField=0;
+  while(editing){const labels=kind==='preset'?['Preset: '+settings.preset,'Review changes']:['Preset: '+settings.preset,'Harness language: '+settings.language,'Total subagents: '+settings.maxTotalSubagents,'Concurrent subagents: '+settings.maxConcurrentSubagents,'Apply global settings: '+!settings.skipGlobal,'Review changes'];const field=await ui.menu('Settings — '+target,labels,{selected:selectedField});if(field===null)break;selectedField=field;
    if(field===0){const value=await ui.menu('Performance preset',['Economy','Balanced','Smart'],{selected:['economy','balanced','smart'].indexOf(settings.preset)});if(value!==null)settings.preset=['economy','balanced','smart'][value];}
    else if(kind==='install'&&field===1){const value=await ui.menu('Harness output language',['English','Korean'],{selected:settings.language==='ko'?1:0});if(value!==null)settings.language=['en','ko'][value];}
    else if(kind==='install'&&(field===2||field===3)){const key=field===2?'maxTotalSubagents':'maxConcurrentSubagents';const raw=await ui.text(field===2?'Maximum total subagents':'Maximum concurrent subagents',String(settings[key]));if(raw!==null)try{settings[key]=parsePositiveLimit(raw);}catch{await ui.page('Invalid limit',['Enter a positive safe ASCII decimal integer.']);}}

package/lib/tui/terminal.mjs

@@ -10,9 +10,11 @@ import {renderScreen} from './render.mjs';
  * discards unread events; a chunk is fully decoded before resolving a reader,
  * so an Enter followed by EOF in that chunk cannot escape shutdown.
  */
-export function createTerminalSession({input=process.stdin,output=process.stdout,signals=process}={}){
+export function createTerminalSession({input=process.stdin,output=process.stdout,signals=process,env=process.env}={}){
  if(!input.isTTY||!output.isTTY)throw Object.assign(Error('An interactive terminal is required.'),{code:'ARC_TUI_TERMINAL'});
  const wasRaw=Boolean(input.isRaw),wasFlowing=input.readableFlowing;
+ const colorEnabled=env.NO_COLOR===undefined&&env.TERM!=='dumb';
+ const truecolor=colorEnabled&&(/^(truecolor|24bit)$/i.test(env.COLORTERM??'')||/^(ghostty|cmux)$/i.test(env.TERM_PROGRAM??'')||/-direct$/.test(env.TERM??'')||(output.getColorDepth?.()??0)>=24);
  let disposed=false,busy=false,parsing=false,pending='',paste=null,sequence=0,escapeTimer,waiter,queue=[],screen,lastLines=0,applyEnabled=true;
  let decoder=new StringDecoder('utf8'),lastWasCR=false;
  const clearTimer=()=>{clearTimeout(escapeTimer);escapeTimer=undefined;};
@@ -26,7 +28,7 @@ export function createTerminalSession({input=process.stdin,output=process.stdout
   output.removeListener('resize',onResize);output.removeListener('error',onError);signals.removeListener('SIGINT',onSigint);signals.removeListener('SIGTERM',onSigterm);
   try{if(input.setRawMode&&!input.destroyed)input.setRawMode(wasRaw);}finally{
    try{if(wasFlowing!==true)input.pause();}finally{
-    try{output.write('\x1b[?2004l\x1b[?25h\n');}finally{if(waiter){const resolve=waiter;waiter=undefined;resolve({name:'eof',sequence});}}
+    try{output.write('\x1b[0m\x1b[?2004l\x1b[?25h\n');}finally{if(waiter){const resolve=waiter;waiter=undefined;resolve({name:'eof',sequence});}}
    }
   }
  }
@@ -39,7 +41,15 @@ export function createTerminalSession({input=process.stdin,output=process.stdout
   const result=renderScreen(screen,{columns:output.columns,rows:output.rows});applyEnabled=result.applyEnabled;
   if(lastLines)output.write(`\x1b[${lastLines}A\r`);
   const lines=result.text.split('\n');
-  for(let index=0;index<Math.max(lastLines,lines.length);index++)output.write('\x1b[2K'+(lines[index]??'')+'\n');
+  for(let index=0;index<Math.max(lastLines,lines.length);index++){
+   let line=lines[index]??'';const style=result.styles.find(style=>style.line===index);
+   if(style&&colorEnabled){
+    if(style.color==='logo'&&truecolor){const cells=new Map(style.cells.map(cell=>[cell.column,cell.rgb]));line=[...line].map((character,column)=>cells.has(column)?'\x1b[38;2;'+cells.get(column).join(';')+'m'+character+'\x1b[0m':character).join('');}
+    else{const color=style.color==='logo'?'\x1b[92m':style.color==='selected'?(truecolor?'\x1b[48;2;16;55;26m\x1b[38;2;220;245;224m':'\x1b[42;30m'):'\x1b[32m';line=color+line+'\x1b[0m';}
+   }
+   output.write('\x1b[2K'+line+'\n');
+  }
+
   if(lastLines>lines.length)output.write(`\x1b[${lastLines-lines.length}A\r`);
   lastLines=lines.length;return result;
  }
@@ -67,5 +77,5 @@ export function createTerminalSession({input=process.stdin,output=process.stdout
  function onData(chunk){if(disposed||busy)return;sequence++;clearTimer();pending+=typeof chunk==='string'?chunk:decoder.write(chunk);parsing=true;try{parse();}finally{parsing=false;if(waiter&&queue.length){const resolve=waiter;waiter=undefined;resolve(queue.shift());}}}
  input.on('data',onData);input.on('end',onEnd);input.on('close',onEnd);input.on('error',onError);output.on('resize',onResize);output.on('error',onError);signals.on('SIGINT',onSigint);signals.on('SIGTERM',onSigterm);
  try{input.setRawMode?.(true);input.resume();output.write('\x1b[?25l\x1b[?2004h');}catch(error){dispose();throw error;}
- return{render,discardInput,dispose,setBusy(value){busy=Boolean(value);discardInput();},nextEvent(){if(queue.length)return Promise.resolve(queue.shift());if(disposed)return Promise.resolve({name:'eof',sequence});if(waiter)return Promise.reject(Error('Only one terminal event reader is allowed.'));return new Promise(resolve=>{waiter=resolve;});}};
+ return{render,discardInput,dispose,viewport(){return{columns:output.columns??80,rows:output.rows??24};},setBusy(value){busy=Boolean(value);discardInput();},nextEvent(){if(queue.length)return Promise.resolve(queue.shift());if(disposed)return Promise.resolve({name:'eof',sequence});if(waiter)return Promise.reject(Error('Only one terminal event reader is allowed.'));return new Promise(resolve=>{waiter=resolve;});}};
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@yunhozz/arc",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"