@ai-composer/dom 0.0.0-stage → 0.1.0

package/dist/popup.js

@@ -0,0 +1,121 @@
+/**
+ * Caret-anchored popup positioning. The suggestion menu opens where the
+ * trigger key (@, /, …) was hit — not just above the box — and reflows:
+ *
+ *   - horizontal: popup's left edge follows the caret, clamped into the
+ *     viewport so it never opens out of the window
+ *   - vertical: prefers `placement` (Copilot-style: above), flips to the
+ *     other side when the viewport lacks room, caps its max-height to the
+ *     available space and scrolls inside
+ *   - repositions on window resize and on any scroll (capture) while open
+ *
+ * The popup must live inside a positioned ancestor (`.aic-input-wrap`) —
+ * coordinates are computed relative to that offset parent each update.
+ */
+const GAP = 6;
+const EDGE = 8;
+/** Measure the caret inside a contenteditable host (viewport coordinates). */
+export function measureCaret(host) {
+    const doc = host.ownerDocument;
+    const win = doc.defaultView;
+    if (!win)
+        return null;
+    const selection = win.getSelection();
+    if (selection && selection.rangeCount > 0 && host.contains(selection.focusNode)) {
+        const range = selection.getRangeAt(0).cloneRange();
+        const rects = range.getClientRects();
+        if (rects.length > 0) {
+            const rect = rects[0];
+            return { x: rect.left, top: rect.top, bottom: rect.bottom };
+        }
+        // Collapsed caret at an element boundary reports no rects — probe with a
+        // zero-width marker and remove it synchronously (no input event fires,
+        // so the editor's view pipeline is never involved).
+        const marker = doc.createElement('span');
+        marker.textContent = '​';
+        try {
+            range.insertNode(marker);
+            const rect = marker.getBoundingClientRect();
+            if (rect.width === 0 && rect.height === 0)
+                return null;
+            return { x: rect.left, top: rect.top, bottom: rect.bottom };
+        }
+        catch {
+            return null;
+        }
+        finally {
+            marker.remove();
+        }
+    }
+    return null;
+}
+/** Fallback: the first text line's start (empty host, no selection). */
+function firstLine(host) {
+    const rect = host.getBoundingClientRect();
+    const style = host.ownerDocument.defaultView?.getComputedStyle(host);
+    const padLeft = Number.parseFloat(style?.paddingLeft ?? '0') || 0;
+    const padTop = Number.parseFloat(style?.paddingTop ?? '0') || 0;
+    return { x: rect.left + padLeft, top: rect.top + padTop, bottom: rect.top + padTop + 22 };
+}
+export function attachCaretAnchoredPopup(popup, host, options = {}) {
+    const win = host.ownerDocument.defaultView ?? window;
+    const prefer = options.placement ?? 'above';
+    const scrollOptions = {
+        capture: true,
+        passive: true,
+    };
+    const update = () => {
+        if (popup.hidden)
+            return;
+        const viewportWidth = win.innerWidth;
+        const viewportHeight = win.innerHeight;
+        const width = Math.max(180, Math.min(360, viewportWidth - EDGE * 2));
+        popup.style.position = 'absolute';
+        popup.style.width = `${Math.round(width)}px`;
+        popup.style.margin = '0';
+        popup.style.zIndex = 'var(--aic-z-suggestions)';
+        // Measure the anchor AFTER taking the popup out of flow — otherwise the
+        // wrap's rect still includes the freshly-opened list and the popup
+        // detaches by exactly its own height.
+        const wrap = popup.parentElement ?? host;
+        const wrapRect = wrap.getBoundingClientRect();
+        const point = measureCaret(host) ?? firstLine(host);
+        // Horizontal — under the caret, clamped so the popup stays on screen.
+        const desiredLeft = point.x - wrapRect.left - 4;
+        const absoluteLeft = Math.min(Math.max(wrapRect.left + desiredLeft, EDGE), viewportWidth - width - EDGE);
+        popup.style.left = `${Math.round(absoluteLeft - wrapRect.left)}px`;
+        popup.style.right = 'auto';
+        // Vertical — preferred side first, flip when the viewport lacks room.
+        popup.style.maxHeight = '';
+        const needed = Math.min(popup.offsetHeight || 200, 260);
+        const spaceAbove = point.top - EDGE;
+        const spaceBelow = viewportHeight - point.bottom - EDGE;
+        let side = prefer;
+        const wanted = Math.min(needed, 140);
+        if (side === 'above' && spaceAbove < wanted && spaceBelow > spaceAbove)
+            side = 'below';
+        else if (side === 'below' && spaceBelow < wanted && spaceAbove > spaceBelow)
+            side = 'above';
+        const available = Math.max(96, Math.min(260, (side === 'above' ? spaceAbove : spaceBelow) - GAP));
+        popup.style.maxHeight = `${Math.round(available)}px`;
+        if (side === 'above') {
+            popup.style.bottom = `${Math.round(wrapRect.bottom - point.top + GAP)}px`;
+            popup.style.top = 'auto';
+        }
+        else {
+            popup.style.top = `${Math.round(point.bottom - wrapRect.top + GAP)}px`;
+            popup.style.bottom = 'auto';
+        }
+    };
+    const onReflow = () => update();
+    win.addEventListener('resize', onReflow);
+    win.addEventListener('scroll', onReflow, scrollOptions);
+    return {
+        update,
+        destroy() {
+            win.removeEventListener('resize', onReflow);
+            win.removeEventListener('scroll', onReflow, scrollOptions);
+        },
+    };
+}
+//# sourceMappingURL=popup.js.map

