@mk-kit/mcp 0.45.0 → 0.47.0

package/data/api.json

@@ -1,6 +1,6 @@
 {
  "package": "@mk-kit/ui",
- "version": "0.45.0",
+ "version": "0.47.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).",
@@ -10407,7 +10430,7 @@
     },
     {
      "name": "mkDetectCardBrand",
-     "description": "Detect the card network from the leading digits (IIN ranges).",
+     "description": "Detect the card network from the leading digits — `detectCardBrand` from `@mk-kit/validators`.",
      "file": "projects/mk-kit/forms/card-number-input/card-number-input.ts",
      "kind": "function",
      "signatures": [
@@ -10425,7 +10448,7 @@
     },
     {
      "name": "mkIbanChecksum",
-     "description": "ISO 13616 mod-97 check over a compact (no spaces, uppercase) IBAN.\nAssumes the shape `CC00…` has already been length-checked by the caller.",
+     "description": "ISO 7064 MOD 97-10 over a compact (uppercase, no separators) IBAN.",
      "file": "projects/mk-kit/forms/iban-input/iban-input.ts",
      "kind": "function",
      "signatures": [
@@ -10434,7 +10457,7 @@
     },
     {
      "name": "mkIbanIsValid",
-     "description": "Full IBAN validity: known country, exact length, mod-97 check.",
+     "description": "Shape, the registry length for the country and the checksum — delegates\nto `isIban` from `@mk-kit/validators`. Unlike that function this one keeps\nthe input kit's stricter rule that the country must be in the table.",
      "file": "projects/mk-kit/forms/iban-input/iban-input.ts",
      "kind": "function",
      "signatures": [
@@ -10452,7 +10475,7 @@
     },
     {
      "name": "mkLuhnCheck",
-     "description": "Luhn (mod 10) checksum over a digit string.",
+     "description": "Luhn (mod 10) checksum over a digit string — `isLuhn` from `@mk-kit/validators`.",
      "file": "projects/mk-kit/forms/card-number-input/card-number-input.ts",
      "kind": "function",
      "signatures": [
@@ -10461,7 +10484,7 @@
     },
     {
      "name": "mkNipChecksum",
-     "description": "Polish NIP checksum: the weighted sum of the first nine digits modulo 11 is\nthe tenth (check) digit. A remainder of 10 can never be a digit, so such a\nnumber is invalid whatever its last digit.",
+     "description": "Polish NIP checksum — delegates to `isNip` from `@mk-kit/validators`\n(weights 6-5-7-2-3-4-5-6-7 mod 11; a remainder of 10 is invalid).",
      "file": "projects/mk-kit/forms/tax-id-input/tax-id-input.ts",
      "kind": "function",
      "signatures": [
@@ -10522,7 +10545,7 @@
     },
     {
      "name": "MK_IBAN_LENGTHS",
-     "description": "IBAN length per ISO 13616 country code (SEPA + common others).",
+     "description": "IBAN lengths per country — re-exported from `@mk-kit/validators`\n(`IBAN_LENGTHS`, the SWIFT registry).",
      "file": "projects/mk-kit/forms/iban-input/iban-input.ts",
      "kind": "const",
      "type": "Readonly<Record<string, number>>"
@@ -22459,6 +22482,85 @@
     }
    ]
   },
+  {
+   "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/pl",
    "import": "@mk-kit/ui/locales/pl",

package/data/llms-full.txt

@@ -1,4 +1,4 @@
-# @mk-kit/ui 0.45.0 — full API reference
+# @mk-kit/ui 0.47.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';`
@@ -6822,7 +6866,7 @@ function mkCountryFlag(code: string): string
 
 Import: `import { mkDetectCardBrand } from '@mk-kit/ui/forms';`
 
-Detect the card network from the leading digits (IIN ranges).
+Detect the card network from the leading digits — `detectCardBrand` from `@mk-kit/validators`.
 
 ```ts
 function mkDetectCardBrand(digits: string): MkCardBrand | null
@@ -6842,8 +6886,7 @@ function mkHighlight(src: string, language: string): string
 
 Import: `import { mkIbanChecksum } from '@mk-kit/ui/forms';`
 
-ISO 13616 mod-97 check over a compact (no spaces, uppercase) IBAN.
-Assumes the shape `CC00…` has already been length-checked by the caller.
+ISO 7064 MOD 97-10 over a compact (uppercase, no separators) IBAN.
 
 ```ts
 function mkIbanChecksum(compact: string): boolean
@@ -6853,7 +6896,9 @@ function mkIbanChecksum(compact: string): boolean
 
 Import: `import { mkIbanIsValid } from '@mk-kit/ui/forms';`
 
-Full IBAN validity: known country, exact length, mod-97 check.
+Shape, the registry length for the country and the checksum — delegates
+to `isIban` from `@mk-kit/validators`. Unlike that function this one keeps
+the input kit's stricter rule that the country must be in the table.
 
 ```ts
 function mkIbanIsValid(compact: string): boolean
@@ -6879,7 +6924,7 @@ function mkIbanValidator(): ValidatorFn
 
 Import: `import { mkLuhnCheck } from '@mk-kit/ui/forms';`
 
-Luhn (mod 10) checksum over a digit string.
+Luhn (mod 10) checksum over a digit string — `isLuhn` from `@mk-kit/validators`.
 
 ```ts
 function mkLuhnCheck(digits: string): boolean
@@ -6889,9 +6934,8 @@ function mkLuhnCheck(digits: string): boolean
 
 Import: `import { mkNipChecksum } from '@mk-kit/ui/forms';`
 
-Polish NIP checksum: the weighted sum of the first nine digits modulo 11 is
-the tenth (check) digit. A remainder of 10 can never be a digit, so such a
-number is invalid whatever its last digit.
+Polish NIP checksum — delegates to `isNip` from `@mk-kit/validators`
+(weights 6-5-7-2-3-4-5-6-7 mod 11; a remainder of 10 is invalid).
 
 ```ts
 function mkNipChecksum(compact: string): boolean
@@ -6975,7 +7019,8 @@ const MK_CARD_BRAND_NAMES: Record<MkCardBrand, string>;
 
 Import: `import { MK_IBAN_LENGTHS } from '@mk-kit/ui/forms';`
 
-IBAN length per ISO 13616 country code (SEPA + common others).
+IBAN lengths per country — re-exported from `@mk-kit/validators`
+(`IBAN_LENGTHS`, the SWIFT registry).
 
 ```ts
 const MK_IBAN_LENGTHS: Readonly<Record<string, number>>;
@@ -15000,6 +15045,99 @@ 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/pl
 
 6 exports. `import { … } from '@mk-kit/ui/locales/pl';`

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.45.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.47.0. 170 components, 41 directives, 16 services and 136 helper functions across 25 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.45.0",
+  "version": "0.47.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",