@sagmans/dsh-tui 0.1.2 → 0.3.0

package/lib/theme-tokens.d.ts

@@ -0,0 +1,110 @@
+import { type ColourMode } from './theme-capability.ts';
+/**
+ * The reset sequence, for the code that has to recognise one.
+ *
+ * pi-tui closes a truncated row with a reset whether or not it opened a style,
+ * so a renderer that turns styling off still has to remove the ones it did not
+ * ask for.
+ */
+export declare function resetSequence(): string;
+/**
+ * The muted shade every receding element shares.
+ *
+ * An explicit grey rather than a palette slot: slot 8 is whatever the reader's
+ * terminal maps it to, which on the reader's own phone was close enough to
+ * ordinary text that dimming looked like it had not been applied at all.
+ */
+export declare const MUTED_GREY = "#8a8a8a";
+/**
+ * The shade a tool's argument takes.
+ *
+ * A call's argument is the one part of a card the reader scans for, and it must
+ * read as neither the tool's own label (warn) nor ordinary output (the default
+ * foreground); a pale blue sits between them without competing for attention.
+ */
+export declare const ARGUMENT_BLUE = "#8db3d9";
+/**
+ * The shade a submitted prompt takes.
+ *
+ * A reader's own turns and the assistant's reply both shipped on the default
+ * foreground, so telling the two apart meant reading them; a mint keeps them
+ * apart at a glance without the pink cast a rose gave every prompt.
+ */
+export declare const USER_PROMPT_MINT = "#27F5C8";
+/** Palette entries a token may name instead of a literal colour. */
+export declare const PALETTE_NAMES: readonly ["default", "muted", "accent", "arg", "warn", "added", "removed", "user", "assistant"];
+/** A named palette entry. */
+export type PaletteName = (typeof PALETTE_NAMES)[number];
+/** A colour: an explicit hex value, or a palette entry. */
+export type ColourSpec = string | number | PaletteName;
+/** One element's appearance, every field optional so a reader sets only what they mean. */
+export interface StyleSpec {
+    readonly fg?: ColourSpec;
+    readonly bg?: ColourSpec;
+    readonly bold?: boolean;
+    readonly dim?: boolean;
+    readonly italic?: boolean;
+    readonly underline?: boolean;
+    readonly strike?: boolean;
+    /** Rendered before the element when set; empty ships nothing. */
+    readonly glyph?: string;
+    /** The element renders nothing at all when true. */
+    readonly hidden?: boolean;
+    /** Start from another token's fields instead of this token's own defaults. */
+    readonly inherit?: TuiToken;
+}
+/** The resolved escape pair and marks one element needs. */
+export interface ResolvedStyle {
+    readonly prefix: string;
+    readonly suffix: string;
+    readonly glyph: string;
+    readonly hidden: boolean;
+}
+/** A row class a tool card can carry, so styling follows what the row means. */
+export declare const CARD_ROW_CLASSES: readonly ["header", "hunk", "added", "removed", "line", "lineNumber", "path", "match", "truncated", "output", "cwd", "status", "source", "url", "detail"];
+/** What a tool card row is, which is what decides how it is drawn. */
+export type CardRowClass = (typeof CARD_ROW_CLASSES)[number];
+/**
+ * Every styled element on the surface, grouped by the region that draws it.
+ *
+ * The list is the contract: a renderer names a token, and the coverage sweep
+ * fails if a token loses its default, so "every element" cannot quietly drift
+ * as the surface grows.
+ */
+export declare const TUI_TOKENS: readonly ["transcript.user", "transcript.notice", "transcript.marker", "transcript.reasoning.summary", "transcript.reasoning.body", "transcript.reasoning.hint", "tool.title", "tool.glyph", "tool.args", "tool.stat.added", "tool.stat.changed", "tool.stat.removed", "tool.stat.size", "tool.stat.separator", "tool.detail", "tool.hint", "tool.failed.title", "tool.failed.glyph", "tool.subcall.title", "tool.subcall.args", "tool.diff.header", "tool.diff.hunk", "tool.diff.added", "tool.diff.removed", "tool.read.header", "tool.read.lineNumber", "tool.read.line", "tool.search.path", "tool.search.lineNumber", "tool.search.match", "tool.search.truncated", "tool.terminal.cwd", "tool.terminal.status", "tool.terminal.output", "tool.web.url", "tool.web.source", "tool.web.truncated", "tool.generic.detail", "markdown.heading", "markdown.link", "markdown.linkUrl", "markdown.code", "markdown.codeBlock", "markdown.codeBlockBorder", "markdown.quote", "markdown.quoteBorder", "markdown.hr", "markdown.listBullet", "markdown.bold", "markdown.italic", "markdown.strikethrough", "markdown.underline", "markdown.diagram.border", "markdown.diagram.text", "markdown.diagram.edge", "markdown.diagram.edgeLabel", "markdown.diagram.title", "markdown.diagram.warning", "picker.title", "picker.glyph", "picker.note", "picker.filter", "picker.row", "picker.rowCurrent", "picker.scrollNewer", "picker.scrollOlder", "picker.hint", "picker.cursor", "gate.title", "gate.glyphApproval", "gate.glyphQuestion", "gate.detail", "gate.option", "gate.optionCurrent", "gate.cursor", "gate.hint", "dock.goal", "dock.planMode", "dock.todos.heading", "dock.todos.pending", "dock.todos.inProgress", "dock.todos.overflow", "dock.subagents.heading", "dock.subagents.running", "dock.subagents.overflow", "dock.jobs.heading", "dock.jobs.running", "dock.jobs.overflow", "status.prefix", "status.back", "status.activity.working", "status.activity.ready", "status.elapsed", "status.agentPreset", "status.model", "status.effort", "status.permission", "status.context", "status.cache", "status.cwd", "status.separator", "editor.border", "editor.queued", "editor.queued.more", "editor.selectList.selectedPrefix", "editor.selectList.selectedText", "editor.selectList.description", "editor.selectList.scrollInfo", "editor.selectList.noMatch"];
+/** A name for one styled element on the surface. */
+export type TuiToken = (typeof TUI_TOKENS)[number];
+/**
+ * Which token draws a card row, by the card's kind and the row's class.
+ *
+ * Two lookups rather than one because `header` means a different element on a
+ * diff than on a read: the kind is half of what a row is.
+ */
+export declare const CARD_ROW_TOKEN: Readonly<Record<string, Readonly<Partial<Record<CardRowClass, TuiToken>>>>>;
+/** The colours a token can name, so a shade is changed in one place. */
+export declare const DEFAULT_PALETTE: Readonly<Record<PaletteName, string>>;
+/**
+ * The shipped appearance of every token.
+ *
+ * Defaults reproduce the surface as it looked before tokens existed, except the
+ * muted family, which moves from faint-on-a-palette-slot to an explicit grey.
+ * A test asserts every token in {@link TUI_TOKENS} appears here.
+ */
+export declare const DEFAULT_TOKENS: Readonly<Record<TuiToken, StyleSpec>>;
+/**
+ * Merge one token's default, its `inherit` target, and the reader's override.
+ *
+ * The inherited token's fields replace this token's defaults, because that is
+ * what "start from another token" means; the reader's own fields still win.
+ * A path-scoped set turns a cycle into a stop, and still lets two branches
+ * inherit one token rather than sharing a single visit.
+ */
+export declare function mergeTokenSpec(token: TuiToken, overrides: ReadonlyMap<TuiToken, StyleSpec>): StyleSpec;
+/**
+ * Resolve one token into the escapes a renderer needs.
+ *
+ * Faint is dropped once a colour is chosen: stacking it on a deliberate grey is
+ * what made the old output differ per terminal.
+ */
+export declare function resolveToken(token: TuiToken, overrides: ReadonlyMap<TuiToken, StyleSpec>, palette: Readonly<Record<PaletteName, string>>, mode: ColourMode): ResolvedStyle;
+//# sourceMappingURL=theme-tokens.d.ts.map

