@backbay/glia 0.2.0-alpha.1

package/dist/vision/types.d.ts

@@ -0,0 +1,72 @@
+export interface VisionSize {
+    width: number;
+    height: number;
+}
+export interface VisionCameraPose {
+    position: [number, number, number];
+    target: [number, number, number];
+    up?: [number, number, number];
+    fov?: number;
+    projectionMatrix?: number[];
+}
+export interface VisionChannel<T = unknown> {
+    id: string;
+    kind: string;
+    data: T;
+    width?: number;
+    height?: number;
+    meta?: Record<string, unknown>;
+}
+export interface VisionTopologyNode {
+    id: string;
+    type: string;
+    label?: string;
+    position?: [number, number, number];
+    radius?: number;
+    bounds?: {
+        min: [number, number, number];
+        max: [number, number, number];
+    };
+    color?: string;
+    meta?: Record<string, unknown>;
+}
+export interface VisionTopologyEdge {
+    id?: string;
+    from: string;
+    to: string;
+    type?: string;
+    color?: string;
+    weight?: number;
+    meta?: Record<string, unknown>;
+}
+export interface VisionTopology {
+    id?: string;
+    source?: string;
+    updatedAt: number;
+    nodes: VisionTopologyNode[];
+    edges?: VisionTopologyEdge[];
+    meta?: Record<string, unknown>;
+}
+export interface VisionFrame {
+    id?: string;
+    source: string;
+    capturedAt: number;
+    size?: VisionSize;
+    camera?: VisionCameraPose;
+    channels?: VisionChannel[];
+    topology?: VisionTopology;
+    meta?: Record<string, unknown>;
+}
+export interface VisionCaptureOptions {
+    size?: VisionSize;
+    includeTopology?: boolean;
+    includeCamera?: boolean;
+    signal?: AbortSignal | null;
+}
+export interface VisionAdapter {
+    id: string;
+    label?: string;
+    capture(options?: VisionCaptureOptions): Promise<VisionFrame>;
+    getTopology?: () => VisionTopology | null;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/vision/types.js

@@ -0,0 +1 @@
+export {};

package/dist/workspace/WorkspaceRenderer.d.ts

@@ -0,0 +1,34 @@
+/**
+ * WorkspaceRenderer
+ *
+ * Renders a WorkspaceSpec into a React component tree.
+ * This is the runtime that brings agent-composed UI to life.
+ */
+import React, { type ReactNode, type ComponentType } from "react";
+import type { WorkspaceSpec, ThemeOverrides, RenderContext } from "./types";
+export declare function useWorkspace(): RenderContext;
+/**
+ * Register a component for runtime use
+ */
+export declare function registerComponent(id: string, component: ComponentType<Record<string, unknown>>): void;
+export interface WorkspaceRendererProps {
+    /** Workspace specification to render */
+    spec: WorkspaceSpec;
+    /** Slot content */
+    slots?: Record<string, ReactNode>;
+    /** Event handler */
+    onEvent?: (event: string, payload?: unknown) => void;
+    /** Custom theme overrides */
+    theme?: ThemeOverrides;
+    /** Target surface */
+    surface?: string;
+    /** Additional className */
+    className?: string;
+    /** Additional styles */
+    style?: React.CSSProperties;
+}
+/**
+ * Render a WorkspaceSpec into a React component tree
+ */
+export declare function WorkspaceRenderer({ spec, slots, onEvent, theme: themeOverrides, surface, className, style, }: WorkspaceRendererProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=WorkspaceRenderer.d.ts.map

package/dist/workspace/WorkspaceRenderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WorkspaceRenderer.d.ts","sourceRoot":"","sources":["../../src/workspace/WorkspaceRenderer.tsx"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,EAMZ,KAAK,SAAS,EACd,KAAK,aAAa,EACnB,MAAM,OAAO,CAAC;AACf,OAAO,KAAK,EACV,aAAa,EAQb,cAAc,EACd,aAAa,EACd,MAAM,SAAS,CAAC;AASjB,wBAAgB,YAAY,IAAI,aAAa,CAM5C;AAUD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,MAAM,EACV,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAChD,IAAI,CAEN;AA2UD,MAAM,WAAW,sBAAsB;IACrC,wCAAwC;IACxC,IAAI,EAAE,aAAa,CAAC;IAEpB,mBAAmB;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAElC,oBAAoB;IACpB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,KAAK,IAAI,CAAC;IAErD,6BAA6B;IAC7B,KAAK,CAAC,EAAE,cAAc,CAAC;IAEvB,qBAAqB;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,2BAA2B;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,wBAAwB;IACxB,KAAK,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,EAChC,IAAI,EACJ,KAAK,EACL,OAAO,EACP,KAAK,EAAE,cAAc,EACrB,OAAmB,EACnB,SAAS,EACT,KAAK,GACN,EAAE,sBAAsB,2CAoGxB"}

package/dist/workspace/WorkspaceRenderer.js

@@ -0,0 +1,292 @@
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+/**
+ * WorkspaceRenderer
+ *
+ * Renders a WorkspaceSpec into a React component tree.
+ * This is the runtime that brings agent-composed UI to life.
+ */
+import { createContext, useContext, useMemo, useState, useCallback, } from "react";
+import { getRegistry } from "./registry/index.js";
+// ============================================================================
+// Context
+// ============================================================================
+const WorkspaceContext = createContext(null);
+export function useWorkspace() {
+    const ctx = useContext(WorkspaceContext);
+    if (!ctx) {
+        throw new Error("useWorkspace must be used within WorkspaceRenderer");
+    }
+    return ctx;
+}
+// ============================================================================
+// Component Map (runtime binding)
+// ============================================================================
+// Import actual components for rendering
+// These would be dynamically imported in production
+const componentMap = {};
+/**
+ * Register a component for runtime use
+ */
+export function registerComponent(id, component) {
+    componentMap[id] = component;
+}
+/**
+ * Get a component by ID
+ */
+function getComponent(id) {
+    return componentMap[id] || null;
+}
+/**
+ * Render a split layout
+ */
+function SplitLayoutRenderer({ node }) {
+    const { direction, sizes, children } = node;
+    const isHorizontal = direction === "horizontal";
+    return (_jsx("div", { className: "workspace-split", style: {
+            display: "flex",
+            flexDirection: isHorizontal ? "row" : "column",
+            width: "100%",
+            height: "100%",
+        }, children: children.map((child, i) => {
+            const size = sizes?.[i];
+            const style = {
+                flex: size === "fill" ? 1 : undefined,
+                width: isHorizontal && typeof size === "number" ? size : undefined,
+                height: !isHorizontal && typeof size === "number" ? size : undefined,
+            };
+            return (_jsx("div", { className: "workspace-split-panel", style: style, children: _jsx(LayoutRenderer, { node: child }) }, i));
+        }) }));
+}
+/**
+ * Render a stack layout
+ */
+function StackLayoutRenderer({ node }) {
+    const { direction, gap = 8, align = "stretch", justify = "start", wrap, children } = node;
+    const alignMap = {
+        start: "flex-start",
+        center: "center",
+        end: "flex-end",
+        stretch: "stretch",
+    };
+    const justifyMap = {
+        start: "flex-start",
+        center: "center",
+        end: "flex-end",
+        between: "space-between",
+        around: "space-around",
+    };
+    return (_jsx("div", { className: "workspace-stack", style: {
+            display: "flex",
+            flexDirection: direction === "horizontal" ? "row" : "column",
+            gap,
+            alignItems: alignMap[align],
+            justifyContent: justifyMap[justify],
+            flexWrap: wrap ? "wrap" : "nowrap",
+            width: "100%",
+            height: "100%",
+        }, children: children.map((child, i) => (_jsx("div", { className: "workspace-stack-item", children: _jsx(LayoutRenderer, { node: child }) }, i))) }));
+}
+/**
+ * Render a tabs layout
+ */
+function TabsLayoutRenderer({ node }) {
+    const { orientation = "horizontal", defaultTab, children } = node;
+    const [activeTab, setActiveTab] = useState(defaultTab || children[0]?.id);
+    const activeContent = children.find((t) => t.id === activeTab)?.content;
+    return (_jsxs("div", { className: "workspace-tabs", style: {
+            display: "flex",
+            flexDirection: orientation === "horizontal" ? "column" : "row",
+            width: "100%",
+            height: "100%",
+        }, children: [_jsx("div", { className: "workspace-tabs-list", role: "tablist", style: {
+                    display: "flex",
+                    flexDirection: orientation === "horizontal" ? "row" : "column",
+                    gap: 4,
+                    padding: 4,
+                    borderBottom: orientation === "horizontal"
+                        ? "1px solid var(--border, #333)"
+                        : undefined,
+                    borderRight: orientation === "vertical"
+                        ? "1px solid var(--border, #333)"
+                        : undefined,
+                }, children: children.map((tab) => (_jsx("button", { role: "tab", "aria-selected": activeTab === tab.id, disabled: tab.disabled, onClick: () => setActiveTab(tab.id), style: {
+                        padding: "8px 16px",
+                        background: activeTab === tab.id ? "var(--accent, #333)" : "transparent",
+                        border: "none",
+                        borderRadius: 4,
+                        color: "inherit",
+                        cursor: tab.disabled ? "not-allowed" : "pointer",
+                        opacity: tab.disabled ? 0.5 : 1,
+                    }, children: tab.label }, tab.id))) }), _jsx("div", { className: "workspace-tabs-content", role: "tabpanel", style: { flex: 1, overflow: "auto" }, children: activeContent && _jsx(LayoutRenderer, { node: activeContent }) })] }));
+}
+/**
+ * Render a grid layout
+ */
+function GridLayoutRenderer({ node }) {
+    const { columns = 1, rows, gap = 16, children } = node;
+    const gridTemplateColumns = typeof columns === "number" ? `repeat(${columns}, 1fr)` : columns;
+    const gridTemplateRows = typeof rows === "number" ? `repeat(${rows}, 1fr)` : rows;
+    const gridGap = Array.isArray(gap) ? `${gap[0]}px ${gap[1]}px` : gap;
+    return (_jsx("div", { className: "workspace-grid", style: {
+            display: "grid",
+            gridTemplateColumns,
+            gridTemplateRows: gridTemplateRows || undefined,
+            gap: gridGap,
+            width: "100%",
+            height: "100%",
+        }, children: children.map((item, i) => (_jsx("div", { className: "workspace-grid-item", style: {
+                gridColumn: item.colSpan ? `span ${item.colSpan}` : item.column,
+                gridRow: item.rowSpan ? `span ${item.rowSpan}` : item.row,
+            }, children: _jsx(LayoutRenderer, { node: item.content }) }, item.id || i))) }));
+}
+/**
+ * Render a panel (leaf node with component)
+ */
+function PanelRenderer({ node }) {
+    const { component, props = {}, children } = node;
+    const ctx = useWorkspace();
+    // Get the component from the map
+    const Component = getComponent(component);
+    // Fallback for unregistered components
+    if (!Component) {
+        const manifest = ctx.registry
+            ? ctx.registry.get(component)
+            : null;
+        return (_jsxs("div", { className: "workspace-panel workspace-panel-placeholder", style: {
+                padding: 16,
+                background: "var(--muted, #1a1a1a)",
+                borderRadius: 8,
+                border: "1px dashed var(--border, #333)",
+            }, children: [_jsxs("div", { style: { opacity: 0.7, fontSize: 12 }, children: ["Component: ", _jsx("strong", { children: component })] }), manifest && (_jsx("div", { style: { opacity: 0.5, fontSize: 11, marginTop: 4 }, children: manifest.description })), Object.keys(props).length > 0 && (_jsx("pre", { style: {
+                        marginTop: 8,
+                        fontSize: 10,
+                        opacity: 0.6,
+                        overflow: "auto",
+                    }, children: JSON.stringify(props, null, 2) }))] }));
+    }
+    // Render children if component has slots
+    const childNodes = children?.map((child, i) => (_jsx(PanelRenderer, { node: child }, i)));
+    return (_jsx("div", { className: "workspace-panel", children: _jsx(Component, { ...props, children: childNodes }) }));
+}
+/**
+ * Render a slot placeholder
+ */
+function SlotRenderer({ node }) {
+    const { slots } = useWorkspace();
+    const content = slots?.[node.name];
+    if (content) {
+        return _jsx(_Fragment, { children: content });
+    }
+    if (node.fallback) {
+        return _jsx(LayoutRenderer, { node: node.fallback });
+    }
+    return (_jsxs("div", { className: "workspace-slot workspace-slot-empty", style: {
+            padding: 16,
+            background: "var(--muted, #1a1a1a)",
+            borderRadius: 8,
+            border: "2px dashed var(--border, #333)",
+            textAlign: "center",
+            opacity: 0.5,
+        }, children: ["Slot: ", node.name] }));
+}
+/**
+ * Main layout node renderer
+ */
+function LayoutRenderer({ node }) {
+    switch (node.type) {
+        case "split":
+            return _jsx(SplitLayoutRenderer, { node: node });
+        case "stack":
+            return _jsx(StackLayoutRenderer, { node: node });
+        case "tabs":
+            return _jsx(TabsLayoutRenderer, { node: node });
+        case "grid":
+            return _jsx(GridLayoutRenderer, { node: node });
+        case "panel":
+            return _jsx(PanelRenderer, { node: node });
+        case "slot":
+            return _jsx(SlotRenderer, { node: node });
+        default:
+            return (_jsxs("div", { className: "workspace-unknown", children: ["Unknown layout type: ", node.type] }));
+    }
+}
+/**
+ * Render a WorkspaceSpec into a React component tree
+ */
+export function WorkspaceRenderer({ spec, slots, onEvent, theme: themeOverrides, surface = "desktop", className, style, }) {
+    // Merge themes
+    const theme = useMemo(() => ({ ...spec.theme, ...themeOverrides }), [spec.theme, themeOverrides]);
+    // Initialize state
+    const [state, setStateObj] = useState(spec.state?.initial || {});
+    // State updater
+    const setState = useCallback((path, value) => {
+        setStateObj((prev) => {
+            const keys = path.split(".");
+            const newState = { ...prev };
+            let current = newState;
+            for (let i = 0; i < keys.length - 1; i++) {
+                const key = keys[i];
+                current[key] = { ...current[key] };
+                current = current[key];
+            }
+            current[keys[keys.length - 1]] = value;
+            return newState;
+        });
+    }, []);
+    // Event emitter
+    const emit = useCallback((event, payload) => {
+        onEvent?.(event, payload);
+    }, [onEvent]);
+    // Build context
+    const context = useMemo(() => ({
+        registry: getRegistry(),
+        theme,
+        state,
+        setState,
+        emit,
+        slots,
+        surface,
+    }), [theme, state, setState, emit, slots, surface]);
+    // Convert theme to CSS variables
+    const cssVariables = useMemo(() => {
+        const vars = {};
+        if (theme.background)
+            vars["--workspace-bg"] = theme.background;
+        if (theme.foreground)
+            vars["--workspace-fg"] = theme.foreground;
+        if (theme.accent)
+            vars["--workspace-accent"] = theme.accent;
+        if (theme.muted)
+            vars["--workspace-muted"] = theme.muted;
+        if (theme.borderColor)
+            vars["--workspace-border"] = theme.borderColor;
+        if (theme.glowColor)
+            vars["--workspace-glow"] = theme.glowColor;
+        if (theme.spacing)
+            vars["--workspace-spacing"] = `${theme.spacing}px`;
+        if (theme.borderRadius)
+            vars["--workspace-radius"] = `${theme.borderRadius}px`;
+        if (theme.fontFamily)
+            vars["--workspace-font"] = theme.fontFamily;
+        if (theme.fontSize)
+            vars["--workspace-font-size"] = `${theme.fontSize}px`;
+        // Custom variables
+        if (theme.variables) {
+            Object.entries(theme.variables).forEach(([key, value]) => {
+                vars[key.startsWith("--") ? key : `--${key}`] = value;
+            });
+        }
+        return vars;
+    }, [theme]);
+    return (_jsx(WorkspaceContext.Provider, { value: context, children: _jsx("div", { className: `workspace-root ${className || ""}`, "data-workspace-id": spec.id, "data-workspace-surface": surface, style: {
+                width: "100%",
+                height: "100%",
+                overflow: "hidden",
+                background: "var(--workspace-bg, transparent)",
+                color: "var(--workspace-fg, inherit)",
+                fontFamily: "var(--workspace-font, inherit)",
+                fontSize: "var(--workspace-font-size, inherit)",
+                ...cssVariables,
+                ...style,
+            }, children: _jsx(LayoutRenderer, { node: spec.layout }) }) }));
+}

package/dist/workspace/componentBindings.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Component Bindings
+ *
+ * Wires up real React components to the WorkspaceRenderer.
+ * This is the bridge between component IDs in WorkspaceSpecs
+ * and actual React components.
+ */
+/**
+ * Register all components with the WorkspaceRenderer.
+ * Call this once at app initialization.
+ */
+export declare function initializeComponentBindings(): void;
+/**
+ * Synchronously initialize core components for SSR/testing.
+ * This is a fallback that imports a minimal set synchronously.
+ */
+export declare function initializeComponentBindingsSync(): void;
+/**
+ * Lazy-load Three.js components (heavy dependencies)
+ */
+export declare function loadThreeComponents(): Promise<void>;
+/**
+ * Get list of all registered component IDs
+ */
+export declare function getRegisteredComponents(): string[];
+//# sourceMappingURL=componentBindings.d.ts.map

package/dist/workspace/componentBindings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentBindings.d.ts","sourceRoot":"","sources":["../../src/workspace/componentBindings.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,IAAI,CAuMlD;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,IAAI,IAAI,CAGtD;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC,CAUzD;AAED;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,EAAE,CAyElD"}