archymedes-cli 2.2.0 → 2.3.0

package/README.md

@@ -312,13 +312,23 @@ The startup geometry makes a brief rotation on roomy interactive terminals. Set
 
 ## Fixed workspace
 
-Start with `archymedes --layout fixed` for a persistent mode bar, an anchored composer, and menus
-that open inside the transcript area. `/layout` switches layouts during a session;
-`ARCHYMEDES_LAYOUT=fixed` makes the fixed workspace your launch preference.
-
-Use `/mode` to choose plan, build, auto, or defender with the arrow keys. Page Up / Page Down
-read retained transcript history; Escape returns to live output. Home and End still edit the
-composer. Each tab retains up to 5,000 output lines. Resize reflows the live transcript.
+Interactive sessions open in the fixed workspace: a persistent mode bar, an anchored composer, and
+menus that open inside the transcript area. `/layout` switches layouts during a session;
+`archymedes --layout scrollback` or `ARCHYMEDES_LAYOUT=scrollback` keeps the plain terminal log.
+
+Use `/mode` to choose plan, build, auto, or defender with the arrow keys. To read history, use the
+mouse wheel or Page Up / Page Down. Alt+Up / Alt+Down (or Ctrl) move one line, and Ctrl+Home jumps
+to the top. Escape, Ctrl+End, or scrolling back to the bottom returns to live output. History keeps
+its colours, a scrollbar shows your position, and the header counts output that arrived while you
+were reading. Arrow keys, Home and End still edit the composer. Wheel scrolling uses mouse
+reporting, so hold Shift to select text, or set `ARCHYMEDES_MOUSE=0` to keep the terminal's own
+selection. Each tab retains up to 5,000 output lines, and resizing reflows the transcript.
+
+`/find <text>` searches the tab's history and jumps to the first match; `/find` again moves to the
+next one, `/find prev` to the previous, and `/find off` or Escape returns to live output. `/pager`
+opens the whole transcript in `$PAGER` (`less -R` by default). `/cat image.png` draws a PNG in the
+transcript with coloured half-blocks; in the scrollback layout, `ARCHYMEDES_IMAGES=kitty` uses Kitty
+graphics for real pixels, and `/clear` removes them.
 
 The opening geometry rotates while the workspace is idle and settles as soon as you type.
 `ARCHYMEDES_NO_MOTION=1` disables this motion and menu focus animation. `--ascii`, `NO_COLOR`,

package/dist/{archymedes-wjaqydyg.mjs → archymedes-4kx65anz.mjs}

@@ -1,13 +1,14 @@
 import {
   SpringAnimator,
   paginator
-} from "./archymedes-r54qthg5.mjs";
+} from "./archymedes-g8y3rt6t.mjs";
 import {
   UNICODE_GLYPHS,
+  clipTo,
   visibleWidth
-} from "./archymedes-5zn4zp84.mjs";
+} from "./archymedes-a10k8yrk.mjs";
 
