@oddsquad/vite-plugin-lit 0.2.3 → 0.4.0

package/lib/runtime/timeline/render.js

@@ -3,8 +3,8 @@
  * Copyright 2026 Google LLC
  * SPDX-License-Identifier: BSD-3-Clause
  */
-import { idOf, sourceOf } from './identity.js';
-import { now } from './clock.js';
+import {idOf, sourceOf} from './identity.js';
+import {now} from './clock.js';
 /**
  * Builds the element-identity `meta` for a render event from the render
  * `host` (the LitElement whose `render()` produced these debug events).
@@ -13,83 +13,218 @@ import { now } from './clock.js';
  * (e.g. a bare lit-html `render()` call not driven by a LitElement).
  */
 const hostMeta = (host) => {
-    if (host === null || typeof host !== 'object')
-        return undefined;
-    return {
-        elementId: idOf(host),
-        tagName: host.localName ?? 'unknown',
-        source: sourceOf(host),
-    };
+  if (host === null || typeof host !== 'object') return undefined;
+  return {
+    elementId: idOf(host),
+    tagName: host.localName ?? 'unknown',
+    source: sourceOf(host),
+  };
 };
+/** Reads the render `host` off a `Part` for the one kind (`set part`) whose
+ *  detail carries the part instead of the render `options` directly. */
+const partHost = (part) => part?.options?.host;
 let removeListener = null;
