npm - @mk-kit/mcp - Versions diffs - 0.56.0 → 0.58.0 - Mend

@mk-kit/mcp 0.56.0 → 0.58.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (4) hide show

package/data/api.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
  "package": "@mk-kit/ui",
- "version": "0.56.0",
+ "version": "0.58.0",
  "site": "https://mk-kit.dev",
  "entries": [
   {
@@ -85,6 +85,39 @@
      "queries": [],
      "docs": "/core-services"
     },
+    {
+     "name": "MkAccentService",
+     "description": "Runtime accent — the user picks one of `MK_ACCENTS` and every kit\ncontrol recolours: the service writes the `--mk-primary` family\n(`primary`, `-hover`, `-active`, `-subtle`, `-subtle-hover`,\n`-subtle-text`), `--mk-focus-ring`, `--mk-selected-bg` / `-text` and three\naccent tokens of its own — `--mk-accent`, `--mk-accent-ink`,\n`--mk-accent-glow` — onto `<html>`, and mirrors the key as\n`data-mk-accent`. Hover / active are a touch darker in light and a touch\nlighter in dark (it follows `MkThemeService`). The choice persists\nin `localStorage` (`mk-kit-accent`); nothing is written until `set()` is\ncalled, so an app that never picks keeps the preset's own primary.\n\n```ts\nreadonly accent = inject(MkAccentService);\naccent.set('coral');           // every button, ring and chip turns coral\naccent.key();                  // 'coral'\nmkAccentSwatch(accent.key());  // for the picker\n```",
+     "file": "projects/mk-kit/core/theme/accent.service.ts",
+     "kind": "service",
+     "providedIn": "root",
+     "methods": [
+      {
+       "name": "set",
+       "signature": "(key: MkAccentKey): void",
+       "description": "Pick an accent; persisted."
+      },
+      {
+       "name": "reset",
+       "signature": "(): void",
+       "description": "Back to the preset's own primary; the stored choice is cleared."
+      }
+     ],
+     "properties": [
+      {
+       "name": "key",
+       "type": "Signal<MkAccentKey | null>",
+       "description": "The chosen accent, or `null` while the preset's own primary is in use.",
+       "readonly": true
+      },
+      {
+       "name": "accent",
+       "type": "Signal<MkAccent>",
+       "description": "The chosen accent's definition (indigo when none is chosen).",
+       "readonly": true
+      }
+     ]
+    },
     {
      "name": "MkBreakpointService",
      "description": "Reactive viewport breakpoints, one `matchMedia` listener per step.\n\n```ts\nprivate readonly bp = inject(MkBreakpointService);\nreadonly compact = this.bp.down('md');          // Signal<boolean>\nreadonly columns = computed(() => this.bp.resolve({ xs: 1, md: 2, xl: 4 }));\n```\n\nOn the server (no `window`) everything reports `xs`.",
@@ -373,6 +406,15 @@
       }
      ]
     },
+    {
+     "name": "mkAccentSwatch",
+     "description": "The swatch a picker shows for an accent (bumblebee is the black / yellow split).",
+     "file": "projects/mk-kit/core/theme/accent.service.ts",
+     "kind": "function",
+     "signatures": [
+      "(key: MkAccentKey): string"
+     ]
+    },
     {
      "name": "mkBodyLevelAncestor",
      "description": "The direct child of `document.body` an overlay-root descendant lives under,\ncrossing shadow boundaries on the way up — `null` when the node is not under\n`body` at all. The overlay service uses it to keep the overlay's own host\nout of the elements it makes `inert` behind a modal.",
@@ -427,6 +469,15 @@
       "(root: HTMLElement): HTMLElement[]"
      ]
     },
+    {
+     "name": "mkHexAlpha",
+     "description": "`#rrggbb` → `rgba(r,g,b,a)`.",
+     "file": "projects/mk-kit/core/theme/accent.service.ts",
+     "kind": "function",
+     "signatures": [
+      "(hex: string, alpha: number): string"
+     ]
+    },
     {
      "name": "mkHighlight",
      "description": "Highlight `src` for `language`, falling back to escaped plain text.",
@@ -627,6 +678,20 @@
      "kind": "token",
      "type": "InjectionToken<MkOverlayRootFn>"
     },
