@adonis-agora/agent 0.61.0 → 0.62.0

package/dist/src/react/core/genui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/genui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,iBAAiB,EACjB,KAAK,sBAAsB,EAC3B,aAAa,EACb,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,SAAS,EACT,eAAe,EACf,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,gBAAgB,GACtB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/react/core/genui/index.js

@@ -0,0 +1,5 @@
+export { GenerativeUI, GenerativeUIScope, GenuiProvider, GenuiTree, useGenerativeUI, useGenuiProvider, } from './generative-ui.js';
+export { createReactComponentRegistry, } from './react-registry.js';
+export { GENUI_TREE_COMPONENT, } from './types.js';
+export { toGenerativeUIItem } from './use-generative-ui.js';
+//# sourceMappingURL=index.js.map

package/dist/src/react/core/genui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/react/core/genui/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EAGZ,iBAAiB,EAEjB,aAAa,EAGb,SAAS,EACT,eAAe,EACf,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACL,4BAA4B,GAG7B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,GAWrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/src/react/core/genui/json-render.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Optional json-render adapter for tree frames (`@adonis-agora/agent/react/genui/json-render`).
+ * Needs the optional peer `@json-render/react` (>= 0.21). Use it when your app already renders
+ * json-render specs and wants tree frames to go through the same `Renderer` (its state, actions and
+ * visibility machinery); otherwise `<GenerativeUI>` renders trees natively.
+ *
+ * ```tsx
+ * import { GenuiProvider } from '@adonis-agora/agent/react/genui/json-render';
+ *
+ * <GenuiProvider registry={registry} catalog={catalog} jsonRender>…</GenuiProvider>
+ * ```
+ */
+import { type ComponentRegistry } from '@json-render/react';
+import { type GenuiProviderProps as BaseGenuiProviderProps } from './generative-ui.js';
+import type { GenerativeUIElement, GenuiRegistry, GenuiRenderer } from './types.js';
+/** A json-render flat spec: `{ root, elements: { [id]: { type, props, children } } }`. */
+export interface JsonRenderFlatSpec {
+    root: string;
+    elements: Record<string, {
+        type: string;
+        props: Record<string, unknown>;
+        children: string[];
+    }>;
+}
+/** A tree frame's `root` as a json-render flat spec (ids `el-0`, `el-1`, … depth first). */
+export declare function treeToJsonRenderSpec(root: GenerativeUIElement): JsonRenderFlatSpec;
+/**
+ * Adapt a genui registry (renderers taking props + `children`) to a json-render registry (renderers
+ * taking `{ element, children }`), so one set of components serves both.
+ */
+export declare function toJsonRenderRegistry(registry: GenuiRegistry): ComponentRegistry;
+export interface JsonRenderTreeProps {
+    root?: GenerativeUIElement;
+    registry: ComponentRegistry;
+    /** json-render state the spec's `$state` expressions read. */
+    initialState?: Record<string, unknown>;
+}
+/** Render a tree frame's `root` with json-render. */
+export declare function JsonRenderTree({ root, registry, initialState }: JsonRenderTreeProps): import("react").JSX.Element | null;
+/** A registry entry for `genui:tree` that renders through json-render with `registry`. */
+export declare function jsonRenderTree(registry: ComponentRegistry): GenuiRenderer<{
+    root?: GenerativeUIElement;
+}>;
+export interface GenuiProviderProps extends BaseGenuiProviderProps {
+    /**
+     * Draw composed tree frames through json-render: pass your json-render registry, or `true` to
+     * derive one from `registry` ({@link toJsonRenderRegistry}). Omitted → trees render natively.
+     * An explicit `treeRenderer` wins over it.
+     */
+    jsonRender?: ComponentRegistry | true;
+}
+/** `GenuiProvider` from `/genui`, plus the {@link GenuiProviderProps.jsonRender} option. */
+export declare function GenuiProvider({ jsonRender, treeRenderer, registry, ...rest }: GenuiProviderProps): import("react").JSX.Element;
+//# sourceMappingURL=json-render.d.ts.map

package/dist/src/react/core/genui/json-render.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-render.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/genui/json-render.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,EAAE,KAAK,iBAAiB,EAA4B,MAAM,oBAAoB,CAAC;AAEtF,OAAO,EAEL,KAAK,kBAAkB,IAAI,sBAAsB,EAClD,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,mBAAmB,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEpF,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CAChG;AAED,4FAA4F;AAC5F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,mBAAmB,GAAG,kBAAkB,CAWlF;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,aAAa,GAAG,iBAAiB,CAS/E;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACxC;AAED,qDAAqD;AACrD,wBAAgB,cAAc,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,YAAY,EAAE,EAAE,mBAAmB,sCAQnF;AAED,0FAA0F;AAC1F,wBAAgB,cAAc,CAAC,QAAQ,EAAE,iBAAiB,GAAG,aAAa,CAAC;IACzE,IAAI,CAAC,EAAE,mBAAmB,CAAC;CAC5B,CAAC,CAID;AAED,MAAM,WAAW,kBAAmB,SAAQ,sBAAsB;IAChE;;;;OAIG;IACH,UAAU,CAAC,EAAE,iBAAiB,GAAG,IAAI,CAAC;CACvC;AAED,4FAA4F;AAC5F,wBAAgB,aAAa,CAAC,EAAE,UAAU,EAAE,YAAY,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,EAAE,kBAAkB,+BAahG"}

