@rockshin/tao-ui 0.0.1

package/dist/utils/semantic.d.ts

@@ -0,0 +1,10 @@
+import type { CSSProperties } from 'react';
+/**
+ * Semantic DOM type utilities.
+ * Each component defines its own SemanticPart union and uses these
+ * generic types for the classNames / styles props.
+ */
+export type SemanticClassNames<T extends string> = Partial<Record<T, string>>;
+export type SemanticStyles<T extends string> = Partial<Record<T, CSSProperties>>;
+/** Join class names, filtering out falsy values. */
+export declare function cx(...classes: (string | undefined | false | null)[]): string | undefined;

package/dist/utils/semantic.js

@@ -0,0 +1,5 @@
+function cx(...classes) {
+    const result = classes.filter(Boolean).join(' ');
+    return result || void 0;
+}
+export { cx };

package/llms.txt

@@ -0,0 +1,67 @@
+# @rockshin/tao-ui
+
+> A modern React 19 component library with semantic DOM customization and OKLCH-based theming. Every component exposes `classNames`/`styles` props to target internal parts by semantic name, and inherits `size`/`disabled`/`variant` from a `TaoProvider` whose theme is derived from a small OKLCH seed token set.
+
+## Install
+
+```bash
+npm install @rockshin/tao-ui
+```
+
+Peer dependencies: `react >=19`, `react-dom >=19`, `dayjs >=1.11` (only needed for `DatePicker`/`RangePicker`).
+Module format: ESM only. Types and CSS ship alongside the JS; component CSS is imported as a side effect, so keep tree-shaking aware of CSS (`sideEffects` is declared in package.json).
+
+## Core concepts
+
+- **TaoProvider**: wrap the app once. Provides `size` (`'small' | 'middle' | 'large'`), `disabled`, and `variant` defaults to all descendants, plus theme tokens. A local prop on a component overrides the provider value. Hook: `useTaoConfig()`.
+- **Theming**: a small seed token set (`TaoSeedToken`) is expanded into a full theme. Pure-CSS-computable values use `calc()`/`color-mix()` with OKLCH; non-linear values (radius steps, font-size log scale, control heights) are computed in JS and injected by `TaoProvider`. CSS variables are prefixed `--tao-*`; data attributes are `data-tao-*`.
+- **Semantic DOM**: every component takes optional `classNames?: SemanticClassNames<Part>` and `styles?: SemanticStyles<Part>`, where `Part` is a component-specific union (e.g. `'root' | 'header' | 'body'`, dotted for nested parts like `'header.cell'`). The top-level `className` prop merges into the `root` part. Helper `cx` is exported.
+
+## Usage
+
+```tsx
+import { TaoProvider, Input, Select, Switch } from '@rockshin/tao-ui';
+
+function App() {
+  return (
+    <TaoProvider size="middle">
+      <Input placeholder="Search" />
+      <Select options={[{ label: 'A', value: 'a' }]} />
+      <Switch defaultChecked />
+    </TaoProvider>
+  );
+}
+
+// Style internal parts by semantic name:
+<Drawer classNames={{ root: 'd', header: 'd-h' }} styles={{ body: { padding: 24 } }} />
+```
+
+## Exported API
+
+Provider & utilities:
+- `TaoProvider`, `useTaoConfig`
+- Types: `TaoProviderProps`, `TaoThemeConfig`, `TaoSeedToken`, `TaoSize`, `TaoVariant`
+- `cx`, types `SemanticClassNames<Part>`, `SemanticStyles<Part>`
+
+Components (each exports `<Name>Props` and, where applicable, `<Name>SemanticPart`):
+- General: `Button`
+- Layout: `Stack`, `FormLayout`, `Splitter` (+ `SplitterPanelProps`)
+- Navigation: `Tabs` (+ `TabItem`), `Pagination`
+- Data Entry: `Input`, `Select` (+ `SelectOption`), `Checkbox` / `CheckboxGroup` (+ `CheckboxOptionType`), `Radio` / `RadioGroup` (+ `RadioOptionType`), `Switch`, `DatePicker`, `RangePicker`, `FormField`, `FormSection`, `FormActions`
+- Data Display: `Table` (+ `TableColumn`, `TableRowSelection`, `TableFilterItem`, `TablePagination`, `SortOrder`, `SorterResult`), `Tag` / `CheckableTag` (+ `TagColor`, `TagVariant`), `ScrollArea` (+ `ScrollAreaType`)
+- Feedback: `Drawer` (+ `DrawerPlacement`)
+
+Headless:
+- `useNumberInput`, `NumberInput` (+ `NumberInputProps`, `UseNumberInputOptions`, `UseNumberInputReturn`, `FormatOptions`, `PadDecimalsOnBlur`)
+
+## Notes for code generation
+
+- Import everything from the package root `@rockshin/tao-ui`; there are no deep sub-path entry points.
+- Do not hand-write internal class names; customize via `classNames`/`styles` semantic parts.
+- Prefer setting `size`/`disabled`/`variant` on `TaoProvider` for app-wide defaults; override per-component only when needed.
+- Override theme by passing a partial seed to `TaoProvider`'s theme config rather than overriding `--tao-*` variables directly.
+
+## Source
+
+- Repository: https://github.com/rickyshin93/tao-ui
+- License: MIT

