@mk-kit/mcp 0.55.0 → 0.56.0

package/data/api.json

@@ -1,6 +1,6 @@
 {
  "package": "@mk-kit/ui",
- "version": "0.55.0",
+ "version": "0.56.0",
  "site": "https://mk-kit.dev",
  "entries": [
   {
@@ -1507,6 +1507,46 @@
        "type": "string",
        "description": "Empty data table / list."
       },
+      {
+       "name": "translationEditorSearch",
+       "type": "string",
+       "description": "Translation editor (`@mk-kit/ui/translate/editor`)."
+      },
+      {
+       "name": "translationEditorAll",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorOverridden",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorMissing",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorKey",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorReset",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorExport",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "translationEditorKeys",
+       "type": "string",
+       "description": ""
+      },
       {
        "name": "resultsCount",
        "type": "(count: number) => string",
@@ -18296,6 +18336,11 @@
        "name": "set",
        "signature": "(lang: string, strings: MkTranslationTree | MkFlatTranslations): void",
        "description": "Replace `lang` entirely (tests, editors reloading from source)."
+      },
+      {
+       "name": "isPartial",
+       "signature": "(lang?: string): boolean",
+       "description": "`true` while `lang` holds only a server render's keys and the rest is still loading."
       }
      ],
      "properties": [
@@ -18454,6 +18499,12 @@
        "description": "Block application bootstrap until the initial language is loaded, so the\nfirst render never shows raw keys and `instant()` calls inside\n`computed()` never cache them. Default `true`.",
        "optional": true
       },
+      {
+       "name": "transfer",
+       "type": "\"none\" | \"used\" | \"all\" | undefined",
+       "description": "What a server render hands to the browser through `TransferState`:\n- `'used'` (default): only the keys read while rendering this page —\n  a few KB — so hydration never flashes raw keys, while the full\n  dictionary loads in the background right after;\n- `'all'`: the whole dictionary (no second request, but every page\n  carries it);\n- `'none'`: nothing; the browser loads the file itself before bootstrap.",
+       "optional": true
+      },
       {
        "name": "documentLang",
        "type": "boolean | undefined",
@@ -24748,6 +24799,106 @@
     }
    ]
   },
