@malva-ui/editor 0.1.13 → 0.1.14

package/esm2022/lib/editor-toolbar-context.js

@@ -1,259 +0,0 @@
-import { Injectable, InjectionToken, signal } from '@angular/core';
-import * as i0 from "@angular/core";
-/** Injects the command state belonging to the nearest `mlv-editor`. */
-export const MLV_EDITOR_TOOLBAR_CONTEXT = new InjectionToken('MLV_EDITOR_TOOLBAR_CONTEXT');
-/** @internal Per-editor invalidation state for built-in toolbar rendering. */
-export class MlvEditorToolbarRevision {
-    /** @internal Increments after every Tiptap transaction or selection update. */
-    revision = signal(0, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "revision" }] : /* istanbul ignore next */ []));
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorToolbarRevision, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorToolbarRevision });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorToolbarRevision, decorators: [{
-            type: Injectable
-        }] });
-/** @internal Supplies the built-in toolbar's per-editor invalidation signal. */
-export const MLV_EDITOR_TOOLBAR_REVISION = new InjectionToken('MLV_EDITOR_TOOLBAR_REVISION');
-/** @internal Projected editor-toolbar widgets share this editor-scoped roving registry. */
-export class MlvEditorToolbarRovingRegistry {
-    _widgets = signal([], /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "_widgets" }] : /* istanbul ignore next */ []));
-    _active = signal(null, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "_active" }] : /* istanbul ignore next */ []));
-    _disabled = signal(false, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "_disabled" }] : /* istanbul ignore next */ []));
-    _domStateRevision = signal(0, /* @ts-ignore */
-    ...(ngDevMode ? [{ debugName: "_domStateRevision" }] : /* istanbul ignore next */ []));
-    _observer;
-    _root;
-    _hasInteracted = false;
-    register(widget) {
-        this._widgets.update((widgets) => [...widgets, widget]);
-        this._observeStateChanges();
-        if (!this._active())
-            this._active.set(widget);
-        queueMicrotask(() => {
-            if (!this._hasInteracted)
-                this._focusFirstWidget();
-        });
-        return () => {
-            this._widgets.update((widgets) => widgets.filter((item) => item !== widget));
-            if (this._active() === widget) {
-                this._focusFirstWidget();
-            }
-            if (!this._widgets().length)
-                this._disconnectObserver();
-        };
-    }
-    /** @internal Resolves the single effective tab stop, even during DOM mutations. */
-    isActive(widget) {
-        this._domStateRevision();
-        const active = this._active();
-        const effectiveActive = active && this._enabled(active)
-            ? active
-            : (this._enabledWidgets()[0] ?? null);
-        return (!this._disabled() && effectiveActive === widget && this._enabled(widget));
-    }
-    activate(widget) {
-        if (this._widgets().includes(widget) && this._enabled(widget)) {
-            this._hasInteracted = true;
-            this._active.set(widget);
-        }
-    }
-    connect(root) {
-        this._root = root;
-        this._observeStateChanges();
-        return () => {
-            if (this._root === root) {
-                this._root = undefined;
-                this._disconnectObserver();
-            }
-        };
-    }
-    setDisabled(disabled) {
-        this._disabled.set(disabled);
-        if (!disabled)
-            this._synchronizeActiveWidget();
-    }
-    focusBoundary(boundary) {
-        if (this._disabled())
-            return;
-        const widgets = this._enabledWidgets();
-        const target = boundary === 'start' ? widgets[0] : widgets[widgets.length - 1];
-        if (!target)
-            return;
-        this.activate(target);
-        target.focus();
-    }
-    move(current, direction, wrap) {
-        if (this._disabled())
-            return;
-        const widgets = this._enabledWidgets();
-        if (!widgets.length)
-            return;
-        const index = Math.max(0, widgets.indexOf(current));
-        const nextIndex = index + direction;
-        const target = wrap
-            ? widgets[(nextIndex + widgets.length) % widgets.length]
-            : widgets[Math.min(Math.max(nextIndex, 0), widgets.length - 1)];
-        if (!target)
-            return;
-        this.activate(target);
-        target.focus();
-    }
-    _enabled(widget) {
-        return (!widget.closest('[hidden]') &&
-            !widget.hasAttribute('disabled') &&
-            widget.getAttribute('aria-disabled') !== 'true');
-    }
-    _enabledWidgets() {
-        return this._widgets()
-            .filter((widget) => this._enabled(widget))
-            .sort((left, right) => {
-            const position = left.compareDocumentPosition(right);
-            return position & 4 ? -1 : position & 2 ? 1 : 0;
-        });
-    }
-    _observeStateChanges() {
-        if (this._observer ||
-            typeof MutationObserver === 'undefined' ||
-            !this._root ||
-            typeof Node === 'undefined' ||
-            !(this._root instanceof Node)) {
-            return;
-        }
-        this._observer = new MutationObserver(() => {
-            this._domStateRevision.update((revision) => revision + 1);
-            this._synchronizeActiveWidget();
-        });
-        this._observer.observe(this._root, {
-            attributes: true,
-            attributeFilter: ['aria-disabled', 'disabled', 'hidden'],
-            childList: true,
-            subtree: true,
-        });
-    }
-    _synchronizeActiveWidget() {
-        const active = this._active();
-        if (active && this._enabled(active))
-            return;
-        this._focusFirstWidget();
-    }
-    _focusFirstWidget() {
-        this._active.set(this._enabledWidgets()[0] ?? null);
-    }
-    _disconnectObserver() {
-        this._observer?.disconnect();
-        this._observer = undefined;
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorToolbarRovingRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorToolbarRovingRegistry });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorToolbarRovingRegistry, decorators: [{
-            type: Injectable
-        }] });
-/** @internal Resolves the nearest editor's projected-toolbar roving registry. */
-export const MLV_EDITOR_TOOLBAR_ROVING = new InjectionToken('MLV_EDITOR_TOOLBAR_ROVING');
-/**
- * Internal per-editor registry for CDK overlay roots owned by toolbar controls.
- * It is intentionally excluded from the public barrel: public controls use it
- * only to preserve the editor's composite focus boundary.
- */
-export class MlvEditorOverlayRegistry {
-    _entries = new Map();
-    _onFocusIn;
-    _onFocusOut;
-    /** @internal Wires the nearest editor's composite focus handlers. */
-    setFocusHandlers(onFocusIn, onFocusOut) {
-        this._onFocusIn = onFocusIn;
-        this._onFocusOut = onFocusOut;
-    }
-    /** @internal Registers a rendered overlay root and returns its teardown. */
-    register(root, close) {
-        const existing = this._entries.get(root);
-        if (existing) {
-            existing.close = close;
-            return () => this._remove(root);
-        }
-        const onFocusIn = (event) => this._onFocusIn?.(event);
-        const onFocusOut = (event) => this._onFocusOut?.(event);
-        const entry = { root, close, onFocusIn, onFocusOut };
-        this._entries.set(root, entry);
-        root.addEventListener('focusin', onFocusIn, true);
-        root.addEventListener('focusout', onFocusOut, true);
-        return () => this._remove(root);
-    }
-    /** @internal Whether a node is rendered in an editor-owned overlay. */
-    contains(node) {
-        if (!node)
-            return false;
-        return [...this._entries.values()].some((entry) => entry.root.contains(node));
-    }
-    /** @internal Closes all owned overlays and removes their listeners. */
-    closeAll() {
-        for (const entry of [...this._entries.values()]) {
-            try {
-                entry.close();
-            }
-            catch {
-                // A third-party overlay must not prevent remaining editor cleanup.
-            }
-            finally {
-                this._remove(entry.root);
-            }
-        }
-    }
-    /** @internal Removes listener resources without invoking overlay close callbacks. */
-    destroy() {
-        for (const entry of [...this._entries.values()])
-            this._remove(entry.root);
-    }
-    _remove(root) {
-        const entry = this._entries.get(root);
-        if (!entry)
-            return;
-        this._entries.delete(root);
-        entry.root.removeEventListener('focusin', entry.onFocusIn, true);
-        entry.root.removeEventListener('focusout', entry.onFocusOut, true);
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorOverlayRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorOverlayRegistry });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorOverlayRegistry, decorators: [{
-            type: Injectable
-        }] });
-/** @internal Injection token for editor-owned overlay registration. */
-export const MLV_EDITOR_OVERLAY_REGISTRY = new InjectionToken('MLV_EDITOR_OVERLAY_REGISTRY');
-/**
- * Internal per-editor abort registry for uploads that outlive an interaction.
- * It remains non-public until the upload coordinator consumes it in Task 11.
- */
-export class MlvEditorUploadAbortRegistry {
-    _aborters = new Set();
-    /** @internal Registers one in-flight upload abort callback. */
-    register(abort) {
-        this._aborters.add(abort);
-        return () => this._aborters.delete(abort);
-    }
-    /** @internal Aborts every registered upload without allowing one failure to stop cleanup. */
-    abortAll() {
-        for (const abort of [...this._aborters]) {
-            this._aborters.delete(abort);
-            try {
-                abort();
-            }
-            catch {
-                // A transport abort is best effort; all remaining uploads still stop.
-            }
-        }
-    }
-    static ɵfac = i0.ɵɵngDeclareFactory({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorUploadAbortRegistry, deps: [], target: i0.ɵɵFactoryTarget.Injectable });
-    static ɵprov = i0.ɵɵngDeclareInjectable({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorUploadAbortRegistry });
-}
-i0.ɵɵngDeclareClassMetadata({ minVersion: "12.0.0", version: "22.0.7", ngImport: i0, type: MlvEditorUploadAbortRegistry, decorators: [{
-            type: Injectable
-        }] });
-/** @internal Injection token for the editor-owned upload abort registry. */
-export const MLV_EDITOR_UPLOAD_ABORT_REGISTRY = new InjectionToken('MLV_EDITOR_UPLOAD_ABORT_REGISTRY');
-//# sourceMappingURL=editor-toolbar-context.js.map

