@osdk/react-devtools 0.5.0

package/build/esm/hooks/useTimeElapsed.js

@@ -0,0 +1,51 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+export function useTimeElapsed(startTime) {
+  const startMs = startTime?.getTime();
+  const stateRef = React.useRef({
+    tick: 0,
+    cachedTick: -1,
+    cachedValue: undefined
+  });
+  const subscribe = React.useCallback(callback => {
+    if (startMs == null) {
+      return () => {};
+    }
+    const intervalId = setInterval(() => {
+      stateRef.current.tick++;
+      callback();
+    }, 1000);
+    return () => {
+      clearInterval(intervalId);
+    };
+  }, [startMs]);
+  const getSnapshot = React.useCallback(() => {
+    if (startMs == null) {
+      return undefined;
+    }
+    const state = stateRef.current;
+    if (state.cachedTick === state.tick) {
+      return state.cachedValue;
+    }
+    state.cachedValue = Date.now() - startMs;
+    state.cachedTick = state.tick;
+    return state.cachedValue;
+  }, [startMs]);
+  return React.useSyncExternalStore(subscribe, getSnapshot);
+}
+//# sourceMappingURL=useTimeElapsed.js.map

package/build/esm/hooks/useTimeElapsed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTimeElapsed.js","names":["React","useTimeElapsed","startTime","startMs","getTime","stateRef","useRef","tick","cachedTick","cachedValue","undefined","subscribe","useCallback","callback","intervalId","setInterval","current","clearInterval","getSnapshot","state","Date","now","useSyncExternalStore"],"sources":["useTimeElapsed.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\n\nexport function useTimeElapsed(\n  startTime: Date | undefined,\n): number | undefined {\n  const startMs = startTime?.getTime();\n\n  const stateRef = React.useRef({\n    tick: 0,\n    cachedTick: -1,\n    cachedValue: undefined as number | undefined,\n  });\n\n  const subscribe = React.useCallback(\n    (callback: () => void) => {\n      if (startMs == null) {\n        return () => {};\n      }\n\n      const intervalId = setInterval(() => {\n        stateRef.current.tick++;\n        callback();\n      }, 1000);\n      return () => {\n        clearInterval(intervalId);\n      };\n    },\n    [startMs],\n  );\n\n  const getSnapshot = React.useCallback(\n    (): number | undefined => {\n      if (startMs == null) {\n        return undefined;\n      }\n      const state = stateRef.current;\n      if (state.cachedTick === state.tick) {\n        return state.cachedValue;\n      }\n      state.cachedValue = Date.now() - startMs;\n      state.cachedTick = state.tick;\n      return state.cachedValue;\n    },\n    [startMs],\n  );\n\n  return React.useSyncExternalStore(subscribe, getSnapshot);\n}\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAOA,KAAK,MAAM,OAAO;AAEzB,OAAO,SAASC,cAAcA,CAC5BC,SAA2B,EACP;EACpB,MAAMC,OAAO,GAAGD,SAAS,EAAEE,OAAO,CAAC,CAAC;EAEpC,MAAMC,QAAQ,GAAGL,KAAK,CAACM,MAAM,CAAC;IAC5BC,IAAI,EAAE,CAAC;IACPC,UAAU,EAAE,CAAC,CAAC;IACdC,WAAW,EAAEC;EACf,CAAC,CAAC;EAEF,MAAMC,SAAS,GAAGX,KAAK,CAACY,WAAW,CAChCC,QAAoB,IAAK;IACxB,IAAIV,OAAO,IAAI,IAAI,EAAE;MACnB,OAAO,MAAM,CAAC,CAAC;IACjB;IAEA,MAAMW,UAAU,GAAGC,WAAW,CAAC,MAAM;MACnCV,QAAQ,CAACW,OAAO,CAACT,IAAI,EAAE;MACvBM,QAAQ,CAAC,CAAC;IACZ,CAAC,EAAE,IAAI,CAAC;IACR,OAAO,MAAM;MACXI,aAAa,CAACH,UAAU,CAAC;IAC3B,CAAC;EACH,CAAC,EACD,CAACX,OAAO,CACV,CAAC;EAED,MAAMe,WAAW,GAAGlB,KAAK,CAACY,WAAW,CACnC,MAA0B;IACxB,IAAIT,OAAO,IAAI,IAAI,EAAE;MACnB,OAAOO,SAAS;IAClB;IACA,MAAMS,KAAK,GAAGd,QAAQ,CAACW,OAAO;IAC9B,IAAIG,KAAK,CAACX,UAAU,KAAKW,KAAK,CAACZ,IAAI,EAAE;MACnC,OAAOY,KAAK,CAACV,WAAW;IAC1B;IACAU,KAAK,CAACV,WAAW,GAAGW,IAAI,CAACC,GAAG,CAAC,CAAC,GAAGlB,OAAO;IACxCgB,KAAK,CAACX,UAAU,GAAGW,KAAK,CAACZ,IAAI;IAC7B,OAAOY,KAAK,CAACV,WAAW;EAC1B,CAAC,EACD,CAACN,OAAO,CACV,CAAC;EAED,OAAOH,KAAK,CAACsB,oBAAoB,CAACX,SAAS,EAAEO,WAAW,CAAC;AAC3D","ignoreList":[]}

