kizlo 0.23.0 → 0.24.0

package/dist/package.js

@@ -1,5 +1,5 @@
 //#region package.json
-var version = "0.23.0";
+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.23.0",
+  "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",