@alloy-js/core 0.23.0-dev.1 → 0.23.0-dev.8

package/dist/src/debug/trace.js

@@ -0,0 +1,443 @@
+/**
+ * Trace helpers and configuration.
+ */
+
+import { broadcastDevtoolsMessage, isDevtoolsEnabled } from "../devtools/devtools-server.js";
+import { untrack } from "../reactivity.js";
+export { isDevtoolsEnabled } from "../devtools/devtools-server.js";
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Environment configuration
+// ─────────────────────────────────────────────────────────────────────────────
+
+const traceEnv = process.env.ALLOY_TRACE ?? "";
+const tracePhases = new Set(traceEnv === "" ? [] : traceEnv.split(",").map(t => t.trim()));
+const debuggerIdsEnv = process.env.ALLOY_BREAK_ON_DID ?? "";
+const debuggerIds = new Set();
+debuggerIdsEnv.split(",").forEach(id => {
+  const num = parseInt(id, 10);
+  if (!isNaN(num)) {
+    debuggerIds.add(num);
+  }
+});
+
+/** Parse the ALLOY_BREAK_ON_DID environment variable into a set of IDs. */
+export function parseBreakOnIds() {
+  const env = process.env.ALLOY_BREAK_ON_DID ?? "";
+  const ids = new Set();
+  env.split(",").forEach(id => {
+    const num = parseInt(id, 10);
+    if (!isNaN(num)) {
+      ids.add(num);
+    }
+  });
+  return ids;
+}
+
+/** Returns true if console tracing is enabled for the given phase (or any phase if not specified). */
+export function isConsoleTraceEnabled(phase) {
+  if (tracePhases.size === 0) return false;
+  if (!phase) return true;
+  const [area, subarea] = phase.split(".");
+  return tracePhases.has(area) || (subarea ? tracePhases.has(phase) : false);
+}
+if (tracePhases.size > 0) {
+  // eslint-disable-next-line no-console
+  console.log("Tracing enabled for phases:", Array.from(tracePhases).join(", "));
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Trace phases
+// ─────────────────────────────────────────────────────────────────────────────
+
+export const TracePhase = {
+  scope: {
+    update: {
+      area: "scope",
+      subarea: "update",
+      bg: {
+        r: 0,
+        g: 255,
+        b: 100
+      }
+    },
+    create: {
+      area: "scope",
+      subarea: "create",
+      bg: {
+        r: 0,
+        g: 150,
+        b: 100
+      }
+    },
+    delete: {
+      area: "scope",
+      subarea: "delete",
+      bg: {
+        r: 150,
+        g: 0,
+        b: 50
+      }
+    },
+    copySymbols: {
+      area: "scope",
+      subarea: "copySymbols",
+      bg: {
+        r: 0,
+        g: 100,
+        b: 100
+      }
+    },
+    moveSymbols: {
+      area: "scope",
+      subarea: "moveSymbols",
+      bg: {
+        r: 0,
+        g: 100,
+        b: 100
+      }
+    }
+  },
+  symbol: {
+    update: {
+      area: "symbol",
+      subarea: "update",
+      bg: {
+        r: 0,
+        g: 0,
+        b: 255
+      }
+    },
+    resolve: {
+      area: "symbol",
+      subarea: "resolve",
+      bg: {
+        r: 0,
+        g: 0,
+        b: 200
+      }
+    },
+    create: {
+      area: "symbol",
+      subarea: "create",
+      bg: {
+        r: 0,
+        g: 0,
+        b: 150
+      }
+    },
+    flow: {
+      area: "symbol",
+      subarea: "flow",
+      bg: {
+        r: 0,
+        g: 0,
+        b: 100
+      }
+    },
+    addToScope: {
+      area: "symbol",
+      subarea: "addToScope",
+      bg: {
+        r: 0,
+        g: 0,
+        b: 50
+      }
+    },
+    instantiate: {
+      area: "symbol",
+      subarea: "instantiate",
+      bg: {
+        r: 0,
+        g: 0,
+        b: 25
+      }
+    },
+    clone: {
+      area: "symbol",
+      subarea: "clone",
+      bg: {
+        r: 0,
+        g: 0,
+        b: 25
+      }
+    },
+    delete: {
+      area: "symbol",
+      subarea: "delete",
+      bg: {
+        r: 100,
+        g: 0,
+        b: 100
+      }
+    },
+    removeFromScope: {
+      area: "symbol",
+      subarea: "removeFromScope",
+      bg: {
+        r: 50,
+        g: 0,
+        b: 50
+      }
+    }
+  },
+  resolve: {
+    success: {
+      area: "resolve",
+      subarea: "success",
+      bg: {
+        r: 0,
+        g: 255,
+        b: 0
+      }
+    },
+    pending: {
+      area: "resolve",
+      subarea: "pending",
+      bg: {
+        r: 255,
+        g: 255,
+        b: 0
+      }
+    },
+    failure: {
+      area: "resolve",
+      subarea: "failure",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 50
+      }
+    }
+  },
+  effect: {
+    schedule: {
+      area: "effect",
+      subarea: "schedule",
+      bg: {
+        r: 100,
+        g: 100,
+        b: 0
+      }
+    },
+    track: {
+      area: "effect",
+      subarea: "track",
+      bg: {
+        r: 75,
+        g: 75,
+        b: 0
+      }
+    },
+    trigger: {
+      area: "effect",
+      subarea: "trigger",
+      bg: {
+        r: 50,
+        g: 50,
+        b: 0
+      }
+    },
+    effectAdded: {
+      area: "effect",
+      subarea: "effectAdded",
+      bg: {
+        r: 75,
+        g: 100,
+        b: 0
+      }
+    },
+    effectUpdated: {
+      area: "effect",
+      subarea: "effectUpdated",
+      bg: {
+        r: 75,
+        g: 75,
+        b: 0
+      }
+    },
+    refAdded: {
+      area: "effect",
+      subarea: "refAdded",
+      bg: {
+        r: 100,
+        g: 75,
+        b: 0
+      }
+    }
+  },
+  render: {
+    worker: {
+      area: "render",
+      subarea: "worker",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    },
+    appendChild: {
+      area: "render",
+      subarea: "appendChild",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    },
+    appendTextNode: {
+      area: "render",
+      subarea: "appendChild.textNode",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    },
+    appendCachedFragment: {
+      area: "render",
+      subarea: "appendChild.cachedFragment",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    },
+    appendCustomContext: {
+      area: "render",
+      subarea: "appendChild.customContext",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    },
+    appendPrintHook: {
+      area: "render",
+      subarea: "appendChild.printHook",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    },
+    appendComponent: {
+      area: "render",
+      subarea: "appendChild.component",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    },
+    appendMemo: {
+      area: "render",
+      subarea: "appendChild.memo",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    },
+    renderEffect: {
+      area: "render",
+      subarea: "renderEffect",
+      bg: {
+        r: 100,
+        g: 50,
+        b: 0
+      }
+    }
+  }
+};
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Console formatting utilities
+// ─────────────────────────────────────────────────────────────────────────────
+
+export function colorText(text, fmt) {
+  if (!fmt) return text;
+  const codes = [];
+  if (fmt.bold) codes.push("1");
+  if (fmt.fg) codes.push(`38;2;${fmt.fg.r};${fmt.fg.g};${fmt.fg.b}`);
+  if (fmt.bg) codes.push(`48;2;${fmt.bg.r};${fmt.bg.g};${fmt.bg.b}`);
+  if (codes.length === 0) return text;
+  return `\x1b[${codes.join(";")}m${text}\x1b[0m`;
+}
+
+// ─────────────────────────────────────────────────────────────────────────────
+// Low-level trace API
+// ─────────────────────────────────────────────────────────────────────────────
+
+let traceCount = 0;
+function shouldTracePhase(area, subarea) {
+  return isConsoleTraceEnabled(area) || isConsoleTraceEnabled(area + "." + subarea);
+}
+function shouldTrace(phase) {
+  return shouldTracePhase(phase.area, phase.subarea);
+}
+export function traceType(phase) {
+  return `${phase.area}:${phase.subarea}`;
+}
+export function logDevtoolsMessage(message) {
+  if (!isConsoleTraceEnabled()) return;
+  const type = String(message.type ?? "");
+  const colonIndex = type.indexOf(":");
+  if (colonIndex === -1) return;
+  const area = type.slice(0, colonIndex);
+  const subarea = type.slice(colonIndex + 1);
+  if (!area || !subarea) return;
+  if (!shouldTracePhase(area, subarea)) return;
+  // eslint-disable-next-line no-console
+  console.log("devtools:", message.type, message);
+}
+
+/**
+ * Emit a devtools message. Logs to console if tracing is enabled for the
+ * message's area, and broadcasts over the WebSocket if devtools are connected.
+ *
+ * Accepts both strictly-typed protocol messages and loosely-typed trace
+ * messages (which construct the type string dynamically).
+ */
+export function emitDevtoolsMessage(message) {
+  logDevtoolsMessage(message);
+  if (!isDevtoolsEnabled()) return;
+  broadcastDevtoolsMessage(message);
+}
+
+/**
+ * Low-level trace function for emitting console output.
+ * Use the `debug` object methods for most use cases.
+ */
+export function trace(phase, cb, triggerIds = new Set()) {
+  if (shouldTrace(phase)) {
+    if (triggerIds.size === 0) {
+      const id = traceCount++;
+      triggerIds.add(id);
+      if (debuggerIds.has(id)) {
+        // eslint-disable-next-line no-debugger
+        debugger;
+      }
+    }
+    const areaTag = ` ${phase.area}:${phase.subarea} `;
+    const message = untrack(cb);
+    // eslint-disable-next-line no-console
+    console.log(colorText(areaTag, {
+      ...phase,
+      bold: true
+    }) + " " + colorText("[" + [...triggerIds].join(",") + "]", {
+      fg: {
+        r: 50,
+        g: 50,
+        b: 50
+      }
+    }) + " " + message + "\n");
+  }
+  if (isDevtoolsEnabled()) {
+    broadcastDevtoolsMessage({
+      type: traceType(phase),
+      triggerIds: [...triggerIds]
+    });
+  }
+}
+//# sourceMappingURL=trace.js.map

