tiptap-apcore 0.1.0

package/dist/runtime/TiptapExecutor.d.ts

@@ -0,0 +1,20 @@
+import type { Executor, EditorLike } from "../types.js";
+import type { TiptapRegistry } from "./TiptapRegistry.js";
+import { AclGuard } from "../security/AclGuard.js";
+export type { EditorLike, ChainLike } from "../types.js";
+export declare class TiptapExecutor implements Executor {
+    readonly registry: TiptapRegistry;
+    private editor;
+    private aclGuard;
+    private sanitizeHtml;
+    constructor(editor: EditorLike, registry: TiptapRegistry, aclGuard: AclGuard, sanitizeHtml?: (html: string) => string);
+    call(moduleId: string, inputs: Record<string, unknown>): Promise<Record<string, unknown>>;
+    callAsync(moduleId: string, inputs: Record<string, unknown>): Promise<Record<string, unknown>>;
+    private extractCategory;
+    private extractCommandName;
+    private executeQuery;
+    private executeCommand;
+    private handleSelectText;
+    private buildArgs;
+}
+//# sourceMappingURL=TiptapExecutor.d.ts.map

package/dist/runtime/TiptapExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiptapExecutor.d.ts","sourceRoot":"","sources":["../../src/runtime/TiptapExecutor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAa,MAAM,aAAa,CAAC;AACnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAInD,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AA4DzD,qBAAa,cAAe,YAAW,QAAQ;IAC7C,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,YAAY,CAAyC;gBAG3D,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,cAAc,EACxB,QAAQ,EAAE,QAAQ,EAClB,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM;IAQnC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAuBzF,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAIpG,OAAO,CAAC,eAAe;IAMvB,OAAO,CAAC,kBAAkB;IAM1B,OAAO,CAAC,YAAY;IAmDpB,OAAO,CAAC,cAAc;IAyCtB,OAAO,CAAC,gBAAgB;IAsCxB,OAAO,CAAC,SAAS;CAiHlB"}

package/dist/runtime/TiptapExecutor.js

