@notectl/core 1.0.4 → 1.0.6

package/dist/model/NodeResolver.d.ts

@@ -0,0 +1,36 @@
+import { BlockNode, Document } from './Document.js';
+/**
+ * Resolves a node in the document tree by its path (array of block IDs).
+ * The path traces the lineage from the root block down to the target.
+ */
+export declare function resolveNodeByPath(doc: Document, path: readonly string[]): BlockNode | undefined;
+/**
+ * Resolves the parent of a node at the given path.
+ * Returns the parent container (Document or BlockNode) and the child's index within it.
+ */
+export declare function resolveParentByPath(doc: Document, path: readonly string[]): {
+    parent: Document | BlockNode;
+    index: number;
+} | undefined;
+/**
+ * Finds the path (array of block IDs) to a node by its ID.
+ * Performs recursive DFS through the document tree.
+ */
+export declare function findNodePath(doc: Document, nodeId: string): string[] | undefined;
+/**
+ * Walks all block nodes in the document tree in depth-first order.
+ * Visits every BlockNode, including nested ones, with their full path.
+ */
+export declare function walkNodes(doc: Document, callback: (node: BlockNode, path: string[]) => void): void;
+/**
+ * Finds a block node by ID anywhere in the document tree (recursive DFS).
+ */
+export declare function findNode(doc: Document, nodeId: string): BlockNode | undefined;
+/**
+ * Finds a block node and returns it together with its path.
+ */
+export declare function findNodeWithPath(doc: Document, nodeId: string): {
+    node: BlockNode;
+    path: string[];
+} | undefined;
+//# sourceMappingURL=NodeResolver.d.ts.map

package/dist/model/NodeResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeResolver.d.ts","sourceRoot":"","sources":["../../src/model/NodeResolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,GAAG,SAAS,CAiB/F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAClC,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,SAAS,MAAM,EAAE,GACrB;IAAE,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAqB7D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAQhF;AAaD;;;GAGG;AACH,wBAAgB,SAAS,CACxB,GAAG,EAAE,QAAQ,EACb,QAAQ,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,IAAI,GACjD,IAAI,CAIN;AAeD;;GAEG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAO7E;AAYD;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,MAAM,GACZ;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,SAAS,CAMjD"}

package/dist/model/NodeSpec.d.ts

@@ -0,0 +1,67 @@
+import { NodeAttrsFor } from './AttrRegistry.js';
+import { BlockNode } from './Document.js';
+import { ParseRule } from './ParseRule.js';
+import { SanitizeConfig } from './SanitizeConfig.js';
+import { BlockId } from './TypeBrands.js';
+export interface AttrSpec {
+    readonly default?: string | number | boolean;
+}
+/** Describes a wrapper element that groups consecutive blocks of the same kind. */
+export interface WrapperSpec {
+    /** The HTML tag for the wrapper element (e.g., 'ul', 'ol'). */
+    readonly tag: string;
+    /** A key to group consecutive blocks. Blocks with the same key share a wrapper. */
+    readonly key: string;
+    /** Optional CSS class for the wrapper element. */
+    readonly className?: string;
+    /** Optional attributes for the wrapper element. */
+    readonly attrs?: Readonly<Record<string, string>>;
+}
+/** Describes which children a node type is allowed to contain. */
+export interface ContentRule {
+    /** Allowed child types or group names. */
+    readonly allow: readonly string[];
+    readonly min?: number;
+    readonly max?: number;
+}
+/** Creates an HTMLElement with the required `data-block-id` attribute. */
+export declare function createBlockElement(tag: string, blockId: BlockId): HTMLElement;
+export interface NodeSpec<T extends string = string> {
+    readonly type: T;
+    /** Renders the block to a DOM element. Must set `data-block-id` on the root. */
+    toDOM(node: Omit<BlockNode, 'attrs'> & {
+        readonly attrs: NodeAttrsFor<T>;
+    }): HTMLElement;
+    readonly attrs?: Readonly<Record<string, AttrSpec>>;
+    /** If true, the node contains no editable text (e.g. Image, HR). */
+    readonly isVoid?: boolean;
+    /** Content model: which children this node can contain. */
+    readonly content?: ContentRule;
+    /** Group membership: 'block' | 'inline' | custom. */
+    readonly group?: string;
+    /** If true, selection cannot cross this node's boundary (e.g. table_cell). */
+    readonly isolating?: boolean;
+    /** If true, node can be selected as an object via mouse interaction. */
+    readonly selectable?: boolean;
+    /**
+     * Mark types that are incompatible with this block type.
+     * When a block is converted to this type, marks listed here
+     * are stripped from the block's inline content.
+     */
+    readonly excludeMarks?: readonly string[];
+    /** Serializes the block to an HTML string. `content` is the pre-serialized inline children. */
+    readonly toHTML?: (node: BlockNode, content: string) => string;
+    /** Rules for matching HTML elements to this block type during parsing. */
+    readonly parseHTML?: readonly ParseRule[];
+    /** Tags and attributes this spec needs through DOMPurify sanitization. */
+    readonly sanitize?: SanitizeConfig;
+    /**
+     * If provided, the Reconciler groups consecutive blocks with the same
+     * wrapper key into a shared wrapper element. Useful for semantic list
+     * wrappers (`<ul>`, `<ol>`) around `<li>` block elements.
+     */
+    wrapper?(node: Omit<BlockNode, 'attrs'> & {
+        readonly attrs: NodeAttrsFor<T>;
+    }): WrapperSpec;
+}
+//# sourceMappingURL=NodeSpec.d.ts.map