package/dist/src/debug/trace.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["broadcastDevtoolsMessage","isDevtoolsEnabled","untrack","traceEnv","process","env","ALLOY_TRACE","tracePhases","Set","split","map","t","trim","debuggerIdsEnv","ALLOY_BREAK_ON_DID","debuggerIds","forEach","id","num","parseInt","isNaN","add","parseBreakOnIds","ids","isConsoleTraceEnabled","phase","size","area","subarea","has","console","log","Array","from","join","TracePhase","scope","update","bg","r","g","b","create","delete","copySymbols","moveSymbols","symbol","resolve","flow","addToScope","instantiate","clone","removeFromScope","success","pending","failure","effect","schedule","track","trigger","effectAdded","effectUpdated","refAdded","render","worker","appendChild","appendTextNode","appendCachedFragment","appendCustomContext","appendPrintHook","appendComponent","appendMemo","renderEffect","colorText","text","fmt","codes","bold","push","fg","length","traceCount","shouldTracePhase","shouldTrace","traceType","logDevtoolsMessage","message","type","String","colonIndex","indexOf","slice","emitDevtoolsMessage","trace","cb","triggerIds","areaTag"],"sources":["../../../src/debug/trace.ts"],"sourcesContent":[null],"mappings":"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","ignoreList":[]}

