@inhuman.tools/quickdraw 0.0.0-bootstrap.0 → 0.2.0

package/dist/theme/theme.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Build a solved Theme from seeds against terminal ground.
+ * Request roles — never claim raw hex in widgets.
+ */
+import { type SolveOpts } from "./salience.js";
+import { type SeedRow } from "./seeds.js";
+import type { Rgb, SemanticRole } from "../lexicon/index.js";
+export type Theme = {
+    id: string;
+    name: string;
+    /** Ground OKLCH L used to solve this theme. */
+    ground: number;
+    /** Solved role → hex. */
+    colors: Record<SemanticRole, string>;
+    /** Solved role → 0–255 RGB (truecolor paint). */
+    rgb: Record<SemanticRole, Rgb>;
+    /**
+     * "Background" hex of ground L (achromatic) — for docs/tests only.
+     * Never paint as default cell bg (TERMINAL O1: transparent inherit).
+     */
+    groundHex: string;
+    /**
+     * Terminal ground sRGB. OSC 11 when probed; otherwise the achromatic
+     * ground L. Transparent FG prominence dissolves toward this, not a
+     * phantom gray at the same lightness.
+     */
+    groundRgb: Rgb;
+};
+export type BuildThemeOpts = SolveOpts & {
+    seeds?: readonly SeedRow[];
+    id?: string;
+    name?: string;
+    /** Override ground; default REFERENCE_GROUND until OSC 11 wires. */
+    ground?: number;
+    /** Probed terminal background. When omitted, achromatic {@link ground}. */
+    groundRgb?: Rgb;
+};
+export declare function buildTheme(opts?: BuildThemeOpts): Theme;
+/** Default dark-reference theme (tests + headless fallback). */
+export declare const defaultTheme: Theme;
+//# sourceMappingURL=theme.d.ts.map

package/dist/theme/theme.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.d.ts","sourceRoot":"","sources":["../../src/theme/theme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAA8C,KAAK,SAAS,EAAY,MAAM,eAAe,CAAC;AACrG,OAAO,EAAiB,KAAK,OAAO,EAAE,MAAM,YAAY,CAAC;AACzD,OAAO,KAAK,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE7D,MAAM,MAAM,KAAK,GAAG;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,yBAAyB;IACzB,MAAM,EAAE,MAAM,CAAC,YAAY,EAAE,MAAM,CAAC,CAAC;IACrC,iDAAiD;IACjD,GAAG,EAAE,MAAM,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC;IAC/B;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;;;OAIG;IACH,SAAS,EAAE,GAAG,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG;IACvC,KAAK,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,SAAS,CAAC,EAAE,GAAG,CAAC;CACjB,CAAC;AAEF,wBAAgB,UAAU,CAAC,IAAI,GAAE,cAAmB,GAAG,KAAK,CA0B3D;AAED,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,KAAgD,CAAC"}

package/dist/theme/theme.js

@@ -0,0 +1,34 @@
+/**
+ * Build a solved Theme from seeds against terminal ground.
+ * Request roles — never claim raw hex in widgets.
+ */
+import { oklchToHex, REFERENCE_GROUND, solvePalette, hexToRgb } from "./salience.js";
+import { DEFAULT_SEEDS } from "./seeds.js";
+export function buildTheme(opts = {}) {
+    const ground = opts.ground ?? REFERENCE_GROUND;
+    const seeds = opts.seeds ?? DEFAULT_SEEDS;
+    const palette = solvePalette(seeds, {
+        ground,
+        polarity: opts.polarity,
+    });
+    const colors = {};
+    const rgb = {};
+    for (const s of seeds) {
+        const hex = palette[s.name];
+        colors[s.name] = hex;
+        rgb[s.name] = hexToRgb(hex);
+    }
+    const groundHex = oklchToHex(ground, 0, 0);
+    return {
+        id: opts.id ?? "salience",
+        name: opts.name ?? "salience",
+        ground,
+        colors,
+        rgb,
+        groundHex,
+        groundRgb: opts.groundRgb ?? hexToRgb(groundHex),
+    };
+}
+/** Default dark-reference theme (tests + headless fallback). */
+export const defaultTheme = buildTheme({ ground: REFERENCE_GROUND });
+//# sourceMappingURL=theme.js.map

