@mk-kit/mcp 0.46.0 → 0.48.0

package/data/api.json

@@ -1,6 +1,6 @@
 {
  "package": "@mk-kit/ui",
- "version": "0.46.0",
+ "version": "0.48.0",
  "site": "https://mk-kit.dev",
  "entries": [
   {
@@ -373,6 +373,15 @@
       }
      ]
     },
+    {
+     "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.",
+     "file": "projects/mk-kit/core/overlay/overlay-root.ts",
+     "kind": "function",
+     "signatures": [
+      "(node: Node, body: HTMLElement): Element | null"
+     ]
+    },
     {
      "name": "mkComputeAnchoredPosition",
      "description": "Pure viewport-positioning maths shared by every anchored overlay\n(`MkAnchoredPanel` and the tooltip). Given the anchor rect, the panel\nsize and the viewport size, returns the top/left for a `position: fixed`\npanel — flipping to the opposite side when it would overflow and clamping\nback inside the viewport.",
@@ -620,6 +629,13 @@
      "kind": "token",
      "type": "InjectionToken<unknown>"
     },
+    {
+     "name": "MK_OVERLAY_ROOT",
+     "description": "Where mk-kit mounts everything that leaves the component tree: overlay\ncontainers (dialogs), anchored panels (selects, menus, tooltips), toast /\nsnackbar containers and the tour surfaces. Defaults to `document.body`.\n\nOverride it to confine those surfaces to another element — `@mk-kit/ui/embed`\npoints it at a themed shadow-DOM host so overlays opened by embedded custom\nelements stay isolated from the host page's stylesheet:\n\n```ts\n{ provide: MK_OVERLAY_ROOT, useValue: () => myOverlayHost }\n```",
+     "file": "projects/mk-kit/core/overlay/overlay-root.ts",
+     "kind": "token",
+     "type": "InjectionToken<MkOverlayRootFn>"
+    },
     {
      "name": "MK_DEFAULT_BREAKPOINTS",
      "description": "The default scale (same numbers as Tailwind, so mental models transfer).",
@@ -3140,6 +3156,13 @@
      "kind": "type",
      "definition": "Partial< Omit<MkI18nStrings, 'dateNames' | 'blockEditor' | 'validation'> > & { dateNames?: Partial<MkDateNames>; blockEditor?: Partial<MkBlockEditorStrings>; validation?: Partial<MkValidationStrings>; }"
     },
+    {
+     "name": "MkOverlayRootFn",
+     "description": "Resolves the element overlay surfaces are appended to. A function (not an\nelement) because the root may be created lazily, after DI is set up.",
+     "file": "projects/mk-kit/core/overlay/overlay-root.ts",
+     "kind": "type",
+     "definition": "() => HTMLElement"
+    },
     {
      "name": "MkPlacement",
      "description": "Common placement values for overlays (menus, tooltips, popovers).",
@@ -22459,6 +22482,241 @@
     }
    ]
   },
