feat: Astro landing for @bearstudio/ui-state

.gitignore

@@ -21,6 +21,9 @@ coverage
 # Vercel
 .vercel
 
+# Astro
+.astro
+
 # Build Outputs
 .next/
 out/

.oxlintrc.json

@@ -18,5 +18,5 @@
     "typescript/no-unnecessary-type-parameters": "off",
     "typescript/no-unsafe-type-assertion": "off"
   },
-  "ignorePatterns": ["**/dist/**", "**/coverage/**"]
+  "ignorePatterns": ["**/dist/**", "**/coverage/**", "**/.astro/**"]
 }

apps/landing/PRODUCT.md

@@ -0,0 +1,46 @@
+# Product
+
+<!-- impeccable:product-schema 1 -->
+
+## Platform
+
+web
+
+## Users
+
+TypeScript and React engineers drowning in nested loading / error / empty UI.
+
+## Product Purpose
+
+`@bearstudio/ui-state` is an OSS TypeScript helper. `getUiState` plus `match` plus `exhaustive()` map pending, error, and the statuses a screen already has onto one typed chain. Success is a compile error when a status is unmatched — not a new store.
+
+## Positioning
+
+exhaustive() is a type error until every status is matched. Statuses are inferred from set(), not a fixed enum. React is a peer. There is no store.
+
+## Operating Context
+
+Library landing (Persuade).
+Engineers arrive from GitHub, read a short example, and wire getUiState to query flags they already have.
+
+## Capabilities and Constraints
+
+- Surface API: getUiState, set(), match, exhaustive(), when().
+- Do not demo is() as a type guard; it does not narrow on current main (PR #5).
+- MIT. React peer. No store, no context, no extra runtime.
+- Do not invent download counts or testimonials.
+
+## Brand Commitments
+
+Voice: specific, technical, no hype. Anti-references: Relume/v0 indigo bento, fake browser chrome, equal feature cards, Unleash. Identity: cream/ink tokens, IBM Plex Sans and Mono.
+
+## Evidence on Hand
+
+No download counts, testimonials, or case studies. Do not fabricate them. Facts: MIT, React peer, no store, exhaustive() fails the type check until every status is matched.
+
+## Product Principles
+
+1. A missed status is a type error, not a blank screen.
+2. Statuses come from the app, not a library enum.
+3. No new store; wire to flags the screen already has.
+4. Marketing copy stays factual; no hype words.

apps/landing/README.md

@@ -0,0 +1,35 @@
+# landing
+
+Marketing site for `@bearstudio/ui-state`. Unpublished; no changeset.
+
+## Run
+
+From the repo root (Node 24, pnpm 10.34.5):
+
+```bash
+pnpm install
+pnpm --filter landing dev
+```
+
+Root `pnpm dev` / `pnpm build` / `pnpm check-types` / `pnpm lint` also
+include this app via turbo. `dev` depends on `^build` so the library
+dist exists before the Astro island imports it.
+
+## Stack
+
+- Astro 6 SSG + one React island (`client:visible`)
+- Tailwind 4 via `@tailwindcss/vite` (not `@astrojs/tailwind`)
+- Tokens in `@theme inline`
+- `@bearstudio/ui-state` as `workspace:*`
+- Fonts: Astro 6 Fonts API, Fontsource, latin + latin-ext, self-hosted
+
+## Typecheck split
+
+Library stays NodeNext (`react-library.json`). This app does **not**
+extend `react-library.json`. It extends
+`@bearstudio/typescript-config/astro.json` (`moduleResolution: Bundler`).
+
+`check-types` is `tsc --noEmit` on `src/**/*.ts(x)` (the island).
+`astro check` is not the source of truth on TypeScript 7 (no compiler API).
+
+Lint: oxlint. Format: oxfmt.

apps/landing/astro.config.ts

@@ -0,0 +1,39 @@
+import react from "@astrojs/react";
+import tailwindcss from "@tailwindcss/vite";
+import { defineConfig, fontProviders } from "astro/config";
+
+export default defineConfig({
+  output: "static",
+  compressHTML: true,
+  integrations: [react()],
+  vite: {
+    plugins: [tailwindcss()],
+  },
+  fonts: [
+    {
+      name: "Roboto Slab",
+      cssVariable: "--font-roboto-slab",
+      provider: fontProviders.fontsource(),
+      weights: [700],
+      styles: ["normal"],
+      subsets: ["latin", "latin-ext"],
+    },
+    {
+      name: "Inter",
+      cssVariable: "--font-inter",
+      provider: fontProviders.fontsource(),
+      weights: [400, 500, 600],
+      styles: ["normal"],
+      subsets: ["latin", "latin-ext"],
+    },
+    {
+      name: "IBM Plex Mono",
+      cssVariable: "--font-ibm-plex-mono",
+      provider: fontProviders.fontsource(),
+      weights: [400, 500],
+      styles: ["normal"],
+      subsets: ["latin", "latin-ext"],
+      fallbacks: ["monospace"],
+    },
+  ],
+});

apps/landing/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "landing",
+  "private": true,
+  "license": "MIT",
+  "type": "module",
+  "scripts": {
+    "dev": "astro dev",
+    "build": "astro build",
+    "preview": "astro preview",
+    "check-types": "tsc --noEmit",
+    "lint": "oxlint .",
+    "format": "oxfmt"
+  },
+  "dependencies": {
+    "@astrojs/react": "6.0.4",
+    "@bearstudio/ui-state": "workspace:*",
+    "@tanstack/highlight": "0.0.10",
+    "astro": "7.2.7",
+    "react": "19.2.8",
+    "react-dom": "19.2.8"
+  },
+  "devDependencies": {
+    "@bearstudio/typescript-config": "workspace:*",
+    "@tailwindcss/vite": "4.3.3",
+    "@types/react": "19.2.18",
+    "@types/react-dom": "19.2.5",
+    "tailwindcss": "4.3.3",
+    "typescript": "7.0.2"
+  }
+}