@logixjs/devtools-react 0.0.1

package/dist/DevtoolsLayer.cjs

@@ -0,0 +1,172 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/DevtoolsLayer.tsx
+var DevtoolsLayer_exports = {};
+__export(DevtoolsLayer_exports, {
+  DevtoolsSnapshotStore: () => DevtoolsSnapshotStore,
+  clearDevtoolsEvents: () => clearDevtoolsEvents,
+  clearDevtoolsSnapshotOverride: () => clearDevtoolsSnapshotOverride,
+  devtoolsLayer: () => devtoolsLayer,
+  devtoolsSnapshotLayer: () => devtoolsSnapshotLayer,
+  getDevtoolsSnapshot: () => getDevtoolsSnapshot,
+  getDevtoolsSnapshotOverrideInfo: () => getDevtoolsSnapshotOverrideInfo,
+  getDevtoolsSnapshotToken: () => getDevtoolsSnapshotToken,
+  getInstanceLabel: () => getInstanceLabel,
+  hasDevtoolsSnapshotOverride: () => hasDevtoolsSnapshotOverride,
+  setDevtoolsSnapshotOverride: () => setDevtoolsSnapshotOverride,
+  setInstanceLabel: () => setInstanceLabel,
+  subscribeDevtoolsSnapshot: () => subscribeDevtoolsSnapshot,
+  subscribeDevtoolsSnapshotToken: () => subscribeDevtoolsSnapshotToken
+});
+module.exports = __toCommonJS(DevtoolsLayer_exports);
+
+// src/internal/snapshot/index.ts
+var Logix = __toESM(require("@logixjs/core"), 1);
+var import_effect = require("effect");
+var clearDevtoolsEvents = Logix.Debug.clearDevtoolsEvents;
+var setInstanceLabel = Logix.Debug.setInstanceLabel;
+var getInstanceLabel = Logix.Debug.getInstanceLabel;
+var snapshotOverride;
+var snapshotOverrideInfo;
+var overrideSnapshotToken = Number.MIN_SAFE_INTEGER;
+var nextOverrideSnapshotToken = () => {
+  overrideSnapshotToken += 1;
+  return overrideSnapshotToken;
+};
+var isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+var asNonEmptyString = (value) => typeof value === "string" && value.length > 0 ? value : void 0;
+var asNonNegativeInt = (value) => {
+  if (typeof value !== "number" || !Number.isFinite(value)) return void 0;
+  const n = Math.floor(value);
+  return n >= 0 ? n : void 0;
+};
+var normalizeTxnSeqFromTxnId = (txnId, instanceId) => {
+  if (!txnId) return void 0;
+  const escapeRe = (s) => s.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+  const m = instanceId ? txnId.match(new RegExp(`^${escapeRe(instanceId)}::t(\\d+)$`)) : txnId.match(/::t(\d+)$/);
+  if (!m) return void 0;
+  const n = Number(m[1]);
+  return Number.isFinite(n) && n >= 0 ? Math.floor(n) : void 0;
+};
+var normalizeDevtoolsSnapshot = (snapshot) => {
+  const events = snapshot.events.map((e, index) => {
+    if (!isRecord(e)) {
+      return e;
+    }
+    const instanceId = asNonEmptyString(e.instanceId);
+    const txnId = asNonEmptyString(e.txnId);
+    const txnSeq = asNonNegativeInt(e.txnSeq) ?? normalizeTxnSeqFromTxnId(txnId, instanceId) ?? 0;
+    const eventSeq = asNonNegativeInt(e.eventSeq) ?? index + 1;
+    const eventId = asNonEmptyString(e.eventId) ?? (instanceId ? `${instanceId}::e${eventSeq}` : `unknown::e${eventSeq}`);
+    const patched = { ...e, eventId, eventSeq, txnSeq };
+    if (!patched.txnId && instanceId && txnSeq > 0) {
+      patched.txnId = `${instanceId}::t${txnSeq}`;
+    }
+    return patched;
+  });
+  return { ...snapshot, events };
+};
+var listeners = /* @__PURE__ */ new Set();
+var unsubscribeCore;
+var notify = () => {
+  for (const listener of listeners) {
+    listener();
+  }
+};
+var ensureCoreSubscribed = () => {
+  if (unsubscribeCore) return;
+  unsubscribeCore = Logix.Debug.subscribeDevtoolsSnapshot(() => {
+    if (snapshotOverride) return;
+    notify();
+  });
+};
+var hasDevtoolsSnapshotOverride = () => snapshotOverride != null;
+var getDevtoolsSnapshotOverrideInfo = () => snapshotOverrideInfo;
+var setDevtoolsSnapshotOverride = (snapshot, info) => {
+  snapshotOverride = normalizeDevtoolsSnapshot({
+    ...snapshot,
+    snapshotToken: nextOverrideSnapshotToken()
+  });
+  snapshotOverrideInfo = info;
+  notify();
+};
+var clearDevtoolsSnapshotOverride = () => {
+  snapshotOverride = void 0;
+  snapshotOverrideInfo = void 0;
+  notify();
+};
+var getDevtoolsSnapshot = () => snapshotOverride ?? Logix.Debug.getDevtoolsSnapshot();
+var getDevtoolsSnapshotToken = () => getDevtoolsSnapshot().snapshotToken;
+var subscribeDevtoolsSnapshot = (listener) => {
+  listeners.add(listener);
+  ensureCoreSubscribed();
+  return () => {
+    listeners.delete(listener);
+    if (listeners.size === 0 && unsubscribeCore) {
+      unsubscribeCore();
+      unsubscribeCore = void 0;
+    }
+  };
+};
+var subscribeDevtoolsSnapshotToken = subscribeDevtoolsSnapshot;
+var devtoolsLayer = Logix.Debug.devtoolsHubLayer();
+var DevtoolsSnapshotStore = class extends import_effect.Context.Tag("Logix/DevtoolsSnapshotStore")() {
+};
+var devtoolsSnapshotService = {
+  get: import_effect.Effect.sync(() => getDevtoolsSnapshot()),
+  changes: import_effect.Stream.async((emit) => {
+    const listener = () => {
+      emit.single(getDevtoolsSnapshot());
+    };
+    const unsubscribe = subscribeDevtoolsSnapshot(listener);
+    return import_effect.Effect.sync(unsubscribe);
+  })
+};
+var devtoolsSnapshotLayer = import_effect.Layer.succeed(
+  DevtoolsSnapshotStore,
+  devtoolsSnapshotService
+);
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DevtoolsSnapshotStore,
+  clearDevtoolsEvents,
+  clearDevtoolsSnapshotOverride,
+  devtoolsLayer,
+  devtoolsSnapshotLayer,
+  getDevtoolsSnapshot,
+  getDevtoolsSnapshotOverrideInfo,
+  getDevtoolsSnapshotToken,
+  getInstanceLabel,
+  hasDevtoolsSnapshotOverride,
+  setDevtoolsSnapshotOverride,
+  setInstanceLabel,
+  subscribeDevtoolsSnapshot,
+  subscribeDevtoolsSnapshotToken
+});

