poeticui 0.1.0

package/README.md

@@ -0,0 +1,95 @@
+# poeticui
+
+> One install. Tokens + components in a single package. The convenience layer over `@artificialpoets/tokens` and `@artificialpoets/components`.
+
+```bash
+bun  add poeticui
+pnpm add poeticui
+npm  install poeticui
+yarn add poeticui
+```
+
+You also need React 19 + the standard styling peers (most projects have these already):
+
+```bash
+bun add react@^19 react-dom@^19 @headlessui/react@^2 clsx@^2 tailwind-merge@^3
+```
+
+For technical-content primitives (`<CodeBlock>`, `<BlockMath>`, `<PackageManagerTabs>`), install the separate content package — it has heavy peers (Shiki, KaTeX):
+
+```bash
+bun add @artificialpoets/content
+```
+
+## Quick start
+
+```tsx
+import { Button, Card, Heading, Text, Badge } from "poeticui";
+
+export default function Welcome() {
+  return (
+    <Card>
+      <Badge color="green">v0.1.0</Badge>
+      <Heading as="h2">Welcome to Poetic UI</Heading>
+      <Text>Built with poeticui.</Text>
+      <Button color="dark/zinc">Get started</Button>
+    </Card>
+  );
+}
+```
+
+Wire the CSS once in your app entry:
+
+```css
+@import "tailwindcss";
+@custom-variant dark (&:where(.dark, .dark *));
+@import "poeticui/styles/tokens";
+```
+
+That's the full install. The library paints with a neutral theme by default; override the 6-slot theme contract in your own CSS to rebrand.
+
+## Two import styles
+
+Pick whichever feels right — both are supported and tree-shake equally well:
+
+```tsx
+// Barrel — simplest
+import { Button, Card, Heading, Input, Switch } from "poeticui";
+
+// Subpath — explicit category, slightly easier to grep for in big codebases
+import { Button } from "poeticui/core";
+import { Card, Heading } from "poeticui/data-display";
+import { Input, Switch } from "poeticui/forms";
+```
+
+## Subpaths
+
+| Subpath | What it re-exports |
+|---|---|
+| `poeticui` | Everything from `@artificialpoets/components` |
+| `poeticui/core` | Button, Link, TouchTarget |
+| `poeticui/data-display` | Avatar, Badge, BadgeButton, Card, Code, DescriptionList family, Divider, Heading, Skeleton, Stat, Strong, Subheading, Table family, Text, TextLink |
+| `poeticui/forms` | Checkbox, Combobox, Fieldset family, Input, Select, Switch family, Textarea, Date-range-picker |
+| `poeticui/feedback` | Alert, Callout, Dialog family, EmptyState, Hint |
+| `poeticui/layout` | DrawerShell, PageHeader, SidebarLayout, StackedLayout |
+| `poeticui/navigation` | Breadcrumbs, Navbar family, Pagination, SegmentedTabs, Sidebar family, Tabs |
+| `poeticui/tables` | DataTable family, FilteredTable, TablePaginationFooter, useDataTableState |
+| `poeticui/misc` | Dropdown family, Popover |
+| `poeticui/icons` | ServiceIcon |
+| `poeticui/lib` | cx() helper |
+| `poeticui/styles/tokens` | CSS — OKLCH palette + semantic variables + Tailwind theme mapping + neutral default theme |
+
+## What this is (and isn't)
+
+This package is a **thin wrapper** — it adds zero source code, zero behavior, and depends on the underlying packages via `^0.1.0`. Use it for ergonomics: one install command, one canonical import path. The underlying packages continue to work and remain installable standalone:
+
+```bash
+# Granular install style — also supported, identical components
+bun add @artificialpoets/components @artificialpoets/tokens
+```
+
+The two styles are interchangeable. Pick whichever fits your project.
+
+## License
+
+Apache-2.0. See [LICENSE](../../LICENSE) at the repo root.

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "poeticui",
+  "version": "0.1.0",
+  "license": "Apache-2.0",
+  "type": "module",
+  "description": "Poetic UI — a neutral, agent-friendly React design system. One install for tokens + components. Apache-2.0.",
+  "keywords": [
+    "design-system",
+    "react",
+    "tailwind",
+    "components",
+    "tokens",
+    "ui",
+    "headless-ui",
+    "oklch",
+    "themable",
+    "agent-friendly"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/artificialpoets/poeticui.git",
+    "directory": "packages/poeticui"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "files": [
+    "src",
+    "styles"
+  ],
+  "main": "./src/index.ts",
+  "types": "./src/index.ts",
+  "sideEffects": [
+    "./styles/*.css"
+  ],
+  "exports": {
+    ".": "./src/index.ts",
+    "./core": "./src/core.ts",
+    "./data-display": "./src/data-display.ts",
+    "./forms": "./src/forms.ts",
+    "./feedback": "./src/feedback.ts",
+    "./layout": "./src/layout.ts",
+    "./misc": "./src/misc.ts",
+    "./navigation": "./src/navigation.ts",
+    "./tables": "./src/tables.ts",
+    "./icons": "./src/icons.ts",
+    "./lib": "./src/lib.ts",
+    "./styles/tokens": "./styles/tokens.css"
+  },
+  "dependencies": {
+    "@artificialpoets/components": "^0.1.0",
+    "@artificialpoets/tokens": "^0.1.0"
+  },
+  "peerDependencies": {
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "@headlessui/react": "^2.0.0",
+    "clsx": "^2.0.0",
+    "tailwind-merge": "^3.0.0"
+  }
+}

package/src/core.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/core";

package/src/data-display.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/data-display";

package/src/feedback.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/feedback";

package/src/forms.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/forms";

package/src/icons.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/icons";

package/src/index.ts

@@ -0,0 +1,22 @@
+/**
+ * @artificialpoets/poeticui — convenience barrel.
+ *
+ * Re-exports the entire surface of @artificialpoets/components. Tokens are
+ * CSS-only and consumed via the `./styles/tokens` subpath, not from here.
+ *
+ * Two valid import styles:
+ *
+ * @example
+ * // Barrel — simplest:
+ * import { Button, Card, Heading } from "@artificialpoets/poeticui";
+ *
+ * @example
+ * // Subpath — explicit, helps some bundlers tree-shake:
+ * import { Button } from "@artificialpoets/poeticui/core";
+ * import { Card } from "@artificialpoets/poeticui/data-display";
+ *
+ * For technical-content primitives (CodeBlock, Math, tabs), install
+ * `@artificialpoets/content` separately. It carries heavy peer deps
+ * (Shiki, KaTeX) and isn't pulled in here.
+ */
+export * from "@artificialpoets/components";

package/src/layout.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/layout";

package/src/lib.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/lib";

package/src/misc.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/misc";

package/src/navigation.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/navigation";

package/src/tables.ts

@@ -0,0 +1 @@
+export * from "@artificialpoets/components/tables";

package/styles/tokens.css

@@ -0,0 +1,6 @@
+/* @artificialpoets/poeticui — tokens entry.
+ * Pass-through to @artificialpoets/tokens so consumers have one CSS import
+ * to remember. Tokens carry zero JS — pure CSS, OKLCH palette, semantic
+ * variables, Tailwind v4 theme mapping, neutral default theme.
+ */
+@import "@artificialpoets/tokens";