@mk-kit/mcp 0.54.0 → 0.55.1

package/data/api.json

@@ -1,6 +1,6 @@
 {
  "package": "@mk-kit/ui",
- "version": "0.54.0",
+ "version": "0.55.1",
  "site": "https://mk-kit.dev",
  "entries": [
   {
@@ -2637,6 +2637,16 @@
        "type": "(position: number) => string",
        "description": "Announced when the item is dropped."
       },
+      {
+       "name": "dndMovedToZone",
+       "type": "(zone: string) => string",
+       "description": "Announced as a lifted item reaches a drop zone (a target that is not a list)."
+      },
+      {
+       "name": "dndDroppedInZone",
+       "type": "(zone: string) => string",
+       "description": "Announced when the item is dropped on a zone."
+      },
       {
        "name": "dndCancelled",
        "type": "string",
@@ -4973,7 +4983,7 @@
    "exports": [
     {
      "name": "MkDrag",
-     "description": "Makes an item inside a `[mkDropList]` draggable — by pointer (mouse / touch /\npen) **and** by keyboard (WCAG 2.1.1). Every move is announced via\n`MkLiveAnnouncer`. Which element carries the keyboard interaction\ndepends on the handle:\n\n- **No handle, or a decorative one** (`<span mkDragHandle aria-hidden>`):\n  the item itself is focusable and exposes `aria-roledescription=\"Draggable\n  item\"` with `role=\"button\"` — or `role=\"option\"` when it is an `<li>` of a\n  `<ul mkDropList>`, which then becomes a labelled `listbox` (an `<li>` may\n  not take the `button` role).\n- **A focusable handle** (`<button mkDragHandle aria-label=\"…\">`, or any\n  handle with `tabindex`): the handle is the keyboard target and receives\n  the `aria-roledescription` / `aria-pressed` / `aria-grabbed` state; the\n  item stays a plain container with no role and no `tabindex`, so it can hold\n  inputs, links and buttons of its own (no nested interactive controls) and\n  `<li>` items keep their list semantics.\n\nKeyboard: focus the item (or its handle) and press **Space/Enter** to pick\nit up, **Arrow** keys to move it (crossing into connected lists at the ends /\nacross the perpendicular axis), **Space/Enter** to drop, **Escape** to cancel.\n\nTouch: a swipe scrolls the page as usual — the drag only arms after a\nlong-press (`mkDragTouchDelay`, default 300 ms). While armed the item\ngets the `mk-drag--armed` class so consumers can style the lift moment.\nMouse and pen drags start immediately, as before.\n\nPerformance: pointer moves are rAF-coalesced (one hit-test + one set of\nstyle/DOM writes per frame) against list/item rects snapshotted when the\ndrag lifts, so a move never forces layout. The pending frame is flushed\nsynchronously on release so drops land exactly where the pointer ended.\n\n```html\n<div mkDrag [mkDragData]=\"row\" [mkDragDisabled]=\"row.locked\">\n  <span mkDragHandle aria-hidden=\"true\">⠿</span> {{ row.title }}\n</div>\n```",
+     "description": "Makes an item inside a `[mkDropList]` draggable — by pointer (mouse / touch /\npen) **and** by keyboard (WCAG 2.1.1). Every move is announced via\n`MkLiveAnnouncer`. Which element carries the keyboard interaction\ndepends on the handle:\n\n- **No handle, or a decorative one** (`<span mkDragHandle aria-hidden>`):\n  the item itself is focusable and exposes `aria-roledescription=\"Draggable\n  item\"` with `role=\"button\"` — or `role=\"option\"` when it is an `<li>` of a\n  `<ul mkDropList>`, which then becomes a labelled `listbox` (an `<li>` may\n  not take the `button` role).\n- **A focusable handle** (`<button mkDragHandle aria-label=\"…\">`, or any\n  handle with `tabindex`): the handle is the keyboard target and receives\n  the `aria-roledescription` / `aria-pressed` / `aria-grabbed` state; the\n  item stays a plain container with no role and no `tabindex`, so it can hold\n  inputs, links and buttons of its own (no nested interactive controls) and\n  `<li>` items keep their list semantics.\n\nKeyboard: focus the item (or its handle) and press **Space/Enter** to pick\nit up, **Arrow** keys to move it (crossing into connected lists at the ends /\nacross the perpendicular axis), **Space/Enter** to drop, **Escape** to cancel.\n\nBesides lists, an item can be released on a connected `[mkDropZone]` — a\ntarget that reports *where* it was dropped instead of an index (a timeline,\na priority band, a \"focus on this\" pane). Zones sit in the same keyboard\ntravel group as lists, in document order; while an item hovers a zone no\nplaceholder is shown and the zone streams `mkDropZoneMoved` events.\n\nTouch: a swipe scrolls the page as usual — the drag only arms after a\nlong-press (`mkDragTouchDelay`, default 300 ms). While armed the item\ngets the `mk-drag--armed` class so consumers can style the lift moment.\nMouse and pen drags start immediately, as before.\n\nPerformance: pointer moves are rAF-coalesced (one hit-test + one set of\nstyle/DOM writes per frame) against list/item rects snapshotted when the\ndrag lifts, so a move never forces layout. The pending frame is flushed\nsynchronously on release so drops land exactly where the pointer ended.\n\n```html\n<div mkDrag [mkDragData]=\"row\" [mkDragDisabled]=\"row.locked\">\n  <span mkDragHandle aria-hidden=\"true\">⠿</span> {{ row.title }}\n</div>\n```",
      "file": "projects/mk-kit/dnd/drag.ts",
      "kind": "component",
      "selector": "[mkDrag]",
@@ -5147,6 +5157,117 @@
      "queries": [],
      "docs": "/components/drag-drop"
     },
+    {
+     "name": "MkDropZone",
+     "description": "A drop **target** that is not a list: an item dragged out of a connected\n`[mkDropList]` can be released anywhere on it, and the zone reports *where*\n— client coordinates, the offset inside the zone and the 0–1 fraction along\neach axis — so the consumer can turn a position into meaning: a time on a\ntimeline, a priority band, a \"focus on this\" pane, a trash can.\n\nNothing reorders and no placeholder is shown while an item hovers a zone;\nthe zone gets the `mk-drop-zone--receiving` class and a stream of\n`mkDropZoneMoved` events instead. Zones and lists can overlap — the\ninnermost target under the pointer wins, so a column can hold three\npriority bands and still accept plain drops between the bands.\n\nWire a zone exactly like another list: give it an id and name that id in\nthe source list's `mkDropListConnectedTo`.\n\nKeyboard: a lifted item reaches zones with the arrow keys that cross lists\n(Left/Right in a vertical list, Up/Down in a horizontal one) — zones sit in\nthe same DOM-ordered travel group as connected lists; Space/Enter drops at\nthe zone's centre. Every step is announced.\n\n```html\n<ul mkDropList mkDropListId=\"backlog\" [mkDropListConnectedTo]=\"['now', 'rail']\" …>\n<section mkDropZone mkDropZoneId=\"now\" mkDropZoneLabel=\"Focus now\"\n         (mkDropZoneDropped)=\"focus($event.item.mkDragData())\">\n<div mkDropZone mkDropZoneId=\"rail\" mkDropZoneLabel=\"Today\"\n     (mkDropZoneMoved)=\"preview($event.fractionY)\"\n     (mkDropZoneDropped)=\"schedule($event.item.mkDragData(), $event.fractionY)\">\n```",
+     "file": "projects/mk-kit/dnd/drop-zone.ts",
+     "kind": "component",
+     "selector": "[mkDropZone]",
+     "selectors": [
+      "mkDropZone"
+     ],
+     "exportAs": "mkDropZone",
+     "inputs": [
+      {
+       "name": "mkDropZoneId",
+       "type": "string | undefined",
+       "description": "Stable id source lists name in `mkDropListConnectedTo`. Auto-generated when omitted."
+      },
+      {
+       "name": "mkDropZoneLabel",
+       "type": "string",
+       "description": "Human-readable name, used in screen-reader announcements when a lifted\nitem reaches the zone (\"Moved to Focus now\") and as the zone's accessible\nname. Set it: the fallback is the id, which may be generated gibberish.",
+       "default": "''"
+      },
+      {
+       "name": "mkDropZoneLabelledBy",
+       "type": "string",
+       "description": "Id of a visible element that names the zone (`aria-labelledby`); wins over the label as the accessible name.",
+       "default": "''"
+      },
+      {
+       "name": "mkDropZoneData",
+       "type": "Z | undefined",
+       "description": "Arbitrary payload handed back on every hover and drop event."
+      },
+      {
+       "name": "mkDropZoneDisabled",
+       "type": "boolean",
+       "description": "Disable dropping onto this zone (it leaves the travel group too).",
+       "default": "false"
+      }
+     ],
+     "outputs": [
+      {
+       "name": "mkDropZoneEntered",
+       "type": "MkDropZoneHover<T, Z>",
+       "description": "An item entered the zone (pointer or keyboard)."
+      },
+      {
+       "name": "mkDropZoneMoved",
+       "type": "MkDropZoneHover<T, Z>",
+       "description": "The pointer moved while over the zone (one per frame, pointer only)."
+      },
+      {
+       "name": "mkDropZoneLeft",
+       "type": "MkDrag<T>",
+       "description": "The item left the zone without dropping (moved on, or the drag was cancelled)."
+      },
+      {
+       "name": "mkDropZoneDropped",
+       "type": "MkDropZoneEvent<T, Z>",
+       "description": "The item was released on the zone."
+      }
+     ],
+     "methods": [
+      {
+       "name": "setReceiving",
+       "signature": "(value: boolean): void",
+       "description": "Toggle the \"receiving\" highlight (called by the active drag)."
+      },
+      {
+       "name": "emitEntered",
+       "signature": "(event: MkDropZoneHover<T, Z>): void",
+       "description": "Called by the active `MkDrag` — not part of the consumer API."
+      },
+      {
+       "name": "emitMoved",
+       "signature": "(event: MkDropZoneHover<T, Z>): void",
+       "description": ""
+      },
+      {
+       "name": "emitLeft",
+       "signature": "(item: MkDrag<T>): void",
+       "description": ""
+      },
+      {
+       "name": "emitDrop",
+       "signature": "(event: MkDropZoneEvent<T, Z>): void",
+       "description": ""
+      }
+     ],
+     "properties": [
+      {
+       "name": "element",
+       "type": "HTMLElement",
+       "description": "The zone's host element (drop target bounds).",
+       "readonly": true
+      },
+      {
+       "name": "id",
+       "type": "Signal<string>",
+       "description": "Resolved id (input or generated).",
+       "readonly": true
+      },
+      {
+       "name": "label",
+       "type": "Signal<string>",
+       "description": "Announceable name: the label when set, otherwise the resolved id.",
+       "readonly": true
+      }
+     ],
+     "queries": []
+    },
     {
      "name": "MkSortableList",
      "description": "Thin convenience wrapper over a single `[mkDropList]` for the common\n\"reorderable list\" case. Bind `items` two-way and provide an `<ng-template>`\nto render each row; drops are applied to the model for you (via\n`mkMoveItemInArray`).\n\nFor connected buckets / kanban, use `[mkDropList]` + `[mkDrag]` directly.\n\nThe list renders as a named `group` of `button` items: pass `label` (or\n`labelledBy` pointing at a visible heading) so screen readers say what is\nbeing reordered — the i18n `sortableListLabel` (\"Sortable list\") is the\nfallback.\n\n```html\n<mk-sortable-list [(items)]=\"rows\" label=\"Steps\">\n  <ng-template let-row let-i=\"index\">\n    <span mkDragHandle aria-hidden=\"true\">⠿</span> {{ i + 1 }}. {{ row.name }}\n  </ng-template>\n</mk-sortable-list>\n```",
@@ -5272,6 +5393,31 @@
        "name": "connectedGroup",
        "signature": "(list: MkDropList<any>): MkDropList<any>[]",
        "description": "The ordered travel group for `list`: `list` itself plus every enabled list\nit is `mkDropListConnectedTo`, in registration (roughly DOM) order. Used to\nresolve \"adjacent\" lists for keyboard column-to-column movement and to\nhit-test the pointer against candidate targets."
+      },
+      {
+       "name": "registerZone",
+       "signature": "(id: string, zone: MkDropZone<any>): void",
+       "description": "Register (or replace) the zone published under `id`."
+      },
+      {
+       "name": "unregisterZone",
+       "signature": "(id: string, zone: MkDropZone<any>): void",
+       "description": "Remove `zone` from the registry if it is still the holder of `id`."
+      },
+      {
+       "name": "getZone",
+       "signature": "(id: string): MkDropZone<any> | undefined",
+       "description": "Look up a zone by its `mkDropZoneId`."
+      },
+      {
+       "name": "connectedZones",
+       "signature": "(list: MkDropList<any>): MkDropZone<any>[]",
+       "description": "Every enabled zone named in `list`'s `mkDropListConnectedTo`, in registration order."
+      },
+      {
+       "name": "travelGroup",
+       "signature": "(list: MkDropList<any>): MkDropTarget[]",
+       "description": "The keyboard travel group for `list`: its connected lists **and** zones,\nin document order, so arrow keys walk targets the way they appear on\nscreen regardless of when each registered."
       }
      ],
      "properties": []
@@ -5333,12 +5479,95 @@
       }
      ]
     },