package/dist/model/NodeSpec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NodeSpec.d.ts","sourceRoot":"","sources":["../../src/model/NodeSpec.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAC1D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC;CAC7C;AAED,mFAAmF;AACnF,MAAM,WAAW,WAAW;IAC3B,+DAA+D;IAC/D,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,mFAAmF;IACnF,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,kDAAkD;IAClD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,mDAAmD;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;CAClD;AAED,kEAAkE;AAClE,MAAM,WAAW,WAAW;IAC3B,0CAA0C;IAC1C,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,0EAA0E;AAC1E,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,WAAW,CAI7E;AAED,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAClD,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC;IACjB,gFAAgF;IAChF,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,WAAW,CAAC;IACzF,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;IACpD,oEAAoE;IACpE,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,2DAA2D;IAC3D,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC;IAC/B,qDAAqD;IACrD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,wEAAwE;IACxE,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,+FAA+F;IAC/F,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D,0EAA0E;IAC1E,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,SAAS,EAAE,CAAC;IAC1C,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACnC;;;;OAIG;IACH,OAAO,CAAC,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,EAAE,OAAO,CAAC,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,WAAW,CAAC;CAC5F"}

package/dist/model/ParseRule.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ParseRule: describes how an HTML element maps to a document node or mark.
+ * Used by plugins to declare their HTML parsing behavior.
+ */
+export interface ParseRule {
+    readonly tag: string;
+    readonly getAttrs?: (el: HTMLElement) => Record<string, unknown> | false;
+    /** Higher priority rules are matched first. Default: 50. */
+    readonly priority?: number;
+}
+//# sourceMappingURL=ParseRule.d.ts.map

package/dist/model/ParseRule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParseRule.d.ts","sourceRoot":"","sources":["../../src/model/ParseRule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,KAAK,CAAC;IACzE,4DAA4D;IAC5D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC3B"}

package/dist/model/SanitizeConfig.d.ts

@@ -0,0 +1,9 @@
+/**
+ * SanitizeConfig: declares which HTML tags and attributes a spec needs
+ * to survive DOMPurify sanitization.
+ */
+export interface SanitizeConfig {
+    readonly tags?: readonly string[];
+    readonly attrs?: readonly string[];
+}
+//# sourceMappingURL=SanitizeConfig.d.ts.map

package/dist/model/SanitizeConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SanitizeConfig.d.ts","sourceRoot":"","sources":["../../src/model/SanitizeConfig.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACnC"}

package/dist/model/Schema.d.ts

