@bitbitpress/client 1.0.4 → 1.1.0-alpha.1

package/README.md

@@ -1141,3 +1141,227 @@ type InteractionResponseResponse = {
   appUserResponse: Record<string, unknown>;
 }
 ```
+
+## Synthesis Views
+
+A **synthesis view** is a UI that BitBit Press generates on the server for a
+named placement in your app (a feed card, a detail panel, a settings
+screen, etc.). You set up the view once in the BitBit CMS — choose a key
+name, write a prompt, point it at a synthesis config. Then in your app you
+mount it like this:
+
+```tsx
+<BitBitView client={client} keyName="story-card" />
+```
+
+The SDK fetches the generated UI, renders it using a small library of
+built-in primitives (`Row`, `Column`, `Text`, `Image`, `Button`, etc.), and
+splices in any of your own React components you've registered. As the user
+interacts with the UI, the SDK either routes the event to you (so your app
+handles navigation, mutations, etc.) or sends it back to the server so the
+agent can generate the next UI.
+
+The same surface is exported from both `@bitbitpress/client/react` and
+`@bitbitpress/client/react-native-expo`. This section uses the web names;
+the Expo entry is identical.
+
+### Quick start
+
+```tsx
+import { BitBitView } from '@bitbitpress/client/react';
+import client from '@/lib/bitbit-client';
+import { MyCard } from '@/components/my-card';
+
+export function Feed({ keyName }: { keyName: string }) {
+  return (
+    <BitBitView
+      client={client}
+      keyName={keyName}
+      components={{ MyCard }}
+      onEvent={(event) => console.log('host event', event)}
+    />
+  );
+}
+```
+
+That's enough to render any view whose generated UI uses only the SDK's
+built-in primitives, plus your `MyCard`.
+
+### Registering your own components
+
+In the CMS you can register a component as **"provided by your app"** —
+the server then refers to it by a name like `MyCard` in the generated UI,
+and the SDK looks it up in your registry to render it. The mapping from
+name to React component is what you pass in `components`:
+
+```tsx
+<BitBitView
+  client={client}
+  keyName="story-card"
+  components={{ MyCard, MyButton, MyAvatar }}
+/>
+```
+
+If you'll use the same component map across many views, register them
+once at the top of your app with `BitBitProvider` instead. Per-view
+`components` overrides still apply:
+
+```tsx
+import { BitBitProvider } from '@bitbitpress/client/react';
+
+<BitBitProvider components={{ MyCard, MyButton, MyAvatar }}>
+  <App />
+</BitBitProvider>
+```
+
+Components receive their bound props from the CMS contract you set up,
+plus a `children` prop when the view nested other components inside
+them. See [Handling events](#handling-events) below for how to also
+accept event callbacks.
+
+### Rendering pre-fetched UI
+
+If you already have the generated UI as a `uiData` array (for example,
+you cached the most recent response, or you're rendering a gallery of
+tiles fetched in one shot), use `BitBitViewRenderer` to skip the fetch:
+
+```tsx
+import { BitBitViewRenderer, type FlatUiNode } from '@bitbitpress/client/react';
+
+export function StaticTile({ uiData }: { uiData: FlatUiNode[] }) {
+  return <BitBitViewRenderer uiData={uiData} components={{ MyCard }} />;
+}
+```
+
+### Handling events
+
+Each event the view emits has a `handleWith` setting (chosen in the CMS):
+
+- **`HOST`** — the SDK forwards the event to your `onEvent` callback and
+  does nothing else. Use this for navigation, mutations, anything where
+  your app owns the consequence.
+- **`AGENT`** — the SDK sends the event back to the synthesis endpoint
+  with the prior UI as context, the agent returns a new UI, and the SDK
+  re-renders with it. Your `onEvent` is **not** called for AGENT events
+  (the handling is internal); they show up in the dev log if you need to
+  observe them. Nodes whose ids appear in both the old and new tree
+  preserve their React state, so a well-behaved view feels like a
+  partial update rather than a full reload.
+
+```tsx
+<BitBitView
+  client={client}
+  keyName="story-card"
+  onEvent={(event) => {
+    if (event.name === 'open-detail') {
+      navigation.push('Detail', { id: event.payload.id });
+    }
+  }}
+/>
+```
+
+The event object you receive is:
+
+```ts
+{
+  name: string;          // identifier from the CMS event binding
+  componentName: string; // name of the component that fired
+  slot: string;          // which slot on the component (e.g. 'onClick')
+  payload: object;       // anything the binding declared + anything the host passed
+}
+```
+
+The runtime also includes a `nodeId` (the internal id of the rendered
+instance) and `handleWith` (always `'HOST'` by the time your callback
+runs). Both are present for debugging and rarely need to be consumed.
+
+#### Events on your components
+
+If you registered a component with events in its CMS contract (e.g. an
+`onClick` slot), the SDK passes a callback for that slot as a prop. Call
+it from inside your component to fire the event through the BB pipeline,
+exactly as if it had come from a built-in primitive:
+
+```tsx
+function MyCard({
+  title,
+  onClick,
+}: {
+  title: string;
+  onClick?: (payload?: unknown) => void;
+}) {
+  return <Pressable onPress={() => onClick?.()}>{title}</Pressable>;
+}
+```
+
+Anything you pass (a plain object) is merged with the payload the CMS
+binding declared before the event fires.
+
+### When a component name isn't registered
+
+If the generated UI references a component name you haven't registered,
+the SDK falls back to a placeholder. The default behavior depends on
+your environment:
+
+- **Development** (`process.env.NODE_ENV !== 'production'`) — renders a
+  labeled marker (`⚠ Unknown component: X`) so you can see what's
+  missing.
+- **Production** — renders nothing. Avoids visible debug artifacts in
+  real user UIs as you grow the registry over time.
+
+Override with `renderUnknown`, or set `dev` to force development behavior
+in environments where `NODE_ENV` doesn't reflect what you want (for
+example, a CMS preview tool that ships as a production build but should
+still surface missing components):
+
+```tsx
+<BitBitView client={client} keyName={keyName} dev /> // always show warnings
+<BitBitView
+  client={client}
+  keyName={keyName}
+  renderUnknown={(name) => <YourPlaceholder name={name} />}
+/>
+```
+
+### Performance: speculative preloading
+
+The SDK can prefetch the next UI for AGENT events whose payload it can
+predict ahead of time, so the user's click lands on a cached response
+with no server roundtrip. This is on by default. To disable:
+
+```tsx
+<BitBitView client={client} keyName={keyName} preloadNextUi={false} />
+```
+
+### Dev diagnostics
+
+In dev mode (or when you pass `dev={true}`), the SDK prints every event
+to the console, prefixed with `[BB]`:
+
+```
+[BB] event MyCard.onClick → AGENT { name: 'open-detail', payload: { id: '…' }, ... }
+```
+
+These logs are completely stripped in production builds — no SDK chatter
+in real user devices.
+
+### Custom rendering (advanced)
+
+If you want to render the UI tree yourself but still use the SDK's fetch +
+AGENT continuation + preload cache, use the hook directly:
+
+```tsx
+import { useEventDrivenView } from '@bitbitpress/client/react';
+
+const { uiData, loading, error, handleEvent } = useEventDrivenView(
+  client,
+  keyName,
+  onHostEvent,
+  contentInputs,
+  viewInputs,
+);
+```
+
+`uiData` is the same array `BitBitViewRenderer` consumes; wire
+`handleEvent` as your custom renderer's event callback to keep AGENT
+events flowing through the SDK.

package/dist/react/index.d.ts

@@ -0,0 +1,60 @@
+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, SynthesisViewEventInput, SynthesizeViewFetcher, ViewEventHandleWith, ViewInputs, } from '../synthesisView/types.js';
+export { type UseEventDrivenViewOptions, type UseEventDrivenViewResult, useEventDrivenView, } from '../synthesisView/useEventDrivenView.js';
+export { bitBitBuiltins } from './primitives.js';
+export type BitBitViewRendererProps = Omit<SynthesisViewTreeProps, 'renderUnknown' | 'defaultComponents'> & {
+    /** Override how unregistered components render. Defaults to a dev-only
+     *  marker (see {@link isDevEnvironment}). */
+    renderUnknown?: RenderUnknown;
+    /** Force the in-dev warning behavior regardless of `process.env.NODE_ENV`.
+     *  Set true in CMS / preview hosts (e.g. BitBitPress's own admin UI) so
+     *  unknown components stay visible even when those hosts are built in
+     *  production mode. Defaults to env-derived. */
+    dev?: boolean;
+};
+/** 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, dev, onEvent, ...rest }: BitBitViewRendererProps): import("react").FunctionComponentElement<SynthesisViewTreeProps>;
+export type BitBitViewProps = {
+    /** A BitBitPressClient (or anything with `user.synthesizeViewItem`). */
+    client: SynthesizeViewFetcher;
+    keyName: string;
+    contentInputs?: ContentInput[];
+    components?: ComponentMap;
+    /** Fires for `HOST` events the component contract declared. `AGENT`
+     *  events are handled internally — the SDK rounds-trips to the synthesis
+     *  endpoint and swaps the UI in place; customers don't see them unless
+     *  they explicitly opt in via the contract. */
+    onEvent?: (event: SynthesisViewEvent) => void;
+    renderUnknown?: RenderUnknown;
+    /** Force the in-dev warning behavior regardless of `process.env.NODE_ENV`.
+     *  See {@link BitBitViewRendererProps.dev}. */
+    dev?: boolean;
+    /** Force a dark/light mode. Defaults to the browser's
+     *  `prefers-color-scheme` (live-updates if the user toggles their OS
+     *  theme). */
+    darkMode?: boolean;
+    /** When true (default), speculatively prefetches the agent's next-UI for
+     *  AGENT events whose payloads don't need runtime input. Real clicks land
+     *  on the cached response with zero server roundtrip. Set false to
+     *  disable. */
+    preloadNextUi?: boolean;
+};
+/**
+ * Web view: fetches a synthesis view by `keyName` and renders it in place.
+ * AGENT-handled events drive the next UI back through the agent
+ * (preloaded when possible). HOST events fire to `onEvent`.
+ */
+export declare function BitBitView({ client, keyName, contentInputs, components, onEvent, renderUnknown, dev, darkMode, preloadNextUi, }: 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":"AAEA,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,uBAAuB,EACvB,qBAAqB,EACrB,mBAAmB,EACnB,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,yBAAyB,EAC9B,KAAK,wBAAwB,EAC7B,kBAAkB,GACnB,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAsBjD,MAAM,MAAM,uBAAuB,GAAG,IAAI,CACxC,sBAAsB,EACtB,eAAe,GAAG,mBAAmB,CACtC,GAAG;IACF;iDAC6C;IAC7C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;;;oDAGgD;IAChD,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,CAAC;AA6BF;;gEAEgE;AAChE,wBAAgB,kBAAkB,CAAC,EACjC,aAAa,EACb,GAAG,EACH,OAAO,EACP,GAAG,IAAI,EACR,EAAE,uBAAuB,oEAQzB;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;;;mDAG+C;IAC/C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;IAC9C,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B;mDAC+C;IAC/C,GAAG,CAAC,EAAE,OAAO,CAAC;IACd;;kBAEc;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;mBAGe;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,EACzB,MAAM,EACN,OAAO,EACP,aAAa,EACb,UAAU,EACV,OAAO,EACP,aAAa,EACb,GAAG,EACH,QAAQ,EACR,aAAa,GACd,EAAE,eAAe;;;;;;;2FAgCjB"}

package/dist/react/index.js

@@ -0,0 +1,85 @@
+import { createElement, useEffect, useState } from 'react';
+import { devLog, isDevEnvironment } from '../synthesisView/devLog.js';
+import { SynthesisViewTree, } from '../synthesisView/engine.js';
+import { useEventDrivenView } from '../synthesisView/useEventDrivenView.js';
+import { bitBitBuiltins } from './primitives.js';
+export { BitBitProvider } from '../synthesisView/context.js';
+export { createComponentMap, } from '../synthesisView/createComponentMap.js';
+export { useEventDrivenView, } from '../synthesisView/useEventDrivenView.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 renderUnknownWarning = (name) => createElement('span', {
+    'data-bitbit-unknown': name,
+    style: { color: '#b00020', fontFamily: 'monospace', fontSize: 12 },
+}, `⚠ Unknown component: ${name}`);
+/** Silent in production: an unknown name renders nothing rather than splashing
+ *  a debug marker in the customer's real app. */
+const renderUnknownSilent = () => null;
+/** Wrap `onEvent` so each emission prints to the console with the dispatch
+ *  routing inline. Routed through {@link devLog} so the message is auto-
+ *  prefixed with `[BB]` and stripped to a no-op outside dev. */
+function withDevEventLog(dev, onEvent) {
+    return (event) => {
+        devLog(dev, `event ${event.componentName}.${event.slot} → ${event.handleWith}`, event);
+        onEvent?.(event);
+    };
+}
+/** 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, dev, onEvent, ...rest }) {
+    const isDev = dev ?? isDevEnvironment();
+    return createElement(SynthesisViewTree, {
+        ...rest,
+        defaultComponents: bitBitBuiltins,
+        renderUnknown: renderUnknown ?? (isDev ? renderUnknownWarning : renderUnknownSilent),
+        onEvent: isDev ? withDevEventLog(dev, onEvent) : onEvent,
+    });
+}
+/**
+ * Web view: fetches a synthesis view by `keyName` and renders it in place.
+ * AGENT-handled events drive the next UI back through the agent
+ * (preloaded when possible). HOST events fire to `onEvent`.
+ */
+export function BitBitView({ client, keyName, contentInputs, components, onEvent, renderUnknown, dev, darkMode, preloadNextUi, }) {
+    const systemDark = useSystemDarkMode();
+    const resolvedDark = darkMode ?? systemDark ?? undefined;
+    const viewInputs = resolvedDark !== undefined ? { darkMode: resolvedDark } : undefined;
+    const { uiData, loading, error, handleEvent } = useEventDrivenView(client, keyName, onEvent, contentInputs, viewInputs, { preloadNextUi });
+    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: handleEvent,
+        renderUnknown,
+        dev,
+    });
+}
+//# 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":"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"}

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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"}