@pnlight/sdk-react 0.1.0

package/dist/haptics.js

@@ -0,0 +1,69 @@
+const IMPACT_STYLES = new Set([
+    "light",
+    "medium",
+    "heavy",
+    "soft",
+    "rigid"
+]);
+const NOTIFICATION_TYPES = new Set(["success", "warning", "error"]);
+/**
+ * Web is only a markup preview, so it records native haptic actions instead of
+ * trying to emulate them through the inconsistent Vibration API.
+ */
+export function handleHapticUrl(rawUrl, logId, log) {
+    let url;
+    try {
+        url = new URL(rawUrl);
+    }
+    catch {
+        return false;
+    }
+    if (url.protocol !== "pnlight:" || url.hostname !== "haptic") {
+        return false;
+    }
+    const command = url.pathname.replace(/^\/+|\/+$/g, "");
+    switch (command) {
+        case "impact": {
+            const requestedStyle = url.searchParams.get("style")?.toLowerCase() ?? "medium";
+            const style = IMPACT_STYLES.has(requestedStyle) ? requestedStyle : "medium";
+            const requestedIntensity = url.searchParams.get("intensity");
+            const parsedIntensity = requestedIntensity == null
+                ? null
+                : Number(requestedIntensity);
+            const intensity = parsedIntensity != null && Number.isFinite(parsedIntensity)
+                ? Math.min(1, Math.max(0, parsedIntensity))
+                : null;
+            log(`Haptic preview: impact · ${style}${intensity == null ? "" : ` · intensity ${intensity}`}`, logId);
+            break;
+        }
+        case "selection":
+            log("Haptic preview: selection", logId);
+            break;
+        case "notification": {
+            const requestedType = url.searchParams.get("type")?.toLowerCase() ?? "success";
+            const type = NOTIFICATION_TYPES.has(requestedType) ? requestedType : "success";
+            log(`Haptic preview: notification · ${type}`, logId);
+            break;
+        }
+        case "start": {
+            const pattern = url.searchParams.get("pattern")?.trim();
+            log(pattern
+                ? `Core Haptics preview: start · ${pattern}`
+                : "Core Haptics preview: start · missing pattern", logId);
+            break;
+        }
+        case "stop": {
+            const pattern = url.searchParams.get("pattern")?.trim();
+            log(pattern
+                ? `Core Haptics preview: stop · ${pattern}`
+                : "Core Haptics preview: stop all", logId);
+            break;
+        }
+        default:
+            log(`Haptic preview: unsupported command · ${command || "(empty)"}`, logId);
+    }
+    // PNLight owns this protocol. Even malformed/unsupported haptic commands
+    // must not escape into DivKit's generic custom-action handling.
+    return true;
+}
+//# sourceMappingURL=haptics.js.map

package/dist/haptics.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { PNLightDivKit, RemoteUi, type RemoteUiProps } from "./RemoteUi.js";
+export type { PNLightActionEvent, PNLightActionKind, RemoteUiDocument } from "./runtime.js";
+export type { FlowDocument, FlowPresentation, FlowRoute } from "./flow.js";
+export type { ReferenceSizeConfiguration, SafeAreaConfiguration, SafeAreaEdge, SafeAreaMode } from "./safe-area.js";
+export type { RemoteUiSchemaVersion } from "./schema-version.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,QAAQ,EACR,KAAK,aAAa,EACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,SAAS,EACV,MAAM,WAAW,CAAC;AACnB,YAAY,EACV,0BAA0B,EAC1B,qBAAqB,EACrB,YAAY,EACZ,YAAY,EACb,MAAM,gBAAgB,CAAC;AACxB,YAAY,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,2 @@
+export { PNLightDivKit, RemoteUi } from "./RemoteUi.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,QAAQ,EAET,MAAM,eAAe,CAAC"}

package/dist/runtime.d.ts