+    {
+     "name": "MkDropZoneEvent",
+     "description": "Emitted by `[mkDropZone]` (`mkDropZoneDropped`) when an item is released on\nit. Carries the same position fields as `MkDropZoneHover` plus where\nthe item came from — the consumer removes it from that list (or not: a\n\"focus on this\" zone may leave the card where it is).",
+     "file": "projects/mk-kit/dnd/drag-drop.types.ts",
+     "kind": "interface",
+     "typeParams": "<T = unknown, Z = unknown>",
+     "extends": [
+      "MkDropZoneHover<T, Z>"
+     ],
+     "members": [
+      {
+       "name": "previousContainer",
+       "type": "MkDropList<T>",
+       "description": "The list the item came from."
+      },
+      {
+       "name": "previousIndex",
+       "type": "number",
+       "description": "Index of the item within `previousContainer`'s data."
+      }
+     ]
+    },
+    {
+     "name": "MkDropZoneHover",
+     "description": "Where an item is over a `[mkDropZone]`, emitted on enter and on every\npointer frame (`mkDropZoneEntered` / `mkDropZoneMoved`). Keyboard entries\nreport the zone's centre.",
+     "file": "projects/mk-kit/dnd/drag-drop.types.ts",
+     "kind": "interface",
+     "typeParams": "<T = unknown, Z = unknown>",
+     "members": [
+      {
+       "name": "item",
+       "type": "MkDrag<T>",
+       "description": "The `MkDrag` directive instance being dragged."
+      },
+      {
+       "name": "zone",
+       "type": "MkDropZone<Z, any>",
+       "description": "The zone under the pointer."
+      },
+      {
+       "name": "x",
+       "type": "number",
+       "description": "Pointer position in client (viewport) coordinates."
+      },
+      {
+       "name": "y",
+       "type": "number",
+       "description": ""
+      },
+      {
+       "name": "offsetX",
+       "type": "number",
+       "description": "Pointer position relative to the zone's top-left corner, in CSS pixels."
+      },
+      {
+       "name": "offsetY",
+       "type": "number",
+       "description": ""
+      },
+      {
+       "name": "fractionX",
+       "type": "number",
+       "description": "Pointer position as a 0–1 fraction of the zone's width / height (clamped)."
+      },
+      {
+       "name": "fractionY",
+       "type": "number",
+       "description": ""
+      },
+      {
+       "name": "isPointerEvent",
+       "type": "boolean",
+       "description": "`true` for pointer (mouse/touch/pen) hovers, `false` for keyboard steps."
+      }
+     ]
+    },
     {
      "name": "MkDropListOrientation",
      "description": "Layout axis a drop list lays its items along.",
      "file": "projects/mk-kit/dnd/drag-drop.types.ts",
      "kind": "type",
      "definition": "'vertical' | 'horizontal'"
+    },
+    {
+     "name": "MkDropTarget",
+     "description": "A keyboard-reachable drop target: a connected list or a connected zone.",
+     "file": "projects/mk-kit/dnd/drag-drop-registry.ts",
+     "kind": "type",
+     "definition": "MkDropList<any> | MkDropZone<any>"
     }
    ]
   },
