@mosaic-media/sdui-react 0.1.0

package/dist/sdui/style.js

@@ -0,0 +1,149 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// SPDX-FileCopyrightText: 2026 the Mosaic authors
+const ALIGN = {
+    start: "flex-start",
+    center: "center",
+    end: "flex-end",
+    stretch: "stretch",
+    baseline: "baseline",
+};
+const JUSTIFY = {
+    start: "flex-start",
+    center: "center",
+    end: "flex-end",
+    between: "space-between",
+    around: "space-around",
+};
+const color = (c) => (c ? `var(--color-${c})` : undefined);
+const space = (n) => (n === undefined ? undefined : n === 0 ? "0" : `var(--space-${n})`);
+const dim = (d) => {
+    if (d === undefined)
+        return undefined;
+    if (d === "full")
+        return "100%";
+    if (typeof d === "number")
+        return `${d}px`;
+    return d; // "auto" | "NN%"
+};
+/** Translate a token-based BoxStyle into concrete web CSS. */
+export function boxToCss(s) {
+    const css = { boxSizing: "border-box" };
+    if (s.layout === "grid") {
+        css.display = "grid";
+        if (s.gridMin !== undefined)
+            css.gridTemplateColumns = `repeat(auto-fill, minmax(${s.gridMin}px, 1fr))`;
+        if (s.gridFlow)
+            css.gridAutoFlow = s.gridFlow;
+        if (s.gridAutoColumns !== undefined)
+            css.gridAutoColumns = `${s.gridAutoColumns}px`;
+    }
+    else {
+        css.display = "flex";
+        css.flexDirection = s.direction === "row" ? "row" : "column";
+        if (s.align)
+            css.alignItems = ALIGN[s.align];
+        if (s.justify)
+            css.justifyContent = JUSTIFY[s.justify];
+        if (s.wrap)
+            css.flexWrap = "wrap";
+    }
+    if (s.gap !== undefined)
+        css.gap = space(s.gap);
+    if (s.overflowX)
+        css.overflowX = s.overflowX;
+    if (s.snap)
+        css.scrollSnapType = `${s.snap} proximity`;
+    if (s.snapAlign)
+        css.scrollSnapAlign = s.snapAlign;
+    if (s.p !== undefined)
+        css.padding = space(s.p);
+    if (s.px !== undefined) {
+        css.paddingLeft = space(s.px);
+        css.paddingRight = space(s.px);
+    }
+    if (s.py !== undefined) {
+        css.paddingTop = space(s.py);
+        css.paddingBottom = space(s.py);
+    }
+    if (s.pt !== undefined)
+        css.paddingTop = space(s.pt);
+    if (s.pr !== undefined)
+        css.paddingRight = space(s.pr);
+    if (s.pb !== undefined)
+        css.paddingBottom = space(s.pb);
+    if (s.pl !== undefined)
+        css.paddingLeft = space(s.pl);
+    if (s.bg)
+        css.background = color(s.bg);
+    if (s.bgGradient) {
+        const stop = (c) => (c === "transparent" ? "transparent" : `var(--color-${c})`);
+        css.background = `linear-gradient(${s.bgGradient.angle ?? 180}deg, ${stop(s.bgGradient.from)}, ${stop(s.bgGradient.to)})`;
+    }
+    if (s.color)
+        css.color = color(s.color);
+    if (s.radius)
+        css.borderRadius = `var(--radius-${s.radius})`;
+    if (s.border)
+        css.border = `1px solid ${color(s.borderColor ?? "border")}`;
+    if (s.width !== undefined)
+        css.width = dim(s.width);
+    if (s.height !== undefined)
+        css.height = dim(s.height);
+    if (s.minWidth !== undefined)
+        css.minWidth = dim(s.minWidth);
+    if (s.maxWidth !== undefined)
+        css.maxWidth = dim(s.maxWidth);
+    if (s.minHeight !== undefined)
+        css.minHeight = dim(s.minHeight);
+    if (s.aspectRatio)
+        css.aspectRatio = s.aspectRatio;
+    if (s.flex !== undefined)
+        css.flex = s.flex;
+    if (s.grow)
+        css.flexGrow = 1;
+    if (s.position)
+        css.position = s.position;
+    if (s.top !== undefined)
+        css.top = space(s.top);
+    if (s.right !== undefined)
+        css.right = space(s.right);
+    if (s.bottom !== undefined)
+        css.bottom = space(s.bottom);
+    if (s.left !== undefined)
+        css.left = space(s.left);
+    if (s.overflow)
+        css.overflow = s.overflow;
+    if (s.shadow)
+        css.boxShadow = `var(--shadow-${s.shadow})`;
+    if (s.opacity !== undefined)
+        css.opacity = s.opacity;
+    return css;
+}
+/** Translate a token-based TextStyle into concrete web CSS. */
+export function textToCss(s) {
+    const css = {};
+    if (s.variant)
+        css.fontSize = `var(--text-${s.variant})`;
+    if (s.weight)
+        css.fontWeight = `var(--weight-${s.weight})`;
+    if (s.color)
+        css.color = color(s.color);
+    if (s.align)
+        css.textAlign = s.align === "start" ? "left" : s.align === "end" ? "right" : "center";
+    if (s.transform)
+        css.textTransform = s.transform;
+    if (s.italic)
+        css.fontStyle = "italic";
+    if (s.mono)
+        css.fontFamily = "var(--font-mono)";
+    if (s.tabular)
+        css.fontVariantNumeric = "tabular-nums";
+    if (s.lineClamp) {
+        css.display = "-webkit-box";
+        css.WebkitLineClamp = s.lineClamp;
+        css.WebkitBoxOrient = "vertical";
+        css.overflow = "hidden";
+    }
+    return css;
+}
+//# sourceMappingURL=style.js.map

