refactor: move Next.js app to apps/www/ in monorepo

Move the Next.js documentation site into apps/www/ to create a cleaner
monorepo structure with apps/* and packages/* workspaces. Root package.json
now delegates all scripts to the app via pnpm --filter tool-ui-www.

Author: Yonom

.claude/agents/tool-ui-designer.md

@@ -16,7 +16,7 @@ You design new Tool UI components for this repo.
 ## Context
 
 Tool UI is a copy/paste component library for AI assistant interfaces.
-The product is the source code inside `components/tool-ui/*`, so APIs must be explicit and easy to modify.
+The product is the source code inside `apps/www/components/tool-ui/*`, so APIs must be explicit and easy to modify.
 
 ## Process
 
@@ -40,12 +40,12 @@ Ask deeper questions only when needed:
 ### 3. Pattern Exploration
 
 Before finalizing, inspect current patterns:
-- `components/tool-ui/*` similar components
-- `components/tool-ui/shared/schema.ts`
-- `components/tool-ui/shared/contract.ts`
-- `components/tool-ui/shared/actions-config.ts`
-- `components/tool-ui/shared/action-buttons.tsx`
-- `components/tool-ui/option-list/*` and `components/tool-ui/plan/*`
+- `apps/www/components/tool-ui/*` similar components
+- `apps/www/components/tool-ui/shared/schema.ts`
+- `apps/www/components/tool-ui/shared/contract.ts`
+- `apps/www/components/tool-ui/shared/actions-config.ts`
+- `apps/www/components/tool-ui/shared/action-buttons.tsx`
+- `apps/www/components/tool-ui/option-list/*` and `apps/www/components/tool-ui/plan/*`
 
 ### 4. Produce Design Spec
 

.claude/agents/tool-ui-documenter.md

@@ -18,16 +18,16 @@ You document new components and wire them into docs/examples surfaces.
 You receive:
 - component slug + label
 - implemented component + schema
-- presets from `lib/presets/<slug>.ts`
+- presets from `apps/www/lib/presets/<slug>.ts`
 
 ## Required Work
 
 ### 1. Create docs page files
 
 Create/update:
-- `app/docs/<slug>/page.tsx`
-- `app/docs/<slug>/content.mdx`
-- `app/docs/<slug>/opengraph-image.tsx`
+- `apps/www/app/docs/<slug>/page.tsx`
+- `apps/www/app/docs/<slug>/content.mdx`
+- `apps/www/app/docs/<slug>/opengraph-image.tsx`
 
 Rules:
 - `page.tsx` must use `ComponentDocsTabs`
@@ -38,14 +38,14 @@ Rules:
 ### 2. Register docs metadata + previews
 
 Update all of:
-- `lib/docs/component-registry.ts`
-- `lib/docs/preview-config.tsx`
-- `app/docs/_components/preset-selector.tsx`
+- `apps/www/lib/docs/component-registry.ts`
+- `apps/www/lib/docs/preview-config.tsx`
+- `apps/www/app/docs/_components/preset-selector.tsx`
 
 ### 3. Keep docs aligned with maintainer contracts
 
 Document:
-- source/install paths in `components/tool-ui/<slug>`
+- source/install paths in `apps/www/components/tool-ui/<slug>`
 - serializable contract + parse helpers
 - action + receipt behavior (use `choice` terminology)
 - accessibility notes for interaction-heavy components

.claude/agents/tool-ui-examples.md

@@ -24,7 +24,7 @@ You receive:
 
 ### 1. Create Presets
 
-Create `lib/presets/<slug>.ts` with 4-5 presets.
+Create `apps/www/lib/presets/<slug>.ts` with 4-5 presets.
 
 Requirements:
 - use believable, specific scenarios
@@ -35,11 +35,11 @@ Requirements:
 
 ### 2. Gallery Entry
 
-Update `app/docs/gallery/page.tsx` with the most representative visual preset when appropriate.
+Update `apps/www/app/docs/gallery/page.tsx` with the most representative visual preset when appropriate.
 
 ### 3. Landing Showcase (Optional)
 
-Update `app/components/home/chat-showcase.tsx` only if the component is visually distinctive and improves landing clarity.
+Update `apps/www/app/components/home/chat-showcase.tsx` only if the component is visually distinctive and improves landing clarity.
 
 ## Preset Quality Bar
 

.claude/agents/tool-ui-implementer.md

@@ -41,7 +41,7 @@ Then extend scaffolded files instead of creating ad-hoc structure.
 
 ### 2. Component Directory Contract
 
-Ensure `components/tool-ui/<slug>/` includes:
+Ensure `apps/www/components/tool-ui/<slug>/` includes:
 - `_adapter.tsx`
 - `schema.ts`
 - `<slug>.tsx`
@@ -78,12 +78,12 @@ Rules:
 
 - Use `createToolUiErrorBoundary` from `../shared/error-boundary`
 - Export component, error boundary, schema, parse/safeParse helpers, and types
-- Update aggregate exports in `components/tool-ui/index.ts`
+- Update aggregate exports in `apps/www/components/tool-ui/index.ts`
 
 ### 6. Tests for Non-Trivial Behavior
 
 For logic-heavy behavior, add focused tests in:
-- `lib/tests/tool-ui/<slug>/...`
+- `apps/www/lib/tests/tool-ui/<slug>/...`
 
 Good candidates:
 - deterministic ids/keys
@@ -93,11 +93,11 @@ Good candidates:
 
 ## Reference Files
 
-- `components/tool-ui/option-list/*`
-- `components/tool-ui/plan/*`
-- `components/tool-ui/message-draft/*`
-- `components/tool-ui/shared/*`
-- `scripts/new-tool-ui-component.ts`
+- `apps/www/components/tool-ui/option-list/*`
+- `apps/www/components/tool-ui/plan/*`
+- `apps/www/components/tool-ui/message-draft/*`
+- `apps/www/components/tool-ui/shared/*`
+- `apps/www/scripts/new-tool-ui-component.ts`
 
 ## Final Checklist
 

.claude/agents/tool-ui-reviewer.md

@@ -17,9 +17,9 @@ You are the final quality gate before completion.
 ## Input
 
 Review the full component integration:
-- `components/tool-ui/<slug>/`
-- `lib/presets/<slug>.ts`
-- `app/docs/<slug>/`
+- `apps/www/components/tool-ui/<slug>/`
+- `apps/www/lib/presets/<slug>.ts`
+- `apps/www/app/docs/<slug>/`
 - docs/preview registry wiring files
 
 ## Phase 1: Hard Gates (Blocking)
@@ -46,18 +46,18 @@ Verify component directory contains:
 - `README.md`
 
 Verify docs + preset exist:
-- `lib/presets/<slug>.ts`
-- `app/docs/<slug>/page.tsx`
-- `app/docs/<slug>/content.mdx`
-- `app/docs/<slug>/opengraph-image.tsx`
+- `apps/www/lib/presets/<slug>.ts`
+- `apps/www/app/docs/<slug>/page.tsx`
+- `apps/www/app/docs/<slug>/content.mdx`
+- `apps/www/app/docs/<slug>/opengraph-image.tsx`
 
 ## Phase 3: Wiring Checks (Blocking)
 
 Verify all registration points:
-- `lib/docs/component-registry.ts`
-- `lib/docs/preview-config.tsx`
-- `app/docs/_components/preset-selector.tsx`
-- `app/docs/<slug>/page.tsx` uses `ComponentDocsTabs`
+- `apps/www/lib/docs/component-registry.ts`
+- `apps/www/lib/docs/preview-config.tsx`
+- `apps/www/app/docs/_components/preset-selector.tsx`
+- `apps/www/app/docs/<slug>/page.tsx` uses `ComponentDocsTabs`
 
 ## Phase 4: Contract/Pattern Checks (Warnings unless severe)
 
@@ -67,7 +67,7 @@ Check for:
 - receipt semantics use `choice` (not `confirmed`/`decision`)
 - deterministic id/key behavior for non-trivial interactions
 - direct shared imports in component logic (avoid `../shared` barrel imports)
-- meaningful tests in `lib/tests/tool-ui/<slug>/` when behavior is non-trivial
+- meaningful tests in `apps/www/lib/tests/tool-ui/<slug>/` when behavior is non-trivial
 
 ## Output Format
 

.claude/commands/component.md

@@ -5,7 +5,7 @@ description: Create new React component
 Create a new component: $ARGUMENTS
 
 Follow project patterns:
-- **Location**: `app/components/` (or specify subdirectory)
+- **Location**: `apps/www/app/components/` (or specify subdirectory)
 - **Style**: Functional component with TypeScript
 - **Props**: Properly typed interface
 - **Styling**: Tailwind CSS classes
@@ -20,4 +20,4 @@ Include:
 4. Responsive design considerations
 5. Error boundaries if needed
 
-Check `app/components/` for similar patterns to follow.
+Check `apps/www/app/components/` for similar patterns to follow.

.claude/commands/generate-tool-ui.md

@@ -39,7 +39,7 @@ Implementation must follow current repo contracts:
 - schema contract via `defineToolUiContract` + `parseSerializableX` + `safeParseSerializableX`
 - receipt prop is `choice` (never `confirmed` / `decision`)
 - maintain component directory file contract (including `README.md`)
-- update aggregate exports in `components/tool-ui/index.ts`
+- update aggregate exports in `apps/www/components/tool-ui/index.ts`
 
 ### 3. Examples + Docs (Parallel)
 
@@ -70,10 +70,10 @@ The documenter/reviewer must ensure all of these are wired:
 
 | File | Purpose |
 |------|---------|
-| `lib/docs/component-registry.ts` | Component metadata + docs nav categorization |
-| `lib/docs/preview-config.tsx` | Interactive preview config + `ComponentId` coverage |
-| `app/docs/_components/preset-selector.tsx` | Examples tab preset mapping |
-| `app/docs/{name}/page.tsx` | `ComponentDocsTabs` docs/examples surface |
+| `apps/www/lib/docs/component-registry.ts` | Component metadata + docs nav categorization |
+| `apps/www/lib/docs/preview-config.tsx` | Interactive preview config + `ComponentId` coverage |
+| `apps/www/app/docs/_components/preset-selector.tsx` | Examples tab preset mapping |
+| `apps/www/app/docs/{name}/page.tsx` | `ComponentDocsTabs` docs/examples surface |
 
 ## Notes
 

.claude/docs/component-workflow.md

@@ -4,32 +4,32 @@ Procedures for common component operations in Tool UI.
 
 ## Adding a New Component
 
-1. Create `components/tool-ui/{name}/` with standard files:
+1. Create `apps/www/components/tool-ui/{name}/` with standard files:
    - `index.tsx` (barrel exports)
    - `{name}.tsx` (main component)
    - `schema.ts` (Zod schema + types)
    - `_adapter.tsx` (shadcn re-exports)
    - `error-boundary.tsx`
 
-2. Create `lib/presets/{name}.ts` with 4-5 example presets
+2. Create `apps/www/lib/presets/{name}.ts` with 4-5 example presets
 
-3. Add to `lib/docs/component-registry.ts`
+3. Add to `apps/www/lib/docs/component-registry.ts`
 
-4. Add to `lib/docs/preview-config.tsx`
+4. Add to `apps/www/lib/docs/preview-config.tsx`
 
 5. Create doc page:
-   - `app/docs/{name}/page.tsx`
-   - `app/docs/{name}/content.mdx`
-   - `app/docs/{name}/opengraph-image.tsx`
+   - `apps/www/app/docs/{name}/page.tsx`
+   - `apps/www/app/docs/{name}/content.mdx`
+   - `apps/www/app/docs/{name}/opengraph-image.tsx`
 
-6. Add to `app/docs/gallery/page.tsx`
+6. Add to `apps/www/app/docs/gallery/page.tsx`
 
 ## Renaming a Preset
 
-1. Update type in `lib/presets/{component}.ts`
+1. Update type in `apps/www/lib/presets/{component}.ts`
 2. Update object key in same file
 3. `grep` for old name across codebase
-4. Update `defaultPreset` in `preview-config.tsx` if needed
+4. Update `defaultPreset` in `apps/www/lib/docs/preview-config.tsx` if needed
 5. Update `content.mdx` and `gallery/page.tsx` references
 
 ## Preset Guidelines

.claude/docs/mdx-authoring.md

@@ -1,10 +1,10 @@
 # MDX Authoring
 
-Guide for writing doc pages in Tool UI (`app/docs/{component}/content.mdx`).
+Guide for writing doc pages in Tool UI (`apps/www/app/docs/{component}/content.mdx`).
 
 ## Configuration
 
-MDX is configured in `next.config.ts:14` with `@next/mdx` and `remark-gfm`.
+MDX is configured in `apps/www/next.config.ts:14` with `@next/mdx` and `remark-gfm`.
 
 **Turbopack limitation:** Plugins must be strings (`"remark-gfm"`) not function imports. Turbopack requires serializable config.
 
@@ -22,7 +22,7 @@ Standard markdown table syntax works:
 
 ### Custom Components
 
-Available via `mdx-components.tsx`:
+Available via `apps/www/mdx-components.tsx`:
 
 - `TypeTable` - Props documentation
 - `Files`, `Folder`, `File` - Directory trees
@@ -43,7 +43,7 @@ Content wraps in `.prose` class from `docs-content.tsx`. Use `not-prose` class t
 
 ### Auto-linking
 
-Tool UI component names in text auto-link to their docs pages. Configured in `lib/mdx/with-auto-link.ts`.
+Tool UI component names in text auto-link to their docs pages. Configured in `apps/www/lib/mdx/with-auto-link.ts`.
 
 ## Page Structure
 
@@ -53,4 +53,4 @@ Each doc page needs:
 2. `content.mdx` - The actual documentation
 3. `opengraph-image.tsx` - OG image generation
 
-See `app/docs/approval-card/` for reference implementation.
+See `apps/www/app/docs/approval-card/` for reference implementation.

.claude/docs/operations.md

@@ -2,18 +2,18 @@
 
 ## Adding a New Component
 
-1. Create `components/tool-ui/{name}/` with standard files
-2. Create `lib/presets/{name}.ts`
-3. Add to `lib/docs/component-registry.ts`
-4. Add to `lib/docs/preview-config.tsx`
-5. Create `app/docs/{name}/page.tsx` and `content.mdx`
-6. Create `app/docs/{name}/opengraph-image.tsx`
-7. Add to `app/docs/gallery/page.tsx`
+1. Create `apps/www/components/tool-ui/{name}/` with standard files
+2. Create `apps/www/lib/presets/{name}.ts`
+3. Add to `apps/www/lib/docs/component-registry.ts`
+4. Add to `apps/www/lib/docs/preview-config.tsx`
+5. Create `apps/www/app/docs/{name}/page.tsx` and `content.mdx`
+6. Create `apps/www/app/docs/{name}/opengraph-image.tsx`
+7. Add to `apps/www/app/docs/gallery/page.tsx`
 
 ## Renaming a Preset
 
-1. Update type in `lib/presets/{component}.ts`
+1. Update type in `apps/www/lib/presets/{component}.ts`
 2. Update object key
 3. `grep` for old name across codebase
-4. Update `defaultPreset` in `preview-config.tsx` if needed
+4. Update `defaultPreset` in `apps/www/lib/docs/preview-config.tsx` if needed
 5. Update `content.mdx` and `gallery/page.tsx` references