package/build/esm/hooks/useTrackerSubscription.js

@@ -0,0 +1,97 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+export function useTrackerSubscription(tracker, getData, emptyData, options = {}) {
+  const {
+    autoRefresh = true,
+    refreshInterval = 1000,
+    limit = 10
+  } = options;
+  const getDataRef = React.useRef(getData);
+  const emptyDataRef = React.useRef(emptyData);
+  getDataRef.current = getData;
+  emptyDataRef.current = emptyData;
+  const storeRef = React.useRef(null);
+  if (storeRef.current == null) {
+    storeRef.current = {
+      data: tracker ? getData(tracker, limit) : emptyData,
+      listeners: new Set()
+    };
+  }
+  const subscribe = React.useCallback(callback => {
+    const store = storeRef.current;
+    if (store == null) {
+      return () => {};
+    }
+    store.listeners.add(callback);
+    const doRefresh = () => {
+      if (store == null) {
+        return;
+      }
+      if (tracker) {
+        store.data = getDataRef.current(tracker, limit);
+      } else {
+        store.data = emptyDataRef.current;
+      }
+      for (const listener of store.listeners) {
+        listener();
+      }
+    };
+    doRefresh();
+    let unsubscribeTracker;
+    let intervalId;
+    if (tracker && autoRefresh) {
+      unsubscribeTracker = tracker.subscribe(doRefresh);
+      intervalId = setInterval(doRefresh, refreshInterval);
+    }
+    return () => {
+      store.listeners.delete(callback);
+      if (unsubscribeTracker) {
+        unsubscribeTracker();
+      }
+      if (intervalId !== undefined) {
+        clearInterval(intervalId);
+      }
+    };
+  }, [tracker, autoRefresh, refreshInterval, limit]);
+  const getSnapshot = React.useCallback(() => {
+    if (storeRef.current == null) {
+      return emptyData;
+    }
+    return storeRef.current.data;
+  }, [emptyData]);
+  const data = React.useSyncExternalStore(subscribe, getSnapshot);
+  const refresh = React.useCallback(() => {
+    const store = storeRef.current;
+    if (store == null) {
+      return;
+    }
+    if (tracker) {
+      store.data = getDataRef.current(tracker, limit);
+    } else {
+      store.data = emptyDataRef.current;
+    }
+    for (const listener of store.listeners) {
+      listener();
+    }
+  }, [tracker, limit]);
+  return {
+    data,
+    refresh
+  };
+}
+//# sourceMappingURL=useTrackerSubscription.js.map

