@ai-composer/core 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

@@ -0,0 +1,6 @@
+# @ai-composer/core
+
+Framework-independent AI composition engine: model, state, events, commands, triggers, plugins, history, serialization.
+
+See [`docs/`](../../docs/README.md) for guides and API reference.
+

package/dist/commands/builtins.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Built-in commands. Plugins extend this set via
+ * their `commands` contribution.
+ */
+import type { Position } from '../model/selection';
+import type { AIComposerNode } from '../model/nodes';
+import type { SuggestionItem } from '../state/state';
+import type { AIComposer } from '../editor';
+import type { AIComposerCommand } from './registry';
+export declare const BUILTIN_COMMANDS: {
+    readonly submit: "submit";
+    readonly clear: "clear";
+    readonly undo: "undo";
+    readonly redo: "redo";
+    readonly insertText: "insertText";
+    readonly insertNode: "insertNode";
+    readonly focus: "focus";
+    readonly blur: "blur";
+    readonly openTrigger: "openTrigger";
+    readonly removeNode: "removeNode";
+    readonly acceptSuggestion: "acceptSuggestion";
+};
+export interface InsertTextPayload {
+    text: string;
+    at?: Position;
+}
+export interface InsertNodePayload {
+    node: AIComposerNode;
+    at?: Position;
+}
+export interface RemoveNodePayload {
+    key: string;
+}
+export interface OpenTriggerPayload {
+    triggerId: string;
+}
+export interface AcceptSuggestionPayload {
+    item?: SuggestionItem;
+}
+export declare function createBuiltinCommands(editor: AIComposer): AIComposerCommand[];
+//# sourceMappingURL=builtins.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"builtins.d.ts","sourceRoot":"","sources":["../../src/commands/builtins.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,eAAO,MAAM,gBAAgB;;;;;;;;;;;;CAYnB,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,cAAc,CAAC;IACrB,EAAE,CAAC,EAAE,QAAQ,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,cAAc,CAAC;CACvB;AAMD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,GAAG,iBAAiB,EAAE,CAyF7E"}

package/dist/commands/builtins.js

@@ -0,0 +1,116 @@
+/**
+ * Built-in commands. Plugins extend this set via
+ * their `commands` contribution.
+ */
+import { AIComposerError } from '../errors';
+export const BUILTIN_COMMANDS = {
+    submit: 'submit',
+    clear: 'clear',
+    undo: 'undo',
+    redo: 'redo',
+    insertText: 'insertText',
+    insertNode: 'insertNode',
+    focus: 'focus',
+    blur: 'blur',
+    openTrigger: 'openTrigger',
+    removeNode: 'removeNode',
+    acceptSuggestion: 'acceptSuggestion',
+};
+function payloadOf(payload) {
+    return payload;
+}
+export function createBuiltinCommands(editor) {
+    const commands = [
+        {
+            id: BUILTIN_COMMANDS.submit,
+            label: 'Submit',
+            canExecute: ({ state }) => !state.disabled && !state.readonly && !state.submitting,
+            execute: () => editor.submit(),
+        },
+        {
+            id: BUILTIN_COMMANDS.clear,
+            label: 'Clear',
+            canExecute: ({ state }) => !state.disabled && !state.readonly,
+            execute: () => editor.clear(),
+        },
+        {
+            id: BUILTIN_COMMANDS.undo,
+            label: 'Undo',
+            canExecute: ({ state }) => state.canUndo,
+            execute: () => editor.undo(),
+        },
+        {
+            id: BUILTIN_COMMANDS.redo,
+            label: 'Redo',
+            canExecute: ({ state }) => state.canRedo,
+            execute: () => editor.redo(),
+        },
+        {
+            id: BUILTIN_COMMANDS.insertText,
+            label: 'Insert text',
+            execute: (_context) => {
+                const payload = payloadOf(_context.payload);
+                if (!payload)
+                    throw new AIComposerError('UNKNOWN_COMMAND', 'insertText requires a payload');
+                if (typeof payload === 'string') {
+                    editor.insertText(payload);
+                }
+                else {
+                    editor.insertText(payload.text, payload.at);
+                }
+            },
+        },
+        {
+            id: BUILTIN_COMMANDS.insertNode,
+            label: 'Insert node',
+            execute: (_context) => {
+                const payload = payloadOf(_context.payload);
+                if (!payload?.node)
+                    throw new AIComposerError('UNKNOWN_COMMAND', 'insertNode requires { node }');
+                editor.insertNode(payload.node, { at: payload.at });
+            },
+        },
+        {
+            id: BUILTIN_COMMANDS.focus,
+            label: 'Focus',
+            execute: () => editor.focus(),
+        },
+        {
+            id: BUILTIN_COMMANDS.blur,
+            label: 'Blur',
+            execute: () => editor.blur(),
+        },
+        {
+            id: BUILTIN_COMMANDS.openTrigger,
+            label: 'Open trigger',
+            execute: (_context) => {
+                const payload = payloadOf(_context.payload);
+                const triggerId = typeof payload === 'string' ? payload : payload?.triggerId;
+                if (!triggerId)
+                    throw new AIComposerError('UNKNOWN_TRIGGER', 'openTrigger requires a triggerId');
+                editor.openTrigger(triggerId);
+            },
+        },
+        {
+            id: BUILTIN_COMMANDS.removeNode,
+            label: 'Remove node',
+            execute: (_context) => {
+                const payload = payloadOf(_context.payload);
+                const key = typeof payload === 'string' ? payload : payload?.key;
+                if (!key)
+                    throw new AIComposerError('UNKNOWN_COMMAND', 'removeNode requires a key');
+                editor.removeNode(key);
+            },
+        },
+        {
+            id: BUILTIN_COMMANDS.acceptSuggestion,
+            label: 'Accept suggestion',
+            execute: async (_context) => {
+                const payload = payloadOf(_context.payload);
+                await editor.acceptSuggestion(payload?.item);
+            },
+        },
+    ];
+    return commands;
+}
+//# sourceMappingURL=builtins.js.map