package/dist/popup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup.js","sourceRoot":"","sources":["../src/popup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAqBH,MAAM,GAAG,GAAG,CAAC,CAAC;AACd,MAAM,IAAI,GAAG,CAAC,CAAC;AAEf,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,IAAiB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;IAC/B,MAAM,GAAG,GAAG,GAAG,CAAC,WAAW,CAAC;IAC5B,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,EAAE,CAAC;IACrC,IAAI,SAAS,IAAI,SAAS,CAAC,UAAU,GAAG,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,SAAS,CAAC,EAAE,CAAC;QAChF,MAAM,KAAK,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,KAAK,CAAC,cAAc,EAAE,CAAC;QACrC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;YACtB,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,CAAC;QACD,yEAAyE;QACzE,uEAAuE;QACvE,oDAAoD;QACpD,MAAM,MAAM,GAAG,GAAG,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;QACzC,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC;QACzB,IAAI,CAAC;YACH,KAAK,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YACzB,MAAM,IAAI,GAAG,MAAM,CAAC,qBAAqB,EAAE,CAAC;YAC5C,IAAI,IAAI,CAAC,KAAK,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvD,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9D,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC;IACH,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,wEAAwE;AACxE,SAAS,SAAS,CAAC,IAAiB;IAClC,MAAM,IAAI,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,WAAW,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAClE,MAAM,MAAM,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,UAAU,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,EAAE,CAAC,EAAE,IAAI,CAAC,IAAI,GAAG,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,GAAG,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,GAAG,GAAG,MAAM,GAAG,EAAE,EAAE,CAAC;AAC5F,CAAC;AAED,MAAM,UAAU,wBAAwB,CACtC,KAAkB,EAClB,IAAiB,EACjB,UAA8B,EAAE;IAEhC,MAAM,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,IAAI,MAAM,CAAC;IACrD,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;IAC5C,MAAM,aAAa,GAAmD;QACpE,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,IAAI;KACd,CAAC;IAEF,MAAM,MAAM,GAAG,GAAS,EAAE;QACxB,IAAI,KAAK,CAAC,MAAM;YAAE,OAAO;QACzB,MAAM,aAAa,GAAG,GAAG,CAAC,UAAU,CAAC;QACrC,MAAM,cAAc,GAAG,GAAG,CAAC,WAAW,CAAC;QAEvC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,aAAa,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,KAAK,CAAC,QAAQ,GAAG,UAAU,CAAC;QAClC,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC;QAC7C,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,CAAC;QACzB,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,0BAA0B,CAAC;QAEhD,wEAAwE;QACxE,mEAAmE;QACnE,sCAAsC;QACtC,MAAM,IAAI,GAAG,KAAK,CAAC,aAAa,IAAI,IAAI,CAAC;QACzC,MAAM,QAAQ,GAAG,IAAI,CAAC,qBAAqB,EAAE,CAAC;QAC9C,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,IAAI,CAAC,CAAC;QAEpD,sEAAsE;QACtE,MAAM,WAAW,GAAG,KAAK,CAAC,CAAC,GAAG,QAAQ,CAAC,IAAI,GAAG,CAAC,CAAC;QAChD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,GAAG,WAAW,EAAE,IAAI,CAAC,EAC3C,aAAa,GAAG,KAAK,GAAG,IAAI,CAC7B,CAAC;QACF,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QACnE,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,MAAM,CAAC;QAE3B,sEAAsE;QACtE,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,EAAE,CAAC;QAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;QACxD,MAAM,UAAU,GAAG,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC;QACpC,MAAM,UAAU,GAAG,cAAc,GAAG,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC;QACxD,IAAI,IAAI,GAAG,MAAM,CAAC;QAClB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACrC,IAAI,IAAI,KAAK,OAAO,IAAI,UAAU,GAAG,MAAM,IAAI,UAAU,GAAG,UAAU;YAAE,IAAI,GAAG,OAAO,CAAC;aAClF,IAAI,IAAI,KAAK,OAAO,IAAI,UAAU,GAAG,MAAM,IAAI,UAAU,GAAG,UAAU;YAAE,IAAI,GAAG,OAAO,CAAC;QAE5F,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CACxB,EAAE,EACF,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,GAAG,CAAC,CAClE,CAAC;QACF,KAAK,CAAC,KAAK,CAAC,SAAS,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC;QACrD,IAAI,IAAI,KAAK,OAAO,EAAE,CAAC;YACrB,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,KAAK,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC;YAC1E,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,MAAM,CAAC;QAC3B,CAAC;aAAM,CAAC;YACN,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,GAAG,GAAG,CAAC,IAAI,CAAC;YACvE,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,GAAS,EAAE,CAAC,MAAM,EAAE,CAAC;IACtC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IACzC,GAAG,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAExD,OAAO;QACL,MAAM;QACN,OAAO;YACL,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YAC5C,GAAG,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;QAC7D,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/render.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Model → DOM rendering. The DOM is a projection of the authoritative
+ * document (ADR-0001). Atomic nodes render as non-editable chips carrying
+ * data-aic-* attributes so parse.ts can round-trip them safely.
+ */
+import type { AIComposerDocument, AIComposerNode } from '@ai-composer/core';
+import type { NodeRegistry } from '@ai-composer/core';
+/** Render one atomic node as a non-editable chip element. */
+export declare function renderChip(node: AIComposerNode, registry: NodeRegistry): HTMLElement;
+/** Render a text run; newlines become <br> so the editable area shows line breaks. */
+export declare function renderTextRun(text: string): Node;
+/**
+ * Render the document into `host`, replacing previous content.
+ * The placeholder <br> keeps the host clickable when empty.
+ */
+export declare function renderDocument(host: HTMLElement, document_: AIComposerDocument, registry: NodeRegistry): void;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render.d.ts","sourceRoot":"","sources":["../src/render.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAOtD,6DAA6D;AAC7D,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,YAAY,GAAG,WAAW,CAsCpF;AAUD,sFAAsF;AACtF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAShD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,EAAE,QAAQ,EAAE,YAAY,GAAG,IAAI,CAQ7G"}

