@chances-ai/ui-core 24.2.0 → 24.3.0

package/dist/editor/kill-ring.d.ts

@@ -0,0 +1,36 @@
+/**
+ * (7.4 / task 04) Emacs kill-ring. **Immutable** (every op returns a new
+ * `KillRing`) so the editor reducer (docs/7.4 §2.5) stays pure and testable.
+ *
+ * Ports pi's `KillRing` behaviour (`push({prepend,accumulate})` / `peek` /
+ * `rotate` / `length`); chances adds a **cap of 10** (claude-code — fixes pi's
+ * unbounded growth) + `snapshot()` for tests (docs/7.4 §2.4, R1-N2).
+ */
+export declare class KillRing {
+    /** CAP — most-recent at the end; older entries drop when exceeded. */
+    static readonly CAP = 10;
+    private readonly ring;
+    constructor(ring?: readonly string[]);
+    /**
+     * Add killed `text`.
+     * - `accumulate` (consecutive kills) merges into the most-recent entry rather
+     *   than adding one: `prepend` ⇒ `text + last` (backward kill), else
+     *   `last + text` (forward kill) — so a run of Ctrl-K reads back in order.
+     * - otherwise pushes a new entry, dropping the oldest past {@link CAP}.
+     *
+     * Empty `text` is a no-op (returns `this`).
+     */
+    push(text: string, opts: {
+        prepend: boolean;
+        accumulate?: boolean;
+    }): KillRing;
+    /** Most-recent entry (yank target), or undefined if empty. */
+    peek(): string | undefined;
+    /** Yank-pop: rotate the most-recent entry to the front so `peek()` returns the
+     *  next-older one. No-op when <2 entries. */
+    rotate(): KillRing;
+    get length(): number;
+    /** Current entries (oldest→newest) — tests only. */
+    snapshot(): readonly string[];
+}
+//# sourceMappingURL=kill-ring.d.ts.map

package/dist/editor/kill-ring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill-ring.d.ts","sourceRoot":"","sources":["../../src/editor/kill-ring.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,qBAAa,QAAQ;IACnB,sEAAsE;IACtE,MAAM,CAAC,QAAQ,CAAC,GAAG,MAAM;IAEzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAoB;gBAE7B,IAAI,GAAE,SAAS,MAAM,EAAO;IAIxC;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,QAAQ;IAY9E,8DAA8D;IAC9D,IAAI,IAAI,MAAM,GAAG,SAAS;IAI1B;iDAC6C;IAC7C,MAAM,IAAI,QAAQ;IAMlB,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,oDAAoD;IACpD,QAAQ,IAAI,SAAS,MAAM,EAAE;CAG9B"}

package/dist/editor/kill-ring.js

@@ -0,0 +1,58 @@
+/**
+ * (7.4 / task 04) Emacs kill-ring. **Immutable** (every op returns a new
+ * `KillRing`) so the editor reducer (docs/7.4 §2.5) stays pure and testable.
+ *
+ * Ports pi's `KillRing` behaviour (`push({prepend,accumulate})` / `peek` /
+ * `rotate` / `length`); chances adds a **cap of 10** (claude-code — fixes pi's
+ * unbounded growth) + `snapshot()` for tests (docs/7.4 §2.4, R1-N2).
+ */
+export class KillRing {
+    /** CAP — most-recent at the end; older entries drop when exceeded. */
+    static CAP = 10;
+    ring;
+    constructor(ring = []) {
+        this.ring = ring;
+    }
+    /**
+     * Add killed `text`.
+     * - `accumulate` (consecutive kills) merges into the most-recent entry rather
+     *   than adding one: `prepend` ⇒ `text + last` (backward kill), else
+     *   `last + text` (forward kill) — so a run of Ctrl-K reads back in order.
+     * - otherwise pushes a new entry, dropping the oldest past {@link CAP}.
+     *
+     * Empty `text` is a no-op (returns `this`).
+     */
+    push(text, opts) {
+        if (!text)
+            return this;
+        if (opts.accumulate && this.ring.length > 0) {
+            const last = this.ring[this.ring.length - 1];
+            const merged = opts.prepend ? text + last : last + text;
+            return new KillRing([...this.ring.slice(0, -1), merged]);
+        }
+        let next = [...this.ring, text];
+        if (next.length > KillRing.CAP)
+            next = next.slice(next.length - KillRing.CAP);
+        return new KillRing(next);
+    }
+    /** Most-recent entry (yank target), or undefined if empty. */
+    peek() {
+        return this.ring.length > 0 ? this.ring[this.ring.length - 1] : undefined;
+    }
+    /** Yank-pop: rotate the most-recent entry to the front so `peek()` returns the
+     *  next-older one. No-op when <2 entries. */
+    rotate() {
+        if (this.ring.length <= 1)
+            return this;
+        const last = this.ring[this.ring.length - 1];
+        return new KillRing([last, ...this.ring.slice(0, -1)]);
+    }
+    get length() {
+        return this.ring.length;
+    }
+    /** Current entries (oldest→newest) — tests only. */
+    snapshot() {
+        return this.ring;
+    }
+}
+//# sourceMappingURL=kill-ring.js.map