package/esm2022/lib/editor-toolbar-context.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"editor-toolbar-context.js","sourceRoot":"","sources":["../../../../../libs/editor/src/lib/editor-toolbar-context.ts"],"names":[],"mappings":"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","sourcesContent":["import { Injectable, InjectionToken, signal } from '@angular/core';\nimport type { Signal, WritableSignal } from '@angular/core';\nimport type { Editor } from '@tiptap/core';\nimport type {\n  MlvEditorError,\n  MlvEditorFormat,\n  MlvEditorImageUploadControl,\n} from './editor.types';\n\n/**\n * Editor-scoped command state made available to toolbar and projected controls.\n *\n * Commands are deliberately supplied as callbacks so Malva does not conceal\n * Tiptap's API or constrain third-party extensions.\n */\nexport interface MlvEditorToolbarContext {\n  /** The editor instance owned by the nearest editor shell. */\n  readonly editor: Signal<Editor | null>;\n  /** Whether every interactive command surface is disabled. */\n  readonly disabled: Signal<boolean>;\n  /** Whether document mutation commands are unavailable. */\n  readonly readonly: Signal<boolean>;\n  /** Whether focus is currently inside the editor composite. */\n  readonly focused: Signal<boolean>;\n  /** Whether the owner has an editor and permits document mutation. */\n  readonly editable: Signal<boolean>;\n  /** The current serialization format. */\n  readonly format: Signal<MlvEditorFormat>;\n  /** View-only editor zoom percentage. */\n  readonly zoom: WritableSignal<number>;\n  /** Optional editor-owned image upload capability for standalone toolbars. */\n  readonly imageUpload?: MlvEditorImageUploadControl;\n  /** Runs a mutation command without allowing unavailable commands to throw. */\n  run(command: (editor: Editor) => boolean): boolean;\n  /** Checks a command without allowing unavailable commands to throw. */\n  can(command: (editor: Editor) => boolean): boolean;\n  /** Safely reads a Tiptap active state. */\n  isActive(name: string, attributes?: Record<string, unknown>): boolean;\n  /** Reports a typed recoverable error through the owning editor. */\n  reportError(error: MlvEditorError): void;\n}\n\n/** Injects the command state belonging to the nearest `mlv-editor`. */\nexport const MLV_EDITOR_TOOLBAR_CONTEXT =\n  new InjectionToken<MlvEditorToolbarContext>('MLV_EDITOR_TOOLBAR_CONTEXT');\n\n/** @internal Per-editor invalidation state for built-in toolbar rendering. */\n@Injectable()\nexport class MlvEditorToolbarRevision {\n  /** @internal Increments after every Tiptap transaction or selection update. */\n  readonly revision = signal(0);\n}\n\n/** @internal Supplies the built-in toolbar's per-editor invalidation signal. */\nexport const MLV_EDITOR_TOOLBAR_REVISION = new InjectionToken<Signal<number>>(\n  'MLV_EDITOR_TOOLBAR_REVISION',\n);\n\n/** @internal Projected editor-toolbar widgets share this editor-scoped roving registry. */\n@Injectable()\nexport class MlvEditorToolbarRovingRegistry {\n  private readonly _widgets = signal<readonly HTMLElement[]>([]);\n  private readonly _active = signal<HTMLElement | null>(null);\n  private readonly _disabled = signal(false);\n  private readonly _domStateRevision = signal(0);\n  private _observer: MutationObserver | undefined;\n  private _root: HTMLElement | undefined;\n  private _hasInteracted = false;\n\n  register(widget: HTMLElement): () => void {\n    this._widgets.update((widgets) => [...widgets, widget]);\n    this._observeStateChanges();\n    if (!this._active()) this._active.set(widget);\n    queueMicrotask(() => {\n      if (!this._hasInteracted) this._focusFirstWidget();\n    });\n    return () => {\n      this._widgets.update((widgets) =>\n        widgets.filter((item) => item !== widget),\n      );\n      if (this._active() === widget) {\n        this._focusFirstWidget();\n      }\n      if (!this._widgets().length) this._disconnectObserver();\n    };\n  }\n\n  /** @internal Resolves the single effective tab stop, even during DOM mutations. */\n  isActive(widget: HTMLElement): boolean {\n    this._domStateRevision();\n    const active = this._active();\n    const effectiveActive =\n      active && this._enabled(active)\n        ? active\n        : (this._enabledWidgets()[0] ?? null);\n    return (\n      !this._disabled() && effectiveActive === widget && this._enabled(widget)\n    );\n  }\n\n  activate(widget: HTMLElement): void {\n    if (this._widgets().includes(widget) && this._enabled(widget)) {\n      this._hasInteracted = true;\n      this._active.set(widget);\n    }\n  }\n\n  connect(root: HTMLElement): () => void {\n    this._root = root;\n    this._observeStateChanges();\n    return () => {\n      if (this._root === root) {\n        this._root = undefined;\n        this._disconnectObserver();\n      }\n    };\n  }\n\n  setDisabled(disabled: boolean): void {\n    this._disabled.set(disabled);\n    if (!disabled) this._synchronizeActiveWidget();\n  }\n\n  focusBoundary(boundary: 'start' | 'end'): void {\n    if (this._disabled()) return;\n    const widgets = this._enabledWidgets();\n    const target =\n      boundary === 'start' ? widgets[0] : widgets[widgets.length - 1];\n    if (!target) return;\n    this.activate(target);\n    target.focus();\n  }\n\n  move(current: HTMLElement, direction: -1 | 1, wrap: boolean): void {\n    if (this._disabled()) return;\n    const widgets = this._enabledWidgets();\n    if (!widgets.length) return;\n    const index = Math.max(0, widgets.indexOf(current));\n    const nextIndex = index + direction;\n    const target = wrap\n      ? widgets[(nextIndex + widgets.length) % widgets.length]\n      : widgets[Math.min(Math.max(nextIndex, 0), widgets.length - 1)];\n    if (!target) return;\n    this.activate(target);\n    target.focus();\n  }\n\n  private _enabled(widget: HTMLElement): boolean {\n    return (\n      !widget.closest('[hidden]') &&\n      !widget.hasAttribute('disabled') &&\n      widget.getAttribute('aria-disabled') !== 'true'\n    );\n  }\n\n  private _enabledWidgets(): readonly HTMLElement[] {\n    return this._widgets()\n      .filter((widget) => this._enabled(widget))\n      .sort((left, right) => {\n        const position = left.compareDocumentPosition(right);\n        return position & 4 ? -1 : position & 2 ? 1 : 0;\n      });\n  }\n\n  private _observeStateChanges(): void {\n    if (\n      this._observer ||\n      typeof MutationObserver === 'undefined' ||\n      !this._root ||\n      typeof Node === 'undefined' ||\n      !(this._root instanceof Node)\n    ) {\n      return;\n    }\n    this._observer = new MutationObserver(() => {\n      this._domStateRevision.update((revision) => revision + 1);\n      this._synchronizeActiveWidget();\n    });\n    this._observer.observe(this._root, {\n      attributes: true,\n      attributeFilter: ['aria-disabled', 'disabled', 'hidden'],\n      childList: true,\n      subtree: true,\n    });\n  }\n\n  private _synchronizeActiveWidget(): void {\n    const active = this._active();\n    if (active && this._enabled(active)) return;\n    this._focusFirstWidget();\n  }\n\n  private _focusFirstWidget(): void {\n    this._active.set(this._enabledWidgets()[0] ?? null);\n  }\n\n  private _disconnectObserver(): void {\n    this._observer?.disconnect();\n    this._observer = undefined;\n  }\n}\n\n/** @internal Resolves the nearest editor's projected-toolbar roving registry. */\nexport const MLV_EDITOR_TOOLBAR_ROVING =\n  new InjectionToken<MlvEditorToolbarRovingRegistry>(\n    'MLV_EDITOR_TOOLBAR_ROVING',\n  );\n\ninterface MlvEditorOverlayEntry {\n  readonly root: HTMLElement;\n  close: () => void;\n  readonly onFocusIn: (event: FocusEvent) => void;\n  readonly onFocusOut: (event: FocusEvent) => void;\n}\n\n/**\n * Internal per-editor registry for CDK overlay roots owned by toolbar controls.\n * It is intentionally excluded from the public barrel: public controls use it\n * only to preserve the editor's composite focus boundary.\n */\n@Injectable()\nexport class MlvEditorOverlayRegistry {\n  private readonly _entries = new Map<HTMLElement, MlvEditorOverlayEntry>();\n  private _onFocusIn: ((event: FocusEvent) => void) | undefined;\n  private _onFocusOut: ((event: FocusEvent) => void) | undefined;\n\n  /** @internal Wires the nearest editor's composite focus handlers. */\n  setFocusHandlers(\n    onFocusIn: (event: FocusEvent) => void,\n    onFocusOut: (event: FocusEvent) => void,\n  ): void {\n    this._onFocusIn = onFocusIn;\n    this._onFocusOut = onFocusOut;\n  }\n\n  /** @internal Registers a rendered overlay root and returns its teardown. */\n  register(root: HTMLElement, close: () => void): () => void {\n    const existing = this._entries.get(root);\n    if (existing) {\n      existing.close = close;\n      return () => this._remove(root);\n    }\n    const onFocusIn = (event: FocusEvent) => this._onFocusIn?.(event);\n    const onFocusOut = (event: FocusEvent) => this._onFocusOut?.(event);\n    const entry: MlvEditorOverlayEntry = { root, close, onFocusIn, onFocusOut };\n    this._entries.set(root, entry);\n    root.addEventListener('focusin', onFocusIn, true);\n    root.addEventListener('focusout', onFocusOut, true);\n    return () => this._remove(root);\n  }\n\n  /** @internal Whether a node is rendered in an editor-owned overlay. */\n  contains(node: Node | null): boolean {\n    if (!node) return false;\n    return [...this._entries.values()].some((entry) =>\n      entry.root.contains(node),\n    );\n  }\n\n  /** @internal Closes all owned overlays and removes their listeners. */\n  closeAll(): void {\n    for (const entry of [...this._entries.values()]) {\n      try {\n        entry.close();\n      } catch {\n        // A third-party overlay must not prevent remaining editor cleanup.\n      } finally {\n        this._remove(entry.root);\n      }\n    }\n  }\n\n  /** @internal Removes listener resources without invoking overlay close callbacks. */\n  destroy(): void {\n    for (const entry of [...this._entries.values()]) this._remove(entry.root);\n  }\n\n  private _remove(root: HTMLElement): void {\n    const entry = this._entries.get(root);\n    if (!entry) return;\n    this._entries.delete(root);\n    entry.root.removeEventListener('focusin', entry.onFocusIn, true);\n    entry.root.removeEventListener('focusout', entry.onFocusOut, true);\n  }\n}\n\n/** @internal Injection token for editor-owned overlay registration. */\nexport const MLV_EDITOR_OVERLAY_REGISTRY =\n  new InjectionToken<MlvEditorOverlayRegistry>('MLV_EDITOR_OVERLAY_REGISTRY');\n\n/**\n * Internal per-editor abort registry for uploads that outlive an interaction.\n * It remains non-public until the upload coordinator consumes it in Task 11.\n */\n@Injectable()\nexport class MlvEditorUploadAbortRegistry {\n  private readonly _aborters = new Set<() => void>();\n\n  /** @internal Registers one in-flight upload abort callback. */\n  register(abort: () => void): () => void {\n    this._aborters.add(abort);\n    return () => this._aborters.delete(abort);\n  }\n\n  /** @internal Aborts every registered upload without allowing one failure to stop cleanup. */\n  abortAll(): void {\n    for (const abort of [...this._aborters]) {\n      this._aborters.delete(abort);\n      try {\n        abort();\n      } catch {\n        // A transport abort is best effort; all remaining uploads still stop.\n      }\n    }\n  }\n}\n\n/** @internal Injection token for the editor-owned upload abort registry. */\nexport const MLV_EDITOR_UPLOAD_ABORT_REGISTRY =\n  new InjectionToken<MlvEditorUploadAbortRegistry>(\n    'MLV_EDITOR_UPLOAD_ABORT_REGISTRY',\n  );\n"]}

