@fluojs/studio 1.0.4 → 1.0.6

package/dist/assets/index-ort96Zw9.css

@@ -0,0 +1 @@
+:root{color-scheme:dark;font-family:Inter,ui-sans-serif,system-ui,-apple-system,BlinkMacSystemFont,Segoe UI,sans-serif;background:#070b16;color:#e5e7eb}*{box-sizing:border-box}body{min-height:100vh;margin:0;background:radial-gradient(circle at top left,rgba(59,130,246,.22),transparent 34rem),radial-gradient(circle at 80% 10%,rgba(14,165,233,.16),transparent 28rem),linear-gradient(180deg,#07101f,#0b1020 55%,#070b16);color:#e5e7eb}button,input{font:inherit}main{width:min(1480px,calc(100vw - 32px));margin:0 auto;padding:28px 0 48px}h1,h2,h3,h4,p{margin-top:0}h1{margin-bottom:12px;font-size:clamp(34px,5vw,68px);letter-spacing:-.065em;line-height:.95}h2{margin-bottom:10px;font-size:22px;letter-spacing:-.03em}h3{margin-bottom:8px}p{line-height:1.65}code{border:1px solid rgba(148,163,184,.26);border-radius:8px;background:#0f172ad1;color:#bfdbfe;padding:2px 7px}.studio-hero{display:grid;grid-template-columns:minmax(0,1fr) auto;gap:24px;align-items:end;margin-bottom:18px;border:1px solid rgba(147,197,253,.2);border-radius:28px;background:linear-gradient(135deg,#0f172ac2,#1e293b94);box-shadow:0 28px 90px #00000047;padding:32px}.studio-hero p{max-width:820px;color:#b6c4d8}.hero-command{border:1px solid rgba(96,165,250,.42);border-radius:18px;background:#0f172ae6;box-shadow:inset 0 1px #ffffff0d;padding:14px 18px;white-space:nowrap}.card{border:1px solid rgba(148,163,184,.2);border-radius:22px;background:linear-gradient(180deg,#0f172ae0,#111827d1);box-shadow:0 20px 80px #00000038;padding:18px;margin-bottom:16px}.section-title-row{display:flex;gap:16px;align-items:flex-start;justify-content:space-between}.eyebrow{margin:0 0 6px;color:#93c5fd;font-size:12px;font-weight:800;letter-spacing:.12em;text-transform:uppercase}.mode-badge,.status-pill,.chip{display:inline-flex;align-items:center;border:1px solid rgba(148,163,184,.24);border-radius:999px;background:#0f172ab8;color:#cbd5e1;padding:5px 10px;font-size:12px;line-height:1.2}.mode-badge{color:#bfdbfe}.status-pill-success{border-color:#22c55e5c;color:#bbf7d0}.status-pill-warning{border-color:#f59e0b6b;color:#fde68a}.status-pill-danger{border-color:#f871716b;color:#fecaca}.status-pill-accent{border-color:#60a5fa6b;color:#bfdbfe}.status-pill-muted{color:#94a3b8}.chips{display:flex;flex-wrap:wrap;gap:7px;margin-bottom:10px}.muted{color:#94a3b8}.notice{margin:12px 0 0;color:#93c5fd}.actions{display:flex;flex-wrap:wrap;gap:8px;margin-top:12px}button{border:1px solid rgba(96,165,250,.32);border-radius:12px;background:linear-gradient(180deg,#2563eb,#1d4ed8);color:#fff;cursor:pointer;padding:9px 13px}button:disabled{border-color:#64748b47;background:#475569;cursor:not-allowed}button:hover:not(:disabled),button:focus-visible:not(:disabled){border-color:#93c5fdcc;outline:none;transform:translateY(-1px)}label{display:block;margin-bottom:10px}input[type=text]{width:100%;margin-top:6px;border:1px solid rgba(148,163,184,.28);border-radius:12px;background:#0f172ad1;color:#e5e7eb;padding:10px 12px}input[type=file]{width:100%;border:1px dashed rgba(148,163,184,.36);border-radius:14px;padding:16px}.filter-row{display:flex;flex-wrap:wrap;align-items:center;gap:8px 12px;margin-bottom:10px}.filter-row span{color:#cbd5e1;font-weight:700}.uploader.drag-active{border-color:#60a5fa;box-shadow:0 0 0 2px #60a5fa59 inset}.live-connection{position:relative;overflow:hidden}.live-connection:before{position:absolute;top:0;right:0;bottom:0;left:0;background:radial-gradient(circle at 0% 0%,rgba(34,211,238,.14),transparent 26rem);content:"";pointer-events:none}.live-status-main{position:relative;display:flex;gap:18px;align-items:flex-start;justify-content:space-between}.connection-orb-wrap{display:grid;gap:8px;justify-items:center;min-width:120px;text-transform:uppercase}.connection-orb{display:block;width:22px;height:22px;border-radius:999px;background:#64748b;box-shadow:0 0 30px #64748bcc}.connection-connected .connection-orb{background:#22c55e;box-shadow:0 0 35px #22c55ec7}.connection-connecting .connection-orb,.connection-reconnecting .connection-orb,.connection-restarting .connection-orb{background:#f59e0b;box-shadow:0 0 35px #f59e0bcc}.connection-stale .connection-orb,.connection-error .connection-orb,.connection-disconnected .connection-orb{background:#ef4444;box-shadow:0 0 35px #ef4444c7}.dashboard-grid{display:grid;grid-template-columns:minmax(0,1.25fr) minmax(360px,.75fr);gap:16px;align-items:start}.live-graph-card,.timing-card,.live-diagnostics-card{grid-column:1 / -1}.live-graph-layout,.routes-layout,.request-layout{display:grid;grid-template-columns:minmax(0,1fr) minmax(280px,.34fr);gap:16px}.live-graph-canvas,#graph-host{overflow:auto;min-height:320px;border:1px solid rgba(148,163,184,.18);border-radius:18px;background:#020617ad}.live-graph-canvas svg,#graph-host svg{min-width:780px;width:100%}.live-edge{stroke:#64748b99;stroke-width:1.4}.live-edge-highlighted{stroke:#f59e0b;stroke-width:2.4}.live-edge-arrow{fill:#64748b}.live-edge-label{fill:#fde68a;font-size:11px;paint-order:stroke;stroke:#020617;stroke-width:3px}.live-node rect{fill:#1e293bf5;stroke:#94a3b873;stroke-width:1.2}.live-node text{fill:#e5e7eb;font-size:11px;text-anchor:middle;pointer-events:none}.live-node .live-node-kind{fill:#94a3b8;font-size:10px}.live-node-module rect,.live-node-active rect{fill:#1e40afeb}.live-node-provider rect{fill:#14532de0}.live-node-controller rect{fill:#5b21b6e0}.live-node-route rect{fill:#0c4a6ee0}.live-node-external rect,.live-node-platform rect{fill:#475569e0}.live-node-selected rect{stroke:#fbbf24;stroke-width:3}.live-node-related rect{stroke:#38bdf8;stroke-width:2.2}.live-graph-details,.route-detail,.request-detail{border:1px solid rgba(148,163,184,.18);border-radius:18px;background:#0f172aa8;padding:14px}.edge-list,.route-list,.request-timeline{display:grid;gap:8px}.edge-row,.route-row,.request-row,.connection-button{display:grid;width:100%;gap:4px;border-color:#94a3b82e;background:#0f172adb;color:#e5e7eb;text-align:left}.edge-row span,.route-row small,.request-row small,.connection-button small{color:#94a3b8}.route-row-selected,.request-row-selected{border-color:#60a5fa;box-shadow:0 0 0 1px #60a5fa3d inset}.method{width:fit-content;border-radius:999px;background:#60a5fa29;color:#bfdbfe;padding:3px 7px;font-size:11px;font-weight:800}.request-row-danger{border-color:#f871716b}.request-row-success{border-color:#22c55e52}.request-row-accent{border-color:#60a5fa5c}.timing-grid{display:grid;gap:16px;grid-template-columns:repeat(auto-fit,minmax(320px,1fr))}.timing-total{display:flex;align-items:baseline;justify-content:space-between;margin-bottom:10px;border:1px solid rgba(148,163,184,.18);border-radius:14px;background:#0f172aa8;padding:10px 12px}table{width:100%;border-collapse:collapse}th,td{border-bottom:1px solid rgba(148,163,184,.18);text-align:left;font-size:13px;padding:8px 6px}pre{overflow:auto;max-height:340px;border:1px solid rgba(148,163,184,.18);border-radius:14px;background:#020617b8;padding:14px}.split-grid,.section-pair{display:grid;gap:16px;grid-template-columns:repeat(auto-fit,minmax(320px,1fr))}.empty-state{display:grid;gap:4px;place-items:start;border:1px dashed rgba(148,163,184,.32);border-radius:16px;color:#94a3b8;padding:18px}.empty-state strong{color:#e5e7eb}.edge-line{stroke:#64748b;stroke-width:1.6}.edge-selected{stroke:#f59e0b;stroke-width:2.6}.edge-arrow{fill:#64748b}.module-node{fill:#1e293b;stroke:#64748b;stroke-width:1.5;cursor:pointer}.module-node:focus-visible{outline:none;stroke:#60a5fa;stroke-width:3}.module-root{stroke:#3b82f6;stroke-width:2.6}.component-ready{fill:#14532d}.component-degraded{fill:#7c2d12}.component-not-ready{fill:#7f1d1d}.component-external{fill:#312e81;cursor:default}.module-selected{stroke:#f59e0b;stroke-width:3}.module-neighbor{stroke:#38bdf8;stroke-width:2.6}.module-dependent{stroke:#a78bfa;stroke-width:2.6}.module-label{fill:#e5e7eb;font-size:11px;pointer-events:none}.diagnostics-list{display:grid;gap:12px}.issue{margin-bottom:0}.issue.severity-error,.inline-diagnostic.severity-error{border-color:#ef4444}.issue.severity-warning{border-color:#f59e0b}.issue.severity-info{border-color:#3b82f6}.inline-diagnostic{border:1px solid rgba(248,113,113,.38);border-radius:14px;background:#7f1d1d3d;padding:12px}a{color:#93c5fd}.inspector-card{background:linear-gradient(135deg,#0f172af5,#111827eb)}.connection-hero{display:flex;flex-wrap:wrap;gap:16px;align-items:flex-start;justify-content:space-between;border:1px solid rgba(148,163,184,.2);border-radius:16px;background:#0f172ad1;padding:14px;margin-bottom:14px}.connection-metrics{display:flex;flex-wrap:wrap;gap:8px}.connection-metrics span,.connection-pill{border:1px solid rgba(148,163,184,.24);border-radius:999px;background:#111827e0;color:#cbd5e1;padding:6px 10px;font-size:12px}.connection-grid{display:grid;gap:14px;grid-template-columns:repeat(auto-fit,minmax(240px,1fr))}.connection-group h4{margin:0 0 8px}.connection-button:hover,.connection-button:focus-visible{border-color:#60a5fa;outline:none}.connection-button span,.connection-button small{display:block}.external-pill{display:inline-block;margin:0 6px 6px 0}.connection-diagnostic{border-left:3px solid #64748b;padding:8px 0 8px 10px;margin-bottom:8px}.connection-diagnostic.severity-error{border-left-color:#ef4444}.connection-diagnostic.severity-warning{border-left-color:#f59e0b}.connection-diagnostic.severity-info{border-left-color:#3b82f6}.connection-diagnostic span{display:block;color:#94a3b8;font-size:12px;margin-top:2px}.connection-diagnostic p{margin:6px 0 0}@media(max-width:960px){main{width:min(100vw - 20px,920px);padding-top:14px}.studio-hero,.dashboard-grid,.live-graph-layout,.routes-layout,.request-layout{grid-template-columns:1fr}.hero-command{width:fit-content}}

package/dist/contracts.d.ts

@@ -38,6 +38,126 @@ export interface StudioPayload {
     snapshot?: PlatformShellSnapshot;
     timing?: BootstrapTimingDiagnostics;
 }
+/** Live Studio graph node kinds emitted by runtime-connected devtools. */
+export type StudioGraphNodeKind = 'module' | 'provider' | 'controller' | 'route' | 'platform' | 'external';
+/** Live Studio graph edge kinds emitted by runtime-connected devtools. */
+export type StudioGraphEdgeKind = 'imports' | 'owns_provider' | 'owns_controller' | 'exposes_route' | 'depends_on' | 'exports';
+/** Serializable node in the runtime-connected Studio dependency graph. */
+export interface StudioGraphNode {
+    id: string;
+    kind: StudioGraphNodeKind;
+    label: string;
+    metadata?: Record<string, unknown>;
+    status?: 'active' | 'idle' | 'warning' | 'error';
+}
+/** Serializable edge in the runtime-connected Studio dependency graph. */
+export interface StudioGraphEdge {
+    from: string;
+    id: string;
+    kind: StudioGraphEdgeKind;
+    label?: string;
+    metadata?: Record<string, unknown>;
+    to: string;
+}
+/** Route descriptor projected into the live Studio UI. */
+export interface StudioRouteDescriptor {
+    controller: string;
+    handler: string;
+    id: string;
+    method: string;
+    module?: string;
+    path: string;
+    version?: string;
+}
+/** Request lifecycle status understood by the live Studio request-flow panel. */
+export type StudioRequestStatus = 'started' | 'matched' | 'succeeded' | 'failed' | 'finished';
+/** Request trace emitted by runtime observers without request/response bodies. */
+export interface StudioRequestTrace {
+    controller?: string;
+    durationMs?: number;
+    error?: {
+        message: string;
+        name?: string;
+    };
+    finishedAt?: string;
+    handler?: string;
+    method: string;
+    path: string;
+    requestId: string;
+    routeId?: string;
+    startedAt: string;
+    status: StudioRequestStatus;
+    statusCode?: number;
+    url: string;
+}
+/** Runtime diagnostic surfaced in the live Studio diagnostics panel. */
+export interface StudioLiveDiagnostic {
+    code: string;
+    fixHint?: string;
+    message: string;
+    scope?: string;
+    severity: PlatformDiagnosticSeverity;
+    targetId?: string;
+}
+/** Live snapshot consumed by the React Studio shell and sidecar replay cache. */
+export interface StudioLiveSnapshot {
+    appId: string;
+    diagnostics: StudioLiveDiagnostic[];
+    generatedAt: string;
+    graph: {
+        edges: StudioGraphEdge[];
+        nodes: StudioGraphNode[];
+    };
+    requests: StudioRequestTrace[];
+    routes: StudioRouteDescriptor[];
+    timing?: BootstrapTimingDiagnostics;
+    version: 1;
+}
+/** Studio connection status presented by the live UI. */
+export type StudioConnectionStatus = 'connected' | 'connecting' | 'disconnected' | 'error' | 'reconnecting' | 'restarting' | 'stale' | 'static';
+/** Studio connection state used by sidecar/UI state machines. */
+export interface StudioConnectionState {
+    lastEventAt?: string;
+    message?: string;
+    status: StudioConnectionStatus;
+}
+/**
+ * Describes Studio Live Event Source data used by the Studio devtool.
+ */
+export interface StudioLiveEventSource {
+    appId: string;
+    runtime: 'node' | 'bun' | 'deno' | 'worker' | 'unknown';
+}
+/**
+ * Describes Studio Live Event Base data used by the Studio devtool.
+ */
+export interface StudioLiveEventBase<TType extends string, TPayload> {
+    emittedAt: string;
+    epoch: string;
+    eventId: string;
+    payload: TPayload;
+    sequence: number;
+    source: StudioLiveEventSource;
+    type: TType;
+    version: 1;
+}
+/**
+ * Defines Studio Heartbeat Payload values used by the Studio devtool.
+ */
+export type StudioHeartbeatPayload = {
+    uptimeMs?: number;
+};
+/** Runtime/app restart lifecycle hint emitted by CLI-owned dev supervision when available. */
+export interface StudioRestartPayload {
+    phase: 'scheduled' | 'starting' | 'started' | 'stopping' | 'stopped';
+    reason?: string;
+}
+/** Runtime/app disconnect lifecycle hint emitted when the local bridge loses the app process. */
+export interface StudioDisconnectPayload {
+    reason?: string;
+}
+/** Event envelope exchanged between runtime, CLI sidecar, and Studio UI. */
+export type StudioLiveEvent = StudioLiveEventBase<'disconnect', StudioDisconnectPayload> | StudioLiveEventBase<'diagnostic', StudioLiveDiagnostic> | StudioLiveEventBase<'heartbeat', StudioHeartbeatPayload> | StudioLiveEventBase<'request', StudioRequestTrace> | StudioLiveEventBase<'restart', StudioRestartPayload> | StudioLiveEventBase<'snapshot', StudioLiveSnapshot> | StudioLiveEventBase<'timing', BootstrapTimingDiagnostics>;
 /**
  * Filter state applied to the loaded platform snapshot inside Studio.
  */
@@ -53,6 +173,28 @@ export interface ParsedPayload {
     payload: StudioPayload;
     rawJson: string;
 }
+/**
+ * Validates a runtime-connected Studio event envelope.
+ *
+ * @param value Candidate event parsed from JSON or received through SSE.
+ * @returns The typed Studio live event.
+ * @throws Error when the event does not match the live Studio contract.
+ */
+export declare function validateStudioLiveEvent(value: unknown): StudioLiveEvent;
+/**
+ * Parses a live Studio event JSON envelope from the runtime sidecar stream.
+ *
+ * @param rawJson Raw JSON encoded event.
+ * @returns The validated Studio live event.
+ */
+export declare function parseStudioLiveEvent(rawJson: string): StudioLiveEvent;
+/**
+ * Runtime-safe type guard for Studio live event envelopes.
+ *
+ * @param value Candidate value.
+ * @returns `true` when the value matches the live Studio event contract.
+ */
+export declare function isStudioLiveEvent(value: unknown): value is StudioLiveEvent;
 /**
  * Parses a Studio JSON file into the documented snapshot/timing envelope.
  *

package/dist/contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,0BAA0B,EAC1B,uBAAuB,EACvB,qBAAqB,EACrB,gBAAgB,EACjB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAEtF;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,gBAAgB,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC;AAE9E;;GAEG;AACH,MAAM,MAAM,0BAA0B,GAAG,uBAAuB,CAAC,UAAU,CAAC,CAAC;AAE7E;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxD,eAAe,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,CAAC;IAC9D,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,qBAAqB,CAAC;IAChC,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,0BAA0B,CAAC;IACnC,OAAO,EAAE,CAAC,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB,EAAE,uBAAuB,EAAE,CAAC;IAC7C,UAAU,EAAE,0BAA0B,EAAE,CAAC;CAC1C;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,aAAa,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AA0MD;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,CA4BjE;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,qBAAqB,EAAE,MAAM,EAAE,WAAW,GAAG,qBAAqB,CAwCxG;AA8BD;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,CAsErE"}
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"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"}

package/dist/contracts.js

@@ -18,6 +18,46 @@
  * Serializable Studio payload envelope built from inspect snapshot/timing exports.
  */
 
+/** Live Studio graph node kinds emitted by runtime-connected devtools. */
+
+/** Live Studio graph edge kinds emitted by runtime-connected devtools. */
+
+/** Serializable node in the runtime-connected Studio dependency graph. */
+
+/** Serializable edge in the runtime-connected Studio dependency graph. */
+
+/** Route descriptor projected into the live Studio UI. */
+
+/** Request lifecycle status understood by the live Studio request-flow panel. */
+
+/** Request trace emitted by runtime observers without request/response bodies. */
+
+/** Runtime diagnostic surfaced in the live Studio diagnostics panel. */
+
+/** Live snapshot consumed by the React Studio shell and sidecar replay cache. */
+
+/** Studio connection status presented by the live UI. */
+
+/** Studio connection state used by sidecar/UI state machines. */
+
+/**
+ * Describes Studio Live Event Source data used by the Studio devtool.
+ */
+
+/**
+ * Describes Studio Live Event Base data used by the Studio devtool.
+ */
+
+/**
+ * Defines Studio Heartbeat Payload values used by the Studio devtool.
+ */
+
+/** Runtime/app restart lifecycle hint emitted by CLI-owned dev supervision when available. */
+
+/** Runtime/app disconnect lifecycle hint emitted when the local bridge loses the app process. */
+
+/** Event envelope exchanged between runtime, CLI sidecar, and Studio UI. */
+
 /**
  * Filter state applied to the loaded platform snapshot inside Studio.
  */
@@ -44,6 +84,360 @@ function isHealthStatus(value) {
 function isDiagnosticSeverity(value) {
   return value === 'error' || value === 'warning' || value === 'info';
 }
+function isNumber(value) {
+  return typeof value === 'number' && Number.isFinite(value);
+}
+function validateString(value, message) {
+  if (typeof value !== 'string') {
+    throw new Error(message);
+  }
+  return value;
+}
+function validateOptionalString(value, message) {
+  if (value === undefined) {
+    return undefined;
+  }
+  return validateString(value, message);
+}
+function validateOptionalNumber(value, message) {
+  if (value === undefined) {
+    return undefined;
+  }
+  if (!isNumber(value)) {
+    throw new Error(message);
+  }
+  return value;
+}
+function validateMetadata(value, message) {
+  if (value === undefined) {
+    return undefined;
+  }
+  if (!isRecord(value)) {
+    throw new Error(message);
+  }
+  return value;
+}
+function isStudioGraphNodeKind(value) {
+  return value === 'module' || value === 'provider' || value === 'controller' || value === 'route' || value === 'platform' || value === 'external';
+}
+function isStudioGraphEdgeKind(value) {
+  return value === 'imports' || value === 'owns_provider' || value === 'owns_controller' || value === 'exposes_route' || value === 'depends_on' || value === 'exports';
+}
+function isStudioRequestStatus(value) {
+  return value === 'started' || value === 'matched' || value === 'succeeded' || value === 'failed' || value === 'finished';
+}
+function validateStudioGraphNode(value) {
+  if (!isRecord(value) || !isStudioGraphNodeKind(value.kind)) {
+    throw new Error('Invalid Studio live graph node payload.');
+  }
+  const node = {
+    id: validateString(value.id, 'Invalid Studio live graph node payload.'),
+    kind: value.kind,
+    label: validateString(value.label, 'Invalid Studio live graph node payload.')
+  };
+  const metadata = validateMetadata(value.metadata, 'Invalid Studio live graph node metadata payload.');
+  if (metadata) {
+    node.metadata = metadata;
+  }
+  if (value.status !== undefined) {
+    if (value.status !== 'active' && value.status !== 'idle' && value.status !== 'warning' && value.status !== 'error') {
+      throw new Error('Invalid Studio live graph node status payload.');
+    }
+    node.status = value.status;
+  }
+  return node;
+}
+function validateStudioGraphEdge(value) {
+  if (!isRecord(value) || !isStudioGraphEdgeKind(value.kind)) {
+    throw new Error('Invalid Studio live graph edge payload.');
+  }
+  const edge = {
+    from: validateString(value.from, 'Invalid Studio live graph edge payload.'),
+    id: validateString(value.id, 'Invalid Studio live graph edge payload.'),
+    kind: value.kind,
+    to: validateString(value.to, 'Invalid Studio live graph edge payload.')
+  };
+  const label = validateOptionalString(value.label, 'Invalid Studio live graph edge label payload.');
+  if (label !== undefined) {
+    edge.label = label;
+  }
+  const metadata = validateMetadata(value.metadata, 'Invalid Studio live graph edge metadata payload.');
+  if (metadata) {
+    edge.metadata = metadata;
+  }
+  return edge;
+}
+function validateStudioRouteDescriptor(value) {
+  if (!isRecord(value)) {
+    throw new Error('Invalid Studio live route descriptor payload.');
+  }
+  const route = {
+    controller: validateString(value.controller, 'Invalid Studio live route descriptor payload.'),
+    handler: validateString(value.handler, 'Invalid Studio live route descriptor payload.'),
+    id: validateString(value.id, 'Invalid Studio live route descriptor payload.'),
+    method: validateString(value.method, 'Invalid Studio live route descriptor payload.'),
+    path: validateString(value.path, 'Invalid Studio live route descriptor payload.')
+  };
+  const moduleName = validateOptionalString(value.module, 'Invalid Studio live route descriptor module payload.');
+  if (moduleName !== undefined) {
+    route.module = moduleName;
+  }
+  const version = validateOptionalString(value.version, 'Invalid Studio live route descriptor version payload.');
+  if (version !== undefined) {
+    route.version = version;
+  }
+  return route;
+}
+function validateStudioRequestTrace(value) {
+  if (!isRecord(value) || !isStudioRequestStatus(value.status)) {
+    throw new Error('Invalid Studio live request trace payload.');
+  }
+  const trace = {
+    method: validateString(value.method, 'Invalid Studio live request trace payload.'),
+    path: validateString(value.path, 'Invalid Studio live request trace payload.'),
+    requestId: validateString(value.requestId, 'Invalid Studio live request trace payload.'),
+    startedAt: validateString(value.startedAt, 'Invalid Studio live request trace payload.'),
+    status: value.status,
+    url: validateString(value.url, 'Invalid Studio live request trace payload.')
+  };
+  for (const key of ['controller', 'finishedAt', 'handler', 'routeId']) {
+    const stringValue = validateOptionalString(value[key], 'Invalid Studio live request trace optional string payload.');
+    if (stringValue !== undefined) {
+      trace[key] = stringValue;
+    }
+  }
+  const durationMs = validateOptionalNumber(value.durationMs, 'Invalid Studio live request trace duration payload.');
+  if (durationMs !== undefined) {
+    trace.durationMs = durationMs;
+  }
+  const statusCode = validateOptionalNumber(value.statusCode, 'Invalid Studio live request trace status code payload.');
+  if (statusCode !== undefined) {
+    trace.statusCode = statusCode;
+  }
+  if (value.error !== undefined) {
+    if (!isRecord(value.error)) {
+      throw new Error('Invalid Studio live request trace error payload.');
+    }
+    trace.error = {
+      message: validateString(value.error.message, 'Invalid Studio live request trace error payload.')
+    };
+    const errorName = validateOptionalString(value.error.name, 'Invalid Studio live request trace error name payload.');
+    if (errorName !== undefined) {
+      trace.error.name = errorName;
+    }
+  }
+  return trace;
+}
+function validateStudioLiveDiagnostic(value) {
+  if (!isRecord(value) || !isDiagnosticSeverity(value.severity)) {
+    throw new Error('Invalid Studio live diagnostic payload.');
+  }
+  const diagnostic = {
+    code: validateString(value.code, 'Invalid Studio live diagnostic payload.'),
+    message: validateString(value.message, 'Invalid Studio live diagnostic payload.'),
+    severity: value.severity
+  };
+  for (const key of ['fixHint', 'scope', 'targetId']) {
+    const stringValue = validateOptionalString(value[key], 'Invalid Studio live diagnostic optional field payload.');
+    if (stringValue !== undefined) {
+      diagnostic[key] = stringValue;
+    }
+  }
+  return diagnostic;
+}
+function validateStudioRestartPayload(value) {
+  if (!isRecord(value)) {
+    throw new Error('Invalid Studio live restart payload.');
+  }
+  const phase = value.phase;
+  if (phase !== 'scheduled' && phase !== 'starting' && phase !== 'started' && phase !== 'stopping' && phase !== 'stopped') {
+    throw new Error('Invalid Studio live restart phase payload.');
+  }
+  const payload = {
+    phase
+  };
+  const reason = validateOptionalString(value.reason, 'Invalid Studio live restart reason payload.');
+  if (reason !== undefined) {
+    payload.reason = reason;
+  }
+  return payload;
+}
+function validateStudioDisconnectPayload(value) {
+  if (!isRecord(value)) {
+    throw new Error('Invalid Studio live disconnect payload.');
+  }
+  const reason = validateOptionalString(value.reason, 'Invalid Studio live disconnect reason payload.');
+  return reason === undefined ? {} : {
+    reason
+  };
+}
+function validateStudioLiveSnapshot(value) {
+  if (!isRecord(value) || value.version !== 1 || !isRecord(value.graph)) {
+    throw new Error('Invalid Studio live snapshot payload.');
+  }
+  if (!Array.isArray(value.graph.nodes) || !Array.isArray(value.graph.edges) || !Array.isArray(value.routes) || !Array.isArray(value.diagnostics) || !Array.isArray(value.requests)) {
+    throw new Error('Invalid Studio live snapshot payload.');
+  }
+  const timing = validateTiming(value.timing);
+  const snapshot = {
+    appId: validateString(value.appId, 'Invalid Studio live snapshot payload.'),
+    diagnostics: value.diagnostics.map(diagnostic => validateStudioLiveDiagnostic(diagnostic)),
+    generatedAt: validateString(value.generatedAt, 'Invalid Studio live snapshot payload.'),
+    graph: {
+      edges: value.graph.edges.map(edge => validateStudioGraphEdge(edge)),
+      nodes: value.graph.nodes.map(node => validateStudioGraphNode(node))
+    },
+    requests: value.requests.map(request => validateStudioRequestTrace(request)),
+    routes: value.routes.map(route => validateStudioRouteDescriptor(route)),
+    version: 1
+  };
+  if (timing) {
+    snapshot.timing = timing;
+  }
+  return snapshot;
+}
+function validateStudioLiveEventSource(value) {
+  if (!isRecord(value)) {
+    throw new Error('Invalid Studio live event source payload.');
+  }
+  const runtime = value.runtime;
+  if (runtime !== 'node' && runtime !== 'bun' && runtime !== 'deno' && runtime !== 'worker' && runtime !== 'unknown') {
+    throw new Error('Invalid Studio live event runtime payload.');
+  }
+  return {
+    appId: validateString(value.appId, 'Invalid Studio live event source payload.'),
+    runtime
+  };
+}
+function validateStudioLiveEventPayload(type, payload) {
+  if (type === 'snapshot') {
+    return validateStudioLiveSnapshot(payload);
+  }
+  if (type === 'request') {
+    return validateStudioRequestTrace(payload);
+  }
+  if (type === 'timing') {
+    const timing = validateTiming(payload);
+    if (!timing) {
+      throw new Error('Invalid Studio live timing event payload.');
+    }
+    return timing;
+  }
+  if (type === 'diagnostic') {
+    return validateStudioLiveDiagnostic(payload);
+  }
+  if (type === 'heartbeat') {
+    if (!isRecord(payload)) {
+      throw new Error('Invalid Studio live heartbeat payload.');
+    }
+    const uptimeMs = validateOptionalNumber(payload.uptimeMs, 'Invalid Studio live heartbeat uptime payload.');
+    return uptimeMs === undefined ? {} : {
+      uptimeMs
+    };
+  }
+  if (type === 'restart') {
+    return validateStudioRestartPayload(payload);
+  }
+  if (type === 'disconnect') {
+    return validateStudioDisconnectPayload(payload);
+  }
+  throw new Error('Invalid Studio live event type payload.');
+}
+
+/**
+ * Validates a runtime-connected Studio event envelope.
+ *
+ * @param value Candidate event parsed from JSON or received through SSE.
+ * @returns The typed Studio live event.
+ * @throws Error when the event does not match the live Studio contract.
+ */
+export function validateStudioLiveEvent(value) {
+  if (!isRecord(value) || value.version !== 1 || !isNumber(value.sequence)) {
+    throw new Error('Invalid Studio live event payload.');
+  }
+  const type = value.type;
+  const payload = validateStudioLiveEventPayload(type, value.payload);
+  const eventBase = {
+    emittedAt: validateString(value.emittedAt, 'Invalid Studio live event payload.'),
+    epoch: validateString(value.epoch, 'Invalid Studio live event payload.'),
+    eventId: validateString(value.eventId, 'Invalid Studio live event payload.'),
+    sequence: value.sequence,
+    source: validateStudioLiveEventSource(value.source),
+    version: 1
+  };
+  if (type === 'snapshot') {
+    return {
+      ...eventBase,
+      payload: payload,
+      type
+    };
+  }
+  if (type === 'request') {
+    return {
+      ...eventBase,
+      payload: payload,
+      type
+    };
+  }
+  if (type === 'timing') {
+    return {
+      ...eventBase,
+      payload: payload,
+      type
+    };
+  }
+  if (type === 'diagnostic') {
+    return {
+      ...eventBase,
+      payload: payload,
+      type
+    };
+  }
+  if (type === 'restart') {
+    return {
+      ...eventBase,
+      payload: payload,
+      type
+    };
+  }
+  if (type === 'disconnect') {
+    return {
+      ...eventBase,
+      payload: payload,
+      type
+    };
+  }
+  return {
+    ...eventBase,
+    payload: payload,
+    type: 'heartbeat'
+  };
+}
+
+/**
+ * Parses a live Studio event JSON envelope from the runtime sidecar stream.
+ *
+ * @param rawJson Raw JSON encoded event.
+ * @returns The validated Studio live event.
+ */
+export function parseStudioLiveEvent(rawJson) {
+  return validateStudioLiveEvent(JSON.parse(rawJson));
+}
+
+/**
+ * Runtime-safe type guard for Studio live event envelopes.
+ *
+ * @param value Candidate value.
+ * @returns `true` when the value matches the live Studio event contract.
+ */
+export function isStudioLiveEvent(value) {
+  try {
+    validateStudioLiveEvent(value);
+    return true;
+  } catch {
+    return false;
+  }
+}
 function validateSnapshot(value) {
   if (!isRecord(value)) {
     return null;

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { applyFilters, parseStudioPayload, renderMermaid, type FilterState, type ParsedPayload, type PlatformDiagnosticIssue, type PlatformDiagnosticSeverity, type PlatformReadinessStatus, type StudioReportArtifact, type StudioReportSummary, type PlatformShellSnapshot, type StudioPayload, } from './contracts.js';
+export { applyFilters, parseStudioLiveEvent, parseStudioPayload, renderMermaid, validateStudioLiveEvent, isStudioLiveEvent, type FilterState, type ParsedPayload, type PlatformDiagnosticIssue, type PlatformDiagnosticSeverity, type PlatformReadinessStatus, type StudioReportArtifact, type StudioReportSummary, type PlatformShellSnapshot, type StudioPayload, type StudioConnectionState, type StudioConnectionStatus, type StudioDisconnectPayload, type StudioGraphEdge, type StudioGraphEdgeKind, type StudioGraphNode, type StudioGraphNodeKind, type StudioHeartbeatPayload, type StudioLiveDiagnostic, type StudioLiveEvent, type StudioLiveEventBase, type StudioLiveEventSource, type StudioLiveSnapshot, type StudioRequestStatus, type StudioRequestTrace, type StudioRestartPayload, type StudioRouteDescriptor, } from './contracts.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,aAAa,EACb,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,GACnB,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,uBAAuB,EACvB,iBAAiB,EACjB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,uBAAuB,EAC5B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,aAAa,EAClB,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,qBAAqB,GAC3B,MAAM,gBAAgB,CAAC"}

package/dist/index.html

@@ -4,8 +4,8 @@
     <meta charset="UTF-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>Fluo Studio</title>
-    <script type="module" crossorigin src="./assets/index-BOSlyIRm.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-RQNFORxf.css">
+    <script type="module" crossorigin src="./assets/index-AjSkQOVN.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-ort96Zw9.css">
   </head>
   <body>
     <div id="app"></div>

package/dist/index.js

@@ -1 +1 @@
-export { applyFilters, parseStudioPayload, renderMermaid } from './contracts.js';
+export { applyFilters, parseStudioLiveEvent, parseStudioPayload, renderMermaid, validateStudioLiveEvent, isStudioLiveEvent } from './contracts.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fluojs/studio",
-  "description": "File-first diagnostics viewer for Fluo runtime platform snapshot and timing JSON exports.",
+  "description": "Runtime-connected React devtool for Fluo apps with static diagnostics report compatibility.",
   "keywords": [
     "fluo",
     "studio",
@@ -9,7 +9,7 @@
     "module-graph",
     "devtools"
   ],
-  "version": "1.0.4",
+  "version": "1.0.6",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -41,9 +41,13 @@
     "dist"
   ],
   "dependencies": {
-    "@fluojs/runtime": "^1.1.2"
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "@fluojs/runtime": "^1.1.6"
   },
   "devDependencies": {
+    "@types/react": "^19.2.14",
+    "@types/react-dom": "^19.2.3",
     "happy-dom": "^20.9.0",
     "vitest": "^3.2.4",
     "@fluojs-internal/tooling-vite": "^0.0.1"