package/lib/theme-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-tokens.d.ts","sourceRoot":"","sources":["../src/theme-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAkC,MAAM,uBAAuB,CAAA;AAIvF;;;;;;GAMG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,YAAY,CAAA;AAEnC;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,YAAY,CAAA;AAEtC;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,YAAY,CAAA;AAEzC,oEAAoE;AACpE,eAAO,MAAM,aAAa,iGAAkG,CAAA;AAE5H,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAExD,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,WAAW,CAAA;AAEtD,2FAA2F;AAC3F,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,EAAE,CAAC,EAAE,UAAU,CAAA;IACxB,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAA;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAA;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,iEAAiE;IACjE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;IACvB,oDAAoD;IACpD,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;IACzB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAA;CAC5B;AAED,4DAA4D;AAC5D,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;CACzB;AAED,gFAAgF;AAChF,eAAO,MAAM,gBAAgB,2JAEnB,CAAA;AAEV,sEAAsE;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,OAAO,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAA;AAE5D;;;;;;GAMG;AACH,eAAO,MAAM,UAAU,ovEA4Hb,CAAA;AAEV,oDAAoD;AACpD,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,CAAC,CAAA;AAElD;;;;;GAKG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC,CAYtG,CAAA;AAED,wEAAwE;AACxE,eAAO,MAAM,eAAe,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAUjE,CAAA;AAaD;;;;;;GAMG;AACH,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,QAAQ,EAAE,SAAS,CAAC,CA0HhE,CAAA;AA0BD;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,SAAS,CAatG;AAOD;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,QAAQ,EACf,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE,SAAS,CAAC,EAC3C,OAAO,EAAE,QAAQ,CAAC,MAAM,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,EAC9C,IAAI,EAAE,UAAU,GACf,aAAa,CA0Bf"}

package/lib/theme-tokens.js

