@notectl/angular 1.0.3 → 1.0.5

package/dist/fesm2022/notectl-angular-testing.mjs

@@ -0,0 +1,60 @@
+/**
+ * Test harness for `NotectlEditorComponent` in consumer tests.
+ *
+ * Wraps a `ComponentFixture` and provides convenience methods
+ * for common test operations.
+ *
+ * @example
+ * ```typescript
+ * const fixture = TestBed.createComponent(NotectlEditorComponent);
+ * const harness = new NotectlTestHarness(fixture);
+ * await harness.whenReady();
+ * harness.setHTML('<p>Hello</p>');
+ * expect(harness.getText()).toBe('Hello');
+ * ```
+ */
+class NotectlTestHarness {
+    fixture;
+    constructor(fixture) {
+        this.fixture = fixture;
+    }
+    /** Returns the component instance. */
+    get component() {
+        return this.fixture.componentInstance;
+    }
+    /** Waits for the editor to be ready and triggers change detection. */
+    async whenReady() {
+        await this.component.whenReady();
+        this.fixture.detectChanges();
+    }
+    /** Executes a command and triggers change detection. */
+    executeCommand(name) {
+        const result = this.component.executeCommand(name);
+        this.fixture.detectChanges();
+        return result;
+    }
+    /** Sets HTML content and triggers change detection. */
+    setHTML(html) {
+        this.component.setHTML(html);
+        this.fixture.detectChanges();
+    }
+    /** Returns the current HTML content. */
+    getHTML() {
+        return this.component.getHTML();
+    }
+    /** Returns the current plain text content. */
+    getText() {
+        return this.component.getText();
+    }
+    /** Returns whether the editor is empty. */
+    get isEmpty() {
+        return this.component.isEmpty();
+    }
+}
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { NotectlTestHarness };
+//# sourceMappingURL=notectl-angular-testing.mjs.map

package/dist/fesm2022/notectl-angular-testing.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"notectl-angular-testing.mjs","sources":["../../testing/src/test-harness.ts","../../testing/src/notectl-angular-testing.ts"],"sourcesContent":["import type { ComponentFixture } from '@angular/core/testing';\nimport type { NotectlEditorComponent } from '@notectl/angular';\n\n/**\n * Test harness for `NotectlEditorComponent` in consumer tests.\n *\n * Wraps a `ComponentFixture` and provides convenience methods\n * for common test operations.\n *\n * @example\n * ```typescript\n * const fixture = TestBed.createComponent(NotectlEditorComponent);\n * const harness = new NotectlTestHarness(fixture);\n * await harness.whenReady();\n * harness.setHTML('<p>Hello</p>');\n * expect(harness.getText()).toBe('Hello');\n * ```\n */\nexport class NotectlTestHarness {\n\tconstructor(private readonly fixture: ComponentFixture<NotectlEditorComponent>) {}\n\n\t/** Returns the component instance. */\n\tget component(): NotectlEditorComponent {\n\t\treturn this.fixture.componentInstance;\n\t}\n\n\t/** Waits for the editor to be ready and triggers change detection. */\n\tasync whenReady(): Promise<void> {\n\t\tawait this.component.whenReady();\n\t\tthis.fixture.detectChanges();\n\t}\n\n\t/** Executes a command and triggers change detection. */\n\texecuteCommand(name: string): boolean {\n\t\tconst result: boolean = this.component.executeCommand(name);\n\t\tthis.fixture.detectChanges();\n\t\treturn result;\n\t}\n\n\t/** Sets HTML content and triggers change detection. */\n\tsetHTML(html: string): void {\n\t\tthis.component.setHTML(html);\n\t\tthis.fixture.detectChanges();\n\t}\n\n\t/** Returns the current HTML content. */\n\tgetHTML(): string {\n\t\treturn this.component.getHTML();\n\t}\n\n\t/** Returns the current plain text content. */\n\tgetText(): string {\n\t\treturn this.component.getText();\n\t}\n\n\t/** Returns whether the editor is empty. */\n\tget isEmpty(): boolean {\n\t\treturn this.component.isEmpty();\n\t}\n}\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;AAcG;MACU,kBAAkB,CAAA;AACD,IAAA,OAAA;AAA7B,IAAA,WAAA,CAA6B,OAAiD,EAAA;QAAjD,IAAA,CAAA,OAAO,GAAP,OAAO;IAA6C;;AAGjF,IAAA,IAAI,SAAS,GAAA;AACZ,QAAA,OAAO,IAAI,CAAC,OAAO,CAAC,iBAAiB;IACtC;;AAGA,IAAA,MAAM,SAAS,GAAA;AACd,QAAA,MAAM,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE;AAChC,QAAA,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;IAC7B;;AAGA,IAAA,cAAc,CAAC,IAAY,EAAA;QAC1B,MAAM,MAAM,GAAY,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC;AAC3D,QAAA,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;AAC5B,QAAA,OAAO,MAAM;IACd;;AAGA,IAAA,OAAO,CAAC,IAAY,EAAA;AACnB,QAAA,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC;AAC5B,QAAA,IAAI,CAAC,OAAO,CAAC,aAAa,EAAE;IAC7B;;IAGA,OAAO,GAAA;AACN,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;IAChC;;IAGA,OAAO,GAAA;AACN,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;IAChC;;AAGA,IAAA,IAAI,OAAO,GAAA;AACV,QAAA,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE;IAChC;AACA;;AC3DD;;AAEG;;;;"}

package/dist/fesm2022/notectl-angular.mjs

