@tristan2828/ui-foundation 3.3.0 → 3.4.0

package/README.md

@@ -19,7 +19,7 @@ than installing this by hand:
 | Import | What |
 |---|---|
 | `@tristan2828/ui-foundation` | `AppShell`, `DataTable`, `EntityForm`, `ErrorState`, `MultiChoice`, `PasswordInput`, `RouteErrorBoundary`, `FoundationProviders`, `LoginRoute`, `RegisterRoute`, `useAuth`, `useTableUrlState`, `useDebouncedValue`, `createQueryClient`, `cn`; types `Page`, `AppError`, `QuerySpec` |
-| `@tristan2828/ui-foundation/ui/<name>` | shadcn primitives: badge, button, calendar, card, combobox, dialog, empty, field, input, input-group, label, popover, select, separator, sheet, sidebar, skeleton, sonner, spinner, table, textarea, tooltip |
+| `@tristan2828/ui-foundation/ui/<name>` | shadcn primitives: badge, button, calendar, card, combobox, dialog, empty, field, input, input-group, label, popover, select, separator, sheet, sidebar, skeleton, sonner, spinner, switch, table, textarea, tooltip |
 | `@tristan2828/ui-foundation/gateway` | `safeFetch`, `toAppError`, `networkError` — for an app's `src/api/gateway/` only |
 | `@tristan2828/ui-foundation/mocks` | MSW: `authHandlers`, `resetMockAuth`, `getMockCurrentUser`, `MOCK_USER`, `exposeMswForE2E` |
 | `@tristan2828/ui-foundation/testing` | Playwright: `defineA11ySuite`, `defineMockModeBannerSuite`, `forceMswOverride`, `forceLoggedOut`, `waitForMswReady` |

package/conventions/docs/add-an-entity.md

