@bitbitpress/client 1.0.2 → 1.1.0-alpha.0

package/dist/generated/openapi.d.ts

@@ -160,6 +160,10 @@ export interface paths {
                                  *     ]
                                  */
                                 suggestedInterestTags: string[];
+                                /** @description User's job title. */
+                                jobTitle?: string;
+                                /** @description User's company. */
+                                company?: string;
                             };
                         };
                     };
@@ -209,7 +213,7 @@ export interface paths {
         };
         /**
          * Profile - Update User Profile
-         * @description **PUT** `/v1/user/profile` Updates the user's interest tags. Supports full replace via `interestTags`, or add/remove via `addInterestTags` and `removeInterestTags` arrays.
+         * @description **PUT** `/v1/user/profile` Updates the user's profile. Supports interest tags (full replace via `interestTags`, or add/remove via `addInterestTags` / `removeInterestTags`) and optional `jobTitle` / `company` fields. Pass empty string to clear.
          */
         put: {
             parameters: {
@@ -230,6 +234,10 @@ export interface paths {
                         addInterestTags?: string[];
                         /** @description Remove these tags from the current list (ignored if interestTags is provided). */
                         removeInterestTags?: string[];
+                        /** @description User's job title. Pass an empty string to clear. */
+                        jobTitle?: string;
+                        /** @description User's company or organization. Pass an empty string to clear. */
+                        company?: string;
                     };
                 };
             };
@@ -718,7 +726,7 @@ export interface paths {
                  *       "complete": false | true
                  *     }
                  *     ```
-                 *     `data` is the synthesized object (keys match your output schema). `complete` is `false` for partial streaming updates and `true` for the final validated object for that index.
+                 *     `data` is the synthesized object (keys match your output schema). `complete` is `false` for partial streaming updates and `true` for the final validated payload. When `limit` > 1 and user reranking is configured, items at the reranking field are pooled across the N stored outputs and the final object is capped at the original array size.
                  *
                  *     **Data Events (error):**
                  *     ```json
