@oddsquad/vite-plugin-lit 0.0.3 → 0.0.5

package/types/inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.js","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/types/inspector.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA8FH,iFAAiF;AACjF,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,CAAC;AAErD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,oBAAoB,GAAG,kBAAkB,CAAC;AAEvD,6EAA6E;AAC7E,MAAM,CAAC,MAAM,8BAA8B,GAAG,6BAA6B,CAAC;AAE5E,wEAAwE;AACxE,MAAM,CAAC,MAAM,YAAY,GAAG,yBAAyB,CAAC;AAEtD,mFAAmF;AACnF,MAAM,CAAC,MAAM,iBAAiB,GAAG,SAAS,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Shared types and channel/path constants for the Components inspector.\n *\n * The inspector lets the DevTools panel show a hierarchical tree of the Lit\n * components on the page plus a detail view (reactive properties, internal\n * state, attributes, source) of a selected element. The panel can't touch the\n * page DOM directly (separate iframe document), so everything flows over the\n * existing transport: panel → server (POST {@link INSPECT_PATH}) → app runtime\n * (HMR {@link INSPECT_CMD_CHANNEL}); app → server (HMR\n * {@link INSPECT_DATA_CHANNEL}) → panel (SSE `event: {@link INSPECT_SSE_EVENT}`).\n *\n * Elements are referenced across the boundary by the stable numeric id from the\n * timeline's `idOf()` WeakMap, so a tree node, a details payload, and an\n * inspector pick all agree on identity.\n */\n\nexport interface ElementSource {\n  file: string;\n  line: number;\n}\n\n/** A node in the component render tree (one inspectable Lit element). */\nexport interface InspectorTreeNode {\n  id: number;\n  tagName: string;\n  componentName?: string;\n  source?: ElementSource;\n  children: InspectorTreeNode[];\n}\n\n/** One reactive property (or internal `@state`) of an inspected element. */\nexport interface InspectorProp {\n  name: string;\n  /** Serialized, depth-limited preview of the current value. */\n  value: string;\n  /** A short type tag (`string`, `number`, `Array(3)`, `MyClass`, …). */\n  type: string;\n  /** The reflected attribute name, or `false` when `attribute: false`. */\n  attribute: string | false;\n  /** Whether the property reflects to its attribute. */\n  reflects: boolean;\n  /** Whether it's an internal `@state()` (no public attribute). */\n  state: boolean;\n}\n\n/** Full detail snapshot for a single inspected element. */\nexport interface InspectorDetails {\n  id: number;\n  tagName: string;\n  componentName?: string;\n  source?: ElementSource;\n  attributes: Array<{name: string; value: string}>;\n  properties: InspectorProp[];\n  flags: {\n    hasUpdated: boolean;\n    isUpdatePending: boolean;\n    hasShadowRoot: boolean;\n  };\n}\n\n/** App runtime → panel messages, carried on SSE `event: inspect`. */\nexport type InspectorMessage =\n  /** The runtime came online; the panel should (re)request the tree. */\n  | {type: 'ready'}\n  | {type: 'tree'; roots: InspectorTreeNode[]}\n  | {type: 'details'; details: InspectorDetails}\n  /** The requested element id couldn't be resolved (removed / GC'd). */\n  | {type: 'gone'; id: number}\n  /** An inspect-mode overlay pick — select this element in the panel. */\n  | {type: 'pick'; id: number};\n\n/** Panel → app runtime commands, POSTed to {@link INSPECT_PATH}. */\nexport type InspectorCommand =\n  | {type: 'tree'}\n  | {type: 'details'; id: number}\n  /** Keep pushing fresh details for `id` as it updates; `null` stops. */\n  | {type: 'watch'; id: number | null}\n  /** Outline element `id` in the page on tree hover; `null` clears it. */\n  | {type: 'highlight'; id: number | null}\n  /**\n   * Opt-in live tree: when enabled, the runtime watches the DOM and pushes a\n   * fresh `tree` message whenever the component hierarchy changes. Off by\n   * default (the panel otherwise refreshes on demand / on pick).\n   */\n  | {type: 'observe'; enabled: boolean}\n  /**\n   * Start the overlay's inspect-mode picker (the panel's \"Pick\" button). Handled\n   * by the server (it broadcasts {@link INSPECT_OVERLAY_TOGGLE_CHANNEL}), not the\n   * app runtime, so it never reaches the runtime's command handler.\n   */\n  | {type: 'pick'};\n\n/** HMR channel the server uses to forward a panel command to the app runtime. */\nexport const INSPECT_CMD_CHANNEL = 'lit:inspect:cmd';\n\n/** HMR channel the app runtime uses to push an {@link InspectorMessage}. */\nexport const INSPECT_DATA_CHANNEL = 'lit:inspect:data';\n\n/** Vite HMR channel the DevTools \"inspect element\" command broadcasts on. */\nexport const INSPECT_OVERLAY_TOGGLE_CHANNEL = 'lit-devtools:toggle-inspect';\n\n/** POST endpoint the panel uses to send an {@link InspectorCommand}. */\nexport const INSPECT_PATH = '/__lit-devtools-inspect';\n\n/** Named SSE event the server relays {@link InspectorMessage}s to the panel on. */\nexport const INSPECT_SSE_EVENT = 'inspect';\n"]}