package/dist/editor/kill-ring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kill-ring.js","sourceRoot":"","sources":["../../src/editor/kill-ring.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,OAAO,QAAQ;IACnB,sEAAsE;IACtE,MAAM,CAAU,GAAG,GAAG,EAAE,CAAC;IAER,IAAI,CAAoB;IAEzC,YAAY,OAA0B,EAAE;QACtC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CAAC,IAAY,EAAE,IAAgD;QACjE,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC;QACvB,IAAI,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;YAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;YACxD,OAAO,IAAI,QAAQ,CAAC,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC;QAC3D,CAAC;QACD,IAAI,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,IAAI,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG;YAAE,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QAC9E,OAAO,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC5B,CAAC;IAED,8DAA8D;IAC9D,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5E,CAAC;IAED;iDAC6C;IAC7C,MAAM;QACJ,IAAI,IAAI,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;QAC9C,OAAO,IAAI,QAAQ,CAAC,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1B,CAAC;IAED,oDAAoD;IACpD,QAAQ;QACN,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC"}

package/dist/editor/layout.d.ts

@@ -0,0 +1,60 @@
+/**
+ * (7.4 / task 04) Pure visual-line layout for the multi-line editor: wrap to a
+ * width, locate the cursor's visual row/col, and compute vertical (↑/↓) moves
+ * with a sticky preferred column (docs/7.4 §2.6). Width is INJECTED as a
+ * `MeasureFn` — the TUI passes the native `measure` so layout and render share
+ * ONE measure (R1-M1, no drift); ui-core/tests use the default `graphemeWidth`.
+ */
+import type { TextBuffer } from "./buffer.js";
+import { type MeasureFn } from "./segments.js";
+export interface VisualRow {
+    /** Row text (no trailing `\n`). */
+    text: string;
+    /** UTF-16 offset of the row start in the buffer. */
+    start: number;
+    /** UTF-16 offset just past the row content. */
+    end: number;
+}
+export interface Layout {
+    rows: VisualRow[];
+    /** Visual row the cursor sits on. */
+    cursorRow: number;
+    /** Visual column (terminal cells) of the cursor within its row. */
+    cursorCol: number;
+}
+/** Wrap + locate the cursor. Greedy word-agnostic wrap by cluster width (a
+ *  cluster wider than `width` still occupies its own row). */
+export declare function layout(text: string, cursor: number, width: number, measure?: MeasureFn): Layout;
+export interface Viewport {
+    /** The visible slice of rows (≤ `maxRows`). */
+    rows: VisualRow[];
+    /** Cursor row index WITHIN `rows`. */
+    cursorRow: number;
+    /** Count of rows hidden above the window (0 = none; caller may show `↑N`). */
+    above: number;
+    /** Count of rows hidden below the window (0 = none; caller may show `↓N`). */
+    below: number;
+}
+/**
+ * (7.4 §G2 / claude-code viewport scroll) Window a wrapped draft to at most
+ * `maxRows` content rows centered on the cursor, so a long multi-line draft
+ * never pushes the transcript off-screen. Pure: the caller renders `rows` and,
+ * when `above`/`below` > 0, a clipped-line indicator. Returns all rows unchanged
+ * when the draft already fits.
+ */
+export declare function viewportRows(rows: VisualRow[], cursorRow: number, maxRows: number): Viewport;
+export interface VisualMove {
+    cursor: number;
+    /** Sticky column to remember for the NEXT vertical move (null = none). */
+    preferredCol: number | null;
+    /** False when already at the top/bottom row (caller may fall back to history). */
+    moved: boolean;
+}
+/**
+ * Move the cursor up (`dir=-1`) or down (`dir=+1`) by one visual row, honouring
+ * a sticky `preferredCol` (oh-my-pi): if the target row is shorter than the goal
+ * column the cursor lands at row end but the goal is remembered so a further move
+ * restores it. `moved=false` when there is no row in that direction.
+ */
+export declare function moveVisual(buf: TextBuffer, width: number, dir: -1 | 1, preferredCol: number | null, measure?: MeasureFn): VisualMove;
+//# sourceMappingURL=layout.d.ts.map

package/dist/editor/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../src/editor/layout.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAmC,KAAK,SAAS,EAAW,MAAM,eAAe,CAAC;AAEzF,MAAM,WAAW,SAAS;IACxB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAC;IACd,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,mEAAmE;IACnE,SAAS,EAAE,MAAM,CAAC;CACnB;AAgBD;8DAC8D;AAC9D,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,SAAyB,GAAG,MAAM,CAwC9G;AAED,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,KAAK,EAAE,MAAM,CAAC;CACf;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,QAAQ,CAS5F;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,0EAA0E;IAC1E,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,kFAAkF;IAClF,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CACxB,GAAG,EAAE,UAAU,EACf,KAAK,EAAE,MAAM,EACb,GAAG,EAAE,CAAC,CAAC,GAAG,CAAC,EACX,YAAY,EAAE,MAAM,GAAG,IAAI,EAC3B,OAAO,GAAE,SAAyB,GACjC,UAAU,CAqBZ"}

