@greensecurity/javascript-sdk 0.45.0 → 0.46.0-beta.10

package/dist/esm/apps/testing/index.d.ts

@@ -0,0 +1,120 @@
+import { RemoteReceiver, type RemoteReceiverElement, type RemoteReceiverNode } from "@remote-dom/core/receivers";
+import type { ReactElement } from "react";
+import { type ComponentName } from "../components.js";
+import { type AppTokens, type ExtensionContext } from "../context.js";
+import type { HostApi } from "../protocol.js";
+import { REMOTE_FRAGMENT_TAG } from "../runtime/elements.js";
+import { type SandboxRuntime } from "../runtime/sandbox.js";
+export type DeepPartial<T> = T extends readonly unknown[] ? T : T extends object ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : T;
+export declare function mockTokens(now?: number): AppTokens;
+/**
+ * A complete, valid `ExtensionContext` with `overrides` deep-merged in (arrays are replaced).
+ *
+ * `app.permissions` defaults to `[]`; set it to your manifest's permissions, platform ones
+ * included, e.g. `{ app: { permissions: ["vendors.view", "app_secrets.write"] } }`. Leave
+ * platform permissions such as `app_secrets.write` out of `auth.user.scope`: the server grants
+ * them to the app's role only, so a real user token never carries them. The mock performs no
+ * permission checks; stub the Secret Store's 403 yourself to test a missing grant.
+ */
+export declare function getMockContext(overrides?: DeepPartial<ExtensionContext>): ExtensionContext;
+export interface HostCall {
+    method: keyof HostApi;
+    args: unknown[];
+}
+export type MockHost = HostApi & {
+    /** Every call, in order. */
+    readonly calls: HostCall[];
+    /** Calls to one method. */
+    callsTo(method: keyof HostApi): unknown[][];
+};
+/**
+ * A `HostApi` that records calls. Unimplemented methods resolve to sensible defaults
+ * (`refreshTokens` returns fresh mock tokens, `openExternalUrl` resolves `false`).
+ */
+export declare function createMockHost(overrides?: Partial<HostApi>): MockHost;
+/** A JSON-friendly snapshot of the rendered tree; text nodes are strings. */
+export interface TestSnapshot {
+    type: ComponentName | typeof REMOTE_FRAGMENT_TAG | string;
+    props: Record<string, unknown>;
+    events: string[];
+    slot?: string;
+    children: Array<TestSnapshot | string>;
+}
+export type ElementPredicate = (element: TestElement) => boolean;
+/** A live view of one rendered element: reads always reflect the latest host-side state. */
+export declare class TestElement {
+    #private;
+    /** @internal */
+    constructor(harness: Harness, id: string);
+    get node(): RemoteReceiverElement;
+    get tag(): string;
+    /** Catalog component name, e.g. `"Button"`; undefined for `remote-fragment`. */
+    get component(): ComponentName | undefined;
+    get props(): Readonly<Record<string, unknown>>;
+    get attributes(): Readonly<Record<string, string>>;
+    /** Name of the slot this element fills, if any. */
+    get slot(): string | undefined;
+    /** Event names the app is listening to (`press`, `change`, `shownchange`, ...). */
+    get events(): string[];
+    get children(): Array<TestElement | string>;
+    /** Concatenated text of this element and its descendants. */
+    get text(): string;
+    /** Elements placed in slot `name` (the children of its `remote-fragment`). */
+    slotted(name: string): TestElement[];
+    find(component: ComponentName | string, predicate?: ElementPredicate): TestElement | undefined;
+    findAll(component: ComponentName | string, predicate?: ElementPredicate): TestElement[];
+    /**
+     * Calls the listener the host would call for `prop` (a catalog event prop such as `onPress`,
+     * or a raw event name such as `press`) with `detail`, then waits for the resulting render.
+     * Resolves with the handler's return value, as the host would receive it.
+     */
+    trigger(prop: string, detail?: unknown): Promise<unknown>;
+    toJSON(): TestSnapshot;
+}
+declare class Harness {
+    readonly receiver: RemoteReceiver;
+    mutations: number;
+    collect(nodes: readonly RemoteReceiverNode[], component: string, predicate?: ElementPredicate): TestElement[];
+    snapshot(node: RemoteReceiverElement): TestSnapshot;
+    /** Waits until React and the mutation batch have gone quiet. */
+    settle(): Promise<void>;
+}
+export interface RenderForTestOptions {
+    /** Overrides merged into `getMockContext()`, or a complete context. */
+    context?: DeepPartial<ExtensionContext>;
+    /** Host method overrides; every call is recorded on `result.host.calls`. */
+    host?: Partial<HostApi>;
+}
+export interface TestRender {
+    /** Top-level rendered elements (normally one ContextView or SettingsView). */
+    readonly roots: TestElement[];
+    /** The first top-level element. */
+    readonly root: TestElement;
+    readonly host: MockHost;
+    /** The context the view currently sees. */
+    readonly context: ExtensionContext;
+    /** Errors thrown by the view or by host calls after mounting. */
+    readonly errors: unknown[];
+    readonly receiver: RemoteReceiver;
+    /** The runtime under test; call its `SandboxExports` methods directly if needed. */
+    readonly runtime: SandboxRuntime;
+    readonly mountId: string;
+    find(component: ComponentName | string, predicate?: ElementPredicate): TestElement | undefined;
+    findAll(component: ComponentName | string, predicate?: ElementPredicate): TestElement[];
+    /** Text of the whole tree. */
+    text(): string;
+    toJSON(): TestSnapshot[];
+    /** Pushes a context patch through `SandboxExports.updateContext`, then settles. */
+    updateContext(patch: Partial<ExtensionContext>): Promise<void>;
+    unmount(): Promise<void>;
+    settle(): Promise<void>;
+}
+/**
+ * Mounts `element` through the real runtime (`SandboxExports.mount`) against an in-process
+ * `RemoteReceiver`, so what a test sees is exactly what a host would receive.
+ */
+export declare function renderForTest(element: ReactElement, options?: RenderForTestOptions): Promise<TestRender>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/apps/testing/index.d.ts.map

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

