@mk-kit/mcp 0.55.1 → 0.57.0

package/data/api.json

@@ -1,6 +1,6 @@
 {
  "package": "@mk-kit/ui",
- "version": "0.55.1",
+ "version": "0.57.0",
  "site": "https://mk-kit.dev",
  "entries": [
   {
@@ -1507,6 +1507,86 @@
        "type": "string",
        "description": "Empty data table / list."
       },
+      {
+       "name": "translationEditorSearch",
+       "type": "string",
+       "description": "Translation editor (`@mk-kit/ui/translate/editor`)."
+      },
+      {
+       "name": "translationEditorAll",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorOverridden",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorMissing",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorKey",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorReset",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorExport",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorKeys",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "sessionExpiryTitle",
+       "type": "string",
+       "description": "Session-expiry dialog (`@mk-kit/ui/attention`)."
+      },
+      {
+       "name": "sessionExpiryExtend",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "sessionExpiryExtending",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "sessionExpiryLogout",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "sessionExpiryBody",
+       "type": "(countdown: string) => string",
+       "description": ""
+      },
+      {
+       "name": "scannerTitle",
+       "type": "string",
+       "description": "Barcode scanner (`@mk-kit/ui/media/scanner`)."
+      },
+      {
+       "name": "scannerHint",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "scannerCameraError",
+       "type": "string",
+       "description": ""
+      },
       {
        "name": "resultsCount",
        "type": "(count: number) => string",
@@ -18522,6 +18602,314 @@
     }
    ]
   },