@@ -1129,7 +1137,7 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
-    "/admin/v1/assets/upsert": {
+    "/v1/user-submissions": {
         parameters: {
             query?: never;
             header?: never;
@@ -1139,88 +1147,151 @@ export interface paths {
         get?: never;
         put?: never;
         /**
-         * Upsert Asset
-         * @description **POST** `/admin/v1/assets/upsert` Creates or updates an asset in the system. If an asset with the same `externalId` already exists it will be updated; otherwise a new asset is created and queued for ingestion.
+         * User Submissions - Create Submission
+         * @description **POST** `/v1/user-submissions` Creates a structured user submission and optional presigned file upload URLs.
          */
         post: {
             parameters: {
                 query?: never;
-                header?: never;
+                header: {
+                    authorization: string;
+                };
                 path?: never;
                 cookie?: never;
             };
             requestBody: {
                 content: {
                     "application/json": {
-                        /** @description Key name of the Admin API data source to associate this asset with */
-                        dataSourceKey: string;
-                        /** @description Unique identifier for the asset in your system */
-                        externalId: string;
-                        /** @description Title of the asset */
-                        title: string;
-                        /** @description Full text content of the asset */
-                        content: string;
-                        /**
-                         * @description Format of the content field. Defaults to text/plain.
-                         * @enum {string}
-                         */
-                        mimeType?: "text/plain" | "text/markdown" | "text/html";
-                        /** @description Canonical URL of the original source */
-                        sourceUrl?: string;
-                        /** @description ISO 8601 publication timestamp */
-                        publishedAt?: string;
-                        /** @description Author or byline */
-                        byline?: string;
-                        /** @description List of tags or categories */
-                        tags?: string[];
-                        /** @description Images associated with the asset */
-                        images?: {
-                            /** @description Image URL */
-                            src: string;
-                            /** @description Alt text */
-                            alt?: string;
-                            /** @description External identifier for the image */
-                            externalId?: string;
-                            /** @description Image width in pixels */
-                            width?: number;
-                            /** @description Image height in pixels */
-                            height?: number;
-                            /** @description Photo credit or attribution */
-                            credit?: string;
-                        }[];
-                        /** @description Videos associated with the asset */
-                        videos?: {
-                            /** @description One or more video source URLs with MIME types */
-                            sources: {
-                                /** @description MIME type of the video source (e.g. video/mp4) */
-                                mimeType: string;
-                                /** @description Video source URL */
-                                src: string;
-                            }[];
-                            /** @description Alt text for the video */
-                            alt?: string;
-                            /** @description External identifier for the video */
-                            externalId?: string;
-                            /** @description Video credit or attribution */
-                            credit?: string;
-                            /** @description Poster image URL */
-                            posterUrl?: string;
-                            /** @description Video caption */
-                            caption?: string;
-                            /** @description Video width in pixels */
-                            width?: number;
-                            /** @description Video height in pixels */
-                            height?: number;
-                        }[];
-                        /** @description Arbitrary additional data to store with the asset */
-                        externalData?: {
+                        keyName: string;
+                        data: {
                             [key: string]: unknown;
                         };
+                        files?: {
+                            field: string;
+                            contentType: string;
+                            fileName?: string;
+                        }[];
                     };
                 };
             };
             responses: {
-                /** @description Successful response */
+                /** @description Default Response */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            success: boolean;
+                            data: {
+                                submission: {
+                                    id: string;
+                                    userSubmissionSchemaId: string;
+                                    userId: string;
+                                    state: string;
+                                    createdAt: string;
+                                    updatedAt?: string;
+                                } & {
+                                    [key: string]: unknown;
+                                };
+                                uploads: {
+                                    field: string;
+                                    s3Key: string;
+                                    uploadUrl: string;
+                                }[];
+                            };
+                        };
+                    };
+                };
+                /** @description Bad request - missing or invalid parameters */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example Bad request */
+                            error?: string;
+                        };
+                    };
+                };
+                /** @description Unauthorized errors */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /**
+                             * @example Unauthorized: No authentication token provided
+                             * @enum {string}
+                             */
+                            error?: "Unauthorized: No authentication token provided" | "Unauthorized: Token has expired" | "Unauthorized: Invalid token" | "Unauthorized: Authentication failed";
+                        };
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example Not found */
+                            error?: string;
+                        };
+                    };
+                };
+                /** @description Internal server error */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example false */
+                            success?: boolean;
+                            /** @example Internal server error: An unknown error occurred */
+                            error?: string;
+                        };
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/v1/user-submission-schemas/{keyName}/submissions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * User Submissions - List Live Submissions
+         * @description **GET** `/v1/user-submission-schemas/:keyName/submissions` Lists live submissions for a schema. Customer apps cannot read non-live submissions.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    first?: number;
+                    after?: string;
+                };
+                header: {
+                    authorization: string;
+                };
+                path: {
+                    keyName: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Default Response */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -1229,12 +1300,10 @@ export interface paths {
                         "application/json": {
                             success: boolean;
                             data: {
-                                /** @description Internal asset identifier */
-                                assetId: string;
-                                /** @description True if a new asset was created */
-                                created: boolean;
-                                /** @description True if the asset was queued for ingestion */
-                                queued: boolean;
+                                cursor: null | string;
+                                items: {
+                                    [key: string]: unknown;
+                                }[];
                             };
                         };
                     };
@@ -1246,6 +1315,7 @@ export interface paths {
                     };
                     content: {
                         "application/json": {
+                            /** @example Bad request */
                             error?: string;
                         };
                     };
@@ -1257,8 +1327,23 @@ export interface paths {
                     };
                     content: {
                         "application/json": {
-                            /** @enum {string} */
-                            error?: "Unauthorized: No API key provided" | "Unauthorized: Invalid or revoked API key";
+                            /**
+                             * @example Unauthorized: No authentication token provided
+                             * @enum {string}
+                             */
+                            error?: "Unauthorized: No authentication token provided" | "Unauthorized: Token has expired" | "Unauthorized: Invalid token" | "Unauthorized: Authentication failed";
+                        };
+                    };
+                };
+                /** @description Not found */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example Not found */
+                            error?: string;
                         };
                     };
                 };
@@ -1269,13 +1354,17 @@ export interface paths {
                     };
                     content: {
                         "application/json": {
+                            /** @example false */
                             success?: boolean;
+                            /** @example Internal server error: An unknown error occurred */
                             error?: string;
                         };
                     };
                 };
             };
         };
+        put?: never;
+        post?: never;
         delete?: never;
         options?: never;
         head?: never;