@@ -0,0 +1,427 @@
+import { sgrBackgroundPrefix, sgrPrefix } from "./theme-capability.js";
+const RESET = '\u001B[0m';
+/**
+ * The reset sequence, for the code that has to recognise one.
+ *
+ * pi-tui closes a truncated row with a reset whether or not it opened a style,
+ * so a renderer that turns styling off still has to remove the ones it did not
+ * ask for.
+ */
+export function resetSequence() {
+    return RESET;
+}
+/**
+ * The muted shade every receding element shares.
+ *
+ * An explicit grey rather than a palette slot: slot 8 is whatever the reader's
+ * terminal maps it to, which on the reader's own phone was close enough to
+ * ordinary text that dimming looked like it had not been applied at all.
+ */
+export const MUTED_GREY = '#8a8a8a';
+/**
+ * The shade a tool's argument takes.
+ *
+ * A call's argument is the one part of a card the reader scans for, and it must
+ * read as neither the tool's own label (warn) nor ordinary output (the default
+ * foreground); a pale blue sits between them without competing for attention.
+ */
+export const ARGUMENT_BLUE = '#8db3d9';
+/**
+ * The shade a submitted prompt takes.
+ *
+ * A reader's own turns and the assistant's reply both shipped on the default
+ * foreground, so telling the two apart meant reading them; a mint keeps them
+ * apart at a glance without the pink cast a rose gave every prompt.
+ */
+export const USER_PROMPT_MINT = '#27F5C8';
+/** Palette entries a token may name instead of a literal colour. */
+export const PALETTE_NAMES = ['default', 'muted', 'accent', 'arg', 'warn', 'added', 'removed', 'user', 'assistant'];
+/** A row class a tool card can carry, so styling follows what the row means. */
+export const CARD_ROW_CLASSES = [
+    'header', 'hunk', 'added', 'removed', 'line', 'lineNumber', 'path', 'match', 'truncated', 'output', 'cwd', 'status', 'source', 'url', 'detail',
+];
+/**
+ * Every styled element on the surface, grouped by the region that draws it.
+ *
+ * The list is the contract: a renderer names a token, and the coverage sweep
+ * fails if a token loses its default, so "every element" cannot quietly drift
+ * as the surface grows.
+ */
+export const TUI_TOKENS = [
+    // Transcript rows
+    'transcript.user',
+    'transcript.notice',
+    'transcript.marker',
+    'transcript.reasoning.summary',
+    'transcript.reasoning.body',
+    'transcript.reasoning.hint',
+    // A reply is markdown, so the markdown tokens are what address it.
+    // Tool cards: the generic layer
+    'tool.title',
+    'tool.glyph',
+    'tool.args',
+    'tool.stat.added',
+    'tool.stat.changed',
+    'tool.stat.removed',
+    'tool.stat.size',
+    'tool.stat.separator',
+    'tool.detail',
+    'tool.hint',
+    'tool.failed.title',
+    'tool.failed.glyph',
+    'tool.subcall.title',
+    'tool.subcall.args',
+    // Tool cards: per kind
+    'tool.diff.header',
+    'tool.diff.hunk',
+    'tool.diff.added',
+    'tool.diff.removed',
+    'tool.read.header',
+    'tool.read.lineNumber',
+    'tool.read.line',
+    'tool.search.path',
+    'tool.search.lineNumber',
+    'tool.search.match',
+    'tool.search.truncated',
+    'tool.terminal.cwd',
+    'tool.terminal.status',
+    'tool.terminal.output',
+    'tool.web.url',
+    'tool.web.source',
+    'tool.web.truncated',
+    'tool.generic.detail',
+    // Markdown
+    'markdown.heading',
+    'markdown.link',
+    'markdown.linkUrl',
+    'markdown.code',
+    'markdown.codeBlock',
+    'markdown.codeBlockBorder',
+    'markdown.quote',
+    'markdown.quoteBorder',
+    'markdown.hr',
+    'markdown.listBullet',
+    'markdown.bold',
+    'markdown.italic',
+    'markdown.strikethrough',
+    'markdown.underline',
+    // A drawn mermaid diagram: the renderer reports what each run *is*, so every
+    // role a drawing can be made of is addressable on its own.
+    'markdown.diagram.border',
+    'markdown.diagram.text',
+    'markdown.diagram.edge',
+    'markdown.diagram.edgeLabel',
+    'markdown.diagram.title',
+    'markdown.diagram.warning',
+    // No markdown.tableHeader: pi-tui styles table headers through the bold hook
+    // it already owns, so a token here would be a setting with no call site.
+    // Picker
+    'picker.title',
+    'picker.glyph',
+    'picker.note',
+    'picker.filter',
+    'picker.row',
+    'picker.rowCurrent',
+    'picker.scrollNewer',
+    'picker.scrollOlder',
+    'picker.hint',
+    'picker.cursor',
+    // Gate
+    'gate.title',
+    'gate.glyphApproval',
+    'gate.glyphQuestion',
+    'gate.detail',
+    'gate.option',
+    'gate.optionCurrent',
+    'gate.cursor',
+    'gate.hint',
+    // Dock
+    'dock.goal',
+    'dock.planMode',
+    'dock.todos.heading',
+    'dock.todos.pending',
+    'dock.todos.inProgress',
+    'dock.todos.overflow',
+    'dock.subagents.heading',
+    'dock.subagents.running',
+    'dock.subagents.overflow',
+    'dock.jobs.heading',
+    'dock.jobs.running',
+    'dock.jobs.overflow',
+    // Status bar
+    'status.prefix',
+    'status.back',
+    'status.activity.working',
+    'status.activity.ready',
+    'status.elapsed',
+    'status.agentPreset',
+    'status.model',
+    'status.effort',
+    'status.permission',
+    'status.context',
+    'status.cache',
+    'status.cwd',
+    'status.separator',
+    // Editor
+    'editor.border',
+    'editor.queued',
+    'editor.queued.more',
+    'editor.selectList.selectedPrefix',
+    'editor.selectList.selectedText',
+    'editor.selectList.description',
+    'editor.selectList.scrollInfo',
+    'editor.selectList.noMatch',
+];
+/**
+ * Which token draws a card row, by the card's kind and the row's class.
+ *
+ * Two lookups rather than one because `header` means a different element on a
+ * diff than on a read: the kind is half of what a row is.
+ */
+export const CARD_ROW_TOKEN = {
+    diff: { header: 'tool.diff.header', hunk: 'tool.diff.hunk', added: 'tool.diff.added', removed: 'tool.diff.removed' },
+    read: { header: 'tool.read.header', lineNumber: 'tool.read.lineNumber', line: 'tool.read.line' },
+    search: {
+        path: 'tool.search.path',
+        lineNumber: 'tool.search.lineNumber',
+        match: 'tool.search.match',
+        truncated: 'tool.search.truncated',
+    },
+    terminal: { cwd: 'tool.terminal.cwd', status: 'tool.terminal.status', output: 'tool.terminal.output' },
+    web: { url: 'tool.web.url', source: 'tool.web.source', truncated: 'tool.web.truncated' },
+    generic: { detail: 'tool.generic.detail' },
+};
+/** The colours a token can name, so a shade is changed in one place. */
+export const DEFAULT_PALETTE = {
+    default: '#d0d0d0',
+    muted: MUTED_GREY,
+    accent: '#5fafd7',
+    arg: ARGUMENT_BLUE,
+    warn: '#d7af5f',
+    added: '#5faf5f',
+    removed: '#d75f5f',
+    user: USER_PROMPT_MINT,
+    assistant: '#d0d0d0',
+};
+/**
+ * Muted elements share one shade, which is what makes the surface coherent.
+ *
+ * It names the palette entry rather than repeating the hex, so a reader who
+ * changes `palette.muted` once quiets every receding element together instead
+ * of hunting the tokens down. No `dim` either: faint is dropped the moment a
+ * colour is named, so carrying it would be a setting that does nothing.
+ */
+const muted = { fg: 'muted' };
+const plain = {};
+/**
+ * The shipped appearance of every token.
+ *
+ * Defaults reproduce the surface as it looked before tokens existed, except the
+ * muted family, which moves from faint-on-a-palette-slot to an explicit grey.
+ * A test asserts every token in {@link TUI_TOKENS} appears here.
+ */
+export const DEFAULT_TOKENS = {
+    'transcript.user': { fg: 'user' },
+    'transcript.notice': muted,
+    'transcript.marker': muted,
+    'transcript.reasoning.summary': muted,
+    'transcript.reasoning.body': muted,
+    'transcript.reasoning.hint': muted,
+    'tool.title': { fg: 'warn' },
+    'tool.glyph': { fg: 'warn' },
+    'tool.args': { fg: 'arg' },
+    'tool.stat.added': { fg: 'added' },
+    'tool.stat.changed': { fg: 'warn' },
+    'tool.stat.removed': { fg: 'removed' },
+    'tool.stat.size': muted,
+    'tool.stat.separator': muted,
+    'tool.detail': muted,
+    'tool.hint': muted,
+    'tool.failed.title': { fg: 'removed' },
+    'tool.failed.glyph': { fg: 'removed' },
+    'tool.subcall.title': muted,
+    'tool.subcall.args': { fg: 'arg' },
+    'tool.diff.header': muted,
+    'tool.diff.hunk': muted,
+    'tool.diff.added': { fg: 'added' },
+    'tool.diff.removed': { fg: 'removed' },
+    'tool.read.header': muted,
+    'tool.read.lineNumber': muted,
+    'tool.read.line': muted,
+    'tool.search.path': muted,
+    'tool.search.lineNumber': muted,
+    'tool.search.match': muted,
+    'tool.search.truncated': muted,
+    'tool.terminal.cwd': muted,
+    'tool.terminal.status': muted,
+    'tool.terminal.output': muted,
+    'tool.web.url': muted,
+    'tool.web.source': muted,
+    'tool.web.truncated': muted,
+    'tool.generic.detail': muted,
+    'markdown.heading': { fg: 'accent', bold: true },
+    'markdown.link': { fg: 'accent', underline: true },
+    'markdown.linkUrl': muted,
+    'markdown.code': { fg: 'accent' },
+    'markdown.codeBlock': plain,
+    'markdown.codeBlockBorder': muted,
+    'markdown.quote': muted,
+    'markdown.quoteBorder': muted,
+    'markdown.hr': muted,
+    'markdown.listBullet': { fg: 'accent' },
+    'markdown.bold': { bold: true },
+    'markdown.italic': { italic: true },
+    'markdown.strikethrough': { strike: true },
+    'markdown.underline': { underline: true },
+    'markdown.diagram.border': muted,
+    'markdown.diagram.text': plain,
+    'markdown.diagram.edge': { fg: 'accent' },
+    'markdown.diagram.edgeLabel': muted,
+    'markdown.diagram.title': { fg: 'accent', bold: true },
+    'markdown.diagram.warning': { fg: 'warn' },
+    'picker.title': { bold: true },
+    'picker.glyph': { bold: true },
+    'picker.note': { bold: true },
+    'picker.filter': muted,
+    'picker.row': plain,
+    'picker.rowCurrent': { bold: true },
+    'picker.scrollNewer': muted,
+    'picker.scrollOlder': muted,
+    'picker.hint': muted,
+    'picker.cursor': plain,
+    'gate.title': { bold: true },
+    'gate.glyphApproval': { bold: true },
+    'gate.glyphQuestion': { bold: true },
+    'gate.detail': muted,
+    'gate.option': plain,
+    'gate.optionCurrent': { bold: true },
+    'gate.cursor': plain,
+    'gate.hint': muted,
+    'dock.goal': { bold: true },
+    'dock.planMode': { bold: true },
+    'dock.todos.heading': { bold: true },
+    'dock.todos.pending': muted,
+    'dock.todos.inProgress': muted,
+    'dock.todos.overflow': muted,
+    'dock.subagents.heading': { bold: true },
+    'dock.subagents.running': muted,
+    'dock.subagents.overflow': muted,
+    'dock.jobs.heading': { bold: true },
+    'dock.jobs.running': muted,
+    'dock.jobs.overflow': muted,
+    'status.prefix': { fg: 'accent' },
+    // The way back is a key the reader presses, so it carries the weight of an
+    // armed chord rather than toning down with the facts.
+    'status.back': { fg: 'accent' },
+    'status.activity.working': muted,
+    'status.activity.ready': muted,
+    'status.elapsed': muted,
+    'status.agentPreset': muted,
+    'status.model': muted,
+    'status.effort': muted,
+    'status.permission': muted,
+    'status.context': muted,
+    'status.cache': muted,
+    'status.cwd': muted,
+    'status.separator': muted,
+    'editor.border': muted,
+    // No colour: a faint is dropped the moment a colour is named, and faint is
+    // what makes queued text read as not-yet-sent rather than as being typed.
+    'editor.queued': { dim: true, italic: true },
+    'editor.queued.more': muted,
+    'editor.selectList.selectedPrefix': { fg: 'accent' },
+    'editor.selectList.selectedText': { bold: true },
+    'editor.selectList.description': muted,
+    'editor.selectList.scrollInfo': muted,
+    'editor.selectList.noMatch': muted,
+};
+/** Map a colour specification through the palette, leaving literals alone. */
+function resolveColour(spec, palette) {
+    if (typeof spec === 'string' && PALETTE_NAMES.includes(spec)) {
+        return palette[spec];
+    }
+    return spec;
+}
+/** Drop the routing field, so a merged spec carries only what it draws. */
+function withoutInherit(spec) {
+    const { inherit: _routing, ...rest } = spec;
+    return rest;
+}
+/** The fields an override really wrote, so an explicit `undefined` cannot shadow a default. */
+function writtenFields(spec) {
+    if (spec === undefined)
+        return {};
+    const written = {};
+    for (const [key, value] of Object.entries(spec)) {
+        if (value !== undefined)
+            written[key] = value;
+    }
+    return written;
+}
+/**
+ * Merge one token's default, its `inherit` target, and the reader's override.
+ *
+ * The inherited token's fields replace this token's defaults, because that is
+ * what "start from another token" means; the reader's own fields still win.
+ * A path-scoped set turns a cycle into a stop, and still lets two branches
+ * inherit one token rather than sharing a single visit.
+ */
+export function mergeTokenSpec(token, overrides) {
+    const visiting = new Set();
+    const merge = (name) => {
+        if (visiting.has(name))
+            return {};
+        visiting.add(name);
+        const own = DEFAULT_TOKENS[name];
+        const override = overrides.get(name);
+        const parent = override?.inherit ?? own.inherit;
+        const inherited = parent === undefined ? {} : merge(parent);
+        visiting.delete(name);
+        return { ...withoutInherit(own), ...inherited, ...withoutInherit(writtenFields(override)) };
+    };
+    return merge(token);
+}
+/** Turn a colour SGR sequence into the parameter list it belongs to. */
+function colourParams(sequence) {
+    return sequence === '' ? undefined : sequence.slice('\u001B['.length, -1);
+}
+/**
+ * Resolve one token into the escapes a renderer needs.
+ *
+ * Faint is dropped once a colour is chosen: stacking it on a deliberate grey is
+ * what made the old output differ per terminal.
+ */
+export function resolveToken(token, overrides, palette, mode) {
+    const merged = mergeTokenSpec(token, overrides);
+    if (merged.hidden === true)
+        return { prefix: '', suffix: '', glyph: '', hidden: true };
+    // With no colour capability the whole promise is "emit nothing", which
+    // includes attributes: a bold word is still styling a reader turned off.
+    if (mode === 'none')
+        return { prefix: '', suffix: '', glyph: merged.glyph ?? '', hidden: false };
+    const fg = merged.fg;
+    const bg = merged.bg;
+    const codes = [];
+    if (merged.bold === true)
+        codes.push('1');
+    if (merged.dim === true && fg === undefined)
+        codes.push('2');
+    if (merged.italic === true)
+        codes.push('3');
+    if (merged.underline === true)
+        codes.push('4');
+    if (merged.strike === true)
+        codes.push('9');
+    for (const params of [
+        fg === undefined ? undefined : colourParams(sgrPrefix(resolveColour(fg, palette), mode)),
+        bg === undefined ? undefined : colourParams(sgrBackgroundPrefix(resolveColour(bg, palette), mode)),
+    ]) {
+        if (params !== undefined)
+            codes.push(params);
+    }
+    // One sequence for attributes and colours together: two escapes in a row would
+    // let a renderer that re-orders them drop half the style.
+    const prefix = codes.length === 0 ? '' : `\u001B[${codes.join(';')}m`;
+    return { prefix, suffix: prefix === '' ? '' : RESET, glyph: merged.glyph ?? '', hidden: false };
+}
+//# sourceMappingURL=theme-tokens.js.map