package/dist/DevtoolsLayer.d.cts

@@ -0,0 +1,53 @@
+import * as Logix from '@logixjs/core';
+import { Layer, Effect, Stream, Context } from 'effect';
+
+/**
+ * Notes:
+ * - Since 003-trait-txn-lifecycle, DevtoolsHub has been moved down into @logixjs/core (global singleton).
+ * - This file is only a thin adapter layer:
+ *   - Still exports DevtoolsSnapshotStore / devtoolsSnapshotLayer for DevtoolsModule.
+ *   - Still exports devtoolsLayer as a legacy compatibility entry (deprecated).
+ */
+type DevtoolsSnapshot = Logix.Debug.DevtoolsSnapshot;
+declare const clearDevtoolsEvents: () => void;
+declare const setInstanceLabel: (instanceId: string, label: string) => void;
+declare const getInstanceLabel: (instanceId: string) => string | undefined;
+type SnapshotToken = Logix.Debug.SnapshotToken;
+type DevtoolsSnapshotOverrideInfo = {
+    readonly kind: 'evidence';
+    readonly evidence: Logix.Observability.EvidencePackage;
+};
+declare const hasDevtoolsSnapshotOverride: () => boolean;
+declare const getDevtoolsSnapshotOverrideInfo: () => DevtoolsSnapshotOverrideInfo | undefined;
+declare const setDevtoolsSnapshotOverride: (snapshot: DevtoolsSnapshot, info?: DevtoolsSnapshotOverrideInfo) => void;
+declare const clearDevtoolsSnapshotOverride: () => void;
+declare const getDevtoolsSnapshot: () => DevtoolsSnapshot;
+/**
+ * SnapshotToken (safe for external subscription):
+ * - `DevtoolsSnapshot` keeps a stable reference and mutates in place; subscribing to the snapshot reference directly in React may miss updates.
+ * - Prefer subscribing to the token (`useSyncExternalStore(subscribe, getToken, getToken)`), and re-read snapshot when token changes.
+ */
+declare const getDevtoolsSnapshotToken: () => SnapshotToken;
+declare const subscribeDevtoolsSnapshot: (listener: () => void) => (() => void);
+declare const subscribeDevtoolsSnapshotToken: (listener: () => void) => (() => void);
+/**
+ * devtoolsLayer（deprecated）：
+ * - Older versions required explicit Layer.replace(DebugSinks); now the core Hub appends sinks.
+ * - Prefer Runtime.make(..., { devtools: true }).
+ */
+declare const devtoolsLayer: Layer.Layer<any, never, never>;
+interface DevtoolsSnapshotService {
+    readonly get: Effect.Effect<DevtoolsSnapshot>;
+    readonly changes: Stream.Stream<DevtoolsSnapshot>;
+}
+declare const DevtoolsSnapshotStore_base: Context.TagClass<DevtoolsSnapshotStore, "Logix/DevtoolsSnapshotStore", DevtoolsSnapshotService>;
+/**
+ * DevtoolsSnapshotStore：
+ * - Exposed as an Env Service for Devtools Runtime.
+ * - Used by DevtoolsModule to subscribe to Snapshot changes and derive DevtoolsState.
+ */
+declare class DevtoolsSnapshotStore extends DevtoolsSnapshotStore_base {
+}
+declare const devtoolsSnapshotLayer: Layer.Layer<DevtoolsSnapshotStore, never, never>;
+
+export { type DevtoolsSnapshot, type DevtoolsSnapshotOverrideInfo, type DevtoolsSnapshotService, DevtoolsSnapshotStore, type SnapshotToken, clearDevtoolsEvents, clearDevtoolsSnapshotOverride, devtoolsLayer, devtoolsSnapshotLayer, getDevtoolsSnapshot, getDevtoolsSnapshotOverrideInfo, getDevtoolsSnapshotToken, getInstanceLabel, hasDevtoolsSnapshotOverride, setDevtoolsSnapshotOverride, setInstanceLabel, subscribeDevtoolsSnapshot, subscribeDevtoolsSnapshotToken };

