mulmoterminal 6.0.0 → 6.1.0

package/README.md

@@ -989,6 +989,7 @@ Settings → Directory settings names both files and lists which keys the local
 | ------------ | ------- |
 | `name`       | Label shown as a badge in the terminal/cell header. |
 | `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, or with the small glyph a chat started from a **collection** wears beside its status dot — that one is the collection's own `icon`, and it says which collection the cell was opened for while this one says which directory it runs in. **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. |
+| `backgroundImage` | A **picture shown faintly behind this directory's terminals**, blended with the text so it stays readable on either theme. A string is the image (15% opaque, fills the terminal); `{ "image", "opacity", "fit" }` sets how faint (above 0, at most 1) and whether it crops to fill (`cover`) or shows whole (`contain`). The image follows `icon`'s rules. |
 | `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`) — 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`.** It applies while that colour is what shows: a working/done/blocked cell paints the theme's own status tint, so its text returns to the theme's too — an ink chosen for your header colour is not readable on a tint the theme mixed. Recolour those states with `headerStatusColors` instead. |

package/common/dirBackground.ts

@@ -0,0 +1,38 @@
+// A directory's terminal background: a picture shown faintly behind its terminals, the way Eterm
+// did. BOTH sides decide from this file — the server reads the config key and serves the file,
+// the browser checks what reached it before putting it in an <img>.
+//
+// The image follows the directory icon's rules (common/dirIcon.ts): a file inside the project,
+// streamed by this server, or an http(s) / data: URL the browser loads itself.
+import { isRecord } from "./isRecord.js";
+import { isRemoteDirIconUrl } from "./dirIcon.js";
+
+export const DIR_BACKGROUND_FITS = ["cover", "contain"] as const;
+export type DirBackgroundFit = (typeof DIR_BACKGROUND_FITS)[number];
+export const isDirBackgroundFit = (value: unknown): value is DirBackgroundFit => DIR_BACKGROUND_FITS.some((fit) => fit === value);
+
+/** Faint enough that a photo reads as a backdrop rather than as the content. */
+export const DIR_BACKGROUND_DEFAULT_OPACITY = 0.15;
+export const DIR_BACKGROUND_DEFAULT_FIT: DirBackgroundFit = "cover";
+
+/** Above 0 (0 is "no background", which omitting the key already says) and at most 1. */
+export const isDirBackgroundOpacity = (value: unknown): value is number => typeof value === "number" && Number.isFinite(value) && value > 0 && value <= 1;
+
+export const DIR_BACKGROUND_ROUTE = "/api/dir-background";
+
+/** What the browser receives: a src ready for an <img>, never a file path. */
+export interface PublicDirBackground {
+  url: string;
+  opacity: number;
+  fit: DirBackgroundFit;
+}
+
+const isUsableBackgroundSrc = (raw: unknown): raw is string =>
+  typeof raw === "string" && !!raw && (raw.startsWith(`${DIR_BACKGROUND_ROUTE}?`) || isRemoteDirIconUrl(raw));
+
+/** The client's own boundary check on the wire shape, so a widened response cannot put an
+ *  unexpected scheme into the DOM. Null for anything that is not a usable background. */
+export function parsePublicDirBackground(raw: unknown): PublicDirBackground | null {
+  if (!isRecord(raw) || !isUsableBackgroundSrc(raw.url) || !isDirBackgroundOpacity(raw.opacity) || !isDirBackgroundFit(raw.fit)) return null;
+  return { url: raw.url, opacity: raw.opacity, fit: raw.fit };
+}

package/common/dirConfigSource.ts

