@ai-composer/core 0.1.0

package/dist/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@ai-composer/core",
+  "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": {},
+  "devDependencies": {
+    "vitest": "^2.1.8"
+  },
+  "module": "./index.js"
+}

package/dist/plugins/registry.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Plugin architecture (ADR-0004). Plugins are plain objects with declarative
+ * contributions plus an optional `setup()` for imperative wiring. They receive
+ * a scoped context — never raw editor internals.
+ */
+import type { Unsubscribe, EventBus } from '../events/event-bus';
+import type { AIComposerEventMap } from '../events/events';
+import type { AIComposerCommand } from '../commands/registry';
+import type { AIComposerTrigger } from '../triggers/engine';
+import type { NodeDefinition } from '../nodes/registry';
+import type { Serializer } from '../serialization/serializers';
+import type { CommandRegistry } from '../commands/registry';
+import type { TriggerRegistry } from '../triggers/engine';
+import type { NodeRegistry } from '../nodes/registry';
+import type { SerializerRegistry } from '../serialization/registry';
+import type { AIComposer } from '../editor';
+import type { AIComposerConfig } from '../types';
+/** Controlled capabilities exposed to plugins. */
+export interface PluginContext {
+    editor: AIComposer;
+    getConfig(): AIComposerConfig;
+    commands: CommandRegistry;
+    triggers: TriggerRegistry;
+    nodes: NodeRegistry;
+    serializers: SerializerRegistry;
+    /** Subscribe to editor events (emit is intentionally not handed out). */
+    events: Pick<EventBus<AIComposerEventMap>, 'on' | 'once' | 'off'>;
+    /** Register cleanup run when the plugin is destroyed. */
+    onCleanup(cleanup: () => void): void;
+}
+export interface AIComposerPlugin {
+    /** Unique plugin name. */
+    name: string;
+    version?: string;
+    /** Imperative wiring — called once when the plugin is attached. */
+    setup?(context: PluginContext): void;
+    commands?: AIComposerCommand[];
+    triggers?: AIComposerTrigger[];
+    nodeTypes?: NodeDefinition[];
+    serializers?: Serializer[];
+    /** Called when the plugin is removed or the editor destroyed. */
+    destroy?(): void;
+}
+export interface PluginRegistry {
+    add(plugin: AIComposerPlugin): Unsubscribe;
+    get(name: string): AIComposerPlugin | undefined;
+    list(): AIComposerPlugin[];
+    /** Set up a plugin immediately with the given context (used by the factory). */
+    install(plugin: AIComposerPlugin, context: PluginContext): Unsubscribe;
+    destroyAll(): void;
+}
+export declare function createPluginRegistry(): PluginRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/plugins/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/plugins/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,kDAAkD;AAClD,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,UAAU,CAAC;IACnB,SAAS,IAAI,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,eAAe,CAAC;IAC1B,QAAQ,EAAE,eAAe,CAAC;IAC1B,KAAK,EAAE,YAAY,CAAC;IACpB,WAAW,EAAE,kBAAkB,CAAC;IAChC,yEAAyE;IACzE,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC,CAAC;IAClE,yDAAyD;IACzD,SAAS,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,IAAI,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,KAAK,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;IACrC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAC/B,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,iEAAiE;IACjE,OAAO,CAAC,IAAI,IAAI,CAAC;CAClB;AAOD,MAAM,WAAW,cAAc;IAC7B,GAAG,CAAC,MAAM,EAAE,gBAAgB,GAAG,WAAW,CAAC;IAC3C,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS,CAAC;IAChD,IAAI,IAAI,gBAAgB,EAAE,CAAC;IAC3B,gFAAgF;IAChF,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,OAAO,EAAE,aAAa,GAAG,WAAW,CAAC;IACvE,UAAU,IAAI,IAAI,CAAC;CACpB;AAED,wBAAgB,oBAAoB,IAAI,cAAc,CAqGrD"}

package/dist/plugins/registry.js