package/dist/commands/builtins.js.map

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

package/dist/commands/registry.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Command system — UI-independent named operations. Toolbars and keyboard
+ * shortcuts bind to command ids, never to implementation functions.
+ */
+import type { Unsubscribe } from '../events/event-bus';
+import type { AIComposer } from '../editor';
+import type { AIComposerState } from '../state/state';
+export interface CommandContext {
+    editor: AIComposer;
+    state: AIComposerState;
+    payload?: unknown;
+}
+export interface AIComposerCommand {
+    id: string;
+    label?: string;
+    execute(context: CommandContext): void | Promise<void>;
+    canExecute?(context: CommandContext): boolean;
+}
+export interface CommandRegistry {
+    register(command: AIComposerCommand): Unsubscribe;
+    get(id: string): AIComposerCommand | undefined;
+    has(id: string): boolean;
+    list(): AIComposerCommand[];
+    clear(): void;
+}
+export declare function createCommandRegistry(): CommandRegistry;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,KAAK,EAAE,eAAe,CAAC;IACvB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvD,UAAU,CAAC,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC;CAC/C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,OAAO,EAAE,iBAAiB,GAAG,WAAW,CAAC;IAClD,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IAC/C,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACzB,IAAI,IAAI,iBAAiB,EAAE,CAAC;IAC5B,KAAK,IAAI,IAAI,CAAC;CACf;AAED,wBAAgB,qBAAqB,IAAI,eAAe,CAsBvD"}

package/dist/commands/registry.js

@@ -0,0 +1,29 @@
+/**
+ * Command system — UI-independent named operations. Toolbars and keyboard
+ * shortcuts bind to command ids, never to implementation functions.
+ */
+export function createCommandRegistry() {
+    const commands = new Map();
+    return {
+        register(command) {
+            commands.set(command.id, command);
+            return () => {
+                if (commands.get(command.id) === command)
+                    commands.delete(command.id);
+            };
+        },
+        get(id) {
+            return commands.get(id);
+        },
+        has(id) {
+            return commands.has(id);
+        },
+        list() {
+            return [...commands.values()];
+        },
+        clear() {
+            commands.clear();
+        },
+    };
+}
+//# sourceMappingURL=registry.js.map

package/dist/commands/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/commands/registry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2BH,MAAM,UAAU,qBAAqB;IACnC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAC;IACtD,OAAO;QACL,QAAQ,CAAC,OAAO;YACd,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;YAClC,OAAO,GAAG,EAAE;gBACV,IAAI,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,OAAO;oBAAE,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;YACxE,CAAC,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,EAAE;YACJ,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,GAAG,CAAC,EAAE;YACJ,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI;YACF,OAAO,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAChC,CAAC;QACD,KAAK;YACH,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/editor.d.ts