-const onLitDebug = (e, emit, recording, layerEnabled) => {
-    if (!recording() || !layerEnabled())
-        return;
-    const detail = e.detail;
-    if (!detail?.kind)
-        return;
-    const time = now();
-    const { kind, id } = detail;
-    switch (kind) {
-        case 'begin render': {
-            const meta = hostMeta(detail.options?.host);
-            emit({
-                layerId: 'lit-render',
-                time,
-                groupId: id,
-                title: 'render:start',
-                subtitle: meta?.tagName,
-                data: { kind, id },
-                meta,
-            });
-            break;
-        }
-        case 'end render': {
-            const meta = hostMeta(detail.options?.host);
-            emit({
-                layerId: 'lit-render',
-                time,
-                groupId: id,
-                title: 'render:end',
-                subtitle: meta?.tagName,
-                data: { kind, id },
-                meta,
-            });
-            break;
-        }
-        // `template prep` fires once per *unique* template, the first time it's
-        // compiled — low volume, useful as a "new template" marker.
-        case 'template prep':
-            emit({
-                layerId: 'lit-render',
-                time,
-                title: kind,
-                data: { kind, id },
-            });
-            break;
-        // `template updating` / `template instantiated` / `…and updated` fire once
-        // per template-bound ChildPart on *every* render — extremely high volume
-        // (a ticking clock or animation floods the layer). The begin/end render
-        // pair above already captures each render as a grouped duration, so these
-        // add noise without signal. Skip them; re-expose behind a "verbose" toggle
-        // if per-part detail is ever needed. Same rationale for commit * / set part.
-        default:
-            break;
+/**
+ * Reduces an arbitrary lit-html binding value to a small JSON-serializable
+ * summary for the verbose layer's `data` field. Never puts the value itself
+ * in `data` — it may be a DOM Node, a TemplateResult, a function, or hold a
+ * reference back to the host element, none of which survive (or belong in) a
+ * structured-clone over the HMR channel.
+ */
+const describeValue = (value) => {
+  if (value === null) return 'null';
+  if (value === undefined) return 'undefined';
+  if (typeof value === 'string') {
+    return value.length > 40
+      ? `string:"${value.slice(0, 40)}…"`
+      : `string:"${value}"`;
+  }
+  if (typeof value === 'number') return `number:${value}`;
+  if (typeof value === 'boolean') return `boolean:${value}`;
+  if (typeof value === 'function') {
+    return `function:${value.name || 'anonymous'}`;
+  }
+  // lit's sentinels (`nothing`, `noChange`) are symbols.
+  if (typeof value === 'symbol') return `symbol:${value.description ?? ''}`;
+  if (Array.isArray(value)) return `array(${value.length})`;
+  if (typeof value === 'object' && '_$litType$' in value) return 'template';
+  if (typeof Node !== 'undefined' && value instanceof Node) {
+    const tag = value.tagName?.toLowerCase();
+    return tag ? `node:<${tag}>` : `node:#${value.nodeType}`;
+  }
+  const ctor = value?.constructor?.name;
+  return `object:${ctor ?? 'Object'}`;
+};
+/** Summarizes each entry of a template-instance's `values` array. */
+const describeValues = (values) => values?.map(describeValue);
+const onLitDebug = (e, emit, recording, renderEnabled, verboseEnabled) => {
+  if (!recording() || (!renderEnabled() && !verboseEnabled())) return;
+  const detail = e.detail;
+  if (!detail?.kind) return;
+  const time = now();
+  const {kind, id} = detail;
+  switch (kind) {
+    case 'begin render': {
+      if (!renderEnabled()) break;
+      const meta = hostMeta(detail.options?.host);
+      emit({
+        layerId: 'lit-render',
+        time,
+        groupId: id,
+        title: 'render:start',
+        subtitle: meta?.tagName,
+        data: {kind, id},
+        meta,
+      });
+      break;
+    }
+    case 'end render': {
+      if (!renderEnabled()) break;
+      const meta = hostMeta(detail.options?.host);
+      emit({
+        layerId: 'lit-render',
+        time,
+        groupId: id,
+        title: 'render:end',
+        subtitle: meta?.tagName,
+        data: {kind, id},
+        meta,
+      });
+      break;
+    }
+    // `template prep` fires once per *unique* template, the first time it's
+    // compiled — low volume, useful as a "new template" marker.
+    case 'template prep':
+      if (!renderEnabled()) break;
+      emit({
+        layerId: 'lit-render',
+        time,
+        title: kind,
+        data: {kind, id},
+      });
+      break;
+    // The events below fire once per template-bound part on *every* render —
+    // extremely high volume (a ticking clock or animation floods the layer).
+    // The begin/end render pair above already captures each render as a
+    // grouped duration, so these live on the separate opt-in
+    // `lit-render-verbose` layer instead of adding noise to `lit-render`.
+    case 'template updating':
+    case 'template instantiated':
+    case 'template instantiated and updated': {
+      if (!verboseEnabled()) break;
+      const meta = hostMeta(detail.options?.host);
+      emit({
+        layerId: 'lit-render-verbose',
+        time,
+        title: kind,
+        subtitle: meta?.tagName,
+        data: {kind, values: describeValues(detail.values)},
+        meta,
+      });
+      break;
+    }
+    case 'set part': {
+      if (!verboseEnabled()) break;
+      const meta = hostMeta(partHost(detail.part));
+      emit({
+        layerId: 'lit-render-verbose',
+        time,
+        title: kind,
+        subtitle: meta?.tagName,
+        data: {
+          kind,
+          valueIndex: detail.valueIndex,
+          value: describeValue(detail.value),
+        },
+        meta,
+      });
+      break;
+    }
+    case 'commit nothing to child': {
+      if (!verboseEnabled()) break;
+      const meta = hostMeta(detail.options?.host);
+      emit({
+        layerId: 'lit-render-verbose',
+        time,
+        title: kind,
+        subtitle: meta?.tagName,
+        data: {kind},
+        meta,
+      });
+      break;
+    }
+    case 'commit text':
+    case 'commit node':
+    case 'commit to element binding': {
+      if (!verboseEnabled()) break;
+      const meta = hostMeta(detail.options?.host);
+      emit({
+        layerId: 'lit-render-verbose',
+        time,
+        title: kind,
+        subtitle: meta?.tagName,
+        data: {kind, value: describeValue(detail.value)},
+        meta,
+      });
+      break;
+    }
+    case 'commit attribute':
+    case 'commit property':
+    case 'commit boolean attribute': {
+      if (!verboseEnabled()) break;
+      const meta = hostMeta(detail.options?.host);
+      emit({
+        layerId: 'lit-render-verbose',
+        time,
+        title: kind,
+        subtitle: meta?.tagName,
+        data: {kind, name: detail.name, value: describeValue(detail.value)},
+        meta,
+      });
+      break;
+    }
+    case 'commit event listener': {
+      if (!verboseEnabled()) break;
+      const meta = hostMeta(detail.options?.host);
+      emit({
+        layerId: 'lit-render-verbose',
+        time,
+        title: kind,
+        subtitle: meta?.tagName,
+        data: {
+          kind,
+          name: detail.name,
+          addListener: detail.addListener,
+          removeListener: detail.removeListener,
+        },
+        meta,
+      });
+      break;
     }
+    // Unknown or future `*Unstable` kind — ignore rather than guess a shape.
+    default:
+      break;
+  }
 };
 /**
- * Install the lit-debug render layer.
+ * Install the lit-debug render layers (`lit-render` and the opt-in
+ * `lit-render-verbose`).
  * Idempotent — calling again when already installed is a no-op.
  */
-export const installRenderLayer = (emit, recording, layerEnabled) => {
-    if (removeListener !== null)
-        return;
-    // The listener is cheap and always attached; the per-render cost lives in the
-    // `emitLitDebugLogEvents` flag, which the caller toggles via
-    // `setRenderDebugEnabled` only while actively capturing.
-    const handler = (e) => onLitDebug(e, emit, recording, layerEnabled);
-    window.addEventListener('lit-debug', handler);
-    removeListener = () => window.removeEventListener('lit-debug', handler);
+export const installRenderLayer = (
+  emit,
+  recording,
+  renderEnabled,
+  verboseEnabled
+) => {
+  if (removeListener !== null) return;
+  // The listener is cheap and always attached; the per-render cost lives in the
+  // `emitLitDebugLogEvents` flag, which the caller toggles via
+  // `setRenderDebugEnabled` only while actively capturing.
+  const handler = (e) =>
+    onLitDebug(e, emit, recording, renderEnabled, verboseEnabled);
+  window.addEventListener('lit-debug', handler);
+  removeListener = () => window.removeEventListener('lit-debug', handler);
 };
 /**
  * Toggle Lit's debug event system. Enabling makes lit-html dispatch a
@@ -97,13 +232,12 @@ export const installRenderLayer = (emit, recording, layerEnabled) => {
  * keeps it off unless the render layer is actively recording.
  */
 export const setRenderDebugEnabled = (enabled) => {
-    globalThis.emitLitDebugLogEvents =
-        enabled;
+  globalThis.emitLitDebugLogEvents = enabled;
 };
 /** Remove the listener and clear the Lit debug flag. */
 export const uninstallRenderLayer = () => {
-    removeListener?.();
-    removeListener = null;
-    setRenderDebugEnabled(false);
+  removeListener?.();
+  removeListener = null;
+  setRenderDebugEnabled(false);
 };
-//# sourceMappingURL=render.js.map
+//# sourceMappingURL=render.js.map

package/lib/runtime/timeline/render.js.map

@@ -1 +1 @@
-{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/timeline/render.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * lit-render timeline layer — listens to the built-in lit-debug CustomEvents\n * instead of patching prototypes, so it's zero-cost when the Lit debug flag\n * is off and perfectly accurate for the render layer.\n *\n * `globalThis.emitLitDebugLogEvents = true` gates the events, and lit-html\n * dispatches a CustomEvent per render whenever it's set — a real per-render\n * cost. So the caller drives the flag via {@link setRenderDebugEnabled} from\n * `recording × layer-enabled` rather than leaving it on for the whole session.\n * The events are tagged `*Unstable` in the Lit source; we tolerate missing\n * `kind` values gracefully.\n *\n * begin render / end render share a numeric `id` → we use it as groupId so\n * the panel can show a duration bar for each render call.\n */\n\nimport type {TimelineEvent} from '../../../types/timeline.js';\nimport {idOf, sourceOf} from './identity.js';\nimport {now} from './clock.js';\n\ntype EmitFn = (event: TimelineEvent) => void;\ntype RecordingFn = () => boolean;\ntype LayerEnabledFn = () => boolean;\n\n/** Minimal shape of the lit-debug event detail we care about. */\ninterface LitDebugDetail {\n  kind: string;\n  id?: number;\n  template?: unknown;\n  instance?: unknown;\n  /** Render options passed to lit-html's `render()`; `host` is the element. */\n  options?: {host?: unknown};\n}\n\n/**\n * Builds the element-identity `meta` for a render event from the render\n * `host` (the LitElement whose `render()` produced these debug events).\n * Uses the same id/source maps as the lifecycle layer so an element keeps one\n * stable id across both layers. Returns undefined for host-less renders\n * (e.g. a bare lit-html `render()` call not driven by a LitElement).\n */\nconst hostMeta = (\n  host: unknown\n): NonNullable<TimelineEvent['meta']> | undefined => {\n  if (host === null || typeof host !== 'object') return undefined;\n  return {\n    elementId: idOf(host),\n    tagName: (host as Element).localName ?? 'unknown',\n    source: sourceOf(host),\n  };\n};\n\ntype LitDebugEvent = CustomEvent<LitDebugDetail>;\n\nlet removeListener: (() => void) | null = null;\n\nconst onLitDebug = (\n  e: Event,\n  emit: EmitFn,\n  recording: RecordingFn,\n  layerEnabled: LayerEnabledFn\n): void => {\n  if (!recording() || !layerEnabled()) return;\n\n  const detail = (e as LitDebugEvent).detail;\n  if (!detail?.kind) return;\n\n  const time = now();\n  const {kind, id} = detail;\n\n  switch (kind) {\n    case 'begin render': {\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render',\n        time,\n        groupId: id,\n        title: 'render:start',\n        subtitle: meta?.tagName,\n        data: {kind, id},\n        meta,\n      });\n      break;\n    }\n\n    case 'end render': {\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render',\n        time,\n        groupId: id,\n        title: 'render:end',\n        subtitle: meta?.tagName,\n        data: {kind, id},\n        meta,\n      });\n      break;\n    }\n\n    // `template prep` fires once per *unique* template, the first time it's\n    // compiled — low volume, useful as a \"new template\" marker.\n    case 'template prep':\n      emit({\n        layerId: 'lit-render',\n        time,\n        title: kind,\n        data: {kind, id},\n      });\n      break;\n\n    // `template updating` / `template instantiated` / `…and updated` fire once\n    // per template-bound ChildPart on *every* render — extremely high volume\n    // (a ticking clock or animation floods the layer). The begin/end render\n    // pair above already captures each render as a grouped duration, so these\n    // add noise without signal. Skip them; re-expose behind a \"verbose\" toggle\n    // if per-part detail is ever needed. Same rationale for commit * / set part.\n    default:\n      break;\n  }\n};\n\n/**\n * Install the lit-debug render layer.\n * Idempotent — calling again when already installed is a no-op.\n */\nexport const installRenderLayer = (\n  emit: EmitFn,\n  recording: RecordingFn,\n  layerEnabled: LayerEnabledFn\n): void => {\n  if (removeListener !== null) return;\n\n  // The listener is cheap and always attached; the per-render cost lives in the\n  // `emitLitDebugLogEvents` flag, which the caller toggles via\n  // `setRenderDebugEnabled` only while actively capturing.\n  const handler = (e: Event) => onLitDebug(e, emit, recording, layerEnabled);\n  window.addEventListener('lit-debug', handler);\n  removeListener = () => window.removeEventListener('lit-debug', handler);\n};\n\n/**\n * Toggle Lit's debug event system. Enabling makes lit-html dispatch a\n * CustomEvent on every render (dev-only; no-op in prod builds), so the caller\n * keeps it off unless the render layer is actively recording.\n */\nexport const setRenderDebugEnabled = (enabled: boolean): void => {\n  (globalThis as {emitLitDebugLogEvents?: boolean}).emitLitDebugLogEvents =\n    enabled;\n};\n\n/** Remove the listener and clear the Lit debug flag. */\nexport const uninstallRenderLayer = (): void => {\n  removeListener?.();\n  removeListener = null;\n  setRenderDebugEnabled(false);\n};\n"]}
+{"version":3,"file":"render.js","sourceRoot":"","sources":["../../../src/lib/runtime/timeline/render.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * lit-render timeline layers — listen to the built-in lit-debug CustomEvents\n * instead of patching prototypes, so they're zero-cost when the Lit debug\n * flag is off and perfectly accurate for the render layers.\n *\n * `globalThis.emitLitDebugLogEvents = true` gates the events, and lit-html\n * dispatches a CustomEvent per render whenever it's set — a real per-render\n * cost. So the caller drives the flag via {@link setRenderDebugEnabled} from\n * `recording × (lit-render OR lit-render-verbose enabled)` rather than\n * leaving it on for the whole session.\n * The events are tagged `*Unstable` in the Lit source; we tolerate missing\n * `kind` values gracefully.\n *\n * begin render / end render share a numeric `id` → we use it as groupId so\n * the panel can show a duration bar for each render call.\n *\n * `template updating` / `template instantiated[ and updated]` / `set part` /\n * `commit *` fire once per template-bound part on *every* render — extremely\n * high volume (a ticking clock or animation floods the layer). They're\n * emitted on the separate opt-in `lit-render-verbose` layer rather than\n * `lit-render`, so the common case (the begin/end render duration bar) stays\n * quiet by default.\n */\n\nimport type {TimelineEvent} from '../../../types/timeline.js';\nimport {idOf, sourceOf} from './identity.js';\nimport {now} from './clock.js';\n\ntype EmitFn = (event: TimelineEvent) => void;\ntype RecordingFn = () => boolean;\ntype LayerEnabledFn = () => boolean;\n\n/**\n * Minimal shape of the lit-debug event detail we care about. Broader than any\n * single `kind` needs — see lit-html's `LitUnstable.DebugLog.Entry` union in\n * `packages/lit-html/src/lit-html.ts` for the exact per-kind shapes; fields\n * below are the ones this layer reads across all of them.\n */\ninterface LitDebugDetail {\n  kind: string;\n  id?: number;\n  template?: unknown;\n  instance?: unknown;\n  /** Render options passed to lit-html's `render()`; `host` is the element. */\n  options?: {host?: unknown};\n  /** `template updating` / `template instantiated[ and updated]`. */\n  values?: unknown[];\n  /** `set part` / most `commit *` kinds. */\n  value?: unknown;\n  /**\n   * `set part` only. Unlike every other kind, `set part` carries no\n   * top-level `options` — the host lives on the `Part` instance itself\n   * (`ChildPart` / `AttributePart` / `EventPart` / `ElementPart` all expose a\n   * public `options: RenderOptions | undefined`), so the host is derived via\n   * {@link partHost} instead of `options?.host` directly.\n   */\n  part?: {options?: {host?: unknown}};\n  /** `set part`. */\n  valueIndex?: number;\n  /** `commit attribute` / `commit property` / `commit boolean attribute` /\n   *  `commit event listener`. */\n  name?: string;\n  /** `commit event listener`. */\n  addListener?: boolean;\n  removeListener?: boolean;\n}\n\n/**\n * Builds the element-identity `meta` for a render event from the render\n * `host` (the LitElement whose `render()` produced these debug events).\n * Uses the same id/source maps as the lifecycle layer so an element keeps one\n * stable id across both layers. Returns undefined for host-less renders\n * (e.g. a bare lit-html `render()` call not driven by a LitElement).\n */\nconst hostMeta = (\n  host: unknown\n): NonNullable<TimelineEvent['meta']> | undefined => {\n  if (host === null || typeof host !== 'object') return undefined;\n  return {\n    elementId: idOf(host),\n    tagName: (host as Element).localName ?? 'unknown',\n    source: sourceOf(host),\n  };\n};\n\n/** Reads the render `host` off a `Part` for the one kind (`set part`) whose\n *  detail carries the part instead of the render `options` directly. */\nconst partHost = (part: LitDebugDetail['part']): unknown => part?.options?.host;\n\ntype LitDebugEvent = CustomEvent<LitDebugDetail>;\n\nlet removeListener: (() => void) | null = null;\n\n/**\n * Reduces an arbitrary lit-html binding value to a small JSON-serializable\n * summary for the verbose layer's `data` field. Never puts the value itself\n * in `data` — it may be a DOM Node, a TemplateResult, a function, or hold a\n * reference back to the host element, none of which survive (or belong in) a\n * structured-clone over the HMR channel.\n */\nconst describeValue = (value: unknown): string => {\n  if (value === null) return 'null';\n  if (value === undefined) return 'undefined';\n  if (typeof value === 'string') {\n    return value.length > 40\n      ? `string:\"${value.slice(0, 40)}…\"`\n      : `string:\"${value}\"`;\n  }\n  if (typeof value === 'number') return `number:${value}`;\n  if (typeof value === 'boolean') return `boolean:${value}`;\n  if (typeof value === 'function') {\n    return `function:${value.name || 'anonymous'}`;\n  }\n  // lit's sentinels (`nothing`, `noChange`) are symbols.\n  if (typeof value === 'symbol') return `symbol:${value.description ?? ''}`;\n  if (Array.isArray(value)) return `array(${value.length})`;\n  if (typeof value === 'object' && '_$litType$' in value) return 'template';\n  if (typeof Node !== 'undefined' && value instanceof Node) {\n    const tag = (value as Partial<Element>).tagName?.toLowerCase();\n    return tag ? `node:<${tag}>` : `node:#${value.nodeType}`;\n  }\n  const ctor = (value as {constructor?: {name?: string}})?.constructor?.name;\n  return `object:${ctor ?? 'Object'}`;\n};\n\n/** Summarizes each entry of a template-instance's `values` array. */\nconst describeValues = (values: unknown[] | undefined): string[] | undefined =>\n  values?.map(describeValue);\n\nconst onLitDebug = (\n  e: Event,\n  emit: EmitFn,\n  recording: RecordingFn,\n  renderEnabled: LayerEnabledFn,\n  verboseEnabled: LayerEnabledFn\n): void => {\n  if (!recording() || (!renderEnabled() && !verboseEnabled())) return;\n\n  const detail = (e as LitDebugEvent).detail;\n  if (!detail?.kind) return;\n\n  const time = now();\n  const {kind, id} = detail;\n\n  switch (kind) {\n    case 'begin render': {\n      if (!renderEnabled()) break;\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render',\n        time,\n        groupId: id,\n        title: 'render:start',\n        subtitle: meta?.tagName,\n        data: {kind, id},\n        meta,\n      });\n      break;\n    }\n\n    case 'end render': {\n      if (!renderEnabled()) break;\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render',\n        time,\n        groupId: id,\n        title: 'render:end',\n        subtitle: meta?.tagName,\n        data: {kind, id},\n        meta,\n      });\n      break;\n    }\n\n    // `template prep` fires once per *unique* template, the first time it's\n    // compiled — low volume, useful as a \"new template\" marker.\n    case 'template prep':\n      if (!renderEnabled()) break;\n      emit({\n        layerId: 'lit-render',\n        time,\n        title: kind,\n        data: {kind, id},\n      });\n      break;\n\n    // The events below fire once per template-bound part on *every* render —\n    // extremely high volume (a ticking clock or animation floods the layer).\n    // The begin/end render pair above already captures each render as a\n    // grouped duration, so these live on the separate opt-in\n    // `lit-render-verbose` layer instead of adding noise to `lit-render`.\n    case 'template updating':\n    case 'template instantiated':\n    case 'template instantiated and updated': {\n      if (!verboseEnabled()) break;\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render-verbose',\n        time,\n        title: kind,\n        subtitle: meta?.tagName,\n        data: {kind, values: describeValues(detail.values)},\n        meta,\n      });\n      break;\n    }\n\n    case 'set part': {\n      if (!verboseEnabled()) break;\n      const meta = hostMeta(partHost(detail.part));\n      emit({\n        layerId: 'lit-render-verbose',\n        time,\n        title: kind,\n        subtitle: meta?.tagName,\n        data: {\n          kind,\n          valueIndex: detail.valueIndex,\n          value: describeValue(detail.value),\n        },\n        meta,\n      });\n      break;\n    }\n\n    case 'commit nothing to child': {\n      if (!verboseEnabled()) break;\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render-verbose',\n        time,\n        title: kind,\n        subtitle: meta?.tagName,\n        data: {kind},\n        meta,\n      });\n      break;\n    }\n\n    case 'commit text':\n    case 'commit node':\n    case 'commit to element binding': {\n      if (!verboseEnabled()) break;\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render-verbose',\n        time,\n        title: kind,\n        subtitle: meta?.tagName,\n        data: {kind, value: describeValue(detail.value)},\n        meta,\n      });\n      break;\n    }\n\n    case 'commit attribute':\n    case 'commit property':\n    case 'commit boolean attribute': {\n      if (!verboseEnabled()) break;\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render-verbose',\n        time,\n        title: kind,\n        subtitle: meta?.tagName,\n        data: {kind, name: detail.name, value: describeValue(detail.value)},\n        meta,\n      });\n      break;\n    }\n\n    case 'commit event listener': {\n      if (!verboseEnabled()) break;\n      const meta = hostMeta(detail.options?.host);\n      emit({\n        layerId: 'lit-render-verbose',\n        time,\n        title: kind,\n        subtitle: meta?.tagName,\n        data: {\n          kind,\n          name: detail.name,\n          addListener: detail.addListener,\n          removeListener: detail.removeListener,\n        },\n        meta,\n      });\n      break;\n    }\n\n    // Unknown or future `*Unstable` kind — ignore rather than guess a shape.\n    default:\n      break;\n  }\n};\n\n/**\n * Install the lit-debug render layers (`lit-render` and the opt-in\n * `lit-render-verbose`).\n * Idempotent — calling again when already installed is a no-op.\n */\nexport const installRenderLayer = (\n  emit: EmitFn,\n  recording: RecordingFn,\n  renderEnabled: LayerEnabledFn,\n  verboseEnabled: LayerEnabledFn\n): void => {\n  if (removeListener !== null) return;\n\n  // The listener is cheap and always attached; the per-render cost lives in the\n  // `emitLitDebugLogEvents` flag, which the caller toggles via\n  // `setRenderDebugEnabled` only while actively capturing.\n  const handler = (e: Event) =>\n    onLitDebug(e, emit, recording, renderEnabled, verboseEnabled);\n  window.addEventListener('lit-debug', handler);\n  removeListener = () => window.removeEventListener('lit-debug', handler);\n};\n\n/**\n * Toggle Lit's debug event system. Enabling makes lit-html dispatch a\n * CustomEvent on every render (dev-only; no-op in prod builds), so the caller\n * keeps it off unless the render layer is actively recording.\n */\nexport const setRenderDebugEnabled = (enabled: boolean): void => {\n  (globalThis as {emitLitDebugLogEvents?: boolean}).emitLitDebugLogEvents =\n    enabled;\n};\n\n/** Remove the listener and clear the Lit debug flag. */\nexport const uninstallRenderLayer = (): void => {\n  removeListener?.();\n  removeListener = null;\n  setRenderDebugEnabled(false);\n};\n"]}

package/lib/runtime/timeline/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/timeline/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC;AAE9D,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9C,CAAC;AAmBF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,SAAS,KAAG,IAe7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,GAAI,IAAI,MAAM,IAAI,KAAG,IAMrD,CAAC;AAaF;;;;GAIG;AACH,eAAO,MAAM,IAAI,GAAI,OAAO,aAAa,KAAG,IAc3C,CAAC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/lib/runtime/timeline/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAC,aAAa,EAAC,MAAM,4BAA4B,CAAC;AAE9D,KAAK,SAAS,GAAG;IACf,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,KAAK,IAAI,CAAC;CAC9C,CAAC;AAmBF;;;;GAIG;AACH,eAAO,MAAM,YAAY,QAAS,SAAS,KAAG,IAe7C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,oBAAoB,OAAQ,MAAM,IAAI,KAAG,IAMrD,CAAC;AAaF;;;;GAIG;AACH,eAAO,MAAM,IAAI,UAAW,aAAa,KAAG,IAc3C,CAAC"}

package/lib/runtime/timeline/transport.js

@@ -23,45 +23,41 @@ const pendingCallbacks = [];
  * Flushes any queued events and fires pending one-shot callbacks.
  */
 export const setHotClient = (hot) => {
-    hotClient = hot;
-    // Drain any events that arrived before the client was wired.
-    if (queue.length > 0 && !flushScheduled) {
-        flushScheduled = true;
-        queueMicrotask(flush);
-    }
-    // Fire one-shot callbacks (e.g. addTimelineLayer announcements).
-    for (const cb of pendingCallbacks.splice(0)) {
-        try {
-            cb();
-        }
-        catch {
-            // ignore
-        }
+  hotClient = hot;
+  // Drain any events that arrived before the client was wired.
+  if (queue.length > 0 && !flushScheduled) {
+    flushScheduled = true;
+    queueMicrotask(flush);
+  }
+  // Fire one-shot callbacks (e.g. addTimelineLayer announcements).
+  for (const cb of pendingCallbacks.splice(0)) {
+    try {
+      cb();
+    } catch {
+      // ignore
     }
+  }
 };
 /**
  * Register a callback to be invoked once the HMR client is available.
  * If the client is already set the callback is fired on the next microtask.
  */
 export const setHotClientCallback = (cb) => {
-    if (hotClient !== null) {
-        queueMicrotask(cb);
-    }
-    else {
-        pendingCallbacks.push(cb);
-    }
+  if (hotClient !== null) {
+    queueMicrotask(cb);
+  } else {
+    pendingCallbacks.push(cb);
+  }
 };
 const flush = () => {
-    flushScheduled = false;
-    if (queue.length === 0 || hotClient === null)
-        return;
-    const batch = queue.splice(0);
-    try {
-        hotClient.send('lit:timeline:push-event', { events: batch });
-    }
-    catch {
-        // HMR channel may be temporarily unavailable; events are dropped.
-    }
+  flushScheduled = false;
+  if (queue.length === 0 || hotClient === null) return;
+  const batch = queue.splice(0);
+  try {
+    hotClient.send('lit:timeline:push-event', {events: batch});
+  } catch {
+    // HMR channel may be temporarily unavailable; events are dropped.
+  }
 };
 /**
  * Enqueue a timeline event for forwarding to the Vite server.
@@ -69,18 +65,18 @@ const flush = () => {
  * doesn't send dozens of individual messages.
  */
 export const emit = (event) => {
-    queue.push(event);
-    if (hotClient === null) {
-        // No consumer yet: bound the buffer instead of scheduling a flush that
-        // would only no-op. `setHotClient` drains the retained tail on connect.
-        if (queue.length > MAX_PENDING) {
-            queue.splice(0, queue.length - MAX_PENDING);
-        }
-        return;
-    }
-    if (!flushScheduled) {
-        flushScheduled = true;
-        queueMicrotask(flush);
+  queue.push(event);
+  if (hotClient === null) {
+    // No consumer yet: bound the buffer instead of scheduling a flush that
+    // would only no-op. `setHotClient` drains the retained tail on connect.
+    if (queue.length > MAX_PENDING) {
+      queue.splice(0, queue.length - MAX_PENDING);
     }
+    return;
+  }
+  if (!flushScheduled) {
+    flushScheduled = true;
+    queueMicrotask(flush);
+  }
 };
-//# sourceMappingURL=transport.js.map
+//# sourceMappingURL=transport.js.map

package/lib/runtime/timeline/transport.js.map

@@ -1 +1 @@
-{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../../../packages/labs/vite-plugin-lit/src/lib/runtime/timeline/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,MAAM,KAAK,GAAoB,EAAE,CAAC;AAClC,IAAI,cAAc,GAAG,KAAK,CAAC;AAC3B,IAAI,SAAS,GAAqB,IAAI,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,kFAAkF;AAClF,oEAAoE;AACpE,MAAM,gBAAgB,GAAsB,EAAE,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAc,EAAQ,EAAE;IACnD,SAAS,GAAG,GAAG,CAAC;IAChB,6DAA6D;IAC7D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,cAAc,GAAG,IAAI,CAAC;QACtB,cAAc,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,iEAAiE;IACjE,KAAK,MAAM,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,EAAE,EAAE,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,EAAc,EAAQ,EAAE;IAC3D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,GAAS,EAAE;IACvB,cAAc,GAAG,KAAK,CAAC;IACvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAC,MAAM,EAAE,KAAK,EAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAoB,EAAQ,EAAE;IACjD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,uEAAuE;QACvE,wEAAwE;QACxE,IAAI,KAAK,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YAC/B,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,IAAI,CAAC;QACtB,cAAc,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Buffered transport for timeline events.\n *\n * Phase 0/1: forwards events over Vite's HMR WebSocket channel\n * (`import.meta.hot.send`). This avoids the need for a separate devframe\n * RPC connection in early phases and works with any Vite dev server.\n *\n * Phase 2 migration: replace `sendViaHmr` with `sendViaRpc` when the\n * devframe RPC client is available (injected by the panel's clientScript).\n *\n * Batching: we coalesce events with `queueMicrotask` so a burst of\n * commit/set-part events from a single render doesn't hammer the channel\n * with one message per event.\n */\n\nimport type {TimelineEvent} from '../../../types/timeline.js';\n\ntype HotClient = {\n  send: (event: string, data: unknown) => void;\n};\n\nconst queue: TimelineEvent[] = [];\nlet flushScheduled = false;\nlet hotClient: HotClient | null = null;\n\n/**\n * Cap on events retained while no hot client is connected. Without a client\n * `flush()` cannot drain the queue, so an uncapped buffer would grow for the\n * whole session (in production, or before `install.ts` wires the client).\n * We keep only the most recent events; the retained tail flushes if a client\n * later connects.\n */\nconst MAX_PENDING = 1000;\n\n// Callbacks registered before the hot client was available (e.g. addTimelineLayer\n// called at module init time before install.ts has set the client).\nconst pendingCallbacks: Array<() => void> = [];\n\n/**\n * Register the HMR hot client.\n * Called by install.ts after import.meta.hot check.\n * Flushes any queued events and fires pending one-shot callbacks.\n */\nexport const setHotClient = (hot: HotClient): void => {\n  hotClient = hot;\n  // Drain any events that arrived before the client was wired.\n  if (queue.length > 0 && !flushScheduled) {\n    flushScheduled = true;\n    queueMicrotask(flush);\n  }\n  // Fire one-shot callbacks (e.g. addTimelineLayer announcements).\n  for (const cb of pendingCallbacks.splice(0)) {\n    try {\n      cb();\n    } catch {\n      // ignore\n    }\n  }\n};\n\n/**\n * Register a callback to be invoked once the HMR client is available.\n * If the client is already set the callback is fired on the next microtask.\n */\nexport const setHotClientCallback = (cb: () => void): void => {\n  if (hotClient !== null) {\n    queueMicrotask(cb);\n  } else {\n    pendingCallbacks.push(cb);\n  }\n};\n\nconst flush = (): void => {\n  flushScheduled = false;\n  if (queue.length === 0 || hotClient === null) return;\n  const batch = queue.splice(0);\n  try {\n    hotClient.send('lit:timeline:push-event', {events: batch});\n  } catch {\n    // HMR channel may be temporarily unavailable; events are dropped.\n  }\n};\n\n/**\n * Enqueue a timeline event for forwarding to the Vite server.\n * Batches via microtask so a single synchronous render burst\n * doesn't send dozens of individual messages.\n */\nexport const emit = (event: TimelineEvent): void => {\n  queue.push(event);\n  if (hotClient === null) {\n    // No consumer yet: bound the buffer instead of scheduling a flush that\n    // would only no-op. `setHotClient` drains the retained tail on connect.\n    if (queue.length > MAX_PENDING) {\n      queue.splice(0, queue.length - MAX_PENDING);\n    }\n    return;\n  }\n  if (!flushScheduled) {\n    flushScheduled = true;\n    queueMicrotask(flush);\n  }\n};\n"]}
+{"version":3,"file":"transport.js","sourceRoot":"","sources":["../../../src/lib/runtime/timeline/transport.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuBH,MAAM,KAAK,GAAoB,EAAE,CAAC;AAClC,IAAI,cAAc,GAAG,KAAK,CAAC;AAC3B,IAAI,SAAS,GAAqB,IAAI,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,WAAW,GAAG,IAAI,CAAC;AAEzB,kFAAkF;AAClF,oEAAoE;AACpE,MAAM,gBAAgB,GAAsB,EAAE,CAAC;AAE/C;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAc,EAAQ,EAAE;IACnD,SAAS,GAAG,GAAG,CAAC;IAChB,6DAA6D;IAC7D,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;QACxC,cAAc,GAAG,IAAI,CAAC;QACtB,cAAc,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;IACD,iEAAiE;IACjE,KAAK,MAAM,EAAE,IAAI,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,IAAI,CAAC;YACH,EAAE,EAAE,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACP,SAAS;QACX,CAAC;IACH,CAAC;AACH,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,EAAc,EAAQ,EAAE;IAC3D,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,cAAc,CAAC,EAAE,CAAC,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC5B,CAAC;AACH,CAAC,CAAC;AAEF,MAAM,KAAK,GAAG,GAAS,EAAE;IACvB,cAAc,GAAG,KAAK,CAAC;IACvB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO;IACrD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC;QACH,SAAS,CAAC,IAAI,CAAC,yBAAyB,EAAE,EAAC,MAAM,EAAE,KAAK,EAAC,CAAC,CAAC;IAC7D,CAAC;IAAC,MAAM,CAAC;QACP,kEAAkE;IACpE,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,CAAC,KAAoB,EAAQ,EAAE;IACjD,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACvB,uEAAuE;QACvE,wEAAwE;QACxE,IAAI,KAAK,CAAC,MAAM,GAAG,WAAW,EAAE,CAAC;YAC/B,KAAK,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO;IACT,CAAC;IACD,IAAI,CAAC,cAAc,EAAE,CAAC;QACpB,cAAc,GAAG,IAAI,CAAC;QACtB,cAAc,CAAC,KAAK,CAAC,CAAC;IACxB,CAAC;AACH,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Buffered transport for timeline events.\n *\n * Phase 0/1: forwards events over Vite's HMR WebSocket channel\n * (`import.meta.hot.send`). This avoids the need for a separate devframe\n * RPC connection in early phases and works with any Vite dev server.\n *\n * Phase 2 migration: replace `sendViaHmr` with `sendViaRpc` when the\n * devframe RPC client is available (injected by the panel's clientScript).\n *\n * Batching: we coalesce events with `queueMicrotask` so a burst of\n * commit/set-part events from a single render doesn't hammer the channel\n * with one message per event.\n */\n\nimport type {TimelineEvent} from '../../../types/timeline.js';\n\ntype HotClient = {\n  send: (event: string, data: unknown) => void;\n};\n\nconst queue: TimelineEvent[] = [];\nlet flushScheduled = false;\nlet hotClient: HotClient | null = null;\n\n/**\n * Cap on events retained while no hot client is connected. Without a client\n * `flush()` cannot drain the queue, so an uncapped buffer would grow for the\n * whole session (in production, or before `install.ts` wires the client).\n * We keep only the most recent events; the retained tail flushes if a client\n * later connects.\n */\nconst MAX_PENDING = 1000;\n\n// Callbacks registered before the hot client was available (e.g. addTimelineLayer\n// called at module init time before install.ts has set the client).\nconst pendingCallbacks: Array<() => void> = [];\n\n/**\n * Register the HMR hot client.\n * Called by install.ts after import.meta.hot check.\n * Flushes any queued events and fires pending one-shot callbacks.\n */\nexport const setHotClient = (hot: HotClient): void => {\n  hotClient = hot;\n  // Drain any events that arrived before the client was wired.\n  if (queue.length > 0 && !flushScheduled) {\n    flushScheduled = true;\n    queueMicrotask(flush);\n  }\n  // Fire one-shot callbacks (e.g. addTimelineLayer announcements).\n  for (const cb of pendingCallbacks.splice(0)) {\n    try {\n      cb();\n    } catch {\n      // ignore\n    }\n  }\n};\n\n/**\n * Register a callback to be invoked once the HMR client is available.\n * If the client is already set the callback is fired on the next microtask.\n */\nexport const setHotClientCallback = (cb: () => void): void => {\n  if (hotClient !== null) {\n    queueMicrotask(cb);\n  } else {\n    pendingCallbacks.push(cb);\n  }\n};\n\nconst flush = (): void => {\n  flushScheduled = false;\n  if (queue.length === 0 || hotClient === null) return;\n  const batch = queue.splice(0);\n  try {\n    hotClient.send('lit:timeline:push-event', {events: batch});\n  } catch {\n    // HMR channel may be temporarily unavailable; events are dropped.\n  }\n};\n\n/**\n * Enqueue a timeline event for forwarding to the Vite server.\n * Batches via microtask so a single synchronous render burst\n * doesn't send dozens of individual messages.\n */\nexport const emit = (event: TimelineEvent): void => {\n  queue.push(event);\n  if (hotClient === null) {\n    // No consumer yet: bound the buffer instead of scheduling a flush that\n    // would only no-op. `setHotClient` drains the retained tail on connect.\n    if (queue.length > MAX_PENDING) {\n      queue.splice(0, queue.length - MAX_PENDING);\n    }\n    return;\n  }\n  if (!flushScheduled) {\n    flushScheduled = true;\n    queueMicrotask(flush);\n  }\n};\n"]}

package/lib/segmented-tabs.d.ts

@@ -8,6 +8,8 @@ export interface TabItem {
     id: string;
     label: string;
     icon?: string;
+    /** Optional count pill trailing the label. Hidden when absent or zero. */
+    badge?: number;
 }
 export type SegTabSize = 'sm' | 'md';
 /**
@@ -23,7 +25,7 @@ export declare class SegmentedTabs extends LitElement {
     size: SegTabSize;
     constructor();
     private _select;
-    render(): import("lit-html").TemplateResult<1>;
+    render(): import("lit").TemplateResult<1>;
 }
 declare global {
     interface HTMLElementTagNameMap {

package/lib/segmented-tabs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"segmented-tabs.d.ts","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/lib/segmented-tabs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,UAAU,EAAqB,MAAM,KAAK,CAAC;AAInD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AAErC;;;;;GAKG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAuDpB;IAE+B,KAAK,EAAE,OAAO,EAAE,CAAC;IAE9B,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,EAAE,UAAU,CAAC;;IASrC,OAAO,CAAC,OAAO;IAWN,MAAM;CAyBhB;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,aAAa,CAAC;KACjC;CACF"}
+{"version":3,"file":"segmented-tabs.d.ts","sourceRoot":"","sources":["../src/lib/segmented-tabs.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAC,UAAU,EAAqB,MAAM,KAAK,CAAC;AAInD,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,0EAA0E;IAC1E,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,CAAC;AAErC;;;;;GAKG;AACH,qBACa,aAAc,SAAQ,UAAU;IAC3C,OAAgB,MAAM,4BAkEpB;IAE+B,KAAK,EAAE,OAAO,EAAE,CAAC;IAE9B,KAAK,EAAE,MAAM,CAAC;IAEd,IAAI,EAAE,UAAU,CAAC;IAErC,cAKC;IAED,OAAO,CAAC,OAAO;IAWN,MAAM,oCA+Bd;CACF;AAED,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,qBAAqB;QAC7B,gBAAgB,EAAE,aAAa,CAAC;KACjC;CACF"}