+  {
+   "name": "embed",
+   "import": "@mk-kit/ui/embed",
+   "exports": [
+    {
+     "name": "MkEmbedApp",
+     "description": "One shared embed application. Create it with `mkEmbed`.",
+     "file": "projects/mk-kit/embed/embed.ts",
+     "kind": "class",
+     "methods": [
+      {
+       "name": "element",
+       "signature": "(tag: string, component: Type<unknown>): this",
+       "description": "Defines `tag` as a custom element rendering `component`. Chainable; a\nno-op when the tag is already defined (hot reload, duplicate script) or\noutside a browser."
+      },
+      {
+       "name": "ready",
+       "signature": "(): Promise<void>",
+       "description": "Resolves when the shared application is running (created on demand)."
+      },
+      {
+       "name": "whenStable",
+       "signature": "(): Promise<void>",
+       "description": "Resolves when the application has no pending change detection."
+      },
+      {
+       "name": "destroy",
+       "signature": "(): void",
+       "description": "Destroys the shared application, every mounted component and the overlay\nhost. Defined tags remain registered (the platform cannot undefine them)\nbut render nothing afterwards."
+      }
+     ],
+     "properties": []
+    },
+    {
+     "name": "mkEmbed",
+     "description": "Creates an embed application: a factory for custom elements that render\nmk-kit-based Angular components behind shadow DOM.\n\n- **Lazy**: `element()` only defines the tag; the Angular application is\n  created on the first element actually connected to a document.\n- **Shared**: every element of one `mkEmbed()` call runs in one zoneless\n  `ApplicationRef` with one provider set.\n- **Isolated but themable**: the host page's CSS cannot reach the widget\n  internals, while `--mk-*` custom properties still inherit through the\n  shadow boundary — set them on the element (or any ancestor) to theme it.\n- **Styled**: Angular routes each component's own styles into the shadow\n  root it renders in; the `styles` option supplies the token/theme layer.\n\n```ts\nimport { mkEmbed, mkShadowCss } from '@mk-kit/ui/embed';\nimport themeCss from '@mk-kit/ui/styles.css' with { type: 'text' };\n\nmkEmbed({ styles: mkShadowCss(themeCss) })\n  .element('acme-reviews', ReviewsWidget)\n  .element('acme-signup', SignupWidget);\n```\n\n```html\n<acme-reviews product-id=\"42\" style=\"--mk-primary: #7c3aed\"></acme-reviews>\n```\n\nInputs are exposed as dash-cased attributes (string values go through the\ninput's `transform`, so `booleanAttribute` / `numberAttribute` inputs coerce\nas usual) and as camel-cased element properties (any value); outputs become\nbubbling, composed `CustomEvent`s named after the output, with the emitted\nvalue as `detail`.",
+     "file": "projects/mk-kit/embed/embed.ts",
+     "kind": "function",
+     "signatures": [
+      "(init?: MkEmbedInit): MkEmbedApp"
+     ]
+    },
+    {
+     "name": "mkShadowCss",
+     "description": "Rewrites a document-level stylesheet for adoption into a shadow root:\n`:root` never matches inside one, so token blocks like mk-kit's\n`:root { --mk-primary: … }` are retargeted to `:host`. Theme opt-ins keep\nworking — `:root:not([data-mk-theme='light'])` becomes\n`:host:not([data-mk-theme='light'])`, so `<my-widget data-mk-theme=\"dark\">`\nswitches one embedded element to the dark palette.\n\n```ts\nimport themeCss from '@mk-kit/ui/styles.css' with { type: 'text' };\nmkEmbed({ styles: mkShadowCss(themeCss) });\n```",
+     "file": "projects/mk-kit/embed/shadow-css.ts",
+     "kind": "function",
+     "signatures": [
+      "(css: string): string"
+     ]
+    },
+    {
+     "name": "MkEmbedInit",
+     "description": "Options for `mkEmbed`.",
+     "file": "projects/mk-kit/embed/embed.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "styles",
+       "type": "string | readonly string[] | undefined",
+       "description": "CSS text adopted into every element's shadow root (and the overlay host).\nPass the mk-kit theme through `mkShadowCss` so its `:root` token\nblocks target `:host`; append your own widget CSS after it. Shared as\nconstructable stylesheets when the browser supports them (one parse for\nany number of instances), `<style>` elements otherwise.",
+       "optional": true
+      },
+      {
+       "name": "providers",
+       "type": "(Provider | EnvironmentProviders)[] | undefined",
+       "description": "Extra providers for the shared application — `provideMkI18n(…)`,\n`provideMkExtendedIcons()`, `provideHttpClient()`, your services.",
+       "optional": true
+      },
+      {
+       "name": "overlays",
+       "type": "boolean | undefined",
+       "description": "Mount mk-kit overlays (dialogs, anchored panels, toasts, tours) inside a\npage-level shadow host that carries the same `styles`, instead of bare\n`document.body`. Default `true`; set `false` to keep the application\ndefault (overlays styled by the page's own stylesheets).",
+       "optional": true
+      }
+     ]
+    }
+   ]
+  },
+  {
+   "name": "locales/de",
+   "import": "@mk-kit/ui/locales/de",
+   "exports": [
+    {
+     "name": "mkPluralDe",
+     "description": "Picks the German plural form for a count — CLDR's `de` rules for integers:\n`one` for 1, `other` for everything else.\n\n```ts\nmkPluralDe(1, 'Ergebnis', 'Ergebnisse'); // 'Ergebnis'\nmkPluralDe(3, 'Ergebnis', 'Ergebnisse'); // 'Ergebnisse'\n```",
+     "file": "projects/mk-kit/locales/de/de.ts",
+     "kind": "function",
+     "signatures": [
+      "(count: number, one: string, other: string): string"
+     ]
+    },
+    {
+     "name": "provideMkI18nDe",
+     "description": "Provides the German strings — `MK_DE_I18N` with any `overrides`\nmerged on top (deep for `dateNames`, `blockEditor` and `validation`, like\n`provideMkI18n`).\n\n```ts\nbootstrapApplication(App, {\n  providers: [provideMkI18nDe({ noData: 'Nichts zu sehen' })],\n});\n```",
+     "file": "projects/mk-kit/locales/de/de.ts",
+     "kind": "function",
+     "signatures": [
+      "(overrides?: MkI18nOverrides): Provider"
+     ]
+    },
+    {
+     "name": "MK_DE_BLOCK_EDITOR",
+     "description": "German strings of the block editor's chrome.",
+     "file": "projects/mk-kit/locales/de/de.ts",
+     "kind": "const",
+     "type": "MkBlockEditorStrings"
+    },
+    {
+     "name": "MK_DE_DATE_NAMES",
+     "description": "German month and weekday names (Sunday-first, as in `Intl`).",
+     "file": "projects/mk-kit/locales/de/de.ts",
+     "kind": "const",
+     "type": "MkDateNames"
+    },
+    {
+     "name": "MK_DE_I18N",
+     "description": "The complete German string map — every key of `MkI18nStrings`,\n`locale: 'de-DE'` and `currency: 'EUR'` for the formatting pipes.\nProvide it whole with `provideMkI18nDe`, or pass it as the base of\n`provideMkI18n(overrides, MK_DE_I18N)`.",
+     "file": "projects/mk-kit/locales/de/de.ts",
+     "kind": "const",
+     "type": "MkI18nStrings"
+    },
+    {
+     "name": "MK_DE_VALIDATION",
+     "description": "German validation messages rendered by `mk-form-field`.",
+     "file": "projects/mk-kit/locales/de/de.ts",
+     "kind": "const",
+     "type": "MkValidationStrings"
+    }
+   ]
+  },
+  {
+   "name": "locales/es",
+   "import": "@mk-kit/ui/locales/es",
+   "exports": [
+    {
+     "name": "mkPluralEs",
+     "description": "Picks the Spanish plural form for a count — CLDR's `es` rules for integers:\n`one` for 1, `other` for everything else.\n\n```ts\nmkPluralEs(1, 'resultado', 'resultados'); // 'resultado'\nmkPluralEs(3, 'resultado', 'resultados'); // 'resultados'\n```",
+     "file": "projects/mk-kit/locales/es/es.ts",
+     "kind": "function",
+     "signatures": [
+      "(count: number, one: string, other: string): string"
+     ]
+    },
+    {
+     "name": "provideMkI18nEs",
+     "description": "Provides the Spanish strings — `MK_ES_I18N` with any `overrides`\nmerged on top (deep for `dateNames`, `blockEditor` and `validation`, like\n`provideMkI18n`).\n\n```ts\nbootstrapApplication(App, {\n  providers: [provideMkI18nEs({ noData: 'No hay nada aquí' })],\n});\n```",
+     "file": "projects/mk-kit/locales/es/es.ts",
+     "kind": "function",
+     "signatures": [
+      "(overrides?: MkI18nOverrides): Provider"
+     ]
+    },
+    {
+     "name": "MK_ES_BLOCK_EDITOR",
+     "description": "Spanish strings of the block editor's chrome.",
+     "file": "projects/mk-kit/locales/es/es.ts",
+     "kind": "const",
+     "type": "MkBlockEditorStrings"
+    },
+    {
+     "name": "MK_ES_DATE_NAMES",
+     "description": "Spanish month and weekday names (Sunday-first, lowercase as in `Intl`).",
+     "file": "projects/mk-kit/locales/es/es.ts",
+     "kind": "const",
+     "type": "MkDateNames"
+    },
+    {
+     "name": "MK_ES_I18N",
+     "description": "The complete Spanish string map — every key of `MkI18nStrings`,\n`locale: 'es-ES'` and `currency: 'EUR'` for the formatting pipes.\nProvide it whole with `provideMkI18nEs`, or pass it as the base of\n`provideMkI18n(overrides, MK_ES_I18N)`.",
+     "file": "projects/mk-kit/locales/es/es.ts",
+     "kind": "const",
+     "type": "MkI18nStrings"
+    },
+    {
+     "name": "MK_ES_VALIDATION",
+     "description": "Spanish validation messages rendered by `mk-form-field`.",
+     "file": "projects/mk-kit/locales/es/es.ts",
+     "kind": "const",
+     "type": "MkValidationStrings"
+    }
+   ]
+  },
+  {
+   "name": "locales/fr",
+   "import": "@mk-kit/ui/locales/fr",
+   "exports": [
+    {
+     "name": "mkPluralFr",
+     "description": "Picks the French plural form for a count — CLDR's `fr` rules for integers:\n`one` for 0 and 1, `other` for everything else.\n\n```ts\nmkPluralFr(1, 'résultat', 'résultats'); // 'résultat'\nmkPluralFr(0, 'résultat', 'résultats'); // 'résultat'\nmkPluralFr(3, 'résultat', 'résultats'); // 'résultats'\n```",
+     "file": "projects/mk-kit/locales/fr/fr.ts",
+     "kind": "function",
+     "signatures": [
+      "(count: number, one: string, other: string): string"
+     ]
+    },
+    {
+     "name": "provideMkI18nFr",
+     "description": "Provides the French strings — `MK_FR_I18N` with any `overrides`\nmerged on top (deep for `dateNames`, `blockEditor` and `validation`, like\n`provideMkI18n`).\n\n```ts\nbootstrapApplication(App, {\n  providers: [provideMkI18nFr({ noData: 'Rien à afficher ici' })],\n});\n```",
+     "file": "projects/mk-kit/locales/fr/fr.ts",
+     "kind": "function",
+     "signatures": [
+      "(overrides?: MkI18nOverrides): Provider"
+     ]
+    },
+    {
+     "name": "MK_FR_BLOCK_EDITOR",
+     "description": "French strings of the block editor's chrome.",
+     "file": "projects/mk-kit/locales/fr/fr.ts",
+     "kind": "const",
+     "type": "MkBlockEditorStrings"
+    },
+    {
+     "name": "MK_FR_DATE_NAMES",
+     "description": "French month and weekday names (Sunday-first, lowercase as in `Intl`).",
+     "file": "projects/mk-kit/locales/fr/fr.ts",
+     "kind": "const",
+     "type": "MkDateNames"
+    },
+    {
+     "name": "MK_FR_I18N",
+     "description": "The complete French string map — every key of `MkI18nStrings`,\n`locale: 'fr-FR'` and `currency: 'EUR'` for the formatting pipes.\nProvide it whole with `provideMkI18nFr`, or pass it as the base of\n`provideMkI18n(overrides, MK_FR_I18N)`.",
+     "file": "projects/mk-kit/locales/fr/fr.ts",
+     "kind": "const",
+     "type": "MkI18nStrings"
+    },
+    {
+     "name": "MK_FR_VALIDATION",
+     "description": "French validation messages rendered by `mk-form-field`.",
+     "file": "projects/mk-kit/locales/fr/fr.ts",
+     "kind": "const",
+     "type": "MkValidationStrings"
+    }
+   ]
+  },
   {
    "name": "locales/pl",
    "import": "@mk-kit/ui/locales/pl",
@@ -22511,6 +22769,58 @@
     }
    ]
   },
