@ultimat3/ui 20.2.1 → 21.0.0

package/CLAUDE.md

@@ -45,7 +45,8 @@ Tier 4 (moved 5 → 4 on 2026-08-19, when the `admin → ui` exception was delet
   (`src/components/async-branch.ts`) is the ONLY place the `(pending, failed, empty, data)` decision
   is made — `AsyncRegion` renders it and `DataTable` calls it, so a table and a card list cannot
   disagree about what "loading with stale rows" looks like. The property is structural: an
-  `AsyncState` in `pending` carries no data, so nothing can be found empty in it, and "No results"
+  `AsyncState` (declared in `@ultimat3/core` since 21.0.0 — imported here, never re-exported, so
+  it has one import path) in `pending` carries no data, so nothing can be found empty in it, and "No results"
   for one frame before the first page arrives is unconstructible rather than discouraged.
   `<AsyncRegion>`'s `empty` and `ready` are REQUIRED props, so forgetting the empty state is a type
   error. `refreshing` CARRIES the previous data — a refetch dims what is on screen (`aria-busy`) and

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ultimat3/ui",
-  "version": "20.2.1",
+  "version": "21.0.0",
   "description": "SolidJS design system: semantic design tokens, dark/RTL-ready SCSS modules, a11y primitives",
   "license": "MIT",
   "type": "module",
@@ -48,10 +48,10 @@
     "icons": "bun run src/icons/build-icons.ts"
   },
   "dependencies": {
-    "@ultimat3/core": "20.2.1",
-    "@ultimat3/i18n": "20.2.1",
-    "@ultimat3/money": "20.2.1",
-    "@ultimat3/time": "20.2.1"
+    "@ultimat3/core": "21.0.0",
+    "@ultimat3/i18n": "21.0.0",
+    "@ultimat3/money": "21.0.0",
+    "@ultimat3/time": "21.0.0"
   },
   "peerDependencies": {
     "solid-js": "^1.9.0"

package/src/components/AsyncRegion.tsx

@@ -7,14 +7,13 @@
 // placeholder is derived from `reserve` so it cannot mismatch the loaded box, and the failure
 // renders through `ErrorState`, which is the one thing allowed to phrase an error.
 
-import { finiteCount } from '@ultimat3/core';
+import { type AsyncState, finiteCount } from '@ultimat3/core';
 import type { JSX } from 'solid-js';
 import { ariaBool } from '../a11y';
 import { cx } from '../cx';
 import styles from './AsyncRegion.module.scss';
 import {
   type AsyncBranch,
-  type AsyncState,
   asyncBranch,
   isBusyBranch,
   type ReserveBox,

package/src/components/DataTable.tsx

@@ -6,13 +6,13 @@
 // table and a card list cannot disagree about what "loading with stale rows" looks like. Only the
 // PLACEHOLDER is local, because a table's is table-shaped: rows of cells, not lines of text.
 
-import { finiteCount } from '@ultimat3/core';
+import { type AsyncState, finiteCount } from '@ultimat3/core';
 import type { JSX } from 'solid-js';
 import { ariaBool } from '../a11y';
 import { cx } from '../cx';
 import { UI_KEYS } from '../i18n-keys';
 import { useUi } from '../theme/context';
-import { type AsyncBranch, type AsyncState, asyncBranch, isBusyBranch } from './async-branch';
+import { type AsyncBranch, asyncBranch, isBusyBranch } from './async-branch';
 import styles from './DataTable.module.scss';
 import { EmptyState } from './EmptyState';
 import { ErrorState } from './ErrorState';

package/src/components/async-branch.ts

@@ -4,18 +4,11 @@
 // unreachable until a result has arrived, and a refetch keeps the previous data on screen.
 
 /**
- * What a caller hands an async region. A STATE, never a query: `@ultimat3/ui` is tier 4 and may
- * not import `query`, `action` or `realtime`, so a live-query accessor, a `createResource` and a
- * plain signal all arrive here as the same four shapes.
- *
- * `refreshing` is the one that makes search feel fast — it CARRIES the previous data, so a refetch
- * re-renders what is already on screen instead of tearing it down to a skeleton.
+ * What a caller hands an async region is `AsyncState` from `@ultimat3/core` — declared at tier 0
+ * because realtime's read hooks (tier 3) return it and ui (tier 4) consumes it, and neither may
+ * import the other that way. Imported, never re-exported: one home, one import path.
  */
-export type AsyncState<T> =
-  | { readonly status: 'pending' }
-  | { readonly status: 'refreshing'; readonly data: T }
-  | { readonly status: 'ready'; readonly data: T }
-  | { readonly status: 'failed'; readonly error: unknown };
+import type { AsyncState } from '@ultimat3/core';
 
 /**
  * The branch a region renders. `empty` and `ready` carry `busy`; `pending` and `failed` do not,
@@ -23,8 +16,9 @@ export type AsyncState<T> =
  *
  * There is no `{ kind: 'empty' }` reachable from `{ status: 'pending' }` — that is the whole
  * point of this module. "No results" rendered for one frame before the first page arrives is the
- * most common agent-authored UX bug in a list screen, and the union above makes it unconstructible
- * rather than merely discouraged: `pending` holds no data, so nothing can be found empty in it.
+ * most common agent-authored UX bug in a list screen, and `AsyncState`'s union makes it
+ * unconstructible rather than merely discouraged: `pending` holds no data, so nothing can be found
+ * empty in it.
  */
 export type AsyncBranch<T> =
   | { readonly kind: 'pending' }

package/src/index.ts

@@ -51,7 +51,6 @@ export { shellIds, shellLandmarks } from './components/app-shell-view';
 export type {
   AsyncBranch,
   AsyncFlags,
-  AsyncState,
   ReserveBox,
 } from './components/async-branch';
 export {