kizlo 0.22.1 → 0.24.0

package/dist/cli/daemon/generate.js

@@ -17,12 +17,23 @@ import fs from "node:fs";
 * The generated barrel is also written as a stub by `kizlo init`. It re-exports `introspection`
 * rather than pre-wrapping it: a server entry passes `createKizlo({ introspection })` itself, so the
 * rest of the options stay visible at the call site instead of hiding inside a generated object.
+*
+* `contract` is left with the JSON's own type and the project's `procedures` are registered instead.
+* The old `as unknown as typeof procedures` asserted that the committed JSON and the exported tree
+* agreed rather than establishing it, and left the client type reachable only by holding the value.
 */
 const CONTRACT_BARREL = [
 	`import type { procedures } from ".."`,
 	`import contractJson from "./contract.json"`,
 	``,
-	`export const contract = contractJson as unknown as typeof procedures`,
+	`export const contract = contractJson`,
+	``,
+	`declare module "kizlo" {`,
+	`\tinterface KizloProcedureRegistry {`,
+	`\t\tprocedures: typeof procedures`,
+	`\t}`,
+	`}`,
+	``,
 	`export { introspection, type WordPressClient } from "./introspection"`,
 	``
 ].join("\n");

package/dist/client.d.ts

@@ -2,23 +2,46 @@ import { AnyProcedureTree, ExtractProcedureByScope } from "./shared/procedure.js
 import { ResultClient } from "./shared/result.js";
 
 //#region src/client.d.ts
+
+/**
+ * Generated code augments this in the project that owns the contract: `kizlo generate` writes a
+ * barrel that registers its `procedures` here, which is what gives {@link ActiveKizloClient} that
+ * project's own types without a cast.
+ */
+interface KizloProcedureRegistry {}
+/**
+ * The browser client this project compiles against. The `any` short-circuit is on the whole client
+ * rather than on the procedure tree: passing `any` through `ResultClient` distributes to a union
+ * whose second property access fails, so an unregistered project would stop compiling instead of
+ * staying loose.
+ */
+type ActiveKizloClient = KizloProcedureRegistry extends {
+  procedures: infer TProcedures extends AnyProcedureTree;
+} ? ResultClient<ExtractProcedureByScope<TProcedures, "remote" | "api">> : any;
+/** What {@link createKizloClient} returns: a {@link KizloClient} typed from the registry instead of its argument. */
+interface KizloBrowserClient {
+  readonly client: ActiveKizloClient;
+}
 interface KizloClientConfig<T extends AnyProcedureTree> {
   url?: string;
   contract: T;
   fetch?: (request: Request) => Promise<Response>;
 }
-declare class KizloClient<TProcedures extends AnyProcedureTree> {
-  readonly client: ResultClient<ExtractProcedureByScope<TProcedures, "remote" | "api">>;
-  protected readonly config: KizloClientConfig<TProcedures>;
-  constructor(config: KizloClientConfig<TProcedures>);
+declare class KizloClient<TProcedures$1 extends AnyProcedureTree> {
+  readonly client: ResultClient<ExtractProcedureByScope<TProcedures$1, "remote" | "api">>;
+  protected readonly config: KizloClientConfig<TProcedures$1>;
+  constructor(config: KizloClientConfig<TProcedures$1>);
   private getUrl;
 }
 /**
  * Creates a browser client for a generated contract. Defaults the URL to the
  * current origin (`window.location.origin`); framework packages wrap this to resolve it from their env.
+ *
+ * `contract` is the runtime routing table only. The type comes from {@link KizloProcedureRegistry},
+ * which the generated barrel augments, so the client is typed even where the value is not in hand.
  */
-declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: {
+declare function createKizloClient(contract: unknown, options?: {
   url?: string;
-}): KizloClient<T>;
+}): KizloBrowserClient;
 //#endregion
-export { KizloClient, KizloClientConfig, createKizloClient };
+export { ActiveKizloClient, KizloBrowserClient, KizloClient, KizloClientConfig, KizloProcedureRegistry, createKizloClient };

package/dist/client.js