package/dist/src/react/core/genui/json-render.js

@@ -0,0 +1,64 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * Optional json-render adapter for tree frames (`@adonis-agora/agent/react/genui/json-render`).
+ * Needs the optional peer `@json-render/react` (>= 0.21). Use it when your app already renders
+ * json-render specs and wants tree frames to go through the same `Renderer` (its state, actions and
+ * visibility machinery); otherwise `<GenerativeUI>` renders trees natively.
+ *
+ * ```tsx
+ * import { GenuiProvider } from '@adonis-agora/agent/react/genui/json-render';
+ *
+ * <GenuiProvider registry={registry} catalog={catalog} jsonRender>…</GenuiProvider>
+ * ```
+ */
+import { JSONUIProvider, Renderer } from '@json-render/react';
+import { useMemo } from 'react';
+import { GenuiProvider as BaseGenuiProvider, } from './generative-ui.js';
+/** A tree frame's `root` as a json-render flat spec (ids `el-0`, `el-1`, … depth first). */
+export function treeToJsonRenderSpec(root) {
+    const elements = {};
+    let next = 0;
+    const visit = (node) => {
+        const id = `el-${next++}`;
+        const entry = { type: node.type, props: node.props ?? {}, children: [] };
+        elements[id] = entry;
+        for (const child of node.children ?? [])
+            entry.children.push(visit(child));
+        return id;
+    };
+    return { root: visit(root), elements };
+}
+/**
+ * Adapt a genui registry (renderers taking props + `children`) to a json-render registry (renderers
+ * taking `{ element, children }`), so one set of components serves both.
+ */
+export function toJsonRenderRegistry(registry) {
+    return Object.fromEntries(Object.entries(registry).map(([name, Renderer]) => [
+        name,
+        ({ element, children }) => (_jsx(Renderer, { ...(element.props ?? {}), children: children })),
+    ]));
+}
+/** Render a tree frame's `root` with json-render. */
+export function JsonRenderTree({ root, registry, initialState }) {
+    const spec = useMemo(() => (root === undefined ? null : treeToJsonRenderSpec(root)), [root]);
+    if (spec === null)
+        return null;
+    return (_jsx(JSONUIProvider, { registry: registry, ...(initialState !== undefined ? { initialState } : {}), children: _jsx(Renderer, { spec: spec, registry: registry }) }));
+}
+/** A registry entry for `genui:tree` that renders through json-render with `registry`. */
+export function jsonRenderTree(registry) {
+    return function JsonRenderTreeFrame({ root }) {
+        return _jsx(JsonRenderTree, { registry: registry, ...(root !== undefined ? { root } : {}) });
+    };
+}
+/** `GenuiProvider` from `/genui`, plus the {@link GenuiProviderProps.jsonRender} option. */
+export function GenuiProvider({ jsonRender, treeRenderer, registry, ...rest }) {
+    const derived = useMemo(() => {
+        if (jsonRender === undefined)
+            return undefined;
+        return jsonRenderTree(jsonRender === true ? toJsonRenderRegistry(registry ?? {}) : jsonRender);
+    }, [jsonRender, registry]);
+    const tree = treeRenderer ?? derived;
+    return (_jsx(BaseGenuiProvider, { ...rest, ...(registry !== undefined ? { registry } : {}), ...(tree !== undefined ? { treeRenderer: tree } : {}) }));
+}
+//# sourceMappingURL=json-render.js.map

package/dist/src/react/core/genui/json-render.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-render.js","sourceRoot":"","sources":["../../../../../src/react/core/genui/json-render.tsx"],"names":[],"mappings":"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"}

package/dist/src/react/core/genui/playwright.d.ts

@@ -0,0 +1,12 @@
+import type { Browser, LaunchOptions } from 'playwright-core';
+import { type CaptureAdapter } from './server.js';
+export interface PlaywrightCaptureOptions {
+    /** Caller-owned browser; the adapter closes only its own contexts and pages. */
+    browser?: Browser;
+    /** Used only without a supplied browser. Install playwright-core and supply executablePath. */
+    launchOptions?: LaunchOptions;
+    /** Explicit allowlist for trusted app images/fonts/styles. Redirects and other requests abort. */
+    allowAsset?: (url: string) => boolean;
+}
+export declare function createPlaywrightCaptureAdapter(options?: PlaywrightCaptureOptions): CaptureAdapter;
+//# sourceMappingURL=playwright.d.ts.map