package/types/timeline.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+export interface TimelineLayer {
+    id: string;
+    label: string;
+    color: number;
+}
+export interface TimelineEvent<TData = unknown> {
+    layerId: string;
+    /** `performance.now()` timestamp in the browser. */
+    time: number;
+    data: TData;
+    title?: string;
+    subtitle?: string;
+    /** Pairs a start event with its matching end event in the same update group. */
+    groupId?: number | string;
+    logType?: 'default' | 'warning' | 'error';
+    meta?: {
+        elementId?: number;
+        tagName?: string;
+        source?: {
+            file: string;
+            line: number;
+        };
+    };
+}
+export interface TimelineLayersState {
+    recordingState: boolean;
+    litLifecycleEnabled: boolean;
+    litRenderEnabled: boolean;
+    mouseEventEnabled: boolean;
+    keyboardEventEnabled: boolean;
+}
+export declare const TIMELINE_LAYERS: readonly TimelineLayer[];
+export declare const DEFAULT_LAYERS_STATE: TimelineLayersState;
+/**
+ * Snapshot of the plugin's resolved feature settings, surfaced in the panel's
+ * Settings tab. The plugin produces this at config time (explicit options >
+ * LIT_PLUGIN_* env > defaults) and serves it from the panel server. It's the
+ * baseline the panel shows; some HMR settings can then be overridden live (see
+ * {@link SettingsOverride}).
+ */
+export interface FeatureSettings {
+    hmr: {
+        enabled: boolean;
+        reconnect: boolean;
+        onIncompatible: 'reload' | 'warn';
+        indicatorEnabled: boolean;
+        indicatorCount: boolean;
+    };
+    sourceOverlay: {
+        enabled: boolean;
+        /** Hotkey letter combined with Ctrl+Shift to toggle the overlay. */
+        key: string;
+        editor: string;
+        throttleMs: number;
+    };
+    timeline: boolean;
+}
+/**
+ * Runtime overrides the panel applies on top of the resolved env config, for
+ * settings whose runtime is already injected (so they can change live). A
+ * feature disabled at config time has no runtime, so it can't be enabled here
+ * — only the behaviour of already-enabled features is overridable.
+ *
+ * Persisted under {@link SETTINGS_OVERRIDE_LS_KEY} (the panel and app share an
+ * origin) so overrides survive reloads, and pushed live over
+ * {@link SETTINGS_OVERRIDE_CHANNEL} via Vite HMR for immediate effect.
+ */
+export interface SettingsOverride {
+    hmrReconnect?: boolean;
+    hmrOnIncompatible?: 'reload' | 'warn';
+    hmrIndicatorVisible?: boolean;
+    hmrIndicatorCount?: boolean;
+    /** Built-in editor key for the source overlay's open-in-editor target. */
+    sourceOverlayEditor?: string;
+}
+/**
+ * Built-in editors the source overlay can open files in. Keep in sync with
+ * BUILTIN_EDITORS in lib/runtime/source-overlay/editors.ts.
+ */
+export declare const SOURCE_OVERLAY_EDITORS: ReadonlyArray<{
+    value: string;
+    label: string;
+}>;
+/** localStorage key holding the {@link SettingsOverride}. */
+export declare const SETTINGS_OVERRIDE_LS_KEY = "lit-devtools-overrides";
+/** Vite HMR channel the server uses to push overrides to the app runtime. */
+export declare const SETTINGS_OVERRIDE_CHANNEL = "lit-devtools:settings-override";
+/**
+ * Vite HMR channel the DevTools "toggle source overlay" command uses to tell
+ * the app runtime to toggle the overlay (the command handler runs server-side).
+ */
+export declare const SOURCE_OVERLAY_TOGGLE_CHANNEL = "lit-devtools:toggle-source-overlay";
+//# sourceMappingURL=timeline.d.ts.map