@@ -0,0 +1,102 @@
+/**
+ * Plugin architecture (ADR-0004). Plugins are plain objects with declarative
+ * contributions plus an optional `setup()` for imperative wiring. They receive
+ * a scoped context — never raw editor internals.
+ */
+export function createPluginRegistry() {
+    const installed = [];
+    const teardown = (entry) => {
+        for (const dispose of entry.disposers.splice(0)) {
+            try {
+                dispose();
+            }
+            catch (error) {
+                console.error(`[ai-composer] plugin "${entry.plugin.name}" cleanup failed`, error);
+            }
+        }
+        try {
+            entry.plugin.destroy?.();
+        }
+        catch (error) {
+            console.error(`[ai-composer] plugin "${entry.plugin.name}" destroy failed`, error);
+        }
+    };
+    const registry = {
+        add(plugin) {
+            const entry = { plugin, disposers: [] };
+            installed.push(entry);
+            return () => {
+                const index = installed.indexOf(entry);
+                if (index >= 0) {
+                    installed.splice(index, 1);
+                    teardown(entry);
+                }
+            };
+        },
+        get(name) {
+            return installed.find((entry) => entry.plugin.name === name)?.plugin;
+        },
+        list() {
+            return installed.map((entry) => entry.plugin);
+        },
+        install(plugin, context) {
+            const entry = { plugin, disposers: [] };
+            installed.push(entry);
+            const scoped = {
+                ...context,
+                onCleanup: (cleanup) => {
+                    entry.disposers.push(cleanup);
+                },
+                events: {
+                    on: (type, handler) => {
+                        const off = context.events.on(type, handler);
+                        entry.disposers.push(off);
+                        return off;
+                    },
+                    once: (type, handler) => {
+                        const off = context.events.once(type, handler);
+                        entry.disposers.push(off);
+                        return off;
+                    },
+                    off: (type, handler) => context.events.off(type, handler),
+                },
+            };
+            for (const command of plugin.commands ?? []) {
+                entry.disposers.push(context.commands.register(command));
+            }
+            for (const trigger of plugin.triggers ?? []) {
+                entry.disposers.push(context.triggers.register(trigger));
+            }
+            for (const nodeType of plugin.nodeTypes ?? []) {
+                entry.disposers.push(context.nodes.register(nodeType));
+            }
+            for (const serializer of plugin.serializers ?? []) {
+                entry.disposers.push(context.serializers.register(serializer));
+            }
+            try {
+                plugin.setup?.(scoped);
+            }
+            catch (error) {
+                // roll this plugin back; the editor stays alive
+                const index = installed.indexOf(entry);
+                if (index >= 0)
+                    installed.splice(index, 1);
+                teardown(entry);
+                throw error;
+            }
+            return () => {
+                const index = installed.indexOf(entry);
+                if (index >= 0) {
+                    installed.splice(index, 1);
+                    teardown(entry);
+                }
+            };
+        },
+        destroyAll() {
+            for (const entry of installed.splice(0))
+                teardown(entry);
+        },
+    };
+    return registry;
+}
+//# sourceMappingURL=registry.js.map

package/dist/plugins/registry.js.map

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

package/dist/serialization/builtins.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Built-in serializers. Every projection goes through the node registry so
+ * plugins control how their custom nodes serialize.
+ */
+import type { AIComposerDocument } from '../model/document';
+import type { AIComposerNode } from '../model/nodes';
+import type { Serializer, SerializerContext } from './serializers';
+/** Structured payload handed to AI providers — provider-neutral by design (see docs). */
+export interface AIComposerPayload {
+    text: string;
+    entities: Array<{
+        type: string;
+        key: string;
+        id?: string;
+        label?: string;
+        name?: string;
+        data?: unknown;
+    }>;
+    metadata?: Record<string, unknown>;
+}
+/** Plain-text projection of a single node. */
+export declare function nodeToText(node: AIComposerNode, context: SerializerContext): string;
+export declare function documentToText(document: AIComposerDocument, context: SerializerContext): string;
+export declare function createJsonSerializer(): Serializer;
+export declare function createTextSerializer(): Serializer;
+export declare function createMarkdownSerializer(): Serializer;
+export declare function createHtmlSerializer(): Serializer;
+export declare function createAiSerializer(): Serializer;
+export declare function createDefaultSerializers(): Serializer[];
+//# sourceMappingURL=builtins.d.ts.map