+  {
+   "name": "attention",
+   "import": "@mk-kit/ui/attention",
+   "exports": [
+    {
+     "name": "MkSessionExpiryDialog",
+     "description": "Last call before a session ends: counts down and offers to extend.\nReaching zero ends the session, so doing nothing still produces a definite,\nvisible outcome. Opened by `MkSessionExpiry`; usable on its own.",
+     "file": "projects/mk-kit/attention/session-expiry.ts",
+     "kind": "component",
+     "selector": "mk-session-expiry-dialog",
+     "selectors": [
+      "mk-session-expiry-dialog"
+     ],
+     "inputs": [],
+     "outputs": [],
+     "methods": [],
+     "properties": [],
+     "queries": [],
+     "docs": "/components/attention"
+    },
+    {
+     "name": "MkNotificationSound",
+     "description": "Alert sounds for incoming work (orders, messages, tickets) with the\nbrowser's autoplay rules handled: an `AudioContext` stays suspended until a\nuser gesture, so a sound fired by a WebSocket message would be silent. The\ncontext is unlocked when the user enables sound (a click) and lazily on the\nfirst interaction anywhere in the app. The default sound is synthesised\n(a short C–E–G chime) — nothing to ship, no CORS, lowest latency; file\npresets are fetched and decoded once and fall back to the chime when they\nfail. The on/off preference lives in localStorage under a configurable key.\n\n```ts\nprovideMkNotificationSound({ presets: [MK_CHIME_PRESET, { id: 'ding', label: 'Ding', url: '/assets/ding.wav' }] })\nsound.primeOnFirstInteraction();          // at app start\nsound.play(settings.newOrderSound);       // on an event, honours the device mute\nsound.preview('ding');                    // settings page test button\n```",
+     "file": "projects/mk-kit/attention/notification-sound.ts",
+     "kind": "service",
+     "providedIn": "root",
+     "methods": [
+      {
+       "name": "isEnabled",
+       "signature": "(): boolean",
+       "description": "Whether the device has sound on."
+      },
+      {
+       "name": "hasBeenAsked",
+       "signature": "(): boolean",
+       "description": "Whether the user ever answered the \"enable sound?\" question on this device."
+      },
+      {
+       "name": "setEnabled",
+       "signature": "(enabled: boolean): void",
+       "description": "Persist the preference; call from a click so audio unlocks at once."
+      },
+      {
+       "name": "primeOnFirstInteraction",
+       "signature": "(): void",
+       "description": "Arm a one-time listener so the first pointer/key interaction unlocks audio."
+      },
+      {
+       "name": "chime",
+       "signature": "(): void",
+       "description": "The default chime, if the device has sound on."
+      },
+      {
+       "name": "play",
+       "signature": "(soundId: string, customUrl?: string | null): void",
+       "description": "Play the sound configured for an event: a preset id, `custom` (with\n`customUrl`) or `none` (silent). Unknown ids and failed loads fall back\nto the chime. Honours the device mute."
+      },
+      {
+       "name": "preview",
+       "signature": "(soundId: string, customUrl?: string | null): void",
+       "description": "Same as `play()` but ignores the device mute — for settings test buttons."
+      }
+     ],
+     "properties": [
+      {
+       "name": "presets",
+       "type": "MkSoundPreset[]",
+       "description": "The selectable presets (always includes the chime).",
+       "readonly": true
+      }
+     ],
+     "docs": "/components/attention"
+    },
+    {
+     "name": "MkSessionExpiry",
+     "description": "Watches `expiresAt()` and warns BEFORE the session lapses, so a session\nnever ends silently: the dialog offers to extend, or signs out at zero.\nRe-arms itself whenever `expiresAt()` changes (every token rotation),\nruns the timer outside the Angular zone and only in the browser. Started\nautomatically by `provideMkSessionExpiry`.",
+     "file": "projects/mk-kit/attention/session-expiry.ts",
+     "kind": "service",
+     "providedIn": "root",
+     "methods": [
+      {
+       "name": "start",
+       "signature": "(): void",
+       "description": "Begin watching. Idempotent; called by the provider's initializer."
+      }
+     ],
+     "properties": [
+      {
+       "name": "open",
+       "type": "WritableSignal<boolean>",
+       "description": "Whether the dialog is currently open.",
+       "readonly": true
+      }
+     ],
+     "docs": "/components/attention"
+    },
+    {
+     "name": "MkTabAttention",
+     "description": "Messenger-style tab attention: while unhandled work exists the favicon\ncarries a red counter badge, and — only while the tab is hidden — the\ntitle alternates with \"(N) label\" so a pinned tab flashes in the tab strip.\nFocusing the tab stops the blinking (someone is looking) but keeps the\nbadge until the count reaches zero. SSR-safe: every entry point bails\nwithout a `document`; the blink timer runs outside the Angular zone.\n\n```ts\nprivate attention = inject(MkTabAttention);\neffect(() => this.attention.set(this.pending().length, 'new orders'));\n```",
+     "file": "projects/mk-kit/attention/tab-attention.ts",
+     "kind": "service",
+     "providedIn": "root",
+     "methods": [
+      {
+       "name": "set",
+       "signature": "(count: number, label?: string): void",
+       "description": "Update the pending count and the label used in the blinking title."
+      },
+      {
+       "name": "clear",
+       "signature": "(): void",
+       "description": "Drop the badge and the blinking entirely and stop listening."
+      }
+     ],
+     "properties": [
+      {
+       "name": "count",
+       "type": "WritableSignal<number>",
+       "description": "The count currently shown (0 = nothing pending).",
+       "readonly": true
+      }
+     ],
+     "docs": "/components/attention"
+    },
+    {
+     "name": "provideMkNotificationSound",
+     "description": "Register presets / storage key for `MkNotificationSound`. Optional.",
+     "file": "projects/mk-kit/attention/notification-sound.ts",
+     "kind": "function",
+     "signatures": [
+      "(config: MkNotificationSoundConfig): { provide: InjectionToken<MkNotificationSoundConfig>; useValue: MkNotificationSoundConfig; }"
+     ]
+    },
+    {
+     "name": "provideMkSessionExpiry",
+     "description": "Register the session-expiry watcher; it starts with the application.\n\n```ts\nprovideMkSessionExpiry({\n  expiresAt: () => auth.tokenExpiresAt(),\n  extend: () => firstValueFrom(auth.refresh()),\n  onExpire: () => auth.logout(),\n  warnBeforeMs: 2 * 60_000,\n})\n```",
+     "file": "projects/mk-kit/attention/session-expiry.ts",
+     "kind": "function",
+     "signatures": [
+      "(config: MkSessionExpiryConfig): EnvironmentProviders"
+     ]
+    },
+    {
+     "name": "provideMkTabAttention",
+     "description": "Register options for `MkTabAttention`. Optional — the defaults work.",
+     "file": "projects/mk-kit/attention/tab-attention.ts",
+     "kind": "function",
+     "signatures": [
+      "(config: MkTabAttentionConfig): { provide: InjectionToken<MkTabAttentionConfig>; useValue: MkTabAttentionConfig; }"
+     ]
+    },
+    {
+     "name": "MK_NOTIFICATION_SOUND_CONFIG",
+     "description": "",
+     "file": "projects/mk-kit/attention/notification-sound.ts",
+     "kind": "token",
+     "type": "InjectionToken<MkNotificationSoundConfig>"
+    },
+    {
+     "name": "MK_SESSION_EXPIRY_CONFIG",
+     "description": "",
+     "file": "projects/mk-kit/attention/session-expiry.ts",
+     "kind": "token",
+     "type": "InjectionToken<MkSessionExpiryConfig>"
+    },
+    {
+     "name": "MK_TAB_ATTENTION_CONFIG",
+     "description": "",
+     "file": "projects/mk-kit/attention/tab-attention.ts",
+     "kind": "token",
+     "type": "InjectionToken<MkTabAttentionConfig>"
+    },
+    {
+     "name": "MK_CHIME_PRESET",
+     "description": "The always-available synthesised sound.",
+     "file": "projects/mk-kit/attention/notification-sound.ts",
+     "kind": "const",
+     "type": "MkSoundPreset"
+    },
+    {
+     "name": "MkNotificationSoundConfig",
+     "description": "Options for `MkNotificationSound`.",
+     "file": "projects/mk-kit/attention/notification-sound.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "presets",
+       "type": "MkSoundPreset[] | undefined",
+       "description": "Selectable sounds; the ids `custom` and `none` are reserved. Default: the chime only.",
+       "optional": true
+      },
+      {
+       "name": "storageKey",
+       "type": "(() => string) | undefined",
+       "description": "localStorage key for the on/off preference — a function so it can vary per tenant / user.",
+       "optional": true
+      },
+      {
+       "name": "volume",
+       "type": "number | undefined",
+       "description": "Output gain for file presets (0–1). Default `0.8`.",
+       "optional": true
+      }
+     ]
+    },
+    {
+     "name": "MkSessionExpiryConfig",
+     "description": "Options for `provideMkSessionExpiry`.",
+     "file": "projects/mk-kit/attention/session-expiry.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "expiresAt",
+       "type": "() => number | null",
+       "description": "Epoch ms when the session lapses, or `null` when there is none. Read reactively."
+      },
+      {
+       "name": "warnBeforeMs",
+       "type": "number | undefined",
+       "description": "How long before the lapse the dialog appears. Default 2 minutes.",
+       "optional": true
+      },
+      {
+       "name": "extend",
+       "type": "() => Promise<unknown>",
+       "description": "Extend the session (refresh the token). Resolve = extended, reject = nothing to extend."
+      },
+      {
+       "name": "onExpire",
+       "type": "() => void",
+       "description": "End the session (sign out, navigate)."
+      },
+      {
+       "name": "enabled",
+       "type": "(() => boolean) | undefined",
+       "description": "Read reactively; `false` suspends the watcher (a kiosk / PIN mode, say).",
+       "optional": true
+      }
+     ]
+    },
+    {
+     "name": "MkSessionExpiryDialogData",
+     "description": "Data handed to `MkSessionExpiryDialog`.",
+     "file": "projects/mk-kit/attention/session-expiry.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "expiresAt",
+       "type": "number",
+       "description": ""
+      },
+      {
+       "name": "extend",
+       "type": "() => Promise<unknown>",
+       "description": ""
+      },
+      {
+       "name": "onExpire",
+       "type": "() => void",
+       "description": ""
+      }
+     ]
+    },
+    {
+     "name": "MkSoundPreset",
+     "description": "One selectable alert sound. `url: null` = the synthesised chime.",
+     "file": "projects/mk-kit/attention/notification-sound.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "id",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "label",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "url",
+       "type": "string | null",
+       "description": ""
+      }
+     ]
+    },
+    {
+     "name": "MkTabAttentionConfig",
+     "description": "Options for `MkTabAttention`, set with `provideMkTabAttention`.",
+     "file": "projects/mk-kit/attention/tab-attention.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "badgeColor",
+       "type": "string | undefined",
+       "description": "Badge fill colour (any CSS colour). Default `#e53935`.",
+       "optional": true
+      },
+      {
+       "name": "blinkMs",
+       "type": "number | undefined",
+       "description": "Title blink period in ms while the tab is hidden. Default `1200`.",
+       "optional": true
+      }
+     ]
+    }
+   ]
+  },
   {
    "name": "feedback",
    "import": "@mk-kit/ui/feedback",
@@ -23812,6 +24200,120 @@
     }
    ]
   },