package/dist/sdui/style.js.map

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

package/dist/sdui/template.d.ts

@@ -0,0 +1,19 @@
+import type { UINode } from "./types";
+export interface ComponentDefinition {
+    /** The node type this definition provides, e.g. "StatChip". */
+    name: string;
+    /** Default param values, overridden by the caller's props. */
+    params?: Record<string, unknown>;
+    /** The primitive tree, with $bind / $if / Outlet markers. */
+    template: UINode;
+}
+/**
+ * Register a component definition as a renderable node type. Calling this is
+ * exactly what a module does to contribute a component — here it happens in TS,
+ * but the same `ComponentDefinition` could arrive as JSON in a payload and be
+ * registered at runtime.
+ */
+export declare function defineComponent(def: ComponentDefinition): void;
+/** Register many definitions at once (e.g. a module's whole component pack). */
+export declare function defineComponents(defs: ComponentDefinition[]): void;
+//# sourceMappingURL=template.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"template.d.ts","sourceRoot":"","sources":["../../src/sdui/template.tsx"],"names":[],"mappings":"AA0BA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAItC,MAAM,WAAW,mBAAmB;IAClC,+DAA+D;IAC/D,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;CAClB;AAyFD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,mBAAmB,GAAG,IAAI,CAmB9D;AAED,gFAAgF;AAChF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,mBAAmB,EAAE,GAAG,IAAI,CAElE"}

package/dist/sdui/template.js

