najm-kit 2.8.2 → 2.10.0

package/dist/json.mjs

@@ -1,6 +1,7 @@
-import { Button } from './chunk-6OOBAEH2.mjs';
-export { NTableJson } from './chunk-6OOBAEH2.mjs';
+import { Button } from './chunk-JUYT2ISO.mjs';
+export { NTableJson } from './chunk-JUYT2ISO.mjs';
 import { cn } from './chunk-KVZACF4G.mjs';
+import './chunk-TFHWLE7N.mjs';
 import { useMemo, useRef, useCallback } from 'react';
 import CodeMirror from '@uiw/react-codemirror';
 import { json } from '@codemirror/lang-json';

package/dist/server/index.d.ts

@@ -0,0 +1,3 @@
+export { U as UiBootstrapConfig, a as UiBootstrapDiagnostic, b as UiBootstrapFailureReason, c as UiBootstrapFetcher, d as UiBootstrapLoader, e as UiBootstrapResource, f as UiBootstrapResources, g as UiBootstrapSnapshot, h as UiBootstrapValue, i as createUiBootstrapLoader } from '../uiBootstrap-Ci6K5j5t.js';
+export { d as defineNajmDesignConfig, p as parseNajmDesignConfig, s as stringifyNajmDesignConfig } from '../design-config-D_x1GCu3.js';
+export { N as NajmComponentThemeConfig, a as NajmDesignConfig, b as NajmLayoutConfig, c as NajmTypographyConfig } from '../design-types-Rkpt8Pg1.js';

package/dist/server/index.mjs

@@ -0,0 +1,2 @@
+export { createUiBootstrapLoader } from '../chunk-7H6NFBQT.mjs';
+export { defineNajmDesignConfig, parseNajmDesignConfig, stringifyNajmDesignConfig } from '../chunk-TFHWLE7N.mjs';

package/dist/server/react.d.ts

@@ -0,0 +1,16 @@
+import { f as UiBootstrapResources, g as UiBootstrapSnapshot, U as UiBootstrapConfig } from '../uiBootstrap-Ci6K5j5t.js';
+export { a as UiBootstrapDiagnostic, b as UiBootstrapFailureReason, c as UiBootstrapFetcher, e as UiBootstrapResource, h as UiBootstrapValue } from '../uiBootstrap-Ci6K5j5t.js';
+
+interface ReactServerUiBootstrap<R extends UiBootstrapResources> {
+    /** Every resource for this request, resolved once and shared. */
+    load(): Promise<UiBootstrapSnapshot<R>>;
+    /** One resource, read off the same shared resolution. */
+    loadResource<K extends keyof R>(name: K): Promise<UiBootstrapSnapshot<R>[K]>;
+    /** `loadResource` pre-bound per name, for destructuring into a facade. */
+    loaders: {
+        [K in keyof R]: () => Promise<UiBootstrapSnapshot<R>[K]>;
+    };
+}
+declare function createReactServerUiBootstrap<R extends UiBootstrapResources>(config: UiBootstrapConfig<R>): ReactServerUiBootstrap<R>;
+
+export { type ReactServerUiBootstrap, UiBootstrapConfig, UiBootstrapResources, UiBootstrapSnapshot, createReactServerUiBootstrap };

package/dist/server/react.mjs

@@ -0,0 +1,23 @@
+import { createUiBootstrapLoader } from '../chunk-7H6NFBQT.mjs';
+import * as React from 'react';
+
+function createReactServerUiBootstrap(config) {
+  const cache2 = React.cache;
+  if (typeof cache2 !== "function") {
+    throw new Error(
+      "najm-kit/server/react requires a React version that exports cache() (React 18.3 or newer). Upgrade react, or use createUiBootstrapLoader() from najm-kit/server directly."
+    );
+  }
+  const loader = createUiBootstrapLoader(config);
+  const load = cache2(loader.load);
+  const loadResource = async (name) => (await load())[name];
+  const loaders = Object.fromEntries(
+    Object.keys(config.resources).map((name) => [
+      name,
+      () => loadResource(name)
+    ])
+  );
+  return { load, loadResource, loaders };
+}
+
+export { createReactServerUiBootstrap };

package/dist/server/reactClientGuard.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/server/reactClientGuard.mjs

@@ -0,0 +1,4 @@
+// src/server/reactClientGuard.ts
+throw new Error(
+  "najm-kit/server/react is a React Server Component module. It cannot be imported from a Client Component or any browser bundle. Seed the client from the server snapshot through NajmAppProvider instead, and use najm-kit/server for non-render server code."
+);

package/dist/uiBootstrap-Ci6K5j5t.d.ts

