@mk-kit/ui 0.41.0 → 0.43.0

package/types/mk-kit-ui-icon-extended.d.ts

@@ -0,0 +1,83 @@
+import { MkIconMap } from '@mk-kit/ui/icon';
+import { EnvironmentProviders } from '@angular/core';
+
+/**
+ * GENERATED by scripts/gen-icons.mjs from scripts/icons.json — do not edit.
+ *
+ * The opt-in extended icon set: `MK_EXTENDED_ICONS` (everything) and one `MK_EXTENDED_ICONS_<GROUP>` subset per themed group. Every map is built by a call marked pure, so an app pays only for the maps it actually passes to `provideMkIcons()` / `provideMkExtendedIcons()`.
+ *
+ * Glyphs © Lucide Icons and Contributors, ISC licence (lucide-static
+ * v1.34.0); see THIRD_PARTY_NOTICES.md. Bodies only — the registry-facing
+ * maps wrap them with the same `<svg>` attributes as the hand-made defaults
+ * so both sets render identically.
+ */
+
+/** `navigation` subset of {@link MK_EXTENDED_ICONS} (34 icons). */
+declare const MK_EXTENDED_ICONS_NAVIGATION: MkIconMap;
+/** `layout` subset of {@link MK_EXTENDED_ICONS} (17 icons). */
+declare const MK_EXTENDED_ICONS_LAYOUT: MkIconMap;
+/** `data` subset of {@link MK_EXTENDED_ICONS} (15 icons). */
+declare const MK_EXTENDED_ICONS_DATA: MkIconMap;
+/** `files` subset of {@link MK_EXTENDED_ICONS} (22 icons). */
+declare const MK_EXTENDED_ICONS_FILES: MkIconMap;
+/** `communication` subset of {@link MK_EXTENDED_ICONS} (15 icons). */
+declare const MK_EXTENDED_ICONS_COMMUNICATION: MkIconMap;
+/** `people` subset of {@link MK_EXTENDED_ICONS} (11 icons). */
+declare const MK_EXTENDED_ICONS_PEOPLE: MkIconMap;
+/** `commerce` subset of {@link MK_EXTENDED_ICONS} (23 icons). */
+declare const MK_EXTENDED_ICONS_COMMERCE: MkIconMap;
+/** `status` subset of {@link MK_EXTENDED_ICONS} (20 icons). */
+declare const MK_EXTENDED_ICONS_STATUS: MkIconMap;
+/** `time` subset of {@link MK_EXTENDED_ICONS} (8 icons). */
+declare const MK_EXTENDED_ICONS_TIME: MkIconMap;
+/** `developer` subset of {@link MK_EXTENDED_ICONS} (23 icons). */
+declare const MK_EXTENDED_ICONS_DEVELOPER: MkIconMap;
+/** `devices` subset of {@link MK_EXTENDED_ICONS} (15 icons). */
+declare const MK_EXTENDED_ICONS_DEVICES: MkIconMap;
+/** `media` subset of {@link MK_EXTENDED_ICONS} (14 icons). */
+declare const MK_EXTENDED_ICONS_MEDIA: MkIconMap;
+/** `editing` subset of {@link MK_EXTENDED_ICONS} (34 icons). */
+declare const MK_EXTENDED_ICONS_EDITING: MkIconMap;
+/** `security` subset of {@link MK_EXTENDED_ICONS} (5 icons). */
+declare const MK_EXTENDED_ICONS_SECURITY: MkIconMap;
+/** `travel` subset of {@link MK_EXTENDED_ICONS} (9 icons). */
+declare const MK_EXTENDED_ICONS_TRAVEL: MkIconMap;
+/** `lifestyle` subset of {@link MK_EXTENDED_ICONS} (40 icons). */
+declare const MK_EXTENDED_ICONS_LIFESTYLE: MkIconMap;
+/**
+ * The themed subsets by group name — handy for a picker or for registering
+ * several groups at once: `provideMkIcons(MK_EXTENDED_ICON_GROUPS['files'])`.
+ */
+declare const MK_EXTENDED_ICON_GROUPS: Readonly<Record<string, MkIconMap>>;
+/**
+ * Every Lucide-derived icon (305 glyphs). Not registered by
+ * default — install it with `provideMkExtendedIcons()`, pass a themed subset
+ * to `provideMkIcons()`, or load it lazily:
+ * `provideMkIcons(() => import('@mk-kit/ui/icon/extended').then((m) => m.MK_EXTENDED_ICONS))`.
+ */
+declare const MK_EXTENDED_ICONS: MkIconMap;
+
+/**
+ * Registers the whole Lucide-derived extended set ({@link MK_EXTENDED_ICONS})
+ * so every `<mk-icon name="…">` in the catalogue resolves. Opt-in: without
+ * it only the hand-made defaults are available and an unknown name warns
+ * once in dev mode.
+ *
+ * ```ts
+ * import { provideMkExtendedIcons } from '@mk-kit/ui/icon/extended';
+ *
+ * bootstrapApplication(App, {
+ *   providers: [provideMkExtendedIcons()],
+ * });
+ * ```
+ *
+ * Size-conscious alternatives (see `provideMkIcons`): register only the
+ * themed subsets you use (`provideMkIcons(MK_EXTENDED_ICONS_FILES)`), or load
+ * the full set lazily in its own chunk:
+ * `provideMkIcons(() => import('@mk-kit/ui/icon/extended').then((m) => m.MK_EXTENDED_ICONS))`.
+ * The hand-made defaults keep their names — the generated set never
+ * overlaps them.
+ */
+declare function provideMkExtendedIcons(): EnvironmentProviders;
+
+export { MK_EXTENDED_ICONS, MK_EXTENDED_ICONS_COMMERCE, MK_EXTENDED_ICONS_COMMUNICATION, MK_EXTENDED_ICONS_DATA, MK_EXTENDED_ICONS_DEVELOPER, MK_EXTENDED_ICONS_DEVICES, MK_EXTENDED_ICONS_EDITING, MK_EXTENDED_ICONS_FILES, MK_EXTENDED_ICONS_LAYOUT, MK_EXTENDED_ICONS_LIFESTYLE, MK_EXTENDED_ICONS_MEDIA, MK_EXTENDED_ICONS_NAVIGATION, MK_EXTENDED_ICONS_PEOPLE, MK_EXTENDED_ICONS_SECURITY, MK_EXTENDED_ICONS_STATUS, MK_EXTENDED_ICONS_TIME, MK_EXTENDED_ICONS_TRAVEL, MK_EXTENDED_ICON_GROUPS, provideMkExtendedIcons };