package/lib/theme-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme-tokens.js","sourceRoot":"","sources":["../src/theme-tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,mBAAmB,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAEvF,MAAM,KAAK,GAAG,WAAW,CAAA;AAEzB;;;;;;GAMG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAA;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,SAAS,CAAA;AAEtC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,SAAS,CAAA;AAEzC,oEAAoE;AACpE,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,CAAU,CAAA;AAiC5H,gFAAgF;AAChF,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ;CACtI,CAAA;AAKV;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,kBAAkB;IAClB,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,8BAA8B;IAC9B,2BAA2B;IAC3B,2BAA2B;IAC3B,mEAAmE;IACnE,gCAAgC;IAChC,YAAY;IACZ,YAAY;IACZ,WAAW;IACX,iBAAiB;IACjB,mBAAmB;IACnB,mBAAmB;IACnB,gBAAgB;IAChB,qBAAqB;IACrB,aAAa;IACb,WAAW;IACX,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,mBAAmB;IACnB,uBAAuB;IACvB,kBAAkB;IAClB,gBAAgB;IAChB,iBAAiB;IACjB,mBAAmB;IACnB,kBAAkB;IAClB,sBAAsB;IACtB,gBAAgB;IAChB,kBAAkB;IAClB,wBAAwB;IACxB,mBAAmB;IACnB,uBAAuB;IACvB,mBAAmB;IACnB,sBAAsB;IACtB,sBAAsB;IACtB,cAAc;IACd,iBAAiB;IACjB,oBAAoB;IACpB,qBAAqB;IACrB,WAAW;IACX,kBAAkB;IAClB,eAAe;IACf,kBAAkB;IAClB,eAAe;IACf,oBAAoB;IACpB,0BAA0B;IAC1B,gBAAgB;IAChB,sBAAsB;IACtB,aAAa;IACb,qBAAqB;IACrB,eAAe;IACf,iBAAiB;IACjB,wBAAwB;IACxB,oBAAoB;IACpB,6EAA6E;IAC7E,2DAA2D;IAC3D,yBAAyB;IACzB,uBAAuB;IACvB,uBAAuB;IACvB,4BAA4B;IAC5B,wBAAwB;IACxB,0BAA0B;IAC1B,6EAA6E;IAC7E,yEAAyE;IACzE,SAAS;IACT,cAAc;IACd,cAAc;IACd,aAAa;IACb,eAAe;IACf,YAAY;IACZ,mBAAmB;IACnB,oBAAoB;IACpB,oBAAoB;IACpB,aAAa;IACb,eAAe;IACf,OAAO;IACP,YAAY;IACZ,oBAAoB;IACpB,oBAAoB;IACpB,aAAa;IACb,aAAa;IACb,oBAAoB;IACpB,aAAa;IACb,WAAW;IACX,OAAO;IACP,WAAW;IACX,eAAe;IACf,oBAAoB;IACpB,oBAAoB;IACpB,uBAAuB;IACvB,qBAAqB;IACrB,wBAAwB;IACxB,wBAAwB;IACxB,yBAAyB;IACzB,mBAAmB;IACnB,mBAAmB;IACnB,oBAAoB;IACpB,aAAa;IACb,eAAe;IACf,aAAa;IACb,yBAAyB;IACzB,uBAAuB;IACvB,gBAAgB;IAChB,oBAAoB;IACpB,cAAc;IACd,eAAe;IACf,mBAAmB;IACnB,gBAAgB;IAChB,cAAc;IACd,YAAY;IACZ,kBAAkB;IAClB,SAAS;IACT,eAAe;IACf,eAAe;IACf,oBAAoB;IACpB,kCAAkC;IAClC,gCAAgC;IAChC,+BAA+B;IAC/B,8BAA8B;IAC9B,2BAA2B;CACnB,CAAA;AAKV;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAgF;IACzG,IAAI,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,iBAAiB,EAAE,OAAO,EAAE,mBAAmB,EAAE;IACpH,IAAI,EAAE,EAAE,MAAM,EAAE,kBAAkB,EAAE,UAAU,EAAE,sBAAsB,EAAE,IAAI,EAAE,gBAAgB,EAAE;IAChG,MAAM,EAAE;QACN,IAAI,EAAE,kBAAkB;QACxB,UAAU,EAAE,wBAAwB;QACpC,KAAK,EAAE,mBAAmB;QAC1B,SAAS,EAAE,uBAAuB;KACnC;IACD,QAAQ,EAAE,EAAE,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,sBAAsB,EAAE,MAAM,EAAE,sBAAsB,EAAE;IACtG,GAAG,EAAE,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,EAAE,iBAAiB,EAAE,SAAS,EAAE,oBAAoB,EAAE;IACxF,OAAO,EAAE,EAAE,MAAM,EAAE,qBAAqB,EAAE;CAC3C,CAAA;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,eAAe,GAA0C;IACpE,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,SAAS;IACjB,GAAG,EAAE,aAAa;IAClB,IAAI,EAAE,SAAS;IACf,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,IAAI,EAAE,gBAAgB;IACtB,SAAS,EAAE,SAAS;CACrB,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,KAAK,GAAc,EAAE,EAAE,EAAE,OAAO,EAAE,CAAA;AACxC,MAAM,KAAK,GAAc,EAAE,CAAA;AAE3B;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,cAAc,GAA0C;IACnE,iBAAiB,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;IACjC,mBAAmB,EAAE,KAAK;IAC1B,mBAAmB,EAAE,KAAK;IAC1B,8BAA8B,EAAE,KAAK;IACrC,2BAA2B,EAAE,KAAK;IAClC,2BAA2B,EAAE,KAAK;IAElC,YAAY,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;IAC5B,YAAY,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;IAC5B,WAAW,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;IAC1B,iBAAiB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE;IAClC,mBAAmB,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;IACnC,mBAAmB,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;IACtC,gBAAgB,EAAE,KAAK;IACvB,qBAAqB,EAAE,KAAK;IAC5B,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,KAAK;IAClB,mBAAmB,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;IACtC,mBAAmB,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;IACtC,oBAAoB,EAAE,KAAK;IAC3B,mBAAmB,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;IAElC,kBAAkB,EAAE,KAAK;IACzB,gBAAgB,EAAE,KAAK;IACvB,iBAAiB,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE;IAClC,mBAAmB,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE;IACtC,kBAAkB,EAAE,KAAK;IACzB,sBAAsB,EAAE,KAAK;IAC7B,gBAAgB,EAAE,KAAK;IACvB,kBAAkB,EAAE,KAAK;IACzB,wBAAwB,EAAE,KAAK;IAC/B,mBAAmB,EAAE,KAAK;IAC1B,uBAAuB,EAAE,KAAK;IAC9B,mBAAmB,EAAE,KAAK;IAC1B,sBAAsB,EAAE,KAAK;IAC7B,sBAAsB,EAAE,KAAK;IAC7B,cAAc,EAAE,KAAK;IACrB,iBAAiB,EAAE,KAAK;IACxB,oBAAoB,EAAE,KAAK;IAC3B,qBAAqB,EAAE,KAAK;IAE5B,kBAAkB,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE;IAChD,eAAe,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE;IAClD,kBAAkB,EAAE,KAAK;IACzB,eAAe,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;IACjC,oBAAoB,EAAE,KAAK;IAC3B,0BAA0B,EAAE,KAAK;IACjC,gBAAgB,EAAE,KAAK;IACvB,sBAAsB,EAAE,KAAK;IAC7B,aAAa,EAAE,KAAK;IACpB,qBAAqB,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;IACvC,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC/B,iBAAiB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;IACnC,wBAAwB,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE;IAC1C,oBAAoB,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;IACzC,yBAAyB,EAAE,KAAK;IAChC,uBAAuB,EAAE,KAAK;IAC9B,uBAAuB,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;IACzC,4BAA4B,EAAE,KAAK;IACnC,wBAAwB,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE;IACtD,0BAA0B,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE;IAE1C,cAAc,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC9B,cAAc,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC9B,aAAa,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC7B,eAAe,EAAE,KAAK;IACtB,YAAY,EAAE,KAAK;IACnB,mBAAmB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACnC,oBAAoB,EAAE,KAAK;IAC3B,oBAAoB,EAAE,KAAK;IAC3B,aAAa,EAAE,KAAK;IACpB,eAAe,EAAE,KAAK;IAEtB,YAAY,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC5B,oBAAoB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACpC,oBAAoB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACpC,aAAa,EAAE,KAAK;IACpB,aAAa,EAAE,KAAK;IACpB,oBAAoB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACpC,aAAa,EAAE,KAAK;IACpB,WAAW,EAAE,KAAK;IAElB,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC3B,eAAe,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAC/B,oBAAoB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACpC,oBAAoB,EAAE,KAAK;IAC3B,uBAAuB,EAAE,KAAK;IAC9B,qBAAqB,EAAE,KAAK;IAC5B,wBAAwB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACxC,wBAAwB,EAAE,KAAK;IAC/B,yBAAyB,EAAE,KAAK;IAChC,mBAAmB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IACnC,mBAAmB,EAAE,KAAK;IAC1B,oBAAoB,EAAE,KAAK;IAE3B,eAAe,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;IACjC,2EAA2E;IAC3E,sDAAsD;IACtD,aAAa,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;IAC/B,yBAAyB,EAAE,KAAK;IAChC,uBAAuB,EAAE,KAAK;IAC9B,gBAAgB,EAAE,KAAK;IACvB,oBAAoB,EAAE,KAAK;IAC3B,cAAc,EAAE,KAAK;IACrB,eAAe,EAAE,KAAK;IACtB,mBAAmB,EAAE,KAAK;IAC1B,gBAAgB,EAAE,KAAK;IACvB,cAAc,EAAE,KAAK;IACrB,YAAY,EAAE,KAAK;IACnB,kBAAkB,EAAE,KAAK;IAEzB,eAAe,EAAE,KAAK;IACtB,2EAA2E;IAC3E,0EAA0E;IAC1E,eAAe,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;IAC5C,oBAAoB,EAAE,KAAK;IAC3B,kCAAkC,EAAE,EAAE,EAAE,EAAE,QAAQ,EAAE;IACpD,gCAAgC,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE;IAChD,+BAA+B,EAAE,KAAK;IACtC,8BAA8B,EAAE,KAAK;IACrC,2BAA2B,EAAE,KAAK;CACnC,CAAA;AAED,8EAA8E;AAC9E,SAAS,aAAa,CAAC,IAAgB,EAAE,OAA8C;IACrF,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAK,aAAmC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACpF,OAAO,OAAO,CAAC,IAAmB,CAAC,CAAA;IACrC,CAAC;IACD,OAAO,IAAuB,CAAA;AAChC,CAAC;AAED,2EAA2E;AAC3E,SAAS,cAAc,CAAC,IAAe;IACrC,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,IAAI,CAAA;IAC3C,OAAO,IAAI,CAAA;AACb,CAAC;AAED,+FAA+F;AAC/F,SAAS,aAAa,CAAC,IAA2B;IAChD,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,EAAE,CAAA;IACjC,MAAM,OAAO,GAA4B,EAAE,CAAA;IAC3C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,CAAC,GAAG,CAAC,GAAG,KAAK,CAAA;IAC/C,CAAC;IACD,OAAO,OAAoB,CAAA;AAC7B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAAC,KAAe,EAAE,SAA2C;IACzF,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAY,CAAA;IACpC,MAAM,KAAK,GAAG,CAAC,IAAc,EAAa,EAAE;QAC1C,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAA;QACjC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAClB,MAAM,GAAG,GAAG,cAAc,CAAC,IAAI,CAAC,CAAA;QAChC,MAAM,QAAQ,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QACpC,MAAM,MAAM,GAAG,QAAQ,EAAE,OAAO,IAAI,GAAG,CAAC,OAAO,CAAA;QAC/C,MAAM,SAAS,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAA;QAC3D,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;QACrB,OAAO,EAAE,GAAG,cAAc,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,EAAE,GAAG,cAAc,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAA;IAC7F,CAAC,CAAA;IACD,OAAO,KAAK,CAAC,KAAK,CAAC,CAAA;AACrB,CAAC;AAED,wEAAwE;AACxE,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAA;AAC3E,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAe,EACf,SAA2C,EAC3C,OAA8C,EAC9C,IAAgB;IAEhB,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,EAAE,SAAS,CAA4B,CAAA;IAC1E,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAA;IAEtF,uEAAuE;IACvE,yEAAyE;IACzE,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAG,MAAM,CAAC,KAA4B,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;IAExH,MAAM,EAAE,GAAG,MAAM,CAAC,EAA4B,CAAA;IAC9C,MAAM,EAAE,GAAG,MAAM,CAAC,EAA4B,CAAA;IAC9C,MAAM,KAAK,GAAa,EAAE,CAAA;IAC1B,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IACzC,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,EAAE,KAAK,SAAS;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3C,IAAI,MAAM,CAAC,SAAS,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC9C,IAAI,MAAM,CAAC,MAAM,KAAK,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAC3C,KAAK,MAAM,MAAM,IAAI;QACnB,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;QACxF,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,mBAAmB,CAAC,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,CAAC;KACnG,EAAE,CAAC;QACF,IAAI,MAAM,KAAK,SAAS;YAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC9C,CAAC;IACD,+EAA+E;IAC/E,0DAA0D;IAC1D,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAA;IACrE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAG,MAAM,CAAC,KAA4B,IAAI,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAA;AACzH,CAAC"}

