@oddsquad/vite-plugin-lit 0.6.1 → 0.8.0

package/lib/runtime/child-state.js

@@ -0,0 +1,461 @@
+/**
+ * Carries child element state across a template re-instantiation.
+ *
+ * When a hot patch changes a template's text, lit-html sees a new template,
+ * clones fresh DOM and swaps it in: every custom element inside the edited
+ * template is re-created and starts from its defaults. For a short window
+ * after a hot patch this module pairs each element dropped from a root with
+ * the next freshly created element of the same tag connected in that root
+ * (FIFO, i.e. document order), then either copies the old element's state
+ * onto the new one (`'transfer'`) or, where the new element carries no
+ * bindings, puts the old element back in its place (`'reuse'`).
+ *
+ * Dependency-free and duck-typed like `patch.ts`. The lit-html internals it
+ * reads (`_$litPart$`, `_$committedValue`, `_$template`, `_$parts`,
+ * `_$startNode`, `_$endNode`) are looked up by their development names first
+ * and then by the stable minified names lit's prod build gives them
+ * (`_$AH`, `_$AD`, `_$AV`, `_$AA`, `_$AB`). Every access is guarded; when the
+ * part tree can't be read, transfer skips only attribute-driven keys and
+ * reuse falls back to transfer.
+ */
+/** `Symbol.for` description prefix of the dev-only `#private` rewrite. */
+export const PRIVATE_KEY_PREFIX = '@oddsquad/vite-plugin-lit#private:';
+/** Hard cap on how long a transfer window stays open. */
+export const WINDOW_CAP_MS = 1000;
+const ATTRIBUTE_PART = 1;
+const CHILD_PART = 2;
+const PROPERTY_PART = 3;
+const BOOLEAN_PART = 4;
+/** Dev name, then the stable minified name from lit-html's prod build. */
+const COMMITTED = ['_$committedValue', '_$AH'];
+const TEMPLATE = ['_$template', '_$AD'];
+const PARTS = ['_$parts', '_$AV'];
+const START = ['_$startNode', '_$AA'];
+const END = ['_$endNode', '_$AB'];
+const LIT_PART = '_$litPart$';
+const internal = (o, [dev, prod]) => {
+  if (o === null || typeof o !== 'object') {
+    return undefined;
+  }
+  const r = o;
+  return dev in r ? r[dev] : r[prod];
+};
+const isPart = (p) =>
+  p !== null && typeof p === 'object' && typeof p.type === 'number';
+const MAX_PARTS = 100_000;
+/** Pushes `part` and, through child parts' committed values, every part below. */
+const walkParts = (part, out) => {
+  if (out.length > MAX_PARTS) {
+    throw new Error('part tree too large');
+  }
+  out.push(part);
+  if (part.type !== CHILD_PART) {
+    return;
+  }
+  const value = internal(part, COMMITTED);
+  if (Array.isArray(value)) {
+    // An iterable's committed value is an array of ChildParts.
+    for (const child of value) {
+      if (isPart(child)) {
+        walkParts(child, out);
+      }
+    }
+    return;
+  }
+  const parts = internal(value, PARTS);
+  if (Array.isArray(parts) && internal(value, TEMPLATE) !== undefined) {
+    for (const child of parts) {
+      // Entries may be undefined (parts removed by the polyfill/hydration).
+      if (isPart(child)) {
+        walkParts(child, out);
+      }
+    }
+  }
+};
+/**
+ * Every lit-html part rendered into the tree `el` lives in: the parts of each
+ * render container (`_$litPart$`) among `el`'s ancestors up to its root.
+ * `undefined` when `el` isn't in a tree or the walk hits a surprise.
+ */
+export const partsAround = (el) => {
+  try {
+    const out = [];
+    let node = el.parentNode;
+    if (node === null) {
+      return undefined;
+    }
+    while (node !== null) {
+      const root = node[LIT_PART];
+      if (isPart(root)) {
+        walkParts(root, out);
+      }
+      node = node.parentNode;
+    }
+    return out;
+  } catch {
+    return undefined;
+  }
+};
+/** Attribute name → reactive property key for an element's class. */
+const attributeMap = (ctor) => {
+  // Dev builds keep the name; prod mangles it, so rebuild from options.
+  const own = ctor.__attributeToPropertyMap;
+  if (own instanceof Map) {
+    return own;
+  }
+  const map = new Map();
+  const props = ctor.elementProperties;
+  if (!(props instanceof Map)) {
+    return map;
+  }
+  for (const [key, options] of props) {
+    const attribute = options?.attribute;
+    if (attribute === false) {
+      continue;
+    }
+    if (typeof attribute === 'string') {
+      map.set(attribute, key);
+    } else if (typeof key === 'string') {
+      map.set(key.toLowerCase(), key);
+    }
+  }
+  return map;
+};
+const propertyKeys = (ctor) => {
+  const props = ctor?.elementProperties;
+  return props instanceof Map ? [...props.keys()] : [];
+};
+/**
+ * Reactive property keys the new element already got from its template:
+ * keys whose attribute is present on it (static attributes), plus, when the
+ * part tree could be read, keys bound by a property, boolean or attribute
+ * part targeting it.
+ */
+export const templateDrivenKeys = (el, parts) => {
+  const keys = new Set();
+  const ctor = el.constructor;
+  const attrs = attributeMap(ctor);
+  try {
+    for (const attr of Array.from(el.attributes)) {
+      const key = attrs.get(attr.name.toLowerCase());
+      if (key !== undefined) {
+        keys.add(key);
+      }
+    }
+  } catch {
+    // No attributes to read.
+  }
+  for (const part of parts ?? []) {
+    if (part.element !== el || typeof part.name !== 'string') {
+      continue;
+    }
+    if (part.type === PROPERTY_PART) {
+      keys.add(part.name);
+    } else if (part.type === ATTRIBUTE_PART || part.type === BOOLEAN_PART) {
+      keys.add(attrs.get(part.name.toLowerCase()) ?? part.name);
+    }
+  }
+  return keys;
+};
+/** Own symbol keys of `el` minted by the dev-only `#private` rewrite. */
+export const privateKeys = (el) =>
+  Object.getOwnPropertySymbols(el).filter((sym) =>
+    (Symbol.keyFor(sym) ?? '').startsWith(PRIVATE_KEY_PREFIX)
+  );
+/**
+ * Copies `from`'s state onto `to`: reactive properties not driven by `to`'s
+ * template, and the `#private` members the dev rewrite turned into
+ * `Symbol.for` keys. Nothing else — Lit's own bookkeeping lives in string
+ * keys and must stay per-instance.
+ */
+export const transferState = (from, to, parts) => {
+  const skip = templateDrivenKeys(to, parts);
+  const keys = new Set([
+    ...propertyKeys(to.constructor),
+    ...propertyKeys(from.constructor),
+  ]);
+  const src = from;
+  const dst = to;
+  for (const key of keys) {
+    if (skip.has(key)) {
+      continue;
+    }
+    try {
+      dst[key] = src[key];
+    } catch {
+      // A throwing setter; leave the default.
+    }
+  }
+  for (const sym of privateKeys(from)) {
+    try {
+      Object.defineProperty(
+        to,
+        sym,
+        Object.getOwnPropertyDescriptor(from, sym)
+      );
+    } catch {
+      // Non-configurable on the target; leave it.
+    }
+  }
+};
+const inside = (el, node) =>
+  node !== null &&
+  typeof node === 'object' &&
+  typeof node.nodeType === 'number' &&
+  el.contains(node);
+/**
+ * Whether `el` (and its light DOM) carries no bindings, so another element
+ * can take its place without lit-html noticing: no part targets it or an
+ * element inside it, no child part's markers or parent lie inside it, and
+ * nothing rendered into it as a container. `false` when `parts` is unknown.
+ */
+export const isReuseSafe = (el, parts) => {
+  if (parts === undefined) {
+    return false;
+  }
+  try {
+    if (LIT_PART in el) {
+      return false;
+    }
+    for (const part of parts) {
+      if (inside(el, part.element)) {
+        return false;
+      }
+      if (part.type === CHILD_PART) {
+        const start = internal(part, START);
+        const end = internal(part, END);
+        if (
+          inside(el, start) ||
+          inside(el, end) ||
+          inside(el, start?.parentNode) ||
+          inside(el, end?.parentNode)
+        ) {
+          return false;
+        }
+      }
+    }
+    return true;
+  } catch {
+    return false;
+  }
+};
+/**
+ * Puts `old` back where `fresh` is: `old` takes `fresh`'s attributes and
+ * light-DOM children, then replaces it. `old` keeps its identity, state,
+ * shadow DOM and controllers, and reconnects.
+ */
+export const swapBack = (old, fresh) => {
+  for (const attr of Array.from(old.attributes)) {
+    if (!fresh.hasAttribute(attr.name)) {
+      old.removeAttribute(attr.name);
+    }
+  }
+  for (const attr of Array.from(fresh.attributes)) {
+    if (old.getAttribute(attr.name) !== attr.value) {
+      old.setAttribute(attr.name, attr.value);
+    }
+  }
+  old.replaceChildren(...Array.from(fresh.childNodes));
+  fresh.replaceWith(old);
+};
+export const createChildState = (options) => {
+  const capMs = options.capMs ?? WINDOW_CAP_MS;
+  /** The root each element was last connected in. */
+  const rootOf = new WeakMap();
+  let current;
+  const close = (w) => {
+    if (current !== w) {
+      return;
+    }
+    current = undefined;
+    clearTimeout(w.idle);
+    clearTimeout(w.cap);
+    // Reuse only once everything we waited on has settled; on the hard cap
+    // with updates still outstanding, the transferred state stands.
+    if (w.mode !== 'reuse' || w.waiting > 0) {
+      return;
+    }
+    for (const [old, fresh] of w.pairs) {
+      // A pair inside an element that was itself swapped back is moot:
+      // the old element's shadow DOM came back intact with it.
+      if (!fresh.isConnected || old.isConnected) {
+        continue;
+      }
+      try {
+        if (isReuseSafe(fresh, partsAround(fresh))) {
+          swapBack(old, fresh);
+        }
+      } catch {
+        // Leave the new element (it already has the transferred state).
+      }
+    }
+  };
+  /** Close once a macrotask passes with no tracked activity. */
+  const settle = (w) => {
+    if (current !== w || w.waiting > 0) {
+      return;
+    }
+    clearTimeout(w.idle);
+    w.idle = setTimeout(() => close(w), 0);
+  };
+  /** The pending-queue root for an element now connected in `root`. */
+  const keyRoot = (w, root) => {
+    const host = root.host;
+    const old = host === undefined ? undefined : w.pairOf.get(host);
+    if (old !== undefined) {
+      // Re-created inside a new element's shadow: match against what was
+      // dropped from the old element's shadow.
+      const oldRoot = old.renderRoot ?? old.shadowRoot;
+      if (oldRoot !== undefined && oldRoot !== null && w.pending.has(oldRoot)) {
+        return oldRoot;
+      }
+    }
+    return root;
+  };
+  const unqueue = (w, el) => {
+    const at = w.pendingOf.get(el);
+    if (at === undefined) {
+      return;
+    }
+    w.pendingOf.delete(el);
+    const queue = w.pending.get(at.root)?.get(at.tag);
+    const i = queue?.indexOf(el) ?? -1;
+    if (i >= 0) {
+      queue.splice(i, 1);
+    }
+  };
+  const pair = (w, fresh, root) => {
+    const queue = w.pending.get(keyRoot(w, root))?.get(fresh.localName);
+    const old = queue?.shift();
+    if (old === undefined) {
+      return;
+    }
+    w.pendingOf.delete(old);
+    w.pairOf.set(fresh, old);
+    const origin = w.originOf.get(old) ?? old;
+    w.originOf.set(fresh, origin);
+    w.pairs.push([origin, fresh]);
+    // lit-html assigns the new template instance to its part only after the
+    // fragment is inserted, so the parts targeting `fresh` aren't reachable
+    // yet. Queued before the original connectedCallback enables updating,
+    // this runs ahead of `fresh`'s first update.
+    queueMicrotask(() => {
+      try {
+        transferState(old, fresh, partsAround(fresh));
+      } catch {
+        // Keep the defaults.
+      }
+    });
+  };
+  return {
+    connected(el, fresh) {
+      let root;
+      try {
+        root = el.getRootNode();
+      } catch {
+        root = undefined;
+      }
+      const w = current;
+      if (w !== undefined) {
+        try {
+          if (fresh && root !== undefined && el.hasUpdated !== true) {
+            pair(w, el, root);
+          } else {
+            // Moved, not re-created: it can't be anyone's replacement.
+            unqueue(w, el);
+          }
+        } catch {
+          // Pairing is best-effort.
+        }
+        settle(w);
+      }
+      if (root !== undefined) {
+        rootOf.set(el, root);
+      }
+    },
+    disconnected(el) {
+      const w = current;
+      if (w === undefined) {
+        return;
+      }
+      const root = rootOf.get(el);
+      if (root !== undefined) {
+        const tag = el.localName;
+        let byTag = w.pending.get(root);
+        if (byTag === undefined) {
+          w.pending.set(root, (byTag = new Map()));
+        }
+        let queue = byTag.get(tag);
+        if (queue === undefined) {
+          byTag.set(tag, (queue = []));
+        }
+        unqueue(w, el);
+        queue.push(el);
+        w.pendingOf.set(el, {root, tag});
+      }
+      settle(w);
+    },
+    open() {
+      const mode = options.mode();
+      if (mode !== 'transfer' && mode !== 'reuse') {
+        return;
+      }
+      let w = current;
+      if (w === undefined) {
+        w = current = {
+          mode,
+          pending: new Map(),
+          pendingOf: new Map(),
+          pairs: [],
+          pairOf: new Map(),
+          originOf: new Map(),
+          waiting: 0,
+        };
+      }
+      w.mode = mode;
+      clearTimeout(w.cap);
+      const opened = w;
+      w.cap = setTimeout(() => close(opened), capMs);
+      settle(w);
+    },
+    watch(els) {
+      const w = current;
+      if (w === undefined) {
+        return;
+      }
+      const promises = [];
+      for (const el of els) {
+        try {
+          const p = el.updateComplete;
+          if (p instanceof Promise) {
+            promises.push(p);
+          }
+        } catch {
+          // No update promise to wait on.
+        }
+      }
+      w.waiting++;
+      clearTimeout(w.idle);
+      let left = promises.length + 1;
+      const done = () => {
+        if (--left === 0) {
+          w.waiting--;
+          settle(w);
+        }
+      };
+      for (const p of promises) {
+        // Rethrow: a failed update must still surface as an unhandled
+        // rejection, exactly as it would with nobody watching.
+        void p.then(done, (e) => {
+          done();
+          throw e;
+        });
+      }
+      queueMicrotask(done);
+    },
+    get active() {
+      return current !== undefined;
+    },
+  };
+};
+//# sourceMappingURL=child-state.js.map

