@mmapp/react 0.1.0-alpha.18 → 0.1.0-alpha.20

package/dist/builtin-atoms-DCKrjG7i.d.mts

@@ -0,0 +1,96 @@
+import React__default from 'react';
+
+/** Minimal types for the standalone player CTR. */
+interface ComponentNode {
+    /** Component type — accepts either `type` (simple) or `component` (compiler IR) */
+    type?: string;
+    /** Alias for `type` — used by the compiler's IR experience nodes */
+    component?: string;
+    /** Props — accepts either `props` (simple) or `config` (compiler IR) */
+    props?: Record<string, unknown>;
+    /** Alias for `props` — used by the compiler's IR experience nodes */
+    config?: Record<string, unknown>;
+    /** Stable node ID (compiler IR) */
+    id?: string;
+    /** CSS class name (compiler IR) */
+    className?: string;
+    children?: ComponentNode[] | string;
+    $if?: string;
+    $for?: {
+        each: string;
+        as: string;
+        key?: string;
+    };
+}
+type ComponentTree = ComponentNode | ComponentNode[];
+interface ScopeData {
+    state_data?: Record<string, unknown>;
+    memory?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+type AtomComponent = React.ComponentType<Record<string, unknown>>;
+type AtomRegistry = Record<string, AtomComponent>;
+
+/**
+ * Standalone ComponentTreeRenderer for the dev player.
+ *
+ * Renders a JSON component tree (IR experience nodes) to React elements.
+ * Uses the minimal evaluator and accepts an AtomRegistry for component resolution.
+ */
+
+interface ComponentTreeRendererProps {
+    /** The component tree to render */
+    tree: ComponentTree;
+    /** Data scopes for expression evaluation */
+    scopes: Partial<ScopeData>;
+    /** Runtime atom registry — maps type names to React components */
+    atoms?: AtomRegistry;
+    /** Event handlers */
+    onEvent?: (eventName: string, payload?: unknown) => void;
+    /** Error boundary fallback */
+    fallback?: React__default.ReactNode;
+}
+declare const ComponentTreeRenderer: React__default.FC<ComponentTreeRendererProps>;
+
+/**
+ * DevPlayer — Development shell for previewing workflow component trees.
+ *
+ * Provides:
+ * - ComponentTreeRenderer with built-in atoms
+ * - Scope inspector panel (collapsible)
+ * - Event log
+ * - HMR integration (listens to __mm_dev WebSocket for live reload)
+ * - Error boundary with dev-friendly error display
+ */
+
+interface DevPlayerProps {
+    /** The component tree to render */
+    tree: ComponentTree;
+    /** Data scopes for expression evaluation */
+    scopes?: Partial<ScopeData>;
+    /** Additional atoms (merged with built-ins; overrides win) */
+    atoms?: AtomRegistry;
+    /** Title shown in the dev chrome */
+    title?: string;
+    /** Hide the dev toolbar (render tree only) */
+    bare?: boolean;
+    /** WebSocket URL for HMR (default: auto-detect from window.location) */
+    wsUrl?: string;
+    /** Called when the tree is reloaded via HMR */
+    onReload?: () => void;
+    /** Called on every atom event */
+    onEvent?: (eventName: string, payload?: unknown) => void;
+}
+declare const DevPlayer: React__default.FC<DevPlayerProps>;
+
+/**
+ * Built-in atom components for the standalone player.
+ *
+ * These are minimal HTML-based implementations of the core layout and
+ * display atoms. Projects can override any of these via the AtomRegistry.
+ */
+
+declare const builtinAtoms: AtomRegistry;
+
+export { type AtomComponent as A, ComponentTreeRenderer as C, DevPlayer as D, type ScopeData as S, type ComponentTreeRendererProps as a, type DevPlayerProps as b, builtinAtoms as c, type ComponentNode as d, type ComponentTree as e, type AtomRegistry as f };

package/dist/builtin-atoms-DCKrjG7i.d.ts

@@ -0,0 +1,96 @@
+import React__default from 'react';
+
+/** Minimal types for the standalone player CTR. */
+interface ComponentNode {
+    /** Component type — accepts either `type` (simple) or `component` (compiler IR) */
+    type?: string;
+    /** Alias for `type` — used by the compiler's IR experience nodes */
+    component?: string;
+    /** Props — accepts either `props` (simple) or `config` (compiler IR) */
+    props?: Record<string, unknown>;
+    /** Alias for `props` — used by the compiler's IR experience nodes */
+    config?: Record<string, unknown>;
+    /** Stable node ID (compiler IR) */
+    id?: string;
+    /** CSS class name (compiler IR) */
+    className?: string;
+    children?: ComponentNode[] | string;
+    $if?: string;
+    $for?: {
+        each: string;
+        as: string;
+        key?: string;
+    };
+}
+type ComponentTree = ComponentNode | ComponentNode[];
+interface ScopeData {
+    state_data?: Record<string, unknown>;
+    memory?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+type AtomComponent = React.ComponentType<Record<string, unknown>>;
+type AtomRegistry = Record<string, AtomComponent>;
+
+/**
+ * Standalone ComponentTreeRenderer for the dev player.
+ *
+ * Renders a JSON component tree (IR experience nodes) to React elements.
+ * Uses the minimal evaluator and accepts an AtomRegistry for component resolution.
+ */
+
+interface ComponentTreeRendererProps {
+    /** The component tree to render */
+    tree: ComponentTree;
+    /** Data scopes for expression evaluation */
+    scopes: Partial<ScopeData>;
+    /** Runtime atom registry — maps type names to React components */
+    atoms?: AtomRegistry;
+    /** Event handlers */
+    onEvent?: (eventName: string, payload?: unknown) => void;
+    /** Error boundary fallback */
+    fallback?: React__default.ReactNode;
+}
+declare const ComponentTreeRenderer: React__default.FC<ComponentTreeRendererProps>;
+
+/**
+ * DevPlayer — Development shell for previewing workflow component trees.
+ *
+ * Provides:
+ * - ComponentTreeRenderer with built-in atoms
+ * - Scope inspector panel (collapsible)
+ * - Event log
+ * - HMR integration (listens to __mm_dev WebSocket for live reload)
+ * - Error boundary with dev-friendly error display
+ */
+
+interface DevPlayerProps {
+    /** The component tree to render */
+    tree: ComponentTree;
+    /** Data scopes for expression evaluation */
+    scopes?: Partial<ScopeData>;
+    /** Additional atoms (merged with built-ins; overrides win) */
+    atoms?: AtomRegistry;
+    /** Title shown in the dev chrome */
+    title?: string;
+    /** Hide the dev toolbar (render tree only) */
+    bare?: boolean;
+    /** WebSocket URL for HMR (default: auto-detect from window.location) */
+    wsUrl?: string;
+    /** Called when the tree is reloaded via HMR */
+    onReload?: () => void;
+    /** Called on every atom event */
+    onEvent?: (eventName: string, payload?: unknown) => void;
+}
+declare const DevPlayer: React__default.FC<DevPlayerProps>;
+
+/**
+ * Built-in atom components for the standalone player.
+ *
+ * These are minimal HTML-based implementations of the core layout and
+ * display atoms. Projects can override any of these via the AtomRegistry.
+ */
+
+declare const builtinAtoms: AtomRegistry;
+
+export { type AtomComponent as A, ComponentTreeRenderer as C, DevPlayer as D, type ScopeData as S, type ComponentTreeRendererProps as a, type DevPlayerProps as b, builtinAtoms as c, type ComponentNode as d, type ComponentTree as e, type AtomRegistry as f };