@absolutejs/absolute 0.19.0-beta.1043 → 0.19.0-beta.1044

package/dist/core/streamingSlotRegistry.js

@@ -0,0 +1,194 @@
+// @bun
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+var __legacyDecorateClassTS = function(decorators, target, key, desc) {
+  var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+  if (typeof Reflect === "object" && typeof Reflect.decorate === "function")
+    r = Reflect.decorate(decorators, target, key, desc);
+  else
+    for (var i = decorators.length - 1;i >= 0; i--)
+      if (d = decorators[i])
+        r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+  return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __legacyMetadataTS = (k, v) => {
+  if (typeof Reflect === "object" && typeof Reflect.metadata === "function")
+    return Reflect.metadata(k, v);
+};
+var __esm = (fn, res) => () => (fn && (res = fn(fn = 0)), res);
+var __require = import.meta.require;
+
+// src/core/streamingSlotRegistrar.ts
+var STREAMING_SLOT_REGISTRAR_KEY = Symbol.for("absolutejs.streamingSlotRegistrar");
+var STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotWarningController");
+var STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotCollectionController");
+var getRegisteredStreamingSlotRegistrar = () => {
+  const value = Reflect.get(globalThis, STREAMING_SLOT_REGISTRAR_KEY);
+  if (typeof value === "function" || value === null) {
+    return value;
+  }
+  return;
+};
+var isObjectRecord = (value) => Boolean(value) && typeof value === "object";
+var isStreamingSlotWarningController = (value) => isObjectRecord(value) && ("maybeWarn" in value) && typeof value.maybeWarn === "function";
+var isStreamingSlotCollectionController = (value) => isObjectRecord(value) && ("isCollecting" in value) && typeof value.isCollecting === "function";
+var getWarningController = () => {
+  const value = Reflect.get(globalThis, STREAMING_SLOT_WARNING_STORAGE_KEY);
+  if (value === null || typeof value === "undefined")
+    return;
+  return isStreamingSlotWarningController(value) ? value : undefined;
+};
+var getCollectionController = () => {
+  const value = Reflect.get(globalThis, STREAMING_SLOT_COLLECTION_STORAGE_KEY);
+  if (value === null || typeof value === "undefined")
+    return;
+  return isStreamingSlotCollectionController(value) ? value : undefined;
+};
+var hasRegisteredStreamingSlotRegistrar = () => typeof getRegisteredStreamingSlotRegistrar() === "function";
+var isStreamingSlotCollectionActive = () => getCollectionController()?.isCollecting() === true;
+var registerStreamingSlot = (slot) => {
+  getRegisteredStreamingSlotRegistrar()?.(slot);
+};
+var setStreamingSlotCollectionController = (controller) => {
+  Reflect.set(globalThis, STREAMING_SLOT_COLLECTION_STORAGE_KEY, controller);
+};
+var setStreamingSlotRegistrar = (nextRegistrar) => {
+  Reflect.set(globalThis, STREAMING_SLOT_REGISTRAR_KEY, nextRegistrar);
+};
+var setStreamingSlotWarningController = (controller) => {
+  Reflect.set(globalThis, STREAMING_SLOT_WARNING_STORAGE_KEY, controller);
+};
+var warnMissingStreamingSlotCollector = (primitiveName) => {
+  if (isStreamingSlotCollectionActive()) {
+    return;
+  }
+  getWarningController()?.maybeWarn(primitiveName);
+};
+
+// src/core/streamingSlotRegistry.ts
+var STREAMING_SLOT_STORAGE_KEY = Symbol.for("absolutejs.streamingSlotAsyncLocalStorage");
+var isObjectRecord2 = (value) => Boolean(value) && typeof value === "object";
+var isAsyncLocalStorage = (value) => isObjectRecord2(value) && ("getStore" in value) && typeof value.getStore === "function" && ("run" in value) && typeof value.run === "function";
+var getStorageGlobal = () => {
+  const value = Reflect.get(globalThis, STREAMING_SLOT_STORAGE_KEY);
+  if (value === null || typeof value === "undefined") {
+    return value;
+  }
+  return isAsyncLocalStorage(value) ? value : undefined;
+};
+var isServerRuntime = () => typeof process !== "undefined" && typeof process.versions?.node === "string";
+var ensureAsyncLocalStorage = async () => {
+  const storage = getStorageGlobal();
+  if (typeof storage !== "undefined") {
+    return storage;
+  }
+  if (!isServerRuntime()) {
+    Reflect.set(globalThis, STREAMING_SLOT_STORAGE_KEY, null);
+    return getStorageGlobal();
+  }
+  const mod = await import("async_hooks");
+  Reflect.set(globalThis, STREAMING_SLOT_STORAGE_KEY, new mod.AsyncLocalStorage);
+  return getStorageGlobal();
+};
+var getActiveSlotStore = () => {
+  const storage = getStorageGlobal();
+  if (!storage)
+    return;
+  return storage.getStore();
+};
+var registerStreamingSlot2 = (slot) => {
+  const store = getActiveSlotStore();
+  if (!store)
+    return;
+  store.set(slot.id, slot);
+};
+setStreamingSlotRegistrar(registerStreamingSlot2);
+setStreamingSlotCollectionController({
+  isCollecting: () => getActiveSlotStore() !== undefined
+});
+var hasActiveStreamingSlotRegistry = () => getActiveSlotStore() !== undefined;
+var runWithStreamingSlotRegistry = async (task) => {
+  const storage = await ensureAsyncLocalStorage();
+  if (!storage) {
+    const slots = [];
+    return {
+      result: await task(),
+      slots
+    };
+  }
+  return storage.run(new Map, async () => {
+    const result = await task();
+    const store = storage.getStore();
+    return {
+      result,
+      slots: store ? [...store.values()] : []
+    };
+  });
+};
+export {
+  runWithStreamingSlotRegistry,
+  hasActiveStreamingSlotRegistry
+};
+
+//# debugId=B49ED06B058CECE964756E2164756E21
+//# sourceMappingURL=streamingSlotRegistry.js.map

package/dist/core/streamingSlotRegistry.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/core/streamingSlotRegistrar.ts", "../src/core/streamingSlotRegistry.ts"],
+  "sourcesContent": [
+    "import type { StreamingSlot } from '../utils/streamingSlots';\n\ntype StreamingSlotRegistrar = (slot: StreamingSlot) => void;\ntype StreamingSlotWarningController = {\n\tmaybeWarn(primitiveName: string): void;\n};\ntype StreamingSlotCollectionController = {\n\tisCollecting(): boolean;\n};\n\nconst STREAMING_SLOT_REGISTRAR_KEY = Symbol.for(\n\t'absolutejs.streamingSlotRegistrar'\n);\nconst STREAMING_SLOT_WARNING_STORAGE_KEY = Symbol.for(\n\t'absolutejs.streamingSlotWarningController'\n);\nconst STREAMING_SLOT_COLLECTION_STORAGE_KEY = Symbol.for(\n\t'absolutejs.streamingSlotCollectionController'\n);\n\nconst getRegisteredStreamingSlotRegistrar = () => {\n\tconst value = Reflect.get(globalThis, STREAMING_SLOT_REGISTRAR_KEY);\n\tif (typeof value === 'function' || value === null) {\n\t\treturn value;\n\t}\n\n\treturn undefined;\n};\n\nconst isObjectRecord = (value: unknown): value is Record<string, unknown> =>\n\tBoolean(value) && typeof value === 'object';\n\nconst isStreamingSlotWarningController = (\n\tvalue: unknown\n): value is StreamingSlotWarningController =>\n\tisObjectRecord(value) &&\n\t'maybeWarn' in value &&\n\ttypeof value.maybeWarn === 'function';\n\nconst isStreamingSlotCollectionController = (\n\tvalue: unknown\n): value is StreamingSlotCollectionController =>\n\tisObjectRecord(value) &&\n\t'isCollecting' in value &&\n\ttypeof value.isCollecting === 'function';\n\nconst getWarningController = () => {\n\tconst value = Reflect.get(globalThis, STREAMING_SLOT_WARNING_STORAGE_KEY);\n\tif (value === null || typeof value === 'undefined') return undefined;\n\n\treturn isStreamingSlotWarningController(value) ? value : undefined;\n};\n\nconst getCollectionController = () => {\n\tconst value = Reflect.get(\n\t\tglobalThis,\n\t\tSTREAMING_SLOT_COLLECTION_STORAGE_KEY\n\t);\n\tif (value === null || typeof value === 'undefined') return undefined;\n\n\treturn isStreamingSlotCollectionController(value) ? value : undefined;\n};\n\nexport const hasRegisteredStreamingSlotRegistrar = () =>\n\ttypeof getRegisteredStreamingSlotRegistrar() === 'function';\nexport const isStreamingSlotCollectionActive = () =>\n\tgetCollectionController()?.isCollecting() === true;\nexport const registerStreamingSlot = (slot: StreamingSlot) => {\n\tgetRegisteredStreamingSlotRegistrar()?.(slot);\n};\nexport const setStreamingSlotCollectionController = (\n\tcontroller: StreamingSlotCollectionController | null\n) => {\n\tReflect.set(globalThis, STREAMING_SLOT_COLLECTION_STORAGE_KEY, controller);\n};\nexport const setStreamingSlotRegistrar = (\n\tnextRegistrar: StreamingSlotRegistrar | null\n) => {\n\tReflect.set(globalThis, STREAMING_SLOT_REGISTRAR_KEY, nextRegistrar);\n};\nexport const setStreamingSlotWarningController = (\n\tcontroller: StreamingSlotWarningController | null\n) => {\n\tReflect.set(globalThis, STREAMING_SLOT_WARNING_STORAGE_KEY, controller);\n};\nexport const warnMissingStreamingSlotCollector = (primitiveName: string) => {\n\tif (\n\t\tprocess.env.NODE_ENV === 'production' ||\n\t\tisStreamingSlotCollectionActive()\n\t) {\n\t\treturn;\n\t}\n\n\tgetWarningController()?.maybeWarn(primitiveName);\n};\n",
+    "import type { StreamingSlot } from '../utils/streamingSlots';\nimport {\n\tsetStreamingSlotCollectionController,\n\tsetStreamingSlotRegistrar\n} from './streamingSlotRegistrar';\n\ntype SlotStore = Map<string, StreamingSlot>;\ntype AsyncLocalStorageType =\n\timport('node:async_hooks').AsyncLocalStorage<SlotStore>;\n\nconst STREAMING_SLOT_STORAGE_KEY = Symbol.for(\n\t'absolutejs.streamingSlotAsyncLocalStorage'\n);\n\nconst isObjectRecord = (value: unknown): value is Record<string, unknown> =>\n\tBoolean(value) && typeof value === 'object';\n\nconst isAsyncLocalStorage = (value: unknown): value is AsyncLocalStorageType =>\n\tisObjectRecord(value) &&\n\t'getStore' in value &&\n\ttypeof value.getStore === 'function' &&\n\t'run' in value &&\n\ttypeof value.run === 'function';\n\nconst getStorageGlobal = () => {\n\tconst value = Reflect.get(globalThis, STREAMING_SLOT_STORAGE_KEY);\n\tif (value === null || typeof value === 'undefined') {\n\t\treturn value;\n\t}\n\n\treturn isAsyncLocalStorage(value) ? value : undefined;\n};\n\nconst isServerRuntime = () =>\n\ttypeof process !== 'undefined' &&\n\ttypeof process.versions?.node === 'string';\n\nconst ensureAsyncLocalStorage = async () => {\n\tconst storage = getStorageGlobal();\n\tif (typeof storage !== 'undefined') {\n\t\treturn storage;\n\t}\n\tif (!isServerRuntime()) {\n\t\tReflect.set(globalThis, STREAMING_SLOT_STORAGE_KEY, null);\n\n\t\treturn getStorageGlobal();\n\t}\n\n\tconst mod = await import('node:async_hooks');\n\tReflect.set(\n\t\tglobalThis,\n\t\tSTREAMING_SLOT_STORAGE_KEY,\n\t\tnew mod.AsyncLocalStorage<SlotStore>()\n\t);\n\n\treturn getStorageGlobal();\n};\n\nconst getActiveSlotStore = () => {\n\tconst storage = getStorageGlobal();\n\tif (!storage) return undefined;\n\n\treturn storage.getStore();\n};\n\nconst registerStreamingSlot = (slot: StreamingSlot) => {\n\tconst store = getActiveSlotStore();\n\tif (!store) return;\n\tstore.set(slot.id, slot);\n};\n\nsetStreamingSlotRegistrar(registerStreamingSlot);\nsetStreamingSlotCollectionController({\n\tisCollecting: () => getActiveSlotStore() !== undefined\n});\n\nexport const hasActiveStreamingSlotRegistry = () =>\n\tgetActiveSlotStore() !== undefined;\n\nexport const runWithStreamingSlotRegistry = async <T>(\n\ttask: () => Promise<T> | T\n) => {\n\tconst storage = await ensureAsyncLocalStorage();\n\tif (!storage) {\n\t\tconst slots: StreamingSlot[] = [];\n\n\t\treturn {\n\t\t\tresult: await task(),\n\t\t\tslots\n\t\t};\n\t}\n\n\treturn storage.run(new Map<string, StreamingSlot>(), async () => {\n\t\tconst result = await task();\n\t\tconst store = storage.getStore();\n\n\t\treturn {\n\t\t\tresult,\n\t\t\tslots: store ? [...store.values()] : []\n\t\t};\n\t});\n};\n"
+  ],
+  "mappings": "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",
+  "debugId": "B49ED06B058CECE964756E2164756E21",
+  "names": []
+}