package/dist/editor/layout.js

@@ -0,0 +1,113 @@
+/**
+ * (7.4 / task 04) Pure visual-line layout for the multi-line editor: wrap to a
+ * width, locate the cursor's visual row/col, and compute vertical (↑/↓) moves
+ * with a sticky preferred column (docs/7.4 §2.6). Width is INJECTED as a
+ * `MeasureFn` — the TUI passes the native `measure` so layout and render share
+ * ONE measure (R1-M1, no drift); ui-core/tests use the default `graphemeWidth`.
+ */
+import { graphemeSegments, graphemeWidth, widthOf } from "./segments.js";
+/** Split `text` into logical lines (`\n`-delimited), returning offset ranges
+ *  (the `\n` itself excluded; a trailing `\n` yields a final empty range). */
+function logicalLines(text) {
+    const out = [];
+    let start = 0;
+    for (let i = 0; i <= text.length; i++) {
+        if (i === text.length || text[i] === "\n") {
+            out.push({ start, end: i });
+            start = i + 1;
+        }
+    }
+    return out;
+}
+/** Wrap + locate the cursor. Greedy word-agnostic wrap by cluster width (a
+ *  cluster wider than `width` still occupies its own row). */
+export function layout(text, cursor, width, measure = graphemeWidth) {
+    const w = Math.max(1, width);
+    const rows = [];
+    for (const ln of logicalLines(text)) {
+        const seg = text.slice(ln.start, ln.end);
+        if (seg === "") {
+            rows.push({ text: "", start: ln.start, end: ln.start });
+            continue;
+        }
+        let rowStart = ln.start;
+        let colW = 0;
+        for (const { segment, index } of graphemeSegments(seg)) {
+            const off = ln.start + index;
+            const cw = measure(segment);
+            if (colW + cw > w && off > rowStart) {
+                rows.push({ text: text.slice(rowStart, off), start: rowStart, end: off });
+                rowStart = off;
+                colW = 0;
+            }
+            colW += cw;
+        }
+        rows.push({ text: text.slice(rowStart, ln.end), start: rowStart, end: ln.end });
+    }
+    // Locate the cursor. At a soft-wrap boundary (cursor === row.end === next
+    // row.start, same logical line) defer to the next row's column 0.
+    let cursorRow = rows.length - 1;
+    let cursorCol = rows.length > 0 ? widthOf(rows[cursorRow].text, measure) : 0;
+    for (let r = 0; r < rows.length; r++) {
+        const row = rows[r];
+        if (cursor < row.start)
+            break;
+        if (cursor <= row.end) {
+            if (cursor === row.end && r + 1 < rows.length && rows[r + 1].start === cursor)
+                continue;
+            cursorRow = r;
+            cursorCol = widthOf(text.slice(row.start, cursor), measure);
+            break;
+        }
+    }
+    return { rows, cursorRow, cursorCol };
+}
+/**
+ * (7.4 §G2 / claude-code viewport scroll) Window a wrapped draft to at most
+ * `maxRows` content rows centered on the cursor, so a long multi-line draft
+ * never pushes the transcript off-screen. Pure: the caller renders `rows` and,
+ * when `above`/`below` > 0, a clipped-line indicator. Returns all rows unchanged
+ * when the draft already fits.
+ */
+export function viewportRows(rows, cursorRow, maxRows) {
+    const n = rows.length;
+    const max = Math.max(1, Math.floor(maxRows));
+    if (n <= max)
+        return { rows, cursorRow, above: 0, below: 0 };
+    let start = cursorRow - Math.floor(max / 2);
+    if (start < 0)
+        start = 0;
+    if (start + max > n)
+        start = n - max;
+    const end = start + max;
+    return { rows: rows.slice(start, end), cursorRow: cursorRow - start, above: start, below: n - end };
+}
+/**
+ * Move the cursor up (`dir=-1`) or down (`dir=+1`) by one visual row, honouring
+ * a sticky `preferredCol` (oh-my-pi): if the target row is shorter than the goal
+ * column the cursor lands at row end but the goal is remembered so a further move
+ * restores it. `moved=false` when there is no row in that direction.
+ */
+export function moveVisual(buf, width, dir, preferredCol, measure = graphemeWidth) {
+    const lay = layout(buf.text, buf.cursor, width, measure);
+    const targetRow = lay.cursorRow + dir;
+    if (targetRow < 0 || targetRow >= lay.rows.length) {
+        return { cursor: buf.cursor, preferredCol, moved: false };
+    }
+    const goalCol = preferredCol ?? lay.cursorCol;
+    const row = lay.rows[targetRow];
+    let off = row.start;
+    let col = 0;
+    for (const { segment, index } of graphemeSegments(row.text)) {
+        const cw = measure(segment);
+        if (col + cw > goalCol)
+            break;
+        col += cw;
+        off = row.start + index + segment.length;
+    }
+    const rowWidth = widthOf(row.text, measure);
+    // Keep the goal sticky while the target row can't reach it.
+    const nextPreferred = rowWidth < goalCol ? goalCol : null;
+    return { cursor: off, preferredCol: nextPreferred, moved: true };
+}
+//# sourceMappingURL=layout.js.map