package/build/esm/hooks/useTrackerSubscription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTrackerSubscription.js","names":["React","useTrackerSubscription","tracker","getData","emptyData","options","autoRefresh","refreshInterval","limit","getDataRef","useRef","emptyDataRef","current","storeRef","data","listeners","Set","subscribe","useCallback","callback","store","add","doRefresh","listener","unsubscribeTracker","intervalId","setInterval","delete","undefined","clearInterval","getSnapshot","useSyncExternalStore","refresh"],"sources":["useTrackerSubscription.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\n\ninterface Subscribable {\n  subscribe(cb: () => void): () => void;\n}\n\nexport interface TrackerSubscriptionOptions {\n  autoRefresh?: boolean;\n  refreshInterval?: number;\n  limit?: number;\n}\n\nexport function useTrackerSubscription<TTracker extends Subscribable, TData>(\n  tracker: TTracker | null,\n  getData: (tracker: TTracker, limit: number) => TData,\n  emptyData: TData,\n  options: TrackerSubscriptionOptions = {},\n): { data: TData; refresh: () => void } {\n  const {\n    autoRefresh = true,\n    refreshInterval = 1000,\n    limit = 10,\n  } = options;\n\n  const getDataRef = React.useRef(getData);\n  const emptyDataRef = React.useRef(emptyData);\n  getDataRef.current = getData;\n  emptyDataRef.current = emptyData;\n\n  const storeRef = React.useRef<\n    {\n      data: TData;\n      listeners: Set<() => void>;\n    } | null\n  >(null);\n\n  if (storeRef.current == null) {\n    storeRef.current = {\n      data: tracker ? getData(tracker, limit) : emptyData,\n      listeners: new Set(),\n    };\n  }\n\n  const subscribe = React.useCallback(\n    (callback: () => void) => {\n      const store = storeRef.current;\n      if (store == null) {\n        return () => {};\n      }\n      store.listeners.add(callback);\n\n      const doRefresh = () => {\n        if (store == null) {\n          return;\n        }\n        if (tracker) {\n          store.data = getDataRef.current(tracker, limit);\n        } else {\n          store.data = emptyDataRef.current;\n        }\n        for (const listener of store.listeners) {\n          listener();\n        }\n      };\n\n      doRefresh();\n\n      let unsubscribeTracker: (() => void) | undefined;\n      let intervalId: ReturnType<typeof setInterval> | undefined;\n\n      if (tracker && autoRefresh) {\n        unsubscribeTracker = tracker.subscribe(doRefresh);\n        intervalId = setInterval(doRefresh, refreshInterval);\n      }\n\n      return () => {\n        store.listeners.delete(callback);\n        if (unsubscribeTracker) {\n          unsubscribeTracker();\n        }\n        if (intervalId !== undefined) {\n          clearInterval(intervalId);\n        }\n      };\n    },\n    [tracker, autoRefresh, refreshInterval, limit],\n  );\n\n  const getSnapshot = React.useCallback(\n    (): TData => {\n      if (storeRef.current == null) {\n        return emptyData;\n      }\n      return storeRef.current.data;\n    },\n    [emptyData],\n  );\n\n  const data = React.useSyncExternalStore(subscribe, getSnapshot);\n\n  const refresh = React.useCallback(() => {\n    const store = storeRef.current;\n    if (store == null) {\n      return;\n    }\n    if (tracker) {\n      store.data = getDataRef.current(tracker, limit);\n    } else {\n      store.data = emptyDataRef.current;\n    }\n    for (const listener of store.listeners) {\n      listener();\n    }\n  }, [tracker, limit]);\n\n  return { data, refresh };\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/hooks/useUnusedFieldAnalysis.js

@@ -0,0 +1,99 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+import { UnusedFieldAnalyzer } from "../utils/UnusedFieldAnalyzer.js";
+class AnalysisStore {
+  state = {
+    report: null,
+    isLoading: true,
+    error: null
+  };
+  listeners = new Set();
+  isAnalyzing = false;
+  constructor(monitorStore, updateIntervalMs) {
+    this.monitorStore = monitorStore;
+    this.updateIntervalMs = updateIntervalMs;
+  }
+  subscribe(callback) {
+    this.listeners.add(callback);
+    if (this.listeners.size === 1) {
+      setTimeout(() => void this.analyze(), 0);
+      this.intervalId = setInterval(() => {
+        void this.analyze();
+      }, this.updateIntervalMs);
+    }
+    return () => {
+      this.listeners.delete(callback);
+      if (this.listeners.size === 0 && this.intervalId !== undefined) {
+        clearInterval(this.intervalId);
+        this.intervalId = undefined;
+      }
+    };
+  }
+  getSnapshot() {
+    return this.state;
+  }
+  async analyze() {
+    if (this.isAnalyzing) {
+      return;
+    }
+    this.isAnalyzing = true;
+    try {
+      this.state = {
+        ...this.state,
+        isLoading: true
+      };
+      this.notify();
+      const registry = this.monitorStore.getComponentRegistry();
+      const propertyTracker = this.monitorStore.getPropertyAccessTracker();
+      const cacheSnapshot = await this.monitorStore.getCacheSnapshot();
+      const analyzer = new UnusedFieldAnalyzer(registry, propertyTracker);
+      const report = analyzer.generateGlobalReport(cacheSnapshot);
+      this.state = {
+        report,
+        isLoading: false,
+        error: null
+      };
+      this.notify();
+    } catch (error) {
+      this.state = {
+        report: null,
+        isLoading: false,
+        error: error instanceof Error ? error : new Error(String(error))
+      };
+      this.notify();
+    } finally {
+      this.isAnalyzing = false;
+    }
+  }
+  notify() {
+    for (const listener of this.listeners) {
+      listener();
+    }
+  }
+}
+export function useUnusedFieldAnalysis(monitorStore, updateIntervalMs = 2000) {
+  const storeRef = React.useRef(null);
+  if (storeRef.current == null) {
+    storeRef.current = new AnalysisStore(monitorStore, updateIntervalMs);
+  }
+  const store = storeRef.current;
+  const subscribe = React.useCallback(callback => store.subscribe(callback), [store]);
+  const getSnapshot = React.useCallback(() => store.getSnapshot(), [store]);
+  return React.useSyncExternalStore(subscribe, getSnapshot);
+}
+//# sourceMappingURL=useUnusedFieldAnalysis.js.map

package/build/esm/hooks/useUnusedFieldAnalysis.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useUnusedFieldAnalysis.js","names":["React","UnusedFieldAnalyzer","AnalysisStore","state","report","isLoading","error","listeners","Set","isAnalyzing","constructor","monitorStore","updateIntervalMs","subscribe","callback","add","size","setTimeout","analyze","intervalId","setInterval","delete","undefined","clearInterval","getSnapshot","notify","registry","getComponentRegistry","propertyTracker","getPropertyAccessTracker","cacheSnapshot","getCacheSnapshot","analyzer","generateGlobalReport","Error","String","listener","useUnusedFieldAnalysis","storeRef","useRef","current","store","useCallback","useSyncExternalStore"],"sources":["useUnusedFieldAnalysis.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport type { MonitorStore } from \"../store/MonitorStore.js\";\nimport {\n  UnusedFieldAnalyzer,\n  type UnusedFieldReport,\n} from \"../utils/UnusedFieldAnalyzer.js\";\n\nexport interface UnusedFieldAnalysisState {\n  report: UnusedFieldReport | null;\n  isLoading: boolean;\n  error: Error | null;\n}\n\nclass AnalysisStore {\n  private state: UnusedFieldAnalysisState = {\n    report: null,\n    isLoading: true,\n    error: null,\n  };\n  private listeners = new Set<() => void>();\n  private intervalId: ReturnType<typeof setInterval> | undefined;\n  private isAnalyzing = false;\n\n  constructor(\n    private readonly monitorStore: MonitorStore,\n    private readonly updateIntervalMs: number,\n  ) {}\n\n  subscribe(callback: () => void): () => void {\n    this.listeners.add(callback);\n\n    if (this.listeners.size === 1) {\n      setTimeout(() => void this.analyze(), 0);\n      this.intervalId = setInterval(() => {\n        void this.analyze();\n      }, this.updateIntervalMs);\n    }\n\n    return () => {\n      this.listeners.delete(callback);\n      if (this.listeners.size === 0 && this.intervalId !== undefined) {\n        clearInterval(this.intervalId);\n        this.intervalId = undefined;\n      }\n    };\n  }\n\n  getSnapshot(): UnusedFieldAnalysisState {\n    return this.state;\n  }\n\n  private async analyze(): Promise<void> {\n    if (this.isAnalyzing) {\n      return;\n    }\n    this.isAnalyzing = true;\n\n    try {\n      this.state = { ...this.state, isLoading: true };\n      this.notify();\n\n      const registry = this.monitorStore.getComponentRegistry();\n      const propertyTracker = this.monitorStore.getPropertyAccessTracker();\n      const cacheSnapshot = await this.monitorStore.getCacheSnapshot();\n\n      const analyzer = new UnusedFieldAnalyzer(\n        registry,\n        propertyTracker,\n      );\n\n      const report = analyzer.generateGlobalReport(cacheSnapshot);\n\n      this.state = {\n        report,\n        isLoading: false,\n        error: null,\n      };\n      this.notify();\n    } catch (error) {\n      this.state = {\n        report: null,\n        isLoading: false,\n        error: error instanceof Error ? error : new Error(String(error)),\n      };\n      this.notify();\n    } finally {\n      this.isAnalyzing = false;\n    }\n  }\n\n  private notify(): void {\n    for (const listener of this.listeners) {\n      listener();\n    }\n  }\n}\n\nexport function useUnusedFieldAnalysis(\n  monitorStore: MonitorStore,\n  updateIntervalMs: number = 2000,\n): UnusedFieldAnalysisState {\n  const storeRef = React.useRef<AnalysisStore | null>(null);\n\n  if (\n    storeRef.current == null\n  ) {\n    storeRef.current = new AnalysisStore(monitorStore, updateIntervalMs);\n  }\n\n  const store = storeRef.current;\n\n  const subscribe = React.useCallback(\n    (callback: () => void) => store.subscribe(callback),\n    [store],\n  );\n\n  const getSnapshot = React.useCallback(\n    () => store.getSnapshot(),\n    [store],\n  );\n\n  return React.useSyncExternalStore(subscribe, getSnapshot);\n}\n"],"mappings":"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","ignoreList":[]}