@@ -11,6 +11,7 @@
 export const DIR_CONFIG_KEYS = [
   "name",
   "icon",
+  "backgroundImage",
   "badgeColor",
   "headerColor",
   "headerTextColor",

package/common/playfulEffects.ts

@@ -0,0 +1,49 @@
+// The `playfulEffects` setting and the heat a session reports to the browser. Both sides decide
+// from it: the server skips measuring when it is "off" and sends the heat frame, the browser picks
+// the picture and draws the level.
+import { isRecord } from "./isRecord.js";
+
+export const HEAT_PATTERNS = ["bomb", "volcano", "kettle", "rocket", "dynamite", "balloon", "skull"] as const;
+export type HeatPattern = (typeof HEAT_PATTERNS)[number];
+export const isHeatPattern = (value: unknown): value is HeatPattern => HEAT_PATTERNS.some((pattern) => pattern === value);
+
+export type PlayfulEffects = HeatPattern | "random" | "off";
+export const PLAYFUL_EFFECTS_DEFAULT: PlayfulEffects = "random";
+
+/** Anything unrecognised is "unconfigured", which is what every config file written before this
+ *  existed contains. `false` is honoured as "off" because it is what a person switching it off
+ *  writes first. */
+export function sanitizePlayfulEffects(input: unknown): PlayfulEffects {
+  if (input === false || input === "off") return "off";
+  if (input === "random" || isHeatPattern(input)) return input;
+  return PLAYFUL_EFFECTS_DEFAULT;
+}
+
+/** 0 nothing, 1 appears, 2 lit, 3 hot, 4 critical. The finale is an event, not a level. */
+export const HEAT_LEVELS = [0, 1, 2, 3, 4] as const;
+export type HeatLevel = (typeof HEAT_LEVELS)[number];
+export const isHeatLevel = (value: unknown): value is HeatLevel => HEAT_LEVELS.some((level) => level === value);
+
+/** The `heat` frame: the session's level now, and whether it has just cooled off from a hot run. */
+export interface HeatFrame {
+  type: "heat";
+  level: HeatLevel;
+  finale: boolean;
+}
+
+export const heatFrameOf = (msg: unknown): { level: HeatLevel; finale: boolean } | null =>
+  isRecord(msg) && msg.type === "heat" && isHeatLevel(msg.level) && typeof msg.finale === "boolean" ? { level: msg.level, finale: msg.finale } : null;
+
+const FNV_OFFSET = 0x811c9dc5;
+const FNV_PRIME = 0x01000193;
+
+// FNV-1a: stable across reloads and browsers, so "random" gives each session its own picture that
+// stays put, rather than one that changes on every re-render.
+const hashOf = (text: string): number => [...text].reduce((hash, char) => Math.imul(hash ^ char.charCodeAt(0), FNV_PRIME) >>> 0, FNV_OFFSET);
+
+/** The picture for a session, or null when the setting is off. */
+export function patternFor(sessionId: string, setting: PlayfulEffects): HeatPattern | null {
+  if (setting === "off") return null;
+  if (setting !== "random") return setting;
+  return HEAT_PATTERNS[hashOf(sessionId) % HEAT_PATTERNS.length] ?? "bomb";
+}

package/dist/assets/{abnfDiagram-O67JEVCF-CoSnTBWR.js → abnfDiagram-O67JEVCF-B2CGO9GH.js}

@@ -1 +1 @@
-import{m as e,t}from"./mermaid-parser.core-S4mGErbM.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-CllyRBe0.js";import"./chunk-O7XYJQB3-ChS0oDzH.js";import{n as i,r as a,t as o}from"./chunk-GTNCS2PH-BegFnGEj.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-DcTpiPIz.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(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=n(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=n(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=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};
+import{m as e,t}from"./mermaid-parser.core-9dyqX5Cv.js";import{n}from"./chunk-Y2CYZVJY-DsF7k-Jl.js";import{m as r}from"./src-CllyRBe0.js";import"./chunk-O7XYJQB3-B7efnPsN.js";import{n as i,r as a,t as o}from"./chunk-GTNCS2PH-3pmrTmQI.js";import{t as s}from"./chunk-JWPE2WC7-DVXcaiue.js";import"./mermaid.core-Cpfr3G3I.js";var c=e().RailroadAbnf.parser.LangiumParser,l=n(e=>{let t=e.alternatives.map(u);return t.length===1?t[0]:{type:`choice`,alternatives:t}},`transformAlternation`),u=n(e=>{let t=e.elements.map(f);return t.length===1?t[0]:{type:`sequence`,elements:t}},`transformConcatenation`),d=n(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=n(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=n(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=n(e=>({name:e.name,definition:l(e.definition)}),`transformRule`),h=n(e=>{s(e,o),e.title&&o.setTitle(e.title),e.rules.map(e=>o.addRule(m(e)))},`populateDb`),g={parser:{parse:n(e=>{o.clear(),r.debug(`[ABNF Parser] Starting Langium parse`);let n=c.parse(e);if(n.lexerErrors.length>0||n.parserErrors.length>0)throw new t(n);let i=n.value;r.debug(`[ABNF Parser] Parsed rules:`,i.rules.length),h(i),r.debug(`[ABNF Parser] Parse complete`)},`parse`),parser:{yy:o}},db:o,renderer:a,styles:i};export{g as diagram};

package/dist/assets/architecture-7GRP2DOG-DjYJsj77.js

@@ -0,0 +1 @@
+import"./chunk-FOHPRMQF-DzxwRta7.js";import{M as e}from"./mermaid-parser.core-9dyqX5Cv.js";export{e as createArchitectureServices};