@preprio/toolkit 0.5.0-rc.4 → 0.5.1-dom.0

package/dist/{chunk-74KY5EAM.js → chunk-ZFGVP2GW.js}

@@ -1,3 +1,17 @@
+import {
+  TEXT_BODY_FIELDS,
+  graphqlFieldName,
+  indexSnapshot,
+  isLiveFieldChange,
+  isPlainRecord,
+  isTextEntry,
+  keepEditLink,
+  parseEditTarget,
+  parseListEntries,
+  plainTextFromHtml,
+  syncListAtPath,
+  writeAtPath
+} from "./chunk-AZC4BZJI.js";
 import {
   createScopedLogger
 } from "./chunk-S3VT4UWM.js";
@@ -6,327 +20,9 @@ import {
 import {
   vercelStegaCombine,
   vercelStegaDecode,
-  vercelStegaSplit as vercelStegaSplit2
+  vercelStegaSplit
 } from "@vercel/stega";
 
-// src/core/live-preview/field-name.ts
-var UPPERCASE_BOUNDARY = /(.)(?=[A-Z])/g;
-function graphqlFieldName(apiId) {
-  return apiId.replace(UPPERCASE_BOUNDARY, "$1_").toLowerCase();
-}
-function fieldKeyIn(record, apiId) {
-  if (Object.prototype.hasOwnProperty.call(record, apiId)) return apiId;
-  const name = graphqlFieldName(apiId);
-  return Object.prototype.hasOwnProperty.call(record, name) ? name : void 0;
-}
-var TEXT_BODY_FIELDS = [
-  { name: "body", plain: false },
-  { name: "html", plain: false },
-  { name: "text", plain: true }
-];
-var TAG_PATTERN = /<[^>]+>/g;
-function plainTextFromHtml(html) {
-  return html.replace(TAG_PATTERN, "");
-}
-function isTextEntry(record) {
-  const typename = record.__typename;
-  if (typeof typename === "string") return typename === "Text";
-  return "html" in record || "text" in record && "format" in record;
-}
-
-// src/core/live-preview/index-snapshot.ts
-var debug = createScopedLogger("live-preview");
-function indexSnapshot(data) {
-  const index = /* @__PURE__ */ new Map();
-  const visited = /* @__PURE__ */ new WeakSet();
-  const path = [];
-  function walk(node) {
-    if (node === null || typeof node !== "object") return;
-    if (visited.has(node)) return;
-    visited.add(node);
-    if (Array.isArray(node)) {
-      for (let i = 0; i < node.length; i++) {
-        path.push(i);
-        walk(node[i]);
-        path.pop();
-      }
-      return;
-    }
-    const record = node;
-    if (typeof record._id === "string") {
-      const paths = index.get(record._id);
-      if (paths) paths.push([...path]);
-      else index.set(record._id, [[...path]]);
-    } else if (typeof record.__typename === "string") {
-      debug.log("item without _id will not live-update", {
-        __typename: record.__typename
-      });
-    }
-    for (const key in record) {
-      if (!Object.prototype.hasOwnProperty.call(record, key)) continue;
-      path.push(key);
-      walk(record[key]);
-      path.pop();
-    }
-  }
-  walk(data);
-  return index;
-}
-
-// src/core/live-preview/patch.ts
-import { vercelStegaSplit } from "@vercel/stega";
-var INDEX_SEGMENT = /^\d+$/;
-var FORBIDDEN_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
-function isPlainObject(value) {
-  return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-function mergeObject(current, incoming) {
-  let changed = false;
-  const next = { ...current };
-  for (const key of Object.keys(current)) {
-    if (!(key in incoming) || incoming[key] === void 0) continue;
-    const value = isPlainObject(current[key]) && isPlainObject(incoming[key]) ? mergeObject(current[key], incoming[key]) : incoming[key];
-    if (value !== current[key]) {
-      next[key] = value;
-      changed = true;
-    }
-  }
-  return changed ? next : current;
-}
-function shapeLike(template, incoming) {
-  const out = {};
-  for (const key of Object.keys(template)) {
-    const value = incoming[key];
-    out[key] = value === void 0 ? null : isPlainObject(template[key]) && isPlainObject(value) ? shapeLike(template[key], value) : value;
-  }
-  return out;
-}
-function mergeStructured(current, incoming) {
-  if (incoming === null || Array.isArray(incoming) && !incoming.length) {
-    if (Array.isArray(current)) return current.length ? [] : current;
-    return null;
-  }
-  const list = Array.isArray(incoming) ? incoming : [incoming];
-  if (current === null || current === void 0) return incoming;
-  if (Array.isArray(current)) {
-    const template = current.find(isPlainObject);
-    return list.map((entry) => {
-      const match = current.find(
-        (c) => isPlainObject(c) && c._id !== void 0 && c._id === entry._id
-      );
-      if (isPlainObject(match)) return mergeObject(match, entry);
-      return isPlainObject(template) ? shapeLike(template, entry) : entry;
-    });
-  }
-  if (isPlainObject(current)) return mergeObject(current, list[0]);
-  return current;
-}
-function isPatchable(current) {
-  return current === null || typeof current === "string" || typeof current === "number" || typeof current === "boolean";
-}
-function cloneNode(node) {
-  return Array.isArray(node) ? [...node] : { ...node };
-}
-function patchSnapshot(snapshot, index, itemId, field, value) {
-  const paths = index.get(itemId);
-  if (!paths?.length) return snapshot;
-  let root = snapshot;
-  let changed = false;
-  const markChanged = () => {
-    changed = true;
-  };
-  for (const path of paths) {
-    for (const [target, targetValue] of expandTextBody(
-      root,
-      path,
-      field,
-      value
-    )) {
-      root = patchAtPath(root, path, target, targetValue, markChanged);
-    }
-  }
-  return changed ? root : snapshot;
-}
-function expandTextBody(root, path, field, value) {
-  const segments = field.split(".");
-  if (segments[segments.length - 1] !== "body" || typeof value !== "string") {
-    return [[field, value]];
-  }
-  let node = root;
-  for (const step of path) {
-    node = node[step];
-  }
-  for (const segment of segments.slice(0, -1)) {
-    if (node === null || typeof node !== "object") return [[field, value]];
-    const record2 = node;
-    node = INDEX_SEGMENT.test(segment) ? record2[Number(segment)] : record2[fieldKeyIn(record2, segment) ?? segment];
-  }
-  if (node === null || typeof node !== "object" || Array.isArray(node)) {
-    return [[field, value]];
-  }
-  const record = node;
-  if (!isTextEntry(record)) return [[field, value]];
-  const prefix = segments.slice(0, -1);
-  const writes = [];
-  for (const { name, plain } of TEXT_BODY_FIELDS) {
-    if (!(name in record)) continue;
-    writes.push([
-      [...prefix, name].join("."),
-      plain ? plainTextFromHtml(value) : value
-    ]);
-  }
-  return writes.length ? writes : [[field, value]];
-}
-function patchAtPath(root, path, field, value, markChanged) {
-  const segments = field.split(".");
-  if (segments.some((s) => FORBIDDEN_SEGMENTS.has(s))) return root;
-  let node = root;
-  for (const step of path) {
-    node = node[step];
-  }
-  const fullPath = [...path];
-  for (const segment of segments) {
-    let step = segment;
-    if (INDEX_SEGMENT.test(segment)) {
-      step = Number(segment);
-    } else if (node !== null && typeof node === "object") {
-      step = fieldKeyIn(node, segment) ?? segment;
-    }
-    fullPath.push(step);
-    node = node !== null && typeof node === "object" ? node[step] : void 0;
-  }
-  return writeAtPath(root, fullPath, value, markChanged);
-}
-function writeAtPath(root, fullPath, value, markChanged = () => {
-}) {
-  if (!fullPath.length) return root;
-  if (fullPath.some((s) => FORBIDDEN_SEGMENTS.has(String(s)))) return root;
-  const last = fullPath.length - 1;
-  let node = root;
-  for (let i = 0; i < last; i++) {
-    if (node === null || typeof node !== "object") return root;
-    node = node[fullPath[i]];
-  }
-  if (node === null || typeof node !== "object") return root;
-  const container = node;
-  const key = fullPath[last];
-  if (!(key in container)) return root;
-  let next;
-  if (value === null || typeof value === "object") {
-    next = mergeStructured(container[key], value);
-  } else if (!isPatchable(container[key])) {
-    return root;
-  } else {
-    next = keepEditLink(container[key], value);
-  }
-  if (container[key] === next) return root;
-  const newRoot = cloneNode(root);
-  let cursor = newRoot;
-  for (let i = 0; i < last; i++) {
-    const child = cloneNode(cursor[fullPath[i]]);
-    cursor[fullPath[i]] = child;
-    cursor = child;
-  }
-  cursor[key] = next;
-  markChanged();
-  return newRoot;
-}
-function listKeysOf(entry) {
-  if (!isPlainObject(entry)) return [];
-  const keys = [];
-  if (typeof entry._id === "string") keys.push(entry._id);
-  const first = Array.isArray(entry.items) ? entry.items[0] : null;
-  if (isPlainObject(first) && typeof first._id === "string") {
-    keys.push(first._id);
-  }
-  return keys;
-}
-function buildText(entry, template) {
-  const body = typeof entry.body === "string" ? entry.body : "";
-  const full = {
-    __typename: "Text",
-    _id: entry._id,
-    body,
-    html: body,
-    text: plainTextFromHtml(body),
-    format: entry.format ?? null
-  };
-  if (!template) return full;
-  const out = {};
-  for (const key of Object.keys(template)) {
-    out[key] = key in full ? full[key] : null;
-  }
-  return out;
-}
-function syncList(current, entries, build) {
-  if (current === null || current === void 0) {
-    const built = syncList([], entries, build);
-    return built.length ? built : current;
-  }
-  if (!Array.isArray(current)) return current;
-  const byKey = /* @__PURE__ */ new Map();
-  const templates = /* @__PURE__ */ new Map();
-  for (const c of current) {
-    for (const key of listKeysOf(c)) byKey.set(key, c);
-    if (isPlainObject(c) && typeof c.__typename === "string") {
-      if (!templates.has(c.__typename)) templates.set(c.__typename, c);
-    }
-  }
-  if (!entries.length) return current.length ? [] : current;
-  if (current.length && !byKey.size) return current;
-  if (current.length && !entries.some((e) => byKey.has(e._id))) return current;
-  const next = [];
-  for (const entry of entries) {
-    const existing = byKey.get(entry._id);
-    const built = existing === void 0 && entry.fields ? build?.(entry) : void 0;
-    if (existing !== void 0) {
-      next.push(existing);
-    } else if (built) {
-      next.push(built);
-    } else if (entry.__typename === "Text") {
-      next.push(buildText(entry, templates.get("Text")));
-    }
-  }
-  const same = next.length === current.length && next.every((n, i) => n === current[i]);
-  return same ? current : next;
-}
-function syncListSnapshot(snapshot, index, itemId, field, entries) {
-  const paths = index.get(itemId);
-  if (!paths?.length) return snapshot;
-  const fieldPath = field.split(".");
-  if (fieldPath.some((s) => FORBIDDEN_SEGMENTS.has(s))) return snapshot;
-  let root = snapshot;
-  for (const path of paths) {
-    root = syncListAtPath(root, [...path, ...fieldPath], entries);
-  }
-  return root;
-}
-function syncListAtPath(root, fullPath, entries, build) {
-  if (!fullPath.length) return root;
-  if (fullPath.some((s) => FORBIDDEN_SEGMENTS.has(String(s)))) return root;
-  let node = root;
-  for (const key of fullPath) {
-    node = node !== null && typeof node === "object" ? node[key] : void 0;
-  }
-  const next = syncList(node, entries, build);
-  if (next === node) return root;
-  const newRoot = cloneNode(root);
-  let cursor = newRoot;
-  for (let i = 0; i < fullPath.length - 1; i++) {
-    const child = cloneNode(cursor[fullPath[i]]);
-    cursor[fullPath[i]] = child;
-    cursor = child;
-  }
-  cursor[fullPath[fullPath.length - 1]] = next;
-  return newRoot;
-}
-function keepEditLink(current, value) {
-  if (typeof current !== "string" || typeof value !== "string") return value;
-  const { encoded } = vercelStegaSplit(current);
-  if (!encoded || vercelStegaSplit(value).encoded) return value;
-  return value + encoded;
-}
-
 // src/core/live-preview/query-document.ts
 var NAME_START = /[_A-Za-z]/;
 var NAME_CONTINUE = /[_0-9A-Za-z]/;
@@ -662,121 +358,12 @@ function typeConditions(selections, doc) {
   return conditions;
 }
 
-// src/core/live-preview/validate.ts
-function isScalar(v) {
-  return typeof v === "string" || typeof v === "number" || typeof v === "boolean";
-}
-var MAX_DEPTH = 3;
-var MAX_ENTRIES = 50;
-var FORBIDDEN_KEYS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
-var SAFE_URL = /^https?:\/\//i;
-var URL_KEY = /^(?:url|href|src|link)$|(?:_url|Url)$/;
-var URL_IGNORED_ANYWHERE = /[\t\n\r]/g;
-var SCRIPT_SCHEME = /^(?:javascript|vbscript|data):/i;
-function isSafeLinkValue(value) {
-  const stripped = value.replace(URL_IGNORED_ANYWHERE, "");
-  let start = 0;
-  while (start < stripped.length && stripped.charCodeAt(start) <= 32) start++;
-  return !SCRIPT_SCHEME.test(stripped.slice(start));
-}
-function isUrlKey(key) {
-  return URL_KEY.test(key);
-}
-function isSafeKeyValue(key, value) {
-  if (typeof value !== "string") return true;
-  if (key === "url") return SAFE_URL.test(value);
-  return !isUrlKey(key) || isSafeLinkValue(value);
-}
-function isLiveValue(v, depth = 0) {
-  if (v === null || isScalar(v)) return true;
-  if (depth >= MAX_DEPTH) return false;
-  if (Array.isArray(v)) {
-    return depth === 0 && v.length <= MAX_ENTRIES && v.every((entry) => isPlainRecord(entry) && isLiveValue(entry, depth + 1));
-  }
-  if (!isPlainRecord(v)) return false;
-  const keys = Object.keys(v);
-  if (keys.length > MAX_ENTRIES) return false;
-  return keys.every((key) => {
-    if (FORBIDDEN_KEYS.has(key)) return false;
-    const value = v[key];
-    if (!isSafeKeyValue(key, value)) return false;
-    return !Array.isArray(value) && isLiveValue(value, depth + 1);
-  });
-}
-function isLiveFieldChange(field, value) {
-  if (!isLiveValue(value)) return false;
-  const name = field.slice(field.lastIndexOf(".") + 1);
-  return typeof value !== "string" || !isUrlKey(name) || isSafeLinkValue(value);
-}
-var MAX_LIST_ENTRIES = 200;
-function parseListEntries(value) {
-  if (!Array.isArray(value) || value.length > MAX_LIST_ENTRIES) return null;
-  const list = [];
-  for (const raw of value) {
-    if (!isPlainRecord(raw) || typeof raw._id !== "string" || !raw._id) {
-      return null;
-    }
-    const entry = { _id: raw._id };
-    if (typeof raw.__typename === "string") entry.__typename = raw.__typename;
-    if (typeof raw.body === "string") entry.body = raw.body;
-    if (typeof raw.format === "string" || raw.format === null) {
-      entry.format = raw.format;
-    }
-    if (typeof raw.typeName === "string" && raw.typeName.length <= 200) {
-      entry.typeName = raw.typeName;
-    }
-    if (raw.fields !== void 0) {
-      if (!isPlainRecord(raw.fields) || !isFieldValue(raw.fields, 0)) {
-        return null;
-      }
-      entry.fields = raw.fields;
-    }
-    list.push(entry);
-  }
-  return list;
-}
-function isPlainRecord(v) {
-  return v !== null && typeof v === "object" && Object.getPrototypeOf(v) === Object.prototype;
-}
-var MAX_FIELD_DEPTH = 6;
-var MAX_FIELD_KEYS = 100;
-function isFieldValue(v, depth) {
-  if (v === null || isScalar(v)) return true;
-  if (depth >= MAX_FIELD_DEPTH) return false;
-  if (Array.isArray(v)) {
-    return v.length <= MAX_ENTRIES && v.every(
-      (entry) => isScalar(entry) || isPlainRecord(entry) && isFieldValue(entry, depth + 1)
-    );
-  }
-  if (!isPlainRecord(v)) return false;
-  const keys = Object.keys(v);
-  if (keys.length > MAX_FIELD_KEYS) return false;
-  return keys.every((key) => {
-    if (FORBIDDEN_KEYS.has(key)) return false;
-    const value = v[key];
-    if (!isSafeKeyValue(key, value)) return false;
-    return isFieldValue(value, depth + 1);
-  });
-}
-var MAX_EDIT_LENGTH = 1e3;
-function parseEditTarget(raw) {
-  if (!isPlainRecord(raw)) return void 0;
-  const { item, field } = raw;
-  if (typeof item !== "string" || !item || item.length > MAX_EDIT_LENGTH) {
-    return void 0;
-  }
-  if (typeof field !== "string" || !field || field.length > MAX_EDIT_LENGTH) {
-    return void 0;
-  }
-  return { item, field };
-}
-
 // src/core/live-preview/normalize-query.ts
-var debug2 = createScopedLogger("live-preview:normalize");
+var debug = createScopedLogger("live-preview:normalize");
 var MAX_LOG_ENTRIES = 500;
 var MAX_LOG_SOURCE_LENGTH = 1e6;
-var INDEX_SEGMENT2 = /^\d+$/;
-var FORBIDDEN_SEGMENTS2 = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
+var INDEX_SEGMENT = /^\d+$/;
+var FORBIDDEN_SEGMENTS = /* @__PURE__ */ new Set(["__proto__", "prototype", "constructor"]);
 var ENVELOPE_KEYS = /* @__PURE__ */ new Set(["data", "errors", "extensions"]);
 function parsePatchLog(raw) {
   let value = raw;
@@ -827,7 +414,7 @@ function applyPatchLog(query, result, log, operationName) {
   try {
     doc = readQueryDocument(query, operationName);
   } catch (error) {
-    debug2.log("could not read the query; applying fields by literal path", {
+    debug.log("could not read the query; applying fields by literal path", {
       error: String(error)
     });
   }
@@ -844,7 +431,7 @@ function applyPatchLog(query, result, log, operationName) {
         }
       }
     } catch (error) {
-      debug2.log("could not apply a change", {
+      debug.log("could not apply a change", {
         itemId: patch.itemId,
         field: patch.field,
         error: String(error)
@@ -860,7 +447,7 @@ function applyPatch(root, index, patch, doc, result) {
   const ownerPaths = index.get(patch.itemId);
   if (!ownerPaths?.length) return root;
   const segments = patch.field.split(".");
-  if (segments.some((s) => !s || FORBIDDEN_SEGMENTS2.has(s))) return root;
+  if (segments.some((s) => !s || FORBIDDEN_SEGMENTS.has(s))) return root;
   const targets = [];
   const plain = /* @__PURE__ */ new Set();
   for (const ownerPath of ownerPaths) {
@@ -874,7 +461,7 @@ function applyPatch(root, index, patch, doc, result) {
     }
   }
   if (!targets.length) {
-    debug2.log("no field in the query matches", {
+    debug.log("no field in the query matches", {
       itemId: patch.itemId,
       field: patch.field
     });
@@ -884,7 +471,7 @@ function applyPatch(root, index, patch, doc, result) {
     for (const target of targets) {
       const pushed = plain.has(target) && typeof patch.value === "string" ? plainTextFromHtml(patch.value) : patch.value;
       let value = keepEditLink(readAtPath(root, target), pushed);
-      if (patch.edit && typeof value === "string" && !vercelStegaSplit2(value).encoded) {
+      if (patch.edit && typeof value === "string" && !vercelStegaSplit(value).encoded) {
         value = editLinksFor(result, patch.edit.item)?.encode(
           value,
           patch.edit.field
@@ -917,7 +504,7 @@ function isEnvelope(value) {
   return Object.keys(value).every((key) => ENVELOPE_KEYS.has(key));
 }
 function toPathSegment(segment) {
-  return INDEX_SEGMENT2.test(segment) ? Number(segment) : segment;
+  return INDEX_SEGMENT.test(segment) ? Number(segment) : segment;
 }
 function typenameOf(node) {
   const typename = node.__typename;
@@ -958,7 +545,7 @@ function resolveTargets(root, doc, ownerPath, segments) {
     }
     const segment = segments[i];
     if (Array.isArray(node)) {
-      if (INDEX_SEGMENT2.test(segment)) {
+      if (INDEX_SEGMENT.test(segment)) {
         const position = Number(segment);
         if (position < node.length) {
           walk(node[position], sel, i + 1, [...path, position]);
@@ -982,7 +569,7 @@ function resolveTargets(root, doc, ownerPath, segments) {
       if (alias?.plain) plain.add(fieldPath);
       let value = record[field.key];
       const next = segments[i + 1];
-      if (value === null && field.selections.length && next !== void 0 && next !== "items" && !INDEX_SEGMENT2.test(next)) {
+      if (value === null && field.selections.length && next !== void 0 && next !== "items" && !INDEX_SEGMENT.test(next)) {
         const typename = resolveTypename(
           doc,
           field.selections,
@@ -1161,7 +748,7 @@ function editLinksFor(result, item) {
   if (!template) return null;
   return {
     encode(text, field) {
-      if (vercelStegaSplit2(text).encoded) return text;
+      if (vercelStegaSplit(text).encoded) return text;
       let href;
       try {
         href = new URL(template.href);
@@ -1187,7 +774,7 @@ function findEditLink(root) {
   const walk = (node) => {
     if (found) return;
     if (typeof node === "string") {
-      if (!vercelStegaSplit2(node).encoded) return;
+      if (!vercelStegaSplit(node).encoded) return;
       try {
         const decoded = vercelStegaDecode(node);
         if (typeof decoded?.origin === "string" && typeof decoded.href === "string" && EDIT_PATH.test(decoded.href)) {
@@ -1207,12 +794,6 @@ function findEditLink(root) {
 }
 
 export {
-  indexSnapshot,
-  patchSnapshot,
-  syncListSnapshot,
-  isLiveFieldChange,
-  parseListEntries,
-  parseEditTarget,
   parsePatchLog,
   normalizeQuery,
   applyPatchLog

package/dist/html-live-DzmEG9wU.d.cts

@@ -0,0 +1,42 @@
+interface HtmlLivePreviewOptions {
+    /**
+     * Replace the `*.prepr.io` editor-origin wildcard with an exact list, as
+     * the toolbar's option of the same name.
+     */
+    allowedEditorOrigins?: string[];
+    /** See the toolbar's `strictMode`. */
+    strictMode?: boolean;
+    /**
+     * Where unsaved changes are applied while the editor types.
+     *
+     * - `'server'` (default): the page is requested again with the changes,
+     *   and the server applies them with `normalizeQuery`.
+     * - `'dom'`: text changes are written straight into the elements whose
+     *   edit links point at the changed field. Needs no server support, so it
+     *   suits any backend (PHP, Ruby, Python). Changes the page cannot show
+     *   this way (images, links, reordered or added blocks) appear on save.
+     *
+     * Every mode renders the stored content again on save.
+     */
+    apply?: 'server' | 'dom';
+}
+interface HtmlLivePreview {
+    stop(): void;
+}
+/**
+ * Live preview for server-rendered pages without a client framework (Astro,
+ * or any HTML-first site): while an editor types, the page is requested
+ * again from the server with the unsaved changes in the request body, and
+ * only the parts of the DOM that changed are updated. On save the page is
+ * requested without changes. The server applies them with `normalizeQuery`;
+ * see `readLiveLogFromRequest`.
+ *
+ * A backend that cannot run `normalizeQuery` passes `apply: 'dom'`: text
+ * changes are then written into the page directly, and the server only
+ * renders the stored content on save.
+ *
+ * A no-op outside the Prepr editor's preview iframe.
+ */
+declare function startHtmlLivePreview(options?: HtmlLivePreviewOptions): HtmlLivePreview;
+
+export { type HtmlLivePreviewOptions as H, type HtmlLivePreview as a, startHtmlLivePreview as s };

package/dist/html-live-DzmEG9wU.d.ts

@@ -0,0 +1,42 @@
+interface HtmlLivePreviewOptions {
+    /**
+     * Replace the `*.prepr.io` editor-origin wildcard with an exact list, as
+     * the toolbar's option of the same name.
+     */
+    allowedEditorOrigins?: string[];
+    /** See the toolbar's `strictMode`. */
+    strictMode?: boolean;
+    /**
+     * Where unsaved changes are applied while the editor types.
+     *
+     * - `'server'` (default): the page is requested again with the changes,
+     *   and the server applies them with `normalizeQuery`.
+     * - `'dom'`: text changes are written straight into the elements whose
+     *   edit links point at the changed field. Needs no server support, so it
+     *   suits any backend (PHP, Ruby, Python). Changes the page cannot show
+     *   this way (images, links, reordered or added blocks) appear on save.
+     *
+     * Every mode renders the stored content again on save.
+     */
+    apply?: 'server' | 'dom';
+}
+interface HtmlLivePreview {
+    stop(): void;
+}
+/**
+ * Live preview for server-rendered pages without a client framework (Astro,
+ * or any HTML-first site): while an editor types, the page is requested
+ * again from the server with the unsaved changes in the request body, and
+ * only the parts of the DOM that changed are updated. On save the page is
+ * requested without changes. The server applies them with `normalizeQuery`;
+ * see `readLiveLogFromRequest`.
+ *
+ * A backend that cannot run `normalizeQuery` passes `apply: 'dom'`: text
+ * changes are then written into the page directly, and the server only
+ * renders the stored content on save.
+ *
+ * A no-op outside the Prepr editor's preview iframe.
+ */
+declare function startHtmlLivePreview(options?: HtmlLivePreviewOptions): HtmlLivePreview;
+
+export { type HtmlLivePreviewOptions as H, type HtmlLivePreview as a, startHtmlLivePreview as s };