package/dist/render.js

@@ -0,0 +1,84 @@
+/**
+ * Model → DOM rendering. The DOM is a projection of the authoritative
+ * document (ADR-0001). Atomic nodes render as non-editable chips carrying
+ * data-aic-* attributes so parse.ts can round-trip them safely.
+ */
+function displayOf(node, registry) {
+    const definition = registry.get(node.type);
+    return definition?.toDisplay?.(node) ?? '';
+}
+/** Render one atomic node as a non-editable chip element. */
+export function renderChip(node, registry) {
+    const chip = document.createElement('span');
+    chip.setAttribute('contenteditable', 'false');
+    chip.className = 'aic-chip';
+    chip.setAttribute('data-aic-key', node.key);
+    chip.setAttribute('data-aic-node', node.type);
+    chip.hidden = node.type === 'attachment';
+    chip.setAttribute('aria-label', displayOf(node, registry));
+    switch (node.type) {
+        case 'mention':
+            chip.setAttribute('data-aic-id', node.id);
+            chip.setAttribute('data-aic-label', node.label);
+            break;
+        case 'command':
+            chip.setAttribute('data-aic-id', node.id);
+            chip.setAttribute('data-aic-label', node.label);
+            break;
+        case 'variable':
+            chip.setAttribute('data-aic-name', node.name);
+            break;
+        case 'attachment':
+            chip.setAttribute('data-aic-id', node.id);
+            chip.setAttribute('data-aic-name', node.name);
+            chip.setAttribute('data-aic-mime', node.mimeType);
+            if (node.size !== undefined)
+                chip.setAttribute('data-aic-size', String(node.size));
+            break;
+        case 'custom':
+            chip.setAttribute('data-aic-plugin', node.plugin);
+            chip.setAttribute('data-aic-type', node.nodeType);
+            chip.setAttribute('data-aic-data', safeJson(node.data));
+            break;
+        default:
+            break;
+    }
+    chip.textContent = displayOf(node, registry);
+    return chip;
+}
+function safeJson(value) {
+    try {
+        return JSON.stringify(value ?? null);
+    }
+    catch {
+        return 'null';
+    }
+}
+/** Render a text run; newlines become <br> so the editable area shows line breaks. */
+export function renderTextRun(text) {
+    if (!text.includes('\n'))
+        return document.createTextNode(text);
+    const fragment = document.createDocumentFragment();
+    const parts = text.split('\n');
+    parts.forEach((part, index) => {
+        if (part)
+            fragment.appendChild(document.createTextNode(part));
+        if (index < parts.length - 1)
+            fragment.appendChild(document.createElement('br'));
+    });
+    return fragment;
+}
+/**
+ * Render the document into `host`, replacing previous content.
+ * The placeholder <br> keeps the host clickable when empty.
+ */
+export function renderDocument(host, document_, registry) {
+    host.textContent = '';
+    for (const node of document_.nodes) {
+        host.appendChild(node.type === 'text' ? renderTextRun(node.text) : renderChip(node, registry));
+    }
+    if (document_.nodes.length === 0) {
+        host.appendChild(document.createElement('br'));
+    }
+}
+//# sourceMappingURL=render.js.map