package/build/esm/index.js

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import "./register.js";
+import "./styles.js";
+export { BubbleChart } from "./components/BubbleChart.js";
+export { MonitorErrorBoundary } from "./components/MonitorErrorBoundary.js";
+export { MonitoringPanel, SafeMonitoringPanel } from "./components/MonitoringPanel.js";
+export { OsdkAppErrorBoundary } from "./components/OsdkAppErrorBoundary.js";
+export { OsdkDevTools } from "./components/OsdkDevTools.js";
+export { useComputeMetrics, useComputeRecording, useComputeRequests } from "./hooks/useComputeSelectors.js";
+export { useMetrics } from "./hooks/useMetrics.js";
+export { usePersistedState } from "./hooks/usePersistedState.js";
+export { ComputeStore } from "./store/ComputeStore.js";
+export { MonitorStore } from "./store/MonitorStore.js";
+export { componentContextCapture } from "./utils/ComponentContextCapture.js";
+export { ComputeMonitor } from "./utils/ComputeMonitor.js";
+//# sourceMappingURL=index.js.map

package/build/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["BubbleChart","MonitorErrorBoundary","MonitoringPanel","SafeMonitoringPanel","OsdkAppErrorBoundary","OsdkDevTools","useComputeMetrics","useComputeRecording","useComputeRequests","useMetrics","usePersistedState","ComputeStore","MonitorStore","componentContextCapture","ComputeMonitor"],"sources":["index.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport \"./register.js\";\nimport \"./styles.js\";\n\nexport { BubbleChart } from \"./components/BubbleChart.js\";\nexport { MonitorErrorBoundary } from \"./components/MonitorErrorBoundary.js\";\nexport type { MonitorErrorBoundaryProps } from \"./components/MonitorErrorBoundary.js\";\nexport {\n  MonitoringPanel,\n  SafeMonitoringPanel,\n} from \"./components/MonitoringPanel.js\";\nexport type { MonitoringPanelProps } from \"./components/MonitoringPanel.js\";\nexport { OsdkAppErrorBoundary } from \"./components/OsdkAppErrorBoundary.js\";\nexport type { OsdkAppErrorBoundaryProps } from \"./components/OsdkAppErrorBoundary.js\";\nexport { OsdkDevTools } from \"./components/OsdkDevTools.js\";\n\nexport {\n  useComputeMetrics,\n  useComputeRecording,\n  useComputeRequests,\n} from \"./hooks/useComputeSelectors.js\";\nexport { useMetrics } from \"./hooks/useMetrics.js\";\nexport { usePersistedState } from \"./hooks/usePersistedState.js\";\n\nexport type { Fiber } from \"./fiber/types.js\";\nexport { ComputeStore } from \"./store/ComputeStore.js\";\nexport { MonitorStore } from \"./store/MonitorStore.js\";\nexport { componentContextCapture } from \"./utils/ComponentContextCapture.js\";\nexport type {\n  ComponentContext,\n  ComponentContextCapture,\n} from \"./utils/ComponentContextCapture.js\";\nexport type { ComponentQueryRegistry } from \"./utils/ComponentQueryRegistry.js\";\nexport { ComputeMonitor } from \"./utils/ComputeMonitor.js\";\n\nexport type {\n  AggregateMetrics,\n  MetricRates,\n  MetricsSnapshot,\n  Operation,\n  OperationMetadata,\n  OperationType,\n  PanelPosition,\n  TimeSeriesData,\n} from \"./types/index.js\";\n"],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAEA,OAAO,eAAe;AACtB,OAAO,aAAa;AAEpB,SAASA,WAAW,QAAQ,6BAA6B;AACzD,SAASC,oBAAoB,QAAQ,sCAAsC;AAE3E,SACEC,eAAe,EACfC,mBAAmB,QACd,iCAAiC;AAExC,SAASC,oBAAoB,QAAQ,sCAAsC;AAE3E,SAASC,YAAY,QAAQ,8BAA8B;AAE3D,SACEC,iBAAiB,EACjBC,mBAAmB,EACnBC,kBAAkB,QACb,gCAAgC;AACvC,SAASC,UAAU,QAAQ,uBAAuB;AAClD,SAASC,iBAAiB,QAAQ,8BAA8B;AAGhE,SAASC,YAAY,QAAQ,yBAAyB;AACtD,SAASC,YAAY,QAAQ,yBAAyB;AACtD,SAASC,uBAAuB,QAAQ,oCAAoC;AAM5E,SAASC,cAAc,QAAQ,2BAA2B","ignoreList":[]}