@@ -17976,6 +18205,323 @@
     }
    ]
   },
+  {
+   "name": "translate",
+   "import": "@mk-kit/ui/translate",
+   "exports": [
+    {
+     "name": "MkTranslatePipe",
+     "description": "`translate` — the key's string in the active language, with `{{name}}`\nplaceholders filled from `params`. Impure so a language switch (or a\n`patch()`) re-renders every use; the signal reads inside `instant()` mark\nthe host view dirty, so this stays cheap under OnPush and zoneless.\n\n```html\n{{ 'menu.title' | translate }}\n{{ 'cart.items' | translate: { count: 3 } }}\n```",
+     "file": "projects/mk-kit/translate/translate.pipe.ts",
+     "kind": "pipe",
+     "pipeName": "translate",
+     "signature": "(key: string | null | undefined, params?: MkTranslateParams): string"
+    },
+    {
+     "name": "MkTranslatePluralPipe",
+     "description": "`translatePlural` — the CLDR plural form under `keyBase` for a count\n(see `MkTranslate.plural`), interpolated with `{ count, ...params }`.\n\n```html\n{{ guests | translatePlural: 'reservation.guests' }}   <!-- 2 osoby / 5 osób -->\n```",
+     "file": "projects/mk-kit/translate/translate.pipe.ts",
+     "kind": "pipe",
+     "pipeName": "translatePlural",
+     "signature": "(count: number | string | null | undefined, keyBase: string, params?: MkTranslateParams): string"
+    },
+    {
+     "name": "MkTranslate",
+     "description": "App translations as signals: a `lang` you switch with `use()`, `instant()`\nfor code, the `translate` pipe for templates, and `plural()` for CLDR\ncount forms. Dictionaries are the plain nested JSON you already have; an\noptional overrides loader (a database of edits, say) is merged on top per\nlanguage. On the server the loaded strings ride to the browser through\n`TransferState`, so hydration never refetches or flashes raw keys.\n\n```ts\nprovideMkTranslate({\n  lang: 'pl',\n  fallbackLang: 'pl',\n  loader: mkHttpTranslateLoader({ prefix: '/assets/i18n/' }),\n});\n```\n```html\n{{ 'checkout.cart.total' | translate }}\n{{ 'checkout.cart.freeDeliveryMissing' | translate: { amount: 12 } }}\n```",
+     "file": "projects/mk-kit/translate/translate.service.ts",
+     "kind": "service",
+     "providedIn": "root",
+     "methods": [
+      {
+       "name": "getCurrentLang",
+       "signature": "(): string",
+       "description": "The active language as a plain string (for non-reactive call sites)."
+      },
+      {
+       "name": "getLangs",
+       "signature": "(): string[]",
+       "description": "Languages known to the service: loaded ones plus any added with `addLangs`."
+      },
+      {
+       "name": "addLangs",
+       "signature": "(langs: string[]): void",
+       "description": "Declare languages up front (a switcher's list); loading still happens on `use()`."
+      },
+      {
+       "name": "setTranslation",
+       "signature": "(lang: string, strings: MkTranslationTree | MkFlatTranslations, shouldMerge?: boolean): void",
+       "description": "ngx-translate-compatible alias: `setTranslation(lang, strings, true)`\nmerges like `patch`, `false` (the default there) replaces like\n`set`."
+      },
+      {
+       "name": "use",
+       "signature": "(lang: string): Promise<void>",
+       "description": "Load `lang` (once — later calls are cached) and make it active. Resolves\nwhen the strings are in memory; a failed load rejects and leaves the\nprevious language active."
+      },
+      {
+       "name": "load",
+       "signature": "(lang: string): Promise<void>",
+       "description": "Load a language into memory without switching to it."
+      },
+      {
+       "name": "instant",
+       "signature": "(key: string, params?: MkTranslateParams): string",
+       "description": "Translate `key` in the active language, then the fallback; `{{name}}`\nplaceholders come from `params`. A missing key renders as the key\nitself (or whatever `onMissing` returns) and is recorded in\n`missingKeys`. Reactive: reading it inside a template or a\n`computed()` re-runs on language switch and after `patch()`."
+      },
+      {
+       "name": "has",
+       "signature": "(key: string, lang?: string): boolean",
+       "description": "Whether `key` exists in `lang` (default: the active language) or its fallback."
+      },
+      {
+       "name": "plural",
+       "signature": "(keyBase: string, count: number, params?: MkTranslateParams): string",
+       "description": "CLDR plural form: `keyBase.{zero|one|two|few|many|other}` picked with\n`Intl.PluralRules` for the active language, `other` as the fallback,\ninterpolated with `{ count, ...params }`.\n\n```json\n{ \"guests\": { \"one\": \"{{count}} osoba\", \"few\": \"{{count}} osoby\", \"many\": \"{{count}} osób\", \"other\": \"{{count}} osoby\" } }\n```"
+      },
+      {
+       "name": "translations",
+       "signature": "(lang?: string): MkFlatTranslations",
+       "description": "The flat dictionary of `lang` (default: active), `{}` before it loads."
+      },
+      {
+       "name": "loadedLangs",
+       "signature": "(): string[]",
+       "description": "Languages currently in memory."
+      },
+      {
+       "name": "patch",
+       "signature": "(lang: string, strings: MkTranslationTree | MkFlatTranslations): void",
+       "description": "Merge strings into `lang` at runtime — a translation editor previewing\nan edit, or a late-arriving overrides payload. Nested or flat."
+      },
+      {
+       "name": "set",
+       "signature": "(lang: string, strings: MkTranslationTree | MkFlatTranslations): void",
+       "description": "Replace `lang` entirely (tests, editors reloading from source)."
+      },
+      {
+       "name": "isPartial",
+       "signature": "(lang?: string): boolean",
+       "description": "`true` while `lang` holds only a server render's keys and the rest is still loading."
+      }
+     ],
+     "properties": [
+      {
+       "name": "lang",
+       "type": "WritableSignal<string>",
+       "description": "The active language. Read it in a `computed()` to follow switches.",
+       "readonly": true
+      },
+      {
+       "name": "ready",
+       "type": "Signal<boolean>",
+       "description": "`true` once the active language's strings are in memory.",
+       "readonly": true
+      },
+      {
+       "name": "langChange",
+       "type": "Observable<string>",
+       "description": "`lang` as an observable, for code still written around streams.",
+       "readonly": true
+      },
+      {
+       "name": "missingKeys",
+       "type": "Signal<string[]>",
+       "description": "Keys asked for that neither the active nor the fallback language has.",
+       "readonly": true
+      },
+      {
+       "name": "currentLang",
+       "type": "string",
+       "description": "ngx-translate-compatible alias of `getCurrentLang`.",
+       "readonly": true
+      }
+     ],
+     "docs": "/components/translate"
+    },
+    {
+     "name": "mkFlattenTranslations",
+     "description": "`{ a: { b: 'x' } }` → `{ 'a.b': 'x' }`; already-dotted keys pass through.",
+     "file": "projects/mk-kit/translate/translate.service.ts",
+     "kind": "function",
+     "signatures": [
+      "(tree: MkTranslationTree | null | undefined, prefix?: string, out?: MkFlatTranslations): MkFlatTranslations"
+     ]
+    },
+    {
+     "name": "mkHttpTranslateLoader",
+     "description": "Fetch `<prefix><lang><suffix>` with `HttpClient` — the bundled JSON files\nin `assets/i18n/`. Needs `provideHttpClient()`; SSR apps that read the\nfiles from disk can supply their own `MkTranslateLoader` instead.",
+     "file": "projects/mk-kit/translate/translate.loaders.ts",
+     "kind": "function",
+     "signatures": [
+      "(options?: MkHttpTranslateLoaderOptions): MkTranslateLoaderFactory"
+     ]
+    },
+    {
+     "name": "mkInterpolate",
+     "description": "Replace `{{name}}` placeholders; unknown names are left in place.",
+     "file": "projects/mk-kit/translate/translate.service.ts",
+     "kind": "function",
+     "signatures": [
+      "(template: string, params?: MkTranslateParams): string"
+     ]
+    },
+    {
+     "name": "mkStaticTranslateLoader",
+     "description": "Strings given up front, keyed by language — tests, storybooks, tiny apps.\nA language not in the map resolves to `{}`.",
+     "file": "projects/mk-kit/translate/translate.loaders.ts",
+     "kind": "function",
+     "signatures": [
+      "(byLang: Record<string, MkTranslationTree>): MkTranslateLoaderFactory"
+     ]
+    },
+    {
+     "name": "mkUnflattenTranslations",
+     "description": "`{ 'a.b': 'x' }` → `{ a: { b: 'x' } }` — for editors that write files back.",
+     "file": "projects/mk-kit/translate/translate.service.ts",
+     "kind": "function",
+     "signatures": [
+      "(flat: MkFlatTranslations): MkTranslationTree"
+     ]
+    },
+    {
+     "name": "provideMkTranslate",
+     "description": "Register app translations. By default the initial language is loaded\nbefore the first render (`preload`), so no view ever shows raw keys and\nnothing caches them.\n\n```ts\nproviders: [\n  provideHttpClient(withFetch()),\n  provideMkTranslate({\n    lang: 'pl',\n    fallbackLang: 'pl',\n    loader: mkHttpTranslateLoader(),\n    overrides: () => inject(TranslationOverridesApi), // optional\n  }),\n]\n```",
+     "file": "projects/mk-kit/translate/translate.providers.ts",
+     "kind": "function",
+     "signatures": [
+      "(config: MkTranslateConfig): EnvironmentProviders"
+     ]
+    },
+    {
+     "name": "MK_TRANSLATE_CONFIG",
+     "description": "Configuration token; set by `provideMkTranslate`.",
+     "file": "projects/mk-kit/translate/translate.service.ts",
+     "kind": "token",
+     "type": "InjectionToken<MkTranslateConfig>"
+    },
+    {
+     "name": "MkTranslateImports",
+     "description": "Everything a template needs, for `imports: [...MkTranslateImports]` — the\none-line replacement for an ngx-translate `TranslateModule` import.",
+     "file": "projects/mk-kit/translate/translate.pipe.ts",
+     "kind": "const",
+     "type": "readonly [typeof MkTranslatePipe, typeof MkTranslatePluralPipe]"
+    },
+    {
+     "name": "MkHttpTranslateLoaderOptions",
+     "description": "Options for `mkHttpTranslateLoader`.",
+     "file": "projects/mk-kit/translate/translate.loaders.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "prefix",
+       "type": "string | undefined",
+       "description": "URL prefix; the language code is appended. Default `/assets/i18n/`.",
+       "optional": true
+      },
+      {
+       "name": "suffix",
+       "type": "string | undefined",
+       "description": "URL suffix after the language code. Default `.json`.",
+       "optional": true
+      }
+     ]
+    },
+    {
+     "name": "MkTranslateConfig",
+     "description": "Options for `provideMkTranslate`.",
+     "file": "projects/mk-kit/translate/translate.types.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "lang",
+       "type": "string",
+       "description": "Language loaded first and used until `use()` switches it."
+      },
+      {
+       "name": "fallbackLang",
+       "type": "string | undefined",
+       "description": "Looked up when the active language lacks a key. Default: none.",
+       "optional": true
+      },
+      {
+       "name": "loader",
+       "type": "MkTranslateLoaderFactory",
+       "description": "Base strings — the bundled JSON, typically (`mkHttpTranslateLoader`)."
+      },
+      {
+       "name": "overrides",
+       "type": "MkTranslateLoaderFactory | undefined",
+       "description": "Optional second source merged OVER the base per language: edits kept in\na database, a tenant's wording, a translator's work in progress. A\nloader that throws or resolves `{}` leaves the base untouched.",
+       "optional": true
+      },
+      {
+       "name": "preload",
+       "type": "boolean | undefined",
+       "description": "Block application bootstrap until the initial language is loaded, so the\nfirst render never shows raw keys and `instant()` calls inside\n`computed()` never cache them. Default `true`.",
+       "optional": true
+      },
+      {
+       "name": "transfer",
+       "type": "\"none\" | \"used\" | \"all\" | undefined",
+       "description": "What a server render hands to the browser through `TransferState`:\n- `'used'` (default): only the keys read while rendering this page —\n  a few KB — so hydration never flashes raw keys, while the full\n  dictionary loads in the background right after;\n- `'all'`: the whole dictionary (no second request, but every page\n  carries it);\n- `'none'`: nothing; the browser loads the file itself before bootstrap.",
+       "optional": true
+      },
+      {
+       "name": "documentLang",
+       "type": "boolean | undefined",
+       "description": "Mirror the active language onto `<html lang>` (server and browser), so\nscreen readers, hyphenation and search engines follow `use()`. Default\n`true`.",
+       "optional": true
+      },
+      {
+       "name": "onMissing",
+       "type": "((key: string, lang: string) => string | undefined | void) | undefined",
+       "description": "Called for a key missing in both the active and the fallback language.\nReturn a string to render instead of the key. Missing keys are also\ncollected in `MkTranslate.missingKeys`.",
+       "optional": true
+      }
+     ]
+    },
+    {
+     "name": "MkTranslateLoader",
+     "description": "Where a language's strings come from. Return the tree (or a promise of\nit); the service flattens, caches per language and merges overrides.",
+     "file": "projects/mk-kit/translate/translate.types.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "load",
+       "type": "(lang: string): Promise<MkTranslationTree> | MkTranslationTree",
+       "description": ""
+      }
+     ]
+    },
+    {
+     "name": "MkTranslationTree",
+     "description": "A translation file: nested objects of strings. Keys are addressed with\ndots (`checkout.cart.total`), so `{ checkout: { cart: { total: '…' } } }`\nand `{ 'checkout.cart.total': '…' }` are the same dictionary. This is the\nplain JSON most apps already ship (ngx-translate's format included).",
+     "file": "projects/mk-kit/translate/translate.types.ts",
+     "kind": "interface",
+     "members": []
+    },
+    {
+     "name": "MkFlatTranslations",
+     "description": "Flattened dictionary: dotted key → string.",
+     "file": "projects/mk-kit/translate/translate.types.ts",
+     "kind": "type",
+     "definition": "Record<string, string>"
+    },
+    {
+     "name": "MkTranslateLoaderFactory",
+     "description": "A loader factory; runs inside an injection context, so `inject()` works.",
+     "file": "projects/mk-kit/translate/translate.types.ts",
+     "kind": "type",
+     "definition": "() => MkTranslateLoader"
+    },
+    {
+     "name": "MkTranslateParams",
+     "description": "Values interpolated into `{{name}}` placeholders.",
+     "file": "projects/mk-kit/translate/translate.types.ts",
+     "kind": "type",
+     "definition": "Record<string, unknown>"
+    }
+   ]
+  },
   {
    "name": "feedback",
    "import": "@mk-kit/ui/feedback",
@@ -24212,6 +24758,46 @@
      "definition": "| 'Enter' | 'Escape' | 'Tab' | 'Backspace' | 'Delete' | ' ' | 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'PageUp' | 'PageDown'"
     }
    ]