package/dist/render.js.map

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

package/dist/selection.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DOM selection ↔ model selection mapping. All coordinates are computed as
+ * document-wide offsets over the same segment order the renderer produces:
+ * text characters, `<br>` = 1, chip = 1.
+ */
+import { type AIComposerDocument, type SelectionState } from '@ai-composer/core';
+/** Read the DOM selection inside `host` as a model selection. */
+export declare function domSelectionToModel(host: HTMLElement, document_: AIComposerDocument): SelectionState | null;
+/** Apply a model selection to the DOM (caret restore after renders). */
+export declare function applyModelSelection(host: HTMLElement, document_: AIComposerDocument, selection: SelectionState): void;
+/** Caret to the end of the host content. */
+export declare function caretToEnd(host: HTMLElement, document_: AIComposerDocument): SelectionState;
+//# sourceMappingURL=selection.d.ts.map

package/dist/selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selection.d.ts","sourceRoot":"","sources":["../src/selection.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAKL,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACpB,MAAM,mBAAmB,CAAC;AAwE3B,iEAAiE;AACjE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,kBAAkB,GAC5B,cAAc,GAAG,IAAI,CAiBvB;AAED,wEAAwE;AACxE,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,EACjB,SAAS,EAAE,kBAAkB,EAC7B,SAAS,EAAE,cAAc,GACxB,IAAI,CAkBN;AAED,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,EAAE,kBAAkB,GAAG,cAAc,CAM3F"}

package/dist/selection.js