@@ -0,0 +1,17 @@
+import { NodeSpec } from './NodeSpec.js';
+import { SchemaRegistry } from './SchemaRegistry.js';
+export interface Schema {
+    readonly nodeTypes: readonly string[];
+    readonly markTypes: readonly string[];
+    /** Looks up the full NodeSpec for a given type. Available when created via schemaFromRegistry. */
+    readonly getNodeSpec?: (type: string) => NodeSpec | undefined;
+}
+/** Creates the default schema with paragraph nodes and bold/italic/underline marks. */
+export declare function defaultSchema(): Schema;
+/** Derives a Schema from a SchemaRegistry's registered specs. */
+export declare function schemaFromRegistry(registry: SchemaRegistry): Schema;
+/** Checks whether the given mark type is allowed by the schema. */
+export declare function isMarkAllowed(schema: Schema, markType: string): boolean;
+/** Checks whether the given node type is allowed by the schema. */
+export declare function isNodeTypeAllowed(schema: Schema, nodeType: string): boolean;
+//# sourceMappingURL=Schema.d.ts.map

package/dist/model/Schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../src/model/Schema.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,MAAM,WAAW,MAAM;IACtB,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,kGAAkG;IAClG,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,QAAQ,GAAG,SAAS,CAAC;CAC9D;AAED,uFAAuF;AACvF,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED,iEAAiE;AACjE,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,GAAG,MAAM,CAMnE;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEvE;AAED,mEAAmE;AACnE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE3E"}

package/dist/model/SchemaRegistry.d.ts

@@ -0,0 +1,81 @@
+import { InputRule } from '../input/InputRule.js';
+import { Keymap } from '../input/Keymap.js';
+import { BlockTypePickerEntry } from '../plugins/heading/BlockTypePickerEntry.js';
+import { ToolbarItem } from '../plugins/toolbar/ToolbarItem.js';
+import { NodeViewFactory } from '../view/NodeView.js';
+import { InlineNodeSpec } from './InlineNodeSpec.js';
+import { MarkSpec } from './MarkSpec.js';
+import { NodeSpec } from './NodeSpec.js';
+import { ParseRule } from './ParseRule.js';
+/** Handler for files pasted or dropped into the editor. */
+export type FileHandler = (files: readonly File[], position: import('./Selection.js').Position | null) => boolean | Promise<boolean>;
+export interface FileHandlerEntry {
+    readonly pattern: string;
+    readonly handler: FileHandler;
+}
+export declare class SchemaRegistry {
+    private readonly _nodeSpecs;
+    private readonly _markSpecs;
+    private readonly _inlineNodeSpecs;
+    private readonly _nodeViews;
+    private readonly _keymaps;
+    private readonly _inputRules;
+    private readonly _toolbarItems;
+    private readonly _toolbarItemPluginMap;
+    private readonly _fileHandlers;
+    private readonly _blockTypePickerEntries;
+    registerNodeSpec<T extends string>(spec: NodeSpec<T>): void;
+    getNodeSpec(type: string): NodeSpec | undefined;
+    removeNodeSpec(type: string): void;
+    getNodeTypes(): string[];
+    registerMarkSpec<T extends string>(spec: MarkSpec<T>): void;
+    getMarkSpec(type: string): MarkSpec | undefined;
+    removeMarkSpec(type: string): void;
+    getMarkTypes(): string[];
+    registerInlineNodeSpec<T extends string>(spec: InlineNodeSpec<T>): void;
+    getInlineNodeSpec(type: string): InlineNodeSpec | undefined;
+    removeInlineNodeSpec(type: string): void;
+    getInlineNodeTypes(): string[];
+    registerNodeView(type: string, factory: NodeViewFactory): void;
+    getNodeViewFactory(type: string): NodeViewFactory | undefined;
+    removeNodeView(type: string): void;
+    registerKeymap(keymap: Keymap): void;
+    getKeymaps(): readonly Keymap[];
+    removeKeymap(keymap: Keymap): void;
+    registerInputRule(rule: InputRule): void;
+    getInputRules(): readonly InputRule[];
+    removeInputRule(rule: InputRule): void;
+    registerToolbarItem(item: ToolbarItem, pluginId?: string): void;
+    getToolbarItemsByPlugin(pluginId: string): ToolbarItem[];
+    getToolbarItem(id: string): ToolbarItem | undefined;
+    getToolbarItems(): ToolbarItem[];
+    removeToolbarItem(id: string): void;
+    registerFileHandler(pattern: string, handler: FileHandler): void;
+    getFileHandlers(): readonly FileHandlerEntry[];
+    matchFileHandlers(mimeType: string): FileHandler[];
+    removeFileHandler(handler: FileHandler): void;
+    registerBlockTypePickerEntry(entry: BlockTypePickerEntry): void;
+    getBlockTypePickerEntries(): readonly BlockTypePickerEntry[];
+    removeBlockTypePickerEntry(id: string): void;
+    /** Returns all NodeSpec parseHTML rules, sorted by priority descending. */
+    getBlockParseRules(): readonly {
+        readonly rule: ParseRule;
+        readonly type: string;
+    }[];
+    /** Returns all InlineNodeSpec parseHTML rules, sorted by priority descending. */
+    getInlineParseRules(): readonly {
+        readonly rule: ParseRule;
+        readonly type: string;
+    }[];
+    /** Returns all MarkSpec parseHTML rules, sorted by priority descending. */
+    getMarkParseRules(): readonly {
+        readonly rule: ParseRule;
+        readonly type: string;
+    }[];
+    /** Returns all allowed HTML tags from base defaults + all spec sanitize configs. */
+    getAllowedTags(): string[];
+    /** Returns all allowed HTML attributes from base defaults + all spec sanitize configs. */
+    getAllowedAttrs(): string[];
+    clear(): void;
+}
+//# sourceMappingURL=SchemaRegistry.d.ts.map