package/dist/DevtoolsLayer.d.ts

@@ -0,0 +1,53 @@
+import * as Logix from '@logixjs/core';
+import { Layer, Effect, Stream, Context } from 'effect';
+
+/**
+ * Notes:
+ * - Since 003-trait-txn-lifecycle, DevtoolsHub has been moved down into @logixjs/core (global singleton).
+ * - This file is only a thin adapter layer:
+ *   - Still exports DevtoolsSnapshotStore / devtoolsSnapshotLayer for DevtoolsModule.
+ *   - Still exports devtoolsLayer as a legacy compatibility entry (deprecated).
+ */
+type DevtoolsSnapshot = Logix.Debug.DevtoolsSnapshot;
+declare const clearDevtoolsEvents: () => void;
+declare const setInstanceLabel: (instanceId: string, label: string) => void;
+declare const getInstanceLabel: (instanceId: string) => string | undefined;
+type SnapshotToken = Logix.Debug.SnapshotToken;
+type DevtoolsSnapshotOverrideInfo = {
+    readonly kind: 'evidence';
+    readonly evidence: Logix.Observability.EvidencePackage;
+};
+declare const hasDevtoolsSnapshotOverride: () => boolean;
+declare const getDevtoolsSnapshotOverrideInfo: () => DevtoolsSnapshotOverrideInfo | undefined;
+declare const setDevtoolsSnapshotOverride: (snapshot: DevtoolsSnapshot, info?: DevtoolsSnapshotOverrideInfo) => void;
+declare const clearDevtoolsSnapshotOverride: () => void;
+declare const getDevtoolsSnapshot: () => DevtoolsSnapshot;
+/**
+ * SnapshotToken (safe for external subscription):
+ * - `DevtoolsSnapshot` keeps a stable reference and mutates in place; subscribing to the snapshot reference directly in React may miss updates.
+ * - Prefer subscribing to the token (`useSyncExternalStore(subscribe, getToken, getToken)`), and re-read snapshot when token changes.
+ */
+declare const getDevtoolsSnapshotToken: () => SnapshotToken;
+declare const subscribeDevtoolsSnapshot: (listener: () => void) => (() => void);
+declare const subscribeDevtoolsSnapshotToken: (listener: () => void) => (() => void);
+/**
+ * devtoolsLayer（deprecated）：
+ * - Older versions required explicit Layer.replace(DebugSinks); now the core Hub appends sinks.
+ * - Prefer Runtime.make(..., { devtools: true }).
+ */
+declare const devtoolsLayer: Layer.Layer<any, never, never>;
+interface DevtoolsSnapshotService {
+    readonly get: Effect.Effect<DevtoolsSnapshot>;
+    readonly changes: Stream.Stream<DevtoolsSnapshot>;
+}
+declare const DevtoolsSnapshotStore_base: Context.TagClass<DevtoolsSnapshotStore, "Logix/DevtoolsSnapshotStore", DevtoolsSnapshotService>;
+/**
+ * DevtoolsSnapshotStore：
+ * - Exposed as an Env Service for Devtools Runtime.
+ * - Used by DevtoolsModule to subscribe to Snapshot changes and derive DevtoolsState.
+ */
+declare class DevtoolsSnapshotStore extends DevtoolsSnapshotStore_base {
+}
+declare const devtoolsSnapshotLayer: Layer.Layer<DevtoolsSnapshotStore, never, never>;
+
+export { type DevtoolsSnapshot, type DevtoolsSnapshotOverrideInfo, type DevtoolsSnapshotService, DevtoolsSnapshotStore, type SnapshotToken, clearDevtoolsEvents, clearDevtoolsSnapshotOverride, devtoolsLayer, devtoolsSnapshotLayer, getDevtoolsSnapshot, getDevtoolsSnapshotOverrideInfo, getDevtoolsSnapshotToken, getInstanceLabel, hasDevtoolsSnapshotOverride, setDevtoolsSnapshotOverride, setInstanceLabel, subscribeDevtoolsSnapshot, subscribeDevtoolsSnapshotToken };