+  },
+  {
+   "name": "translate/server",
+   "import": "@mk-kit/ui/translate/server",
+   "exports": [
+    {
+     "name": "mkFsTranslateLoader",
+     "description": "Server-side loader that reads the translation JSON from disk instead of\nfetching the app's own HTTP endpoint during SSR — no self-request, no\nproxy hop, no interceptor ordering to get right. Register it in the\nserver config only (`app.config.server.ts`); the browser keeps\n`mkHttpTranslateLoader`. Files are parsed once per process.\n\n```ts\n// app.config.server.ts\nprovideMkTranslate({\n  ...browserTranslateConfig,\n  loader: mkFsTranslateLoader({\n    dirs: [join(import.meta.dirname, '../browser/assets/i18n'), join(process.cwd(), 'src/assets/i18n')],\n  }),\n})\n```",
+     "file": "projects/mk-kit/translate/server/fs-loader.ts",
+     "kind": "function",
+     "signatures": [
+      "(options: MkFsTranslateLoaderOptions): MkTranslateLoaderFactory"
+     ]
+    },
+    {
+     "name": "MkFsTranslateLoaderOptions",
+     "description": "Options for `mkFsTranslateLoader`.",
+     "file": "projects/mk-kit/translate/server/fs-loader.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "dirs",
+       "type": "string[]",
+       "description": "Directories searched in order for `<lang><suffix>`; the first readable\nfile wins. Typical: the built browser assets next to the server bundle,\nthen the source tree for `ng serve`."
+      },
+      {
+       "name": "suffix",
+       "type": "string | undefined",
+       "description": "File suffix after the language code. Default `.json`.",
+       "optional": true
+      },
+      {
+       "name": "onNotFound",
+       "type": "\"empty\" | \"throw\" | undefined",
+       "description": "When no directory has the file: return `{}` (default) so the app boots\nwith keys as text, or throw so the failure surfaces at once.",
+       "optional": true
+      }
+     ]
+    }
+   ]
   }
  ]
 }