package/dist/editor/layout.js.map

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

package/dist/editor/reducer.d.ts

@@ -0,0 +1,93 @@
+/**
+ * (7.4 / task 04) The PURE editor reducer (docs/7.4 §2.5): folds buffer +
+ * kill-ring + undo + last-action into `editorReducer(state, action) => state`,
+ * so "consecutive kills accumulate", "yank-pop only right after a yank", and
+ * "undo groups runs of typing" are all unit-testable as data. NO Ink/React/node.
+ *
+ * Vertical (↑/↓) visual moves are NOT here — they need an injected width/measure,
+ * so `EmacsEditor` computes them via `layout.moveVisual` and dispatches
+ * `setCursor` (keeps this reducer measure-free + pure). See docs/7.4 §2.8.
+ */
+import { type TextBuffer } from "./buffer.js";
+import { KillRing } from "./kill-ring.js";
+export interface Snapshot {
+    text: string;
+    cursor: number;
+}
+export type LastAction = "kill" | "yank" | "insert" | "edit" | "move" | "none";
+export interface EditorState {
+    buffer: TextBuffer;
+    killRing: KillRing;
+    lastAction: LastAction;
+    /** The region a yank inserted, so yank-pop can replace it. */
+    yankAnchor: {
+        start: number;
+        len: number;
+    } | null;
+    undo: {
+        stack: Snapshot[];
+        redo: Snapshot[];
+    };
+}
+export type EditorAction = {
+    t: "insert";
+    text: string;
+} | {
+    t: "newline";
+} | {
+    t: "backspace";
+} | {
+    t: "deleteForward";
+} | {
+    t: "moveLeft";
+} | {
+    t: "moveRight";
+} | {
+    t: "moveWordLeft";
+} | {
+    t: "moveWordRight";
+} | {
+    t: "moveLineStart";
+} | {
+    t: "moveLineEnd";
+} | {
+    t: "moveBufferStart";
+} | {
+    t: "moveBufferEnd";
+} | {
+    t: "setCursor";
+    cursor: number;
+} | {
+    t: "deleteWordBackward";
+} | {
+    t: "deleteWordForward";
+} | {
+    t: "killToLineEnd";
+} | {
+    t: "killToLineStart";
+} | {
+    t: "yank";
+} | {
+    t: "yankPop";
+} | {
+    t: "undo";
+} | {
+    t: "redo";
+} | {
+    t: "setText";
+    text: string;
+} | {
+    t: "clear";
+};
+export declare function initialEditorState(text?: string): EditorState;
+export declare function editorReducer(state: EditorState, action: EditorAction): EditorState;
+/** All `EditorAction["t"]` values — used to validate `Editor`-context keybindings
+ *  (docs/7.4 §4.3). Keymap-driven keys map to a subset; the rest are dispatched
+ *  by `EmacsEditor` directly. */
+export declare const EDITOR_ACTION_TYPES: ReadonlySet<EditorAction["t"]>;
+/** Editor actions a `keybindings.json` `Editor` binding may target (7.4 R2-M1):
+ *  EVERY entry is payload-free, so `EmacsEditor` can dispatch `{ t: action }`
+ *  safely. EXCLUDES `insert`/`setText`/`setCursor` (they need a payload — binding
+ *  one would dispatch `{t:"insert"}` with no text and crash on `toNFC(undefined)`). */
+export declare const BINDABLE_EDITOR_ACTIONS: ReadonlySet<EditorAction["t"]>;
+//# sourceMappingURL=reducer.d.ts.map

package/dist/editor/reducer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../../src/editor/reducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAmBL,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE1C,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAE/E,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,UAAU,CAAC;IACnB,QAAQ,EAAE,QAAQ,CAAC;IACnB,UAAU,EAAE,UAAU,CAAC;IACvB,8DAA8D;IAC9D,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,IAAI,EAAE;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,IAAI,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,CAAC,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,CAAC,EAAE,SAAS,CAAA;CAAE,GAChB;IAAE,CAAC,EAAE,WAAW,CAAA;CAAE,GAClB;IAAE,CAAC,EAAE,eAAe,CAAA;CAAE,GACtB;IAAE,CAAC,EAAE,UAAU,CAAA;CAAE,GACjB;IAAE,CAAC,EAAE,WAAW,CAAA;CAAE,GAClB;IAAE,CAAC,EAAE,cAAc,CAAA;CAAE,GACrB;IAAE,CAAC,EAAE,eAAe,CAAA;CAAE,GACtB;IAAE,CAAC,EAAE,eAAe,CAAA;CAAE,GACtB;IAAE,CAAC,EAAE,aAAa,CAAA;CAAE,GACpB;IAAE,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACxB;IAAE,CAAC,EAAE,eAAe,CAAA;CAAE,GACtB;IAAE,CAAC,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,CAAC,EAAE,oBAAoB,CAAA;CAAE,GAC3B;IAAE,CAAC,EAAE,mBAAmB,CAAA;CAAE,GAC1B;IAAE,CAAC,EAAE,eAAe,CAAA;CAAE,GACtB;IAAE,CAAC,EAAE,iBAAiB,CAAA;CAAE,GACxB;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACb;IAAE,CAAC,EAAE,SAAS,CAAA;CAAE,GAChB;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACb;IAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GACb;IAAE,CAAC,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAInB,wBAAgB,kBAAkB,CAAC,IAAI,SAAK,GAAG,WAAW,CAQzD;AAyCD,wBAAgB,aAAa,CAAC,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,GAAG,WAAW,CAuGnF;AAED;;iCAEiC;AACjC,eAAO,MAAM,mBAAmB,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAwB7D,CAAC;AAEH;;;uFAGuF;AACvF,eAAO,MAAM,uBAAuB,EAAE,WAAW,CAAC,YAAY,CAAC,GAAG,CAAC,CAElE,CAAC"}