package/dist/DevtoolsLayer.js

@@ -0,0 +1,33 @@
+import "./chunk-HFUIUVQI.js";
+import {
+  DevtoolsSnapshotStore,
+  clearDevtoolsEvents,
+  clearDevtoolsSnapshotOverride,
+  devtoolsLayer,
+  devtoolsSnapshotLayer,
+  getDevtoolsSnapshot,
+  getDevtoolsSnapshotOverrideInfo,
+  getDevtoolsSnapshotToken,
+  getInstanceLabel,
+  hasDevtoolsSnapshotOverride,
+  setDevtoolsSnapshotOverride,
+  setInstanceLabel,
+  subscribeDevtoolsSnapshot,
+  subscribeDevtoolsSnapshotToken
+} from "./chunk-FNWHBEXD.js";
+export {
+  DevtoolsSnapshotStore,
+  clearDevtoolsEvents,
+  clearDevtoolsSnapshotOverride,
+  devtoolsLayer,
+  devtoolsSnapshotLayer,
+  getDevtoolsSnapshot,
+  getDevtoolsSnapshotOverrideInfo,
+  getDevtoolsSnapshotToken,
+  getInstanceLabel,
+  hasDevtoolsSnapshotOverride,
+  setDevtoolsSnapshotOverride,
+  setInstanceLabel,
+  subscribeDevtoolsSnapshot,
+  subscribeDevtoolsSnapshotToken
+};