@mosaic-media/sdui-react 0.1.0

package/dist/components/shared.js

@@ -0,0 +1,36 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useRuntime } from "../sdui/context";
+import { prop } from "../sdui/registry";
+export function cx(...parts) {
+    return parts.filter(Boolean).join(" ");
+}
+/** Read an optional `action` prop off a node and return a click handler. */
+export function useNodeAction(node) {
+    const { emit } = useRuntime();
+    const action = prop(node, "action", undefined);
+    return () => emit(action);
+}
+const PATHS = {
+    play: "M8 5v14l11-7z",
+    search: "M10 4a6 6 0 104.9 9.5l4.3 4.3 1.4-1.4-4.3-4.3A6 6 0 0010 4zm0 2a4 4 0 110 8 4 4 0 010-8z",
+    "chevron-right": "M9 6l6 6-6 6",
+    "chevron-down": "M6 9l6 6 6-6",
+    star: "M12 3.5l2.6 5.3 5.9.9-4.3 4.1 1 5.8-5.2-2.7-5.2 2.7 1-5.8L3.5 9.7l5.9-.9z",
+    plus: "M12 5v14M5 12h14",
+    check: "M5 13l4 4L19 7",
+    close: "M6 6l12 12M18 6L6 18",
+    dots: "M5 12h.01M12 12h.01M19 12h.01",
+    info: "M12 8h.01M11 12h1v4h1M12 3a9 9 0 100 18 9 9 0 000-18z",
+    warning: "M12 3l9 16H3zM12 10v4M12 17h.01",
+    error: "M12 3a9 9 0 100 18 9 9 0 000-18zM9 9l6 6M15 9l-6 6",
+    success: "M12 3a9 9 0 100 18 9 9 0 000-18zM8 12l3 3 5-5",
+    external: "M14 5h5v5M19 5l-8 8M12 5H6a1 1 0 00-1 1v12a1 1 0 001 1h12a1 1 0 001-1v-6",
+    grid: "M4 4h7v7H4zM13 4h7v7h-7zM4 13h7v7H4zM13 13h7v7h-7z",
+    list: "M8 6h13M8 12h13M8 18h13M3 6h.01M3 12h.01M3 18h.01",
+};
+const FILLED = { play: true, star: true };
+export function Icon({ name, size = "1em", style, className, }) {
+    const filled = FILLED[name];
+    return (_jsx("svg", { className: cx("msc-icon", className), width: size, height: size, viewBox: "0 0 24 24", fill: filled ? "currentColor" : "none", stroke: filled ? "none" : "currentColor", strokeWidth: filled ? 0 : 1.8, strokeLinecap: "round", strokeLinejoin: "round", style: style, "aria-hidden": "true", focusable: "false", children: _jsx("path", { d: PATHS[name] }) }));
+}
+//# sourceMappingURL=shared.js.map