@@ -0,0 +1,110 @@
+/**
+ * DOM selection ↔ model selection mapping. All coordinates are computed as
+ * document-wide offsets over the same segment order the renderer produces:
+ * text characters, `<br>` = 1, chip = 1.
+ */
+import { clampSelection, createSelection, fromGlobalOffset, globalRange, } from '@ai-composer/core';
+function isChip(node) {
+    return node instanceof HTMLElement && node.hasAttribute('data-aic-node');
+}
+/** Global offset of a DOM point inside the host, or null when outside. */
+function globalOffsetOfPoint(host, target, targetOffset) {
+    let offset = 0;
+    let found = false;
+    const visit = (current) => {
+        if (found)
+            return true;
+        if (current === target) {
+            offset += targetOffset;
+            found = true;
+            return true;
+        }
+        if (current.nodeType === Node.TEXT_NODE) {
+            offset += current.textContent?.length ?? 0;
+            return false;
+        }
+        if (current.nodeName === 'BR' || isChip(current)) {
+            offset += 1;
+            return false;
+        }
+        for (const child of Array.from(current.childNodes)) {
+            if (visit(child))
+                return true;
+        }
+        return false;
+    };
+    visit(host);
+    return found ? offset : null;
+}
+/** DOM point at a global offset, or the host end as fallback. */
+function domPointAtGlobal(host, globalOffset) {
+    let remaining = globalOffset;
+    const pointBefore = (node) => ({ node: node.parentNode ?? host, offset: indexOfChild(node) });
+    const indexOfChild = (node) => node.parentNode ? Array.prototype.indexOf.call(node.parentNode.childNodes, node) : 0;
+    const visit = (parent) => {
+        for (const child of Array.from(parent.childNodes)) {
+            if (child.nodeType === Node.TEXT_NODE) {
+                const length = child.textContent?.length ?? 0;
+                if (remaining <= length)
+                    return { node: child, offset: remaining };
+                remaining -= length;
+                continue;
+            }
+            if (child.nodeName === 'BR' || isChip(child)) {
+                if (remaining <= 0)
+                    return pointBefore(child);
+                remaining -= 1;
+                if (remaining <= 0)
+                    return { node: child.parentNode ?? host, offset: indexOfChild(child) + 1 };
+                continue;
+            }
+            const nested = visit(child);
+            if (nested)
+                return nested;
+        }
+        return null;
+    };
+    return visit(host) ?? { node: host, offset: host.childNodes.length };
+}
+/** Read the DOM selection inside `host` as a model selection. */
+export function domSelectionToModel(host, document_) {
+    const selection = host.ownerDocument.getSelection();
+    if (!selection || selection.rangeCount === 0)
+        return null;
+    const anchorNode = selection.anchorNode;
+    const focusNode = selection.focusNode;
+    if (!anchorNode || !focusNode || !host.contains(anchorNode) || !host.contains(focusNode)) {
+        return null;
+    }
+    const anchorOffset = globalOffsetOfPoint(host, anchorNode, selection.anchorOffset);
+    const focusOffset = globalOffsetOfPoint(host, focusNode, selection.focusOffset);
+    if (anchorOffset === null || focusOffset === null)
+        return null;
+    return clampSelection(document_, createSelection(fromGlobalOffset(document_, anchorOffset), fromGlobalOffset(document_, focusOffset)));
+}
+/** Apply a model selection to the DOM (caret restore after renders). */
+export function applyModelSelection(host, document_, selection) {
+    const ownerDocument = host.ownerDocument;
+    const domSelection = ownerDocument.getSelection();
+    if (!domSelection)
+        return;
+    const { start, end } = globalRange(document_, selection);
+    const startPoint = domPointAtGlobal(host, start);
+    const endPoint = start === end ? startPoint : domPointAtGlobal(host, end);
+    try {
+        const range = ownerDocument.createRange();
+        range.setStart(startPoint.node, startPoint.offset);
+        range.setEnd(endPoint.node, endPoint.offset);
+        domSelection.removeAllRanges();
+        domSelection.addRange(range);
+    }
+    catch {
+        // Browsers can reject boundary points mid-render; the next render retries.
+    }
+}
+/** Caret to the end of the host content. */
+export function caretToEnd(host, document_) {
+    const length = document_.nodes.reduce((sum, node) => sum + (node.type === 'text' ? node.text.length : 1), 0);
+    return createSelection(fromGlobalOffset(document_, length));
+}
+//# sourceMappingURL=selection.js.map

package/dist/selection.js.map

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

package/dist/suggestions.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Suggestion menu — a true popup (ADR-0001 style projection): it opens at the
+ * caret where the trigger key was hit, never reserving DOM space, and flips /
+ * clamps itself to the viewport (see ./popup). Keyboard navigation lives in
+ * the editable surface; this module renders and handles clicks.
+ */
+import type { AIComposer, SuggestionItem } from '@ai-composer/core';
+export interface SuggestionListOptions {
+    /** Custom item renderer; default is a simple label/description row. */
+    renderItem?: (item: SuggestionItem, active: boolean) => HTMLElement;
+    /** The editable host to wire aria-controls / aria-activedescendant onto. */
+    inputHost?: HTMLElement;
+    /** Preferred popup placement relative to the caret; flips to fit the viewport. */
+    placement?: 'above' | 'below';
+    /** Decorative keyboard-hints footer (default true). */
+    showKbdHints?: boolean;
+}
+export interface SuggestionList {
+    readonly element: HTMLElement;
+    destroy(): void;
+}
+export declare function createSuggestionList(editor: AIComposer, element?: HTMLElement, options?: SuggestionListOptions): SuggestionList;
+//# sourceMappingURL=suggestions.d.ts.map