package/package.json

@@ -0,0 +1,97 @@
+{
+  "name": "@rockshin/tao-ui",
+  "version": "0.0.1",
+  "type": "module",
+  "description": "A modern React 19 component library with semantic DOM customization and OKLCH-based theming.",
+  "keywords": [
+    "react",
+    "react19",
+    "component-library",
+    "ui",
+    "design-system",
+    "tao-ui",
+    "oklch"
+  ],
+  "author": "rickyshin",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rickyshin93/tao-ui.git"
+  },
+  "homepage": "https://github.com/rickyshin93/tao-ui#readme",
+  "bugs": "https://github.com/rickyshin93/tao-ui/issues",
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "llms.txt"
+  ],
+  "scripts": {
+    "build": "rslib",
+    "build:storybook": "storybook build",
+    "check": "biome check --write",
+    "dev": "rslib --watch",
+    "doc": "rspress dev",
+    "doc:build": "rspress build",
+    "doc:preview": "rspress preview",
+    "format": "biome format --write",
+    "storybook": "storybook dev",
+    "test": "rstest",
+    "test:watch": "rstest --watch"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.4.14",
+    "@rsbuild/core": "~2.0.6",
+    "@rsbuild/plugin-babel": "^1.1.2",
+    "@rsbuild/plugin-react": "^2.0.0",
+    "@rslib/core": "^0.21.5",
+    "@rspress/core": "^2.0.11",
+    "@rspress/plugin-api-docgen": "^2.0.11",
+    "@rspress/plugin-preview": "^2.0.11",
+    "@rstest/adapter-rslib": "^0.2.2",
+    "@rstest/core": "^0.9.10",
+    "@storybook/addon-docs": "^10.3.6",
+    "@storybook/addon-onboarding": "^10.3.6",
+    "@storybook/react": "^10.3.6",
+    "@tailwindcss/postcss": "^4.3.0",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.2",
+    "@types/node": "^24.12.4",
+    "@types/react": "^19.2.14",
+    "babel-plugin-react-compiler": "^1.0.0",
+    "happy-dom": "^20.9.0",
+    "postcss": "^8.5.15",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "rsbuild-plugin-workspace-dev": "^0.1.4",
+    "storybook": "^10.3.6",
+    "storybook-addon-rslib": "^3.3.3",
+    "storybook-react-rsbuild": "^3.3.3",
+    "tailwindcss": "^4.3.0",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "dayjs": ">=1.11.0",
+    "react": ">=19.0.0",
+    "react-dom": ">=19.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "dependencies": {
+    "@radix-ui/react-dialog": "^1.1.15",
+    "@radix-ui/react-popover": "^1.1.15",
+    "@radix-ui/react-select": "^2.2.6",
+    "@tanstack/react-virtual": "^3.14.2",
+    "dayjs": "^1.11.21"
+  }
+}