package/dist/components/shared.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.js","sourceRoot":"","sources":["../../src/components/shared.tsx"],"names":[],"mappings":";AAWA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAGxC,MAAM,UAAU,EAAE,CAAC,GAAG,KAA+C;IACnE,OAAO,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;IAC9B,MAAM,MAAM,GAAG,IAAI,CAAqB,IAAI,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;IACnE,OAAO,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAoBD,MAAM,KAAK,GAA6B;IACtC,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,0FAA0F;IAClG,eAAe,EAAE,cAAc;IAC/B,cAAc,EAAE,cAAc;IAC9B,IAAI,EAAE,2EAA2E;IACjF,IAAI,EAAE,kBAAkB;IACxB,KAAK,EAAE,gBAAgB;IACvB,KAAK,EAAE,sBAAsB;IAC7B,IAAI,EAAE,+BAA+B;IACrC,IAAI,EAAE,uDAAuD;IAC7D,OAAO,EAAE,iCAAiC;IAC1C,KAAK,EAAE,oDAAoD;IAC3D,OAAO,EAAE,+CAA+C;IACxD,QAAQ,EAAE,0EAA0E;IACpF,IAAI,EAAE,oDAAoD;IAC1D,IAAI,EAAE,mDAAmD;CAC1D,CAAC;AAEF,MAAM,MAAM,GAAuC,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAE9E,MAAM,UAAU,IAAI,CAAC,EACnB,IAAI,EACJ,IAAI,GAAG,KAAK,EACZ,KAAK,EACL,SAAS,GAMV;IACC,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAC5B,OAAO,CACL,cACE,SAAS,EAAE,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC,EACpC,KAAK,EAAE,IAAI,EACX,MAAM,EAAE,IAAI,EACZ,OAAO,EAAC,WAAW,EACnB,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,MAAM,EACtC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,cAAc,EACxC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAC7B,aAAa,EAAC,OAAO,EACrB,cAAc,EAAC,OAAO,EACtB,KAAK,EAAE,KAAK,iBACA,MAAM,EAClB,SAAS,EAAC,OAAO,YAEjB,eAAM,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,GAAI,GACpB,CACP,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+export type { UINode, Action, Tone, ActionResult, PlatformErrorCategory } from "./sdui/types";
+export { register, registerAll, resolve, registeredTypes, prop } from "./sdui/registry";
+export type { NodeComponent, NodeComponentProps } from "./sdui/registry";
+export { RenderNode, Children, Slot, hasSlot } from "./sdui/Renderer";
+export { defineComponent, defineComponents } from "./sdui/template";
+export type { ComponentDefinition } from "./sdui/template";
+export { ShellProvider } from "./sdui/ShellProvider";
+export type { ToastItem } from "./sdui/ShellProvider";
+export { useRuntime, ShellRuntimeContext } from "./sdui/context";
+export type { ShellRuntime, OverlayHandle } from "./sdui/context";
+export { boxToCss, textToCss } from "./sdui/style";
+export type { BoxStyle, TextStyle, ColorToken, SpaceToken, RadiusToken } from "./sdui/style";
+export { installComponents } from "./components";
+export { OverlayHost, ToastHost } from "./components/host";
+export { Icon, cx } from "./components/shared";
+export type { IconName } from "./components/shared";
+export { gql, PlatformError, setAuthToken } from "./lib/platform";
+export type { GraphQLError } from "./lib/platform";
+//# 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":"AAUA,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAG9F,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AACxF,YAAY,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAGzE,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAGtE,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACpE,YAAY,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AAG3D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,YAAY,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AACjE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACnD,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG7F,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAC/C,YAAY,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAGpD,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+// @mosaic-media/sdui-react — the React runtime for the Mosaic SDUI contract.
+// The web binding: primitives, the registry, the recursive renderer, the
+// definition expander, the runtime context/provider, the token-driven skin, and
+// the built-in component vocabulary. Consumed by the Shell app and by
+// mosaic-storybook. It is a *client implementation* (AGPL-3.0-only), distinct
+// from the technology-agnostic contract in @mosaic-media/sdui.
+//
+// Styles ship separately: import "@mosaic-media/sdui-react/styles.css".
+// Registry.
+export { register, registerAll, resolve, registeredTypes, prop } from "./sdui/registry";
+// Recursive renderer.
+export { RenderNode, Children, Slot, hasSlot } from "./sdui/Renderer";
+// Component definitions (data → components).
+export { defineComponent, defineComponents } from "./sdui/template";
+// Runtime context + provider.
+export { ShellProvider } from "./sdui/ShellProvider";
+export { useRuntime, ShellRuntimeContext } from "./sdui/context";
+// Token-based style vocabulary.
+export { boxToCss, textToCss } from "./sdui/style";
+// The built-in component vocabulary (primitives + definitions).
+export { installComponents } from "./components";
+export { OverlayHost, ToastHost } from "./components/host";
+export { Icon, cx } from "./components/shared";
+// GraphQL client used by ShellProvider to run invoke/query actions.
+export { gql, PlatformError, setAuthToken } from "./lib/platform";
+//# 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,6EAA6E;AAC7E,yEAAyE;AACzE,gFAAgF;AAChF,sEAAsE;AACtE,8EAA8E;AAC9E,+DAA+D;AAC/D,EAAE;AACF,wEAAwE;AAKxE,YAAY;AACZ,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAC;AAGxF,sBAAsB;AACtB,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAEtE,6CAA6C;AAC7C,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAGpE,8BAA8B;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGjE,gCAAgC;AAChC,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGnD,gEAAgE;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,qBAAqB,CAAC;AAG/C,oEAAoE;AACpE,OAAO,EAAE,GAAG,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/lib/platform.d.ts