+  {
+   "name": "locales/uk",
+   "import": "@mk-kit/ui/locales/uk",
+   "exports": [
+    {
+     "name": "mkPluralUk",
+     "description": "Picks the Ukrainian plural form for a count — CLDR's `uk` rules for\nintegers: `one` when the number ends in 1 (but not 11), `few` when it ends\nin 2–4 (but not 12–14), `many` otherwise.\n\n```ts\nmkPluralUk(1, 'результат', 'результати', 'результатів');  // 'результат'\nmkPluralUk(3, 'результат', 'результати', 'результатів');  // 'результати'\nmkPluralUk(11, 'результат', 'результати', 'результатів'); // 'результатів'\n```",
+     "file": "projects/mk-kit/locales/uk/uk.ts",
+     "kind": "function",
+     "signatures": [
+      "(count: number, one: string, few: string, many: string): string"
+     ]
+    },
+    {
+     "name": "provideMkI18nUk",
+     "description": "Provides the Ukrainian strings — `MK_UK_I18N` with any `overrides`\nmerged on top (deep for `dateNames`, `blockEditor` and `validation`, like\n`provideMkI18n`).\n\n```ts\nbootstrapApplication(App, {\n  providers: [provideMkI18nUk({ noData: 'Тут нічого немає' })],\n});\n```",
+     "file": "projects/mk-kit/locales/uk/uk.ts",
+     "kind": "function",
+     "signatures": [
+      "(overrides?: MkI18nOverrides): Provider"
+     ]
+    },
+    {
+     "name": "MK_UK_BLOCK_EDITOR",
+     "description": "Ukrainian strings of the block editor's chrome.",
+     "file": "projects/mk-kit/locales/uk/uk.ts",
+     "kind": "const",
+     "type": "MkBlockEditorStrings"
+    },
+    {
+     "name": "MK_UK_DATE_NAMES",
+     "description": "Ukrainian month and weekday names (Sunday-first, lowercase as in `Intl`).",
+     "file": "projects/mk-kit/locales/uk/uk.ts",
+     "kind": "const",
+     "type": "MkDateNames"
+    },
+    {
+     "name": "MK_UK_I18N",
+     "description": "The complete Ukrainian string map — every key of `MkI18nStrings`,\n`locale: 'uk-UA'` and `currency: 'UAH'` for the formatting pipes.\nProvide it whole with `provideMkI18nUk`, or pass it as the base of\n`provideMkI18n(overrides, MK_UK_I18N)`.",
+     "file": "projects/mk-kit/locales/uk/uk.ts",
+     "kind": "const",
+     "type": "MkI18nStrings"
+    },
+    {
+     "name": "MK_UK_VALIDATION",
+     "description": "Ukrainian validation messages rendered by `mk-form-field`.",
+     "file": "projects/mk-kit/locales/uk/uk.ts",
+     "kind": "const",
+     "type": "MkValidationStrings"
+    }
+   ]
+  },
   {
    "name": "testing",
    "import": "@mk-kit/ui/testing",

package/data/llms-full.txt

@@ -1,4 +1,4 @@
-# @mk-kit/ui 0.46.0 — full API reference
+# @mk-kit/ui 0.48.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
 
-76 exports. `import { … } from '@mk-kit/ui/core';`
+79 exports. `import { … } from '@mk-kit/ui/core';`
 
 ### MkAnchoredPanel (directive)
 
@@ -250,6 +250,19 @@ 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. |
 
+### mkBodyLevelAncestor (function)
+
+Import: `import { mkBodyLevelAncestor } from '@mk-kit/ui/core';`
+
+The direct child of `document.body` an overlay-root descendant lives under,
+crossing shadow boundaries on the way up — `null` when the node is not under
+`body` at all. The overlay service uses it to keep the overlay's own host
+out of the elements it makes `inert` behind a modal.
+
+```ts
+function mkBodyLevelAncestor(node: Node, body: HTMLElement): Element | null
+```
+
 ### mkComputeAnchoredPosition (function)
 
 Import: `import { mkComputeAnchoredPosition } from '@mk-kit/ui/core';`
@@ -618,6 +631,26 @@ Injection token exposing the data passed to an overlay component.
 const MK_OVERLAY_DATA: InjectionToken<unknown>;
 ```
 
+### MK_OVERLAY_ROOT (token)
+
+Import: `import { MK_OVERLAY_ROOT } from '@mk-kit/ui/core';`
+
+Where mk-kit mounts everything that leaves the component tree: overlay
+containers (dialogs), anchored panels (selects, menus, tooltips), toast /
+snackbar containers and the tour surfaces. Defaults to `document.body`.
+
+Override it to confine those surfaces to another element — `@mk-kit/ui/embed`
+points it at a themed shadow-DOM host so overlays opened by embedded custom
+elements stay isolated from the host page's stylesheet:
+
+```ts
+{ provide: MK_OVERLAY_ROOT, useValue: () => myOverlayHost }
+```
+
+```ts
+const MK_OVERLAY_ROOT: InjectionToken<MkOverlayRootFn>;
+```
+
 ### MK_DEFAULT_BREAKPOINTS (const)
 
 Import: `import { MK_DEFAULT_BREAKPOINTS } from '@mk-kit/ui/core';`
@@ -1390,6 +1423,17 @@ and `validation` groups may be partial too (they are merged deeply).
 type MkI18nOverrides = Partial< Omit<MkI18nStrings, 'dateNames' | 'blockEditor' | 'validation'> > & { dateNames?: Partial<MkDateNames>; blockEditor?: Partial<MkBlockEditorStrings>; validation?: Partial<MkValidationStrings>; };
 ```
 
+### MkOverlayRootFn (type)
+
+Import: `import { MkOverlayRootFn } from '@mk-kit/ui/core';`
+
+Resolves the element overlay surfaces are appended to. A function (not an
+element) because the root may be created lazily, after DI is set up.
+
+```ts
+type MkOverlayRootFn = () => HTMLElement;
+```
+
 ### MkPlacement (type)
 
 Import: `import { MkPlacement } from '@mk-kit/ui/core';`
@@ -15001,6 +15045,343 @@ Load lifecycle of an `MkImage`.
 type MkImageState = 'loading' | 'loaded' | 'error';
 ```
 
+## @mk-kit/ui/embed
+
+4 exports. `import { … } from '@mk-kit/ui/embed';`
+
+### MkEmbedApp (class)
+
+Import: `import { MkEmbedApp } from '@mk-kit/ui/embed';`
+
+One shared embed application. Create it with `mkEmbed`.
+
+Methods:
+
+| Signature | Description |
+| --- | --- |
+| `element(tag: string, component: Type<unknown>): this` | Defines `tag` as a custom element rendering `component`. Chainable; a no-op when the tag is already defined (hot reload, duplicate script) or outside a browser. |
+| `ready(): Promise<void>` | Resolves when the shared application is running (created on demand). |
+| `whenStable(): Promise<void>` | Resolves when the application has no pending change detection. |
+| `destroy(): void` | Destroys the shared application, every mounted component and the overlay host. Defined tags remain registered (the platform cannot undefine them) but render nothing afterwards. |
+
+### mkEmbed (function)
+
+Import: `import { mkEmbed } from '@mk-kit/ui/embed';`
+
+Creates an embed application: a factory for custom elements that render
+mk-kit-based Angular components behind shadow DOM.
+
+- **Lazy**: `element()` only defines the tag; the Angular application is
+  created on the first element actually connected to a document.
+- **Shared**: every element of one `mkEmbed()` call runs in one zoneless
+  `ApplicationRef` with one provider set.
+- **Isolated but themable**: the host page's CSS cannot reach the widget
+  internals, while `--mk-*` custom properties still inherit through the
+  shadow boundary — set them on the element (or any ancestor) to theme it.
+- **Styled**: Angular routes each component's own styles into the shadow
+  root it renders in; the `styles` option supplies the token/theme layer.
+
+```ts
+import { mkEmbed, mkShadowCss } from '@mk-kit/ui/embed';
+import themeCss from '@mk-kit/ui/styles.css' with { type: 'text' };
+
+mkEmbed({ styles: mkShadowCss(themeCss) })
+  .element('acme-reviews', ReviewsWidget)
+  .element('acme-signup', SignupWidget);
+```
+
+```html
+<acme-reviews product-id="42" style="--mk-primary: #7c3aed"></acme-reviews>
+```
+
+Inputs are exposed as dash-cased attributes (string values go through the
+input's `transform`, so `booleanAttribute` / `numberAttribute` inputs coerce
+as usual) and as camel-cased element properties (any value); outputs become
+bubbling, composed `CustomEvent`s named after the output, with the emitted
+value as `detail`.
+
+```ts
+function mkEmbed(init?: MkEmbedInit): MkEmbedApp
+```
+
+### mkShadowCss (function)
+
+Import: `import { mkShadowCss } from '@mk-kit/ui/embed';`
+
+Rewrites a document-level stylesheet for adoption into a shadow root:
+`:root` never matches inside one, so token blocks like mk-kit's
+`:root { --mk-primary: … }` are retargeted to `:host`. Theme opt-ins keep
+working — `:root:not([data-mk-theme='light'])` becomes
+`:host:not([data-mk-theme='light'])`, so `<my-widget data-mk-theme="dark">`
+switches one embedded element to the dark palette.
+
+```ts
+import themeCss from '@mk-kit/ui/styles.css' with { type: 'text' };
+mkEmbed({ styles: mkShadowCss(themeCss) });
+```
+
+```ts
+function mkShadowCss(css: string): string
+```
+
+### MkEmbedInit (interface)
+
+Import: `import { MkEmbedInit } from '@mk-kit/ui/embed';`
+
+Options for `mkEmbed`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `styles`? | `string \| readonly string[] \| undefined` | CSS text adopted into every element's shadow root (and the overlay host). Pass the mk-kit theme through `mkShadowCss` so its `:root` token blocks target `:host`; append your own widget CSS after it. Shared as constructable stylesheets when the browser supports them (one parse for any number of instances), `<style>` elements otherwise. |
+| `providers`? | `(Provider \| EnvironmentProviders)[] \| undefined` | Extra providers for the shared application — `provideMkI18n(…)`, `provideMkExtendedIcons()`, `provideHttpClient()`, your services. |
+| `overlays`? | `boolean \| undefined` | Mount mk-kit overlays (dialogs, anchored panels, toasts, tours) inside a page-level shadow host that carries the same `styles`, instead of bare `document.body`. Default `true`; set `false` to keep the application default (overlays styled by the page's own stylesheets). |
+
+## @mk-kit/ui/locales/de
+
+6 exports. `import { … } from '@mk-kit/ui/locales/de';`
+
+### mkPluralDe (function)
+
+Import: `import { mkPluralDe } from '@mk-kit/ui/locales/de';`
+
+Picks the German plural form for a count — CLDR's `de` rules for integers:
+`one` for 1, `other` for everything else.
+
+```ts
+mkPluralDe(1, 'Ergebnis', 'Ergebnisse'); // 'Ergebnis'
+mkPluralDe(3, 'Ergebnis', 'Ergebnisse'); // 'Ergebnisse'
+```
+
+```ts
+function mkPluralDe(count: number, one: string, other: string): string
+```
+
+### provideMkI18nDe (function)
+
+Import: `import { provideMkI18nDe } from '@mk-kit/ui/locales/de';`
+
+Provides the German strings — `MK_DE_I18N` with any `overrides`
+merged on top (deep for `dateNames`, `blockEditor` and `validation`, like
+`provideMkI18n`).
+
+```ts
+bootstrapApplication(App, {
+  providers: [provideMkI18nDe({ noData: 'Nichts zu sehen' })],
+});
+```
+
+```ts
+function provideMkI18nDe(overrides?: MkI18nOverrides): Provider
+```
+
+### MK_DE_BLOCK_EDITOR (const)
+
+Import: `import { MK_DE_BLOCK_EDITOR } from '@mk-kit/ui/locales/de';`
+
+German strings of the block editor's chrome.
+
+```ts
+const MK_DE_BLOCK_EDITOR: MkBlockEditorStrings;
+```
+
+### MK_DE_DATE_NAMES (const)
+
+Import: `import { MK_DE_DATE_NAMES } from '@mk-kit/ui/locales/de';`
+
+German month and weekday names (Sunday-first, as in `Intl`).
+
+```ts
+const MK_DE_DATE_NAMES: MkDateNames;
+```
+
+### MK_DE_I18N (const)
+
+Import: `import { MK_DE_I18N } from '@mk-kit/ui/locales/de';`
+
+The complete German string map — every key of `MkI18nStrings`,
+`locale: 'de-DE'` and `currency: 'EUR'` for the formatting pipes.
+Provide it whole with `provideMkI18nDe`, or pass it as the base of
+`provideMkI18n(overrides, MK_DE_I18N)`.
+
+```ts
+const MK_DE_I18N: MkI18nStrings;
+```
+
+### MK_DE_VALIDATION (const)
+
+Import: `import { MK_DE_VALIDATION } from '@mk-kit/ui/locales/de';`
+
+German validation messages rendered by `mk-form-field`.
+
+```ts
+const MK_DE_VALIDATION: MkValidationStrings;
+```
+
+## @mk-kit/ui/locales/es
+
+6 exports. `import { … } from '@mk-kit/ui/locales/es';`
+
+### mkPluralEs (function)
+
+Import: `import { mkPluralEs } from '@mk-kit/ui/locales/es';`
+
+Picks the Spanish plural form for a count — CLDR's `es` rules for integers:
+`one` for 1, `other` for everything else.
+
+```ts
+mkPluralEs(1, 'resultado', 'resultados'); // 'resultado'
+mkPluralEs(3, 'resultado', 'resultados'); // 'resultados'
+```
+
+```ts
+function mkPluralEs(count: number, one: string, other: string): string
+```
+
+### provideMkI18nEs (function)
+
+Import: `import { provideMkI18nEs } from '@mk-kit/ui/locales/es';`
+
+Provides the Spanish strings — `MK_ES_I18N` with any `overrides`
+merged on top (deep for `dateNames`, `blockEditor` and `validation`, like
+`provideMkI18n`).
+
+```ts
+bootstrapApplication(App, {
+  providers: [provideMkI18nEs({ noData: 'No hay nada aquí' })],
+});
+```
+
+```ts
+function provideMkI18nEs(overrides?: MkI18nOverrides): Provider
+```
+
+### MK_ES_BLOCK_EDITOR (const)
+
+Import: `import { MK_ES_BLOCK_EDITOR } from '@mk-kit/ui/locales/es';`
+
+Spanish strings of the block editor's chrome.
+
+```ts
+const MK_ES_BLOCK_EDITOR: MkBlockEditorStrings;
+```
+
+### MK_ES_DATE_NAMES (const)
+
+Import: `import { MK_ES_DATE_NAMES } from '@mk-kit/ui/locales/es';`
+
+Spanish month and weekday names (Sunday-first, lowercase as in `Intl`).
+
+```ts
+const MK_ES_DATE_NAMES: MkDateNames;
+```
+
+### MK_ES_I18N (const)
+
+Import: `import { MK_ES_I18N } from '@mk-kit/ui/locales/es';`
+
+The complete Spanish string map — every key of `MkI18nStrings`,
+`locale: 'es-ES'` and `currency: 'EUR'` for the formatting pipes.
+Provide it whole with `provideMkI18nEs`, or pass it as the base of
+`provideMkI18n(overrides, MK_ES_I18N)`.
+
+```ts
+const MK_ES_I18N: MkI18nStrings;
+```
+
+### MK_ES_VALIDATION (const)
+
+Import: `import { MK_ES_VALIDATION } from '@mk-kit/ui/locales/es';`
+
+Spanish validation messages rendered by `mk-form-field`.
+
+```ts
+const MK_ES_VALIDATION: MkValidationStrings;
+```
+
+## @mk-kit/ui/locales/fr
+
+6 exports. `import { … } from '@mk-kit/ui/locales/fr';`
+
+### mkPluralFr (function)
+
+Import: `import { mkPluralFr } from '@mk-kit/ui/locales/fr';`
+
+Picks the French plural form for a count — CLDR's `fr` rules for integers:
+`one` for 0 and 1, `other` for everything else.
+
+```ts
+mkPluralFr(1, 'résultat', 'résultats'); // 'résultat'
+mkPluralFr(0, 'résultat', 'résultats'); // 'résultat'
+mkPluralFr(3, 'résultat', 'résultats'); // 'résultats'
+```
+
+```ts
+function mkPluralFr(count: number, one: string, other: string): string
+```
+
+### provideMkI18nFr (function)
+
+Import: `import { provideMkI18nFr } from '@mk-kit/ui/locales/fr';`
+
+Provides the French strings — `MK_FR_I18N` with any `overrides`
+merged on top (deep for `dateNames`, `blockEditor` and `validation`, like
+`provideMkI18n`).
+
+```ts
+bootstrapApplication(App, {
+  providers: [provideMkI18nFr({ noData: 'Rien à afficher ici' })],
+});
+```
+
+```ts
+function provideMkI18nFr(overrides?: MkI18nOverrides): Provider
+```
+
+### MK_FR_BLOCK_EDITOR (const)
+
+Import: `import { MK_FR_BLOCK_EDITOR } from '@mk-kit/ui/locales/fr';`
+
+French strings of the block editor's chrome.
+
+```ts
+const MK_FR_BLOCK_EDITOR: MkBlockEditorStrings;
+```
+
+### MK_FR_DATE_NAMES (const)
+
+Import: `import { MK_FR_DATE_NAMES } from '@mk-kit/ui/locales/fr';`
+
+French month and weekday names (Sunday-first, lowercase as in `Intl`).
+
+```ts
+const MK_FR_DATE_NAMES: MkDateNames;
+```
+
+### MK_FR_I18N (const)
+
+Import: `import { MK_FR_I18N } from '@mk-kit/ui/locales/fr';`
+
+The complete French string map — every key of `MkI18nStrings`,
+`locale: 'fr-FR'` and `currency: 'EUR'` for the formatting pipes.
+Provide it whole with `provideMkI18nFr`, or pass it as the base of
+`provideMkI18n(overrides, MK_FR_I18N)`.
+
+```ts
+const MK_FR_I18N: MkI18nStrings;
+```
+
+### MK_FR_VALIDATION (const)
+
+Import: `import { MK_FR_VALIDATION } from '@mk-kit/ui/locales/fr';`
+
+French validation messages rendered by `mk-form-field`.
+
+```ts
+const MK_FR_VALIDATION: MkValidationStrings;
+```
+
 ## @mk-kit/ui/locales/pl
 
 6 exports. `import { … } from '@mk-kit/ui/locales/pl';`
@@ -15084,6 +15465,89 @@ Polish validation messages rendered by `mk-form-field`.
 const MK_PL_VALIDATION: MkValidationStrings;
 ```
 
+## @mk-kit/ui/locales/uk
+
+6 exports. `import { … } from '@mk-kit/ui/locales/uk';`
+
+### mkPluralUk (function)
+
+Import: `import { mkPluralUk } from '@mk-kit/ui/locales/uk';`
+
+Picks the Ukrainian plural form for a count — CLDR's `uk` rules for
+integers: `one` when the number ends in 1 (but not 11), `few` when it ends
+in 2–4 (but not 12–14), `many` otherwise.
+
+```ts
+mkPluralUk(1, 'результат', 'результати', 'результатів');  // 'результат'
+mkPluralUk(3, 'результат', 'результати', 'результатів');  // 'результати'
+mkPluralUk(11, 'результат', 'результати', 'результатів'); // 'результатів'
+```
+
+```ts
+function mkPluralUk(count: number, one: string, few: string, many: string): string
+```
+
+### provideMkI18nUk (function)
+
+Import: `import { provideMkI18nUk } from '@mk-kit/ui/locales/uk';`
+
+Provides the Ukrainian strings — `MK_UK_I18N` with any `overrides`
+merged on top (deep for `dateNames`, `blockEditor` and `validation`, like
+`provideMkI18n`).
+
+```ts
+bootstrapApplication(App, {
+  providers: [provideMkI18nUk({ noData: 'Тут нічого немає' })],
+});
+```
+
+```ts
+function provideMkI18nUk(overrides?: MkI18nOverrides): Provider
+```
+
+### MK_UK_BLOCK_EDITOR (const)
+
+Import: `import { MK_UK_BLOCK_EDITOR } from '@mk-kit/ui/locales/uk';`
+
+Ukrainian strings of the block editor's chrome.
+
+```ts
+const MK_UK_BLOCK_EDITOR: MkBlockEditorStrings;
+```
+
+### MK_UK_DATE_NAMES (const)
+
+Import: `import { MK_UK_DATE_NAMES } from '@mk-kit/ui/locales/uk';`
+
+Ukrainian month and weekday names (Sunday-first, lowercase as in `Intl`).
+
+```ts
+const MK_UK_DATE_NAMES: MkDateNames;
+```
+
+### MK_UK_I18N (const)
+
+Import: `import { MK_UK_I18N } from '@mk-kit/ui/locales/uk';`
+
+The complete Ukrainian string map — every key of `MkI18nStrings`,
+`locale: 'uk-UA'` and `currency: 'UAH'` for the formatting pipes.
+Provide it whole with `provideMkI18nUk`, or pass it as the base of
+`provideMkI18n(overrides, MK_UK_I18N)`.
+
+```ts
+const MK_UK_I18N: MkI18nStrings;
+```
+
+### MK_UK_VALIDATION (const)
+
+Import: `import { MK_UK_VALIDATION } from '@mk-kit/ui/locales/uk';`
+
+Ukrainian validation messages rendered by `mk-form-field`.
+
+```ts
+const MK_UK_VALIDATION: MkValidationStrings;
+```
+
 ## @mk-kit/ui/testing
 
 23 exports. `import { … } from '@mk-kit/ui/testing';`

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.46.0. 170 components, 41 directives, 16 services and 133 helper functions across 24 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.48.0. 170 components, 41 directives, 16 services and 144 helper functions across 29 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.
 

package/package.json

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