package/dist/suggestions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestions.d.ts","sourceRoot":"","sources":["../src/suggestions.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAe,MAAM,mBAAmB,CAAC;AAGjF,MAAM,WAAW,qBAAqB;IACpC,uEAAuE;IACvE,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,KAAK,WAAW,CAAC;IACpE,4EAA4E;IAC5E,SAAS,CAAC,EAAE,WAAW,CAAC;IACxB,kFAAkF;IAClF,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;IAC9B,uDAAuD;IACvD,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,OAAO,IAAI,IAAI,CAAC;CACjB;AAwBD,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,WAAW,EACrB,OAAO,GAAE,qBAA0B,GAClC,cAAc,CA6FhB"}

package/dist/suggestions.js

@@ -0,0 +1,113 @@
+/**
+ * Suggestion menu — a true popup (ADR-0001 style projection): it opens at the
+ * caret where the trigger key was hit, never reserving DOM space, and flips /
+ * clamps itself to the viewport (see ./popup). Keyboard navigation lives in
+ * the editable surface; this module renders and handles clicks.
+ */
+import { attachCaretAnchoredPopup } from './popup';
+let listCounter = 0;
+/** Decorative footer: ↑↓ navigate · ↵ select · esc close (aria-hidden). */
+function kbdHintsFooter() {
+    const li = document.createElement('li');
+    li.className = 'aic-suggestion-footer';
+    li.setAttribute('role', 'presentation');
+    li.setAttribute('aria-hidden', 'true');
+    const hints = [
+        ['↑↓', 'navigate'],
+        ['↵', 'select'],
+        ['esc', 'close'],
+    ];
+    hints.forEach(([key, action], index) => {
+        const kbd = document.createElement('kbd');
+        kbd.textContent = key;
+        li.append(kbd, document.createTextNode(action));
+        if (index < hints.length - 1)
+            li.append(document.createElement('span'));
+    });
+    return li;
+}
+export function createSuggestionList(editor, element, options = {}) {
+    const list = element ?? document.createElement('ul');
+    if (!list.id)
+        list.id = `aic-suggestions-${(listCounter += 1)}`;
+    list.className = 'aic-suggestions';
+    list.setAttribute('role', 'listbox');
+    list.setAttribute('aria-hidden', 'true');
+    list.hidden = true;
+    let anchor = null;
+    const defaultItem = (item, active) => {
+        const li = document.createElement('li');
+        li.className = 'aic-suggestion' + (active ? ' aic-active' : '');
+        li.setAttribute('role', 'option');
+        if (item.description) {
+            const label = document.createElement('span');
+            label.className = 'aic-suggestion-label';
+            label.textContent = item.label;
+            const description = document.createElement('span');
+            description.className = 'aic-suggestion-description';
+            description.textContent = item.description;
+            li.append(label, description);
+        }
+        else {
+            li.textContent = item.label;
+        }
+        return li;
+    };
+    const renderItem = options.renderItem ?? defaultItem;
+    const sync = (state) => {
+        const open = state.activeTrigger !== null && state.suggestions.length > 0;
+        list.hidden = !open;
+        list.setAttribute('aria-hidden', String(!open));
+        const input = options.inputHost;
+        if (input) {
+            input.setAttribute('aria-controls', list.id);
+            input.setAttribute('aria-expanded', String(open));
+            if (open && state.activeSuggestionIndex >= 0) {
+                input.setAttribute('aria-activedescendant', `${list.id}-option-${state.activeSuggestionIndex}`);
+            }
+            else {
+                input.removeAttribute('aria-activedescendant');
+            }
+        }
+        list.textContent = '';
+        if (!open)
+            return;
+        if (input && !anchor) {
+            // Anchors to the caret inside the input host; the popup itself must be
+            // attached to a positioned ancestor (`.aic-input-wrap`) — by the time it
+            // opens it has been appended there.
+            anchor = attachCaretAnchoredPopup(list, input, { placement: options.placement });
+        }
+        state.suggestions.forEach((item, index) => {
+            const active = index === state.activeSuggestionIndex;
+            const li = renderItem(item, active);
+            li.id = `${list.id}-option-${index}`;
+            li.setAttribute('role', 'option');
+            li.setAttribute('aria-selected', String(active));
+            li.addEventListener('mousedown', (event) => event.preventDefault()); // keep caret in place
+            li.addEventListener('click', () => {
+                void editor.acceptSuggestion(item);
+            });
+            list.appendChild(li);
+        });
+        if (options.showKbdHints !== false) {
+            list.appendChild(kbdHintsFooter());
+        }
+        // Position after items exist so the measured height is real.
+        anchor?.update();
+    };
+    const unsubscribe = editor.subscribe(sync);
+    const offDestroy = editor.on('destroy', () => destroy());
+    function destroy() {
+        unsubscribe();
+        offDestroy();
+        anchor?.destroy();
+        anchor = null;
+        list.textContent = '';
+        list.hidden = true;
+        list.remove();
+    }
+    sync(editor.getState());
+    return { element: list, destroy };
+}
+//# sourceMappingURL=suggestions.js.map