package/dist/theme/theme.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"theme.js","sourceRoot":"","sources":["../../src/theme/theme.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAkB,QAAQ,EAAE,MAAM,eAAe,CAAC;AACrG,OAAO,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAmCzD,MAAM,UAAU,UAAU,CAAC,OAAuB,EAAE;IAClD,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,gBAAgB,CAAC;IAC/C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,aAAa,CAAC;IAC1C,MAAM,OAAO,GAAG,YAAY,CAAC,KAAK,EAAE;QAClC,MAAM;QACN,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,EAAkC,CAAC;IAClD,MAAM,GAAG,GAAG,EAA+B,CAAC;IAC5C,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,GAAG,GAAG,OAAO,CAAC,CAAC,CAAC,IAAI,CAAE,CAAC;QAC7B,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC;QACrB,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;IAC9B,CAAC;IAED,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3C,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,UAAU;QACzB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,UAAU;QAC7B,MAAM;QACN,MAAM;QACN,GAAG;QACH,SAAS;QACT,SAAS,EAAE,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC;KACjD,CAAC;AACJ,CAAC;AAED,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAU,UAAU,CAAC,EAAE,MAAM,EAAE,gBAAgB,EAAE,CAAC,CAAC"}

package/dist/widgets/composer-caret.d.ts

@@ -0,0 +1,47 @@
+import { type Frame } from "../layout/index.js";
+export type CaretPark = {
+    readonly row: number;
+    readonly col: number;
+    readonly show: boolean;
+};
+export declare function composerOffsetAtCell(draft: string, col0: number, row0: number, origin: {
+    col: number;
+    row: number;
+}, textW: number): number;
+/** Exclusive end of the grapheme at this body cell (padding stays put). */
+export declare function composerOffsetAfterCell(draft: string, col0: number, row0: number, origin: {
+    col: number;
+    row: number;
+}, textW: number): number;
+/**
+ * Visual composer selection → draft mark/cursor (textarea `[start, end)`).
+ * Cell hits land *before* a grapheme; the later endpoint is exclusive.
+ */
+export declare function composerDraftSelectionFromCells(draft: string, anchor: {
+    col: number;
+    row: number;
+}, active: {
+    col: number;
+    row: number;
+}, origin: {
+    col: number;
+    row: number;
+}, textW: number): {
+    cursor: number;
+    mark: number;
+} | null;
+/** 1-based CUP for the draft caret. termFocused false → hide. */
+export declare function parkComposerCaret(opts: {
+    readonly draft: string;
+    readonly cursor: number;
+    readonly frame: Frame | null;
+    readonly cols: number;
+    readonly rows: number;
+    readonly termFocused: boolean;
+    /** Layout key for the chrome_frame draft surface. Default `composer:frame`. */
+    readonly composerFrameKey?: string;
+}): CaretPark;
+export declare const SHOW_CURSOR = "\u001B[?25h";
+export declare const HIDE_CURSOR = "\u001B[?25l";
+export declare function caretAnsi(park: CaretPark): string;
+//# sourceMappingURL=composer-caret.d.ts.map