package/lib/runtime/child-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"child-state.js","sourceRoot":"","sources":["../../src/lib/runtime/child-state.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Carries child element state across a template re-instantiation.\n *\n * When a hot patch changes a template's text, lit-html sees a new template,\n * clones fresh DOM and swaps it in: every custom element inside the edited\n * template is re-created and starts from its defaults. For a short window\n * after a hot patch this module pairs each element dropped from a root with\n * the next freshly created element of the same tag connected in that root\n * (FIFO, i.e. document order), then either copies the old element's state\n * onto the new one (`'transfer'`) or, where the new element carries no\n * bindings, puts the old element back in its place (`'reuse'`).\n *\n * Dependency-free and duck-typed like `patch.ts`. The lit-html internals it\n * reads (`_$litPart$`, `_$committedValue`, `_$template`, `_$parts`,\n * `_$startNode`, `_$endNode`) are looked up by their development names first\n * and then by the stable minified names lit's prod build gives them\n * (`_$AH`, `_$AD`, `_$AV`, `_$AA`, `_$AB`). Every access is guarded; when the\n * part tree can't be read, transfer skips only attribute-driven keys and\n * reuse falls back to transfer.\n */\n\nexport type ChildStateMode = 'reset' | 'transfer' | 'reuse';\n\n/** `Symbol.for` description prefix of the dev-only `#private` rewrite. */\nexport const PRIVATE_KEY_PREFIX = '@oddsquad/vite-plugin-lit#private:';\n\n/** Hard cap on how long a transfer window stays open. */\nexport const WINDOW_CAP_MS = 1000;\n\nconst ATTRIBUTE_PART = 1;\nconst CHILD_PART = 2;\nconst PROPERTY_PART = 3;\nconst BOOLEAN_PART = 4;\n\n/** Dev name, then the stable minified name from lit-html's prod build. */\nconst COMMITTED = ['_$committedValue', '_$AH'] as const;\nconst TEMPLATE = ['_$template', '_$AD'] as const;\nconst PARTS = ['_$parts', '_$AV'] as const;\nconst START = ['_$startNode', '_$AA'] as const;\nconst END = ['_$endNode', '_$AB'] as const;\nconst LIT_PART = '_$litPart$';\n\n/** Duck-typed lit-html part. */\nexport interface PartLike {\n  type: number;\n  element?: unknown;\n  name?: unknown;\n}\n\n/** Duck-typed element the window works with. */\nexport type ElementLike = HTMLElement & {\n  renderRoot?: unknown;\n  hasUpdated?: boolean;\n  updateComplete?: unknown;\n};\n\ninterface CtorLike {\n  elementProperties?: Map<PropertyKey, {attribute?: unknown} | undefined>;\n  __attributeToPropertyMap?: unknown;\n}\n\nconst internal = (\n  o: unknown,\n  [dev, prod]: readonly [string, string]\n): unknown => {\n  if (o === null || typeof o !== 'object') {\n    return undefined;\n  }\n  const r = o as Record<string, unknown>;\n  return dev in r ? r[dev] : r[prod];\n};\n\nconst isPart = (p: unknown): p is PartLike =>\n  p !== null &&\n  typeof p === 'object' &&\n  typeof (p as PartLike).type === 'number';\n\nconst MAX_PARTS = 100_000;\n\n/** Pushes `part` and, through child parts' committed values, every part below. */\nconst walkParts = (part: PartLike, out: PartLike[]): void => {\n  if (out.length > MAX_PARTS) {\n    throw new Error('part tree too large');\n  }\n  out.push(part);\n  if (part.type !== CHILD_PART) {\n    return;\n  }\n  const value = internal(part, COMMITTED);\n  if (Array.isArray(value)) {\n    // An iterable's committed value is an array of ChildParts.\n    for (const child of value) {\n      if (isPart(child)) {\n        walkParts(child, out);\n      }\n    }\n    return;\n  }\n  const parts = internal(value, PARTS);\n  if (Array.isArray(parts) && internal(value, TEMPLATE) !== undefined) {\n    for (const child of parts) {\n      // Entries may be undefined (parts removed by the polyfill/hydration).\n      if (isPart(child)) {\n        walkParts(child, out);\n      }\n    }\n  }\n};\n\n/**\n * Every lit-html part rendered into the tree `el` lives in: the parts of each\n * render container (`_$litPart$`) among `el`'s ancestors up to its root.\n * `undefined` when `el` isn't in a tree or the walk hits a surprise.\n */\nexport const partsAround = (el: Node): PartLike[] | undefined => {\n  try {\n    const out: PartLike[] = [];\n    let node: Node | null = el.parentNode;\n    if (node === null) {\n      return undefined;\n    }\n    while (node !== null) {\n      const root = (node as unknown as Record<string, unknown>)[LIT_PART];\n      if (isPart(root)) {\n        walkParts(root, out);\n      }\n      node = node.parentNode;\n    }\n    return out;\n  } catch {\n    return undefined;\n  }\n};\n\n/** Attribute name → reactive property key for an element's class. */\nconst attributeMap = (ctor: CtorLike): Map<string, PropertyKey> => {\n  // Dev builds keep the name; prod mangles it, so rebuild from options.\n  const own = ctor.__attributeToPropertyMap;\n  if (own instanceof Map) {\n    return own as Map<string, PropertyKey>;\n  }\n  const map = new Map<string, PropertyKey>();\n  const props = ctor.elementProperties;\n  if (!(props instanceof Map)) {\n    return map;\n  }\n  for (const [key, options] of props) {\n    const attribute = options?.attribute;\n    if (attribute === false) {\n      continue;\n    }\n    if (typeof attribute === 'string') {\n      map.set(attribute, key);\n    } else if (typeof key === 'string') {\n      map.set(key.toLowerCase(), key);\n    }\n  }\n  return map;\n};\n\nconst propertyKeys = (ctor: CtorLike | undefined): PropertyKey[] => {\n  const props = ctor?.elementProperties;\n  return props instanceof Map ? [...props.keys()] : [];\n};\n\n/**\n * Reactive property keys the new element already got from its template:\n * keys whose attribute is present on it (static attributes), plus, when the\n * part tree could be read, keys bound by a property, boolean or attribute\n * part targeting it.\n */\nexport const templateDrivenKeys = (\n  el: ElementLike,\n  parts: readonly PartLike[] | undefined\n): Set<PropertyKey> => {\n  const keys = new Set<PropertyKey>();\n  const ctor = el.constructor as CtorLike;\n  const attrs = attributeMap(ctor);\n  try {\n    for (const attr of Array.from(el.attributes)) {\n      const key = attrs.get(attr.name.toLowerCase());\n      if (key !== undefined) {\n        keys.add(key);\n      }\n    }\n  } catch {\n    // No attributes to read.\n  }\n  for (const part of parts ?? []) {\n    if (part.element !== el || typeof part.name !== 'string') {\n      continue;\n    }\n    if (part.type === PROPERTY_PART) {\n      keys.add(part.name);\n    } else if (part.type === ATTRIBUTE_PART || part.type === BOOLEAN_PART) {\n      keys.add(attrs.get(part.name.toLowerCase()) ?? part.name);\n    }\n  }\n  return keys;\n};\n\n/** Own symbol keys of `el` minted by the dev-only `#private` rewrite. */\nexport const privateKeys = (el: object): symbol[] =>\n  Object.getOwnPropertySymbols(el).filter((sym) =>\n    (Symbol.keyFor(sym) ?? '').startsWith(PRIVATE_KEY_PREFIX)\n  );\n\n/**\n * Copies `from`'s state onto `to`: reactive properties not driven by `to`'s\n * template, and the `#private` members the dev rewrite turned into\n * `Symbol.for` keys. Nothing else — Lit's own bookkeeping lives in string\n * keys and must stay per-instance.\n */\nexport const transferState = (\n  from: ElementLike,\n  to: ElementLike,\n  parts: readonly PartLike[] | undefined\n): void => {\n  const skip = templateDrivenKeys(to, parts);\n  const keys = new Set<PropertyKey>([\n    ...propertyKeys(to.constructor as CtorLike),\n    ...propertyKeys(from.constructor as CtorLike),\n  ]);\n  const src = from as unknown as Record<PropertyKey, unknown>;\n  const dst = to as unknown as Record<PropertyKey, unknown>;\n  for (const key of keys) {\n    if (skip.has(key)) {\n      continue;\n    }\n    try {\n      dst[key] = src[key];\n    } catch {\n      // A throwing setter; leave the default.\n    }\n  }\n  for (const sym of privateKeys(from)) {\n    try {\n      Object.defineProperty(\n        to,\n        sym,\n        Object.getOwnPropertyDescriptor(from, sym)!\n      );\n    } catch {\n      // Non-configurable on the target; leave it.\n    }\n  }\n};\n\nconst inside = (el: Node, node: unknown): boolean =>\n  node !== null &&\n  typeof node === 'object' &&\n  typeof (node as Node).nodeType === 'number' &&\n  el.contains(node as Node);\n\n/**\n * Whether `el` (and its light DOM) carries no bindings, so another element\n * can take its place without lit-html noticing: no part targets it or an\n * element inside it, no child part's markers or parent lie inside it, and\n * nothing rendered into it as a container. `false` when `parts` is unknown.\n */\nexport const isReuseSafe = (\n  el: ElementLike,\n  parts: readonly PartLike[] | undefined\n): boolean => {\n  if (parts === undefined) {\n    return false;\n  }\n  try {\n    if (LIT_PART in el) {\n      return false;\n    }\n    for (const part of parts) {\n      if (inside(el, part.element)) {\n        return false;\n      }\n      if (part.type === CHILD_PART) {\n        const start = internal(part, START) as Node | null | undefined;\n        const end = internal(part, END) as Node | null | undefined;\n        if (\n          inside(el, start) ||\n          inside(el, end) ||\n          inside(el, start?.parentNode) ||\n          inside(el, end?.parentNode)\n        ) {\n          return false;\n        }\n      }\n    }\n    return true;\n  } catch {\n    return false;\n  }\n};\n\n/**\n * Puts `old` back where `fresh` is: `old` takes `fresh`'s attributes and\n * light-DOM children, then replaces it. `old` keeps its identity, state,\n * shadow DOM and controllers, and reconnects.\n */\nexport const swapBack = (old: ElementLike, fresh: ElementLike): void => {\n  for (const attr of Array.from(old.attributes)) {\n    if (!fresh.hasAttribute(attr.name)) {\n      old.removeAttribute(attr.name);\n    }\n  }\n  for (const attr of Array.from(fresh.attributes)) {\n    if (old.getAttribute(attr.name) !== attr.value) {\n      old.setAttribute(attr.name, attr.value);\n    }\n  }\n  old.replaceChildren(...Array.from(fresh.childNodes));\n  fresh.replaceWith(old);\n};\n\ninterface Pending {\n  root: Node;\n  tag: string;\n}\n\ninterface TransferWindow {\n  mode: 'transfer' | 'reuse';\n  /** Elements dropped during the window, by root then tag, in drop order. */\n  pending: Map<Node, Map<string, ElementLike[]>>;\n  pendingOf: Map<ElementLike, Pending>;\n  /** (old, new) in pairing order; `old` is the chain's original element. */\n  pairs: Array<[ElementLike, ElementLike]>;\n  /** New element → the element it replaced (immediate predecessor). */\n  pairOf: Map<ElementLike, ElementLike>;\n  /** New element → the first element of its replacement chain. */\n  originOf: Map<ElementLike, ElementLike>;\n  /** Outstanding `watch()` batches. */\n  waiting: number;\n  idle?: ReturnType<typeof setTimeout>;\n  cap?: ReturnType<typeof setTimeout>;\n}\n\nexport interface ChildStateOptions {\n  /** Read at every `open()`. */\n  mode: () => ChildStateMode;\n  /** Hard cap on a window's lifetime. Defaults to {@link WINDOW_CAP_MS}. */\n  capMs?: number;\n}\n\nexport interface ChildState {\n  /**\n   * From the instrumented `connectedCallback`, before the original runs.\n   * `fresh` is whether the element has never been connected before.\n   */\n  connected(el: ElementLike, fresh: boolean): void;\n  /** From the instrumented `disconnectedCallback`. */\n  disconnected(el: ElementLike): void;\n  /** A hot patch is about to re-render instances: open (or extend) a window. */\n  open(): void;\n  /** Keep the window open until these instances' updates complete. */\n  watch(els: Iterable<ElementLike>): void;\n  /** Whether a window is currently open. */\n  readonly active: boolean;\n}\n\nexport const createChildState = (options: ChildStateOptions): ChildState => {\n  const capMs = options.capMs ?? WINDOW_CAP_MS;\n  /** The root each element was last connected in. */\n  const rootOf = new WeakMap<ElementLike, Node>();\n  let current: TransferWindow | undefined;\n\n  const close = (w: TransferWindow): void => {\n    if (current !== w) {\n      return;\n    }\n    current = undefined;\n    clearTimeout(w.idle);\n    clearTimeout(w.cap);\n    // Reuse only once everything we waited on has settled; on the hard cap\n    // with updates still outstanding, the transferred state stands.\n    if (w.mode !== 'reuse' || w.waiting > 0) {\n      return;\n    }\n    for (const [old, fresh] of w.pairs) {\n      // A pair inside an element that was itself swapped back is moot:\n      // the old element's shadow DOM came back intact with it.\n      if (!fresh.isConnected || old.isConnected) {\n        continue;\n      }\n      try {\n        if (isReuseSafe(fresh, partsAround(fresh))) {\n          swapBack(old, fresh);\n        }\n      } catch {\n        // Leave the new element (it already has the transferred state).\n      }\n    }\n  };\n\n  /** Close once a macrotask passes with no tracked activity. */\n  const settle = (w: TransferWindow): void => {\n    if (current !== w || w.waiting > 0) {\n      return;\n    }\n    clearTimeout(w.idle);\n    w.idle = setTimeout(() => close(w), 0);\n  };\n\n  /** The pending-queue root for an element now connected in `root`. */\n  const keyRoot = (w: TransferWindow, root: Node): Node => {\n    const host = (root as Partial<ShadowRoot>).host as ElementLike | undefined;\n    const old = host === undefined ? undefined : w.pairOf.get(host);\n    if (old !== undefined) {\n      // Re-created inside a new element's shadow: match against what was\n      // dropped from the old element's shadow.\n      const oldRoot = (old.renderRoot ?? old.shadowRoot) as Node | undefined;\n      if (oldRoot !== undefined && oldRoot !== null && w.pending.has(oldRoot)) {\n        return oldRoot;\n      }\n    }\n    return root;\n  };\n\n  const unqueue = (w: TransferWindow, el: ElementLike): void => {\n    const at = w.pendingOf.get(el);\n    if (at === undefined) {\n      return;\n    }\n    w.pendingOf.delete(el);\n    const queue = w.pending.get(at.root)?.get(at.tag);\n    const i = queue?.indexOf(el) ?? -1;\n    if (i >= 0) {\n      queue!.splice(i, 1);\n    }\n  };\n\n  const pair = (w: TransferWindow, fresh: ElementLike, root: Node): void => {\n    const queue = w.pending.get(keyRoot(w, root))?.get(fresh.localName);\n    const old = queue?.shift();\n    if (old === undefined) {\n      return;\n    }\n    w.pendingOf.delete(old);\n    w.pairOf.set(fresh, old);\n    const origin = w.originOf.get(old) ?? old;\n    w.originOf.set(fresh, origin);\n    w.pairs.push([origin, fresh]);\n    // lit-html assigns the new template instance to its part only after the\n    // fragment is inserted, so the parts targeting `fresh` aren't reachable\n    // yet. Queued before the original connectedCallback enables updating,\n    // this runs ahead of `fresh`'s first update.\n    queueMicrotask(() => {\n      try {\n        transferState(old, fresh, partsAround(fresh));\n      } catch {\n        // Keep the defaults.\n      }\n    });\n  };\n\n  return {\n    connected(el, fresh) {\n      let root: Node | undefined;\n      try {\n        root = el.getRootNode();\n      } catch {\n        root = undefined;\n      }\n      const w = current;\n      if (w !== undefined) {\n        try {\n          if (fresh && root !== undefined && el.hasUpdated !== true) {\n            pair(w, el, root);\n          } else {\n            // Moved, not re-created: it can't be anyone's replacement.\n            unqueue(w, el);\n          }\n        } catch {\n          // Pairing is best-effort.\n        }\n        settle(w);\n      }\n      if (root !== undefined) {\n        rootOf.set(el, root);\n      }\n    },\n    disconnected(el) {\n      const w = current;\n      if (w === undefined) {\n        return;\n      }\n      const root = rootOf.get(el);\n      if (root !== undefined) {\n        const tag = el.localName;\n        let byTag = w.pending.get(root);\n        if (byTag === undefined) {\n          w.pending.set(root, (byTag = new Map()));\n        }\n        let queue = byTag.get(tag);\n        if (queue === undefined) {\n          byTag.set(tag, (queue = []));\n        }\n        unqueue(w, el);\n        queue.push(el);\n        w.pendingOf.set(el, {root, tag});\n      }\n      settle(w);\n    },\n    open() {\n      const mode = options.mode();\n      if (mode !== 'transfer' && mode !== 'reuse') {\n        return;\n      }\n      let w = current;\n      if (w === undefined) {\n        w = current = {\n          mode,\n          pending: new Map(),\n          pendingOf: new Map(),\n          pairs: [],\n          pairOf: new Map(),\n          originOf: new Map(),\n          waiting: 0,\n        };\n      }\n      w.mode = mode;\n      clearTimeout(w.cap);\n      const opened = w;\n      w.cap = setTimeout(() => close(opened), capMs);\n      settle(w);\n    },\n    watch(els) {\n      const w = current;\n      if (w === undefined) {\n        return;\n      }\n      const promises: Promise<unknown>[] = [];\n      for (const el of els) {\n        try {\n          const p = el.updateComplete;\n          if (p instanceof Promise) {\n            promises.push(p);\n          }\n        } catch {\n          // No update promise to wait on.\n        }\n      }\n      w.waiting++;\n      clearTimeout(w.idle);\n      let left = promises.length + 1;\n      const done = () => {\n        if (--left === 0) {\n          w.waiting--;\n          settle(w);\n        }\n      };\n      for (const p of promises) {\n        // Rethrow: a failed update must still surface as an unhandled\n        // rejection, exactly as it would with nobody watching.\n        void p.then(done, (e: unknown) => {\n          done();\n          throw e;\n        });\n      }\n      queueMicrotask(done);\n    },\n    get active() {\n      return current !== undefined;\n    },\n  };\n};\n"]}