@@ -0,0 +1,12 @@
+import type { PlatformErrorCategory } from "../sdui/types";
+export interface GraphQLError {
+    category: PlatformErrorCategory;
+    message: string;
+}
+export declare class PlatformError extends Error {
+    category: PlatformErrorCategory;
+    constructor(category: PlatformErrorCategory, message: string);
+}
+export declare function setAuthToken(token: string | null): void;
+export declare function gql<T = unknown>(query: string, variables?: Record<string, unknown>): Promise<T>;
+//# sourceMappingURL=platform.d.ts.map

package/dist/lib/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/lib/platform.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAI3D,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,EAAE,qBAAqB,CAAC;gBACpB,QAAQ,EAAE,qBAAqB,EAAE,OAAO,EAAE,MAAM;CAK7D;AASD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,QAEhD;AAED,wBAAsB,GAAG,CAAC,CAAC,GAAG,OAAO,EACnC,KAAK,EAAE,MAAM,EACb,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,OAAO,CAAC,CAAC,CAAC,CA4BZ"}

package/dist/lib/platform.js

@@ -0,0 +1,74 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// SPDX-FileCopyrightText: 2026 the Mosaic authors
+const ENDPOINT = "/graphql";
+export class PlatformError extends Error {
+    constructor(category, message) {
+        super(message);
+        this.category = category;
+        this.name = "PlatformError";
+    }
+}
+/** Session token, if signed in. Kept in memory for the skeleton. */
+let authToken = null;
+export function setAuthToken(token) {
+    authToken = token;
+}
+export async function gql(query, variables) {
+    let res;
+    try {
+        res = await fetch(ENDPOINT, {
+            method: "POST",
+            headers: {
+                "content-type": "application/json",
+                ...(authToken ? { authorization: `Bearer ${authToken}` } : {}),
+            },
+            body: JSON.stringify({ query, variables }),
+        });
+    }
+    catch {
+        throw new PlatformError("Unavailable", "Could not reach the Platform.");
+    }
+    if (!res.ok) {
+        throw new PlatformError(httpToCategory(res.status), `Platform returned ${res.status}.`);
+    }
+    const body = (await res.json());
+    if (body.errors?.length) {
+        const first = body.errors[0];
+        throw new PlatformError(normaliseCategory(first.extensions?.category), first.message);
+    }
+    if (body.data === undefined) {
+        throw new PlatformError("Internal", "Platform returned no data.");
+    }
+    return body.data;
+}
+function httpToCategory(status) {
+    switch (status) {
+        case 400:
+            return "InvalidArgument";
+        case 401:
+            return "Unauthenticated";
+        case 403:
+            return "PermissionDenied";
+        case 404:
+            return "NotFound";
+        case 409:
+            return "Conflict";
+        case 503:
+            return "Unavailable";
+        default:
+            return "Internal";
+    }
+}
+function normaliseCategory(raw) {
+    const known = [
+        "InvalidArgument",
+        "Unauthenticated",
+        "PermissionDenied",
+        "NotFound",
+        "Conflict",
+        "Unavailable",
+        "Internal",
+    ];
+    return known.find((c) => c === raw) ?? "Internal";
+}
+//# sourceMappingURL=platform.js.map

