The unified 2.2 API

.github/workflows/ci.yml

@@ -37,3 +37,19 @@ jobs:
 
       - name: Build
         run: bun run build
+
+      - name: Test
+        run: bun test
+
+      # Fails when docs/api-contract.md and the shipped types disagree, in
+      # either direction. Never runs with --write: regenerating the document on
+      # every build is what made the last one unable to disagree with the code.
+      - name: API Contract
+        run: bun run check:api
+
+      # Packs the tarball, installs it into a fresh consumer and builds against
+      # it. The only step that tests the artifact a consumer receives, and the
+      # one that catches a package dist imports but the manifest does not
+      # declare.
+      - name: Consumer Smoke
+        run: bun run smoke

.gitignore

@@ -35,3 +35,6 @@ bun.lockb
 # Finder (MacOS) folder config
 .DS_Store
 *.generated.tsx
+
+# Generated by the application-side iconify build, never by this library.
+src/styles/icons/

CONTRIBUTING.md

@@ -16,18 +16,23 @@ bun run lint
 bun run format
 ```
 
-### Playground — hot-test without rebuilding
+### Trying a change
 
-The fastest way to try a change. Run from the repository root:
+There is no in-repo playground. It demoed every component against the pre-2.2 API
+and had become 477 typecheck errors of dead demos, so it was deleted rather than
+rewritten: a copy of the API living beside the API only ever drifts from it. The
+showcase belongs in [js.software](https://github.com/pathscale/js.software).
+
+[`docs/how-to-setup-playground.md`](docs/how-to-setup-playground.md) has two
+recipes, one aliased at `src/` for hot reload and one installed from the tarball.
+
+The quickest check without either:
 
 ```bash
-bun run playground:dev
+bun run build
+bun run smoke        # scripts/smoke-consumer.ts, imports the built artifact
 ```
 
-The playground aliases `@pathscale/ui` to local `src/` via Vite, so edits under `src/` and
-`src/styles/` refresh immediately — no rebuild, no relink. `playground/src/App.tsx` demos
-every component, with longer examples in `playground/src/examples/`.
-
 ## Commit Convention
 
 ```

README.md

@@ -162,7 +162,7 @@ import — the published size is the whole library, not what ships to your users
 |---|---|
 | **[Live showcase](https://js.software)** | every component, rendered and interactive |
 | **[Usage reference](https://github.com/pathscale/ui/blob/master/docs/ui-usage.md)** | theming, conventions, forms, table, toast, icons, dates |
-| **[Contributing](https://github.com/pathscale/ui/blob/master/CONTRIBUTING.md)** | local setup, playground, component checklist, proposal template |
+| **[Contributing](https://github.com/pathscale/ui/blob/master/CONTRIBUTING.md)** | local setup, component checklist, proposal template |
 
 ## License