package/build/esm/inspector/ClickToInspectSystem.js

@@ -0,0 +1,228 @@
+/*
+ * Copyright 2025 Palantir Technologies, Inc. All rights reserved.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+import React from "react";
+import { createRoot } from "react-dom/client";
+import { InspectorBanner } from "./components/InspectorBanner.js";
+import { InspectorOverlay } from "./components/InspectorOverlay.js";
+import { createInspectorController } from "./inspectorController.js";
+export class ClickToInspectSystem {
+  state = {
+    active: false,
+    hoveredElement: null,
+    hoveredComponentId: null,
+    selectedComponentId: null
+  };
+  inspectorController = null;
+  bannerContainer = null;
+  bannerRoot = null;
+  overlayContainer = null;
+  overlayRoot = null;
+  stateUnsubscribe = null;
+  eventHandlers = new Map();
+  constructor(options = {}) {
+    this.options = options;
+    this.setupKeyboardShortcuts();
+  }
+  activate() {
+    if (this.state.active) {
+      return;
+    }
+    this.state.active = true;
+    this.inspectorController = createInspectorController({
+      containerElement: this.options.containerElement,
+      eventHandlers: {
+        onActivate: () => {
+          this.options.onActivate?.();
+        },
+        onDeactivate: () => {
+          this.deactivate();
+        },
+        onSelect: component => {
+          this.handleComponentSelected(component);
+        },
+        onHover: component => {
+          if (component) {
+            this.state.hoveredComponentId = component.name;
+          } else {
+            this.state.hoveredComponentId = null;
+          }
+        }
+      }
+    });
+    this.inspectorController.activate();
+    this.showOverlay();
+    this.showBanner();
+    this.setCursor("crosshair");
+  }
+  showOverlay() {
+    const renderTarget = this.options.renderTarget ?? document.body;
+    if (!this.overlayContainer) {
+      this.overlayContainer = document.createElement("div");
+      this.overlayContainer.id = "osdk-inspector-overlay";
+      this.overlayContainer.setAttribute("data-osdk-devtools-ignore", "");
+      renderTarget.appendChild(this.overlayContainer);
+      this.overlayRoot = createRoot(this.overlayContainer);
+    }
+    if (this.inspectorController) {
+      this.stateUnsubscribe = this.inspectorController.subscribe(controllerState => {
+        this.renderOverlay(controllerState);
+      });
+      this.renderOverlay(this.inspectorController.getState());
+    }
+  }
+  renderOverlay(controllerState) {
+    if (!this.overlayRoot) {
+      return;
+    }
+    this.overlayRoot.render(/*#__PURE__*/React.createElement(InspectorOverlay, {
+      state: controllerState
+    }));
+  }
+  hideOverlay() {
+    if (this.stateUnsubscribe) {
+      this.stateUnsubscribe();
+      this.stateUnsubscribe = null;
+    }
+    if (this.overlayRoot) {
+      this.overlayRoot.render(/*#__PURE__*/React.createElement(InspectorOverlay, {
+        state: {
+          mode: "inactive",
+          mouseX: -9999,
+          mouseY: -9999,
+          hoveredElement: null,
+          selectedElement: null,
+          frozenElement: null,
+          inspectedComponent: null,
+          selectionBounds: null,
+          labelPosition: null,
+          labelStatus: "idle",
+          viewportVersion: 0
+        }
+      }));
+    }
+  }
+  showBanner() {
+    const renderTarget = this.options.renderTarget ?? document.body;
+    if (!this.bannerContainer) {
+      this.bannerContainer = document.createElement("div");
+      this.bannerContainer.id = "osdk-inspector-banner";
+      renderTarget.appendChild(this.bannerContainer);
+      this.bannerRoot = createRoot(this.bannerContainer);
+    }
+    this.bannerRoot?.render(/*#__PURE__*/React.createElement(InspectorBanner, {
+      visible: true
+    }));
+  }
+  hideBanner() {
+    if (this.bannerRoot) {
+      this.bannerRoot.render(/*#__PURE__*/React.createElement(InspectorBanner, {
+        visible: false
+      }));
+    }
+  }
+  handleComponentSelected(component) {
+    this.state.selectedComponentId = component.name;
+    this.options.onSelect?.(component);
+    this.deactivate();
+  }
+  deactivate() {
+    if (!this.state.active) {
+      return;
+    }
+    this.state.active = false;
+    this.hideOverlay();
+    if (this.inspectorController) {
+      this.inspectorController.destroy();
+      this.inspectorController = null;
+    }
+    this.hideBanner();
+    this.setCursor("default");
+    this.clearHover();
+    this.options.onDeactivate?.();
+  }
+  toggle() {
+    if (this.state.active) {
+      this.deactivate();
+    } else {
+      this.activate();
+    }
+  }
+  setupKeyboardShortcuts() {
+    const existing = this.eventHandlers.get("keydown-global");
+    if (existing) {
+      window.removeEventListener(existing.eventType, existing.handler, true);
+      this.eventHandlers.delete("keydown-global");
+    }
+    const handler = e => {
+      const keyEvent = e;
+      if ((keyEvent.ctrlKey || keyEvent.metaKey) && keyEvent.shiftKey && keyEvent.key === "C") {
+        keyEvent.preventDefault();
+        keyEvent.stopPropagation();
+        this.toggle();
+      }
+      if (keyEvent.key === "Escape" && this.state.active) {
+        keyEvent.preventDefault();
+        keyEvent.stopPropagation();
+        this.deactivate();
+      }
+    };
+    window.addEventListener("keydown", handler, true);
+    this.eventHandlers.set("keydown-global", {
+      eventType: "keydown",
+      handler
+    });
+  }
+  clearHover() {
+    this.state.hoveredElement = null;
+    this.state.hoveredComponentId = null;
+  }
+  setCursor(cursor) {
+    document.body.style.cursor = cursor;
+  }
+  dispose() {
+    this.deactivate();
+    for (const {
+      eventType,
+      handler
+    } of this.eventHandlers.values()) {
+      window.removeEventListener(eventType, handler, true);
+    }
+    this.eventHandlers.clear();
+    if (this.bannerRoot) {
+      this.bannerRoot.unmount();
+      this.bannerRoot = null;
+    }
+    if (this.bannerContainer) {
+      this.bannerContainer.remove();
+      this.bannerContainer = null;
+    }
+    if (this.overlayRoot) {
+      this.overlayRoot.unmount();
+      this.overlayRoot = null;
+    }
+    if (this.overlayContainer) {
+      this.overlayContainer.remove();
+      this.overlayContainer = null;
+    }
+  }
+  getState() {
+    return {
+      ...this.state
+    };
+  }
+}
+//# sourceMappingURL=ClickToInspectSystem.js.map