@@ -0,0 +1,185 @@
+/**
+ * The editor engine (ADR-0001). `AIComposer` is the public, framework-neutral
+ * contract implemented by `AIComposerImpl` and created via
+ * `createAIComposer()`. It owns the document, selection, state, history,
+ * registries and the trigger engine — but no DOM.
+ */
+import { type Unsubscribe } from './events/event-bus';
+import type { ChangeSource, AIComposerBus, AIComposerEventMap, AIComposerEventType, TriggerCloseReason } from './events/events';
+import { type AIComposerDocument } from './model/document';
+import { type AIComposerNode } from './model/nodes';
+import { type DocumentRange, type Position, type SelectionState } from './model/selection';
+import type { AIComposerState, SuggestionItem, TriggerState } from './state/state';
+import { type CommandRegistry, type AIComposerCommand } from './commands/registry';
+import { type NodeDefinition, type NodeRegistry } from './nodes/registry';
+import { type AIComposerTrigger, type TriggerRegistry } from './triggers/engine';
+import { type PluginRegistry, type AIComposerPlugin } from './plugins/registry';
+import { type SerializationFormat, type Serializer, type SerializerRegistry } from './serialization/index';
+import type { AIComposerConfig, AIComposerOptions } from './types';
+/** Optional DOM/view handle attached by the DOM layer or an adapter. */
+export interface EditorView {
+    focus(): void;
+    blur(): void;
+    /** Re-render the document into the view. */
+    render?(): void;
+}
+export interface SetValueOptions {
+    source?: ChangeSource;
+    /** Record as an undo step (default true). */
+    history?: boolean;
+    label?: string;
+}
+export interface TransactionOptions {
+    label?: string;
+    source?: ChangeSource;
+    history?: boolean;
+}
+export interface InsertNodeOptions {
+    at?: Position;
+    /** Insert a trailing space and place the caret after it (default true). */
+    trailingSpace?: boolean;
+    source?: ChangeSource;
+}
+export type StateListener = (state: AIComposerState) => void;
+/**
+ * Public editor contract. Stable across framework adapters — if a method makes
+ * sense without a browser, it belongs here, not in an adapter.
+ */
+export interface AIComposer {
+    getValue(): AIComposerDocument;
+    setValue(value: AIComposerDocument | AIComposerNode[] | string, options?: SetValueOptions): void;
+    clear(): void;
+    /** Replace a range with nodes in a single history step. */
+    replaceRange(range: DocumentRange, nodes: AIComposerNode[], options?: {
+        trailingSpace?: boolean;
+        source?: ChangeSource;
+    }): void;
+    insertText(text: string, at?: Position): void;
+    insertNode(node: AIComposerNode, options?: InsertNodeOptions): void;
+    removeNode(key: string): void;
+    /** Reconcile a document parsed from the view (user typing). View-layer API. */
+    applyViewUpdate(next: AIComposerDocument, selection?: SelectionState): void;
+    getSelection(): SelectionState;
+    setSelection(selection: SelectionState): void;
+    focus(): void;
+    blur(): void;
+    /** Called by the attached view on native focus changes. View-layer API. */
+    setFocused(focused: boolean): void;
+    attachView(view: EditorView): Unsubscribe;
+    /** True once destroy() has run — adapters use this to rebuild safely. */
+    isDestroyed(): boolean;
+    destroy(): void;
+    submit(): Promise<void>;
+    undo(): void;
+    redo(): void;
+    /** Group mutations into one undo step. */
+    transaction(fn: () => void, options?: TransactionOptions): void;
+    readonly commands: CommandRegistry;
+    executeCommand(id: string, payload?: unknown): Promise<void>;
+    canExecuteCommand(id: string, payload?: unknown): boolean;
+    readonly triggers: TriggerRegistry;
+    getActiveTrigger(): TriggerState | null;
+    acceptSuggestion(item?: SuggestionItem): Promise<void>;
+    moveSuggestionSelection(delta: number): void;
+    closeTrigger(reason?: TriggerCloseReason): void;
+    /** Insert a trigger character at the caret, opening its suggestion session. */
+    openTrigger(triggerId: string): void;
+    readonly nodes: NodeRegistry;
+    readonly serializers: SerializerRegistry;
+    readonly pluginRegistry: PluginRegistry;
+    registerPlugin(plugin: AIComposerPlugin): Unsubscribe;
+    registerTrigger(trigger: AIComposerTrigger): Unsubscribe;
+    registerCommand(command: AIComposerCommand): Unsubscribe;
+    registerNodeType(definition: NodeDefinition): Unsubscribe;
+    registerSerializer(serializer: Serializer): Unsubscribe;
+    on<K extends AIComposerEventType>(type: K, handler: (event: AIComposerEventMap[K]) => void): Unsubscribe;
+    once<K extends AIComposerEventType>(type: K, handler: (event: AIComposerEventMap[K]) => void): Unsubscribe;
+    off<K extends AIComposerEventType>(type: K, handler: (event: AIComposerEventMap[K]) => void): void;
+    getState(): AIComposerState;
+    subscribe(listener: StateListener): Unsubscribe;
+    getConfig(): AIComposerConfig;
+    configure(patch: Partial<AIComposerOptions>): void;
+    setMode(mode: string): void;
+    setDisabled(disabled: boolean): void;
+    setReadonly(readonly: boolean): void;
+    serialize(format: SerializationFormat): unknown;
+}
+export declare class AIComposerImpl implements AIComposer {
+    readonly events: AIComposerBus;
+    readonly commands: CommandRegistry;
+    readonly triggers: TriggerRegistry;
+    readonly nodes: NodeRegistry;
+    readonly serializers: SerializerRegistry;
+    readonly pluginRegistry: PluginRegistry;
+    private readonly triggerEngine;
+    private readonly history;
+    private config;
+    private document;
+    private selection;
+    private focused;
+    private submitting;
+    private destroyed;
+    private mutationDepth;
+    private view;
+    private stateListeners;
+    private stateCache;
+    constructor(options?: AIComposerOptions);
+    getValue(): AIComposerDocument;
+    setValue(value: AIComposerDocument | AIComposerNode[] | string, options?: SetValueOptions): void;
+    clear(): void;
+    replaceRange(range: DocumentRange, nodes: AIComposerNode[], options?: {
+        trailingSpace?: boolean;
+        source?: ChangeSource;
+    }): void;
+    insertText(text: string, at?: Position): void;
+    insertNode(node: AIComposerNode, options?: InsertNodeOptions): void;
+    removeNode(key: string): void;
+    applyViewUpdate(next: AIComposerDocument, selection?: SelectionState): void;
+    getSelection(): SelectionState;
+    setSelection(selection: SelectionState): void;
+    focus(): void;
+    blur(): void;
+    setFocused(focused: boolean): void;
+    attachView(view: EditorView): Unsubscribe;
+    destroy(): void;
+    isDestroyed(): boolean;
+    submit(): Promise<void>;
+    undo(): void;
+    redo(): void;
+    transaction(fn: () => void, options?: TransactionOptions): void;
+    executeCommand(id: string, payload?: unknown): Promise<void>;
+    canExecuteCommand(id: string, payload?: unknown): boolean;
+    getActiveTrigger(): TriggerState | null;
+    acceptSuggestion(item?: SuggestionItem): Promise<void>;
+    moveSuggestionSelection(delta: number): void;
+    closeTrigger(reason?: TriggerCloseReason): void;
+    openTrigger(triggerId: string): void;
+    registerPlugin(plugin: AIComposerPlugin): Unsubscribe;
+    registerTrigger(trigger: AIComposerTrigger): Unsubscribe;
+    registerCommand(command: AIComposerCommand): Unsubscribe;
+    registerNodeType(definition: NodeDefinition): Unsubscribe;
+    registerSerializer(serializer: Serializer): Unsubscribe;
+    on<K extends AIComposerEventType>(type: K, handler: (event: AIComposerEventMap[K]) => void): Unsubscribe;
+    once<K extends AIComposerEventType>(type: K, handler: (event: AIComposerEventMap[K]) => void): Unsubscribe;
+    off<K extends AIComposerEventType>(type: K, handler: (event: AIComposerEventMap[K]) => void): void;
+    getState(): AIComposerState;
+    subscribe(listener: StateListener): Unsubscribe;
+    getConfig(): AIComposerConfig;
+    configure(patch: Partial<AIComposerOptions>): void;
+    setMode(mode: string): void;
+    setDisabled(disabled: boolean): void;
+    setReadonly(readonly: boolean): void;
+    serialize(format: SerializationFormat): unknown;
+    private assertAlive;
+    private deleteSelectionIfNeeded;
+    private mutate;
+    private commit;
+    private restore;
+    private invalidateState;
+    private notify;
+    private createTriggerHost;
+    private createPluginContext;
+}
+/** Runtime guard for values claimed to be editors (useful in adapters). */
+export declare function isAIComposer(value: unknown): value is AIComposer;
+//# sourceMappingURL=editor.d.ts.map

package/dist/editor.d.ts.map

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