@cascivo/react 0.16.1 → 0.17.1

package/dist/tabs/tabs.js

@@ -2,14 +2,15 @@
 
 import e from "./tabs.module.js";
 import { createContext as t, forwardRef as n, useId as r, useRef as i } from "react";
-import { Slot as a, cn as o, useSignal as s, useSignals as c } from "@cascivo/core";
+import { Slot as a, cn as o, useControllableSignal as s, useSignals as c } from "@cascivo/core";
 import { jsx as l } from "react/jsx-runtime";
 //#region ../components/src/tabs/tabs.tsx
 var u = t(null);
 function d({ defaultValue: t, value: n, onValueChange: i, className: a, children: c }) {
-	let d = r(), f = s(n ?? t ?? "");
-	n !== void 0 && (f.value = n);
-	let p = {
+	let d = r(), [f] = s({
+		value: n,
+		defaultValue: t ?? ""
+	}), p = {
 		active: f,
 		baseId: d,
 		setValue: (e) => {

package/dist/toc/toc.js

@@ -2,15 +2,16 @@
 
 import e from "./toc.module.js";
 import { useRef as t } from "react";
-import { cn as n, useSignal as r, useSignalEffect as i, useSignals as a } from "@cascivo/core";
+import { cn as n, useControllableSignal as r, useSignalEffect as i, useSignals as a } from "@cascivo/core";
 import { builtin as o, t as s } from "@cascivo/i18n";
 import { jsx as c } from "react/jsx-runtime";
 //#region ../components/src/toc/toc.tsx
 function l({ items: l, activeId: u, onActiveChange: d, labels: f, className: p }) {
 	a();
-	let m = u !== void 0, h = r(u ?? l[0]?.id ?? "");
-	m && (h.value = u);
-	let g = t(d);
+	let m = u !== void 0, [h] = r({
+		value: u,
+		defaultValue: l[0]?.id ?? ""
+	}), g = t(d);
 	return g.current = d, i(() => {
 		if (m || typeof document > "u" || typeof IntersectionObserver > "u") return;
 		let e = l.map((e) => document.getElementById(e.id)).filter((e) => e !== null);

package/dist/types.d.ts

@@ -0,0 +1,21 @@
+/**
+ * The catalog-wide vocabulary types, importable on the prebuilt path.
+ *
+ * `Status.status` and `Badge.variant` are `ToneInput`; every layout `gap` is a
+ * `SpaceStep`. These declarations are the same ones the main entry's props reference, so
+ * a value typed here is assignable there.
+ *
+ *   import type { Tone } from '@cascivo/react/types'
+ *   const TONE: Record<DeployState, Tone> = { ready: 'success', error: 'danger' }
+ *   <Status status={TONE[deployment.state]} />
+ */
+export type {
+  Tone,
+  ToneAlias,
+  ToneInput,
+  Progress,
+  ProgressAlias,
+  ProgressInput,
+  SpaceStep,
+  RovingOrientation,
+} from '@cascivo/core'

package/dist/types.js

@@ -0,0 +1 @@
+export {}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cascivo/react",
-  "version": "0.16.1",
+  "version": "0.17.1",
   "private": false,
   "description": "Prebuilt cascivo design system components — use without copying source. @cascivo/themes installs with it; pair with @cascivo/charts (data-viz) and @cascivo/icons. Docs offline: npx @cascivo/docs",
   "keywords": [
@@ -33,10 +33,16 @@
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
+      "react-server": "./dist/index.js",
       "node": "./dist/node/index.js",
       "import": "./dist/index.js",
       "default": "./dist/index.js"
     },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.js",
+      "default": "./dist/types.js"
+    },
     "./styles.css": "./dist/styles.css",
     "./package.json": "./package.json"
   },
@@ -45,13 +51,14 @@
     "provenance": true
   },
   "dependencies": {
-    "@cascivo/core": "^0.16.1",
-    "@cascivo/i18n": "^0.16.1",
-    "@cascivo/themes": "^0.4.11"
+    "@cascivo/core": "^0.17.1",
+    "@cascivo/i18n": "^0.17.1",
+    "@cascivo/themes": "^0.4.12"
   },
   "devDependencies": {
     "@testing-library/jest-dom": "^6.9.1",
     "@testing-library/react": "^16.3.2",
+    "@types/node": "^25",
     "@types/react": "^19.2.17",
     "@types/react-dom": "^19.2.3",
     "jsdom": "^29",

package/readme.body.md

@@ -55,26 +55,27 @@ RSC without any extra wrapper.
 
 > **No bundler? (CDN, import maps, plain `<link>`)** Import the aggregate sheet
 > `@cascivo/react/styles.css` — every component's CSS **plus the tokens and the
-> light & dark themes** in one file (~305 KB / ~40 KB gzip, not tree-shaken). It is
+> light & dark themes** in one file (~328 KB / ~47 KB gzip, not tree-shaken). It is
 > self-contained: this single import gives you a fully-colored app with no separate
-> `@cascivo/themes` import. With a bundler (CSR) you don't need it; import it only if
-> you prefer one explicit stylesheet over per-component tree-shaking, or for Vite SSR
-> (below), where it is required.
+> `@cascivo/themes` import. On **any** bundler — CSR, SSR or RSC alike — you don't
+> need it, and importing it costs you the per-component tree-shaking; reach for it
+> only when nothing walks the module graph.
 
 > **Vite SSR / TanStack Start / Remix / workerd?** The 4-line SSR checklist (full
 > recipe: [USING-WITH-VITE-SSR.md](https://github.com/cascivo/cascivo/blob/main/docs/USING-WITH-VITE-SSR.md)):
 >
-> 1. **`ssr: { noExternal: [/^@cascivo\//] }`** in `vite.config` (or the
->    `cascivoSsr()` plugin from `@cascivo/vite-plugin`). Without it a bare
->    server-side ESM loader can't resolve the per-component `.css` side-effect
->    imports and throws `Unknown file extension ".css"`.
+> 1. **No Vite config needed** on 0.10+ — the `node` export condition ships a
+>    CSS-free server build a bare ESM loader can import. Pinned below 0.10? Add
+>    `ssr: { noExternal: [/^@cascivo\//] }` (or the `cascivoSsr()` plugin from
+>    `@cascivo/vite-plugin`), else the loader throws `Unknown file extension ".css"`.
 > 2. **`@preact/signals-react` 3.x** — on React 19 the 2.x line fails to load. The
 >    peer range enforces `>=3`.
-> 3. **Import the CSS once** in your root entry: `@cascivo/react/styles.css` +
->    `@cascivo/themes/all` (+ `@cascivo/charts/styles.css` if you use charts). If you
->    typecheck (`tsc --noEmit`), these bare `.css` imports need ambient types — add
->    `src/vite-env.d.ts` with `/// <reference types="vite/client" />` or
->    `declare module '*.css'`, else TS2307/TS2882.
+> 3. **Import a theme once** in your root entry: `@cascivo/themes/light-dark.css`
+>    (+ `@cascivo/charts/styles.css` if you use charts). Component CSS is automatic
+>    here too — don't add the aggregate. If you typecheck (`tsc --noEmit`), these
+>    bare `.css` imports need ambient types — add `src/vite-env.d.ts` with
+>    `/// <reference types="vite/client" />` or `declare module '*.css'`, else
+>    TS2307/TS2882.
 > 4. **Theme without a mismatch:** inline `themePreloadScript()` in `<head>` and add
 >    `suppressHydrationWarning` to `<html>`, or hard-code `data-theme` for a fixed theme.
 >