package/dist/widgets/composer-caret.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-caret.d.ts","sourceRoot":"","sources":["../../src/widgets/composer-caret.ts"],"names":[],"mappings":"AAWA,OAAO,EAAuB,KAAK,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAErE,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;CACxB,CAAC;AAeF,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACpC,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AAED,2EAA2E;AAC3E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACpC,KAAK,EAAE,MAAM,GACZ,MAAM,CAIR;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,MAAM,EACb,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACpC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACpC,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,EACpC,KAAK,EAAE,MAAM,GACZ;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CASzC;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,+EAA+E;IAC/E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;CACpC,GAAG,SAAS,CAuCZ;AAED,eAAO,MAAM,WAAW,gBAAgB,CAAC;AACzC,eAAO,MAAM,WAAW,gBAAgB,CAAC;AAEzC,wBAAgB,SAAS,CAAC,IAAI,EAAE,SAAS,GAAG,MAAM,CAGjD"}

package/dist/widgets/composer-caret.js

@@ -0,0 +1,90 @@
+/**
+ * TTY caret park for the composer omnibox + click→offset inverse.
+ *
+ * Enter-alt hides the cursor (`?25l`). Every present tick must re-park/show
+ * when focused, or the caret vanishes after first paint ("losing focus").
+ *
+ * Prefer laid-out body hit for `composer:frame` (text column). Click→offset
+ * shares visualDraftLines with paint via widgets offsetAtVisualCell (not a
+ * local char-wrap walk).
+ */
+import { offsetAfterVisualCell, offsetAtVisualCell } from "./composer-click.js";
+import { visualCaretGeometry } from "../layout/index.js";
+const DEFAULT_COMPOSER_FRAME_KEY = "composer:frame";
+function localCell(col0, row0, origin) {
+    return {
+        localCol: Math.max(0, col0 - origin.col),
+        localRow: Math.max(0, row0 - origin.row),
+    };
+}
+export function composerOffsetAtCell(draft, col0, row0, origin, textW) {
+    const w = Math.max(1, textW);
+    const { localCol, localRow } = localCell(col0, row0, origin);
+    return offsetAtVisualCell(draft, w, localRow, localCol);
+}
+/** Exclusive end of the grapheme at this body cell (padding stays put). */
+export function composerOffsetAfterCell(draft, col0, row0, origin, textW) {
+    const w = Math.max(1, textW);
+    const { localCol, localRow } = localCell(col0, row0, origin);
+    return offsetAfterVisualCell(draft, w, localRow, localCol);
+}
+/**
+ * Visual composer selection → draft mark/cursor (textarea `[start, end)`).
+ * Cell hits land *before* a grapheme; the later endpoint is exclusive.
+ */
+export function composerDraftSelectionFromCells(draft, anchor, active, origin, textW) {
+    const before = (cell) => composerOffsetAtCell(draft, cell.col, cell.row, origin, textW);
+    const after = (cell) => composerOffsetAfterCell(draft, cell.col, cell.row, origin, textW);
+    const anchorFirst = anchor.row < active.row || (anchor.row === active.row && anchor.col <= active.col);
+    const mark = anchorFirst ? before(anchor) : after(anchor);
+    const cursor = anchorFirst ? after(active) : before(active);
+    if (mark === cursor)
+        return null;
+    return { cursor, mark };
+}
+/** 1-based CUP for the draft caret. termFocused false → hide. */
+export function parkComposerCaret(opts) {
+    if (!opts.termFocused)
+        return { row: 1, col: 1, show: false };
+    const draft = opts.draft;
+    const cursor = Math.max(0, Math.min(draft.length, opts.cursor));
+    const frameKey = opts.composerFrameKey ?? DEFAULT_COMPOSER_FRAME_KEY;
+    const hit = opts.frame?.byKey.get(frameKey)?.hitRect;
+    // chrome_frame text column: hit.w (outer − 4: │ mark gap │), else estimate.
+    const textW = hit && hit.w > 0 ? hit.w : Math.max(8, opts.cols - 4);
+    // Same soft-wrap as ↑/↓: wrap-boundary offsets park on *next* row col 0,
+    // not trailing past the last glyph of the prior row.
+    const geom = visualCaretGeometry(draft, cursor, textW);
+    const line = geom.line;
+    const colInContent = geom.colInContent;
+    if (hit && hit.h > 0) {
+        // Never park on right border `│` (col === textW). Virtual line past bodyH
+        // → last body row, last cell.
+        const maxLine = Math.max(0, hit.h - 1);
+        const lineClamped = Math.min(line, maxLine);
+        const colIn = line > maxLine || colInContent >= textW ? Math.max(0, textW - 1) : colInContent;
+        const row = Math.min(opts.rows, Math.max(1, hit.y + 1 + lineClamped));
+        const col = Math.min(opts.cols, Math.max(1, hit.x + 1 + colIn));
+        return { row, col, show: true };
+    }
+    // Laid-out frame without composer:frame — hide. A fallback CUP+?25h on a
+    // catalog/demo paint is a visible hop every live tick (no draft to park).
+    if (opts.frame !== null)
+        return { row: 1, col: 1, show: false };
+    // BOOT: caret must exist before first layout. Enter-alt hides (`?25l`);
+    // hiding here leaves the cursor gone until a frame exists. Floor is
+    // `rows-2` / `6+col` — a CUP into the composer band, not (1,1).
+    return {
+        row: Math.max(1, opts.rows - 2),
+        col: Math.min(opts.cols, 6 + colInContent),
+        show: true,
+    };
+}
+export const SHOW_CURSOR = "\u001B[?25h";
+export const HIDE_CURSOR = "\u001B[?25l";
+export function caretAnsi(park) {
+    if (!park.show)
+        return HIDE_CURSOR;
+    return `\u001B[${park.row};${park.col}H${SHOW_CURSOR}`;
+}
+//# sourceMappingURL=composer-caret.js.map

