@ai-composer/dom 0.0.0-stage → 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Deepak Chopkar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,6 @@
-# Temporary Holding Version
+# @ai-composer/dom
+
+Browser layer: contentEditable surface, selection mapping, clipboard, templates and suggestion list.
+
+See [`docs/`](../../docs/README.md) for guides and API reference.
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.

package/dist/icons.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Inline SVG icons for the default mount UI (lucide-derived geometry).
+ * Built with createElementNS so no innerHTML parsing is involved.
+ */
+type IconPaths = Array<Array<[string, Record<string, string | number>]>>;
+declare const ICON_PATHS: Record<'send' | 'undo' | 'redo' | 'close', IconPaths>;
+export declare function createIcon(name: keyof typeof ICON_PATHS, size?: number): SVGSVGElement;
+/** Loading state for the send button (animated in themes css). */
+export declare function createSpinner(): HTMLSpanElement;
+export {};
+//# sourceMappingURL=icons.d.ts.map

package/dist/icons.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.d.ts","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,KAAK,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzE,QAAA,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,EAAE,SAAS,CAWrE,CAAC;AAIF,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,OAAO,UAAU,EAAE,IAAI,SAAK,GAAG,aAAa,CAoBlF;AAED,kEAAkE;AAClE,wBAAgB,aAAa,IAAI,eAAe,CAK/C"}

package/dist/icons.js

@@ -0,0 +1,46 @@
+/**
+ * Inline SVG icons for the default mount UI (lucide-derived geometry).
+ * Built with createElementNS so no innerHTML parsing is involved.
+ */
+const ICON_PATHS = {
+    send: [
+        [['M12 19V5', { 'stroke-width': 2.4 }], ['m5 12 7-7 7 7', { 'stroke-width': 2.4 }]],
+    ],
+    undo: [
+        [['M3 7v6h6', {}], ['M21 17a9 9 0 0 0-9-9 9 9 0 0 0-6 2.3L3 13', {}]],
+    ],
+    redo: [
+        [['M21 7v6h-6', {}], ['M3 17a9 9 0 0 1 9-9 9 9 0 0 1 6 2.3L21 13', {}]],
+    ],
+    close: [[['M18 6 6 18', {}], ['m6 6 12 12', {}]]],
+};
+const SVG_NS = 'http://www.w3.org/2000/svg';
+export function createIcon(name, size = 16) {
+    const svg = document.createElementNS(SVG_NS, 'svg');
+    svg.setAttribute('width', String(size));
+    svg.setAttribute('height', String(size));
+    svg.setAttribute('viewBox', '0 0 24 24');
+    svg.setAttribute('fill', 'none');
+    svg.setAttribute('stroke', 'currentColor');
+    svg.setAttribute('stroke-width', '2');
+    svg.setAttribute('stroke-linecap', 'round');
+    svg.setAttribute('stroke-linejoin', 'round');
+    svg.setAttribute('aria-hidden', 'true');
+    for (const [d, attributes] of ICON_PATHS[name].flat()) {
+        const path = document.createElementNS(SVG_NS, 'path');
+        path.setAttribute('d', d);
+        for (const [key, value] of Object.entries(attributes)) {
+            path.setAttribute(key, String(value));
+        }
+        svg.appendChild(path);
+    }
+    return svg;
+}
+/** Loading state for the send button (animated in themes css). */
+export function createSpinner() {
+    const spinner = document.createElement('span');
+    spinner.className = 'aic-spinner';
+    spinner.setAttribute('aria-hidden', 'true');
+    return spinner;
+}
+//# sourceMappingURL=icons.js.map

