najm-kit 2.8.2 → 2.10.0

package/CHANGELOG.md

@@ -1,5 +1,49 @@
 # Changelog
 
+## 2.10.0 - 2026-08-10
+
+- Added a shared, failure-aware media source chain for `NAvatar`, `NImage`, and
+  the new Next-only `NNextImage` export. Sources reset cleanly when inputs or
+  cache versions change, duplicate candidates are tried once, consumer event
+  handlers are preserved, and failed avatars return to initials without a
+  broken-image glyph.
+- `NAvatar` now uses a native lazy-loaded image so loading and error events are
+  observable, keeps initials visible until the image paints, supports native
+  `imageProps`, and actually tries `fallbackSrc` after a primary failure.
+- Added provider-level status badge defaults and the public
+  `normalizeStatusToken` helper. Applications can configure translated status
+  labels, colors, icons, look, shape, and size once while explicit badge props
+  retain precedence.
+- Added `NNextImage` and `NNextImageProps` to `najm-kit/next` only, preserving
+  Next Image `fill`, `sizes`, optimizer, and `unoptimized` controls without
+  adding Next.js to the root runtime graph.
+
+## 2.9.0 - 2026-08-09
+
+- Added `najm-kit/server`, a pure UI bootstrap loader. `createUiBootstrapLoader()`
+  takes the application's own fetcher, endpoint paths, payload parsers, and
+  factory values, then runs the resources concurrently, unwraps the `{ data }`
+  envelope (or one the application selects), and falls back per resource so a
+  branding outage never discards a valid appearance. Failures are reported
+  through an optional structured `onDiagnostic` callback carrying resource,
+  reason, path, and status — never a response body, header, cookie, or raw
+  thrown value. A `fallback()` that throws stays a visible error. The entry
+  imports no React, no Next.js, and no Node built-in, and re-exports
+  `parseNajmDesignConfig` so an appearance payload can be parsed without
+  reaching the root barrel.
+- Added `najm-kit/server/react`, the React Server Component adapter.
+  `createReactServerUiBootstrap()` memoizes one bootstrap per request with
+  React's `cache()` and derives the per-resource accessors from it, so a root
+  layout, a nested layout, and a page share one resolution and one stable
+  snapshot for the whole render. Resolution is request-scoped only: separate
+  requests share no snapshot, failure, or diagnostic, and a transient outage is
+  retried on the next request. The `browser` export condition resolves to a
+  module that throws, so importing the adapter from a Client Component fails at
+  build time instead of shipping the application's fetcher and factory values
+  into a browser bundle.
+- The root `najm-kit`, `najm-kit/next`, and `najm-kit/app` entries are unchanged
+  and do not reach either server entry.
+
 ## 2.8.2 - 2026-08-08
 
 - Added the framework-neutral `najm-kit/person-images` subpath. It ships a
@@ -10,33 +54,33 @@
   unknown role strings at the call site. The root `najm-kit` entry stays
   unchanged and does not pull in the person images.
 
-## 2.8.1 - 2026-08-08
-
-- Added schema-driven form development tools to `NajmAppProvider`. Passing
-  `formDevTools` enables F8 filling for every `NForm` and `WizardForm` without
-  an application helper or additional provider.
-- Added built-in Zod 4 form-value generation with per-form overrides for
-  relation fields and other application-owned values. Existing explicit
-  `devTools.enabled` and `devTools.fill` usage remains supported.
-
-## 2.8.0 - 2026-08-08
-
-- Added server-safe `najm-kit/format` helpers for currency minor units,
-  numbers, percentages, dates, times, relative time, tokens, local date inputs,
-  and slugs. Client applications can use the same contract reactively through
-  `NajmFormatProvider` and `useNajmFormat`.
-- Added the server-safe `najm-kit/pagination` offset protocol, including bounded
-  page creation, total-aware continuation, probe-row continuation for APIs
-  without totals, and query cleanup that preserves meaningful `false` and `0`.
-- Added the optional-peer `najm-kit/query` entry with offset infinite-query and
-  responsive paged/card-list hooks, plus shared card-pagination adapters and
-  localized continuation labels.
-- Extended `NajmAppProvider` with formatting locale, currency, and placeholder
-  configuration so applications can bind language, time zone, and formatting
-  without another host bridge provider.
-- Added shared media-query/card-viewport helpers and avatar-source utilities.
-
-## 2.6.2
+## 2.8.1 - 2026-08-08
+
+- Added schema-driven form development tools to `NajmAppProvider`. Passing
+  `formDevTools` enables F8 filling for every `NForm` and `WizardForm` without
+  an application helper or additional provider.
+- Added built-in Zod 4 form-value generation with per-form overrides for
+  relation fields and other application-owned values. Existing explicit
+  `devTools.enabled` and `devTools.fill` usage remains supported.
+
+## 2.8.0 - 2026-08-08
+
+- Added server-safe `najm-kit/format` helpers for currency minor units,
+  numbers, percentages, dates, times, relative time, tokens, local date inputs,
+  and slugs. Client applications can use the same contract reactively through
+  `NajmFormatProvider` and `useNajmFormat`.
+- Added the server-safe `najm-kit/pagination` offset protocol, including bounded
+  page creation, total-aware continuation, probe-row continuation for APIs
+  without totals, and query cleanup that preserves meaningful `false` and `0`.
+- Added the optional-peer `najm-kit/query` entry with offset infinite-query and
+  responsive paged/card-list hooks, plus shared card-pagination adapters and
+  localized continuation labels.
+- Extended `NajmAppProvider` with formatting locale, currency, and placeholder
+  configuration so applications can bind language, time zone, and formatting
+  without another host bridge provider.
+- Added shared media-query/card-viewport helpers and avatar-source utilities.
+
+## 2.6.2
 
 - Added `NSidebarProvider` and `useNSidebar`, so sidebar state can be read from a distance. `NSidebar` renders beside the page content rather than around it, which left applications hand-rolling a context to hand `setMobileOpen` down to a page header — a wrapper component plus an aliased import at every call site. Wrap the shell in `NSidebarProvider` and `NPageHeader` now resolves both `onSidebarOpen` and `mobileBreakpoint` from it, so a header nested anywhere below renders a working mobile trigger with no props threaded to it. Also exports the `NSidebarContextValue` type.
 - `NSidebar` resolves its open and collapsed state as explicit prop → surrounding provider → internal state. Passing `collapsed`, `mobileOpen`, `onCollapsedChange`, or `onMobileOpenChange` keeps behaving exactly as before, and a sidebar with no provider around it still owns its own state, so this is additive for every existing consumer.