+  {
+   "name": "translate/editor",
+   "import": "@mk-kit/ui/translate/editor",
+   "exports": [
+    {
+     "name": "MkTranslationEditor",
+     "description": "Translation editor — keys as rows, locales as columns, click a cell to\nedit. The base strings are your bundled files; edits are **overrides**\nkept apart from them, so a rebuild never loses them and a cell can be\nrestored to the file text. Search by key or text, filter to the keys a\nlocale is missing or the ones already edited, export the grid as CSV.\nPersistence is yours: every edit is emitted as `changed`, feed the result\nback through `overrides`.\n\n```html\n<mk-translation-editor\n  [locales]=\"['pl', 'en', 'ru']\"\n  [base]=\"base()\"\n  [overrides]=\"overrides()\"\n  (changed)=\"save($event)\" />\n```",
+     "file": "projects/mk-kit/translate/editor/translation-editor.ts",
+     "kind": "component",
+     "selector": "mk-translation-editor",
+     "selectors": [
+      "mk-translation-editor"
+     ],
+     "inputs": [
+      {
+       "name": "locales",
+       "type": "string[]",
+       "description": "Locale codes, in column order. The first one is the reference language.",
+       "required": true
+      },
+      {
+       "name": "base",
+       "type": "Record<string, MkFlatTranslations>",
+       "description": "Bundled strings per locale, flat (`'a.b.c': 'text'`) or nested.",
+       "required": true
+      },
+      {
+       "name": "overrides",
+       "type": "Record<string, MkFlatTranslations>",
+       "description": "Edits per locale, flat. Missing locales are fine.",
+       "default": "{}"
+      },
+      {
+       "name": "readonly",
+       "type": "boolean",
+       "description": "Show but do not edit.",
+       "default": "false"
+      },
+      {
+       "name": "exportFilename",
+       "type": "string",
+       "description": "File name of the CSV export.",
+       "default": "'translations.csv'"
+      }
+     ],
+     "outputs": [
+      {
+       "name": "changed",
+       "type": "MkTranslationChange",
+       "description": "An edit or a restore; persist it and update `overrides`."
+      }
+     ],
+     "methods": [],
+     "properties": [],
+     "queries": [],
+     "docs": "/components/translate"
+    },
+    {
+     "name": "MkTranslationChange",
+     "description": "One edit made in the editor. `value: null` clears the override.",
+     "file": "projects/mk-kit/translate/editor/translation-editor.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "locale",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "key",
+       "type": "string",
+       "description": ""
+      },
+      {
+       "name": "value",
+       "type": "string | null",
+       "description": ""
+      },
+      {
+       "name": "previous",
+       "type": "string | null",
+       "description": "The text shown before the edit (override, or the base string)."
+      }
+     ]
+    },
+    {
+     "name": "MkTranslationRow",
+     "description": "A row of the editor: the key plus the effective text per locale.",
+     "file": "projects/mk-kit/translate/editor/translation-editor.ts",
+     "kind": "interface",
+     "members": [
+      {
+       "name": "key",
+       "type": "string",
+       "description": ""
+      }
+     ]
+    }
+   ]
+  },
   {
    "name": "translate/server",
    "import": "@mk-kit/ui/translate/server",

package/data/llms-full.txt

@@ -1,4 +1,4 @@
-# @mk-kit/ui 0.55.0 — full API reference
+# @mk-kit/ui 0.56.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
 
@@ -903,6 +903,14 @@ Members:
 | `noOptions` | `string` | Empty listbox with no options (select, time picker). |
 | `noResults` | `string` | Empty async/filtered results (autocomplete, multi-select, command palette). |
 | `noData` | `string` | Empty data table / list. |
+| `translationEditorSearch` | `string` | Translation editor (`@mk-kit/ui/translate/editor`). |
+| `translationEditorAll` | `string` |  |
+| `translationEditorOverridden` | `string` |  |
+| `translationEditorMissing` | `string` |  |
+| `translationEditorKey` | `string` |  |
+| `translationEditorReset` | `string` |  |
+| `translationEditorExport` | `string` |  |
+| `translationEditorKeys` | `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. |
@@ -12125,6 +12133,7 @@ Methods:
 | `loadedLangs(): string[]` | Languages currently in memory. |
 | `patch(lang: string, strings: MkTranslationTree \| MkFlatTranslations): void` | Merge strings into `lang` at runtime — a translation editor previewing an edit, or a late-arriving overrides payload. Nested or flat. |
 | `set(lang: string, strings: MkTranslationTree \| MkFlatTranslations): void` | Replace `lang` entirely (tests, editors reloading from source). |
+| `isPartial(lang?: string): boolean` | `true` while `lang` holds only a server render's keys and the rest is still loading. |
 
 Properties:
 
@@ -12262,6 +12271,7 @@ Members:
 | `loader` | `MkTranslateLoaderFactory` | Base strings — the bundled JSON, typically (`mkHttpTranslateLoader`). |
 | `overrides`? | `MkTranslateLoaderFactory \| undefined` | Optional second source merged OVER the base per language: edits kept in a database, a tenant's wording, a translator's work in progress. A loader that throws or resolves `{}` leaves the base untouched. |
 | `preload`? | `boolean \| undefined` | Block application bootstrap until the initial language is loaded, so the first render never shows raw keys and `instant()` calls inside `computed()` never cache them. Default `true`. |
+| `transfer`? | `"none" \| "used" \| "all" \| undefined` | What a server render hands to the browser through `TransferState`: - `'used'` (default): only the keys read while rendering this page —   a few KB — so hydration never flashes raw keys, while the full   dictionary loads in the background right after; - `'all'`: the whole dictionary (no second request, but every page   carries it); - `'none'`: nothing; the browser loads the file itself before bootstrap. |
 | `documentLang`? | `boolean \| undefined` | Mirror the active language onto `<html lang>` (server and browser), so screen readers, hyphenation and search engines follow `use()`. Default `true`. |
 | `onMissing`? | `((key: string, lang: string) => string \| undefined \| void) \| undefined` | Called for a key missing in both the active and the fallback language. Return a string to render instead of the key. Missing keys are also collected in `MkTranslate.missingKeys`. |
 
@@ -16642,6 +16652,77 @@ Keys accepted by `MkTestElement.sendKeys` besides printable characters.
 type MkTestKey = | 'Enter' | 'Escape' | 'Tab' | 'Backspace' | 'Delete' | ' ' | 'ArrowUp' | 'ArrowDown' | 'ArrowLeft' | 'ArrowRight' | 'Home' | 'End' | 'PageUp' | 'PageDown';
 ```
 
+## @mk-kit/ui/translate/editor
+
+3 exports. `import { … } from '@mk-kit/ui/translate/editor';`
+
+### MkTranslationEditor (component)
+
+Selector: `mk-translation-editor`
+
+Docs: https://mk-kit.dev/components/translate
+
+Import: `import { MkTranslationEditor } from '@mk-kit/ui/translate/editor';`
+
+Translation editor — keys as rows, locales as columns, click a cell to
+edit. The base strings are your bundled files; edits are **overrides**
+kept apart from them, so a rebuild never loses them and a cell can be
+restored to the file text. Search by key or text, filter to the keys a
+locale is missing or the ones already edited, export the grid as CSV.
+Persistence is yours: every edit is emitted as `changed`, feed the result
+back through `overrides`.
+
+```html
+<mk-translation-editor
+  [locales]="['pl', 'en', 'ru']"
+  [base]="base()"
+  [overrides]="overrides()"
+  (changed)="save($event)" />
+```
+
+Inputs:
+
+| Name | Type | Default | Description |
+| --- | --- | --- | --- |
+| `locales` (required) | `string[]` |  | Locale codes, in column order. The first one is the reference language. |
+| `base` (required) | `Record<string, MkFlatTranslations>` |  | Bundled strings per locale, flat (`'a.b.c': 'text'`) or nested. |
+| `overrides` | `Record<string, MkFlatTranslations>` | `{}` | Edits per locale, flat. Missing locales are fine. |
+| `readonly` | `boolean` | `false` | Show but do not edit. |
+| `exportFilename` | `string` | `'translations.csv'` | File name of the CSV export. |
+
+Outputs:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `changed` | `MkTranslationChange` | An edit or a restore; persist it and update `overrides`. |
+
+### MkTranslationChange (interface)
+
+Import: `import { MkTranslationChange } from '@mk-kit/ui/translate/editor';`
+
+One edit made in the editor. `value: null` clears the override.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `locale` | `string` |  |
+| `key` | `string` |  |
+| `value` | `string \| null` |  |
+| `previous` | `string \| null` | The text shown before the edit (override, or the base string). |
+
+### MkTranslationRow (interface)
+
+Import: `import { MkTranslationRow } from '@mk-kit/ui/translate/editor';`
+
+A row of the editor: the key plus the effective text per locale.
+
+Members:
+
+| Name | Type | Description |
+| --- | --- | --- |
+| `key` | `string` |  |
+
 ## @mk-kit/ui/translate/server
 
 2 exports. `import { … } from '@mk-kit/ui/translate/server';`

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.55.0. 173 components, 45 directives, 17 services and 152 helper functions across 34 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.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`.
 
 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.55.0",
+  "version": "0.56.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",