package/dist/editor/reducer.js

@@ -0,0 +1,196 @@
+/**
+ * (7.4 / task 04) The PURE editor reducer (docs/7.4 §2.5): folds buffer +
+ * kill-ring + undo + last-action into `editorReducer(state, action) => state`,
+ * so "consecutive kills accumulate", "yank-pop only right after a yank", and
+ * "undo groups runs of typing" are all unit-testable as data. NO Ink/React/node.
+ *
+ * Vertical (↑/↓) visual moves are NOT here — they need an injected width/measure,
+ * so `EmacsEditor` computes them via `layout.moveVisual` and dispatches
+ * `setCursor` (keeps this reducer measure-free + pure). See docs/7.4 §2.8.
+ */
+import { backspace, deleteForward, deleteWordBackward, deleteWordForward, insert, killToLineEnd, killToLineStart, makeBuffer, moveBufferEnd, moveBufferStart, moveLeft, moveLineEnd, moveLineStart, moveRight, moveWordLeft, moveWordRight, setCursor, } from "./buffer.js";
+import { KillRing } from "./kill-ring.js";
+const MAX_UNDO = 200;
+export function initialEditorState(text = "") {
+    return {
+        buffer: makeBuffer(text),
+        killRing: new KillRing(),
+        lastAction: "none",
+        yankAnchor: null,
+        undo: { stack: [], redo: [] },
+    };
+}
+function snapshot(buf) {
+    return { text: buf.text, cursor: buf.cursor };
+}
+/** Push an undo entry, grouping a contiguous run of typing into one. `redo` is
+ *  cleared on any fresh edit. */
+function pushUndo(state, isInsert) {
+    const continuing = isInsert && state.lastAction === "insert";
+    if (continuing)
+        return { stack: state.undo.stack, redo: [] };
+    const stack = [...state.undo.stack, snapshot(state.buffer)];
+    if (stack.length > MAX_UNDO)
+        stack.splice(0, stack.length - MAX_UNDO);
+    return { stack, redo: [] };
+}
+/** Apply a kill result: buffer + accumulate-aware kill-ring + last-action=kill. */
+function applyKill(state, kr) {
+    // (7.4 R2-S3) An empty kill (e.g. Ctrl-K at end of buffer) removed nothing —
+    // don't pollute the kill-ring, undo stack, or the accumulate flag.
+    if (kr.killed === "")
+        return state;
+    const accumulate = state.lastAction === "kill";
+    return {
+        buffer: kr.buffer,
+        killRing: kr.killed ? state.killRing.push(kr.killed, { prepend: kr.dir === "backward", accumulate }) : state.killRing,
+        lastAction: "kill",
+        yankAnchor: null,
+        undo: pushUndo(state, false),
+    };
+}
+/** A non-kill edit: new buffer + undo + last-action. */
+function applyEdit(state, buffer, lastAction, isInsert = false) {
+    return { ...state, buffer, lastAction, yankAnchor: null, undo: pushUndo(state, isInsert) };
+}
+/** A pure cursor move: no undo, no kill-ring change; resets accumulation. */
+function applyMove(state, buffer) {
+    return { ...state, buffer, lastAction: "move", yankAnchor: null };
+}
+export function editorReducer(state, action) {
+    switch (action.t) {
+        case "insert":
+            return action.text === "" ? state : applyEdit(state, insert(state.buffer, action.text), "insert", true);
+        case "newline":
+            return applyEdit(state, insert(state.buffer, "\n"), "insert", true);
+        case "backspace":
+            return applyEdit(state, backspace(state.buffer), "edit");
+        case "deleteForward":
+            return applyEdit(state, deleteForward(state.buffer), "edit");
+        case "moveLeft":
+            return applyMove(state, moveLeft(state.buffer));
+        case "moveRight":
+            return applyMove(state, moveRight(state.buffer));
+        case "moveWordLeft":
+            return applyMove(state, moveWordLeft(state.buffer));
+        case "moveWordRight":
+            return applyMove(state, moveWordRight(state.buffer));
+        case "moveLineStart":
+            return applyMove(state, moveLineStart(state.buffer));
+        case "moveLineEnd":
+            return applyMove(state, moveLineEnd(state.buffer));
+        case "moveBufferStart":
+            return applyMove(state, moveBufferStart(state.buffer));
+        case "moveBufferEnd":
+            return applyMove(state, moveBufferEnd(state.buffer));
+        case "setCursor":
+            return applyMove(state, setCursor(state.buffer, action.cursor));
+        case "deleteWordBackward":
+            return applyKill(state, deleteWordBackward(state.buffer));
+        case "deleteWordForward":
+            return applyKill(state, deleteWordForward(state.buffer));
+        case "killToLineEnd":
+            return applyKill(state, killToLineEnd(state.buffer));
+        case "killToLineStart":
+            return applyKill(state, killToLineStart(state.buffer));
+        case "yank": {
+            const text = state.killRing.peek();
+            if (!text)
+                return { ...state, lastAction: "yank", yankAnchor: null };
+            return {
+                ...state,
+                buffer: insert(state.buffer, text),
+                lastAction: "yank",
+                yankAnchor: { start: state.buffer.cursor, len: text.length },
+                undo: pushUndo(state, false),
+            };
+        }
+        case "yankPop": {
+            if (state.lastAction !== "yank" || state.yankAnchor === null || state.killRing.length <= 1)
+                return state;
+            const ring = state.killRing.rotate();
+            const text = ring.peek() ?? "";
+            const { start, len } = state.yankAnchor;
+            const newText = state.buffer.text.slice(0, start) + text + state.buffer.text.slice(start + len);
+            return {
+                ...state,
+                buffer: { text: newText, cursor: start + text.length },
+                killRing: ring,
+                lastAction: "yank",
+                yankAnchor: { start, len: text.length },
+            };
+        }
+        case "undo": {
+            const prev = state.undo.stack[state.undo.stack.length - 1];
+            if (!prev)
+                return state;
+            return {
+                ...state,
+                buffer: makeBuffer(prev.text, prev.cursor),
+                lastAction: "none",
+                yankAnchor: null,
+                undo: { stack: state.undo.stack.slice(0, -1), redo: [...state.undo.redo, snapshot(state.buffer)] },
+            };
+        }
+        case "redo": {
+            const next = state.undo.redo[state.undo.redo.length - 1];
+            if (!next)
+                return state;
+            return {
+                ...state,
+                buffer: makeBuffer(next.text, next.cursor),
+                lastAction: "none",
+                yankAnchor: null,
+                undo: { stack: [...state.undo.stack, snapshot(state.buffer)], redo: state.undo.redo.slice(0, -1) },
+            };
+        }
+        case "setText":
+            return {
+                ...state,
+                buffer: makeBuffer(action.text),
+                lastAction: "none",
+                yankAnchor: null,
+                undo: { stack: [...state.undo.stack, snapshot(state.buffer)].slice(-MAX_UNDO), redo: [] },
+            };
+        case "clear":
+            return { ...state, buffer: makeBuffer(""), lastAction: "none", yankAnchor: null };
+        default:
+            // Defensive: an unknown action.t (e.g. a typo'd keybindings.json target
+            // cast through) is a no-op rather than collapsing state to undefined.
+            return state;
+    }
+}
+/** All `EditorAction["t"]` values — used to validate `Editor`-context keybindings
+ *  (docs/7.4 §4.3). Keymap-driven keys map to a subset; the rest are dispatched
+ *  by `EmacsEditor` directly. */
+export const EDITOR_ACTION_TYPES = new Set([
+    "insert",
+    "newline",
+    "backspace",
+    "deleteForward",
+    "moveLeft",
+    "moveRight",
+    "moveWordLeft",
+    "moveWordRight",
+    "moveLineStart",
+    "moveLineEnd",
+    "moveBufferStart",
+    "moveBufferEnd",
+    "setCursor",
+    "deleteWordBackward",
+    "deleteWordForward",
+    "killToLineEnd",
+    "killToLineStart",
+    "yank",
+    "yankPop",
+    "undo",
+    "redo",
+    "setText",
+    "clear",
+]);
+/** Editor actions a `keybindings.json` `Editor` binding may target (7.4 R2-M1):
+ *  EVERY entry is payload-free, so `EmacsEditor` can dispatch `{ t: action }`
+ *  safely. EXCLUDES `insert`/`setText`/`setCursor` (they need a payload — binding
+ *  one would dispatch `{t:"insert"}` with no text and crash on `toNFC(undefined)`). */
+export const BINDABLE_EDITOR_ACTIONS = new Set([...EDITOR_ACTION_TYPES].filter((a) => a !== "insert" && a !== "setText" && a !== "setCursor"));
+//# sourceMappingURL=reducer.js.map

