@ai-composer/core 0.1.0

package/dist/triggers/engine.js

@@ -0,0 +1,235 @@
+/**
+ * Trigger system — detects trigger characters (`@`, `/`, `#`, `$`, `:` …)
+ * typed before the caret, runs the owning trigger's search, and manages the
+ * suggestion session in editor state.
+ */
+import { AIComposerError, toError } from '../errors';
+import { createCommandNode, createCustomNode, createMentionNode, createVariableNode, } from '../model/nodes';
+export function createTriggerRegistry() {
+    const triggers = new Map();
+    return {
+        register(trigger) {
+            triggers.set(trigger.id, trigger);
+            return () => {
+                if (triggers.get(trigger.id) === trigger)
+                    triggers.delete(trigger.id);
+            };
+        },
+        get(id) {
+            return triggers.get(id);
+        },
+        list() {
+            return [...triggers.values()];
+        },
+        clear() {
+            triggers.clear();
+        },
+    };
+}
+/** Build the atomic node a trigger inserts for a chosen suggestion. */
+export function createNodeFromSuggestion(trigger, item) {
+    const type = trigger.type ?? 'mention';
+    switch (type) {
+        case 'mention':
+            return createMentionNode({
+                id: item.id,
+                label: item.label,
+                ...(item.data ? { metadata: item.data } : {}),
+            });
+        case 'command':
+            return createCommandNode({
+                id: item.id,
+                label: item.label,
+                ...(item.data ? { metadata: item.data } : {}),
+            });
+        case 'variable':
+            return createVariableNode({ name: item.label, value: item.data?.value });
+        default:
+            return createCustomNode({
+                plugin: trigger.id,
+                nodeType: type,
+                data: item.data ?? { id: item.id, label: item.label },
+            });
+    }
+}
+const WORD_CHAR = /[\p{L}\p{N}_]/u;
+export class TriggerEngine {
+    host;
+    active = null;
+    items = [];
+    activeIndex = -1;
+    searchToken = 0;
+    constructor(host) {
+        this.host = host;
+    }
+    get activeTrigger() {
+        return this.active;
+    }
+    get suggestions() {
+        return this.items;
+    }
+    get activeSuggestionIndex() {
+        return this.activeIndex;
+    }
+    /** Re-evaluate the trigger context after a document change. */
+    handleDocumentChange() {
+        this.evaluate();
+    }
+    handleSelectionChange() {
+        this.evaluate();
+    }
+    /** Move the highlighted suggestion (ArrowUp/ArrowDown). */
+    moveSelection(delta) {
+        if (!this.active || this.items.length === 0)
+            return;
+        const next = (this.activeIndex + delta + this.items.length) % this.items.length;
+        this.setSuggestions(this.active.triggerId, this.items, next);
+    }
+    /** Accept a suggestion (click, Enter/Tab, or programmatic). */
+    async accept(item) {
+        const state = this.active;
+        if (!state)
+            return;
+        const trigger = this.host.triggers.get(state.triggerId);
+        if (!trigger) {
+            this.close('manual');
+            return;
+        }
+        const chosen = item ?? (this.activeIndex >= 0 ? this.items[this.activeIndex] : undefined) ?? this.items[0];
+        if (!chosen)
+            return;
+        const context = {
+            editor: this.host.editor,
+            document: this.host.document,
+            nodeIndex: state.nodeIndex,
+            triggerOffset: state.triggerOffset,
+            endOffset: state.endOffset,
+            query: state.query,
+            item: chosen,
+        };
+        this.close('select');
+        try {
+            if (trigger.select) {
+                await trigger.select(chosen, context);
+            }
+            else {
+                this.host.replaceRun(state, [createNodeFromSuggestion(trigger, chosen)], {
+                    trailingSpace: true,
+                    source: 'plugin',
+                });
+            }
+        }
+        catch (error) {
+            this.host.events.emit('error', { error: toError(error), phase: `trigger:${trigger.id}:select` });
+        }
+    }
+    /** Close the active trigger session. */
+    close(reason) {
+        const state = this.active;
+        if (!state)
+            return;
+        this.active = null;
+        this.items = [];
+        this.activeIndex = -1;
+        this.host.patchState({ activeTrigger: null, suggestions: [], activeSuggestionIndex: -1 });
+        this.host.events.emit('triggerClose', { triggerId: state.triggerId, reason });
+    }
+    evaluate() {
+        const document = this.host.document;
+        const selection = this.host.selection;
+        if (selection.anchor.nodeIndex !== selection.focus.nodeIndex ||
+            selection.anchor.offset !== selection.focus.offset) {
+            this.close('input');
+            return;
+        }
+        const node = document.nodes[selection.focus.nodeIndex];
+        if (!node || node.type !== 'text') {
+            this.close('input');
+            return;
+        }
+        const before = node.text.slice(0, selection.focus.offset);
+        let best = null;
+        for (const trigger of this.host.triggers.list()) {
+            const index = before.lastIndexOf(trigger.character);
+            if (index === -1)
+                continue;
+            const query = before.slice(index + 1);
+            if (query.includes('\n'))
+                continue;
+            if (!trigger.allowSpaces && /\s/.test(query))
+                continue;
+            if (!trigger.allowMidWord && index > 0 && WORD_CHAR.test(before[index - 1] ?? ''))
+                continue;
+            if (!best || index > best.state.triggerOffset) {
+                best = {
+                    trigger,
+                    state: {
+                        triggerId: trigger.id,
+                        query,
+                        nodeIndex: selection.focus.nodeIndex,
+                        triggerOffset: index,
+                        endOffset: selection.focus.offset,
+                    },
+                };
+            }
+        }
+        const previous = this.active;
+        if (!best) {
+            this.close('input');
+            return;
+        }
+        const changed = !previous ||
+            previous.triggerId !== best.state.triggerId ||
+            previous.query !== best.state.query ||
+            previous.nodeIndex !== best.state.nodeIndex ||
+            previous.triggerOffset !== best.state.triggerOffset;
+        this.active = best.state;
+        if (!previous || previous.triggerId !== best.trigger.id) {
+            this.host.events.emit('triggerOpen', { triggerId: best.trigger.id, query: best.state.query });
+        }
+        this.host.patchState({ activeTrigger: best.state });
+        if (changed) {
+            this.setSuggestions(best.state.triggerId, [], -1);
+            void this.runSearch(best.trigger, best.state);
+        }
+    }
+    async runSearch(trigger, state) {
+        const token = ++this.searchToken;
+        const controller = typeof AbortController !== 'undefined' ? new AbortController() : undefined;
+        try {
+            const results = await trigger.search({
+                query: state.query,
+                document: this.host.document,
+                selection: this.host.selection,
+                signal: controller?.signal,
+            });
+            if (token !== this.searchToken || this.active !== state)
+                return;
+            const items = (results ?? []).filter((item) => item && typeof item.id === 'string');
+            if (items.length === 0) {
+                this.setSuggestions(state.triggerId, [], -1);
+                return;
+            }
+            this.setSuggestions(state.triggerId, items, 0);
+        }
+        catch (error) {
+            if (token === this.searchToken) {
+                this.host.events.emit('error', { error: toError(error), phase: `trigger:${trigger.id}:search` });
+            }
+        }
+    }
+    setSuggestions(triggerId, items, activeIndex) {
+        this.items = items;
+        this.activeIndex = activeIndex;
+        this.host.patchState({ suggestions: items, activeSuggestionIndex: activeIndex });
+        this.host.events.emit('suggestionsChange', { triggerId: items.length ? triggerId : null, suggestions: items, activeIndex });
+    }
+}
+/** Convenience factory used by tests and plugins to build triggers quickly. */
+export function defineTrigger(trigger) {
+    if (!trigger.character || trigger.character.length !== 1) {
+        throw new AIComposerError('UNKNOWN_TRIGGER', `Trigger "${trigger.id}" must define a single character`);
+    }
+    return trigger;
+}
+//# sourceMappingURL=engine.js.map

