@oddsquad/vite-plugin-lit 0.2.3 → 0.4.0

package/lib/options.js

@@ -0,0 +1,128 @@
+/**
+ * @license
+ * Copyright 2026 Google LLC
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+const CSS_SHEET_BUILD_MODES = ['auto', 'url', 'inline', 'inline-raw'];
+/** Env var prefix consumed at config time. */
+export const ENV_PREFIX = 'LIT_PLUGIN';
+const ON_INCOMPATIBLE_MODES = ['reload', 'warn'];
+/** Parse a boolean-ish env string; `undefined` when unset/unrecognized. */
+const envBool = (v) =>
+  v === 'true' || v === '1'
+    ? true
+    : v === 'false' || v === '0'
+      ? false
+      : undefined;
+/** Parse a numeric env string; `undefined` when unset/non-numeric. */
+const envNum = (v) => {
+  if (v === undefined || v === '') return undefined;
+  const n = Number(v);
+  return Number.isNaN(n) ? undefined : n;
+};
+/**
+ * Parse a string against a closed set of values; `undefined` (with a warning)
+ * when set to something outside it, so a typo falls back to the default
+ * instead of silently disabling a feature.
+ */
+const envEnum = (v, allowed, source) => {
+  if (v === undefined || v === '') return undefined;
+  if (allowed.includes(v)) return v;
+  console.warn(
+    `[lit-plugin] ignoring ${source}=${JSON.stringify(v)}; expected one of ` +
+      allowed.map((a) => JSON.stringify(a)).join(', ')
+  );
+  return undefined;
+};
+/**
+ * Merge explicit options over env vars over defaults (in that precedence) into
+ * the flat shape the plugin hooks consume.
+ */
+export const resolveOptions = (options, env) => {
+  const hmr = options.hmr;
+  const hmrObj = typeof hmr === 'object' ? hmr : undefined;
+  const hmrEnabled =
+    (typeof hmr === 'boolean' ? hmr : hmrObj?.enabled) ??
+    envBool(env[`${ENV_PREFIX}_HMR`]) ??
+    true;
+  const reconnect =
+    hmrObj?.reconnect ?? envBool(env[`${ENV_PREFIX}_HMR_RECONNECT`]) ?? false;
+  const onIncompatible =
+    hmrObj?.onIncompatible ??
+    envEnum(
+      env[`${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`],
+      ON_INCOMPATIBLE_MODES,
+      `${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`
+    ) ??
+    'reload';
+  const ind = hmrObj?.indicator;
+  const indObj = typeof ind === 'object' ? ind : undefined;
+  const indEnabled =
+    (typeof ind === 'boolean' ? ind : indObj?.enabled) ??
+    envBool(env[`${ENV_PREFIX}_HMR_INDICATOR`]) ??
+    true;
+  const indCount =
+    indObj?.count ?? envBool(env[`${ENV_PREFIX}_HMR_INDICATOR_COUNT`]) ?? false;
+  // The indicator is meaningless without HMR, so it follows the master toggle.
+  const indicator = hmrEnabled && indEnabled ? {count: indCount} : false;
+  const so = options.sourceOverlay;
+  const soExplicit =
+    typeof so === 'boolean' ? so : so === undefined ? undefined : true;
+  const soEnabled =
+    soExplicit ?? envBool(env[`${ENV_PREFIX}_SOURCE_OVERLAY`]) ?? false;
+  let sourceOverlay = false;
+  if (soEnabled) {
+    const base = typeof so === 'object' ? {...so} : {};
+    base.key ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_KEY`] || undefined;
+    base.editor ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`] || undefined;
+    base.throttleMs ??= envNum(env[`${ENV_PREFIX}_SOURCE_OVERLAY_THROTTLE_MS`]);
+    sourceOverlay = base;
+  }
+  const timeline =
+    options.timeline ?? envBool(env[`${ENV_PREFIX}_TIMELINE`]) ?? false;
+  const cssSheetBuild =
+    envEnum(options.cssSheetBuild, CSS_SHEET_BUILD_MODES, 'cssSheetBuild') ??
+    envEnum(
+      env[`${ENV_PREFIX}_CSS_SHEET_BUILD`],
+      CSS_SHEET_BUILD_MODES,
+      `${ENV_PREFIX}_CSS_SHEET_BUILD`
+    ) ??
+    'auto';
+  return {
+    hmrEnabled,
+    reconnect,
+    onIncompatible,
+    indicator,
+    sourceOverlay,
+    timeline,
+    cssSheetBuild,
+  };
+};
+/**
+ * Flattens resolved options into the JSON-serializable shape the panel's
+ * Settings tab consumes (callback options like `exclude`/`onSelect` dropped;
+ * a custom editor object reported as `"custom"`). Default key/editor/throttle
+ * are applied here so the panel shows the effective values the runtime uses.
+ */
+export const toFeatureSettings = (r) => {
+  const so = r.sourceOverlay;
+  const editor = so === false ? undefined : so.editor;
+  return {
+    hmr: {
+      enabled: r.hmrEnabled,
+      reconnect: r.reconnect,
+      onIncompatible: r.onIncompatible,
+      indicatorEnabled: r.indicator !== false,
+      indicatorCount: r.indicator !== false && r.indicator.count,
+    },
+    sourceOverlay: {
+      enabled: so !== false,
+      key: (so === false ? undefined : so.key) ?? 's',
+      editor:
+        typeof editor === 'string' ? editor : editor ? 'custom' : 'vscode',
+      throttleMs: (so === false ? undefined : so.throttleMs) ?? 50,
+    },
+    timeline: r.timeline,
+  };
+};
+//# sourceMappingURL=options.js.map