package/dist/index.d.ts

@@ -6,18 +6,19 @@
  */
 export type { BitBitPressClientConfig, BitBitPressClientOptions } from './client.js';
 export { BitBitPressClient } from './client.js';
-export type { BitBitPressFetch, FetchHeaders, FetchReadableStream, FetchReadableStreamReader, RequestInit, Response, } from './request.js';
+export type { AssetsRequest, AssetsResponse } from './data/assets.js';
+export type { DataMethods } from './data/index.js';
 export type * from './generated/openapi.js';
+export type { BitBitPressFetch, FetchHeaders, FetchReadableStream, FetchReadableStreamReader, RequestInit, Response, } from './request.js';
 export type { UserMethods } from './user/index.js';
-export type { DataMethods } from './data/index.js';
-export type { AssetsRequest, AssetsResponse } from './data/assets.js';
-export type { Signal, SignalRequest, SignalResponse } from './user/signal.js';
-export type { RecommendationsRequest, RecommendationsResponse } from './user/recommendations.js';
+export type { InteractionItem, InteractionResponseRequest, InteractionResponseResponse, InteractionsRequest, InteractionsResponse, } from './user/interaction.js';
 export type { ProfileResponse, ProfileUpdateRequest } from './user/profile.js';
+export type { RecommendationsRequest, RecommendationsResponse } from './user/recommendations.js';
 export type { ReportRequest, ReportResponse } from './user/report.js';
+export type { Signal, SignalRequest, SignalResponse } from './user/signal.js';
+export type { CreateUserSubmissionRequest, CreateUserSubmissionResponse, ListUserSubmissionsRequest, ListUserSubmissionsResponse, } from './user/submissions.js';
+export type { SynthesizeEvent, SynthesizeItemResponse, SynthesizeOptions, } from './user/synthesize.js';
+export type { SynthesizeOnStreamingData } from './user/synthesize-batch-manager.js';
 export type { TokenRequest, TokenResponse } from './user/token.js';
 export type { BitBitPressSynthesizeRequest, RecommendationsRequestBody, SynthesizeInput, SynthesizeItem, SynthesizeItems, SynthesizeOutputSchema, SynthesizeRequest, } from './user/typeDefs.js';
-export type { SynthesizeEvent, SynthesizeItemResponse, SynthesizeOptions } from './user/synthesize.js';
-export type { SynthesizeOnStreamingData } from './user/synthesize-batch-manager.js';
-export type { InteractionItem, InteractionResponseRequest, InteractionResponseResponse, InteractionsRequest, InteractionsResponse, } from './user/interaction.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAC;AAGtB,mBAAmB,wBAAwB,CAAC;AAG5C,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjG,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,eAAe,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AACvG,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,YAAY,EAAE,uBAAuB,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACrF,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAEnD,mBAAmB,wBAAwB,CAAC;AAC5C,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,yBAAyB,EACzB,WAAW,EACX,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,YAAY,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,YAAY,EACV,eAAe,EACf,0BAA0B,EAC1B,2BAA2B,EAC3B,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,eAAe,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC/E,YAAY,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjG,YAAY,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAC9E,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,0BAA0B,EAC1B,2BAA2B,GAC5B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACV,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EAAE,yBAAyB,EAAE,MAAM,oCAAoC,CAAC;AACpF,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AACnE,YAAY,EACV,4BAA4B,EAC5B,0BAA0B,EAC1B,eAAe,EACf,cAAc,EACd,eAAe,EACf,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC"}

package/dist/react/index.d.ts

