@mk-kit/mcp 0.44.0 → 0.46.0

package/data/api.json

@@ -1,6 +1,6 @@
 {
  "package": "@mk-kit/ui",
- "version": "0.44.0",
+ "version": "0.46.0",
  "site": "https://mk-kit.dev",
  "entries": [
   {
@@ -463,6 +463,15 @@
       "<T>(value: MkResponsive<T>): value is Partial<Record<MkBreakpoint, T>>"
      ]
     },
+    {
+     "name": "mkMergeI18n",
+     "description": "Merges `overrides` over a complete string map — shallow for the top level,\ndeep for the `dateNames`, `blockEditor` and `validation` groups. Exported\nso locale packs and tests can build a map without providing it.",
+     "file": "projects/mk-kit/core/i18n/mk-i18n.ts",
+     "kind": "function",
+     "signatures": [
+      "(base: MkI18nStrings, overrides: MkI18nOverrides): MkI18nStrings"
+     ]
+    },
     {
      "name": "mkQueryCompact",
      "description": "Drop empty groups and rules that still need a value, so the API gets only complete conditions.",
@@ -582,11 +591,11 @@
     },
     {
      "name": "provideMkI18n",
-     "description": "Provide localised strings (merged over the English defaults) — pass any\nsubset. The nested `dateNames`, `blockEditor` and `validation` groups are\nmerged deeply, so partial overrides of those work too.\n\n```ts\nbootstrapApplication(App, {\n  providers: [provideMkI18n({ noResults: 'Brak wyników', close: 'Zamknij' })],\n});\n```",
+     "description": "Provide localised strings — pass any subset, merged over `base` (the\nEnglish defaults unless given). The nested `dateNames`, `blockEditor` and\n`validation` groups are merged deeply, so partial overrides of those work\ntoo.\n\n```ts\nbootstrapApplication(App, {\n  providers: [provideMkI18n({ noResults: 'Brak wyników', close: 'Zamknij' })],\n});\n```\n\nA locale pack is a complete map that serves as the base — either through\nits own helper (`provideMkI18nPl(overrides)` from `@mk-kit/ui/locales/pl`)\nor explicitly: `provideMkI18n(overrides, MK_PL_I18N)`.",
      "file": "projects/mk-kit/core/i18n/mk-i18n.ts",
      "kind": "function",
      "signatures": [
-      "(overrides: Partial<Omit<MkI18nStrings, \"dateNames\" | \"blockEditor\" | \"validation\">> & { dateNames?: Partial<MkDateNames>; blockEditor?: Partial<MkBlockEditorStrings>; validation?: Partial<MkValidationStrings>; }): Provider"
+      "(overrides: MkI18nOverrides, base?: MkI18nStrings): Provider"
      ],
      "docs": "/core-services"
     },
@@ -3124,6 +3133,13 @@
      "kind": "type",
      "definition": "Readonly<Record<string, string | ((err: any) => string)>>"
     },
+    {
+     "name": "MkI18nOverrides",
+     "description": "Any subset of `MkI18nStrings`; the nested `dateNames`, `blockEditor`\nand `validation` groups may be partial too (they are merged deeply).",
+     "file": "projects/mk-kit/core/i18n/mk-i18n.ts",
+     "kind": "type",
+     "definition": "Partial< Omit<MkI18nStrings, 'dateNames' | 'blockEditor' | 'validation'> > & { dateNames?: Partial<MkDateNames>; blockEditor?: Partial<MkBlockEditorStrings>; validation?: Partial<MkValidationStrings>; }"
+    },
     {
      "name": "MkPlacement",
      "description": "Common placement values for overlays (menus, tooltips, popovers).",
@@ -10391,7 +10407,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": [
@@ -10409,7 +10425,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": [
@@ -10418,7 +10434,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": [
@@ -10436,7 +10452,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": [
@@ -10445,7 +10461,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": [
@@ -10506,7 +10522,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>>"
@@ -22443,6 +22459,58 @@
     }
    ]
   },