package/esm2022/lib/editor.tokens.js

@@ -1,10 +0,0 @@
-import { InjectionToken } from '@angular/core';
-/** Optional dependency-injection token for a host-provided image uploader. */
-export const MLV_EDITOR_IMAGE_UPLOADER = new InjectionToken('MLV_EDITOR_IMAGE_UPLOADER');
-/** Default restrictions for image files inserted through the editor. */
-export const MLV_EDITOR_DEFAULT_IMAGE_UPLOAD_OPTIONS = {
-    accept: ['image/*'],
-    maxSize: 10 * 1024 * 1024,
-    maxFiles: 1,
-};
-//# sourceMappingURL=editor.tokens.js.map

package/esm2022/lib/editor.tokens.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"editor.tokens.js","sourceRoot":"","sources":["../../../../../libs/editor/src/lib/editor.tokens.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAM/C,8EAA8E;AAC9E,MAAM,CAAC,MAAM,yBAAyB,GACpC,IAAI,cAAc,CAAyB,2BAA2B,CAAC,CAAC;AAE1E,wEAAwE;AACxE,MAAM,CAAC,MAAM,uCAAuC,GAClD;IACE,MAAM,EAAE,CAAC,SAAS,CAAC;IACnB,OAAO,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;IACzB,QAAQ,EAAE,CAAC;CACZ,CAAC","sourcesContent":["import { InjectionToken } from '@angular/core';\nimport {\n  type MlvEditorImageUploader,\n  type MlvEditorImageUploadOptions,\n} from './editor.types';\n\n/** Optional dependency-injection token for a host-provided image uploader. */\nexport const MLV_EDITOR_IMAGE_UPLOADER =\n  new InjectionToken<MlvEditorImageUploader>('MLV_EDITOR_IMAGE_UPLOADER');\n\n/** Default restrictions for image files inserted through the editor. */\nexport const MLV_EDITOR_DEFAULT_IMAGE_UPLOAD_OPTIONS: MlvEditorImageUploadOptions =\n  {\n    accept: ['image/*'],\n    maxSize: 10 * 1024 * 1024,\n    maxFiles: 1,\n  };\n"]}