package/dist/lib/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/lib/platform.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,kDAAkD;AAclD,MAAM,QAAQ,GAAG,UAAU,CAAC;AAO5B,MAAM,OAAO,aAAc,SAAQ,KAAK;IAEtC,YAAY,QAA+B,EAAE,OAAe;QAC1D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAOD,oEAAoE;AACpE,IAAI,SAAS,GAAkB,IAAI,CAAC;AACpC,MAAM,UAAU,YAAY,CAAC,KAAoB;IAC/C,SAAS,GAAG,KAAK,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,KAAa,EACb,SAAmC;IAEnC,IAAI,GAAa,CAAC;IAClB,IAAI,CAAC;QACH,GAAG,GAAG,MAAM,KAAK,CAAC,QAAQ,EAAE;YAC1B,MAAM,EAAE,MAAM;YACd,OAAO,EAAE;gBACP,cAAc,EAAE,kBAAkB;gBAClC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,UAAU,SAAS,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAC/D;YACD,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC;SAC3C,CAAC,CAAC;IACL,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,aAAa,CAAC,aAAa,EAAE,+BAA+B,CAAC,CAAC;IAC1E,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;QACZ,MAAM,IAAI,aAAa,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,qBAAqB,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,CAAuB,CAAC;IACtD,IAAI,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC7B,MAAM,IAAI,aAAa,CAAC,iBAAiB,CAAC,KAAK,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IACxF,CAAC;IACD,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,aAAa,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;IACpE,CAAC;IACD,OAAO,IAAI,CAAC,IAAI,CAAC;AACnB,CAAC;AAED,SAAS,cAAc,CAAC,MAAc;IACpC,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,iBAAiB,CAAC;QAC3B,KAAK,GAAG;YACN,OAAO,iBAAiB,CAAC;QAC3B,KAAK,GAAG;YACN,OAAO,kBAAkB,CAAC;QAC5B,KAAK,GAAG;YACN,OAAO,UAAU,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,UAAU,CAAC;QACpB,KAAK,GAAG;YACN,OAAO,aAAa,CAAC;QACvB;YACE,OAAO,UAAU,CAAC;IACtB,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAY;IACrC,MAAM,KAAK,GAA4B;QACrC,iBAAiB;QACjB,iBAAiB;QACjB,kBAAkB;QAClB,UAAU;QACV,UAAU;QACV,aAAa;QACb,UAAU;KACX,CAAC;IACF,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,IAAI,UAAU,CAAC;AACpD,CAAC"}

package/dist/sdui/Renderer.d.ts

@@ -0,0 +1,16 @@
+import type { UINode } from "./types";
+export declare function RenderNode({ node }: {
+    node: UINode;
+}): import("react").JSX.Element;
+/** Render an ordered list of nodes (a component's `children`). */
+export declare function Children({ nodes }: {
+    nodes?: UINode[];
+}): import("react").JSX.Element | null;
+/** Render a named slot, which may hold one node or a list. */
+export declare function Slot({ node, name }: {
+    node: UINode;
+    name: string;
+}): import("react").JSX.Element | null;
+/** Convenience: does this node have content in a given slot? */
+export declare function hasSlot(node: UINode, name: string): boolean;
+//# sourceMappingURL=Renderer.d.ts.map

package/dist/sdui/Renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Renderer.d.ts","sourceRoot":"","sources":["../../src/sdui/Renderer.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC,wBAAgB,UAAU,CAAC,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,+BAMpD;AAED,kEAAkE;AAClE,wBAAgB,QAAQ,CAAC,EAAE,KAAK,EAAE,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,sCAWvD;AAED,8DAA8D;AAC9D,wBAAgB,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,sCAKlE;AAED,gEAAgE;AAChE,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAG3D"}

package/dist/sdui/Renderer.js

@@ -0,0 +1,40 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+// SPDX-License-Identifier: AGPL-3.0-only
+// SPDX-FileCopyrightText: 2026 the Mosaic authors
+/*
+ * The recursive renderer. Give it a UINode (or a list) and it walks the tree,
+ * resolving each node's `type` through the registry. Components pull their own
+ * children by calling <Slot> / <Children> so container components control
+ * layout, not the renderer.
+ */
+import { Fragment } from "react";
+import { resolve } from "./registry";
+import { Unknown } from "../components/feedback/Unknown";
+export function RenderNode({ node }) {
+    const Component = resolve(node.type);
+    if (!Component) {
+        return _jsx(Unknown, { type: node.type });
+    }
+    return _jsx(Component, { node: node });
+}
+/** Render an ordered list of nodes (a component's `children`). */
+export function Children({ nodes }) {
+    if (!nodes?.length)
+        return null;
+    return (_jsx(_Fragment, { children: nodes.map((child, i) => (_jsx(Fragment, { children: _jsx(RenderNode, { node: child }) }, child.id ?? i))) }));
+}
+/** Render a named slot, which may hold one node or a list. */
+export function Slot({ node, name }) {
+    const slot = node.slots?.[name];
+    if (!slot)
+        return null;
+    if (Array.isArray(slot))
+        return _jsx(Children, { nodes: slot });
+    return _jsx(RenderNode, { node: slot });
+}
+/** Convenience: does this node have content in a given slot? */
+export function hasSlot(node, name) {
+    const slot = node.slots?.[name];
+    return Array.isArray(slot) ? slot.length > 0 : Boolean(slot);
+}
+//# sourceMappingURL=Renderer.js.map

