@ox-content/islands 3.1.2 → 3.1.4

package/dist/html-host2.mjs

@@ -0,0 +1,226 @@
+//#region src/html-host-errors.ts
+var HtmlHostClientHydrationError = class extends Error {
+	diagnostic;
+	constructor(diagnostic) {
+		super(diagnostic.message);
+		this.name = "HtmlHostClientHydrationError";
+		this.diagnostic = diagnostic;
+	}
+};
+function reportHtmlHostClientError(input, error, eventName = "ox-content-html-host:error") {
+	error.element.classList?.add("ox-island-error");
+	error.element.dataset.oxError = error.message;
+	input.onError?.(error);
+	if (typeof CustomEvent === "function" && typeof error.element.dispatchEvent === "function") error.element.dispatchEvent(new CustomEvent(eventName, { detail: error }));
+}
+function createHtmlHostClientError(code, element, props, context = {}) {
+	return {
+		code,
+		element,
+		props,
+		componentName: context.componentName,
+		moduleId: context.moduleId,
+		exportName: context.exportName,
+		cause: context.cause,
+		message: clientErrorMessage(code, context)
+	};
+}
+function once(cleanup) {
+	let called = false;
+	return () => {
+		if (called) return;
+		called = true;
+		cleanup();
+	};
+}
+function clientErrorMessage(code, context) {
+	const framework = context.frameworkName?.trim() || "HTML host";
+	const island = `${framework} island`;
+	const component = context.componentName ? `${island} "${context.componentName}"` : island;
+	const reason = causeMessage(context.cause);
+	switch (code) {
+		case "missing-island-name": return `${island} element is missing data-ox-island.`;
+		case "missing-module-id": return `${component} is missing data-ox-module.`;
+		case "unknown-module": return `${component} references unknown module "${context.moduleId ?? ""}".`;
+		case "module-load-failed": return `${component} module "${context.moduleId ?? ""}" failed to load: ${reason}`;
+		case "runtime-load-failed": return `${framework} runtime failed to load: ${reason}`;
+		case "missing-export": return `${component} module "${context.moduleId ?? ""}" is missing export "${context.exportName ?? "default"}".`;
+		case "render-failed": return `${component} failed to render: ${reason}`;
+	}
+}
+function causeMessage(cause) {
+	if (cause == null) return "";
+	if (cause instanceof Error) return cause.message;
+	if (typeof cause === "string") return cause;
+	if (typeof cause === "number" || typeof cause === "boolean") return cause.toString();
+	try {
+		return JSON.stringify(cause);
+	} catch {
+		return Object.prototype.toString.call(cause);
+	}
+}
+//#endregion
+//#region src/html-host.ts
+const ISLAND_JSON_SCRIPT = /^\s*<script type="application\/json">[\s\S]*?<\/script>/;
+function initHtmlHost(input) {
+	return input.initIslands(createHtmlHostLazyHydrate(input), input.options);
+}
+function createHtmlHostLazyHydrate(input) {
+	const render = resolveRenderer(input);
+	const loadRuntime = input.loadRuntime ?? input.adapter?.loadRuntime;
+	const preserveElementContents = input.preserveElementContents ?? input.adapter?.preserveElementContents ?? false;
+	const frameworkName = input.frameworkName ?? input.adapter?.frameworkName ?? "HTML host";
+	const eventName = input.eventName ?? input.adapter?.eventName ?? "ox-content-html-host:error";
+	const moduleCache = /* @__PURE__ */ new Map();
+	let runtimeCache;
+	return (element, props) => {
+		let disposed = false;
+		let disposeMounted;
+		const dispose = (() => {
+			if (disposed) return;
+			disposed = true;
+			disposeMounted?.();
+			disposeMounted = void 0;
+		});
+		const ready = (async () => {
+			const componentName = element.dataset.oxIsland;
+			if (!componentName) fail(input, eventName, frameworkName, "missing-island-name", element, props);
+			const moduleId = input.resolveModuleId?.(element, {
+				componentName,
+				props
+			}) ?? element.dataset.oxModule;
+			if (!moduleId) fail(input, eventName, frameworkName, "missing-module-id", element, props, { componentName });
+			if (!moduleLoader(input.modules, moduleId)) fail(input, eventName, frameworkName, "unknown-module", element, props, {
+				componentName,
+				moduleId
+			});
+			const exportName = input.resolveExportName?.(element, {
+				componentName,
+				moduleId,
+				props
+			}) ?? element.dataset.oxExport ?? "default";
+			const slotHtml = readHtmlHostSlot(element);
+			let moduleExports;
+			let runtime;
+			try {
+				moduleExports = await loadClientModule(input.modules, moduleId, moduleCache);
+			} catch (cause) {
+				if (!disposed) fail(input, eventName, frameworkName, "module-load-failed", element, props, {
+					componentName,
+					moduleId,
+					exportName,
+					cause
+				});
+				return;
+			}
+			if (disposed) return;
+			try {
+				runtime = await loadHtmlHostRuntime(loadRuntime, () => runtimeCache, (pending) => {
+					runtimeCache = pending;
+				});
+			} catch (cause) {
+				if (!disposed) fail(input, eventName, frameworkName, "runtime-load-failed", element, props, {
+					componentName,
+					moduleId,
+					exportName,
+					cause
+				});
+				return;
+			}
+			if (disposed) return;
+			const component = exportedValue(moduleExports, exportName);
+			if (component == null) fail(input, eventName, frameworkName, "missing-export", element, props, {
+				componentName,
+				moduleId,
+				exportName,
+				cause: /* @__PURE__ */ new Error(`Export "${exportName}" was not found.`)
+			});
+			if (!preserveElementContents) element.innerHTML = "";
+			try {
+				const cleanup = await render({
+					component,
+					componentName,
+					element,
+					exportName,
+					moduleExports,
+					moduleId,
+					props,
+					runtime,
+					slotHtml
+				});
+				disposeMounted = cleanup ? once(cleanup) : void 0;
+				if (disposed) {
+					disposeMounted?.();
+					disposeMounted = void 0;
+				}
+			} catch (cause) {
+				if (!disposed) fail(input, eventName, frameworkName, "render-failed", element, props, {
+					componentName,
+					moduleId,
+					exportName,
+					cause
+				});
+			}
+		})();
+		ready.catch(() => void 0);
+		Object.defineProperty(dispose, "then", { value: ready.then.bind(ready) });
+		return dispose;
+	};
+}
+function readHtmlHostSlot(element) {
+	const fromAttr = element.dataset.oxContent;
+	if (fromAttr) return fromAttr;
+	if (element.dataset.oxSsr === "true") return void 0;
+	return element.innerHTML.replace(ISLAND_JSON_SCRIPT, "") || void 0;
+}
+async function loadClientModule(modules, moduleId, cache) {
+	const cached = cache.get(moduleId);
+	if (cached) return cached;
+	const loader = moduleLoader(modules, moduleId);
+	if (!loader) throw new Error(`Unknown module "${moduleId}".`);
+	const pending = Promise.resolve().then(loader).catch((cause) => {
+		cache.delete(moduleId);
+		throw cause;
+	});
+	cache.set(moduleId, pending);
+	return pending;
+}
+async function loadHtmlHostRuntime(load, getCached, setCached) {
+	if (!load) return void 0;
+	const cached = getCached();
+	if (cached) return cached;
+	const pending = Promise.resolve().then(load).catch((cause) => {
+		setCached(void 0);
+		throw cause;
+	});
+	setCached(pending);
+	return pending;
+}
+function fail(input, eventName, frameworkName, code, element, props, context = {}) {
+	const error = createHtmlHostClientError(code, element, props, {
+		...context,
+		frameworkName
+	});
+	reportHtmlHostClientError(input, error, eventName);
+	throw new HtmlHostClientHydrationError(error);
+}
+function resolveRenderer(input) {
+	const render = input.render ?? input.adapter?.render;
+	if (render) return render;
+	throw new Error("initHtmlHost requires either render or adapter.render.");
+}
+function moduleLoader(modules, moduleId) {
+	return isReadonlyMap(modules) ? modules.get(moduleId) : modules[moduleId];
+}
+function isReadonlyMap(value) {
+	return typeof value.get === "function";
+}
+function exportedValue(moduleExports, exportName) {
+	if (exportName === "default" && typeof moduleExports === "function") return moduleExports;
+	if (!moduleExports || typeof moduleExports !== "object") return;
+	return moduleExports[exportName];
+}
+//#endregion
+export { createHtmlHostClientError as a, HtmlHostClientHydrationError as i, initHtmlHost as n, reportHtmlHostClientError as o, readHtmlHostSlot as r, createHtmlHostLazyHydrate as t };
+
+//# sourceMappingURL=html-host2.mjs.map

