@notectl/core 1.7.3 → 2.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 notectl contributors
+
+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

@@ -15,7 +15,7 @@ React, Vue, Angular, Svelte, or plain HTML. Zero config, full power.
 [![Web Component](https://img.shields.io/badge/Web_Component-%3Cnotectl--editor%3E-purple)](https://developer.mozilla.org/en-US/docs/Web/API/Web_components)
 [![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
 [![npm](https://img.shields.io/npm/v/@notectl/core)](https://www.npmjs.com/package/@notectl/core)
-[![Bundle Size](https://img.shields.io/badge/core-29kb-orange)](https://www.npmjs.com/package/@notectl/core)
+[![Bundle Size](https://img.shields.io/badge/gzip-~40kb-orange)](https://www.npmjs.com/package/@notectl/core)
 
 <br />
 
@@ -29,12 +29,30 @@ React, Vue, Angular, Svelte, or plain HTML. Zero config, full power.
 
 <br />
 
-## 30 seconds to a full editor
+## Quick Start
 
 ```bash
 npm install @notectl/core
 ```
 
+### Preset — full editor in 5 lines
+
+```ts
+import { createEditor, createFullPreset, ThemePreset } from '@notectl/core';
+
+const editor = await createEditor({
+  ...createFullPreset(),
+  theme: ThemePreset.Light,
+  placeholder: 'Start typing...',
+});
+
+document.body.appendChild(editor);
+```
+
+All 19 plugins, toolbar groups, and keyboard shortcuts — ready to go.
+
+### Custom — pick exactly what you need
+
 ```ts
 import {
   createEditor,
@@ -61,42 +79,40 @@ const editor = await createEditor({
 document.body.appendChild(editor);
 ```
 
-That's it. A production-ready editor in 16 lines. No build step required.
-
 <br />
 
-## Why teams choose notectl
+## Why notectl
 
 <table>
 <tr>
 <td width="50%">
 
-**Ship faster**
+**CSP-compliant — zero inline styles**
 
-One `<notectl-editor>` tag works in every framework. No wrapper libraries, no adapter boilerplate, no version lock-in.
+The only editor with a built-in CSP-safe rendering pipeline. All styles go through `adoptedStyleSheets` with reference-counted token management. Works with `style-src 'self'` — no `unsafe-inline` needed. ProseMirror, TipTap, Slate, Lexical, Quill all write inline styles.
 
 </td>
 <td width="50%">
 
-**Stay lean**
+**One dependency**
 
-34 KB core. One runtime dependency (DOMPurify). Every feature is a plugin — bundle only what you use.
+The entire editor — state engine, reconciler, plugin system, toolbar, undo/redo, selection sync — is built from scratch with a single production dependency (DOMPurify for HTML sanitization). Tree-shakeable plugin architecture: bundle only what you use.
 
 </td>
 </tr>
 <tr>
 <td>
 
-**Accessible out of the box**
+**True Web Component**
 
-Full keyboard navigation, ARIA roles, screen reader announcements, focus management, high-contrast themes. Not an afterthought — it's the foundation.
+Shadow DOM encapsulation, reactive attributes, framework-agnostic by design. One `<notectl-editor>` tag works in React, Vue, Angular, Svelte, or plain HTML. No wrappers, no adapters, no version lock-in.
 
 </td>
 <td>
 
-**Built for control**
+**Plugin system with full lifecycle**
 
-Immutable state, step-based transactions, time-travel undo/redo. Every change is traceable, testable, and invertible.
+Dependency-resolved initialization (topological sort), per-plugin teardown tracking, type-safe inter-plugin services via `ServiceKey<T>`, priority-ordered middleware, error isolation. Plugins can't crash the editor or leak memory.
 
 </td>
 </tr>
@@ -104,43 +120,56 @@ Immutable state, step-based transactions, time-travel undo/redo. Every change is
 
 <br />
 
-## Plugin ecosystem
+## Plugin Ecosystem
 
-Every capability is a plugin. Compose exactly the editor you need — nothing more, nothing less.
+Every capability is a plugin. Compose exactly the editor you need.
 
 | Plugin | What you get |
 |---|---|
 | **TextFormattingPlugin** | Bold, italic, underline |
 | **StrikethroughPlugin** | ~~Strikethrough~~ text |
-| **HeadingPlugin** | H1 – H6 headings |
+| **SuperSubPlugin** | Superscript and subscript |
+| **HeadingPlugin** | H1 – H6 headings with block type picker |
 | **BlockquotePlugin** | Block quotes |
 | **ListPlugin** | Bullet, ordered, and checklists |
 | **LinkPlugin** | Hyperlink insertion and editing |
 | **TablePlugin** | Full table support with row/column controls |
 | **CodeBlockPlugin** | Code blocks with syntax highlighting |
+| **ImagePlugin** | Image upload, resize, and drag-and-drop |
 | **TextColorPlugin** | Text color picker |
 | **HighlightPlugin** | Text highlighting / background color |
 | **AlignmentPlugin** | Left, center, right, justify |
-| **FontPlugin** | Font family selection with custom fonts |
+| **FontPlugin** | Font family selection with custom web fonts |
 | **FontSizePlugin** | Configurable font sizes |
 | **HorizontalRulePlugin** | Horizontal dividers |
-| **SuperSubPlugin** | Superscript and subscript |
-| **PrintPlugin** | Print editor content with configurable options |
+| **PrintPlugin** | Print editor content with configurable paper sizes |
 
 See the [plugin documentation](https://samyssmile.github.io/notectl/plugins/overview/) for configuration and examples.
 
 <br />
 
+## Built-in Features
+
+- **Themes** — Dark and Light presets, or create fully custom themes
+- **i18n** — 8 languages: English, German, Spanish, French, Chinese, Russian, Arabic, Hindi + auto-detect via `Locale.BROWSER`
+- **Paper sizes** — DIN A4, DIN A5, US Letter, US Legal for WYSIWYG page layout
+- **CSP-compliant** — Style delivery via `adoptedStyleSheets`, no inline styles required
+- **Markdown shortcuts** — `#` → H1, `##` → H2, `-` → bullet list, `1.` → ordered list, `>` → blockquote
+- **Syntax highlighting** — Pluggable highlighter for code blocks
+
+<br />
+
 ## Content API
 
 Read and write content in any format:
 
 ```ts
-editor.getContentHTML();                                        // export as HTML
-editor.setContentHTML('<p>Hello <strong>world</strong></p>');    // import HTML
-editor.getJSON();                                        // structured JSON
-editor.getText();                                        // plain text
-editor.isEmpty();                                        // check if empty
+await editor.getContentHTML();                               // export as HTML
+editor.setContentHTML('<p>Hello <strong>world</strong></p>'); // import HTML
+editor.getJSON();                                            // structured JSON
+editor.setJSON(doc);                                         // import JSON
+editor.getText();                                            // plain text
+editor.isEmpty();                                            // check if empty
 ```
 
 <br />
@@ -150,12 +179,7 @@ editor.isEmpty();                                        // check if empty
 | | Framework | How |
 |---|---|---|
 | **Any** | Vanilla JS, React, Vue, Svelte | `<notectl-editor>` Web Component |
-| **Angular** | Angular 17+ | [`@notectl/angular`](https://www.npmjs.com/package/@notectl/angular) native integration |
-
-```bash
-git clone https://github.com/Samyssmile/notectl.git
-cd notectl && pnpm install && pnpm dev
-```
+| **Angular** | Angular 21+ | [`@notectl/angular`](https://www.npmjs.com/package/@notectl/angular) native integration |
 
 See [`examples/vanillajs`](examples/vanillajs) and [`examples/angular`](examples/angular) for full working demos.
 
@@ -164,7 +188,8 @@ See [`examples/vanillajs`](examples/vanillajs) and [`examples/angular`](examples
 ## Contributing
 
 ```bash
-pnpm install          # install dependencies
+git clone https://github.com/Samyssmile/notectl.git
+cd notectl && pnpm install
 pnpm build            # build all packages
 pnpm test             # run unit tests
 pnpm test:e2e         # run e2e tests

package/custom-elements.json

@@ -19,29 +19,187 @@
 							"kind": "field",
 							"name": "commands",
 							"type": {
-								"text": "{ toggleBold(): boolean | undefined; toggleItalic(): boolean | undefined; toggleUnderline(): boolean | undefined; undo(): void; redo(): void; selectAll(): void; }"
+								"text": "{ toggleBold(): boolean; toggleItalic(): boolean; toggleUnderline(): boolean; undo(): void; redo(): void; selectAll(): void; }"
 							},
 							"description": "Convenience accessors for common formatting commands.",
 							"readonly": true
 						},
+						{
+							"kind": "field",
+							"name": "isReadOnly",
+							"type": {
+								"text": "boolean"
+							},
+							"description": "Returns whether the editor is in read-only mode.",
+							"readonly": true
+						},
 						{
 							"kind": "method",
-							"name": "getHTML",
+							"name": "init",
 							"return": {
 								"type": {
-									"text": "string"
+									"text": "Promise<void>"
+								}
+							},
+							"parameters": [
+								{
+									"name": "config",
+									"optional": true,
+									"type": {
+										"text": "NotectlEditorConfig"
+									},
+									"description": "Optional editor configuration (plugins, theme, placeholder, etc.)."
+								}
+							],
+							"description": "Initializes the editor with the given config. Automatically called on connectedCallback, but can be called manually for deferred initialization."
+						},
+						{
+							"kind": "method",
+							"name": "whenReady",
+							"return": {
+								"type": {
+									"text": "Promise<void>"
+								}
+							},
+							"description": "Returns a promise that resolves when the editor is fully initialized and all plugins are ready."
+						},
+						{
+							"kind": "method",
+							"name": "configure",
+							"return": {
+								"type": {
+									"text": "void"
 								}
 							},
-							"description": "Returns sanitized HTML representation of the document."
+							"parameters": [
+								{
+									"name": "config",
+									"type": {
+										"text": "Partial<NotectlEditorConfig>"
+									},
+									"description": "Partial configuration to merge into the current editor config."
+								}
+							],
+							"description": "Updates configuration at runtime (e.g. placeholder, readonly, dir)."
 						},
 						{
 							"kind": "method",
-							"name": "setHTML",
+							"name": "registerPlugin",
 							"return": {
 								"type": {
 									"text": "void"
 								}
 							},
+							"parameters": [
+								{
+									"name": "plugin",
+									"type": {
+										"text": "Plugin"
+									},
+									"description": "A plugin instance to register."
+								}
+							],
+							"description": "Registers a plugin before initialization. Must be called before init() or DOM insertion."
+						},
+						{
+							"kind": "method",
+							"name": "configurePlugin",
+							"return": {
+								"type": {
+									"text": "void"
+								}
+							},
+							"parameters": [
+								{
+									"name": "pluginId",
+									"type": {
+										"text": "string"
+									},
+									"description": "The ID of the plugin to configure."
+								},
+								{
+									"name": "config",
+									"type": {
+										"text": "PluginConfig"
+									},
+									"description": "Configuration object to pass to the plugin."
+								}
+							],
+							"description": "Configures a plugin at runtime."
+						},
+						{
+							"kind": "method",
+							"name": "getService",
+							"return": {
+								"type": {
+									"text": "T | undefined"
+								}
+							},
+							"parameters": [
+								{
+									"name": "key",
+									"type": {
+										"text": "ServiceKey<T>"
+									},
+									"description": "Typed service key registered by a plugin."
+								}
+							],
+							"description": "Returns a registered plugin service by typed key."
+						},
+						{
+							"kind": "method",
+							"name": "onPluginEvent",
+							"return": {
+								"type": {
+									"text": "() => void"
+								}
+							},
+							"parameters": [
+								{
+									"name": "key",
+									"type": {
+										"text": "EventKey<T>"
+									},
+									"description": "Typed event key registered by a plugin."
+								},
+								{
+									"name": "callback",
+									"type": {
+										"text": "PluginEventCallback<T>"
+									},
+									"description": "Callback invoked when the event fires."
+								}
+							],
+							"description": "Subscribes to a plugin event. Returns an unsubscribe function."
+						},
+						{
+							"kind": "method",
+							"name": "getContentHTML",
+							"return": {
+								"type": {
+									"text": "Promise<string | ContentCSSResult>"
+								}
+							},
+							"parameters": [
+								{
+									"name": "options",
+									"optional": true,
+									"type": {
+										"text": "ContentHTMLOptions"
+									},
+									"description": "Options for HTML export. Pass { pretty: true } for formatted output, or { cssMode: 'classes' } for CSS class-based export returning a ContentCSSResult."
+								}
+							],
+							"description": "Returns sanitized HTML representation of the document. Supports pretty-printing and CSS class export for round-trip."
+						},
+						{
+							"kind": "method",
+							"name": "setContentHTML",
+							"return": {
+								"type": {
+									"text": "Promise<void>"
+								}
+							},
 							"parameters": [
 								{
 									"name": "html",
@@ -49,9 +207,17 @@
 										"text": "string"
 									},
 									"description": "HTML string to set as content."
+								},
+								{
+									"name": "options",
+									"optional": true,
+									"type": {
+										"text": "SetContentHTMLOptions"
+									},
+									"description": "Options for HTML import, including optional styleMap for class-based round-trip."
 								}
 							],
-							"description": "Sets the editor content from an HTML string (sanitized via DOMPurify)."
+							"description": "Sets the editor content from an HTML string (sanitized). Accepts optional styleMap for class-based round-trip."
 						},
 						{
 							"kind": "method",
@@ -102,6 +268,35 @@
 							},
 							"description": "Returns true if the editor contains only a single empty paragraph."
 						},
+						{
+							"kind": "method",
+							"name": "can",
+							"return": {
+								"type": {
+									"text": "{ toggleBold(): boolean; toggleItalic(): boolean; toggleUnderline(): boolean; undo(): boolean; redo(): boolean; selectAll(): boolean; }"
+								}
+							},
+							"description": "Returns an object with methods that check whether each built-in command can be executed in the current state."
+						},
+						{
+							"kind": "method",
+							"name": "canExecuteCommand",
+							"return": {
+								"type": {
+									"text": "boolean"
+								}
+							},
+							"parameters": [
+								{
+									"name": "name",
+									"type": {
+										"text": "string"
+									},
+									"description": "The name of a registered command."
+								}
+							],
+							"description": "Returns whether a named command (registered by a plugin) can be executed in the current state."
+						},
 						{
 							"kind": "method",
 							"name": "executeCommand",
@@ -121,6 +316,87 @@
 							],
 							"description": "Executes a named command registered by a plugin."
 						},
+						{
+							"kind": "method",
+							"name": "getState",
+							"return": {
+								"type": {
+									"text": "EditorState"
+								}
+							},
+							"description": "Returns the current immutable editor state."
+						},
+						{
+							"kind": "method",
+							"name": "dispatch",
+							"return": {
+								"type": {
+									"text": "void"
+								}
+							},
+							"parameters": [
+								{
+									"name": "tr",
+									"type": {
+										"text": "Transaction"
+									},
+									"description": "A transaction to apply. Routed through plugin middleware before application."
+								}
+							],
+							"description": "Dispatches a transaction (routed through middleware if any). Respects read-only mode."
+						},
+						{
+							"kind": "method",
+							"name": "on",
+							"return": {
+								"type": {
+									"text": "void"
+								}
+							},
+							"parameters": [
+								{
+									"name": "event",
+									"type": {
+										"text": "keyof EditorEventMap"
+									},
+									"description": "The event name ('ready', 'focus', 'blur', 'stateChange', 'selectionChange')."
+								},
+								{
+									"name": "callback",
+									"type": {
+										"text": "(payload: EditorEventMap[K]) => void"
+									},
+									"description": "Callback invoked when the event fires."
+								}
+							],
+							"description": "Registers a type-safe event listener."
+						},
+						{
+							"kind": "method",
+							"name": "off",
+							"return": {
+								"type": {
+									"text": "void"
+								}
+							},
+							"parameters": [
+								{
+									"name": "event",
+									"type": {
+										"text": "keyof EditorEventMap"
+									},
+									"description": "The event name."
+								},
+								{
+									"name": "callback",
+									"type": {
+										"text": "(payload: EditorEventMap[K]) => void"
+									},
+									"description": "The previously registered callback to remove."
+								}
+							],
+							"description": "Removes a previously registered event listener."
+						},
 						{
 							"kind": "method",
 							"name": "setTheme",
@@ -150,6 +426,16 @@
 							},
 							"description": "Returns the current theme setting."
 						},
+						{
+							"kind": "method",
+							"name": "getPaperSize",
+							"return": {
+								"type": {
+									"text": "PaperSize | undefined"
+								}
+							},
+							"description": "Returns the currently configured paper size, or undefined if using fluid layout."
+						},
 						{
 							"kind": "method",
 							"name": "destroy",
@@ -182,6 +468,20 @@
 								"text": "'light' | 'dark' | 'system'"
 							},
 							"description": "Sets the built-in theme preset. Defaults to 'light'."
+						},
+						{
+							"name": "paper-size",
+							"type": {
+								"text": "'din-a4' | 'din-a5' | 'us-letter' | 'us-legal'"
+							},
+							"description": "Sets a fixed paper size for WYSIWYG layout. Omit for fluid layout."
+						},
+						{
+							"name": "dir",
+							"type": {
+								"text": "'ltr' | 'rtl'"
+							},
+							"description": "Sets the document-level text direction."
 						}
 					],
 					"events": [
@@ -289,6 +589,50 @@
 						{
 							"name": "--notectl-focus-ring",
 							"description": "Focus ring color for keyboard navigation."
+						},
+						{
+							"name": "--notectl-toolbar-bg",
+							"description": "Toolbar background color. Defaults to --notectl-surface-raised."
+						},
+						{
+							"name": "--notectl-toolbar-border",
+							"description": "Toolbar border color. Defaults to --notectl-border."
+						},
+						{
+							"name": "--notectl-code-block-bg",
+							"description": "Code block background color. Defaults to --notectl-surface-raised."
+						},
+						{
+							"name": "--notectl-code-block-color",
+							"description": "Code block text color. Defaults to --notectl-fg."
+						},
+						{
+							"name": "--notectl-code-block-header-bg",
+							"description": "Code block header background color."
+						},
+						{
+							"name": "--notectl-code-block-header-color",
+							"description": "Code block header text color."
+						},
+						{
+							"name": "--notectl-code-block-header-border",
+							"description": "Code block header border color."
+						},
+						{
+							"name": "--notectl-tooltip-bg",
+							"description": "Tooltip background color. Defaults to --notectl-fg."
+						},
+						{
+							"name": "--notectl-tooltip-fg",
+							"description": "Tooltip foreground color. Defaults to --notectl-bg."
+						},
+						{
+							"name": "--notectl-content-min-height",
+							"description": "Minimum height of the content area. Defaults to 400px."
+						},
+						{
+							"name": "--notectl-paper-viewport-bg",
+							"description": "Background of the paper viewport when in paper mode."
 						}
 					]
 				},

package/dist/chunks/AttrRegistry-Ckj9eCHj.mjs

@@ -0,0 +1,2 @@
+import{o as n}from"./Document-HC8s50qJ.mjs";function t(n,t){return n.type===t}function e(n,t){return n.type===t}function r(t,e){return n(t)&&t.inlineType===e}export{e as a,t as b,r as i};
+//# sourceMappingURL=AttrRegistry-Ckj9eCHj.mjs.map

package/dist/chunks/AttrRegistry-Ckj9eCHj.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttrRegistry-Ckj9eCHj.mjs","sources":["../../src/model/AttrRegistry.ts"],"sourcesContent":["/**\n * Module-augmentable attribute registries for type-safe node/mark attributes.\n *\n * Plugins extend these interfaces via `declare module`:\n * @example\n * declare module '../../model/AttrRegistry.js' {\n *   interface NodeAttrRegistry {\n *     heading: { level: HeadingLevel; align?: BlockAlignment };\n *   }\n * }\n */\n\nimport type { BlockAlignment } from './BlockAlignment.js';\nimport type { BlockNode, InlineNode, Mark } from './Document.js';\nimport { isInlineNode } from './Document.js';\n\n/** Plugins augment this interface to register typed node attributes. */\nexport interface NodeAttrRegistry {\n\tparagraph: { align?: BlockAlignment };\n}\n\n/** Plugins augment this interface to register typed mark attributes. */\nexport interface MarkAttrRegistry {\n\tbold: Record<string, never>;\n\titalic: Record<string, never>;\n\tunderline: Record<string, never>;\n}\n\n/** Resolves typed attributes for known node types, falls back for unknown. */\nexport type NodeAttrsFor<T extends string> = T extends keyof NodeAttrRegistry\n\t? NodeAttrRegistry[T]\n\t: Record<string, string | number | boolean>;\n\n/** Resolves typed attributes for known mark types, falls back for unknown. */\nexport type MarkAttrsFor<T extends string> = T extends keyof MarkAttrRegistry\n\t? MarkAttrRegistry[T]\n\t: Record<string, string | number | boolean>;\n\n/** Narrows a BlockNode to a typed variant with known attributes. */\nexport function isNodeOfType<T extends keyof NodeAttrRegistry>(\n\tnode: BlockNode,\n\ttype: T,\n): node is BlockNode & { readonly type: T; readonly attrs: NodeAttrRegistry[T] } {\n\treturn (node.type as string) === type;\n}\n\n/** Narrows a Mark to a typed variant with known attributes. */\nexport function isMarkOfType<T extends keyof MarkAttrRegistry>(\n\tmark: Mark,\n\ttype: T,\n): mark is Mark & { readonly type: T; readonly attrs: MarkAttrRegistry[T] } {\n\treturn (mark.type as string) === type;\n}\n\n// --- InlineNode Attribute Registry ---\n\n/** Plugins augment this interface to register typed inline node attributes. */\n// biome-ignore lint/suspicious/noEmptyInterface: module augmentation requires interface\nexport interface InlineNodeAttrRegistry {}\n\n/** Resolves typed attributes for known inline node types, falls back for unknown. */\nexport type InlineNodeAttrsFor<T extends string> = T extends keyof InlineNodeAttrRegistry\n\t? InlineNodeAttrRegistry[T]\n\t: Record<string, string | number | boolean>;\n\n/** Narrows an InlineNode to a typed variant with known attributes. */\nexport function isInlineNodeOfType<T extends keyof InlineNodeAttrRegistry>(\n\tnode: InlineNode,\n\tinlineNodeType: T,\n): node is InlineNode & {\n\treadonly inlineType: T;\n\treadonly attrs: InlineNodeAttrRegistry[T];\n} {\n\treturn isInlineNode(node) && (node.inlineType as string) === inlineNodeType;\n}\n"],"names":["isNodeOfType","node","type","isMarkOfType","mark","isInlineNodeOfType","inlineNodeType","isInlineNode","inlineType"],"mappings":"4CAuCO,SAASA,EACfC,EACAC,GAEA,OAAQD,EAAKC,OAAoBA,CAClC,CAGO,SAASC,EACfC,EACAF,GAEA,OAAQE,EAAKF,OAAoBA,CAClC,CAcO,SAASG,EACfJ,EACAK,GAKA,OAAOC,EAAaN,IAAUA,EAAKO,aAA0BF,CAC9D"}

package/dist/chunks/AttributedMarkCommands-x7h4Xy7V.mjs

@@ -0,0 +1,2 @@
+import{a as t}from"./AttrRegistry-Ckj9eCHj.mjs";import{h as n,m as o,k as r,q as e}from"./Document-HC8s50qJ.mjs";import{j as s,i as c,s as i}from"./Selection-DhbizDM4.mjs";import{m as a}from"./TypeBrands-Bp_Z_o5Y.mjs";import{f as l}from"./RangeIterator-CprUbOWv.mjs";function f(t,o){const r=t.selection;if(!s(r))return null;const e=a(o.type);if(c(r)){const s=t.getBlock(r.anchor.blockId);if(!s)return null;const c=[...(t.storedMarks??n(s,r.anchor.offset)).filter(t=>t.type!==e),o];return t.transaction("command").setStoredMarks(c,t.storedMarks).setSelection(r).build()}const f=i(r,t.getBlockOrder()),u=t.transaction("command");return l(t,f,(n,r,s)=>{const c=t.getBlock(n);if(c){const t=k(c,e,r,s);t&&u.removeMark(n,r,s,t)}u.addMark(n,r,s,o)}),u.setSelection(r),u.build()}function u(t,r){const e=t.selection;if(!s(e))return null;if(c(e)){const s=t.getBlock(e.anchor.blockId);if(!s)return null;const c=t.storedMarks??n(s,e.anchor.offset);if(!o(c,r))return null;const i=c.filter(t=>t.type!==r);return t.transaction("command").setStoredMarks(i,t.storedMarks).setSelection(e).build()}const a=i(e,t.getBlockOrder()),f=t.transaction("command");return l(t,a,(n,o,e)=>{const s=t.getBlock(n),c=s?k(s,r,o,e):void 0;f.removeMark(n,o,e,c??{type:r})}),f.setSelection(e),f.build()}function m(o,r,e){const i=o.selection;if(!s(i))return null;if(c(i)&&o.storedMarks){const n=o.storedMarks.find(t=>t.type===r);return n&&t(n,r)?e(n):null}const a=o.getBlock(i.anchor.blockId);if(!a)return null;const l=n(a,i.anchor.offset).find(t=>t.type===r);return l&&t(l,r)?e(l):null}function d(t,n){return null!==m(t,n,()=>!0)}function k(t,n,o,s){const c=r(t);let i=0;for(const r of c){if(!e(r)){i+=1;continue}const t=i+r.text.length;if(t>o&&i<s){const t=r.marks.find(t=>t.type===n);if(t)return t}i=t}}export{f as a,m as g,d as i,u as r};
+//# sourceMappingURL=AttributedMarkCommands-x7h4Xy7V.mjs.map

package/dist/chunks/AttributedMarkCommands-x7h4Xy7V.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"AttributedMarkCommands-x7h4Xy7V.mjs","sources":["../../src/commands/AttributedMarkCommands.ts"],"sourcesContent":["/**\n * Generic helpers for attributed marks (marks with key/value attrs).\n *\n * Unlike boolean marks (`bold`, `italic`) that toggle on/off, attributed\n * marks (`font`, `fontSize`, `textColor`, `highlight`) carry data and use\n * **replace** semantics: applying a new value removes the old one first.\n *\n * These helpers extract the duplicated collapsed-vs-range branching that\n * was previously copy-pasted across ColorMarkOperations, FontSizeOperations,\n * and FontPlugin.\n */\n\nimport { isMarkOfType } from '../model/AttrRegistry.js';\nimport type { MarkAttrRegistry } from '../model/AttrRegistry.js';\nimport type { BlockNode, Mark, TextNode } from '../model/Document.js';\nimport {\n\tgetBlockMarksAtOffset,\n\tgetInlineChildren,\n\thasMark,\n\tisTextNode,\n} from '../model/Document.js';\nimport type { InlineNode } from '../model/Document.js';\nimport { isCollapsed, isTextSelection, selectionRange } from '../model/Selection.js';\nimport { markType } from '../model/TypeBrands.js';\nimport type { MarkTypeName } from '../model/TypeBrands.js';\nimport type { EditorState } from '../state/EditorState.js';\nimport type { Transaction } from '../state/Transaction.js';\nimport { forEachBlockInRange } from './RangeIterator.js';\n\n/**\n * Applies an attributed mark to the current selection.\n *\n * - **Collapsed cursor**: replaces stored marks (filters out old mark of the\n *   same type, appends the new one).\n * - **Range selection**: removes then re-adds the mark in every block span.\n *\n * Returns the built `Transaction`, or `null` when the selection is\n * unsupported (node-selection / gap-cursor) or the anchor block is missing.\n */\nexport function applyAttributedMark(state: EditorState, mark: Mark): Transaction | null {\n\tconst sel = state.selection;\n\tif (!isTextSelection(sel)) return null;\n\n\tconst typeName: MarkTypeName = markType(mark.type as string);\n\n\tif (isCollapsed(sel)) {\n\t\tconst anchorBlock = state.getBlock(sel.anchor.blockId);\n\t\tif (!anchorBlock) return null;\n\t\tconst currentMarks: readonly Mark[] =\n\t\t\tstate.storedMarks ?? getBlockMarksAtOffset(anchorBlock, sel.anchor.offset);\n\t\tconst withoutMark: readonly Mark[] = currentMarks.filter((m) => m.type !== typeName);\n\t\tconst newMarks: readonly Mark[] = [...withoutMark, mark];\n\n\t\treturn state\n\t\t\t.transaction('command')\n\t\t\t.setStoredMarks(newMarks, state.storedMarks)\n\t\t\t.setSelection(sel)\n\t\t\t.build();\n\t}\n\n\tconst range = selectionRange(sel, state.getBlockOrder());\n\tconst builder = state.transaction('command');\n\n\tforEachBlockInRange(state, range, (blockId, from, to) => {\n\t\tconst block: BlockNode | undefined = state.getBlock(blockId);\n\t\tif (block) {\n\t\t\tconst existing: Mark | undefined = findMarkInRange(block, typeName, from, to);\n\t\t\tif (existing) {\n\t\t\t\tbuilder.removeMark(blockId, from, to, existing);\n\t\t\t}\n\t\t}\n\t\tbuilder.addMark(blockId, from, to, mark);\n\t});\n\n\tbuilder.setSelection(sel);\n\treturn builder.build();\n}\n\n/**\n * Removes an attributed mark from the current selection.\n *\n * - **Collapsed cursor**: filters the mark out of stored marks.\n *   Returns `null` when the mark was not present.\n * - **Range selection**: removes the mark across all block spans.\n *\n * Returns the built `Transaction`, or `null` when the selection is\n * unsupported or the mark is absent at a collapsed cursor.\n */\nexport function removeAttributedMark(\n\tstate: EditorState,\n\tmarkTypeName: MarkTypeName,\n): Transaction | null {\n\tconst sel = state.selection;\n\tif (!isTextSelection(sel)) return null;\n\n\tif (isCollapsed(sel)) {\n\t\tconst anchorBlock = state.getBlock(sel.anchor.blockId);\n\t\tif (!anchorBlock) return null;\n\t\tconst currentMarks: readonly Mark[] =\n\t\t\tstate.storedMarks ?? getBlockMarksAtOffset(anchorBlock, sel.anchor.offset);\n\t\tif (!hasMark(currentMarks, markTypeName)) return null;\n\n\t\tconst newMarks: readonly Mark[] = currentMarks.filter((m) => m.type !== markTypeName);\n\t\treturn state\n\t\t\t.transaction('command')\n\t\t\t.setStoredMarks(newMarks, state.storedMarks)\n\t\t\t.setSelection(sel)\n\t\t\t.build();\n\t}\n\n\tconst range = selectionRange(sel, state.getBlockOrder());\n\tconst builder = state.transaction('command');\n\n\tforEachBlockInRange(state, range, (blockId, from, to) => {\n\t\tconst block: BlockNode | undefined = state.getBlock(blockId);\n\t\tconst existing: Mark | undefined = block\n\t\t\t? findMarkInRange(block, markTypeName, from, to)\n\t\t\t: undefined;\n\t\tbuilder.removeMark(blockId, from, to, existing ?? { type: markTypeName });\n\t});\n\n\tbuilder.setSelection(sel);\n\treturn builder.build();\n}\n\n/**\n * Extracts a typed attribute value from the mark at the current selection.\n *\n * Looks at stored marks (collapsed w/ stored), block marks at cursor offset\n * (collapsed w/o stored), or anchor-block marks (range).\n *\n * @param extractFn — Narrows the found mark and returns the desired value,\n *   or `null` when the mark's attrs don't match expectations.\n */\nexport function getMarkAttrAtSelection<K extends keyof MarkAttrRegistry, V>(\n\tstate: EditorState,\n\tmarkTypeName: K,\n\textractFn: (mark: Mark & { readonly type: K; readonly attrs: MarkAttrRegistry[K] }) => V | null,\n): V | null {\n\tconst sel = state.selection;\n\tif (!isTextSelection(sel)) return null;\n\n\tif (isCollapsed(sel) && state.storedMarks) {\n\t\tconst found = state.storedMarks.find((m) => (m.type as string) === markTypeName);\n\t\treturn found && isMarkOfType(found, markTypeName) ? extractFn(found) : null;\n\t}\n\n\tconst block = state.getBlock(sel.anchor.blockId);\n\tif (!block) return null;\n\tconst marks: readonly Mark[] = getBlockMarksAtOffset(block, sel.anchor.offset);\n\tconst found = marks.find((m) => (m.type as string) === markTypeName);\n\treturn found && isMarkOfType(found, markTypeName) ? extractFn(found) : null;\n}\n\n/**\n * Returns `true` when the given attributed mark type is present at the\n * current selection (collapsed or range).\n */\nexport function isAttributedMarkActive<K extends keyof MarkAttrRegistry>(\n\tstate: EditorState,\n\tmarkTypeName: K,\n): boolean {\n\treturn getMarkAttrAtSelection(state, markTypeName, () => true as const) !== null;\n}\n\n/**\n * Finds the first mark of the given type within an offset range of a block.\n *\n * Returns the full mark (including attrs) so callers can pass it to\n * `removeMark` for correct undo inversion, or `undefined` when absent.\n */\nfunction findMarkInRange(\n\tblock: BlockNode,\n\ttypeName: MarkTypeName,\n\tfrom: number,\n\tto: number,\n): Mark | undefined {\n\tconst children: readonly (TextNode | InlineNode)[] = getInlineChildren(block);\n\tlet pos = 0;\n\n\tfor (const child of children) {\n\t\tif (!isTextNode(child)) {\n\t\t\tpos += 1;\n\t\t\tcontinue;\n\t\t}\n\t\tconst nodeEnd: number = pos + child.text.length;\n\t\tif (nodeEnd > from && pos < to) {\n\t\t\tconst found: Mark | undefined = child.marks.find((m) => m.type === typeName);\n\t\t\tif (found) return found;\n\t\t}\n\t\tpos = nodeEnd;\n\t}\n\treturn undefined;\n}\n"],"names":["applyAttributedMark","state","mark","sel","selection","isTextSelection","typeName","markType","type","isCollapsed","anchorBlock","getBlock","anchor","blockId","newMarks","storedMarks","getBlockMarksAtOffset","offset","filter","m","transaction","setStoredMarks","setSelection","build","range","selectionRange","getBlockOrder","builder","forEachBlockInRange","from","to","block","existing","findMarkInRange","removeMark","addMark","removeAttributedMark","markTypeName","currentMarks","hasMark","getMarkAttrAtSelection","extractFn","found","find","isMarkOfType","isAttributedMarkActive","children","getInlineChildren","pos","child","isTextNode","nodeEnd","text","length","marks"],"mappings":"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"}