package/dist/sdui/Renderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Renderer.js","sourceRoot":"","sources":["../../src/sdui/Renderer.tsx"],"names":[],"mappings":";AAAA,yCAAyC;AACzC,kDAAkD;AAElD;;;;;GAKG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AACrC,OAAO,EAAE,OAAO,EAAE,MAAM,gCAAgC,CAAC;AAEzD,MAAM,UAAU,UAAU,CAAC,EAAE,IAAI,EAAoB;IACnD,MAAM,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrC,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,KAAC,OAAO,IAAC,IAAI,EAAE,IAAI,CAAC,IAAI,GAAI,CAAC;IACtC,CAAC;IACD,OAAO,KAAC,SAAS,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC;AACnC,CAAC;AAED,kEAAkE;AAClE,MAAM,UAAU,QAAQ,CAAC,EAAE,KAAK,EAAwB;IACtD,IAAI,CAAC,KAAK,EAAE,MAAM;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,CACL,4BACG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,CACvB,KAAC,QAAQ,cACP,KAAC,UAAU,IAAC,IAAI,EAAE,KAAK,GAAI,IADd,KAAK,CAAC,EAAE,IAAI,CAAC,CAEjB,CACZ,CAAC,GACD,CACJ,CAAC;AACJ,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAkC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IACvB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,KAAC,QAAQ,IAAC,KAAK,EAAE,IAAI,GAAI,CAAC;IAC1D,OAAO,KAAC,UAAU,IAAC,IAAI,EAAE,IAAI,GAAI,CAAC;AACpC,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,OAAO,CAAC,IAAY,EAAE,IAAY;IAChD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AAC/D,CAAC"}

package/dist/sdui/ShellProvider.d.ts

@@ -0,0 +1,24 @@
+import { type ReactNode } from "react";
+import type { Tone } from "./types";
+import { type OverlayHandle } from "./context";
+export interface ToastItem {
+    id: string;
+    message: string;
+    tone: Tone;
+}
+interface ShellProviderProps {
+    screen: string;
+    onNavigate: (screen: string, params?: Record<string, unknown>) => void;
+    onBack: () => void;
+    children: ReactNode;
+    /** Render prop for overlays/toasts so the host controls where they mount. */
+    render: (ui: {
+        overlays: OverlayHandle[];
+        toasts: ToastItem[];
+        dismissOverlay: () => void;
+        dismissToast: (id: string) => void;
+    }) => ReactNode;
+}
+export declare function ShellProvider({ screen, onNavigate, onBack, children, render }: ShellProviderProps): import("react").JSX.Element;
+export {};
+//# sourceMappingURL=ShellProvider.d.ts.map

package/dist/sdui/ShellProvider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ShellProvider.d.ts","sourceRoot":"","sources":["../../src/sdui/ShellProvider.tsx"],"names":[],"mappings":"AASA,OAAO,EAAkC,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACvE,OAAO,KAAK,EAAwB,IAAI,EAAU,MAAM,SAAS,CAAC;AAClE,OAAO,EAAuB,KAAK,aAAa,EAAE,MAAM,WAAW,CAAC;AAGpE,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;CACZ;AAED,UAAU,kBAAkB;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACvE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;IACpB,6EAA6E;IAC7E,MAAM,EAAE,CAAC,EAAE,EAAE;QAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;QAAC,MAAM,EAAE,SAAS,EAAE,CAAC;QAAC,cAAc,EAAE,MAAM,IAAI,CAAC;QAAC,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,KAAK,SAAS,CAAC;CAC/I;AAKD,wBAAgB,aAAa,CAAC,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,kBAAkB,+BAwHjG"}

package/dist/sdui/ShellProvider.js

