@takazudo/zudo-doc 5.14.0 → 5.16.0

package/dist/content/content-link.js

@@ -24,7 +24,9 @@ function createContentLink({
   base,
   assetManifest,
   routePrefix,
-  dir
+  dir,
+  locale,
+  isDefaultLocaleOnlyPath
 }) {
   return function ManifestAwareContentLink(props) {
     const { href, className, children } = props;
@@ -43,6 +45,7 @@ function createContentLink({
           base,
           routePrefix,
           path: entry.path,
+          locale: isDefaultLocaleOnlyPath?.(`/${routePrefix}/${entry.path}`) ? void 0 : locale,
           fragment: decoded.fragment
         }),
         children: /* @__PURE__ */ jsxs("span", { className: "inline-flex items-baseline gap-x-hsp-xs font-mono", children: [

package/dist/doc-content-header/index.js

@@ -20,7 +20,7 @@ function createDocContentHeader(ctx) {
     version
   }) {
     return /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold border-b border-fg pb-vsp-xs mb-vsp-xs", children: entry.data.title }),
+      /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold border-b border-fg pb-vsp-xs mb-vsp-xs break-words", children: entry.data.title }),
       docContentHeaderExtras?.({
         entry,
         slug,

package/dist/doc-page-shell/index.js

@@ -176,7 +176,7 @@ function createDocPageShell(ctx) {
              Fragment (not <div>) so children become direct children of
              <article class="zd-content">, picking up the flow-space rule. */
           /* @__PURE__ */ jsxs(Fragment, { children: [
-            /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold border-b border-fg pb-vsp-xs mb-vsp-xs", children: autoIndexLabel }),
+            /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold border-b border-fg pb-vsp-xs mb-vsp-xs break-words", children: autoIndexLabel }),
             metainfoSlot,
             description && /* @__PURE__ */ jsx("p", { class: "mb-vsp-lg text-title text-muted", "data-doc-description": true, children: description }),
             /* @__PURE__ */ jsx(NavCardGrid, { children: autoIndexChildren ?? [] })

package/dist/factory-context/index.d.ts

@@ -27,8 +27,9 @@ export interface FactoryI18n {
     /** Display label for a locale (e.g. `"EN"`, `"日本語"`). */
     getLocaleLabel: (locale: string) => string;
     /**
-     * Translate a UI string key for a locale, falling back to the default locale
-     * then the key itself. Optional: factories that emit no UI strings omit it.
+     * Translate a UI string key for a locale, falling back through the configured
+     * default locale, package English, then the raw key. Optional: factories
+     * that emit no UI strings omit it.
      */
     t?: (key: string, locale?: string) => string;
 }
@@ -136,7 +137,10 @@ export interface RouteContext<S = Settings> extends UrlHelpers, NavSourceDocsAPI
     } | undefined;
     /** Display label for a locale. */
     getLocaleLabel(locale: string): string;
-    /** Translate a UI string key for a locale (falls back to default then key). */
+    /**
+     * Translate a UI string key for a locale (falls back through the configured
+     * default locale, package English, then the raw key).
+     */
     t(key: string, locale?: string): string;
     /** The full URL-helper bag (also spread as own members via `extends`). */
     urlHelpers: UrlHelpers;

package/dist/header-with-defaults/index.js

@@ -120,6 +120,8 @@ function createHeaderWithDefaults(ctx) {
       LanguageSwitcher,
       {
         links: localeLinks,
+        accessibleLabel: t("language.switcher.label", lang),
+        idSuffix: "header",
         config: {
           base: settings.base.replace(/\/+$/, ""),
           defaultLocale,

package/dist/home-page/index.js

@@ -117,7 +117,7 @@ function createHomePageView(ctx) {
               }
             ) : null,
             /* @__PURE__ */ jsxs("div", { children: [
-              /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs", children: settings.siteName }),
+              /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs break-words", children: settings.siteName }),
               /* @__PURE__ */ jsx("p", { class: "text-muted text-small mb-vsp-sm", children: settings.siteDescription }),
               /* @__PURE__ */ jsx("div", { class: "flex items-center justify-center lg:justify-start gap-hsp-md text-small", children: rowItems.map((item, index) => /* @__PURE__ */ jsxs(Fragment2, { children: [
                 index > 0 && /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" }),

package/dist/html-preview-wrapper/html-preview-wrapper.d.ts

@@ -1,6 +1,7 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { VNode } from "preact";
+import { type HtmlPreviewLabels } from "./html-preview.js";
 /**
  * Global HTML preview configuration. Mirrors the `settings.htmlPreview`
  * shape from the host project so callers can pass the resolved config
@@ -15,6 +16,20 @@ export interface HtmlPreviewGlobalConfig {
     js?: string;
 }
 export interface HtmlPreviewWrapperProps {
+    /**
+     * Controls when the preview subtree is rendered.
+     *
+     * `"eager"` (and omission) preserves the server-rendered iframe and
+     * hydrates it when visible. `"visible"` emits only an inert height
+     * reservation during SSR and renders the preview on the client through
+     * zfb's skip-SSR island path.
+     *
+     * This is a component lifecycle policy and is not forwarded as the native
+     * iframe `loading` attribute.
+     *
+     * @default "eager"
+     */
+    loading?: "eager" | "visible";
     /**
      * Site-wide HTML preview configuration (resolved from
      * `settings.htmlPreview` by the caller). When provided, its
@@ -36,10 +51,24 @@ export interface HtmlPreviewWrapperProps {
     js?: string;
     /** Optional title displayed in the preview title bar. */
     title?: string;
+    /**
+     * Language tag for the generated preview document. Any nonblank tag is
+     * forwarded as-is; omission or a blank value falls back to `"en"` in
+     * `<HtmlPreview>`. Bound consumers should pass their active route locale.
+     *
+     * @default "en"
+     */
+    lang?: string;
     /** Fixed iframe height in pixels. Auto-sizes when omitted. */
     height?: number;
     /** When true, the code section is expanded by default. */
     defaultOpen?: boolean;
+    /** Localized labels for viewport, source, and iframe controls. */
+    labels?: Partial<HtmlPreviewLabels>;
+    /** Whether the source toggle and code panel are rendered. @default true */
+    showSource?: boolean;
+    /** Whether the viewport preset controls are rendered. @default true */
+    showViewportControls?: boolean;
     /**
      * Forwarded to `<HtmlPreview>`. When true, makes the preview document's
      * `html`/`body` stretch to 100% height. Interacts with auto-height — pair
@@ -94,6 +123,7 @@ export interface HtmlPreviewWrapperProps {
      */
     showResources?: boolean;
 }
+type HtmlPreviewWrapperInnerProps = Omit<HtmlPreviewWrapperProps, "loading">;
 /**
  * Bare HTML preview body — the actual island **hydration target**.
  *
@@ -121,7 +151,7 @@ export interface HtmlPreviewWrapperProps {
  * (`HtmlPreviewWrapperInner`) and is exported, so the marker resolves to
  * THIS bare component and the bundle hydrates it in-place.
  */
-export declare function HtmlPreviewWrapperInner(props: HtmlPreviewWrapperProps): VNode;
+export declare function HtmlPreviewWrapperInner(props: HtmlPreviewWrapperInnerProps): VNode;
 export declare namespace HtmlPreviewWrapperInner {
     var displayName: string;
 }
@@ -129,12 +159,15 @@ export declare namespace HtmlPreviewWrapperInner {
  * HTML preview wrapper component — the public MDX-registered binding
  * (`HtmlPreview: HtmlPreviewWrapper`).
  *
- * Wraps the bare `HtmlPreviewWrapperInner` in `<Island when="visible">`,
- * mirroring the legacy `client:visible` hydration timing — the iframe is
- * heavy and not on the critical path, so hydration is deferred until the
- * preview enters the viewport. The SSG output emits
- * `data-zfb-island="HtmlPreviewWrapperInner"` around the bare tree, and the
- * client bundle hydrates `HtmlPreviewWrapperInner` against it in-place.
+ * Eager mode wraps the bare `HtmlPreviewWrapperInner` in
+ * `<Island when="visible">`, mirroring the legacy `client:visible` hydration
+ * timing while preserving the complete server-rendered preview. Visible mode
+ * uses zfb's skip-SSR fallback path: static output contains only an inert
+ * nonzero reservation, while the real serializable inner props remain on the
+ * island marker for the client mount. zfb intentionally mounts skip-SSR
+ * islands immediately, so the bare inner target keeps that reservation in
+ * place and applies its own one-shot IntersectionObserver gate before it
+ * instantiates the preview subtree; missing observer support fails open.
  *
  * The public export name and signature are unchanged from before the
  * zudolab/zudo-doc#1925 fix, so existing consumers that register
@@ -142,3 +175,4 @@ export declare namespace HtmlPreviewWrapperInner {
  * with no call-site change.
  */
 export declare function HtmlPreviewWrapper(props: HtmlPreviewWrapperProps): VNode;
+export {};

package/dist/html-preview-wrapper/html-preview-wrapper.js

@@ -1,24 +1,91 @@
 "use client";
 import { jsx } from "preact/jsx-runtime";
+import { useEffect, useRef, useState } from "preact/hooks";
 import { Island } from "@takazudo/zfb";
 import { HtmlPreview } from "./html-preview.js";
+const VISIBLE_MOUNT_PROP = "__zudoDocVisibleMount";
+function reservationHeight(height) {
+  return height != null && height > 0 ? height : 200;
+}
+function HtmlPreviewReservation({
+  height,
+  reservationRef
+}) {
+  return /* @__PURE__ */ jsx(
+    "div",
+    {
+      ref: reservationRef,
+      "aria-hidden": "true",
+      "data-zd-html-preview-reservation": true,
+      style: { height: reservationHeight(height) }
+    }
+  );
+}
 function HtmlPreviewWrapperInner(props) {
+  const runtimeProps = props;
+  const deferUntilVisible = runtimeProps[VISIBLE_MOUNT_PROP] === true;
+  const reservationRef = useRef(null);
+  const [shouldRenderPreview, setShouldRenderPreview] = useState(
+    !deferUntilVisible || typeof globalThis.IntersectionObserver !== "function"
+  );
+  useEffect(() => {
+    if (shouldRenderPreview) return;
+    if (!deferUntilVisible) {
+      setShouldRenderPreview(true);
+      return;
+    }
+    const target = reservationRef.current;
+    const Observer = globalThis.IntersectionObserver;
+    if (!target || typeof Observer !== "function") {
+      setShouldRenderPreview(true);
+      return;
+    }
+    let fired = false;
+    const observer = new Observer(
+      (entries) => {
+        if (fired || !entries.some((entry) => entry.isIntersecting)) return;
+        fired = true;
+        observer.disconnect();
+        setShouldRenderPreview(true);
+      },
+      { threshold: 0 }
+    );
+    observer.observe(target);
+    return () => {
+      fired = true;
+      observer.disconnect();
+    };
+  }, [deferUntilVisible, shouldRenderPreview]);
   const {
+    [VISIBLE_MOUNT_PROP]: _visibleMount,
     globalConfig,
     html,
     css,
     head,
     js,
     title,
+    lang,
     height,
     defaultOpen,
+    labels,
+    showSource,
+    showViewportControls,
     fullHeight,
     sandbox,
     externalStyles,
     externalScripts,
     preflight,
     showResources
-  } = props;
+  } = runtimeProps;
+  if (!shouldRenderPreview) {
+    return /* @__PURE__ */ jsx(
+      HtmlPreviewReservation,
+      {
+        height,
+        reservationRef
+      }
+    );
+  }
   const mergedHead = [globalConfig?.head, head].filter(Boolean).join("\n") || void 0;
   const mergedCss = [globalConfig?.css, css].filter(Boolean).join("\n") || void 0;
   const mergedJs = [globalConfig?.js, js].filter(Boolean).join("\n") || void 0;
@@ -30,8 +97,12 @@ function HtmlPreviewWrapperInner(props) {
       head: mergedHead,
       js: mergedJs,
       title,
+      lang,
       height,
       defaultOpen,
+      labels,
+      showSource,
+      showViewportControls,
       fullHeight,
       sandbox,
       componentCss: css,
@@ -46,9 +117,22 @@ function HtmlPreviewWrapperInner(props) {
 }
 HtmlPreviewWrapperInner.displayName = "HtmlPreviewWrapperInner";
 function HtmlPreviewWrapper(props) {
+  const { loading = "eager", ...innerProps } = props;
+  if (loading === "visible") {
+    const visibleInnerProps = {
+      ...innerProps,
+      [VISIBLE_MOUNT_PROP]: true
+    };
+    const rendered2 = Island({
+      when: "visible",
+      ssrFallback: /* @__PURE__ */ jsx(HtmlPreviewReservation, { height: innerProps.height }),
+      children: /* @__PURE__ */ jsx(HtmlPreviewWrapperInner, { ...visibleInnerProps })
+    });
+    return rendered2;
+  }
   const rendered = Island({
     when: "visible",
-    children: /* @__PURE__ */ jsx(HtmlPreviewWrapperInner, { ...props })
+    children: /* @__PURE__ */ jsx(HtmlPreviewWrapperInner, { ...innerProps })
   });
   return rendered;
 }

package/dist/html-preview-wrapper/html-preview.d.ts

@@ -1,14 +1,30 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { VNode } from "preact";
+import { type HtmlPreviewLabels } from "./preview-base.js";
+export type { HtmlPreviewLabels } from "./preview-base.js";
 export interface HtmlPreviewProps {
     html: string;
     css?: string;
     head?: string;
     js?: string;
     title?: string;
+    /**
+     * Language tag for the generated preview document's `<html lang>`
+     * attribute. Any nonblank tag is accepted; omission or a blank value falls
+     * back to `"en"`. Bound consumers should pass their active route locale.
+     *
+     * @default "en"
+     */
+    lang?: string;
     height?: number;
     defaultOpen?: boolean;
+    /** Localized labels for viewport, source, and iframe controls. */
+    labels?: Partial<HtmlPreviewLabels>;
+    /** Whether the source toggle and code panel are rendered. @default true */
+    showSource?: boolean;
+    /** Whether the viewport preset controls are rendered. @default true */
+    showViewportControls?: boolean;
     /**
      * When true, injects `<style>html,body{height:100%}</style>` into the
      * preview document so the preview's content can stretch to fill the
@@ -20,8 +36,9 @@ export interface HtmlPreviewProps {
      * `iframe.contentDocument.body.scrollHeight` and resizes the iframe to
      * fit; `fullHeight` makes the body's height derive FROM the iframe's own
      * height instead, which creates a feedback loop when the iframe height is
-     * itself derived from the body. This component does not attempt to
-     * detect or break that loop — always set `height` alongside `fullHeight`.
+     * itself derived from the body. Auto-height is therefore disabled when
+     * `fullHeight` is used without a fixed height. Pair both props when the
+     * preview needs a height other than the default 200px reservation.
      *
      * @default false
      */
@@ -121,7 +138,15 @@ export declare function containsScript(head?: string, js?: string, externalScrip
  * trust note.
  */
 export declare function resolveSandbox(sandbox: string | undefined, hasScripts: boolean): string;
-export declare function buildSrcdoc(html: string, css?: string, head?: string, js?: string, fullHeight?: boolean, externalStyles?: string[], externalScripts?: string[], preflight?: boolean): string;
+export interface BuildSrcdocMetadata {
+    /** Language for the generated document. Blank values fall back to `"en"`. */
+    lang?: string;
+    /** Visible preview title, used when the trusted head has no opening title. */
+    title?: string;
+    /** Localized preview label used after a blank visible title. */
+    previewLabel?: string;
+}
+export declare function buildSrcdoc(html: string, css?: string, head?: string, js?: string, fullHeight?: boolean, externalStyles?: string[], externalScripts?: string[], preflight?: boolean, metadata?: BuildSrcdocMetadata): string;
 /**
  * HTML preview widget — renders an isolated iframe with viewport
  * controls and a collapsible code section.
@@ -134,4 +159,4 @@ export declare function buildSrcdoc(html: string, css?: string, head?: string, j
  * Astro, or wire up the SSR-skip placeholder pattern for non-Astro
  * consumers.
  */
-export declare function HtmlPreview({ html, css, head, js, title, height, defaultOpen, fullHeight, sandbox, componentCss, componentHead, componentJs, externalStyles, externalScripts, preflight, showResources, }: HtmlPreviewProps): VNode;
+export declare function HtmlPreview({ html, css, head, js, title, lang, height, defaultOpen, labels, showSource, showViewportControls, fullHeight, sandbox, componentCss, componentHead, componentJs, externalStyles, externalScripts, preflight, showResources, }: HtmlPreviewProps): VNode;

package/dist/html-preview-wrapper/html-preview.js

@@ -1,6 +1,8 @@
 import { jsx } from "preact/jsx-runtime";
 import { useMemo } from "preact/hooks";
-import { PreviewBase } from "./preview-base.js";
+import {
+  PreviewBase
+} from "./preview-base.js";
 import { dedent } from "./dedent.js";
 import { preflightCss } from "./preflight.js";
 function containsScript(head, js, externalScripts) {
@@ -13,15 +15,49 @@ function resolveSandbox(sandbox, hasScripts) {
   return sandbox ?? (hasScripts ? "allow-scripts allow-same-origin" : "allow-same-origin");
 }
 const fullHeightStyle = "<style>html,body{height:100%}</style>";
-function buildSrcdoc(html, css, head, js, fullHeight, externalStyles, externalScripts, preflight) {
+function nonBlank(value) {
+  return value?.trim() ? value : void 0;
+}
+function escapeHtmlAttribute(value) {
+  return value.replaceAll("&", "&amp;").replaceAll('"', "&quot;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function escapeHtmlText(value) {
+  return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function hasAuthorTitle(head) {
+  if (!head) return false;
+  const withoutComments = head.replace(/<!--[\s\S]*?-->/g, "");
+  const openingTitle = /<title(?=[\s>])/gi;
+  for (const match of withoutComments.matchAll(openingTitle)) {
+    let quote;
+    for (let index = (match.index ?? 0) + match[0].length; index < withoutComments.length; index += 1) {
+      const character = withoutComments[index];
+      if (quote) {
+        if (character === quote) quote = void 0;
+        continue;
+      }
+      if (character === '"' || character === "'") {
+        quote = character;
+        continue;
+      }
+      if (character === ">") return true;
+      if (character === "<") break;
+    }
+  }
+  return false;
+}
+function buildSrcdoc(html, css, head, js, fullHeight, externalStyles, externalScripts, preflight, metadata) {
   const includePreflight = preflight ?? true;
+  const lang = nonBlank(metadata?.lang) ?? "en";
+  const generatedTitle = hasAuthorTitle(head) ? void 0 : nonBlank(metadata?.title) ?? nonBlank(metadata?.previewLabel) ?? "Preview";
   const externalStylesHtml = (externalStyles ?? []).map((href) => `<link rel="stylesheet" href="${href}">`).join("\n");
   const externalScriptsHtml = (externalScripts ?? []).map((src) => `<script src="${src}"></script>`).join("\n");
   return `<!doctype html>
-<html>
+<html lang="${escapeHtmlAttribute(lang)}">
 <head>
 <meta charset="utf-8">
 <meta name="viewport" content="width=device-width,initial-scale=1">
+${generatedTitle ? `<title>${escapeHtmlText(generatedTitle)}</title>` : ""}
 ${includePreflight ? `<style>${preflightCss}</style>` : ""}
 ${fullHeight ? fullHeightStyle : ""}
 ${externalStylesHtml}
@@ -40,8 +76,12 @@ function HtmlPreview({
   head,
   js,
   title,
+  lang,
   height,
   defaultOpen,
+  labels,
+  showSource,
+  showViewportControls,
   fullHeight,
   sandbox,
   componentCss,
@@ -61,13 +101,27 @@ function HtmlPreview({
       fullHeight,
       externalStyles,
       externalScripts,
-      preflight
+      preflight,
+      { lang, title, previewLabel: labels?.preview }
     ),
-    [html, css, head, js, fullHeight, externalStyles, externalScripts, preflight]
+    [
+      html,
+      css,
+      head,
+      js,
+      fullHeight,
+      externalStyles,
+      externalScripts,
+      preflight,
+      lang,
+      title,
+      labels?.preview
+    ]
   );
   const hasScripts = containsScript(head, js, externalScripts);
   const syncDelay = hasScripts ? 300 : 0;
   const sandboxValue = resolveSandbox(sandbox, hasScripts);
+  const sandboxAttributeValue = sandboxValue === "" ? " " : sandboxValue;
   const codeBlocks = useMemo(() => {
     const resourceLines = showResources ? [
       ...(externalStyles ?? []).map(
@@ -108,7 +162,11 @@ ${dedent(html)}` : dedent(html);
       height,
       srcdoc,
       defaultOpen,
-      sandbox: sandboxValue,
+      labels,
+      showSource,
+      showViewportControls,
+      autoHeight: height == null && !fullHeight,
+      sandbox: sandboxAttributeValue,
       syncDelay,
       codeBlocks
     }

package/dist/html-preview-wrapper/index.d.ts

@@ -3,6 +3,6 @@ export type { HtmlPreviewWrapperProps, HtmlPreviewGlobalConfig, } from "./html-p
 export { HtmlPreview } from "./html-preview.js";
 export type { HtmlPreviewProps } from "./html-preview.js";
 export { PreviewBase } from "./preview-base.js";
-export type { PreviewBaseProps, CodeBlockData } from "./preview-base.js";
+export type { PreviewBaseProps, CodeBlockData, HtmlPreviewLabels, } from "./preview-base.js";
 export { HighlightedCode } from "./highlighted-code.js";
 export type { HighlightedCodeProps } from "./highlighted-code.js";

package/dist/html-preview-wrapper/preview-auto-height.d.ts

@@ -0,0 +1,24 @@
+interface PreviewAutoHeightRuntime {
+    setTimeout(callback: () => void, delay: number): number;
+    clearTimeout(id: number): void;
+    requestAnimationFrame(callback: FrameRequestCallback): number;
+    cancelAnimationFrame(id: number): void;
+}
+export interface PreviewAutoHeightOptions {
+    iframe: HTMLIFrameElement;
+    syncDelay: number;
+    getCurrentHeight: () => number;
+    setHeight: (height: number) => void;
+    runtime?: PreviewAutoHeightRuntime;
+}
+export interface PreviewAutoHeightController {
+    handleLoad(): void;
+    schedule(): void;
+    destroy(): void;
+}
+/**
+ * Owns the readable-iframe auto-height lifecycle. Kept separate from Preact so
+ * reload generations, observer callbacks, and teardown remain deterministic.
+ */
+export declare function createPreviewAutoHeightController({ iframe, syncDelay, getCurrentHeight, setHeight, runtime, }: PreviewAutoHeightOptions): PreviewAutoHeightController;
+export {};

package/dist/html-preview-wrapper/preview-auto-height.js

@@ -0,0 +1,120 @@
+const MIN_PREVIEW_HEIGHT = 200;
+const PREVIEW_HEIGHT_BUFFER = 16;
+const SELF_SIZING_EPSILON = 1;
+function defaultRuntime(iframe) {
+  const view = iframe.ownerDocument.defaultView ?? window;
+  return {
+    setTimeout: (callback, delay) => view.setTimeout(callback, delay),
+    clearTimeout: (id) => view.clearTimeout(id),
+    requestAnimationFrame: (callback) => view.requestAnimationFrame(callback),
+    cancelAnimationFrame: (id) => view.cancelAnimationFrame(id)
+  };
+}
+function createPreviewAutoHeightController({
+  iframe,
+  syncDelay,
+  getCurrentHeight,
+  setHeight,
+  runtime = defaultRuntime(iframe)
+}) {
+  let generation = 0;
+  let document = null;
+  let observer = null;
+  let timeoutId = null;
+  let frameId = null;
+  let lastAppliedHeight = getCurrentHeight();
+  let lastWriteSample;
+  let destroyed = false;
+  const cancelPending = () => {
+    observer?.disconnect();
+    observer = null;
+    if (timeoutId != null) {
+      runtime.clearTimeout(timeoutId);
+      timeoutId = null;
+    }
+    if (frameId != null) {
+      runtime.cancelAnimationFrame(frameId);
+      frameId = null;
+    }
+    document = null;
+  };
+  const measure = (expectedGeneration) => {
+    if (destroyed || expectedGeneration !== generation || !document?.body) {
+      return;
+    }
+    const bodyHeight = document.body.scrollHeight;
+    if (!Number.isFinite(bodyHeight) || bodyHeight <= 0) return;
+    const currentHeight = getCurrentHeight();
+    const targetHeight = Math.max(
+      bodyHeight + PREVIEW_HEIGHT_BUFFER,
+      MIN_PREVIEW_HEIGHT
+    );
+    const isSelfSizingGrowth = targetHeight > currentHeight && Math.abs(bodyHeight - currentHeight) <= SELF_SIZING_EPSILON;
+    const followedPreviousWrite = targetHeight > currentHeight && lastWriteSample != null && Math.abs(currentHeight - lastWriteSample.targetHeight) <= SELF_SIZING_EPSILON && Math.abs(
+      bodyHeight - lastWriteSample.bodyHeight - (currentHeight - lastWriteSample.currentHeight)
+    ) <= SELF_SIZING_EPSILON;
+    if (isSelfSizingGrowth || followedPreviousWrite || targetHeight === lastAppliedHeight) {
+      return;
+    }
+    lastAppliedHeight = targetHeight;
+    lastWriteSample = { bodyHeight, currentHeight, targetHeight };
+    setHeight(targetHeight);
+  };
+  const scheduleFor = (expectedGeneration) => {
+    if (destroyed || expectedGeneration !== generation || document == null || frameId != null) {
+      return;
+    }
+    frameId = runtime.requestAnimationFrame(() => {
+      frameId = null;
+      measure(expectedGeneration);
+    });
+  };
+  const handleLoad = () => {
+    generation += 1;
+    cancelPending();
+    if (destroyed) return;
+    const expectedGeneration = generation;
+    lastAppliedHeight = getCurrentHeight();
+    lastWriteSample = void 0;
+    try {
+      const nextDocument = iframe.contentDocument;
+      if (!nextDocument?.body) return;
+      void nextDocument.body.scrollHeight;
+      document = nextDocument;
+    } catch {
+      return;
+    }
+    measure(expectedGeneration);
+    if (syncDelay > 0) {
+      timeoutId = runtime.setTimeout(() => {
+        timeoutId = null;
+        scheduleFor(expectedGeneration);
+      }, syncDelay);
+    }
+    const iframeWindow = iframe.contentWindow;
+    const ResizeObserverConstructor = iframeWindow?.ResizeObserver;
+    if (ResizeObserverConstructor) {
+      const nextObserver = new ResizeObserverConstructor(() => {
+        scheduleFor(expectedGeneration);
+      });
+      observer = nextObserver;
+      nextObserver.observe(document.body);
+      if (document.documentElement !== document.body) {
+        nextObserver.observe(document.documentElement);
+      }
+    }
+  };
+  return {
+    handleLoad,
+    schedule: () => scheduleFor(generation),
+    destroy: () => {
+      if (destroyed) return;
+      destroyed = true;
+      generation += 1;
+      cancelPending();
+    }
+  };
+}
+export {
+  createPreviewAutoHeightController
+};