package/dist/dev/client/constants.ts

@@ -0,0 +1,26 @@
+import type {} from '../../types/globals';
+/* Client-side constants — local copy for dist/dev/client/ portability.
+   These values MUST stay in sync with the root constants.ts.
+   This file exists because the client files are copied raw to dist/dev/client/
+   and cannot import from ../../constants when installed from npm. */
+
+export const ANGULAR_INIT_TIMEOUT_MS = 500;
+export const CSS_ERROR_RESOLVE_DELAY_MS = 50;
+export const CSS_MAX_CHECK_ATTEMPTS = 10;
+export const CSS_MAX_PARSE_TIMEOUT_MS = 500;
+export const CSS_SHEET_READY_TIMEOUT_MS = 100;
+export const DOM_UPDATE_DELAY_MS = 50;
+export const FOCUS_ID_PREFIX_LENGTH = 3;
+export const FOCUS_IDX_PREFIX_LENGTH = 4;
+export const FOCUS_NAME_PREFIX_LENGTH = 5;
+export const HMR_UPDATE_TIMEOUT_MS = 2000;
+export const MAX_RECONNECT_ATTEMPTS = 60;
+export const OVERLAY_FADE_DURATION_MS = 150;
+export const PING_INTERVAL_MS = 30_000;
+export const RAF_BATCH_COUNT = 3;
+export const REBUILD_RELOAD_DELAY_MS = 200;
+export const RECONNECT_INITIAL_DELAY_MS = 500;
+export const RECONNECT_POLL_INTERVAL_MS = 300;
+export const SVELTE_CSS_LOAD_TIMEOUT_MS = 500;
+export const UNFOUND_INDEX = -1;
+export const WEBSOCKET_NORMAL_CLOSURE = 1000;

