@arsedizioni/ars-utils 22.5.9 → 22.5.11

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

@@ -5,7 +5,7 @@ import { MatExpansionPanel } from '@angular/material/expansion';
 import { MatInput } from '@angular/material/input';
 import { MatPaginator, PageEvent } from '@angular/material/paginator';
 import { MatDrawer } from '@angular/material/sidenav';
-import { ClipperSearchFacetsSnapshot, ClipperSearchFacet, ClipperSearchFacetGroup, ClipperService, ClipperDocumentInfo, ClipperSearchParams, ClipperQueryReferencesMode, ClipperModule, ClipperModel, ClipperSearchCalendarSnapshotMonth, ClipperSearchCalendarSnapshotResult, ClipperSelectionMode, ClipperSearchResult, ClipperSort, ClipperUserSearch, SectorInfo, ClipperUserInfo, EditDialogCompleted, ClipperContactInfo, ClipperDocumentRelevants, ClipperDocumentAnchorInfo, ClipperDocumentNote, EditDialogData } from '@arsedizioni/ars-utils/clipper.common';
+import { ClipperSearchFacetsSnapshot, ClipperSearchFacet, ClipperSearchFacetGroup, ClipperService, ClipperDocumentInfo, ClipperSearchParams, ClipperQueryReferencesMode, ClipperModule, ClipperModel, ClipperSearchCalendarSnapshotMonth, ClipperSearchCalendarSnapshotResult, ClipperSelectionMode, ClipperSearchResult, ClipperSort, ClipperUserSearch, SectorInfo, ClipperUserInfo, ClipperDocumentRelevants, ClipperDocumentAnchorInfo } from '@arsedizioni/ars-utils/clipper.common';
 import { BroadcastService, DateInterval, ThemeService, ScreenService, SelectableModel, NameValueItem, INode, ThemeType } from '@arsedizioni/ars-utils/core';
 import { CalendarEmptyHeader, ButtonSelectorComponent, ChipsSelectorComponent } from '@arsedizioni/ars-utils/ui.controls';
 import { BreakpointObserver } from '@angular/cdk/layout';
@@ -13,7 +13,6 @@ import { Clipboard } from '@angular/cdk/clipboard';
 import { ApplicationDialogService } from '@arsedizioni/ars-utils/ui.application';
 import { SendToPopulateData } from '@arsedizioni/ars-utils/ui';
 import { MatCalendar, MatCalendarCellClassFunction } from '@angular/material/datepicker';
-import { NgForm } from '@angular/forms';
 import { MatSelectionList } from '@angular/material/list';
 import { MatMenuTrigger, MatMenu } from '@angular/material/menu';
 