package/dist/icons.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"icons.js","sourceRoot":"","sources":["../src/icons.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,UAAU,GAA0D;IACxE,IAAI,EAAE;QACJ,CAAC,CAAC,UAAU,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,EAAE,cAAc,EAAE,GAAG,EAAE,CAAC,CAAC;KACpF;IACD,IAAI,EAAE;QACJ,CAAC,CAAC,UAAU,EAAE,EAAE,CAAC,EAAE,CAAC,2CAA2C,EAAE,EAAE,CAAC,CAAC;KACtE;IACD,IAAI,EAAE;QACJ,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,2CAA2C,EAAE,EAAE,CAAC,CAAC;KACxE;IACD,KAAK,EAAE,CAAC,CAAC,CAAC,YAAY,EAAE,EAAE,CAAC,EAAE,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,CAAC;CAClD,CAAC;AAEF,MAAM,MAAM,GAAG,4BAA4B,CAAC;AAE5C,MAAM,UAAU,UAAU,CAAC,IAA6B,EAAE,IAAI,GAAG,EAAE;IACjE,MAAM,GAAG,GAAG,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACpD,GAAG,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACxC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IACzC,GAAG,CAAC,YAAY,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IACzC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,GAAG,CAAC,YAAY,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;IAC3C,GAAG,CAAC,YAAY,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACtC,GAAG,CAAC,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAAC,CAAC;IAC5C,GAAG,CAAC,YAAY,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC7C,GAAG,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IACxC,KAAK,MAAM,CAAC,CAAC,EAAE,UAAU,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,QAAQ,CAAC,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QACtD,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QAC1B,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;YACtD,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACxC,CAAC;QACD,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAC/C,OAAO,CAAC,SAAS,GAAG,aAAa,CAAC;IAClC,OAAO,CAAC,YAAY,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @ai-composer/dom — browser layer over @ai-composer/core.
+ *
+ *   surface     contentEditable binding (input pipeline, keyboard, clipboard, IME)
+ *   render      model → DOM projection (chips carry data-aic-* attributes)
+ *   parse       DOM → model with strict sanitization
+ *   selection   DOM selection ↔ model selection mapping
+ *   suggestions accessible suggestion listbox driven by state
+ *   template    structural mode presets (compact/default/chat/expanded)
+ *   mount       vanilla JS mountAIComposer()
+ */
+export { createEditableSurface, EDITABLE_SURFACE_CLASS, type EditableSurface, type EditableSurfaceOptions, } from './surface';
+export { renderChip, renderDocument, renderTextRun } from './render';
+export { htmlToPlainText, parseEditableHost, CLIPBOARD_MIME } from './parse';
+export { applyModelSelection, caretToEnd, domSelectionToModel } from './selection';
+export { createSuggestionList, type SuggestionList, type SuggestionListOptions, } from './suggestions';
+export { attachCaretAnchoredPopup, measureCaret, type CaretAnchor, type CaretAnchorOptions, type CaretPoint, } from './popup';
+export { CHAT_TEMPLATE, COMPACT_TEMPLATE, DEFAULT_TEMPLATE, EXPANDED_TEMPLATE, registerTemplate, SLOT_ATTRIBUTE, templateForMode, type AIComposerDomTemplate, type TemplateSlotName, } from './template';
+export { mountAIComposer, type MountedEditor, type MountOptions, } from './mount';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,sBAAsB,GAC5B,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,oBAAoB,EACpB,KAAK,cAAc,EACnB,KAAK,qBAAqB,GAC3B,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,UAAU,GAChB,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,EACf,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,EACf,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,20 @@
+/**
+ * @ai-composer/dom — browser layer over @ai-composer/core.
+ *
+ *   surface     contentEditable binding (input pipeline, keyboard, clipboard, IME)
+ *   render      model → DOM projection (chips carry data-aic-* attributes)
+ *   parse       DOM → model with strict sanitization
+ *   selection   DOM selection ↔ model selection mapping
+ *   suggestions accessible suggestion listbox driven by state
+ *   template    structural mode presets (compact/default/chat/expanded)
+ *   mount       vanilla JS mountAIComposer()
+ */
+export { createEditableSurface, EDITABLE_SURFACE_CLASS, } from './surface';
+export { renderChip, renderDocument, renderTextRun } from './render';
+export { htmlToPlainText, parseEditableHost, CLIPBOARD_MIME } from './parse';
+export { applyModelSelection, caretToEnd, domSelectionToModel } from './selection';
+export { createSuggestionList, } from './suggestions';
+export { attachCaretAnchoredPopup, measureCaret, } from './popup';
+export { CHAT_TEMPLATE, COMPACT_TEMPLATE, DEFAULT_TEMPLATE, EXPANDED_TEMPLATE, registerTemplate, SLOT_ATTRIBUTE, templateForMode, } from './template';
+export { mountAIComposer, } from './mount';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,qBAAqB,EACrB,sBAAsB,GAGvB,MAAM,WAAW,CAAC;AAEnB,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,EAAE,mBAAmB,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACnF,OAAO,EACL,oBAAoB,GAGrB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,YAAY,GAIb,MAAM,SAAS,CAAC;AACjB,OAAO,EACL,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,eAAe,GAGhB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,eAAe,GAGhB,MAAM,SAAS,CAAC"}

package/dist/mount.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Vanilla JS mount — proves the stack works with zero framework. Builds the
+ * DOM once (every slot exists), then applies the mode's structural preset and
+ * re-applies it live when the editor's mode changes — the draft, focus and
+ * undo history survive a compact ↔ chat ↔ expanded switch.
+ */
+import type { AIComposer, SuggestionItem } from '@ai-composer/core';
+import { type EditableSurface } from './surface';
+import { type AIComposerDomTemplate } from './template';
+export interface MountOptions {
+    /** Initial mode preset; can be changed later via `editor.setMode()`. */
+    mode?: string;
+    /** Replace the structural preset (static — not mode-switched). */
+    template?: AIComposerDomTemplate;
+    /**
+     * Force slots on regardless of the mode preset (projection-friendly):
+     * attachments/header/toolbar/footer stay mountable in compact too.
+     */
+    showSlots?: Array<'header' | 'attachments' | 'toolbar' | 'footer'>;
+    /**
+     * Auto-height ceiling — any CSS length ("160px", "40vh"). The box grows
+     * with content up to this height, then scrolls inside.
+     * Equivalent to the `--aic-input-max-height` token.
+     */
+    maxHeight?: string;
+    /** Custom suggestion item renderer. */
+    renderSuggestionItem?: (item: SuggestionItem, active: boolean) => HTMLElement;
+    labels?: {
+        removeAttachment?: string;
+    };
+}
+export interface MountedEditor {
+    root: HTMLElement;
+    input: HTMLElement;
+    suggestions: HTMLElement;
+    surface: EditableSurface;
+    slots: Record<string, HTMLElement>;
+    destroy(): void;
+}
+export declare function mountAIComposer(container: HTMLElement, editor: AIComposer, options?: MountOptions): MountedEditor;
+//# sourceMappingURL=mount.d.ts.map

package/dist/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAe,MAAM,mBAAmB,CAAC;AACjF,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,WAAW,CAAC;AAGxE,OAAO,EAAmC,KAAK,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAEzF,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kEAAkE;IAClE,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,QAAQ,GAAG,aAAa,GAAG,SAAS,GAAG,QAAQ,CAAC,CAAC;IACnE;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,oBAAoB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,OAAO,KAAK,WAAW,CAAC;IAC9E,MAAM,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxC;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,WAAW,CAAC;IAClB,KAAK,EAAE,WAAW,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,OAAO,EAAE,eAAe,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;IACnC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,eAAe,CAC7B,SAAS,EAAE,WAAW,EACtB,MAAM,EAAE,UAAU,EAClB,OAAO,GAAE,YAAiB,GACzB,aAAa,CA0Kf"}

package/dist/mount.js

@@ -0,0 +1,168 @@
+/**
+ * Vanilla JS mount — proves the stack works with zero framework. Builds the
+ * DOM once (every slot exists), then applies the mode's structural preset and
+ * re-applies it live when the editor's mode changes — the draft, focus and
+ * undo history survive a compact ↔ chat ↔ expanded switch.
+ */
+import { createEditableSurface } from './surface';
+import { createSuggestionList } from './suggestions';
+import { createIcon, createSpinner } from './icons';
+import { templateForMode, SLOT_ATTRIBUTE } from './template';
+export function mountAIComposer(container, editor, options = {}) {
+    const labels = {
+        removeAttachment: options.labels?.removeAttachment ?? 'Remove',
+    };
+    const slots = {};
+    const disposables = [];
+    const makeSlot = (name, className) => {
+        const element = document.createElement('div');
+        element.className = className;
+        element.setAttribute(SLOT_ATTRIBUTE, name);
+        slots[name] = element;
+        return element;
+    };
+    const root = container;
+    root.classList.add('aic-root');
+    if (options.maxHeight) {
+        root.style.setProperty('--aic-input-max-height', options.maxHeight);
+    }
+    const header = makeSlot('header', 'aic-header');
+    const body = makeSlot('body', 'aic-body');
+    const toolbar = makeSlot('toolbar', 'aic-toolbar');
+    const footer = makeSlot('footer', 'aic-footer');
+    const attachments = makeSlot('attachments', 'aic-attachments');
+    const input = makeSlot('input', 'aic-input-host');
+    root.append(header, body, toolbar, footer);
+    // The input wrapper is the popup anchor: it occupies exactly the input's
+    // space — the suggestion list floats out of it (no DOM-space reservation).
+    const inputWrap = document.createElement('div');
+    inputWrap.className = 'aic-input-wrap';
+    inputWrap.setAttribute(SLOT_ATTRIBUTE, 'suggestions');
+    inputWrap.appendChild(input);
+    slots.suggestions = inputWrap;
+    body.append(attachments, inputWrap);
+    const surface = createEditableSurface(editor, input, { id: input.id || undefined });
+    const suggestionList = createSuggestionList(editor, undefined, {
+        renderItem: options.renderSuggestionItem,
+        inputHost: input,
+    });
+    inputWrap.appendChild(suggestionList.element);
+    // -- mode presets ----------------------------------------------------------
+    const applyTemplate = (mode) => {
+        const template = options.template ?? templateForMode(mode);
+        const present = new Set(template.slots);
+        for (const slotName of options.showSlots ?? [])
+            present.add(slotName);
+        root.setAttribute('data-aic-mode', template.name);
+        header.hidden = !present.has('header');
+        toolbar.hidden = !present.has('toolbar');
+        footer.hidden = !present.has('footer');
+        surface.setMultiline(template.multiline);
+        surface.setSubmitKey(template.submitKey);
+        if (toolbar) {
+            toolbar.textContent = '';
+            for (const action of template.toolbarButtons ?? []) {
+                const button = document.createElement('button');
+                button.type = 'button';
+                button.className = `aic-toolbar-${action}`;
+                button.setAttribute('data-aic-action', action);
+                if (action === 'submit') {
+                    button.appendChild(createIcon('send'));
+                    button.setAttribute('aria-label', 'Send');
+                    button.addEventListener('click', () => void editor.executeCommand('submit'));
+                }
+                else if (action === 'undo') {
+                    button.appendChild(createIcon('undo'));
+                    button.setAttribute('aria-label', 'Undo');
+                    button.addEventListener('click', () => void editor.executeCommand('undo'));
+                }
+                else {
+                    button.appendChild(createIcon('redo'));
+                    button.setAttribute('aria-label', 'Redo');
+                    button.addEventListener('click', () => void editor.executeCommand('redo'));
+                }
+                toolbar.appendChild(button);
+            }
+        }
+    };
+    // -- state-driven UI -------------------------------------------------------
+    let currentMode = '';
+    const syncUi = (state) => {
+        if (state.mode !== currentMode) {
+            currentMode = state.mode;
+            applyTemplate(state.mode);
+        }
+        const submit = toolbar.querySelector('[data-aic-action="submit"]');
+        if (submit) {
+            const canSubmit = !state.disabled && !state.readonly && !state.submitting &&
+                (!state.empty || state.attachments.length > 0);
+            submit.disabled = !canSubmit;
+            submit.setAttribute('aria-disabled', String(!canSubmit));
+            if (state.submitting) {
+                if (!submit.querySelector('.aic-spinner')) {
+                    submit.textContent = '';
+                    submit.appendChild(createSpinner());
+                }
+            }
+            else if (!submit.querySelector('svg')) {
+                submit.textContent = '';
+                submit.appendChild(createIcon('send'));
+            }
+        }
+        const undo = toolbar.querySelector('[data-aic-action="undo"]');
+        if (undo)
+            undo.disabled = !state.canUndo;
+        const redo = toolbar.querySelector('[data-aic-action="redo"]');
+        if (redo)
+            redo.disabled = !state.canRedo;
+        // Attachments are projection-friendly: visible whenever they exist,
+        // regardless of the mode preset (apps add them via editor.addAttachment).
+        attachments.hidden = state.attachments.length === 0;
+        attachments.textContent = '';
+        for (const attachment of state.attachments) {
+            const item = document.createElement('span');
+            item.className = 'aic-attachment';
+            const name = document.createElement('span');
+            name.className = 'aic-attachment-name';
+            name.textContent = attachment.name;
+            const remove = document.createElement('button');
+            remove.type = 'button';
+            remove.className = 'aic-attachment-remove';
+            remove.setAttribute('aria-label', `${labels.removeAttachment} ${attachment.name}`);
+            remove.appendChild(createIcon('close', 12));
+            remove.addEventListener('click', () => editor.removeNode(attachment.key));
+            item.append(name, remove);
+            attachments.appendChild(item);
+        }
+    };
+    const unsubscribeState = editor.subscribe(syncUi);
+    disposables.push(unsubscribeState);
+    if (options.mode && options.mode !== editor.getState().mode) {
+        editor.setMode(options.mode);
+    }
+    // setMode emits to subscribers; ensure the initial template is applied even
+    // when the editor was already in the target mode.
+    currentMode = editor.getState().mode;
+    applyTemplate(currentMode);
+    syncUi(editor.getState());
+    const offDestroy = editor.on('destroy', () => mounted.destroy());
+    disposables.push(offDestroy);
+    const mounted = {
+        root,
+        input,
+        suggestions: suggestionList.element,
+        surface,
+        slots,
+        destroy() {
+            for (const dispose of disposables.splice(0))
+                dispose();
+            suggestionList.destroy();
+            surface.destroy();
+            root.textContent = '';
+            root.classList.remove('aic-root');
+            root.removeAttribute('data-aic-mode');
+        },
+    };
+    return mounted;
+}
+//# sourceMappingURL=mount.js.map

package/dist/mount.js.map

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

package/dist/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@ai-composer/dom",
+  "version": "0.1.0",
+  "type": "module",
+  "license": "MIT",
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "@ai-composer/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "@ai-composer/core": "workspace:*",
+    "vitest": "^2.1.8",
+    "jsdom": "^25.0.1"
+  },
+  "module": "./index.js"
+}