@@ -0,0 +1,41 @@
+import { type RenderUnknown, type SynthesisViewTreeProps } from '../synthesisView/engine.js';
+import type { ComponentMap, ContentInput, SynthesisViewEvent, SynthesizeViewFetcher } from '../synthesisView/types.js';
+export { type BitBitContextValue, BitBitProvider } from '../synthesisView/context.js';
+export { createComponentMap, type GlobModules, type RequireContext, } from '../synthesisView/createComponentMap.js';
+export type { ComponentMap, ContentInput, FlatUiKeyNameNode, FlatUiNode, FlatUiPrimitiveNode, SynthesisViewEvent, SynthesizeViewFetcher, ViewInputs, } from '../synthesisView/types.js';
+export { bitBitBuiltins } from './primitives.js';
+export type BitBitViewRendererProps = Omit<SynthesisViewTreeProps, 'renderUnknown' | 'defaultComponents'> & {
+    /** Override how unregistered components render. Defaults to a labeled marker. */
+    renderUnknown?: RenderUnknown;
+};
+/** Web renderer for a pre-fetched `uiData` array. BB built-in primitives are
+ *  registered automatically; pass `components` to add or override entries by
+ *  name. Use `<BitBitView>` if you want it to fetch for you. */
+export declare function BitBitViewRenderer({ renderUnknown, ...rest }: BitBitViewRendererProps): import("react").FunctionComponentElement<SynthesisViewTreeProps>;
+export type BitBitViewProps = {
+    /** A BitBitPressClient (or anything with `user.synthesizeViewItem`). */
+    client: SynthesizeViewFetcher;
+    keyName: string;
+    contentInputs?: ContentInput[];
+    components?: ComponentMap;
+    onEvent?: (event: SynthesisViewEvent) => void;
+    renderUnknown?: RenderUnknown;
+    /** Force a dark/light mode. Defaults to the browser's
+     *  `prefers-color-scheme` (live-updates if the user toggles their OS
+     *  theme). */
+    darkMode?: boolean;
+};
+/**
+ * Web view: fetches a synthesis view by `keyName` and renders it in place.
+ * Renders nothing while loading. Multiple `<BitBitView>` mounts within a
+ * short window are coalesced into a single batched request.
+ */
+export declare function BitBitView({ client, keyName, contentInputs, components, onEvent, renderUnknown, darkMode, }: BitBitViewProps): import("react").DetailedReactHTMLElement<{
+    'data-bitbit-error': boolean;
+    style: {
+        color: "#b00020";
+        fontFamily: "monospace";
+        fontSize: number;
+    };
+}, HTMLElement> | import("react").FunctionComponentElement<BitBitViewRendererProps> | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/react/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,KAAK,aAAa,EAElB,KAAK,sBAAsB,EAC5B,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EACV,YAAY,EACZ,YAAY,EACZ,kBAAkB,EAClB,qBAAqB,EAEtB,MAAM,2BAA2B,CAAC;AAInC,OAAO,EAAE,KAAK,kBAAkB,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EACL,kBAAkB,EAClB,KAAK,WAAW,EAChB,KAAK,cAAc,GACpB,MAAM,wCAAwC,CAAC;AAChD,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,iBAAiB,EACjB,UAAU,EACV,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAsBjD,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,sBAAsB,EACtB,eAAe,GAAG,mBAAmB,CACtC,GAAG;IACF,iFAAiF;IACjF,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CAAC;AAYF;;gEAEgE;AAChE,wBAAgB,kBAAkB,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,EAAE,EAAE,uBAAuB,oEAMrF;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,wEAAwE;IACxE,MAAM,EAAE,qBAAqB,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,CAAC,EAAE,YAAY,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,YAAY,CAAC;IAC1B,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;kBAEc;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,OAAO,EACP,aAAa,EACb,UAAU,EACV,OAAO,EACP,aAAa,EACb,QAAQ,GACT,EAAE,eAAe;;;;;;;2FAwBjB"}

package/dist/react/index.js