@@ -0,0 +1,93 @@
+/** Reaches the application's own backend. The path is resource-relative. */
+type UiBootstrapFetcher = (path: string) => Promise<Response>;
+/** Why a resource fell back. Kept coarse enough to be worth alerting on. */
+type UiBootstrapFailureReason = "fetch-failed" | "response-not-ok" | "invalid-json" | "invalid-envelope" | "invalid-payload";
+/**
+ * What the application learns about a fallback.
+ *
+ * Deliberately narrow. Response bodies, headers, cookies, and raw thrown
+ * values never appear here — a branding endpoint answering with a stack trace
+ * or a `Set-Cookie` must not become a log line. `error` is a normalized
+ * summary, never the thrown value itself.
+ */
+interface UiBootstrapDiagnostic {
+    resource: string;
+    reason: UiBootstrapFailureReason;
+    path: string;
+    /** Present for `response-not-ok`. */
+    status?: number;
+    /** Present when something was thrown; `"<name>: <message>"` for an `Error`. */
+    error?: string;
+}
+interface UiBootstrapResource<T> {
+    /** Passed to the fetcher unchanged. */
+    path: string;
+    /**
+     * Narrows the endpoint payload to the application's own type.
+     *
+     * Return `undefined` or throw to reject it — both are the same answer, so a
+     * parser built from `undefined` guards and one built from a schema that
+     * throws are equally usable without a wrapper.
+     */
+    parse: (input: unknown) => T | undefined;
+    /**
+     * The built-in value, used whenever the endpoint cannot produce a valid one.
+     *
+     * A function, not a value: it is called per load, so an application that
+     * returns a fresh object keeps loads independent. Its failure is *not*
+     * caught — a missing factory theme is a broken build, and a second fallback
+     * would only hide it.
+     */
+    fallback: () => T;
+    /** Per-resource envelope override. Defaults to the loader-level `select`. */
+    select?: (payload: unknown) => unknown;
+}
+/**
+ * Resources keyed by name.
+ *
+ * `any` rather than `unknown` in the value position: the payload types are
+ * unrelated to each other, and `UiBootstrapResource<unknown>` is not a
+ * supertype of `UiBootstrapResource<PublicBranding>` — `parse` and `fallback`
+ * make `T` invariant, so every concrete configuration would fail the
+ * constraint. Inference recovers the real type through `UiBootstrapValue`.
+ */
+type UiBootstrapResources = Record<string, UiBootstrapResource<any>>;
+type UiBootstrapValue<R> = R extends UiBootstrapResource<infer T> ? T : never;
+/** The resolved value of every configured resource, keyed by resource name. */
+type UiBootstrapSnapshot<R extends UiBootstrapResources> = {
+    [K in keyof R]: UiBootstrapValue<R[K]>;
+};
+interface UiBootstrapConfig<R extends UiBootstrapResources> {
+    fetcher: UiBootstrapFetcher;
+    resources: R;
+    /**
+     * Unwraps the endpoint response.
+     *
+     * Defaults to Najm's `{ data }` envelope. Applications behind a different
+     * envelope — or none — pass their own; returning the payload unchanged is a
+     * valid selector, and throwing rejects the response as `invalid-envelope`.
+     */
+    select?: (payload: unknown) => unknown;
+    /**
+     * Called once per fallback, never for a successful load.
+     *
+     * Optional because there is no sensible default: a package cannot know
+     * whether this application wants `console.warn`, a counter, or a pager. Its
+     * own failure is contained — an observability fault must not take the render
+     * with it.
+     */
+    onDiagnostic?: (diagnostic: UiBootstrapDiagnostic) => void;
+}
+interface UiBootstrapLoader<R extends UiBootstrapResources> {
+    /** Every resource, loaded concurrently. */
+    load(): Promise<UiBootstrapSnapshot<R>>;
+    /** One resource on its own. */
+    loadResource<K extends keyof R>(name: K): Promise<UiBootstrapSnapshot<R>[K]>;
+    /** `loadResource` pre-bound per name, for destructuring into a facade. */
+    loaders: {
+        [K in keyof R]: () => Promise<UiBootstrapSnapshot<R>[K]>;
+    };
+}
+declare function createUiBootstrapLoader<R extends UiBootstrapResources>(config: UiBootstrapConfig<R>): UiBootstrapLoader<R>;
+
+export { type UiBootstrapConfig as U, type UiBootstrapDiagnostic as a, type UiBootstrapFailureReason as b, type UiBootstrapFetcher as c, type UiBootstrapLoader as d, type UiBootstrapResource as e, type UiBootstrapResources as f, type UiBootstrapSnapshot as g, type UiBootstrapValue as h, createUiBootstrapLoader as i };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "najm-kit",
-  "version": "2.8.2",
+  "version": "2.10.0",
   "license": "MIT",
   "type": "module",
   "description": "Reusable React UI component package for Najm framework",
@@ -32,6 +32,18 @@
       "import": "./dist/adapters/app.mjs",
       "default": "./dist/adapters/app.mjs"
     },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.mjs",
+      "default": "./dist/server/index.mjs"
+    },
+    "./server/react": {
+      "types": "./dist/server/react.d.ts",
+      "react-server": "./dist/server/react.mjs",
+      "browser": "./dist/server/reactClientGuard.mjs",
+      "import": "./dist/server/react.mjs",
+      "default": "./dist/server/react.mjs"
+    },
     "./package.json": "./package.json",
     "./query": {
       "types": "./dist/query.d.ts",
@@ -69,7 +81,9 @@
     "dev:preview": "vite",
     "preview": "vite preview",
     "build:preview": "vite build",
-    "test": "bun test",
+    "test": "bun test && bun run test:rsc",
+    "test:rsc": "cd test/rsc && bun test --conditions react-server",
+    "test:next16": "bun run build && bun integration/next16-ui-bootstrap/run.ts",
     "clean": "rimraf dist tsconfig.tsbuildinfo"
   },
   "peerDependencies": {