package/lib/theme.d.ts

@@ -1,47 +1,44 @@
-import type { EditorTheme, MarkdownTheme } from '@earendil-works/pi-tui';
-/** Glyph that introduces each transcript row kind. */
-export interface TranscriptGlyphs {
-    readonly user: string;
-    readonly assistant: string;
-    readonly tool: string;
-    readonly notice: string;
-    readonly reasoning: string;
-    readonly marker: string;
-}
-/** Styling the surface applies, and the editor/select themes pi-tui needs. */
+import { type EditorTheme, type MarkdownTheme } from '@earendil-works/pi-tui';
+import { type ColourMode } from './theme-capability.ts';
+import { type TuiToken } from './theme-tokens.ts';
+import type { ThemeOverrides } from './theme-settings.ts';
+/**
+ * Styling the surface applies, and the editor/select themes pi-tui needs.
+ *
+ * Every element is drawn by naming its token, so a reader's override reaches
+ * it without the renderer knowing what the element is for.
+ */
 export interface TuiTheme {
+    readonly revision: number;
     readonly color: boolean;
-    readonly glyphs: TranscriptGlyphs;
-    dim(text: string): string;
-    bold(text: string): string;
-    tool(text: string): string;
-    notice(text: string): string;
-    /** Diff additions and removals, colored by background rather than by hue alone. */
-    added(text: string): string;
-    removed(text: string): string;
-    /** A boundary in the conversation rather than something anyone said. */
-    marker(text: string): string;
-    /** Structure the reader scans for: headings, links, inline code, list bullets. */
-    accent(text: string): string;
-    italic(text: string): string;
+    /** Draw one named element. */
+    style(token: TuiToken, text: string): string;
+    /** Cut a row to a width, so no renderer has to reach for the raw helper. */
+    cut(text: string, width: number, ellipsis?: string): string;
+    /** The mark that introduces an element, empty unless the reader set one. */
+    glyph(token: TuiToken): string;
+    /** Whether an element is drawn at all. */
+    visible(token: TuiToken): boolean;
     readonly editor: EditorTheme;
     readonly markdown: MarkdownTheme;
 }
 /**
- * Whether styling is on, given the launch flag and the environment.
+ * Build the surface theme.
  *
- * `NO_COLOR` is a cross-tool convention (no-color.org): when it is present and
- * not empty, a program that colors by default must not, regardless of its own
- * flags. Honouring it means one environment variable turns styling off for
- * every tool in a session, which is how a reader actually wants it to work.
+ * Every token is resolved once, when the theme is built, rather than per frame:
+ * a repaint walks the whole transcript and re-resolving a palette chain for
+ * every row would pay for the same answer thousands of times. A settings change
+ * builds a new theme instead, which is also what makes the swap atomic.
  */
-export declare function colorEnabled(requested: boolean, env?: Record<string, string | undefined>): boolean;
+export declare function createTheme(mode?: ColourMode, overrides?: ThemeOverrides): TuiTheme;
 /**
- * Build the surface theme.
+ * An editor theme that follows a moving source.
  *
- * Styling uses the standard 16 ANSI colors and terminal defaults rather than
- * true-color values, so a light or dark terminal remaps the interface on its
- * own and the surface needs no theme setting.
+ * The editor keeps the theme it was built with for the life of the session, so
+ * a settings change has to reach it through a stable object instead of by
+ * replacing the one it captured.
  */
-export declare function createTheme(color: boolean): TuiTheme;
+export declare function forwardEditorTheme(source: () => EditorTheme): EditorTheme;
+/** The markdown counterpart of {@link forwardEditorTheme}. */
+export declare function forwardMarkdownTheme(source: () => MarkdownTheme): MarkdownTheme;
 //# sourceMappingURL=theme.d.ts.map