@ikas/code-components-mcp 1.4.0-beta.45 → 1.4.0-beta.46
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/data/framework.json
CHANGED
|
@@ -565,8 +565,8 @@
|
|
|
565
565
|
},
|
|
566
566
|
"translations": {
|
|
567
567
|
"title": "Localizing Labels — Prop & Group Translations (CLI)",
|
|
568
|
-
"description": "Add or remove per-locale translations of prop
|
|
569
|
-
"content": "## Localizing Labels — Translations\n\
|
|
568
|
+
"description": "Add or remove per-locale translations of prop, prop-group, and component-name labels (displayName/description/name) with the CLI: set-prop-translation, set-group-translation, remove-prop-translation, remove-group-translation. Keywords: translation, çeviri, locale, localization, i18n.",
|
|
569
|
+
"content": "## Localizing Labels — Translations\n\nThe component/section's own **name**, a prop's **label** (`displayName` / `description`) and a prop-group's **label** (`name` / `description`) can be translated per locale. These translations live in a `translations` array on each prop / prop group in `ikas.config.json`:\n\n```json\n{\n \"name\": \"title\",\n \"displayName\": \"Title\",\n \"type\": \"TEXT\",\n \"translations\": [\n { \"id\": \"<auto>\", \"locale\": \"de\", \"displayName\": \"Titel\", \"description\": \"...\" }\n ]\n}\n```\n\n**Do NOT hand-edit the `translations` array.** Use the dedicated CLI commands — they validate the component/prop/group, generate the `id`, and upsert by locale:\n\n```bash\n# Prop label translation (displayName / description)\nnpx ikas-component config set-prop-translation --component MySection --prop title --locale de --displayName \"Titel\" --description \"...\"\n\n# Prop-group label translation (name / description)\nnpx ikas-component config set-group-translation --component MySection --group content --locale de --name \"Inhalt\"\n\n# Component (section) name translation (the component's own name)\nnpx ikas-component config set-component-translation --component MySection --locale de --name \"Mein Abschnitt\"\n\n# Remove a translation for a locale\nnpx ikas-component config remove-prop-translation --component MySection --prop title --locale de\nnpx ikas-component config remove-group-translation --component MySection --group content --locale de\nnpx ikas-component config remove-component-translation --component MySection --locale de\n```\n\nIdentify the component with `--component <PascalCaseName>` or `--component-id <id>`; groups by their local `--group <id>` (the id as written in `ikas.config.json`, e.g. `content`).\n\n### Valid locales — never invent one\n\nThe `--locale` value MUST be one of the editor's **configured** locales. Discover them first:\n\n```bash\nnpx ikas-component config list-locales # → { defaultLocale, locales: [{ locale, isDefault, name }] }\n```\n\nUse only the returned `locale` codes (e.g. `en`, `de`, `tr`). Do NOT guess or invent a locale — an unknown locale is still applied but the dev server logs a warning and it matches no language, so it never appears anywhere. (`list-locales` requires a running dev server with the editor connected.)\n\n### How it reaches the editor\n\n- **Studio owns translations.** They are normally authored by the translation team in the visual editor. Config translations are *seeded* into the editor only for props/groups the studio has never seen yet (first import, or a newly added prop/group).\n- **Live edits are authoritative.** While the dev server (`ikas-component dev`) is running and the editor is connected, a `*-translation` command (or any change to the `translations` in the file) is detected and pushed to the editor live — it overrides the studio value for that (label, locale) and is NOT clobbered on the next reconnect.\n- If you change an **already-imported** prop's translation while the dev server is **not** running, it may be ignored on the next connect (studio-wins). Prefer editing while connected.\n\n### Base label vs. translation\n\n- The **default-locale base label** (`displayName` / `name` / `description`) is code-owned — change it with `config update-prop` / `config update-prop-group`. In the editor's default locale these fields are read-only.\n- The **per-locale `translations`** are what the `*-translation` commands manage.\n\nRun `npx ikas-component config --help` to confirm the commands exist (requires a recent CLI build).",
|
|
570
570
|
"tags": [
|
|
571
571
|
"translation",
|
|
572
572
|
"translations",
|
|
@@ -579,7 +579,11 @@
|
|
|
579
579
|
"remove-prop-translation",
|
|
580
580
|
"remove-group-translation",
|
|
581
581
|
"displayName",
|
|
582
|
-
"label"
|
|
582
|
+
"label",
|
|
583
|
+
"set-component-translation",
|
|
584
|
+
"remove-component-translation",
|
|
585
|
+
"component name",
|
|
586
|
+
"section name"
|
|
583
587
|
]
|
|
584
588
|
}
|
|
585
589
|
}
|
package/data/storefront-api.json
CHANGED