@@ -0,0 +1,549 @@
+import * as i0 from '@angular/core';
+import { InjectionToken, makeEnvironmentProviders, inject, DestroyRef, input, model, output, signal, computed, viewChild, afterNextRender, effect, ChangeDetectionStrategy, Component, forwardRef, Directive, Injectable } from '@angular/core';
+import { ThemePreset, NotectlEditor } from '@notectl/core';
+export { AlignmentPlugin, BlockquotePlugin, CodeBlockPlugin, DARK_THEME, FontPlugin, FontSizePlugin, HardBreakPlugin, HeadingPlugin, HighlightPlugin, HorizontalRulePlugin, ImagePlugin, LIGHT_THEME, LinkPlugin, ListPlugin, StrikethroughPlugin, SuperSubPlugin, TablePlugin, TextColorPlugin, TextFormattingPlugin, ThemePreset, ToolbarPlugin, createTheme } from '@notectl/core';
+import { NG_VALUE_ACCESSOR } from '@angular/forms';
+import { Subject } from 'rxjs';
+export { STARTER_FONTS } from '@notectl/core/fonts';
+
+/**
+ * Default configuration applied to all `<notectl-editor>` instances within
+ * the injector scope. Component-level inputs override these defaults.
+ */
+const NOTECTL_DEFAULT_CONFIG = new InjectionToken('notectl-default-config');
+/**
+ * Content format used by the `ControlValueAccessor` for forms integration.
+ * Determines how editor content is serialized when reading/writing form values.
+ *
+ * - `'json'` — `Document` objects (default)
+ * - `'html'` — sanitized HTML strings
+ * - `'text'` — plain text strings
+ */
+const NOTECTL_CONTENT_FORMAT = new InjectionToken('notectl-content-format');
+/**
+ * Configures the notectl editor at the environment injector level.
+ *
+ * @example
+ * ```typescript
+ * bootstrapApplication(App, {
+ *   providers: [
+ *     provideNotectl({
+ *       config: { theme: ThemePreset.Light, placeholder: 'Start typing...' },
+ *       contentFormat: 'json',
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+function provideNotectl(options = {}) {
+    const providers = [];
+    if (options.config) {
+        providers.push({ provide: NOTECTL_DEFAULT_CONFIG, useValue: options.config });
+    }
+    if (options.contentFormat) {
+        providers.push({ provide: NOTECTL_CONTENT_FORMAT, useValue: options.contentFormat });
+    }
+    return makeEnvironmentProviders(providers);
+}
+
+/**
+ * Angular standalone component wrapping the `<ntl-editor>` Web Component.
+ *
+ * Uses `afterNextRender()` for SSR-safe initialization and `effect()` for
+ * reactive input tracking — no lifecycle interfaces needed.
+ *
+ * @example
+ * ```html
+ * <!-- Basic usage -->
+ * <ntl-editor [toolbar]="toolbar" [plugins]="plugins" />
+ *
+ * <!-- Two-way content binding -->
+ * <ntl-editor [(content)]="myDocument" [toolbar]="toolbar" />
+ *
+ * <!-- Reactive forms -->
+ * <ntl-editor [formControl]="editorControl" [toolbar]="toolbar" />
+ * ```
+ */
+class NotectlEditorComponent {
+    // --- Injected dependencies ---
+    destroyRef = inject(DestroyRef);
+    defaultConfig = inject(NOTECTL_DEFAULT_CONFIG, { optional: true });
+    // --- Signal Inputs (1:1 with Web Component config) ---
+    plugins = input([], ...(ngDevMode ? [{ debugName: "plugins" }] : []));
+    toolbar = input(...(ngDevMode ? [undefined, { debugName: "toolbar" }] : []));
+    features = input(...(ngDevMode ? [undefined, { debugName: "features" }] : []));
+    placeholder = input('Start typing...', ...(ngDevMode ? [{ debugName: "placeholder" }] : []));
+    readonlyMode = input(false, ...(ngDevMode ? [{ debugName: "readonlyMode" }] : []));
+    autofocus = input(false, ...(ngDevMode ? [{ debugName: "autofocus" }] : []));
+    maxHistoryDepth = input(...(ngDevMode ? [undefined, { debugName: "maxHistoryDepth" }] : []));
+    theme = input(ThemePreset.Light, ...(ngDevMode ? [{ debugName: "theme" }] : []));
+    // --- Two-way content binding via model() ---
+    /**
+     * Two-way bindable document content.
+     *
+     * `undefined` means no external content was provided — the editor manages
+     * its own state. Once the editor emits changes, the model updates to the
+     * current `Document`.
+     *
+     * @example
+     * ```html
+     * <ntl-editor [(content)]="myDocument" />
+     * ```
+     */
+    content = model(...(ngDevMode ? [undefined, { debugName: "content" }] : []));
+    // --- Signal Outputs (events bridged from Web Component) ---
+    stateChange = output();
+    selectionChange = output();
+    editorFocus = output();
+    editorBlur = output();
+    ready = output();
+    // --- Reactive State ---
+    editorState = signal(null, ...(ngDevMode ? [{ debugName: "editorState" }] : []));
+    isEmpty = computed(() => {
+        const state = this.editorState();
+        if (!state)
+            return true;
+        const doc = state.doc;
+        if (doc.children.length === 0)
+            return true;
+        if (doc.children.length > 1)
+            return false;
+        const block = doc.children[0];
+        if (!block)
+            return true;
+        return block.type === 'paragraph' && block.children.length === 0;
+    }, ...(ngDevMode ? [{ debugName: "isEmpty" }] : []));
+    // --- Internal state ---
+    hostRef = viewChild.required('host');
+    editorRef = null;
+    readyResolve = null;
+    readyPromise = new Promise((resolve) => {
+        this.readyResolve = resolve;
+    });
+    initialized = signal(false, ...(ngDevMode ? [{ debugName: "initialized" }] : []));
+    /** Tracks the last document set from within the editor to prevent feedback loops. */
+    lastEditorDoc = null;
+    constructor() {
+        // SSR-safe: only runs in the browser after first render
+        afterNextRender(() => {
+            this.initEditor();
+        });
+        // React to input changes via effect() — replaces ngOnChanges
+        effect(() => {
+            const currentTheme = this.theme();
+            const currentPlaceholder = this.placeholder();
+            const currentReadonly = this.readonlyMode();
+            const editor = this.editorRef;
+            if (!this.initialized() || !editor)
+                return;
+            editor.setTheme(currentTheme);
+            editor.configure({
+                placeholder: currentPlaceholder,
+                readonly: currentReadonly,
+            });
+        });
+        // Sync external content model changes into the editor.
+        // Skips when the document was set by the editor itself (feedback loop prevention).
+        effect(() => {
+            const doc = this.content();
+            const editor = this.editorRef;
+            if (!this.initialized() || !editor || !doc)
+                return;
+            // Skip if this document originated from the editor's own state change
+            if (doc === this.lastEditorDoc)
+                return;
+            editor.setJSON(doc);
+        });
+        this.destroyRef.onDestroy(() => {
+            this.destroyEditor();
+        });
+    }
+    // --- Public API (proxy to Web Component) ---
+    /** Returns the document as JSON. */
+    getJSON() {
+        return this.requireEditor().getJSON();
+    }
+    /** Sets the document from JSON. */
+    setJSON(doc) {
+        this.requireEditor().setJSON(doc);
+    }
+    /** Returns sanitized HTML representation of the document. */
+    getHTML() {
+        return this.requireEditor().getHTML();
+    }
+    /** Sets content from HTML (sanitized). */
+    setHTML(html) {
+        this.requireEditor().setHTML(html);
+    }
+    /** Returns plain text content. */
+    getText() {
+        return this.requireEditor().getText();
+    }
+    /** Proxy to the Web Component's `commands` object. */
+    get commands() {
+        return this.requireEditor().commands;
+    }
+    /** Proxy to the Web Component's `can()` capability checker. */
+    can() {
+        return this.requireEditor().can();
+    }
+    /** Executes a named command registered by a plugin. */
+    executeCommand(name) {
+        if (!this.editorRef)
+            return false;
+        return this.editorRef.executeCommand(name);
+    }
+    /** Configures a plugin at runtime. */
+    configurePlugin(pluginId, config) {
+        this.editorRef?.configurePlugin(pluginId, config);
+    }
+    /** Dispatches a transaction. */
+    dispatch(tr) {
+        this.editorRef?.dispatch(tr);
+    }
+    /** Returns the current editor state. */
+    getState() {
+        return this.requireEditor().getState();
+    }
+    /** Changes the theme at runtime. */
+    setTheme(theme) {
+        this.editorRef?.setTheme(theme);
+    }
+    /** Returns the current theme setting. */
+    getTheme() {
+        return this.editorRef?.getTheme() ?? this.theme();
+    }
+    /** Sets the readonly state programmatically (used by ControlValueAccessor). */
+    setReadonly(readonlyState) {
+        this.editorRef?.configure({ readonly: readonlyState });
+    }
+    /** Resolves when the editor is ready. */
+    whenReady() {
+        return this.readyPromise;
+    }
+    // --- Private ---
+    initEditor() {
+        const hostElement = this.hostRef().nativeElement;
+        const config = this.buildConfig();
+        const editor = new NotectlEditor();
+        this.editorRef = editor;
+        // Register event listeners BEFORE appending to DOM, because
+        // appendChild triggers connectedCallback → init() synchronously.
+        editor.on('stateChange', (event) => {
+            this.editorState.set(event.newState);
+            this.syncContentModel(event.newState.doc);
+            this.stateChange.emit(event);
+        });
+        editor.on('selectionChange', (event) => {
+            this.selectionChange.emit(event);
+        });
+        editor.on('focus', () => {
+            this.editorFocus.emit();
+        });
+        editor.on('blur', () => {
+            this.editorBlur.emit();
+        });
+        editor.on('ready', () => {
+            this.initialized.set(true);
+            const state = editor.getState();
+            this.editorState.set(state);
+            // Apply initial content model if set before editor was ready
+            const initialContent = this.content();
+            if (initialContent) {
+                editor.setJSON(initialContent);
+            }
+            this.readyResolve?.();
+            this.ready.emit();
+        });
+        // Init with config BEFORE appending to DOM. appendChild triggers
+        // connectedCallback which calls init() without config — by calling
+        // init(config) first, the editor initializes with the full config
+        // and connectedCallback's init() becomes a no-op (already initialized).
+        editor.init(config);
+        hostElement.appendChild(editor);
+    }
+    buildConfig() {
+        const defaults = this.defaultConfig ?? {};
+        const toolbar = this.toolbar();
+        const features = this.features();
+        const maxHistory = this.maxHistoryDepth();
+        const config = {
+            ...defaults,
+            plugins: this.plugins(),
+            placeholder: this.placeholder(),
+            readonly: this.readonlyMode(),
+            autofocus: this.autofocus(),
+            theme: this.theme(),
+        };
+        if (toolbar !== undefined) {
+            config.toolbar = toolbar;
+        }
+        if (features !== undefined) {
+            config.features = features;
+        }
+        if (maxHistory !== undefined) {
+            config.maxHistoryDepth = maxHistory;
+        }
+        return config;
+    }
+    /** Syncs editor document changes to the content model without feedback loops. */
+    syncContentModel(doc) {
+        this.lastEditorDoc = doc;
+        this.content.set(doc);
+    }
+    destroyEditor() {
+        if (this.editorRef) {
+            this.editorRef.destroy();
+            this.editorRef = null;
+        }
+        this.initialized.set(false);
+    }
+    requireEditor() {
+        const editor = this.editorRef;
+        if (!editor) {
+            throw new Error('NotectlEditor is not initialized. Await whenReady() first.');
+        }
+        return editor;
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: NotectlEditorComponent, deps: [], target: i0.ɵɵFactoryTarget.Component });
+    static ɵcmp = i0.ɵɵngDeclareComponent({ minVersion: "17.2.0", version: "21.1.4", type: NotectlEditorComponent, isStandalone: true, selector: "ntl-editor", inputs: { plugins: { classPropertyName: "plugins", publicName: "plugins", isSignal: true, isRequired: false, transformFunction: null }, toolbar: { classPropertyName: "toolbar", publicName: "toolbar", isSignal: true, isRequired: false, transformFunction: null }, features: { classPropertyName: "features", publicName: "features", isSignal: true, isRequired: false, transformFunction: null }, placeholder: { classPropertyName: "placeholder", publicName: "placeholder", isSignal: true, isRequired: false, transformFunction: null }, readonlyMode: { classPropertyName: "readonlyMode", publicName: "readonlyMode", isSignal: true, isRequired: false, transformFunction: null }, autofocus: { classPropertyName: "autofocus", publicName: "autofocus", isSignal: true, isRequired: false, transformFunction: null }, maxHistoryDepth: { classPropertyName: "maxHistoryDepth", publicName: "maxHistoryDepth", isSignal: true, isRequired: false, transformFunction: null }, theme: { classPropertyName: "theme", publicName: "theme", isSignal: true, isRequired: false, transformFunction: null }, content: { classPropertyName: "content", publicName: "content", isSignal: true, isRequired: false, transformFunction: null } }, outputs: { content: "contentChange", stateChange: "stateChange", selectionChange: "selectionChange", editorFocus: "editorFocus", editorBlur: "editorBlur", ready: "ready" }, viewQueries: [{ propertyName: "hostRef", first: true, predicate: ["host"], descendants: true, isSignal: true }], ngImport: i0, template: '<div #host></div>', isInline: true, styles: [":host{display:block}\n"], changeDetection: i0.ChangeDetectionStrategy.OnPush });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: NotectlEditorComponent, decorators: [{
+            type: Component,
+            args: [{ selector: 'ntl-editor', template: '<div #host></div>', changeDetection: ChangeDetectionStrategy.OnPush, styles: [":host{display:block}\n"] }]
+        }], ctorParameters: () => [], propDecorators: { plugins: [{ type: i0.Input, args: [{ isSignal: true, alias: "plugins", required: false }] }], toolbar: [{ type: i0.Input, args: [{ isSignal: true, alias: "toolbar", required: false }] }], features: [{ type: i0.Input, args: [{ isSignal: true, alias: "features", required: false }] }], placeholder: [{ type: i0.Input, args: [{ isSignal: true, alias: "placeholder", required: false }] }], readonlyMode: [{ type: i0.Input, args: [{ isSignal: true, alias: "readonlyMode", required: false }] }], autofocus: [{ type: i0.Input, args: [{ isSignal: true, alias: "autofocus", required: false }] }], maxHistoryDepth: [{ type: i0.Input, args: [{ isSignal: true, alias: "maxHistoryDepth", required: false }] }], theme: [{ type: i0.Input, args: [{ isSignal: true, alias: "theme", required: false }] }], content: [{ type: i0.Input, args: [{ isSignal: true, alias: "content", required: false }] }, { type: i0.Output, args: ["contentChange"] }], stateChange: [{ type: i0.Output, args: ["stateChange"] }], selectionChange: [{ type: i0.Output, args: ["selectionChange"] }], editorFocus: [{ type: i0.Output, args: ["editorFocus"] }], editorBlur: [{ type: i0.Output, args: ["editorBlur"] }], ready: [{ type: i0.Output, args: ["ready"] }], hostRef: [{ type: i0.ViewChild, args: ['host', { isSignal: true }] }] } });
+
+/** Escapes HTML special characters to prevent XSS when inserting plain text. */
+function escapeHtml(text) {
+    return text
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+}
+/**
+ * `ControlValueAccessor` directive for Angular forms integration.
+ *
+ * Supports Reactive Forms (`formControl`, `formControlName`) and
+ * template-driven forms (`ngModel`).
+ *
+ * The content format is configurable via `provideNotectl({ contentFormat })` or
+ * the `NOTECTL_CONTENT_FORMAT` injection token:
+ * - `'json'` (default) — form value is a `Document` object
+ * - `'html'` — form value is a sanitized HTML string
+ * - `'text'` — form value is a plain text string
+ */
+class NotectlValueAccessorDirective {
+    editor = inject(NotectlEditorComponent);
+    destroyRef = inject(DestroyRef);
+    format = inject(NOTECTL_CONTENT_FORMAT, { optional: true }) ?? 'json';
+    onChange = () => { };
+    onTouched = () => { };
+    pendingValue = null;
+    suppressEmit = false;
+    stateChangeSub = this.editor.stateChange.subscribe((_event) => {
+        if (this.suppressEmit)
+            return;
+        const value = this.readValue();
+        this.onChange(value);
+    });
+    blurSub = this.editor.editorBlur.subscribe(() => {
+        this.onTouched();
+    });
+    constructor() {
+        this.destroyRef.onDestroy(() => {
+            this.stateChangeSub.unsubscribe();
+            this.blurSub.unsubscribe();
+        });
+    }
+    writeValue(value) {
+        if (!value)
+            return;
+        try {
+            this.editor.getState();
+            this.writeValueToEditor(value);
+            return;
+        }
+        catch {
+            // Editor not ready yet — defer
+        }
+        this.pendingValue = value;
+        this.editor.whenReady().then(() => {
+            if (this.pendingValue !== null) {
+                this.writeValueToEditor(this.pendingValue);
+                this.pendingValue = null;
+            }
+        });
+    }
+    registerOnChange(fn) {
+        this.onChange = fn;
+    }
+    registerOnTouched(fn) {
+        this.onTouched = fn;
+    }
+    setDisabledState(isDisabled) {
+        this.editor.setReadonly(isDisabled);
+    }
+    writeValueToEditor(value) {
+        this.suppressEmit = true;
+        try {
+            if (this.format === 'json' && typeof value === 'object') {
+                this.editor.setJSON(value);
+            }
+            else if (this.format === 'html' && typeof value === 'string') {
+                this.editor.setHTML(value);
+            }
+            else if (this.format === 'text' && typeof value === 'string') {
+                this.editor.setHTML(`<p>${escapeHtml(value)}</p>`);
+            }
+            else if (typeof value === 'string') {
+                this.editor.setHTML(value);
+            }
+            else {
+                this.editor.setJSON(value);
+            }
+        }
+        finally {
+            this.suppressEmit = false;
+        }
+    }
+    readValue() {
+        try {
+            switch (this.format) {
+                case 'html':
+                    return this.editor.getHTML();
+                case 'text':
+                    return this.editor.getText();
+                default:
+                    return this.editor.getJSON();
+            }
+        }
+        catch {
+            return null;
+        }
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: NotectlValueAccessorDirective, deps: [], target: i0.ɵɵFactoryTarget.Directive });
+    static ɵdir = i0.ɵɵngDeclareDirective({ minVersion: "14.0.0", version: "21.1.4", type: NotectlValueAccessorDirective, isStandalone: true, selector: "ntl-editor[formControl], ntl-editor[formControlName], ntl-editor[ngModel]", providers: [
+            {
+                provide: NG_VALUE_ACCESSOR,
+                useExisting: forwardRef(() => NotectlValueAccessorDirective),
+                multi: true,
+            },
+        ], ngImport: i0 });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: NotectlValueAccessorDirective, decorators: [{
+            type: Directive,
+            args: [{
+                    selector: 'ntl-editor[formControl], ntl-editor[formControlName], ntl-editor[ngModel]',
+                    providers: [
+                        {
+                            provide: NG_VALUE_ACCESSOR,
+                            useExisting: forwardRef(() => NotectlValueAccessorDirective),
+                            multi: true,
+                        },
+                    ],
+                }]
+        }], ctorParameters: () => [] });
+
+/**
+ * Optional injectable service for programmatic editor access via DI.
+ *
+ * Useful when a toolbar or other component needs to interact with
+ * the editor without a direct template reference.
+ *
+ * The service must be provided at a shared injector level and
+ * connected to the editor component via `register()`.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   providers: [NotectlEditorService],
+ *   template: `
+ *     <app-toolbar />
+ *     <ntl-editor #editor [plugins]="plugins" />
+ *   `,
+ * })
+ * export class EditorPage {
+ *   private readonly editor = viewChild.required<NotectlEditorComponent>('editor');
+ *   private readonly service = inject(NotectlEditorService);
+ *
+ *   constructor() {
+ *     afterNextRender(() => {
+ *       this.service.register(this.editor());
+ *     });
+ *   }
+ * }
+ * ```
+ */
+class NotectlEditorService {
+    destroyRef = inject(DestroyRef);
+    editorRef = signal(null, ...(ngDevMode ? [{ debugName: "editorRef" }] : []));
+    stateChangeSubject = new Subject();
+    /** Whether an editor is currently registered with this service. */
+    hasEditor = computed(() => this.editorRef() !== null, ...(ngDevMode ? [{ debugName: "hasEditor" }] : []));
+    /** Observable stream of state change events from the editor. */
+    stateChanges$ = this.stateChangeSubject.asObservable();
+    stateChangeSub = null;
+    constructor() {
+        this.destroyRef.onDestroy(() => {
+            this.unregister();
+            this.stateChangeSubject.complete();
+        });
+    }
+    /** Registers an editor component with this service. */
+    register(editor) {
+        this.unregister();
+        this.editorRef.set(editor);
+        this.stateChangeSub = editor.stateChange.subscribe((event) => {
+            this.stateChangeSubject.next(event);
+        });
+    }
+    /** Unregisters the current editor from this service. */
+    unregister() {
+        this.stateChangeSub?.unsubscribe();
+        this.stateChangeSub = null;
+        this.editorRef.set(null);
+    }
+    /** Executes a named command on the registered editor. */
+    executeCommand(name) {
+        const editor = this.editorRef();
+        if (!editor)
+            return false;
+        return editor.executeCommand(name);
+    }
+    /** Returns the current editor state, or `null` if no editor is registered. */
+    getState() {
+        const editor = this.editorRef();
+        if (!editor)
+            return null;
+        try {
+            return editor.getState();
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Dispatches a transaction on the registered editor. */
+    dispatch(tr) {
+        this.editorRef()?.dispatch(tr);
+    }
+    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: NotectlEditorService, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
+    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: NotectlEditorService });
+}
+i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "21.1.4", ngImport: i0, type: NotectlEditorService, decorators: [{
+            type: Injectable
+        }], ctorParameters: () => [] });
+
+/**
+ * @notectl/angular — Angular integration for the notectl rich text editor.
+ * @packageDocumentation
+ */
+// --- Angular Bindings ---
+
+/**
+ * Generated bundle index. Do not edit.
+ */
+
+export { NOTECTL_CONTENT_FORMAT, NOTECTL_DEFAULT_CONFIG, NotectlEditorComponent, NotectlEditorService, NotectlValueAccessorDirective, provideNotectl };
+//# sourceMappingURL=notectl-angular.mjs.map