package/data/llms-full.txt

@@ -1,4 +1,4 @@
-# @mk-kit/ui 0.54.0 — full API reference
+# @mk-kit/ui 0.55.1 — full API reference
 
 Generated from the library sources. Browsable version: https://mk-kit.dev/api · JSON: https://mk-kit.dev/api.json · Guides: https://mk-kit.dev/llms.txt
 
@@ -1129,6 +1129,8 @@ Members:
 | `dndMoved` | `(position: number, total: number) => string` | Announced as the item moves within its list. |
 | `dndMovedToList` | `(list: string, position: number, total: number) => string` | Announced as the item moves into another list. |
 | `dndDropped` | `(position: number) => string` | Announced when the item is dropped. |
+| `dndMovedToZone` | `(zone: string) => string` | Announced as a lifted item reaches a drop zone (a target that is not a list). |
+| `dndDroppedInZone` | `(zone: string) => string` | Announced when the item is dropped on a zone. |
 | `dndCancelled` | `string` | Announced when the drag is cancelled. |
 | `repeaterAddRow` | `string` | Repeater add-row button caption (default when no `addLabel` is given). |
 | `repeaterRemoveRow` | `(index: number) => string` | Repeater per-row remove button label (1-based row number). |
@@ -3186,7 +3188,7 @@ type MkPluralForms = { other: string } & Partial<Record<Intl.LDMLPluralRule, str
 
 ## @mk-kit/ui/dnd
 
-9 exports. `import { … } from '@mk-kit/ui/dnd';`
+13 exports. `import { … } from '@mk-kit/ui/dnd';`
 
 ### MkDrag (component)
 
@@ -3217,6 +3219,12 @@ Keyboard: focus the item (or its handle) and press **Space/Enter** to pick
 it up, **Arrow** keys to move it (crossing into connected lists at the ends /
 across the perpendicular axis), **Space/Enter** to drop, **Escape** to cancel.
 
+Besides lists, an item can be released on a connected `[mkDropZone]` — a
+target that reports *where* it was dropped instead of an index (a timeline,
+a priority band, a "focus on this" pane). Zones sit in the same keyboard
+travel group as lists, in document order; while an item hovers a zone no
+placeholder is shown and the zone streams `mkDropZoneMoved` events.
+
 Touch: a swipe scrolls the page as usual — the drag only arms after a
 long-press (`mkDragTouchDelay`, default 300 ms). While armed the item
 gets the `mk-drag--armed` class so consumers can style the lift moment.
@@ -3325,6 +3333,78 @@ Properties:
 | `role` | `Signal<string \| null>` | The role the host exposes. One set in the template wins. A `<ul>`/`<ol>` keeps its implicit `list` role (`null` — nothing is written) while every item hands the keyboard drag to a focusable handle, and becomes a `listbox` (its items `option`s) otherwise. Any other element is a `group`. |
 | `connectedTo` | `Signal<readonly string[]>` | Connected-list ids, normalised to a plain array. |
 
+### MkDropZone (component)
+
+Selector: `[mkDropZone]` · exportAs: `mkDropZone`
+
+Import: `import { MkDropZone } from '@mk-kit/ui/dnd';`
+
+A drop **target** that is not a list: an item dragged out of a connected
+`[mkDropList]` can be released anywhere on it, and the zone reports *where*
+— client coordinates, the offset inside the zone and the 0–1 fraction along
+each axis — so the consumer can turn a position into meaning: a time on a
+timeline, a priority band, a "focus on this" pane, a trash can.
+
+Nothing reorders and no placeholder is shown while an item hovers a zone;
+the zone gets the `mk-drop-zone--receiving` class and a stream of
+`mkDropZoneMoved` events instead. Zones and lists can overlap — the
+innermost target under the pointer wins, so a column can hold three
+priority bands and still accept plain drops between the bands.
+
+Wire a zone exactly like another list: give it an id and name that id in
+the source list's `mkDropListConnectedTo`.
+
+Keyboard: a lifted item reaches zones with the arrow keys that cross lists
+(Left/Right in a vertical list, Up/Down in a horizontal one) — zones sit in
+the same DOM-ordered travel group as connected lists; Space/Enter drops at
+the zone's centre. Every step is announced.
+
+```html
+<ul mkDropList mkDropListId="backlog" [mkDropListConnectedTo]="['now', 'rail']" …>
+<section mkDropZone mkDropZoneId="now" mkDropZoneLabel="Focus now"
+         (mkDropZoneDropped)="focus($event.item.mkDragData())">
+<div mkDropZone mkDropZoneId="rail" mkDropZoneLabel="Today"
+     (mkDropZoneMoved)="preview($event.fractionY)"
+     (mkDropZoneDropped)="schedule($event.item.mkDragData(), $event.fractionY)">
+```
+
+Inputs:
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| `mkDropZoneId` | `string \| undefined` |  | Stable id source lists name in `mkDropListConnectedTo`. Auto-generated when omitted. |
+| `mkDropZoneLabel` | `string` | `''` | Human-readable name, used in screen-reader announcements when a lifted item reaches the zone ("Moved to Focus now") and as the zone's accessible name. Set it: the fallback is the id, which may be generated gibberish. |
+| `mkDropZoneLabelledBy` | `string` | `''` | Id of a visible element that names the zone (`aria-labelledby`); wins over the label as the accessible name. |
+| `mkDropZoneData` | `Z \| undefined` |  | Arbitrary payload handed back on every hover and drop event. |
+| `mkDropZoneDisabled` | `boolean` | `false` | Disable dropping onto this zone (it leaves the travel group too). |
+
+Outputs:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `mkDropZoneEntered` | `MkDropZoneHover<T, Z>` | An item entered the zone (pointer or keyboard). |
+| `mkDropZoneMoved` | `MkDropZoneHover<T, Z>` | The pointer moved while over the zone (one per frame, pointer only). |
+| `mkDropZoneLeft` | `MkDrag<T>` | The item left the zone without dropping (moved on, or the drag was cancelled). |
+| `mkDropZoneDropped` | `MkDropZoneEvent<T, Z>` | The item was released on the zone. |
+
+Methods:
+
+| Signature | Description |
+| --- | --- |
+| `setReceiving(value: boolean): void` | Toggle the "receiving" highlight (called by the active drag). |
+| `emitEntered(event: MkDropZoneHover<T, Z>): void` | Called by the active `MkDrag` — not part of the consumer API. |
+| `emitMoved(event: MkDropZoneHover<T, Z>): void` |  |
+| `emitLeft(item: MkDrag<T>): void` |  |
+| `emitDrop(event: MkDropZoneEvent<T, Z>): void` |  |
+
+Properties:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `element` | `HTMLElement` | The zone's host element (drop target bounds). |
+| `id` | `Signal<string>` | Resolved id (input or generated). |
+| `label` | `Signal<string>` | Announceable name: the label when set, otherwise the resolved id. |
+
 ### MkSortableList (component)
 
 Selector: `mk-sortable-list`