@@ -0,0 +1,110 @@
+import { jsxs as _jsxs } from "react/jsx-runtime";
+// SPDX-License-Identifier: AGPL-3.0-only
+// SPDX-FileCopyrightText: 2026 the Mosaic authors
+/*
+ * ShellProvider wires the runtime: it owns overlay + toast state, forwards
+ * navigation to the host, and interprets every Action kind. It is the one place
+ * that talks to the network, so components stay declarative.
+ */
+import { useCallback, useMemo, useState } from "react";
+import { ShellRuntimeContext } from "./context";
+import { gql, PlatformError } from "../lib/platform";
+let seq = 0;
+const nextId = (p) => `${p}-${++seq}`;
+export function ShellProvider({ screen, onNavigate, onBack, children, render }) {
+    const [overlays, setOverlays] = useState([]);
+    const [toasts, setToasts] = useState([]);
+    const pushToast = useCallback((message, tone = "neutral") => {
+        const id = nextId("toast");
+        setToasts((t) => [...t, { id, message, tone }]);
+        // Auto-dismiss; reduced-motion users still get the removal.
+        window.setTimeout(() => setToasts((t) => t.filter((x) => x.id !== id)), 4200);
+    }, []);
+    const dismissToast = useCallback((id) => {
+        setToasts((t) => t.filter((x) => x.id !== id));
+    }, []);
+    const dismissOverlay = useCallback(() => {
+        setOverlays((o) => o.slice(0, -1));
+    }, []);
+    const dispatch = useCallback(async (action) => {
+        switch (action.kind) {
+            case "navigate":
+                onNavigate(action.screen, action.params);
+                return { ok: true };
+            case "back":
+                onBack();
+                return { ok: true };
+            case "openUrl": {
+                // Only allow http(s) — never interpret server-supplied javascript: etc.
+                try {
+                    const u = new URL(action.url);
+                    if (u.protocol === "http:" || u.protocol === "https:") {
+                        window.open(u.href, "_blank", "noopener,noreferrer");
+                        return { ok: true };
+                    }
+                }
+                catch {
+                    /* fall through */
+                }
+                pushToast("Blocked an unsafe link.", "warning");
+                return { ok: false, error: { category: "InvalidArgument", message: "Unsafe URL" } };
+            }
+            case "openOverlay": {
+                const handle = {
+                    id: nextId("overlay"),
+                    surface: action.surface ?? "modal",
+                    node: action.node,
+                };
+                setOverlays((o) => [...o, handle]);
+                return { ok: true };
+            }
+            case "closeOverlay":
+                dismissOverlay();
+                return { ok: true };
+            case "toast":
+                pushToast(action.message, action.tone ?? "neutral");
+                return { ok: true };
+            case "playPart":
+                // Playback resolution is a future module (Remote Media). For the
+                // skeleton we acknowledge the intent.
+                pushToast(`Play requested for part ${action.partId}`, "accent");
+                return { ok: true };
+            case "invoke":
+            case "query": {
+                const document = action.kind === "invoke"
+                    ? `mutation Shell($input: JSON) { ${action.mutation}(input: $input) }`
+                    : action.query;
+                const variables = action.kind === "invoke" ? { input: action.input } : action.variables;
+                try {
+                    const data = await gql(document, variables);
+                    return { ok: true, data };
+                }
+                catch (e) {
+                    const err = e instanceof PlatformError
+                        ? { category: e.category, message: e.message }
+                        : { category: "Internal", message: "Unexpected error" };
+                    pushToast(err.message, "danger");
+                    return { ok: false, error: err };
+                }
+            }
+            case "sequence": {
+                let last = { ok: true };
+                for (const a of action.actions) {
+                    last = await dispatch(a);
+                    if (!last.ok)
+                        break;
+                }
+                return last;
+            }
+            default:
+                return { ok: false, error: { category: "InvalidArgument", message: "Unknown action" } };
+        }
+    }, [onNavigate, onBack, dismissOverlay, pushToast]);
+    const emit = useCallback((action) => {
+        if (action)
+            void dispatch(action);
+    }, [dispatch]);
+    const runtime = useMemo(() => ({ dispatch, emit, screen }), [dispatch, emit, screen]);
+    return (_jsxs(ShellRuntimeContext.Provider, { value: runtime, children: [children, render({ overlays, toasts, dismissOverlay, dismissToast })] }));
+}
+//# sourceMappingURL=ShellProvider.js.map

package/dist/sdui/ShellProvider.js.map

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

package/dist/sdui/context.d.ts