package/dist/src/react/core/genui/playwright.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"playwright.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/genui/playwright.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,aAAa,EAAQ,MAAM,iBAAiB,CAAC;AACpE,OAAO,EAAyB,KAAK,cAAc,EAAuB,MAAM,aAAa,CAAC;AAE9F,MAAM,WAAW,wBAAwB;IACvC,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,+FAA+F;IAC/F,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kGAAkG;IAClG,UAAU,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;CACvC;AACD,wBAAgB,8BAA8B,CAC5C,OAAO,GAAE,wBAA6B,GACrC,cAAc,CAmJhB"}

package/dist/src/react/core/genui/playwright.js

@@ -0,0 +1,141 @@
+import { boundedCaptureOptions } from './server.js';
+export function createPlaywrightCaptureAdapter(options = {}) {
+    async function withPage(settings, operation) {
+        const limits = boundedCaptureOptions(settings);
+        const browser = options.browser ??
+            (await (await import('playwright-core')).chromium.launch(options.launchOptions));
+        try {
+            const context = await browser.newContext({
+                javaScriptEnabled: false,
+                serviceWorkers: 'block',
+                viewport: { width: limits.width, height: limits.height },
+            });
+            try {
+                const page = await context.newPage();
+                try {
+                    page.setDefaultTimeout(limits.timeoutMs);
+                    await context.route('**/*', async (route) => {
+                        try {
+                            if (!options.allowAsset?.(route.request().url())) {
+                                await route.abort();
+                                return;
+                            }
+                            // Browser redirects bypass route handlers. Fetch one approved URL only,
+                            // then fulfill its response; never let an asset redirect escape the allowlist.
+                            const response = await route.fetch({ maxRedirects: 0, timeout: limits.timeoutMs });
+                            try {
+                                if (response.status() >= 300 && response.status() < 400) {
+                                    await route.abort();
+                                }
+                                else {
+                                    await route.fulfill({ response });
+                                }
+                            }
+                            finally {
+                                await response.dispose();
+                            }
+                        }
+                        catch {
+                            await route.abort();
+                        }
+                    });
+                    let timer;
+                    try {
+                        return await Promise.race([
+                            operation(page, limits),
+                            new Promise((_, reject) => {
+                                timer = setTimeout(() => reject(new Error('genui: capture timed out')), limits.timeoutMs);
+                            }),
+                        ]);
+                    }
+                    finally {
+                        clearTimeout(timer);
+                    }
+                }
+                finally {
+                    await page.close();
+                }
+            }
+            finally {
+                await context.close();
+            }
+        }
+        finally {
+            if (!options.browser)
+                await browser.close();
+        }
+    }
+    function checkPages(html) {
+        if (!html.length || html.length > 100)
+            throw new RangeError('genui: capture requires 1–100 pages');
+    }
+    async function ready(page, html, limits) {
+        await page.setContent(html, { waitUntil: 'load', timeout: limits.timeoutMs });
+        // Host evaluation is available while page-origin JavaScript stays disabled.
+        await page.evaluate(async (timeoutMs) => {
+            let timer;
+            try {
+                await Promise.race([
+                    Promise.all([
+                        document.fonts.ready,
+                        ...Array.from(document.images, (image) => image.complete
+                            ? Promise.resolve()
+                            : new Promise((resolve) => {
+                                image.addEventListener('load', () => resolve(), { once: true });
+                                image.addEventListener('error', () => resolve(), { once: true });
+                            })),
+                    ]),
+                    new Promise((_, reject) => {
+                        timer = setTimeout(() => reject(new Error('genui: assets timed out')), timeoutMs);
+                    }),
+                ]);
+            }
+            finally {
+                clearTimeout(timer);
+            }
+        }, limits.timeoutMs);
+        const height = await page.evaluate(() => Math.max(document.body.scrollHeight, document.documentElement.scrollHeight));
+        if (height > limits.height)
+            throw new RangeError('genui: content exceeds capture height; reduce rowsPerPage or paginate the component');
+    }
+    return {
+        async images(html, settings) {
+            checkPages(html);
+            return withPage(settings, async (page, limits) => {
+                const images = [];
+                for (const content of html) {
+                    await ready(page, content, limits);
+                    images.push(await page.screenshot({ type: 'png', fullPage: true, timeout: limits.timeoutMs }));
+                }
+                return images;
+            });
+        },
+        async pdf(html, settings) {
+            checkPages(html);
+            return withPage(settings, async (page, limits) => {
+                // Separate full HTML pages via srcdoc to preserve per-page CSS and theme.
+                // Keep frames in the intercepted origin; opaque sandbox frames can bypass Chromium
+                // request routing. Scripts remain disabled by both the context and the sandbox.
+                const escapeAttribute = (value) => value.replace(/&/g, '&amp;').replace(/"/g, '&quot;').replace(/</g, '&lt;');
+                const pdfDocument = `<!doctype html><html><head><style>@page { size: ${limits.width}px ${limits.height}px; margin: 0 } body { margin: 0 } iframe { display:block; border:0; width:${limits.width}px; height:${limits.height}px; break-after:page } iframe:last-child { break-after:auto }</style></head><body>${html.map((content) => `<iframe sandbox="allow-same-origin" srcdoc="${escapeAttribute(content)}"></iframe>`).join('')}</body></html>`;
+                await page.setContent(pdfDocument, { waitUntil: 'load', timeout: limits.timeoutMs });
+                for (const frame of page.frames().slice(1)) {
+                    await frame.evaluate(async () => {
+                        await document.fonts.ready;
+                        await Promise.all(Array.from(document.images, (image) => image.decode().catch(() => { })));
+                    });
+                    const height = await frame.evaluate(() => document.documentElement.scrollHeight);
+                    if (height > limits.height)
+                        throw new RangeError('genui: content exceeds PDF page height; reduce rowsPerPage');
+                }
+                return page.pdf({
+                    width: `${limits.width}px`,
+                    height: `${limits.height}px`,
+                    printBackground: true,
+                    preferCSSPageSize: true,
+                });
+            });
+        },
+    };
+}
+//# sourceMappingURL=playwright.js.map

package/dist/src/react/core/genui/playwright.js.map

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

package/dist/src/react/core/genui/react-registry.d.ts

@@ -0,0 +1,22 @@
+import { type ComponentType, type ReactNode } from 'react';
+import { type CatalogOptions, type ComponentDefinition, type ComponentPresentation } from '../../../genui/index.js';
+import type { GenuiRegistry } from './types.js';
+export interface ReactComponentRenderers<P extends object> {
+    react?: ComponentType<P>;
+    text?: (props: P) => string | Promise<string>;
+    /** Return each page's complete props. Each page is validated again before SSR. */
+    paginate?: (props: P, rowsPerPage: number) => readonly P[] | Promise<readonly P[]>;
+}
+/** App-scoped registry shared by GenuiProvider and static server rendering. */
+export declare function createReactComponentRegistry(options?: CatalogOptions): {
+    readonly catalog: import("../../../genui/catalog.js").Catalog;
+    readonly manifest: readonly import("../../../genui/registry.js").ComponentManifest[];
+    readonly components: GenuiRegistry;
+    prepare: (presentation: ComponentPresentation<object>) => Promise<ComponentPresentation<Record<string, unknown>>>;
+    render: (presentation: ComponentPresentation<object>, channel: string) => Promise<unknown>;
+    register<P extends object>(definition: ComponentDefinition<P>, renderers: ReactComponentRenderers<P>): /*elided*/ any;
+    renderPages(presentation: ComponentPresentation<object>, size: number): Promise<ReactNode[]>;
+    paginate(presentation: ComponentPresentation<object>, size: number): Promise<ComponentPresentation[]>;
+};
+export type ReactComponentRegistry = ReturnType<typeof createReactComponentRegistry>;
+//# sourceMappingURL=react-registry.d.ts.map

package/dist/src/react/core/genui/react-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-registry.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/genui/react-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,aAAa,EAAiB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC1E,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAE3B,MAAM,yBAAyB,CAAC;AACjC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD,MAAM,WAAW,uBAAuB,CAAC,CAAC,SAAS,MAAM;IACvD,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC,CAAC,CAAC;IACzB,IAAI,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC9C,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,WAAW,EAAE,MAAM,KAAK,SAAS,CAAC,EAAE,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;CACpF;AAED,+EAA+E;AAC/E,wBAAgB,4BAA4B,CAAC,OAAO,CAAC,EAAE,cAAc;;;yBAe/C,aAAa;4BAGP,qBAAqB,CAAC,MAAM,CAAC;2BAE9B,qBAAqB,CAAC,MAAM,CAAC,WAAW,MAAM;aAK5D,CAAC,SAAS,MAAM,cACX,mBAAmB,CAAC,CAAC,CAAC,aACvB,uBAAuB,CAAC,CAAC,CAAC;8BAuBvB,qBAAqB,CAAC,MAAM,CAAC,QACrC,MAAM,GACX,OAAO,CAAC,SAAS,EAAE,CAAC;2BAWP,qBAAqB,CAAC,MAAM,CAAC,QACrC,MAAM,GACX,OAAO,CAAC,qBAAqB,EAAE,CAAC;EAuBtC;AACD,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC,OAAO,4BAA4B,CAAC,CAAC"}

package/dist/src/react/core/genui/react-registry.js

@@ -0,0 +1,72 @@
+import { createElement } from 'react';
+import { createComponentRegistry, } from '../../../genui/index.js';
+/** App-scoped registry shared by GenuiProvider and static server rendering. */
+export function createReactComponentRegistry(options) {
+    const registry = createComponentRegistry(options);
+    const components = Object.create(null);
+    const texts = new Map();
+    const paginators = new Map();
+    const adapter = {
+        get catalog() {
+            return registry.catalog;
+        },
+        get manifest() {
+            return registry.manifest;
+        },
+        get components() {
+            return { ...components };
+        },
+        prepare: (presentation) => registry.prepare({ ...presentation, props: presentation.props }),
+        render: (presentation, channel) => registry.render({ ...presentation, props: presentation.props }, channel),
+        register(definition, renderers) {
+            const ReactComponent = renderers.react;
+            registry.register(definition, {
+                ...(ReactComponent ? { react: (props) => createElement(ReactComponent, props) } : {}),
+                ...(renderers.text ? { text: renderers.text } : {}),
+            });
+            if (renderers.react)
+                components[definition.name] = renderers.react;
+            if (renderers.text) {
+                const text = renderers.text;
+                texts.set(definition.name, (props) => text(props));
+            }
+            if (renderers.paginate) {
+                const paginate = renderers.paginate;
+                paginators.set(definition.name, async (props, size) => (await paginate(props, size)));
+            }
+            return adapter;
+        },
+        async renderPages(presentation, size) {
+            const pages = await adapter.paginate(presentation, size);
+            return Promise.all(pages.map(async (page) => {
+                const ReactComponent = components[page.component];
+                if (ReactComponent)
+                    return createElement(ReactComponent, page.props);
+                return texts.get(page.component)?.(page.props) ?? page.fallbackText;
+            }));
+        },
+        async paginate(presentation, size) {
+            if (!Number.isInteger(size) || size < 1 || size > 500)
+                throw new RangeError('genui: rowsPerPage must be 1–500');
+            const prepared = await registry.prepare({
+                ...presentation,
+                props: presentation.props,
+            });
+            const custom = paginators.get(prepared.component);
+            const rows = prepared.props.rows;
+            const pages = custom
+                ? await custom(prepared.props, size)
+                : prepared.component === 'DataTable' && Array.isArray(rows) && rows.length > size
+                    ? Array.from({ length: Math.ceil(rows.length / size) }, (_, index) => ({
+                        ...prepared.props,
+                        rows: rows.slice(index * size, (index + 1) * size),
+                    }))
+                    : [prepared.props];
+            if (!pages.length || pages.length > 100)
+                throw new RangeError('genui: capture requires 1–100 pages');
+            return Promise.all(pages.map((props) => registry.prepare({ ...prepared, props })));
+        },
+    };
+    return adapter;
+}
+//# sourceMappingURL=react-registry.js.map

package/dist/src/react/core/genui/react-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-registry.js","sourceRoot":"","sources":["../../../../../src/react/core/genui/react-registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAsB,aAAa,EAAkB,MAAM,OAAO,CAAC;AAC1E,OAAO,EAIL,uBAAuB,GACxB,MAAM,yBAAyB,CAAC;AAUjC,+EAA+E;AAC/E,MAAM,UAAU,4BAA4B,CAAC,OAAwB;IACnE,MAAM,QAAQ,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,UAAU,GAAkB,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACtD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAwE,CAAC;IAC9F,MAAM,UAAU,GAAG,IAAI,GAAG,EAGvB,CAAC;IACJ,MAAM,OAAO,GAAG;QACd,IAAI,OAAO;YACT,OAAO,QAAQ,CAAC,OAAO,CAAC;QAC1B,CAAC;QACD,IAAI,QAAQ;YACV,OAAO,QAAQ,CAAC,QAAQ,CAAC;QAC3B,CAAC;QACD,IAAI,UAAU;YACZ,OAAO,EAAE,GAAG,UAAU,EAAE,CAAC;QAC3B,CAAC;QACD,OAAO,EAAE,CAAC,YAA2C,EAAE,EAAE,CACvD,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,YAAY,EAAE,KAAK,EAAE,YAAY,CAAC,KAAgC,EAAE,CAAC;QAC7F,MAAM,EAAE,CAAC,YAA2C,EAAE,OAAe,EAAE,EAAE,CACvE,QAAQ,CAAC,MAAM,CACb,EAAE,GAAG,YAAY,EAAE,KAAK,EAAE,YAAY,CAAC,KAAgC,EAAE,EACzE,OAAO,CACR;QACH,QAAQ,CACN,UAAkC,EAClC,SAAqC;YAErC,MAAM,cAAc,GAAG,SAAS,CAAC,KAAK,CAAC;YACvC,QAAQ,CAAC,QAAQ,CAAC,UAAU,EAAE;gBAC5B,GAAG,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,KAAQ,EAAE,EAAE,CAAC,aAAa,CAAC,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACxF,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpD,CAAC,CAAC;YACH,IAAI,SAAS,CAAC,KAAK;gBAAE,UAAU,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,KAAK,CAAC;YACnE,IAAI,SAAS,CAAC,IAAI,EAAE,CAAC;gBACnB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC;gBAC5B,KAAK,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAU,CAAC,CAAC,CAAC;YAC1D,CAAC;YACD,IAAI,SAAS,CAAC,QAAQ,EAAE,CAAC;gBACvB,MAAM,QAAQ,GAAG,SAAS,CAAC,QAAQ,CAAC;gBACpC,UAAU,CAAC,GAAG,CACZ,UAAU,CAAC,IAAI,EACf,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CACpB,CAAC,MAAM,QAAQ,CAAC,KAAU,EAAE,IAAI,CAAC,CAAuC,CAC3E,CAAC;YACJ,CAAC;YACD,OAAO,OAAO,CAAC;QACjB,CAAC;QACD,KAAK,CAAC,WAAW,CACf,YAA2C,EAC3C,IAAY;YAEZ,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;YACzD,OAAO,OAAO,CAAC,GAAG,CAChB,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;gBACvB,MAAM,cAAc,GAAG,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;gBAClD,IAAI,cAAc;oBAAE,OAAO,aAAa,CAAC,cAAc,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;gBACrE,OAAO,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,YAAY,CAAC;YACtE,CAAC,CAAC,CACH,CAAC;QACJ,CAAC;QACD,KAAK,CAAC,QAAQ,CACZ,YAA2C,EAC3C,IAAY;YAEZ,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG;gBACnD,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC;YAC3D,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,OAAO,CAAC;gBACtC,GAAG,YAAY;gBACf,KAAK,EAAE,YAAY,CAAC,KAAgC;aACrD,CAAC,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC;YACjC,MAAM,KAAK,GAAG,MAAM;gBAClB,CAAC,CAAC,MAAM,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;gBACpC,CAAC,CAAC,QAAQ,CAAC,SAAS,KAAK,WAAW,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,IAAI;oBAC/E,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;wBACnE,GAAG,QAAQ,CAAC,KAAK;wBACjB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;qBACnD,CAAC,CAAC;oBACL,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG;gBACrC,MAAM,IAAI,UAAU,CAAC,qCAAqC,CAAC,CAAC;YAC9D,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QACrF,CAAC;KACF,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/react/core/genui/server.d.ts

@@ -0,0 +1,32 @@
+import type { ComponentPresentation } from '../../../genui/index.js';
+import type { ReactComponentRegistry } from './react-registry.js';
+export { createReactComponentRegistry, type ReactComponentRegistry } from './react-registry.js';
+export interface CaptureOptions {
+    width?: number;
+    height?: number;
+    timeoutMs?: number;
+}
+export interface CaptureAdapter {
+    images(html: readonly string[], options: CaptureOptions): Promise<Uint8Array[]>;
+    pdf(html: readonly string[], options: CaptureOptions): Promise<Uint8Array>;
+}
+export interface ServerRenderOptions extends CaptureOptions {
+    rowsPerPage?: number;
+    capture?: CaptureAdapter;
+}
+export interface ReactServerRendererOptions {
+    registry: ReactComponentRegistry;
+    /** Trusted app CSS, or a trusted filesystem path; never supply user CSS. */
+    stylesheet?: string | {
+        path: string;
+    };
+    theme?: string;
+    capture?: CaptureAdapter;
+}
+export declare function boundedCaptureOptions(options: CaptureOptions): Required<CaptureOptions>;
+export declare function createReactServerRenderer(options: ReactServerRendererOptions): {
+    html: (presentation: ComponentPresentation<object>) => Promise<string>;
+    images(presentation: ComponentPresentation<object>, settings?: ServerRenderOptions): Promise<Uint8Array<ArrayBufferLike>[]>;
+    pdf(presentation: ComponentPresentation<object>, settings?: ServerRenderOptions): Promise<Uint8Array<ArrayBufferLike>>;
+};
+//# sourceMappingURL=server.d.ts.map

package/dist/src/react/core/genui/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../../../src/react/core/genui/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AACrE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAElE,OAAO,EAAE,4BAA4B,EAAE,KAAK,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAEhG,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AACD,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC;IAChF,GAAG,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC5E;AACD,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AACD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,EAAE,sBAAsB,CAAC;IACjC,4EAA4E;IAC5E,UAAU,CAAC,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,cAAc,CAAC;CAC1B;AACD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,cAAc,GAAG,QAAQ,CAAC,cAAc,CAAC,CAevF;AACD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B;yBAgBzC,qBAAqB,CAAC,MAAM,CAAC,KAAG,OAAO,CAAC,MAAM,CAAC;yBAoCpD,qBAAqB,CAAC,MAAM,CAAC,aAAY,mBAAmB;sBAI/D,qBAAqB,CAAC,MAAM,CAAC,aAAY,mBAAmB;EAKvF"}

package/dist/src/react/core/genui/server.js

@@ -0,0 +1,66 @@
+import { readFile } from 'node:fs/promises';
+import { createElement } from 'react';
+import { renderToStaticMarkup } from 'react-dom/server';
+export { createReactComponentRegistry } from './react-registry.js';
+export function boundedCaptureOptions(options) {
+    const result = {
+        width: options.width ?? 1200,
+        height: options.height ?? 1600,
+        timeoutMs: options.timeoutMs ?? 15000,
+    };
+    for (const [key, value, min, max] of [
+        ['width', result.width, 320, 4096],
+        ['height', result.height, 200, 16384],
+        ['timeoutMs', result.timeoutMs, 100, 60000],
+    ]) {
+        if (!Number.isInteger(value) || value < min || value > max)
+            throw new RangeError(`genui: ${key} must be ${min}–${max}`);
+    }
+    return result;
+}
+export function createReactServerRenderer(options) {
+    async function content(presentation) {
+        const rendered = await options.registry.render(presentation, 'react');
+        return renderToStaticMarkup(createElement('main', { 'data-component': presentation.component, 'data-theme': options.theme }, rendered));
+    }
+    async function stylesheet() {
+        return typeof options.stylesheet === 'object'
+            ? readFile(options.stylesheet.path, 'utf8')
+            : (options.stylesheet ?? '');
+    }
+    async function html(presentation) {
+        return document(await content(presentation));
+    }
+    async function document(markup) {
+        const css = await stylesheet();
+        // Closing tags in trusted CSS must still never break out of the style element.
+        return `<!doctype html><html><head><meta charset="utf-8"><style>${css.replace(/<\/style/gi, '<\\/style')}</style></head><body>${markup}</body></html>`;
+    }
+    async function pages(presentation, settings) {
+        const limits = boundedCaptureOptions(settings);
+        const size = settings.rowsPerPage ?? 30;
+        if (!Number.isInteger(size) || size < 1 || size > 500)
+            throw new RangeError('genui: rowsPerPage must be 1–500');
+        const capture = settings.capture ?? options.capture;
+        if (!capture)
+            throw new Error('genui: a capture adapter is required for PNG/PDF output');
+        const rendered = await options.registry.renderPages(presentation, size);
+        return {
+            html: await Promise.all(rendered.map((node) => document(renderToStaticMarkup(createElement('main', { 'data-component': presentation.component, 'data-theme': options.theme }, node))))),
+            capture,
+            limits,
+        };
+    }
+    return {
+        html,
+        async images(presentation, settings = {}) {
+            const page = await pages(presentation, settings);
+            return page.capture.images(page.html, page.limits);
+        },
+        async pdf(presentation, settings = {}) {
+            const page = await pages(presentation, settings);
+            return page.capture.pdf(page.html, page.limits);
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

package/dist/src/react/core/genui/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../../../../src/react/core/genui/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAkB,MAAM,OAAO,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAC;AAIxD,OAAO,EAAE,4BAA4B,EAA+B,MAAM,qBAAqB,CAAC;AAsBhG,MAAM,UAAU,qBAAqB,CAAC,OAAuB;IAC3D,MAAM,MAAM,GAAG;QACb,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,IAAI;QAC5B,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,IAAI;QAC9B,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,KAAK;KACtC,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,IAAI;QACnC,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,EAAE,IAAI,CAAC;QAClC,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC;QACrC,CAAC,WAAW,EAAE,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,KAAK,CAAC;KACnC,EAAE,CAAC;QACX,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,GAAG,IAAI,KAAK,GAAG,GAAG;YACxD,MAAM,IAAI,UAAU,CAAC,UAAU,GAAG,YAAY,GAAG,IAAI,GAAG,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AACD,MAAM,UAAU,yBAAyB,CAAC,OAAmC;IAC3E,KAAK,UAAU,OAAO,CAAC,YAA2C;QAChE,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QACtE,OAAO,oBAAoB,CACzB,aAAa,CACX,MAAM,EACN,EAAE,gBAAgB,EAAE,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,KAAK,EAAE,EACzE,QAAqB,CACtB,CACF,CAAC;IACJ,CAAC;IACD,KAAK,UAAU,UAAU;QACvB,OAAO,OAAO,OAAO,CAAC,UAAU,KAAK,QAAQ;YAC3C,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC;YAC3C,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;IACD,KAAK,UAAU,IAAI,CAAC,YAA2C;QAC7D,OAAO,QAAQ,CAAC,MAAM,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC;IAC/C,CAAC;IACD,KAAK,UAAU,QAAQ,CAAC,MAAc;QACpC,MAAM,GAAG,GAAG,MAAM,UAAU,EAAE,CAAC;QAC/B,+EAA+E;QAC/E,OAAO,2DAA2D,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,WAAW,CAAC,wBAAwB,MAAM,gBAAgB,CAAC;IACzJ,CAAC;IACD,KAAK,UAAU,KAAK,CAAC,YAA2C,EAAE,QAA6B;QAC7F,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,QAAQ,CAAC,WAAW,IAAI,EAAE,CAAC;QACxC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,GAAG;YACnD,MAAM,IAAI,UAAU,CAAC,kCAAkC,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzF,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC;QACxE,OAAO;YACL,IAAI,EAAE,MAAM,OAAO,CAAC,GAAG,CACrB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CACpB,QAAQ,CACN,oBAAoB,CAClB,aAAa,CACX,MAAM,EACN,EAAE,gBAAgB,EAAE,YAAY,CAAC,SAAS,EAAE,YAAY,EAAE,OAAO,CAAC,KAAK,EAAE,EACzE,IAAI,CACL,CACF,CACF,CACF,CACF;YACD,OAAO;YACP,MAAM;SACP,CAAC;IACJ,CAAC;IACD,OAAO;QACL,IAAI;QACJ,KAAK,CAAC,MAAM,CAAC,YAA2C,EAAE,QAAQ,GAAwB,EAAE;YAC1F,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACrD,CAAC;QACD,KAAK,CAAC,GAAG,CAAC,YAA2C,EAAE,QAAQ,GAAwB,EAAE;YACvF,MAAM,IAAI,GAAG,MAAM,KAAK,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;YACjD,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/src/react/core/genui/types.d.ts

@@ -0,0 +1,98 @@
+import type { ComponentType, ReactNode } from 'react';
+/** The `ui` frame component a composed tree is pushed under (`GENUI_TREE_COMPONENT` of `@adonis-agora/agent/genui`). */
+export declare const GENUI_TREE_COMPONENT = "genui:tree";
+/** One pushed component, normalized from whatever carried it (a transcript block, a `data-ui` part, a stored entry). */
+export interface GenerativeUIItem {
+    fallbackText?: string;
+    componentVersions?: Record<string, number>;
+    id: string;
+    component: string;
+    props: Record<string, unknown>;
+    version: number | null;
+    toolCallId: string | null;
+}
+/** A node of a composed tree (`genui:tree` frames): `{ type, props, children? }`. */
+export interface GenerativeUIElement {
+    type: string;
+    props: Record<string, unknown>;
+    children?: GenerativeUIElement[];
+}
+/**
+ * An app's renderer for one component: it receives the component's props spread, plus `children`
+ * when it is a layout node in a tree. Any React component — the library never styles anything.
+ */
+export type GenuiRenderer<P = any> = ComponentType<P & {
+    children?: ReactNode;
+}>;
+/** Component name → the app's renderer. */
+export type GenuiRegistry = Record<string, GenuiRenderer>;
+/**
+ * Resolve a component the registry does not have — typically a tenant's own component, fetched for
+ * the exact `version` a message was rendered with. Return `null`/`undefined` for "no such
+ * component". May be async; results are cached per resolver, name and version.
+ */
+export type ResolveComponent = (name: string, version: number | null) => GenuiRenderer | null | undefined | Promise<GenuiRenderer | null | undefined>;
+export interface GenuiIssueLike {
+    path: (string | number)[];
+    message: string;
+}
+type ValidationLike = {
+    ok: true;
+    value: Record<string, unknown>;
+} | {
+    ok: false;
+    issues: GenuiIssueLike[];
+};
+/**
+ * What the renderer needs from a catalog to validate props before drawing them. A `Catalog` from
+ * `@adonis-agora/agent/genui` satisfies it; declared structurally so any catalog-shaped
+ * object does too.
+ */
+export interface GenuiCatalogLike {
+    get?(name: string): {
+        version?: number;
+    } | undefined;
+    has(name: string): boolean;
+    validate(name: string, props: unknown): Promise<ValidationLike>;
+    validateSync?(name: string, props: unknown): ValidationLike | undefined;
+}
+export interface GenerativeUIOptions {
+    registry: GenuiRegistry;
+    /** Validate props against it before rendering. Components the catalog does not know render unvalidated. */
+    catalog?: GenuiCatalogLike;
+    resolveComponent?: ResolveComponent;
+    /**
+     * Draws a composed tree frame (`genui:tree`) whole — e.g. through json-render (see the
+     * `/genui/json-render` subpath's `GenuiProvider`). Omitted → trees render node by node through
+     * `registry`.
+     */
+    treeRenderer?: GenuiRenderer<{
+        root?: GenerativeUIElement;
+    }>;
+}
+/** Why an item did not render. */
+export type GenerativeUIProblem = {
+    reason: 'unknown';
+    item: GenerativeUIItem;
+} | {
+    reason: 'invalid';
+    item: GenerativeUIItem;
+    issues: GenuiIssueLike[];
+} | {
+    reason: 'error';
+    item: GenerativeUIItem;
+    error: unknown;
+};
+export type GenerativeUIState = {
+    status: 'ready';
+    item: GenerativeUIItem;
+    Component: GenuiRenderer;
+    props: Record<string, unknown>;
+} | {
+    status: 'loading';
+    item: GenerativeUIItem;
+} | ({
+    status: 'problem';
+} & GenerativeUIProblem);
+export {};
+//# sourceMappingURL=types.d.ts.map