js.foresight-devtools 1.4.0 → 2.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Bart Spaans
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,6 +1,7 @@
 # js.foresight-devtools
 
 [![npm version](https://img.shields.io/npm/v/js.foresight-devtools.svg)](https://www.npmjs.com/package/js.foresight-devtools)
+[![npm downloads](https://img.shields.io/npm/dt/js.foresight-devtools.svg)](https://www.npmjs.com/package/js.foresight-devtools)
 [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
@@ -8,6 +9,8 @@
 
 These tools are built entirely using `ForesightJS`'s [built-in events](/docs/events), demonstrating how you can create your own monitoring and debugging tools using the same event system.
 
+Since the devtools observe the `ForesightManager` directly, they work with every Foresight integration: the [`js.foresight`](https://foresightjs.com/docs/getting-started/quick-start) core, the official [React](https://foresightjs.com/docs/react/installation) and [Vue](https://foresightjs.com/docs/vue/installation) packages, or your own [custom binding](https://foresightjs.com/docs/other-frameworks).
+
 ## Installation
 
 To install the `ForesightJS` Development Tools package, use your preferred package manager:
@@ -31,16 +34,19 @@ ForesightManager.initialize({})
 
 // Initialize the development tools (all options are optional)
 ForesightDevtools.initialize({
-  showDebugger: true,
+  show: {
+    controlPanel: true, // show the floating control panel
+    nameTags: true, // show the element name above each registered element
+    elementOverlays: true, // show the hit-slop boundary around each registered element
+    mouseTrajectory: true, // show the predicted mouse trajectory line
+    scrollTrajectory: true, // show the predicted scroll trajectory line
+  },
   isControlPanelDefaultMinimized: false, // optional setting which allows you to minimize the control panel on default
-  showNameTags: true, // optional setting which shows the name of the element
   sortElementList: "visibility", // optional setting for how the elements in the control panel are sorted
   logging: {
     logLocation: "controlPanel", // Where to log the Foresight Events
     callbackCompleted: true,
-    elementReactivated: true,
     callbackInvoked: true,
-    elementDataUpdated: false,
     elementRegistered: false,
     elementUnregistered: false,
     managerSettingsChanged: true,

package/dist/index.d.mts

@@ -0,0 +1,612 @@
+import { LitElement, PropertyValues, TemplateResult } from "lit";
+import { CallbackHitType, CallbackHits, ForesightElement, ForesightElementState, ForesightEvent, ForesightManagerData, ForesightManagerSettings, ForesightPoint, HitSlop, ScrollDirection, UpdatedManagerSetting } from "js.foresight";
+
+//#region src/types/types.d.ts
+type DeepPartial<T> = T extends object ? { [P in keyof T]?: DeepPartial<T[P]> } : T;
+type ShowSettings = {
+  /**
+   * Show the debugger control panel.
+   * @default true
+   */
+  controlPanel: boolean;
+  /**
+   * Show name tags above each registered element.
+   * @default true
+   */
+  nameTags: boolean;
+  /**
+   * Show element hit-slop overlays (the expanded boundary around each registered element).
+   *
+   * Note: turning this off also hides name tags, since the labels live inside
+   * the same overlay host.
+   *
+   * @default true
+   */
+  elementOverlays: boolean;
+  /**
+   * Show the predicted mouse trajectory line.
+   * @default true
+   */
+  mouseTrajectory: boolean;
+  /**
+   * Show the predicted scroll trajectory line.
+   * @default true
+   */
+  scrollTrajectory: boolean;
+};
+type ShowKey = keyof ShowSettings;
+type DevtoolsSettings = {
+  /**
+   * Granular visibility flags for the devtools UI.
+   *
+   * @link https://foresightjs.com/docs/getting_started/debug
+   */
+  show: ShowSettings;
+  /**
+   * Determines if the debugger control panel should be initialized in a minimized state.
+   *
+   * @link https://foresightjs.com/docs/getting_started/debug
+   *
+   * @default false
+   */
+  isControlPanelDefaultMinimized: boolean;
+  /**
+   * Specifies the default sorting order for the list of registered elements in the debugger panel.
+   * - `'visibility'`: Sorts elements by their viewport visibility (visible elements first),
+   *   with a secondary documentOrder sort.
+   * - `'documentOrder'`: Sorts elements based on their order of appearance in the
+   *   document's structure (matching the HTML source).
+   * - `'insertionOrder'`: Sorts by registration order.
+   *
+   *
+   * @link https://foresightjs.com/docs/getting_started/debug
+   *
+   * @default 'visibility'
+   *
+   */
+  sortElementList: SortElementList;
+  logging: LogEvents & {
+    logLocation: LoggingLocations;
+  };
+};
+type LogEvents = { [K in ForesightEvent]: boolean };
+type LoggingLocations = "controlPanel" | "console" | "both" | "none";
+type SortElementList = "documentOrder" | "visibility" | "insertionOrder";
+type DebuggerBooleanSettingKeys = ShowKey;
+//#endregion
+//#region src/lit-entry/control-panel/base-tab/chip.d.ts
+declare class ChipElement extends LitElement {
+  static styles: any[];
+  title: string;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "chip-element": ChipElement;
+  }
+} //# sourceMappingURL=chip.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/base-tab/tab-content.d.ts
+declare class TabContent extends LitElement {
+  static styles: any[];
+  noContentMessage: string;
+  hasContent: boolean;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "tab-content": TabContent;
+  }
+} //# sourceMappingURL=tab-content.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/base-tab/tab-header.d.ts
+declare class TabHeader extends LitElement {
+  static styles: any[];
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "tab-header": TabHeader;
+  }
+} //# sourceMappingURL=tab-header.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/dropdown/base-dropdown.d.ts
+type DropdownOption = {
+  value: string;
+  label: string;
+  title: string;
+  icon: TemplateResult;
+};
+declare abstract class BaseDropdown extends LitElement {
+  private static currentlyOpen;
+  static styles: any[];
+  protected isDropdownOpen: boolean;
+  dropdownOptions: DropdownOption[];
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  protected _toggleDropdown: (event: MouseEvent) => void;
+  protected _closeDropdown(): void;
+  protected _positionDropdown(): void;
+  protected _handleOutsideClick: (event: MouseEvent) => void;
+  protected abstract _handleOptionClick(option: DropdownOption): void;
+  protected abstract _getTriggerIcon(): TemplateResult;
+  protected abstract _isOptionSelected(option: DropdownOption): boolean;
+  protected abstract _getTriggerTitle(): string;
+  protected abstract _getTriggerLabel(): string;
+  render(): any;
+}
+//#endregion
+//#region src/lit-entry/control-panel/dropdown/single-select-dropdown.d.ts
+declare class SingleSelectDropdown extends BaseDropdown {
+  selectedOptionValue: string;
+  onSelectionChange?: (value: string) => void;
+  connectedCallback(): void;
+  willUpdate(changedProperties: Map<PropertyKey, unknown>): void;
+  protected _handleOptionClick(option: DropdownOption): void;
+  protected _getTriggerIcon(): TemplateResult;
+  protected _isOptionSelected(option: DropdownOption): boolean;
+  protected _getTriggerTitle(): string;
+  protected _getTriggerLabel(): string;
+  private _getSelectedOption;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "single-select-dropdown": SingleSelectDropdown;
+  }
+} //# sourceMappingURL=single-select-dropdown.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/copy-icon/copy-icon.d.ts
+declare class CopyIcon extends LitElement {
+  static styles: any;
+  title: string;
+  onCopy?: (event: MouseEvent) => Promise<void> | void;
+  private isCopied;
+  private copyTimeout;
+  private handleClick;
+  disconnectedCallback(): void;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "copy-icon": CopyIcon;
+  }
+} //# sourceMappingURL=copy-icon.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/base-tab/expandable-item.d.ts
+declare class ExpandableItem extends LitElement {
+  static styles: any[];
+  borderColor: string;
+  showCopyButton: boolean;
+  itemId: string;
+  isExpanded: boolean;
+  onToggle: ((itemId: string) => void) | undefined;
+  private toggleExpand;
+  private handleCopy;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "expandable-item": ExpandableItem;
+  }
+} //# sourceMappingURL=expandable-item.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/element-tab/reactivate-countdown.d.ts
+declare class ReactivateCountdown extends LitElement {
+  static styles: any[];
+  element: ForesightElement;
+  state: ForesightElementState;
+  private remainingTime;
+  private isCountdownActive;
+  private intervalId;
+  private startTime;
+  private lastDisplayedTime;
+  private countdownForElement;
+  private countdownReactivateAfter;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  willUpdate(changedProperties: Map<string | number | symbol, unknown>): void;
+  private checkAndStartCountdown;
+  private startCountdown;
+  private clearCountdown;
+  private handleTimerClick;
+  private formatTime;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "reactivate-countdown": ReactivateCountdown;
+  }
+} //# sourceMappingURL=reactivate-countdown.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/element-tab/single-element.d.ts
+declare class SingleElement extends LitElement {
+  static styles: any[];
+  element: ForesightElement;
+  state: ForesightElementState;
+  isExpanded: boolean;
+  onToggle: ((elementId: string) => void) | undefined;
+  private currentDeviceStrategy;
+  private _abortController;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  private getInactiveReasons;
+  private getBorderColor;
+  private getStatusIndicatorClass;
+  private getStatusText;
+  private formatElementDetails;
+  private handleUnregister;
+  private handleToggleEnabled;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "single-element": SingleElement;
+  }
+} //# sourceMappingURL=single-element.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/element-tab/element-tab.d.ts
+declare class ElementTab extends LitElement {
+  static styles: any;
+  private get hitCount();
+  private sortDropdown;
+  private sortOrder;
+  private elementListItems;
+  private noContentMessage;
+  private expandedElementIds;
+  private activeSectionCollapsed;
+  private inactiveSectionCollapsed;
+  private _abortController;
+  private _elementSubscriptions;
+  private _pendingElementUpdates;
+  private _updateDebounceId;
+  private _cachedActiveElements;
+  private _cachedInactiveElements;
+  private _elementsCacheDirty;
+  constructor();
+  private handleSortChange;
+  private handleElementToggle;
+  private _generateHitsChipTitle;
+  private _subscribeToElement;
+  private _unsubscribeFromElement;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  private _scheduleDebouncedUpdate;
+  private _flushPendingUpdates;
+  private updateElementListFromManager;
+  private getSortedElements;
+  private _recomputeElementsCache;
+  private get activeElements();
+  private get inactiveElements();
+  private sortByDocumentPosition;
+  private renderElementSection;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "element-tab": ElementTab;
+  }
+} //# sourceMappingURL=element-tab.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/dropdown/multi-select-dropdown.d.ts
+declare class MultiSelectDropdown extends BaseDropdown {
+  static styles: any[];
+  selectedValues: string[];
+  onSelectionChange?: (changedValue: string, isSelected: boolean) => void;
+  protected _handleOptionClick(option: DropdownOption): void;
+  protected _getTriggerIcon(): TemplateResult;
+  protected _isOptionSelected(option: DropdownOption): boolean;
+  protected _getTriggerTitle(): string;
+  protected _getTriggerLabel(): string;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "multi-select-dropdown": MultiSelectDropdown;
+  }
+} //# sourceMappingURL=multi-select-dropdown.d.ts.map
+//#endregion
+//#region src/helpers/safeSerializeEventData.d.ts
+type SerializedEventType = ForesightEvent | "serializationError" | "managerDataPayload";
+interface PayloadBase {
+  type: SerializedEventType;
+  localizedTimestamp: string;
+  summary: string;
+  logId: string;
+}
+interface ElementRegisteredPayload extends PayloadBase {
+  type: "elementRegistered";
+  name: string;
+  id: string;
+  state: ForesightElementState;
+  hitslop: HitSlop;
+  meta: Record<string, unknown>;
+}
+interface ElementUnregisteredEvent extends PayloadBase {
+  type: "elementUnregistered";
+  name: string;
+  id: string;
+  state: ForesightElementState;
+  meta: Record<string, unknown>;
+  wasLastRegisteredElement: boolean;
+}
+interface CallbackInvokedPayload extends PayloadBase {
+  type: "callbackInvoked";
+  name: string;
+  hitType: CallbackHitType;
+  state: ForesightElementState;
+  meta: Record<string, unknown>;
+}
+interface CallbackCompletedPayload extends PayloadBase {
+  type: "callbackCompleted";
+  elapsed: string;
+  name: string;
+  hitType: CallbackHitType;
+  status: "success" | "error" | undefined;
+  errorMessage: string | undefined | null;
+  state: ForesightElementState;
+  wasLastActiveElement: boolean;
+  meta: Record<string, unknown>;
+}
+interface MouseTrajectoryUpdatePayload extends PayloadBase {
+  type: "mouseTrajectoryUpdate";
+  currentPoint: ForesightPoint;
+  predictedPoint: ForesightPoint;
+  positionCount: number;
+  mousePredictionEnabled: boolean;
+}
+interface ScrollTrajectoryUpdatePayload extends PayloadBase {
+  type: "scrollTrajectoryUpdate";
+  currentPoint: ForesightPoint;
+  predictedPoint: ForesightPoint;
+  scrollDirection: ScrollDirection;
+}
+interface ManagerSettingsChangedPayload extends PayloadBase {
+  type: "managerSettingsChanged";
+  globalSettings: ForesightManagerSettings;
+  settingsChanged: UpdatedManagerSetting[];
+}
+interface DeviceStrategyChangedPayload extends PayloadBase {
+  type: "deviceStrategyChanged";
+  oldStrategy: string;
+  newStrategy: string;
+}
+interface SerializationErrorPayload extends PayloadBase {
+  type: "serializationError";
+  error: "Failed to serialize event data";
+  errorMessage: string;
+}
+interface ManagerDataPayload extends PayloadBase {
+  type: "managerDataPayload";
+  warning: string;
+  globalCallbackHits: CallbackHits;
+  eventListenerCount: Record<string, number>;
+  managerSettings: ForesightManagerSettings;
+  registeredElements: Array<ForesightElementState & {
+    elementInfo: string;
+  }>;
+  loadedModules: ForesightManagerData["loadedModules"];
+}
+type SerializedEventData = ElementRegisteredPayload | ElementUnregisteredEvent | CallbackInvokedPayload | CallbackCompletedPayload | MouseTrajectoryUpdatePayload | ScrollTrajectoryUpdatePayload | ManagerSettingsChangedPayload | DeviceStrategyChangedPayload | ManagerDataPayload | SerializationErrorPayload;
+//#endregion
+//#region src/lit-entry/control-panel/log-tab/single-log.d.ts
+declare class SingleLog extends LitElement {
+  static styles: any[];
+  log: SerializedEventData;
+  constructor(log: SerializedEventData);
+  isExpanded: boolean;
+  onToggle: ((logId: string) => void) | undefined;
+  protected updated(changedProperties: PropertyValues<this>): void;
+  private serializeLogDataWithoutSummary;
+  private getLogTypeColor;
+  private getEventDisplayName;
+  private truncateLogSummary;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "single-log": SingleLog;
+  }
+} //# sourceMappingURL=single-log.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/log-tab/log-tab.d.ts
+declare class LogTab extends LitElement {
+  static styles: any[];
+  private store;
+  private logDropdown;
+  private filterDropdown;
+  private expandedLogIds;
+  noContentMessage: string;
+  private _unsubscribeStore;
+  constructor();
+  private handleLogLocationChange;
+  private handleFilterChange;
+  private getSelectedEventFilters;
+  private shouldShowPerformanceWarning;
+  private getNoLogsMessage;
+  private handleLogToggle;
+  private clearLogs;
+  private logManagerData;
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "log-tab": LogTab;
+  }
+} //# sourceMappingURL=log-tab.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/settings-tab/setting-item/setting-item.d.ts
+declare class SettingItem extends LitElement {
+  static styles: any[];
+  header: string;
+  description: string;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "setting-item": SettingItem;
+  }
+} //# sourceMappingURL=setting-item.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/settings-tab/setting-item/setting-item-checkbox.d.ts
+type ShowSettingKey = `show.${ShowKey}`;
+declare class SettingItemCheckbox extends LitElement {
+  static styles: any[];
+  isChecked: boolean;
+  header: string;
+  description: string;
+  setting: keyof ForesightManagerSettings | keyof DevtoolsSettings | ShowSettingKey;
+  private handleCheckboxChange;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "setting-item-checkbox": SettingItemCheckbox;
+  }
+}
+//#endregion
+//#region src/lit-entry/control-panel/settings-tab/setting-item/setting-item-range.d.ts
+declare class SettingItemRange extends LitElement {
+  static styles: any[];
+  minValue: number;
+  maxValue: number;
+  currentValue: number;
+  unit: string;
+  header: string;
+  description: string;
+  setting: keyof ForesightManagerSettings;
+  private displayValue;
+  private handleRangeInput;
+  private handleRangeChange;
+  willUpdate(changedProperties: PropertyValues): void;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "setting-item-range": SettingItemRange;
+  }
+} //# sourceMappingURL=setting-item-range.d.ts.map
+//#endregion
+//#region src/lit-entry/control-panel/settings-tab/settings-tab.d.ts
+declare class SettingsTab extends LitElement {
+  static styles: any;
+  private managerSettings;
+  private initialSettings;
+  private devtoolsSettings;
+  private changedSettings;
+  private currentCorner;
+  private touchDeviceStrategyOptions;
+  private minimumConnectionTypeOptions;
+  private cornerOptions;
+  private _abortController;
+  constructor();
+  connectedCallback(): void;
+  disconnectedCallback(): void;
+  private _updateChangedSettings;
+  private _checkManagerSettingsChanges;
+  private _checkDevtoolsSettingsChanges;
+  private _handleDevtoolsSettingChange;
+  private _handleTouchDeviceStrategyChange;
+  private _handleMinimumConnectionTypeChange;
+  private _handleCornerChange;
+  private getCurrentCorner;
+  private handleCopySettings;
+  private generateSettingsCode;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "settings-tab": SettingsTab;
+  }
+} //# sourceMappingURL=settings-tab.d.ts.map
+//#endregion
+//#region src/lit-entry/debug-overlay/element-overlays.d.ts
+declare class ElementOverlays extends LitElement {
+  private overlayMap;
+  private callbackAnimations;
+  private _elementSubscriptions;
+  private containerElement;
+  showNameTags: boolean;
+  static styles: any[];
+  private _abortController;
+  connectedCallback(): void;
+  protected willUpdate(changed: PropertyValues<this>): void;
+  private _subscribeToElement;
+  private _unsubscribeFromElement;
+  private createOverlay;
+  /**
+   * The slop area is the element's own shape offset outward by the hit slop:
+   * every corner keeps the element's border radius, grown by the slop on each
+   * axis. Sharp corners stay sharp, since offsetting a rectangle outward does
+   * not round its corners.
+   */
+  private expandedBorderRadius;
+  private updateSlopArea;
+  private updateNameLabel;
+  private createOrUpdateElementOverlay;
+  private removeElementOverlay;
+  private clearCallbackAnimationTimeout;
+  private highlightElementCallback;
+  private unhighlightElementCallback;
+  updateNameTagVisibility(showNameTags: boolean): void;
+  disconnectedCallback(): void;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "element-overlays": ElementOverlays;
+  }
+} //# sourceMappingURL=element-overlays.d.ts.map
+//#endregion
+//#region src/lit-entry/debug-overlay/debug-overlay.d.ts
+declare class DebugOverlay extends LitElement {
+  static styles: any[];
+  private _abortController;
+  private _strategy;
+  showElementOverlays: boolean;
+  showMouseTrajectory: boolean;
+  showScrollTrajectory: boolean;
+  showNameTags: boolean;
+  connectedCallback(): void;
+  private handleDeviceStrategyChange;
+  disconnectedCallback(): void;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "debug-overlay": DebugOverlay;
+  }
+} //# sourceMappingURL=debug-overlay.d.ts.map
+//#endregion
+//#region src/lit-entry/foresight-devtools.d.ts
+declare class ForesightDevtools extends LitElement {
+  static styles: any[];
+  private isInitialized;
+  private static _instance;
+  devtoolsSettings: Required<DevtoolsSettings>;
+  private constructor();
+  private static createAndAppendInstance;
+  static initialize(props?: DeepPartial<DevtoolsSettings>): ForesightDevtools;
+  static get instance(): ForesightDevtools;
+  disconnectedCallback(): void;
+  private shouldUpdateSetting;
+  private updateLoggingSetting;
+  private updateShowSetting;
+  /**
+   * Set every flag inside `show` to the same value. Useful for "turn the
+   * entire devtools UI off" without listing each key.
+   */
+  setAllShow(value: boolean): void;
+  alterDevtoolsSettings(props?: DeepPartial<DevtoolsSettings>): void;
+  private cleanup;
+  render(): any;
+}
+declare global {
+  interface HTMLElementTagNameMap {
+    "foresight-devtools": ForesightDevtools;
+  }
+} //# sourceMappingURL=foresight-devtools.d.ts.map
+//#endregion
+export { type DebuggerBooleanSettingKeys, type DevtoolsSettings, ForesightDevtools, type SortElementList };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/types/types.ts","../src/lit-entry/control-panel/base-tab/chip.ts","../src/lit-entry/control-panel/base-tab/tab-content.ts","../src/lit-entry/control-panel/base-tab/tab-header.ts","../src/lit-entry/control-panel/dropdown/base-dropdown.ts","../src/lit-entry/control-panel/dropdown/single-select-dropdown.ts","../src/lit-entry/control-panel/copy-icon/copy-icon.ts","../src/lit-entry/control-panel/base-tab/expandable-item.ts","../src/lit-entry/control-panel/element-tab/reactivate-countdown.ts","../src/lit-entry/control-panel/element-tab/single-element.ts","../src/lit-entry/control-panel/element-tab/element-tab.ts","../src/lit-entry/control-panel/dropdown/multi-select-dropdown.ts","../src/helpers/safeSerializeEventData.ts","../src/lit-entry/control-panel/log-tab/single-log.ts","../src/lit-entry/control-panel/log-tab/log-tab.ts","../src/lit-entry/control-panel/settings-tab/setting-item/setting-item.ts","../src/lit-entry/control-panel/settings-tab/setting-item/setting-item-checkbox.ts","../src/lit-entry/control-panel/settings-tab/setting-item/setting-item-range.ts","../src/lit-entry/control-panel/settings-tab/settings-tab.ts","../src/lit-entry/debug-overlay/element-overlays.ts","../src/lit-entry/debug-overlay/debug-overlay.ts","../src/lit-entry/foresight-devtools.ts"],"mappings":"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"}