package/dist/fesm2022/notectl-angular.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"notectl-angular.mjs","sources":["../../src/lib/tokens.ts","../../src/lib/notectl-editor.component.ts","../../src/lib/value-accessor.directive.ts","../../src/lib/notectl-editor.service.ts","../../src/public-api.ts","../../src/notectl-angular.ts"],"sourcesContent":["import { type EnvironmentProviders, InjectionToken, makeEnvironmentProviders } from '@angular/core';\nimport type { NotectlEditorConfig } from '@notectl/core';\n\n/**\n * Default configuration applied to all `<notectl-editor>` instances within\n * the injector scope. Component-level inputs override these defaults.\n */\nexport const NOTECTL_DEFAULT_CONFIG: InjectionToken<Partial<NotectlEditorConfig>> =\n\tnew InjectionToken<Partial<NotectlEditorConfig>>('notectl-default-config');\n\n/**\n * Content format used by the `ControlValueAccessor` for forms integration.\n * Determines how editor content is serialized when reading/writing form values.\n *\n * - `'json'` — `Document` objects (default)\n * - `'html'` — sanitized HTML strings\n * - `'text'` — plain text strings\n */\nexport const NOTECTL_CONTENT_FORMAT: InjectionToken<ContentFormat> =\n\tnew InjectionToken<ContentFormat>('notectl-content-format');\n\n/** Supported content serialization formats for forms integration. */\nexport type ContentFormat = 'json' | 'html' | 'text';\n\n/** Options for `provideNotectl()`. */\nexport interface NotectlProviderOptions {\n\t/** Default editor configuration applied to all instances. */\n\treadonly config?: Partial<NotectlEditorConfig>;\n\t/** Content serialization format for forms integration. Defaults to `'json'`. */\n\treadonly contentFormat?: ContentFormat;\n}\n\n/**\n * Configures the notectl editor at the environment injector level.\n *\n * @example\n * ```typescript\n * bootstrapApplication(App, {\n *   providers: [\n *     provideNotectl({\n *       config: { theme: ThemePreset.Light, placeholder: 'Start typing...' },\n *       contentFormat: 'json',\n *     }),\n *   ],\n * });\n * ```\n */\nexport function provideNotectl(options: NotectlProviderOptions = {}): EnvironmentProviders {\n\tconst providers = [];\n\n\tif (options.config) {\n\t\tproviders.push({ provide: NOTECTL_DEFAULT_CONFIG, useValue: options.config });\n\t}\n\n\tif (options.contentFormat) {\n\t\tproviders.push({ provide: NOTECTL_CONTENT_FORMAT, useValue: options.contentFormat });\n\t}\n\n\treturn makeEnvironmentProviders(providers);\n}\n","import {\n\tChangeDetectionStrategy,\n\tComponent,\n\tDestroyRef,\n\ttype ElementRef,\n\ttype ModelSignal,\n\tafterNextRender,\n\tcomputed,\n\teffect,\n\tinject,\n\tinput,\n\tmodel,\n\toutput,\n\tsignal,\n\tviewChild,\n} from '@angular/core';\nimport type {\n\tDocument,\n\tEditorSelection,\n\tEditorState,\n\tNotectlEditorConfig,\n\tPlugin,\n\tPluginConfig,\n\tStateChangeEvent,\n\tTextFormattingConfig,\n\tTheme,\n\tTransaction,\n} from '@notectl/core';\nimport { NotectlEditor, ThemePreset } from '@notectl/core';\n\nimport { NOTECTL_DEFAULT_CONFIG } from './tokens';\nimport type { SelectionChangeEvent } from './types';\n\n/**\n * Angular standalone component wrapping the `<ntl-editor>` Web Component.\n *\n * Uses `afterNextRender()` for SSR-safe initialization and `effect()` for\n * reactive input tracking — no lifecycle interfaces needed.\n *\n * @example\n * ```html\n * <!-- Basic usage -->\n * <ntl-editor [toolbar]=\"toolbar\" [plugins]=\"plugins\" />\n *\n * <!-- Two-way content binding -->\n * <ntl-editor [(content)]=\"myDocument\" [toolbar]=\"toolbar\" />\n *\n * <!-- Reactive forms -->\n * <ntl-editor [formControl]=\"editorControl\" [toolbar]=\"toolbar\" />\n * ```\n */\n@Component({\n\tselector: 'ntl-editor',\n\ttemplate: '<div #host></div>',\n\tstyles: ':host { display: block; }',\n\tchangeDetection: ChangeDetectionStrategy.OnPush,\n})\nexport class NotectlEditorComponent {\n\t// --- Injected dependencies ---\n\n\tprivate readonly destroyRef: DestroyRef = inject(DestroyRef);\n\tprivate readonly defaultConfig: Partial<NotectlEditorConfig> | null = inject(\n\t\tNOTECTL_DEFAULT_CONFIG,\n\t\t{ optional: true },\n\t);\n\n\t// --- Signal Inputs (1:1 with Web Component config) ---\n\n\treadonly plugins = input<Plugin[]>([]);\n\treadonly toolbar = input<ReadonlyArray<ReadonlyArray<Plugin>>>();\n\treadonly features = input<Partial<TextFormattingConfig>>();\n\treadonly placeholder = input<string>('Start typing...');\n\treadonly readonlyMode = input<boolean>(false);\n\treadonly autofocus = input<boolean>(false);\n\treadonly maxHistoryDepth = input<number>();\n\treadonly theme = input<ThemePreset | Theme>(ThemePreset.Light);\n\n\t// --- Two-way content binding via model() ---\n\n\t/**\n\t * Two-way bindable document content.\n\t *\n\t * `undefined` means no external content was provided — the editor manages\n\t * its own state. Once the editor emits changes, the model updates to the\n\t * current `Document`.\n\t *\n\t * @example\n\t * ```html\n\t * <ntl-editor [(content)]=\"myDocument\" />\n\t * ```\n\t */\n\treadonly content: ModelSignal<Document | undefined> = model<Document>();\n\n\t// --- Signal Outputs (events bridged from Web Component) ---\n\n\treadonly stateChange = output<StateChangeEvent>();\n\treadonly selectionChange = output<SelectionChangeEvent>();\n\treadonly editorFocus = output<void>();\n\treadonly editorBlur = output<void>();\n\treadonly ready = output<void>();\n\n\t// --- Reactive State ---\n\n\treadonly editorState = signal<EditorState | null>(null);\n\n\treadonly isEmpty = computed<boolean>(() => {\n\t\tconst state: EditorState | null = this.editorState();\n\t\tif (!state) return true;\n\t\tconst doc: Document = state.doc;\n\t\tif (doc.children.length === 0) return true;\n\t\tif (doc.children.length > 1) return false;\n\t\tconst block = doc.children[0];\n\t\tif (!block) return true;\n\t\treturn block.type === 'paragraph' && block.children.length === 0;\n\t});\n\n\t// --- Internal state ---\n\n\tprivate readonly hostRef = viewChild.required<ElementRef<HTMLDivElement>>('host');\n\tprivate editorRef: NotectlEditor | null = null;\n\tprivate readyResolve: (() => void) | null = null;\n\tprivate readonly readyPromise: Promise<void> = new Promise<void>((resolve) => {\n\t\tthis.readyResolve = resolve;\n\t});\n\tprivate readonly initialized = signal(false);\n\n\t/** Tracks the last document set from within the editor to prevent feedback loops. */\n\tprivate lastEditorDoc: Document | null = null;\n\n\tconstructor() {\n\t\t// SSR-safe: only runs in the browser after first render\n\t\tafterNextRender(() => {\n\t\t\tthis.initEditor();\n\t\t});\n\n\t\t// React to input changes via effect() — replaces ngOnChanges\n\t\teffect(() => {\n\t\t\tconst currentTheme: ThemePreset | Theme = this.theme();\n\t\t\tconst currentPlaceholder: string = this.placeholder();\n\t\t\tconst currentReadonly: boolean = this.readonlyMode();\n\n\t\t\tconst editor: NotectlEditor | null = this.editorRef;\n\t\t\tif (!this.initialized() || !editor) return;\n\n\t\t\teditor.setTheme(currentTheme);\n\t\t\teditor.configure({\n\t\t\t\tplaceholder: currentPlaceholder,\n\t\t\t\treadonly: currentReadonly,\n\t\t\t});\n\t\t});\n\n\t\t// Sync external content model changes into the editor.\n\t\t// Skips when the document was set by the editor itself (feedback loop prevention).\n\t\teffect(() => {\n\t\t\tconst doc: Document | undefined = this.content();\n\t\t\tconst editor: NotectlEditor | null = this.editorRef;\n\t\t\tif (!this.initialized() || !editor || !doc) return;\n\n\t\t\t// Skip if this document originated from the editor's own state change\n\t\t\tif (doc === this.lastEditorDoc) return;\n\n\t\t\teditor.setJSON(doc);\n\t\t});\n\n\t\tthis.destroyRef.onDestroy(() => {\n\t\t\tthis.destroyEditor();\n\t\t});\n\t}\n\n\t// --- Public API (proxy to Web Component) ---\n\n\t/** Returns the document as JSON. */\n\tgetJSON(): Document {\n\t\treturn this.requireEditor().getJSON();\n\t}\n\n\t/** Sets the document from JSON. */\n\tsetJSON(doc: Document): void {\n\t\tthis.requireEditor().setJSON(doc);\n\t}\n\n\t/** Returns sanitized HTML representation of the document. */\n\tgetHTML(): string {\n\t\treturn this.requireEditor().getHTML();\n\t}\n\n\t/** Sets content from HTML (sanitized). */\n\tsetHTML(html: string): void {\n\t\tthis.requireEditor().setHTML(html);\n\t}\n\n\t/** Returns plain text content. */\n\tgetText(): string {\n\t\treturn this.requireEditor().getText();\n\t}\n\n\t/** Proxy to the Web Component's `commands` object. */\n\tget commands(): NotectlEditor['commands'] {\n\t\treturn this.requireEditor().commands;\n\t}\n\n\t/** Proxy to the Web Component's `can()` capability checker. */\n\tcan(): ReturnType<NotectlEditor['can']> {\n\t\treturn this.requireEditor().can();\n\t}\n\n\t/** Executes a named command registered by a plugin. */\n\texecuteCommand(name: string): boolean {\n\t\tif (!this.editorRef) return false;\n\t\treturn this.editorRef.executeCommand(name);\n\t}\n\n\t/** Configures a plugin at runtime. */\n\tconfigurePlugin(pluginId: string, config: PluginConfig): void {\n\t\tthis.editorRef?.configurePlugin(pluginId, config);\n\t}\n\n\t/** Dispatches a transaction. */\n\tdispatch(tr: Transaction): void {\n\t\tthis.editorRef?.dispatch(tr);\n\t}\n\n\t/** Returns the current editor state. */\n\tgetState(): EditorState {\n\t\treturn this.requireEditor().getState();\n\t}\n\n\t/** Changes the theme at runtime. */\n\tsetTheme(theme: ThemePreset | Theme): void {\n\t\tthis.editorRef?.setTheme(theme);\n\t}\n\n\t/** Returns the current theme setting. */\n\tgetTheme(): ThemePreset | Theme {\n\t\treturn this.editorRef?.getTheme() ?? this.theme();\n\t}\n\n\t/** Sets the readonly state programmatically (used by ControlValueAccessor). */\n\tsetReadonly(readonlyState: boolean): void {\n\t\tthis.editorRef?.configure({ readonly: readonlyState });\n\t}\n\n\t/** Resolves when the editor is ready. */\n\twhenReady(): Promise<void> {\n\t\treturn this.readyPromise;\n\t}\n\n\t// --- Private ---\n\n\tprivate initEditor(): void {\n\t\tconst hostElement: HTMLDivElement = this.hostRef().nativeElement;\n\t\tconst config: NotectlEditorConfig = this.buildConfig();\n\n\t\tconst editor: NotectlEditor = new NotectlEditor();\n\t\tthis.editorRef = editor;\n\n\t\t// Register event listeners BEFORE appending to DOM, because\n\t\t// appendChild triggers connectedCallback → init() synchronously.\n\t\teditor.on('stateChange', (event: StateChangeEvent) => {\n\t\t\tthis.editorState.set(event.newState);\n\t\t\tthis.syncContentModel(event.newState.doc);\n\t\t\tthis.stateChange.emit(event);\n\t\t});\n\n\t\teditor.on('selectionChange', (event: { selection: EditorSelection }) => {\n\t\t\tthis.selectionChange.emit(event);\n\t\t});\n\n\t\teditor.on('focus', () => {\n\t\t\tthis.editorFocus.emit();\n\t\t});\n\n\t\teditor.on('blur', () => {\n\t\t\tthis.editorBlur.emit();\n\t\t});\n\n\t\teditor.on('ready', () => {\n\t\t\tthis.initialized.set(true);\n\t\t\tconst state: EditorState = editor.getState();\n\t\t\tthis.editorState.set(state);\n\n\t\t\t// Apply initial content model if set before editor was ready\n\t\t\tconst initialContent: Document | undefined = this.content();\n\t\t\tif (initialContent) {\n\t\t\t\teditor.setJSON(initialContent);\n\t\t\t}\n\n\t\t\tthis.readyResolve?.();\n\t\t\tthis.ready.emit();\n\t\t});\n\n\t\t// Init with config BEFORE appending to DOM. appendChild triggers\n\t\t// connectedCallback which calls init() without config — by calling\n\t\t// init(config) first, the editor initializes with the full config\n\t\t// and connectedCallback's init() becomes a no-op (already initialized).\n\t\teditor.init(config);\n\t\thostElement.appendChild(editor);\n\t}\n\n\tprivate buildConfig(): NotectlEditorConfig {\n\t\tconst defaults: Partial<NotectlEditorConfig> = this.defaultConfig ?? {};\n\t\tconst toolbar: ReadonlyArray<ReadonlyArray<Plugin>> | undefined = this.toolbar();\n\t\tconst features: Partial<TextFormattingConfig> | undefined = this.features();\n\t\tconst maxHistory: number | undefined = this.maxHistoryDepth();\n\n\t\tconst config: NotectlEditorConfig = {\n\t\t\t...defaults,\n\t\t\tplugins: this.plugins(),\n\t\t\tplaceholder: this.placeholder(),\n\t\t\treadonly: this.readonlyMode(),\n\t\t\tautofocus: this.autofocus(),\n\t\t\ttheme: this.theme(),\n\t\t};\n\n\t\tif (toolbar !== undefined) {\n\t\t\tconfig.toolbar = toolbar;\n\t\t}\n\t\tif (features !== undefined) {\n\t\t\tconfig.features = features;\n\t\t}\n\t\tif (maxHistory !== undefined) {\n\t\t\tconfig.maxHistoryDepth = maxHistory;\n\t\t}\n\n\t\treturn config;\n\t}\n\n\t/** Syncs editor document changes to the content model without feedback loops. */\n\tprivate syncContentModel(doc: Document): void {\n\t\tthis.lastEditorDoc = doc;\n\t\tthis.content.set(doc);\n\t}\n\n\tprivate destroyEditor(): void {\n\t\tif (this.editorRef) {\n\t\t\tthis.editorRef.destroy();\n\t\t\tthis.editorRef = null;\n\t\t}\n\t\tthis.initialized.set(false);\n\t}\n\n\tprivate requireEditor(): NotectlEditor {\n\t\tconst editor: NotectlEditor | null = this.editorRef;\n\t\tif (!editor) {\n\t\t\tthrow new Error('NotectlEditor is not initialized. Await whenReady() first.');\n\t\t}\n\t\treturn editor;\n\t}\n}\n","import { DestroyRef, Directive, forwardRef, inject } from '@angular/core';\nimport { type ControlValueAccessor, NG_VALUE_ACCESSOR } from '@angular/forms';\nimport type { Document, StateChangeEvent } from '@notectl/core';\n\nimport { NotectlEditorComponent } from './notectl-editor.component';\nimport { type ContentFormat, NOTECTL_CONTENT_FORMAT } from './tokens';\n\ntype OnChangeFn = (value: Document | string | null) => void;\ntype OnTouchedFn = () => void;\n\n/** Escapes HTML special characters to prevent XSS when inserting plain text. */\nfunction escapeHtml(text: string): string {\n\treturn text\n\t\t.replace(/&/g, '&amp;')\n\t\t.replace(/</g, '&lt;')\n\t\t.replace(/>/g, '&gt;')\n\t\t.replace(/\"/g, '&quot;')\n\t\t.replace(/'/g, '&#39;');\n}\n\n/**\n * `ControlValueAccessor` directive for Angular forms integration.\n *\n * Supports Reactive Forms (`formControl`, `formControlName`) and\n * template-driven forms (`ngModel`).\n *\n * The content format is configurable via `provideNotectl({ contentFormat })` or\n * the `NOTECTL_CONTENT_FORMAT` injection token:\n * - `'json'` (default) — form value is a `Document` object\n * - `'html'` — form value is a sanitized HTML string\n * - `'text'` — form value is a plain text string\n */\n@Directive({\n\tselector: 'ntl-editor[formControl], ntl-editor[formControlName], ntl-editor[ngModel]',\n\tproviders: [\n\t\t{\n\t\t\tprovide: NG_VALUE_ACCESSOR,\n\t\t\tuseExisting: forwardRef(() => NotectlValueAccessorDirective),\n\t\t\tmulti: true,\n\t\t},\n\t],\n})\nexport class NotectlValueAccessorDirective implements ControlValueAccessor {\n\tprivate readonly editor: NotectlEditorComponent = inject(NotectlEditorComponent);\n\tprivate readonly destroyRef: DestroyRef = inject(DestroyRef);\n\tprivate readonly format: ContentFormat =\n\t\tinject(NOTECTL_CONTENT_FORMAT, { optional: true }) ?? 'json';\n\n\tprivate onChange: OnChangeFn = () => {};\n\tprivate onTouched: OnTouchedFn = () => {};\n\tprivate pendingValue: Document | string | null = null;\n\tprivate suppressEmit = false;\n\n\tprivate readonly stateChangeSub = this.editor.stateChange.subscribe(\n\t\t(_event: StateChangeEvent) => {\n\t\t\tif (this.suppressEmit) return;\n\t\t\tconst value: Document | string | null = this.readValue();\n\t\t\tthis.onChange(value);\n\t\t},\n\t);\n\n\tprivate readonly blurSub = this.editor.editorBlur.subscribe(() => {\n\t\tthis.onTouched();\n\t});\n\n\tconstructor() {\n\t\tthis.destroyRef.onDestroy(() => {\n\t\t\tthis.stateChangeSub.unsubscribe();\n\t\t\tthis.blurSub.unsubscribe();\n\t\t});\n\t}\n\n\twriteValue(value: Document | string | null): void {\n\t\tif (!value) return;\n\n\t\ttry {\n\t\t\tthis.editor.getState();\n\t\t\tthis.writeValueToEditor(value);\n\t\t\treturn;\n\t\t} catch {\n\t\t\t// Editor not ready yet — defer\n\t\t}\n\n\t\tthis.pendingValue = value;\n\t\tthis.editor.whenReady().then(() => {\n\t\t\tif (this.pendingValue !== null) {\n\t\t\t\tthis.writeValueToEditor(this.pendingValue);\n\t\t\t\tthis.pendingValue = null;\n\t\t\t}\n\t\t});\n\t}\n\n\tregisterOnChange(fn: OnChangeFn): void {\n\t\tthis.onChange = fn;\n\t}\n\n\tregisterOnTouched(fn: OnTouchedFn): void {\n\t\tthis.onTouched = fn;\n\t}\n\n\tsetDisabledState(isDisabled: boolean): void {\n\t\tthis.editor.setReadonly(isDisabled);\n\t}\n\n\tprivate writeValueToEditor(value: Document | string): void {\n\t\tthis.suppressEmit = true;\n\t\ttry {\n\t\t\tif (this.format === 'json' && typeof value === 'object') {\n\t\t\t\tthis.editor.setJSON(value as Document);\n\t\t\t} else if (this.format === 'html' && typeof value === 'string') {\n\t\t\t\tthis.editor.setHTML(value);\n\t\t\t} else if (this.format === 'text' && typeof value === 'string') {\n\t\t\t\tthis.editor.setHTML(`<p>${escapeHtml(value)}</p>`);\n\t\t\t} else if (typeof value === 'string') {\n\t\t\t\tthis.editor.setHTML(value);\n\t\t\t} else {\n\t\t\t\tthis.editor.setJSON(value as Document);\n\t\t\t}\n\t\t} finally {\n\t\t\tthis.suppressEmit = false;\n\t\t}\n\t}\n\n\tprivate readValue(): Document | string | null {\n\t\ttry {\n\t\t\tswitch (this.format) {\n\t\t\t\tcase 'html':\n\t\t\t\t\treturn this.editor.getHTML();\n\t\t\t\tcase 'text':\n\t\t\t\t\treturn this.editor.getText();\n\t\t\t\tdefault:\n\t\t\t\t\treturn this.editor.getJSON();\n\t\t\t}\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n}\n","import { DestroyRef, Injectable, computed, inject, signal } from '@angular/core';\nimport type { EditorState, StateChangeEvent, Transaction } from '@notectl/core';\nimport { type Observable, Subject } from 'rxjs';\n\nimport type { NotectlEditorComponent } from './notectl-editor.component';\n\n/**\n * Optional injectable service for programmatic editor access via DI.\n *\n * Useful when a toolbar or other component needs to interact with\n * the editor without a direct template reference.\n *\n * The service must be provided at a shared injector level and\n * connected to the editor component via `register()`.\n *\n * @example\n * ```typescript\n * @Component({\n *   providers: [NotectlEditorService],\n *   template: `\n *     <app-toolbar />\n *     <ntl-editor #editor [plugins]=\"plugins\" />\n *   `,\n * })\n * export class EditorPage {\n *   private readonly editor = viewChild.required<NotectlEditorComponent>('editor');\n *   private readonly service = inject(NotectlEditorService);\n *\n *   constructor() {\n *     afterNextRender(() => {\n *       this.service.register(this.editor());\n *     });\n *   }\n * }\n * ```\n */\n@Injectable()\nexport class NotectlEditorService {\n\tprivate readonly destroyRef: DestroyRef = inject(DestroyRef);\n\tprivate readonly editorRef = signal<NotectlEditorComponent | null>(null);\n\tprivate readonly stateChangeSubject = new Subject<StateChangeEvent>();\n\n\t/** Whether an editor is currently registered with this service. */\n\treadonly hasEditor = computed<boolean>(() => this.editorRef() !== null);\n\n\t/** Observable stream of state change events from the editor. */\n\treadonly stateChanges$: Observable<StateChangeEvent> = this.stateChangeSubject.asObservable();\n\n\tprivate stateChangeSub: { unsubscribe(): void } | null = null;\n\n\tconstructor() {\n\t\tthis.destroyRef.onDestroy(() => {\n\t\t\tthis.unregister();\n\t\t\tthis.stateChangeSubject.complete();\n\t\t});\n\t}\n\n\t/** Registers an editor component with this service. */\n\tregister(editor: NotectlEditorComponent): void {\n\t\tthis.unregister();\n\t\tthis.editorRef.set(editor);\n\n\t\tthis.stateChangeSub = editor.stateChange.subscribe((event: StateChangeEvent) => {\n\t\t\tthis.stateChangeSubject.next(event);\n\t\t});\n\t}\n\n\t/** Unregisters the current editor from this service. */\n\tunregister(): void {\n\t\tthis.stateChangeSub?.unsubscribe();\n\t\tthis.stateChangeSub = null;\n\t\tthis.editorRef.set(null);\n\t}\n\n\t/** Executes a named command on the registered editor. */\n\texecuteCommand(name: string): boolean {\n\t\tconst editor: NotectlEditorComponent | null = this.editorRef();\n\t\tif (!editor) return false;\n\t\treturn editor.executeCommand(name);\n\t}\n\n\t/** Returns the current editor state, or `null` if no editor is registered. */\n\tgetState(): EditorState | null {\n\t\tconst editor: NotectlEditorComponent | null = this.editorRef();\n\t\tif (!editor) return null;\n\t\ttry {\n\t\t\treturn editor.getState();\n\t\t} catch {\n\t\t\treturn null;\n\t\t}\n\t}\n\n\t/** Dispatches a transaction on the registered editor. */\n\tdispatch(tr: Transaction): void {\n\t\tthis.editorRef()?.dispatch(tr);\n\t}\n}\n","/**\n * @notectl/angular — Angular integration for the notectl rich text editor.\n * @packageDocumentation\n */\n\n// --- Angular Bindings ---\nexport { NotectlEditorComponent } from './lib/notectl-editor.component';\nexport { NotectlValueAccessorDirective } from './lib/value-accessor.directive';\nexport { NotectlEditorService } from './lib/notectl-editor.service';\n\n// --- Provider Function ---\nexport {\n\tprovideNotectl,\n\ttype NotectlProviderOptions,\n} from './lib/tokens';\n\n// --- Injection Tokens ---\nexport {\n\tNOTECTL_DEFAULT_CONFIG,\n\tNOTECTL_CONTENT_FORMAT,\n\ttype ContentFormat,\n} from './lib/tokens';\n\n// --- Angular-specific Types ---\nexport type { SelectionChangeEvent } from './lib/types';\n\n// --- Re-exports from @notectl/core (convenience) ---\n\n// Model types\nexport type {\n\tDocument,\n\tBlockNode,\n\tTextNode,\n\tInlineNode,\n\tMark,\n\tBlockAttrs,\n} from '@notectl/core';\n\n// Selection types\nexport type { EditorSelection, Position, Selection } from '@notectl/core';\n\n// State types\nexport type {\n\tEditorState,\n\tTransaction,\n\tTransactionMetadata,\n\tStateChangeEvent,\n} from '@notectl/core';\n\n// Plugin types\nexport type { Plugin, PluginConfig, PluginContext } from '@notectl/core';\n\n// Theme types\nexport type { Theme, PartialTheme, ThemePrimitives } from '@notectl/core';\nexport { ThemePreset, LIGHT_THEME, DARK_THEME, createTheme } from '@notectl/core';\n\n// Editor config\nexport type {\n\tNotectlEditorConfig,\n\tTextFormattingConfig,\n} from '@notectl/core';\n\n// Plugin config types\nexport type { FontDefinition } from '@notectl/core';\n\n// Starter fonts\n/** @deprecated Import from '@notectl/core/fonts' instead. */\nexport { STARTER_FONTS } from '@notectl/core/fonts';\n\n// Plugins (tree-shakable re-exports)\nexport {\n\tTextFormattingPlugin,\n\tHeadingPlugin,\n\tListPlugin,\n\tLinkPlugin,\n\tBlockquotePlugin,\n\tCodeBlockPlugin,\n\tTablePlugin,\n\tImagePlugin,\n\tHorizontalRulePlugin,\n\tHardBreakPlugin,\n\tStrikethroughPlugin,\n\tHighlightPlugin,\n\tTextColorPlugin,\n\tFontPlugin,\n\tFontSizePlugin,\n\tAlignmentPlugin,\n\tSuperSubPlugin,\n\tToolbarPlugin,\n} from '@notectl/core';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":"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"}