@@ -0,0 +1,111 @@
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+import { register } from "./registry";
+import { RenderNode } from "./Renderer";
+function isObj(v) {
+    return typeof v === "object" && v !== null;
+}
+function isBind(v) {
+    return isObj(v) && "$bind" in v;
+}
+function isMatch(v) {
+    return isObj(v) && "$match" in v;
+}
+/** Walk a dot path ("s.label") through args/objects. */
+function getPath(root, path) {
+    return path.split(".").reduce((acc, key) => (isObj(acc) ? acc[key] : undefined), root);
+}
+/** Resolve a template value against args: bindings, matches, nested structures. */
+function resolveValue(v, args) {
+    if (isBind(v))
+        return getPath(args, v.$bind);
+    if (isMatch(v)) {
+        const key = String(resolveValue(v.$match.on, args));
+        const chosen = key in v.$match.cases ? v.$match.cases[key] : v.$match.default;
+        return resolveValue(chosen, args);
+    }
+    if (Array.isArray(v))
+        return v.map((x) => resolveValue(x, args));
+    if (isObj(v)) {
+        const out = {};
+        for (const [k, val] of Object.entries(v))
+            out[k] = resolveValue(val, args);
+        return out;
+    }
+    return v;
+}
+/** Expand one template node into zero or more concrete nodes. */
+function expandNode(tmpl, args, host) {
+    // Outlet → whatever the caller passed as children / a named slot.
+    if (tmpl.type === "Outlet") {
+        const name = tmpl.props?.name;
+        if (name) {
+            const slot = host.slots?.[name];
+            if (!slot)
+                return [];
+            return Array.isArray(slot) ? slot : [slot];
+        }
+        return host.children ?? [];
+    }
+    const rawProps = tmpl.props ?? {};
+    // $each — repeat this node once per item of a bound array, exposing the item
+    // (and its index) under $as. The repeated node is expanded without $each.
+    if ("$each" in rawProps) {
+        const arr = resolveValue(rawProps.$each, args);
+        if (!Array.isArray(arr))
+            return [];
+        const as = rawProps.$as ?? "item";
+        const rest = {};
+        for (const [k, val] of Object.entries(rawProps)) {
+            if (k !== "$each" && k !== "$as")
+                rest[k] = val;
+        }
+        const bare = { type: tmpl.type, id: tmpl.id, props: rest, children: tmpl.children, slots: tmpl.slots };
+        return arr.flatMap((item, i) => expandNode(bare, { ...args, [as]: item, [`${as}Index`]: i }, host));
+    }
+    // $if / $ifNot guards — drop the node (and its subtree) conditionally.
+    if ("$if" in rawProps && !resolveValue(rawProps.$if, args))
+        return [];
+    if ("$ifNot" in rawProps && resolveValue(rawProps.$ifNot, args))
+        return [];
+    const props = {};
+    for (const [k, val] of Object.entries(rawProps)) {
+        if (k === "$if" || k === "$ifNot")
+            continue;
+        props[k] = resolveValue(val, args);
+    }
+    const children = tmpl.children?.flatMap((c) => expandNode(c, args, host));
+    let slots;
+    if (tmpl.slots) {
+        slots = {};
+        for (const [k, val] of Object.entries(tmpl.slots)) {
+            const arr = Array.isArray(val) ? val : [val];
+            slots[k] = arr.flatMap((c) => expandNode(c, args, host));
+        }
+    }
+    return [{ type: tmpl.type, id: tmpl.id, props, children, slots }];
+}
+/**
+ * Register a component definition as a renderable node type. Calling this is
+ * exactly what a module does to contribute a component — here it happens in TS,
+ * but the same `ComponentDefinition` could arrive as JSON in a payload and be
+ * registered at runtime.
+ */
+export function defineComponent(def) {
+    register(def.name, ({ node }) => {
+        const args = {
+            ...(def.params ?? {}),
+            ...(node.props ?? {}),
+            // Injected: lets a template branch on what the caller handed it, e.g.
+            // $if: { $bind: "$childCount" } for an empty-vs-populated rail.
+            $childCount: node.children?.length ?? 0,
+            $slots: node.slots ? Object.keys(node.slots) : [],
+        };
+        const expanded = expandNode(def.template, args, node);
+        return (_jsx(_Fragment, { children: expanded.map((n, i) => (_jsx(RenderNode, { node: n }, n.id ?? i))) }));
+    });
+}
+/** Register many definitions at once (e.g. a module's whole component pack). */
+export function defineComponents(defs) {
+    defs.forEach(defineComponent);
+}
+//# sourceMappingURL=template.js.map

package/dist/sdui/template.js.map

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

package/dist/sdui/types.d.ts