package/types/timeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/types/timeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa,CAAC,KAAK,GAAG,OAAO;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAC1C,IAAI,CAAC,EAAE;QACL,SAAS,CAAC,EAAE,MAAM,CAAC;QACnB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAC,CAAC;KACvC,CAAC;CACH;AAED,MAAM,WAAW,mBAAmB;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,eAAO,MAAM,eAAe,EAAE,SAAS,aAAa,EAKnD,CAAC;AAEF,eAAO,MAAM,oBAAoB,EAAE,mBAMlC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE;QACH,OAAO,EAAE,OAAO,CAAC;QACjB,SAAS,EAAE,OAAO,CAAC;QACnB,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;QAClC,gBAAgB,EAAE,OAAO,CAAC;QAC1B,cAAc,EAAE,OAAO,CAAC;KACzB,CAAC;IACF,aAAa,EAAE;QACb,OAAO,EAAE,OAAO,CAAC;QACjB,oEAAoE;QACpE,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;KACpB,CAAC;IACF,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,iBAAiB,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IACtC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,0EAA0E;IAC1E,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,aAAa,CAAC;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,CAMA,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,wBAAwB,2BAA2B,CAAC;AAEjE,6EAA6E;AAC7E,eAAO,MAAM,yBAAyB,mCAAmC,CAAC;AAE1E;;;GAGG;AACH,eAAO,MAAM,6BAA6B,uCACJ,CAAC"}

package/types/timeline.js

@@ -0,0 +1,39 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+export const TIMELINE_LAYERS = [
+    { id: 'lit-lifecycle', label: 'Lit Lifecycle', color: 0x4d63ff },
+    { id: 'lit-render', label: 'Lit Render', color: 0x325cff },
+    { id: 'mouse', label: 'Mouse', color: 0xa451af },
+    { id: 'keyboard', label: 'Keyboard', color: 0x8151af },
+];
+export const DEFAULT_LAYERS_STATE = {
+    recordingState: false,
+    litLifecycleEnabled: true,
+    litRenderEnabled: true,
+    mouseEventEnabled: false,
+    keyboardEventEnabled: false,
+};
+/**
+ * Built-in editors the source overlay can open files in. Keep in sync with
+ * BUILTIN_EDITORS in lib/runtime/source-overlay/editors.ts.
+ */
+export const SOURCE_OVERLAY_EDITORS = [
+    { value: 'vscode', label: 'VS Code' },
+    { value: 'cursor', label: 'Cursor' },
+    { value: 'zed', label: 'Zed' },
+    { value: 'idea', label: 'IntelliJ' },
+    { value: 'windsurf', label: 'Windsurf' },
+];
+/** localStorage key holding the {@link SettingsOverride}. */
+export const SETTINGS_OVERRIDE_LS_KEY = 'lit-devtools-overrides';
+/** Vite HMR channel the server uses to push overrides to the app runtime. */
+export const SETTINGS_OVERRIDE_CHANNEL = 'lit-devtools:settings-override';
+/**
+ * Vite HMR channel the DevTools "toggle source overlay" command uses to tell
+ * the app runtime to toggle the overlay (the command handler runs server-side).
+ */
+export const SOURCE_OVERLAY_TOGGLE_CHANNEL = 'lit-devtools:toggle-source-overlay';
+//# sourceMappingURL=timeline.js.map