+  {
+   "name": "media/scanner",
+   "import": "@mk-kit/ui/media/scanner",
+   "exports": [
+    {
+     "name": "MkBarcodeScanner",
+     "description": "Camera barcode / QR reader. Starts the rear camera when it appears, emits\n`scanned` once with the first decoded text and stops. The decoder\n(`html5-qrcode`, an optional peer dependency) is loaded on demand, so pages\nthat only *offer* scanning ship nothing extra until a scan starts. Use\ninline, or through `MkBarcodeScannerDialog`.\n\n```html\n<mk-barcode-scanner (scanned)=\"onCode($event)\" (failed)=\"show($event)\" />\n```",
+     "file": "projects/mk-kit/media/scanner/barcode-scanner.ts",
+     "kind": "component",
+     "selector": "mk-barcode-scanner",
+     "selectors": [
+      "mk-barcode-scanner"
+     ],
+     "inputs": [
+      {
+       "name": "formats",
+       "type": "MkBarcodeFormat[]",
+       "description": "Symbologies to decode. Default: QR + the retail 1-D codes.",
+       "default": "MK_BARCODE_DEFAULT_FORMATS"
+      },
+      {
+       "name": "fps",
+       "type": "number",
+       "description": "Frames per second offered to the decoder. Default 10.",
+       "default": "10"
+      },
+      {
+       "name": "hint",
+       "type": "boolean",
+       "description": "Show the built-in hint line above the viewfinder. Default `true`.",
+       "default": "true"
+      },
+      {
+       "name": "continuous",
+       "type": "boolean",
+       "description": "Keep scanning after a hit instead of stopping. Default `false`.",
+       "default": "false"
+      }
+     ],
+     "outputs": [
+      {
+       "name": "scanned",
+       "type": "string",
+       "description": "Decoded text."
+      },
+      {
+       "name": "failed",
+       "type": "string",
+       "description": "The camera could not start (permission, no device, insecure context)."
+      }
+     ],
+     "methods": [
+      {
+       "name": "stop",
+       "signature": "(): Promise<void>",
+       "description": "Stop the camera and release it. Safe to call twice."
+      }
+     ],
+     "properties": [],
+     "queries": [],
+     "docs": "/components/images"
+    },
+    {
+     "name": "MkBarcodeScannerDialog",
+     "description": "The scanner in a dialog: resolves with the decoded text, or `null` when\ncancelled. Open it with `MkDialogService`:\n\n```ts\nconst code = await dialog.open<MkBarcodeScannerDialog, string | null>(MkBarcodeScannerDialog, { size: 'sm' }).afterClosed;\nif (code) this.search.setValue(code);\n```",
+     "file": "projects/mk-kit/media/scanner/barcode-scanner-dialog.ts",
+     "kind": "component",
+     "selector": "mk-barcode-scanner-dialog",
+     "selectors": [
+      "mk-barcode-scanner-dialog"
+     ],
+     "inputs": [],
+     "outputs": [],
+     "methods": [],
+     "properties": [],
+     "queries": [],
+     "docs": "/components/images"
+    },
+    {
+     "name": "MK_BARCODE_DEFAULT_FORMATS",
+     "description": "",
+     "file": "projects/mk-kit/media/scanner/barcode-scanner.ts",
+     "kind": "const",
+     "type": "MkBarcodeFormat[]"
+    },
+    {
+     "name": "MkBarcodeScannerDialogData",
+     "description": "Optional data for `MkBarcodeScannerDialog`.",
+     "file": "projects/mk-kit/media/scanner/barcode-scanner-dialog.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "title",
+       "type": "string | undefined",
+       "description": "",
+       "optional": true
+      },
+      {
+       "name": "formats",
+       "type": "MkBarcodeFormat[] | undefined",
+       "description": "",
+       "optional": true
+      }
+     ]
+    },
+    {
+     "name": "MkBarcodeFormat",
+     "description": "Symbologies the scanner reads; names follow `Html5QrcodeSupportedFormats`.",
+     "file": "projects/mk-kit/media/scanner/barcode-scanner.ts",
+     "kind": "type",
+     "definition": "| 'QR_CODE' | 'EAN_13' | 'EAN_8' | 'CODE_128' | 'CODE_39' | 'UPC_A' | 'UPC_E' | 'DATA_MATRIX' | 'ITF' | 'CODABAR'"
+    }
+   ]
+  },
   {
    "name": "testing",
    "import": "@mk-kit/ui/testing",
@@ -24759,6 +25261,106 @@
     }
    ]
   },