package/dist/dev/client/cssUtils.ts

@@ -0,0 +1,311 @@
+import type {} from '../../types/globals';
+/* CSS reload/preload utilities for HMR */
+
+import type { CSSUpdateResult } from '../../types/client';
+import {
+	CSS_ERROR_RESOLVE_DELAY_MS,
+	CSS_MAX_CHECK_ATTEMPTS,
+	CSS_MAX_PARSE_TIMEOUT_MS,
+	CSS_SHEET_READY_TIMEOUT_MS,
+	DOM_UPDATE_DELAY_MS,
+	RAF_BATCH_COUNT
+} from './constants';
+import { hmrState } from './hmrState';
+
+export const getCSSBaseName = (href: string) => {
+	const fileName = href.split('?')[0]?.split('/').pop() || '';
+
+	return fileName.split('.')[0] ?? '';
+};
+
+const baseNamesMatch = (baseA: string, baseB: string) =>
+	baseA === baseB || baseA.includes(baseB) || baseB.includes(baseA);
+
+const findMatchingLink = (baseNew: string) => {
+	const links = document.head.querySelectorAll('link[rel="stylesheet"]');
+	for (const existing of links) {
+		if (!(existing instanceof HTMLLinkElement)) continue;
+		const existingHref = existing.getAttribute('href') || '';
+		const baseExisting = getCSSBaseName(existingHref);
+		if (baseNamesMatch(baseExisting, baseNew)) {
+			return existing;
+		}
+	}
+
+	return null;
+};
+
+const createTimestampedLink = (href: string) => {
+	const newLinkElement = document.createElement('link');
+	newLinkElement.rel = 'stylesheet';
+	newLinkElement.media = 'print';
+	const newHref = `${href + (href.includes('?') ? '&' : '?')}t=${Date.now()}`;
+	newLinkElement.href = newHref;
+
+	return { newHref, newLinkElement };
+};
+
+const processNewLink = (
+	newLink: Element,
+	linksToRemove: HTMLLinkElement[],
+	linksToActivate: HTMLLinkElement[],
+	linksToWaitFor: Promise<void>[]
+) => {
+	const href = newLink.getAttribute('href');
+	if (!href) return;
+
+	const baseNew = getCSSBaseName(href);
+	const existingLink = findMatchingLink(baseNew);
+
+	if (!existingLink) {
+		const { newHref, newLinkElement } = createTimestampedLink(href);
+		linksToActivate.push(newLinkElement);
+		const loadPromise = createCSSLoadPromise(newLinkElement, newHref);
+		document.head.appendChild(newLinkElement);
+		linksToWaitFor.push(loadPromise);
+
+		return;
+	}
+
+	const existingHrefAttr = existingLink.getAttribute('href');
+	const existingHref = existingHrefAttr ? existingHrefAttr.split('?')[0] : '';
+	const [newHrefBase] = href.split('?');
+	if (existingHref === newHrefBase) return;
+
+	const { newHref, newLinkElement } = createTimestampedLink(href);
+	linksToRemove.push(existingLink);
+	linksToActivate.push(newLinkElement);
+	const loadPromise = createCSSLoadPromise(newLinkElement, newHref);
+	document.head.appendChild(newLinkElement);
+	linksToWaitFor.push(loadPromise);
+};
+
+export const processCSSLinks = (headHTML: string) => {
+	const tempDiv = document.createElement('div');
+	tempDiv.innerHTML = headHTML;
+	const newStylesheets = tempDiv.querySelectorAll('link[rel="stylesheet"]');
+	const existingStylesheets = Array.from(
+		document.head.querySelectorAll<HTMLLinkElement>(
+			'link[rel="stylesheet"]'
+		)
+	);
+
+	const newHrefs = Array.from(newStylesheets).map((link) => {
+		const href = link.getAttribute('href') || '';
+
+		return getCSSBaseName(href);
+	});
+
+	const linksToRemove: HTMLLinkElement[] = [];
+	const linksToWaitFor: Promise<void>[] = [];
+	const linksToActivate: HTMLLinkElement[] = [];
+
+	newStylesheets.forEach((newLink) => {
+		processNewLink(newLink, linksToRemove, linksToActivate, linksToWaitFor);
+	});
+
+	existingStylesheets.forEach((existingLink) => {
+		const existingHref = existingLink.getAttribute('href') || '';
+		const baseExisting = getCSSBaseName(existingHref);
+		const stillExists = newHrefs.some((newBase) =>
+			baseNamesMatch(baseExisting, newBase)
+		);
+		if (stillExists) return;
+
+		const wasHandled = Array.from(newStylesheets).some((newLink) => {
+			const newHref = newLink.getAttribute('href') || '';
+			const baseNewLocal = getCSSBaseName(newHref);
+
+			return baseNamesMatch(baseExisting, baseNewLocal);
+		});
+
+		if (!wasHandled) {
+			linksToRemove.push(existingLink);
+		}
+	});
+
+	return { linksToActivate, linksToRemove, linksToWaitFor };
+};
+
+const findManifestHref = (
+	manifest: Record<string, string>,
+	baseName: string
+) => {
+	const manifestKey = `${baseName
+		.split('-')
+		.map((part) => part.charAt(0).toUpperCase() + part.slice(1))
+		.join('')}CSS`;
+
+	if (manifest[manifestKey]) {
+		return manifest[manifestKey];
+	}
+
+	for (const [key, value] of Object.entries(manifest)) {
+		if (key.endsWith('CSS') && value.includes(baseName)) {
+			return value;
+		}
+	}
+
+	return null;
+};
+
+const updateStylesheetLink = (
+	link: Element,
+	manifest: Record<string, string>
+) => {
+	if (!(link instanceof HTMLLinkElement)) return;
+	const href = link.getAttribute('href');
+	if (!href || href.includes('htmx.min.js')) return;
+
+	let newHref: string | null = null;
+	if (manifest) {
+		const baseName = getCSSBaseName(href);
+		newHref = findManifestHref(manifest, baseName);
+	}
+
+	if (newHref && newHref !== href) {
+		link.href = `${newHref}?t=${Date.now()}`;
+	} else {
+		const url = new URL(href, window.location.origin);
+		url.searchParams.set('t', Date.now().toString());
+		link.href = url.toString();
+	}
+};
+
+export const reloadCSSStylesheets = (manifest: Record<string, string>) => {
+	const stylesheets = document.querySelectorAll('link[rel="stylesheet"]');
+	stylesheets.forEach((link) => {
+		updateStylesheetLink(link, manifest);
+	});
+};
+
+const createCSSLoadPromise = (
+	linkElement: HTMLLinkElement,
+	newHref: string
+) => {
+	const { promise, resolve } = Promise.withResolvers<void>();
+	let resolved = false;
+	const doResolve = function () {
+		if (resolved) return;
+		resolved = true;
+		resolve();
+	};
+
+	const verifyCSSOM = function () {
+		try {
+			const sheets = Array.from(document.styleSheets);
+
+			return sheets.some(
+				(sheet) =>
+					sheet.href &&
+					sheet.href.includes(newHref.split('?')[0] ?? '')
+			);
+		} catch {
+			return false;
+		}
+	};
+
+	linkElement.onload = function () {
+		let checkCount = 0;
+		const checkCSSOM = function () {
+			checkCount++;
+			if (verifyCSSOM() || checkCount > CSS_MAX_CHECK_ATTEMPTS) {
+				doResolve();
+			} else {
+				requestAnimationFrame(checkCSSOM);
+			}
+		};
+		requestAnimationFrame(checkCSSOM);
+	};
+
+	linkElement.onerror = function () {
+		setTimeout(() => {
+			doResolve();
+		}, CSS_ERROR_RESOLVE_DELAY_MS);
+	};
+
+	setTimeout(() => {
+		if (linkElement.sheet && !resolved) {
+			doResolve();
+		}
+	}, CSS_SHEET_READY_TIMEOUT_MS);
+
+	setTimeout(() => {
+		if (!resolved) {
+			doResolve();
+		}
+	}, CSS_MAX_PARSE_TIMEOUT_MS);
+
+	return promise;
+};
+
+const removeLinks = (linksToRemove: HTMLLinkElement[]) => {
+	linksToRemove.forEach((link) => {
+		if (link.parentNode) {
+			link.remove();
+		}
+	});
+};
+
+const activateLinks = (linksToActivate: HTMLLinkElement[]) => {
+	linksToActivate.forEach((link) => {
+		link.media = 'all';
+	});
+};
+
+const chainRAF = (depth: number, callback: () => void) => {
+	if (depth <= 0) {
+		callback();
+
+		return;
+	}
+	requestAnimationFrame(() => {
+		chainRAF(depth - 1, callback);
+	});
+};
+
+/* Coordinate CSS load with body update: waits for CSS, patches body,
+   activates new CSS, removes old CSS. Handles first-update delay. */
+export const waitForCSSAndUpdate = (
+	cssResult: CSSUpdateResult,
+	updateBody: () => void
+) => {
+	const { linksToActivate, linksToRemove, linksToWaitFor } = cssResult;
+
+	if (linksToWaitFor.length > 0) {
+		void Promise.all(linksToWaitFor).then(() => {
+			setTimeout(() => {
+				chainRAF(RAF_BATCH_COUNT, () => {
+					updateBody();
+					activateLinks(linksToActivate);
+					requestAnimationFrame(() => {
+						removeLinks(linksToRemove);
+						if (hmrState.isFirstHMRUpdate) {
+							hmrState.isFirstHMRUpdate = false;
+						}
+					});
+				});
+			}, DOM_UPDATE_DELAY_MS);
+
+			return undefined;
+		});
+
+		return;
+	}
+
+	const doUpdate = function () {
+		chainRAF(RAF_BATCH_COUNT, () => {
+			updateBody();
+			requestAnimationFrame(() => {
+				removeLinks(linksToRemove);
+			});
+		});
+	};
+
+	if (hmrState.isFirstHMRUpdate) {
+		hmrState.isFirstHMRUpdate = false;
+		setTimeout(doUpdate, DOM_UPDATE_DELAY_MS);
+	} else {
+		doUpdate();
+	}
+};