package/dist/widgets/composer-caret.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-caret.js","sourceRoot":"","sources":["../../src/widgets/composer-caret.ts"],"names":[],"mappings":"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"}

package/dist/widgets/composer-click.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Composer click→caret — the inverse of {@link composerVisualGeometry}.
+ *
+ * Given a clicked cell inside the composer body, map it back to a character
+ * offset in the draft string. This is the #1 missing feature in AI-TUI peers
+ * (Claude Code, Gemini CLI, Codex all lack click-to-position-cursor).
+ *
+ * Uses the same visual line partition as paint/caret park:
+ * {@link visualDraftLines} → `wrapText` with `pre-wrap` (word-preferring soft
+ * wrap). Prior char-by-char walk disagreed with the renderer on space breaks
+ * (audit C5).
+ *
+ * CJK convention (neovim `vcol2col`): a wide char occupies 2 cells. Click on
+ * EITHER half of a wide char lands the cursor BEFORE it — never split a wide
+ * char.
+ *
+ * Padding clamps follow the browser `<textarea>` convention: clicks in the
+ * left padding clamp to line start; clicks past the line end clamp to the end
+ * of the logical line.
+ */
+/**
+ * Map (visualLine, visualCol) → UTF-16 offset using the same line breaks as paint.
+ */
+export declare function offsetAtVisualCell(draft: string, contentWidth: number, targetLine: number, targetCol: number): number;
+/**
+ * Exclusive end of the grapheme painted at this cell.
+ * Padding / past-line cells stay at {@link offsetAtVisualCell} (already exclusive).
+ */
+export declare function offsetAfterVisualCell(draft: string, contentWidth: number, targetLine: number, targetCol: number): number;
+//# sourceMappingURL=composer-click.d.ts.map

package/dist/widgets/composer-click.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-click.d.ts","sourceRoot":"","sources":["../../src/widgets/composer-click.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAKH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAgCrH;AAcD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,MAAM,CAUR"}

package/dist/widgets/composer-click.js