+  {
+   "name": "translate/editor",
+   "import": "@mk-kit/ui/translate/editor",
+   "exports": [
+    {
+     "name": "MkTranslationEditor",
+     "description": "Translation editor — keys as rows, locales as columns, click a cell to\nedit. The base strings are your bundled files; edits are **overrides**\nkept apart from them, so a rebuild never loses them and a cell can be\nrestored to the file text. Search by key or text, filter to the keys a\nlocale is missing or the ones already edited, export the grid as CSV.\nPersistence is yours: every edit is emitted as `changed`, feed the result\nback through `overrides`.\n\n```html\n<mk-translation-editor\n  [locales]=\"['pl', 'en', 'ru']\"\n  [base]=\"base()\"\n  [overrides]=\"overrides()\"\n  (changed)=\"save($event)\" />\n```",
+     "file": "projects/mk-kit/translate/editor/translation-editor.ts",
+     "kind": "component",
+     "selector": "mk-translation-editor",
+     "selectors": [
+      "mk-translation-editor"
+     ],
+     "inputs": [
+      {
+       "name": "locales",
+       "type": "string[]",
+       "description": "Locale codes, in column order. The first one is the reference language.",
+       "required": true
+      },
+      {
+       "name": "base",
+       "type": "Record<string, MkFlatTranslations>",
+       "description": "Bundled strings per locale, flat (`'a.b.c': 'text'`) or nested.",
+       "required": true
+      },
+      {
+       "name": "overrides",
+       "type": "Record<string, MkFlatTranslations>",
+       "description": "Edits per locale, flat. Missing locales are fine.",
+       "default": "{}"
+      },
+      {
+       "name": "readonly",
+       "type": "boolean",
+       "description": "Show but do not edit.",
+       "default": "false"
+      },
+      {
+       "name": "exportFilename",
+       "type": "string",
+       "description": "File name of the CSV export.",
+       "default": "'translations.csv'"
+      }
+     ],
+     "outputs": [
+      {
+       "name": "changed",
+       "type": "MkTranslationChange",
+       "description": "An edit or a restore; persist it and update `overrides`."
+      }
+     ],
+     "methods": [],
+     "properties": [],
+     "queries": [],
+     "docs": "/components/translate"
+    },
+    {
+     "name": "MkTranslationChange",
+     "description": "One edit made in the editor. `value: null` clears the override.",
+     "file": "projects/mk-kit/translate/editor/translation-editor.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "locale",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "key",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "value",
+       "type": "string | null",
+       "description": ""
+      },
+      {
+       "name": "previous",
+       "type": "string | null",
+       "description": "The text shown before the edit (override, or the base string)."
+      }
+     ]
+    },
+    {
+     "name": "MkTranslationRow",
+     "description": "A row of the editor: the key plus the effective text per locale.",
+     "file": "projects/mk-kit/translate/editor/translation-editor.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "key",
+       "type": "string",
+       "description": ""
+      }
+     ]
+    }
+   ]
+  },
   {
    "name": "translate/server",
    "import": "@mk-kit/ui/translate/server",

package/data/llms-full.txt

@@ -1,4 +1,4 @@
-# @mk-kit/ui 0.55.1 — full API reference
+# @mk-kit/ui 0.57.0 — 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
 
@@ -903,6 +903,22 @@ Members:
 | `noOptions` | `string` | Empty listbox with no options (select, time picker). |
 | `noResults` | `string` | Empty async/filtered results (autocomplete, multi-select, command palette). |
 | `noData` | `string` | Empty data table / list. |
+| `translationEditorSearch` | `string` | Translation editor (`@mk-kit/ui/translate/editor`). |
+| `translationEditorAll` | `string` |  |
+| `translationEditorOverridden` | `string` |  |
+| `translationEditorMissing` | `string` |  |
+| `translationEditorKey` | `string` |  |
+| `translationEditorReset` | `string` |  |
+| `translationEditorExport` | `string` |  |
+| `translationEditorKeys` | `string` |  |
+| `sessionExpiryTitle` | `string` | Session-expiry dialog (`@mk-kit/ui/attention`). |
+| `sessionExpiryExtend` | `string` |  |
+| `sessionExpiryExtending` | `string` |  |
+| `sessionExpiryLogout` | `string` |  |
+| `sessionExpiryBody` | `(countdown: string) => string` |  |
+| `scannerTitle` | `string` | Barcode scanner (`@mk-kit/ui/media/scanner`). |
+| `scannerHint` | `string` |  |
+| `scannerCameraError` | `string` |  |
 | `resultsCount` | `(count: number) => string` | Announced when a filterable list updates (autocomplete, multi-select, command palette). |
 | `previousPage` | `string` | Pagination: previous page control. |
 | `nextPage` | `string` | Pagination: next page control. |
@@ -12319,6 +12335,261 @@ Values interpolated into `{{name}}` placeholders.
 type MkTranslateParams = Record<string, unknown>;
 ```
 
+## @mk-kit/ui/attention
+
+16 exports. `import { … } from '@mk-kit/ui/attention';`
+
+### MkSessionExpiryDialog (component)
+
+Selector: `mk-session-expiry-dialog`
+
+Docs: https://mk-kit.dev/components/attention
+
+Import: `import { MkSessionExpiryDialog } from '@mk-kit/ui/attention';`
+
+Last call before a session ends: counts down and offers to extend.
+Reaching zero ends the session, so doing nothing still produces a definite,
+visible outcome. Opened by `MkSessionExpiry`; usable on its own.
+
+### MkNotificationSound (service)
+
+Docs: https://mk-kit.dev/components/attention
+
+Import: `import { MkNotificationSound } from '@mk-kit/ui/attention';`
+
+Alert sounds for incoming work (orders, messages, tickets) with the
+browser's autoplay rules handled: an `AudioContext` stays suspended until a
+user gesture, so a sound fired by a WebSocket message would be silent. The
+context is unlocked when the user enables sound (a click) and lazily on the
+first interaction anywhere in the app. The default sound is synthesised
+(a short C–E–G chime) — nothing to ship, no CORS, lowest latency; file
+presets are fetched and decoded once and fall back to the chime when they
+fail. The on/off preference lives in localStorage under a configurable key.
+
+```ts
+provideMkNotificationSound({ presets: [MK_CHIME_PRESET, { id: 'ding', label: 'Ding', url: '/assets/ding.wav' }] })
+sound.primeOnFirstInteraction();          // at app start
+sound.play(settings.newOrderSound);       // on an event, honours the device mute
+sound.preview('ding');                    // settings page test button
+```
+
+Methods:
+
+| Signature | Description |
+| --- | --- |
+| `isEnabled(): boolean` | Whether the device has sound on. |
+| `hasBeenAsked(): boolean` | Whether the user ever answered the "enable sound?" question on this device. |
+| `setEnabled(enabled: boolean): void` | Persist the preference; call from a click so audio unlocks at once. |
+| `primeOnFirstInteraction(): void` | Arm a one-time listener so the first pointer/key interaction unlocks audio. |
+| `chime(): void` | The default chime, if the device has sound on. |
+| `play(soundId: string, customUrl?: string \| null): void` | Play the sound configured for an event: a preset id, `custom` (with `customUrl`) or `none` (silent). Unknown ids and failed loads fall back to the chime. Honours the device mute. |
+| `preview(soundId: string, customUrl?: string \| null): void` | Same as `play()` but ignores the device mute — for settings test buttons. |
+
+Properties:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `presets` | `MkSoundPreset[]` | The selectable presets (always includes the chime). |
+
+### MkSessionExpiry (service)
+
+Docs: https://mk-kit.dev/components/attention
+
+Import: `import { MkSessionExpiry } from '@mk-kit/ui/attention';`
+
+Watches `expiresAt()` and warns BEFORE the session lapses, so a session
+never ends silently: the dialog offers to extend, or signs out at zero.
+Re-arms itself whenever `expiresAt()` changes (every token rotation),
+runs the timer outside the Angular zone and only in the browser. Started
+automatically by `provideMkSessionExpiry`.
+
+Methods:
+
+| Signature | Description |
+| --- | --- |
+| `start(): void` | Begin watching. Idempotent; called by the provider's initializer. |
+
+Properties:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `open` | `WritableSignal<boolean>` | Whether the dialog is currently open. |
+
+### MkTabAttention (service)
+
+Docs: https://mk-kit.dev/components/attention
+
+Import: `import { MkTabAttention } from '@mk-kit/ui/attention';`
+
+Messenger-style tab attention: while unhandled work exists the favicon
+carries a red counter badge, and — only while the tab is hidden — the
+title alternates with "(N) label" so a pinned tab flashes in the tab strip.
+Focusing the tab stops the blinking (someone is looking) but keeps the
+badge until the count reaches zero. SSR-safe: every entry point bails
+without a `document`; the blink timer runs outside the Angular zone.
+
+```ts
+private attention = inject(MkTabAttention);
+effect(() => this.attention.set(this.pending().length, 'new orders'));
+```
+
+Methods:
+
+| Signature | Description |
+| --- | --- |
+| `set(count: number, label?: string): void` | Update the pending count and the label used in the blinking title. |
+| `clear(): void` | Drop the badge and the blinking entirely and stop listening. |
+
+Properties:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `count` | `WritableSignal<number>` | The count currently shown (0 = nothing pending). |
+
+### provideMkNotificationSound (function)
+
+Import: `import { provideMkNotificationSound } from '@mk-kit/ui/attention';`
+
+Register presets / storage key for `MkNotificationSound`. Optional.
+
+```ts
+function provideMkNotificationSound(config: MkNotificationSoundConfig): { provide: InjectionToken<MkNotificationSoundConfig>; useValue: MkNotificationSoundConfig; }
+```
+
+### provideMkSessionExpiry (function)
+
+Import: `import { provideMkSessionExpiry } from '@mk-kit/ui/attention';`
+
+Register the session-expiry watcher; it starts with the application.
+
+```ts
+provideMkSessionExpiry({
+  expiresAt: () => auth.tokenExpiresAt(),
+  extend: () => firstValueFrom(auth.refresh()),
+  onExpire: () => auth.logout(),
+  warnBeforeMs: 2 * 60_000,
+})
+```
+
+```ts
+function provideMkSessionExpiry(config: MkSessionExpiryConfig): EnvironmentProviders
+```
+
+### provideMkTabAttention (function)
+
+Import: `import { provideMkTabAttention } from '@mk-kit/ui/attention';`
+
+Register options for `MkTabAttention`. Optional — the defaults work.
+
+```ts
+function provideMkTabAttention(config: MkTabAttentionConfig): { provide: InjectionToken<MkTabAttentionConfig>; useValue: MkTabAttentionConfig; }
+```
+
+### MK_NOTIFICATION_SOUND_CONFIG (token)
+
+Import: `import { MK_NOTIFICATION_SOUND_CONFIG } from '@mk-kit/ui/attention';`
+
+```ts
+const MK_NOTIFICATION_SOUND_CONFIG: InjectionToken<MkNotificationSoundConfig>;
+```
+
+### MK_SESSION_EXPIRY_CONFIG (token)
+
+Import: `import { MK_SESSION_EXPIRY_CONFIG } from '@mk-kit/ui/attention';`
+
+```ts
+const MK_SESSION_EXPIRY_CONFIG: InjectionToken<MkSessionExpiryConfig>;
+```
+
+### MK_TAB_ATTENTION_CONFIG (token)
+
+Import: `import { MK_TAB_ATTENTION_CONFIG } from '@mk-kit/ui/attention';`
+
+```ts
+const MK_TAB_ATTENTION_CONFIG: InjectionToken<MkTabAttentionConfig>;
+```
+
+### MK_CHIME_PRESET (const)
+
+Import: `import { MK_CHIME_PRESET } from '@mk-kit/ui/attention';`
+
+The always-available synthesised sound.
+
+```ts
+const MK_CHIME_PRESET: MkSoundPreset;
+```
+
+### MkNotificationSoundConfig (interface)
+
+Import: `import { MkNotificationSoundConfig } from '@mk-kit/ui/attention';`
+
+Options for `MkNotificationSound`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `presets`? | `MkSoundPreset[] \| undefined` | Selectable sounds; the ids `custom` and `none` are reserved. Default: the chime only. |
+| `storageKey`? | `(() => string) \| undefined` | localStorage key for the on/off preference — a function so it can vary per tenant / user. |
+| `volume`? | `number \| undefined` | Output gain for file presets (0–1). Default `0.8`. |
+
+### MkSessionExpiryConfig (interface)
+
+Import: `import { MkSessionExpiryConfig } from '@mk-kit/ui/attention';`
+
+Options for `provideMkSessionExpiry`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `expiresAt` | `() => number \| null` | Epoch ms when the session lapses, or `null` when there is none. Read reactively. |
+| `warnBeforeMs`? | `number \| undefined` | How long before the lapse the dialog appears. Default 2 minutes. |
+| `extend` | `() => Promise<unknown>` | Extend the session (refresh the token). Resolve = extended, reject = nothing to extend. |
+| `onExpire` | `() => void` | End the session (sign out, navigate). |
+| `enabled`? | `(() => boolean) \| undefined` | Read reactively; `false` suspends the watcher (a kiosk / PIN mode, say). |
+
+### MkSessionExpiryDialogData (interface)
+
+Import: `import { MkSessionExpiryDialogData } from '@mk-kit/ui/attention';`
+
+Data handed to `MkSessionExpiryDialog`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `expiresAt` | `number` |  |
+| `extend` | `() => Promise<unknown>` |  |
+| `onExpire` | `() => void` |  |
+
+### MkSoundPreset (interface)
+
+Import: `import { MkSoundPreset } from '@mk-kit/ui/attention';`
+
+One selectable alert sound. `url: null` = the synthesised chime.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `id` | `string` |  |
+| `label` | `string` |  |
+| `url` | `string \| null` |  |
+
+### MkTabAttentionConfig (interface)
+
+Import: `import { MkTabAttentionConfig } from '@mk-kit/ui/attention';`
+
+Options for `MkTabAttention`, set with `provideMkTabAttention`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `badgeColor`? | `string \| undefined` | Badge fill colour (any CSS colour). Default `#e53935`. |
+| `blinkMs`? | `number \| undefined` | Title blink period in ms while the tab is hidden. Default `1200`. |
+
 ## @mk-kit/ui/feedback
 
 55 exports. `import { … } from '@mk-kit/ui/feedback';`
@@ -16235,6 +16506,97 @@ Ukrainian validation messages rendered by `mk-form-field`.
 const MK_UK_VALIDATION: MkValidationStrings;
 ```
 
+## @mk-kit/ui/media/scanner
+
+5 exports. `import { … } from '@mk-kit/ui/media/scanner';`
+
+### MkBarcodeScanner (component)
+
+Selector: `mk-barcode-scanner`
+
+Docs: https://mk-kit.dev/components/images
+
+Import: `import { MkBarcodeScanner } from '@mk-kit/ui/media/scanner';`
+
+Camera barcode / QR reader. Starts the rear camera when it appears, emits
+`scanned` once with the first decoded text and stops. The decoder
+(`html5-qrcode`, an optional peer dependency) is loaded on demand, so pages
+that only *offer* scanning ship nothing extra until a scan starts. Use
+inline, or through `MkBarcodeScannerDialog`.
+
+```html
+<mk-barcode-scanner (scanned)="onCode($event)" (failed)="show($event)" />
+```
+
+Inputs:
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| `formats` | `MkBarcodeFormat[]` | `MK_BARCODE_DEFAULT_FORMATS` | Symbologies to decode. Default: QR + the retail 1-D codes. |
+| `fps` | `number` | `10` | Frames per second offered to the decoder. Default 10. |
+| `hint` | `boolean` | `true` | Show the built-in hint line above the viewfinder. Default `true`. |
+| `continuous` | `boolean` | `false` | Keep scanning after a hit instead of stopping. Default `false`. |
+
+Outputs:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `scanned` | `string` | Decoded text. |
+| `failed` | `string` | The camera could not start (permission, no device, insecure context). |
+
+Methods:
+
+| Signature | Description |
+| --- | --- |
+| `stop(): Promise<void>` | Stop the camera and release it. Safe to call twice. |
+
+### MkBarcodeScannerDialog (component)
+
+Selector: `mk-barcode-scanner-dialog`
+
+Docs: https://mk-kit.dev/components/images
+
+Import: `import { MkBarcodeScannerDialog } from '@mk-kit/ui/media/scanner';`
+
+The scanner in a dialog: resolves with the decoded text, or `null` when
+cancelled. Open it with `MkDialogService`:
+
+```ts
+const code = await dialog.open<MkBarcodeScannerDialog, string | null>(MkBarcodeScannerDialog, { size: 'sm' }).afterClosed;
+if (code) this.search.setValue(code);
+```
+
+### MK_BARCODE_DEFAULT_FORMATS (const)
+
+Import: `import { MK_BARCODE_DEFAULT_FORMATS } from '@mk-kit/ui/media/scanner';`
+
+```ts
+const MK_BARCODE_DEFAULT_FORMATS: MkBarcodeFormat[];
+```
+
+### MkBarcodeScannerDialogData (interface)
+
+Import: `import { MkBarcodeScannerDialogData } from '@mk-kit/ui/media/scanner';`
+
+Optional data for `MkBarcodeScannerDialog`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `title`? | `string \| undefined` |  |
+| `formats`? | `MkBarcodeFormat[] \| undefined` |  |
+
+### MkBarcodeFormat (type)
+
+Import: `import { MkBarcodeFormat } from '@mk-kit/ui/media/scanner';`
+
+Symbologies the scanner reads; names follow `Html5QrcodeSupportedFormats`.
+
+```ts
+type MkBarcodeFormat = | 'QR_CODE' | 'EAN_13' | 'EAN_8' | 'CODE_128' | 'CODE_39' | 'UPC_A' | 'UPC_E' | 'DATA_MATRIX' | 'ITF' | 'CODABAR';
+```
+
 ## @mk-kit/ui/testing
 
 23 exports. `import { … } from '@mk-kit/ui/testing';`
@@ -16644,6 +17006,77 @@ Keys accepted by `MkTestElement.sendKeys` besides printable characters.
 type MkTestKey = | 'Enter' | 'Escape' | 'Tab' | 'Backspace' | 'Delete' | ' ' | 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'PageUp' | 'PageDown';
 ```
 
+## @mk-kit/ui/translate/editor
+
+3 exports. `import { … } from '@mk-kit/ui/translate/editor';`
+
+### MkTranslationEditor (component)
+
+Selector: `mk-translation-editor`
+
+Docs: https://mk-kit.dev/components/translate
+
+Import: `import { MkTranslationEditor } from '@mk-kit/ui/translate/editor';`
+
+Translation editor — keys as rows, locales as columns, click a cell to
+edit. The base strings are your bundled files; edits are **overrides**
+kept apart from them, so a rebuild never loses them and a cell can be
+restored to the file text. Search by key or text, filter to the keys a
+locale is missing or the ones already edited, export the grid as CSV.
+Persistence is yours: every edit is emitted as `changed`, feed the result
+back through `overrides`.
+
+```html
+<mk-translation-editor
+  [locales]="['pl', 'en', 'ru']"
+  [base]="base()"
+  [overrides]="overrides()"
+  (changed)="save($event)" />
+```
+
+Inputs:
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| `locales` (required) | `string[]` |  | Locale codes, in column order. The first one is the reference language. |
+| `base` (required) | `Record<string, MkFlatTranslations>` |  | Bundled strings per locale, flat (`'a.b.c': 'text'`) or nested. |
+| `overrides` | `Record<string, MkFlatTranslations>` | `{}` | Edits per locale, flat. Missing locales are fine. |
+| `readonly` | `boolean` | `false` | Show but do not edit. |
+| `exportFilename` | `string` | `'translations.csv'` | File name of the CSV export. |
+
+Outputs:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `changed` | `MkTranslationChange` | An edit or a restore; persist it and update `overrides`. |
+
+### MkTranslationChange (interface)
+
+Import: `import { MkTranslationChange } from '@mk-kit/ui/translate/editor';`
+
+One edit made in the editor. `value: null` clears the override.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `locale` | `string` |  |
+| `key` | `string` |  |
+| `value` | `string \| null` |  |
+| `previous` | `string \| null` | The text shown before the edit (override, or the base string). |
+
+### MkTranslationRow (interface)
+
+Import: `import { MkTranslationRow } from '@mk-kit/ui/translate/editor';`
+
+A row of the editor: the key plus the effective text per locale.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `key` | `string` |  |
+
 ## @mk-kit/ui/translate/server
 
 2 exports. `import { … } from '@mk-kit/ui/translate/server';`

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.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`.
+> 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.57.0. 177 components, 45 directives, 20 services and 155 helper functions across 37 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)
+- [Attention](https://mk-kit.dev/components/attention)
 - [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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mk-kit/mcp",
-  "version": "0.55.1",
+  "version": "0.57.0",
   "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",