+    {
+     "name": "MK_ACCENT_ORDER",
+     "description": "Picker order.",
+     "file": "projects/mk-kit/core/theme/accent.service.ts",
+     "kind": "const",
+     "type": "readonly MkAccentKey[]"
+    },
+    {
+     "name": "MK_ACCENTS",
+     "description": "High-saturation, distinct, energising accents — the set the `momentum` preset was designed around.",
+     "file": "projects/mk-kit/core/theme/accent.service.ts",
+     "kind": "const",
+     "type": "Record<MkAccentKey, MkAccent>"
+    },
     {
      "name": "MK_DEFAULT_BREAKPOINTS",
      "description": "The default scale (same numbers as Tailwind, so mental models transfer).",
@@ -676,6 +741,29 @@
      "kind": "const",
      "type": "ReadonlySet<MkQueryOperator>"
     },
+    {
+     "name": "MkAccent",
+     "description": "`fill` = bars, rings and buttons · `ink` = small accent text on a light ground.",
+     "file": "projects/mk-kit/core/theme/accent.service.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "fill",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "ink",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "name",
+       "type": "string",
+       "description": ""
+      }
+     ]
+    },
     {
      "name": "MkAnchoredPosition",
      "description": "Resolved coordinates (viewport-relative, for `position: fixed`).",
@@ -1547,6 +1635,46 @@
        "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",
@@ -3266,6 +3394,13 @@
       }
      ]
     },