package/esm2022/lib/editor.types.js

@@ -1,48 +0,0 @@
-/**
- * Default image URL policy used by the editor upload coordinator.
- *
- * Only absolute HTTP(S) URLs with a hostname and without credentials are
- * accepted. Leading and trailing whitespace is ignored, while whitespace or
- * control characters inside the URL are rejected.
- *
- * @param url Candidate image URL returned by an uploader.
- * @returns Whether the URL is safe to insert.
- */
-export function mlvEditorDefaultImageUrlPolicy(url) {
-    if (typeof url !== 'string')
-        return false;
-    const trimmedUrl = url.trim();
-    const hasControlCharacter = [...trimmedUrl].some((character) => {
-        const codePoint = character.codePointAt(0) ?? 0;
-        return codePoint < 0x20 || codePoint === 0x7f;
-    });
-    if (!trimmedUrl || /\s/u.test(trimmedUrl) || hasControlCharacter) {
-        return false;
-    }
-    try {
-        const parsedUrl = new URL(trimmedUrl);
-        return ((parsedUrl.protocol === 'http:' || parsedUrl.protocol === 'https:') &&
-            parsedUrl.hostname.length > 0 &&
-            parsedUrl.username.length === 0 &&
-            parsedUrl.password.length === 0);
-    }
-    catch {
-        return false;
-    }
-}
-/**
- * Editor-owned image-upload capability forwarded to standalone toolbars.
- *
- * The capability is intentionally one shared reference so toolbar controls
- * never create a second uploader, request registry, or placeholder owner. Its
- * private brand makes this a library-owned capability rather than a structural
- * protocol for consumers to implement.
- */
-export class MlvEditorImageUploadControl {
-    /** @private Nominal brand preventing structural implementations. */
-    _mlvEditorImageUploadControlBrand = true;
-    constructor() {
-        void this._mlvEditorImageUploadControlBrand;
-    }
-}
-//# sourceMappingURL=editor.types.js.map