package/build/esm/inspector/ClickToInspectSystem.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClickToInspectSystem.js","names":["React","createRoot","InspectorBanner","InspectorOverlay","createInspectorController","ClickToInspectSystem","state","active","hoveredElement","hoveredComponentId","selectedComponentId","inspectorController","bannerContainer","bannerRoot","overlayContainer","overlayRoot","stateUnsubscribe","eventHandlers","Map","constructor","options","setupKeyboardShortcuts","activate","containerElement","onActivate","onDeactivate","deactivate","onSelect","component","handleComponentSelected","onHover","name","showOverlay","showBanner","setCursor","renderTarget","document","body","createElement","id","setAttribute","appendChild","subscribe","controllerState","renderOverlay","getState","render","hideOverlay","mode","mouseX","mouseY","selectedElement","frozenElement","inspectedComponent","selectionBounds","labelPosition","labelStatus","viewportVersion","visible","hideBanner","destroy","clearHover","toggle","existing","get","window","removeEventListener","eventType","handler","delete","e","keyEvent","ctrlKey","metaKey","shiftKey","key","preventDefault","stopPropagation","addEventListener","set","cursor","style","dispose","values","clear","unmount","remove"],"sources":["ClickToInspectSystem.ts"],"sourcesContent":["/*\n * Copyright 2025 Palantir Technologies, Inc. All rights reserved.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport React from \"react\";\nimport { createRoot, type Root } from \"react-dom/client\";\nimport { InspectorBanner } from \"./components/InspectorBanner.js\";\nimport { InspectorOverlay } from \"./components/InspectorOverlay.js\";\nimport { createInspectorController } from \"./inspectorController.js\";\nimport type {\n  InspectedComponent,\n  InspectorController,\n  InspectorState as InspectorControllerState,\n} from \"./types.js\";\n\nexport interface ClickToInspectOptions {\n  containerElement?: HTMLElement;\n  renderTarget?: HTMLElement;\n  onSelect?: (component: InspectedComponent) => void;\n  onActivate?: () => void;\n  onDeactivate?: () => void;\n}\n\nexport interface InspectorState {\n  active: boolean;\n  hoveredElement: HTMLElement | null;\n  hoveredComponentId: string | null;\n  selectedComponentId: string | null;\n}\n\nexport class ClickToInspectSystem {\n  private state: InspectorState = {\n    active: false,\n    hoveredElement: null,\n    hoveredComponentId: null,\n    selectedComponentId: null,\n  };\n\n  private readonly options: ClickToInspectOptions;\n  private inspectorController: InspectorController | null = null;\n  private bannerContainer: HTMLDivElement | null = null;\n  private bannerRoot: Root | null = null;\n  private overlayContainer: HTMLDivElement | null = null;\n  private overlayRoot: Root | null = null;\n  private stateUnsubscribe: (() => void) | null = null;\n  private eventHandlers: Map<\n    string,\n    { eventType: string; handler: EventListener }\n  > = new Map();\n\n  constructor(options: ClickToInspectOptions = {}) {\n    this.options = options;\n    this.setupKeyboardShortcuts();\n  }\n\n  activate(): void {\n    if (this.state.active) {\n      return;\n    }\n\n    this.state.active = true;\n\n    this.inspectorController = createInspectorController({\n      containerElement: this.options.containerElement,\n      eventHandlers: {\n        onActivate: () => {\n          this.options.onActivate?.();\n        },\n        onDeactivate: () => {\n          this.deactivate();\n        },\n        onSelect: (component: InspectedComponent) => {\n          this.handleComponentSelected(component);\n        },\n        onHover: (component: InspectedComponent | null) => {\n          if (component) {\n            this.state.hoveredComponentId = component.name;\n          } else {\n            this.state.hoveredComponentId = null;\n          }\n        },\n      },\n    });\n\n    this.inspectorController.activate();\n\n    this.showOverlay();\n    this.showBanner();\n    this.setCursor(\"crosshair\");\n  }\n\n  private showOverlay(): void {\n    const renderTarget = this.options.renderTarget ?? document.body;\n\n    if (!this.overlayContainer) {\n      this.overlayContainer = document.createElement(\"div\");\n      this.overlayContainer.id = \"osdk-inspector-overlay\";\n      this.overlayContainer.setAttribute(\"data-osdk-devtools-ignore\", \"\");\n      renderTarget.appendChild(this.overlayContainer);\n      this.overlayRoot = createRoot(this.overlayContainer);\n    }\n\n    if (this.inspectorController) {\n      this.stateUnsubscribe = this.inspectorController.subscribe(\n        (controllerState) => {\n          this.renderOverlay(controllerState);\n        },\n      );\n\n      this.renderOverlay(this.inspectorController.getState());\n    }\n  }\n\n  private renderOverlay(controllerState: InspectorControllerState): void {\n    if (!this.overlayRoot) {\n      return;\n    }\n\n    this.overlayRoot.render(\n      React.createElement(InspectorOverlay, {\n        state: controllerState,\n      }),\n    );\n  }\n\n  private hideOverlay(): void {\n    if (this.stateUnsubscribe) {\n      this.stateUnsubscribe();\n      this.stateUnsubscribe = null;\n    }\n\n    if (this.overlayRoot) {\n      this.overlayRoot.render(\n        React.createElement(InspectorOverlay, {\n          state: {\n            mode: \"inactive\",\n            mouseX: -9999,\n            mouseY: -9999,\n            hoveredElement: null,\n            selectedElement: null,\n            frozenElement: null,\n            inspectedComponent: null,\n            selectionBounds: null,\n            labelPosition: null,\n            labelStatus: \"idle\",\n            viewportVersion: 0,\n          },\n        }),\n      );\n    }\n  }\n\n  private showBanner(): void {\n    const renderTarget = this.options.renderTarget ?? document.body;\n\n    if (!this.bannerContainer) {\n      this.bannerContainer = document.createElement(\"div\");\n      this.bannerContainer.id = \"osdk-inspector-banner\";\n      renderTarget.appendChild(this.bannerContainer);\n      this.bannerRoot = createRoot(this.bannerContainer);\n    }\n\n    this.bannerRoot?.render(\n      React.createElement(InspectorBanner, { visible: true }),\n    );\n  }\n\n  private hideBanner(): void {\n    if (this.bannerRoot) {\n      this.bannerRoot.render(\n        React.createElement(InspectorBanner, { visible: false }),\n      );\n    }\n  }\n\n  private handleComponentSelected(component: InspectedComponent): void {\n    this.state.selectedComponentId = component.name;\n    this.options.onSelect?.(component);\n    this.deactivate();\n  }\n\n  deactivate(): void {\n    if (!this.state.active) {\n      return;\n    }\n\n    this.state.active = false;\n\n    this.hideOverlay();\n\n    if (this.inspectorController) {\n      this.inspectorController.destroy();\n      this.inspectorController = null;\n    }\n\n    this.hideBanner();\n    this.setCursor(\"default\");\n    this.clearHover();\n\n    this.options.onDeactivate?.();\n  }\n\n  toggle(): void {\n    if (this.state.active) {\n      this.deactivate();\n    } else {\n      this.activate();\n    }\n  }\n\n  private setupKeyboardShortcuts(): void {\n    const existing = this.eventHandlers.get(\"keydown-global\");\n    if (existing) {\n      window.removeEventListener(existing.eventType, existing.handler, true);\n      this.eventHandlers.delete(\"keydown-global\");\n    }\n\n    const handler = (e: Event) => {\n      const keyEvent = e as KeyboardEvent;\n\n      if (\n        (keyEvent.ctrlKey || keyEvent.metaKey) && keyEvent.shiftKey\n        && keyEvent.key === \"C\"\n      ) {\n        keyEvent.preventDefault();\n        keyEvent.stopPropagation();\n        this.toggle();\n      }\n\n      if (keyEvent.key === \"Escape\" && this.state.active) {\n        keyEvent.preventDefault();\n        keyEvent.stopPropagation();\n        this.deactivate();\n      }\n    };\n\n    window.addEventListener(\"keydown\", handler, true);\n    this.eventHandlers.set(\"keydown-global\", { eventType: \"keydown\", handler });\n  }\n\n  private clearHover(): void {\n    this.state.hoveredElement = null;\n    this.state.hoveredComponentId = null;\n  }\n\n  private setCursor(cursor: string): void {\n    document.body.style.cursor = cursor;\n  }\n\n  dispose(): void {\n    this.deactivate();\n\n    for (const { eventType, handler } of this.eventHandlers.values()) {\n      window.removeEventListener(eventType, handler, true);\n    }\n    this.eventHandlers.clear();\n\n    if (this.bannerRoot) {\n      this.bannerRoot.unmount();\n      this.bannerRoot = null;\n    }\n    if (this.bannerContainer) {\n      this.bannerContainer.remove();\n      this.bannerContainer = null;\n    }\n\n    if (this.overlayRoot) {\n      this.overlayRoot.unmount();\n      this.overlayRoot = null;\n    }\n    if (this.overlayContainer) {\n      this.overlayContainer.remove();\n      this.overlayContainer = null;\n    }\n  }\n\n  getState(): InspectorState {\n    return { ...this.state };\n  }\n}\n"],"mappings":"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","ignoreList":[]}