package/dist/suggestions.js.map

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

package/dist/surface.d.ts

@@ -0,0 +1,40 @@
+/**
+ * The editable surface: binds a contentEditable host to an editor using the
+ * model-first pipeline:
+ *
+ *   user input → parse DOM → editor.applyViewUpdate() (model is authoritative)
+ *   model change → render → restore caret from model selection
+ *
+ * All programmatic APIs (setValue/insertNode/undo…) write the model; the
+ * surface re-projects it. See ADR-0001.
+ */
+import { type AIComposer, type SubmitKey } from '@ai-composer/core';
+export interface EditableSurfaceOptions {
+    /** Multiline hint for a11y and Enter handling (chat/expanded modes). */
+    multiline?: boolean;
+    /** Override the editor config's submit key behavior. */
+    submitKey?: SubmitKey;
+    /** Explicit id (used for aria-controls wiring). */
+    id?: string;
+    /** Additional class names for the host. */
+    className?: string;
+    /** Accessible label; defaults to the placeholder. */
+    ariaLabel?: string;
+}
+export interface EditableSurface {
+    readonly host: HTMLElement;
+    /** Manually re-render from the model (used by undo/redo view hook). */
+    render(): void;
+    focus(options?: {
+        at?: 'start' | 'end';
+    }): void;
+    blur(): void;
+    /** Multiline hint (a11y + newline handling) — updated on mode switches. */
+    setMultiline(multiline: boolean): void;
+    /** Submit-key override (mode presets) — cleared with `undefined`. */
+    setSubmitKey(key: SubmitKey | undefined): void;
+    destroy(): void;
+}
+export declare const EDITABLE_SURFACE_CLASS = "aic-input";
+export declare function createEditableSurface(editor: AIComposer, host: HTMLElement, options?: EditableSurfaceOptions): EditableSurface;
+//# sourceMappingURL=surface.d.ts.map

package/dist/surface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"surface.d.ts","sourceRoot":"","sources":["../src/surface.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EASL,KAAK,UAAU,EAEf,KAAK,SAAS,EAEf,MAAM,mBAAmB,CAAC;AAK3B,MAAM,WAAW,sBAAsB;IACrC,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,wDAAwD;IACxD,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,mDAAmD;IACnD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,uEAAuE;IACvE,MAAM,IAAI,IAAI,CAAC;IACf,KAAK,CAAC,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,OAAO,GAAG,KAAK,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,IAAI,IAAI,IAAI,CAAC;IACb,2EAA2E;IAC3E,YAAY,CAAC,SAAS,EAAE,OAAO,GAAG,IAAI,CAAC;IACvC,qEAAqE;IACrE,YAAY,CAAC,GAAG,EAAE,SAAS,GAAG,SAAS,GAAG,IAAI,CAAC;IAC/C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,eAAO,MAAM,sBAAsB,cAAc,CAAC;AAIlD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,UAAU,EAClB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,sBAA2B,GACnC,eAAe,CAgUjB"}