@@ -0,0 +1,27 @@
+import { render as renderDivKit } from "@divkitframework/divkit/client";
+import { type RemoteUiSchemaVersion } from "./schema-version.js";
+type DivKitRenderOptions = Parameters<typeof renderDivKit>[0];
+export type PNLightActionKind = "navigation" | "dialog" | "haptic";
+export interface PNLightActionEvent {
+    kind: PNLightActionKind;
+    url: string;
+    logId: string;
+    message?: string;
+}
+export type RemoteUiDocument = DivKitRenderOptions["json"] | Record<string, unknown>;
+export type RemoteUiRenderOptions = Omit<DivKitRenderOptions, "target" | "json" | "globalVariablesController" | "customComponents" | "extensions" | "onCustomAction" | "onError"> & {
+    target: HTMLElement;
+    json: RemoteUiDocument | string;
+    customComponents?: DivKitRenderOptions["customComponents"];
+    extensions?: DivKitRenderOptions["extensions"];
+    onCustomAction?: DivKitRenderOptions["onCustomAction"];
+    onError?: DivKitRenderOptions["onError"];
+    onPNLightAction?: (event: PNLightActionEvent) => void;
+};
+export interface MountedRemoteUi {
+    readonly schemaVersion: RemoteUiSchemaVersion;
+    destroy(): void;
+}
+export declare function mountRemoteUi(options: RemoteUiRenderOptions): MountedRemoteUi;
+export {};
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,MAAM,IAAI,YAAY,EACvB,MAAM,gCAAgC,CAAC;AAaxC,OAAO,EAEL,KAAK,qBAAqB,EAC3B,MAAM,qBAAqB,CAAC;AAE7B,KAAK,mBAAmB,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAG9D,MAAM,MAAM,iBAAiB,GAAG,YAAY,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEnE,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,iBAAiB,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,MAAM,gBAAgB,GACxB,mBAAmB,CAAC,MAAM,CAAC,GAC3B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE5B,MAAM,MAAM,qBAAqB,GAAG,IAAI,CACtC,mBAAmB,EACjB,QAAQ,GACR,MAAM,GACN,2BAA2B,GAC3B,kBAAkB,GAClB,YAAY,GACZ,gBAAgB,GAChB,SAAS,CACZ,GAAG;IACF,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAAC;IAChC,gBAAgB,CAAC,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;IAC3D,UAAU,CAAC,EAAE,mBAAmB,CAAC,YAAY,CAAC,CAAC;IAC/C,cAAc,CAAC,EAAE,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACvD,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAC;IACzC,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;CACvD,CAAC;AAMF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,qBAAqB,GAAG,eAAe,CAE7E"}

package/dist/runtime.js

