@mk-kit/ui 0.36.0 → 0.37.0

package/fesm2022/mk-kit-ui.mjs

@@ -15,6 +15,8 @@ export * from '@mk-kit/ui/rich-text';
 export * from '@mk-kit/ui/block-editor';
 export * from '@mk-kit/ui/context-menu';
 export * from '@mk-kit/ui/layout';
+export * from '@mk-kit/ui/chat';
+export * from '@mk-kit/ui/query-builder';
 export * from '@mk-kit/ui/media';
 
 /*

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/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/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/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.36.0",
+  "version": "0.37.0",
   "publishConfig": {
     "access": "public"
   },
@@ -63,6 +63,10 @@
       "types": "./types/mk-kit-ui-button.d.ts",
       "default": "./fesm2022/mk-kit-ui-button.mjs"
     },
+    "./chat": {
+      "types": "./types/mk-kit-ui-chat.d.ts",
+      "default": "./fesm2022/mk-kit-ui-chat.mjs"
+    },
     "./checkbox": {
       "types": "./types/mk-kit-ui-checkbox.d.ts",
       "default": "./fesm2022/mk-kit-ui-checkbox.mjs"
@@ -119,6 +123,10 @@
       "types": "./types/mk-kit-ui-navigation.d.ts",
       "default": "./fesm2022/mk-kit-ui-navigation.mjs"
     },
+    "./query-builder": {
+      "types": "./types/mk-kit-ui-query-builder.d.ts",
+      "default": "./fesm2022/mk-kit-ui-query-builder.mjs"
+    },
     "./rich-text": {
       "types": "./types/mk-kit-ui-rich-text.d.ts",
       "default": "./fesm2022/mk-kit-ui-rich-text.mjs"

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

@@ -0,0 +1,288 @@
+import * as _angular_core from '@angular/core';
+import { TemplateRef } from '@angular/core';
+import * as _mk_kit_ui_core from '@mk-kit/ui/core';
+
+/** Who a message comes from. `system` renders as a centred note. */
+type MkChatRole = 'user' | 'assistant' | 'system';
+/** Display identity of a message author. */
+interface MkChatAuthor {
+    /** Shown beside the message and used for avatar initials. */
+    name: string;
+    /** Avatar image URL; initials from `name` when omitted. */
+    avatar?: string;
+}
+/** A file shown with a message (an image when `type` is `image/*` and `url` is set). */
+interface MkChatAttachment {
+    name: string;
+    /** MIME type, e.g. `image/png`. */
+    type?: string;
+    /** Size in bytes, shown formatted. */
+    size?: number;
+    /** Link / image source. */
+    url?: string;
+}
+/** Lifecycle of a tool / function call an assistant made while answering. */
+type MkChatToolStatus = 'running' | 'done' | 'error';
+/** A tool call card rendered above the message text. */
+interface MkChatToolCall {
+    id?: string;
+    /** Tool name, e.g. `search_orders`. */
+    name: string;
+    status: MkChatToolStatus;
+    /** One-line human summary, e.g. `3 orders found`. */
+    summary?: string;
+    /** Raw input, shown under the disclosure. */
+    input?: string;
+    /** Raw output, shown under the disclosure. */
+    output?: string;
+}
+/** One message in the conversation. Replace the object (new reference) to update it. */
+interface MkChatMessage {
+    id: string;
+    role: MkChatRole;
+    /** Message body — Markdown for assistants (when `markdown` is on), plain text otherwise. */
+    text: string;
+    author?: MkChatAuthor;
+    /** When it was sent; a `Date`, ISO string or epoch ms. */
+    timestamp?: Date | string | number;
+    /** Still receiving text: shows a cursor and keeps the log pinned to the bottom. */
+    streaming?: boolean;
+    /** Delivery / generation failed; shown under the bubble with a retry button. */
+    error?: string;
+    attachments?: MkChatAttachment[];
+    tools?: MkChatToolCall[];
+}
+/** Payload of the `send` output. */
+interface MkChatSend {
+    text: string;
+    files: File[];
+}
+
+/**
+ * PromptBox — the composer of a chat: an auto-growing textarea, attachments
+ * (button, drop, paste), quick-reply suggestions and a send button that turns
+ * into *stop* while a reply is being generated.
+ *
+ * Enter sends, Shift+Enter breaks the line (`sendOnEnter="false"` to swap).
+ *
+ * ```html
+ * <mk-prompt-box
+ *   [(value)]="draft"
+ *   [busy]="generating()"
+ *   attachments
+ *   [suggestions]="['Summarise this page', 'Draft a reply']"
+ *   (send)="ask($event)"
+ *   (stop)="abort()"
+ * />
+ * ```
+ */
+declare class MkPromptBox {
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    protected readonly id: string;
+    /** The draft text (two-way). */
+    readonly value: _angular_core.ModelSignal<string>;
+    /** Placeholder of the textarea. */
+    readonly placeholder: _angular_core.InputSignal<string>;
+    /** Disable everything (e.g. while offline). */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** A reply is being generated: the send button becomes *stop*, sending is paused. */
+    readonly busy: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Allow attaching files (button, drag & drop, paste). */
+    readonly attachments: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Accepted file types for the picker (`accept` attribute syntax). */
+    readonly accept: _angular_core.InputSignal<string>;
+    /** Maximum number of attached files (0 = unlimited). */
+    readonly maxFiles: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Maximum draft length; shows a counter when set. */
+    readonly maxLength: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Minimum visible rows. */
+    readonly rows: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Rows the textarea grows to before scrolling. */
+    readonly maxRows: _angular_core.InputSignalWithTransform<number, unknown>;
+    /** Enter sends and Shift+Enter breaks the line (default); `false` swaps them. */
+    readonly sendOnEnter: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Quick replies shown above the box; clicking one sends it. */
+    readonly suggestions: _angular_core.InputSignal<readonly string[]>;
+    /** Focus the textarea on render. */
+    readonly autofocus: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The user submitted the draft (and any files). */
+    readonly send: _angular_core.OutputEmitterRef<MkChatSend>;
+    /** The user pressed *stop* while `busy`. */
+    readonly stop: _angular_core.OutputEmitterRef<void>;
+    /** Files waiting to be sent. */
+    readonly files: _angular_core.WritableSignal<File[]>;
+    protected readonly dragging: _angular_core.WritableSignal<boolean>;
+    private readonly textarea;
+    private readonly fileInput;
+    protected readonly canSend: _angular_core.Signal<boolean>;
+    protected readonly remaining: _angular_core.Signal<number | null>;
+    constructor();
+    /** Focus the textarea. */
+    focus(): void;
+    /** Empty the draft and the attachment list. */
+    clear(): void;
+    /** Submit the current draft (no-op when there is nothing to send or while busy). */
+    submit(): void;
+    /** Add files, honouring `maxFiles` and `accept`. */
+    addFiles(list: ArrayLike<File> | null | undefined): void;
+    removeFile(index: number): void;
+    protected onInput(event: Event): void;
+    protected onKeydown(event: KeyboardEvent): void;
+    protected onPaste(event: ClipboardEvent): void;
+    protected onDragOver(event: DragEvent): void;
+    protected onDrop(event: DragEvent): void;
+    protected openPicker(): void;
+    protected onFilesPicked(event: Event): void;
+    protected onSuggestion(text: string): void;
+    protected onPrimary(): void;
+    /** Human-readable size, e.g. `1.2 MB`. */
+    protected formatSize(bytes: number): string;
+    private accepts;
+    private autosize;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkPromptBox, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkPromptBox, "mk-prompt-box", never, { "value": { "alias": "value"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "rows": { "alias": "rows"; "required": false; "isSignal": true; }; "maxRows": { "alias": "maxRows"; "required": false; "isSignal": true; }; "sendOnEnter": { "alias": "sendOnEnter"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "autofocus": { "alias": "autofocus"; "required": false; "isSignal": true; }; }, { "value": "valueChange"; "send": "send"; "stop": "stop"; }, never, never, true, never>;
+}
+
+/**
+ * ChatMessage — one bubble: avatar, author and time, attachment previews,
+ * tool-call cards, the text (Markdown for assistants) with a streaming
+ * cursor, and copy / retry actions. `mk-chat` renders these for you; use it
+ * directly to build your own list.
+ */
+declare class MkChatMessageComponent {
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    /** The message to render. */
+    readonly message: _angular_core.InputSignal<MkChatMessage>;
+    /** Render on the "own" (end) side — `mk-chat` sets this from `ownRole`. */
+    readonly own: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Render `text` as Markdown (assistants only; user text is always plain). */
+    readonly markdown: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showAvatar: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showTimestamp: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Offer a copy button on hover / focus. */
+    readonly copyable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** The retry button of a failed message was pressed. */
+    readonly retry: _angular_core.OutputEmitterRef<MkChatMessage>;
+    protected readonly authorName: _angular_core.Signal<string>;
+    protected readonly time: _angular_core.Signal<string>;
+    protected readonly ariaLabel: _angular_core.Signal<string | null>;
+    protected readonly useMarkdown: _angular_core.Signal<boolean>;
+    protected isImage(a: MkChatAttachment): boolean;
+    protected formatSize(bytes: number | undefined): string;
+    protected toolIcon(tool: MkChatToolCall): string;
+    protected toolStatus(tool: MkChatToolCall): string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkChatMessageComponent, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkChatMessageComponent, "mk-chat-message", never, { "message": { "alias": "message"; "required": true; "isSignal": true; }; "own": { "alias": "own"; "required": false; "isSignal": true; }; "markdown": { "alias": "markdown"; "required": false; "isSignal": true; }; "showAvatar": { "alias": "showAvatar"; "required": false; "isSignal": true; }; "showTimestamp": { "alias": "showTimestamp"; "required": false; "isSignal": true; }; "copyable": { "alias": "copyable"; "required": false; "isSignal": true; }; }, { "retry": "retry"; }, never, never, true, never>;
+}
+
+/** Context handed to an `*mkChatMessageDef` template. */
+interface MkChatMessageContext {
+    $implicit: MkChatMessage;
+    own: boolean;
+    index: number;
+}
+/**
+ * Custom message rendering for `mk-chat`:
+ *
+ * ```html
+ * <mk-chat [messages]="messages()">
+ *   <ng-template mkChatMessageDef let-message let-own="own">
+ *     <my-bubble [message]="message" [mine]="own" />
+ *   </ng-template>
+ * </mk-chat>
+ * ```
+ */
+declare class MkChatMessageDef {
+    readonly template: TemplateRef<any>;
+    static ngTemplateContextGuard(_dir: MkChatMessageDef, ctx: unknown): ctx is MkChatMessageContext;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkChatMessageDef, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MkChatMessageDef, "ng-template[mkChatMessageDef]", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Chat — a conversation: a scrolling, screen-reader-announced log of
+ * `mk-chat-message` bubbles that stays pinned to the newest message while
+ * text streams in (with a *jump to latest* button once the reader scrolls
+ * up), a typing indicator, and an `mk-prompt-box` composer.
+ *
+ * The component is presentational: hand it `messages` (replace the array or
+ * a message object to update — signals compare by reference) and react to
+ * `(send)` / `(stop)` / `(retry)` with your own transport.
+ *
+ * ```html
+ * <mk-chat
+ *   [messages]="messages()"
+ *   [busy]="generating()"
+ *   [typing]="peerTyping()"
+ *   attachments
+ *   [suggestions]="starters"
+ *   (send)="ask($event)"
+ *   (stop)="abort()"
+ *   (retry)="resend($event)"
+ *   style="height: 32rem"
+ * >
+ *   <div mkChatHeader>…title, model picker…</div>
+ *   <div mkChatEmpty>…first-run hint…</div>
+ * </mk-chat>
+ * ```
+ *
+ * Slots: `[mkChatHeader]`, `[mkChatEmpty]`, `[mkChatFooter]` (under the composer).
+ */
+declare class MkChat {
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    /** The conversation, oldest first. */
+    readonly messages: _angular_core.InputSignal<readonly MkChatMessage[]>;
+    /** Which role renders on the "own" side (default `user`). */
+    readonly ownRole: _angular_core.InputSignal<MkChatRole>;
+    /** Render assistant text as Markdown. */
+    readonly markdown: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showAvatars: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly showTimestamps: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Someone else is typing (shows the dots indicator). */
+    readonly typing: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** A reply is being generated: composer shows *stop*. */
+    readonly busy: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Disable the composer. */
+    readonly disabled: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Hide the composer entirely (read-only transcript). */
+    readonly readonly: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly placeholder: _angular_core.InputSignal<string | undefined>;
+    /** Allow attachments in the composer. */
+    readonly attachments: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    readonly accept: _angular_core.InputSignal<string>;
+    readonly maxFiles: _angular_core.InputSignal<number>;
+    readonly maxLength: _angular_core.InputSignal<number>;
+    /** Quick replies above the composer; each click sends its text. */
+    readonly suggestions: _angular_core.InputSignal<readonly string[]>;
+    /** Text shown when there are no messages (or project `[mkChatEmpty]`). */
+    readonly emptyMessage: _angular_core.InputSignal<string | undefined>;
+    /** Keep the log pinned to the newest message while the reader is at the bottom. */
+    readonly autoScroll: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Accessible name of the log region. */
+    readonly ariaLabel: _angular_core.InputSignal<string | undefined>;
+    readonly send: _angular_core.OutputEmitterRef<MkChatSend>;
+    readonly stop: _angular_core.OutputEmitterRef<void>;
+    readonly retry: _angular_core.OutputEmitterRef<MkChatMessage>;
+    protected readonly messageDef: _angular_core.Signal<MkChatMessageDef | undefined>;
+    private readonly log;
+    private readonly composer;
+    /** The reader is (near) the bottom of the log. */
+    protected readonly atBottom: _angular_core.WritableSignal<boolean>;
+    /** Messages that arrived while scrolled up. */
+    protected readonly unseen: _angular_core.WritableSignal<number>;
+    private lastCount;
+    protected readonly resolvedEmpty: _angular_core.Signal<string>;
+    protected readonly resolvedPlaceholder: _angular_core.Signal<string>;
+    constructor();
+    /** Scroll the log to the newest message. */
+    scrollToBottom(): void;
+    /** Focus the composer. */
+    focus(): void;
+    protected onScroll(): void;
+    protected isOwn(m: MkChatMessage): boolean;
+    protected trackMessage: (_: number, m: MkChatMessage) => string;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkChat, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkChat, "mk-chat", never, { "messages": { "alias": "messages"; "required": false; "isSignal": true; }; "ownRole": { "alias": "ownRole"; "required": false; "isSignal": true; }; "markdown": { "alias": "markdown"; "required": false; "isSignal": true; }; "showAvatars": { "alias": "showAvatars"; "required": false; "isSignal": true; }; "showTimestamps": { "alias": "showTimestamps"; "required": false; "isSignal": true; }; "typing": { "alias": "typing"; "required": false; "isSignal": true; }; "busy": { "alias": "busy"; "required": false; "isSignal": true; }; "disabled": { "alias": "disabled"; "required": false; "isSignal": true; }; "readonly": { "alias": "readonly"; "required": false; "isSignal": true; }; "placeholder": { "alias": "placeholder"; "required": false; "isSignal": true; }; "attachments": { "alias": "attachments"; "required": false; "isSignal": true; }; "accept": { "alias": "accept"; "required": false; "isSignal": true; }; "maxFiles": { "alias": "maxFiles"; "required": false; "isSignal": true; }; "maxLength": { "alias": "maxLength"; "required": false; "isSignal": true; }; "suggestions": { "alias": "suggestions"; "required": false; "isSignal": true; }; "emptyMessage": { "alias": "emptyMessage"; "required": false; "isSignal": true; }; "autoScroll": { "alias": "autoScroll"; "required": false; "isSignal": true; }; "ariaLabel": { "alias": "ariaLabel"; "required": false; "isSignal": true; }; }, { "send": "send"; "stop": "stop"; "retry": "retry"; }, ["messageDef"], ["[mkChatHeader]", "[mkChatEmpty]", "[mkChatFooter]"], true, never>;
+}
+
+export { MkChat, MkChatMessageComponent, MkChatMessageDef, MkPromptBox };
+export type { MkChatAttachment, MkChatAuthor, MkChatMessage, MkChatMessageContext, MkChatRole, MkChatSend, MkChatToolCall, MkChatToolStatus };

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

@@ -933,6 +933,89 @@ interface MkI18nStrings {
     logCopyAll: string;
     /** Log viewer: soft-wrap toolbar toggle. */
     logWrapLines: string;
+    /** Chat: accessible name of the message log. */
+    chatLabel: string;
+    /** Chat: accessible name of the composer textarea. */
+    chatComposerLabel: string;
+    /** Chat: composer placeholder. */
+    chatPlaceholder: string;
+    /** Chat: send button. */
+    chatSend: string;
+    /** Chat: stop-generating button (replaces send while busy). */
+    chatStop: string;
+    /** Chat: attach-files button. */
+    chatAttach: string;
+    /** Chat: remove one pending attachment. */
+    chatRemoveAttachment: string;
+    /** Chat: group label of pending / shown attachments. */
+    chatAttachments: string;
+    /** Chat: group label of quick-reply suggestions. */
+    chatSuggestions: string;
+    /** Chat: copy-message button. */
+    chatCopy: string;
+    /** Chat: retry a failed message. */
+    chatRetry: string;
+    /** Chat: typing indicator. */
+    chatTyping: string;
+    /** Chat: screen-reader text while a reply streams in. */
+    chatStreaming: string;
+    /** Chat: scroll-to-newest button. */
+    chatJumpToLatest: string;
+    /** Chat: empty-state text. */
+    chatEmpty: string;
+    /** Chat: author fallback for the user's own messages. */
+    chatYou: string;
+    /** Chat: author fallback for assistant messages. */
+    chatAssistant: string;
+    /** Chat: tool call in progress. */
+    chatToolRunning: string;
+    /** Chat: tool call finished. */
+    chatToolDone: string;
+    /** Chat: tool call failed. */
+    chatToolError: string;
+    /** Query builder: accessible name of the whole builder. */
+    queryBuilderLabel: string;
+    queryAddRule: string;
+    queryAddGroup: string;
+    queryRemoveRule: string;
+    queryRemoveGroup: string;
+    /** Combinator labels — also used by `mkQueryToText`. */
+    queryAnd: string;
+    queryOr: string;
+    queryNot: string;
+    queryField: string;
+    queryOperator: string;
+    queryValue: string;
+    queryValueFrom: string;
+    queryValueTo: string;
+    queryEmptyGroup: string;
+    queryTrue: string;
+    queryFalse: string;
+    queryOpEq: string;
+    queryOpNeq: string;
+    queryOpContains: string;
+    queryOpNotContains: string;
+    queryOpStartsWith: string;
+    queryOpEndsWith: string;
+    queryOpGt: string;
+    queryOpGte: string;
+    queryOpLt: string;
+    queryOpLte: string;
+    queryOpBetween: string;
+    queryOpIn: string;
+    queryOpNotIn: string;
+    queryOpBefore: string;
+    queryOpAfter: string;
+    queryOpEmpty: string;
+    queryOpNotEmpty: string;
+    /** Dialog: label of the move grip (arrow keys move, Home resets). */
+    dialogMove: string;
+    /** Dialog: label of the resize grip (arrow keys resize, Home resets). */
+    dialogResize: string;
+    /** Listbox: filter box placeholder / label. */
+    listboxFilter: string;
+    /** Listbox: shown when the filter matches nothing. */
+    listboxEmpty: string;
     /** Announced when an event is picked up in keyboard move mode. */
     eventCalendarGrabbed: (title: string, from: string, to: string) => string;
     /** Announced after each keyboard step: current day + time range. */
@@ -1181,5 +1264,83 @@ type MkErrorMessages = Readonly<Record<string, string | ((err: any) => string)>>
  */
 declare function mkFirstErrorMessage(errors: ValidationErrors | null | undefined, strings: MkValidationStrings, overrides?: MkErrorMessages): string | null;
 
-export { MK_BREAKPOINTS, MK_DEFAULT_BREAKPOINTS, MK_DEFAULT_DATE_NAMES, MK_DEFAULT_I18N, MK_DEFAULT_VALIDATION, MK_I18N, MK_OVERLAY_DATA, MkAnchoredPanel, MkBreakpointService, MkFieldContext, MkFocusTrap, MkLiveAnnouncer, MkOverlayRef, MkOverlayService, MkThemeService, mkComputeAnchoredPosition, mkFirstErrorMessage, mkGetFocusable, mkHighlight, mkHighlightJson, mkIsResponsive, mkUniqueId, mkValidatorChange, provideMkI18n };
-export type { MkAnchoredPosition, MkAnchoredPositionOptions, MkAriaLivePoliteness, MkBlockEditorStrings, MkBreakpoint, MkBreakpoints, MkCodeLanguage, MkDateNames, MkDensity, MkErrorMessages, MkI18nStrings, MkOverlayConfig, MkPlacement, MkResolvedTheme, MkResponsive, MkSize$1 as MkSize, MkSortAnnounceDirection, MkThemePreference, MkTone, MkValidationStrings, MkValidatorChangeRef, MkVariant };
+/** 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. */
+interface MkQueryFieldOption {
+    label: string;
+    value: unknown;
+}
+/** A field the user can filter on. */
+interface MkQueryField {
+    /** Property key on the row objects / the API's filter name. */
+    key: string;
+    /** Label shown in the field picker. */
+    label: string;
+    /** Default `string`. */
+    type?: MkQueryValueType;
+    /** Choices for `select` fields. */
+    options?: readonly MkQueryFieldOption[];
+    /** Restrict / reorder the operators offered (default: all for the type). */
+    operators?: readonly MkQueryOperator[];
+    /** Placeholder of the value editor. */
+    placeholder?: string;
+}
+/** Comparison operators. Which apply depends on the field type. */
+type MkQueryOperator = 'eq' | 'neq' | 'contains' | 'notContains' | 'startsWith' | 'endsWith' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'in' | 'notIn' | 'before' | 'after' | 'empty' | 'notEmpty';
+/** A leaf condition. `value` is `[from, to]` for `between`, an array for `in` / `notIn`, absent for `empty` / `notEmpty`. Dates are ISO strings. */
+interface MkQueryRule {
+    id: string;
+    field: string;
+    operator: MkQueryOperator;
+    value?: unknown;
+}
+type MkQueryCombinator = 'and' | 'or';
+/** A group of rules and nested groups joined by one combinator, optionally negated. */
+interface MkQueryGroup {
+    id: string;
+    combinator: MkQueryCombinator;
+    /** Negate the whole group. */
+    not?: boolean;
+    rules: MkQueryNode[];
+}
+type MkQueryNode = MkQueryRule | MkQueryGroup;
+
+/** Operators offered per field type, in menu order. */
+declare const MK_QUERY_OPERATORS: Readonly<Record<MkQueryValueType, readonly MkQueryOperator[]>>;
+/** Operators that take no value. */
+declare const MK_QUERY_UNARY: ReadonlySet<MkQueryOperator>;
+/** True for a group node (as opposed to a rule). */
+declare function mkIsQueryGroup(node: MkQueryNode): node is MkQueryGroup;
+/** A fresh empty group. */
+declare function mkCreateQueryGroup(init?: Partial<Omit<MkQueryGroup, 'id'>>): MkQueryGroup;
+/** A fresh rule on `field`, using its first operator. */
+declare function mkCreateQueryRule(field: MkQueryField): MkQueryRule;
+/** Operators a field offers (its own list, else the defaults for its type). */
+declare function mkQueryOperatorsFor(field: MkQueryField | undefined): readonly MkQueryOperator[];
+/** True when the tree holds no rule at all (empty groups only). */
+declare function mkQueryIsEmpty(group: MkQueryGroup): boolean;
+/** Number of rules in the tree. */
+declare function mkQueryRuleCount(group: MkQueryGroup): number;
+/** Drop empty groups and rules that still need a value, so the API gets only complete conditions. */
+declare function mkQueryCompact(group: MkQueryGroup): MkQueryGroup;
+/** A rule is complete when its operator needs no value or has one. */
+declare function mkQueryRuleIsComplete(rule: MkQueryRule): boolean;
+/** Evaluate one rule against a row. */
+declare function mkQueryRuleMatches(rule: MkQueryRule, row: Record<string, unknown>, field?: MkQueryField): boolean;
+/**
+ * Compile a query into a row predicate for client-side filtering
+ * (`rows.filter(mkQueryToPredicate(query, fields))`). Unfinished rules are
+ * ignored, so a half-edited query never blanks the table.
+ */
+declare function mkQueryToPredicate<T extends object = Record<string, unknown>>(group: MkQueryGroup, fields?: readonly MkQueryField[]): (row: T) => boolean;
+/** Localised label of an operator. */
+declare function mkQueryOperatorLabel(op: MkQueryOperator, i18n?: MkI18nStrings): string;
+/**
+ * Human-readable sentence for a query, e.g.
+ * `(Name contains "ada" and Orders at least 10) or Status is any of Active, Invited`.
+ */
+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, MkDateNames, MkDensity, MkErrorMessages, MkI18nStrings, MkOverlayConfig, MkPlacement, MkQueryCombinator, MkQueryField, MkQueryFieldOption, MkQueryGroup, MkQueryNode, MkQueryOperator, MkQueryRule, MkQueryValueType, MkResolvedTheme, MkResponsive, MkSize$1 as MkSize, MkSortAnnounceDirection, MkThemePreference, MkTone, MkValidationStrings, MkValidatorChangeRef, MkVariant };

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

@@ -543,13 +543,53 @@ declare class MkDialog {
     readonly titleId: _angular_core.InputSignal<string>;
     /** Hide the header close button. */
     readonly hideClose: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Let the user move the dialog by dragging its header (pointer / touch) or
+     * with the arrow keys on the grip that appears in the header. Double-click
+     * the header or press Home on the grip to snap back to the centre.
+     */
+    readonly draggable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /**
+     * Let the user resize the dialog from the corner grip (pointer / touch, or
+     * arrow keys on the grip; Home resets). The panel never grows past the
+     * viewport or shrinks below a usable minimum.
+     */
+    readonly resizable: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    private readonly destroyRef;
+    /** The body-level overlay panel this dialog lives in (`null` when inline). */
+    private panelEl;
+    /** Current drag offset from the centred position, px. */
+    private offset;
     constructor();
     /** Close the surrounding overlay, if any. */
     protected close(): void;
+    /** Snap back to the centred, preset-sized panel. */
+    reset(): void;
+    protected onHeaderPointerDown(event: PointerEvent): void;
+    protected onGripPointerDown(event: PointerEvent): void;
+    protected onResizerPointerDown(event: PointerEvent): void;
+    protected onHeaderDoubleClick(event: MouseEvent): void;
+    protected onGripKeydown(event: KeyboardEvent): void;
+    protected onResizerKeydown(event: KeyboardEvent): void;
+    private static arrowDelta;
+    private startPointer;
+    /** Move the panel to `(x, y)` px from its centred spot, kept inside the viewport. */
+    private moveTo;
+    /** Resize the panel to `w × h` px within [minimum, viewport]. */
+    private resizeTo;
+    /**
+     * Once the user takes hold, the entrance animation must never run again —
+     * toggling `animation` back on (as a transient class would) restarts it,
+     * so the panel would blink after every drag. The class is never removed.
+     */
+    private markMoved;
+    private clampIntoView;
+    private isRtl;
+    private panel;
     /** Point the owning dialog panel's `aria-labelledby` at the title element. */
     private wireLabelledBy;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkDialog, never>;
-    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkDialog, "mk-dialog", never, { "dialogTitle": { "alias": "dialogTitle"; "required": false; "isSignal": true; }; "titleId": { "alias": "titleId"; "required": false; "isSignal": true; }; "hideClose": { "alias": "hideClose"; "required": false; "isSignal": true; }; }, {}, never, ["[mkDialogHeader], mk-dialog-title", "*", "[mkDialogFooter]"], true, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkDialog, "mk-dialog", never, { "dialogTitle": { "alias": "dialogTitle"; "required": false; "isSignal": true; }; "titleId": { "alias": "titleId"; "required": false; "isSignal": true; }; "hideClose": { "alias": "hideClose"; "required": false; "isSignal": true; }; "draggable": { "alias": "draggable"; "required": false; "isSignal": true; }; "resizable": { "alias": "resizable"; "required": false; "isSignal": true; }; }, {}, never, ["[mkDialogHeader], mk-dialog-title", "*", "[mkDialogFooter]"], true, never>;
 }
 
 /** Data contract for {@link MkConfirmDialog} / `MkDialogService.confirm`. */
@@ -1266,5 +1306,74 @@ declare class MkTourService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MkTourService>;
 }
 
-export { MK_TOUR_DATA, MkAlert, MkBanner, MkBottomSheet, MkBottomSheetService, MkConfirmDialog, MkDialog, MkDialogService, MkDialogTitle, MkHovercard, MkHovercardTrigger, MkLoadingBar, MkLoadingBarService, MkNotificationCenter, MkPopconfirm, MkPopconfirmTrigger, MkPopover, MkPopoverTrigger, MkPromptDialog, MkResult, MkSnackbar, MkSnackbarContainer, MkSnackbarRef, MkSnackbarService, MkToast, MkToastContainer, MkToastService, MkTooltip, MkTooltipPanel, MkTourPopup, MkTourService };
+/**
+ * The translucent panel with a spinner that `mkBlockUi` and
+ * `MkBlockUiService` drop over a region or the page.
+ */
+declare class MkBlockUiOverlay {
+    protected readonly i18n: _mk_kit_ui_core.MkI18nStrings;
+    readonly message: _angular_core.WritableSignal<string>;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkBlockUiOverlay, never>;
+    static ɵcmp: _angular_core.ɵɵComponentDeclaration<MkBlockUiOverlay, "mk-block-ui-overlay", never, {}, {}, never, never, true, never>;
+}
+/**
+ * Block UI — cover the host element with a translucent panel and spinner
+ * while something loads, so its contents can neither be read nor operated:
+ * a card refreshing, a form submitting, a table re-fetching.
+ *
+ * Children get `inert` (no clicks, no Tab stops) and the host `aria-busy`.
+ * `mkBlockUiDelay` (ms) holds the overlay back for quick operations so the
+ * screen does not flash.
+ *
+ * ```html
+ * <mk-card [mkBlockUi]="saving()" mkBlockUiMessage="Saving…">…</mk-card>
+ * <form [mkBlockUi]="submitting()" [mkBlockUiDelay]="300">…</form>
+ * ```
+ */
+declare class MkBlockUi {
+    private readonly host;
+    private readonly document;
+    private readonly injector;
+    private readonly appRef;
+    /** Block while `true`. */
+    readonly mkBlockUi: _angular_core.InputSignalWithTransform<boolean, unknown>;
+    /** Text under the spinner (also its accessible label). */
+    readonly mkBlockUiMessage: _angular_core.InputSignal<string>;
+    /** Wait this many ms before showing, to avoid a flash on fast operations. */
+    readonly mkBlockUiDelay: _angular_core.InputSignalWithTransform<number, unknown>;
+    private mounted;
+    private timer;
+    constructor();
+    private mount;
+    private unmount;
+    private cancelTimer;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkBlockUi, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<MkBlockUi, "[mkBlockUi]", never, { "mkBlockUi": { "alias": "mkBlockUi"; "required": false; "isSignal": true; }; "mkBlockUiMessage": { "alias": "mkBlockUiMessage"; "required": false; "isSignal": true; }; "mkBlockUiDelay": { "alias": "mkBlockUiDelay"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
+}
+/**
+ * Block the whole page. Reference-counted: every `block()` returns a release
+ * function, and the overlay disappears once all of them have been called.
+ *
+ * ```ts
+ * const release = this.blockUi.block('Exporting…');
+ * try { await this.api.export(); } finally { release(); }
+ * ```
+ */
+declare class MkBlockUiService {
+    private readonly document;
+    private readonly injector;
+    private readonly appRef;
+    private mounted;
+    private readonly _count;
+    /** Number of active blocks. */
+    readonly count: _angular_core.Signal<number>;
+    /** Show the page overlay (or update its message); call the returned function to release. */
+    block(message?: string): () => void;
+    /** True while the page is blocked. */
+    isBlocked(): boolean;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkBlockUiService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MkBlockUiService>;
+}
+
+export { MK_TOUR_DATA, MkAlert, MkBanner, MkBlockUi, MkBlockUiOverlay, MkBlockUiService, MkBottomSheet, MkBottomSheetService, MkConfirmDialog, MkDialog, MkDialogService, MkDialogTitle, MkHovercard, MkHovercardTrigger, MkLoadingBar, MkLoadingBarService, MkNotificationCenter, MkPopconfirm, MkPopconfirmTrigger, MkPopover, MkPopoverTrigger, MkPromptDialog, MkResult, MkSnackbar, MkSnackbarContainer, MkSnackbarRef, MkSnackbarService, MkToast, MkToastContainer, MkToastService, MkTooltip, MkTooltipPanel, MkTourPopup, MkTourService };
 export type { MkAlertTone, MkAlertVariant, MkBottomSheetConfig, MkConfirmDialogData, MkDialogConfig, MkDialogSize, MkNotification, MkPromptDialogData, MkResultIconVariant, MkResultStatus, MkResultTone, MkSnackbarConfig, MkSnackbarDismissReason, MkSnackbarItem, MkSnackbarTone, MkToastAction, MkToastConfig, MkToastItem, MkToastTone, MkTourController, MkTourData, MkTourStep };