package/types/timeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline.js","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/types/timeline.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiCH,MAAM,CAAC,MAAM,eAAe,GAA6B;IACvD,EAAC,EAAE,EAAE,eAAe,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,QAAQ,EAAC;IAC9D,EAAC,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY,EAAE,KAAK,EAAE,QAAQ,EAAC;IACxD,EAAC,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAC;IAC9C,EAAC,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAC;CACrD,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAwB;IACvD,cAAc,EAAE,KAAK;IACrB,mBAAmB,EAAE,IAAI;IACzB,gBAAgB,EAAE,IAAI;IACtB,iBAAiB,EAAE,KAAK;IACxB,oBAAoB,EAAE,KAAK;CAC5B,CAAC;AA8CF;;;GAGG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAG9B;IACH,EAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,EAAC;IACnC,EAAC,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAC;IAClC,EAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAC;IAC5B,EAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAC;IAClC,EAAC,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,EAAC;CACvC,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,wBAAwB,GAAG,wBAAwB,CAAC;AAEjE,6EAA6E;AAC7E,MAAM,CAAC,MAAM,yBAAyB,GAAG,gCAAgC,CAAC;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,6BAA6B,GACxC,oCAAoC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nexport interface TimelineLayer {\n  id: string;\n  label: string;\n  color: number; // 0xRRGGBB\n}\n\nexport interface TimelineEvent<TData = unknown> {\n  layerId: string;\n  /** `performance.now()` timestamp in the browser. */\n  time: number;\n  data: TData;\n  title?: string;\n  subtitle?: string;\n  /** Pairs a start event with its matching end event in the same update group. */\n  groupId?: number | string;\n  logType?: 'default' | 'warning' | 'error';\n  meta?: {\n    elementId?: number;\n    tagName?: string;\n    source?: {file: string; line: number};\n  };\n}\n\nexport interface TimelineLayersState {\n  recordingState: boolean;\n  litLifecycleEnabled: boolean;\n  litRenderEnabled: boolean;\n  mouseEventEnabled: boolean;\n  keyboardEventEnabled: boolean;\n}\n\nexport const TIMELINE_LAYERS: readonly TimelineLayer[] = [\n  {id: 'lit-lifecycle', label: 'Lit Lifecycle', color: 0x4d63ff},\n  {id: 'lit-render', label: 'Lit Render', color: 0x325cff},\n  {id: 'mouse', label: 'Mouse', color: 0xa451af},\n  {id: 'keyboard', label: 'Keyboard', color: 0x8151af},\n];\n\nexport const DEFAULT_LAYERS_STATE: TimelineLayersState = {\n  recordingState: false,\n  litLifecycleEnabled: true,\n  litRenderEnabled: true,\n  mouseEventEnabled: false,\n  keyboardEventEnabled: false,\n};\n\n/**\n * Snapshot of the plugin's resolved feature settings, surfaced in the panel's\n * Settings tab. The plugin produces this at config time (explicit options >\n * LIT_PLUGIN_* env > defaults) and serves it from the panel server. It's the\n * baseline the panel shows; some HMR settings can then be overridden live (see\n * {@link SettingsOverride}).\n */\nexport interface FeatureSettings {\n  hmr: {\n    enabled: boolean;\n    reconnect: boolean;\n    onIncompatible: 'reload' | 'warn';\n    indicatorEnabled: boolean;\n    indicatorCount: boolean;\n  };\n  sourceOverlay: {\n    enabled: boolean;\n    /** Hotkey letter combined with Ctrl+Shift to toggle the overlay. */\n    key: string;\n    editor: string;\n    throttleMs: number;\n  };\n  timeline: boolean;\n}\n\n/**\n * Runtime overrides the panel applies on top of the resolved env config, for\n * settings whose runtime is already injected (so they can change live). A\n * feature disabled at config time has no runtime, so it can't be enabled here\n * — only the behaviour of already-enabled features is overridable.\n *\n * Persisted under {@link SETTINGS_OVERRIDE_LS_KEY} (the panel and app share an\n * origin) so overrides survive reloads, and pushed live over\n * {@link SETTINGS_OVERRIDE_CHANNEL} via Vite HMR for immediate effect.\n */\nexport interface SettingsOverride {\n  hmrReconnect?: boolean;\n  hmrOnIncompatible?: 'reload' | 'warn';\n  hmrIndicatorVisible?: boolean;\n  hmrIndicatorCount?: boolean;\n  /** Built-in editor key for the source overlay's open-in-editor target. */\n  sourceOverlayEditor?: string;\n}\n\n/**\n * Built-in editors the source overlay can open files in. Keep in sync with\n * BUILTIN_EDITORS in lib/runtime/source-overlay/editors.ts.\n */\nexport const SOURCE_OVERLAY_EDITORS: ReadonlyArray<{\n  value: string;\n  label: string;\n}> = [\n  {value: 'vscode', label: 'VS Code'},\n  {value: 'cursor', label: 'Cursor'},\n  {value: 'zed', label: 'Zed'},\n  {value: 'idea', label: 'IntelliJ'},\n  {value: 'windsurf', label: 'Windsurf'},\n];\n\n/** localStorage key holding the {@link SettingsOverride}. */\nexport const SETTINGS_OVERRIDE_LS_KEY = 'lit-devtools-overrides';\n\n/** Vite HMR channel the server uses to push overrides to the app runtime. */\nexport const SETTINGS_OVERRIDE_CHANNEL = 'lit-devtools:settings-override';\n\n/**\n * Vite HMR channel the DevTools \"toggle source overlay\" command uses to tell\n * the app runtime to toggle the overlay (the command handler runs server-side).\n */\nexport const SOURCE_OVERLAY_TOGGLE_CHANNEL =\n  'lit-devtools:toggle-source-overlay';\n"]}