package/dist/esm/apps/testing/index.js

@@ -0,0 +1,334 @@
+/*
+ * Hand-written (not generated by Speakeasy). Third-party app developer kit (C10); see
+ * docs/third-party-apps/plan.md.
+ *
+ * Import as `@greensecurity/javascript-sdk/apps/testing`. Works in Vitest and Jest with the
+ * plain Node environment: the remote-dom polyfill supplies the DOM the runtime needs.
+ *
+ * ```ts
+ * const view = await renderForTest(<VendorPanel />, {
+ *   context: { environment: { objectContext: { object: "vendor", id: 42 } } },
+ * });
+ * expect(view.find("Text", (t) => t.text.includes("42"))).toBeDefined();
+ * await view.find("Button")!.trigger("onPress");
+ * expect(view.find("FocusView")!.props["shown"]).toBe(true);
+ * ```
+ */
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _TestElement_harness, _TestElement_id;
+import { polyfillInstalled } from "../runtime/polyfill.js";
+import { RemoteReceiver } from "@remote-dom/core/receivers";
+import { COMPONENTS } from "../components.js";
+import { PROTOCOL_VERSION } from "../context.js";
+import { REMOTE_FRAGMENT_TAG } from "../runtime/elements.js";
+import { createSandboxExports } from "../runtime/sandbox.js";
+// Remote-dom node type constants (`NODE_TYPE_ELEMENT`, `NODE_TYPE_TEXT`).
+const NODE_TYPE_ELEMENT = 1;
+const NODE_TYPE_TEXT = 3;
+const FIFTEEN_MINUTES = 15 * 60000;
+export function mockTokens(now = Date.now()) {
+    return {
+        user: { accessToken: "gsu_test_user_token", expiresAt: now + FIFTEEN_MINUTES, scope: [] },
+        installation: { accessToken: "gsi_test_installation_token", expiresAt: now + FIFTEEN_MINUTES, activationId: 1 },
+    };
+}
+/**
+ * A complete, valid `ExtensionContext` with `overrides` deep-merged in (arrays are replaced).
+ *
+ * `app.permissions` defaults to `[]`; set it to your manifest's permissions, platform ones
+ * included, e.g. `{ app: { permissions: ["vendors.view", "app_secrets.write"] } }`. Leave
+ * platform permissions such as `app_secrets.write` out of `auth.user.scope`: the server grants
+ * them to the app's role only, so a real user token never carries them. The mock performs no
+ * permission checks; stub the Secret Store's 403 yourself to test a missing grant.
+ */
+export function getMockContext(overrides = {}) {
+    const base = {
+        protocolVersion: PROTOCOL_VERSION,
+        app: { id: 1, version: "1.0.0", permissions: [], csp: { connectSrc: [], imageSrc: [] } },
+        user: { id: 1, name: "Test User", userType: "company_manager", locale: "en-US", companyId: 1 },
+        environment: {
+            surfaceId: "gs.company.drawer.default",
+            portal: "company",
+            platform: "web",
+            queryParams: {},
+            constants: {},
+            apiBaseUrl: "https://api.example.test/api",
+        },
+        auth: mockTokens(),
+    };
+    return deepMerge(base, overrides);
+}
+function isPlainObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value) &&
+        (Object.getPrototypeOf(value) === Object.prototype || Object.getPrototypeOf(value) === null);
+}
+function deepMerge(base, patch) {
+    if (!isPlainObject(base) || !isPlainObject(patch))
+        return patch === undefined ? base : patch;
+    const out = { ...base };
+    for (const [key, value] of Object.entries(patch)) {
+        if (value === undefined)
+            continue;
+        out[key] = deepMerge(base[key], value);
+    }
+    return out;
+}
+/**
+ * A `HostApi` that records calls. Unimplemented methods resolve to sensible defaults
+ * (`refreshTokens` returns fresh mock tokens, `openExternalUrl` resolves `false`).
+ */
+export function createMockHost(overrides = {}) {
+    const calls = [];
+    const defaults = {
+        refreshTokens: async () => mockTokens(),
+        navigate: async () => undefined,
+        openExternalUrl: async () => false,
+        showToast: async () => undefined,
+        refreshHostData: async () => undefined,
+        clipboardWriteText: async () => undefined,
+        closeView: async () => undefined,
+    };
+    const impl = { ...defaults, ...overrides };
+    const record = (method) => ((...args) => {
+        calls.push({ method, args });
+        return impl[method](...args);
+    });
+    return {
+        refreshTokens: record("refreshTokens"),
+        navigate: record("navigate"),
+        openExternalUrl: record("openExternalUrl"),
+        showToast: record("showToast"),
+        refreshHostData: record("refreshHostData"),
+        clipboardWriteText: record("clipboardWriteText"),
+        closeView: record("closeView"),
+        calls,
+        callsTo: (method) => calls.filter((c) => c.method === method).map((c) => c.args),
+    };
+}
+// ---------------------------------------------------------------------------------------------
+// Rendered tree
+const CATALOG = COMPONENTS;
+const NAME_BY_TAG = new Map(Object.keys(CATALOG).map((name) => [CATALOG[name].tagName, name]));
+/** A live view of one rendered element: reads always reflect the latest host-side state. */
+export class TestElement {
+    /** @internal */
+    constructor(harness, id) {
+        _TestElement_harness.set(this, void 0);
+        _TestElement_id.set(this, void 0);
+        __classPrivateFieldSet(this, _TestElement_harness, harness, "f");
+        __classPrivateFieldSet(this, _TestElement_id, id, "f");
+    }
+    get node() {
+        const node = __classPrivateFieldGet(this, _TestElement_harness, "f").receiver.get({ id: __classPrivateFieldGet(this, _TestElement_id, "f") });
+        if (!node)
+            throw new Error("This element is no longer rendered");
+        return node;
+    }
+    get tag() {
+        return this.node.element;
+    }
+    /** Catalog component name, e.g. `"Button"`; undefined for `remote-fragment`. */
+    get component() {
+        return NAME_BY_TAG.get(this.tag);
+    }
+    get props() {
+        return this.node.properties;
+    }
+    get attributes() {
+        return this.node.attributes;
+    }
+    /** Name of the slot this element fills, if any. */
+    get slot() {
+        return this.node.attributes["slot"];
+    }
+    /** Event names the app is listening to (`press`, `change`, `shownchange`, ...). */
+    get events() {
+        return Object.keys(this.node.eventListeners).filter((name) => typeof this.node.eventListeners[name] === "function");
+    }
+    get children() {
+        return this.node.children.flatMap((child) => {
+            if (child.type === NODE_TYPE_ELEMENT)
+                return [new TestElement(__classPrivateFieldGet(this, _TestElement_harness, "f"), child.id)];
+            if (child.type === NODE_TYPE_TEXT)
+                return [child.data];
+            return [];
+        });
+    }
+    /** Concatenated text of this element and its descendants. */
+    get text() {
+        return textOf(this.node);
+    }
+    /** Elements placed in slot `name` (the children of its `remote-fragment`). */
+    slotted(name) {
+        return this.children.flatMap((child) => typeof child !== "string" && child.tag === REMOTE_FRAGMENT_TAG && child.slot === name
+            ? child.children.filter((c) => typeof c !== "string")
+            : []);
+    }
+    find(component, predicate) {
+        return this.findAll(component, predicate)[0];
+    }
+    findAll(component, predicate) {
+        return __classPrivateFieldGet(this, _TestElement_harness, "f").collect(this.node.children, component, predicate);
+    }
+    /**
+     * Calls the listener the host would call for `prop` (a catalog event prop such as `onPress`,
+     * or a raw event name such as `press`) with `detail`, then waits for the resulting render.
+     * Resolves with the handler's return value, as the host would receive it.
+     */
+    async trigger(prop, detail) {
+        const component = this.component;
+        const eventName = (component && CATALOG[component].events[prop]?.event) ?? prop;
+        const listener = this.node.eventListeners[eventName];
+        if (typeof listener !== "function") {
+            throw new Error(`<${this.tag}> is not listening for "${eventName}"`);
+        }
+        const result = await listener(detail);
+        await __classPrivateFieldGet(this, _TestElement_harness, "f").settle();
+        return result;
+    }
+    toJSON() {
+        return __classPrivateFieldGet(this, _TestElement_harness, "f").snapshot(this.node);
+    }
+}
+_TestElement_harness = new WeakMap(), _TestElement_id = new WeakMap();
+function textOf(node) {
+    if (node.type === NODE_TYPE_TEXT)
+        return node.data;
+    if ("children" in node)
+        return node.children.map(textOf).join("");
+    return "";
+}
+class Harness {
+    constructor() {
+        this.receiver = new RemoteReceiver();
+        this.mutations = 0;
+    }
+    collect(nodes, component, predicate) {
+        const tag = component in CATALOG ? CATALOG[component].tagName : component;
+        const found = [];
+        const walk = (list) => {
+            for (const node of list) {
+                if (node.type !== NODE_TYPE_ELEMENT)
+                    continue;
+                const element = new TestElement(this, node.id);
+                if (node.element === tag && (!predicate || predicate(element)))
+                    found.push(element);
+                walk(node.children);
+            }
+        };
+        walk(nodes);
+        return found;
+    }
+    snapshot(node) {
+        const snap = {
+            type: NAME_BY_TAG.get(node.element) ?? node.element,
+            props: { ...node.properties },
+            events: Object.keys(node.eventListeners).filter((k) => typeof node.eventListeners[k] === "function"),
+            children: node.children.flatMap((child) => {
+                if (child.type === NODE_TYPE_ELEMENT)
+                    return [this.snapshot(child)];
+                if (child.type === NODE_TYPE_TEXT)
+                    return [child.data];
+                return [];
+            }),
+        };
+        const slot = node.attributes["slot"];
+        if (slot !== undefined)
+            snap.slot = slot;
+        return snap;
+    }
+    /** Waits until React and the mutation batch have gone quiet. */
+    async settle() {
+        let quietTicks = 0;
+        for (let i = 0; i < 50 && quietTicks < 2; i++) {
+            const before = this.mutations;
+            await new Promise((resolve) => setTimeout(resolve, 0));
+            quietTicks = this.mutations === before ? quietTicks + 1 : 0;
+        }
+    }
+}
+let nextMount = 0;
+/**
+ * Mounts `element` through the real runtime (`SandboxExports.mount`) against an in-process
+ * `RemoteReceiver`, so what a test sees is exactly what a host would receive.
+ */
+export async function renderForTest(element, options = {}) {
+    if (!polyfillInstalled())
+        throw new Error("The remote-dom polyfill is not installed");
+    const harness = new Harness();
+    const errors = [];
+    const host = createMockHost(options.host);
+    let context = getMockContext(options.context);
+    const runtime = createSandboxExports({ views: { TestView: () => element } }, {
+        batch: (flush) => queueMicrotask(flush),
+        onError: (error) => {
+            errors.push(error);
+        },
+    });
+    const connection = {
+        mutate(records) {
+            harness.mutations += 1;
+            harness.receiver.connection.mutate(records);
+        },
+        call(id, method, ...args) {
+            return harness.receiver.connection.call(id, method, ...args);
+        },
+    };
+    const mountId = `test-${++nextMount}`;
+    await runtime.mount({
+        mountId,
+        viewComponent: "TestView",
+        surfaceId: context.environment.surfaceId,
+        connection,
+        context,
+        host,
+    });
+    await harness.settle();
+    const rootElements = () => harness.receiver.root.children
+        .filter((node) => node.type === NODE_TYPE_ELEMENT)
+        .map((node) => new TestElement(harness, node.id));
+    return {
+        get roots() {
+            return rootElements();
+        },
+        get root() {
+            const first = rootElements()[0];
+            if (!first)
+                throw new Error("The view rendered nothing");
+            return first;
+        },
+        host,
+        get context() {
+            return context;
+        },
+        errors,
+        receiver: harness.receiver,
+        runtime,
+        mountId,
+        find: (component, predicate) => harness.collect(harness.receiver.root.children, component, predicate)[0],
+        findAll: (component, predicate) => harness.collect(harness.receiver.root.children, component, predicate),
+        text: () => textOf(harness.receiver.root),
+        toJSON: () => rootElements().map((e) => e.toJSON()),
+        async updateContext(patch) {
+            await runtime.updateContext(mountId, patch);
+            context = { ...context, ...patch, protocolVersion: PROTOCOL_VERSION };
+            await harness.settle();
+        },
+        async unmount() {
+            await runtime.unmount(mountId);
+            await harness.settle();
+        },
+        settle: () => harness.settle(),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/esm/apps/testing/index.js.map

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

package/dist/esm/apps/testing.d.ts

@@ -0,0 +1,2 @@
+export * from "./testing/index.js";
+//# sourceMappingURL=testing.d.ts.map

package/dist/esm/apps/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../../../src/apps/testing.ts"],"names":[],"mappings":"AAOA,cAAc,oBAAoB,CAAC"}

package/dist/esm/apps/testing.js

@@ -0,0 +1,8 @@
+/*
+ * Hand-written (not generated by Speakeasy). Entry point for
+ * `@greensecurity/javascript-sdk/apps/testing` (third-party app developer kit, C10). The package
+ * `exports` map resolves `./apps/<name>` to `src/apps/<name>.ts`, so each kit folder gets
+ * a one-line entry file next to it.
+ */
+export * from "./testing/index.js";
+//# sourceMappingURL=testing.js.map

package/dist/esm/apps/testing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.js","sourceRoot":"","sources":["../../../src/apps/testing.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,oBAAoB,CAAC"}

package/dist/esm/apps/ui/factory.d.ts

@@ -0,0 +1,6 @@
+import { type FunctionComponent, type ReactNode } from "react";
+import { type ComponentName, type ComponentProps } from "../components.js";
+/** Props of the SDK component for catalog entry `N`: C0's `ComponentProps` with React nodes. */
+export type UiProps<N extends ComponentName> = ComponentProps<N, ReactNode>;
+export declare function createUiComponent<N extends ComponentName>(name: N): FunctionComponent<UiProps<N>>;
+//# sourceMappingURL=factory.d.ts.map

package/dist/esm/apps/ui/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../../../src/apps/ui/factory.ts"],"names":[],"mappings":"AAsBA,OAAO,EAA0C,KAAK,iBAAiB,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvG,OAAO,EAAc,KAAK,aAAa,EAAE,KAAK,cAAc,EAAsB,MAAM,kBAAkB,CAAC;AAE3G,gGAAgG;AAChG,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,aAAa,IAAI,cAAc,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAmD5E,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,aAAa,EAAE,IAAI,EAAE,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CA+EjG"}

package/dist/esm/apps/ui/factory.js

@@ -0,0 +1,138 @@
+/*
+ * Hand-written (not generated by Speakeasy). Third-party app developer kit (C10); see
+ * docs/third-party-apps/plan.md.
+ *
+ * Builds the React component for one catalog entry. It renders the catalog's custom element
+ * (registered by `runtime/elements.ts`) and syncs props onto it after each commit, the job
+ * `createRemoteComponent` from `@remote-dom/react` does. The SDK does its own because that
+ * package's peer range (`react ^17 || ^18`) breaks React 19 installs for app authors. Beyond
+ * that, this layer:
+ *  - hands handlers the event's `detail` (a boolean, a string, the form values...) instead of
+ *    a DOM event, and returns whatever they return (usually a promise) as the value of the
+ *    host's call, so the host can wait for an async handler;
+ *  - keeps listener identities stable across renders, so a re-render does not re-send
+ *    listeners across the thread;
+ *  - forwards only catalog props (no `style`, `className`, `ref` or typos), and clears a prop
+ *    on the host when the app stops passing it;
+ *  - renders each slot prop as `<remote-fragment slot="name">`, wrapping text so it still lands
+ *    in the slot.
+ */
+import { REMOTE_FRAGMENT_TAG } from "../runtime/elements.js";
+import { createElement, useLayoutEffect, useRef } from "react";
+import { COMPONENTS } from "../components.js";
+const CATALOG = COMPONENTS;
+/**
+ * Whether a value is React content rather than plain data: an element, a portal, a fragment,
+ * an array or other iterable of nodes, a thenable (React 19 renders promises), or a `bigint`
+ * (a React 19 node that JSON cannot encode). The plain values a catalog prop that doubles as a
+ * slot accepts (strings, numbers) are none of these.
+ */
+function isRichNode(value) {
+    return typeof value === "bigint" || (typeof value === "object" && value !== null);
+}
+/** How deep {@link isSendable} looks into arrays and plain objects. */
+const MAX_DATA_DEPTH = 8;
+/**
+ * Whether a plain data prop can cross the JSON thread: no React element or portal (`$$typeof`),
+ * `bigint`, function or symbol anywhere inside it, including nested in arrays and plain objects.
+ * Anything else (a class instance, a cycle, very deep nesting) is refused too.
+ */
+function isSendable(value, depth = 0, seen = new Set()) {
+    if (value === null || value === undefined)
+        return true;
+    switch (typeof value) {
+        case "string":
+        case "number":
+        case "boolean":
+            return true;
+        case "object":
+            break;
+        default:
+            return false; // bigint, function, symbol
+    }
+    if (depth >= MAX_DATA_DEPTH || seen.has(value) || "$$typeof" in value)
+        return false;
+    seen.add(value);
+    if (Array.isArray(value))
+        return value.every((item) => isSendable(item, depth + 1, seen));
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== null)
+        return false;
+    return Object.values(value).every((item) => isSendable(item, depth + 1, seen));
+}
+export function createUiComponent(name) {
+    const spec = CATALOG[name];
+    const tagName = spec.tagName;
+    const dataProps = Object.keys(spec.props);
+    const events = Object.entries(spec.events).map(([prop, e]) => [prop, e.event]);
+    const slotNames = spec.slots;
+    const propAndSlot = new Set(slotNames.filter((slot) => slot in spec.props));
+    function UiComponent(props) {
+        const raw = props;
+        const element = useRef(null);
+        // A stable ref callback, so React does not detach and reattach it on every render.
+        const setElement = useRef((node) => void (element.current = node)).current;
+        // Latest handlers, read by listeners whose identity never changes.
+        const handlers = useRef({});
+        const listeners = useRef({});
+        // What was last written to the element, to write only changes.
+        const appliedProps = useRef({});
+        const attached = useRef({});
+        const slotChildren = [];
+        for (const slot of slotNames) {
+            const value = raw[slot];
+            if (value === undefined || value === null || typeof value === "boolean")
+                continue;
+            // A name that is both a prop and a slot (PropertyListItem `value`): plain values are the
+            // prop, React content in any form fills the slot.
+            if (propAndSlot.has(slot) && !isRichNode(value))
+                continue;
+            slotChildren.push(createElement(REMOTE_FRAGMENT_TAG, { slot, key: `slot:${slot}` }, value));
+        }
+        useLayoutEffect(() => {
+            var _a;
+            const el = element.current;
+            if (!el)
+                return;
+            const target = el;
+            const next = {};
+            for (const key of dataProps) {
+                const value = raw[key];
+                // React content is rendered into the slot above, and is never sent as remote data: it
+                // cannot cross the thread.
+                next[key] = (propAndSlot.has(key) ? isRichNode(value) : !isSendable(value)) ? undefined : value;
+                // Assigning `undefined` clears the property on the host.
+                if (!Object.is(appliedProps.current[key], next[key]))
+                    target[key] = next[key];
+            }
+            appliedProps.current = next;
+            // Handlers are taken from committed props only. Updating them during render would let an
+            // already-attached listener call a handler from a render that never commits (an
+            // interrupted transition, a suspended subtree).
+            for (const [prop] of events) {
+                const handler = raw[prop];
+                handlers.current[prop] = typeof handler === "function" ? handler : undefined;
+            }
+            for (const [prop, eventName] of events) {
+                const wanted = handlers.current[prop] !== undefined;
+                if (wanted === (attached.current[prop] === true))
+                    continue;
+                (_a = listeners.current)[prop] ?? (_a[prop] = (event) => {
+                    const result = handlers.current[prop]?.(event.detail);
+                    if (result !== undefined)
+                        event.respondWith(result);
+                });
+                if (wanted)
+                    el.addEventListener(eventName, listeners.current[prop]);
+                else
+                    el.removeEventListener(eventName, listeners.current[prop]);
+                attached.current[prop] = wanted;
+            }
+        });
+        const children = raw["children"];
+        return createElement(tagName, { ref: setElement }, ...(slotChildren.length ? [children, slotChildren] : [children]));
+    }
+    UiComponent.displayName = name;
+    return UiComponent;
+}
+//# sourceMappingURL=factory.js.map