+    {
+     "name": "MkAccentKey",
+     "description": "One of the eight kit accents (the Momentum palette).",
+     "file": "projects/mk-kit/core/theme/accent.service.ts",
+     "kind": "type",
+     "definition": "'indigo' | 'blue' | 'teal' | 'violet' | 'coral' | 'lime' | 'pink' | 'bumblebee'"
+    },
     {
      "name": "MkAriaLivePoliteness",
      "description": "",
@@ -18562,6 +18697,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",
@@ -23852,6 +24295,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",

package/data/llms-full.txt CHANGED Viewed

@@ -1,4 +1,4 @@
-# @mk-kit/ui 0.56.0 — full API reference
+# @mk-kit/ui 0.58.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
@@ -12,7 +12,7 @@ Every component and directive below is standalone — import the class from its
 ## @mk-kit/ui/core
-80 exports. `import { … } from '@mk-kit/ui/core';`
+87 exports. `import { … } from '@mk-kit/ui/core';`
 ### MkAnchoredPanel (directive)
@@ -66,6 +66,42 @@ Methods:
 | --- | --- |
 | `position(track?: boolean): void` | Recompute and apply the panel position. Safe to call at any time. With `track` (scroll-driven), the panel follows the anchor unclamped and dismisses once the anchor leaves the viewport (matching the CDK's reposition-with-auto-close scroll behaviour). |
+### MkAccentService (service)
+Import: `import { MkAccentService } from '@mk-kit/ui/core';`
+Runtime accent — the user picks one of `MK_ACCENTS` and every kit
+control recolours: the service writes the `--mk-primary` family
+(`primary`, `-hover`, `-active`, `-subtle`, `-subtle-hover`,
+`-subtle-text`), `--mk-focus-ring`, `--mk-selected-bg` / `-text` and three
+accent tokens of its own — `--mk-accent`, `--mk-accent-ink`,
+`--mk-accent-glow` — onto `<html>`, and mirrors the key as
+`data-mk-accent`. Hover / active are a touch darker in light and a touch
+lighter in dark (it follows `MkThemeService`). The choice persists
+in `localStorage` (`mk-kit-accent`); nothing is written until `set()` is
+called, so an app that never picks keeps the preset's own primary.
+```ts
+readonly accent = inject(MkAccentService);
+accent.set('coral');           // every button, ring and chip turns coral
+accent.key();                  // 'coral'
+mkAccentSwatch(accent.key());  // for the picker
+```
+Methods:
+| Signature | Description |
+| --- | --- |
+| `set(key: MkAccentKey): void` | Pick an accent; persisted. |
+| `reset(): void` | Back to the preset's own primary; the stored choice is cleared. |
+Properties:
+| Name | Type | Description |
+| --- | --- | --- |
+| `key` | `Signal<MkAccentKey \| null>` | The chosen accent, or `null` while the preset's own primary is in use. |
+| `accent` | `Signal<MkAccent>` | The chosen accent's definition (indigo when none is chosen). |
 ### MkBreakpointService (service)
 Docs: https://mk-kit.dev/core-services
@@ -250,6 +286,16 @@ Properties:
 | `afterClosed` | `Promise<TResult \| undefined>` | Resolves with the close result when the overlay is dismissed. |
 | `closed$` | `Observable<TResult \| undefined>` | Emits the close result once, then completes. Subscribing after the overlay has already closed replays the result immediately, so a late subscriber never hangs. |
+### mkAccentSwatch (function)
+Import: `import { mkAccentSwatch } from '@mk-kit/ui/core';`
+The swatch a picker shows for an accent (bumblebee is the black / yellow split).
+```ts
+function mkAccentSwatch(key: MkAccentKey): string
+```
 ### mkBodyLevelAncestor (function)
 Import: `import { mkBodyLevelAncestor } from '@mk-kit/ui/core';`
@@ -324,6 +370,16 @@ Returns the tabbable elements inside `root`, in DOM order.
 function mkGetFocusable(root: HTMLElement): HTMLElement[]
 ```
+### mkHexAlpha (function)
+Import: `import { mkHexAlpha } from '@mk-kit/ui/core';`
+`#rrggbb` → `rgba(r,g,b,a)`.
+```ts
+function mkHexAlpha(hex: string, alpha: number): string
+```
 ### mkHighlight (function)
 Import: `import { mkHighlight } from '@mk-kit/ui/core';`
@@ -618,6 +674,26 @@ elements stay isolated from the host page's stylesheet:
 const MK_OVERLAY_ROOT: InjectionToken<MkOverlayRootFn>;
 ```
+### MK_ACCENT_ORDER (const)
+Import: `import { MK_ACCENT_ORDER } from '@mk-kit/ui/core';`
+Picker order.
+```ts
+const MK_ACCENT_ORDER: readonly MkAccentKey[];
+```
+### MK_ACCENTS (const)
+Import: `import { MK_ACCENTS } from '@mk-kit/ui/core';`
+High-saturation, distinct, energising accents — the set the `momentum` preset was designed around.
+```ts
+const MK_ACCENTS: Record<MkAccentKey, MkAccent>;
+```
 ### MK_DEFAULT_BREAKPOINTS (const)
 Import: `import { MK_DEFAULT_BREAKPOINTS } from '@mk-kit/ui/core';`
@@ -688,6 +764,20 @@ Operators that take no value.
 const MK_QUERY_UNARY: ReadonlySet<MkQueryOperator>;
 ```
+### MkAccent (interface)
+Import: `import { MkAccent } from '@mk-kit/ui/core';`
+`fill` = bars, rings and buttons · `ink` = small accent text on a light ground.
+Members:
+| Name | Type | Description |
+| --- | --- | --- |
+| `fill` | `string` |  |
+| `ink` | `string` |  |
+| `name` | `string` |  |
 ### MkAnchoredPosition (interface)
 Import: `import { MkAnchoredPosition } from '@mk-kit/ui/core';`
@@ -911,6 +1001,14 @@ Members:
 | `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. |
@@ -1348,6 +1446,16 @@ Members:
 | `register` | `(fn: () => void): void` | Store the callback Angular hands to `registerOnValidatorChange`. |
 | `notify` | `(): void` | Ask the bound control to re-run `validate()` now. |
+### MkAccentKey (type)
+Import: `import { MkAccentKey } from '@mk-kit/ui/core';`
+One of the eight kit accents (the Momentum palette).
+```ts
+type MkAccentKey = 'indigo' | 'blue' | 'teal' | 'violet' | 'coral' | 'lime' | 'pink' | 'bumblebee';
+```
 ### MkAriaLivePoliteness (type)
 Import: `import { MkAriaLivePoliteness } from '@mk-kit/ui/core';`
@@ -12327,6 +12435,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';`
@@ -16243,6 +16606,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';`

package/data/llms.txt CHANGED Viewed

@@ -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.56.0. 174 components, 45 directives, 17 services and 152 helper functions across 35 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.58.0. 177 components, 45 directives, 21 services and 157 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 CHANGED Viewed

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