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

package/CHANGELOG.md

@@ -0,0 +1,244 @@
+# Changelog
+
+All notable changes to `@krizaka/sovkora-design-system` (published as `@krizaka/orazaka-design-system` up to 3.4.0). Format: [Keep a Changelog](https://keepachangelog.com/en/1.1.0/);
+versions: [Semantic Versioning](https://semver.org/).
+
+## 4.0.1
+
+### Patch Changes
+
+- Updated dependencies [[`9b63927`](https://github.com/krizaka/krizaka-ui/commit/9b63927f5f7ac45e0b1dce2b43b1ef7fece63e71), [`9b63927`](https://github.com/krizaka/krizaka-ui/commit/9b63927f5f7ac45e0b1dce2b43b1ef7fece63e71), [`e2131ce`](https://github.com/krizaka/krizaka-ui/commit/e2131ce4ad5eb31dc33df541955a1e12ec0dbaf9)]:
+  - @krizaka/ui@4.1.0
+  - @krizaka/icons@0.10.0
+  - @krizaka/tailwind@4.1.0
+  - @krizaka/tokens@4.1.0
+
+## 4.0.0
+
+### Major Changes
+
+- The Sovkora design system, published until 3.4.0 as `@krizaka/orazaka-design-system`, is now `@krizaka/sovkora-design-system`: it lives in krizaka-ui (`packages/sovkora-design-system`, moved from sovkora-ui-kit, ADR-029) and drops the code name. Import `@krizaka/sovkora-design-system` (and `@krizaka/sovkora-design-system/theme.css`); the product tokens are `--sovkora-*` (were `--orazaka-*`), the named theme is « Sovkora Orange » and the registry's product is `sovkora`. It is built on the 4.x platform: `@krizaka/ui`, `@krizaka/tokens` and `@krizaka/tailwind` ^4.0.0 (workspace siblings); `theme.css` imports `@krizaka/tokens/brands/sovkora.css` (the same orange as the former `brands/orazaka.css`) and the docs point to `SovkoraLogo`. An app moves to it together with `@krizaka/ui` 4. `ChatShowcase` reads the reduced-motion preference in render (same behaviour, no state set inside an effect). Node >= 22. This first release also carries the 3.4.1 fix of the changelog, never published under the old name. Its shared contracts are `@krizaka/sovkora-shared` 2.0.0 (was `@krizaka/orazaka-shared`).
+
+## [3.4.1] — 2026-10-16
+
+### Fixed
+- `@krizaka/tailwind` and `@krizaka/tokens` are declared at `^3.19.0`, like `@krizaka/ui` (they were still `^2.4.0`): npm hoisted tailwind 2.10 to the workspace root, where `theme.css`'s `@import "@krizaka/tailwind"` could not find `@krizaka/ui/motion.css` and every app build failed. A test keeps the three on one major.
+
+## [3.4.0] — 2026-10-16
+
+### Changed
+- `ChatShowcase`'s footer is now an instance of `@krizaka/ui`'s `MessageComposer` (`variant="pill"`, inert) instead of a drawing, so the home hero and the app's chat share one component; the privacy line is its status row. New optional label `send`. Depends on `@krizaka/ui` ^3.19.0.
+
+## [3.3.1] — 2026-10-15
+
+### Fixed
+- `RunFacts`: a value wraps at its spaces and breaks only a word that does not fit (`overflow-wrap: anywhere`); it used
+  `break-all`, which cut sentences mid-word in narrow columns.
+
+## [3.3.0] — 2026-10-15
+
+### Added
+- `ClipPlayer`: a short clip that is plainly a clip — a muted loop that plays only in view (a pause by hand sticks), a
+  "Video · 5 s" badge, play/pause and sound buttons on hover and focus, a click that opens it larger in a dialog with the
+  native controls; poster and a play button under reduced motion.
+- `RunFacts`: what a run recorded, as a description list.
+
+### Changed
+- `VideoResult` is built on them (a loop in view instead of a still player), takes `promptNode` (the app may type the
+  prompt in) and `reproduceLead`; its labels gain the player's words. New dependency: `@krizaka/icons`.
+
+## [3.2.0] — 2026-10-15
+
+### Added
+- `VideoResult`: what a video run of a Studio leaves — the clip in a player with its poster, the exact prompt, the facts
+  the run recorded (model, seed, frame, length, time, cost, run id), "Reproduce it" as a `@krizaka/ui` CodeBlock, and a
+  download. Every word is a prop; a portrait clip is drawn as tall as a phone allows. Documented with `video-result.meta.ts`
+  and two examples; render-tested. Web only: the mobile app draws the same facts natively (tracked in orazaka-mobile-client).
+
+## [3.1.0] — 2026-10-14
+
+### Removed
+- The hand-made sign-in layout of the theme: `.login-split`, `.login-hero*`, `.login-form-panel`, `.auth-legal-*`,
+  `.auth-footer-separator`, `.auth-lang-*`, and the Sentinel HUD animations (`.sentinel-*`, `.hud-pulse`, `.rotator-*`).
+  The apps' entry screens are built on `@krizaka/ui/auth-layout`.
+
+## [3.0.1] — 2026-10-14
+
+### Fixed
+- `ChatShowcase`: the card is sized by its final state (an invisible copy of the finished conversation shares its grid
+  cell), so it no longer grows while the answer types in — the page around it does not shift (CLS 0). Reduced motion
+  shows the final state directly. Tests guard it.
+
+## [3.0.0] — 2026-10-11
+
+The kit keeps only what is Orazaka's: the theme, the composites, and the few primitives it re-exports with an Orazaka
+default. Everything @krizaka/ui 2.4 now draws is imported from there — the apps (web client, console) moved first.
+
+### Removed (breaking)
+
+- `Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardContent`, `CardFooter`, `Dialog`, `ToastContainer` (the
+  1.x adapters, deprecated since 2.3): compose `Card.*` (`@krizaka/ui/card`), `Dialog.*` (`@krizaka/ui/dialog`),
+  `Toaster` + `toast` (`@krizaka/ui/toast`). Their documentation pages go with them.
+- The 1.x defaults of `CommandPalette`: `commands` and `labels` are required.
+- The "2.x compatibility" block of `theme.css` — the 1.x variables (`--surface-1`, `--text-primary`, `--accent`…), their
+  utilities (`text-text-primary`, `bg-card-bg`, `text-status-success`…) — and the 1.x theme classes (`html.cyberpunk`…):
+  write the roles (`bg-surface-1`, `text-fg`, `text-accent`, `text-fg-danger`) and `html.theme-<name>`.
+
+### Changed
+
+- On `@krizaka/ui` ^2.4.0, `@krizaka/tailwind` / `@krizaka/tokens` ^2.4.0 (Loader, Stepper, Progress with ETA, the
+  job toasts, Meter, NumberTicker, GlowCard, the gliding Tabs, NavBar; DS3: DataTable, Pagination, FilterBar…).
+
+## [2.5.0] — 2026-10-11
+
+The kit documents itself: krizaka.com/docs/orazaka/ui is generated from its code, like /docs/ui from @krizaka/ui.
+
+### Added
+
+- **The registry** (`registry/`, published; `./registry/*` and `./registry/examples/*` exports), in the format of
+  @krizaka/ui's: one `registry/<name>.json` per component (its `src/components/<name>.meta.ts` — summary, why it exists
+  above Krizaka UI, when to use / not, the @krizaka/ui primitives it is built on, accessibility, related, deprecation;
+  its named examples, `registry/examples/<name>/*.tsx`; its props from their JSDoc), `registry/foundations.json` (the
+  Orazaka Orange theme resolved in both modes and the five named themes, with their WCAG contrasts; the product tokens,
+  the fluid type scale, the typography, the icons, the product rules quoted from the contracts) and `registry/index.json`.
+  Written by `npm run registry` (in `check`, and before `npm pack`).
+- `scripts/registry.test.mjs` (in `npm test`): fails when an exported component has no meta or example, a prop has no
+  description, a reference does not resolve, a theme falls below AA, or an example speaks as an admin.
+- `SkeletonGroupProps`; JSDoc on `ChatShowcase`'s `labels` and `className`.
+
+## [2.4.0] — 2026-10-11
+
+Built on `@krizaka/ui`, `@krizaka/tokens` and `@krizaka/tailwind` **2.1.0** (floor raised from 2.0.0).
+
+### Changed
+
+- **The Orazaka mark is the brand's orange.** `OrazakaLogo` / `ProductLogo id="orazaka"` (and `OrazakaMark` native) of
+  `@krizaka/ui` 2.1.0 leave amber (`#b45309 → #f59e0b`) for deep orange `#b45309` → orange `#dc6509` on the accent's
+  hue 26 — every stop ≥ 3:1 on dark and light pages — read from `marks.orazaka` of `@krizaka/tokens`.
+- `ThemeScript` takes `defaultMode` like `ThemeProvider` (`@krizaka/ui/theme`): an Orazaka app that wants to be dark
+  first passes `defaultMode="dark"` to both — no flash, the visitor's `kz-theme` still wins.
+
+## [2.3.0] — 2026-10-10
+
+No markup of a primitive is left in the kit: what it still drew itself is now drawn by `@krizaka/ui` 2.0.0 (stable).
+No export is removed (semver minor); the 1.x APIs below are deprecated and go in 3.0.
+
+### Changed
+
+- `CommandPalette` is a product composite on `CommandDialog` from `@krizaka/ui/command` (cmdk + the platform dialog:
+  combobox and listbox roles, arrows, Enter, filtering, focus trap, Escape, focus return). New props: `commands`
+  (entries with a `section`, an `icon` of the registry, an `href` and/or `onSelect`, `keywords`), `labels` (the words,
+  translated), `onNavigate` (default `router.push`), `shortcut` (default `k`).
+- `Card`, `CardHeader`, `CardTitle`, `CardDescription`, `CardContent`, `CardFooter` are drawn by `@krizaka/ui/card`
+  (`Card.Root`, `Card.Body`, `Card.Title`…), with their 1.x look kept through `className`.
+- `Dialog` (1.x props: `open`, `onClose`, `title`, `description`, `closeLabel`) is drawn by `@krizaka/ui/dialog` (Radix:
+  focus trap and focus return, which 1.x lacked).
+- `ToastContainer` (1.x controlled list) is drawn by the `@krizaka/ui/toast` `Toaster` (sonner): each item becomes a
+  `toast[variant]` with its id; new optional `label` and `closeLabel`.
+- Dependencies: `@krizaka/ui`, `@krizaka/tokens`, `@krizaka/tailwind` `^2.0.0` (stable). `@krizaka/orazaka-shared`
+  1.1.1 takes `@krizaka/tokens` `^2.0.0` (nothing else changes).
+
+### Deprecated
+
+- `Card*` → `Card.*` from `@krizaka/ui/card`; `Dialog` → `Dialog.*` from `@krizaka/ui/dialog`; `ToastContainer`,
+  `ToastItem`, `ToastVariant` → `Toaster` + `toast` from `@krizaka/ui/toast`; the 1.x defaults of `CommandPalette`
+  (English words, 1.x routes) → pass `labels` and `commands`. All removed in 3.0.
+
+## [2.2.1] — 2026-10-10
+
+### Added
+
+- `Icon` takes an optional `fallback`: the icon drawn when `name` comes from data and is not in the registry (a Studio
+  whose `iconKey` the kit does not know showed an empty square).
+
+### Fixed
+
+- `ChatShowcase`: the composer placeholder reads at AA (`text-fg-secondary`; `text-fg-muted` measured 3.9:1 on
+  `surface-1`, which Lighthouse counts against the page even though the composer is decorative).
+
+### Changed
+
+- `tokens`, `themes`, `status` (re-exported from `@krizaka/orazaka-shared` 1.1.0) are the Orazaka orange for React
+  Native and the CLI too: `dark` and `light` come from `@krizaka/tokens/native`, each theme gains `onAccent` and
+  `accentText`, and `electric` joins the named themes.
+
+## [2.2.0] — 2026-10-09
+
+### Changed
+
+- **Orazaka is orange.** The default theme (dark and light) is the Orazaka brand of `@krizaka/tokens`
+  (`brands/orazaka.css`, imported by `theme.css`): the orange of the Orazaka mark — `hsl(26 92% 55%)` under near-black
+  text in dark (7.4:1), the mark's deep stop `#b45309` under white in light (5.1:1). `info` stays blue. Nothing to
+  change in an app: the roles (`bg-accent`, `text-on-accent`…) take the new values.
+
+### Added
+
+- The named theme `electric` (`html.theme-electric`, `.theme-electric`): Electric Blue, the 2.x identity, for the
+  users who chose it.
+- Every named theme sets its whole accent family (`accent-text`, `accent-2`, `ring`, `info`, section gradient), so an
+  island never keeps the brand's orange; `accent-text` is tested at AA on every surface.
+
+## [2.1.0] — 2026-10-09
+
+### Added
+
+- A named theme also works as an **island**: `.theme-custom`, `.theme-cyberpunk`, `.theme-solarized`, `.theme-krizaka` on
+  any element give it that theme inside any page — as `.theme-dark` does for dark. A theme picker draws its previews
+  with the roles (`bg-surface-1`, `bg-accent`…) inside the island and shows the real tokens. `html.theme-<name>` stays
+  the first selector, so it still outweighs `html.light` on the root.
+
+## [2.0.0] — 2026-10-09
+
+The kit becomes a theme and a set of composites on the Krizaka platform (`@krizaka/tokens`, `@krizaka/tailwind`,
+`@krizaka/ui` 2). No export is removed: every primitive is re-exported, and the 1.x variables stay mapped until 3.0.
+
+### Changed
+
+- `theme.css` is the **Electric Blue** identity expressed as `--kz-*` role overrides, on the organisation's mechanism:
+  dark by default on `:root` (and `.theme-dark`), light on `html.light`, a named theme on `html.theme-<name>`
+  (`custom`, `cyberpunk`, `solarized`, `krizaka`). It imports `@krizaka/tailwind` and `@krizaka/ui/tailwind.css`
+  itself: the app keeps two lines (`tailwindcss`, then this `theme.css`).
+- The accent is the brief's — `hsl(217 92% 60%)` dark, `hsl(217 92% 50%)` light (was amber `hsl(38 92% 50%)`); the
+  surfaces, borders and text are the platform's (the krizaka.com values).
+- **Contrast adjustments (WCAG AA, tested):** white on the dark accent reads 3.6:1, so the dark accent carries
+  near-black text (`--kz-on-accent: hsl(240 6% 5%)`, 5.4:1) and its hover lightens to `hsl(217 92% 66%)` (6.6:1); the
+  same holds for the dark named themes and solarized. Solarized text is darker (primary `hsl(192 14% 25%)`, secondary
+  `hsl(192 14% 32%)`, muted `hsl(186 5% 42%)` — the 1.x primary read 3.7:1); krizaka muted text is `hsl(210 8% 46%)`
+  (was 2.5:1). Named-theme hovers lighten instead of darkening.
+- `Button`, `Badge`, `Input`, `Skeleton` are the `@krizaka/ui` primitives. `Button` keeps `primary` as its default
+  variant; sizes follow the primitive (`lg` is `h-12`, `icon` is `h-10 w-10`); `ref` is a prop (React 19). `Badge` is
+  the platform badge (uppercase, `tone`, `dot`, `pulse`). `Skeleton` keeps `rect` as its default shape.
+- `Card*`, `Dialog`, `ToastContainer`, `CommandPalette`, `ChatShowcase` are tokenized: roles only (`bg-surface-1`,
+  `text-fg-secondary`, `border-border-subtle`, `text-success` / `text-danger` / `text-warning`), no `[var(--…)]`, no
+  `dark:`, no raw palette colour, `cn()` instead of template strings — a `className` override now wins.
+- The 1.x `@custom-variant` declarations are gone: `dark:` comes from `@krizaka/tailwind` (`:root:not(.light)`).
+- Lint: the four UI rules of `@krizaka/config` (strict) and `krizaka-ratchet` at zero; `check` = lint, type-check, Jest,
+  publint (`validate` runs it).
+- The theme's own idle and entrance animations stop under `prefers-reduced-motion`.
+
+### Added
+
+- `IconButton`, `buttonVariants`, `badgeVariants`, `Field`, `Textarea`, `Select`, `skeletonVariants`, `cn`, the
+  `BadgeVariant` and `ButtonVariants` types.
+- Product tokens `--orazaka-accent-glow`, `--orazaka-grid-color`, `--orazaka-space-card`, `--orazaka-space-section`.
+- `src/__tests__/theme.test.ts`: every theme resolved over the `@krizaka/tokens` defaults and held to WCAG AA.
+
+### Deprecated
+
+- `Badge` `variant` → `tone` (`default` → `neutral`).
+- `Skeleton` `variant` → `shape`; `width` / `height` → a `className` or `style`.
+- The **2.x compatibility block** of `theme.css` — the unprefixed 1.x variables (`--surface-*`, `--accent*`,
+  `--text-*`, `--border-*`, `--status-*`, `--radius-*`, `--shadow-*`, `--background`, `--card-*`, `--input-*`…), their
+  utilities (`text-text-primary`, `bg-card-bg`, `bg-status-success`…) and the 1.x theme classes (`html.custom`,
+  `html.cyberpunk`, `html.solarized`, `html.krizaka`). **Removed in 3.0.**
+
+### Removed
+
+- From `theme.css`: the light-on-`:root` / dark-on-`.dark` mechanism and its `prefers-color-scheme` block, the
+  `--accent-h/-s/-l` channels, the `@custom-variant` declarations.
+
+### Not changed
+
+- `@krizaka/orazaka-shared` (types, Zod schemas, tokens) — its `themes` keep the 1.x values for React Native and the
+  CLI. It is CommonJS and `@krizaka/tokens` is ESM-only, so it cannot import the platform tokens yet; the mobile
+  migration does it.

package/LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -1,3 +1,83 @@
-# Temporary Holding Version
+# @krizaka/sovkora-design-system
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+The Sovkora identity on the Krizaka platform: the **Sovkora Orange** theme (the Sovkora brand of `@krizaka/tokens`)
+and its named themes as `--kz-*` token
+overrides, the product composites, and the [`@krizaka/ui`](https://github.com/krizaka/krizaka-ui) primitives
+re-exported. Lives in [`packages/sovkora-design-system`](https://github.com/krizaka/krizaka-ui/tree/main/packages/sovkora-design-system) of krizaka-ui.
+
+## Install
+
+```bash
+npm install @krizaka/sovkora-design-system && npm install -D tailwindcss
+```
+
+React 19, Next.js ≥ 15, Tailwind CSS v4. The package ships its TypeScript sources: add it to `transpilePackages`.
+
+```ts
+// next.config.ts
+transpilePackages: ["@krizaka/sovkora-design-system", "@krizaka/sovkora-shared", "@krizaka/ui"],
+```
+
+The app's global stylesheet — `theme.css` brings the platform layers (`@krizaka/tailwind`, `@krizaka/ui/tailwind.css`)
+itself:
+
+```css
+@import "tailwindcss";
+@import "@krizaka/sovkora-design-system/theme.css";
+```
+
+## Themes
+
+One mechanism, the organisation's: **dark** is the default (`:root`), **light** is `html.light`, a **named theme** is
+`html.theme-<name>` — `electric` (Electric Blue, the 2.x identity), `custom` (Deep Violet), `cyberpunk` (Neon Matrix), `solarized` (Warm Parchment, light),
+`krizaka` (Obsidian Razor, zero radius). A named theme also works as an island: `.theme-<name>` on
+any element gives it that theme inside any page (as `.theme-dark` does for dark) — a theme picker draws real previews.
+A theme is a set of token values, never a set of classes: components write
+roles (`bg-surface-1`, `text-fg-secondary`, `border-border-subtle`, `bg-accent text-on-accent`, `text-danger`) and
+read right in every theme.
+
+| Role | Dark | Light |
+| :--- | :--- | :--- |
+| `--kz-accent` | `hsl(26 92% 55%)` #f67e23 | `hsl(26 90.5% 37.1%)` #b45309 (deep orange, the first stop of the mark) |
+| `--kz-accent-hover` | `hsl(26 92% 62%)` | `hsl(26 90% 31%)` |
+| `--kz-on-accent` | `hsl(240 6% 5%)` — 7.4:1 | white — 5.1:1 |
+| `--kz-accent-text` (`text-fg-accent`) | `hsl(26 92% 60%)` | `hsl(26 90% 32%)` |
+| `--kz-accent-2` | `#f59e0b` (closes the buttons' gradient) | `hsl(32 95% 33%)` |
+| `--kz-info` | blue `hsl(217 92% 60%)` — an orange "info" would read as a warning | `hsl(217 92% 50%)` |
+| surfaces, borders, text | the platform's (`@krizaka/tokens`, the krizaka.com values) | idem |
+
+These values are **not declared here**: `theme.css` imports `@krizaka/tokens/brands/sovkora.css`, the Sovkora brand of
+the Krizaka brand system (`@krizaka/tokens`, `BRAND.md`) — the orange of the Sovkora mark. A change of colour is made
+there, released, then adopted.
+
+Every theme is tested at WCAG AA (`src/__tests__/theme.test.ts`): primary and secondary text ≥ 4.5:1 on every
+surface, muted text ≥ 3:1, on-accent ≥ 4.5:1 on the accent and its hover, the accent as text ≥ 4.5:1 on every
+surface, focus ring ≥ 3:1.
+
+## Contents
+
+| | |
+| :--- | :--- |
+| **Theme** | `theme.css`: the `--kz-*` overrides above, the named themes, the product tokens (`--sovkora-*`), the fluid type scale, the Sovkora layout classes (`glass-card`, `login-*`, `sentinel-*`…). |
+| **Composites** | `ChatShowcase`, `SentinelMini`, `Icon` (the icon registry), `CommandPalette` (the ⌘K palette on `CommandDialog` from `@krizaka/ui/command`: entries and words as props, `onNavigate`). |
+| **Re-exported from `@krizaka/ui`** | `Button` (default variant `primary`, as in 1.x), `IconButton`, `buttonVariants`, `Badge` (`variant` → deprecated alias of `tone`), `badgeVariants`, `Input`, `Field`, `Textarea`, `Select`, `Skeleton` (`variant`, `width`, `height` deprecated), `skeletonVariants`, `cn`. New code imports them from `@krizaka/ui`. |
+| **Documentation** | `registry/`: every component's documentation, examples and props, and the foundations (the themes resolved with their contrasts, the type scale, the rules) — rendered by [krizaka.com/docs/sovkora/ui](https://www.krizaka.com/en/docs/sovkora/ui). |
+| **Tokens** | `tokens`, `themes`, `radius`… re-exported from `@krizaka/sovkora-shared` (for React Native and the CLI: the same Sovkora orange as `theme.css`, from `@krizaka/tokens/native`). |
+| **Everything else** | From `@krizaka/ui` directly: `Card`, `Dialog`, `Toaster` + `toast` / `progressToast` / `groupedToast`, `Loader` / `LoadingRegion`, `Stepper`, `Progress`, `Meter`, `NumberTicker`, `GlowCard`, `Tabs`, `NavBar`… and the charts from `@krizaka/charts`. 3.0 removed the 1.x adapters and variables (see the CHANGELOG). |
+
+A product variant extends a primitive, it never copies it:
+
+```ts
+import { buttonVariants } from "@krizaka/ui/button";
+import { tv } from "tailwind-variants";
+
+export const sovkoraButton = tv({ extend: buttonVariants, variants: { variant: { glow: "shadow-lg shadow-accent/30" } } });
+```
+
+## Develop
+
+```bash
+pnpm turbo run check --filter=@krizaka/sovkora-design-system   # eslint (UI rules strict), type-check, Vitest + the registry test, registry, size, publint
+```
+
+Apache-2.0 · Part of [Krizaka](https://www.krizaka.com).

package/package.json

@@ -1,6 +1,115 @@
 {
   "name": "@krizaka/sovkora-design-system",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "4.0.1",
+  "description": "The Sovkora identity on the Krizaka platform: the Sovkora Orange theme (the Sovkora brand of @krizaka/tokens) and its named themes as --kz-* token overrides, the product composites (ChatShowcase, CommandPalette, SentinelMini, icon registry) with their documentation registry (krizaka.com/docs/sovkora/ui), and the @krizaka/ui primitives re-exported.",
+  "keywords": [
+    "sovkora",
+    "krizaka",
+    "design-system",
+    "theme",
+    "design-tokens",
+    "react",
+    "nextjs",
+    "tailwindcss",
+    "tailwind-v4"
+  ],
+  "homepage": "https://github.com/krizaka/krizaka-ui/tree/main/packages/sovkora-design-system#readme",
+  "bugs": "https://github.com/krizaka/krizaka-ui/issues",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/krizaka/krizaka-ui.git",
+    "directory": "packages/sovkora-design-system"
+  },
+  "license": "Apache-2.0",
+  "author": "Krizaka (https://www.krizaka.com)",
+  "type": "module",
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "exports": {
+    ".": "./src/index.ts",
+    "./theme.css": "./src/theme.css",
+    "./registry/examples/*": "./registry/examples/*.tsx",
+    "./registry/*": "./registry/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "!src/**/__tests__",
+    "registry",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "sideEffects": [
+    "*.css"
+  ],
+  "dependencies": {
+    "tailwind-variants": "^3.3.1",
+    "@krizaka/icons": "^0.10.0",
+    "@krizaka/sovkora-shared": "^2.0.0",
+    "@krizaka/tailwind": "^4.1.0",
+    "@krizaka/tokens": "^4.1.0",
+    "@krizaka/ui": "^4.1.0"
+  },
+  "peerDependencies": {
+    "next": ">=15",
+    "react": ">=19",
+    "react-dom": ">=19",
+    "tailwindcss": "^4.1"
+  },
+  "devDependencies": {
+    "@krizaka/config": "^0.9.1",
+    "@size-limit/preset-small-lib": "^14.2.0",
+    "@testing-library/dom": "^10.4.0",
+    "@testing-library/jest-dom": "^7.0.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/node": "^22.15.0",
+    "@types/react": "^19.2.0",
+    "@types/react-dom": "^19.2.0",
+    "@vitest/coverage-v8": "5.0.5",
+    "eslint": "^9.39.0",
+    "happy-dom": "^21.0.4",
+    "next": "^16.3.0",
+    "publint": "^0.3.25",
+    "react": "^19.3.1",
+    "react-docgen-typescript": "^2.4.0",
+    "react-dom": "^19.3.1",
+    "size-limit": "^14.2.0",
+    "tailwindcss": "^4.3.3",
+    "typescript": "^5.9.0",
+    "vitest": "^5.0.5"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "size-limit": [
+    {
+      "name": ".",
+      "path": "src/index.ts",
+      "limit": "60 kB",
+      "gzip": true,
+      "ignore": [
+        "react",
+        "react-dom",
+        "next",
+        "@krizaka/ui",
+        "@krizaka/icons",
+        "@krizaka/sovkora-shared",
+        "@krizaka/tokens",
+        "@krizaka/tailwind",
+        "tailwind-variants"
+      ]
+    }
+  ],
+  "scripts": {
+    "build": "node scripts/build-registry.mjs",
+    "lint": "eslint . --max-warnings 0 && tsc --noEmit --noUnusedParameters --noFallthroughCasesInSwitch --noImplicitReturns",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --coverage",
+    "size": "size-limit",
+    "publint": "publint"
+  }
 }