@@ -3446,6 +3526,11 @@ Methods:
 | `get(id: string): MkDropList<any> \| undefined` | Look up a list by its `mkDropListId`. |
 | `all(): MkDropList<any>[]` | All registered lists, in registration order. |
 | `connectedGroup(list: MkDropList<any>): MkDropList<any>[]` | The ordered travel group for `list`: `list` itself plus every enabled list it is `mkDropListConnectedTo`, in registration (roughly DOM) order. Used to resolve "adjacent" lists for keyboard column-to-column movement and to hit-test the pointer against candidate targets. |
+| `registerZone(id: string, zone: MkDropZone<any>): void` | Register (or replace) the zone published under `id`. |
+| `unregisterZone(id: string, zone: MkDropZone<any>): void` | Remove `zone` from the registry if it is still the holder of `id`. |
+| `getZone(id: string): MkDropZone<any> \| undefined` | Look up a zone by its `mkDropZoneId`. |
+| `connectedZones(list: MkDropList<any>): MkDropZone<any>[]` | Every enabled zone named in `list`'s `mkDropListConnectedTo`, in registration order. |
+| `travelGroup(list: MkDropList<any>): MkDropTarget[]` | The keyboard travel group for `list`: its connected lists **and** zones, in document order, so arrow keys walk targets the way they appear on screen regardless of when each registered. |
 
 ### mkMoveItemInArray (function)
 
@@ -3513,6 +3598,44 @@ Members:
 | `container` | `MkDropList<T>` | The list the item was dropped into (same as `previousContainer` for a re-sort). |
 | `isPointerEvent` | `boolean` | `true` for pointer (mouse/touch/pen) drops, `false` for keyboard drops. |
 
+### MkDropZoneEvent (interface)
+
+Import: `import { MkDropZoneEvent } from '@mk-kit/ui/dnd';`
+
+Emitted by `[mkDropZone]` (`mkDropZoneDropped`) when an item is released on
+it. Carries the same position fields as `MkDropZoneHover` plus where
+the item came from — the consumer removes it from that list (or not: a
+"focus on this" zone may leave the card where it is).
+
+Members (extends `MkDropZoneHover<T, Z>`):
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `previousContainer` | `MkDropList<T>` | The list the item came from. |
+| `previousIndex` | `number` | Index of the item within `previousContainer`'s data. |
+
+### MkDropZoneHover (interface)
+
+Import: `import { MkDropZoneHover } from '@mk-kit/ui/dnd';`
+
+Where an item is over a `[mkDropZone]`, emitted on enter and on every
+pointer frame (`mkDropZoneEntered` / `mkDropZoneMoved`). Keyboard entries
+report the zone's centre.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `item` | `MkDrag<T>` | The `MkDrag` directive instance being dragged. |
+| `zone` | `MkDropZone<Z, any>` | The zone under the pointer. |
+| `x` | `number` | Pointer position in client (viewport) coordinates. |
+| `y` | `number` |  |
+| `offsetX` | `number` | Pointer position relative to the zone's top-left corner, in CSS pixels. |
+| `offsetY` | `number` |  |
+| `fractionX` | `number` | Pointer position as a 0–1 fraction of the zone's width / height (clamped). |
+| `fractionY` | `number` |  |
+| `isPointerEvent` | `boolean` | `true` for pointer (mouse/touch/pen) hovers, `false` for keyboard steps. |
+
 ### MkDropListOrientation (type)
 
 Import: `import { MkDropListOrientation } from '@mk-kit/ui/dnd';`