package/dist/html-host2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-host2.mjs","names":[],"sources":["../src/html-host-errors.ts","../src/html-host.ts"],"sourcesContent":["export type HtmlHostClientDiagnosticCode =\n  | \"missing-island-name\"\n  | \"missing-module-id\"\n  | \"unknown-module\"\n  | \"module-load-failed\"\n  | \"runtime-load-failed\"\n  | \"missing-export\"\n  | \"render-failed\";\n\nexport interface HtmlHostClientError {\n  code: HtmlHostClientDiagnosticCode;\n  message: string;\n  element: HTMLElement;\n  props: Record<string, unknown>;\n  componentName?: string;\n  moduleId?: string;\n  exportName?: string;\n  cause?: unknown;\n}\n\nexport class HtmlHostClientHydrationError extends Error {\n  readonly diagnostic: HtmlHostClientError;\n\n  constructor(diagnostic: HtmlHostClientError) {\n    super(diagnostic.message);\n    this.name = \"HtmlHostClientHydrationError\";\n    this.diagnostic = diagnostic;\n  }\n}\n\ninterface HtmlHostClientErrorContext {\n  componentName?: string;\n  moduleId?: string;\n  exportName?: string;\n  cause?: unknown;\n  frameworkName?: string;\n}\n\nexport function reportHtmlHostClientError(\n  input: { onError?: (error: HtmlHostClientError) => void },\n  error: HtmlHostClientError,\n  eventName = \"ox-content-html-host:error\",\n): void {\n  error.element.classList?.add(\"ox-island-error\");\n  error.element.dataset.oxError = error.message;\n  input.onError?.(error);\n\n  if (typeof CustomEvent === \"function\" && typeof error.element.dispatchEvent === \"function\") {\n    error.element.dispatchEvent(new CustomEvent(eventName, { detail: error }));\n  }\n}\n\nexport function createHtmlHostClientError(\n  code: HtmlHostClientDiagnosticCode,\n  element: HTMLElement,\n  props: Record<string, unknown>,\n  context: HtmlHostClientErrorContext = {},\n): HtmlHostClientError {\n  return {\n    code,\n    element,\n    props,\n    componentName: context.componentName,\n    moduleId: context.moduleId,\n    exportName: context.exportName,\n    cause: context.cause,\n    message: clientErrorMessage(code, context),\n  };\n}\n\nexport function once(cleanup: () => void): () => void {\n  let called = false;\n  return () => {\n    if (called) return;\n    called = true;\n    cleanup();\n  };\n}\n\nfunction clientErrorMessage(\n  code: HtmlHostClientDiagnosticCode,\n  context: HtmlHostClientErrorContext,\n): string {\n  const framework = context.frameworkName?.trim() || \"HTML host\";\n  const island = `${framework} island`;\n  const component = context.componentName ? `${island} \"${context.componentName}\"` : island;\n  const reason = causeMessage(context.cause);\n  switch (code) {\n    case \"missing-island-name\":\n      return `${island} element is missing data-ox-island.`;\n    case \"missing-module-id\":\n      return `${component} is missing data-ox-module.`;\n    case \"unknown-module\":\n      return `${component} references unknown module \"${context.moduleId ?? \"\"}\".`;\n    case \"module-load-failed\":\n      return `${component} module \"${context.moduleId ?? \"\"}\" failed to load: ${reason}`;\n    case \"runtime-load-failed\":\n      return `${framework} runtime failed to load: ${reason}`;\n    case \"missing-export\":\n      return `${component} module \"${context.moduleId ?? \"\"}\" is missing export \"${context.exportName ?? \"default\"}\".`;\n    case \"render-failed\":\n      return `${component} failed to render: ${reason}`;\n  }\n}\n\nfunction causeMessage(cause: unknown): string {\n  if (cause == null) return \"\";\n  if (cause instanceof Error) return cause.message;\n  if (typeof cause === \"string\") return cause;\n  if (typeof cause === \"number\" || typeof cause === \"boolean\") return cause.toString();\n  try {\n    return JSON.stringify(cause);\n  } catch {\n    return Object.prototype.toString.call(cause);\n  }\n}\n","import type { HydrateFunction, InitIslandsOptions } from \"./types\";\nimport {\n  HtmlHostClientHydrationError,\n  createHtmlHostClientError,\n  once,\n  reportHtmlHostClientError,\n  type HtmlHostClientDiagnosticCode,\n  type HtmlHostClientError,\n} from \"./html-host-errors\";\n\nconst ISLAND_JSON_SCRIPT = /^\\s*<script type=\"application\\/json\">[\\s\\S]*?<\\/script>/;\n\nexport { HtmlHostClientHydrationError, createHtmlHostClientError, reportHtmlHostClientError };\nexport type { HtmlHostClientDiagnosticCode, HtmlHostClientError };\n\nexport type HtmlHostClientComponentValue = unknown;\nexport type HtmlHostClientModuleValue = unknown;\n\nexport type HtmlHostClientModuleLoader<TModule = HtmlHostClientModuleValue> = () =>\n  | TModule\n  | PromiseLike<TModule>;\n\nexport type HtmlHostClientModules<TModule = HtmlHostClientModuleValue> =\n  | Readonly<Record<string, HtmlHostClientModuleLoader<TModule>>>\n  | ReadonlyMap<string, HtmlHostClientModuleLoader<TModule>>;\n\nexport interface HtmlHostClientContext<TRuntime = undefined> {\n  component: unknown;\n  componentName: string;\n  element: HTMLElement;\n  exportName: string;\n  moduleExports: unknown;\n  moduleId: string;\n  props: Record<string, unknown>;\n  runtime: TRuntime | undefined;\n  slotHtml: string | undefined;\n}\n\nexport type HtmlHostClientRenderer<TRuntime = undefined> = (\n  context: HtmlHostClientContext<TRuntime>,\n) => void | (() => void) | PromiseLike<void | (() => void)>;\n\nexport type HtmlHostClientRuntimeLoader<TRuntime = undefined> = () =>\n  | TRuntime\n  | PromiseLike<TRuntime>;\n\nexport type HtmlHostModuleIdResolver = (\n  element: HTMLElement,\n  context: { componentName: string; props: Record<string, unknown> },\n) => string | undefined;\n\nexport type HtmlHostExportNameResolver = (\n  element: HTMLElement,\n  context: { componentName: string; moduleId: string; props: Record<string, unknown> },\n) => string | undefined;\n\nexport interface HtmlHostClientAdapter<TRuntime = undefined> {\n  frameworkName?: string;\n  eventName?: string;\n  render: HtmlHostClientRenderer<TRuntime>;\n  loadRuntime?: HtmlHostClientRuntimeLoader<TRuntime>;\n  preserveElementContents?: boolean;\n}\n\nexport interface CreateHtmlHostLazyHydrateInput<TRuntime = undefined> {\n  modules: HtmlHostClientModules;\n  adapter?: HtmlHostClientAdapter<TRuntime>;\n  render?: HtmlHostClientRenderer<TRuntime>;\n  loadRuntime?: HtmlHostClientRuntimeLoader<TRuntime>;\n  preserveElementContents?: boolean;\n  resolveModuleId?: HtmlHostModuleIdResolver;\n  resolveExportName?: HtmlHostExportNameResolver;\n  onError?: (error: HtmlHostClientError) => void;\n  frameworkName?: string;\n  eventName?: string;\n}\n\nexport type HtmlHostHydrationHandle = (() => void) & PromiseLike<void>;\n\nexport type HtmlHostLazyHydrateFunction = (\n  element: HTMLElement,\n  props: Record<string, unknown>,\n) => HtmlHostHydrationHandle;\n\nexport type HtmlHostInitIslands<TController = unknown> = (\n  hydrate: HydrateFunction,\n  options?: InitIslandsOptions,\n) => TController;\n\nexport type InitHtmlHostInput<TRuntime = undefined> = CreateHtmlHostLazyHydrateInput<TRuntime> & {\n  initIslands: HtmlHostInitIslands;\n  options?: InitIslandsOptions;\n};\n\nexport function initHtmlHost<TRuntime = undefined>(\n  input: InitHtmlHostInput<TRuntime>,\n): ReturnType<InitHtmlHostInput<TRuntime>[\"initIslands\"]> {\n  return input.initIslands(createHtmlHostLazyHydrate(input), input.options);\n}\n\nexport function createHtmlHostLazyHydrate<TRuntime = undefined>(\n  input: CreateHtmlHostLazyHydrateInput<TRuntime>,\n): HtmlHostLazyHydrateFunction {\n  const render = resolveRenderer(input);\n  const loadRuntime = input.loadRuntime ?? input.adapter?.loadRuntime;\n  const preserveElementContents =\n    input.preserveElementContents ?? input.adapter?.preserveElementContents ?? false;\n  const frameworkName = input.frameworkName ?? input.adapter?.frameworkName ?? \"HTML host\";\n  const eventName = input.eventName ?? input.adapter?.eventName ?? \"ox-content-html-host:error\";\n  const moduleCache = new Map<string, Promise<unknown>>();\n  let runtimeCache: Promise<TRuntime> | undefined;\n\n  return (element, props) => {\n    let disposed = false;\n    let disposeMounted: (() => void) | undefined;\n\n    const dispose = (() => {\n      if (disposed) return;\n      disposed = true;\n      disposeMounted?.();\n      disposeMounted = undefined;\n    }) as HtmlHostHydrationHandle;\n\n    const ready = (async () => {\n      const componentName = element.dataset.oxIsland;\n      if (!componentName) {\n        fail(input, eventName, frameworkName, \"missing-island-name\", element, props);\n      }\n\n      const moduleId =\n        input.resolveModuleId?.(element, { componentName, props }) ?? element.dataset.oxModule;\n      if (!moduleId) {\n        fail(input, eventName, frameworkName, \"missing-module-id\", element, props, {\n          componentName,\n        });\n      }\n      if (!moduleLoader(input.modules, moduleId)) {\n        fail(input, eventName, frameworkName, \"unknown-module\", element, props, {\n          componentName,\n          moduleId,\n        });\n      }\n\n      const exportName =\n        input.resolveExportName?.(element, { componentName, moduleId, props }) ??\n        element.dataset.oxExport ??\n        \"default\";\n      const slotHtml = readHtmlHostSlot(element);\n\n      let moduleExports: unknown;\n      let runtime: TRuntime | undefined;\n      try {\n        moduleExports = await loadClientModule(input.modules, moduleId, moduleCache);\n      } catch (cause) {\n        if (!disposed) {\n          fail(input, eventName, frameworkName, \"module-load-failed\", element, props, {\n            componentName,\n            moduleId,\n            exportName,\n            cause,\n          });\n        }\n        return;\n      }\n\n      if (disposed) return;\n\n      try {\n        runtime = await loadHtmlHostRuntime(\n          loadRuntime,\n          () => runtimeCache,\n          (pending) => {\n            runtimeCache = pending;\n          },\n        );\n      } catch (cause) {\n        if (!disposed) {\n          fail(input, eventName, frameworkName, \"runtime-load-failed\", element, props, {\n            componentName,\n            moduleId,\n            exportName,\n            cause,\n          });\n        }\n        return;\n      }\n\n      if (disposed) return;\n\n      const component = exportedValue(moduleExports, exportName);\n      if (component == null) {\n        fail(input, eventName, frameworkName, \"missing-export\", element, props, {\n          componentName,\n          moduleId,\n          exportName,\n          cause: new Error(`Export \"${exportName}\" was not found.`),\n        });\n      }\n\n      if (!preserveElementContents) {\n        element.innerHTML = \"\";\n      }\n      try {\n        const cleanup = await render({\n          component,\n          componentName,\n          element,\n          exportName,\n          moduleExports,\n          moduleId,\n          props,\n          runtime,\n          slotHtml,\n        });\n        disposeMounted = cleanup ? once(cleanup) : undefined;\n        if (disposed) {\n          disposeMounted?.();\n          disposeMounted = undefined;\n        }\n      } catch (cause) {\n        if (!disposed) {\n          fail(input, eventName, frameworkName, \"render-failed\", element, props, {\n            componentName,\n            moduleId,\n            exportName,\n            cause,\n          });\n        }\n      }\n    })();\n\n    ready.catch(() => undefined);\n    // Promise-like handles let initIslands keep the loading state until async\n    // module/runtime/render work has completed.\n    // oxlint-disable-next-line unicorn/no-thenable\n    Object.defineProperty(dispose, \"then\", { value: ready.then.bind(ready) });\n    return dispose;\n  };\n}\n\nexport function readHtmlHostSlot(\n  element: Pick<HTMLElement, \"dataset\" | \"innerHTML\">,\n): string | undefined {\n  const fromAttr = element.dataset.oxContent;\n  if (fromAttr) return fromAttr;\n  if (element.dataset.oxSsr === \"true\") return undefined;\n\n  const slotHtml = element.innerHTML.replace(ISLAND_JSON_SCRIPT, \"\");\n  return slotHtml || undefined;\n}\n\nasync function loadClientModule(\n  modules: HtmlHostClientModules,\n  moduleId: string,\n  cache: Map<string, Promise<unknown>>,\n): Promise<unknown> {\n  const cached = cache.get(moduleId);\n  if (cached) return cached;\n\n  const loader = moduleLoader(modules, moduleId);\n  if (!loader) {\n    throw new Error(`Unknown module \"${moduleId}\".`);\n  }\n\n  const pending = Promise.resolve()\n    .then(loader)\n    .catch((cause: unknown) => {\n      cache.delete(moduleId);\n      throw cause;\n    });\n  cache.set(moduleId, pending);\n  return pending;\n}\n\nasync function loadHtmlHostRuntime<TRuntime>(\n  load: HtmlHostClientRuntimeLoader<TRuntime> | undefined,\n  getCached: () => Promise<TRuntime> | undefined,\n  setCached: (pending: Promise<TRuntime> | undefined) => void,\n): Promise<TRuntime | undefined> {\n  if (!load) return undefined;\n\n  const cached = getCached();\n  if (cached) return cached;\n\n  const pending = Promise.resolve()\n    .then(load)\n    .catch((cause: unknown) => {\n      setCached(undefined);\n      throw cause;\n    });\n  setCached(pending);\n  return pending;\n}\n\nfunction fail(\n  input: Pick<CreateHtmlHostLazyHydrateInput, \"onError\">,\n  eventName: string,\n  frameworkName: string,\n  code: HtmlHostClientDiagnosticCode,\n  element: HTMLElement,\n  props: Record<string, unknown>,\n  context: {\n    componentName?: string;\n    moduleId?: string;\n    exportName?: string;\n    cause?: unknown;\n  } = {},\n): never {\n  const error = createHtmlHostClientError(code, element, props, {\n    ...context,\n    frameworkName,\n  });\n  reportHtmlHostClientError(input, error, eventName);\n  throw new HtmlHostClientHydrationError(error);\n}\n\nfunction resolveRenderer<TRuntime>(\n  input: CreateHtmlHostLazyHydrateInput<TRuntime>,\n): HtmlHostClientRenderer<TRuntime> {\n  const render = input.render ?? input.adapter?.render;\n  if (render) return render;\n  throw new Error(\"initHtmlHost requires either render or adapter.render.\");\n}\n\nfunction moduleLoader(\n  modules: HtmlHostClientModules,\n  moduleId: string,\n): HtmlHostClientModuleLoader | undefined {\n  return isReadonlyMap(modules) ? modules.get(moduleId) : modules[moduleId];\n}\n\nfunction isReadonlyMap(\n  value: HtmlHostClientModules,\n): value is ReadonlyMap<string, HtmlHostClientModuleLoader> {\n  return typeof (value as ReadonlyMap<string, HtmlHostClientModuleLoader>).get === \"function\";\n}\n\nfunction exportedValue(moduleExports: unknown, exportName: string): unknown {\n  if (exportName === \"default\" && typeof moduleExports === \"function\") {\n    return moduleExports;\n  }\n  if (!moduleExports || typeof moduleExports !== \"object\") {\n    return undefined;\n  }\n  return (moduleExports as Record<string, unknown>)[exportName];\n}\n"],"mappings":"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"}