@@ -76,7 +76,12 @@ is a filled-in example while the Widgets demo is still here).
    and labels from its field table, and field types by pattern (a
    `reference` field copies Category's searchable combobox, a
    `single choice` copies Status's select, a `date-time` copies
-   Available From's date picker, a `multi choice` copies Tags — the
+   Available From's date picker, a `yes/no` copies In Stock — a `Switch`
+   (`@tristan2828/ui-foundation/ui/switch`) in a horizontal `Field` with
+   its label beside it on the form, cell pattern 12 (the word Yes/No) in
+   the table, and a three-way toolbar `Select` (either / yes / no) whose URL
+   value is `'true'`/`'false'` and whose `filters` value is a real boolean,
+   so `false` reaches the wire — and a `multi choice` copies Tags — the
    `<MultiChoice>` control from the foundation on the
    form and as a toolbar filter via `useTableUrlState`'s multi filters,
    badges in the table, and a `filters` array the gateway sends as a

package/conventions/docs/cell-patterns.md

@@ -7,7 +7,9 @@ per-entity, and only the shape is reusable. Copy the markup into your
 
 Patterns 1–10 were each chosen for a real column, from a page of
 alternatives ([`column-options.md`](column-options.md)), not designed in the abstract.
-Patterns from 11 on are marked **Unproven**: written ahead of a real
+Pattern 12 (boolean) is the template's own reference: Widget's In Stock
+column renders it and its specs pin it. The other patterns from 11 on are
+marked **Unproven**: written ahead of a real
 column, so no app has tested them on real data yet. Prefer a proven
 pattern when one fits. When you use an unproven one, say so in the
 entity's plan, and raise what you learned for the foundation, so the
@@ -257,9 +259,11 @@ cell: ({ getValue }) => {
   template's `USD` is the demo's.
 - **Cost:** none to speak of. It's the plain-text pattern with formatting.
 
-## 12. Boolean — *Unproven*
+## 12. Boolean
 
-A yes/no field.
+A yes/no field. Widget's In Stock column (`src/routes/widgets/widgets-columns.tsx`)
+is the reference; its value is never null, so it drops the `emptyCell`
+branch below.
 
 ```tsx
 cell: ({ getValue }) => {

package/conventions/docs/entity-plan-template.md

@@ -24,7 +24,9 @@ One or two sentences: what one record is, and who uses the screens.
 - **Type** — what the foundation supports today:
   - *Demonstrated by the Widget reference* (copied directly): `text` (one
     line), `long text`, `decimal` (fixed places — say how many),
-    `date-time`, `email`, `single choice` (list the options, in display
+    `date-time`, `email`, `yes/no` (a boolean that is always yes or no:
+    say its default and the filter's three labels, e.g. Any stock /
+    In stock / Out of stock), `single choice` (list the options, in display
     order; see the note below if it is *optional*), `multi choice` (list
     the options; any number can be picked —
     chips on the form, badges in the table, an any-of filter), `reference`
@@ -32,7 +34,8 @@ One or two sentences: what one record is, and who uses the screens.
   - *Close variants* (built by a small, stated change to the nearest
     pattern): `integer` (from decimal), `url` (from email — a format
     check), `date` (from date-time — no time part).
-  - *Not supported yet:* boolean, file, and anything else.
+  - *Not supported yet:* a yes/no that can also be unset (three states),
+    file, and anything else.
     Write it anyway with a note; the playbook will stop and raise it
     rather than improvise.
 - **Required**: `yes`, or `no` (then say whether empty means "unknown").

package/dist/components/ui/switch.d.ts

@@ -0,0 +1,5 @@
+import { Switch as SwitchPrimitive } from "@base-ui/react/switch";
+declare function Switch({ className, size, ...props }: SwitchPrimitive.Root.Props & {
+    size?: "sm" | "default";
+}): import("react").JSX.Element;
+export { Switch };

package/dist/components/ui/switch.js

@@ -0,0 +1,7 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { Switch as SwitchPrimitive } from "@base-ui/react/switch";
+import { cn } from "cn";
+function Switch({ className, size = "default", ...props }) {
+    return (_jsx(SwitchPrimitive.Root, { "data-slot": "switch", "data-size": size, className: cn("peer group/switch relative inline-flex shrink-0 items-center rounded-full border border-transparent transition-all outline-none group-has-[:focus-visible]/field-label:border-transparent group-has-[:focus-visible]/field-label:ring-0 after:absolute after:-inset-x-3 after:-inset-y-2 focus-visible:border-ring focus-visible:ring-3 focus-visible:ring-ring/50 aria-invalid:border-destructive aria-invalid:ring-3 aria-invalid:ring-destructive/20 data-[size=default]:h-[18.4px] data-[size=default]:w-[32px] data-[size=sm]:h-[14px] data-[size=sm]:w-[24px] dark:aria-invalid:border-destructive/50 dark:aria-invalid:ring-destructive/40 data-checked:bg-primary data-unchecked:bg-input dark:data-unchecked:bg-input/80 data-disabled:cursor-not-allowed data-disabled:opacity-50", className), ...props, children: _jsx(SwitchPrimitive.Thumb, { "data-slot": "switch-thumb", className: "pointer-events-none block rounded-full bg-background ring-0 transition-transform group-data-[size=default]/switch:size-4 group-data-[size=sm]/switch:size-3 group-data-[size=default]/switch:data-checked:translate-x-[calc(100%-2px)] group-data-[size=sm]/switch:data-checked:translate-x-[calc(100%-2px)] dark:data-checked:bg-primary-foreground group-data-[size=default]/switch:data-unchecked:translate-x-0 group-data-[size=sm]/switch:data-unchecked:translate-x-0 dark:data-unchecked:bg-foreground" }) }));
+}
+export { Switch };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tristan2828/ui-foundation",
-  "version": "3.3.0",
+  "version": "3.4.0",
   "description": "Shared UI foundation for contract-first, database-backed React apps: shadcn primitives, DataTable/EntityForm composites, auth, the gateway error seam, design tokens, lint rules and the AI playbook.",
   "license": "MIT",
   "repository": {