package/dist/src/devtools/devtools-protocol.d.ts

@@ -0,0 +1,232 @@
+/**
+ * Shared protocol types for communication between the Alloy devtools server
+ * and the devtools UI client. Both sides import these types to ensure
+ * compile-time safety and prevent protocol drift.
+ */
+import type { SourceLocation } from "../debug/effects.js";
+export type { SourceLocation };
+export interface RenderTreeNode {
+    id: number;
+    kind: "root" | "component" | "intrinsic" | "printHook" | "text" | "memo" | "customContext" | "fragment";
+    name?: string;
+    propsSerialized?: string;
+    value?: string;
+    source?: SourceLocation;
+}
+export interface EffectInfo {
+    id: number;
+    name?: string;
+    type?: string;
+    createdAt?: SourceLocation;
+    lastTriggeredByRefId?: number;
+    lastTriggeredAt?: SourceLocation;
+}
+export interface RefInfo {
+    id: number;
+    kind?: string;
+    createdAt?: SourceLocation;
+    createdByEffectId?: number;
+}
+export interface EffectEdgeInfo {
+    id: number;
+    type: "track" | "trigger" | "triggered-by";
+    effectId: number;
+    refId?: number;
+    targetId?: number;
+    targetKind?: "ref" | "target";
+    targetLabel?: string;
+    targetKey?: string | number;
+    location?: SourceLocation;
+    count?: number;
+}
+export interface ScopeInfo {
+    id: number;
+    name: string;
+    parentId: number | null;
+    ownerSymbolId: number | null;
+    renderNodeId?: number | null;
+    isMemberScope: boolean;
+    isTransient?: boolean;
+    metadata?: Record<string, unknown>;
+    debugInfo?: Record<string, unknown>;
+    children?: Array<{
+        id: number;
+        name?: string;
+    }>;
+    spaces?: Array<{
+        key: string;
+        symbols: Array<{
+            id: number;
+            name?: string;
+        }>;
+    }>;
+}
+export interface SymbolInfo {
+    id: number;
+    name: string;
+    originalName: string;
+    scopeId: number | null;
+    ownerSymbolId: number | null;
+    renderNodeId?: number | null;
+    isMemberSymbol: boolean;
+    isTransient: boolean;
+    isAlias: boolean;
+    movedToId: number | null;
+    metadata?: Record<string, unknown>;
+    debugInfo?: Record<string, unknown>;
+    memberSpaces?: Array<{
+        key: string;
+        symbols: Array<{
+            id: number;
+            name?: string;
+        }>;
+    }>;
+}
+export interface RenderErrorStackEntry {
+    name: string;
+    propsSerialized?: string;
+    renderNodeId?: number;
+    source?: SourceLocation;
+}
+export interface DiagnosticInfo {
+    id: string;
+    message: string;
+    severity: string;
+    source?: SourceLocation;
+    componentStack?: Array<{
+        name: string;
+        renderNodeId?: number;
+        source?: SourceLocation;
+    }>;
+}
+export interface DebuggerInfoMessage {
+    type: "debugger:info";
+    version: string;
+    cwd?: string;
+}
+export interface RenderResetMessage {
+    type: "render:reset";
+}
+export interface RenderNodeAddedMessage {
+    type: "render:nodeAdded";
+    parentId: number | null;
+    node: RenderTreeNode;
+}
+export interface RenderNodeUpdatedMessage {
+    type: "render:nodeUpdated";
+    id: number;
+    propsSerialized?: string;
+}
+export interface RenderNodeRemovedMessage {
+    type: "render:nodeRemoved";
+    parentId: number | null;
+    id: number;
+    name?: string;
+}
+export interface RenderErrorMessage {
+    type: "render:error";
+    id: number;
+    name?: string;
+    message?: string;
+    stack?: string;
+    componentStack: RenderErrorStackEntry[];
+}
+export interface RenderCompleteMessage {
+    type: "render:complete";
+}
+export interface FlushJobsCompleteMessage {
+    type: "flushJobs:complete";
+}
+export interface DirectoryAddedMessage {
+    type: "files:directoryAdded";
+    path: string;
+}
+export interface DirectoryRemovedMessage {
+    type: "files:directoryRemoved";
+    path: string;
+}
+export interface FileAddedMessage {
+    type: "files:fileAdded";
+    path: string;
+    filetype: string;
+    renderNodeId?: number;
+}
+export interface FileRemovedMessage {
+    type: "files:fileRemoved";
+    path: string;
+}
+export interface FileUpdatedMessage {
+    type: "files:fileUpdated";
+    path: string;
+    filetype: string;
+    contents: string;
+}
+export interface ScopeCreateMessage {
+    type: "scope:create";
+    scope: ScopeInfo;
+}
+export interface ScopeUpdateMessage {
+    type: "scope:update";
+    scope: ScopeInfo;
+}
+export interface ScopeDeleteMessage {
+    type: "scope:delete";
+    id: number;
+}
+export interface SymbolCreateMessage {
+    type: "symbol:create";
+    symbol: SymbolInfo;
+}
+export interface SymbolUpdateMessage {
+    type: "symbol:update";
+    symbol: SymbolInfo;
+}
+export interface SymbolDeleteMessage {
+    type: "symbol:delete";
+    id: number;
+}
+export interface EffectAddedMessage {
+    type: "effect:effectAdded";
+    effect: EffectInfo;
+}
+export interface EffectUpdatedMessage {
+    type: "effect:effectUpdated";
+    effect: EffectInfo;
+}
+export interface RefAddedMessage {
+    type: "effect:refAdded";
+    ref: RefInfo;
+}
+export interface EffectTrackMessage {
+    type: "effect:track";
+    edge: EffectEdgeInfo;
+    message?: string;
+}
+export interface EffectTriggerMessage {
+    type: "effect:trigger";
+    edge: EffectEdgeInfo;
+    message?: string;
+}
+export interface EffectEdgeUpdatedMessage {
+    type: "effect:edgeUpdated";
+    edge: EffectEdgeInfo;
+}
+export interface DiagnosticsReportMessage {
+    type: "diagnostics:report";
+    diagnostics: DiagnosticInfo[];
+}
+export interface BatchMessage {
+    type: "batch";
+    messages: ServerToClientMessage[];
+}
+export type ServerToClientMessage = DebuggerInfoMessage | RenderResetMessage | RenderNodeAddedMessage | RenderNodeUpdatedMessage | RenderNodeRemovedMessage | RenderErrorMessage | RenderCompleteMessage | FlushJobsCompleteMessage | DirectoryAddedMessage | DirectoryRemovedMessage | FileAddedMessage | FileRemovedMessage | FileUpdatedMessage | ScopeCreateMessage | ScopeUpdateMessage | ScopeDeleteMessage | SymbolCreateMessage | SymbolUpdateMessage | SymbolDeleteMessage | EffectAddedMessage | EffectUpdatedMessage | RefAddedMessage | EffectTrackMessage | EffectTriggerMessage | EffectEdgeUpdatedMessage | DiagnosticsReportMessage | BatchMessage;
+export interface RerenderRequestMessage {
+    type: "render:rerender";
+    id: number;
+}
+export interface RerenderBreakRequestMessage {
+    type: "render:rerenderAndBreak";
+    id: number;
+}
+export type ClientToServerMessage = RerenderRequestMessage | RerenderBreakRequestMessage;
+//# sourceMappingURL=devtools-protocol.d.ts.map