package/types/mk-kit-ui-icon.d.ts

@@ -1,7 +1,7 @@
 import * as _angular_platform_browser from '@angular/platform-browser';
 import { SafeHtml } from '@angular/platform-browser';
 import * as _angular_core from '@angular/core';
-import { EnvironmentProviders } from '@angular/core';
+import { Signal, EnvironmentProviders } from '@angular/core';
 import { MkSize } from '@mk-kit/ui/core';
 
 /**
@@ -29,18 +29,31 @@ declare class MkIcon {
     readonly label: _angular_core.InputSignal<string>;
     /** CSS length for the icon box (width = height = font-size). */
     protected readonly dimension: _angular_core.Signal<string>;
-    /** Sanitized SVG for the named icon, or `null` (falls back to projection). */
+    /**
+     * Sanitized SVG for the named icon, or `null` (falls back to projection).
+     * Tracks the registry's `changes` so a late registration (lazy-loaded set,
+     * runtime `register()`) fills the icon in without re-binding `name`.
+     */
     protected readonly svg: _angular_core.Signal<_angular_platform_browser.SafeHtml | null>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkIcon, never>;
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkIcon, "mk-icon", never, { "name": { "alias": "name"; "required": false; "isSignal": true; }; "size": { "alias": "size"; "required": false; "isSignal": true; }; "label": { "alias": "label"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** A `{ name: '<svg …>…</svg>' }` map — what every registration API accepts. */
+type MkIconMap = Readonly<Record<string, string>>;
+/**
+ * Loads an icon map on demand — typically a dynamic import of the extended
+ * set: `() => import('@mk-kit/ui/icon/extended').then((m) => m.MK_EXTENDED_ICONS)`.
+ */
+type MkIconLoader = () => Promise<MkIconMap>;
 /**
- * IconRegistry — the name → SVG store behind `<mk-icon name="…">`. The built-in
- * sets — the hand-made {@link MK_DEFAULT_ICONS} and the Lucide-derived
- * {@link MK_EXTENDED_ICONS} — are registered on construction; add your own SVGs
- * (from a sprite, a design export, anything) with {@link register} /
- * {@link registerIcons}.
+ * IconRegistry — the name → SVG store behind `<mk-icon name="…">`. The
+ * hand-made {@link MK_DEFAULT_ICONS} are registered on construction and ship
+ * with every app. Everything else is opt-in and tree-shakeable: the
+ * Lucide-derived extended set via `provideMkExtendedIcons()` (from
+ * `@mk-kit/ui/icon/extended`), a themed subset or your own SVGs (from a
+ * sprite, a design export, anything) via `provideMkIcons()`, or at runtime
+ * with {@link register} / {@link registerIcons} / {@link load}.
  *
  * SVG markup is trusted verbatim (bypassed through `DomSanitizer`), so only
  * register icons from sources you control — never user input.
@@ -49,35 +62,72 @@ declare class MkIcon {
  * const reg = inject(MkIconRegistry);
  * reg.register('logo', '<svg viewBox="0 0 24 24">…</svg>');
  * reg.registerIcons({ save: '<svg…>', share: '<svg…>' });
+ * reg.load(() => import('@mk-kit/ui/icon/extended').then((m) => m.MK_EXTENDED_ICONS_FILES));
  * ```
  */
 declare class MkIconRegistry {
     private readonly sanitizer;
+    private readonly pendingTasks;
     private readonly icons;
     private readonly aliases;
+    private readonly version;
+    private readonly loads;
+    private readonly warned;
+    /**
+     * Bumps on every registration. `<mk-icon>` reads it, so an icon that
+     * arrives late (a lazy {@link load}, a runtime {@link register}) renders in
+     * place without any re-binding.
+     */
+    readonly changes: Signal<number>;
+    /** Whether a lazy {@link load} is still in flight. */
+    readonly pending: Signal<boolean>;
     constructor();
     /** Register (or overwrite) a single named icon from raw SVG markup. */
     register(name: string, svg: string): this;
-    /** Register many icons at once from a `{ name: svg }` map. */
-    registerIcons(icons: Readonly<Record<string, string>>): this;
+    /**
+     * Register many icons at once from a `{ name: svg }` map — a whole set, a
+     * themed subset (`MK_EXTENDED_ICONS_FILES`) or a hand-picked few. Later
+     * registrations overwrite earlier ones on a shared name.
+     */
+    registerIcons(icons: MkIconMap): this;
     /**
      * Register alternative names that resolve to existing icons — e.g. map
      * Material Symbols ligature names onto the built-in set
      * (`{ delete: 'trash', expand_more: 'chevron-down' }`). A real icon
-     * registered under an alias name always wins over the alias.
+     * registered under an alias name always wins over the alias; an alias
+     * whose target is not registered resolves to nothing (and, in dev mode,
+     * warns once naming the missing target).
      */
     registerAliases(aliases: Readonly<Record<string, string>>): this;
+    /**
+     * Load an icon map asynchronously and register it once it arrives. Icons
+     * already on screen fill in when the map lands (see {@link changes}); the
+     * missing-icon warning stays quiet while a load is pending. Server-side
+     * rendering waits for it (Angular's `PendingTasks`), so the HTML ships with
+     * the icons in place.
+     *
+     * ```ts
+     * registry.load(() => import('@mk-kit/ui/icon/extended').then((m) => m.MK_EXTENDED_ICONS));
+     * ```
+     */
+    load(loader: MkIconLoader): Promise<void>;
     /** Sanitized SVG for a name (aliases resolved), or `null` when unknown. */
     get(name: string): SafeHtml | null;
     /** Whether an icon with this name (or alias) is registered. */
     has(name: string): boolean;
     /** All registered icon names (useful for a picker / catalogue). */
     names(): string[];
+    /**
+     * Dev-mode only: warn once per unknown name with a hint about the opt-in
+     * extended set. Silent in production builds and while a {@link load} is
+     * pending (the name may be on its way). Called by `<mk-icon>`.
+     */
+    warnMissing(name: string): void;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkIconRegistry, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MkIconRegistry>;
 }
 
-/** Name → SVG markup map of the default icons. */
+/** Name → SVG markup map of the default icons (registered by {@link MkIconRegistry} on construction). */
 declare const MK_DEFAULT_ICONS: Readonly<Record<string, string>>;
 
 /**
@@ -87,9 +137,13 @@ declare const MK_DEFAULT_ICONS: Readonly<Record<string, string>>;
  * glyph once {@link provideMkMaterialIcons} is installed.
  *
  * Several Material names intentionally collapse onto one mk glyph (all the
- * calendar variants → `calendar`, the delete variants → `trash`, …). Names
- * not listed here have no sensible built-in equivalent — register your own
- * SVG under the Material name via `MkIconRegistry.register`.
+ * calendar variants → `calendar`, the delete variants → `trash`, …). Every
+ * target is a default icon, so the aliases work without the opt-in extended
+ * set. Names not listed here have no sensible built-in equivalent — register
+ * your own SVG under the Material name via `MkIconRegistry.register`, or
+ * alias it onto an extended glyph with `registerAliases` once
+ * `provideMkExtendedIcons()` is installed (an alias whose target is missing
+ * renders nothing and warns once in dev mode).
  */
 declare const MK_MATERIAL_ICON_ALIASES: Readonly<Record<string, string>>;
 /**
@@ -106,7 +160,36 @@ declare const MK_MATERIAL_ICON_ALIASES: Readonly<Record<string, string>>;
  */
 declare function provideMkMaterialIcons(): EnvironmentProviders;
 
-/** Name → SVG markup map of the Lucide-derived icons registered by default. */
-declare const MK_EXTENDED_ICONS: Readonly<Record<string, string>>;
+/**
+ * Registers extra icons at bootstrap — a themed subset of the extended set,
+ * a hand-picked few, your own SVGs, or a lazily loaded map. Call it as many
+ * times as you like; each call adds to the {@link MkIconRegistry}. The
+ * hand-made defaults are always there; this is for everything else.
+ *
+ * ```ts
+ * import { provideMkIcons } from '@mk-kit/ui/icon';
+ * import { MK_EXTENDED_ICONS_FILES, MK_EXTENDED_ICONS_DATA } from '@mk-kit/ui/icon/extended';
+ *
+ * bootstrapApplication(App, {
+ *   providers: [
+ *     // themed subsets — only these glyphs end up in the bundle
+ *     provideMkIcons(MK_EXTENDED_ICONS_FILES),
+ *     provideMkIcons(MK_EXTENDED_ICONS_DATA),
+ *     // your own
+ *     provideMkIcons({ logo: '<svg viewBox="0 0 24 24">…</svg>' }),
+ *     // or the whole extended set in its own lazy chunk, off the critical path
+ *     provideMkIcons(() => import('@mk-kit/ui/icon/extended').then((m) => m.MK_EXTENDED_ICONS)),
+ *   ],
+ * });
+ * ```
+ *
+ * A loader runs once at bootstrap without blocking it: icons already on
+ * screen fill in when the chunk lands, and server-side rendering waits for
+ * it. Picking single names out of the full map
+ * (`{ receipt: MK_EXTENDED_ICONS['receipt'] }`) works but still bundles the
+ * whole map — use a subset or copy the SVG when size matters.
+ */
+declare function provideMkIcons(icons: MkIconMap | MkIconLoader): EnvironmentProviders;
 
-export { MK_DEFAULT_ICONS, MK_EXTENDED_ICONS, MK_MATERIAL_ICON_ALIASES, MkIcon, MkIconRegistry, provideMkMaterialIcons };
+export { MK_DEFAULT_ICONS, MK_MATERIAL_ICON_ALIASES, MkIcon, MkIconRegistry, provideMkIcons, provideMkMaterialIcons };
+export type { MkIconLoader, MkIconMap };

package/types/mk-kit-ui-rich-text.d.ts

@@ -23,6 +23,8 @@ import * as _mk_kit_ui_core from '@mk-kit/ui/core';
  */
 declare class MkRichText implements ControlValueAccessor {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     private readonly i18n;
     /** Two-way HTML string value (sanitised; `''` when visually empty). */
     readonly value: _angular_core.ModelSignal<string>;

package/types/mk-kit-ui-table.d.ts

@@ -178,12 +178,29 @@ interface MkGroupToggle {
     /** Whether the group is now collapsed. */
     collapsed: boolean;
 }
-/** Options for {@link MkTable.exportCsv}. */
-interface MkTableExportOptions extends MkCsvExportOptions {
+/** Options for {@link MkTable.getExportRows} — which rows and columns to export. */
+interface MkTableExportRowsOptions {
     /** Export only the selected rows (default: every row). */
     selectedOnly?: boolean;
     /** Restrict to these column keys, in table order (default: every column). */
     columns?: readonly string[];
+}
+/** What {@link MkTable.getExportRows} returns: the rows and the columns to write them with. */
+interface MkTableExportRows<T> {
+    /**
+     * The rows in display order — sorted the way they are shown, tree children
+     * flattened under their parent (expanded or not), selection applied when
+     * `selectedOnly` was set.
+     */
+    rows: T[];
+    /**
+     * The columns in the table's current (user-reordered) order, restricted to
+     * the requested keys, each with its header and formatter.
+     */
+    columns: MkCsvColumn<T>[];
+}
+/** Options for {@link MkTable.exportCsv}. */
+interface MkTableExportOptions extends MkCsvExportOptions, MkTableExportRowsOptions {
     /** Start the browser download (default `true`); `false` just returns the text. */
     download?: boolean;
 }
@@ -201,22 +218,6 @@ type MkTableItem<T> = {
     /** Whether its children are currently shown (tree mode). */
     expanded: boolean;
 };
-/**
- * Table — a themed data table built on a native `<table>` for accessibility.
- * Supply `columns` and `data`; opt into sortable columns, sticky header,
- * zebra striping, hover and density. Sorting is fully keyboard operable
- * (Enter/Space on a header) and announces changes via {@link MkLiveAnnouncer}.
- *
- * ```html
- * <mk-table
- *   [columns]="columns"
- *   [data]="rows()"
- *   stickyHeader
- *   zebra
- *   (sortChange)="onSort($event)"
- *   (rowClick)="open($event)" />
- * ```
- */
 declare class MkTable<T = Record<string, unknown>> {
     private readonly announcer;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
@@ -431,7 +432,6 @@ declare class MkTable<T = Record<string, unknown>> {
      * re-resolves locale data on every call; one cached `Intl.Collator` makes
      * large-table sorts several-fold faster with the same default-locale order.
      */
-    private static readonly sortCollator;
     /** Data sorted by the active column, or the input order when unsorted. */
     protected readonly sortedData: _angular_core.Signal<T[]>;
     /** Sort one sibling group by the active column (input order when unsorted). */
@@ -498,11 +498,28 @@ declare class MkTable<T = Record<string, unknown>> {
     expandAllRows(): void;
     /** Collapse every parent row (tree mode). */
     collapseAllRows(): void;
+    /**
+     * The rows and columns an export writes — exactly what {@link exportCsv}
+     * serialises, for other formats (XLSX, PDF, the clipboard, …): rows in
+     * display order with the current sort applied and tree children
+     * (`childrenKey`) flattened under their parent whether or not they are
+     * expanded, optionally only the selected ones; columns in the table's
+     * current order, restricted to `options.columns` when given, each carrying
+     * its header and `format` so what the user saw is what gets written.
+     *
+     * ```ts
+     * const { rows, columns } = table.getExportRows({ selectedOnly: true });
+     * const sheet = rows.map((row) =>
+     *   Object.fromEntries(columns.map((c) => [c.header ?? c.key, c.format ? c.format(row[c.key], row) : row[c.key]])),
+     * );
+     * ```
+     */
+    getExportRows(options?: MkTableExportRowsOptions): MkTableExportRows<T>;
     /**
      * The table's rows as CSV: current column order, column formatters applied,
      * sorted the way they are shown, tree children flattened under their parent
      * whether or not they are expanded. Downloads the file (default name
-     * `table.csv`) and returns the text.
+     * `table.csv`) and returns the text. Built on {@link getExportRows}.
      */
     exportCsv(options?: MkTableExportOptions): string;
     private setTreeExpanded;
@@ -876,4 +893,4 @@ declare class MkTableDataSource<T> {
 }
 
 export { MkSort, MkSortHeader, MkTable, MkTableCell, MkTableDataSource, MkTableRowDetail, mkDownloadText, mkExportCsv, mkToCsv };
-export type { MkCellEdit, MkColumnResize, MkCsvColumn, MkCsvExportOptions, MkCsvOptions, MkDataFetcher, MkDataPage, MkDataRequest, MkGroupToggle, MkSortChange, MkSortDirection, MkSortState, MkSortable, MkTableAlign, MkTableCellContext, MkTableColumn, MkTableDataSourceOptions, MkTableDensity, MkTableExportOptions, MkTableGroup, MkTreeToggle };
+export type { MkCellEdit, MkColumnResize, MkCsvColumn, MkCsvExportOptions, MkCsvOptions, MkDataFetcher, MkDataPage, MkDataRequest, MkGroupToggle, MkSortChange, MkSortDirection, MkSortState, MkSortable, MkTableAlign, MkTableCellContext, MkTableColumn, MkTableDataSourceOptions, MkTableDensity, MkTableExportOptions, MkTableExportRows, MkTableExportRowsOptions, MkTableGroup, MkTreeToggle };

package/types/mk-kit-ui.d.ts

@@ -1,5 +1,6 @@
 export * from '@mk-kit/ui/core';
 export * from '@mk-kit/ui/icon';
+export * from '@mk-kit/ui/icon/extended';
 export * from '@mk-kit/ui/chip';
 export * from '@mk-kit/ui/checkbox';
 export * from '@mk-kit/ui/button';