package/lib/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../src/lib/options.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\nimport type {SourceOverlayOptions} from './types.js';\nimport type {FeatureSettings} from '../types/timeline.js';\n\n/**\n * On-page HMR feedback: a small pulsing indicator in the corner of the host\n * page that briefly animates on each HMR update, for at-a-glance feedback\n * without watching the console.\n */\nexport interface HmrIndicatorOptions {\n  /** Inject the indicator element. Defaults to `true` (when HMR is enabled). */\n  enabled?: boolean;\n\n  /**\n   * Show a cumulative update count next to the dot (idle opacity 0.5 instead\n   * of fully transparent). Defaults to `false`.\n   */\n  count?: boolean;\n}\n\n/**\n * HMR for Lit component classes and its on-page feedback.\n */\nexport interface HmrOptions {\n  /**\n   * Enable in-place HMR for Lit component classes. When `false`, the plugin\n   * skips all HMR transforms and runtime injection. Defaults to `true`.\n   */\n  enabled?: boolean;\n\n  /**\n   * Cycle `disconnectedCallback()`/`connectedCallback()` on live instances\n   * after a hot patch. Interning makes this mostly unnecessary, so it's\n   * opt-in. Defaults to `false`.\n   */\n  reconnect?: boolean;\n\n  /**\n   * What to do when a component can't be hot-patched in place (e.g.\n   * standard `accessor` decorators). Defaults to `'reload'`.\n   */\n  onIncompatible?: 'reload' | 'warn';\n\n  /**\n   * The on-page update indicator. `true` enables it without a count; an\n   * object configures it. Forced off when HMR itself is disabled. Defaults\n   * to enabled (without a count).\n   */\n  indicator?: boolean | HmrIndicatorOptions;\n}\n\n/**\n * What a `?css-sheet` import compiles to under `vite build`.\n *\n * - `'url'`: fetch-backed sheet over the emitted `.css` asset.\n * - `'inline'`: css text embedded in the JS chunk, processed by the css\n *   pipeline (`?inline`).\n * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline\n *   (`?raw`).\n * - `'auto'`: `'inline'` when `build.lib` is set, `'url'` otherwise.\n */\nexport type CssSheetBuild = 'auto' | 'url' | 'inline' | 'inline-raw';\n\nconst CSS_SHEET_BUILD_MODES: readonly CssSheetBuild[] = [\n  'auto',\n  'url',\n  'inline',\n  'inline-raw',\n];\n\n/**\n * Options for the Lit Vite plugin.\n *\n * Every option also resolves from environment variables (and `.env` files)\n * with the `LIT_PLUGIN` prefix — e.g. `LIT_PLUGIN_HMR_INDICATOR=true`. Options\n * passed here take precedence over env vars, which take precedence over the\n * built-in defaults.\n */\nexport interface LitPluginOptions {\n  /**\n   * HMR for Lit components and its on-page feedback. `true`/`false` toggles\n   * the whole feature (patching and indicator); an object configures it.\n   * Defaults to enabled.\n   */\n  hmr?: boolean | HmrOptions;\n\n  /**\n   * Dev-only click-to-open-in-IDE inspector for Lit custom elements.\n   * Toggle with Ctrl+Shift+S (configurable via `key`). Defaults to `false`.\n   */\n  sourceOverlay?: boolean | SourceOverlayOptions;\n\n  /**\n   * Vite DevTools Timeline panel — a Vue DevTools–style layered event stream\n   * for Lit lifecycle, render, mouse, and keyboard events.\n   *\n   * Requires `@vitejs/devtools` in the Vite config and the `@vitejs/devtools`\n   * Vite plugin (`DevTools()`) to be active. Defaults to `false` while\n   * experimental.\n   *\n   * `true` enables all built-in layers with defaults.\n   */\n  timeline?: boolean;\n\n  /**\n   * What a `?css-sheet` import compiles to under `vite build`.\n   * - `'url'`:        fetch-backed sheet over the emitted `.css` asset\n   * - `'inline'`:     css text embedded in the JS chunk, processed by the css\n   *                   pipeline (`?inline`)\n   * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline\n   *                   (`?raw`)\n   * - `'auto'`:       `'inline'` when `build.lib` is set, `'url'` otherwise\n   *\n   * Dev is always the fetch-backed HMR form regardless of this setting.\n   * Defaults to `'auto'`.\n   */\n  cssSheetBuild?: CssSheetBuild;\n}\n\n/** Plugin options after merging explicit options, env vars, and defaults. */\nexport interface ResolvedOptions {\n  hmrEnabled: boolean;\n  reconnect: boolean;\n  onIncompatible: 'reload' | 'warn';\n  indicator: false | {count: boolean};\n  sourceOverlay: false | SourceOverlayOptions;\n  timeline: boolean;\n  cssSheetBuild: CssSheetBuild;\n}\n\n/** Env var prefix consumed at config time. */\nexport const ENV_PREFIX = 'LIT_PLUGIN';\n\nconst ON_INCOMPATIBLE_MODES: readonly ('reload' | 'warn')[] = [\n  'reload',\n  'warn',\n];\n\n/** Parse a boolean-ish env string; `undefined` when unset/unrecognized. */\nconst envBool = (v: string | undefined): boolean | undefined =>\n  v === 'true' || v === '1'\n    ? true\n    : v === 'false' || v === '0'\n      ? false\n      : undefined;\n\n/** Parse a numeric env string; `undefined` when unset/non-numeric. */\nconst envNum = (v: string | undefined): number | undefined => {\n  if (v === undefined || v === '') return undefined;\n  const n = Number(v);\n  return Number.isNaN(n) ? undefined : n;\n};\n\n/**\n * Parse a string against a closed set of values; `undefined` (with a warning)\n * when set to something outside it, so a typo falls back to the default\n * instead of silently disabling a feature.\n */\nconst envEnum = <T extends string>(\n  v: string | undefined,\n  allowed: readonly T[],\n  source: string\n): T | undefined => {\n  if (v === undefined || v === '') return undefined;\n  if ((allowed as readonly string[]).includes(v)) return v as T;\n  console.warn(\n    `[lit-plugin] ignoring ${source}=${JSON.stringify(v)}; expected one of ` +\n      allowed.map((a) => JSON.stringify(a)).join(', ')\n  );\n  return undefined;\n};\n\n/**\n * Merge explicit options over env vars over defaults (in that precedence) into\n * the flat shape the plugin hooks consume.\n */\nexport const resolveOptions = (\n  options: LitPluginOptions,\n  env: Record<string, string>\n): ResolvedOptions => {\n  const hmr = options.hmr;\n  const hmrObj = typeof hmr === 'object' ? hmr : undefined;\n  const hmrEnabled =\n    (typeof hmr === 'boolean' ? hmr : hmrObj?.enabled) ??\n    envBool(env[`${ENV_PREFIX}_HMR`]) ??\n    true;\n  const reconnect =\n    hmrObj?.reconnect ?? envBool(env[`${ENV_PREFIX}_HMR_RECONNECT`]) ?? false;\n  const onIncompatible =\n    hmrObj?.onIncompatible ??\n    envEnum(\n      env[`${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`],\n      ON_INCOMPATIBLE_MODES,\n      `${ENV_PREFIX}_HMR_ON_INCOMPATIBLE`\n    ) ??\n    'reload';\n\n  const ind = hmrObj?.indicator;\n  const indObj = typeof ind === 'object' ? ind : undefined;\n  const indEnabled =\n    (typeof ind === 'boolean' ? ind : indObj?.enabled) ??\n    envBool(env[`${ENV_PREFIX}_HMR_INDICATOR`]) ??\n    true;\n  const indCount =\n    indObj?.count ?? envBool(env[`${ENV_PREFIX}_HMR_INDICATOR_COUNT`]) ?? false;\n  // The indicator is meaningless without HMR, so it follows the master toggle.\n  const indicator = hmrEnabled && indEnabled ? {count: indCount} : false;\n\n  const so = options.sourceOverlay;\n  const soExplicit =\n    typeof so === 'boolean' ? so : so === undefined ? undefined : true;\n  const soEnabled =\n    soExplicit ?? envBool(env[`${ENV_PREFIX}_SOURCE_OVERLAY`]) ?? false;\n  let sourceOverlay: false | SourceOverlayOptions = false;\n  if (soEnabled) {\n    const base: SourceOverlayOptions = typeof so === 'object' ? {...so} : {};\n    base.key ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_KEY`] || undefined;\n    base.editor ??= env[`${ENV_PREFIX}_SOURCE_OVERLAY_EDITOR`] || undefined;\n    base.throttleMs ??= envNum(env[`${ENV_PREFIX}_SOURCE_OVERLAY_THROTTLE_MS`]);\n    sourceOverlay = base;\n  }\n\n  const timeline =\n    options.timeline ?? envBool(env[`${ENV_PREFIX}_TIMELINE`]) ?? false;\n\n  const cssSheetBuild =\n    envEnum(options.cssSheetBuild, CSS_SHEET_BUILD_MODES, 'cssSheetBuild') ??\n    envEnum(\n      env[`${ENV_PREFIX}_CSS_SHEET_BUILD`],\n      CSS_SHEET_BUILD_MODES,\n      `${ENV_PREFIX}_CSS_SHEET_BUILD`\n    ) ??\n    'auto';\n\n  return {\n    hmrEnabled,\n    reconnect,\n    onIncompatible,\n    indicator,\n    sourceOverlay,\n    timeline,\n    cssSheetBuild,\n  };\n};\n\n/**\n * Flattens resolved options into the JSON-serializable shape the panel's\n * Settings tab consumes (callback options like `exclude`/`onSelect` dropped;\n * a custom editor object reported as `\"custom\"`). Default key/editor/throttle\n * are applied here so the panel shows the effective values the runtime uses.\n */\nexport const toFeatureSettings = (r: ResolvedOptions): FeatureSettings => {\n  const so = r.sourceOverlay;\n  const editor = so === false ? undefined : so.editor;\n  return {\n    hmr: {\n      enabled: r.hmrEnabled,\n      reconnect: r.reconnect,\n      onIncompatible: r.onIncompatible,\n      indicatorEnabled: r.indicator !== false,\n      indicatorCount: r.indicator !== false && r.indicator.count,\n    },\n    sourceOverlay: {\n      enabled: so !== false,\n      key: (so === false ? undefined : so.key) ?? 's',\n      editor:\n        typeof editor === 'string' ? editor : editor ? 'custom' : 'vscode',\n      throttleMs: (so === false ? undefined : so.throttleMs) ?? 50,\n    },\n    timeline: r.timeline,\n  };\n};\n"]}

package/lib/plugin.d.ts

@@ -4,143 +4,12 @@
  * SPDX-License-Identifier: BSD-3-Clause
  */
 import { type Plugin } from 'vite';
-import type { SourceOverlayOptions } from './types.js';
-/**
- * On-page HMR feedback: a small pulsing indicator in the corner of the host
- * page that briefly animates on each HMR update, for at-a-glance feedback
- * without watching the console.
- */
-export interface HmrIndicatorOptions {
-    /** Inject the indicator element. Defaults to `true` (when HMR is enabled). */
-    enabled?: boolean;
-    /**
-     * Show a cumulative update count next to the dot (idle opacity 0.5 instead
-     * of fully transparent). Defaults to `false`.
-     */
-    count?: boolean;
-}
-/**
- * HMR for Lit component classes and its on-page feedback.
- */
-export interface HmrOptions {
-    /**
-     * Enable in-place HMR for Lit component classes. When `false`, the plugin
-     * skips all HMR transforms and runtime injection. Defaults to `true`.
-     */
-    enabled?: boolean;
-    /**
-     * Cycle `disconnectedCallback()`/`connectedCallback()` on live instances
-     * after a hot patch. Interning makes this mostly unnecessary, so it's
-     * opt-in. Defaults to `false`.
-     */
-    reconnect?: boolean;
-    /**
-     * What to do when a component can't be hot-patched in place (e.g.
-     * standard `accessor` decorators). Defaults to `'reload'`.
-     */
-    onIncompatible?: 'reload' | 'warn';
-    /**
-     * The on-page update indicator. `true` enables it without a count; an
-     * object configures it. Forced off when HMR itself is disabled. Defaults
-     * to enabled (without a count).
-     */
-    indicator?: boolean | HmrIndicatorOptions;
-}
-/**
- * What a `?css-sheet` import compiles to under `vite build`.
- *
- * - `'url'`: fetch-backed sheet over the emitted `.css` asset.
- * - `'inline'`: css text embedded in the JS chunk, processed by the css
- *   pipeline (`?inline`).
- * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline
- *   (`?raw`).
- * - `'auto'`: `'inline'` when `build.lib` is set, `'url'` otherwise.
- */
-export type CssSheetBuild = 'auto' | 'url' | 'inline' | 'inline-raw';
-/**
- * Options for the Lit Vite plugin.
- *
- * Every option also resolves from environment variables (and `.env` files)
- * with the `LIT_PLUGIN` prefix — e.g. `LIT_PLUGIN_HMR_INDICATOR=true`. Options
- * passed here take precedence over env vars, which take precedence over the
- * built-in defaults.
- */
-export interface LitPluginOptions {
-    /**
-     * HMR for Lit components and its on-page feedback. `true`/`false` toggles
-     * the whole feature (patching and indicator); an object configures it.
-     * Defaults to enabled.
-     */
-    hmr?: boolean | HmrOptions;
-    /**
-     * Dev-only click-to-open-in-IDE inspector for Lit custom elements.
-     * Toggle with Ctrl+Shift+S (configurable via `key`). Defaults to `false`.
-     */
-    sourceOverlay?: boolean | SourceOverlayOptions;
-    /**
-     * Vite DevTools Timeline panel — a Vue DevTools–style layered event stream
-     * for Lit lifecycle, render, mouse, and keyboard events.
-     *
-     * Requires `@vitejs/devtools` in the Vite config and the `@vitejs/devtools`
-     * Vite plugin (`DevTools()`) to be active. Defaults to `false` while
-     * experimental.
-     *
-     * `true` enables all built-in layers with defaults.
-     */
-    timeline?: boolean;
-    /**
-     * What a `?css-sheet` import compiles to under `vite build`.
-     * - `'url'`:        fetch-backed sheet over the emitted `.css` asset
-     * - `'inline'`:     css text embedded in the JS chunk, processed by the css
-     *                   pipeline (`?inline`)
-     * - `'inline-raw'`: css text embedded verbatim, skipping the css pipeline
-     *                   (`?raw`)
-     * - `'auto'`:       `'inline'` when `build.lib` is set, `'url'` otherwise
-     *
-     * Dev is always the fetch-backed HMR form regardless of this setting.
-     * Defaults to `'auto'`.
-     */
-    cssSheetBuild?: CssSheetBuild;
-}
-/** Plugin options after merging explicit options, env vars, and defaults. */
-export interface ResolvedOptions {
-    hmrEnabled: boolean;
-    reconnect: boolean;
-    onIncompatible: 'reload' | 'warn';
-    indicator: false | {
-        count: boolean;
-    };
-    sourceOverlay: false | SourceOverlayOptions;
-    timeline: boolean;
-    cssSheetBuild: CssSheetBuild;
-}
-/**
- * Merge explicit options over env vars over defaults (in that precedence) into
- * the flat shape the plugin hooks consume.
- */
-export declare const resolveOptions: (options: LitPluginOptions, env: Record<string, string>) => ResolvedOptions;
-export declare const createOpenInEditorMiddleware: (allowedRoots: readonly string[]) => (req: {
-    url?: string;
-    headers?: {
-        origin?: string;
-        host?: string;
-    };
-}, res: {
-    statusCode: number;
-    end: (msg: string) => void;
-}, next: (err?: unknown) => void) => void;
-/**
- * Import-query support, served in dev and build alike (source code using
- * `?hmr-url`/`?css-sheet` must keep working under `vite build`, where the HMR
- * plugin doesn't apply). Exported for the baseline e2e run, which needs the
- * queries working without the HMR plugin.
- *
- * `getCssSheetBuild` is a getter, not a value: `litPlugin()` re-resolves its
- * options against the loaded env in a `config` hook, which runs after the
- * plugin array is built. Standalone (no getter) it behaves like the `'auto'`
- * default.
- */
-export declare const litCssQueries: (getCssSheetBuild?: () => CssSheetBuild) => Plugin;
+import { type LitPluginOptions } from './options.js';
+export { createOpenInEditorMiddleware } from './plugins/open-in-editor.js';
+export { litCssQueries } from './plugins/css-queries.js';
+export { litTimelineVirtual } from './plugins/timeline-virtual.js';
+export type { HmrIndicatorOptions, HmrOptions, CssSheetBuild, LitPluginOptions, ResolvedOptions, } from './options.js';
+export { resolveOptions } from './options.js';
 /**
  * Vite plugin set providing HMR, CSS helpers, and Lightning CSS processing
  * for Lit projects.

package/lib/plugin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../packages/labs/vite-plugin-lit/src/lib/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAA2B,KAAK,MAAM,EAAC,MAAM,MAAM,CAAC;AAI3D,OAAO,KAAK,EAAC,oBAAoB,EAAC,MAAM,YAAY,CAAC;AAKrD;;;;GAIG;AACH,MAAM,WAAW,mBAAmB;IAClC,8EAA8E;IAC9E,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;IAEnC;;;;OAIG;IACH,SAAS,CAAC,EAAE,OAAO,GAAG,mBAAmB,CAAC;CAC3C;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,YAAY,CAAC;AASrE;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;OAIG;IACH,GAAG,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,GAAG,oBAAoB,CAAC;IAE/C;;;;;;;;;OASG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;;;;;;;;OAWG;IACH,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,6EAA6E;AAC7E,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,OAAO,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,QAAQ,GAAG,MAAM,CAAC;IAClC,SAAS,EAAE,KAAK,GAAG;QAAC,KAAK,EAAE,OAAO,CAAA;KAAC,CAAC;IACpC,aAAa,EAAE,KAAK,GAAG,oBAAoB,CAAC;IAC5C,QAAQ,EAAE,OAAO,CAAC;IAClB,aAAa,EAAE,aAAa,CAAC;CAC9B;AAuCD;;;GAGG;AACH,eAAO,MAAM,cAAc,GACzB,SAAS,gBAAgB,EACzB,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAC1B,eA4DF,CAAC;AA8DF,eAAO,MAAM,4BAA4B,GACvC,cAAc,SAAS,MAAM,EAAE,MAM7B,KAAK;IAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAC,CAAA;CAAC,EAC/D,KAAK;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,IAAI,CAAA;CAAC,EACrD,MAAM,CAAC,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,SAkFhC,CAAC;AAoCF;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,GACxB,mBAAkB,MAAM,aAA4B,KACnD,MAwFF,CAAC;AAuFF;;;GAGG;AACH,eAAO,MAAM,SAAS,GAAI,UAAS,gBAAqB,KAAG,MAAM,EA0RhE,CAAC"}
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/lib/plugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAU,KAAK,MAAM,EAAC,MAAM,MAAM,CAAC;AAO1C,OAAO,EAEL,KAAK,gBAAgB,EAItB,MAAM,cAAc,CAAC;AAUtB,OAAO,EAAC,4BAA4B,EAAC,MAAM,6BAA6B,CAAC;AACzE,OAAO,EAAC,aAAa,EAAC,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAC,kBAAkB,EAAC,MAAM,+BAA+B,CAAC;AACjE,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAC,cAAc,EAAC,MAAM,cAAc,CAAC;AAE5C;;;GAGG;AACH,eAAO,MAAM,SAAS,aAAa,gBAAgB,KAAQ,MAAM,EA+QhE,CAAC"}