@arsedizioni/ars-utils 22.6.86 → 22.6.88

package/types/arsedizioni-ars-utils-ui.tinymce.d.ts

@@ -1,9 +1,7 @@
-import { RawEditorOptions, TinyMCE, Editor } from 'tinymce';
-import * as _angular_core from '@angular/core';
-import { OnInit, OnDestroy } from '@angular/core';
-import { ControlValueAccessor } from '@angular/forms';
-import * as _angular_forms_signals from '@angular/forms/signals';
-
+import { Editor, RawEditorOptions, TinyMCE } from "tinymce";
+import * as i0 from "@angular/core";
+import { OnDestroy, OnInit } from "@angular/core";
+import { ControlValueAccessor } from "@angular/forms";
 /**
  * The editor profiles the applications ask for, ready to be handed to
  * `[tinymceConfig]` on {@link TinymceEditorDirective}.
@@ -23,46 +21,45 @@ import * as _angular_forms_signals from '@angular/forms/signals';
  * Each accessor returns a **fresh deep copy**: a caller that tweaks a returned object — as the
  * editor dialog does with its toolbar — cannot corrupt the preset for everyone else.
  */
-declare class TinymceUtils {
-    /**
-     * Everything TinyMCE 8 open source has to offer, for a full-page editor.
-     *
-     * Adapted from the TinyMCE 5 profile the library used to ship: `paste`, `print`, `hr`,
-     * `textpattern` and the `fullpage_*` options no longer exist (paste and text patterns moved
-     * into the core, `fullpage` and `print` were dropped in v6), and `checklist`,
-     * `openCodeMirrorButton` and `insertMediaButton` are premium or application-specific buttons
-     * that a self-hosted GPL build has no way to render.
-     */
-    private static readonly FULL;
-    /**
-     * The one for a field inside a form: it grows with the text instead of owning the page, the
-     * toolbar sits under it and collapses into groups, and there is no status bar or context menu
-     * to compete with the form around it.
-     */
-    private static readonly COMPACT;
-    /** The compact one plus full screen, the insert group and the source view. */
-    private static readonly COMPACT_EXTENDED;
-    /**
-     * The full-page profile.
-     * @returns A fresh copy of the configuration, safe to modify.
-     */
-    static get TinymceConfig(): RawEditorOptions;
-    /**
-     * The in-form profile.
-     * @returns A fresh copy of the configuration, safe to modify.
-     */
-    static get TinymceCompactConfig(): RawEditorOptions;
-    /**
-     * The in-form profile with full screen and source view.
-     * @returns A fresh copy of the configuration, safe to modify.
-     */
-    static get TinymceCompactExtendedConfig(): RawEditorOptions;
+export declare class TinymceUtils {
+  /**
+   * Everything TinyMCE 8 open source has to offer, for a full-page editor.
+   *
+   * Adapted from the TinyMCE 5 profile the library used to ship: `paste`, `print`, `hr`,
+   * `textpattern` and the `fullpage_*` options no longer exist (paste and text patterns moved
+   * into the core, `fullpage` and `print` were dropped in v6), and `checklist`,
+   * `openCodeMirrorButton` and `insertMediaButton` are premium or application-specific buttons
+   * that a self-hosted GPL build has no way to render.
+   */
+  private static readonly FULL;
+  /**
+   * The one for a field inside a form: it grows with the text instead of owning the page, the
+   * toolbar sits under it and collapses into groups, and there is no status bar or context menu
+   * to compete with the form around it.
+   */
+  private static readonly COMPACT;
+  /** The compact one plus full screen, the insert group and the source view. */
+  private static readonly COMPACT_EXTENDED;
+  /**
+   * The full-page profile.
+   * @returns A fresh copy of the configuration, safe to modify.
+   */
+  static get TinymceConfig(): RawEditorOptions;
+  /**
+   * The in-form profile.
+   * @returns A fresh copy of the configuration, safe to modify.
+   */
+  static get TinymceCompactConfig(): RawEditorOptions;
+  /**
+   * The in-form profile with full screen and source view.
+   * @returns A fresh copy of the configuration, safe to modify.
+   */
+  static get TinymceCompactExtendedConfig(): RawEditorOptions;
 }
-
 declare global {
-    interface Window {
-        tinymce?: TinyMCE;
-    }
+  interface Window {
+    tinymce?: TinyMCE;
+  }
 }
 /**
  * Loads the self-hosted TinyMCE bundle on demand.
@@ -75,26 +72,25 @@ declare global {
  * model, plugins and skin relative to `base_url`, which is how the self-hosted distribution
  * expects to work.
  */
-declare class TinymceLoaderService {
-    /** The in-flight (or completed) load, so concurrent editors share a single script tag. */
-    private pending?;
-    /**
-     * The absolute URL of the TinyMCE asset folder, resolved against the document base href so the
-     * app keeps working when it is served from a sub-path.
-     * @returns The base URL, without a trailing slash.
-     */
-    get baseUrl(): string;
-    /**
-     * Loads TinyMCE, reusing the script already injected by a previous call.
-     * @returns A promise resolving with the global TinyMCE instance.
-     */
-    load(): Promise<TinyMCE>;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TinymceLoaderService, never>;
-    static ɵprov: _angular_core.ɵɵInjectableDeclaration<any>;
+export declare class TinymceLoaderService {
+  /** The in-flight (or completed) load, so concurrent editors share a single script tag. */
+  private pending?;
+  /**
+   * The absolute URL of the TinyMCE asset folder, resolved against the document base href so the
+   * app keeps working when it is served from a sub-path.
+   * @returns The base URL, without a trailing slash.
+   */
+  get baseUrl(): string;
+  /**
+   * Loads TinyMCE, reusing the script already injected by a previous call.
+   * @returns A promise resolving with the global TinyMCE instance.
+   */
+  load(): Promise<TinyMCE>;
+  static ɵfac: i0.ɵɵFactoryDeclaration<TinymceLoaderService, never>;
+  static ɵprov: i0.ɵɵInjectableDeclaration<any>;
 }
-
 /** Uploads one image and resolves with the URL to reference it by. */
-type TinymceImageUploader = (file: File) => Promise<string>;
+export type TinymceImageUploader = (file: File) => Promise<string>;
 /**
  * How the editor presents itself.
  *
@@ -105,7 +101,7 @@ type TinymceImageUploader = (file: File) => Promise<string>;
  * it, at which point the toolbar floats over the content. It needs an ordinary element to edit —
  * a `<div>` — because there is nothing to render inside a `<textarea>`.
  */
-type TinymceToolbarMode = 'fixed' | 'inline';
+export type TinymceToolbarMode = 'fixed' | 'inline';
 /**
  * Turns a `<textarea>` into a rich text editor backed by the self-hosted TinyMCE bundle, and wires
  * it to Angular forms as a `ControlValueAccessor`, so `[(ngModel)]`, `required` and the
@@ -117,131 +113,149 @@ type TinymceToolbarMode = 'fixed' | 'inline';
  * Usage: `<textarea tinymceEditor [(ngModel)]="item.text" name="text" required></textarea>`
  *
  */
-declare class TinymceEditorDirective implements ControlValueAccessor, OnInit, OnDestroy {
-    /** Extra TinyMCE options, merged over (and able to override) the defaults below. */
-    readonly tinymceConfig: _angular_core.InputSignal<RawEditorOptions>;
-    /** Whether the toolbar is pinned above the content (`fixed`) or floats on focus (`inline`). */
-    readonly tinymceToolbarMode: _angular_core.InputSignal<TinymceToolbarMode>;
-    /**
-     * Handler invoked for every image dropped, pasted or picked in the editor. When not provided
-     * the upload tab is hidden and only images referenced by URL can be inserted.
-     */
-    readonly tinymceImageUploader: _angular_core.InputSignal<TinymceImageUploader>;
-    /** Emitted once the editor is up, for callers that want to enable UI only when it is usable. */
-    readonly ready: _angular_core.OutputEmitterRef<Editor>;
-    /** Emitted when the editor could not be loaded or initialised. */
-    readonly failed: _angular_core.OutputEmitterRef<Error>;
-    private readonly host;
-    private readonly loader;
-    private readonly themeService;
-    private readonly changeDetector;
-    private editor?;
-    /** True while the editor is showing itself full screen. */
-    private fullscreen;
-    /** True once the directive has been destroyed, so a late init resolves into a no-op. */
-    private destroyed;
-    /**
-     * True while the directive itself is pushing a value into the editor. TinyMCE raises the same
-     * content events for a programmatic `setContent` as for a keystroke, so without this flag
-     * `writeValue` would immediately echo back through `onChange` and mark a freshly loaded form
-     * as dirty.
-     */
-    private writingValue;
-    /** The value received before the editor existed, applied as soon as it does. */
-    private value;
-    private disabled;
-    private onChange;
-    private onTouched;
-    /**
-     * Leaves full screen on Escape, for the keystrokes that happen outside the content: with the
-     * classic editor the content is an iframe, and a keydown in there never reaches this document.
-     * Bound on the capture phase and stopped, so a dialog hosting the editor does not take the
-     * Escape and close, throwing the edit away when the user only meant to leave full screen.
-     */
-    private readonly onDocumentKeydown;
-    /**
-     * Loads TinyMCE and initialises the editor over the host textarea.
-     * @returns A promise that completes once the editor is ready (or has failed).
-     */
-    ngOnInit(): Promise<void>;
-    /**
-     * Tears the editor down. TinyMCE keeps global state per instance, so leaving it behind when a
-     * dialog closes leaks both DOM and editor registrations.
-     * @returns void
-     */
-    ngOnDestroy(): void;
-    /**
-     * Decides whether an Escape press means "leave full screen": it does whenever the editor is
-     * full screen, full stop. While full screen the editor owns Escape, and the press is stopped
-     * here so it can never reach the dialog hosting it — leaving full screen must not also throw
-     * away what is being written.
-     * @param event The keyboard event, from the document or from the editor's content.
-     * @returns True when full screen should be left.
-     */
-    private shouldEscapeLeaveFullscreen;
-    /**
-     * Asks the editor to leave full screen. Safe to call when it is not in full screen.
-     * @returns void
-     */
-    private exitFullscreen;
-    /**
-     * Attaches or detaches everything that only makes sense while the editor is full screen.
-     * @param state True when the editor has just entered full screen.
-     * @returns void
-     */
-    private handleFullscreenChanged;
-    /**
-     * Detaches the listener that only makes sense while the editor is full screen.
-     * @returns void
-     */
-    private releaseFullscreen;
-    /**
-     * Pushes a value coming from the form into the editor.
-     * @param value The new content, or null/undefined for an empty editor.
-     * @returns void
-     */
-    writeValue(value: string | null | undefined): void;
-    /**
-     * Registers the callback used to report content changes to the form.
-     * @param fn The callback supplied by Angular forms.
-     * @returns void
-     */
-    registerOnChange(fn: (value: string) => void): void;
-    /**
-     * Registers the callback used to report the first blur to the form.
-     * @param fn The callback supplied by Angular forms.
-     * @returns void
-     */
-    registerOnTouched(fn: () => void): void;
-    /**
-     * Enables or disables editing.
-     * @param isDisabled True to switch the editor to read-only.
-     * @returns void
-     */
-    setDisabledState(isDisabled: boolean): void;
-    /**
-     * Writes content into the editor when it exists, guarding against the echo described on
-     * <see cref="writingValue"/>.
-     * @param value The content to write.
-     * @returns void
-     */
-    private applyValue;
-    /**
-     * Applies the disabled state to the editor when it exists.
-     * @param isDisabled True to switch the editor to read-only.
-     * @returns void
-     */
-    private applyDisabled;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TinymceEditorDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<TinymceEditorDirective, "textarea[tinymceEditor], div[tinymceEditor]", never, { "tinymceConfig": { "alias": "tinymceConfig"; "required": false; "isSignal": true; }; "tinymceToolbarMode": { "alias": "tinymceToolbarMode"; "required": false; "isSignal": true; }; "tinymceImageUploader": { "alias": "tinymceImageUploader"; "required": false; "isSignal": true; }; }, { "ready": "ready"; "failed": "failed"; }, never, never, true, never>;
+export declare class TinymceEditorDirective implements ControlValueAccessor, OnInit, OnDestroy {
+  /** Extra TinyMCE options, merged over (and able to override) the defaults below. */
+  readonly tinymceConfig: import("@angular/core").InputSignal<RawEditorOptions>;
+  /** Whether the toolbar is pinned above the content (`fixed`) or floats on focus (`inline`). */
+  readonly tinymceToolbarMode: import("@angular/core").InputSignal<TinymceToolbarMode>;
+  /**
+   * Handler invoked for every image dropped, pasted or picked in the editor. When not provided
+   * the upload tab is hidden and only images referenced by URL can be inserted.
+   */
+  readonly tinymceImageUploader: import("@angular/core").InputSignal<TinymceImageUploader>;
+  /** Emitted once the editor is up, for callers that want to enable UI only when it is usable. */
+  readonly ready: import("@angular/core").OutputEmitterRef<Editor>;
+  /** Emitted when the editor could not be loaded or initialised. */
+  readonly failed: import("@angular/core").OutputEmitterRef<Error>;
+  private readonly host;
+  private readonly loader;
+  private readonly themeService;
+  private readonly changeDetector;
+  private editor?;
+  /** True while the editor is showing itself full screen. */
+  private fullscreen;
+  /** True once the directive has been destroyed, so a late init resolves into a no-op. */
+  private destroyed;
+  /**
+   * True while the directive itself is pushing a value into the editor. TinyMCE raises the same
+   * content events for a programmatic `setContent` as for a keystroke, so without this flag
+   * `writeValue` would immediately echo back through `onChange` and mark a freshly loaded form
+   * as dirty.
+   */
+  private writingValue;
+  /** The value received before the editor existed, applied as soon as it does. */
+  private value;
+  private disabled;
+  private onChange;
+  private onTouched;
+  /**
+   * Leaves full screen on Escape, for the keystrokes that happen outside the content: with the
+   * classic editor the content is an iframe, and a keydown in there never reaches this document.
+   * Bound on the capture phase and stopped, so a dialog hosting the editor does not take the
+   * Escape and close, throwing the edit away when the user only meant to leave full screen.
+   */
+  private readonly onDocumentKeydown;
+  /**
+   * Loads TinyMCE and initialises the editor over the host textarea.
+   * @returns A promise that completes once the editor is ready (or has failed).
+   */
+  ngOnInit(): Promise<void>;
+  /**
+   * Tears the editor down. TinyMCE keeps global state per instance, so leaving it behind when a
+   * dialog closes leaks both DOM and editor registrations.
+   * @returns void
+   */
+  ngOnDestroy(): void;
+  /**
+   * Decides whether an Escape press means "leave full screen": it does whenever the editor is
+   * full screen, full stop. While full screen the editor owns Escape, and the press is stopped
+   * here so it can never reach the dialog hosting it — leaving full screen must not also throw
+   * away what is being written.
+   * @param event The keyboard event, from the document or from the editor's content.
+   * @returns True when full screen should be left.
+   */
+  private shouldEscapeLeaveFullscreen;
+  /**
+   * Asks the editor to leave full screen. Safe to call when it is not in full screen.
+   * @returns void
+   */
+  private exitFullscreen;
+  /**
+   * Attaches or detaches everything that only makes sense while the editor is full screen.
+   * @param state True when the editor has just entered full screen.
+   * @returns void
+   */
+  private handleFullscreenChanged;
+  /**
+   * Detaches the listener that only makes sense while the editor is full screen.
+   * @returns void
+   */
+  private releaseFullscreen;
+  /**
+   * Pushes a value coming from the form into the editor.
+   * @param value The new content, or null/undefined for an empty editor.
+   * @returns void
+   */
+  writeValue(value: string | null | undefined): void;
+  /**
+   * Registers the callback used to report content changes to the form.
+   * @param fn The callback supplied by Angular forms.
+   * @returns void
+   */
+  registerOnChange(fn: (value: string) => void): void;
+  /**
+   * Registers the callback used to report the first blur to the form.
+   * @param fn The callback supplied by Angular forms.
+   * @returns void
+   */
+  registerOnTouched(fn: () => void): void;
+  /**
+   * Enables or disables editing.
+   * @param isDisabled True to switch the editor to read-only.
+   * @returns void
+   */
+  setDisabledState(isDisabled: boolean): void;
+  /**
+   * Writes content into the editor when it exists, guarding against the echo described on
+   * <see cref="writingValue"/>.
+   * @param value The content to write.
+   * @returns void
+   */
+  private applyValue;
+  /**
+   * Applies the disabled state to the editor when it exists.
+   * @param isDisabled True to switch the editor to read-only.
+   * @returns void
+   */
+  private applyDisabled;
+  static ɵfac: i0.ɵɵFactoryDeclaration<TinymceEditorDirective, never>;
+  static ɵdir: i0.ɵɵDirectiveDeclaration<TinymceEditorDirective, "textarea[tinymceEditor], div[tinymceEditor]", never, {
+    "tinymceConfig": {
+      "alias": "tinymceConfig";
+      "required": false;
+      "isSignal": true;
+    };
+    "tinymceToolbarMode": {
+      "alias": "tinymceToolbarMode";
+      "required": false;
+      "isSignal": true;
+    };
+    "tinymceImageUploader": {
+      "alias": "tinymceImageUploader";
+      "required": false;
+      "isSignal": true;
+    };
+  }, {
+    "ready": "ready";
+    "failed": "failed";
+  }, never, never, true, never>;
 }
-
-interface TinyMceEditorDialogData {
-    text: string;
-    configuration: RawEditorOptions;
-    infoButtonLabel?: string;
-    onShowInfo?: Function;
-    disabled?: boolean;
+export interface TinyMceEditorDialogData {
+  text: string;
+  configuration: RawEditorOptions;
+  infoButtonLabel?: string;
+  onShowInfo?: Function;
+  disabled?: boolean;
 }
 /**
  * A dialog that is nothing but an editor: the caller hands it a text and gets the edited one
@@ -251,47 +265,46 @@ interface TinyMceEditorDialogData {
  * exactly what any other editor in the application costs — the TinyMCE bundle is fetched on
  * first use and nothing about it reaches the initial chunk.
  */
-declare class TinyMceEditorComponent {
-    /** Emitted with the edited text when the user saves. */
-    readonly saving: _angular_core.OutputEmitterRef<string>;
-    private readonly dialogRef;
-    /** Dialog configuration, injected and exposed as a signal. */
-    protected readonly dialogData: _angular_core.WritableSignal<TinyMceEditorDialogData>;
-    /** Whether the editor is in read-only mode. */
-    protected readonly disabled: _angular_core.WritableSignal<boolean>;
-    /**
-     * Why the editor could not be shown, when it could not.
-     *
-     * Without it a failure looked exactly like an empty document: the directive reported it on its
-     * `failed` output, nothing was listening, and the user was left with a blank box and no reason
-     * for it. The message is the directive's own — the bundle did not load, or TinyMCE refused to
-     * start — and it also goes to the console, because that is where whoever is asked about it will
-     * look first.
-     */
-    protected readonly error: _angular_core.WritableSignal<string>;
-    /** Current editor content. */
-    protected readonly text: _angular_core.WritableSignal<string>;
-    /**
-     * Signal form bound to the editor textarea. The disabled state is pushed to the
-     * TinymceEditorDirective through the ControlValueAccessor interop.
-     */
-    protected readonly textForm: _angular_forms_signals.FieldTree<string, string | number, "writable">;
-    /** The profile handed to the editor directive, merged over its defaults. */
-    protected tinymceConfig: RawEditorOptions;
-    constructor();
-    /**
-     * Records that the editor could not be shown.
-     * @param error - What the directive could not do.
-     * @returns void
-     */
-    protected failed(error: Error): void;
-    /**
-     * Save the current editor content and close the dialog.
-     */
-    protected ok(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TinyMceEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TinyMceEditorComponent, "ng-component", never, {}, { "saving": "saving"; }, never, never, true, never>;
-}
-
-export { TinyMceEditorComponent, TinymceEditorDirective, TinymceLoaderService, TinymceUtils };
-export type { TinyMceEditorDialogData, TinymceImageUploader, TinymceToolbarMode };
+export declare class TinyMceEditorComponent {
+  /** Emitted with the edited text when the user saves. */
+  readonly saving: import("@angular/core").OutputEmitterRef<string>;
+  private readonly dialogRef;
+  /** Dialog configuration, injected and exposed as a signal. */
+  protected readonly dialogData: import("@angular/core").WritableSignal<TinyMceEditorDialogData>;
+  /** Whether the editor is in read-only mode. */
+  protected readonly disabled: import("@angular/core").WritableSignal<boolean>;
+  /**
+   * Why the editor could not be shown, when it could not.
+   *
+   * Without it a failure looked exactly like an empty document: the directive reported it on its
+   * `failed` output, nothing was listening, and the user was left with a blank box and no reason
+   * for it. The message is the directive's own — the bundle did not load, or TinyMCE refused to
+   * start — and it also goes to the console, because that is where whoever is asked about it will
+   * look first.
+   */
+  protected readonly error: import("@angular/core").WritableSignal<string>;
+  /** Current editor content. */
+  protected readonly text: import("@angular/core").WritableSignal<string>;
+  /**
+   * Signal form bound to the editor textarea. The disabled state is pushed to the
+   * TinymceEditorDirective through the ControlValueAccessor interop.
+   */
+  protected readonly textForm: import("@angular/forms/signals").FieldTree<string, string | number, "writable">;
+  /** The profile handed to the editor directive, merged over its defaults. */
+  protected tinymceConfig: RawEditorOptions;
+  constructor();
+  /**
+   * Records that the editor could not be shown.
+   * @param error - What the directive could not do.
+   * @returns void
+   */
+  protected failed(error: Error): void;
+  /**
+   * Save the current editor content and close the dialog.
+   */
+  protected ok(): void;
+  static ɵfac: i0.ɵɵFactoryDeclaration<TinyMceEditorComponent, never>;
+  static ɵcmp: i0.ɵɵComponentDeclaration<TinyMceEditorComponent, "ng-component", never, {}, {
+    "saving": "saving";
+  }, never, never, true, never>;
+}

package/types/arsedizioni-ars-utils.d.ts

@@ -1,4 +1,2 @@
 /** Version of the library, aligned with the supported Angular major. */
-declare const ARS_UTILS_VERSION = "22.1.5";
-
-export { ARS_UTILS_VERSION };
+export declare const ARS_UTILS_VERSION = "22.1.5";