@mk-kit/ui 0.35.0 → 0.37.0

package/fesm2022/mk-kit-ui.mjs

@@ -14,6 +14,9 @@ export * from '@mk-kit/ui/feedback';
 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/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.35.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"
@@ -107,6 +111,10 @@
       "types": "./types/mk-kit-ui-icon.d.ts",
       "default": "./fesm2022/mk-kit-ui-icon.mjs"
     },
+    "./layout": {
+      "types": "./types/mk-kit-ui-layout.d.ts",
+      "default": "./fesm2022/mk-kit-ui-layout.mjs"
+    },
     "./media": {
       "types": "./types/mk-kit-ui-media.d.ts",
       "default": "./fesm2022/mk-kit-ui-media.mjs"
@@ -115,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/styles/mk-kit.css

@@ -381,6 +381,22 @@ body.mk-app {
   border: 0;
 }
 
+/* Print helpers: `.mk-print-hidden` drops page chrome (toolbars, filters)
+   from paper; `.mk-print-only` shows something (a title, a date) only there.
+   Components ship their own `@media print` rules — mk-table prints as one
+   unbroken sheet with repeating headers and no controls. */
+.mk-print-only {
+  display: none;
+}
+
+@media print {
+  .mk-print-hidden {
+    display: none !important;
+  }
+  .mk-print-only {
+    display: revert;
+  }
+}
 /* mk-drag-handle — the grip a pointer drag must start on. MkDragHandle is a
  * DIRECTIVE (so it composes onto any element, including other components'
  * hosts like mk-icon), and directives cannot carry styles — hence the global

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

@@ -1,5 +1,5 @@
 import * as _angular_core from '@angular/core';
-import { InjectionToken, ComponentRef, Injector, OnDestroy, Type, AfterViewInit, ElementRef, Provider, Signal } from '@angular/core';
+import { InjectionToken, OnDestroy, Signal, ComponentRef, Injector, Type, AfterViewInit, ElementRef, Provider } from '@angular/core';
 import { Observable } from 'rxjs';
 import { ValidationErrors } from '@angular/forms';
 
@@ -84,6 +84,67 @@ declare class MkThemeService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<MkThemeService>;
 }
 
+/** Named viewport ranges, mobile-first: each starts at its min-width. */
+type MkBreakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | '2xl';
+/** Min-widths (px) at which each named breakpoint begins; `xs` is everything below `sm`. */
+type MkBreakpoints = Record<Exclude<MkBreakpoint, 'xs'>, number>;
+/** The default scale (same numbers as Tailwind, so mental models transfer). */
+declare const MK_DEFAULT_BREAKPOINTS: MkBreakpoints;
+/** Override the breakpoint scale app-wide: `{ provide: MK_BREAKPOINTS, useValue: { …, lg: 1100 } }`. */
+declare const MK_BREAKPOINTS: InjectionToken<MkBreakpoints>;
+/**
+ * A value that may differ per breakpoint: either the plain value or a
+ * mobile-first map, `{ xs: 1, md: 2, xl: 4 }`, where each key applies from
+ * that breakpoint up until the next key given.
+ */
+type MkResponsive<T> = T | Partial<Record<MkBreakpoint, T>>;
+/** True when `value` is a per-breakpoint map rather than a plain value. */
+declare function mkIsResponsive<T>(value: MkResponsive<T>): value is Partial<Record<MkBreakpoint, T>>;
+/**
+ * Reactive viewport breakpoints, one `matchMedia` listener per step.
+ *
+ * ```ts
+ * private readonly bp = inject(MkBreakpointService);
+ * readonly compact = this.bp.down('md');          // Signal<boolean>
+ * readonly columns = computed(() => this.bp.resolve({ xs: 1, md: 2, xl: 4 }));
+ * ```
+ *
+ * On the server (no `window`) everything reports `xs`.
+ */
+declare class MkBreakpointService implements OnDestroy {
+    /** The breakpoint scale in effect (see {@link MK_BREAKPOINTS}). */
+    readonly breakpoints: MkBreakpoints;
+    private readonly document;
+    private readonly isBrowser;
+    /** `matches` per step, in scale order (`sm` first). */
+    private readonly steps;
+    private readonly cleanup;
+    private readonly queries;
+    private readonly ups;
+    private readonly downs;
+    /** The widest breakpoint the viewport currently satisfies. */
+    readonly current: Signal<MkBreakpoint>;
+    constructor();
+    /** True while the viewport is at least `bp` wide (`up('md')` = md, lg, xl, 2xl). */
+    up(bp: MkBreakpoint): Signal<boolean>;
+    /** True while the viewport is narrower than `bp` (`down('md')` = xs, sm). */
+    down(bp: MkBreakpoint): Signal<boolean>;
+    /** True while the viewport is at least `from` and narrower than `to`. */
+    between(from: MkBreakpoint, to: MkBreakpoint): Signal<boolean>;
+    /** Any media query as a signal, e.g. `observe('(orientation: portrait)')`. */
+    observe(query: string): Signal<boolean>;
+    /**
+     * Pick the entry of a responsive value for the current viewport —
+     * mobile-first, so `{ xs: 1, md: 2 }` gives 1 on `sm` and 2 on `xl`.
+     * A plain value is returned as is. Read inside a `computed` to track it.
+     */
+    resolve<T>(value: MkResponsive<T>): T | undefined;
+    ngOnDestroy(): void;
+    private watch;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<MkBreakpointService, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<MkBreakpointService>;
+}
+
 type MkAriaLivePoliteness = 'polite' | 'assertive';
 /**
  * Announces messages to assistive technology via a visually-hidden
@@ -780,6 +841,9 @@ interface MkI18nStrings {
     /** Row expander toggle labels. */
     expandRow: string;
     collapseRow: string;
+    /** Tree-row toggle labels (`childrenKey`). */
+    expandTreeRow: string;
+    collapseTreeRow: string;
     /** aria-label of a group header's toggle when the group is collapsed. */
     expandGroup: string;
     /** aria-label of a group header's toggle when the group is expanded. */
@@ -869,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. */
@@ -1117,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_DEFAULT_DATE_NAMES, MK_DEFAULT_I18N, MK_DEFAULT_VALIDATION, MK_I18N, MK_OVERLAY_DATA, MkAnchoredPanel, MkFieldContext, MkFocusTrap, MkLiveAnnouncer, MkOverlayRef, MkOverlayService, MkThemeService, mkComputeAnchoredPosition, mkFirstErrorMessage, mkGetFocusable, mkHighlight, mkHighlightJson, mkUniqueId, mkValidatorChange, provideMkI18n };
-export type { MkAnchoredPosition, MkAnchoredPositionOptions, MkAriaLivePoliteness, MkBlockEditorStrings, MkCodeLanguage, MkDateNames, MkDensity, MkErrorMessages, MkI18nStrings, MkOverlayConfig, MkPlacement, MkResolvedTheme, 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 };