@@ -0,0 +1,89 @@
+/**
+ * Composer click→caret — the inverse of {@link composerVisualGeometry}.
+ *
+ * Given a clicked cell inside the composer body, map it back to a character
+ * offset in the draft string. This is the #1 missing feature in AI-TUI peers
+ * (Claude Code, Gemini CLI, Codex all lack click-to-position-cursor).
+ *
+ * Uses the same visual line partition as paint/caret park:
+ * {@link visualDraftLines} → `wrapText` with `pre-wrap` (word-preferring soft
+ * wrap). Prior char-by-char walk disagreed with the renderer on space breaks
+ * (audit C5).
+ *
+ * CJK convention (neovim `vcol2col`): a wide char occupies 2 cells. Click on
+ * EITHER half of a wide char lands the cursor BEFORE it — never split a wide
+ * char.
+ *
+ * Padding clamps follow the browser `<textarea>` convention: clicks in the
+ * left padding clamp to line start; clicks past the line end clamp to the end
+ * of the logical line.
+ */
+import { visualDraftLines } from "../layout/index.js";
+import { displayWidth } from "../measure/index.js";
+/**
+ * Map (visualLine, visualCol) → UTF-16 offset using the same line breaks as paint.
+ */
+export function offsetAtVisualCell(draft, contentWidth, targetLine, targetCol) {
+    const lines = visualDraftLines(draft, contentWidth);
+    if (lines.length === 0)
+        return 0;
+    if (targetLine >= lines.length) {
+        return lines.at(-1).end;
+    }
+    const line = lines[targetLine];
+    if (targetCol <= 0)
+        return line.start;
+    if (line.text.length === 0)
+        return line.start;
+    const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+    let colInLine = 0;
+    let offset = line.start;
+    for (const seg of segmenter.segment(line.text)) {
+        const segWidth = displayWidth(seg.segment);
+        // Click at or before this grapheme → land before it.
+        if (targetCol <= colInLine) {
+            return offset;
+        }
+        // Click inside a wide grapheme → land before it (don't split CJK).
+        if (targetCol < colInLine + segWidth) {
+            return offset;
+        }
+        colInLine += segWidth;
+        offset += seg.segment.length;
+    }
+    // Past end of visual line → clamp to line end (exclusive of following soft-wrap text).
+    return line.end;
+}
+function firstGraphemeLength(s) {
+    if (s.length === 0)
+        return 0;
+    try {
+        const it = new Intl.Segmenter(undefined, { granularity: "grapheme" }).segment(s)[Symbol.iterator]();
+        const first = it.next();
+        return first.done ? 0 : first.value.segment.length;
+    }
+    catch {
+        const cp = s.codePointAt(0);
+        return cp !== undefined && cp > 0xff_ff ? 2 : 1;
+    }
+}
+/**
+ * Exclusive end of the grapheme painted at this cell.
+ * Padding / past-line cells stay at {@link offsetAtVisualCell} (already exclusive).
+ */
+export function offsetAfterVisualCell(draft, contentWidth, targetLine, targetCol) {
+    const start = offsetAtVisualCell(draft, contentWidth, targetLine, targetCol);
+    const next = offsetAtVisualCell(draft, contentWidth, targetLine, targetCol + 1);
+    if (next > start)
+        return next;
+    const lines = visualDraftLines(draft, Math.max(1, contentWidth));
+    if (lines.length === 0)
+        return start;
+    const line = lines[Math.min(Math.max(0, targetLine), lines.length - 1)];
+    if (start >= line.end)
+        return start;
+    if (targetCol >= displayWidth(line.text))
+        return start;
+    return start + firstGraphemeLength(draft.slice(start, line.end));
+}
+//# sourceMappingURL=composer-click.js.map

package/dist/widgets/composer-click.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-click.js","sourceRoot":"","sources":["../../src/widgets/composer-click.ts"],"names":[],"mappings":"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"}

package/dist/widgets/composer-command.d.ts