package/esm2022/lib/editor.types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"editor.types.js","sourceRoot":"","sources":["../../../../../libs/editor/src/lib/editor.types.ts"],"names":[],"mappings":"AA+BA;;;;;;;;;GASG;AACH,MAAM,UAAU,8BAA8B,CAAC,GAAW;IACxD,IAAI,OAAO,GAAG,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1C,MAAM,UAAU,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,MAAM,mBAAmB,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE;QAC7D,MAAM,SAAS,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChD,OAAO,SAAS,GAAG,IAAI,IAAI,SAAS,KAAK,IAAI,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,mBAAmB,EAAE,CAAC;QACjE,OAAO,KAAK,CAAC;IACf,CAAC;IAED,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;QACtC,OAAO,CACL,CAAC,SAAS,CAAC,QAAQ,KAAK,OAAO,IAAI,SAAS,CAAC,QAAQ,KAAK,QAAQ,CAAC;YACnE,SAAS,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;YAC7B,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC;YAC/B,SAAS,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,CAChC,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AA8GD;;;;;;;GAOG;AACH,MAAM,OAAgB,2BAA2B;IAC/C,oEAAoE;IACnD,iCAAiC,GAAG,IAAI,CAAC;IAE1D;QACE,KAAK,IAAI,CAAC,iCAAiC,CAAC;IAC9C,CAAC;CAiCF","sourcesContent":["import type { Signal } from '@angular/core';\nimport type { Editor } from '@tiptap/core';\nimport type {} from '@tiptap/markdown';\nimport type { Transaction } from '@tiptap/pm/state';\n\n/**\n * Supported external serialization formats for editor content.\n *\n * `'html'` and `'markdown'` carry text markup. `'json'` carries the Tiptap\n * document itself as `JSON.stringify(editor.getJSON())`, so custom block nodes\n * round-trip their typed attributes instead of being flattened into HTML\n * attributes. The model type stays `string | null` in every format; a JSON\n * host parses that string at its own boundary.\n */\nexport type MlvEditorFormat = 'html' | 'markdown' | 'json';\n\n/**\n * Width of the centred editor content column.\n *\n * `'default'` is a comfortable reading measure, `'wide'` suits dense or tabular\n * documents, and `'full'` lets the column fill its host. A horizontal gutter is\n * reserved at every value, so block affordances never overlap text.\n */\nexport type MlvEditorContentWidth = 'default' | 'wide' | 'full';\n\n/** Origin of an image file supplied to the editor. */\nexport type MlvEditorImageUploadSource = 'button' | 'paste' | 'drop';\n\n/** Decides whether an uploaded image URL is safe to insert into the editor. */\nexport type MlvEditorImageUrlPolicy = (url: string) => boolean;\n\n/**\n * Default image URL policy used by the editor upload coordinator.\n *\n * Only absolute HTTP(S) URLs with a hostname and without credentials are\n * accepted. Leading and trailing whitespace is ignored, while whitespace or\n * control characters inside the URL are rejected.\n *\n * @param url Candidate image URL returned by an uploader.\n * @returns Whether the URL is safe to insert.\n */\nexport function mlvEditorDefaultImageUrlPolicy(url: string): boolean {\n  if (typeof url !== 'string') return false;\n  const trimmedUrl = url.trim();\n  const hasControlCharacter = [...trimmedUrl].some((character) => {\n    const codePoint = character.codePointAt(0) ?? 0;\n    return codePoint < 0x20 || codePoint === 0x7f;\n  });\n  if (!trimmedUrl || /\\s/u.test(trimmedUrl) || hasControlCharacter) {\n    return false;\n  }\n\n  try {\n    const parsedUrl = new URL(trimmedUrl);\n    return (\n      (parsedUrl.protocol === 'http:' || parsedUrl.protocol === 'https:') &&\n      parsedUrl.hostname.length > 0 &&\n      parsedUrl.username.length === 0 &&\n      parsedUrl.password.length === 0\n    );\n  } catch {\n    return false;\n  }\n}\n\n/** Details emitted when the Tiptap selection changes. */\nexport interface MlvEditorSelectionChange {\n  /** Editor that produced the selection transaction. */\n  readonly editor: Editor;\n\n  /** Tiptap transaction containing the updated selection. */\n  readonly transaction: Transaction;\n}\n\n/** Details emitted for every Tiptap transaction. */\nexport interface MlvEditorTransactionEvent {\n  /** Editor that produced the transaction. */\n  readonly editor: Editor;\n\n  /** Tiptap transaction emitted by the editor. */\n  readonly transaction: Transaction;\n}\n\n/** Details emitted when the editor receives or loses focus. */\nexport interface MlvEditorFocusEvent {\n  /** Editor associated with the native focus event. */\n  readonly editor: Editor;\n\n  /** Native browser focus event. */\n  readonly event: FocusEvent;\n}\n\n/** Context supplied to an image uploader for one upload operation. */\nexport interface MlvEditorImageUploadContext {\n  /** Origin of the image file. */\n  readonly source: MlvEditorImageUploadSource;\n\n  /** Signal that is aborted when the upload should stop. */\n  readonly signal: AbortSignal;\n\n  /** Reports upload progress as a percentage from 0 through 100. */\n  readonly reportProgress: (percentage: number) => void;\n}\n\n/** Image metadata returned by an image uploader after a successful upload. */\nexport interface MlvEditorImageUploadResult {\n  /** URL used in the inserted image node. */\n  readonly src: string;\n\n  /** Optional alternative text for the image. */\n  readonly alt?: string;\n\n  /** Optional image title. */\n  readonly title?: string;\n\n  /** Optional rendered image width. */\n  readonly width?: number;\n\n  /** Optional rendered image height. */\n  readonly height?: number;\n}\n\n/** Adapter used to transfer image files selected, pasted, or dropped in the editor. */\nexport interface MlvEditorImageUploader {\n  /**\n   * Uploads an image file and returns the metadata used to insert it.\n   *\n   * @param file Image file to upload.\n   * @param context Source, cancellation, and progress facilities for this upload.\n   * @returns Metadata for the successfully uploaded image.\n   */\n  upload(\n    file: File,\n    context: MlvEditorImageUploadContext,\n  ): Promise<MlvEditorImageUploadResult>;\n}\n\n/** Constraints applied before images are sent to an uploader. */\nexport interface MlvEditorImageUploadOptions {\n  /** MIME types or patterns accepted by the editor. */\n  readonly accept: readonly string[];\n\n  /** Largest allowed file size in bytes. */\n  readonly maxSize: number;\n\n  /** Maximum number of files accepted in one upload action. */\n  readonly maxFiles: number;\n\n  /** Optional host policy replacing the default uploaded-image URL decision. */\n  readonly urlPolicy?: MlvEditorImageUrlPolicy;\n}\n\n/** One upload retained by the editor while it is active or retryable. */\nexport interface MlvEditorPendingUpload {\n  /** Stable identifier shared with the non-serializable placeholder. */\n  readonly id: string;\n\n  /** Image file supplied by the host interaction. */\n  readonly file: File;\n\n  /** Interaction that supplied the file. */\n  readonly source: MlvEditorImageUploadSource;\n\n  /** Current finite upload progress from zero through one hundred. */\n  readonly progress: number;\n\n  /** Whether the upload is active or retained after a recoverable failure. */\n  readonly status: 'uploading' | 'failed';\n\n  /** Recoverable failure retained while the upload can be retried or removed. */\n  readonly error?: MlvEditorError;\n}\n\n/**\n * Editor-owned image-upload capability forwarded to standalone toolbars.\n *\n * The capability is intentionally one shared reference so toolbar controls\n * never create a second uploader, request registry, or placeholder owner. Its\n * private brand makes this a library-owned capability rather than a structural\n * protocol for consumers to implement.\n */\nexport abstract class MlvEditorImageUploadControl {\n  /** @private Nominal brand preventing structural implementations. */\n  private readonly _mlvEditorImageUploadControlBrand = true;\n\n  protected constructor() {\n    void this._mlvEditorImageUploadControlBrand;\n  }\n\n  /** Whether this editor can currently begin image uploads. */\n  abstract readonly available: Signal<boolean>;\n\n  /** Whether either the input or injected adapter resolves for this editor. */\n  abstract readonly adapterAvailable: Signal<boolean>;\n\n  /** Current editor-scoped validation options. */\n  abstract readonly options: Signal<MlvEditorImageUploadOptions>;\n\n  /** Active and retryable uploads owned by this editor. */\n  abstract readonly pending: Signal<readonly MlvEditorPendingUpload[]>;\n\n  /** Starts validated uploads in the owning editor. */\n  abstract start(\n    files: readonly File[],\n    source: MlvEditorImageUploadSource,\n    metadata?: {\n      readonly position?: number;\n      readonly alt?: string;\n      readonly title?: string;\n    },\n  ): readonly string[];\n\n  /** Cancels one active request. */\n  abstract cancel(id: string): void;\n\n  /** Retries one recoverable request. */\n  abstract retry(id: string): void;\n\n  /** Removes one recoverable failure. */\n  abstract remove(id: string): void;\n}\n\n/** Details emitted after a successful image upload. */\nexport interface MlvEditorImageUploadSuccess {\n  /** Image file that was uploaded. */\n  readonly file: File;\n\n  /** Origin of the image file. */\n  readonly source: MlvEditorImageUploadSource;\n\n  /** Metadata returned by the image uploader. */\n  readonly result: MlvEditorImageUploadResult;\n}\n\n/** Details emitted when an image upload fails. */\nexport interface MlvEditorImageUploadFailure {\n  /** Image file whose upload failed. */\n  readonly file: File;\n\n  /** Origin of the image file. */\n  readonly source: MlvEditorImageUploadSource;\n\n  /** Recoverable error describing the failed upload. */\n  readonly error: MlvEditorError;\n}\n\n/** Details emitted when an image upload is cancelled. */\nexport interface MlvEditorImageUploadCancelled {\n  /** Image file whose upload was cancelled. */\n  readonly file: File;\n\n  /** Origin of the image file. */\n  readonly source: MlvEditorImageUploadSource;\n}\n\n/**\n * Categories of recoverable errors emitted by the editor.\n *\n * `'ai-transport'` reports an AI provider that threw or whose stream failed;\n * `'ai-result'` reports AI output that could not be used. Both restore the\n * document to its pre-request checkpoint; cancellation is silent and never\n * emits an error.\n */\nexport type MlvEditorErrorCode =\n  | 'configuration'\n  | 'parse'\n  | 'serialize'\n  | 'unsupported-command'\n  | 'upload-validation'\n  | 'upload-transport'\n  | 'upload-result'\n  | 'ai-transport'\n  | 'ai-result';\n\n/** Structured error emitted instead of throwing through Angular change detection. */\nexport interface MlvEditorError {\n  /** Stable category that callers can use for error handling. */\n  readonly code: MlvEditorErrorCode;\n\n  /** Human-readable description of the failure. */\n  readonly message: string;\n\n  /** Whether the editor can continue operating after the failure. */\n  readonly recoverable: boolean;\n\n  /** Original failure when one is available. */\n  readonly cause?: unknown;\n}\n"]}