@@ -0,0 +1,96 @@
+/** A single node in a server-driven UI tree. */
+export interface UINode {
+    /** Component discriminator, e.g. "PosterCard". Open vocabulary. */
+    type: string;
+    /** Stable id — useful as a React key and for targeted updates. */
+    id?: string;
+    /** Component-specific data. Each component documents the props it reads. */
+    props?: Record<string, unknown>;
+    /** Ordered child nodes (the common case: containers). */
+    children?: UINode[];
+    /**
+     * Named slots for components that take structured regions rather than a
+     * single ordered list, e.g. a HeroBanner's `background` vs `actions`.
+     */
+    slots?: Record<string, UINode | UINode[]>;
+}
+/**
+ * A serialisable behaviour envelope. The Shell interprets each kind; the server
+ * only ever emits data. Add kinds as the surface grows — keep them declarative.
+ */
+export type Action = 
+/** Push another server-defined screen by name (+ params for the query). */
+{
+    kind: "navigate";
+    screen: string;
+    params?: Record<string, unknown>;
+}
+/** Go back in the Shell's navigation stack. */
+ | {
+    kind: "back";
+}
+/** Open an external URL in a new tab (validated by the Shell). */
+ | {
+    kind: "openUrl";
+    url: string;
+}
+/**
+ * Invoke a Platform GraphQL mutation by name with an input map, e.g.
+ * "importContent". The Shell resolves the caller/session; the server
+ * re-authorises (ADR 0017).
+ */
+ | {
+    kind: "invoke";
+    mutation: string;
+    input?: Record<string, unknown>;
+}
+/** Run a Platform query and (optionally) refresh a region with the result. */
+ | {
+    kind: "query";
+    query: string;
+    variables?: Record<string, unknown>;
+    into?: string;
+}
+/** Present a node as an overlay (modal / sheet / drawer). */
+ | {
+    kind: "openOverlay";
+    surface?: "modal" | "sheet" | "drawer";
+    node: UINode;
+}
+/** Dismiss the topmost overlay. */
+ | {
+    kind: "closeOverlay";
+}
+/** Ask the Shell to resolve & play a content Part (future playback module). */
+ | {
+    kind: "playPart";
+    partId: string;
+    nodeId?: string;
+}
+/** Show a transient toast. */
+ | {
+    kind: "toast";
+    message: string;
+    tone?: Tone;
+}
+/** Run several actions in order. */
+ | {
+    kind: "sequence";
+    actions: Action[];
+};
+export type Tone = "neutral" | "accent" | "success" | "warning" | "danger" | "info";
+/** Result of dispatching an action, so callers can await network kinds. */
+export interface ActionResult {
+    ok: boolean;
+    data?: unknown;
+    error?: {
+        category: PlatformErrorCategory;
+        message: string;
+    };
+}
+/**
+ * The Platform's fixed error categories (from CLAUDE.md / the contracts). The
+ * Shell maps every failure into one of these so feedback UI is uniform.
+ */
+export type PlatformErrorCategory = "InvalidArgument" | "Unauthenticated" | "PermissionDenied" | "NotFound" | "Conflict" | "Unavailable" | "Internal";
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/sdui/types.ts"],"names":[],"mappings":"AAmBA,gDAAgD;AAChD,MAAM,WAAW,MAAM;IACrB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,4EAA4E;IAC5E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,yDAAyD;IACzD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,MAAM,MAAM;AAChB,2EAA2E;AACzE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AACxE,+CAA+C;GAC7C;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB,kEAAkE;GAChE;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE;AAClC;;;;GAIG;GACD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;AACvE,8EAA8E;GAC5E;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE;AACtF,6DAA6D;GAC3D;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC/E,mCAAmC;GACjC;IAAE,IAAI,EAAE,cAAc,CAAA;CAAE;AAC1B,+EAA+E;GAC7E;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE;AACvD,8BAA8B;GAC5B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,IAAI,CAAA;CAAE;AACjD,oCAAoC;GAClC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAE5C,MAAM,MAAM,IAAI,GAAG,SAAS,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAEpF,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,OAAO,CAAC;IACZ,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE;QAAE,QAAQ,EAAE,qBAAqB,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9D;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,iBAAiB,GACjB,kBAAkB,GAClB,UAAU,GACV,UAAU,GACV,aAAa,GACb,UAAU,CAAC"}

package/dist/sdui/types.js

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// SPDX-FileCopyrightText: 2026 the Mosaic authors
+export {};
+//# sourceMappingURL=types.js.map

package/dist/sdui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sdui/types.ts"],"names":[],"mappings":"AAAA,yCAAyC;AACzC,kDAAkD"}