@@ -0,0 +1,64 @@
+/**
+ * Composer command catalog + match.
+ *
+ * Pure. The widget paints the match; the worker calls the same matcher so
+ * autocomplete can notify on a prefix hit (`/conn` → `/connect` is active)
+ * without a function on the layout node.
+ *
+ * {@link autocompleteRemainder} is the dim suffix after the caret. It is not
+ * draft: caret, copy, and Tab rewrite stay on the typed prefix.
+ */
+import type { ChromeHotkey } from "../layout/paint-hotkey.js";
+export type ComposerCommand = {
+    readonly name: string;
+    readonly description?: string;
+    readonly aliases?: readonly string[];
+};
+export type ComposerCommandAction = {
+    readonly name: string;
+    readonly displayName: string;
+    readonly hotkey?: string;
+};
+export type ComposerCommandChoice = {
+    readonly key?: string;
+    readonly name: string;
+    readonly status?: string;
+    readonly annotation?: string;
+    readonly description?: string;
+    readonly actionDisplayName?: string;
+    readonly actions: readonly ComposerCommandAction[];
+    /** When set, the panel paints this URL as an accent+underline link. */
+    readonly href?: string;
+};
+/** Fallback row when choices are empty or the catalog missed. */
+export type ComposerCommandFallback = {
+    readonly name: string;
+    readonly displayName: string;
+    readonly actions: readonly ComposerCommandAction[];
+    readonly href?: string;
+};
+export type ComposerCommandMatch = {
+    readonly matches: readonly ComposerCommand[];
+    readonly selected: ComposerCommand | null;
+    readonly selectedIndex: number;
+};
+/**
+ * Dim suffix after the typed prefix for the highlighted picker row.
+ *
+ * Catalog names start with `/` and complete the verb (`/con` → `nect`).
+ * Choice names do not: a bare verb gets a separating space (`/connect` →
+ * ` LM Studio`); a prefix of the name — spaces included — gets only the rest
+ * (`LM St` → `udio`). Empty when the prefix is already exact, is not a prefix
+ * of the name, or the draft is not a single-line slash command.
+ */
+export declare function autocompleteRemainder(inputValue: string, selectedName: string): string;
+/**
+ * Prefix match against `commands`. Empty draft / no leading `/` → no match.
+ * Selected is the first match (caller may override with an index).
+ */
+export declare function matchComposerCommand(inputValue: string, commands: readonly ComposerCommand[]): ComposerCommandMatch;
+export declare function commandToChoice(cmd: ComposerCommand): ComposerCommandChoice;
+/** Chord/action pairs for the omnibox strip. */
+export declare function actionHotkeys(actions: readonly ComposerCommandAction[] | undefined): ChromeHotkey[] | undefined;
+export declare function fallbackToChoice(action: ComposerCommandFallback): ComposerCommandChoice;
+//# sourceMappingURL=composer-command.d.ts.map

package/dist/widgets/composer-command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-command.d.ts","sourceRoot":"","sources":["../../src/widgets/composer-command.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAE9D,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,uEAAuE;IACvE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,iEAAiE;AACjE,MAAM,MAAM,uBAAuB,GAAG;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,CAAC;AAaF;;;;;;;;GAQG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAkBtF;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,SAAS,eAAe,EAAE,GAAG,oBAAoB,CAanH;AAED,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,qBAAqB,CAQ3E;AAED,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,GAAG,SAAS,GAAG,YAAY,EAAE,GAAG,SAAS,CAW/G;AAmBD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,uBAAuB,GAAG,qBAAqB,CAQvF"}

package/dist/widgets/composer-command.js

