mn-angular-lib 1.0.136 → 1.0.138

package/types/mn-angular-lib.d.ts

@@ -128,6 +128,13 @@ type MnAlertTemplateContext = {
     dismiss: () => void;
 };
 declare class MnAlertOutletComponent {
+    private readonly lang;
+    /**
+     * Accessible name for this control. Resolved through the conventional
+     * `mnAlert.close` key so an app can translate it, falling back to English when the
+     * key is not defined rather than leaking the raw key into the UI.
+     */
+    get closeLabel(): string;
     template?: TemplateRef<MnAlertTemplateContext>;
     private store;
     alerts$: Observable<MnAlert[]>;
@@ -3243,6 +3250,21 @@ declare class MnLanguageService {
      * Helper to retrieve a value from a potentially nested translation map using a dot-notated key.
      */
     private getValueFromMap;
+    /**
+     * Translate a key **only if it is defined**, returning `undefined` otherwise.
+     *
+     * {@link translate} deliberately returns the key itself when it is missing, which
+     * makes it unusable for a library's own default labels: a consumer that never
+     * defined `mnCollection.rowsPerPage` would see that raw string in their UI. This
+     * lets a caller try a conventional key and fall back to a readable English default
+     * when the app has not translated it, so components ship translatable strings
+     * without forcing every consumer to define them.
+     *
+     * @param key The dot-notated translation key.
+     * @param params Optional `{{name}}` interpolation values.
+     * @returns The translation, or `undefined` when the key is not defined.
+     */
+    translateIfPresent(key: string, params?: Record<string, string | number>): string | undefined;
     /**
      * Shorthand alias for `translate`.
      */
@@ -3399,6 +3421,24 @@ declare abstract class MnCollectionBase<T, DS extends MnCollectionDataSource<T>>
      * to keep the default (currently nothing).
      */
     protected onRowsChanged(): void;
+    /**
+     * Resolves a label three ways, in order: the consumer's explicit key, a
+     * conventional `mnCollection.*` key when the app defines one, and finally a
+     * readable English default.
+     *
+     * The middle step is what makes the components translatable out of the box: an
+     * app that adds the `mnCollection` namespace to its locale files gets every
+     * table, list and grid translated at once, with no per-call-site wiring across
+     * dozens of data sources. An app that does not keeps today's English text rather
+     * than leaking raw keys into the UI.
+     *
+     * @param consumerKey The data source's own translation key, if it set one.
+     * @param defaultKey The conventional key this label falls back to.
+     * @param fallback The English text used when neither key resolves.
+     * @param params Optional interpolation values.
+     * @returns The resolved label.
+     */
+    protected resolveLabel(consumerKey: string | undefined, defaultKey: string, fallback: string, params?: Record<string, string | number>): string;
     /**
      * Resolves translation keys to display strings via {@link MnLanguageService}.
      * Subclasses override to resolve their own keys; call `super` to keep these.
@@ -3469,12 +3509,6 @@ declare abstract class MnSelectableCollectionBase<T, DS extends MnSelectableColl
      * its ids matched a loaded row yet. See {@link beforeInitialFilter}.
      */
     private pendingInitialEmit;
-    /**
-     * The ids that arrived pre-selected, kept apart from {@link selectedIds} so
-     * {@link prioritizeInitialSelection} has a set that does **not** move as the user
-     * clicks. Null when the collection opened with nothing selected.
-     */
-    private pinnedSelectionIds;
     /**
      * Every selected row, in selection order, for the summary. Ids whose row was
      * never seen are skipped rather than rendered as a bare id.
@@ -3484,6 +3518,15 @@ declare abstract class MnSelectableCollectionBase<T, DS extends MnSelectableColl
     get showSelectionSummary(): boolean;
     /** How many tags to show before collapsing the remainder. */
     get selectionSummaryLimit(): number;
+    /**
+     * Tag count the summary collapses at when the data source names no limit.
+     *
+     * Subclasses that know their own width narrow this: the same eight tags that
+     * read as a compact header on a wide table become seven stacked lines in a phone
+     * sheet, pushing the rows they describe off screen. Overridden by
+     * {@link MnCollectionDataSource.selectionSummaryLimit}.
+     */
+    protected get defaultSelectionSummaryLimit(): number;
     /**
      * The tags to render: the first {@link selectionSummaryLimit} rows, or all of them
      * once expanded. Keeps a large selection from turning the header into the page.
@@ -3517,23 +3560,6 @@ declare abstract class MnSelectableCollectionBase<T, DS extends MnSelectableColl
      * @returns The label, or null when none can be derived.
      */
     protected defaultSelectionLabel(_row: T): string | null;
-    /**
-     * Reorders rows so the ones that were already selected when the collection
-     * opened come first, preserving the incoming order within each group.
-     *
-     * Deliberately keyed on the *initial* selection rather than the live one: pinning
-     * what the user is currently ticking would make a row jump to the top the instant
-     * it is clicked, moving the next row under the pointer mid-click. Freezing the set
-     * answers the actual question — "what was already chosen?" — and leaves the list
-     * still while it is being worked with. A row deselected during the session keeps
-     * its place for the same reason.
-     *
-     * Callers apply this only when no explicit sort is active, so a sorted column
-     * always wins.
-     * @param items The rows in their current order.
-     * @returns The rows with the initially-selected ones hoisted to the top.
-     */
-    protected prioritizeInitialSelection(items: T[]): T[];
     /** Seeds selection from `initialSelectedIds` before the first filter pass. */
     protected beforeInitialFilter(): void;
     /** Announces a deferred initial selection as soon as its rows are loaded. */
@@ -3566,6 +3592,7 @@ type MnPageSlot = {
  * reacts to the outputs.
  */
 declare class MnCollectionPagination {
+    private readonly lang;
     /** Prefix for the page-size select's id, keeping it unique per host. */
     idPrefix: string;
     isPaginated: boolean;
@@ -3594,17 +3621,61 @@ declare class MnCollectionPagination {
      * e.g. page 5 of 50 → `1 … 4 5 6 … 50`
      */
     get pageSlots(): MnPageSlot[];
-    /** Wrapper classes for a slot: anchors and their gaps are md+ only. */
-    slotVisibility(slot: MnPageSlot): string;
     /** e.g. `Page 5 of 50`. */
     get pageIndicatorLabel(): string;
     /** e.g. `41–50 of 250`. */
     get itemRangeLabel(): string;
+    /** "Items per page" label beside the page-size selector. */
+    get rowsPerPageLabel(): string;
     /**
      * Substitutes `{{name}}` placeholders, matching the interpolation syntax used
      * by MnLanguageService so the same translation strings work either way.
      */
     private fill;
+    /** Label for the load-more button. */
+    get loadMoreLabel(): string;
+    /** Accessible label for the first-page control. */
+    get firstPageLabel(): string;
+    /** Accessible label for the previous-page control. */
+    get previousPageLabel(): string;
+    /** Accessible label for the next-page control. */
+    get nextPageLabel(): string;
+    /** Accessible label for the last-page control. */
+    get lastPageLabel(): string;
+    /**
+     * Wrapper classes for one slot in the page strip, shrinking it in two steps as
+     * the footer narrows. Container queries, so the measurement is the footer's own
+     * width — the same strip is wide on a page and cramped in a modal.
+     *
+     * The first/last anchors and their gaps drop below 640px, where « and » already
+     * jump to either end. Below 380px every number except the current one drops too:
+     * the strip would otherwise wrap onto a second line and push the footer over the
+     * table, and the "Page 3 of 9" readout beside it already says where the user is.
+     * The arrows survive both steps, so navigation never depends on a number.
+     */
+    slotVisibility(slot: MnPageSlot): string;
+    /**
+     * Accessible label for a page-number button.
+     * @param page The page the button jumps to.
+     * @returns The label, naming the page.
+     */
+    pageLabel(page: number): string;
+    /**
+     * Resolves a label three ways, in order: the consumer's explicit text, the
+     * conventional `mnCollection.*` key when the app defines one, and finally a
+     * readable English default.
+     *
+     * Mirrors `MnCollectionBase.resolveLabel`; this component is presentational and
+     * does not extend that base, but its chrome must be just as translatable — the
+     * page-size label and the item-range readout are on screen for every paged
+     * collection in the app.
+     *
+     * @param explicit The label the host passed in, if any.
+     * @param key The conventional translation key to try.
+     * @param fallback The English text used when neither resolves.
+     * @returns The resolved label.
+     */
+    private label;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnCollectionPagination, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnCollectionPagination, "mn-collection-pagination", never, { "idPrefix": { "alias": "idPrefix"; "required": false; }; "isPaginated": { "alias": "isPaginated"; "required": false; }; "isServerPaginated": { "alias": "isServerPaginated"; "required": false; }; "showLoadMore": { "alias": "showLoadMore"; "required": false; }; "loadingMoreRows": { "alias": "loadingMoreRows"; "required": false; }; "currentPage": { "alias": "currentPage"; "required": false; }; "pageSize": { "alias": "pageSize"; "required": false; }; "totalPages": { "alias": "totalPages"; "required": false; }; "totalItemCount": { "alias": "totalItemCount"; "required": false; }; "visiblePages": { "alias": "visiblePages"; "required": false; }; "pageSizeSelectOptions": { "alias": "pageSizeSelectOptions"; "required": false; }; "labels": { "alias": "labels"; "required": false; }; }, { "loadMore": "loadMore"; "pageChange": "pageChange"; "pageSizeChange": "pageSizeChange"; }, never, never, true, never>;
 }
@@ -3879,10 +3950,13 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
     isColumnFilterActive(column: ColumnDefinition<T>): boolean;
     /** Filter options formatted for mn-multi-select for a given column. */
     getFilterMultiSelectOptions(column: ColumnDefinition<T>): MnMultiSelectOption<string>[];
-    /** Any / Yes / No options for a boolean column filter. */
-    getBooleanFilterOptions(column: ColumnDefinition<T>): MnSelectOption<string>[];
-    /** Filter options formatted for mn-select for a given column. */
-    getFilterSelectOptions(column: ColumnDefinition<T>): MnSelectOption<string>[];
+    /** Label for the small-screen filters toggle button. */
+    get filtersButtonLabel(): string;
+    /**
+     * Summary a multi-select filter collapses to once more than one option is picked.
+     * Resolved with the `{count}` token intact for mn-multi-select to fill in.
+     */
+    get filterSelectedLabel(): string;
     /** Current text/select filter value for a column. */
     textFilterValue(column: ColumnDefinition<T>): string;
     /** Current multi-select filter value for a column. */
@@ -3893,15 +3967,12 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
     clearAllFilters(): void;
     /** Whether any column has filtering enabled. */
     get hasColumnFilters(): boolean;
-    /** Label for the small-screen filters toggle button. */
-    get filtersButtonLabel(): string;
-    /**
-     * Summary a multi-select filter collapses to once more than one option is picked.
-     * Resolved with the `{count}` token intact for mn-multi-select to fill in.
-     */
-    get filterSelectedLabel(): string;
     /** Label for the "clear all filters" action in the small-screen panel. */
     get clearFiltersButtonLabel(): string;
+    /** Heading for the selection summary, with the count filled in. */
+    get selectionSummaryTitle(): string;
+    /** Label for the summary's clear-everything action. */
+    get selectionClearAllLabel(): string;
     /** Opens/closes the stacked filter panel shown on small screens. */
     toggleFiltersPanel(): void;
     private readonly baseTableClasses;
@@ -3944,18 +4015,23 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
     get tableClasses(): string;
     /** Page size to use at/above the `md` breakpoint (consumer's pageSize, or the user's selection). */
     private desktopPageSize;
-    /** Heading for the selection summary, with the count filled in. */
-    get selectionSummaryTitle(): string;
-    /** Label for the summary's clear-everything action. */
-    get selectionClearAllLabel(): string;
     /** Label for the summary's expand/collapse control. */
     get selectionSummaryToggleLabel(): string;
-    /**
-     * Accessible label for a tag's remove button.
-     * @param row The row the tag stands for.
-     * @returns The label, naming the row so screen readers announce which one goes.
+    /** Placeholder and accessible name for the search box. */
+    get searchPlaceholderLabel(): string;
+    /** Accessible name for the scrollable table region. */
+    get tableRegionLabel(): string;
+    /**
+     * Fewer tags once the table is narrow. A tag holding a person's full name takes
+     * a whole line at phone width, so the eight that read as a compact header on a
+     * wide table become eight stacked lines in a modal sheet — the summary then
+     * occupies more of the screen than the rows it is summarising.
+     *
+     * Reuses {@link filtersCollapsed} rather than measuring again: it is already
+     * maintained on every resize and means exactly "this table is under 640px".
+     * The heading still states the true total, so the hidden tags cost no information.
      */
-    selectionRemoveLabel(row: T): string;
+    protected get defaultSelectionSummaryLimit(): number;
     /** Tracks the desktop page size when the user picks one (selector only shows at >= md). */
     onPageSizeChange(newSize: number): void;
     /** The effective column-width strategy, defaulting to `stable`. */
@@ -3967,6 +4043,8 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
      * it sits in could still have grown to fit it.
      */
     get widthsArePinned(): boolean;
+    /** Any / Yes / No options for a boolean column filter. */
+    getBooleanFilterOptions(column: ColumnDefinition<T>): MnSelectOption<string>[];
     /**
      * The width to render for a column: the consumer's own declared width always
      * wins, then a width pinned by the `stable` layout, otherwise none.
@@ -4083,6 +4161,14 @@ declare class MnTable<T = object> extends MnSelectableCollectionBase<T, TableDat
     /** Resolves the range / boolean filter control labels from their translation keys. */
     private resolveFilterLabelKeys;
     private applySorting;
+    /** Filter options formatted for mn-select for a given column. */
+    getFilterSelectOptions(column: ColumnDefinition<T>): MnSelectOption<string>[];
+    /**
+     * Accessible label for a tag's remove button.
+     * @param row The row the tag stands for.
+     * @returns The label, naming the row so screen readers announce which one goes.
+     */
+    selectionRemoveLabel(row: T): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnTable<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnTable<any>, "mn-table", never, {}, { "sortChange": "sortChange"; "rowClick": "rowClick"; }, never, never, true, never>;
 }
@@ -5309,6 +5395,13 @@ declare class MnModalService {
 }
 
 declare class MnModalShellComponent<TResult = unknown> implements OnInit, AfterViewInit, OnDestroy {
+    private readonly lang;
+    /**
+     * Accessible name for this control. Resolved through the conventional
+     * `mnModal.close` key so an app can translate it, falling back to English when the
+     * key is not defined rather than leaking the raw key into the UI.
+     */
+    get closeModalLabel(): string;
     private el;
     private cdr;
     /** Downward release speed (px/ms) above which a short drag still dismisses — a "flick".
@@ -5822,6 +5915,8 @@ declare class MnList<T = unknown> extends MnSelectableCollectionBase<T, ListData
     protected get trackedToolbarTemplate(): TemplateRef<unknown> | undefined;
     protected collectionBody?: ElementRef<HTMLElement>;
     protected applyFilter(searchForItems: boolean): void;
+    /** Accessible name for the scrollable list region. */
+    get listRegionLabel(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnList<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnList<any>, "mn-list", never, {}, { "itemClick": "itemClick"; }, never, never, true, never>;
 }
@@ -5930,6 +6025,10 @@ declare class MnGrid<T = unknown> extends MnCollectionBase<T, GridDataSource<T>>
     protected collectionBody?: ElementRef<HTMLElement>;
     onItemClick(item: T): void;
     protected applyFilter(searchForItems: boolean): void;
+    /** Accessible name for the scrollable grid region. */
+    get gridRegionLabel(): string;
+    /** Accessible name for the loading placeholder. */
+    get loadingLabel(): string;
     static ɵfac: i0.ɵɵFactoryDeclaration<MnGrid<any>, never>;
     static ɵcmp: i0.ɵɵComponentDeclaration<MnGrid<any>, "mn-grid", never, {}, { "itemClick": "itemClick"; }, never, never, true, never>;
 }
@@ -6189,6 +6288,12 @@ type MonthItem = {
  * ```
  */
 declare class CalendarViewComponent implements OnInit, OnDestroy {
+    /**
+     * Accessible name for this control. Resolved through the conventional
+     * `mnCalendar.calendarView` key so an app can translate it, falling back to English when the
+     * key is not defined rather than leaking the raw key into the UI.
+     */
+    get calendarViewLabel(): string;
     /** Whether to show the action button in the toolbar. */
     showButton: boolean;
     /** Label text for the action button. */
@@ -6286,6 +6391,13 @@ type DisplayHourRow$1 = {
  * so they appear side-by-side rather than stacked.
  */
 declare class CalendarWeekComponent implements OnInit, OnDestroy {
+    private readonly lang;
+    /**
+     * Accessible name for this control. Resolved through the conventional
+     * `mnCalendar.weekView` key so an app can translate it, falling back to English when the
+     * key is not defined rather than leaking the raw key into the UI.
+     */
+    get weekViewLabel(): string;
     private layoutService;
     private cdr;
     /** The date around which the week is centred. */
@@ -6356,6 +6468,13 @@ type DisplayHourRow = {
  * {@link CalendarEventLayoutService}.
  */
 declare class CalendarDayComponent implements OnInit, OnDestroy {
+    private readonly lang;
+    /**
+     * Accessible name for this control. Resolved through the conventional
+     * `mnCalendar.dayView` key so an app can translate it, falling back to English when the
+     * key is not defined rather than leaking the raw key into the UI.
+     */
+    get dayViewLabel(): string;
     private layoutService;
     private cdr;
     /** The date to display. */
@@ -6415,6 +6534,13 @@ declare class CalendarDayComponent implements OnInit, OnDestroy {
  * events on that day. Clicking a cell emits `dayClicked`.
  */
 declare class CalendarMonthComponent implements OnInit, OnDestroy {
+    private readonly lang;
+    /**
+     * Accessible name for this control. Resolved through the conventional
+     * `mnCalendar.monthView` key so an app can translate it, falling back to English when the
+     * key is not defined rather than leaking the raw key into the UI.
+     */
+    get monthViewLabel(): string;
     /** The date whose month is displayed. */
     focusDay: Date;
     /** Observable that emits the full event list whenever it changes. */
@@ -6502,6 +6628,13 @@ declare class CalendarEventDefaultComponent implements CalendarEventData, OnInit
  * (events whose end time is in the future), sorted by start time.
  */
 declare class UpcomingEventsComponent implements OnInit, OnChanges, OnDestroy {
+    private readonly lang;
+    /**
+     * Accessible name for this control. Resolved through the conventional
+     * `mnCalendar.upcomingEvents` key so an app can translate it, falling back to English when the
+     * key is not defined rather than leaking the raw key into the UI.
+     */
+    get upcomingEventsLabel(): string;
     /** Observable that emits the full event list whenever it changes. */
     eventsChanged: Observable<CalendarEvent[]>;
     /** Resolved calendar configuration passed from the parent view. */
@@ -6723,6 +6856,12 @@ type MnTabDataSource = {
 declare class MnTabComponent implements DoCheck, AfterViewInit, OnDestroy {
     /** The horizontally-scrolling wrapper the edge fade is painted onto. */
     private scrollContainer?;
+    /** The tab row; queried for the active tab so the indicator can measure it. */
+    private tabList?;
+    /** The shared underline that slides to the active tab. */
+    private indicator?;
+    /** Pending indicator remeasure, cancelled on destroy so a post-destroy frame can't read a detached ref. */
+    private indicatorFrame?;
     /** How far the fade reaches in from each overflowing edge. */
     private static readonly FADE;
     /** Data source containing tab items and default active index. */
@@ -6788,6 +6927,20 @@ declare class MnTabComponent implements DoCheck, AfterViewInit, OnDestroy {
      * @param item - The tab item to activate.
      */
     setActive(item: MnTabItem): void;
+    /**
+     * Moves the shared underline to the active tab. When `animate` is false the
+     * move is snapped (no slide) by disabling the transition for one reflow —
+     * used on init, async selection and resize, where a slide would read as jank.
+     * @param animate - Whether the move should slide (true) or snap (false).
+     */
+    private updateIndicator;
+    /**
+     * Remeasures the indicator on the next animation frame, so the read happens
+     * after layout reflects the latest active-tab classes. Coalesces bursts and
+     * is cancellable on destroy.
+     * @param animate - Whether the resulting move should slide.
+     */
+    private scheduleIndicator;
     /**
      * Returns the resolved badge value for a tab item, supporting both plain numbers and Signal<number>.
      * @param item - The tab item whose badge to resolve.
@@ -6803,6 +6956,158 @@ declare class MnTabComponent implements DoCheck, AfterViewInit, OnDestroy {
     static ɵcmp: i0.ɵɵComponentDeclaration<MnTabComponent, "mn-tab", never, { "dataSource": { "alias": "dataSource"; "required": false; }; "scrollable": { "alias": "scrollable"; "required": false; }; "justified": { "alias": "justified"; "required": false; }; }, { "activeChange": "activeChange"; }, never, never, true, never>;
 }
 
+/**
+ * One control on the editor's default toolbar.
+ *
+ * The list doubles as the key space for {@link MnRichTextEditorLabels}: a label
+ * can only be given for a control the default toolbar actually renders.
+ */
+type MnRichTextEditorControl = 'textStyle' | 'bold' | 'italic' | 'underline' | 'strike' | 'orderedList' | 'bulletList' | 'blockquote' | 'codeBlock' | 'link' | 'clean';
+/**
+ * Hover labels for the toolbar controls.
+ *
+ * Values are either literal text (`labels`) or translation keys resolved through
+ * `MnLanguageService` (`labelKeys`); anything left out falls back to the
+ * component's built-in English label.
+ */
+type MnRichTextEditorLabels = Partial<Record<MnRichTextEditorControl, string>>;
+/**
+ * A Quill toolbar definition: rows of control descriptors, exactly as Quill's
+ * `modules.toolbar` option takes them.
+ *
+ * Typed loosely on purpose — Quill accepts strings (`'bold'`) and objects
+ * (`{ header: [2, 3, false] }`) in the same row, and the library does not export
+ * a type for it.
+ */
+type MnRichTextEditorToolbar = readonly (readonly unknown[])[];
+
+/**
+ * Thin wrapper around the {@link Quill} rich-text editor.
+ *
+ * Quill is used **directly** rather than through an Angular wrapper package: the
+ * wrapper libraries carry peer-dependency ranges that lag behind Angular's
+ * release train, and none of them add anything this component needs.
+ *
+ * Consumers must install `quill` themselves (it is an optional peer dependency)
+ * and load its snow theme, e.g. `node_modules/quill/dist/quill.snow.css` in the
+ * `styles` array of `angular.json`. Only the chrome around that theme — radius,
+ * borders, height limits and the toolbar tooltips — belongs to this component;
+ * recolouring Quill's own palette to an app theme stays with the app, because
+ * the same `.ql-snow` markup is normally reused to render stored HTML in places
+ * where no editor is mounted.
+ *
+ * Quill itself is pulled in with a dynamic `import()` when the editor mounts.
+ * This component sits in the library's single entry point, which apps import
+ * eagerly, so a static import would put the whole editor engine in every app's
+ * initial bundle — including the pages that never open one.
+ *
+ * Zoneless notes: nothing here relies on an implicit change-detection tick. The
+ * editor is created inside {@link afterNextRender} (the host element only exists
+ * after the first render pass) and every value that flows back out is written to
+ * a signal or emitted through an `output`, both of which schedule change
+ * detection themselves. No `setTimeout`, no manual `detectChanges`.
+ *
+ * The produced HTML is **not** trusted: sanitise it before rendering it anywhere.
+ *
+ * @example
+ * ```html
+ * <mn-rich-text-editor
+ *   [content]="draft()"
+ *   [placeholder]="'minutes.placeholder' | mnTranslate"
+ *   [labelKeys]="{ bold: 'editor.bold', italic: 'editor.italic' }"
+ *   (contentChange)="draft.set($event)">
+ * </mn-rich-text-editor>
+ * ```
+ */
+declare class MnRichTextEditor implements OnDestroy {
+    /**
+     * The initial HTML content. Later changes are applied only when they differ
+     * from what the editor currently holds, so a parent echoing the emitted value
+     * back never moves the caret.
+     */
+    readonly content: i0.InputSignal<string>;
+    /** Placeholder shown while the editor is empty. */
+    readonly placeholder: i0.InputSignal<string>;
+    /** Accessible label for the editing surface. */
+    readonly ariaLabel: i0.InputSignal<string>;
+    /** Toolbar layout, in Quill's own format. Defaults to a prose-oriented set. */
+    readonly toolbar: i0.InputSignal<MnRichTextEditorToolbar>;
+    /** Literal hover labels per toolbar control. */
+    readonly labels: i0.InputSignal<Partial<Record<MnRichTextEditorControl, string>>>;
+    /** Translation keys per toolbar control; takes precedence over `labels`. */
+    readonly labelKeys: i0.InputSignal<Partial<Record<MnRichTextEditorControl, string>>>;
+    /**
+     * Utilities applied to the wrapper, for sizing the writing surface. Overriding
+     * this replaces the default height limits, so pass both bounds when you do.
+     */
+    readonly editorClass: i0.InputSignal<string>;
+    /** Emits the editor's HTML on every user edit. */
+    readonly contentChange: i0.OutputEmitterRef<string>;
+    /**
+     * Chrome around Quill's snow theme: the field's radius, border and surface.
+     *
+     * Descendant variants rather than a stylesheet — the utilities come from the
+     * consuming app's Tailwind build (which scans this bundle), so they follow the
+     * app's theme tokens the same way the rest of the library does.
+     */
+    protected readonly chromeClass: string;
+    /** Host element, used to keep DOM queries inside this component. */
+    private readonly host;
+    /** Language service, used to resolve the toolbar labels from keys. */
+    private readonly lang;
+    /** The container Quill mounts into. */
+    private readonly editorHost;
+    /** The live editor instance, or null before Quill has loaded. */
+    private quill;
+    /** Whether the component is gone, so a late Quill load knows to stop. */
+    private destroyed;
+    /** The last HTML this component emitted, used to skip redundant writes. */
+    private readonly lastEmitted;
+    constructor();
+    /** Drops the editor reference so the instance can be garbage collected. */
+    ngOnDestroy(): void;
+    /** Moves focus into the editing surface. */
+    focusEditor(): void;
+    /**
+     * Loads Quill, builds the instance and wires its change handler.
+     *
+     * Nothing awaits this beyond the component itself: the surface appears once
+     * the engine has loaded, and until then the `content` effect is a no-op that
+     * the seeding below makes good.
+     */
+    private createEditor;
+    /**
+     * Gives each toolbar control a hover label, so hovering explains what the
+     * style does. Set on the Quill-generated DOM after init; a control the current
+     * toolbar does not render is simply skipped.
+     */
+    private applyToolbarLabels;
+    /**
+     * Picks the hover label for one control.
+     * @param control The control being labelled.
+     * @param labels Literal labels supplied by the consumer.
+     * @param keys Translation keys supplied by the consumer.
+     * @returns The translated key, the literal label, or the built-in default.
+     */
+    private resolveLabel;
+    /**
+     * Replaces the editor content with stored HTML. Quill parses it into its own
+     * document model, which silently drops anything it has no format for — a
+     * useful extra filter on top of the consumer's sanitiser.
+     * @param html The HTML to load into the editor.
+     */
+    private setEditorHtml;
+    /** Emits the editor's current HTML, normalising Quill's "empty" document. */
+    private emitCurrentHtml;
+    /**
+     * Reads the editor's HTML.
+     * @returns The current HTML, or an empty string when the editor is blank.
+     */
+    private readHtml;
+    static ɵfac: i0.ɵɵFactoryDeclaration<MnRichTextEditor, never>;
+    static ɵcmp: i0.ɵɵComponentDeclaration<MnRichTextEditor, "mn-rich-text-editor", never, { "content": { "alias": "content"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; "toolbar": { "alias": "toolbar"; "required": false; "isSignal": true; }; "labels": { "alias": "labels"; "required": false; "isSignal": true; }; "labelKeys": { "alias": "labelKeys"; "required": false; "isSignal": true; }; "editorClass": { "alias": "editorClass"; "required": false; "isSignal": true; }; }, { "contentChange": "contentChange"; }, never, never, true, never>;
+}
+
 declare const mnIconVariants: tailwind_variants.TVReturnType<{
     color: {
         current: string;
@@ -7357,5 +7662,5 @@ type MnPreviewMessage = {
  */
 declare function enableMnPreviewMode(configService: MnConfigService, langService: MnLanguageService, allowedOrigins?: string[]): void;
 
-export { API_BASE_URL, ActionStyle, BackdropMode, BaseModalBuilder, CALENDAR_CONFIG, CALENDAR_DATE_FORMATTER, CalendarDayComponent, CalendarEventComponent, CalendarEventDefaultComponent, CalendarEventLayoutService, CalendarMonthComponent, CalendarUtility, CalendarView, CalendarViewComponent, CalendarWeekComponent, CloseMode, ColumnSortType, ConfirmationModalBuilder, ConfirmationTone, CrudService, CustomModalBuilder, DEFAULT_CALENDAR_CONFIG, DEFAULT_MN_ALERT_CONFIG, DefaultCalendarDateFormatter, FieldAppearance, FieldKind, FormLayoutMode, FormModalBuilder, KeyboardMode, MN_ALERT_CONFIG, MN_CALENDAR_COMPONENT_NAME, MN_CALENDAR_CONFIG, MN_CHECKBOX_CONFIG, MN_DATETIME_CONFIG, MN_HAPTICS, MN_ICON_MAP, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MODAL_ACTION_ICONS, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MODAL_ACTION_ICON_SIZE, MODAL_ACTION_ICON_SIZE_SM, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnButton, MnCheckbox, MnCollectionBase, MnCollectionPagination, MnCollectionState, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDateSelectorBar, MnDatetime, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, MnSectionDirective, MnSelect, MnSelectableCollectionBase, MnShowAboveDirective, MnShowBelowDirective, MnSkeleton, MnTabComponent, MnTable, MnTextarea, MnTranslatePipe, MnWizardBodyComponent, ModalBuilder, ModalCloseReason, ModalIntent, ModalKind, ModalSize, NavigationDirection, OptionState, SelectionMode, StepBuilder, StepState, SubmitMode, UpcomingEventRowComponent, UpcomingEventsComponent, ValidationCode, ValidationStatus, WizardFlowMode, WizardModalBuilder, dateTimeAdapter, defaultFilterPredicate, defaultIconForStyle, defaultTextAdapter, emptyFilterValue, enableMnPreviewMode, isFilterValueActive, isTranslatable, matchesColumnFilter, mnAlertVariants, mnBadgeVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnFileInputVariants, mnIconVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnSkeletonVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig, resolveFilterableValue };
-export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnBase, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ColumnFilterValue, ColumnSkeleton, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DateSelectorBarLayout, DatetimeFieldConfig, DayTile, FailureResult, FieldDataSource, FieldRequiredCondition, FieldValidator, FieldVisibilityCondition, FileFieldConfig, FormFieldConfig, FormFieldGroup, FormModalConfig, FormRow, FormRowField, FormValidator, GridDataSource, GridLayout, GridSkeleton, HourRow, ListAppearance, ListDataSource, ListLabels, ListSkeleton, MnAlert, MnAlertConfig, MnAlertId, MnAlertKind, MnAlertTemplateContext, MnAlertVariants, MnBadgeTypes, MnBadgeVariants, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnCollectionDataSource, MnCollectionLabels, MnColumnFilter, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessageFn, MnErrorMessagesData, MnFileDisplayItem, MnFileInputDisplayMode, MnFileInputErrorMessageData, MnFileInputErrorMessagesData, MnFileInputProps, MnFileInputUIConfig, MnFileInputVariants, MnHapticStyle, MnHapticsHandler, MnIconTypes, MnIconVariants, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPageSlot, MnPreviewMessage, MnQueryParams, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, MnTableFilterLabels, MnTextareaErrorMessageData, MnTextareaErrorMessagesData, MnTextareaProps, MnTextareaUIConfig, MnTextareaVariants, MnTranslatable, MnTranslationMap, MnTranslations, MnValidationErrorArgs, ModalCancelHandler, ModalCloseEvent, ModalConfig, ModalFooterAction, ModalI18nLabels, ModalInputMap, ModalPollingConfig, ModalRef, ModalResultHandler, ModalStepId, MonthItem, MultiSelectFieldConfig, MultiSelectTableFieldConfig, NumberFieldConfig, OffsetPaginationStrategy, PaginationMode, PaginationStrategy, PasswordFieldConfig, Primitive, QueryParams, QueryValue, RatingFieldConfig, Result, ResultMeta, SelectFieldConfig, SelectOption, SingleSelectTableFieldConfig, SliderFieldConfig, SortState, StepBodyConfig, StepGuard, StepValidator, SuccessResult, TableAppearance, TableDataSource, TableLabels, TextFieldConfig, TextareaFieldConfig, ValidationResult, WizardBeforeCompleteValidator, WizardModalConfig, WizardResult, WizardStepChangeEvent, WizardStepChangeHandler, WizardStepConfig };
+export { API_BASE_URL, ActionStyle, BackdropMode, BaseModalBuilder, CALENDAR_CONFIG, CALENDAR_DATE_FORMATTER, CalendarDayComponent, CalendarEventComponent, CalendarEventDefaultComponent, CalendarEventLayoutService, CalendarMonthComponent, CalendarUtility, CalendarView, CalendarViewComponent, CalendarWeekComponent, CloseMode, ColumnSortType, ConfirmationModalBuilder, ConfirmationTone, CrudService, CustomModalBuilder, DEFAULT_CALENDAR_CONFIG, DEFAULT_MN_ALERT_CONFIG, DefaultCalendarDateFormatter, FieldAppearance, FieldKind, FormLayoutMode, FormModalBuilder, KeyboardMode, MN_ALERT_CONFIG, MN_CALENDAR_COMPONENT_NAME, MN_CALENDAR_CONFIG, MN_CHECKBOX_CONFIG, MN_DATETIME_CONFIG, MN_HAPTICS, MN_ICON_MAP, MN_INPUT_FIELD_CONFIG, MN_INSTANCE_ID, MN_LIB_DUAL_HORIZONTAL_IMAGE, MN_MODAL_ACTION_ICONS, MN_MULTI_SELECT_CONFIG, MN_SECTION_PATH, MN_SELECT_CONFIG, MN_TEXTAREA_CONFIG, MODAL_ACTION_ICON_SIZE, MODAL_ACTION_ICON_SIZE_SM, MnAlertOutletComponent, MnAlertService, MnAlertStore, MnBadge, MnButton, MnCheckbox, MnCollectionBase, MnCollectionPagination, MnCollectionState, MnConfigService, MnConfirmationBodyComponent, MnCustomBodyHostComponent, MnDateSelectorBar, MnDatetime, MnDualHorizontalImage, MnFileInput, MnFormBodyComponent, MnGrid, MnHiddenBelowDirective, MnHttpService, MnIcon, MnIconAttributes, MnInformationCard, MnInputField, MnInstanceDirective, MnLanguageService, MnList, MnModalRef, MnModalService, MnModalShellComponent, MnMultiSelect, MnRichTextEditor, MnSectionDirective, MnSelect, MnSelectableCollectionBase, MnShowAboveDirective, MnShowBelowDirective, MnSkeleton, MnTabComponent, MnTable, MnTextarea, MnTranslatePipe, MnWizardBodyComponent, ModalBuilder, ModalCloseReason, ModalIntent, ModalKind, ModalSize, NavigationDirection, OptionState, SelectionMode, StepBuilder, StepState, SubmitMode, UpcomingEventRowComponent, UpcomingEventsComponent, ValidationCode, ValidationStatus, WizardFlowMode, WizardModalBuilder, dateTimeAdapter, defaultFilterPredicate, defaultIconForStyle, defaultTextAdapter, emptyFilterValue, enableMnPreviewMode, isFilterValueActive, isTranslatable, matchesColumnFilter, mnAlertVariants, mnBadgeVariants, mnButtonVariants, mnCheckboxVariants, mnCheckboxWrapperVariants, mnDatetimeVariants, mnFileInputVariants, mnIconVariants, mnInformationCardVariants, mnInputFieldVariants, mnMultiSelectVariants, mnSelectVariants, mnSkeletonVariants, mnTextareaVariants, numberAdapter, pickAdapter, provideMnAlerts, provideMnCalendarConfig, provideMnComponentConfig, provideMnConfig, provideMnLanguage, resolveCalendarConfig, resolveFilterableValue };
+export type { AnimationOptions, ApiError, BaseModalConfig, CalendarButton, CalendarConfig, CalendarDateFormatter, CalendarEvent, CalendarEventData, CancellationActionConfig, CheckboxFieldConfig, ColorFieldConfig, ColorPreset, ColumnBase, ColumnDay, ColumnDefinition, ColumnFilterOption, ColumnFilterState, ColumnFilterType, ColumnFilterValue, ColumnSkeleton, ConfirmationActionConfig, ConfirmationModalConfig, CrudConfig, CurrentTimeCalendarEvent, CursorPaginationStrategy, CustomFieldConfig, CustomModalConfig, DateFieldConfig, DateSelectorBarLayout, DatetimeFieldConfig, DayTile, FailureResult, FieldDataSource, FieldRequiredCondition, FieldValidator, FieldVisibilityCondition, FileFieldConfig, FormFieldConfig, FormFieldGroup, FormModalConfig, FormRow, FormRowField, FormValidator, GridDataSource, GridLayout, GridSkeleton, HourRow, ListAppearance, ListDataSource, ListLabels, ListSkeleton, MnAlert, MnAlertConfig, MnAlertId, MnAlertKind, MnAlertTemplateContext, MnAlertVariants, MnBadgeTypes, MnBadgeVariants, MnButtonTypes, MnButtonVariants, MnCheckboxErrorMessageData, MnCheckboxErrorMessagesData, MnCheckboxProps, MnCheckboxUIConfig, MnCheckboxVariants, MnCheckboxWrapperVariants, MnCollectionDataSource, MnCollectionLabels, MnColumnFilter, MnConfigFile, MnConfigSettings, MnConfigValue, MnDatetimeErrorMessageData, MnDatetimeErrorMessagesData, MnDatetimeMode, MnDatetimeProps, MnDatetimeUIConfig, MnDatetimeVariants, MnDomAttrs, MnDualHorizontalImageConfig, MnDualHorizontalImageTypes, MnErrorMessageData, MnErrorMessageFn, MnErrorMessagesData, MnFileDisplayItem, MnFileInputDisplayMode, MnFileInputErrorMessageData, MnFileInputErrorMessagesData, MnFileInputProps, MnFileInputUIConfig, MnFileInputVariants, MnHapticStyle, MnHapticsHandler, MnIconTypes, MnIconVariants, MnImageType, MnInformationCardBaseData, MnInformationCardData, MnInformationCardVariants, MnInputAdapter, MnInputBaseProps, MnInputDateTimeProps, MnInputFieldProps, MnInputFieldUIConfig, MnInputProps, MnInputType, MnInputVariants, MnLanguageConfig, MnMultiSelectErrorMessageData, MnMultiSelectErrorMessagesData, MnMultiSelectOption, MnMultiSelectProps, MnMultiSelectUIConfig, MnMultiSelectVariants, MnPageSlot, MnPreviewMessage, MnQueryParams, MnRichTextEditorControl, MnRichTextEditorLabels, MnRichTextEditorToolbar, MnSelectErrorMessageData, MnSelectErrorMessagesData, MnSelectOption, MnSelectProps, MnSelectUIConfig, MnSelectVariants, MnSelectableCollectionDataSource, MnShowInput, MnSkeletonProps, MnSkeletonShape, MnSkeletonVariantProps, MnTabDataSource, MnTabItem, MnTableFilterLabels, MnTextareaErrorMessageData, MnTextareaErrorMessagesData, MnTextareaProps, MnTextareaUIConfig, MnTextareaVariants, MnTranslatable, MnTranslationMap, MnTranslations, MnValidationErrorArgs, ModalCancelHandler, ModalCloseEvent, ModalConfig, ModalFooterAction, ModalI18nLabels, ModalInputMap, ModalPollingConfig, ModalRef, ModalResultHandler, ModalStepId, MonthItem, MultiSelectFieldConfig, MultiSelectTableFieldConfig, NumberFieldConfig, OffsetPaginationStrategy, PaginationMode, PaginationStrategy, PasswordFieldConfig, Primitive, QueryParams, QueryValue, RatingFieldConfig, Result, ResultMeta, SelectFieldConfig, SelectOption, SingleSelectTableFieldConfig, SliderFieldConfig, SortState, StepBodyConfig, StepGuard, StepValidator, SuccessResult, TableAppearance, TableDataSource, TableLabels, TextFieldConfig, TextareaFieldConfig, ValidationResult, WizardBeforeCompleteValidator, WizardModalConfig, WizardResult, WizardStepChangeEvent, WizardStepChangeHandler, WizardStepConfig };