package/dist/editor/reducer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reducer.js","sourceRoot":"","sources":["../../src/editor/reducer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,SAAS,EACT,aAAa,EACb,kBAAkB,EAClB,iBAAiB,EACjB,MAAM,EACN,aAAa,EACb,eAAe,EACf,UAAU,EACV,aAAa,EACb,eAAe,EACf,QAAQ,EACR,WAAW,EACX,aAAa,EACb,SAAS,EACT,YAAY,EACZ,aAAa,EACb,SAAS,GAGV,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AA2C1C,MAAM,QAAQ,GAAG,GAAG,CAAC;AAErB,MAAM,UAAU,kBAAkB,CAAC,IAAI,GAAG,EAAE;IAC1C,OAAO;QACL,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC;QACxB,QAAQ,EAAE,IAAI,QAAQ,EAAE;QACxB,UAAU,EAAE,MAAM;QAClB,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE;KAC9B,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,GAAe;IAC/B,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;iCACiC;AACjC,SAAS,QAAQ,CAAC,KAAkB,EAAE,QAAiB;IACrD,MAAM,UAAU,GAAG,QAAQ,IAAI,KAAK,CAAC,UAAU,KAAK,QAAQ,CAAC;IAC7D,IAAI,UAAU;QAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;IAC5D,IAAI,KAAK,CAAC,MAAM,GAAG,QAAQ;QAAE,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,CAAC;IACtE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC;AAC7B,CAAC;AAED,mFAAmF;AACnF,SAAS,SAAS,CAAC,KAAkB,EAAE,EAAc;IACnD,6EAA6E;IAC7E,mEAAmE;IACnE,IAAI,EAAE,CAAC,MAAM,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IACnC,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,KAAK,MAAM,CAAC;IAC/C,OAAO;QACL,MAAM,EAAE,EAAE,CAAC,MAAM;QACjB,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,EAAE,CAAC,GAAG,KAAK,UAAU,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ;QACrH,UAAU,EAAE,MAAM;QAClB,UAAU,EAAE,IAAI;QAChB,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;KAC7B,CAAC;AACJ,CAAC;AAED,wDAAwD;AACxD,SAAS,SAAS,CAAC,KAAkB,EAAE,MAAkB,EAAE,UAAsB,EAAE,QAAQ,GAAG,KAAK;IACjG,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;AAC7F,CAAC;AAED,6EAA6E;AAC7E,SAAS,SAAS,CAAC,KAAkB,EAAE,MAAkB;IACvD,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;AACpE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,KAAkB,EAAE,MAAoB;IACpE,QAAQ,MAAM,CAAC,CAAC,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC1G,KAAK,SAAS;YACZ,OAAO,SAAS,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,CAAC;QACtE,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3D,KAAK,eAAe;YAClB,OAAO,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;QAE/D,KAAK,UAAU;YACb,OAAO,SAAS,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACnD,KAAK,cAAc;YACjB,OAAO,SAAS,CAAC,KAAK,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACtD,KAAK,eAAe;YAClB,OAAO,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,KAAK,eAAe;YAClB,OAAO,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,KAAK,aAAa;YAChB,OAAO,SAAS,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACrD,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,KAAK,eAAe;YAClB,OAAO,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,KAAK,WAAW;YACd,OAAO,SAAS,CAAC,KAAK,EAAE,SAAS,CAAC,KAAK,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC;QAElE,KAAK,oBAAoB;YACvB,OAAO,SAAS,CAAC,KAAK,EAAE,kBAAkB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,KAAK,mBAAmB;YACtB,OAAO,SAAS,CAAC,KAAK,EAAE,iBAAiB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3D,KAAK,eAAe;YAClB,OAAO,SAAS,CAAC,KAAK,EAAE,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QACvD,KAAK,iBAAiB;YACpB,OAAO,SAAS,CAAC,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;QAEzD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;YACnC,IAAI,CAAC,IAAI;gBAAE,OAAO,EAAE,GAAG,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;YACrE,OAAO;gBACL,GAAG,KAAK;gBACR,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC;gBAClC,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE;gBAC5D,IAAI,EAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC;aAC7B,CAAC;QACJ,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,IAAI,KAAK,CAAC,UAAU,KAAK,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YACzG,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC;YACrC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;YAC/B,MAAM,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC;YACxC,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,GAAG,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;YAChG,OAAO;gBACL,GAAG,KAAK;gBACR,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,GAAG,IAAI,CAAC,MAAM,EAAE;gBACtD,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE;aACxC,CAAC;QACJ,CAAC;QAED,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YAC3D,IAAI,CAAC,IAAI;gBAAE,OAAO,KAAK,CAAC;YACxB,OAAO;gBACL,GAAG,KAAK;gBACR,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;gBAC1C,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE;aACnG,CAAC;QACJ,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACzD,IAAI,CAAC,IAAI;gBAAE,OAAO,KAAK,CAAC;YACxB,OAAO;gBACL,GAAG,KAAK;gBACR,MAAM,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC;gBAC1C,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;aACnG,CAAC;QACJ,CAAC;QAED,KAAK,SAAS;YACZ,OAAO;gBACL,GAAG,KAAK;gBACR,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC/B,UAAU,EAAE,MAAM;gBAClB,UAAU,EAAE,IAAI;gBAChB,IAAI,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE;aAC1F,CAAC;QACJ,KAAK,OAAO;YACV,OAAO,EAAE,GAAG,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;QACpF;YACE,wEAAwE;YACxE,sEAAsE;YACtE,OAAO,KAAK,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;iCAEiC;AACjC,MAAM,CAAC,MAAM,mBAAmB,GAAmC,IAAI,GAAG,CAAC;IACzE,QAAQ;IACR,SAAS;IACT,WAAW;IACX,eAAe;IACf,UAAU;IACV,WAAW;IACX,cAAc;IACd,eAAe;IACf,eAAe;IACf,aAAa;IACb,iBAAiB;IACjB,eAAe;IACf,WAAW;IACX,oBAAoB;IACpB,mBAAmB;IACnB,eAAe;IACf,iBAAiB;IACjB,MAAM;IACN,SAAS;IACT,MAAM;IACN,MAAM;IACN,SAAS;IACT,OAAO;CACR,CAAC,CAAC;AAEH;;;uFAGuF;AACvF,MAAM,CAAC,MAAM,uBAAuB,GAAmC,IAAI,GAAG,CAC5E,CAAC,GAAG,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,WAAW,CAAC,CAC/F,CAAC"}