package/dist/types/notectl-angular-testing.d.ts

@@ -0,0 +1,38 @@
+import { ComponentFixture } from '@angular/core/testing';
+import { NotectlEditorComponent } from '@notectl/angular';
+
+/**
+ * Test harness for `NotectlEditorComponent` in consumer tests.
+ *
+ * Wraps a `ComponentFixture` and provides convenience methods
+ * for common test operations.
+ *
+ * @example
+ * ```typescript
+ * const fixture = TestBed.createComponent(NotectlEditorComponent);
+ * const harness = new NotectlTestHarness(fixture);
+ * await harness.whenReady();
+ * harness.setHTML('<p>Hello</p>');
+ * expect(harness.getText()).toBe('Hello');
+ * ```
+ */
+declare class NotectlTestHarness {
+    private readonly fixture;
+    constructor(fixture: ComponentFixture<NotectlEditorComponent>);
+    /** Returns the component instance. */
+    get component(): NotectlEditorComponent;
+    /** Waits for the editor to be ready and triggers change detection. */
+    whenReady(): Promise<void>;
+    /** Executes a command and triggers change detection. */
+    executeCommand(name: string): boolean;
+    /** Sets HTML content and triggers change detection. */
+    setHTML(html: string): void;
+    /** Returns the current HTML content. */
+    getHTML(): string;
+    /** Returns the current plain text content. */
+    getText(): string;
+    /** Returns whether the editor is empty. */
+    get isEmpty(): boolean;
+}
+
+export { NotectlTestHarness };

