mulmoterminal 4.8.0 → 4.8.1

package/README.md

@@ -786,7 +786,7 @@ Settings → Directory settings names both files and lists which keys the local
 | `icon`       | An **image** marking this directory — shown in the cell header, the cockpit roster, the filmstrip thumbnails, the launcher's directory chips, and the phone's terminal list and terminal screen. Either a path **relative to this directory** (an absolute path, or a `../` that escapes it, is rejected), an `http(s)://` URL, or a `data:image/…` URI. PNG / JPEG / **GIF (animated plays)** / WebP / AVIF / SVG / ICO / BMP. Not to be confused with a header **button's** `icon`, which is a Material Symbols name. **Omit it and the repository's own favicon is used** (`public/favicon.svg`, `apple-touch-icon.png`, a web manifest — see `autoDirIcon`); `false` means no icon here and stops that search. |
 | `badgeColor` | Badge background color (`#rrggbb`); text auto-contrasts. |
 | `headerColor` | Header **background** color (`#rrggbb`) — the grid cell's header row and the terminal's own header row (grid row 2). While a terminal is working/blocked the status tint still shows; the custom color applies when idle. |
-| `headerTextColor` | Header **text** color (`#rrggbb`) — the dir path, title, and prompt. |
+| `headerTextColor` | Header **text** color (`#rrggbb`) — everything written on the header: the dir path, title and prompt, plus the model/context badge, the token counts and any custom chip. **Omit it and a readable colour is derived from `headerColor`**, while that colour is what shows (a working/blocked cell paints its own header tint, so its text returns to the theme's). |
 | `cellColor` | Cell **body background** color (`#rrggbb`) — the frame around the terminal. |
 | `cellBorderColor` | Cell **border** color (`#rrggbb`). The status frame (working/blocked) still overrides it while active. |
 | `dotColor` | **Idle** status-dot color (`#rrggbb`). The working/waiting colors are unchanged so the activity signal stays intact. |

package/common/chromeFromColor.ts

@@ -15,7 +15,7 @@
 // Snapping every role to absolute values drifts by ΔE 20 at the dark end of the hue wheel; making
 // every role a relative offset drifts by ΔE 15 at the pale end. Both were tried; this is the mix
 // that fits. Anyone retuning these numbers should re-measure rather than reason about them.
-import { readableTextColor } from "./contrast.js";
+import { contrastRatio, readableTextColor, relativeLuminance } from "./contrast.js";
 
 export interface ChromeColors {
   badgeColor: string;
@@ -36,6 +36,37 @@ const BUTTON = { s: 0.67, l: 0.89 };
 
 const clamp01 = (n: number): number => Math.min(1, Math.max(0, n));
 
+// The inks a header background can be written in. Black is softened to a near-black so a pale
+// header does not read as a printed page; white is left pure, since anything softer loses contrast
+// on the dark end where it is chosen.
+const DARK_INK = "#1b2430";
+const PURE_DARK_INK = "#000000";
+const LIGHT_INK = "#ffffff";
+
+// WCAG AA for normal text. These chips run to 10px, so the large-text 3:1 bar does not apply.
+const AA_CONTRAST = 4.5;
+const DARK_INK_LUMINANCE = relativeLuminance(0x1b, 0x24, 0x30);
+
+// The softening is a PREFERENCE, and it costs contrast: on a mid-tone background that cost is what
+// drops the text below AA — `#e8341c` measures 3.68:1 against the softened ink and 4.94:1 against
+// pure black (Codex on #1592, which is right and was worth measuring). So it is applied only while
+// it is free. Falling back always works: at the worst background — the luminance where black and
+// white are equally readable — the pure ink still reaches 4.58:1.
+function inkFor(rgb: [number, number, number]): string {
+  if (readableTextColor(rgb[0], rgb[1], rgb[2]) === "#fff") return LIGHT_INK;
+  const background = relativeLuminance(rgb[0], rgb[1], rgb[2]);
+  return contrastRatio(background, DARK_INK_LUMINANCE) >= AA_CONTRAST ? DARK_INK : PURE_DARK_INK;
+}
+
+/** Which ink a header background wants, or null when it isn't a colour we can read. Exported so a
+ *  directory that declares only `headerColor` derives the SAME text colour this file gives a
+ *  repo.json brand colour (src/components/cellHeaderStyle.ts) — two answers to one question is how
+ *  one directory ends up written in two different colours. */
+export function headerTextColorFor(background: string): string | null {
+  const rgb = parseHex(background);
+  return rgb ? inkFor(rgb) : null;
+}
+
 /** The seven colours for a brand colour, or null when it isn't a colour we can read. */
 export function chromeFromColor(primary: string, background?: string | null): ChromeColors | null {
   const rgb = parseHex(primary);
@@ -50,7 +81,7 @@ export function chromeFromColor(primary: string, background?: string | null): Ch
     headerColor: normalizeHex(primary),
     // Never taken from the file — see the spec's "text colour is never declared". Deriving it is
     // also what makes two conforming tools agree.
-    headerTextColor: readableTextColor(rgb[0], rgb[1], rgb[2]) === "#000" ? "#1b2430" : "#ffffff",
+    headerTextColor: inkFor(rgb),
     // `background` is the surface the brand colour sits on, which is exactly what a cell body is.
     // Gated on it PARSING, not on it being present: an unusable value here used to win the branch,
     // survive as a non-colour, and then be dropped downstream — leaving no surface at all, neither

package/common/pathSegments.ts

@@ -0,0 +1,23 @@
+// Splitting a filesystem path into its parts, on EITHER separator.
+//
+// `path.sep` is not the answer here: these paths come from a config file and from a saved
+// directory list, so a Windows path can be read on a mac (a synced config, a bug report, a test
+// fixture) and a POSIX one on Windows. Code that splits on "/" alone does not fail loudly on
+// `C:\Users\me\project` — it returns the WHOLE STRING as one segment, which is how a "label"
+// becomes an absolute path.
+//
+// That is a privacy contract in one place: the phone's project listing sends a label and never a
+// path, precisely so a command or an artifact cannot publish the user's home directory. A
+// one-separator split turns that guarantee off on Windows without changing a line of the code
+// that states it.
+
+/** The non-empty parts of a path, splitting on `/` and `\` alike. A drive letter (`C:`) stays a
+ *  segment of its own — it is not a directory name, and nothing here wants it as one. */
+export function pathSegments(value: string): string[] {
+  return value.split(/[/\\]+/).filter((segment) => segment.length > 0);
+}
+
+/** The last part of a path — its directory or file name — or the input when it has none. */
+export function lastSegment(value: string): string {
+  return pathSegments(value).at(-1) ?? value;
+}

package/dist/assets/{abnfDiagram-N423BO3Z-D0pzqjdS-C_1F9Lr9.js → abnfDiagram-N423BO3Z-D0pzqjdS-CTSEh1uL.js}

@@ -1 +1 @@
-import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-CvsWqFln-Tc7ZSrRz.js";import{_ as n,g as r}from"./mermaid-parser.core-C1baW7NG-B9TNqufx.js";import"./chunk-I66GZJ75-DSPCVCny-BJLh4409.js";import"./chunk-3NCLNEKW-CBztX243-CRh6N7eI.js";import{n as i,r as a,t as o}from"./chunk-6Q2QTUOP-Cx8nz5_t-DoqT-qjo.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};
+import{n as e}from"./chunk-Y2CYZVJY-Bdt8pFDJ-DsF7k-Jl.js";import{f as t}from"./src-CvsWqFln-Tc7ZSrRz.js";import{_ as n,g as r}from"./mermaid-parser.core-C1baW7NG-m5_U2vyD.js";import"./chunk-I66GZJ75-DSPCVCny-DxpV96_X.js";import"./chunk-3NCLNEKW-CBztX243-DK2bYr2d.js";import{n as i,r as a,t as o}from"./chunk-6Q2QTUOP-Cx8nz5_t-BmPIYTTz.js";import{t as s}from"./chunk-JWPE2WC7-BQ3zXr2k-DSd3Ct95.js";var c=r().RailroadAbnf.parser.LangiumParser,l=e(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=e(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=e(e=>{if(e.includes(`*`)){let[t,n]=e.split(`*`);return{min:t?parseInt(t,10):0,max:n?parseInt(n,10):1/0}}let t=parseInt(e,10);return{min:t,max:t}},`parseRepeat`),f=e(e=>{let t=p(e.primary);if(!e.repeat)return t;let{min:n,max:r}=d(e.repeat);return n===0&&r===1?{type:`optional`,element:t}:{type:`repetition`,element:t,min:n,max:r}},`transformElement`),p=e(e=>{switch(e.$type){case`AbnfStringLiteral`:return{type:`terminal`,value:e.value};case`AbnfNumVal`:return{type:`terminal`,value:e.value};case`AbnfRuleName`:return{type:`nonterminal`,name:e.name};case`AbnfGroup`:return l(e.element);case`AbnfOptionalGroup`:return{type:`optional`,element:l(e.element)};default:throw Error(`Unsupported ABNF primary node: ${e.$type}`)}},`transformPrimary`),m=e(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=e(e=>{s(e,a),e.title&&a.setTitle(e.title),e.rules.map(e=>a.addRule(m(e)))},`populateDb`),g={parser:{parse:e(e=>{a.clear(),t.debug(`[ABNF Parser] Starting Langium parse`);let r=c.parse(e);if(r.lexerErrors.length>0||r.parserErrors.length>0)throw new n(r);let i=r.value;t.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),t.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:a}},db:a,renderer:o,styles:i};export{g as diagram};

package/dist/assets/architecture-TIHT7OUA-Cqhmai3f-DYURJf3a.js

@@ -0,0 +1 @@
+import{f as e}from"./mermaid-parser.core-C1baW7NG-m5_U2vyD.js";export{e as createArchitectureServices};