package/dist/serialization/builtins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/serialization/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,KAAK,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAEnE,yFAAyF;AACzF,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,KAAK,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,IAAI,CAAC,EAAE,OAAO,CAAC;KAChB,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAMD,8CAA8C;AAC9C,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAKnF;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAE/F;AAcD,wBAAgB,oBAAoB,IAAI,UAAU,CAQjD;AAED,wBAAgB,oBAAoB,IAAI,UAAU,CAOjD;AAED,wBAAgB,wBAAwB,IAAI,UAAU,CAOrD;AAED,wBAAgB,oBAAoB,IAAI,UAAU,CAQjD;AAED,wBAAgB,kBAAkB,IAAI,UAAU,CAqB/C;AAED,wBAAgB,wBAAwB,IAAI,UAAU,EAAE,CAQvD"}

package/dist/serialization/builtins.js

@@ -0,0 +1,102 @@
+/**
+ * Built-in serializers. Every projection goes through the node registry so
+ * plugins control how their custom nodes serialize.
+ */
+import { escapeHtml } from '../utils/html';
+function definitionOf(context, node) {
+    return context.nodes.get(node.type);
+}
+/** Plain-text projection of a single node. */
+export function nodeToText(node, context) {
+    const def = definitionOf(context, node);
+    if (def?.toText)
+        return def.toText(node);
+    if (node.type === 'text')
+        return node.text;
+    return '';
+}
+export function documentToText(document, context) {
+    return document.nodes.map((node) => nodeToText(node, context)).join('');
+}
+function nodeToMarkdown(node, context) {
+    const def = definitionOf(context, node);
+    if (def?.toMarkdown)
+        return def.toMarkdown(node);
+    return nodeToText(node, context);
+}
+function nodeToHtml(node, context) {
+    const def = definitionOf(context, node);
+    if (def?.toHtml)
+        return def.toHtml(node);
+    return escapeHtml(nodeToText(node, context));
+}
+export function createJsonSerializer() {
+    return {
+        format: 'json',
+        serialize(document) {
+            // Round-trip safe: plain JSON structures only.
+            return JSON.parse(JSON.stringify(document));
+        },
+    };
+}
+export function createTextSerializer() {
+    return {
+        format: 'text',
+        serialize(document, context) {
+            return documentToText(document, context);
+        },
+    };
+}
+export function createMarkdownSerializer() {
+    return {
+        format: 'markdown',
+        serialize(document, context) {
+            return document.nodes.map((node) => nodeToMarkdown(node, context)).join('');
+        },
+    };
+}
+export function createHtmlSerializer() {
+    return {
+        format: 'html',
+        serialize(document, context) {
+            const body = document.nodes.map((node) => nodeToHtml(node, context)).join('');
+            return `<div data-aic-document>${body}</div>`;
+        },
+    };
+}
+export function createAiSerializer() {
+    return {
+        format: 'ai',
+        serialize(document, context) {
+            return {
+                text: documentToText(document, context),
+                entities: document.nodes
+                    .filter((node) => node.type !== 'text')
+                    .map((node) => {
+                    const base = { type: node.type, key: node.key };
+                    const record = node;
+                    if (typeof record.id === 'string')
+                        base.id = record.id;
+                    if (typeof record.label === 'string')
+                        base.label = record.label;
+                    if (typeof record.name === 'string')
+                        base.name = record.name;
+                    if (node.type === 'custom')
+                        base.data = record.data;
+                    return base;
+                }),
+                ...(document.metadata ? { metadata: document.metadata } : {}),
+            };
+        },
+    };
+}
+export function createDefaultSerializers() {
+    return [
+        createJsonSerializer(),
+        createTextSerializer(),
+        createMarkdownSerializer(),
+        createHtmlSerializer(),
+        createAiSerializer(),
+    ];
+}
+//# sourceMappingURL=builtins.js.map

package/dist/serialization/builtins.js.map

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

package/dist/serialization/index.d.ts

@@ -0,0 +1,4 @@
+export type { SerializationFormat, Serializer, SerializerContext, } from './serializers';
+export { createSerializerRegistry, type SerializerRegistry, } from './registry';
+export { createAiSerializer, createDefaultSerializers, createHtmlSerializer, createJsonSerializer, createMarkdownSerializer, createTextSerializer, documentToText, nodeToText, type AIComposerPayload, } from './builtins';
+//# sourceMappingURL=index.d.ts.map

package/dist/serialization/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/serialization/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,iBAAiB,GAClB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,wBAAwB,EACxB,KAAK,kBAAkB,GACxB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,UAAU,EACV,KAAK,iBAAiB,GACvB,MAAM,YAAY,CAAC"}

package/dist/serialization/index.js