package/dist/editor/segments.d.ts

@@ -0,0 +1,46 @@
+/**
+ * (7.4 / task 04) Grapheme + word segmentation for the editor core. PURE +
+ * browser-safe: built-in `Intl.Segmenter` (Node 16+/Bun/browsers) + `string-width`
+ * for cluster display width — no `node:*`, no Ink/React.
+ *
+ * Two concerns:
+ *  - **grapheme-cluster boundaries** — the cursor moves one *cluster* at a time,
+ *    so an emoji ZWJ family 👨‍👩‍👧‍👦 or a CJK char is one move unit, never split.
+ *  - **word-nav classification** (`getWordNavKind`, ported from oh-my-pi,
+ *    CJK-aware) for word-wise move/delete.
+ *
+ * Display WIDTH (the `MeasureFn` layout + render share, docs/7.4 §2.6 R1-M1)
+ * defaults here to a grapheme-cluster-aware width via `string-width`; the TUI
+ * injects the native `measure` instead so layout and render can never drift.
+ */
+/** NFC-normalize at the buffer boundary so combining-mark variants can't desync
+ *  the cursor (claude-code `MeasuredText` lesson). */
+export declare function toNFC(text: string): string;
+/** Iterate grapheme clusters of `text` as `{ segment, index }` (index = UTF-16
+ *  offset of the cluster start). Thin wrapper so the rest of the module — and
+ *  `layout.ts` — share one segmenter instance. */
+export declare function graphemeSegments(text: string): Intl.Segments;
+/** UTF-16 offsets of every grapheme-cluster start in `text`, plus `text.length`
+ *  as the final sentinel. `""` → `[0]`. */
+export declare function graphemeBoundaries(text: string): number[];
+/** The grapheme-cluster boundary strictly after `offset` (clamped to length). */
+export declare function nextGraphemeOffset(text: string, offset: number): number;
+/** The grapheme-cluster boundary strictly before `offset` (clamped to 0). */
+export declare function prevGraphemeOffset(text: string, offset: number): number;
+/** Terminal-cell width of ONE grapheme cluster — cluster-aware (docs/7.4 §2.6
+ *  R1-M1): emoji presentation / ZWJ / VS16 / skin-tone + CJK wide → 2,
+ *  combining / control → 0, else 1. Delegates to `string-width`, which already
+ *  handles East-Asian-Width + emoji. */
+export declare function graphemeWidth(cluster: string): number;
+/** Measures one grapheme cluster's terminal-cell width. The TUI injects the
+ *  native `measure`; ui-core + tests use {@link graphemeWidth}. */
+export type MeasureFn = (cluster: string) => number;
+/** Sum of cluster widths across `text` under `measure`. */
+export declare function widthOf(text: string, measure?: MeasureFn): number;
+export type WordNavKind = "whitespace" | "delimiter" | "cjk" | "word" | "other";
+/** Classify a grapheme for word navigation. Order: whitespace → cjk → word →
+ *  delimiter → other (cjk/word before delimiter because of `\p{L}` / `_`). */
+export declare function getWordNavKind(grapheme: string): WordNavKind;
+/** Whether `grapheme` is a word-internal joiner (kept inside a word run). */
+export declare function isWordJoiner(grapheme: string): boolean;
+//# sourceMappingURL=segments.d.ts.map

package/dist/editor/segments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"segments.d.ts","sourceRoot":"","sources":["../../src/editor/segments.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH;sDACsD;AACtD,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE1C;AAID;;kDAEkD;AAClD,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC,QAAQ,CAE5D;AAED;2CAC2C;AAC3C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAKzD;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAGvE;AAED,6EAA6E;AAC7E,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAOvE;AAED;;;wCAGwC;AACxC,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAGrD;AAED;mEACmE;AACnE,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;AAEpD,2DAA2D;AAC3D,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,SAAyB,GAAG,MAAM,CAIhF;AAID,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,WAAW,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAiBhF;8EAC8E;AAC9E,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,CAQ5D;AAED,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEtD"}