+  {
+   "name": "locales/pl",
+   "import": "@mk-kit/ui/locales/pl",
+   "exports": [
+    {
+     "name": "mkPluralPl",
+     "description": "Picks the Polish plural form for a count: `one` for 1, `few` for 2–4\n(except 12–14), `many` otherwise — CLDR's `pl` rules for integers, which is\nall the library's counts ever are.\n\n```ts\nmkPluralPl(1, 'wynik', 'wyniki', 'wyników');  // 'wynik'\nmkPluralPl(3, 'wynik', 'wyniki', 'wyników');  // 'wyniki'\nmkPluralPl(12, 'wynik', 'wyniki', 'wyników'); // 'wyników'\n```",
+     "file": "projects/mk-kit/locales/pl/pl.ts",
+     "kind": "function",
+     "signatures": [
+      "(count: number, one: string, few: string, many: string): string"
+     ]
+    },
+    {
+     "name": "provideMkI18nPl",
+     "description": "Provides the Polish strings — `MK_PL_I18N` with any `overrides`\nmerged on top (deep for `dateNames`, `blockEditor` and `validation`, like\n`provideMkI18n`).\n\n```ts\nbootstrapApplication(App, {\n  providers: [provideMkI18nPl({ noData: 'Nic tu nie ma' })],\n});\n```",
+     "file": "projects/mk-kit/locales/pl/pl.ts",
+     "kind": "function",
+     "signatures": [
+      "(overrides?: MkI18nOverrides): Provider"
+     ]
+    },
+    {
+     "name": "MK_PL_BLOCK_EDITOR",
+     "description": "Polish strings of the block editor's chrome.",
+     "file": "projects/mk-kit/locales/pl/pl.ts",
+     "kind": "const",
+     "type": "MkBlockEditorStrings"
+    },
+    {
+     "name": "MK_PL_DATE_NAMES",
+     "description": "Polish month and weekday names (Sunday-first, lowercase as in `Intl`).",
+     "file": "projects/mk-kit/locales/pl/pl.ts",
+     "kind": "const",
+     "type": "MkDateNames"
+    },
+    {
+     "name": "MK_PL_I18N",
+     "description": "The complete Polish string map — every key of `MkI18nStrings`,\n`locale: 'pl-PL'` and `currency: 'PLN'` for the formatting pipes.\nProvide it whole with `provideMkI18nPl`, or pass it as the base of\n`provideMkI18n(overrides, MK_PL_I18N)`.",
+     "file": "projects/mk-kit/locales/pl/pl.ts",
+     "kind": "const",
+     "type": "MkI18nStrings"
+    },
+    {
+     "name": "MK_PL_VALIDATION",
+     "description": "Polish validation messages rendered by `mk-form-field`.",
+     "file": "projects/mk-kit/locales/pl/pl.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.44.0 — full API reference
+# @mk-kit/ui 0.46.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
 
-74 exports. `import { … } from '@mk-kit/ui/core';`
+76 exports. `import { … } from '@mk-kit/ui/core';`
 
 ### MkAnchoredPanel (directive)
 
@@ -386,6 +386,18 @@ True when `value` is a per-breakpoint map rather than a plain value.
 function mkIsResponsive<T>(value: MkResponsive<T>): value is Partial<Record<MkBreakpoint, T>>
 ```
 
+### mkMergeI18n (function)
+
+Import: `import { mkMergeI18n } from '@mk-kit/ui/core';`
+
+Merges `overrides` over a complete string map — shallow for the top level,
+deep for the `dateNames`, `blockEditor` and `validation` groups. Exported
+so locale packs and tests can build a map without providing it.
+
+```ts
+function mkMergeI18n(base: MkI18nStrings, overrides: MkI18nOverrides): MkI18nStrings
+```
+
 ### mkQueryCompact (function)
 
 Import: `import { mkQueryCompact } from '@mk-kit/ui/core';`
@@ -555,9 +567,10 @@ Docs: https://mk-kit.dev/core-services
 
 Import: `import { provideMkI18n } from '@mk-kit/ui/core';`
 
-Provide localised strings (merged over the English defaults) — pass any
-subset. The nested `dateNames`, `blockEditor` and `validation` groups are
-merged deeply, so partial overrides of those work too.
+Provide localised strings — pass any subset, merged over `base` (the
+English defaults unless given). The nested `dateNames`, `blockEditor` and
+`validation` groups are merged deeply, so partial overrides of those work
+too.
 
 ```ts
 bootstrapApplication(App, {
@@ -565,8 +578,12 @@ bootstrapApplication(App, {
 });
 ```
 
+A locale pack is a complete map that serves as the base — either through
+its own helper (`provideMkI18nPl(overrides)` from `@mk-kit/ui/locales/pl`)
+or explicitly: `provideMkI18n(overrides, MK_PL_I18N)`.
+
 ```ts
-function provideMkI18n(overrides: Partial<Omit<MkI18nStrings, "dateNames" | "blockEditor" | "validation">> & { dateNames?: Partial<MkDateNames>; blockEditor?: Partial<MkBlockEditorStrings>; validation?: Partial<MkValidationStrings>; }): Provider
+function provideMkI18n(overrides: MkI18nOverrides, base?: MkI18nStrings): Provider
 ```
 
 ### MK_BREAKPOINTS (token)
@@ -1362,6 +1379,17 @@ to a function receiving that key's error payload.
 type MkErrorMessages = Readonly<Record<string, string | ((err: any) => string)>>;
 ```
 
+### MkI18nOverrides (type)
+
+Import: `import { MkI18nOverrides } from '@mk-kit/ui/core';`
+
+Any subset of `MkI18nStrings`; the nested `dateNames`, `blockEditor`
+and `validation` groups may be partial too (they are merged deeply).
+
+```ts
+type MkI18nOverrides = Partial< Omit<MkI18nStrings, 'dateNames' | 'blockEditor' | 'validation'> > & { dateNames?: Partial<MkDateNames>; blockEditor?: Partial<MkBlockEditorStrings>; validation?: Partial<MkValidationStrings>; };
+```
+
 ### MkPlacement (type)
 
 Import: `import { MkPlacement } from '@mk-kit/ui/core';`
@@ -6794,7 +6822,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
@@ -6814,8 +6842,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
@@ -6825,7 +6852,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
@@ -6851,7 +6880,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
@@ -6861,9 +6890,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
@@ -6947,7 +6975,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>>;
@@ -14972,6 +15001,89 @@ Load lifecycle of an `MkImage`.
 type MkImageState = 'loading' | 'loaded' | 'error';
 ```
 
+## @mk-kit/ui/locales/pl
+
+6 exports. `import { … } from '@mk-kit/ui/locales/pl';`
+
+### mkPluralPl (function)
+
+Import: `import { mkPluralPl } from '@mk-kit/ui/locales/pl';`
+
+Picks the Polish plural form for a count: `one` for 1, `few` for 2–4
+(except 12–14), `many` otherwise — CLDR's `pl` rules for integers, which is
+all the library's counts ever are.
+
+```ts
+mkPluralPl(1, 'wynik', 'wyniki', 'wyników');  // 'wynik'
+mkPluralPl(3, 'wynik', 'wyniki', 'wyników');  // 'wyniki'
+mkPluralPl(12, 'wynik', 'wyniki', 'wyników'); // 'wyników'
+```
+
+```ts
+function mkPluralPl(count: number, one: string, few: string, many: string): string
+```
+
+### provideMkI18nPl (function)
+
+Import: `import { provideMkI18nPl } from '@mk-kit/ui/locales/pl';`
+
+Provides the Polish strings — `MK_PL_I18N` with any `overrides`
+merged on top (deep for `dateNames`, `blockEditor` and `validation`, like
+`provideMkI18n`).
+
+```ts
+bootstrapApplication(App, {
+  providers: [provideMkI18nPl({ noData: 'Nic tu nie ma' })],
+});
+```
+
+```ts
+function provideMkI18nPl(overrides?: MkI18nOverrides): Provider
+```
+
+### MK_PL_BLOCK_EDITOR (const)
+
+Import: `import { MK_PL_BLOCK_EDITOR } from '@mk-kit/ui/locales/pl';`
+
+Polish strings of the block editor's chrome.
+
+```ts
+const MK_PL_BLOCK_EDITOR: MkBlockEditorStrings;
+```
+
+### MK_PL_DATE_NAMES (const)
+
+Import: `import { MK_PL_DATE_NAMES } from '@mk-kit/ui/locales/pl';`
+
+Polish month and weekday names (Sunday-first, lowercase as in `Intl`).
+
+```ts
+const MK_PL_DATE_NAMES: MkDateNames;
+```
+
+### MK_PL_I18N (const)
+
+Import: `import { MK_PL_I18N } from '@mk-kit/ui/locales/pl';`
+
+The complete Polish string map — every key of `MkI18nStrings`,
+`locale: 'pl-PL'` and `currency: 'PLN'` for the formatting pipes.
+Provide it whole with `provideMkI18nPl`, or pass it as the base of
+`provideMkI18n(overrides, MK_PL_I18N)`.
+
+```ts
+const MK_PL_I18N: MkI18nStrings;
+```
+
+### MK_PL_VALIDATION (const)
+
+Import: `import { MK_PL_VALIDATION } from '@mk-kit/ui/locales/pl';`
+
+Polish validation messages rendered by `mk-form-field`.
+
+```ts
+const MK_PL_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.44.0. 170 components, 41 directives, 16 services and 130 helper functions across 23 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.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`.
 
 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.44.0",
+  "version": "0.46.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",