@@ -79,8 +78,6 @@ declare class ClipperDocumentManager {
     readonly clipperService: ClipperService;
     protected readonly broadcastService: BroadcastService;
     protected readonly dialogService: ApplicationDialogService;
-    protected readonly canUseArchive: _angular_core.WritableSignal<boolean>;
-    protected readonly canUseNotes: _angular_core.WritableSignal<boolean>;
     protected readonly canHandleTooManyResults: _angular_core.WritableSignal<boolean>;
     protected readonly canPopulateContacts: _angular_core.WritableSignal<boolean>;
     /**
@@ -100,16 +97,6 @@ declare class ClipperDocumentManager {
      * @param item - The document whose deadline to export.
      */
     exportDeadline(item: ClipperDocumentInfo): void;
-    /**
-     * Sends a broadcast message to add the given documents to the archive.
-     * @param items - The list of documents to archive.
-     */
-    addToArchive(items: ClipperDocumentInfo[]): void;
-    /**
-     * Sends a broadcast message to create a new calendar deadline from the given document.
-     * @param item - The document to add to the calendar.
-     */
-    addToCalendar(item: ClipperDocumentInfo): void;
     /**
      * Sends a broadcast message to add the given documents to the working-documents set.
      * @param items - The list of documents to add.
@@ -120,11 +107,6 @@ declare class ClipperDocumentManager {
      * @param items - The list of documents to add.
      */
     addItemsToBag(items: ClipperDocumentInfo[]): void;
-    /**
-     * Sends a broadcast message to add custom notes to the given document.
-     * @param item - The document to add notes to.
-     */
-    addItemNotes(item: ClipperDocumentInfo): void;
     /**
      * Copies the document's metadata (ID, titles, number, date, origin) as a tab-separated string to the clipboard.
      * @param item - The document whose metadata to copy.
@@ -748,56 +730,6 @@ declare class ClipperBrowserDialogComponent {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperBrowserDialogComponent, "ng-component", never, {}, {}, never, never, true, never>;
 }
 
-declare class ClipperContactEditComponent {
-    private clipperService;
-    private dialogService;
-    private dialogRef;
-    private dialogData;
-    protected readonly f: _angular_core.Signal<NgForm>;
-    readonly done: _angular_core.OutputEmitterRef<EditDialogCompleted<ClipperContactInfo>>;
-    protected readonly dialogTitle: string;
-    protected readonly isNew: _angular_core.WritableSignal<boolean>;
-    protected item: ClipperContactInfo;
-    protected readonly availableTeams: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected selectedTeam: NameValueItem<string>;
-    constructor();
-    /**
-     * Loads the list of available teams from the server and populates the team selector.
-     * Pre-selects the team that matches the current contact's team id, falling back to 'Personale'.
-     */
-    private loadTeams;
-    /**
-     * Persists the current contact to the server.
-     * Closes the dialog without saving when editing an existing contact whose form is unchanged.
-     */
-    protected save(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperContactEditComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperContactEditComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
-}
-
-declare class ClipperContactsSelector {
-    /**
-     * Builds an HTML string representing a list of email addresses separated by line breaks.
-     * @param emails - A semicolon-separated string of email addresses, or undefined.
-     * @returns An HTML string with each address wrapped in a `<span>` tag.
-     */
-    private static buildEmailsHtml;
-    /**
-     * Builds the HTML row template used to display a contact inside the selection dialog.
-     * @param item - The contact data to render.
-     * @returns An HTML string representing the contact row.
-     */
-    private static buildContactTemplate;
-    /**
-     * Opens the contacts selection/management dialog and wires up all interaction events.
-     * @param injector - The Angular injector used to resolve services within the dialog context.
-     * @param canAppend - When true, the dialog allows adding new contacts.
-     * @param canEdit - When true, the dialog allows editing and deleting contacts.
-     * @param onSelect - Optional callback invoked with the selection result when the user confirms.
-     */
-    static Show(injector: Injector, canAppend?: boolean, canEdit?: boolean, onSelect?: (result: unknown) => void): void;
-}
-
 interface ClipperDocumentDialogData {
     selectionMode?: ClipperSelectionMode;
     selectableModules?: ClipperModule[];
@@ -805,8 +737,6 @@ interface ClipperDocumentDialogData {
     query?: string;
     queryChunks?: string;
     theme?: ThemeType;
-    canUseArchive?: boolean;
-    canUseNotes?: boolean;
     canHandleTooManyResults?: boolean;
 }
 declare class ClipperDocumentComponent extends ClipperDocumentManager {
@@ -1072,9 +1002,6 @@ declare class ClipperDocumentMenuComponent {
     readonly isLawInForce: _angular_core.InputSignal<boolean>;
     readonly canPrint: _angular_core.InputSignal<boolean>;
     readonly canFind: _angular_core.InputSignal<boolean>;
-    readonly canUseCalendar: _angular_core.InputSignal<boolean>;
-    readonly canUseArchive: _angular_core.InputSignal<boolean>;
-    readonly canUseNotes: _angular_core.InputSignal<boolean>;
     readonly canUseAIAssistant: _angular_core.InputSignal<boolean>;
     protected readonly canUseAIEditor: boolean;
     readonly canUseRS: _angular_core.InputSignal<boolean>;
@@ -1087,13 +1014,7 @@ declare class ClipperDocumentMenuComponent {
     protected readonly canOpen: _angular_core.Signal<boolean>;
     /** `true` when at least one item can be sent by email. */
     protected readonly canSendByEmail: _angular_core.Signal<boolean>;
-    /** `true` when custom notes can be added to the single selected document. */
-    protected readonly canAddNotes: _angular_core.Signal<boolean>;
-    /** `true` when archive access is enabled and there is at least one selected item. */
-    protected readonly canAddToArchive: _angular_core.Signal<boolean>;
-    /** `true` when all selected items are deadline/alert documents and calendar is enabled. */
-    protected readonly canAddToCalendar: _angular_core.Signal<boolean>;
-    /** `true` when all selected items can be exported as an ICS calendar file. */
+    /** `true` when all selected items are deadline/alert documents and can travel as an ICS file. */
     protected readonly canExportCalendar: _angular_core.Signal<boolean>;
     /** `true` when the selection contains non-Coordinamento items that can be added to working documents. */
     protected readonly canAddToWorkingDocuments: _angular_core.Signal<boolean>;
@@ -1155,113 +1076,7 @@ declare class ClipperDocumentMenuComponent {
      */
     protected openReferences(item: ClipperDocumentInfo | undefined, mode: number): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperDocumentMenuComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperDocumentMenuComponent, "clipper-document-menu", never, { "useSelections": { "alias": "useSelections"; "required": false; "isSignal": true; }; "selectionSource": { "alias": "selectionSource"; "required": false; "isSignal": true; }; "parent": { "alias": "parent"; "required": true; "isSignal": true; }; "item": { "alias": "item"; "required": false; "isSignal": true; }; "isReference": { "alias": "isReference"; "required": false; "isSignal": true; }; "isReadable": { "alias": "isReadable"; "required": false; "isSignal": true; }; "isReadableModel": { "alias": "isReadableModel"; "required": false; "isSignal": true; }; "isLawInForce": { "alias": "isLawInForce"; "required": false; "isSignal": true; }; "canPrint": { "alias": "canPrint"; "required": false; "isSignal": true; }; "canFind": { "alias": "canFind"; "required": false; "isSignal": true; }; "canUseCalendar": { "alias": "canUseCalendar"; "required": false; "isSignal": true; }; "canUseArchive": { "alias": "canUseArchive"; "required": false; "isSignal": true; }; "canUseNotes": { "alias": "canUseNotes"; "required": false; "isSignal": true; }; "canUseAIAssistant": { "alias": "canUseAIAssistant"; "required": false; "isSignal": true; }; "canUseRS": { "alias": "canUseRS"; "required": false; "isSignal": true; }; "canOpenDocument": { "alias": "canOpenDocument"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
-}
-
-declare class ClipperNoteBadgeComponent {
-    private readonly themeService;
-    private readonly injector;
-    private readonly clipperService;
-    private readonly broadcastService;
-    private readonly dialogService;
-    private readonly destroyRef;
-    private readonly overlay;
-    private overlayRef;
-    private resizeSub;
-    private readonly viewContainerRef;
-    readonly populateContacts: _angular_core.OutputEmitterRef<SendToPopulateData>;
-    private readonly popupTpl;
-    readonly note: _angular_core.ModelSignal<ClipperDocumentNote>;
-    private readonly theme;
-    /**
-     * Badge background colour, blended from the note colour and the active theme.
-     * Recomputes automatically whenever the theme or the note colour changes.
-     */
-    protected readonly backgroundColor: _angular_core.Signal<string>;
-    protected readonly trackingUnopenedCount: _angular_core.Signal<number>;
-    protected readonly trackingOpenedCount: _angular_core.Signal<number>;
-    protected readonly totalTrackings: _angular_core.Signal<number>;
-    constructor();
-    /**
-     * Opens the note-details popup positioned near the mouse cursor.
-     * Stops event propagation to avoid triggering parent click handlers.
-     * @param event - The mouse event used to determine the popup position.
-     */
-    protected showPopup(event: MouseEvent): void;
-    /**
-     * Closes the note-details popup and cleans up overlay resources.
-     * @param event - Optional mouse event; when provided, propagation is stopped.
-     */
-    protected closePopup(event?: MouseEvent): void;
-    /**
-     * Opens the note-edit dialog pre-populated with the current note data.
-     * On confirmation, updates the model and broadcasts the change.
-     * Stops event propagation to avoid triggering parent click handlers.
-     * @param event - The mouse event that triggered the edit action.
-     */
-    protected edit(event: MouseEvent): void;
-    /**
-     * Opens a confirmation dialog and, on confirmation, deletes the note via the service.
-     * Broadcasts the deletion and closes the popup on success.
-     * Stops event propagation to avoid triggering parent click handlers.
-     * @param event - The mouse event that triggered the delete action.
-     */
-    protected delete(event: MouseEvent): void;
-    /**
-     * Opens the send-by-email dialog for the document linked to this note.
-     * On confirmation, sends a notification via the service and updates tracking data.
-     * Stops event propagation to avoid triggering parent click handlers.
-     * @param event - The mouse event that triggered the send action.
-     */
-    protected sendTo(event: MouseEvent): void;
-    /**
-     * Opens a confirmation dialog and, on confirmation, resends the email notifications
-     * associated with this note.
-     * Stops event propagation to avoid triggering parent click handlers.
-     * @param event - The mouse event that triggered the resend action.
-     * @param notifyIfNotOpen - When `true`, only recipients who have not yet opened the previous email are notified.
-     */
-    protected sendAgain(event: MouseEvent, notifyIfNotOpen: boolean): void;
-    /**
-     * Fetches the latest tracking data for the note from the server and updates the model.
-     * Stops event propagation to avoid triggering parent click handlers.
-     * @param event - The mouse event that triggered the refresh action.
-     */
-    protected refresh(event: MouseEvent): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperNoteBadgeComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperNoteBadgeComponent, "clipper-note-badge", never, { "note": { "alias": "note"; "required": true; "isSignal": true; }; }, { "populateContacts": "populateContacts"; "note": "noteChange"; }, never, never, true, never>;
-}
-
-declare class ClipperNoteEditComponent {
-    readonly done: _angular_core.OutputEmitterRef<ClipperDocumentNote>;
-    private readonly dialogService;
-    protected readonly dialogData: EditDialogData<ClipperDocumentNote>;
-    protected readonly dialogTitle: _angular_core.WritableSignal<string>;
-    private readonly clipperService;
-    protected readonly colors: NameValueItem<string>[];
-    protected readonly isNew: _angular_core.WritableSignal<boolean>;
-    protected readonly availableTeams: _angular_core.WritableSignal<NameValueItem<string>[]>;
-    protected selectedTeam: NameValueItem<string>;
-    protected item: ClipperDocumentNote;
-    constructor();
-    /**
-     * Returns the display name for the given colour value.
-     * @param value - The hex/CSS colour string to look up.
-     * @returns The human-readable colour name, or the raw value when not found.
-     */
-    protected colorName(value: string): string;
-    /**
-     * Loads the teams available for shared-workspace notes and populates the teams dropdown.
-     * Pre-selects the team matching the current item's teamId, defaulting to "Personale".
-     */
-    private loadTeams;
-    /**
-     * Saves the note via the service and emits the result through the `done` output.
-     * For new notes, assigns the selected team before saving.
-     */
-    protected ok(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<ClipperNoteEditComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperNoteEditComponent, "ng-component", never, {}, { "done": "done"; }, never, never, true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<ClipperDocumentMenuComponent, "clipper-document-menu", never, { "useSelections": { "alias": "useSelections"; "required": false; "isSignal": true; }; "selectionSource": { "alias": "selectionSource"; "required": false; "isSignal": true; }; "parent": { "alias": "parent"; "required": true; "isSignal": true; }; "item": { "alias": "item"; "required": false; "isSignal": true; }; "isReference": { "alias": "isReference"; "required": false; "isSignal": true; }; "isReadable": { "alias": "isReadable"; "required": false; "isSignal": true; }; "isReadableModel": { "alias": "isReadableModel"; "required": false; "isSignal": true; }; "isLawInForce": { "alias": "isLawInForce"; "required": false; "isSignal": true; }; "canPrint": { "alias": "canPrint"; "required": false; "isSignal": true; }; "canFind": { "alias": "canFind"; "required": false; "isSignal": true; }; "canUseAIAssistant": { "alias": "canUseAIAssistant"; "required": false; "isSignal": true; }; "canUseRS": { "alias": "canUseRS"; "required": false; "isSignal": true; }; "canOpenDocument": { "alias": "canOpenDocument"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
 }
 
 interface ClipperReferencesDialogData {
@@ -1270,7 +1085,6 @@ interface ClipperReferencesDialogData {
     anchorTitle?: string;
     documentId: string;
     model: number;
-    canUseArchive?: boolean;
     canHandleTooManyResults?: boolean;
 }
 interface ClipperReferenceDialogResult {
@@ -1450,13 +1264,11 @@ declare class ClipperDocumentsUtils {
      * @param selectionMode - The Clipper selection mode to activate inside the viewer.
      * @param selectableModules - The list of Clipper modules available for selection.
      * @param theme - The UI theme to apply. Defaults to the system theme.
-     * @param canUseArchive - When `true`, archive access is enabled inside the viewer.
-     * @param canUseNotes - When `true`, notes access is enabled inside the viewer.
      * @param canHandleTooManyResults - When `true`, the component handles oversized result sets.
      * @param replaceUrl - When provided, after the dialog closes the method calls `window.close()`
      *   if the page was opened by another window, or navigates to this URL otherwise.
      */
-    static openDocument(injector: Injector, documentId: string, query?: string, queryChunks?: string, selectionMode?: ClipperSelectionMode, selectableModules?: ClipperModule[], theme?: ThemeType, canUseArchive?: boolean, canUseNotes?: boolean, canHandleTooManyResults?: boolean, replaceUrl?: string): void;
+    static openDocument(injector: Injector, documentId: string, query?: string, queryChunks?: string, selectionMode?: ClipperSelectionMode, selectableModules?: ClipperModule[], theme?: ThemeType, canHandleTooManyResults?: boolean, replaceUrl?: string): void;
     /**
      * Extracts the display title from a full document title by stripping any trailing `[...]` suffix.
      * @param title - The full document title, which may contain a bracketed qualifier.
@@ -1465,5 +1277,5 @@ declare class ClipperDocumentsUtils {
     static parseDocumentTitle(title: string): string;
 }
 
-export { ClipperBrowserComponent, ClipperBrowserDialogComponent, ClipperContactEditComponent, ClipperContactsSelector, ClipperDocumentComponent, ClipperDocumentIndexComponent, ClipperDocumentManager, ClipperDocumentMenuComponent, ClipperDocumentsUtils, ClipperNoteBadgeComponent, ClipperNoteEditComponent, ClipperReferencesComponent, ClipperSearchCalendarComponent, ClipperSearchFacetsComponent, ClipperSearchFreeTextHelpComponent, ClipperSearchFreeTextQueryBuilderComponent, ClipperSearchResultItemComponent, ClipperSearchResultItemDisplayMode, ClipperSearchResultManager };
+export { ClipperBrowserComponent, ClipperBrowserDialogComponent, ClipperDocumentComponent, ClipperDocumentIndexComponent, ClipperDocumentManager, ClipperDocumentMenuComponent, ClipperDocumentsUtils, ClipperReferencesComponent, ClipperSearchCalendarComponent, ClipperSearchFacetsComponent, ClipperSearchFreeTextHelpComponent, ClipperSearchFreeTextQueryBuilderComponent, ClipperSearchResultItemComponent, ClipperSearchResultItemDisplayMode, ClipperSearchResultManager };
 export type { ClipperBrowserDialogData, ClipperDocumentDialogData, ClipperDocumentIndexDialogData, ClipperDocumentIndexDialogResult, ClipperReferenceDialogResult, ClipperReferencesDialogData, SearchFreeTextQueryParams };

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

@@ -1,63 +1,275 @@
+import { RawEditorOptions, TinyMCE, Editor } from 'tinymce';
 import * as _angular_core from '@angular/core';
+import { OnInit, OnDestroy } from '@angular/core';
+import { ControlValueAccessor } from '@angular/forms';
 
+/**
+ * The editor profiles the applications ask for, ready to be handed to
+ * `[tinymceConfig]` on {@link TinymceEditorDirective}.
+ *
+ * They describe **what the editor offers** — plugins, toolbar, formats, link and image
+ * behaviour — and nothing else. Everything about *loading* TinyMCE (`base_url`, `suffix`,
+ * `language`, `language_url`, `license_key`) and about the *theme* (`skin`, `content_css`)
+ * belongs to `TinymceLoaderService` and to the directive, which resolve them against the
+ * document base href and against `ThemeService`: a preset repeating them could only get them
+ * wrong, and used to — the old ones pinned a relative `assets/tinymce` that broke under a
+ * sub-path, and read the skin from `prefers-color-scheme` instead of the theme the user chose.
+ *
+ * Uploads are the same story: `automatic_uploads`, `paste_data_images` and `file_picker_types`
+ * follow the `tinymceImageUploader` input, so an editor without a handler cannot end up
+ * offering an upload tab that leads nowhere.
+ *
+ * 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 {
     /**
-     * Returns `true` when the user agent currently prefers a dark color scheme.
-     * Evaluated on demand (not frozen at module load) and SSR-safe.
+     * 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 prefersDark;
-    /** URL of the TinyMCE script hosted on the Tiny Cloud CDN. */
-    static readonly CDN_URL = "https://cdn.tiny.cloud/1/5lnoc6ohmpjau6zyzgqyhyf52cueoennkcs8v1yfoak57ku9/tinymce/7/tinymce.min.js";
-    /** URL of the locally bundled TinyMCE script. */
-    static readonly LOCAL_URL = "/assets/tinymce/tinymce.min.js";
+    private static readonly FULL;
     /**
-     * Full-featured TinyMCE base configuration with all standard plugins and toolbar.
+     * 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.
      */
-    static TinymceConfig: Record<string, any>;
+    private static readonly COMPACT;
+    /** The compact one plus full screen, the insert group and the source view. */
+    private static readonly COMPACT_EXTENDED;
     /**
-     * Compact TinyMCE configuration with autoresize, bottom toolbar, and grouped toolbar buttons.
-     * Extends `TinymceConfig` with reduced height and a simplified toolbar.
+     * The full-page profile.
+     * @returns A fresh copy of the configuration, safe to modify.
      */
-    static TinymceCompactConfig: Record<string, any>;
+    static get TinymceConfig(): RawEditorOptions;
     /**
-     * Extended compact TinyMCE configuration that adds fullscreen support and an insert group.
-     * Extends `TinymceCompactConfig`.
+     * The in-form profile.
+     * @returns A fresh copy of the configuration, safe to modify.
      */
-    static TinymceCompactExtendedConfig: Record<string, any>;
+    static get TinymceCompactConfig(): RawEditorOptions;
     /**
-     * Inject the TinyMCE script tag into the document head if it is not already present.
-     * @param useCDN - When `true`, loads from the Tiny Cloud CDN; otherwise uses the local asset.
+     * The in-form profile with full screen and source view.
+     * @returns A fresh copy of the configuration, safe to modify.
      */
-    static loadTinyMCEScript(useCDN?: boolean): void;
+    static get TinymceCompactExtendedConfig(): RawEditorOptions;
 }
 
-interface FullScreenEditorDialogData {
+declare global {
+    interface Window {
+        tinymce?: TinyMCE;
+    }
+}
+/**
+ * Loads the self-hosted TinyMCE bundle on demand.
+ *
+ * TinyMCE is deliberately NOT imported by any module: a static import would pull ~500 kB into
+ * whichever chunk referenced it, and the editor is needed by exactly one dialog. The library is
+ * copied to `assets/tinymce` by the build (see `angular.json`) and injected here as a plain
+ * `<script>` the first time an editor is created, so it costs nothing until then and is served
+ * from the browser cache afterwards. Loading it this way also lets TinyMCE resolve its own theme,
+ * 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<TinymceLoaderService>;
+}
+
+/** Uploads one image and resolves with the URL to reference it by. */
+type TinymceImageUploader = (file: File) => Promise<string>;
+/**
+ * How the editor presents itself.
+ *
+ * `fixed` is the classic editor: the content lives in an iframe and the toolbar sits above it,
+ * pinned so it stays reachable while the surrounding container scrolls.
+ *
+ * `inline` edits the host element in place, with no iframe and no chrome until the user focuses
+ * 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';
+/**
+ * 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
+ * pristine/dirty state keep working exactly as they do on a plain control.
+ *
+ * The library itself is fetched on demand by <see cref="TinymceLoaderService"/>: nothing about
+ * TinyMCE reaches the bundle until an editor is actually created.
+ *
+ * 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>;
+}
+
+interface TinyMceEditorDialogData {
     text: string;
-    configuration: Record<string, any>;
+    configuration: RawEditorOptions;
     infoButtonLabel?: string;
     onShowInfo?: Function;
     disabled?: boolean;
 }
-declare class FullScreenEditorComponent {
+/**
+ * A dialog that is nothing but an editor: the caller hands it a text and gets the edited one
+ * back through {@link saving}.
+ *
+ * The editor is {@link TinymceEditorDirective} on a plain `<textarea>`, so this dialog costs
+ * 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<FullScreenEditorDialogData>;
+    protected readonly dialogData: _angular_core.WritableSignal<TinyMceEditorDialogData>;
     /** Whether the editor is in read-only mode. */
     protected readonly disabled: _angular_core.WritableSignal<boolean>;
     /** Current editor content, kept as a plain field for [(ngModel)] two-way binding. */
     protected text: string;
-    /** TinyMCE editor configuration. */
-    protected tinymceConfig: Record<string, any>;
+    /** The profile handed to the editor directive, merged over its defaults. */
+    protected tinymceConfig: RawEditorOptions;
     constructor();
     /**
      * Save the current editor content and close the dialog.
      */
     protected ok(): void;
-    static ɵfac: _angular_core.ɵɵFactoryDeclaration<FullScreenEditorComponent, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<FullScreenEditorComponent, "ng-component", never, {}, { "saving": "saving"; }, never, never, true, never>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<TinyMceEditorComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<TinyMceEditorComponent, "ng-component", never, {}, { "saving": "saving"; }, never, never, true, never>;
 }
 
-export { FullScreenEditorComponent, TinymceUtils };
-export type { FullScreenEditorDialogData };
+export { TinyMceEditorComponent, TinymceEditorDirective, TinymceLoaderService, TinymceUtils };
+export type { TinyMceEditorDialogData, TinymceImageUploader, TinymceToolbarMode };