@mk-kit/ui 0.42.0 → 0.43.0

package/fesm2022/mk-kit-ui.mjs

@@ -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';

package/fesm2022/mk-kit-ui.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"mk-kit-ui.mjs","sources":["../../../projects/mk-kit/src/public-api.ts","../../../projects/mk-kit/src/mk-kit-ui.ts"],"sourcesContent":["/*\n * Public API Surface of @mk-kit/ui.\n *\n * The library ships Material-style secondary entry points — import from the\n * group entries (`@mk-kit/ui/forms`, `@mk-kit/ui/table`, …) so a code-split\n * app only carries the groups each chunk uses. This root entry re-exports\n * everything for convenience; importing it eagerly pulls all groups into the\n * importing chunk.\n */\nexport * from '@mk-kit/ui/core';\nexport * from '@mk-kit/ui/icon';\nexport * from '@mk-kit/ui/chip';\nexport * from '@mk-kit/ui/checkbox';\nexport * from '@mk-kit/ui/button';\nexport * from '@mk-kit/ui/directives';\nexport * from '@mk-kit/ui/dnd';\nexport * from '@mk-kit/ui/navigation';\nexport * from '@mk-kit/ui/forms';\nexport * from '@mk-kit/ui/datetime';\nexport * from '@mk-kit/ui/table';\nexport * from '@mk-kit/ui/data';\nexport * from '@mk-kit/ui/feedback';\nexport * from '@mk-kit/ui/rich-text';\nexport * from '@mk-kit/ui/block-editor';\nexport * from '@mk-kit/ui/context-menu';\nexport * from '@mk-kit/ui/layout';\nexport * from '@mk-kit/ui/chat';\nexport * from '@mk-kit/ui/query-builder';\nexport * from '@mk-kit/ui/dynamic-form';\nexport * from '@mk-kit/ui/media';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;AAQG;;ACRH;;AAEG"}
+{"version":3,"file":"mk-kit-ui.mjs","sources":["../../../projects/mk-kit/src/public-api.ts","../../../projects/mk-kit/src/mk-kit-ui.ts"],"sourcesContent":["/*\n * Public API Surface of @mk-kit/ui.\n *\n * The library ships Material-style secondary entry points — import from the\n * group entries (`@mk-kit/ui/forms`, `@mk-kit/ui/table`, …) so a code-split\n * app only carries the groups each chunk uses. This root entry re-exports\n * everything for convenience; importing it eagerly pulls all groups into the\n * importing chunk.\n */\nexport * from '@mk-kit/ui/core';\nexport * from '@mk-kit/ui/icon';\nexport * from '@mk-kit/ui/icon/extended';\nexport * from '@mk-kit/ui/chip';\nexport * from '@mk-kit/ui/checkbox';\nexport * from '@mk-kit/ui/button';\nexport * from '@mk-kit/ui/directives';\nexport * from '@mk-kit/ui/dnd';\nexport * from '@mk-kit/ui/navigation';\nexport * from '@mk-kit/ui/forms';\nexport * from '@mk-kit/ui/datetime';\nexport * from '@mk-kit/ui/table';\nexport * from '@mk-kit/ui/data';\nexport * from '@mk-kit/ui/feedback';\nexport * from '@mk-kit/ui/rich-text';\nexport * from '@mk-kit/ui/block-editor';\nexport * from '@mk-kit/ui/context-menu';\nexport * from '@mk-kit/ui/layout';\nexport * from '@mk-kit/ui/chat';\nexport * from '@mk-kit/ui/query-builder';\nexport * from '@mk-kit/ui/dynamic-form';\nexport * from '@mk-kit/ui/media';\n","/**\n * Generated bundle index. Do not edit.\n */\n\nexport * from './public-api';\n"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;;;;AAQG;;ACRH;;AAEG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mk-kit/ui",
-  "version": "0.42.0",
+  "version": "0.43.0",
   "publishConfig": {
     "access": "public"
   },
@@ -115,6 +115,10 @@
       "types": "./types/mk-kit-ui-icon.d.ts",
       "default": "./fesm2022/mk-kit-ui-icon.mjs"
     },
+    "./icon/extended": {
+      "types": "./types/mk-kit-ui-icon-extended.d.ts",
+      "default": "./fesm2022/mk-kit-ui-icon-extended.mjs"
+    },
     "./layout": {
       "types": "./types/mk-kit-ui-layout.d.ts",
       "default": "./fesm2022/mk-kit-ui-layout.mjs"

package/schematics/migrate-primeng/transform.js

@@ -310,7 +310,10 @@ function renderReport(files, options) {
     lines.push('## Files', '');
     lines.push(...(changed.length ? changed.map((f) => `- \`${f.path}\` — ${f.findings.map((x) => `${x.rule}×${x.count}`).join(', ')}`) : ['- (none)']), '');
     lines.push('## Next', '');
-    lines.push('1. Run `ng build` and fix the remaining template errors — most are the `<!-- mk-kit -->` notes above.', '2. Replace `MessageService.add(...)` calls with `MkToastService` and `ConfirmationService.confirm(...)` with `await MkDialogService.confirm(...)`.', '3. Icons: `pi pi-*` classes → `<mk-icon name="…" />` (see https://mk-kit.dev/components/icon).', `4. Theme: \`--mk-*\` tokens replace the PrimeNG preset — https://mk-kit.dev/theming.`, '');
+    lines.push('1. Run `ng build` and fix the remaining template errors — most are the `<!-- mk-kit -->` notes above.', '2. Replace `MessageService.add(...)` calls with `MkToastService` and `ConfirmationService.confirm(...)` with `await MkDialogService.confirm(...)`.', '3. Icons: `pi pi-*` classes → `<mk-icon name="…" />` (see https://mk-kit.dev/components/icon). ' +
+        'Most PrimeIcons names live in the opt-in extended set — add `provideMkExtendedIcons()` ' +
+        "(from '@mk-kit/ui/icon/extended', ≈13 KiB) or a themed subset via `provideMkIcons()` to your providers; " +
+        'only the default set ships otherwise.', `4. Theme: \`--mk-*\` tokens replace the PrimeNG preset — https://mk-kit.dev/theming.`, '');
     return lines.join('\n');
 }
 function group(list, withDocs = false) {

package/schematics/ng-add/index.js

@@ -8,6 +8,9 @@ exports.ngAdd = ngAdd;
  *   in angular.json (physical path — exports maps don't apply there).
  * - Optionally (`--i18n`) inserts a `provideMkI18n({})` override block into
  *   the application config via the CLI's standalone-app AST helpers.
+ * - Optionally (`--extended-icons`) inserts `provideMkExtendedIcons()` so the
+ *   Lucide-derived icon set (≈13 KiB brotli, opt-in) is available to
+ *   `<mk-icon name="…">`.
  * - Prints a short getting-started note.
  */
 const schematics_1 = require("@angular-devkit/schematics");
@@ -28,7 +31,8 @@ function ngAdd(options) {
         return (0, schematics_1.chain)([
             addThemeStyles(projectName),
             options.i18n ? addI18nProvider(projectName) : (0, schematics_1.noop)(),
-            logGettingStarted(),
+            options.extendedIcons ? addExtendedIconsProvider(projectName) : (0, schematics_1.noop)(),
+            logGettingStarted(options),
         ]);
     };
 }
@@ -101,12 +105,36 @@ function addI18nProvider(projectName) {
         }
     };
 }
+/**
+ * Inserts `provideMkExtendedIcons()` into the application config so the
+ * opt-in Lucide-derived icon set resolves. Same graceful fallback as the i18n
+ * rule when the app is not a standard standalone app.
+ */
+function addExtendedIconsProvider(projectName) {
+    return async (tree, context) => {
+        const rule = (0, utility_1.addRootProvider)(projectName, ({ code, external }) => code `${external('provideMkExtendedIcons', '@mk-kit/ui/icon/extended')}()`);
+        try {
+            return await (0, rxjs_1.lastValueFrom)((0, schematics_1.callRule)(rule, tree, context));
+        }
+        catch {
+            context.logger.warn('Could not set up provideMkExtendedIcons automatically (the application config does not ' +
+                'match the standard standalone shape). To use the extended icon set, add it manually:');
+            context.logger.warn(`  import { provideMkExtendedIcons } from '@mk-kit/ui/icon/extended';`);
+            context.logger.warn('  providers: [provideMkExtendedIcons()]');
+            return tree;
+        }
+    };
+}
 /** Prints a short getting-started message at the end of a successful run. */
-function logGettingStarted() {
+function logGettingStarted(options) {
     return (_tree, context) => {
         context.logger.info('');
         context.logger.info('@mk-kit/ui has been set up.');
         context.logger.info(`  - Theme stylesheet wired into angular.json (${THEME_STYLE_PATH}).`);
+        context.logger.info(options.extendedIcons
+            ? '  - Extended icon set registered (provideMkExtendedIcons()).'
+            : '  - Only the default icon set is registered; for the 300+ extended (Lucide) names re-run with ' +
+                "--extended-icons or add provideMkExtendedIcons() from '@mk-kit/ui/icon/extended'.");
         context.logger.info("  - Scaffold a dashboard layout with MkAppShell: import { MkAppShell } from '@mk-kit/ui/navigation';");
         context.logger.info(`  - Docs and examples: ${DOCS_URL}`);
     };

package/schematics/ng-add/schema.json

@@ -16,6 +16,12 @@
       "default": false,
       "description": "Insert a provideMkI18n({}) override block into the application config so built-in strings can be localised.",
       "x-prompt": "Set up a provideMkI18n override block?"
+    },
+    "extendedIcons": {
+      "type": "boolean",
+      "default": false,
+      "description": "Insert provideMkExtendedIcons() into the application config so the 300+ Lucide-derived icon names resolve (about 13 KiB brotli; only the default set ships otherwise).",
+      "x-prompt": "Register the extended (Lucide-derived) icon set? Adds provideMkExtendedIcons(), about 13 KiB."
     }
   },
   "required": []

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

@@ -192,6 +192,8 @@ declare class MkBlockEditor implements ControlValueAccessor {
     readonly htmlChange: _angular_core.OutputEmitterRef<string>;
     protected readonly cvaDisabled: _angular_core.WritableSignal<boolean>;
     /** Invalid visual, forced by the `invalid` input. */
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly isInvalid: _angular_core.Signal<boolean>;
     private onChange;
     private onTouched;

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

@@ -19,6 +19,8 @@ import { MkSize, MkTone } from '@mk-kit/ui/core';
  */
 declare class MkCheckbox implements ControlValueAccessor, Validator {
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     /** Two-way checked state. */
     readonly checked: _angular_core.ModelSignal<boolean>;
     /** Two-way indeterminate ("mixed") state; cleared when the user toggles. */

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

@@ -980,6 +980,12 @@ interface MkI18nStrings {
     logCopyAll: string;
     /** Log viewer: soft-wrap toolbar toggle. */
     logWrapLines: string;
+    /** Org chart: default accessible label of the tree. */
+    orgChartLabel: string;
+    /** Org chart: aria-label of a collapsed node's toggle (`{label}` = node label). */
+    orgChartExpand: string;
+    /** Org chart: aria-label of an expanded node's toggle (`{label}` = node label). */
+    orgChartCollapse: string;
     /** Chat: accessible name of the message log. */
     chatLabel: string;
     /** Chat: accessible name of the composer textarea. */
@@ -1315,6 +1321,70 @@ type MkErrorMessages = Readonly<Record<string, string | ((err: any) => string)>>
  */
 declare function mkFirstErrorMessage(errors: ValidationErrors | null | undefined, strings: MkValidationStrings, overrides?: MkErrorMessages): string | null;
 
+/**
+ * The shape of a Signal Forms validation error as `mk-kit` reads it — the
+ * `{ kind, message? }` contract of `ValidationError` from
+ * `@angular/forms/signals`, plus whatever payload the error class carries
+ * (`min`, `maxLength`, `pattern`, …). Declared structurally so `@mk-kit/ui/core`
+ * stays free of a runtime dependency on the signals entry point.
+ */
+interface MkSignalValidationError {
+    /** Identifies the kind of error (`'required'`, `'minLength'`, …). */
+    readonly kind: string;
+    /** Human-readable message, when the schema supplied one. */
+    readonly message?: string;
+}
+/**
+ * Converts Signal Forms errors to the reactive-forms `ValidationErrors` shape
+ * the `validation` i18n table is keyed by, so both form systems render the
+ * same messages. The built-in kinds map to Angular's classic keys and payloads
+ * (`minLength` → `minlength: { requiredLength }`, `minDate` → `mkMinDate`,
+ * …); any other kind is kept as-is with its payload spread into the value.
+ *
+ * @returns The error map in the order the errors were reported, or `null`
+ *   when the list is empty.
+ */
+declare function mkSignalErrorsToValidationErrors(errors: readonly MkSignalValidationError[] | null | undefined): ValidationErrors | null;
+/**
+ * Resolves the message for the first Signal Forms error on a field, the way
+ * `mkFirstErrorMessage` does for reactive forms.
+ *
+ * Lookup order: the field's `overrides` for that kind, then the `message` the
+ * schema attached to the error (`required(p.email, { message: '…' })`), then
+ * the i18n `validation` table, then the generic fallback.
+ *
+ * @returns The message, or `null` when there are no errors.
+ */
+declare function mkSignalErrorMessage(errors: readonly MkSignalValidationError[] | null | undefined, strings: MkValidationStrings, overrides?: MkErrorMessages): string | null;
+
+/**
+ * Touched-gate for a control's `invalid` input under Signal Forms.
+ *
+ * When a control is bound with the `[formField]` directive, Angular writes the
+ * field's `invalid()` state straight into the control's `invalid` input — from
+ * the first render, before the user has reached the field. mk-kit controls
+ * pass that input through this gate so the invalid visual (and `aria-invalid`)
+ * only shows once the field is touched or dirty, matching how `mk-form-field`
+ * reveals its message and how `submit()` (which marks every field touched)
+ * surfaces the remaining problems.
+ *
+ * Returns a signal that is always `true` for a control that is not bound with
+ * `[formField]`, so a standalone `[invalid]="true"` keeps working as before.
+ * Call it in a field initializer (an injection context):
+ *
+ * ```ts
+ * private readonly fieldTouched = mkInjectFieldTouched();
+ * protected readonly isInvalid = computed(
+ *   () => (this.invalid() && this.fieldTouched()) || (this.field?.hasError() ?? false),
+ * );
+ * ```
+ *
+ * The binding is looked up lazily, on first read: the `FormField` directive
+ * itself injects the element's `NG_VALUE_ACCESSOR` (the control) while it is
+ * created, so resolving it from the control's constructor would be circular.
+ */
+declare function mkInjectFieldTouched(): Signal<boolean>;
+
 /** Value kind of a filterable field; decides the editor and the operators offered. */
 type MkQueryValueType = 'string' | 'number' | 'boolean' | 'date' | 'select';
 /** A choice for `select` fields. */
@@ -1393,5 +1463,5 @@ declare function mkQueryOperatorLabel(op: MkQueryOperator, i18n?: MkI18nStrings)
  */
 declare function mkQueryToText(group: MkQueryGroup, fields?: readonly MkQueryField[], i18n?: MkI18nStrings): string;
 
-export { MK_BREAKPOINTS, MK_DEFAULT_BREAKPOINTS, MK_DEFAULT_DATE_NAMES, MK_DEFAULT_I18N, MK_DEFAULT_VALIDATION, MK_I18N, MK_OVERLAY_DATA, MK_QUERY_OPERATORS, MK_QUERY_UNARY, MkAnchoredPanel, MkBreakpointService, MkFieldContext, MkFocusTrap, MkLiveAnnouncer, MkOverlayRef, MkOverlayService, MkThemeService, mkComputeAnchoredPosition, mkCreateQueryGroup, mkCreateQueryRule, mkFirstErrorMessage, mkGetFocusable, mkHighlight, mkHighlightJson, mkIsQueryGroup, mkIsResponsive, mkQueryCompact, mkQueryIsEmpty, mkQueryOperatorLabel, mkQueryOperatorsFor, mkQueryRuleCount, mkQueryRuleIsComplete, mkQueryRuleMatches, mkQueryToPredicate, mkQueryToText, mkUniqueId, mkValidatorChange, provideMkI18n };
-export type { MkAnchoredPosition, MkAnchoredPositionOptions, MkAriaLivePoliteness, MkBlockEditorStrings, MkBreakpoint, MkBreakpoints, MkCodeLanguage, MkContrastPreference, MkDateNames, MkDensity, MkErrorMessages, MkI18nStrings, MkOverlayConfig, MkPlacement, MkQueryCombinator, MkQueryField, MkQueryFieldOption, MkQueryGroup, MkQueryNode, MkQueryOperator, MkQueryRule, MkQueryValueType, MkResolvedContrast, MkResolvedTheme, MkResponsive, MkSize$1 as MkSize, MkSortAnnounceDirection, MkThemePreference, MkTone, MkValidationStrings, MkValidatorChangeRef, MkVariant };
+export { MK_BREAKPOINTS, MK_DEFAULT_BREAKPOINTS, MK_DEFAULT_DATE_NAMES, MK_DEFAULT_I18N, MK_DEFAULT_VALIDATION, MK_I18N, MK_OVERLAY_DATA, MK_QUERY_OPERATORS, MK_QUERY_UNARY, MkAnchoredPanel, MkBreakpointService, MkFieldContext, MkFocusTrap, MkLiveAnnouncer, MkOverlayRef, MkOverlayService, MkThemeService, mkComputeAnchoredPosition, mkCreateQueryGroup, mkCreateQueryRule, mkFirstErrorMessage, mkGetFocusable, mkHighlight, mkHighlightJson, mkInjectFieldTouched, mkIsQueryGroup, mkIsResponsive, mkQueryCompact, mkQueryIsEmpty, mkQueryOperatorLabel, mkQueryOperatorsFor, mkQueryRuleCount, mkQueryRuleIsComplete, mkQueryRuleMatches, mkQueryToPredicate, mkQueryToText, mkSignalErrorMessage, mkSignalErrorsToValidationErrors, mkUniqueId, mkValidatorChange, provideMkI18n };
+export type { MkAnchoredPosition, MkAnchoredPositionOptions, MkAriaLivePoliteness, MkBlockEditorStrings, MkBreakpoint, MkBreakpoints, MkCodeLanguage, MkContrastPreference, MkDateNames, MkDensity, MkErrorMessages, MkI18nStrings, MkOverlayConfig, MkPlacement, MkQueryCombinator, MkQueryField, MkQueryFieldOption, MkQueryGroup, MkQueryNode, MkQueryOperator, MkQueryRule, MkQueryValueType, MkResolvedContrast, MkResolvedTheme, MkResponsive, MkSignalValidationError, MkSize$1 as MkSize, MkSortAnnounceDirection, MkThemePreference, MkTone, MkValidationStrings, MkValidatorChangeRef, MkVariant };

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

@@ -385,6 +385,205 @@ declare class MkTimelineItem {
     static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkTimelineItem, "mk-timeline-item", never, { "tone": { "alias": "tone"; "required": false; "isSignal": true; }; "icon": { "alias": "icon"; "required": false; "isSignal": true; }; "time": { "alias": "time"; "required": false; "isSignal": true; }; "heading": { "alias": "heading"; "required": false; "isSignal": true; }; }, {}, never, ["*"], true, never>;
 }
 
+/** A node in an {@link MkOrgChart} tree. `children` makes it a parent. */
+interface MkOrgChartNode<T = unknown> {
+    /** Unique id — drives selection (`[(selected)]`) and expansion (`[(expanded)]`). */
+    id: string;
+    /** Primary text of the default card (and the initials fallback). */
+    label?: string;
+    /**
+     * Arbitrary payload handed to the node template. The default card reads
+     * `data.title` (sub-label) and `data.avatar` (image URL) when present.
+     */
+    data?: T;
+    /** Direct reports; a non-empty array makes the node collapsible. */
+    children?: MkOrgChartNode<T>[];
+    /** Initial expansion (default `true`). Only consulted when `[(expanded)]` is not bound. */
+    expanded?: boolean;
+}
+/** One row of a flat list accepted by {@link mkOrgChartFromFlat}. */
+interface MkOrgChartFlatNode<T = unknown> {
+    id: string;
+    label?: string;
+    data?: T;
+    /** Id of the parent row; `null` / `undefined` / unknown id = root. */
+    parentId?: string | null;
+    expanded?: boolean;
+}
+/**
+ * Build the nested `nodes` input from a flat `parentId` list (the shape most
+ * HR / directory APIs return). Row order is preserved among siblings; rows
+ * whose `parentId` does not match any row become roots.
+ *
+ * ```ts
+ * const nodes = mkOrgChartFromFlat([
+ *   { id: 'ceo', label: 'Ada' },
+ *   { id: 'cto', label: 'Grace', parentId: 'ceo' },
+ * ]);
+ * ```
+ */
+declare function mkOrgChartFromFlat<T = unknown>(list: readonly MkOrgChartFlatNode<T>[]): MkOrgChartNode<T>[];
+/**
+ * `data` type seen by a node template: `T` when it could be inferred (the
+ * template binds `[mkOrgChartNodeDef]="nodes"`), otherwise `any` so an
+ * untyped `<ng-template mkOrgChartNodeDef>` can still read `node.data?.title`.
+ */
+type MkOrgChartTemplateData<T> = keyof T extends never ? any : T;
+/** Template context of `ng-template[mkOrgChartNodeDef]`. */
+interface MkOrgChartNodeContext<T = unknown> {
+    /** The node (also available as `let-node`). */
+    $implicit: MkOrgChartNode<MkOrgChartTemplateData<T>>;
+    node: MkOrgChartNode<MkOrgChartTemplateData<T>>;
+    /** 1-based depth (roots are 1). */
+    depth: number;
+    /** Whether the node's children are currently shown. */
+    expanded: boolean;
+    /** Whether the node is the selected one. */
+    selected: boolean;
+}
+/**
+ * Custom node card for `mk-org-chart`:
+ *
+ * ```html
+ * <mk-org-chart [nodes]="nodes">
+ *   <ng-template mkOrgChartNodeDef let-node let-selected="selected">
+ *     <strong>{{ node.label }}</strong> — {{ node.data?.title }}
+ *   </ng-template>
+ * </mk-org-chart>
+ * ```
+ *
+ * Bind the same array you pass to `nodes` to get a typed `node.data` in the
+ * template: `<ng-template [mkOrgChartNodeDef]="nodes" let-node>`.
+ */
+declare class MkOrgChartNodeDef<T = unknown> {
+    /**
+     * Type-inference hook only (the value is not used at runtime): bind the
+     * `nodes` array so `let-node` is typed as `MkOrgChartNode<T>`.
+     */
+    readonly mkOrgChartNodeDef: _angular_core.InputSignal<"" | readonly MkOrgChartNode<T>[] | undefined>;
+    readonly template: TemplateRef<any>;
+    static ngTemplateContextGuard<T>(_dir: MkOrgChartNodeDef<T>, ctx: unknown): ctx is MkOrgChartNodeContext<T>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkOrgChartNodeDef<any>, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MkOrgChartNodeDef<any>, "ng-template[mkOrgChartNodeDef]", never, { "mkOrgChartNodeDef": { "alias": "mkOrgChartNodeDef"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/** Chart direction: `top` = root at the top, `left` = root at the inline start. */
+type MkOrgChartOrientation = 'top' | 'left';
+/** Payload of `(nodeToggle)`. */
+interface MkOrgChartToggleEvent<T = unknown> {
+    node: MkOrgChartNode<T>;
+    expanded: boolean;
+}
+/** One visible node after flattening (pre-order, i.e. DOM order). */
+interface MkOrgChartRow {
+    node: MkOrgChartNode;
+    depth: number;
+    parentId: string | null;
+    /** Ids of the sibling set this row belongs to (in order). */
+    siblings: readonly string[];
+    hasChildren: boolean;
+    expanded: boolean;
+}
+/**
+ * Organisation chart — a reporting-line hierarchy drawn with plain nested
+ * lists and CSS connectors (no canvas, prints and themes like everything
+ * else). Feed it a tree (`nodes`) or convert a flat `parentId` list with
+ * {@link mkOrgChartFromFlat}. Nodes render as a default card (avatar /
+ * initials, label, `data.title`) or through an `mkOrgChartNodeDef` template.
+ *
+ * Follows the ARIA tree pattern (`role="tree"` / `treeitem` / `group`, one
+ * roving tab stop). Keyboard (top-down; the axes swap for `orientation="left"`
+ * and in RTL): Down = first child (expands a collapsed node first), Up =
+ * parent, Left/Right = previous/next sibling, Home/End = first/last visible
+ * node, Enter/Space = select (or toggle when not selectable), `*` = expand
+ * all siblings, `+`/`-` = expand/collapse.
+ *
+ * ```html
+ * <mk-org-chart
+ *   [nodes]="company"
+ *   selectable
+ *   [(selected)]="personId"
+ *   collapsible
+ *   (nodeClick)="open($event)"
+ * />
+ * ```
+ */
+declare class MkOrgChart<T = unknown> {
+    private readonly host;
+    private readonly document;
+    /** Localised strings (override globally via `provideMkI18n`). */
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    /** The hierarchy to render (roots first). */
+    readonly nodes: _angular_core.InputSignal<readonly MkOrgChartNode<T>[]>;
+    /** Root at the top (children below) or at the inline start (children to the side). */
+    readonly orientation: _angular_core.InputSignal<MkOrgChartOrientation>;
+    /** Allow choosing a node (adds selection styling + `aria-selected`). */
+    readonly selectable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Show a toggle on every parent so branches can be hidden. */
+    readonly collapsible: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Scale factor applied to the whole chart (clamped to 0.5–2). */
+    readonly zoom: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Accessible name for the tree. */
+    readonly ariaLabel: _angular_core.InputSignal<string>;
+    /** Two-way selected node id (`null` = nothing selected). */
+    readonly selected: _angular_core.ModelSignal<string | null>;
+    /**
+     * Two-way ids of the expanded parents. Leave unbound to let the chart
+     * manage expansion itself (seeded from each node's `expanded` flag).
+     */
+    readonly expanded: _angular_core.ModelSignal<readonly string[] | undefined>;
+    /** Emits the node whose card was clicked or activated with Enter/Space. */
+    readonly nodeClick: _angular_core.OutputEmitterRef<MkOrgChartNode<T>>;
+    /** Emits whenever a node is expanded or collapsed. */
+    readonly nodeToggle: _angular_core.OutputEmitterRef<MkOrgChartToggleEvent<T>>;
+    protected readonly nodeDef: _angular_core.Signal<MkOrgChartNodeDef<T> | undefined>;
+    protected readonly zoomLevel: _angular_core.Signal<number>;
+    /**
+     * Expanded parent ids. Controlled by `expanded` when bound; otherwise kept
+     * locally — a node's `expanded` flag only seeds ids not present in the
+     * previous `nodes` value, so re-emitting the array never reverts branches
+     * the user has since toggled.
+     */
+    private readonly expandedIds;
+    /** Id of the node holding the roving tab stop. */
+    private readonly activeId;
+    /** Visible nodes in DOM (pre-order) order. */
+    protected readonly rows: _angular_core.Signal<MkOrgChartRow[]>;
+    private readonly rowById;
+    /** The single id with `tabindex="0"` (falls back to the first visible node). */
+    private readonly tabStopId;
+    protected isExpanded(node: MkOrgChartNode<T>): boolean;
+    protected isSelected(node: MkOrgChartNode<T>): boolean;
+    protected tabIndexFor(node: MkOrgChartNode<T>): number;
+    protected toggleLabel(node: MkOrgChartNode<T>): string;
+    protected context(node: MkOrgChartNode<T>, depth: number): MkOrgChartNodeContext<T>;
+    /** `data.title` / `data.avatar` of the default card, read defensively. */
+    protected field(node: MkOrgChartNode<T>, key: 'title' | 'avatar'): string | undefined;
+    /** Expand or collapse a parent (no-op for leaves / non-collapsible charts). */
+    toggle(node: MkOrgChartNode<T>): void;
+    /** Expand or collapse a parent explicitly. */
+    setExpanded(node: MkOrgChartNode<T>, expanded: boolean): void;
+    /** Select a node by reference (no-op unless `selectable`). */
+    select(node: MkOrgChartNode<T>): void;
+    private activate;
+    protected onCardClick(event: Event, node: MkOrgChartNode<T>): void;
+    protected onToggleClick(event: Event, node: MkOrgChartNode<T>): void;
+    /** Keeps the roving tab stop on whichever item last received focus. */
+    protected onFocusIn(event: Event): void;
+    protected onKeydown(event: Event): void;
+    /**
+     * Map an arrow key to a tree direction. Top-down: Down = into, Up = parent,
+     * Left/Right = siblings (mirrored in RTL). Left-to-right: Right = into,
+     * Left = parent (mirrored in RTL), Up/Down = siblings.
+     */
+    private intentOf;
+    private siblingsOf;
+    private isRtl;
+    private itemIdOf;
+    private focusItem;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkOrgChart<any>, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkOrgChart<any>, "mk-org-chart", ["mkOrgChart"], { "nodes": { "alias": "nodes"; "required": false; "isSignal": true; }; "orientation": { "alias": "orientation"; "required": false; "isSignal": true; }; "selectable": { "alias": "selectable"; "required": false; "isSignal": true; }; "collapsible": { "alias": "collapsible"; "required": false; "isSignal": true; }; "zoom": { "alias": "zoom"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "aria-label"; "required": false; "isSignal": true; }; "selected": { "alias": "selected"; "required": false; "isSignal": true; }; "expanded": { "alias": "expanded"; "required": false; "isSignal": true; }; }, { "selected": "selectedChange"; "expanded": "expandedChange"; "nodeClick": "nodeClick"; "nodeToggle": "nodeToggle"; }, ["nodeDef"], never, true, never>;
+}
+
 /** Direction of a {@link MkStatCard} delta. */
 type MkStatTrend = 'up' | 'down' | 'neutral';
 /**
@@ -1819,6 +2018,8 @@ declare class MkSkeletonPreset {
 declare class MkInlineEdit implements ControlValueAccessor {
     private readonly injector;
     private readonly field;
+    /** Signal Forms: gates `invalid` until the bound field is touched or dirty. */
+    private readonly fieldTouched;
     protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
     private readonly displayRef;
     private readonly inputRef;
@@ -2777,5 +2978,5 @@ declare function mkParseMarkdown(src: string, options?: MkMarkdownParseOptions):
  */
 declare function mkRenderMarkdown(blocks: MkMarkdownBlock[], options?: MkMarkdownRenderOptions): string;
 
-export { MK_CHART_PALETTE_SIZE, MK_HEATMAP_MIN_CONTRAST, MkAvatar, MkAvatarGroup, MkBadge, MkBadgeOverlay, MkBarChart, MkCalendarHeatmap, MkCard, MkCardFooter, MkCardHeader, MkCardTitle, MkCarousel, MkCarouselSlide, MkCode, MkCountdown, MkDescItem, MkDescriptionList, MkDiff, MkDivider, MkDonutChart, MkEmptyState, MkFunnelChart, MkGauge, MkHeatmap, MkInlineEdit, MkJsonViewer, MkKanban, MkLineChart, MkList, MkListItem, MkLogViewer, MkMarkdown, MkProfileActions, MkProfileCard, MkProfileMeta, MkProgressBar, MkProgressRing, MkQrCode, MkRadarChart, MkScatterChart, MkSkeleton, MkSkeletonPreset, MkSparkline, MkSpinner, MkStatCard, MkTag, MkTimeline, MkTimelineItem, MkTreemap, MkVirtualScroll, mkArcPath, mkAreaPath, mkBuildJsonTree, mkChartColor, mkComputeDiff, mkContrastRatio, mkDiffStats, mkEncodeQr, mkFormatCompact, mkHeatmapCellColors, mkLinePath, mkLinearScale, mkMixRgb, mkNiceTicks, mkParseAnsi, mkParseMarkdown, mkParseRgb, mkRelativeLuminance, mkRenderMarkdown, mkSplitDuration, mkSquarify, mkStripAnsi };
-export type { MkAnsiSpan, MkAvatarShape, MkAvatarStatus, MkBadgeOverlayPosition, MkBadgeVariant, MkBarOrientation, MkCalendarHeatmapCell, MkCalendarHeatmapEntry, MkCardPadding, MkCardVariant, MkChartSeries, MkChartSlice, MkDescriptionLayout, MkDiffMode, MkDiffOp, MkDiffOptions, MkDiffRow, MkDiffSegment, MkDiffStats, MkDividerOrientation, MkDurationParts, MkFunnelSegment, MkHeatmapCellColors, MkHeatmapPalette, MkJsonNode, MkKanbanCard, MkKanbanCardMovedEvent, MkKanbanColumn, MkLogToken, MkMarkdownAlign, MkMarkdownBlock, MkMarkdownInline, MkMarkdownList, MkMarkdownListItem, MkMarkdownParseOptions, MkMarkdownRenderOptions, MkPoint, MkProfileCardOrientation, MkQrEcc, MkRgb, MkScatterPoint, MkScatterSeries, MkSkeletonPresetKind, MkSkeletonShape, MkSparklineType, MkStatTrend, MkTagVariant, MkTreemapItem, MkTreemapRect };
+export { MK_CHART_PALETTE_SIZE, MK_HEATMAP_MIN_CONTRAST, MkAvatar, MkAvatarGroup, MkBadge, MkBadgeOverlay, MkBarChart, MkCalendarHeatmap, MkCard, MkCardFooter, MkCardHeader, MkCardTitle, MkCarousel, MkCarouselSlide, MkCode, MkCountdown, MkDescItem, MkDescriptionList, MkDiff, MkDivider, MkDonutChart, MkEmptyState, MkFunnelChart, MkGauge, MkHeatmap, MkInlineEdit, MkJsonViewer, MkKanban, MkLineChart, MkList, MkListItem, MkLogViewer, MkMarkdown, MkOrgChart, MkOrgChartNodeDef, MkProfileActions, MkProfileCard, MkProfileMeta, MkProgressBar, MkProgressRing, MkQrCode, MkRadarChart, MkScatterChart, MkSkeleton, MkSkeletonPreset, MkSparkline, MkSpinner, MkStatCard, MkTag, MkTimeline, MkTimelineItem, MkTreemap, MkVirtualScroll, mkArcPath, mkAreaPath, mkBuildJsonTree, mkChartColor, mkComputeDiff, mkContrastRatio, mkDiffStats, mkEncodeQr, mkFormatCompact, mkHeatmapCellColors, mkLinePath, mkLinearScale, mkMixRgb, mkNiceTicks, mkOrgChartFromFlat, mkParseAnsi, mkParseMarkdown, mkParseRgb, mkRelativeLuminance, mkRenderMarkdown, mkSplitDuration, mkSquarify, mkStripAnsi };
+export type { MkAnsiSpan, MkAvatarShape, MkAvatarStatus, MkBadgeOverlayPosition, MkBadgeVariant, MkBarOrientation, MkCalendarHeatmapCell, MkCalendarHeatmapEntry, MkCardPadding, MkCardVariant, MkChartSeries, MkChartSlice, MkDescriptionLayout, MkDiffMode, MkDiffOp, MkDiffOptions, MkDiffRow, MkDiffSegment, MkDiffStats, MkDividerOrientation, MkDurationParts, MkFunnelSegment, MkHeatmapCellColors, MkHeatmapPalette, MkJsonNode, MkKanbanCard, MkKanbanCardMovedEvent, MkKanbanColumn, MkLogToken, MkMarkdownAlign, MkMarkdownBlock, MkMarkdownInline, MkMarkdownList, MkMarkdownListItem, MkMarkdownParseOptions, MkMarkdownRenderOptions, MkOrgChartFlatNode, MkOrgChartNode, MkOrgChartNodeContext, MkOrgChartOrientation, MkOrgChartTemplateData, MkOrgChartToggleEvent, MkPoint, MkProfileCardOrientation, MkQrEcc, MkRgb, MkScatterPoint, MkScatterSeries, MkSkeletonPresetKind, MkSkeletonShape, MkSparklineType, MkStatTrend, MkTagVariant, MkTreemapItem, MkTreemapRect };