@@ -43,6 +43,9 @@ var KizloClient = class {
 /**
 * Creates a browser client for a generated contract. Defaults the URL to the
 * current origin (`window.location.origin`); framework packages wrap this to resolve it from their env.
+*
+* `contract` is the runtime routing table only. The type comes from {@link KizloProcedureRegistry},
+* which the generated barrel augments, so the client is typed even where the value is not in hand.
 */
 function createKizloClient(contract, options) {
 	return new KizloClient({

package/dist/index.d.ts

@@ -33,7 +33,7 @@ import { InferProcedureData, InferProcedureError, InferProcedureInput, InferProc
 import { AnyKizloConfig, CreateKizloOptions, Kizlo, KizloConfig, RootProcedures, S2SClient, createKizlo, integrationEnv, resolveKizloConfig, resolveWordPressConnection, wordPressConnectionComplete } from "./kizlo.js";
 import { WEB_MANIFEST_ROUTE, WebManifest, buildWebManifest, createManifestRoute } from "./brand/manifest.js";
 import "./brand/index.js";
-import { KizloClient, KizloClientConfig, createKizloClient } from "./client.js";
+import { ActiveKizloClient, KizloBrowserClient, KizloClient, KizloClientConfig, KizloProcedureRegistry, createKizloClient } from "./client.js";
 import { CONTENT_TYPES, ContentType, ListSitemapUrlInput, ListSitemapUrlInputBase, Robots, RobotsRule, Seo, SeoHead, SeoSchema, Sitemap, SitemapIndex, SitemapList, SitemapUrl, SitemapUrlImage, SitemapUrlList } from "./seo/schema.js";
 import { WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage } from "./seo/types.js";
 import { SitemapIndexEntry, deserializeSeo, parseSitemapSlug, renderJsonLd, renderSitemapIndex, renderUrlSet, sitemapEntryPath, xmlResponse } from "./seo/utils.js";
@@ -43,4 +43,4 @@ import { ShaAlgorithm, compare, hash, hmac } from "./shared/crypto.js";
 import { Identifier, parseIdentifier } from "./shared/identifier.js";
 import { createOrpcRouter } from "./shared/router.js";
 import { deserializeCurrencyFormat, deserializeListMetadata, emptyList, serializeCurrencyFormat } from "./shared/serialize.js";
-export { ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetSession, AuthUser, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, type Category, type CategoryCustomFields, CategoryCustomFieldsSchema, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloResult, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeCallerOptions, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, type Page, type PageCustomFields, PageCustomFieldsSchema, PersonSettings, PersonSettingsInput, PluginSource, type Post, type PostCustomFields, PostCustomFieldsSchema, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureMethod, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, ResultClient, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, SessionFn, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, type Tag, type TagCustomFields, TagCustomFieldsSchema, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_RequestParts, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createResultClient, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, sortIntegrations, toKizloError, turnstile, wordPressConnectionComplete, wpEndpoint, xmlResponse };
+export { ActiveKizloClient, ActiveWordPressClient, AnyContext, AnyEventSchema, AnyEvents, AnyIntegration, AnyKizloConfig, AnyMiddleware, AnyNestedClient, AnyProcedure, AnyProcedureTree, AuthAdapter, AuthGetSession, AuthUser, AuthorsSettings, AuthorsSettingsInput, BaseHandlerOptions, BrandSettings, BrandSettingsInput, COMMON_ERRORS, CONTENT_TYPES, CORE_PROCEDURES, CaptchaAdapter, type Category, type CategoryCustomFields, CategoryCustomFieldsSchema, CommonErrorCode, CommonErrorLiteral, CommonErrorMap, ConnInfo, ConnInfoFn, ConsoleLogAdapterOptions, ContentType, Context, ContextConfig, Contract, ContractProcedure, CookiesAdapter, CookiesDeleteAll, CookiesGetAll, CookiesSetAll, CookiesStorage, CoreProcedures, CrawlingSettings, CrawlingSettingsInput, CreateKizloOptions, CreateSitemapRouteOptions, CurrencyFormat, DefinedErrorMapLike, DevPluginSource, EnvReader, EnvRecord, EnvSource, ErrorDefinition, EventHandler, EventHandlerFn, ExtractIntegrationProcedures, ExtractMiddlewareContextOutput, ExtractParams, ExtractProcedureByScope, Fixture, FixtureCleanupFn, FixtureSeedFn, FixtureSettleFn, GeoAdapter, GeoGetConnInfo, HTTPMethod, HeadlessSettings, HeadlessSettingsInput, IconDescriptor, Identifier, IdentifierInput, IdentitySettings, IdentitySettingsInput, InferEventUnion, InferIntegrationProcedures, InferMiddlewares, InferProcedureData, InferProcedureError, InferProcedureInput, InferProcedureResult, Integration, IntegrationRequirements, InvocationScope, JsonValue, Kizlo, KizloBrowserClient, KizloClient, KizloClientConfig, KizloConfig, KizloEnv, KizloError, KizloErrorOptions, KizloErrorUnion, KizloProcedureRegistry, KizloResult, LIST_ORDER, List, ListMetadata, ListOrder, ListSitemapUrlInput, ListSitemapUrlInputBase, LocalPlugin, LogLevel, LogPayload, Logger, LoggerAdapter, ManifestIcon, MaybeCallerOptions, MaybeOptionalOptions, Middleware, MiddlewareHandler, MiddlewareNextFn, MiddlewareOptions, MiddlewareResult, OpenapiPart, OrganizationFounder, OrganizationSettings, OrganizationSettingsInput, type Page, type PageCustomFields, PageCustomFieldsSchema, PersonSettings, PersonSettingsInput, PluginSource, type Post, type PostCustomFields, PostCustomFieldsSchema, PostStatusDefinition, PostTypeSettings, PostTypeSettingsInput, PreviewTokenData, PreviewTokenPayload, Procedure, ProcedureContext, ProcedureErrors, ProcedureHandler, ProcedureMethod, ProcedureOptions, ProcedureTreeDepthTuple, RedirectInput, RedirectStatus, ResolveParamsPart, ResolvedIcons, ResolvedSchemaInput, ResolvedSchemaOutput, ResultClient, Robots, RobotsRule, RootProcedures, S2SClient, SITEMAP_BASE, SITEMAP_INDEX_SLUG, SchemaIO, SeedContext, Seo, SeoHead, SeoSchema, ServiceAdapters, SessionFn, Settings, SettingsService, SettleContext, ShaAlgorithm, SiteSettings, SiteSettingsInput, Sitemap, SitemapIndex, SitemapIndexEntry, SitemapList, SitemapRouteExtra, SitemapUrl, SitemapUrlImage, SitemapUrlList, SocialProfile, type Tag, type TagCustomFields, TagCustomFieldsSchema, TaxonomySettings, TaxonomySettingsInput, TestAdminUser, TestCredentials, TestUser, ThrowableErrorFn, ThrowableErrorMap, UploadsSettings, UploadsSettingsInput, VerifyCaptchaFn, VerifyPreviewTokenFn, WEB_MANIFEST_ROUTE, WPK_RobotRule, WPK_Robots, WPK_Seo, WPK_Sitemap, WPK_SitemapUrl, WPK_SitemapUrlImage, WP_CallOptions, WP_Client, WP_CommonErrorCode, WP_CurrencyFormat, WP_CustomFields, WP_CustomFieldsPath, WP_Endpoint, WP_EndpointData, WP_EndpointDefinition, WP_EndpointError, WP_EndpointInput, WP_EndpointPath, WP_EndpointResult, WP_Error, WP_ErrorData, WP_Failure, WP_List, WP_ListMetadata, WP_RequestBuild, WP_RequestContentType, WP_RequestInput, WP_RequestMethod, WP_RequestParts, WP_ResponseContentType, WP_Result, WP_Success, WP_TransportFailure, WP_TypedHeaders, WebManifest, WebhookOptions, WebhookSettings, WebhookSettingsInput, WithCommonErrorMap, WordPressClientRegistry, WordPressCredentials, WordPressCustomFieldsRegistry, WordPressEndpointRegistry, WordPressEnv, WordPressTransport, WordPressTransportOptions, WordPressTransportResult, altcha, arkose, assertIntegrationEndpoints, assertIntegrationEnv, authMock, buildProcedure, buildWebManifest, buildWordPressRequest, combineDetailed, compare, consoleLog, createAuthAdapter, createCaptchaAdapter, createCookiesAdapter, createEventHandler, createGeoAdapter, createIntegration, createKizlo, createKizloClient, createLoggerAdapter, createManifestRoute, createMiddleware, createOrpcRouter, createProcedure, createResultClient, createSitemapRedirectRoute, createSitemapRoute, createThrowableErrorMap, createWebhookRouter, createWordPressClient, customFieldsSchema, defineErrorMap, defineFixture, deserializeCurrencyFormat, deserializeListMetadata, deserializeSeo, emptyList, friendlyCaptcha, generateContract, geoMock, geoVercelNext, handleUnexpectedError, hash, hcaptcha, hmac, integrationEnv, isContractProcedure, isKizloError, isLocalPlugin, isWordPressResourceError, mergeServiceAdapters, missingEndpoints, missingEnv, noopAdapter, parseIdentifier, parseSitemapSlug, readEnv, recaptcha, renderJsonLd, renderSitemapIndex, renderUrlSet, resolveIcons, resolveKizloConfig, resolveWordPressConnection, restoreContract, schemaType, serializeCurrencyFormat, sitemapEntryPath, sortIntegrations, toKizloError, turnstile, wordPressConnectionComplete, wpEndpoint, xmlResponse };

package/dist/integrations/astro/kizlo.client.d.ts

@@ -1,5 +1,4 @@
-import { AnyProcedureTree } from "../../shared/procedure.js";
-import { KizloClient } from "../../client.js";
+import { KizloBrowserClient } from "../../client.js";
 
 //#region src/integrations/astro/kizlo.client.d.ts
 interface KizloClientOptions {
@@ -10,6 +9,6 @@ interface KizloClientOptions {
    */
   url?: string;
 }
-declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient(contract: unknown, options?: KizloClientOptions): KizloBrowserClient;
 //#endregion
 export { KizloClientOptions, createKizloClient };

package/dist/integrations/astro/kizlo.client.js

@@ -1,13 +1,10 @@
-import { KizloClient } from "../../client.js";
+import { createKizloClient } from "../../client.js";
 import { getServerBaseUrl } from "./utils.js";
 
 //#region src/integrations/astro/kizlo.client.ts
-function createKizloClient(contract, options) {
-	return new KizloClient({
-		url: options?.url ?? getServerBaseUrl(),
-		contract
-	});
+function createKizloClient$1(contract, options) {
+	return createKizloClient(contract, { url: options?.url ?? getServerBaseUrl() });
 }
 
 //#endregion
-export { createKizloClient };
+export { createKizloClient$1 as createKizloClient };

package/dist/integrations/nextjs/kizlo.client.d.ts

@@ -1,10 +1,9 @@
-import { AnyProcedureTree } from "../../shared/procedure.js";
-import { KizloClient } from "../../client.js";
+import { KizloBrowserClient } from "../../client.js";
 
 //#region src/integrations/nextjs/kizlo.client.d.ts
 interface KizloClientOptions {
   url?: string;
 }
-declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient(contract: unknown, options?: KizloClientOptions): KizloBrowserClient;
 //#endregion
 export { KizloClientOptions, createKizloClient };

package/dist/integrations/nextjs/kizlo.client.js

@@ -1,13 +1,10 @@
-import { KizloClient } from "../../client.js";
+import { createKizloClient } from "../../client.js";
 import { getServerBaseUrl } from "./utils.js";
 
 //#region src/integrations/nextjs/kizlo.client.ts
-function createKizloClient(contract, options) {
-	return new KizloClient({
-		url: options?.url ?? getServerBaseUrl(),
-		contract
-	});
+function createKizloClient$1(contract, options) {
+	return createKizloClient(contract, { url: options?.url ?? getServerBaseUrl() });
 }
 
 //#endregion
-export { createKizloClient };
+export { createKizloClient$1 as createKizloClient };

package/dist/integrations/tanstack-start/kizlo.client.d.ts

@@ -1,5 +1,4 @@
-import { AnyProcedureTree } from "../../shared/procedure.js";
-import { KizloClient } from "../../client.js";
+import { KizloBrowserClient } from "../../client.js";
 
 //#region src/integrations/tanstack-start/kizlo.client.d.ts
 interface KizloClientOptions {
@@ -15,6 +14,6 @@ interface KizloClientOptions {
  * over HTTP, so it runs the same in the browser and during SSR. Server routes and server functions use
  * the server-to-server client from {@link createKizlo} instead.
  */
-declare function createKizloClient<T extends AnyProcedureTree>(contract: T, options?: KizloClientOptions): KizloClient<T>;
+declare function createKizloClient(contract: unknown, options?: KizloClientOptions): KizloBrowserClient;
 //#endregion
 export { KizloClientOptions, createKizloClient };

package/dist/integrations/tanstack-start/kizlo.client.js

@@ -1,4 +1,4 @@
-import { KizloClient } from "../../client.js";
+import { createKizloClient } from "../../client.js";
 import { getServerBaseUrl } from "./utils.js";
 
 //#region src/integrations/tanstack-start/kizlo.client.ts
@@ -7,12 +7,9 @@ import { getServerBaseUrl } from "./utils.js";
 * over HTTP, so it runs the same in the browser and during SSR. Server routes and server functions use
 * the server-to-server client from {@link createKizlo} instead.
 */
-function createKizloClient(contract, options) {
-	return new KizloClient({
-		url: options?.url ?? getServerBaseUrl(),
-		contract
-	});
+function createKizloClient$1(contract, options) {
+	return createKizloClient(contract, { url: options?.url ?? getServerBaseUrl() });
 }
 
 //#endregion
-export { createKizloClient };
+export { createKizloClient$1 as createKizloClient };

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.22.1";
+var version = "0.24.0";
 
 //#endregion
 export { version };

package/dist/react.d.ts

@@ -0,0 +1,56 @@
+import { ActiveKizloClient } from "./client.js";
+import * as react0 from "react";
+import { ReactNode } from "react";
+
+//#region src/react.d.ts
+
+/**
+ * What the context carries. One key today, which is why the hook hands back the object rather than the client itself: a
+ * locale, a session or app-wide configuration can join it without changing a signature.
+ */
+type KizloContextValue = {
+  /** The app's browser Kizlo client, typed from the procedures that app registered. */
+  client: ActiveKizloClient;
+};
+type KizloProviderProps = {
+  children: ReactNode;
+  /** The app's browser Kizlo client, the callable procedure tree. */
+  client: ActiveKizloClient;
+};
+/**
+ * Holds the app's browser Kizlo client for the client components below it. Mount it once, above anything that reads it.
+ *
+ * @example
+ * ```tsx
+ * // app/providers.tsx
+ * "use client"
+ * import { KizloProvider } from "kizlo/react"
+ * import { client } from "@/lib/kizlo/client"
+ *
+ * export function Providers({ children }: { children: React.ReactNode }) {
+ * 	return <KizloProvider client={client}>{children}</KizloProvider>
+ * }
+ * ```
+ */
+declare function KizloProvider({
+  children,
+  client
+}: KizloProviderProps): react0.JSX.Element;
+/**
+ * Reads the context, whose `client` is typed from the procedures the app registered, so a call the contract does not
+ * carry is a compile error rather than a runtime surprise.
+ *
+ * @example
+ * ```tsx
+ * "use client"
+ * import { useKizloContext } from "kizlo/react"
+ *
+ * function LatestPosts() {
+ * 	const { client } = useKizloContext()
+ * 	// ...
+ * }
+ * ```
+ */
+declare function useKizloContext(): KizloContextValue;
+//#endregion
+export { KizloContextValue, KizloProvider, KizloProviderProps, useKizloContext };

package/dist/react.js

@@ -0,0 +1,54 @@
+"use client";
+
+
+import { createContext, useContext, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+
+//#region src/react.tsx
+const KizloContext = createContext(null);
+/**
+* Holds the app's browser Kizlo client for the client components below it. Mount it once, above anything that reads it.
+*
+* @example
+* ```tsx
+* // app/providers.tsx
+* "use client"
+* import { KizloProvider } from "kizlo/react"
+* import { client } from "@/lib/kizlo/client"
+*
+* export function Providers({ children }: { children: React.ReactNode }) {
+* 	return <KizloProvider client={client}>{children}</KizloProvider>
+* }
+* ```
+*/
+function KizloProvider({ children, client }) {
+	if (!client) throw new Error("<KizloProvider client={client}> needs the browser client `createKizloClient` returned.");
+	const value = useMemo(() => ({ client }), [client]);
+	return /* @__PURE__ */ jsx(KizloContext.Provider, {
+		value,
+		children
+	});
+}
+/**
+* Reads the context, whose `client` is typed from the procedures the app registered, so a call the contract does not
+* carry is a compile error rather than a runtime surprise.
+*
+* @example
+* ```tsx
+* "use client"
+* import { useKizloContext } from "kizlo/react"
+*
+* function LatestPosts() {
+* 	const { client } = useKizloContext()
+* 	// ...
+* }
+* ```
+*/
+function useKizloContext() {
+	const value = useContext(KizloContext);
+	if (!value) throw new Error("mount <KizloProvider client={client}> from kizlo/react above this component.");
+	return value;
+}
+
+//#endregion
+export { KizloProvider, useKizloContext };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kizlo",
-  "version": "0.22.1",
+  "version": "0.24.0",
   "type": "module",
   "description": "A headless WordPress framework for TypeScript.",
   "keywords": [
@@ -40,6 +40,12 @@
         "default": "./dist/index.js"
       }
     },
+    "./react": {
+      "import": {
+        "types": "./dist/react.d.ts",
+        "default": "./dist/react.js"
+      }
+    },
     "./config": {
       "import": {
         "types": "./dist/config.d.ts",