@mk-kit/mcp 0.47.0 → 0.49.0

package/data/llms-full.txt

@@ -1,4 +1,4 @@
-# @mk-kit/ui 0.47.0 — full API reference
+# @mk-kit/ui 0.49.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
 
-79 exports. `import { … } from '@mk-kit/ui/core';`
+81 exports. `import { … } from '@mk-kit/ui/core';`
 
 ### MkAnchoredPanel (directive)
 
@@ -274,7 +274,7 @@ panel — flipping to the opposite side when it would overflow and clamping
 back inside the viewport.
 
 ```ts
-function mkComputeAnchoredPosition(anchor: MkRectLike, panel: MkSize, viewport: MkSize, opts: MkAnchoredPositionOptions): MkAnchoredPosition
+function mkComputeAnchoredPosition(anchor: MkRectLike, panel: MkDimensions, viewport: MkDimensions, opts: MkAnchoredPositionOptions): MkAnchoredPosition
 ```
 
 ### mkCreateQueryGroup (function)
@@ -438,7 +438,7 @@ Import: `import { mkQueryOperatorLabel } from '@mk-kit/ui/core';`
 Localised label of an operator.
 
 ```ts
-function mkQueryOperatorLabel(op: MkQueryOperator, i18n?: MkI18nStrings): string
+function mkQueryOperatorLabel(op: MkQueryOperator, i18n?: MkQueryTextStrings): string
 ```
 
 ### mkQueryOperatorsFor (function)
@@ -501,7 +501,7 @@ Human-readable sentence for a query, e.g.
 `(Name contains "ada" and Orders at least 10) or Status is any of Active, Invited`.
 
 ```ts
-function mkQueryToText(group: MkQueryGroup, fields?: readonly MkQueryField[], i18n?: MkI18nStrings): string
+function mkQueryToText(group: MkQueryGroup, fields?: readonly MkQueryField[], i18n?: MkQueryTextStrings): string
 ```
 
 ### mkSignalErrorMessage (function)
@@ -701,6 +701,16 @@ Operators offered per field type, in menu order.
 const MK_QUERY_OPERATORS: Readonly<Record<MkQueryValueType, readonly MkQueryOperator[]>>;
 ```
 
+### MK_QUERY_TEXT_EN (const)
+
+Import: `import { MK_QUERY_TEXT_EN } from '@mk-kit/ui/core';`
+
+English defaults for `MkQueryTextStrings`.
+
+```ts
+const MK_QUERY_TEXT_EN: MkQueryTextStrings;
+```
+
 ### MK_QUERY_UNARY (const)
 
 Import: `import { MK_QUERY_UNARY } from '@mk-kit/ui/core';`
@@ -877,9 +887,7 @@ Members:
 
 Import: `import { MkDateNames } from '@mk-kit/ui/core';`
 
-Localised date-name tables consumed by the calendar, the date/month/week
-pickers and `formatDate`. All arrays are full-length (12 months, 7 weekdays
-starting with Sunday) — override the whole set for a locale.
+Localised month and weekday name tables (the shape `MK_I18N` carries).
 
 Members:
 
@@ -1258,6 +1266,41 @@ Members:
 | `operator` | `MkQueryOperator` |  |
 | `value`? | `unknown` |  |
 
+### MkQueryTextStrings (interface)
+
+Import: `import { MkQueryTextStrings } from '@mk-kit/ui/core';`
+
+The strings `mkQueryToText` and `mkQueryOperatorLabel` render
+with. A structural subset of mk-kit's `MkI18nStrings`, so the UI's full
+i18n map can be passed directly; defaults to `MK_QUERY_TEXT_EN`.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `queryTrue` | `string` |  |
+| `queryFalse` | `string` |  |
+| `queryAnd` | `string` |  |
+| `queryOr` | `string` |  |
+| `queryNot` | `string` |  |
+| `queryOpEq` | `string` |  |
+| `queryOpNeq` | `string` |  |
+| `queryOpContains` | `string` |  |
+| `queryOpNotContains` | `string` |  |
+| `queryOpStartsWith` | `string` |  |
+| `queryOpEndsWith` | `string` |  |
+| `queryOpGt` | `string` |  |
+| `queryOpGte` | `string` |  |
+| `queryOpLt` | `string` |  |
+| `queryOpLte` | `string` |  |
+| `queryOpBetween` | `string` |  |
+| `queryOpIn` | `string` |  |
+| `queryOpNotIn` | `string` |  |
+| `queryOpBefore` | `string` |  |
+| `queryOpAfter` | `string` |  |
+| `queryOpEmpty` | `string` |  |
+| `queryOpNotEmpty` | `string` |  |
+
 ### MkSignalValidationError (interface)
 
 Import: `import { MkSignalValidationError } from '@mk-kit/ui/core';`
@@ -1438,7 +1481,7 @@ type MkOverlayRootFn = () => HTMLElement;
 
 Import: `import { MkPlacement } from '@mk-kit/ui/core';`
 
-Common placement values for overlays (menus, tooltips, popovers).
+Common placement values for anchored overlays (menus, tooltips, popovers).
 
 ```ts
 type MkPlacement = | 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
@@ -15138,6 +15181,250 @@ Members:
 | `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';`
@@ -15221,6 +15508,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.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`.
+> 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.49.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.47.0",
+  "version": "0.49.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",