package/dist/index.cjs

@@ -0,0 +1,15 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./runtime2.cjs");
+const require_html_host = require("./html-host2.cjs");
+exports.HtmlHostClientHydrationError = require_html_host.HtmlHostClientHydrationError;
+exports.createDeferredInit = require_runtime.createDeferredInit;
+exports.createHtmlHostClientError = require_html_host.createHtmlHostClientError;
+exports.createHtmlHostLazyHydrate = require_html_host.createHtmlHostLazyHydrate;
+exports.initHtmlHost = require_html_host.initHtmlHost;
+exports.initIslands = require_runtime.initIslands;
+exports.isIslandsSupported = require_runtime.isIslandsSupported;
+exports.readHtmlHostSlot = require_html_host.readHtmlHostSlot;
+exports.readIslandSlotHtml = require_runtime.readIslandSlotHtml;
+exports.reportHtmlHostClientError = require_html_host.reportHtmlHostClientError;
+exports.stripIslandPayloadScript = require_runtime.stripIslandPayloadScript;
+exports.unwrapIslandProps = require_runtime.unwrapIslandProps;

package/dist/index.d.cts

@@ -0,0 +1,19 @@
+import { a as IslandController, i as IslandConfig, n as HydrateFunction, o as IslandInstance, r as InitIslandsOptions, s as LoadStrategy, t as ComponentRegistry } from "./types.cjs";
+import { C as reportHtmlHostClientError, S as createHtmlHostClientError, _ as initHtmlHost, a as HtmlHostClientModuleLoader, b as HtmlHostClientError, c as HtmlHostClientRenderer, d as HtmlHostHydrationHandle, f as HtmlHostInitIslands, g as createHtmlHostLazyHydrate, h as InitHtmlHostInput, i as HtmlHostClientContext, l as HtmlHostClientRuntimeLoader, m as HtmlHostModuleIdResolver, n as HtmlHostClientAdapter, o as HtmlHostClientModuleValue, p as HtmlHostLazyHydrateFunction, r as HtmlHostClientComponentValue, s as HtmlHostClientModules, t as CreateHtmlHostLazyHydrateInput, u as HtmlHostExportNameResolver, v as readHtmlHostSlot, x as HtmlHostClientHydrationError, y as HtmlHostClientDiagnosticCode } from "./html-host.cjs";
+import { createDeferredInit, initIslands, isIslandsSupported } from "./runtime.cjs";
+//#region src/payload.d.ts
+/**
+ * Flatten the Rust MDX island payload (`{ props, expressions, spreads }`)
+ * into the literal props object hydrate functions expect. Legacy flat
+ * `data-ox-props` objects from the Markdown regex path are returned as-is.
+ */
+declare function unwrapIslandProps(parsed: unknown): Record<string, unknown>;
+/**
+ * Slot markup for an island: `data-ox-content` when the regex path set it,
+ * otherwise inner HTML with the Rust JSON payload script stripped.
+ */
+declare function stripIslandPayloadScript(innerHTML: string): string;
+declare function readIslandSlotHtml(element: Pick<HTMLElement, "dataset" | "innerHTML">): string;
+//#endregion
+export { type ComponentRegistry, type CreateHtmlHostLazyHydrateInput, type HtmlHostClientAdapter, type HtmlHostClientComponentValue, type HtmlHostClientContext, type HtmlHostClientDiagnosticCode, type HtmlHostClientError, HtmlHostClientHydrationError, type HtmlHostClientModuleLoader, type HtmlHostClientModuleValue, type HtmlHostClientModules, type HtmlHostClientRenderer, type HtmlHostClientRuntimeLoader, type HtmlHostExportNameResolver, type HtmlHostHydrationHandle, type HtmlHostInitIslands, type HtmlHostLazyHydrateFunction, type HtmlHostModuleIdResolver, type HydrateFunction, type InitHtmlHostInput, type InitIslandsOptions, type IslandConfig, type IslandController, type IslandInstance, type LoadStrategy, createDeferredInit, createHtmlHostClientError, createHtmlHostLazyHydrate, initHtmlHost, initIslands, isIslandsSupported, readHtmlHostSlot, readIslandSlotHtml, reportHtmlHostClientError, stripIslandPayloadScript, unwrapIslandProps };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.cts","names":[],"sources":["../src/payload.ts"],"mappings":";;;;;;;;;iBAQgB,kBAAkB,kBAAkB;;;;;iBAwBpC,yBAAyB;iBAIzB,mBAAmB,SAAS,KAAK"}