@@ -0,0 +1,17 @@
+import type { Action, ActionResult, UINode } from "./types";
+export interface OverlayHandle {
+    id: string;
+    surface: "modal" | "sheet" | "drawer";
+    node: UINode;
+}
+export interface ShellRuntime {
+    /** Interpret an action envelope. Network kinds resolve asynchronously. */
+    dispatch: (action: Action) => Promise<ActionResult>;
+    /** Convenience for the very common onClick case. */
+    emit: (action?: Action) => void;
+    /** Current screen name, for highlighting nav. */
+    screen: string;
+}
+export declare const ShellRuntimeContext: import("react").Context<ShellRuntime | null>;
+export declare function useRuntime(): ShellRuntime;
+//# sourceMappingURL=context.d.ts.map

package/dist/sdui/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../src/sdui/context.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAE5D,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,YAAY;IAC3B,0EAA0E;IAC1E,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IACpD,oDAAoD;IACpD,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,eAAO,MAAM,mBAAmB,8CAA2C,CAAC;AAE5E,wBAAgB,UAAU,IAAI,YAAY,CAMzC"}

package/dist/sdui/context.js

@@ -0,0 +1,18 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// SPDX-FileCopyrightText: 2026 the Mosaic authors
+/*
+ * Runtime context handed to every rendered component: how to dispatch actions,
+ * and access to whatever ambient services the Shell provides (navigation,
+ * overlays, toasts). Components stay pure — they emit Actions, they don't reach
+ * for the network themselves.
+ */
+import { createContext, useContext } from "react";
+export const ShellRuntimeContext = createContext(null);
+export function useRuntime() {
+    const ctx = useContext(ShellRuntimeContext);
+    if (!ctx) {
+        throw new Error("useRuntime must be used within a <ShellProvider>");
+    }
+    return ctx;
+}
+//# sourceMappingURL=context.js.map

package/dist/sdui/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/sdui/context.tsx"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,kDAAkD;AAElD;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAkBlD,MAAM,CAAC,MAAM,mBAAmB,GAAG,aAAa,CAAsB,IAAI,CAAC,CAAC;AAE5E,MAAM,UAAU,UAAU;IACxB,MAAM,GAAG,GAAG,UAAU,CAAC,mBAAmB,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/sdui/registry.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentType } from "react";
+import type { UINode } from "./types";
+export interface NodeComponentProps {
+    node: UINode;
+}
+export type NodeComponent = ComponentType<NodeComponentProps>;
+export declare function register(type: string, component: NodeComponent): void;
+export declare function registerAll(entries: Record<string, NodeComponent>): void;
+export declare function resolve(type: string): NodeComponent | undefined;
+export declare function registeredTypes(): string[];
+/** Read a typed prop off a node with a fallback. Keeps components terse. */
+export declare function prop<T>(node: UINode, key: string, fallback: T): T;
+//# sourceMappingURL=registry.d.ts.map

package/dist/sdui/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/sdui/registry.tsx"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,MAAM,aAAa,GAAG,aAAa,CAAC,kBAAkB,CAAC,CAAC;AAI9D,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,aAAa,GAAG,IAAI,CAKrE;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,IAAI,CAIxE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAE/D;AAED,wBAAgB,eAAe,IAAI,MAAM,EAAE,CAE1C;AAED,4EAA4E;AAC5E,wBAAgB,IAAI,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAGjE"}

package/dist/sdui/registry.js

@@ -0,0 +1,26 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// SPDX-FileCopyrightText: 2026 the Mosaic authors
+const registry = new Map();
+export function register(type, component) {
+    if (registry.has(type)) {
+        console.warn(`[sdui] re-registering component type "${type}"`);
+    }
+    registry.set(type, component);
+}
+export function registerAll(entries) {
+    for (const [type, component] of Object.entries(entries)) {
+        register(type, component);
+    }
+}
+export function resolve(type) {
+    return registry.get(type);
+}
+export function registeredTypes() {
+    return [...registry.keys()].sort();
+}
+/** Read a typed prop off a node with a fallback. Keeps components terse. */
+export function prop(node, key, fallback) {
+    const v = node.props?.[key];
+    return (v === undefined ? fallback : v);
+}
+//# sourceMappingURL=registry.js.map