package/dist/types/notectl-angular.d.ts

@@ -0,0 +1,241 @@
+import * as _angular_core from '@angular/core';
+import { ModelSignal, InjectionToken, EnvironmentProviders } from '@angular/core';
+import { EditorSelection, Plugin, TextFormattingConfig, ThemePreset, Theme, Document, StateChangeEvent, EditorState, NotectlEditor, PluginConfig, Transaction, NotectlEditorConfig } from '@notectl/core';
+export { AlignmentPlugin, BlockAttrs, BlockNode, BlockquotePlugin, CodeBlockPlugin, DARK_THEME, Document, EditorSelection, EditorState, FontDefinition, FontPlugin, FontSizePlugin, HardBreakPlugin, HeadingPlugin, HighlightPlugin, HorizontalRulePlugin, ImagePlugin, InlineNode, LIGHT_THEME, LinkPlugin, ListPlugin, Mark, NotectlEditorConfig, PartialTheme, Plugin, PluginConfig, PluginContext, Position, Selection, StateChangeEvent, StrikethroughPlugin, SuperSubPlugin, TablePlugin, TextColorPlugin, TextFormattingConfig, TextFormattingPlugin, TextNode, Theme, ThemePreset, ThemePrimitives, ToolbarPlugin, Transaction, TransactionMetadata, createTheme } from '@notectl/core';
+import { ControlValueAccessor } from '@angular/forms';
+import { Observable } from 'rxjs';
+export { STARTER_FONTS } from '@notectl/core/fonts';
+
+/** Event payload emitted on selection changes. */
+interface SelectionChangeEvent {
+    readonly selection: EditorSelection;
+}
+
+/**
+ * Angular standalone component wrapping the `<ntl-editor>` Web Component.
+ *
+ * Uses `afterNextRender()` for SSR-safe initialization and `effect()` for
+ * reactive input tracking — no lifecycle interfaces needed.
+ *
+ * @example
+ * ```html
+ * <!-- Basic usage -->
+ * <ntl-editor [toolbar]="toolbar" [plugins]="plugins" />
+ *
+ * <!-- Two-way content binding -->
+ * <ntl-editor [(content)]="myDocument" [toolbar]="toolbar" />
+ *
+ * <!-- Reactive forms -->
+ * <ntl-editor [formControl]="editorControl" [toolbar]="toolbar" />
+ * ```
+ */
+declare class NotectlEditorComponent {
+    private readonly destroyRef;
+    private readonly defaultConfig;
+    readonly plugins: _angular_core.InputSignal<Plugin<Record<string, unknown>>[]>;
+    readonly toolbar: _angular_core.InputSignal<readonly (readonly Plugin<Record<string, unknown>>[])[]>;
+    readonly features: _angular_core.InputSignal<Partial<TextFormattingConfig>>;
+    readonly placeholder: _angular_core.InputSignal<string>;
+    readonly readonlyMode: _angular_core.InputSignal<boolean>;
+    readonly autofocus: _angular_core.InputSignal<boolean>;
+    readonly maxHistoryDepth: _angular_core.InputSignal<number>;
+    readonly theme: _angular_core.InputSignal<ThemePreset | Theme>;
+    /**
+     * Two-way bindable document content.
+     *
+     * `undefined` means no external content was provided — the editor manages
+     * its own state. Once the editor emits changes, the model updates to the
+     * current `Document`.
+     *
+     * @example
+     * ```html
+     * <ntl-editor [(content)]="myDocument" />
+     * ```
+     */
+    readonly content: ModelSignal<Document | undefined>;
+    readonly stateChange: _angular_core.OutputEmitterRef<StateChangeEvent>;
+    readonly selectionChange: _angular_core.OutputEmitterRef<SelectionChangeEvent>;
+    readonly editorFocus: _angular_core.OutputEmitterRef<void>;
+    readonly editorBlur: _angular_core.OutputEmitterRef<void>;
+    readonly ready: _angular_core.OutputEmitterRef<void>;
+    readonly editorState: _angular_core.WritableSignal<EditorState>;
+    readonly isEmpty: _angular_core.Signal<boolean>;
+    private readonly hostRef;
+    private editorRef;
+    private readyResolve;
+    private readonly readyPromise;
+    private readonly initialized;
+    /** Tracks the last document set from within the editor to prevent feedback loops. */
+    private lastEditorDoc;
+    constructor();
+    /** Returns the document as JSON. */
+    getJSON(): Document;
+    /** Sets the document from JSON. */
+    setJSON(doc: Document): void;
+    /** Returns sanitized HTML representation of the document. */
+    getHTML(): string;
+    /** Sets content from HTML (sanitized). */
+    setHTML(html: string): void;
+    /** Returns plain text content. */
+    getText(): string;
+    /** Proxy to the Web Component's `commands` object. */
+    get commands(): NotectlEditor['commands'];
+    /** Proxy to the Web Component's `can()` capability checker. */
+    can(): ReturnType<NotectlEditor['can']>;
+    /** Executes a named command registered by a plugin. */
+    executeCommand(name: string): boolean;
+    /** Configures a plugin at runtime. */
+    configurePlugin(pluginId: string, config: PluginConfig): void;
+    /** Dispatches a transaction. */
+    dispatch(tr: Transaction): void;
+    /** Returns the current editor state. */
+    getState(): EditorState;
+    /** Changes the theme at runtime. */
+    setTheme(theme: ThemePreset | Theme): void;
+    /** Returns the current theme setting. */
+    getTheme(): ThemePreset | Theme;
+    /** Sets the readonly state programmatically (used by ControlValueAccessor). */
+    setReadonly(readonlyState: boolean): void;
+    /** Resolves when the editor is ready. */
+    whenReady(): Promise<void>;
+    private initEditor;
+    private buildConfig;
+    /** Syncs editor document changes to the content model without feedback loops. */
+    private syncContentModel;
+    private destroyEditor;
+    private requireEditor;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotectlEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<NotectlEditorComponent, "ntl-editor", never, { "plugins": { "alias": "plugins"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "features": { "alias": "features"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "readonlyMode": { "alias": "readonlyMode"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; "maxHistoryDepth": { "alias": "maxHistoryDepth"; "required": false; "isSignal": true; }; "theme": { "alias": "theme"; "required": false; "isSignal": true; }; "content": { "alias": "content"; "required": false; "isSignal": true; }; }, { "content": "contentChange"; "stateChange": "stateChange"; "selectionChange": "selectionChange"; "editorFocus": "editorFocus"; "editorBlur": "editorBlur"; "ready": "ready"; }, never, never, true, never>;
+}
+
+type OnChangeFn = (value: Document | string | null) => void;
+type OnTouchedFn = () => void;
+/**
+ * `ControlValueAccessor` directive for Angular forms integration.
+ *
+ * Supports Reactive Forms (`formControl`, `formControlName`) and
+ * template-driven forms (`ngModel`).
+ *
+ * The content format is configurable via `provideNotectl({ contentFormat })` or
+ * the `NOTECTL_CONTENT_FORMAT` injection token:
+ * - `'json'` (default) — form value is a `Document` object
+ * - `'html'` — form value is a sanitized HTML string
+ * - `'text'` — form value is a plain text string
+ */
+declare class NotectlValueAccessorDirective implements ControlValueAccessor {
+    private readonly editor;
+    private readonly destroyRef;
+    private readonly format;
+    private onChange;
+    private onTouched;
+    private pendingValue;
+    private suppressEmit;
+    private readonly stateChangeSub;
+    private readonly blurSub;
+    constructor();
+    writeValue(value: Document | string | null): void;
+    registerOnChange(fn: OnChangeFn): void;
+    registerOnTouched(fn: OnTouchedFn): void;
+    setDisabledState(isDisabled: boolean): void;
+    private writeValueToEditor;
+    private readValue;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotectlValueAccessorDirective, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<NotectlValueAccessorDirective, "ntl-editor[formControl], ntl-editor[formControlName], ntl-editor[ngModel]", never, {}, {}, never, never, true, never>;
+}
+
+/**
+ * Optional injectable service for programmatic editor access via DI.
+ *
+ * Useful when a toolbar or other component needs to interact with
+ * the editor without a direct template reference.
+ *
+ * The service must be provided at a shared injector level and
+ * connected to the editor component via `register()`.
+ *
+ * @example
+ * ```typescript
+ * @Component({
+ *   providers: [NotectlEditorService],
+ *   template: `
+ *     <app-toolbar />
+ *     <ntl-editor #editor [plugins]="plugins" />
+ *   `,
+ * })
+ * export class EditorPage {
+ *   private readonly editor = viewChild.required<NotectlEditorComponent>('editor');
+ *   private readonly service = inject(NotectlEditorService);
+ *
+ *   constructor() {
+ *     afterNextRender(() => {
+ *       this.service.register(this.editor());
+ *     });
+ *   }
+ * }
+ * ```
+ */
+declare class NotectlEditorService {
+    private readonly destroyRef;
+    private readonly editorRef;
+    private readonly stateChangeSubject;
+    /** Whether an editor is currently registered with this service. */
+    readonly hasEditor: _angular_core.Signal<boolean>;
+    /** Observable stream of state change events from the editor. */
+    readonly stateChanges$: Observable<StateChangeEvent>;
+    private stateChangeSub;
+    constructor();
+    /** Registers an editor component with this service. */
+    register(editor: NotectlEditorComponent): void;
+    /** Unregisters the current editor from this service. */
+    unregister(): void;
+    /** Executes a named command on the registered editor. */
+    executeCommand(name: string): boolean;
+    /** Returns the current editor state, or `null` if no editor is registered. */
+    getState(): EditorState | null;
+    /** Dispatches a transaction on the registered editor. */
+    dispatch(tr: Transaction): void;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<NotectlEditorService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<NotectlEditorService>;
+}
+
+/**
+ * Default configuration applied to all `<notectl-editor>` instances within
+ * the injector scope. Component-level inputs override these defaults.
+ */
+declare const NOTECTL_DEFAULT_CONFIG: InjectionToken<Partial<NotectlEditorConfig>>;
+/**
+ * Content format used by the `ControlValueAccessor` for forms integration.
+ * Determines how editor content is serialized when reading/writing form values.
+ *
+ * - `'json'` — `Document` objects (default)
+ * - `'html'` — sanitized HTML strings
+ * - `'text'` — plain text strings
+ */
+declare const NOTECTL_CONTENT_FORMAT: InjectionToken<ContentFormat>;
+/** Supported content serialization formats for forms integration. */
+type ContentFormat = 'json' | 'html' | 'text';
+/** Options for `provideNotectl()`. */
+interface NotectlProviderOptions {
+    /** Default editor configuration applied to all instances. */
+    readonly config?: Partial<NotectlEditorConfig>;
+    /** Content serialization format for forms integration. Defaults to `'json'`. */
+    readonly contentFormat?: ContentFormat;
+}
+/**
+ * Configures the notectl editor at the environment injector level.
+ *
+ * @example
+ * ```typescript
+ * bootstrapApplication(App, {
+ *   providers: [
+ *     provideNotectl({
+ *       config: { theme: ThemePreset.Light, placeholder: 'Start typing...' },
+ *       contentFormat: 'json',
+ *     }),
+ *   ],
+ * });
+ * ```
+ */
+declare function provideNotectl(options?: NotectlProviderOptions): EnvironmentProviders;
+
+export { NOTECTL_CONTENT_FORMAT, NOTECTL_DEFAULT_CONFIG, NotectlEditorComponent, NotectlEditorService, NotectlValueAccessorDirective, provideNotectl };
+export type { ContentFormat, NotectlProviderOptions, SelectionChangeEvent };

package/package.json

@@ -1,55 +1,58 @@
 {
-  "name": "@notectl/angular",
-  "version": "1.0.3",
-  "description": "Angular integration for the notectl rich text editor. Provides a standalone component, reactive forms support, and DI service.",
-  "license": "MIT",
-  "type": "module",
-  "module": "fesm2022/notectl-angular.mjs",
-  "typings": "types/notectl-angular.d.ts",
-  "sideEffects": false,
-  "files": [
-    "dist",
-    "README.md"
-  ],
-  "keywords": [
-    "angular",
-    "rich-text-editor",
-    "notectl",
-    "web-component",
-    "editor",
-    "wysiwyg",
-    "reactive-forms",
-    "signals"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/Samyssmile/notectl.git",
-    "directory": "packages/angular"
-  },
-  "homepage": "https://github.com/Samyssmile/notectl",
-  "bugs": {
-    "url": "https://github.com/Samyssmile/notectl/issues"
-  },
-  "dependencies": {
-    "tslib": "^2.3.0"
-  },
-  "peerDependencies": {
-    "@angular/core": ">=21.0.0",
-    "@angular/forms": ">=21.0.0",
-    "@notectl/core": "^1.0.0",
-    "rxjs": ">=7.0.0"
-  },
-  "exports": {
-    "./package.json": {
-      "default": "./package.json"
-    },
-    ".": {
-      "types": "./types/notectl-angular.d.ts",
-      "default": "./fesm2022/notectl-angular.mjs"
-    },
-    "./testing": {
-      "types": "./types/notectl-angular-testing.d.ts",
-      "default": "./fesm2022/notectl-angular-testing.mjs"
-    }
-  }
-}
+	"name": "@notectl/angular",
+	"version": "1.0.5",
+	"description": "Angular integration for the notectl rich text editor. Provides a standalone component, reactive forms support, and DI service.",
+	"license": "MIT",
+	"type": "module",
+	"module": "./dist/fesm2022/notectl-angular.mjs",
+	"typings": "./dist/types/notectl-angular.d.ts",
+	"sideEffects": false,
+	"files": ["dist", "README.md"],
+	"keywords": [
+		"angular",
+		"rich-text-editor",
+		"notectl",
+		"web-component",
+		"editor",
+		"wysiwyg",
+		"reactive-forms",
+		"signals"
+	],
+	"repository": {
+		"type": "git",
+		"url": "https://github.com/Samyssmile/notectl.git",
+		"directory": "packages/angular"
+	},
+	"homepage": "https://github.com/Samyssmile/notectl",
+	"bugs": {
+		"url": "https://github.com/Samyssmile/notectl/issues"
+	},
+	"scripts": {
+		"build": "ng-packagr -p ng-package.json",
+		"test": "vitest run",
+		"test:watch": "vitest",
+		"typecheck": "tsc --noEmit"
+	},
+	"dependencies": {
+		"tslib": "^2.3.0"
+	},
+	"peerDependencies": {
+		"@angular/core": ">=21.0.0",
+		"@angular/forms": ">=21.0.0",
+		"@notectl/core": "^1.0.0",
+		"rxjs": ">=7.0.0"
+	},
+	"devDependencies": {
+		"@angular/compiler": "^21.0.0",
+		"@angular/compiler-cli": "^21.0.0",
+		"@angular/core": "^21.0.0",
+		"@angular/forms": "^21.0.0",
+		"@angular/platform-browser": "^21.0.0",
+		"@angular/platform-browser-dynamic": "^21.0.0",
+		"@notectl/core": "workspace:*",
+		"ng-packagr": "^21.0.0",
+		"rxjs": "~7.8.0",
+		"vite": "^6.0.0",
+		"vitest": "^4.0.0"
+	}
+}