package/dist/index.d.mts

@@ -1,4 +1,6 @@
-import { a as HydrateFunction, c as IslandController, i as ComponentRegistry, l as IslandInstance, n as initIslands, o as InitIslandsOptions, r as isIslandsSupported, s as IslandConfig, t as createDeferredInit, u as LoadStrategy } from "./runtime.mjs";
+import { a as IslandController, i as IslandConfig, n as HydrateFunction, o as IslandInstance, r as InitIslandsOptions, s as LoadStrategy, t as ComponentRegistry } from "./types.mjs";
+import { C as reportHtmlHostClientError, S as createHtmlHostClientError, _ as initHtmlHost, a as HtmlHostClientModuleLoader, b as HtmlHostClientError, c as HtmlHostClientRenderer, d as HtmlHostHydrationHandle, f as HtmlHostInitIslands, g as createHtmlHostLazyHydrate, h as InitHtmlHostInput, i as HtmlHostClientContext, l as HtmlHostClientRuntimeLoader, m as HtmlHostModuleIdResolver, n as HtmlHostClientAdapter, o as HtmlHostClientModuleValue, p as HtmlHostLazyHydrateFunction, r as HtmlHostClientComponentValue, s as HtmlHostClientModules, t as CreateHtmlHostLazyHydrateInput, u as HtmlHostExportNameResolver, v as readHtmlHostSlot, x as HtmlHostClientHydrationError, y as HtmlHostClientDiagnosticCode } from "./html-host.mjs";
+import { createDeferredInit, initIslands, isIslandsSupported } from "./runtime.mjs";
 //#region src/payload.d.ts
 /**
  * Flatten the Rust MDX island payload (`{ props, expressions, spreads }`)
@@ -13,5 +15,5 @@ declare function unwrapIslandProps(parsed: unknown): Record<string, unknown>;
 declare function stripIslandPayloadScript(innerHTML: string): string;
 declare function readIslandSlotHtml(element: Pick<HTMLElement, "dataset" | "innerHTML">): string;
 //#endregion
-export { type ComponentRegistry, type HydrateFunction, type InitIslandsOptions, type IslandConfig, type IslandController, type IslandInstance, type LoadStrategy, createDeferredInit, initIslands, isIslandsSupported, readIslandSlotHtml, stripIslandPayloadScript, unwrapIslandProps };
+export { type ComponentRegistry, type CreateHtmlHostLazyHydrateInput, type HtmlHostClientAdapter, type HtmlHostClientComponentValue, type HtmlHostClientContext, type HtmlHostClientDiagnosticCode, type HtmlHostClientError, HtmlHostClientHydrationError, type HtmlHostClientModuleLoader, type HtmlHostClientModuleValue, type HtmlHostClientModules, type HtmlHostClientRenderer, type HtmlHostClientRuntimeLoader, type HtmlHostExportNameResolver, type HtmlHostHydrationHandle, type HtmlHostInitIslands, type HtmlHostLazyHydrateFunction, type HtmlHostModuleIdResolver, type HydrateFunction, type InitHtmlHostInput, type InitIslandsOptions, type IslandConfig, type IslandController, type IslandInstance, type LoadStrategy, createDeferredInit, createHtmlHostClientError, createHtmlHostLazyHydrate, initHtmlHost, initIslands, isIslandsSupported, readHtmlHostSlot, readIslandSlotHtml, reportHtmlHostClientError, stripIslandPayloadScript, unwrapIslandProps };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/payload.ts"],"mappings":";;;;;;;iBAQgB,kBAAkB,kBAAkB;;;;;iBAwBpC,yBAAyB;iBAIzB,mBAAmB,SAAS,KAAK"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/payload.ts"],"mappings":";;;;;;;;;iBAQgB,kBAAkB,kBAAkB;;;;;iBAwBpC,yBAAyB;iBAIzB,mBAAmB,SAAS,KAAK"}

package/dist/index.mjs

@@ -1,2 +1,3 @@
 import { a as stripIslandPayloadScript, i as readIslandSlotHtml, n as initIslands, o as unwrapIslandProps, r as isIslandsSupported, t as createDeferredInit } from "./runtime2.mjs";
-export { createDeferredInit, initIslands, isIslandsSupported, readIslandSlotHtml, stripIslandPayloadScript, unwrapIslandProps };
+import { a as createHtmlHostClientError, i as HtmlHostClientHydrationError, n as initHtmlHost, o as reportHtmlHostClientError, r as readHtmlHostSlot, t as createHtmlHostLazyHydrate } from "./html-host2.mjs";
+export { HtmlHostClientHydrationError, createDeferredInit, createHtmlHostClientError, createHtmlHostLazyHydrate, initHtmlHost, initIslands, isIslandsSupported, readHtmlHostSlot, readIslandSlotHtml, reportHtmlHostClientError, stripIslandPayloadScript, unwrapIslandProps };

package/dist/runtime.cjs

@@ -0,0 +1,5 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./runtime2.cjs");
+exports.createDeferredInit = require_runtime.createDeferredInit;
+exports.initIslands = require_runtime.initIslands;
+exports.isIslandsSupported = require_runtime.isIslandsSupported;

package/dist/runtime.d.cts

@@ -0,0 +1,95 @@
+import { a as IslandController, n as HydrateFunction, r as InitIslandsOptions } from "./types.cjs";
+//#region src/runtime.d.ts
+/**
+ * Initialize islands with a hydration function.
+ *
+ * This is the main entry point for the island system.
+ * Pass a hydrate function that knows how to mount your components.
+ *
+ * @example Vue
+ * ```ts
+ * import { initIslands } from '@ox-content/islands';
+ * import { createApp, h } from 'vue';
+ * import Counter from './Counter.vue';
+ *
+ * const components = { Counter };
+ *
+ * initIslands((el, props) => {
+ *   const name = el.dataset.oxIsland!;
+ *   const Component = components[name];
+ *   if (!Component) return;
+ *
+ *   const app = createApp({ render: () => h(Component, props) });
+ *   app.mount(el);
+ *
+ *   return () => app.unmount();
+ * });
+ * ```
+ *
+ * @example React
+ * ```ts
+ * import { initIslands } from '@ox-content/islands';
+ * import { createRoot } from 'react-dom/client';
+ * import Counter from './Counter';
+ *
+ * const components = { Counter };
+ *
+ * initIslands((el, props) => {
+ *   const name = el.dataset.oxIsland!;
+ *   const Component = components[name];
+ *   if (!Component) return;
+ *
+ *   const root = createRoot(el);
+ *   root.render(<Component {...props} />);
+ *
+ *   return () => root.unmount();
+ * });
+ * ```
+ *
+ * @example Vanilla JS
+ * ```ts
+ * import { initIslands } from '@ox-content/islands';
+ *
+ * initIslands((el, props) => {
+ *   const name = el.dataset.oxIsland!;
+ *
+ *   if (name === 'Counter') {
+ *     let count = props.initial || 0;
+ *     const button = el.querySelector('button')!;
+ *     const handler = () => {
+ *       count++;
+ *       button.textContent = String(count);
+ *     };
+ *     button.addEventListener('click', handler);
+ *     return () => button.removeEventListener('click', handler);
+ *   }
+ * });
+ * ```
+ */
+declare function initIslands(hydrate: HydrateFunction, options?: InitIslandsOptions): IslandController;
+/**
+ * Create a deferred hydration wrapper.
+ *
+ * Returns a function that can be called to hydrate islands later.
+ * Useful for frameworks that need to register components first.
+ *
+ * @example
+ * ```ts
+ * const deferredInit = createDeferredInit();
+ *
+ * // Later, after components are ready
+ * const components = await loadComponents();
+ * deferredInit((el, props) => {
+ *   const Component = components[el.dataset.oxIsland!];
+ *   // ...
+ * });
+ * ```
+ */
+declare function createDeferredInit(options?: InitIslandsOptions): (hydrate: HydrateFunction) => IslandController;
+/**
+ * Check if islands are supported in the current environment.
+ */
+declare function isIslandsSupported(): boolean;
+//#endregion
+export { createDeferredInit, initIslands, isIslandsSupported };
+//# sourceMappingURL=runtime.d.cts.map