package/dist/parse.d.ts

@@ -0,0 +1,13 @@
+/**
+ * DOM → model parsing with strict sanitization: only elements we generate
+ * (data-aic-node chips) survive as structured nodes — everything else is
+ * flattened to plain text (see the serialization ADR).
+ */
+import { createDocument, type NodeRegistry } from '@ai-composer/core';
+/** Parse the editable host back into a document. Never trusts markup: unknown nodes collapse to text. */
+export declare function parseEditableHost(host: HTMLElement, registry: NodeRegistry): ReturnType<typeof createDocument>;
+/** Extract safe plain text from arbitrary HTML (paste path). Tags are dropped, <br> becomes \n. */
+export declare function htmlToPlainText(html: string): string;
+/** Clipboard mime used for lossless internal copy/paste round-trips. */
+export declare const CLIPBOARD_MIME = "application/x-ai-composer";
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,cAAc,EAEd,KAAK,YAAY,EAGlB,MAAM,mBAAmB,CAAC;AAS3B,yGAAyG;AACzG,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAsC9G;AAiDD,mGAAmG;AACnG,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAqBpD;AAED,wEAAwE;AACxE,eAAO,MAAM,cAAc,8BAAqB,CAAC"}

package/dist/parse.js

@@ -0,0 +1,133 @@
+/**
+ * DOM → model parsing with strict sanitization: only elements we generate
+ * (data-aic-node chips) survive as structured nodes — everything else is
+ * flattened to plain text (see the serialization ADR).
+ */
+import { createDocument, createNodeKey, } from '@ai-composer/core';
+const INTERNAL_CLIP_MIME = 'application/x-ai-composer';
+function textNode(text, previous) {
+    if (previous)
+        return { ...previous, text: previous.text + text };
+    return { type: 'text', key: createNodeKey('text'), text };
+}
+/** Parse the editable host back into a document. Never trusts markup: unknown nodes collapse to text. */
+export function parseEditableHost(host, registry) {
+    const nodes = [];
+    const appendText = (text) => {
+        if (!text)
+            return;
+        const last = nodes[nodes.length - 1];
+        if (last && last.type === 'text')
+            nodes[nodes.length - 1] = textNode(text, last);
+        else
+            nodes.push(textNode(text));
+    };
+    const walk = (parent) => {
+        for (const child of Array.from(parent.childNodes)) {
+            if (child.nodeType === Node.TEXT_NODE) {
+                appendText(child.textContent ?? '');
+                continue;
+            }
+            if (child.nodeName === 'BR') {
+                appendText('\n');
+                continue;
+            }
+            if (child instanceof HTMLElement) {
+                // Never surface executable/style content as text.
+                if (child.tagName === 'SCRIPT' || child.tagName === 'STYLE')
+                    continue;
+                const type = child.getAttribute('data-aic-node');
+                const parsed = type ? chipFromElement(child, type, registry) : null;
+                if (parsed) {
+                    nodes.push(parsed);
+                    continue;
+                }
+                // Unknown wrapper (browser artifact, pasted markup) — flatten to text only.
+                walk(child);
+            }
+            // Comments and other node types are dropped.
+        }
+    };
+    walk(host);
+    return createDocument(nodes);
+}
+function chipFromElement(element, type, registry) {
+    if (!registry.has(type))
+        return null;
+    const key = element.getAttribute('data-aic-key') ?? createNodeKey(type);
+    const attr = (name) => element.getAttribute(`data-aic-${name}`);
+    switch (type) {
+        case 'mention':
+        case 'command': {
+            const id = attr('id');
+            const label = attr('label');
+            if (!id || !label)
+                return null;
+            return type === 'mention'
+                ? { type: 'mention', key, id, label }
+                : { type: 'command', key, id, label };
+        }
+        case 'variable': {
+            const name = attr('name');
+            if (!name)
+                return null;
+            return { type: 'variable', key, name };
+        }
+        case 'attachment': {
+            const id = attr('id');
+            const name = attr('name');
+            const mimeType = attr('mime') ?? 'application/octet-stream';
+            if (!id || !name)
+                return null;
+            const sizeAttr = attr('size');
+            const size = sizeAttr ? Number(sizeAttr) : undefined;
+            return { type: 'attachment', key, id, name, mimeType, ...(Number.isFinite(size) ? { size } : {}) };
+        }
+        case 'custom': {
+            const plugin = attr('plugin');
+            const nodeType = attr('type');
+            if (!plugin || !nodeType)
+                return null;
+            let data = null;
+            try {
+                data = JSON.parse(attr('data') ?? 'null');
+            }
+            catch {
+                data = null;
+            }
+            return { type: 'custom', key, plugin, nodeType, data };
+        }
+        default:
+            // Registered custom node types without a known chip shape degrade to text.
+            return null;
+    }
+}
+/** Extract safe plain text from arbitrary HTML (paste path). Tags are dropped, <br> becomes \n. */
+export function htmlToPlainText(html) {
+    const container = document.createElement('div');
+    container.innerHTML = html; // parsed, never inserted into the page
+    let text = '';
+    const walk = (parent) => {
+        for (const child of Array.from(parent.childNodes)) {
+            if (child.nodeType === Node.TEXT_NODE)
+                text += child.textContent ?? '';
+            else if (child.nodeName === 'BR')
+                text += '\n';
+            else if (child.nodeType === Node.ELEMENT_NODE) {
+                const element = child;
+                if (element.tagName === 'DIV' || element.tagName === 'P') {
+                    walk(element);
+                    text += '\n';
+                }
+                else {
+                    walk(element);
+                }
+            }
+        }
+    };
+    walk(container);
+    return text;
+}
+/** Clipboard mime used for lossless internal copy/paste round-trips. */
+export const CLIPBOARD_MIME = INTERNAL_CLIP_MIME;
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/popup.d.ts