package/lib/runtime/css.d.ts

@@ -1,7 +1,18 @@
 /**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
+ * Browser helpers for referencing CSS files from shadow roots via Vite's
+ * `?url` imports.
+ *
+ * A `?url` import yields a real stylesheet URL — the dev server serves the
+ * file as CSS, and `vite build` emits it as a hashed `.css` asset. That
+ * makes it the right base for `<link>` hrefs and `@import url()`s inside
+ * shadow roots. The one gap is dev HMR: the imported URL string is identical
+ * across module re-executions, so the browser would keep the stale
+ * stylesheet. These helpers close that gap.
+ *
+ * This module is dependency-free and must stay safe to load in any
+ * environment.
+ *
+ * @module
  */
 /**
  * Appends a cache-busting query to a `?url`-imported CSS file URL in dev.

package/lib/runtime/css.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA4BH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,MAE1C,CAAC;AAqBF;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;OASG;IACH,KAAK,EAAE,aAAa,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,QAAQ,QAAS,MAAM,KAAG,QAkCtC,CAAC"}
+{"version":3,"file":"css.d.ts","sourceRoot":"","sources":["../../src/lib/runtime/css.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;GAeG;AAaH;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,YAAY,QAAS,MAAM,KAAG,MAE1C,CAAC;AAqBF;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;;;;;;;;OASG;IACH,KAAK,EAAE,aAAa,CAAC;IACrB;;;;;;;;;;;;OAYG;IACH,WAAW,EAAE,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,QAAQ,QAAS,MAAM,KAAG,QAkCtC,CAAC"}

package/lib/runtime/css.js

@@ -1,8 +1,4 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
- */
+/* @ts-self-types="./css.d.ts" */
 /**
  * Browser helpers for referencing CSS files from shadow roots via Vite's
  * `?url` imports.
@@ -16,6 +12,8 @@
  *
  * This module is dependency-free and must stay safe to load in any
  * environment.
+ *
+ * @module
  */
 /**
  * Vite's dev flag. Accessed as a direct member expression (`import.meta.env.DEV`)

package/lib/runtime/css.js.map

@@ -1 +1 @@
-{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH;;;;;;;GAOG;AACH,MAAM,KAAK,GAAG,GAAY,EAAE,CACzB,OAAO,IAAgC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE;IAClD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE;IACxC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;AACxD,CAAC,CAAC;AAkCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAY,EAAE;IAChD,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,qEAAqE;IACrE,yEAAyE;IACzE,uEAAuE;IACvE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,CAAC,IAAY,EAAiB,EAAE;QAC7C,MAAM,KAAK,GAAG,EAAE,MAAM,CAAC;QACvB,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;aAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,wEAAwE;YACxE,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,kEAAkE;YAClE,OAAO,CAAC,IAAI,CAAC,yCAAyC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO;QACL,KAAK;QACL,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/**\n * @license\n * Copyright 2026 Google LLC\n * SPDX-License-Identifier: BSD-3-Clause\n */\n\n/**\n * Browser helpers for referencing CSS files from shadow roots via Vite's\n * `?url` imports.\n *\n * A `?url` import yields a real stylesheet URL — the dev server serves the\n * file as CSS, and `vite build` emits it as a hashed `.css` asset. That\n * makes it the right base for `<link>` hrefs and `@import url()`s inside\n * shadow roots. The one gap is dev HMR: the imported URL string is identical\n * across module re-executions, so the browser would keep the stale\n * stylesheet. These helpers close that gap.\n *\n * This module is dependency-free and must stay safe to load in any\n * environment.\n */\n\n/**\n * Vite's dev flag. Accessed as a direct member expression (`import.meta.env.DEV`)\n * so the bundler can statically replace it per key. Aliasing the whole object\n * (`const env = import.meta.env`) instead defeats that replacement and makes\n * Vite inline the ENTIRE serialized `import.meta.env` — every env var — into the\n * consumer bundle. Optional chaining keeps this safe where `import.meta.env` is\n * absent (non-Vite runtimes).\n */\nconst isDev = (): boolean =>\n  (import.meta as {env?: {DEV?: boolean}}).env?.DEV === true;\n\n/**\n * Appends a cache-busting query to a `?url`-imported CSS file URL in dev.\n *\n * Call this at *module scope* (not in `render()`, where every render would\n * refetch): each HMR re-execution then yields a fresh href and the browser\n * refetches the changed stylesheet.\n *\n * In production builds the URL is a content-hashed asset, so the input is\n * returned unchanged.\n *\n * @example\n * ```ts\n * import cssUrl from './my-element.css?url';\n * import {devCacheBust} from '@oddsquad/vite-plugin-lit/css.js';\n *\n * const href = devCacheBust(cssUrl); // module scope\n * html`<link rel=\"stylesheet\" href=\"${href}\" />`;\n * ```\n */\nexport const devCacheBust = (url: string): string => {\n  return isDev() ? `${url}?t=${Date.now()}` : url;\n};\n\n/**\n * In dev, turns a `?url`-imported CSS path into one that fetches the\n * *compiled CSS bytes* (`text/css`). Vite serves a `?url` CSS path as a JS\n * module (`__vite__updateStyle(…)`), so a plain `fetch().text()` returns\n * JavaScript; the `direct` query makes it return the stylesheet instead,\n * pipeline-processed the same way the build asset is. In production the URL\n * is already a real `.css` asset, so it's returned unchanged.\n *\n * Joined with `?` or `&` depending on whether the URL already carries a query\n * (a freshly started dev server yields a bare path; after an HMR cache-bust\n * it carries `?t=…`).\n */\nconst devDirect = (url: string): string => {\n  if (!isDev()) {\n    return url;\n  }\n  return `${url}${url.includes('?') ? '&' : '?'}direct`;\n};\n\n/**\n * A shared `CSSStyleSheet` backed by a `?url` CSS asset, plus the callback to\n * hot-swap it in place. Returned by {@link urlSheet}.\n */\nexport interface UrlSheet {\n  /**\n   * The constructed stylesheet. Adopt it from any number of components\n   * (`static styles = [sheet]`); an edit to the source CSS re-fetches and\n   * `replaceSync()`s it, updating every shadow root that adopted it without\n   * re-rendering a component or reloading the page.\n   *\n   * It is empty until the first fetch resolves, so expect a brief flash of\n   * unstyled content on initial load — the cost of keeping the CSS as a real\n   * asset rather than inlining it into the JS bundle.\n   */\n  sheet: CSSStyleSheet;\n  /**\n   * Vite HMR accept callback for the `?url` dependency. Wire it up with the\n   * *same literal specifier* you imported — Vite resolves accepted deps by\n   * static analysis, so the string has to appear in your module:\n   *\n   * ```ts\n   * import.meta.hot?.accept('./utils.css?url', onHotUpdate);\n   * ```\n   *\n   * Typed to match Vite's accept callback (`ModuleNamespace | undefined`) so\n   * it drops straight in; the new module's `default` export is the updated\n   * `?url` string.\n   */\n  onHotUpdate: (mod: Record<string, unknown> | undefined) => void;\n}\n\n/**\n * Builds a {@link UrlSheet} from a `?url`-imported CSS asset: a single\n * constructed `CSSStyleSheet`, shareable across shadow roots via\n * `adoptedStyleSheets`, that hot-swaps in place on edits — no component\n * re-render, no full-page reload.\n *\n * `?url` keeps the stylesheet as a standalone, pipeline-processed `.css` file\n * in the build output (unlike `?inline`/`?raw`, which inline it into the JS\n * chunk). The file is read into the sheet at runtime via `fetch()`, with the\n * dev/build path difference handled internally.\n *\n * @example\n * ```ts\n * import {urlSheet} from '@oddsquad/vite-plugin-lit/css.js';\n * import sheetUrl from './utils.css?url';\n *\n * const {sheet, onHotUpdate} = urlSheet(sheetUrl);\n * export default sheet; // `static styles = [sheet]` in components\n *\n * import.meta.hot?.accept('./utils.css?url', onHotUpdate);\n * ```\n */\nexport const urlSheet = (url: string): UrlSheet => {\n  const sheet = new CSSStyleSheet();\n  // Guards against out-of-order fetch resolution: two rapid edits fire\n  // overlapping fetches, and a slower earlier one must not land after (and\n  // clobber) a newer one. Only the most recently issued request applies.\n  let latest = 0;\n  const update = (next: string): Promise<void> => {\n    const token = ++latest;\n    return fetch(devDirect(next))\n      .then((r) => {\n        // A 404 still has a body (Vite's fallback page); don't adopt it as css.\n        if (!r.ok) throw new Error(`HTTP ${r.status}`);\n        return r.text();\n      })\n      .then((css) => {\n        if (token === latest) {\n          sheet.replaceSync(css);\n        }\n      })\n      .catch((err: unknown) => {\n        // Keep the last good sheet; just say why this update didn't land.\n        console.warn(`[lit-plugin] urlSheet: failed to load ${next}:`, err);\n      });\n  };\n  void update(url);\n  return {\n    sheet,\n    onHotUpdate: (mod) => {\n      const next = mod?.['default'];\n      if (typeof next === 'string') {\n        void update(next);\n      }\n    },\n  };\n};\n"]}
+{"version":3,"file":"css.js","sourceRoot":"","sources":["../../src/lib/runtime/css.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC;;;;;;;;;;;;;;;GAeG;AAEH;;;;;;;GAOG;AACH,MAAM,KAAK,GAAG,GAAY,EAAE,CACzB,OAAO,IAAgC,CAAC,GAAG,EAAE,GAAG,KAAK,IAAI,CAAC;AAE7D;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE;IAClD,OAAO,KAAK,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC;AAClD,CAAC,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,SAAS,GAAG,CAAC,GAAW,EAAU,EAAE;IACxC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC;QACb,OAAO,GAAG,CAAC;IACb,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC;AACxD,CAAC,CAAC;AAkCF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAY,EAAE;IAChD,MAAM,KAAK,GAAG,IAAI,aAAa,EAAE,CAAC;IAClC,qEAAqE;IACrE,yEAAyE;IACzE,uEAAuE;IACvE,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,MAAM,GAAG,CAAC,IAAY,EAAiB,EAAE;QAC7C,MAAM,KAAK,GAAG,EAAE,MAAM,CAAC;QACvB,OAAO,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;aAC1B,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YACV,wEAAwE;YACxE,IAAI,CAAC,CAAC,CAAC,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;YAC/C,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QAClB,CAAC,CAAC;aACD,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;YACZ,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;gBACrB,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,kEAAkE;YAClE,OAAO,CAAC,IAAI,CAAC,yCAAyC,IAAI,GAAG,EAAE,GAAG,CAAC,CAAC;QACtE,CAAC,CAAC,CAAC;IACP,CAAC,CAAC;IACF,KAAK,MAAM,CAAC,GAAG,CAAC,CAAC;IACjB,OAAO;QACL,KAAK;QACL,WAAW,EAAE,CAAC,GAAG,EAAE,EAAE;YACnB,MAAM,IAAI,GAAG,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;YAC9B,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC7B,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC;YACpB,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC,CAAC","sourcesContent":["/* @ts-self-types=\"./css.d.ts\" */\n/**\n * Browser helpers for referencing CSS files from shadow roots via Vite's\n * `?url` imports.\n *\n * A `?url` import yields a real stylesheet URL — the dev server serves the\n * file as CSS, and `vite build` emits it as a hashed `.css` asset. That\n * makes it the right base for `<link>` hrefs and `@import url()`s inside\n * shadow roots. The one gap is dev HMR: the imported URL string is identical\n * across module re-executions, so the browser would keep the stale\n * stylesheet. These helpers close that gap.\n *\n * This module is dependency-free and must stay safe to load in any\n * environment.\n *\n * @module\n */\n\n/**\n * Vite's dev flag. Accessed as a direct member expression (`import.meta.env.DEV`)\n * so the bundler can statically replace it per key. Aliasing the whole object\n * (`const env = import.meta.env`) instead defeats that replacement and makes\n * Vite inline the ENTIRE serialized `import.meta.env` — every env var — into the\n * consumer bundle. Optional chaining keeps this safe where `import.meta.env` is\n * absent (non-Vite runtimes).\n */\nconst isDev = (): boolean =>\n  (import.meta as {env?: {DEV?: boolean}}).env?.DEV === true;\n\n/**\n * Appends a cache-busting query to a `?url`-imported CSS file URL in dev.\n *\n * Call this at *module scope* (not in `render()`, where every render would\n * refetch): each HMR re-execution then yields a fresh href and the browser\n * refetches the changed stylesheet.\n *\n * In production builds the URL is a content-hashed asset, so the input is\n * returned unchanged.\n *\n * @example\n * ```ts\n * import cssUrl from './my-element.css?url';\n * import {devCacheBust} from '@oddsquad/vite-plugin-lit/css.js';\n *\n * const href = devCacheBust(cssUrl); // module scope\n * html`<link rel=\"stylesheet\" href=\"${href}\" />`;\n * ```\n */\nexport const devCacheBust = (url: string): string => {\n  return isDev() ? `${url}?t=${Date.now()}` : url;\n};\n\n/**\n * In dev, turns a `?url`-imported CSS path into one that fetches the\n * *compiled CSS bytes* (`text/css`). Vite serves a `?url` CSS path as a JS\n * module (`__vite__updateStyle(…)`), so a plain `fetch().text()` returns\n * JavaScript; the `direct` query makes it return the stylesheet instead,\n * pipeline-processed the same way the build asset is. In production the URL\n * is already a real `.css` asset, so it's returned unchanged.\n *\n * Joined with `?` or `&` depending on whether the URL already carries a query\n * (a freshly started dev server yields a bare path; after an HMR cache-bust\n * it carries `?t=…`).\n */\nconst devDirect = (url: string): string => {\n  if (!isDev()) {\n    return url;\n  }\n  return `${url}${url.includes('?') ? '&' : '?'}direct`;\n};\n\n/**\n * A shared `CSSStyleSheet` backed by a `?url` CSS asset, plus the callback to\n * hot-swap it in place. Returned by {@link urlSheet}.\n */\nexport interface UrlSheet {\n  /**\n   * The constructed stylesheet. Adopt it from any number of components\n   * (`static styles = [sheet]`); an edit to the source CSS re-fetches and\n   * `replaceSync()`s it, updating every shadow root that adopted it without\n   * re-rendering a component or reloading the page.\n   *\n   * It is empty until the first fetch resolves, so expect a brief flash of\n   * unstyled content on initial load — the cost of keeping the CSS as a real\n   * asset rather than inlining it into the JS bundle.\n   */\n  sheet: CSSStyleSheet;\n  /**\n   * Vite HMR accept callback for the `?url` dependency. Wire it up with the\n   * *same literal specifier* you imported — Vite resolves accepted deps by\n   * static analysis, so the string has to appear in your module:\n   *\n   * ```ts\n   * import.meta.hot?.accept('./utils.css?url', onHotUpdate);\n   * ```\n   *\n   * Typed to match Vite's accept callback (`ModuleNamespace | undefined`) so\n   * it drops straight in; the new module's `default` export is the updated\n   * `?url` string.\n   */\n  onHotUpdate: (mod: Record<string, unknown> | undefined) => void;\n}\n\n/**\n * Builds a {@link UrlSheet} from a `?url`-imported CSS asset: a single\n * constructed `CSSStyleSheet`, shareable across shadow roots via\n * `adoptedStyleSheets`, that hot-swaps in place on edits — no component\n * re-render, no full-page reload.\n *\n * `?url` keeps the stylesheet as a standalone, pipeline-processed `.css` file\n * in the build output (unlike `?inline`/`?raw`, which inline it into the JS\n * chunk). The file is read into the sheet at runtime via `fetch()`, with the\n * dev/build path difference handled internally.\n *\n * @example\n * ```ts\n * import {urlSheet} from '@oddsquad/vite-plugin-lit/css.js';\n * import sheetUrl from './utils.css?url';\n *\n * const {sheet, onHotUpdate} = urlSheet(sheetUrl);\n * export default sheet; // `static styles = [sheet]` in components\n *\n * import.meta.hot?.accept('./utils.css?url', onHotUpdate);\n * ```\n */\nexport const urlSheet = (url: string): UrlSheet => {\n  const sheet = new CSSStyleSheet();\n  // Guards against out-of-order fetch resolution: two rapid edits fire\n  // overlapping fetches, and a slower earlier one must not land after (and\n  // clobber) a newer one. Only the most recently issued request applies.\n  let latest = 0;\n  const update = (next: string): Promise<void> => {\n    const token = ++latest;\n    return fetch(devDirect(next))\n      .then((r) => {\n        // A 404 still has a body (Vite's fallback page); don't adopt it as css.\n        if (!r.ok) throw new Error(`HTTP ${r.status}`);\n        return r.text();\n      })\n      .then((css) => {\n        if (token === latest) {\n          sheet.replaceSync(css);\n        }\n      })\n      .catch((err: unknown) => {\n        // Keep the last good sheet; just say why this update didn't land.\n        console.warn(`[lit-plugin] urlSheet: failed to load ${next}:`, err);\n      });\n  };\n  void update(url);\n  return {\n    sheet,\n    onHotUpdate: (mod) => {\n      const next = mod?.['default'];\n      if (typeof next === 'string') {\n        void update(next);\n      }\n    },\n  };\n};\n"]}

package/lib/runtime/edge-panel.d.ts

@@ -1,7 +1,12 @@
 /**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
+ * Keeps our on-page dev UI (HMR indicator, source-overlay tooltip) clear of the
+ * Vite DevTools edge panel so they don't sit on top of it.
+ *
+ * The panel is `#vite-devtools-edge-panel` inside the open shadow root of the
+ * `<vite-devtools-dock-embedded>` host, and only exists while the dock is
+ * docked to an edge (it can be moved/resized). We report the inset, in px, that
+ * the panel occupies on each viewport edge it touches — plus a small gap — so
+ * callers can offset themselves.
  */
 export interface EdgeInsets {
     top: number;

package/lib/runtime/edge-panel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"edge-panel.d.ts","sourceRoot":"","sources":["../../src/lib/runtime/edge-panel.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAoBH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAyCD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAClB,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,KACrC,CAAC,MAAM,IAAI,CA+Db,CAAC"}
+{"version":3,"file":"edge-panel.d.ts","sourceRoot":"","sources":["../../src/lib/runtime/edge-panel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AASH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd;AAyCD;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,aAClB,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,KACrC,CAAC,MAAM,IAAI,CA+Db,CAAC"}

package/lib/runtime/edge-panel.js

@@ -1,8 +1,3 @@
-/**
- * @license
- * Copyright 2026 Google LLC
- * SPDX-License-Identifier: BSD-3-Clause
- */
 /**
  * Keeps our on-page dev UI (HMR indicator, source-overlay tooltip) clear of the
  * Vite DevTools edge panel so they don't sit on top of it.