-// packages/archymedes-cli/src/chooser.ts
+// src/ui/chooser.ts
 var ALL_CHROME = { title: true, status: true, pagination: true, help: true };
 function chromeOf(chrome) {
   return { ...ALL_CHROME, ...chrome };
@@ -150,22 +151,6 @@ function renderChooser(state, items, options) {
   return lines.join(`
 `);
 }
-function clipTo(text, width, glyphs = UNICODE_GLYPHS) {
-  if (width <= 0)
-    return "";
-  if (visibleWidth(text) <= width)
-    return text;
-  const mark = visibleWidth(glyphs.ellipsis) < width ? glyphs.ellipsis : "";
-  const budget = width - visibleWidth(mark);
-  let out = "";
-  const segments = typeof Intl.Segmenter === "function" ? [...new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(text)].map((entry) => entry.segment) : [...text];
-  for (const segment of segments) {
-    if (visibleWidth(out + segment) > budget)
-      break;
-    out += segment;
-  }
-  return `${out}${mark}`;
-}
 async function runChooser(keys, items, paint, options) {
   let state = { selected: Math.max(0, Math.min(options.initialIndex ?? 0, Math.max(0, items.length - 1))), query: "" };
   const liveOptions = () => {
@@ -221,4 +206,4 @@ async function runChooser(keys, items, paint, options) {
   return;
 }
 
-export { INITIAL_CHOOSER_STATE, windowStart, terminalColumns, renderChooser, clipTo, runChooser };
+export { INITIAL_CHOOSER_STATE, filterItems, windowStart, terminalColumns, renderChooser, runChooser };

package/dist/{archymedes-5zn4zp84.mjs → archymedes-a10k8yrk.mjs}

@@ -1,4 +1,4 @@
-// packages/archymedes-cli/src/theme.ts
+// src/theme/theme.ts
 var BLUEPRINT = `
 /* Blueprint navy, chalk-white ink and an amber pencil — the original drafting table. */
 @theme blueprint {
@@ -296,9 +296,30 @@ function buildPalette(theme, depth) {
     tokens: theme.tokens
   };
 }
+var EXTERNAL_MARK = "\x1B[35m";
+var ANSI_PALETTE = buildPalette({ name: "ansi", description: "", tokens: DEFAULT_TOKENS }, "ansi256");
+function roleCode(role, palette, depth) {
+  if (depth === "none")
+    return "";
+  return palette?.[role] || ANSI_PALETTE[role];
+}
 var NO_COLOR_PALETTE = buildPalette(findBuiltinTheme(DEFAULT_THEME_NAME) ?? { name: DEFAULT_THEME_NAME, description: "", tokens: DEFAULT_TOKENS }, "none");
 
-// packages/archymedes-cli/src/glyphs.ts
+// src/text/ansi.ts
+var RESET = "\x1B[0m";
+var BOLD = "\x1B[1m";
+var DIM = "\x1B[2m";
+var ITALIC = "\x1B[3m";
+var STRIKE = "\x1B[9m";
+var REVERSE = "\x1B[7m";
+function paint(text, code, depth) {
+  return depth === "none" || code === "" ? text : `${code}${text}${RESET}`;
+}
+function paintAll(text, codes, depth) {
+  return depth === "none" || codes.length === 0 ? text : `${codes.join("")}${text}${RESET}`;
+}
+
+// src/text/glyphs.ts
 var UNICODE_GLYPHS = {
   starGlyphs: [".", "·", "✧", "✦", "✶"],
   spinnerFrames: ["  ◜  ", "  ◠  ", "  ◝  ", "  ◞  ", "  ◡  ", "  ◟  "],
@@ -405,20 +426,14 @@ function borderGlyphsFor(style, glyphs) {
   return ROUND_BORDER;
 }
 
-// packages/archymedes-cli/src/markdown.ts
-var RESET = "\x1B[0m";
-var BOLD = "\x1B[1m";
-var DIM = "\x1B[2m";
-var ITALIC = "\x1B[3m";
-var STRIKE = "\x1B[9m";
-var CYAN = "\x1B[36m";
-var BLUE = "\x1B[34m";
-var GREEN = "\x1B[32m";
-var YELLOW = "\x1B[33m";
+// src/text/text-width.ts
 var ANSI = /\x1b\[[0-9;]*m/g;
+var PRINTABLE_ASCII = /^[\x20-\x7e]*$/;
 function visibleWidth(text) {
+  if (PRINTABLE_ASCII.test(text))
+    return text.length;
   let width = 0;
-  for (const character of text.replace(ANSI, "")) {
+  for (const character of text.includes("\x1B") ? text.replace(ANSI, "") : text) {
     const code = character.codePointAt(0) ?? 0;
     if (code >= 768 && code <= 879)
       continue;
@@ -429,218 +444,21 @@ function visibleWidth(text) {
 function isWide(code) {
   return code >= 4352 && code <= 4447 || code >= 11904 && code <= 42191 || code >= 44032 && code <= 55203 || code >= 63744 && code <= 64255 || code >= 65072 && code <= 65135 || code >= 65280 && code <= 65376 || code >= 127744 && code <= 129535;
 }
-var INLINE_PATTERN = /(?<!\\)(`[^`\n]+`)|(?<!\\)(\*\*[^*\n]+\*\*)|(?<!\\)(__[^_\n]+__)|(?<!\\)(~~[^~\n]+~~)|(?<!\\)(\*[^*\n]+\*)|(?<!\\)(_[^_\n]+_)|(!?\[([^\]\n]+)\]\((https?:\/\/[^\s)\n]+)\))|(<(https?:\/\/[^>\s]+)>)/g;
-var unescapeMarkdown = (text) => text.replace(/\\([\\`*_[\]{}()#+.!~>-])/g, "$1");
-function parseInline(line) {
-  const tokens = [];
-  let lastIndex = 0;
-  INLINE_PATTERN.lastIndex = 0;
-  for (let match = INLINE_PATTERN.exec(line);match !== null; match = INLINE_PATTERN.exec(line)) {
-    if (match.index > lastIndex)
-      tokens.push({ text: unescapeMarkdown(line.slice(lastIndex, match.index)), code: "" });
-    const [whole, code, boldStars, boldUnderscores, strike, italicStars, italicUnderscores, link, linkLabel, linkUrl, autolink, autolinkUrl] = match;
-    if (code !== undefined)
-      tokens.push({ text: code.slice(1, -1), code: CYAN });
-    else if (boldStars !== undefined)
-      tokens.push({ text: boldStars.slice(2, -2), code: BOLD });
-    else if (boldUnderscores !== undefined)
-      tokens.push({ text: boldUnderscores.slice(2, -2), code: BOLD });
-    else if (strike !== undefined)
-      tokens.push({ text: strike.slice(2, -2), code: STRIKE });
-    else if (italicStars !== undefined)
-      tokens.push({ text: italicStars.slice(1, -1), code: ITALIC });
-    else if (italicUnderscores !== undefined)
-      tokens.push({ text: italicUnderscores.slice(1, -1), code: ITALIC });
-    else if (link !== undefined)
-      tokens.push({ text: `${link.startsWith("!") ? `image: ${linkLabel}` : linkLabel} (${linkUrl})`, code: CYAN });
-    else if (autolink !== undefined)
-      tokens.push({ text: autolinkUrl, code: CYAN });
-    lastIndex = match.index + whole.length;
-  }
-  if (lastIndex < line.length)
-    tokens.push({ text: unescapeMarkdown(line.slice(lastIndex)), code: "" });
-  return tokens.filter((token) => token.text.length > 0);
-}
-function paint(text, code, depth) {
-  return depth === "none" || code === "" ? text : `${code}${text}${RESET}`;
-}
-function wrapTokens(tokens, width, options) {
-  const firstPrefix = options.firstPrefix ?? "";
-  const continuationPrefix = options.continuationPrefix ?? "";
-  const lines = [];
-  let current = "";
-  let currentWidth = 0;
-  let prefix = firstPrefix;
-  let prefixWidth = visibleWidth(firstPrefix);
-  const limit = Math.max(1, width);
-  const flush = () => {
-    lines.push(`${prefix}${current}`.replace(/[ \t]+$/, ""));
-    current = "";
-    currentWidth = 0;
-    prefix = continuationPrefix;
-    prefixWidth = visibleWidth(continuationPrefix);
-  };
-  for (const token of tokens) {
-    for (const word of token.text.split(/(\s+)/)) {
-      if (word === "")
-        continue;
-      const wordWidth = visibleWidth(word);
-      if (/^\s+$/.test(word)) {
-        if (currentWidth > 0 && prefixWidth + currentWidth + wordWidth <= limit) {
-          current += word;
-          currentWidth += wordWidth;
-        }
-        continue;
-      }
-      if (currentWidth > 0 && prefixWidth + currentWidth + wordWidth > limit)
-        flush();
-      if (prefixWidth + wordWidth > limit) {
-        let remaining = word;
-        while (remaining.length > 0) {
-          const available = Math.max(1, limit - prefixWidth - currentWidth);
-          if (visibleWidth(remaining) <= available)
-            break;
-          const head = [...remaining].slice(0, available).join("");
-          current += paint(head, token.code, options.depth);
-          remaining = [...remaining].slice(available).join("");
-          flush();
-        }
-        if (remaining.length > 0) {
-          current += paint(remaining, token.code, options.depth);
-          currentWidth += visibleWidth(remaining);
-        }
-        continue;
-      }
-      current += paint(word, token.code, options.depth);
-      currentWidth += wordWidth;
-    }
-  }
-  if (current !== "" || lines.length === 0)
-    lines.push(`${prefix}${current}`.replace(/[ \t]+$/, ""));
-  return lines;
-}
-function newMarkdownState() {
-  return { inFence: false, fenceLanguage: "" };
-}
-var HEADING = /^(#{1,6})\s+(.*)$/;
-var BULLET = /^(\s*)([-*+])\s+(.*)$/;
-var TASK = /^(\s*)[-*+]\s+\[([ xX])\]\s+(.*)$/;
-var NUMBERED = /^(\s*)(\d+[.)])\s+(.*)$/;
-var BLOCKQUOTE = /^>\s?(.*)$/;
-var RULE = /^\s*([-*_])\s*(?:\1\s*){2,}$/;
-var FENCE = /^\s*```(.*)$/;
-var TABLE_SEPARATOR_CELL = /^:?-{3,}:?$/;
-function tableCells(line) {
-  if (!line.includes("|"))
-    return null;
-  const trimmed = line.trim().replace(/^\|/, "").replace(/\|$/, "");
-  const cells = trimmed.split("|").map((cell) => cell.trim());
-  return cells.length >= 2 ? cells : null;
-}
-function fitCell(text, width, glyphs = UNICODE_GLYPHS) {
-  let result = "";
-  for (const character of text) {
-    if (visibleWidth(result + character) > width) {
-      while (visibleWidth(result) > Math.max(0, width - visibleWidth(glyphs.ellipsis)))
-        result = [...result].slice(0, -1).join("");
-      result += glyphs.ellipsis;
-      return result + " ".repeat(Math.max(0, width - visibleWidth(result)));
-    }
-    result += character;
-  }
-  return result + " ".repeat(Math.max(0, width - visibleWidth(result)));
-}
-function renderTableLine(cells, separator, width, depth, glyphs) {
-  const cellWidth = Math.max(3, Math.floor((Math.max(width, 12) - cells.length - 1) / cells.length));
-  if (separator)
-    return paint(`${glyphs.boxTeeLeft}${cells.map(() => glyphs.boxHorizontal.repeat(cellWidth)).join(glyphs.boxCross)}${glyphs.boxTeeRight}`, DIM, depth);
-  const contentWidth = Math.max(1, cellWidth - 2);
-  const rendered = cells.map((cell) => fitCell(parseInline(cell).map((token) => token.text).join(""), contentWidth, glyphs));
-  return `${glyphs.boxVertical}${rendered.map((cell) => ` ${cell} `).join(glyphs.boxVertical)}${glyphs.boxVertical}`;
-}
-function renderMarkdownLine(line, state, options) {
-  const { width, depth } = options;
-  const glyphs = options.glyphs ?? UNICODE_GLYPHS;
-  const fence = FENCE.exec(line);
-  if (fence) {
-    const ruleWidth = Math.max(4, Math.min(width - 4, 40));
-    if (state.inFence) {
-      state.inFence = false;
-      state.fenceLanguage = "";
-      return [paint(`  ${glyphs.boxBottomLeft}${glyphs.boxHorizontal.repeat(ruleWidth)}`, DIM, depth)];
-    }
-    state.inFence = true;
-    state.fenceLanguage = fence[1].trim();
-    const label = state.fenceLanguage ? ` ${state.fenceLanguage} ` : "";
-    const drawn = 1 + visibleWidth(label);
-    return [paint(`  ${glyphs.boxTopLeft}${glyphs.boxHorizontal}${label}${glyphs.boxHorizontal.repeat(Math.max(0, ruleWidth - drawn))}`, DIM, depth)];
-  }
-  if (state.inFence) {
-    return [`${paint(`  ${glyphs.boxVertical} `, DIM, depth)}${paint(line, GREEN, depth)}`];
-  }
-  const table = tableCells(line);
-  if (table) {
-    const separator = table.every((cell) => TABLE_SEPARATOR_CELL.test(cell));
-    return [renderTableLine(table, separator, width, depth, glyphs)];
-  }
-  if (RULE.test(line) && line.trim().length > 0) {
-    return [paint("  " + glyphs.boxHorizontal.repeat(Math.max(4, Math.min(width - 4, 40))), DIM, depth)];
-  }
-  const heading = HEADING.exec(line);
-  if (heading) {
-    const level = heading[1].length;
-    const code = level <= 2 ? `${BOLD}${CYAN}` : BOLD;
-    const tokens = parseInline(heading[2]).map((token) => ({ text: token.text, code }));
-    return wrapTokens(tokens, width, { depth });
-  }
-  const task = TASK.exec(line);
-  if (task) {
-    return wrapTokens(parseInline(task[3]), width, {
-      firstPrefix: `${task[1]}${paint(task[2].trim() ? glyphs.checkboxDone : glyphs.checkbox, task[2].trim() ? GREEN : BLUE, depth)} `,
-      continuationPrefix: `${task[1]}  `,
-      depth
-    });
-  }
-  const bullet = BULLET.exec(line);
-  if (bullet) {
-    const indent = bullet[1];
-    return wrapTokens(parseInline(bullet[3]), width, {
-      firstPrefix: `${indent}${paint(glyphs.bullet, BLUE, depth)} `,
-      continuationPrefix: `${indent}  `,
-      depth
-    });
-  }
-  const numbered = NUMBERED.exec(line);
-  if (numbered) {
-    const indent = numbered[1];
-    const marker = numbered[2];
-    return wrapTokens(parseInline(numbered[3]), width, {
-      firstPrefix: `${indent}${paint(marker, BLUE, depth)} `,
-      continuationPrefix: `${indent}${" ".repeat(marker.length + 1)}`,
-      depth
-    });
-  }
-  const quote = BLOCKQUOTE.exec(line);
-  if (quote) {
-    return wrapTokens([{ text: quote[1], code: DIM }], width, {
-      firstPrefix: paint(`${glyphs.boxVertical} `, YELLOW, depth),
-      continuationPrefix: paint(`${glyphs.boxVertical} `, YELLOW, depth),
-      depth
-    });
+function clipTo(text, width, glyphs = UNICODE_GLYPHS) {
+  if (width <= 0)
+    return "";
+  if (visibleWidth(text) <= width)
+    return text;
+  const mark = visibleWidth(glyphs.ellipsis) < width ? glyphs.ellipsis : "";
+  const budget = width - visibleWidth(mark);
+  let out = "";
+  const segments = typeof Intl.Segmenter === "function" ? [...new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(text)].map((entry) => entry.segment) : [...text];
+  for (const segment of segments) {
+    if (visibleWidth(out + segment) > budget)
+      break;
+    out += segment;
   }
-  if (line.trim() === "")
-    return [""];
-  return wrapTokens(parseInline(line), width, { depth });
-}
-function renderMarkdown(text, options) {
-  const state = newMarkdownState();
-  const glyphs = options.glyphs ?? UNICODE_GLYPHS;
-  const rendered = text.split(`
-`).flatMap((line) => renderMarkdownLine(line, state, options));
-  if (state.inFence)
-    rendered.push(paint(`  ${glyphs.boxBottomLeft}${glyphs.boxHorizontal.repeat(4)}`, DIM, options.depth));
-  return rendered.join(`
-`);
+  return `${out}${mark}`;
 }
 
-export { UNICODE_GLYPHS, ASCII_GLYPHS, borderGlyphsFor, visibleWidth, newMarkdownState, renderMarkdownLine, renderMarkdown, BUILTIN_THEME_SOURCES, rgbTo256, rainbowText, parseThemeSource, NO_COLOR_PALETTE };
+export { RESET, BOLD, DIM, ITALIC, STRIKE, REVERSE, paint, paintAll, UNICODE_GLYPHS, ASCII_GLYPHS, borderGlyphsFor, visibleWidth, clipTo, BUILTIN_THEME_SOURCES, parseColor, rgbTo256, rainbowText, parseThemeSource, EXTERNAL_MARK, ANSI_PALETTE, roleCode, NO_COLOR_PALETTE };