@@ -3523,6 +3646,16 @@ Layout axis a drop list lays its items along.
 type MkDropListOrientation = 'vertical' | 'horizontal';
 ```
 
+### MkDropTarget (type)
+
+Import: `import { MkDropTarget } from '@mk-kit/ui/dnd';`
+
+A keyboard-reachable drop target: a connected list or a connected zone.
+
+```ts
+type MkDropTarget = MkDropList<any> | MkDropZone<any>;
+```
+
 ## @mk-kit/ui/navigation
 
 37 exports. `import { … } from '@mk-kit/ui/navigation';`
@@ -11917,6 +12050,275 @@ Members:
 | `index` | `number` | Its position in `columns`. |
 | `count` | `number` | `column.cards.length`, for a count badge. |
 
+## @mk-kit/ui/translate
+
+18 exports. `import { … } from '@mk-kit/ui/translate';`
+
+### MkTranslatePipe (pipe)
+
+Pipe name: `translate` · `transform(key: string | null | undefined, params?: MkTranslateParams): string`
+
+Import: `import { MkTranslatePipe } from '@mk-kit/ui/translate';`
+
+`translate` — the key's string in the active language, with `{{name}}`
+placeholders filled from `params`. Impure so a language switch (or a
+`patch()`) re-renders every use; the signal reads inside `instant()` mark
+the host view dirty, so this stays cheap under OnPush and zoneless.
+
+```html
+{{ 'menu.title' | translate }}
+{{ 'cart.items' | translate: { count: 3 } }}
+```
+
+### MkTranslatePluralPipe (pipe)
+
+Pipe name: `translatePlural` · `transform(count: number | string | null | undefined, keyBase: string, params?: MkTranslateParams): string`
+
+Import: `import { MkTranslatePluralPipe } from '@mk-kit/ui/translate';`
+
+`translatePlural` — the CLDR plural form under `keyBase` for a count
+(see `MkTranslate.plural`), interpolated with `{ count, ...params }`.
+
+```html
+{{ guests | translatePlural: 'reservation.guests' }}   <!-- 2 osoby / 5 osób -->
+```
+
+### MkTranslate (service)
+
+Docs: https://mk-kit.dev/components/translate
+
+Import: `import { MkTranslate } from '@mk-kit/ui/translate';`
+
+App translations as signals: a `lang` you switch with `use()`, `instant()`
+for code, the `translate` pipe for templates, and `plural()` for CLDR
+count forms. Dictionaries are the plain nested JSON you already have; an
+optional overrides loader (a database of edits, say) is merged on top per
+language. On the server the loaded strings ride to the browser through
+`TransferState`, so hydration never refetches or flashes raw keys.
+
+```ts
+provideMkTranslate({
+  lang: 'pl',
+  fallbackLang: 'pl',
+  loader: mkHttpTranslateLoader({ prefix: '/assets/i18n/' }),
+});
+```
+```html
+{{ 'checkout.cart.total' | translate }}
+{{ 'checkout.cart.freeDeliveryMissing' | translate: { amount: 12 } }}
+```
+
+Methods:
+
+| Signature | Description |
+| --- | --- |
+| `getCurrentLang(): string` | The active language as a plain string (for non-reactive call sites). |
+| `getLangs(): string[]` | Languages known to the service: loaded ones plus any added with `addLangs`. |
+| `addLangs(langs: string[]): void` | Declare languages up front (a switcher's list); loading still happens on `use()`. |
+| `setTranslation(lang: string, strings: MkTranslationTree \| MkFlatTranslations, shouldMerge?: boolean): void` | ngx-translate-compatible alias: `setTranslation(lang, strings, true)` merges like `patch`, `false` (the default there) replaces like `set`. |
+| `use(lang: string): Promise<void>` | Load `lang` (once — later calls are cached) and make it active. Resolves when the strings are in memory; a failed load rejects and leaves the previous language active. |
+| `load(lang: string): Promise<void>` | Load a language into memory without switching to it. |
+| `instant(key: string, params?: MkTranslateParams): string` | Translate `key` in the active language, then the fallback; `{{name}}` placeholders come from `params`. A missing key renders as the key itself (or whatever `onMissing` returns) and is recorded in `missingKeys`. Reactive: reading it inside a template or a `computed()` re-runs on language switch and after `patch()`. |
+| `has(key: string, lang?: string): boolean` | Whether `key` exists in `lang` (default: the active language) or its fallback. |
+| `plural(keyBase: string, count: number, params?: MkTranslateParams): string` | CLDR plural form: `keyBase.{zero\|one\|two\|few\|many\|other}` picked with `Intl.PluralRules` for the active language, `other` as the fallback, interpolated with `{ count, ...params }`.  ```json { "guests": { "one": "{{count}} osoba", "few": "{{count}} osoby", "many": "{{count}} osób", "other": "{{count}} osoby" } } ``` |
+| `translations(lang?: string): MkFlatTranslations` | The flat dictionary of `lang` (default: active), `{}` before it loads. |
+| `loadedLangs(): string[]` | Languages currently in memory. |
+| `patch(lang: string, strings: MkTranslationTree \| MkFlatTranslations): void` | Merge strings into `lang` at runtime — a translation editor previewing an edit, or a late-arriving overrides payload. Nested or flat. |
+| `set(lang: string, strings: MkTranslationTree \| MkFlatTranslations): void` | Replace `lang` entirely (tests, editors reloading from source). |
+| `isPartial(lang?: string): boolean` | `true` while `lang` holds only a server render's keys and the rest is still loading. |
+
+Properties:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `lang` | `WritableSignal<string>` | The active language. Read it in a `computed()` to follow switches. |
+| `ready` | `Signal<boolean>` | `true` once the active language's strings are in memory. |
+| `langChange` | `Observable<string>` | `lang` as an observable, for code still written around streams. |
+| `missingKeys` | `Signal<string[]>` | Keys asked for that neither the active nor the fallback language has. |
+| `currentLang` | `string` | ngx-translate-compatible alias of `getCurrentLang`. |
+
+### mkFlattenTranslations (function)
+
+Import: `import { mkFlattenTranslations } from '@mk-kit/ui/translate';`
+
+`{ a: { b: 'x' } }` → `{ 'a.b': 'x' }`; already-dotted keys pass through.
+
+```ts
+function mkFlattenTranslations(tree: MkTranslationTree | null | undefined, prefix?: string, out?: MkFlatTranslations): MkFlatTranslations
+```
+
+### mkHttpTranslateLoader (function)
+
+Import: `import { mkHttpTranslateLoader } from '@mk-kit/ui/translate';`
+
+Fetch `<prefix><lang><suffix>` with `HttpClient` — the bundled JSON files
+in `assets/i18n/`. Needs `provideHttpClient()`; SSR apps that read the
+files from disk can supply their own `MkTranslateLoader` instead.
+
+```ts
+function mkHttpTranslateLoader(options?: MkHttpTranslateLoaderOptions): MkTranslateLoaderFactory
+```
+
+### mkInterpolate (function)
+
+Import: `import { mkInterpolate } from '@mk-kit/ui/translate';`
+
+Replace `{{name}}` placeholders; unknown names are left in place.
+
+```ts
+function mkInterpolate(template: string, params?: MkTranslateParams): string
+```
+
+### mkStaticTranslateLoader (function)
+
+Import: `import { mkStaticTranslateLoader } from '@mk-kit/ui/translate';`
+
+Strings given up front, keyed by language — tests, storybooks, tiny apps.
+A language not in the map resolves to `{}`.
+
+```ts
+function mkStaticTranslateLoader(byLang: Record<string, MkTranslationTree>): MkTranslateLoaderFactory
+```
+
+### mkUnflattenTranslations (function)
+
+Import: `import { mkUnflattenTranslations } from '@mk-kit/ui/translate';`
+
+`{ 'a.b': 'x' }` → `{ a: { b: 'x' } }` — for editors that write files back.
+
+```ts
+function mkUnflattenTranslations(flat: MkFlatTranslations): MkTranslationTree
+```
+
+### provideMkTranslate (function)
+
+Import: `import { provideMkTranslate } from '@mk-kit/ui/translate';`
+
+Register app translations. By default the initial language is loaded
+before the first render (`preload`), so no view ever shows raw keys and
+nothing caches them.
+
+```ts
+providers: [
+  provideHttpClient(withFetch()),
+  provideMkTranslate({
+    lang: 'pl',
+    fallbackLang: 'pl',
+    loader: mkHttpTranslateLoader(),
+    overrides: () => inject(TranslationOverridesApi), // optional
+  }),
+]
+```
+
+```ts
+function provideMkTranslate(config: MkTranslateConfig): EnvironmentProviders
+```
+
+### MK_TRANSLATE_CONFIG (token)
+
+Import: `import { MK_TRANSLATE_CONFIG } from '@mk-kit/ui/translate';`
+
+Configuration token; set by `provideMkTranslate`.
+
+```ts
+const MK_TRANSLATE_CONFIG: InjectionToken<MkTranslateConfig>;
+```
+
+### MkTranslateImports (const)
+
+Import: `import { MkTranslateImports } from '@mk-kit/ui/translate';`
+
+Everything a template needs, for `imports: [...MkTranslateImports]` — the
+one-line replacement for an ngx-translate `TranslateModule` import.
+
+```ts
+const MkTranslateImports: readonly [typeof MkTranslatePipe, typeof MkTranslatePluralPipe];
+```
+
+### MkHttpTranslateLoaderOptions (interface)
+
+Import: `import { MkHttpTranslateLoaderOptions } from '@mk-kit/ui/translate';`
+
+Options for `mkHttpTranslateLoader`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `prefix`? | `string \| undefined` | URL prefix; the language code is appended. Default `/assets/i18n/`. |
+| `suffix`? | `string \| undefined` | URL suffix after the language code. Default `.json`. |
+
+### MkTranslateConfig (interface)
+
+Import: `import { MkTranslateConfig } from '@mk-kit/ui/translate';`
+
+Options for `provideMkTranslate`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `lang` | `string` | Language loaded first and used until `use()` switches it. |
+| `fallbackLang`? | `string \| undefined` | Looked up when the active language lacks a key. Default: none. |
+| `loader` | `MkTranslateLoaderFactory` | Base strings — the bundled JSON, typically (`mkHttpTranslateLoader`). |
+| `overrides`? | `MkTranslateLoaderFactory \| undefined` | Optional second source merged OVER the base per language: edits kept in a database, a tenant's wording, a translator's work in progress. A loader that throws or resolves `{}` leaves the base untouched. |
+| `preload`? | `boolean \| undefined` | Block application bootstrap until the initial language is loaded, so the first render never shows raw keys and `instant()` calls inside `computed()` never cache them. Default `true`. |
+| `transfer`? | `"none" \| "used" \| "all" \| undefined` | What a server render hands to the browser through `TransferState`: - `'used'` (default): only the keys read while rendering this page —   a few KB — so hydration never flashes raw keys, while the full   dictionary loads in the background right after; - `'all'`: the whole dictionary (no second request, but every page   carries it); - `'none'`: nothing; the browser loads the file itself before bootstrap. |
+| `documentLang`? | `boolean \| undefined` | Mirror the active language onto `<html lang>` (server and browser), so screen readers, hyphenation and search engines follow `use()`. Default `true`. |
+| `onMissing`? | `((key: string, lang: string) => string \| undefined \| void) \| undefined` | Called for a key missing in both the active and the fallback language. Return a string to render instead of the key. Missing keys are also collected in `MkTranslate.missingKeys`. |
+
+### MkTranslateLoader (interface)
+
+Import: `import { MkTranslateLoader } from '@mk-kit/ui/translate';`
+
+Where a language's strings come from. Return the tree (or a promise of
+it); the service flattens, caches per language and merges overrides.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `load` | `(lang: string): Promise<MkTranslationTree> \| MkTranslationTree` |  |
+
+### MkTranslationTree (interface)
+
+Import: `import { MkTranslationTree } from '@mk-kit/ui/translate';`
+
+A translation file: nested objects of strings. Keys are addressed with
+dots (`checkout.cart.total`), so `{ checkout: { cart: { total: '…' } } }`
+and `{ 'checkout.cart.total': '…' }` are the same dictionary. This is the
+plain JSON most apps already ship (ngx-translate's format included).
+
+### MkFlatTranslations (type)
+
+Import: `import { MkFlatTranslations } from '@mk-kit/ui/translate';`
+
+Flattened dictionary: dotted key → string.
+
+```ts
+type MkFlatTranslations = Record<string, string>;
+```
+
+### MkTranslateLoaderFactory (type)
+
+Import: `import { MkTranslateLoaderFactory } from '@mk-kit/ui/translate';`
+
+A loader factory; runs inside an injection context, so `inject()` works.
+
+```ts
+type MkTranslateLoaderFactory = () => MkTranslateLoader;
+```
+
+### MkTranslateParams (type)
+
+Import: `import { MkTranslateParams } from '@mk-kit/ui/translate';`
+
+Values interpolated into `{{name}}` placeholders.
+
+```ts
+type MkTranslateParams = Record<string, unknown>;
+```
+
 ## @mk-kit/ui/feedback
 
 55 exports. `import { … } from '@mk-kit/ui/feedback';`
@@ -16241,3 +16643,45 @@ Keys accepted by `MkTestElement.sendKeys` besides printable characters.
 ```ts
 type MkTestKey = | 'Enter' | 'Escape' | 'Tab' | 'Backspace' | 'Delete' | ' ' | 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'PageUp' | 'PageDown';
 ```
+
+## @mk-kit/ui/translate/server
+
+2 exports. `import { … } from '@mk-kit/ui/translate/server';`
+
+### mkFsTranslateLoader (function)
+
+Import: `import { mkFsTranslateLoader } from '@mk-kit/ui/translate/server';`
+
+Server-side loader that reads the translation JSON from disk instead of
+fetching the app's own HTTP endpoint during SSR — no self-request, no
+proxy hop, no interceptor ordering to get right. Register it in the
+server config only (`app.config.server.ts`); the browser keeps
+`mkHttpTranslateLoader`. Files are parsed once per process.
+
+```ts
+// app.config.server.ts
+provideMkTranslate({
+  ...browserTranslateConfig,
+  loader: mkFsTranslateLoader({
+    dirs: [join(import.meta.dirname, '../browser/assets/i18n'), join(process.cwd(), 'src/assets/i18n')],
+  }),
+})
+```
+
+```ts
+function mkFsTranslateLoader(options: MkFsTranslateLoaderOptions): MkTranslateLoaderFactory
+```
+
+### MkFsTranslateLoaderOptions (interface)
+
+Import: `import { MkFsTranslateLoaderOptions } from '@mk-kit/ui/translate/server';`
+
+Options for `mkFsTranslateLoader`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `dirs` | `string[]` | Directories searched in order for `<lang><suffix>`; the first readable file wins. Typical: the built browser assets next to the server bundle, then the source tree for `ng serve`. |
+| `suffix`? | `string \| undefined` | File suffix after the language code. Default `.json`. |
+| `onNotFound`? | `"empty" \| "throw" \| undefined` | When no directory has the file: return `{}` (default) so the app boots with keys as text, or throw so the failure surfaces at once. |

package/data/llms.txt

@@ -1,6 +1,6 @@
 # mk-kit
 
-> Themable, accessible Angular 22 component library for admin dashboards and UIs. Signals-based, WCAG 2.1 AA, controlled entirely through CSS variables with light/dark out of the box. — `@mk-kit/ui` 0.54.0. 172 components, 45 directives, 16 services and 145 helper functions across 32 tree-shakeable entry points. MIT licensed, zero runtime dependencies beyond Angular. Standalone components, signals, OnPush, zoneless-ready, SSR-safe, RTL and i18n via `provideMkI18n`.
+> Themable, accessible Angular 22 component library for admin dashboards and UIs. Signals-based, WCAG 2.1 AA, controlled entirely through CSS variables with light/dark out of the box. — `@mk-kit/ui` 0.55.1. 173 components, 45 directives, 17 services and 152 helper functions across 34 tree-shakeable entry points. MIT licensed, zero runtime dependencies beyond Angular. Standalone components, signals, OnPush, zoneless-ready, SSR-safe, RTL and i18n via `provideMkI18n`.
 
 Install with `ng add @mk-kit/ui` (or `npm i @mk-kit/ui` + import `@mk-kit/ui/styles/mk-kit.css`). Import from the group entry points (`@mk-kit/ui/forms`, `@mk-kit/ui/table`, …) so each lazy chunk only carries what it uses; the root `@mk-kit/ui` entry re-exports everything. Every component is standalone: add the class to a component's `imports`. Theme with `--mk-*` CSS custom properties; `MkThemeService` switches light/dark/system and density.
 
@@ -35,6 +35,7 @@ Install with `ng add @mk-kit/ui` (or `npm i @mk-kit/ui` + import `@mk-kit/ui/sty
 - [Sliders & rating](https://mk-kit.dev/components/sliders)
 - [Tooltips & popovers](https://mk-kit.dev/components/popovers)
 - [Dialogs](https://mk-kit.dev/components/dialogs)
+- [Translate](https://mk-kit.dev/components/translate)
 - [Status & notifications](https://mk-kit.dev/components/status)
 - [Proportion & KPI charts](https://mk-kit.dev/components/proportion-charts)
 - [Dashboard example](https://mk-kit.dev/examples/dashboard)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mk-kit/mcp",
-  "version": "0.54.0",
+  "version": "0.55.1",
   "description": "MCP server for @mk-kit/ui — lets AI coding assistants look up every component, directive, service and helper of the mk-kit Angular library (inputs, outputs, methods, import paths, docs links).",
   "license": "MIT",
   "type": "module",