package/dist/model/SchemaRegistry.d.ts.map

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

package/dist/model/Selection.d.ts

@@ -0,0 +1,52 @@
+import { BlockId } from './TypeBrands.js';
+export interface Position {
+    readonly blockId: BlockId;
+    readonly offset: number;
+    /** Path from root block to leaf block (optional, for nested structures). */
+    readonly path?: readonly BlockId[];
+}
+export interface Selection {
+    readonly anchor: Position;
+    readonly head: Position;
+}
+export interface SelectionRange {
+    readonly from: Position;
+    readonly to: Position;
+}
+/** A selection that selects an entire node (e.g. void blocks, table selection). */
+export interface NodeSelection {
+    readonly type: 'node';
+    readonly nodeId: BlockId;
+    readonly path: readonly BlockId[];
+}
+/** Union type representing either a text selection or a node selection. */
+export type EditorSelection = Selection | NodeSelection;
+/** Creates a NodeSelection for the given block. */
+export declare function createNodeSelection(nodeId: BlockId, path: readonly BlockId[]): NodeSelection;
+/** Type guard: returns true if the selection is a NodeSelection. */
+export declare function isNodeSelection(sel: EditorSelection): sel is NodeSelection;
+/** Type guard: returns true if the selection is a text Selection. */
+export declare function isTextSelection(sel: EditorSelection): sel is Selection;
+/** Compares two EditorSelections for equality. */
+export declare function selectionsEqual(a: EditorSelection, b: EditorSelection): boolean;
+/** Creates a Position, optionally with a path. */
+export declare function createPosition(blockId: BlockId, offset: number, path?: readonly BlockId[]): Position;
+/** Creates a selection with distinct anchor and head. */
+export declare function createSelection(anchor: Position, head: Position): Selection;
+/** Creates a collapsed selection (cursor) at the given position. */
+export declare function createCollapsedSelection(blockId: BlockId, offset: number): Selection;
+/** Returns true if the selection is collapsed (cursor with no range). NodeSelection is never collapsed. */
+export declare function isCollapsed(sel: EditorSelection): boolean;
+/**
+ * Returns true if the selection direction is forward (anchor before head).
+ * When anchor and head are in the same block, compares offsets.
+ * Cross-block ordering uses document order (not determinable here — caller provides block order).
+ * For NodeSelection, always returns true.
+ */
+export declare function isForward(sel: EditorSelection, blockOrder?: readonly BlockId[]): boolean;
+/**
+ * Returns a normalized range where `from` is always before `to`.
+ * Throws for NodeSelection — use isNodeSelection() guard first.
+ */
+export declare function selectionRange(sel: Selection, blockOrder?: readonly BlockId[]): SelectionRange;
+//# sourceMappingURL=Selection.d.ts.map