@@ -0,0 +1,3 @@
+export { createSerializerRegistry, } from './registry';
+export { createAiSerializer, createDefaultSerializers, createHtmlSerializer, createJsonSerializer, createMarkdownSerializer, createTextSerializer, documentToText, nodeToText, } from './builtins';
+//# sourceMappingURL=index.js.map

package/dist/serialization/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/serialization/index.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,wBAAwB,GAEzB,MAAM,YAAY,CAAC;AACpB,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,oBAAoB,EACpB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,cAAc,EACd,UAAU,GAEX,MAAM,YAAY,CAAC"}

package/dist/serialization/registry.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Serializer registry (ADR-0006). Built-in formats: json, text, markdown,
+ * html, ai. Plugins can add formats or override built-ins by re-registering
+ * the same format id (last registration wins).
+ */
+import type { Unsubscribe } from '../events/event-bus';
+import type { AIComposerDocument } from '../model/document';
+import type { SerializationFormat, Serializer, SerializerContext } from './serializers';
+export interface SerializerRegistry {
+    register(serializer: Serializer): Unsubscribe;
+    get(format: SerializationFormat): Serializer | undefined;
+    formats(): SerializationFormat[];
+    serialize(format: SerializationFormat, document: AIComposerDocument, context: SerializerContext): unknown;
+    clear(): void;
+}
+export declare function createSerializerRegistry(): SerializerRegistry;
+//# sourceMappingURL=registry.d.ts.map

package/dist/serialization/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/serialization/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAExF,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,UAAU,EAAE,UAAU,GAAG,WAAW,CAAC;IAC9C,GAAG,CAAC,MAAM,EAAE,mBAAmB,GAAG,UAAU,GAAG,SAAS,CAAC;IACzD,OAAO,IAAI,mBAAmB,EAAE,CAAC;IACjC,SAAS,CAAC,MAAM,EAAE,mBAAmB,EAAE,QAAQ,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAC1G,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CA6B7D"}

package/dist/serialization/registry.js