@@ -0,0 +1,34 @@
+/**
+ * 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.
+ */
+export interface CaretPoint {
+    /** Viewport x of the caret. */
+    x: number;
+    /** Viewport y of the caret line's top / bottom. */
+    top: number;
+    bottom: number;
+}
+export interface CaretAnchor {
+    /** Recompute position (call after content/visibility changes). */
+    update(): void;
+    destroy(): void;
+}
+export interface CaretAnchorOptions {
+    /** Preferred side; flips automatically when the viewport lacks room. */
+    placement?: 'above' | 'below';
+}
+/** Measure the caret inside a contenteditable host (viewport coordinates). */
+export declare function measureCaret(host: HTMLElement): CaretPoint | null;
+export declare function attachCaretAnchoredPopup(popup: HTMLElement, host: HTMLElement, options?: CaretAnchorOptions): CaretAnchor;
+//# sourceMappingURL=popup.d.ts.map

package/dist/popup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"popup.d.ts","sourceRoot":"","sources":["../src/popup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,MAAM,WAAW,UAAU;IACzB,+BAA+B;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,mDAAmD;IACnD,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,kEAAkE;IAClE,MAAM,IAAI,IAAI,CAAC;IACf,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,SAAS,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC;CAC/B;AAKD,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,GAAG,IAAI,CA6BjE;AAWD,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,WAAW,EAClB,IAAI,EAAE,WAAW,EACjB,OAAO,GAAE,kBAAuB,GAC/B,WAAW,CAsEb"}