package/dist/runtime.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.cts","names":[],"sources":["../src/runtime.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwLgB,YACd,SAAS,iBACT,UAAU,qBACT;;;;;;;;;;;;;;;;;;;iBAqMa,mBACd,UAAU,sBACR,SAAS,oBAAoB;;;;iBAOjB"}

package/dist/runtime.d.mts

@@ -1,86 +1,4 @@
-//#region src/types.d.ts
-/**
- * Island Architecture Types
- *
- * Framework-agnostic type definitions for the Island system.
- */
-/**
- * Loading strategy for islands.
- *
- * - `eager`: Hydrate immediately on page load
- * - `idle`: Hydrate when the browser is idle (requestIdleCallback)
- * - `visible`: Hydrate when the element becomes visible (IntersectionObserver)
- * - `media`: Hydrate when a media query matches
- */
-type LoadStrategy = "eager" | "idle" | "visible" | "media";
-/**
- * Island configuration extracted from data attributes.
- */
-interface IslandConfig {
-  /** Unique island identifier */
-  id: string;
-  /** Component name to hydrate */
-  component: string;
-  /** Loading strategy */
-  load: LoadStrategy;
-  /** Media query for 'media' load strategy */
-  mediaQuery?: string;
-  /** Component props (JSON serialized in data-ox-props) */
-  props: Record<string, unknown>;
-  /** Whether the island wrapper already contains server-rendered component HTML. */
-  ssr?: boolean;
-}
-/**
- * Hydration function signature.
- *
- * Called when an island should be hydrated.
- * Returns an optional cleanup function.
- */
-type HydrateFunction = (element: HTMLElement, props: Record<string, unknown>) => void | (() => void);
-/**
- * Component registry mapping component names to hydrate functions.
- */
-type ComponentRegistry = Map<string, HydrateFunction>;
-/**
- * Options for initializing islands.
- */
-interface InitIslandsOptions {
-  /** Root margin for IntersectionObserver (visible strategy). Default: "200px" */
-  rootMargin?: string;
-  /** Threshold for IntersectionObserver. Default: 0 */
-  threshold?: number;
-  /** Timeout for idle callback fallback in ms. Default: 200 */
-  idleTimeout?: number;
-  /** Custom selector for finding islands. Default: "[data-ox-island]" */
-  selector?: string;
-  /** Called when an island starts hydrating */
-  onHydrateStart?: (element: HTMLElement, config: IslandConfig) => void;
-  /** Called when an island finishes hydrating */
-  onHydrateEnd?: (element: HTMLElement, config: IslandConfig) => void;
-  /** Called when hydration fails */
-  onHydrateError?: (element: HTMLElement, config: IslandConfig, error: Error) => void;
-}
-/**
- * Island instance tracking.
- */
-interface IslandInstance {
-  element: HTMLElement;
-  config: IslandConfig;
-  cleanup?: () => void;
-  hydrated: boolean;
-}
-/**
- * Island controller returned by initIslands.
- */
-interface IslandController {
-  /** All tracked island instances */
-  instances: IslandInstance[];
-  /** Manually hydrate a specific island */
-  hydrate: (element: HTMLElement) => void;
-  /** Destroy all islands and cleanup */
-  destroy: () => void;
-}
-//#endregion
+import { a as IslandController, n as HydrateFunction, r as InitIslandsOptions } from "./types.mjs";
 //#region src/runtime.d.ts
 /**
  * Initialize islands with a hydration function.
@@ -173,5 +91,5 @@ declare function createDeferredInit(options?: InitIslandsOptions): (hydrate: Hyd
  */
 declare function isIslandsSupported(): boolean;
 //#endregion
