@krizaka/sovkora-design-system 0.0.0-stage → 4.0.0

package/registry/badge.json

@@ -0,0 +1,97 @@
+{
+  "name": "badge",
+  "type": "composite",
+  "title": "Badge",
+  "summary": "The @krizaka/ui badge with the 1.x `variant` kept as a deprecated alias of `tone`.",
+  "description": "The @krizaka/ui badge with the 1.x `variant` kept as a deprecated alias of `tone`.",
+  "why": "Sovkora 1.x badges took `variant` (`default`, `success`…); the platform says `tone`. This adapter maps one onto the other so the apps keep working while they migrate.",
+  "status": "stable",
+  "deprecated": null,
+  "category": "data-display",
+  "platforms": "web",
+  "builtOn": [
+    "ui/badge"
+  ],
+  "whenToUse": [
+    "In code already importing `Badge` from `@krizaka/sovkora-design-system`: a model's state, a job's status."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "In new code: import `Badge` from `@krizaka/ui/badge` and write `tone`.",
+      "use": "ui/badge"
+    }
+  ],
+  "bestPractices": [
+    "Write `tone`, not `variant` (deprecated since 2.0; `default` → `neutral`).",
+    "One or two words: `Local`, `Running`, `Failed`."
+  ],
+  "accessibility": {
+    "keyboard": [],
+    "notes": [
+      "The primitive's: a `<span>` read with its content; the colour is never the only signal."
+    ]
+  },
+  "related": [
+    "ui/badge"
+  ],
+  "web": {
+    "entry": "@krizaka/sovkora-design-system",
+    "import": "import { Badge } from \"@krizaka/sovkora-design-system\";",
+    "props": [
+      {
+        "component": "Badge",
+        "description": "The",
+        "props": [
+          {
+            "name": "dot",
+            "type": "boolean",
+            "default": null,
+            "description": "A small dot before the text, in the tone's colour (pulsing with `pulse`).",
+            "required": false
+          },
+          {
+            "name": "pulse",
+            "type": "boolean",
+            "default": null,
+            "description": "Makes the `dot` pulse (stopped under reduced motion).",
+            "required": false
+          },
+          {
+            "name": "size",
+            "type": "\"sm\" | \"md\"",
+            "default": "sm",
+            "description": "sm · md.",
+            "required": false
+          },
+          {
+            "name": "tone",
+            "type": "\"neutral\" | \"accent\" | \"success\" | \"warning\" | \"danger\" | \"scrim\"",
+            "default": "neutral",
+            "description": "neutral · accent · success · warning · danger (soft tints, the text stays a text role) · scrim (on a media).",
+            "required": false
+          },
+          {
+            "name": "variant",
+            "type": "BadgeVariant",
+            "default": null,
+            "description": "@deprecated Since 2.0 — use `tone` (`default` → `neutral`, the other names are the same).",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "model-state",
+        "title": "A model's state",
+        "description": "Local, loading, failed — the tones of the primitive.",
+        "path": "examples/badge/model-state.tsx",
+        "module": "@krizaka/sovkora-design-system/registry/examples/badge/model-state",
+        "code": "import { Badge } from \"@krizaka/sovkora-design-system\";\n\n// A model's state in the console: `tone`, never the deprecated `variant`.\nexport default function ModelState() {\n  return (\n    <div className=\"flex flex-wrap gap-2\">\n      <Badge tone=\"success\" dot>\n        Local · ready\n      </Badge>\n      <Badge tone=\"accent\" dot pulse>\n        Loading\n      </Badge>\n      <Badge tone=\"danger\">Failed</Badge>\n    </div>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
+  "dependencies": [],
+  "registryDependencies": []
+}

package/registry/button.json

@@ -0,0 +1,140 @@
+{
+  "name": "button",
+  "type": "composite",
+  "title": "Button",
+  "summary": "The @krizaka/ui button with the Sovkora 1.x default kept: without a `variant`, it is the primary (orange) button.",
+  "description": "The @krizaka/ui button with the Sovkora 1.x default kept: without a `variant`, it is the primary (orange) button.",
+  "why": "Sovkora 1.x buttons were primary by default; the platform's default is `secondary`. This adapter keeps the 1.x default so the apps written against it look the same — everything else is the primitive's.",
+  "status": "stable",
+  "deprecated": null,
+  "category": "actions",
+  "platforms": "web",
+  "builtOn": [
+    "ui/button"
+  ],
+  "whenToUse": [
+    "In code already importing `Button` from `@krizaka/sovkora-design-system`."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "In new code: import `Button` from `@krizaka/ui/button` and say the variant.",
+      "use": "ui/button"
+    }
+  ],
+  "bestPractices": [
+    "One primary action per view: pass `variant=\"secondary\"` or `\"ghost\"` to the others.",
+    "Lock it while sending (`disabled` + `loading`): the input-blocking rule (ERR-126)."
+  ],
+  "accessibility": {
+    "keyboard": [],
+    "notes": [
+      "The primitive's: a native `<button>`, its focus ring, `loading` sets `aria-busy`."
+    ]
+  },
+  "related": [
+    "ui/button",
+    "icon"
+  ],
+  "web": {
+    "entry": "@krizaka/sovkora-design-system",
+    "import": "import { Button } from \"@krizaka/sovkora-design-system\";",
+    "props": [
+      {
+        "component": "Button",
+        "description": "The",
+        "props": [
+          {
+            "name": "announce",
+            "type": "string",
+            "default": null,
+            "description": "A message announced politely by assistive technology when it changes (“Saved”, “Upload failed”) — passed translated.",
+            "required": false
+          },
+          {
+            "name": "asChild",
+            "type": "boolean",
+            "default": null,
+            "description": "Renders the child (e.g. a <Link>) instead of the <button>, with props, classes and ref merged.",
+            "required": false
+          },
+          {
+            "name": "indicator",
+            "type": "boolean",
+            "default": "true",
+            "description": "Shows the glyph while `loading` / with a `status`. `false`: you draw your own.",
+            "required": false
+          },
+          {
+            "name": "loading",
+            "type": "boolean",
+            "default": null,
+            "description": "Disables and signals the wait (aria-busy, data-loading) and shows the Krizaka loader glyph before the label; the\nbutton keeps its colour.",
+            "required": false
+          },
+          {
+            "name": "magnetic",
+            "type": "boolean",
+            "default": null,
+            "description": "@deprecated Since 3.31 (krizaka-ui#393): does nothing — a button never moves under the pointer. Removed in 4.0.",
+            "required": false
+          },
+          {
+            "name": "progress",
+            "type": "number | null",
+            "default": null,
+            "description": "Between 0 and 1, while `loading`: the glyph's trace and a light fill across the button grow to the value (an\nupload, an export).",
+            "required": false
+          },
+          {
+            "name": "shape",
+            "type": "\"rounded\" | \"pill\" | \"cut\"",
+            "default": "rounded",
+            "description": "`rounded` (an 8 px radius, the radius of a field) · `pill`. `cut` is deprecated (krizaka-ui#393: the chamfer is\nretired) — it draws `rounded` and warns in development; it will be removed in 4.0.",
+            "required": false
+          },
+          {
+            "name": "shimmer",
+            "type": "boolean",
+            "default": null,
+            "description": "@deprecated Since 3.31 (krizaka-ui#393): does nothing — the hover is quiet. Removed in 4.0.",
+            "required": false
+          },
+          {
+            "name": "size",
+            "type": "\"sm\" | \"md\" | \"lg\" | \"icon\"",
+            "default": "md",
+            "description": "sm · md · lg, or `icon` (a square).",
+            "required": false
+          },
+          {
+            "name": "status",
+            "type": "\"success\" | \"error\" | null",
+            "default": null,
+            "description": "How the action ended: `success` draws a check, `error` a cross (and the button shakes its head once); a ring of\nthe status colour opens around it. Clear it to return to rest.",
+            "required": false
+          },
+          {
+            "name": "variant",
+            "type": "\"danger\" | \"primary\" | \"gradient\" | \"secondary\" | \"outline\" | \"ghost\"",
+            "default": "primary",
+            "description": "The look: `primary` (the accent), `gradient` (accent → accent-2), `secondary` (a raised surface), `outline`,\n`ghost`, `danger`.",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "send",
+        "title": "Send a prompt",
+        "description": "The primary by default; locked while the answer is generated.",
+        "path": "examples/button/send.tsx",
+        "module": "@krizaka/sovkora-design-system/registry/examples/button/send",
+        "code": "\"use client\";\n\nimport { Button } from \"@krizaka/sovkora-design-system\";\nimport { useState } from \"react\";\n\n// Primary by default (the 1.x default); locked while the answer is generated (ERR-126).\nexport default function Send() {\n  const [generating, setGenerating] = useState(false);\n  const send = () => {\n    setGenerating(true);\n    setTimeout(() => setGenerating(false), 1500);\n  };\n  return (\n    <Button loading={generating} disabled={generating} onClick={send}>\n      Send\n    </Button>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
+  "dependencies": [],
+  "registryDependencies": []
+}

package/registry/chat-showcase.json

@@ -0,0 +1,113 @@
+{
+  "name": "chat-showcase",
+  "type": "composite",
+  "title": "Chat showcase",
+  "summary": "A self-playing sovereign AI chat: a question, the answer typed out, the interceptor pipeline it went through, and the promise that nothing left the premises.",
+  "description": "A self-playing sovereign AI chat: a question, the answer typed out, the interceptor pipeline it went through, and the promise that nothing left the premises.",
+  "why": "Sovkora sells one idea — your AI answers on your own machines, through a deterministic pipeline, with zero data egress. A chat bubble from @krizaka/ui cannot tell that story; this composite stages it the same way on the website, the client app and the console: the persona asks, the engine answers locally, the pipeline chips land, the privacy line closes.",
+  "status": "stable",
+  "deprecated": null,
+  "category": "data-display",
+  "platforms": "web",
+  "builtOn": [],
+  "whenToUse": [
+    "On a home or a product page, to show what Sovkora does in one glance.",
+    "In an empty state of the chat (first visit), as a demonstration before the first question."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "For a real conversation: this is a scripted mockup, not a chat."
+    },
+    {
+      "when": "For a short status of the engine (online, model).",
+      "use": "ui/badge"
+    }
+  ],
+  "bestPractices": [
+    "Speak as a named persona with a real need (\"Eric, finance lead\"), never an admin or a test account.",
+    "The pipeline names steps the reader understands (`PII masked`, `Routed locally`), not class names.",
+    "Every word is a prop (`labels`, `question`, `answer`, `pipeline`): the app translates them.",
+    "One per page: it moves, and two moving mockups compete."
+  ],
+  "accessibility": {
+    "keyboard": [],
+    "notes": [
+      "`role=\"img\"` with the question and the answer as its name: a screen reader hears the exchange once, not the typing.",
+      "Under `prefers-reduced-motion` the final state shows at once: no typing, no pulse, no caret.",
+      "The composer is the kit's `MessageComposer` (pill), `inert` and `aria-hidden`: it is the same component as the app's chat, not a field here."
+    ]
+  },
+  "related": [
+    "icon",
+    "sentinel-mini",
+    "ui/card"
+  ],
+  "web": {
+    "entry": "@krizaka/sovkora-design-system",
+    "import": "import { ChatShowcase } from \"@krizaka/sovkora-design-system\";",
+    "props": [
+      {
+        "component": "ChatShowcase",
+        "description": "Renders the animated sovereign-chat card.",
+        "props": [
+          {
+            "name": "answer",
+            "type": "string",
+            "default": null,
+            "description": "The assistant's scripted answer (typed out char-by-char).",
+            "required": true
+          },
+          {
+            "name": "labels",
+            "type": "ChatShowcaseLabels",
+            "default": null,
+            "description": "The chrome's words, translated: the agent's name, its status, the model, the \"answered locally\" tag, the privacy line, the composer's placeholder.",
+            "required": true
+          },
+          {
+            "name": "pipeline",
+            "type": "string[]",
+            "default": null,
+            "description": "Interceptor pipeline steps rendered as chips once the answer lands.",
+            "required": true
+          },
+          {
+            "name": "question",
+            "type": "string",
+            "default": null,
+            "description": "The user's scripted question.",
+            "required": true
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "default": null,
+            "description": "Extra classes on the wrapper (width, placement), merged last.",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "sovereign-answer",
+        "title": "A sovereign answer",
+        "description": "Eric asks about a contract; the answer is computed on premises and the pipeline shows the steps.",
+        "path": "examples/chat-showcase/sovereign-answer.tsx",
+        "module": "@krizaka/sovkora-design-system/registry/examples/chat-showcase/sovereign-answer",
+        "code": "import { ChatShowcase } from \"@krizaka/sovkora-design-system\";\n\n// Eric, finance lead, asks about a contract: the engine answers on premises, nothing leaves.\nexport default function SovereignAnswer() {\n  return (\n    <ChatShowcase\n      labels={{\n        agent: \"Sovkora · Finance desk\",\n        status: \"On premises · online\",\n        model: \"llama-3.1-70b\",\n        routed: \"Answered locally\",\n        privacy: \"0 bytes left your network\",\n        placeholder: \"Ask about your documents…\",\n      }}\n      question=\"Eric here — which supplier contracts renew before March, and at what notice?\"\n      answer=\"Three renew before March: Northwind (90 days' notice, by Dec 2), Calder Logistics (60 days, by Jan 4) and Ivo Print (30 days, by Feb 1). Northwind's clause also caps the increase at 3 %.\"\n      pipeline={[\"PII masked\", \"Policy checked\", \"Routed locally\", \"Cited 3 contracts\"]}\n    />\n  );\n}\n"
+      },
+      {
+        "name": "french",
+        "title": "In the reader's language",
+        "description": "The same mockup with the words of another locale — every word is a prop.",
+        "path": "examples/chat-showcase/french.tsx",
+        "module": "@krizaka/sovkora-design-system/registry/examples/chat-showcase/french",
+        "code": "import { ChatShowcase } from \"@krizaka/sovkora-design-system\";\n\n// The same mockup in French: every word is a prop, translated by the app.\nexport default function French() {\n  return (\n    <ChatShowcase\n      labels={{\n        agent: \"Sovkora · Service juridique\",\n        status: \"Sur site · en ligne\",\n        model: \"mistral-small\",\n        routed: \"Répondu en local\",\n        privacy: \"0 octet n'a quitté votre réseau\",\n        placeholder: \"Posez une question sur vos documents…\",\n      }}\n      question=\"Camille ici — quels contrats contiennent une clause de non-concurrence ?\"\n      answer=\"Deux contrats : celui de Hélène Morel (12 mois, Île-de-France) et celui de Bastien Roy (6 mois, sans zone). Aucun autre n'en contient.\"\n      pipeline={[\"Données masquées\", \"Politique vérifiée\", \"Routé en local\"]}\n    />\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
+  "dependencies": [],
+  "registryDependencies": []
+}

package/registry/clip-player.json

@@ -0,0 +1,120 @@
+{
+  "name": "clip-player",
+  "type": "composite",
+  "title": "Clip player",
+  "summary": "A short clip that is plainly a clip: a muted loop that plays in view, a badge with its length, play/pause and sound buttons, and a click that opens it larger.",
+  "description": "A short clip that is plainly a clip: a muted loop that plays in view, a badge with its length, play/pause and sound buttons, and a click that opens it larger.",
+  "why": "A 5-second generated clip is shown as a loop, not as a video page: it must read as a video at a glance (badge), play by itself only while it is on screen, stay quiet, give the visitor the controls on hover and focus, and open large with the native controls. @krizaka/ui's player is built for long videos; this one is the product's way to show a result.",
+  "status": "beta",
+  "deprecated": null,
+  "category": "data-display",
+  "platforms": "web",
+  "builtOn": [
+    "ui/button",
+    "ui/dialog"
+  ],
+  "whenToUse": [
+    "A generated clip of a few seconds in a gallery, a result page or a card.",
+    "Anywhere a loop must start and stop with the viewport and respect reduced motion."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "A long video, subtitles, chapters or streaming.",
+      "use": "ui/video-player"
+    },
+    {
+      "when": "A decorative background loop with no controls: a muted `<video>` is enough."
+    }
+  ],
+  "bestPractices": [
+    "Give both files: `webm` is tried first, `mp4` is the fallback every browser reads.",
+    "Give the poster: it is what reduced motion and the first paint show.",
+    "Name the clip in a sentence (`title`): it is the video's accessible name and the dialog's title."
+  ],
+  "accessibility": {
+    "keyboard": [
+      {
+        "keys": "Tab",
+        "action": "Reaches the frame (open larger), play/pause and sound."
+      },
+      {
+        "keys": "Enter / Space",
+        "action": "Activates the focused button."
+      },
+      {
+        "keys": "Escape",
+        "action": "Closes the large view."
+      }
+    ],
+    "notes": [
+      "Nothing plays by itself under `prefers-reduced-motion`: the poster and a play button.",
+      "The clip is muted and `playsInline`; the sound button is a toggle (`aria-pressed`).",
+      "A pause by hand sticks: scrolling away and back does not restart it."
+    ]
+  },
+  "related": [
+    "video-result",
+    "run-facts",
+    "ui/video-player"
+  ],
+  "web": {
+    "entry": "@krizaka/sovkora-design-system",
+    "import": "import { ClipPlayer } from \"@krizaka/sovkora-design-system\";",
+    "props": [
+      {
+        "component": "ClipPlayer",
+        "description": "A clip that is plainly a clip: muted loop that plays only while on screen (and pauses off screen and in a hidden\ntab), a badge, play/pause and sound buttons on hover and focus (always shown where the pointer cannot hover), and a\nclick anywhere on the frame opens it larger in a dialog with the native controls. Under `prefers-reduced-motion` it\nnever plays by itself: the poster and a play button. Plain files, `playsInline`, `preload=\"none\"`.",
+        "props": [
+          {
+            "name": "labels",
+            "type": "ClipPlayerLabels",
+            "default": null,
+            "description": "The words.",
+            "required": true
+          },
+          {
+            "name": "sources",
+            "type": "ClipSources",
+            "default": null,
+            "description": "The files.",
+            "required": true
+          },
+          {
+            "name": "title",
+            "type": "string",
+            "default": null,
+            "description": "The accessible name of the video: what it shows, in a sentence.",
+            "required": true
+          },
+          {
+            "name": "className",
+            "type": "string",
+            "default": null,
+            "description": "Extra classes on the video, merged last.",
+            "required": false
+          },
+          {
+            "name": "orientation",
+            "type": "\"landscape\" | \"portrait\"",
+            "default": "landscape",
+            "description": "The shape of the frame: a 16:9 one by default, a portrait one as tall as a phone allows.",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "tea-pour",
+        "title": "A loop in a card",
+        "description": "Eric's tea-pour shot: badge, controls on hover, opens larger on click.",
+        "path": "examples/clip-player/tea-pour.tsx",
+        "module": "@krizaka/sovkora-design-system/registry/examples/clip-player/tea-pour",
+        "code": "import { ClipPlayer } from \"@krizaka/sovkora-design-system\";\n\n// Eric's tea-pour shot as a loop: it plays in view, the controls show on hover, a click opens it larger.\nexport default function TeaPour() {\n  return (\n    <div className=\"max-w-xl overflow-hidden rounded-2xl border border-border-default\">\n      <ClipPlayer\n        title=\"Mint tea pouring into an engraved glass in a Berber tent\"\n        sources={{\n          mp4: \"https://krizaka-assets.b-cdn.net/site/products/orazaka/gallery-video/tea-pour.c4138c8ce9.mp4\",\n          webm: \"https://krizaka-assets.b-cdn.net/site/products/orazaka/gallery-video/tea-pour.b33e468733.webm\",\n          poster:\n            \"https://krizaka-assets.b-cdn.net/site/products/orazaka/gallery-video/tea-pour-poster.8a062e63c2.webp\",\n        }}\n        labels={{\n          badge: \"Video · 5 s\",\n          play: \"Play\",\n          pause: \"Pause\",\n          mute: \"Mute\",\n          unmute: \"Sound on\",\n          enlarge: \"Open larger\",\n          close: \"Close\",\n        }}\n      />\n    </div>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
+  "dependencies": [],
+  "registryDependencies": []
+}

package/registry/command-palette.json

@@ -0,0 +1,116 @@
+{
+  "name": "command-palette",
+  "type": "composite",
+  "title": "Command palette",
+  "summary": "The Sovkora ⌘K palette: jump to a studio, a chat, a setting — sections, registry icons and a footer of hints, on the platform's command dialog.",
+  "description": "The Sovkora ⌘K palette: jump to a studio, a chat, a setting — sections, registry icons and a footer of hints, on the platform's command dialog.",
+  "why": "`CommandDialog` from @krizaka/ui gives the combobox, the filtering, the focus trap and Escape. Sovkora adds what is its own: the ⌘K / Ctrl+K shortcut, entries grouped by section with the Sovkora icon registry, and the footer of keyboard hints its consoles share.",
+  "status": "stable",
+  "deprecated": null,
+  "category": "navigation",
+  "platforms": "web",
+  "builtOn": [
+    "ui/command",
+    "ui/kbd",
+    "ui/dialog"
+  ],
+  "whenToUse": [
+    "Once per app shell: the client app and the console, for power users who navigate by keyboard.",
+    "To reach an action that has no place in the navigation (new chat, switch theme)."
+  ],
+  "whenNotToUse": [
+    {
+      "when": "As the only way to reach a page: everything stays reachable from the navigation."
+    },
+    {
+      "when": "For a search over content (documents, conversations) with results to read.",
+      "use": "ui/command"
+    }
+  ],
+  "bestPractices": [
+    "Pass `commands` and `labels` translated (both required since 3.0).",
+    "Give `onNavigate` outside Next.js (or in tests); inside, it uses the router.",
+    "Short labels, verbs for actions (`New chat`), nouns for places (`Studios`)."
+  ],
+  "accessibility": {
+    "keyboard": [
+      {
+        "keys": "⌘ K / Ctrl K",
+        "action": "Opens and closes the palette."
+      },
+      {
+        "keys": "↑ ↓",
+        "action": "Moves through the results."
+      },
+      {
+        "keys": "Enter",
+        "action": "Runs the highlighted entry."
+      },
+      {
+        "keys": "Esc",
+        "action": "Closes it and returns the focus."
+      }
+    ],
+    "notes": [
+      "A dialog with a combobox and a listbox (cmdk on Radix): named by `labels.label`, results by `labels.results`."
+    ]
+  },
+  "related": [
+    "icon",
+    "ui/command",
+    "ui/kbd"
+  ],
+  "web": {
+    "entry": "@krizaka/sovkora-design-system",
+    "import": "import { CommandPalette } from \"@krizaka/sovkora-design-system\";",
+    "props": [
+      {
+        "component": "CommandPalette",
+        "description": "The Sovkora ⌘K palette: a product composite on `CommandDialog` from `@krizaka/ui/command` (cmdk + the platform's\ndialog: the combobox and listbox roles, the arrows, Enter, the filtering, the focus trap, Escape). It adds what is\nSovkora's: the shortcut, the registry icons, the sections and the footer of hints. Words and entries arrive as\nprops (since 3.0 they are required: the 1.x English defaults are gone).",
+        "props": [
+          {
+            "name": "commands",
+            "type": "CommandPaletteItem[]",
+            "default": null,
+            "description": "The entries, grouped by `section` in their order.",
+            "required": true
+          },
+          {
+            "name": "labels",
+            "type": "CommandPaletteLabels",
+            "default": null,
+            "description": "The words, translated.",
+            "required": true
+          },
+          {
+            "name": "onNavigate",
+            "type": "((href: string) => void)",
+            "default": null,
+            "description": "Where an entry's `href` goes. Default: the Next.js router (`router.push`).",
+            "required": false
+          },
+          {
+            "name": "shortcut",
+            "type": "string",
+            "default": "k",
+            "description": "The letter that opens it with ⌘ / Ctrl. Default `k`.",
+            "required": false
+          }
+        ]
+      }
+    ],
+    "examples": [
+      {
+        "name": "workspace",
+        "title": "Eric's workspace",
+        "description": "Studios, chats and settings, opened with ⌘K or the button.",
+        "path": "examples/command-palette/workspace.tsx",
+        "module": "@krizaka/sovkora-design-system/registry/examples/command-palette/workspace",
+        "code": "\"use client\";\n\nimport { CommandPalette } from \"@krizaka/sovkora-design-system\";\n\n// Eric's workspace: ⌘K / Ctrl+K opens it; entries and words are props.\nexport default function Workspace() {\n  return (\n    <div className=\"flex flex-col items-start gap-2 text-sm text-fg-secondary\">\n      <p>Press ⌘K (Ctrl+K) to open the palette.</p>\n      <CommandPalette\n        onNavigate={() => {}}\n        labels={{\n          label: \"Command palette\",\n          placeholder: \"Go to…\",\n          results: \"Results\",\n          empty: \"Nothing matches.\",\n          navigate: \"move\",\n          open: \"open\",\n          close: \"close\",\n        }}\n        commands={[\n          { id: \"studios\", label: \"Studios\", icon: \"studio\", href: \"/studios\", section: \"Go to\" },\n          { id: \"chat\", label: \"Contracts assistant\", icon: \"chat\", href: \"/chat/contracts\", section: \"Go to\" },\n          { id: \"new-chat\", label: \"New chat\", icon: \"newChat\", href: \"/chat/new\", section: \"Actions\" },\n          { id: \"models\", label: \"Local models\", icon: \"model\", href: \"/settings/models\", section: \"Settings\" },\n        ]}\n      />\n    </div>\n  );\n}\n"
+      }
+    ]
+  },
+  "native": null,
+  "dependencies": [],
+  "registryDependencies": []
+}

package/registry/examples/badge/model-state.tsx

@@ -0,0 +1,16 @@
+import { Badge } from "@krizaka/sovkora-design-system";
+
+// A model's state in the console: `tone`, never the deprecated `variant`.
+export default function ModelState() {
+  return (
+    <div className="flex flex-wrap gap-2">
+      <Badge tone="success" dot>
+        Local · ready
+      </Badge>
+      <Badge tone="accent" dot pulse>
+        Loading
+      </Badge>
+      <Badge tone="danger">Failed</Badge>
+    </div>
+  );
+}

package/registry/examples/button/send.tsx

@@ -0,0 +1,18 @@
+"use client";
+
+import { Button } from "@krizaka/sovkora-design-system";
+import { useState } from "react";
+
+// Primary by default (the 1.x default); locked while the answer is generated (ERR-126).
+export default function Send() {
+  const [generating, setGenerating] = useState(false);
+  const send = () => {
+    setGenerating(true);
+    setTimeout(() => setGenerating(false), 1500);
+  };
+  return (
+    <Button loading={generating} disabled={generating} onClick={send}>
+      Send
+    </Button>
+  );
+}

package/registry/examples/chat-showcase/french.tsx

@@ -0,0 +1,20 @@
+import { ChatShowcase } from "@krizaka/sovkora-design-system";
+
+// The same mockup in French: every word is a prop, translated by the app.
+export default function French() {
+  return (
+    <ChatShowcase
+      labels={{
+        agent: "Sovkora · Service juridique",
+        status: "Sur site · en ligne",
+        model: "mistral-small",
+        routed: "Répondu en local",
+        privacy: "0 octet n'a quitté votre réseau",
+        placeholder: "Posez une question sur vos documents…",
+      }}
+      question="Camille ici — quels contrats contiennent une clause de non-concurrence ?"
+      answer="Deux contrats : celui de Hélène Morel (12 mois, Île-de-France) et celui de Bastien Roy (6 mois, sans zone). Aucun autre n'en contient."
+      pipeline={["Données masquées", "Politique vérifiée", "Routé en local"]}
+    />
+  );
+}