@@ -0,0 +1,127 @@
+/**
+ * Composer command catalog + match.
+ *
+ * Pure. The widget paints the match; the worker calls the same matcher so
+ * autocomplete can notify on a prefix hit (`/conn` → `/connect` is active)
+ * without a function on the layout node.
+ *
+ * {@link autocompleteRemainder} is the dim suffix after the caret. It is not
+ * draft: caret, copy, and Tab rewrite stay on the typed prefix.
+ */
+import { catalogKey } from "./composer-picker.js";
+function verbToken(inputValue) {
+    const first = (inputValue.split("\n")[0] ?? "").trim();
+    if (!first.startsWith("/"))
+        return "";
+    return (first.split(/\s/)[0] ?? "").slice(1).toLowerCase();
+}
+function commandNames(cmd) {
+    const names = [cmd.name, ...(cmd.aliases ?? [])];
+    return names.map((n) => n.replace(/^\//, "").toLowerCase());
+}
+/**
+ * Dim suffix after the typed prefix for the highlighted picker row.
+ *
+ * Catalog names start with `/` and complete the verb (`/con` → `nect`).
+ * Choice names do not: a bare verb gets a separating space (`/connect` →
+ * ` LM Studio`); a prefix of the name — spaces included — gets only the rest
+ * (`LM St` → `udio`). Empty when the prefix is already exact, is not a prefix
+ * of the name, or the draft is not a single-line slash command.
+ */
+export function autocompleteRemainder(inputValue, selectedName) {
+    if (inputValue.includes("\n"))
+        return "";
+    const choice = selectedName.trim();
+    if (choice.length === 0)
+        return "";
+    const rest = inputValue.replace(/^\s*/, "");
+    if (!rest.startsWith("/"))
+        return "";
+    const sp = rest.search(/\s/);
+    if (choice.startsWith("/")) {
+        if (sp >= 0)
+            return "";
+        if (!startsWithInsensitive(choice, rest))
+            return "";
+        return choice.slice(rest.length);
+    }
+    if (sp < 0)
+        return ` ${choice}`;
+    const args = rest.slice(sp + 1);
+    if (!startsWithInsensitive(choice, args))
+        return "";
+    return choice.slice(args.length);
+}
+function startsWithInsensitive(full, prefix) {
+    return full.toLowerCase().startsWith(prefix.toLowerCase());
+}
+/**
+ * Prefix match against `commands`. Empty draft / no leading `/` → no match.
+ * Selected is the first match (caller may override with an index).
+ */
+export function matchComposerCommand(inputValue, commands) {
+    const token = verbToken(inputValue);
+    if (token.length === 0 && !(inputValue.split("\n")[0] ?? "").trim().startsWith("/")) {
+        return { matches: [], selected: null, selectedIndex: 0 };
+    }
+    const matches = token.length === 0 ? commands : commands.filter((c) => commandNames(c).some((n) => n.startsWith(token)));
+    const selected = matches[0] ?? null;
+    return {
+        matches,
+        selected,
+        selectedIndex: selected ? 0 : 0,
+    };
+}
+export function commandToChoice(cmd) {
+    const name = cmd.name.startsWith("/") ? cmd.name : `/${cmd.name}`;
+    return {
+        key: catalogKey(name),
+        name,
+        description: cmd.description,
+        actions: [{ name: "select", displayName: "select", hotkey: "Enter" }],
+    };
+}
+/** Chord/action pairs for the omnibox strip. */
+export function actionHotkeys(actions) {
+    if (actions === undefined)
+        return undefined;
+    const out = [];
+    for (const action of actions) {
+        const key = paintHotkey((action.hotkey ?? "").trim());
+        if (key.length === 0)
+            continue;
+        const label = (action.displayName || action.name).trim();
+        if (label.length === 0)
+            continue;
+        out.push({ key, action: label, event: action.name });
+    }
+    return out.length > 0 ? out : undefined;
+}
+/**
+ * STRIP vs STORAGE. Stored chords stay `escape` / `control-x` so
+ * `eventMatchesChord` matches. This function is display-only: the strip
+ * writes `Esc` / `Ctrl-x`. Normalizing storage to the strip form breaks matching.
+ */
+function paintHotkey(hotkey) {
+    return hotkey
+        .split("-")
+        .map((part) => {
+        const lower = part.toLowerCase();
+        if (lower === "escape")
+            return "Esc";
+        if (lower === "control")
+            return "Ctrl";
+        return part;
+    })
+        .join("-");
+}
+export function fallbackToChoice(action) {
+    return {
+        name: action.displayName || action.name,
+        description: action.name,
+        actions: action.actions,
+        actionDisplayName: action.actions[0]?.displayName,
+        href: action.href,
+    };
+}
+//# sourceMappingURL=composer-command.js.map

package/dist/widgets/composer-command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"composer-command.js","sourceRoot":"","sources":["../../src/widgets/composer-command.ts"],"names":[],"mappings":"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"}

package/dist/widgets/composer-frame.d.ts

@@ -0,0 +1,74 @@
+/**
+ * ComposerFrame — TEA widget leaf for boxed prompt chrome.
+ *
+ * One declaration. Values (draft, annotation, progress, status, command
+ * rows) ride the composer box; layout's `chrome_frame` strategy paints
+ * edges. Speculative echo and progress ease live on the host.
+ *
+ * @see quickdraw/layout/src/chrome_frame.ts
+ */
+import { type ComposerCommand, type ComposerCommandChoice, type ComposerCommandFallback } from "./composer-command.js";
+import { type ChromeHotkey, type ChromeQuotaWindow, type ChromeStatusItem, type LayoutNode } from "../layout/index.js";
+export type ComposerErrorAnnotation = {
+    readonly level: "warning" | "error";
+    readonly message: string;
+};
+export type ComposerFrameModel = {
+    inputValue?: string;
+    placeholder?: string;
+    hotkeys?: readonly ChromeHotkey[] | null;
+    modHeld?: boolean;
+    annotation?: string | null;
+    /** T-join right-rail when stacked (session title above the input). */
+    joinAnnotation?: string | null;
+    /** Ignored here — Tea seats the error on the wait pin, not ╭╮. */
+    errorAnnotation?: ComposerErrorAnnotation | null;
+    progress?: number;
+    progressColor?: string;
+    progressGlowAt?: number;
+    progressAnnotation?: string | null;
+    statusItems?: readonly ChromeStatusItem[];
+    quotaWindows?: readonly ChromeQuotaWindow[];
+    contextUsed?: number;
+    contextLimit?: number;
+    contourRole?: string;
+    commands?: readonly ComposerCommand[];
+    /** When set (even empty), wins over {@link commands} for the panel. */
+    commandChoices?: readonly ComposerCommandChoice[];
+    commandAction?: ComposerCommandFallback | null;
+    /** Wins the ╭╮ annotation slot when there is no stack. */
+    commandAnnotation?: string | null;
+    /** Wins over {@link selectedCommandIndex}. */
+    selectedCommandKey?: string | null;
+    selectedCommandIndex?: number;
+    scrollOffset?: number;
+    pickerHoverKey?: string | null;
+    pickerPressKey?: string | null;
+    pickerViewport?: number;
+    /** Ignored when a picker is open. Empty / omitted → no panel. */
+    stackedBody?: string | null;
+    stackedViewport?: number;
+    /** MCP confirm stays off. */
+    stackedNumbered?: boolean;
+    /** Numbered stacks ignore this. */
+    stackedLang?: string | null;
+    glyph?: string;
+    cursor?: number;
+    mark?: number | null;
+    interactive?: boolean;
+    readOnly?: boolean;
+    selected?: boolean;
+};
+export type ComposerFrameOpts = {
+    key: string;
+    width: number;
+    omitTop?: boolean;
+    joinTop?: boolean;
+    joinBottom?: boolean;
+    plainBottom?: boolean;
+};
+/**
+ * TEA leaf: model → `chrome_frame` (plus a T-joined command panel when open).
+ */
+export declare function ComposerFrame(model: ComposerFrameModel, opts: ComposerFrameOpts): LayoutNode;
+//# sourceMappingURL=composer-frame.d.ts.map