@@ -0,0 +1,327 @@
+import { TiptapModuleError, ErrorCodes } from "../errors/index.js";
+// ── URL safety (C-1) ──────────────────────────────────────────────
+const SAFE_PROTOCOLS = /^(https?|mailto|tel):/i;
+const SAFE_RELATIVE = /^[/#?]/;
+function isSafeUrl(url) {
+    if (typeof url !== "string")
+        return false;
+    const trimmed = url.trim();
+    return SAFE_PROTOCOLS.test(trimmed) || SAFE_RELATIVE.test(trimmed);
+}
+// ── Prototype pollution guard (C-2 + H-8) ─────────────────────────
+const FORBIDDEN_PROPS = new Set([
+    "__proto__",
+    "constructor",
+    "prototype",
+    "toString",
+    "valueOf",
+    "hasOwnProperty",
+]);
+// ── Input validation helpers (H-2) ────────────────────────────────
+function requireString(inputs, field, moduleId) {
+    const val = inputs[field];
+    if (typeof val !== "string" || val.length === 0) {
+        throw new TiptapModuleError(ErrorCodes.SCHEMA_VALIDATION_ERROR, `'${field}' must be a non-empty string`, { moduleId, field });
+    }
+    return val;
+}
+function requireNumber(inputs, field, moduleId) {
+    const val = inputs[field];
+    if (typeof val !== "number" || !Number.isFinite(val)) {
+        throw new TiptapModuleError(ErrorCodes.SCHEMA_VALIDATION_ERROR, `'${field}' must be a finite number`, { moduleId, field });
+    }
+    return val;
+}
+// ── Executor ──────────────────────────────────────────────────────
+export class TiptapExecutor {
+    registry;
+    editor;
+    aclGuard;
+    sanitizeHtml;
+    constructor(editor, registry, aclGuard, sanitizeHtml) {
+        this.editor = editor;
+        this.registry = registry;
+        this.aclGuard = aclGuard;
+        this.sanitizeHtml = sanitizeHtml;
+    }
+    async call(moduleId, inputs) {
+        // 1. Check editor ready
+        if (this.editor.isDestroyed) {
+            throw new TiptapModuleError(ErrorCodes.EDITOR_NOT_READY, "Editor is not ready", { editorDestroyed: true });
+        }
+        // 2. Resolve descriptor
+        const descriptor = this.registry.getDefinition(moduleId);
+        if (!descriptor) {
+            throw new TiptapModuleError(ErrorCodes.MODULE_NOT_FOUND, `Module '${moduleId}' not found`, { moduleId });
+        }
+        // 3. ACL check (throws ACL_DENIED)
+        this.aclGuard.check(moduleId, descriptor);
+        // 4. Route to handler
+        const category = this.extractCategory(moduleId);
+        if (category === "query") {
+            return this.executeQuery(moduleId, inputs);
+        }
+        return this.executeCommand(moduleId, inputs);
+    }
+    async callAsync(moduleId, inputs) {
+        return this.call(moduleId, inputs);
+    }
+    extractCategory(moduleId) {
+        // "tiptap.format.toggleBold" → "format"
+        const parts = moduleId.split(".");
+        return parts.length >= 2 ? parts[1] : "unknown";
+    }
+    extractCommandName(moduleId) {
+        // "tiptap.format.toggleBold" → "toggleBold"
+        const parts = moduleId.split(".");
+        return parts.length >= 3 ? parts[2] : moduleId;
+    }
+    executeQuery(moduleId, inputs) {
+        const commandName = this.extractCommandName(moduleId);
+        switch (commandName) {
+            case "getHTML":
+                return { html: this.editor.getHTML() };
+            case "getJSON":
+                return { json: this.editor.getJSON() };
+            case "getText": {
+                const options = {};
+                if (typeof inputs.blockSeparator === "string") {
+                    options.blockSeparator = inputs.blockSeparator;
+                }
+                return { text: this.editor.getText(options) };
+            }
+            case "isActive": {
+                const name = requireString(inputs, "name", moduleId);
+                return { active: this.editor.isActive(name, inputs.attrs ?? {}) };
+            }
+            case "getAttributes": {
+                const typeOrName = requireString(inputs, "typeOrName", moduleId);
+                return { attributes: this.editor.getAttributes(typeOrName) };
+            }
+            case "isEmpty":
+                return { value: this.editor.isEmpty };
+            case "isEditable":
+                return { value: this.editor.isEditable };
+            case "isFocused":
+                return { value: this.editor.isFocused };
+            case "getCharacterCount": {
+                const cc = this.editor.storage?.characterCount;
+                if (!cc || typeof cc.characters !== "function") {
+                    throw new TiptapModuleError(ErrorCodes.COMMAND_NOT_FOUND, "Character count extension not available", { moduleId, commandName });
+                }
+                return { count: cc.characters() };
+            }
+            case "getWordCount": {
+                const cc = this.editor.storage?.characterCount;
+                if (!cc || typeof cc.words !== "function") {
+                    throw new TiptapModuleError(ErrorCodes.COMMAND_NOT_FOUND, "Character count extension not available", { moduleId, commandName });
+                }
+                return { count: cc.words() };
+            }
+            default:
+                throw new TiptapModuleError(ErrorCodes.COMMAND_NOT_FOUND, `Command '${commandName}' not available on editor`, { moduleId, commandName });
+        }
+    }
+    executeCommand(moduleId, inputs) {
+        const commandName = this.extractCommandName(moduleId);
+        // Built-in: selectText — find text content and set selection
+        if (commandName === "selectText") {
+            return this.handleSelectText(inputs, moduleId);
+        }
+        // C-2 + H-8: Prototype pollution / arbitrary command guard
+        if (FORBIDDEN_PROPS.has(commandName)) {
+            throw new TiptapModuleError(ErrorCodes.COMMAND_NOT_FOUND, `Command '${commandName}' is not allowed`, { moduleId, commandName });
+        }
+        // Build chain: editor.chain().focus().<commandName>(...args).run()
+        const chain = this.editor.chain().focus();
+        const commandFn = chain[commandName];
+        if (typeof commandFn !== "function") {
+            throw new TiptapModuleError(ErrorCodes.COMMAND_NOT_FOUND, `Command '${commandName}' not available on editor`, { moduleId, commandName });
+        }
+        // Spread input arguments into the command
+        const args = this.buildArgs(commandName, inputs, moduleId);
+        const resultChain = commandFn.call(chain, ...args);
+        const success = resultChain.run();
+        if (!success) {
+            // undo/redo return false when history stack is empty — this is a normal
+            // condition (editor is recreated per request), not an execution error.
+            if (commandName === "undo" || commandName === "redo") {
+                return { success: false, reason: `Nothing to ${commandName}` };
+            }
+            throw new TiptapModuleError(ErrorCodes.COMMAND_FAILED, `Command '${commandName}' failed`, { moduleId, commandName });
+        }
+        return { success: true };
+    }
+    handleSelectText(inputs, moduleId) {
+        const text = requireString(inputs, "text", moduleId);
+        const occurrence = typeof inputs.occurrence === "number" ? Math.max(1, inputs.occurrence) : 1;
+        const doc = this.editor.state.doc;
+        let count = 0;
+        let foundFrom = -1;
+        let foundTo = -1;
+        doc.descendants((node, pos) => {
+            if (foundFrom >= 0)
+                return false;
+            if (node.isText && node.text) {
+                let searchFrom = 0;
+                while (searchFrom < node.text.length) {
+                    const idx = node.text.indexOf(text, searchFrom);
+                    if (idx === -1)
+                        break;
+                    count++;
+                    if (count === occurrence) {
+                        foundFrom = pos + idx;
+                        foundTo = foundFrom + text.length;
+                        return false;
+                    }
+                    searchFrom = idx + 1;
+                }
+            }
+        });
+        if (foundFrom < 0) {
+            return { found: false };
+        }
+        // Set text selection around the found text
+        const chain = this.editor.chain().focus();
+        chain.setTextSelection({ from: foundFrom, to: foundTo }).run();
+        return { found: true, from: foundFrom, to: foundTo };
+    }
+    buildArgs(commandName, inputs, moduleId) {
+        // Map input object fields to positional command arguments based on command name
+        // Most commands take 0 or 1 args
+        switch (commandName) {
+            // Commands with no args
+            case "toggleBold":
+            case "toggleItalic":
+            case "toggleStrike":
+            case "toggleCode":
+            case "toggleUnderline":
+            case "toggleSubscript":
+            case "toggleSuperscript":
+            case "toggleBulletList":
+            case "toggleOrderedList":
+            case "toggleTaskList":
+            case "toggleBlockquote":
+            case "unsetAllMarks":
+            case "clearNodes":
+            case "setHardBreak":
+            case "setHorizontalRule":
+            case "unsetLink":
+            case "selectAll":
+            case "selectParentNode":
+            case "selectTextblockStart":
+            case "selectTextblockEnd":
+            case "blur":
+            case "scrollIntoView":
+            case "undo":
+            case "redo":
+            case "deleteSelection":
+            case "deleteCurrentNode":
+            case "cut":
+            case "joinBackward":
+            case "joinForward":
+            case "setBold":
+            case "unsetBold":
+            case "setItalic":
+            case "unsetItalic":
+            case "setStrike":
+            case "unsetStrike":
+            case "setCode":
+            case "unsetCode":
+            case "setBlockquote":
+            case "unsetBlockquote":
+            case "setParagraph":
+            case "exitCode":
+                return [];
+            case "splitBlock":
+                return inputs.keepMarks !== undefined ? [{ keepMarks: inputs.keepMarks }] : [];
+            // Commands with single object arg
+            case "toggleHeading":
+                return [{ level: inputs.level }];
+            case "setHeading":
+                return [{ level: inputs.level }];
+            case "toggleHighlight":
+                return inputs.color ? [{ color: inputs.color }] : [];
+            case "toggleCodeBlock":
+                return inputs.language ? [{ language: inputs.language }] : [];
+            case "setTextAlign":
+                return [inputs.alignment];
+            case "setMark":
+                return [inputs.typeOrName, inputs.attrs ?? {}];
+            case "unsetMark":
+                return [inputs.typeOrName];
+            case "updateAttributes":
+                return [inputs.typeOrName, inputs.attrs];
+            case "setLink": {
+                // C-1: URL protocol validation
+                if (!isSafeUrl(inputs.href)) {
+                    throw new TiptapModuleError(ErrorCodes.SCHEMA_VALIDATION_ERROR, "Invalid or unsafe URL protocol", { field: "href" });
+                }
+                const linkAttrs = { href: inputs.href };
+                if (inputs.target !== undefined)
+                    linkAttrs.target = inputs.target;
+                if (inputs.rel !== undefined)
+                    linkAttrs.rel = inputs.rel;
+                return [linkAttrs];
+            }
+            // Content commands — H-1: sanitize HTML
+            case "insertContent": {
+                let value = inputs.value;
+                if (typeof value === "string" && this.sanitizeHtml) {
+                    value = this.sanitizeHtml(value);
+                }
+                return [value, inputs.options ?? {}];
+            }
+            case "insertContentAt": {
+                const position = requireNumber(inputs, "position", moduleId);
+                let value = inputs.value;
+                if (typeof value === "string" && this.sanitizeHtml) {
+                    value = this.sanitizeHtml(value);
+                }
+                return [position, value, inputs.options ?? {}];
+            }
+            case "setNode":
+                return [inputs.typeOrName, inputs.attrs ?? {}];
+            case "liftListItem":
+            case "sinkListItem":
+                return [inputs.typeOrName];
+            case "wrapIn":
+                return [inputs.typeOrName, inputs.attrs ?? {}];
+            case "lift":
+                return [inputs.typeOrName, inputs.attrs ?? {}];
+            case "splitListItem":
+                return [inputs.typeOrName, inputs.overrideAttrs ?? {}];
+            case "wrapInList":
+                return [inputs.typeOrName, inputs.attributes ?? {}];
+            case "toggleList":
+                return [inputs.listTypeOrName, inputs.itemTypeOrName, inputs.keepMarks ?? false, inputs.attributes ?? {}];
+            case "deleteNode":
+                return [inputs.typeOrName];
+            // Destructive commands
+            case "clearContent":
+                return inputs.emitUpdate !== undefined ? [inputs.emitUpdate] : [];
+            case "setContent": {
+                let value = inputs.value;
+                if (typeof value === "string" && this.sanitizeHtml) {
+                    value = this.sanitizeHtml(value);
+                }
+                return [value, inputs.emitUpdate ?? true, inputs.parseOptions ?? {}];
+            }
+            case "deleteRange":
+                return [{ from: inputs.from, to: inputs.to }];
+            // Selection commands
+            case "setTextSelection":
+                return [inputs.position];
+            case "setNodeSelection": {
+                const position = requireNumber(inputs, "position", moduleId);
+                return [position];
+            }
+            case "focus":
+                return inputs.position !== undefined ? [inputs.position] : [];
+            default:
+                // Unknown commands: pass all inputs as single object arg
+                return Object.keys(inputs).length > 0 ? [inputs] : [];
+        }
+    }
+}
+//# sourceMappingURL=TiptapExecutor.js.map

package/dist/runtime/TiptapExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiptapExecutor.js","sourceRoot":"","sources":["../../src/runtime/TiptapExecutor.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAKnE,qEAAqE;AAErE,MAAM,cAAc,GAAG,wBAAwB,CAAC;AAChD,MAAM,aAAa,GAAG,QAAQ,CAAC;AAE/B,SAAS,SAAS,CAAC,GAAY;IAC7B,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,cAAc,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,qEAAqE;AAErE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC;IAC9B,WAAW;IACX,aAAa;IACb,WAAW;IACX,UAAU;IACV,SAAS;IACT,gBAAgB;CACjB,CAAC,CAAC;AAEH,qEAAqE;AAErE,SAAS,aAAa,CACpB,MAA+B,EAC/B,KAAa,EACb,QAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAChD,MAAM,IAAI,iBAAiB,CACzB,UAAU,CAAC,uBAAuB,EAClC,IAAI,KAAK,8BAA8B,EACvC,EAAE,QAAQ,EAAE,KAAK,EAAE,CACpB,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,aAAa,CACpB,MAA+B,EAC/B,KAAa,EACb,QAAgB;IAEhB,MAAM,GAAG,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,iBAAiB,CACzB,UAAU,CAAC,uBAAuB,EAClC,IAAI,KAAK,2BAA2B,EACpC,EAAE,QAAQ,EAAE,KAAK,EAAE,CACpB,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,qEAAqE;AAErE,MAAM,OAAO,cAAc;IAChB,QAAQ,CAAiB;IAC1B,MAAM,CAAa;IACnB,QAAQ,CAAW;IACnB,YAAY,CAAyC;IAE7D,YACE,MAAkB,EAClB,QAAwB,EACxB,QAAkB,EAClB,YAAuC;QAEvC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,QAAgB,EAAE,MAA+B;QAC1D,wBAAwB;QACxB,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;YAC5B,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,gBAAgB,EAAE,qBAAqB,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;QAC7G,CAAC;QAED,wBAAwB;QACxB,MAAM,UAAU,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,gBAAgB,EAAE,WAAW,QAAQ,aAAa,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC;QAC3G,CAAC;QAED,mCAAmC;QACnC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAE1C,sBAAsB;QACtB,MAAM,QAAQ,GAAG,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;QAChD,IAAI,QAAQ,KAAK,OAAO,EAAE,CAAC;YACzB,OAAO,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QAC7C,CAAC;QACD,OAAO,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,QAAgB,EAAE,MAA+B;QAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACrC,CAAC;IAEO,eAAe,CAAC,QAAgB;QACtC,wCAAwC;QACxC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAClD,CAAC;IAEO,kBAAkB,CAAC,QAAgB;QACzC,4CAA4C;QAC5C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAClC,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACjD,CAAC;IAEO,YAAY,CAAC,QAAgB,EAAE,MAA+B;QACpE,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAEtD,QAAQ,WAAW,EAAE,CAAC;YACpB,KAAK,SAAS;gBACZ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACzC,KAAK,SAAS;gBACZ,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,CAAC;YACzC,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,MAAM,OAAO,GAAgC,EAAE,CAAC;gBAChD,IAAI,OAAO,MAAM,CAAC,cAAc,KAAK,QAAQ,EAAE,CAAC;oBAC9C,OAAO,CAAC,cAAc,GAAG,MAAM,CAAC,cAAc,CAAC;gBACjD,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAChD,CAAC;YACD,KAAK,UAAU,CAAC,CAAC,CAAC;gBAChB,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;gBACrD,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,MAAM,CAAC,KAAiC,IAAI,EAAE,CAAC,EAAE,CAAC;YACjG,CAAC;YACD,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,MAAM,UAAU,GAAG,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;gBACjE,OAAO,EAAE,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,EAAE,CAAC;YAC/D,CAAC;YACD,KAAK,SAAS;gBACZ,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACxC,KAAK,YAAY;gBACf,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC3C,KAAK,WAAW;gBACd,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YAC1C,KAAK,mBAAmB,CAAC,CAAC,CAAC;gBACzB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC;gBAC/C,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;oBAC/C,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,iBAAiB,EACtD,yCAAyC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;gBAC1E,CAAC;gBACD,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,UAAU,EAAY,EAAE,CAAC;YAC9C,CAAC;YACD,KAAK,cAAc,CAAC,CAAC,CAAC;gBACpB,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC;gBAC/C,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;oBAC1C,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,iBAAiB,EACtD,yCAAyC,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;gBAC1E,CAAC;gBACD,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,EAAY,EAAE,CAAC;YACzC,CAAC;YACD;gBACE,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,iBAAiB,EACtD,YAAY,WAAW,2BAA2B,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QACrF,CAAC;IACH,CAAC;IAEO,cAAc,CAAC,QAAgB,EAAE,MAA+B;QACtE,MAAM,WAAW,GAAG,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,CAAC;QAEtD,6DAA6D;QAC7D,IAAI,WAAW,KAAK,YAAY,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACjD,CAAC;QAED,2DAA2D;QAC3D,IAAI,eAAe,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,iBAAiB,EACtD,YAAY,WAAW,kBAAkB,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAC1E,CAAC;QAED,mEAAmE;QACnE,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC;QAC1C,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,CAAC,CAAC;QAErC,IAAI,OAAO,SAAS,KAAK,UAAU,EAAE,CAAC;YACpC,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,iBAAiB,EACtD,YAAY,WAAW,2BAA2B,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QACnF,CAAC;QAED,0CAA0C;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QAC3D,MAAM,WAAW,GAAG,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,CAAC;QACnD,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;QAElC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,wEAAwE;YACxE,uEAAuE;YACvE,IAAI,WAAW,KAAK,MAAM,IAAI,WAAW,KAAK,MAAM,EAAE,CAAC;gBACrD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,WAAW,EAAE,EAAE,CAAC;YACjE,CAAC;YACD,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,cAAc,EACnD,YAAY,WAAW,UAAU,EAAE,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC;QAClE,CAAC;QAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;IAC3B,CAAC;IAEO,gBAAgB,CAAC,MAA+B,EAAE,QAAgB;QACxE,MAAM,IAAI,GAAG,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;QACrD,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9F,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAClC,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;QACnB,IAAI,OAAO,GAAG,CAAC,CAAC,CAAC;QAEjB,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;YAC5B,IAAI,SAAS,IAAI,CAAC;gBAAE,OAAO,KAAK,CAAC;YACjC,IAAI,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;gBAC7B,IAAI,UAAU,GAAG,CAAC,CAAC;gBACnB,OAAO,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;oBACrC,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;oBAChD,IAAI,GAAG,KAAK,CAAC,CAAC;wBAAE,MAAM;oBACtB,KAAK,EAAE,CAAC;oBACR,IAAI,KAAK,KAAK,UAAU,EAAE,CAAC;wBACzB,SAAS,GAAG,GAAG,GAAG,GAAG,CAAC;wBACtB,OAAO,GAAG,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC;wBAClC,OAAO,KAAK,CAAC;oBACf,CAAC;oBACD,UAAU,GAAG,GAAG,GAAG,CAAC,CAAC;gBACvB,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;YAClB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QAC1B,CAAC;QAED,2CAA2C;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,CAAC;QAC1C,KAAK,CAAC,gBAAgB,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC;QAE/D,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;IACvD,CAAC;IAEO,SAAS,CAAC,WAAmB,EAAE,MAA+B,EAAE,QAAgB;QACtF,gFAAgF;QAChF,iCAAiC;QACjC,QAAQ,WAAW,EAAE,CAAC;YACpB,wBAAwB;YACxB,KAAK,YAAY,CAAC;YAAC,KAAK,cAAc,CAAC;YAAC,KAAK,cAAc,CAAC;YAAC,KAAK,YAAY,CAAC;YAC/E,KAAK,iBAAiB,CAAC;YAAC,KAAK,iBAAiB,CAAC;YAAC,KAAK,mBAAmB,CAAC;YACzE,KAAK,kBAAkB,CAAC;YAAC,KAAK,mBAAmB,CAAC;YAAC,KAAK,gBAAgB,CAAC;YACzE,KAAK,kBAAkB,CAAC;YAAC,KAAK,eAAe,CAAC;YAAC,KAAK,YAAY,CAAC;YACjE,KAAK,cAAc,CAAC;YAAC,KAAK,mBAAmB,CAAC;YAAC,KAAK,WAAW,CAAC;YAChE,KAAK,WAAW,CAAC;YAAC,KAAK,kBAAkB,CAAC;YAAC,KAAK,sBAAsB,CAAC;YACvE,KAAK,oBAAoB,CAAC;YAAC,KAAK,MAAM,CAAC;YAAC,KAAK,gBAAgB,CAAC;YAC9D,KAAK,MAAM,CAAC;YAAC,KAAK,MAAM,CAAC;YAAC,KAAK,iBAAiB,CAAC;YAAC,KAAK,mBAAmB,CAAC;YAC3E,KAAK,KAAK,CAAC;YAAC,KAAK,cAAc,CAAC;YAAC,KAAK,aAAa,CAAC;YACpD,KAAK,SAAS,CAAC;YAAC,KAAK,WAAW,CAAC;YAAC,KAAK,WAAW,CAAC;YAAC,KAAK,aAAa,CAAC;YACvE,KAAK,WAAW,CAAC;YAAC,KAAK,aAAa,CAAC;YAAC,KAAK,SAAS,CAAC;YAAC,KAAK,WAAW,CAAC;YACvE,KAAK,eAAe,CAAC;YAAC,KAAK,iBAAiB,CAAC;YAAC,KAAK,cAAc,CAAC;YAClE,KAAK,UAAU;gBACb,OAAO,EAAE,CAAC;YAEZ,KAAK,YAAY;gBACf,OAAO,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEjF,kCAAkC;YAClC,KAAK,eAAe;gBAClB,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACnC,KAAK,YAAY;gBACf,OAAO,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC;YACnC,KAAK,iBAAiB;gBACpB,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,KAAK,iBAAiB;gBACpB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,KAAK,cAAc;gBACjB,OAAO,CAAC,MAAM,CAAC,SAAmB,CAAC,CAAC;YACtC,KAAK,SAAS;gBACZ,OAAO,CAAC,MAAM,CAAC,UAAoB,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC3D,KAAK,WAAW;gBACd,OAAO,CAAC,MAAM,CAAC,UAAoB,CAAC,CAAC;YACvC,KAAK,kBAAkB;gBACrB,OAAO,CAAC,MAAM,CAAC,UAAoB,EAAE,MAAM,CAAC,KAAgC,CAAC,CAAC;YAChF,KAAK,SAAS,CAAC,CAAC,CAAC;gBACf,+BAA+B;gBAC/B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC5B,MAAM,IAAI,iBAAiB,CAAC,UAAU,CAAC,uBAAuB,EAC5D,gCAAgC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;gBACzD,CAAC;gBACD,MAAM,SAAS,GAA4B,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,CAAC;gBACjE,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;oBAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC;gBAClE,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS;oBAAE,SAAS,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC;gBACzD,OAAO,CAAC,SAAS,CAAC,CAAC;YACrB,CAAC;YAED,wCAAwC;YACxC,KAAK,eAAe,CAAC,CAAC,CAAC;gBACrB,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;gBACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACnD,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACvC,CAAC;YACD,KAAK,iBAAiB,CAAC,CAAC,CAAC;gBACvB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAC7D,IAAI,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;gBACzB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACnD,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YACjD,CAAC;YACD,KAAK,SAAS;gBACZ,OAAO,CAAC,MAAM,CAAC,UAAoB,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC3D,KAAK,cAAc,CAAC;YAAC,KAAK,cAAc;gBACtC,OAAO,CAAC,MAAM,CAAC,UAAoB,CAAC,CAAC;YACvC,KAAK,QAAQ;gBACX,OAAO,CAAC,MAAM,CAAC,UAAoB,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC3D,KAAK,MAAM;gBACT,OAAO,CAAC,MAAM,CAAC,UAAoB,EAAE,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;YAC3D,KAAK,eAAe;gBAClB,OAAO,CAAC,MAAM,CAAC,UAAoB,EAAE,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;YACnE,KAAK,YAAY;gBACf,OAAO,CAAC,MAAM,CAAC,UAAoB,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAChE,KAAK,YAAY;gBACf,OAAO,CAAC,MAAM,CAAC,cAAwB,EAAE,MAAM,CAAC,cAAwB,EAAE,MAAM,CAAC,SAAS,IAAI,KAAK,EAAE,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;YAChI,KAAK,YAAY;gBACf,OAAO,CAAC,MAAM,CAAC,UAAoB,CAAC,CAAC;YAEvC,uBAAuB;YACvB,KAAK,cAAc;gBACjB,OAAO,MAAM,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACpE,KAAK,YAAY,CAAC,CAAC,CAAC;gBAClB,IAAI,KAAK,GAAG,MAAM,CAAC,KAAe,CAAC;gBACnC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;oBACnD,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC;gBACD,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,UAAU,IAAI,IAAI,EAAE,MAAM,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC;YACvE,CAAC;YACD,KAAK,aAAa;gBAChB,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAEhD,qBAAqB;YACrB,KAAK,kBAAkB;gBACrB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC3B,KAAK,kBAAkB,CAAC,CAAC,CAAC;gBACxB,MAAM,QAAQ,GAAG,aAAa,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;gBAC7D,OAAO,CAAC,QAAQ,CAAC,CAAC;YACpB,CAAC;YACD,KAAK,OAAO;gBACV,OAAO,MAAM,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAEhE;gBACE,yDAAyD;gBACzD,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,CAAC;IACH,CAAC;CACF"}

package/dist/runtime/TiptapRegistry.d.ts

@@ -0,0 +1,35 @@
+import type { Registry, ModuleDescriptor } from "../types.js";
+/**
+ * TiptapRegistry implements the APCore Registry interface.
+ *
+ * Manages module descriptors with event-driven registration/unregistration
+ * and supports filtering by tags (OR logic) and/or prefix (startsWith).
+ */
+export declare class TiptapRegistry implements Registry {
+    private modules;
+    private handlers;
+    private scanFn;
+    register(descriptor: ModuleDescriptor): void;
+    unregister(moduleId: string): void;
+    list(options?: {
+        tags?: string[] | null;
+        prefix?: string | null;
+    }): string[];
+    getDefinition(moduleId: string): ModuleDescriptor | null;
+    has(moduleId: string): boolean;
+    /** Returns an iterator over [moduleId, descriptor] pairs. */
+    iter(): IterableIterator<[string, ModuleDescriptor]>;
+    /** Number of registered modules. */
+    get count(): number;
+    /** Array of all registered module IDs. */
+    get moduleIds(): string[];
+    /** Clears any internal caches (no-op for now, reserved for future use). */
+    clearCache(): void;
+    on(event: string, callback: (...args: unknown[]) => void): () => void;
+    off(event: string, callback: (...args: unknown[]) => void): void;
+    removeAllListeners(event?: string): void;
+    discover(): Promise<number>;
+    setScanFunction(fn: () => number | Promise<number>): void;
+    private emit;
+}
+//# sourceMappingURL=TiptapRegistry.d.ts.map

package/dist/runtime/TiptapRegistry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiptapRegistry.d.ts","sourceRoot":"","sources":["../../src/runtime/TiptapRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,cAAe,YAAW,QAAQ;IAC7C,OAAO,CAAC,OAAO,CAA4C;IAC3D,OAAO,CAAC,QAAQ,CACJ;IACZ,OAAO,CAAC,MAAM,CAAiD;IAE/D,QAAQ,CAAC,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAK5C,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKlC,IAAI,CAAC,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,MAAM,EAAE;IAyB5E,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI;IAIxD,GAAG,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAI9B,6DAA6D;IAC7D,IAAI,IAAI,gBAAgB,CAAC,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAIpD,oCAAoC;IACpC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,0CAA0C;IAC1C,IAAI,SAAS,IAAI,MAAM,EAAE,CAExB;IAED,2EAA2E;IAC3E,UAAU,IAAI,IAAI;IAKlB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,MAAM,IAAI;IAQrE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAOhE,kBAAkB,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI;IAQlC,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC;IAOjC,eAAe,CAAC,EAAE,EAAE,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,IAAI;IAIzD,OAAO,CAAC,IAAI;CAMb"}

package/dist/runtime/TiptapRegistry.js

@@ -0,0 +1,100 @@
+/**
+ * TiptapRegistry implements the APCore Registry interface.
+ *
+ * Manages module descriptors with event-driven registration/unregistration
+ * and supports filtering by tags (OR logic) and/or prefix (startsWith).
+ */
+export class TiptapRegistry {
+    modules = new Map();
+    handlers = new Map();
+    scanFn = null;
+    register(descriptor) {
+        this.modules.set(descriptor.moduleId, descriptor);
+        this.emit("register", descriptor.moduleId, descriptor);
+    }
+    unregister(moduleId) {
+        this.modules.delete(moduleId);
+        this.emit("unregister", moduleId);
+    }
+    list(options) {
+        let ids = Array.from(this.modules.keys());
+        if (!options) {
+            return ids;
+        }
+        const { tags, prefix } = options;
+        if (tags && tags.length > 0) {
+            ids = ids.filter((id) => {
+                const descriptor = this.modules.get(id);
+                const moduleTags = descriptor.tags ?? [];
+                // OR logic: module matches if it has ANY of the requested tags
+                return tags.some((tag) => moduleTags.includes(tag));
+            });
+        }
+        if (prefix) {
+            ids = ids.filter((id) => id.startsWith(prefix));
+        }
+        return ids;
+    }
+    getDefinition(moduleId) {
+        return this.modules.get(moduleId) ?? null;
+    }
+    has(moduleId) {
+        return this.modules.has(moduleId);
+    }
+    /** Returns an iterator over [moduleId, descriptor] pairs. */
+    iter() {
+        return this.modules.entries();
+    }
+    /** Number of registered modules. */
+    get count() {
+        return this.modules.size;
+    }
+    /** Array of all registered module IDs. */
+    get moduleIds() {
+        return Array.from(this.modules.keys());
+    }
+    /** Clears any internal caches (no-op for now, reserved for future use). */
+    clearCache() {
+        // TiptapRegistry has no caches currently; method provided for API parity
+        // with apcore-js Registry.
+    }
+    on(event, callback) {
+        if (!this.handlers.has(event)) {
+            this.handlers.set(event, []);
+        }
+        this.handlers.get(event).push(callback);
+        return () => this.off(event, callback);
+    }
+    off(event, callback) {
+        const callbacks = this.handlers.get(event);
+        if (!callbacks)
+            return;
+        const idx = callbacks.indexOf(callback);
+        if (idx !== -1)
+            callbacks.splice(idx, 1);
+    }
+    removeAllListeners(event) {
+        if (event) {
+            this.handlers.delete(event);
+        }
+        else {
+            this.handlers.clear();
+        }
+    }
+    async discover() {
+        if (this.scanFn) {
+            return this.scanFn();
+        }
+        return this.modules.size;
+    }
+    setScanFunction(fn) {
+        this.scanFn = fn;
+    }
+    emit(event, ...args) {
+        const callbacks = this.handlers.get(event);
+        if (callbacks) {
+            callbacks.forEach((cb) => cb(...args));
+        }
+    }
+}
+//# sourceMappingURL=TiptapRegistry.js.map

package/dist/runtime/TiptapRegistry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TiptapRegistry.js","sourceRoot":"","sources":["../../src/runtime/TiptapRegistry.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,OAAO,cAAc;IACjB,OAAO,GAAkC,IAAI,GAAG,EAAE,CAAC;IACnD,QAAQ,GACd,IAAI,GAAG,EAAE,CAAC;IACJ,MAAM,GAA4C,IAAI,CAAC;IAE/D,QAAQ,CAAC,UAA4B;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IACzD,CAAC;IAED,UAAU,CAAC,QAAgB;QACzB,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC9B,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,CAAC,OAA4D;QAC/D,IAAI,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;QAE1C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,GAAG,CAAC;QACb,CAAC;QAED,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAEjC,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5B,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE;gBACtB,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAE,CAAC;gBACzC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,IAAI,EAAE,CAAC;gBACzC,+DAA+D;gBAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC;YACtD,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,MAAM,EAAE,CAAC;YACX,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;QAClD,CAAC;QAED,OAAO,GAAG,CAAC;IACb,CAAC;IAED,aAAa,CAAC,QAAgB;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC;IAC5C,CAAC;IAED,GAAG,CAAC,QAAgB;QAClB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,6DAA6D;IAC7D,IAAI;QACF,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;IAChC,CAAC;IAED,oCAAoC;IACpC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,0CAA0C;IAC1C,IAAI,SAAS;QACX,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IACzC,CAAC;IAED,2EAA2E;IAC3E,UAAU;QACR,yEAAyE;QACzE,2BAA2B;IAC7B,CAAC;IAED,EAAE,CAAC,KAAa,EAAE,QAAsC;QACtD,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC/B,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACzC,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,QAAQ,CAAC,CAAC;IACzC,CAAC;IAED,GAAG,CAAC,KAAa,EAAE,QAAsC;QACvD,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,CAAC,SAAS;YAAE,OAAO;QACvB,MAAM,GAAG,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,GAAG,KAAK,CAAC,CAAC;YAAE,SAAS,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;IAC3C,CAAC;IAED,kBAAkB,CAAC,KAAc;QAC/B,IAAI,KAAK,EAAE,CAAC;YACV,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,QAAQ;QACZ,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC;IAC3B,CAAC;IAED,eAAe,CAAC,EAAkC;QAChD,IAAI,CAAC,MAAM,GAAG,EAAE,CAAC;IACnB,CAAC;IAEO,IAAI,CAAC,KAAa,EAAE,GAAG,IAAe;QAC5C,MAAM,SAAS,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC3C,IAAI,SAAS,EAAE,CAAC;YACd,SAAS,CAAC,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;QACzC,CAAC;IACH,CAAC;CACF"}

package/dist/runtime/index.d.ts

@@ -0,0 +1,3 @@
+export { TiptapRegistry } from "./TiptapRegistry.js";
+export { TiptapExecutor } from "./TiptapExecutor.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/runtime/index.js

@@ -0,0 +1,4 @@
+// Runtime layer - TiptapRegistry, TiptapExecutor (Tasks 6, 9)
+export { TiptapRegistry } from "./TiptapRegistry.js";
+export { TiptapExecutor } from "./TiptapExecutor.js";
+//# sourceMappingURL=index.js.map

package/dist/runtime/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/security/AclGuard.d.ts

@@ -0,0 +1,10 @@
+import type { AclConfig, Logger, ModuleDescriptor } from "../types.js";
+export declare class AclGuard {
+    private config;
+    private logger;
+    constructor(config?: AclConfig, logger?: Logger);
+    check(moduleId: string, descriptor: ModuleDescriptor): void;
+    isAllowed(moduleId: string, descriptor: ModuleDescriptor): boolean;
+    private getDenialReason;
+}
+//# sourceMappingURL=AclGuard.d.ts.map

package/dist/security/AclGuard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AclGuard.d.ts","sourceRoot":"","sources":["../../src/security/AclGuard.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AASvE,qBAAa,QAAQ;IACnB,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAqB;gBAEvB,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;IAK/C,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,IAAI;IAY3D,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,gBAAgB,GAAG,OAAO;IAwClE,OAAO,CAAC,eAAe;CAgDxB"}

package/dist/security/AclGuard.js

@@ -0,0 +1,96 @@
+import { TiptapModuleError, ErrorCodes } from "../errors/index.js";
+const ROLE_TAGS = {
+    readonly: ["query"],
+    editor: ["query", "format", "content", "history", "selection"],
+    admin: ["query", "format", "content", "destructive", "history", "selection"],
+};
+export class AclGuard {
+    config;
+    logger;
+    constructor(config, logger) {
+        this.config = config;
+        this.logger = logger;
+    }
+    check(moduleId, descriptor) {
+        if (!this.isAllowed(moduleId, descriptor)) {
+            const reason = this.getDenialReason(moduleId, descriptor);
+            this.logger?.warn(`ACL denied: ${moduleId}`, { reason });
+            throw new TiptapModuleError(ErrorCodes.ACL_DENIED, `Access denied: module '${moduleId}' is not permitted`, { moduleId });
+        }
+    }
+    isAllowed(moduleId, descriptor) {
+        // No ACL config = all allowed (opt-in security)
+        if (!this.config)
+            return true;
+        const { denyModules, allowModules, denyTags, allowTags, role } = this.config;
+        const moduleTags = descriptor.tags ?? [];
+        // 1. denyModules (highest precedence)
+        if (denyModules?.includes(moduleId))
+            return false;
+        // 2. allowModules
+        if (allowModules && allowModules.length > 0) {
+            if (allowModules.includes(moduleId))
+                return true;
+        }
+        // 3. denyTags
+        if (denyTags && denyTags.length > 0) {
+            if (moduleTags.some((t) => denyTags.includes(t)))
+                return false;
+        }
+        // 4. allowTags
+        if (allowTags && allowTags.length > 0) {
+            if (moduleTags.some((t) => allowTags.includes(t)))
+                return true;
+        }
+        // 5. Role-based
+        if (role) {
+            const roleTags = ROLE_TAGS[role];
+            if (!roleTags)
+                return false;
+            return moduleTags.some((t) => roleTags.includes(t));
+        }
+        // 6. If any allow-list is present, default to deny; otherwise permissive
+        const hasAllowList = (allowModules && allowModules.length > 0) ||
+            (allowTags && allowTags.length > 0);
+        return !hasAllowList;
+    }
+    getDenialReason(moduleId, descriptor) {
+        if (!this.config)
+            return "No ACL config";
+        const { denyModules, denyTags, allowTags, allowModules, role } = this.config;
+        const moduleTags = descriptor.tags ?? [];
+        // 1. denyModules
+        if (denyModules?.includes(moduleId)) {
+            return `Module '${moduleId}' is in the denyModules list`;
+        }
+        // 2. allowModules set but module not in it
+        if (allowModules && allowModules.length > 0) {
+            if (!allowModules.includes(moduleId)) {
+                return `Module '${moduleId}' is not in the allowModules list`;
+            }
+        }
+        // 3. denyTags
+        if (denyTags && denyTags.length > 0) {
+            const denied = moduleTags.filter((t) => denyTags.includes(t));
+            if (denied.length > 0) {
+                return `Module tags [${denied.join(", ")}] are in the denyTags list`;
+            }
+        }
+        // 4. allowTags set but no overlap
+        if (allowTags && allowTags.length > 0) {
+            if (!moduleTags.some((t) => allowTags.includes(t))) {
+                return `Module tags [${moduleTags.join(", ")}] are not in the allowTags list`;
+            }
+        }
+        // 5. Role-based denial
+        if (role) {
+            const roleTags = ROLE_TAGS[role];
+            if (!roleTags) {
+                return `Unknown role '${role}'`;
+            }
+            return `Role '${role}' does not permit tags [${moduleTags.join(", ")}]`;
+        }
+        return "Access denied by policy";
+    }
+}
+//# sourceMappingURL=AclGuard.js.map