package/dist/sdui/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/sdui/registry.tsx"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,kDAAkD;AAsBlD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAyB,CAAC;AAElD,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,SAAwB;IAC7D,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACvB,OAAO,CAAC,IAAI,CAAC,yCAAyC,IAAI,GAAG,CAAC,CAAC;IACjE,CAAC;IACD,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAsC;IAChE,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACxD,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAY;IAClC,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACrC,CAAC;AAED,4EAA4E;AAC5E,MAAM,UAAU,IAAI,CAAI,IAAY,EAAE,GAAW,EAAE,QAAW;IAC5D,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IAC5B,OAAO,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAE,CAAO,CAAC,CAAC;AACjD,CAAC"}

package/dist/sdui/style.d.ts

@@ -0,0 +1,81 @@
+import type { CSSProperties } from "react";
+export type SpaceToken = 0 | 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8;
+export type RadiusToken = "sm" | "md" | "lg" | "xl" | "pill";
+export type ShadowToken = "1" | "2" | "3";
+export type TextVariant = "xs" | "sm" | "md" | "lg" | "xl" | "2xl" | "3xl";
+export type Weight = "regular" | "medium" | "bold";
+export type ColorToken = "bg" | "surface" | "surface-raised" | "surface-overlay" | "text" | "text-muted" | "text-faint" | "text-on-accent" | "accent" | "accent-hover" | "accent-quiet" | "success" | "warning" | "danger" | "info" | "success-quiet" | "warning-quiet" | "danger-quiet" | "info-quiet" | "rating" | "border" | "border-strong";
+export type Align = "start" | "center" | "end" | "stretch" | "baseline";
+export type Justify = "start" | "center" | "end" | "between" | "around";
+export type Dimension = number | "full" | "auto" | `${number}%`;
+export type GradientStop = ColorToken | "transparent";
+/** Layout + box styling for the Box primitive. All values are tokens/enums. */
+export interface BoxStyle {
+    /** Layout mode. "grid" enables the grid-* fields (Flutter: GridView). */
+    layout?: "flex" | "grid";
+    direction?: "row" | "column";
+    gap?: SpaceToken;
+    align?: Align;
+    justify?: Justify;
+    wrap?: boolean;
+    /** grid: responsive auto-fill columns of at least this width (px). */
+    gridMin?: number;
+    /** grid: flow direction — "column" makes a horizontal rail. */
+    gridFlow?: "row" | "column";
+    /** grid: fixed track size for a rail (px). */
+    gridAutoColumns?: number;
+    /** Horizontal scroll + snap, for carousels. */
+    overflowX?: "auto" | "hidden" | "visible";
+    snap?: "x" | "y";
+    snapAlign?: "start" | "center";
+    p?: SpaceToken;
+    px?: SpaceToken;
+    py?: SpaceToken;
+    pt?: SpaceToken;
+    pr?: SpaceToken;
+    pb?: SpaceToken;
+    pl?: SpaceToken;
+    bg?: ColorToken;
+    /** Linear gradient background (Flutter-portable). Overrides `bg` if both set. */
+    bgGradient?: {
+        from: GradientStop;
+        to: GradientStop;
+        angle?: number;
+    };
+    color?: ColorToken;
+    radius?: RadiusToken;
+    border?: boolean;
+    borderColor?: ColorToken;
+    width?: Dimension;
+    height?: Dimension;
+    minWidth?: Dimension;
+    maxWidth?: Dimension;
+    minHeight?: Dimension;
+    aspectRatio?: string;
+    flex?: number;
+    grow?: boolean;
+    position?: "relative" | "absolute";
+    top?: SpaceToken;
+    right?: SpaceToken;
+    bottom?: SpaceToken;
+    left?: SpaceToken;
+    overflow?: "hidden" | "auto" | "visible";
+    shadow?: ShadowToken;
+    opacity?: number;
+}
+export interface TextStyle {
+    variant?: TextVariant;
+    weight?: Weight;
+    color?: ColorToken;
+    align?: "start" | "center" | "end";
+    transform?: "uppercase" | "capitalize" | "none";
+    italic?: boolean;
+    mono?: boolean;
+    tabular?: boolean;
+    lineClamp?: number;
+}
+/** Translate a token-based BoxStyle into concrete web CSS. */
+export declare function boxToCss(s: BoxStyle): CSSProperties;
+/** Translate a token-based TextStyle into concrete web CSS. */
+export declare function textToCss(s: TextStyle): CSSProperties;
+//# sourceMappingURL=style.d.ts.map

package/dist/sdui/style.d.ts.map

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