package/dist/triggers/engine.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,37 @@
+/** Editor configuration types. */
+import type { AIComposerDocument } from './model/document';
+import type { AIComposerNode } from './model/nodes';
+import type { AIComposerPlugin } from './plugins/registry';
+import type { Serializer } from './serialization/serializers';
+import type { NodeDefinition } from './nodes/registry';
+import type { AIComposer } from './editor';
+import type { HistoryOptions } from './history/history';
+export type SubmitKey = 'enter' | 'shift-enter' | 'none';
+export interface SubmitConfig {
+    /** Async handler invoked by editor.submit(). */
+    onSubmit?(value: AIComposerDocument, editor: AIComposer): void | Promise<void>;
+    /** Clear the document after a successful submit (default false). */
+    clearOnSubmit?: boolean;
+    /** Allow submitting an empty document (default false). */
+    allowEmpty?: boolean;
+}
+export interface AIComposerConfig {
+    /** Presentation mode / preset name — 'default' | 'compact' | 'chat' | 'expanded' | custom. */
+    mode?: string;
+    placeholder?: string;
+    disabled?: boolean;
+    readonly?: boolean;
+    submit?: SubmitConfig;
+    submitKey?: SubmitKey;
+    history?: HistoryOptions;
+}
+export interface AIComposerOptions extends AIComposerConfig {
+    /** Initial value: document, node list or plain string. */
+    value?: AIComposerDocument | AIComposerNode[] | string;
+    plugins?: AIComposerPlugin[];
+    /** Extra/overriding node type definitions. */
+    nodeTypes?: NodeDefinition[];
+    /** Extra/overriding serializers. */
+    serializers?: Serializer[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,kCAAkC;AAElC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAC3C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAExD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,aAAa,GAAG,MAAM,CAAC;AAEzD,MAAM,WAAW,YAAY;IAC3B,gDAAgD;IAChD,QAAQ,CAAC,CAAC,KAAK,EAAE,kBAAkB,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,oEAAoE;IACpE,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,0DAA0D;IAC1D,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,8FAA8F;IAC9F,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAkB,SAAQ,gBAAgB;IACzD,0DAA0D;IAC1D,KAAK,CAAC,EAAE,kBAAkB,GAAG,cAAc,EAAE,GAAG,MAAM,CAAC;IACvD,OAAO,CAAC,EAAE,gBAAgB,EAAE,CAAC;IAC7B,8CAA8C;IAC9C,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,oCAAoC;IACpC,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;CAC5B"}

package/dist/types.js

@@ -0,0 +1,3 @@
+/** Editor configuration types. */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/utils/html.d.ts

@@ -0,0 +1,3 @@
+/** Escape a string for safe interpolation into HTML text/attribute contexts. */
+export declare function escapeHtml(value: string): string;
+//# sourceMappingURL=html.d.ts.map

package/dist/utils/html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/utils/html.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAOhD"}

package/dist/utils/html.js

@@ -0,0 +1,10 @@
+/** Escape a string for safe interpolation into HTML text/attribute contexts. */
+export function escapeHtml(value) {
+    return value
+        .replace(/&/g, '&')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+//# sourceMappingURL=html.js.map

package/dist/utils/html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/utils/html.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAChF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK;SACT,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC;SACvB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AAC5B,CAAC"}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "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"
+  }
+}

package/project.json

@@ -0,0 +1,56 @@
+{
+  "name": "core",
+  "$schema": "../node_modules/nx/schemas/project-schema.json",
+  "sourceRoot": "packages/core/src",
+  "projectType": "library",
+  "tags": [
+    "scope:core",
+    "type:lib"
+  ],
+  "targets": {
+    "build": {
+      "executor": "@nx/js:tsc",
+      "outputs": [
+        "{options.outputPath}"
+      ],
+      "options": {
+        "outputPath": "packages/core/dist",
+        "main": "packages/core/src/index.ts",
+        "tsConfig": "packages/core/tsconfig.lib.json",
+        "rootDir": "packages/core/src",
+        "assets": [
+          {
+            "input": "../packages/core",
+            "glob": "*.md",
+            "output": "."
+          }
+        ],
+        "generateExportsIfAbsent": false
+      }
+    },
+    "test": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "vitest run --project core"
+      }
+    },
+    "lint": {
+      "executor": "@nx/eslint:lint",
+      "outputs": [
+        "{options.outputFile}"
+      ],
+      "options": {
+        "lintFilePatterns": [
+          "packages/core/**/*.ts",
+          "packages/core/**/*.tsx"
+        ]
+      }
+    },
+    "typecheck": {
+      "executor": "nx:run-commands",
+      "options": {
+        "command": "tsc -p packages/core/tsconfig.spec.json --noEmit"
+      }
+    }
+  }
+}

package/src/commands/builtins.ts

@@ -0,0 +1,142 @@
+/**
+ * Built-in commands. Plugins extend this set via
+ * their `commands` contribution.
+ */
+
+import { AIComposerError } from '../errors';
+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 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',
+} as const;
+
+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;
+}
+
+function payloadOf<T>(payload: unknown): T {
+  return payload as T;
+}
+
+export function createBuiltinCommands(editor: AIComposer): AIComposerCommand[] {
+  const commands: AIComposerCommand[] = [
+    {
+      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<InsertTextPayload | string>(_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<InsertNodePayload>(_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<OpenTriggerPayload | string>(_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<RemoveNodePayload | string>(_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<AcceptSuggestionPayload | undefined>(_context.payload);
+        await editor.acceptSuggestion(payload?.item);
+      },
+    },
+  ];
+
+  return commands;
+}

package/src/commands/registry.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 function createCommandRegistry(): CommandRegistry {
+  const commands = new Map<string, AIComposerCommand>();
+  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();
+    },
+  };
+}