@@ -0,0 +1,35 @@
+/**
+ * Serializer registry (ADR-0006). Built-in formats: json, text, markdown,
+ * html, ai. Plugins can add formats or override built-ins by re-registering
+ * the same format id (last registration wins).
+ */
+import { AIComposerError } from '../errors';
+export function createSerializerRegistry() {
+    const serializers = new Map();
+    return {
+        register(serializer) {
+            serializers.set(serializer.format, serializer);
+            return () => {
+                if (serializers.get(serializer.format) === serializer)
+                    serializers.delete(serializer.format);
+            };
+        },
+        get(format) {
+            return serializers.get(format);
+        },
+        formats() {
+            return [...serializers.keys()];
+        },
+        serialize(format, document, context) {
+            const serializer = serializers.get(format);
+            if (!serializer) {
+                throw new AIComposerError('UNKNOWN_FORMAT', `No serializer registered for "${format}". Registered: ${[...serializers.keys()].join(', ') || 'none'}`);
+            }
+            return serializer.serialize(document, context);
+        },
+        clear() {
+            serializers.clear();
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/serialization/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/serialization/registry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAY5C,MAAM,UAAU,wBAAwB;IACtC,MAAM,WAAW,GAAG,IAAI,GAAG,EAAmC,CAAC;IAC/D,OAAO;QACL,QAAQ,CAAC,UAAU;YACjB,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;YAC/C,OAAO,GAAG,EAAE;gBACV,IAAI,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,KAAK,UAAU;oBAAE,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;YAC/F,CAAC,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,MAAM;YACR,OAAO,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,CAAC;QACD,OAAO;YACL,OAAO,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,SAAS,CAAC,MAAM,EAAE,QAAQ,EAAE,OAAO;YACjC,MAAM,UAAU,GAAG,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;YAC3C,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,MAAM,IAAI,eAAe,CACvB,gBAAgB,EAChB,iCAAiC,MAAM,kBAAkB,CAAC,GAAG,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,MAAM,EAAE,CACxG,CAAC;YACJ,CAAC;YACD,OAAO,UAAU,CAAC,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QACjD,CAAC;QACD,KAAK;YACH,WAAW,CAAC,KAAK,EAAE,CAAC;QACtB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/serialization/serializers.d.ts

@@ -0,0 +1,12 @@
+/** Serializer contracts. Built-in implementations live in ./builtins.ts. */
+import type { AIComposerDocument } from '../model/document';
+import type { NodeRegistry } from '../nodes/registry';
+export type SerializationFormat = 'json' | 'text' | 'markdown' | 'html' | 'ai';
+export interface SerializerContext {
+    nodes: NodeRegistry;
+}
+export interface Serializer {
+    format: SerializationFormat;
+    serialize(document: AIComposerDocument, context: SerializerContext): unknown;
+}
+//# sourceMappingURL=serializers.d.ts.map

package/dist/serialization/serializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.d.ts","sourceRoot":"","sources":["../../src/serialization/serializers.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAE5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,mBAAmB,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,IAAI,CAAC;AAE/E,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,YAAY,CAAC;CACrB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,SAAS,CAAC,QAAQ,EAAE,kBAAkB,EAAE,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC;CAC9E"}

package/dist/serialization/serializers.js

@@ -0,0 +1,3 @@
+/** Serializer contracts. Built-in implementations live in ./builtins.ts. */
+export {};
+//# sourceMappingURL=serializers.js.map

package/dist/serialization/serializers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializers.js","sourceRoot":"","sources":["../../src/serialization/serializers.ts"],"names":[],"mappings":"AAAA,4EAA4E"}

package/dist/state/state.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Observable, framework-neutral editor state. Adapters expose it as
+ * React hooks state, Angular signals, Vue refs, Svelte stores — core stays UI-free.
+ */
+import type { AIComposerDocument } from '../model/document';
+import type { AttachmentNode } from '../model/nodes';
+import type { SelectionState } from '../model/selection';
+/** One entry of a trigger's suggestion list. */
+export interface SuggestionItem {
+    id: string;
+    label: string;
+    description?: string;
+    /** Optional grouping heading in the suggestion UI. */
+    group?: string;
+    /** Icon name/URL — rendering is up to the UI layer. */
+    icon?: string;
+    /** Plugin-specific payload handed back on select. */
+    data?: Record<string, unknown>;
+}
+/** Live trigger session, e.g. while the user types "@jo". */
+export interface TriggerState {
+    triggerId: string;
+    /** Text typed after the trigger character. */
+    query: string;
+    /** Index of the text node containing the trigger run. */
+    nodeIndex: number;
+    /** Offset of the trigger character within that text node. */
+    triggerOffset: number;
+    /** Offset where the query ends (the caret at scan time). */
+    endOffset: number;
+}
+export interface AIComposerState {
+    /** Current document value. */
+    value: AIComposerDocument;
+    focused: boolean;
+    disabled: boolean;
+    readonly: boolean;
+    /** True while an async submit handler is running. */
+    submitting: boolean;
+    selection: SelectionState;
+    activeTrigger: TriggerState | null;
+    suggestions: SuggestionItem[];
+    /** Highlighted suggestion (-1 when none). */
+    activeSuggestionIndex: number;
+    /** Convenience view of attachment nodes inside the document. */
+    attachments: AttachmentNode[];
+    canUndo: boolean;
+    canRedo: boolean;
+    /** Active presentation mode / preset name (e.g. 'chat'). */
+    mode: string;
+    placeholder: string;
+    empty: boolean;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/state/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,gDAAgD;AAChD,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uDAAuD;IACvD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,6DAA6D;AAC7D,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,aAAa,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,eAAe;IAC9B,8BAA8B;IAC9B,KAAK,EAAE,kBAAkB,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,qDAAqD;IACrD,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,cAAc,CAAC;IAC1B,aAAa,EAAE,YAAY,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,6CAA6C;IAC7C,qBAAqB,EAAE,MAAM,CAAC;IAC9B,gEAAgE;IAChE,WAAW,EAAE,cAAc,EAAE,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,OAAO,CAAC;IACjB,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB"}

package/dist/state/state.js

@@ -0,0 +1,6 @@
+/**
+ * Observable, framework-neutral editor state. Adapters expose it as
+ * React hooks state, Angular signals, Vue refs, Svelte stores — core stays UI-free.
+ */
+export {};
+//# sourceMappingURL=state.js.map

package/dist/state/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../../src/state/state.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/triggers/engine.d.ts

@@ -0,0 +1,102 @@
+/**
+ * Trigger system — detects trigger characters (`@`, `/`, `#`, `$`, `:` …)
+ * typed before the caret, runs the owning trigger's search, and manages the
+ * suggestion session in editor state.
+ */
+import type { Unsubscribe } from '../events/event-bus';
+import { type AIComposerNode } from '../model/nodes';
+import type { AIComposerDocument } from '../model/document';
+import type { SelectionState } from '../model/selection';
+import type { SuggestionItem, TriggerState } from '../state/state';
+import type { AIComposer } from '../editor';
+import type { AIComposerBus } from '../events/events';
+export interface TriggerSearchContext {
+    query: string;
+    document: AIComposerDocument;
+    selection: SelectionState;
+    /** Aborted when a newer keystroke superseded this search. */
+    signal?: AbortSignal;
+}
+export interface TriggerSelectContext {
+    editor: AIComposer;
+    document: AIComposerDocument;
+    /** Text node index containing the trigger run. */
+    nodeIndex: number;
+    /** Offset of the trigger character. */
+    triggerOffset: number;
+    /** Offset where the query ends. */
+    endOffset: number;
+    query: string;
+    item: SuggestionItem;
+}
+export interface AIComposerTrigger {
+    id: string;
+    /** Character that activates the trigger, e.g. '@'. */
+    character: string;
+    /** Node type produced by the default select behavior ('mention' by default). */
+    type?: string;
+    /** Allow spaces inside the query (default false). */
+    allowSpaces?: boolean;
+    /** Allow the trigger character mid-word, e.g. "user@x" (default false). */
+    allowMidWord?: boolean;
+    /** Provide suggestions for the current query. */
+    search(context: TriggerSearchContext): SuggestionItem[] | Promise<SuggestionItem[]>;
+    /**
+     * Handle selection. When omitted, the trigger run is replaced with an
+     * atomic node built from the item (see createNodeFromSuggestion).
+     */
+    select?(item: SuggestionItem, context: TriggerSelectContext): void;
+}
+export interface TriggerRegistry {
+    register(trigger: AIComposerTrigger): Unsubscribe;
+    get(id: string): AIComposerTrigger | undefined;
+    list(): AIComposerTrigger[];
+    clear(): void;
+}
+export declare function createTriggerRegistry(): TriggerRegistry;
+/** Build the atomic node a trigger inserts for a chosen suggestion. */
+export declare function createNodeFromSuggestion(trigger: AIComposerTrigger, item: SuggestionItem): AIComposerNode;
+/** Narrow host surface the engine needs from the editor (keeps the engine testable). */
+export interface TriggerHost {
+    readonly editor: AIComposer;
+    readonly document: AIComposerDocument;
+    readonly selection: SelectionState;
+    readonly triggers: TriggerRegistry;
+    readonly events: AIComposerBus;
+    patchState(patch: {
+        activeTrigger?: TriggerState | null;
+        suggestions?: SuggestionItem[];
+        activeSuggestionIndex?: number;
+    }): void;
+    /** Replace the trigger run with nodes as one history step; caret lands after the run. */
+    replaceRun(state: TriggerState, nodes: AIComposerNode[], options?: {
+        trailingSpace?: boolean;
+        source?: 'api' | 'plugin' | 'user';
+    }): void;
+}
+export declare class TriggerEngine {
+    private readonly host;
+    private active;
+    private items;
+    private activeIndex;
+    private searchToken;
+    constructor(host: TriggerHost);
+    get activeTrigger(): TriggerState | null;
+    get suggestions(): SuggestionItem[];
+    get activeSuggestionIndex(): number;
+    /** Re-evaluate the trigger context after a document change. */
+    handleDocumentChange(): void;
+    handleSelectionChange(): void;
+    /** Move the highlighted suggestion (ArrowUp/ArrowDown). */
+    moveSelection(delta: number): void;
+    /** Accept a suggestion (click, Enter/Tab, or programmatic). */
+    accept(item?: SuggestionItem): Promise<void>;
+    /** Close the active trigger session. */
+    close(reason: 'select' | 'escape' | 'blur' | 'input' | 'manual' | 'editor-destroy'): void;
+    private evaluate;
+    private runSearch;
+    private setSuggestions;
+}
+/** Convenience factory used by tests and plugins to build triggers quickly. */
+export declare function defineTrigger(trigger: AIComposerTrigger): AIComposerTrigger;
+//# sourceMappingURL=engine.d.ts.map

package/dist/triggers/engine.d.ts.map

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