@@ -0,0 +1,68 @@
+import { createElement, useEffect, useState } from 'react';
+import { SynthesisViewTree, } from '../synthesisView/engine.js';
+import { useSynthesisView } from '../synthesisView/useSynthesisView.js';
+import { bitBitBuiltins } from './primitives.js';
+export { BitBitProvider } from '../synthesisView/context.js';
+export { createComponentMap, } from '../synthesisView/createComponentMap.js';
+export { bitBitBuiltins } from './primitives.js';
+/** Track the browser's `prefers-color-scheme` and re-render on change. Returns
+ *  `null` during SSR or when the API isn't available — callers fall back to
+ *  the server's default. */
+function useSystemDarkMode() {
+    const [isDark, setIsDark] = useState(() => {
+        if (typeof window === 'undefined' || !window.matchMedia)
+            return null;
+        return window.matchMedia('(prefers-color-scheme: dark)').matches;
+    });
+    useEffect(() => {
+        if (typeof window === 'undefined' || !window.matchMedia)
+            return;
+        const mq = window.matchMedia('(prefers-color-scheme: dark)');
+        const onChange = (e) => setIsDark(e.matches);
+        mq.addEventListener('change', onChange);
+        return () => mq.removeEventListener('change', onChange);
+    }, []);
+    return isDark;
+}
+const defaultRenderUnknown = (name) => createElement('span', {
+    'data-bitbit-unknown': name,
+    style: { color: '#b00020', fontFamily: 'monospace', fontSize: 12 },
+}, `⚠ Unknown component: ${name}`);
+/** Web renderer for a pre-fetched `uiData` array. BB built-in primitives are
+ *  registered automatically; pass `components` to add or override entries by
+ *  name. Use `<BitBitView>` if you want it to fetch for you. */
+export function BitBitViewRenderer({ renderUnknown, ...rest }) {
+    return createElement(SynthesisViewTree, {
+        ...rest,
+        defaultComponents: bitBitBuiltins,
+        renderUnknown: renderUnknown ?? defaultRenderUnknown,
+    });
+}
+/**
+ * Web view: fetches a synthesis view by `keyName` and renders it in place.
+ * Renders nothing while loading. Multiple `<BitBitView>` mounts within a
+ * short window are coalesced into a single batched request.
+ */
+export function BitBitView({ client, keyName, contentInputs, components, onEvent, renderUnknown, darkMode, }) {
+    const systemDark = useSystemDarkMode();
+    const resolvedDark = darkMode ?? systemDark ?? undefined;
+    const viewInputs = resolvedDark !== undefined ? { darkMode: resolvedDark } : undefined;
+    const { uiData, loading, error } = useSynthesisView(client, keyName, contentInputs, viewInputs);
+    if (loading)
+        return null;
+    if (error) {
+        return createElement('div', {
+            'data-bitbit-error': true,
+            style: { color: '#b00020', fontFamily: 'monospace', fontSize: 12 },
+        }, error);
+    }
+    if (!uiData.length)
+        return null;
+    return createElement(BitBitViewRenderer, {
+        uiData,
+        components,
+        onEvent,
+        renderUnknown,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/react/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAC3D,OAAO,EAEL,iBAAiB,GAElB,MAAM,4BAA4B,CAAC;AAQpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD,OAAO,EAA2B,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACtF,OAAO,EACL,kBAAkB,GAGnB,MAAM,wCAAwC,CAAC;AAWhD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEjD;;4BAE4B;AAC5B,SAAS,iBAAiB;IACxB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAiB,GAAG,EAAE;QACxD,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO,IAAI,CAAC;QACrE,OAAO,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC,OAAO,CAAC;IACnE,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,CAAC,MAAM,CAAC,UAAU;YAAE,OAAO;QAChE,MAAM,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,8BAA8B,CAAC,CAAC;QAC7D,MAAM,QAAQ,GAAG,CAAC,CAAsB,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;QAClE,EAAE,CAAC,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;QACxC,OAAO,GAAG,EAAE,CAAC,EAAE,CAAC,mBAAmB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,OAAO,MAAM,CAAC;AAChB,CAAC;AAUD,MAAM,oBAAoB,GAAkB,CAAC,IAAI,EAAE,EAAE,CACnD,aAAa,CACX,MAAM,EACN;IACE,qBAAqB,EAAE,IAAI;IAC3B,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE;CACnE,EACD,wBAAwB,IAAI,EAAE,CAC/B,CAAC;AAEJ;;gEAEgE;AAChE,MAAM,UAAU,kBAAkB,CAAC,EAAE,aAAa,EAAE,GAAG,IAAI,EAA2B;IACpF,OAAO,aAAa,CAAC,iBAAiB,EAAE;QACtC,GAAG,IAAI;QACP,iBAAiB,EAAE,cAAc;QACjC,aAAa,EAAE,aAAa,IAAI,oBAAoB;KACrD,CAAC,CAAC;AACL,CAAC;AAgBD;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,EACzB,MAAM,EACN,OAAO,EACP,aAAa,EACb,UAAU,EACV,OAAO,EACP,aAAa,EACb,QAAQ,GACQ;IAChB,MAAM,UAAU,GAAG,iBAAiB,EAAE,CAAC;IACvC,MAAM,YAAY,GAAG,QAAQ,IAAI,UAAU,IAAI,SAAS,CAAC;IACzD,MAAM,UAAU,GACd,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,UAAU,CAAC,CAAC;IAChG,IAAI,OAAO;QAAE,OAAO,IAAI,CAAC;IACzB,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,aAAa,CAClB,KAAK,EACL;YACE,mBAAmB,EAAE,IAAI;YACzB,KAAK,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,EAAE,EAAE;SACnE,EACD,KAAK,CACN,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,aAAa,CAAC,kBAAkB,EAAE;QACvC,MAAM;QACN,UAAU;QACV,OAAO;QACP,aAAa;KACd,CAAC,CAAC;AACL,CAAC"}

package/dist/react/primitives.d.ts

@@ -0,0 +1,54 @@
+import { type CSSProperties } from 'react';
+import type { AudioProps, ButtonProps, CardProps, CheckboxProps, ChoicePickerProps, ColumnProps, DateTimeInputProps, DividerProps, GradientProps, HorizontalScrollProps, IconProps, ImageProps, ListProps, ModalProps, PressableProps, RowProps, SliderProps, TabsItemProps, TabsProps, TextFieldProps, TextProps, VerticalScrollProps, VideoProps } from '../synthesisView/primitives.js';
+import type { ComponentMap } from '../synthesisView/types.js';
+export declare function Text({ text, children, ...rest }: TextProps): import("react/jsx-runtime").JSX.Element;
+export declare function Image({ src, alt, ...rest }: ImageProps): import("react/jsx-runtime").JSX.Element;
+export declare function Button({ title, children, disabled, onPress, ...rest }: ButtonProps): import("react/jsx-runtime").JSX.Element;
+export declare function Pressable({ children, disabled, onPress, style, ...rest }: PressableProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Icon({ name, ...rest }: IconProps): import("react/jsx-runtime").JSX.Element;
+export declare function Video({ src, poster, ...rest }: VideoProps): import("react/jsx-runtime").JSX.Element;
+export declare function Audio({ src, ...rest }: AudioProps): import("react/jsx-runtime").JSX.Element;
+export declare function Column({ children, style, ...rest }: ColumnProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Row({ children, style, ...rest }: RowProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function List({ children, style, ...rest }: ListProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Card({ children, style, ...rest }: CardProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Divider({ style, ...rest }: DividerProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function VerticalScroll({ children, style, ...rest }: VerticalScrollProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function HorizontalScroll({ children, style, ...rest }: HorizontalScrollProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Gradient({ colors, start, end, locations, children, style, ...rest }: GradientProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function Tabs({ defaultValue, children, ...rest }: TabsProps): import("react/jsx-runtime").JSX.Element;
+export declare function TabsItem({ children }: TabsItemProps): import("react/jsx-runtime").JSX.Element;
+export declare function Modal({ open, children, onClose, style, ...rest }: ModalProps & {
+    style?: CSSProperties;
+}): import("react/jsx-runtime").JSX.Element | null;
+export declare function TextField({ defaultValue, placeholder, multiline, disabled, onChange, ...rest }: TextFieldProps): import("react/jsx-runtime").JSX.Element;
+export declare function Checkbox({ label, defaultChecked, disabled, onChange, ...rest }: CheckboxProps): import("react/jsx-runtime").JSX.Element;
+export declare function ChoicePicker({ defaultValue, options, disabled, onChange, ...rest }: ChoicePickerProps): import("react/jsx-runtime").JSX.Element;
+export declare function Slider({ defaultValue, min, max, step, disabled, onChange, ...rest }: SliderProps): import("react/jsx-runtime").JSX.Element;
+export declare function DateTimeInput({ defaultValue, mode, disabled, onChange, ...rest }: DateTimeInputProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Default component map: every primitive name → its web implementation. Used
+ * as the fallback registry by `<BitBitView>` so a customer renders a view
+ * with zero registration. Spread it into a custom map to add or override:
+ * `<BitBitProvider components={{ ...bitBitBuiltins, MyCard }}>`.
+ */
+export declare const bitBitBuiltins: ComponentMap;
+//# sourceMappingURL=primitives.d.ts.map

package/dist/react/primitives.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"primitives.d.ts","sourceRoot":"","sources":["../../src/react/primitives.tsx"],"names":[],"mappings":"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"}