package/dist/model/Selection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Selection.d.ts","sourceRoot":"","sources":["../../src/model/Selection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,MAAM,WAAW,QAAQ;IACxB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,4EAA4E;IAC5E,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,QAAQ,CAAC,EAAE,EAAE,QAAQ,CAAC;CACtB;AAED,mFAAmF;AACnF,MAAM,WAAW,aAAa;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,SAAS,OAAO,EAAE,CAAC;CAClC;AAED,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GAAG,SAAS,GAAG,aAAa,CAAC;AAExD,mDAAmD;AACnD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,SAAS,OAAO,EAAE,GAAG,aAAa,CAE5F;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,GAAG,IAAI,aAAa,CAE1E;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,GAAG,EAAE,eAAe,GAAG,GAAG,IAAI,SAAS,CAEtE;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC,EAAE,eAAe,GAAG,OAAO,CAa/E;AAED,kDAAkD;AAClD,wBAAgB,cAAc,CAC7B,OAAO,EAAE,OAAO,EAChB,MAAM,EAAE,MAAM,EACd,IAAI,CAAC,EAAE,SAAS,OAAO,EAAE,GACvB,QAAQ,CAEV;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,GAAG,SAAS,CAE3E;AAED,oEAAoE;AACpE,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,CAGpF;AAED,2GAA2G;AAC3G,wBAAgB,WAAW,CAAC,GAAG,EAAE,eAAe,GAAG,OAAO,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,eAAe,EAAE,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,OAAO,CAWxF;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,GAAG,cAAc,CAK9F"}

package/dist/model/TypeBrands.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Branded (nominal) types for semantic string distinctions.
+ * Prevents accidental interchange of structurally identical IDs.
+ */
+declare const __brand: unique symbol;
+type Brand<T, B extends string> = T & {
+    readonly [__brand]: B;
+};
+/** Unique identifier for a block node in the document tree. */
+export type BlockId = Brand<string, 'BlockId'>;
+/** Semantic name for a node type (e.g. 'paragraph', 'heading'). */
+export type NodeTypeName = Brand<string, 'NodeTypeName'>;
+/** Semantic name for a mark type (e.g. 'bold', 'link'). */
+export type MarkTypeName = Brand<string, 'MarkTypeName'>;
+/** Unique identifier for a plugin. */
+export type PluginId = Brand<string, 'PluginId'>;
+/** Registered command name. */
+export type CommandName = Brand<string, 'CommandName'>;
+/** Semantic name for an inline node type (e.g. 'image', 'mention'). */
+export type InlineTypeName = Brand<string, 'InlineTypeName'>;
+export declare function blockId(id: string): BlockId;
+export declare function nodeType(name: string): NodeTypeName;
+export declare function markType(name: string): MarkTypeName;
+export declare function pluginId(id: string): PluginId;
+export declare function commandName(name: string): CommandName;
+export declare function inlineType(name: string): InlineTypeName;
+export {};
+//# sourceMappingURL=TypeBrands.d.ts.map

package/dist/model/TypeBrands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TypeBrands.d.ts","sourceRoot":"","sources":["../../src/model/TypeBrands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,CAAC,MAAM,OAAO,EAAE,OAAO,MAAM,CAAC;AACrC,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC,SAAS,MAAM,IAAI,CAAC,GAAG;IAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAEhE,+DAA+D;AAC/D,MAAM,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAE/C,mEAAmE;AACnE,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEzD,2DAA2D;AAC3D,MAAM,MAAM,YAAY,GAAG,KAAK,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;AAEzD,sCAAsC;AACtC,MAAM,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AAEjD,+BAA+B;AAC/B,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;AAEvD,uEAAuE;AACvE,MAAM,MAAM,cAAc,GAAG,KAAK,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;AAI7D,wBAAgB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAE3C;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEnD;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,CAEnD;AAED,wBAAgB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,CAE7C;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAErD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAEvD"}