-export { HydrateFunction as a, IslandController as c, ComponentRegistry as i, IslandInstance as l, initIslands as n, InitIslandsOptions as o, isIslandsSupported as r, IslandConfig as s, createDeferredInit as t, LoadStrategy as u };
+export { createDeferredInit, initIslands, isIslandsSupported };
 //# sourceMappingURL=runtime.d.mts.map

package/dist/runtime.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/types.ts","../src/runtime.ts"],"mappings":";;;;;;;;;;;;;;KAcY;;;;UAKK;;EAEf;;EAEA;;EAEA,MAAM;;EAEN;;EAEA,OAAO;;EAEP;;;;;;;;KASU,mBACV,SAAS,aACT,OAAO;;;;KAMG,oBAAoB,YAAY;;;;UAK3B;;EAEf;;EAEA;;EAEA;;EAEA;;EAEA,kBAAkB,SAAS,aAAa,QAAQ;;EAEhD,gBAAgB,SAAS,aAAa,QAAQ;;EAE9C,kBAAkB,SAAS,aAAa,QAAQ,cAAc,OAAO;;;;;UAMtD;EACf,SAAS;EACT,QAAQ;EACR;EACA;;;;;UAMe;;EAEf,WAAW;;EAEX,UAAU,SAAS;;EAEnB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBC+Fc,YACd,SAAS,iBACT,UAAU,qBACT;;;;;;;;;;;;;;;;;;;iBAyJa,mBACd,UAAU,sBACR,SAAS,oBAAoB;;;;iBAOjB"}
+{"version":3,"file":"runtime.d.mts","names":[],"sources":["../src/runtime.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAwLgB,YACd,SAAS,iBACT,UAAU,qBACT;;;;;;;;;;;;;;;;;;;iBAqMa,mBACd,UAAU,sBACR,SAAS,oBAAoB;;;;iBAOjB"}