@@ -0,0 +1,192 @@
+import { lottieExtensionBuilder, render as renderDivKit } from "@divkitframework/divkit/client";
+import lottie from "lottie-web";
+import { registerPNLightComponents } from "./custom-components.js";
+import { PNLightWebDialogs, readDialogs } from "./dialogs.js";
+import { isFlowDocument, PNLightWebFlow } from "./flow.js";
+import { handleHapticUrl } from "./haptics.js";
+import { configureSafeArea, disconnectSafeArea, readReferenceSize } from "./safe-area.js";
+import { resolveSchemaVersion } from "./schema-version.js";
+export function mountRemoteUi(options) {
+    return new PNLightRemoteUiRuntime(options);
+}
+class PNLightRemoteUiRuntime {
+    schemaVersion;
+    target;
+    options;
+    instance = null;
+    activeFlow = null;
+    activeDialogs = null;
+    destroyed = false;
+    routeCounter = 0;
+    constructor(options) {
+        this.options = options;
+        this.target = options.target;
+        const json = parseDocument(options.json);
+        this.schemaVersion = resolveSchemaVersion(json);
+        this.target.classList.add("pnlight-remote-ui");
+        this.target.addEventListener("pnlight-action", this.handleComponentAction);
+        try {
+            this.render(json);
+        }
+        catch (error) {
+            this.reportError(asError(error));
+        }
+    }
+    destroy() {
+        if (this.destroyed)
+            return;
+        this.destroyed = true;
+        this.instance?.$destroy();
+        this.activeDialogs?.destroy();
+        this.activeFlow = null;
+        this.activeDialogs = null;
+        this.instance = null;
+        this.target.removeEventListener("pnlight-action", this.handleComponentAction);
+        disconnectSafeArea(this.target);
+        this.target.classList.remove("pnlight-remote-ui", "pnlight-flow-host");
+        this.target.replaceChildren();
+    }
+    render(json) {
+        if (this.schemaVersion < 2 && isFlowLike(json)) {
+            throw new Error('PNLight flow documents require "schemaVersion": 2.');
+        }
+        this.activeDialogs = this.schemaVersion >= 2
+            ? new PNLightWebDialogs(readDialogs(json), (url, logId) => this.emitPNLightAction("dialog", url, logId))
+            : null;
+        if (isFlowDocument(json)) {
+            configureSafeArea(this.target, { mode: "edge_to_edge" }, undefined, this.schemaVersion);
+            this.activeFlow = new PNLightWebFlow({
+                host: this.target,
+                document: json,
+                schemaVersion: this.schemaVersion,
+                renderRoute: (routeOptions) => this.renderDivKitRoute(routeOptions),
+                onAction: (url, logId) => {
+                    this.emitPNLightAction(inferKind(url), url, logId);
+                },
+                onError: (message) => this.reportError(new Error(message))
+            });
+            this.instance = this.activeFlow;
+            return;
+        }
+        this.instance = this.renderDivKitRoute({
+            target: this.target,
+            json,
+            id: this.options.id,
+            onAction: () => { },
+            onError: (message) => this.reportError(new Error(message)),
+            safeArea: readSafeArea(json),
+            referenceSize: readReferenceSize(json),
+            schemaVersion: this.schemaVersion
+        });
+    }
+    renderDivKitRoute(route) {
+        const { target: _target, json: _json, onPNLightAction: _onPNLightAction, customComponents: suppliedComponents, extensions: suppliedExtensions, onCustomAction, onError: _onError, ...divKitOptions } = this.options;
+        const globalVariablesController = configureSafeArea(route.target, route.safeArea, route.referenceSize, route.schemaVersion);
+        const customComponents = new Map(suppliedComponents ?? []);
+        for (const [name, description] of registerPNLightComponents()) {
+            customComponents.set(name, description);
+        }
+        const extensions = new Map(suppliedExtensions ?? []);
+        extensions.set("lottie", lottieExtensionBuilder(lottie.loadAnimation));
+        let routeInstance;
+        routeInstance = renderDivKit({
+            ...divKitOptions,
+            id: route.id || `${this.options.id}-route-${++this.routeCounter}`,
+            target: route.target,
+            json: route.json,
+            pagerChildrenClipEnabled: this.options.pagerChildrenClipEnabled ?? false,
+            globalVariablesController,
+            customComponents,
+            extensions,
+            onCustomAction: (action, context) => {
+                const url = action.url ?? "";
+                const logId = action.log_id ?? "custom_action";
+                if (!this.handlePNLightUrl(url, logId, routeInstance)) {
+                    onCustomAction?.(action, context);
+                }
+            },
+            onError: (details) => {
+                route.onError(details.error.message);
+            }
+        });
+        return routeInstance;
+    }
+    handlePNLightUrl(url, logId, instance) {
+        if (this.schemaVersion < 2)
+            return false;
+        if (this.activeFlow?.handleUrl(url, logId))
+            return true;
+        if (this.activeDialogs?.handleUrl(url, logId, (action) => {
+            instance?.execAction(action);
+        })) {
+            return true;
+        }
+        let hapticMessage;
+        const handled = handleHapticUrl(url, logId, (message) => {
+            hapticMessage = message;
+        });
+        if (handled) {
+            this.emitPNLightAction("haptic", url, logId, hapticMessage);
+        }
+        return handled;
+    }
+    handleComponentAction = (event) => {
+        const detail = event.detail;
+        const url = detail?.url ?? "";
+        const logId = detail?.log_id ?? "pnlight_custom_component";
+        if (this.handlePNLightUrl(url, logId)) {
+            event.preventDefault();
+        }
+    };
+    emitPNLightAction(kind, url, logId, message) {
+        this.options.onPNLightAction?.({ kind, url, logId, message });
+    }
+    reportError(error) {
+        const divKitError = Object.assign(error, {
+            level: "error",
+            additional: {}
+        });
+        this.options.onError?.({ error: divKitError });
+    }
+}
+function parseDocument(value) {
+    if (typeof value !== "string")
+        return value;
+    const parsed = JSON.parse(value);
+    if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+        throw new Error("Remote UI JSON must be an object.");
+    }
+    return parsed;
+}
+function readSafeArea(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const safeArea = value.safe_area;
+    if (!safeArea || typeof safeArea !== "object" || Array.isArray(safeArea)) {
+        return undefined;
+    }
+    return safeArea;
+}
+function isFlowLike(value) {
+    return Boolean(value
+        && typeof value === "object"
+        && !Array.isArray(value)
+        && value.type === "flow");
+}
+function inferKind(urlValue) {
+    try {
+        const url = new URL(urlValue);
+        if (url.hostname === "dialog")
+            return "dialog";
+        if (url.hostname === "haptic")
+            return "haptic";
+    }
+    catch {
+        // Flow owns malformed navigation URLs only after successful parsing.
+    }
+    return "navigation";
+}
+function asError(value) {
+    return value instanceof Error ? value : new Error(String(value));
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

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

package/dist/safe-area.d.ts

@@ -0,0 +1,22 @@
+import { createGlobalVariablesController } from "@divkitframework/divkit/client";
+import type { RemoteUiSchemaVersion } from "./schema-version.js";
+export type SafeAreaMode = "inset" | "content" | "edge_to_edge";
+export type SafeAreaEdge = "top" | "bottom" | "left" | "right";
+export interface SafeAreaConfiguration {
+    mode?: SafeAreaMode;
+    edges?: SafeAreaEdge[];
+}
+export interface ReferenceSizeConfiguration {
+    width: number;
+    height: number;
+}
+export declare function disconnectSafeArea(target: HTMLElement): void;
+/**
+ * Applies a deterministic portrait-phone safe area for markup testing.
+ *
+ * Native values depend on the device and presentation. Web deliberately uses
+ * fixed values so screenshots and expression debugging are reproducible.
+ */
+export declare function configureSafeArea(target: HTMLElement, input?: SafeAreaConfiguration, referenceSize?: ReferenceSizeConfiguration, schemaVersion?: RemoteUiSchemaVersion): ReturnType<typeof createGlobalVariablesController>;
+export declare function readReferenceSize(value: unknown): ReferenceSizeConfiguration | undefined;
+//# sourceMappingURL=safe-area.d.ts.map

package/dist/safe-area.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-area.d.ts","sourceRoot":"","sources":["../src/safe-area.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,+BAA+B,EAEhC,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,SAAS,GAAG,cAAc,CAAC;AAChE,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,qBAAqB;IACpC,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,KAAK,CAAC,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAWD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,CAG5D;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EACnB,KAAK,CAAC,EAAE,qBAAqB,EAC7B,aAAa,CAAC,EAAE,0BAA0B,EAC1C,aAAa,GAAE,qBAAyB,GACvC,UAAU,CAAC,OAAO,+BAA+B,CAAC,CAyFpD;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,0BAA0B,GAAG,SAAS,CAkBxF"}

package/dist/safe-area.js

@@ -0,0 +1,104 @@
+import { createGlobalVariablesController, createVariable } from "@divkitframework/divkit/client";
+const ALL_EDGES = ["top", "bottom", "left", "right"];
+const SIMULATED_INSETS = {
+    top: 24,
+    bottom: 16,
+    left: 0,
+    right: 0
+};
+const scaleObservers = new WeakMap();
+export function disconnectSafeArea(target) {
+    scaleObservers.get(target)?.disconnect();
+    scaleObservers.delete(target);
+}
+/**
+ * Applies a deterministic portrait-phone safe area for markup testing.
+ *
+ * Native values depend on the device and presentation. Web deliberately uses
+ * fixed values so screenshots and expression debugging are reproducible.
+ */
+export function configureSafeArea(target, input, referenceSize, schemaVersion = 1) {
+    disconnectSafeArea(target);
+    const extensionsEnabled = schemaVersion >= 2;
+    const mode = extensionsEnabled
+        ? (input?.mode === "content" || input?.mode === "edge_to_edge"
+            ? input.mode
+            : "inset")
+        : "edge_to_edge";
+    const edges = new Set(Array.isArray(input?.edges)
+        ? input.edges.filter((edge) => ALL_EDGES.includes(edge))
+        : ALL_EDGES);
+    target.dataset.safeAreaMode = mode;
+    target.style.setProperty("--pnlight-safe-top", mode === "inset" && edges.has("top") ? `${SIMULATED_INSETS.top}px` : "0px");
+    target.style.setProperty("--pnlight-safe-bottom", mode === "inset" && edges.has("bottom") ? `${SIMULATED_INSETS.bottom}px` : "0px");
+    target.style.setProperty("--pnlight-safe-left", mode === "inset" && edges.has("left") ? `${SIMULATED_INSETS.left}px` : "0px");
+    target.style.setProperty("--pnlight-safe-right", mode === "inset" && edges.has("right") ? `${SIMULATED_INSETS.right}px` : "0px");
+    const variables = createGlobalVariablesController();
+    if (!extensionsEnabled) {
+        delete target.dataset.scaleX;
+        delete target.dataset.scaleY;
+        return variables;
+    }
+    for (const edge of ALL_EDGES) {
+        const value = mode === "content" && edges.has(edge)
+            ? SIMULATED_INSETS[edge]
+            : 0;
+        variables.setVariable(createVariable(`safe_area_${edge}`, "number", value));
+    }
+    const scaleXVariable = createVariable("scaleX", "number", 1);
+    const scaleYVariable = createVariable("scaleY", "number", 1);
+    variables.setVariable(scaleXVariable);
+    variables.setVariable(scaleYVariable);
+    const updateScale = () => {
+        const rect = target.getBoundingClientRect();
+        const insetWidth = mode === "inset"
+            ? (edges.has("left") ? SIMULATED_INSETS.left : 0)
+                + (edges.has("right") ? SIMULATED_INSETS.right : 0)
+            : 0;
+        const insetHeight = mode === "inset"
+            ? (edges.has("top") ? SIMULATED_INSETS.top : 0)
+                + (edges.has("bottom") ? SIMULATED_INSETS.bottom : 0)
+            : 0;
+        const availableWidth = Math.max(0, rect.width - insetWidth);
+        const availableHeight = Math.max(0, rect.height - insetHeight);
+        const hasReference = referenceSize
+            && Number.isFinite(referenceSize.width)
+            && Number.isFinite(referenceSize.height)
+            && referenceSize.width > 0
+            && referenceSize.height > 0;
+        const scaleX = hasReference && availableWidth > 0
+            ? availableWidth / referenceSize.width
+            : 1;
+        const scaleY = hasReference && availableHeight > 0
+            ? availableHeight / referenceSize.height
+            : 1;
+        target.dataset.scaleX = String(scaleX);
+        target.dataset.scaleY = String(scaleY);
+        scaleXVariable.setValue(scaleX);
+        scaleYVariable.setValue(scaleY);
+    };
+    updateScale();
+    const scaleObserver = new ResizeObserver(updateScale);
+    scaleObserver.observe(target);
+    scaleObservers.set(target, scaleObserver);
+    return variables;
+}
+export function readReferenceSize(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    const candidate = value.referenceSize;
+    if (!candidate || typeof candidate !== "object" || Array.isArray(candidate)) {
+        return undefined;
+    }
+    const { width, height } = candidate;
+    if (typeof width !== "number"
+        || typeof height !== "number"
+        || !Number.isFinite(width)
+        || !Number.isFinite(height)
+        || width <= 0
+        || height <= 0) {
+        return undefined;
+    }
+    return { width, height };
+}
+//# sourceMappingURL=safe-area.js.map

package/dist/safe-area.js.map

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

package/dist/schema-version.d.ts

@@ -0,0 +1,11 @@
+export type RemoteUiSchemaVersion = 1 | 2;
+export declare const LEGACY_SCHEMA_VERSION: RemoteUiSchemaVersion;
+export declare const CURRENT_SCHEMA_VERSION: RemoteUiSchemaVersion;
+/**
+ * Missing schema metadata always means the legacy contract.
+ *
+ * An inherited version is used for nested documents such as routes in a
+ * server-authored flow.
+ */
+export declare function resolveSchemaVersion(value: unknown, inherited?: RemoteUiSchemaVersion): RemoteUiSchemaVersion;
+//# sourceMappingURL=schema-version.d.ts.map

package/dist/schema-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.d.ts","sourceRoot":"","sources":["../src/schema-version.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,CAAC,CAAC;AAE1C,eAAO,MAAM,qBAAqB,EAAE,qBAAyB,CAAC;AAC9D,eAAO,MAAM,sBAAsB,EAAE,qBAAyB,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,SAAS,GAAE,qBAA6C,GACvD,qBAAqB,CAevB"}

package/dist/schema-version.js

@@ -0,0 +1,30 @@
+export const LEGACY_SCHEMA_VERSION = 1;
+export const CURRENT_SCHEMA_VERSION = 2;
+/**
+ * Missing schema metadata always means the legacy contract.
+ *
+ * An inherited version is used for nested documents such as routes in a
+ * server-authored flow.
+ */
+export function resolveSchemaVersion(value, inherited = LEGACY_SCHEMA_VERSION) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return inherited;
+    }
+    const raw = value.schemaVersion;
+    if (raw === undefined)
+        return inherited;
+    if (raw === 1 || raw === 2) {
+        return raw;
+    }
+    throw new Error(`Unsupported Remote UI schemaVersion ${formatVersion(raw)}. `
+        + `This preview supports schemaVersion 1 and 2.`);
+}
+function formatVersion(value) {
+    if (typeof value === "string")
+        return JSON.stringify(value);
+    if (typeof value === "number" || typeof value === "boolean") {
+        return String(value);
+    }
+    return JSON.stringify(value) ?? String(value);
+}
+//# sourceMappingURL=schema-version.js.map

package/dist/schema-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-version.js","sourceRoot":"","sources":["../src/schema-version.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,qBAAqB,GAA0B,CAAC,CAAC;AAC9D,MAAM,CAAC,MAAM,sBAAsB,GAA0B,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,KAAc,EACd,YAAmC,qBAAqB;IAExD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,GAAG,GAAI,KAAqC,CAAC,aAAa,CAAC;IACjE,IAAI,GAAG,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IACxC,IAAI,GAAG,KAAK,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,MAAM,IAAI,KAAK,CACb,uCAAuC,aAAa,CAAC,GAAG,CAAC,IAAI;UACzD,8CAA8C,CACnD,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5D,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IACvB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC"}