@btst/stack 3.0.0-rc.1 → 3.0.0-rc.3

package/dist/client/components/index.d.ts

@@ -3,8 +3,10 @@ import React__default, { ErrorInfo } from 'react';
 import { FallbackProps } from 'react-error-boundary';
 export { FallbackProps } from 'react-error-boundary';
 import { createRouter } from '@btst/yar';
-import { C as CanParams } from '../../shared/stack.C4_gEENS.js';
+import { PermissionRequest } from '../../authorization/index.js';
+import 'zod';
 
+type RoutePermission = PermissionRequest;
 /**
  * Route type with optional components
  */
@@ -29,6 +31,23 @@ declare function RouteRenderer({ router, path, NotFoundComponent, onNotFound, on
     onError: (error: Error, info: ErrorInfo) => void;
     props?: any;
 }): react_jsx_runtime.JSX.Element;
+/**
+ * Route-level permission gate used by `ComposedRoute` when a `permission`
+ * is declared.
+ *
+ * - Without an auth provider on `StackProvider`, renders children unchanged.
+ * - While the identity/permission check is pending, renders the route's
+ *   `LoadingComponent` so gated content never flashes.
+ * - On deny: unauthenticated users are redirected to the provider's
+ *   `loginPath` (via the top-level router's `navigate`, falling back to
+ *   `window.location.assign`); authenticated users get an `Unauthorized`
+ *   error thrown into the route's ErrorBoundary.
+ */
+declare function PermissionRouteAccess({ permission, LoadingComponent, children, }: {
+    permission: RoutePermission;
+    LoadingComponent?: React__default.ComponentType;
+    children: React__default.ReactNode;
+}): react_jsx_runtime.JSX.Element;
 /**
  * Renders a route with Suspense and ErrorBoundary wrappers.
  * Handles loading states, error boundaries, and not-found scenarios for a single route.
@@ -44,9 +63,7 @@ declare function RouteRenderer({ router, path, NotFoundComponent, onNotFound, on
  *   a prop named `params` or `query` intentionally takes precedence over the
  *   router-extracted values. Only pass trusted, framework-controlled values.
  * @param onError - Error handler callback for the error boundary
- * @param permission - Optional route-level permission requirement (e.g.
- *   `{ resource: "blog:draft", action: "read" }`). Only enforced when an
- *   auth provider is configured on `StackProvider`; see `RouteGuard`.
+ * @param permission - Optional schema-backed route permission descriptor.
  */
 declare function ComposedRoute({ path, PageComponent, ErrorComponent, LoadingComponent, onNotFound, NotFoundComponent, props, onError, permission, }: {
     path: string;
@@ -59,7 +76,7 @@ declare function ComposedRoute({ path, PageComponent, ErrorComponent, LoadingCom
     }>;
     props?: any;
     onError: (error: Error, info: ErrorInfo) => void;
-    permission?: CanParams;
+    permission?: RoutePermission;
 }): react_jsx_runtime.JSX.Element | undefined;
 
 /**
@@ -78,5 +95,5 @@ declare function ErrorBoundary({ children, FallbackComponent, resetKeys, onError
     onError: (error: Error, info: ErrorInfo) => void;
 }): react_jsx_runtime.JSX.Element;
 
-export { ComposedRoute, ErrorBoundary, RouteRenderer };
+export { ComposedRoute, ErrorBoundary, PermissionRouteAccess, RouteRenderer };
 export type { RouteWithComponents };

package/dist/client/components/index.mjs

@@ -1,2 +1,2 @@
-export { ComposedRoute, RouteRenderer } from '../../packages/stack/src/client/components/compose.mjs';
+export { ComposedRoute, PermissionRouteAccess, RouteRenderer } from '../../packages/stack/src/client/components/compose.mjs';
 export { ErrorBoundary } from '../../packages/stack/src/client/components/error-boundary.mjs';

package/dist/client/hooks/index.cjs

@@ -0,0 +1,8 @@
+"use client";
+'use strict';
+
+const useListState = require('../../packages/stack/src/client/hooks/use-list-state.cjs');
+
+
+
+exports.useListState = useListState.useListState;

package/dist/client/hooks/index.d.cts

@@ -0,0 +1,25 @@
+import { L as ListStateSchema, I as InferListState, S as SetListState } from '../../shared/stack.Cmg7lzzy.cjs';
+export { b as ListStateField, a as SetListStateOptions } from '../../shared/stack.Cmg7lzzy.cjs';
+
+/**
+ * Sync list UI state (filters, tabs, pagination) with URL search params.
+ *
+ * Defaults are omitted from the URL. Field-level `history: "replace"` is used
+ * for rapid changes; discrete changes (tab/page) default to `push` so the back
+ * button undoes them.
+ *
+ * The `namespace` identifies this list state for SSR helpers; URL keys use
+ * the schema field names directly.
+ *
+ * @example
+ * ```tsx
+ * const [state, setState] = useListState("comments-moderation", {
+ *   tab: { type: "string", default: "pending" },
+ *   page: { type: "number", default: 1 },
+ * });
+ * // URL: ?tab=spam&page=3
+ * ```
+ */
+declare function useListState<S extends ListStateSchema>(namespace: string, schema: S): [InferListState<S>, SetListState<S>];
+
+export { InferListState, ListStateSchema, SetListState, useListState };

package/dist/client/hooks/index.d.mts

@@ -0,0 +1,25 @@
+import { L as ListStateSchema, I as InferListState, S as SetListState } from '../../shared/stack.Cmg7lzzy.mjs';
+export { b as ListStateField, a as SetListStateOptions } from '../../shared/stack.Cmg7lzzy.mjs';
+
+/**
+ * Sync list UI state (filters, tabs, pagination) with URL search params.
+ *
+ * Defaults are omitted from the URL. Field-level `history: "replace"` is used
+ * for rapid changes; discrete changes (tab/page) default to `push` so the back
+ * button undoes them.
+ *
+ * The `namespace` identifies this list state for SSR helpers; URL keys use
+ * the schema field names directly.
+ *
+ * @example
+ * ```tsx
+ * const [state, setState] = useListState("comments-moderation", {
+ *   tab: { type: "string", default: "pending" },
+ *   page: { type: "number", default: 1 },
+ * });
+ * // URL: ?tab=spam&page=3
+ * ```
+ */
+declare function useListState<S extends ListStateSchema>(namespace: string, schema: S): [InferListState<S>, SetListState<S>];
+
+export { InferListState, ListStateSchema, SetListState, useListState };

package/dist/client/hooks/index.d.ts

@@ -0,0 +1,25 @@
+import { L as ListStateSchema, I as InferListState, S as SetListState } from '../../shared/stack.Cmg7lzzy.js';
+export { b as ListStateField, a as SetListStateOptions } from '../../shared/stack.Cmg7lzzy.js';
+
+/**
+ * Sync list UI state (filters, tabs, pagination) with URL search params.
+ *
+ * Defaults are omitted from the URL. Field-level `history: "replace"` is used
+ * for rapid changes; discrete changes (tab/page) default to `push` so the back
+ * button undoes them.
+ *
+ * The `namespace` identifies this list state for SSR helpers; URL keys use
+ * the schema field names directly.
+ *
+ * @example
+ * ```tsx
+ * const [state, setState] = useListState("comments-moderation", {
+ *   tab: { type: "string", default: "pending" },
+ *   page: { type: "number", default: 1 },
+ * });
+ * // URL: ?tab=spam&page=3
+ * ```
+ */
+declare function useListState<S extends ListStateSchema>(namespace: string, schema: S): [InferListState<S>, SetListState<S>];
+
+export { InferListState, ListStateSchema, SetListState, useListState };

package/dist/client/hooks/index.mjs

@@ -0,0 +1,2 @@
+"use client";
+export { useListState } from '../../packages/stack/src/client/hooks/use-list-state.mjs';

package/dist/client/index.cjs

@@ -1,15 +1,44 @@
 'use strict';
 
 const yar = require('@btst/yar');
+const runtime = require('../packages/stack/src/client/runtime.cjs');
+const pluginRegistration = require('../packages/stack/src/plugin-registration.cjs');
 const sitemapUtils = require('../packages/stack/src/client/sitemap-utils.cjs');
 const metaUtils = require('../packages/stack/src/client/meta-utils.cjs');
 const pathUtils = require('../packages/stack/src/client/path-utils.cjs');
-const useListState = require('../packages/stack/src/client/hooks/use-list-state.cjs');
 const listState = require('../packages/stack/src/shared/list-state.cjs');
 
-function createStackClient(config) {
-  const { plugins, basePath } = config;
-  const allRoutes = {};
+function createClientStack(config) {
+  const registrations = config.plugins;
+  const registrationIds = pluginRegistration.resolvePluginRegistrationIds(registrations, "client");
+  const validatedRegistrations = registrations;
+  const runtime$1 = runtime.resolveClientRuntime(config, registrationIds);
+  const resolvedPlugins = /* @__PURE__ */ Object.create(
+    null
+  );
+  for (const [pluginKey, registration] of Object.entries(
+    validatedRegistrations
+  )) {
+    const definition = registration;
+    if (!Object.hasOwn(definition, "resolve") || typeof definition.resolve !== "function") {
+      throw new Error(
+        `[btst/client] Client plugin "${pluginKey}" must declare an own resolve() function.`
+      );
+    }
+    const resolution = definition.resolve(runtime$1.pluginRuntimes[pluginKey]);
+    if (!resolution || typeof resolution.routes !== "function") {
+      throw new Error(
+        `[btst/client] Client plugin "${pluginKey}" did not resolve to a routes() function.`
+      );
+    }
+    resolvedPlugins[pluginKey] = {
+      ...resolution,
+      id: registrationIds[pluginKey]
+    };
+  }
+  const plugins = resolvedPlugins;
+  const basePath = runtime$1.provider.site.basePath;
+  const allRoutes = /* @__PURE__ */ Object.create(null);
   const clientStackContext = {
     plugins,
     basePath
@@ -19,7 +48,8 @@ function createStackClient(config) {
     Object.assign(allRoutes, pluginRoutes);
   }
   const router = yar.createRouter(allRoutes);
-  return {
+  const result = {
+    context: clientStackContext,
     router,
     async generateSitemap() {
       const sitemapEntries = [];
@@ -39,13 +69,14 @@ function createStackClient(config) {
       return deduped;
     }
   };
+  return { ...result, provider: runtime$1.provider };
 }
 
 exports.sitemapEntryToXmlString = sitemapUtils.sitemapEntryToXmlString;
 exports.metaElementsToObject = metaUtils.metaElementsToObject;
 exports.normalizePath = pathUtils.normalizePath;
-exports.useListState = useListState.useListState;
 exports.listStateParamKey = listState.listStateParamKey;
 exports.parseListStateFromSearchParams = listState.parseListStateFromSearchParams;
+exports.resolveListStateHistoryMode = listState.resolveListStateHistoryMode;
 exports.serializeListStateToSearchParams = listState.serializeListStateToSearchParams;
-exports.createStackClient = createStackClient;
+exports.createClientStack = createClientStack;

package/dist/client/index.d.cts

@@ -1,9 +1,15 @@
-import { c as Sitemap, C as ClientPlugin, d as PluginRoutes, e as ClientLibConfig, f as ClientLib } from '../shared/stack.CBsp9rDM.cjs';
-export { b as ClientStackContext } from '../shared/stack.CBsp9rDM.cjs';
+import { s as Sitemap, q as ClientPluginRegistration, t as PluginRoutes, u as ClientStackConfig, v as ResolvedClientStack } from '../shared/stack.DiuRuzIs.cjs';
+export { w as ClientApiConfig, x as ClientApiEndpointOverride, y as ClientLocation, z as ClientLocationOverride, C as ClientPlugin, p as ClientPluginDefinition, E as ClientPluginEndpointOverride, F as ClientPluginEndpointOverrides, G as ClientProviderApi, H as ClientProviderPluginRuntime, J as ClientProviderProjection, N as ClientStack, K as ClientStackContext, L as ResolvedClientApi, r as ResolvedClientPluginRuntime, M as ResolvedClientStackConfig } from '../shared/stack.DiuRuzIs.cjs';
+export { I as InferListState, b as ListStateField, L as ListStateSchema, S as SetListState, a as SetListStateOptions, l as listStateParamKey, p as parseListStateFromSearchParams, r as resolveListStateHistoryMode, s as serializeListStateToSearchParams } from '../shared/stack.Cmg7lzzy.cjs';
 import '@btst/yar';
+import '@tanstack/react-query';
 import '@btst/db';
 import 'better-call';
-import '../shared/stack.C4_gEENS.cjs';
+import '../authorization/server.cjs';
+import '../authorization/index.cjs';
+import 'zod';
+import '../shared/stack.CKXzdGiJ.cjs';
+import '../shared/stack.BYMentwB.cjs';
 
 /**
  * Converts an array of sitemap entries into an XML string following the sitemap.org protocol.
@@ -97,113 +103,37 @@ declare function metaElementsToObject(metaElements: Array<React.JSX.IntrinsicEle
  */
 declare function normalizePath(path?: string | Array<string> | undefined): string;
 
-type ListStateFieldType = "string" | "number" | "boolean";
-interface ListStateField<T extends ListStateFieldType = ListStateFieldType> {
-    type: T;
-    default: T extends "string" ? string : T extends "number" ? number : boolean;
-    /**
-     * How URL history is updated when this field changes.
-     * - `"push"` (default): discrete changes (tab switch, page change) — back button undoes.
-     * - `"replace"`: rapid changes (typing in a filter) — no extra history entries.
-     */
-    history?: "push" | "replace";
-}
-type ListStateSchema = Record<string, ListStateField>;
-type InferListStateValue<F extends ListStateField> = F["type"] extends "string" ? string : F["type"] extends "number" ? number : boolean;
-type InferListState<S extends ListStateSchema> = {
-    [K in keyof S]: InferListStateValue<S[K]>;
-};
-/**
- * URL query param key for a list-state field.
- * The `namespace` argument identifies the hook instance for SSR helpers but
- * does not prefix URL keys — field names are used directly (e.g. `?tab=spam`).
- */
-declare function listStateParamKey(_namespace: string, fieldKey: string): string;
-/**
- * Parse list state from URL search params (SSR-safe — pass the request URL's
- * search string or a `URLSearchParams` instance).
- */
-declare function parseListStateFromSearchParams<S extends ListStateSchema>(namespace: string, schema: S, searchParams: URLSearchParams | string): InferListState<S>;
-/**
- * Serialize list state into URL search params. Default values are omitted for
- * clean URLs.
- */
-declare function serializeListStateToSearchParams<S extends ListStateSchema>(namespace: string, schema: S, state: InferListState<S>, baseParams?: URLSearchParams): URLSearchParams;
-
-type SetListStateOptions = {
-    /** Force `replace` vs `push` history semantics for this update */
-    replace?: boolean;
-};
-type SetListState<S extends ListStateSchema> = (updates: Partial<InferListState<S>> | ((prev: InferListState<S>) => Partial<InferListState<S>>), options?: SetListStateOptions) => void;
+type AnyPluginMap = Record<string, ClientPluginRegistration<any, any, any, any, any>>;
 /**
- * Sync list UI state (filters, tabs, pagination) with URL search params.
- *
- * Defaults are omitted from the URL. Field-level `history: "replace"` is used
- * for rapid changes; discrete changes (tab/page) default to `push` so the back
- * button undoes them.
+ * Resolves all registered client plugin definitions against one API location,
+ * site location, and React Query client.
  *
- * The `namespace` identifies this list state for SSR helpers; URL keys use
- * the schema field names directly.
- *
- * @example
- * ```tsx
- * const [state, setState] = useListState("comments-moderation", {
- *   tab: { type: "string", default: "pending" },
- *   page: { type: "number", default: 1 },
- * });
- * // URL: ?tab=spam&page=3
- * ```
- */
-declare function useListState<S extends ListStateSchema>(namespace: string, schema: S): [InferListState<S>, SetListState<S>];
-
-/**
- * Creates the client library with plugin support
+ * Create a request-specific instance with `api.headers` for SSR/SSG and a
+ * separate browser instance without request headers. The returned `provider`
+ * projection contains no request headers.
  *
  * @example
  * ```ts
- * // For Next.js with SSR:
- * const lib = createStackClient({
+ * const clientStack = createClientStack({
+ *   api: {
+ *     baseURL: "https://app.example.com",
+ *     basePath: "/api/data",
+ *     headers: requestHeaders,
+ *   },
+ *   site: {
+ *     baseURL: "https://app.example.com",
+ *     basePath: "/pages",
+ *   },
+ *   queryClient,
  *   plugins: {
- *     blog: blogPlugin.client
- *   }
+ *     example: exampleClientPlugin(),
+ *   },
  * });
- *
- * // SPA usage - just render the route
- * function Page() {
- *   return lib.resolveRoute('/blog');
- * }
- *
- * // SSR usage - prefetch data with loader, then render
- * async function Page({ params }) {
- *   const path = '/blog';
- *
- *   // Load data server-side if loader exists
- *   const loader = lib.getLoader(path);
- *   if (loader) await loader(queryClient, baseURL, basePath);
- *
- *   // Render with built-in Suspense + Error Boundary
- *   return lib.resolveRoute(path);
- * }
- *
- * // Next.js with notFound() function
- * import { notFound } from 'next/navigation';
- *
- * async function Page({ params }) {
- *   const path = '/blog';
- *   const loader = lib.getLoader(path);
- *   if (loader) await loader(queryClient, baseURL);
- *
- *   return lib.resolveRoute(path, {
- *     onNotFound: notFound // Calls Next.js notFound() instead of rendering
- *   });
- * }
- *
  * ```
  *
  * @template TPlugins - The exact plugins map (inferred from config)
  * @template TRoutes - All routes from all plugins, merged (computed automatically)
  */
-declare function createStackClient<TPlugins extends Record<string, ClientPlugin<any, any>>, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>>(config: ClientLibConfig<TPlugins>): ClientLib<TRoutes>;
+declare function createClientStack<TPlugins extends AnyPluginMap, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>>(config: ClientStackConfig<TPlugins>): ResolvedClientStack<TRoutes, TPlugins>;
 
-export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient, listStateParamKey, metaElementsToObject, normalizePath, parseListStateFromSearchParams, serializeListStateToSearchParams, sitemapEntryToXmlString, useListState };
-export type { InferListState, ListStateField, ListStateSchema, SetListState, SetListStateOptions };
+export { ClientPluginRegistration, ClientStackConfig, ResolvedClientStack, createClientStack, metaElementsToObject, normalizePath, sitemapEntryToXmlString };

package/dist/client/index.d.mts

@@ -1,9 +1,15 @@
-import { c as Sitemap, C as ClientPlugin, d as PluginRoutes, e as ClientLibConfig, f as ClientLib } from '../shared/stack.BL5PvShn.mjs';
-export { b as ClientStackContext } from '../shared/stack.BL5PvShn.mjs';
+import { s as Sitemap, q as ClientPluginRegistration, t as PluginRoutes, u as ClientStackConfig, v as ResolvedClientStack } from '../shared/stack.CfK5NKlK.mjs';
+export { w as ClientApiConfig, x as ClientApiEndpointOverride, y as ClientLocation, z as ClientLocationOverride, C as ClientPlugin, p as ClientPluginDefinition, E as ClientPluginEndpointOverride, F as ClientPluginEndpointOverrides, G as ClientProviderApi, H as ClientProviderPluginRuntime, J as ClientProviderProjection, N as ClientStack, K as ClientStackContext, L as ResolvedClientApi, r as ResolvedClientPluginRuntime, M as ResolvedClientStackConfig } from '../shared/stack.CfK5NKlK.mjs';
+export { I as InferListState, b as ListStateField, L as ListStateSchema, S as SetListState, a as SetListStateOptions, l as listStateParamKey, p as parseListStateFromSearchParams, r as resolveListStateHistoryMode, s as serializeListStateToSearchParams } from '../shared/stack.Cmg7lzzy.mjs';
 import '@btst/yar';
+import '@tanstack/react-query';
 import '@btst/db';
 import 'better-call';
-import '../shared/stack.C4_gEENS.mjs';
+import '../authorization/server.mjs';
+import '../authorization/index.mjs';
+import 'zod';
+import '../shared/stack.CKXzdGiJ.mjs';
+import '../shared/stack.BYMentwB.mjs';
 
 /**
  * Converts an array of sitemap entries into an XML string following the sitemap.org protocol.
@@ -97,113 +103,37 @@ declare function metaElementsToObject(metaElements: Array<React.JSX.IntrinsicEle
  */
 declare function normalizePath(path?: string | Array<string> | undefined): string;
 
-type ListStateFieldType = "string" | "number" | "boolean";
-interface ListStateField<T extends ListStateFieldType = ListStateFieldType> {
-    type: T;
-    default: T extends "string" ? string : T extends "number" ? number : boolean;
-    /**
-     * How URL history is updated when this field changes.
-     * - `"push"` (default): discrete changes (tab switch, page change) — back button undoes.
-     * - `"replace"`: rapid changes (typing in a filter) — no extra history entries.
-     */
-    history?: "push" | "replace";
-}
-type ListStateSchema = Record<string, ListStateField>;
-type InferListStateValue<F extends ListStateField> = F["type"] extends "string" ? string : F["type"] extends "number" ? number : boolean;
-type InferListState<S extends ListStateSchema> = {
-    [K in keyof S]: InferListStateValue<S[K]>;
-};
-/**
- * URL query param key for a list-state field.
- * The `namespace` argument identifies the hook instance for SSR helpers but
- * does not prefix URL keys — field names are used directly (e.g. `?tab=spam`).
- */
-declare function listStateParamKey(_namespace: string, fieldKey: string): string;
-/**
- * Parse list state from URL search params (SSR-safe — pass the request URL's
- * search string or a `URLSearchParams` instance).
- */
-declare function parseListStateFromSearchParams<S extends ListStateSchema>(namespace: string, schema: S, searchParams: URLSearchParams | string): InferListState<S>;
-/**
- * Serialize list state into URL search params. Default values are omitted for
- * clean URLs.
- */
-declare function serializeListStateToSearchParams<S extends ListStateSchema>(namespace: string, schema: S, state: InferListState<S>, baseParams?: URLSearchParams): URLSearchParams;
-
-type SetListStateOptions = {
-    /** Force `replace` vs `push` history semantics for this update */
-    replace?: boolean;
-};
-type SetListState<S extends ListStateSchema> = (updates: Partial<InferListState<S>> | ((prev: InferListState<S>) => Partial<InferListState<S>>), options?: SetListStateOptions) => void;
+type AnyPluginMap = Record<string, ClientPluginRegistration<any, any, any, any, any>>;
 /**
- * Sync list UI state (filters, tabs, pagination) with URL search params.
- *
- * Defaults are omitted from the URL. Field-level `history: "replace"` is used
- * for rapid changes; discrete changes (tab/page) default to `push` so the back
- * button undoes them.
+ * Resolves all registered client plugin definitions against one API location,
+ * site location, and React Query client.
  *
- * The `namespace` identifies this list state for SSR helpers; URL keys use
- * the schema field names directly.
- *
- * @example
- * ```tsx
- * const [state, setState] = useListState("comments-moderation", {
- *   tab: { type: "string", default: "pending" },
- *   page: { type: "number", default: 1 },
- * });
- * // URL: ?tab=spam&page=3
- * ```
- */
-declare function useListState<S extends ListStateSchema>(namespace: string, schema: S): [InferListState<S>, SetListState<S>];
-
-/**
- * Creates the client library with plugin support
+ * Create a request-specific instance with `api.headers` for SSR/SSG and a
+ * separate browser instance without request headers. The returned `provider`
+ * projection contains no request headers.
  *
  * @example
  * ```ts
- * // For Next.js with SSR:
- * const lib = createStackClient({
+ * const clientStack = createClientStack({
+ *   api: {
+ *     baseURL: "https://app.example.com",
+ *     basePath: "/api/data",
+ *     headers: requestHeaders,
+ *   },
+ *   site: {
+ *     baseURL: "https://app.example.com",
+ *     basePath: "/pages",
+ *   },
+ *   queryClient,
  *   plugins: {
- *     blog: blogPlugin.client
- *   }
+ *     example: exampleClientPlugin(),
+ *   },
  * });
- *
- * // SPA usage - just render the route
- * function Page() {
- *   return lib.resolveRoute('/blog');
- * }
- *
- * // SSR usage - prefetch data with loader, then render
- * async function Page({ params }) {
- *   const path = '/blog';
- *
- *   // Load data server-side if loader exists
- *   const loader = lib.getLoader(path);
- *   if (loader) await loader(queryClient, baseURL, basePath);
- *
- *   // Render with built-in Suspense + Error Boundary
- *   return lib.resolveRoute(path);
- * }
- *
- * // Next.js with notFound() function
- * import { notFound } from 'next/navigation';
- *
- * async function Page({ params }) {
- *   const path = '/blog';
- *   const loader = lib.getLoader(path);
- *   if (loader) await loader(queryClient, baseURL);
- *
- *   return lib.resolveRoute(path, {
- *     onNotFound: notFound // Calls Next.js notFound() instead of rendering
- *   });
- * }
- *
  * ```
  *
  * @template TPlugins - The exact plugins map (inferred from config)
  * @template TRoutes - All routes from all plugins, merged (computed automatically)
  */
-declare function createStackClient<TPlugins extends Record<string, ClientPlugin<any, any>>, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>>(config: ClientLibConfig<TPlugins>): ClientLib<TRoutes>;
+declare function createClientStack<TPlugins extends AnyPluginMap, TRoutes extends PluginRoutes<TPlugins> = PluginRoutes<TPlugins>>(config: ClientStackConfig<TPlugins>): ResolvedClientStack<TRoutes, TPlugins>;
 
-export { ClientLib, ClientLibConfig, ClientPlugin, createStackClient, listStateParamKey, metaElementsToObject, normalizePath, parseListStateFromSearchParams, serializeListStateToSearchParams, sitemapEntryToXmlString, useListState };
-export type { InferListState, ListStateField, ListStateSchema, SetListState, SetListStateOptions };
+export { ClientPluginRegistration, ClientStackConfig, ResolvedClientStack, createClientStack, metaElementsToObject, normalizePath, sitemapEntryToXmlString };