@shllg/emend 0.1.0 → 0.2.0

package/dist/publish-worker.mjs

@@ -20256,6 +20256,9 @@ var LIMITS = {
   prefixSuffixChars: 32,
   diffContextLines: 3,
   titleChars: 200,
+  headingsPerDoc: 1024,
+  headingTextChars: 200,
+  headingIdChars: 256,
   diffSideBytes: 1048576,
   markdownDocBytes: 1048576,
   htmlDocBytes: 8388608,
@@ -20422,6 +20425,15 @@ var DeviceView = external_exports.object({
 });
 var DeviceList = external_exports.object({ items: external_exports.array(DeviceView) });
 
+// ../../packages/contract/src/doc.ts
+var DocTitle = external_exports.string().min(1).max(LIMITS.titleChars).refine((title) => /\S/.test(title), "title must not be blank");
+var DocHeading = external_exports.object({
+  level: external_exports.union([external_exports.literal(2), external_exports.literal(3)]),
+  text: external_exports.string().max(LIMITS.headingTextChars),
+  id: external_exports.string().min(1).max(LIMITS.headingIdChars).optional()
+});
+var DocHeadings = external_exports.array(DocHeading).max(LIMITS.headingsPerDoc);
+
 // ../../packages/contract/src/errors.ts
 var ERROR_STATUS = {
   internal: 500,
@@ -20619,7 +20631,11 @@ var PublishManifest = external_exports.object({
       role: external_exports.enum(["diff", "doc"]),
       topic: TopicSlug.optional(),
       source: source.optional(),
+      title: DocTitle.optional(),
       notes: AgentNotes.optional()
+    }).refine((file2) => file2.role === "doc" || file2.title === void 0, {
+      path: ["title"],
+      message: "only doc files have titles"
     }).refine((file2) => file2.role === "diff" || file2.notes === void 0, {
       path: ["notes"],
       message: "only diff files have agent notes"
@@ -20689,6 +20705,7 @@ var ASSET_EXTENSIONS = new Set(
 var Sha256 = external_exports.string().length(64).regex(/^[0-9a-f]{64}$/);
 var PublishFile = external_exports.object({
   path: FilePath,
+  title: DocTitle.optional(),
   oldPath: FilePath.nullable(),
   role: FileRole,
   status: FileStatus.optional(),
@@ -20699,6 +20716,9 @@ var PublishFile = external_exports.object({
   parent: FilePath.optional(),
   assets: external_exports.array(FilePath).max(LIMITS.filesPerRevision).optional(),
   notes: AgentNotes.optional()
+}).refine((file2) => file2.role === "doc" || file2.title === void 0, {
+  path: ["title"],
+  message: "only doc files have titles"
 }).refine((file2) => file2.role === "diff" || file2.notes === void 0, {
   path: ["notes"],
   message: "only diff files have agent notes"
@@ -20896,6 +20916,7 @@ var ImportRows = external_exports.object({
       oldBlob: Sha256.nullable(),
       newBlob: Sha256.nullable(),
       renderedBlob: Sha256.nullable(),
+      title: DocTitle.nullable().optional(),
       flag: FileFlag.nullable(),
       parentDocId: id.nullable()
     })
@@ -21202,12 +21223,20 @@ var RevisionView = external_exports.object({
       external_exports.object({
         path: FilePath,
         kind: external_exports.literal("markdown"),
+        title: DocTitle.optional(),
+        headings: DocHeadings.optional(),
         blocks: external_exports.array(RenderedBlock).max(LIMITS.blocksPerRevision).refine(
           (blocks) => renderedBytes(blocks) <= LIMITS.renderedBytesPerRevision,
           "doc exceeds the rendered JSON byte budget"
         )
       }),
-      external_exports.object({ path: FilePath, kind: external_exports.literal("html"), contentUrl })
+      external_exports.object({
+        path: FilePath,
+        kind: external_exports.literal("html"),
+        contentUrl,
+        title: DocTitle.optional(),
+        headings: DocHeadings.optional()
+      })
     ])
   ).max(LIMITS.filesPerRevision),
   threads: external_exports.array(ThreadView),
@@ -21218,6 +21247,8 @@ var RevisionView = external_exports.object({
 ).refine((view) => {
   let bytes = renderedBytes(view.writeup);
   for (const doc of view.docs) {
+    if (doc.title !== void 0 || doc.headings !== void 0)
+      bytes += renderedBytes({ title: doc.title, headings: doc.headings });
     if (doc.kind === "markdown" && doc.blocks.length) bytes += renderedBytes(doc.blocks);
     if (bytes > LIMITS.renderedBytesPerRevision) return false;
   }
@@ -31951,32 +31982,6 @@ function visualizeCharacterCode(charCode) {
   return "0x" + charCode.toString(16).toUpperCase();
 }
 
-// ../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/lib/index.js
-function toString(node3) {
-  if ("children" in node3) {
-    return all2(node3);
-  }
-  return "value" in node3 ? node3.value : "";
-}
-function one2(node3) {
-  if (node3.type === "text") {
-    return node3.value;
-  }
-  return "children" in node3 ? all2(node3) : "";
-}
-function all2(node3) {
-  let index2 = -1;
-  const result = [];
-  while (++index2 < node3.children.length) {
-    result[index2] = one2(node3.children[index2]);
-  }
-  return result.join("");
-}
-
-// ../../packages/core/src/doc-title.ts
-var TITLE_PREFIX_BYTES = 64 * 1024;
-var TITLE_CANDIDATE_CHARS = LIMITS.titleChars * 4;
-
 // ../../packages/core/src/render/normalize.ts
 function normalizeText(text10) {
   return text10.normalize("NFC").replace(/[\p{White_Space}]+/gu, " ").trim();
@@ -32042,10 +32047,10 @@ var omitted = /* @__PURE__ */ new Set(["script", "style", "template", "noscript"
 var HTML_NESTING_LIMIT = 512;
 var HtmlNestingLimitError = class extends Error {
 };
-function docText(html7) {
+function parseDocHtml(html7) {
   try {
     let openElements = 0;
-    const tree = parse5(html7, {
+    return parse5(html7, {
       scriptingEnabled: true,
       treeAdapter: {
         ...defaultTreeAdapter,
@@ -32057,21 +32062,47 @@ function docText(html7) {
         }
       }
     });
-    const document3 = tree.childNodes.find((node3) => defaultTreeAdapter.isElementNode(node3) && node3.tagName === "html");
-    const body3 = document3 && defaultTreeAdapter.isElementNode(document3) ? document3.childNodes.find((node3) => defaultTreeAdapter.isElementNode(node3) && node3.tagName === "body") : void 0;
-    if (!body3) return "";
-    const parts = [];
-    const pending = [body3];
-    for (let node3 = pending.pop(); node3 !== void 0; node3 = pending.pop()) {
-      if (defaultTreeAdapter.isTextNode(node3)) parts.push(node3.value);
-      else if (defaultTreeAdapter.isElementNode(node3) && !omitted.has(node3.tagName)) {
-        for (let index2 = node3.childNodes.length - 1; index2 >= 0; index2--) {
-          const child = node3.childNodes[index2];
-          if (child) pending.push(child);
-        }
-      }
+  } catch {
+    return null;
+  }
+}
+function htmlPart(tree, tag) {
+  const root7 = tree.childNodes.find((node3) => defaultTreeAdapter.isElementNode(node3) && node3.tagName === "html");
+  return root7 && defaultTreeAdapter.isElementNode(root7) ? root7.childNodes.find((node3) => defaultTreeAdapter.isElementNode(node3) && node3.tagName === tag) : void 0;
+}
+function* docNodes(root7, nodeLimit = Infinity) {
+  const pending = [[root7][Symbol.iterator]()];
+  while (pending.length) {
+    const next2 = pending.at(-1)?.next();
+    if (!next2 || next2.done) {
+      pending.pop();
+      continue;
     }
-    return normalizeText(parts.join(""));
+    if (nodeLimit-- <= 0) return;
+    const node3 = next2.value;
+    if (defaultTreeAdapter.isElementNode(node3) && omitted.has(node3.tagName)) continue;
+    yield node3;
+    if (defaultTreeAdapter.isElementNode(node3)) pending.push(node3.childNodes[Symbol.iterator]());
+  }
+}
+function nodeText(root7, limit = Infinity) {
+  const parts = [];
+  if (limit <= 0) return "";
+  for (const node3 of docNodes(root7, 8 * limit)) {
+    if (!defaultTreeAdapter.isTextNode(node3)) continue;
+    const part = node3.value.slice(0, limit);
+    parts.push(part);
+    limit -= part.length;
+    if (limit <= 0) break;
+  }
+  return parts.join("");
+}
+function docText(html7) {
+  try {
+    const tree = parseDocHtml(html7);
+    if (!tree) return null;
+    const body3 = htmlPart(tree, "body");
+    return body3 ? normalizeText(nodeText(body3)) : "";
   } catch {
     return null;
   }
@@ -32086,890 +32117,302 @@ function placeHtmlSpan(text10, target) {
   return { status: "unplaced", reason: candidates.length > 1 ? "ambiguous" : "block-gone" };
 }
 
-// ../../node_modules/.pnpm/diff@9.0.0/node_modules/diff/libesm/diff/base.js
-var Diff = class {
-  diff(oldStr, newStr, options = {}) {
-    let callback;
-    if (typeof options === "function") {
-      callback = options;
-      options = {};
-    } else if ("callback" in options) {
-      callback = options.callback;
-    }
-    const oldString = this.castInput(oldStr, options);
-    const newString = this.castInput(newStr, options);
-    const oldTokens = this.removeEmpty(this.tokenize(oldString, options));
-    const newTokens = this.removeEmpty(this.tokenize(newString, options));
-    return this.diffWithOptionsObj(oldTokens, newTokens, options, callback);
+// ../../node_modules/.pnpm/@shikijs+types@4.5.0/node_modules/@shikijs/types/dist/index.mjs
+var ShikiError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "ShikiError";
   }
-  diffWithOptionsObj(oldTokens, newTokens, options, callback) {
-    var _a4;
-    const done = (value) => {
-      value = this.postProcess(value, options);
-      if (callback) {
-        setTimeout(function() {
-          callback(value);
-        }, 0);
-        return void 0;
-      } else {
-        return value;
-      }
-    };
-    const newLen = newTokens.length, oldLen = oldTokens.length;
-    let editLength = 1;
-    let maxEditLength = newLen + oldLen;
-    if (options.maxEditLength != null) {
-      maxEditLength = Math.min(maxEditLength, options.maxEditLength);
+};
+
+// ../../node_modules/.pnpm/@shikijs+vscode-textmate@10.1.0/node_modules/@shikijs/vscode-textmate/dist/index.js
+function clone2(something) {
+  return doClone(something);
+}
+function doClone(something) {
+  if (Array.isArray(something)) {
+    return cloneArray(something);
+  }
+  if (something instanceof RegExp) {
+    return something;
+  }
+  if (typeof something === "object") {
+    return cloneObj(something);
+  }
+  return something;
+}
+function cloneArray(arr) {
+  let r4 = [];
+  for (let i2 = 0, len = arr.length; i2 < len; i2++) {
+    r4[i2] = doClone(arr[i2]);
+  }
+  return r4;
+}
+function cloneObj(obj) {
+  let r4 = {};
+  for (let key2 in obj) {
+    r4[key2] = doClone(obj[key2]);
+  }
+  return r4;
+}
+function mergeObjects(target, ...sources) {
+  sources.forEach((source2) => {
+    for (let key2 in source2) {
+      target[key2] = source2[key2];
     }
-    const maxExecutionTime = (_a4 = options.timeout) !== null && _a4 !== void 0 ? _a4 : Infinity;
-    const abortAfterTimestamp = Date.now() + maxExecutionTime;
-    const bestPath = [{ oldPos: -1, lastComponent: void 0 }];
-    let newPos = this.extractCommon(bestPath[0], newTokens, oldTokens, 0, options);
-    if (bestPath[0].oldPos + 1 >= oldLen && newPos + 1 >= newLen) {
-      return done(this.buildValues(bestPath[0].lastComponent, newTokens, oldTokens));
+  });
+  return target;
+}
+function basename(path2) {
+  const idx = ~path2.lastIndexOf("/") || ~path2.lastIndexOf("\\");
+  if (idx === 0) {
+    return path2;
+  } else if (~idx === path2.length - 1) {
+    return basename(path2.substring(0, path2.length - 1));
+  } else {
+    return path2.substr(~idx + 1);
+  }
+}
+var CAPTURING_REGEX_SOURCE = /\$(\d+)|\${(\d+):\/(downcase|upcase)}/g;
+var RegexSource = class {
+  static hasCaptures(regexSource) {
+    if (regexSource === null) {
+      return false;
     }
-    let minDiagonalToConsider = -Infinity, maxDiagonalToConsider = Infinity;
-    const execEditLength = () => {
-      for (let diagonalPath = Math.max(minDiagonalToConsider, -editLength); diagonalPath <= Math.min(maxDiagonalToConsider, editLength); diagonalPath += 2) {
-        let basePath;
-        const removePath = bestPath[diagonalPath - 1], addPath = bestPath[diagonalPath + 1];
-        if (removePath) {
-          bestPath[diagonalPath - 1] = void 0;
-        }
-        let canAdd = false;
-        if (addPath) {
-          const addPathNewPos = addPath.oldPos - diagonalPath;
-          canAdd = addPath && 0 <= addPathNewPos && addPathNewPos < newLen;
-        }
-        const canRemove = removePath && removePath.oldPos + 1 < oldLen;
-        if (!canAdd && !canRemove) {
-          bestPath[diagonalPath] = void 0;
-          continue;
-        }
-        if (!canRemove || canAdd && removePath.oldPos < addPath.oldPos) {
-          basePath = this.addToPath(addPath, true, false, 0, options);
-        } else {
-          basePath = this.addToPath(removePath, false, true, 1, options);
+    CAPTURING_REGEX_SOURCE.lastIndex = 0;
+    return CAPTURING_REGEX_SOURCE.test(regexSource);
+  }
+  static replaceCaptures(regexSource, captureSource, captureIndices) {
+    return regexSource.replace(CAPTURING_REGEX_SOURCE, (match, index2, commandIndex, command) => {
+      let capture = captureIndices[parseInt(index2 || commandIndex, 10)];
+      if (capture) {
+        let result = captureSource.substring(capture.start, capture.end);
+        while (result[0] === ".") {
+          result = result.substring(1);
         }
-        newPos = this.extractCommon(basePath, newTokens, oldTokens, diagonalPath, options);
-        if (basePath.oldPos + 1 >= oldLen && newPos + 1 >= newLen) {
-          return done(this.buildValues(basePath.lastComponent, newTokens, oldTokens)) || true;
-        } else {
-          bestPath[diagonalPath] = basePath;
-          if (basePath.oldPos + 1 >= oldLen) {
-            maxDiagonalToConsider = Math.min(maxDiagonalToConsider, diagonalPath - 1);
-          }
-          if (newPos + 1 >= newLen) {
-            minDiagonalToConsider = Math.max(minDiagonalToConsider, diagonalPath + 1);
-          }
+        switch (command) {
+          case "downcase":
+            return result.toLowerCase();
+          case "upcase":
+            return result.toUpperCase();
+          default:
+            return result;
         }
+      } else {
+        return match;
       }
-      editLength++;
-    };
-    if (callback) {
-      (function exec() {
-        setTimeout(function() {
-          if (editLength > maxEditLength || Date.now() > abortAfterTimestamp) {
-            return callback(void 0);
-          }
-          if (!execEditLength()) {
-            exec();
-          }
-        }, 0);
-      })();
-    } else {
-      while (editLength <= maxEditLength && Date.now() <= abortAfterTimestamp) {
-        const ret = execEditLength();
-        if (ret) {
-          return ret;
-        }
+    });
+  }
+};
+function strcmp(a2, b3) {
+  if (a2 < b3) {
+    return -1;
+  }
+  if (a2 > b3) {
+    return 1;
+  }
+  return 0;
+}
+function strArrCmp(a2, b3) {
+  if (a2 === null && b3 === null) {
+    return 0;
+  }
+  if (!a2) {
+    return -1;
+  }
+  if (!b3) {
+    return 1;
+  }
+  let len1 = a2.length;
+  let len2 = b3.length;
+  if (len1 === len2) {
+    for (let i2 = 0; i2 < len1; i2++) {
+      let res = strcmp(a2[i2], b3[i2]);
+      if (res !== 0) {
+        return res;
       }
     }
+    return 0;
   }
-  addToPath(path2, added, removed, oldPosInc, options) {
-    const last = path2.lastComponent;
-    if (last && !options.oneChangePerToken && last.added === added && last.removed === removed) {
-      return {
-        oldPos: path2.oldPos + oldPosInc,
-        lastComponent: { count: last.count + 1, added, removed, previousComponent: last.previousComponent }
-      };
-    } else {
-      return {
-        oldPos: path2.oldPos + oldPosInc,
-        lastComponent: { count: 1, added, removed, previousComponent: last }
-      };
+  return len1 - len2;
+}
+function isValidHexColor(hex3) {
+  if (/^#[0-9a-f]{6}$/i.test(hex3)) {
+    return true;
+  }
+  if (/^#[0-9a-f]{8}$/i.test(hex3)) {
+    return true;
+  }
+  if (/^#[0-9a-f]{3}$/i.test(hex3)) {
+    return true;
+  }
+  if (/^#[0-9a-f]{4}$/i.test(hex3)) {
+    return true;
+  }
+  return false;
+}
+function escapeRegExpCharacters(value) {
+  return value.replace(/[\-\\\{\}\*\+\?\|\^\$\.\,\[\]\(\)\#\s]/g, "\\$&");
+}
+var CachedFn = class {
+  constructor(fn) {
+    this.fn = fn;
+  }
+  fn;
+  cache = /* @__PURE__ */ new Map();
+  get(key2) {
+    if (this.cache.has(key2)) {
+      return this.cache.get(key2);
     }
+    const value = this.fn(key2);
+    this.cache.set(key2, value);
+    return value;
   }
-  extractCommon(basePath, newTokens, oldTokens, diagonalPath, options) {
-    const newLen = newTokens.length, oldLen = oldTokens.length;
-    let oldPos = basePath.oldPos, newPos = oldPos - diagonalPath, commonCount = 0;
-    while (newPos + 1 < newLen && oldPos + 1 < oldLen && this.equals(oldTokens[oldPos + 1], newTokens[newPos + 1], options)) {
-      newPos++;
-      oldPos++;
-      commonCount++;
-      if (options.oneChangePerToken) {
-        basePath.lastComponent = { count: 1, previousComponent: basePath.lastComponent, added: false, removed: false };
-      }
+};
+var Theme = class {
+  constructor(_colorMap, _defaults, _root) {
+    this._colorMap = _colorMap;
+    this._defaults = _defaults;
+    this._root = _root;
+  }
+  _colorMap;
+  _defaults;
+  _root;
+  static createFromRawTheme(source2, colorMap) {
+    return this.createFromParsedTheme(parseTheme(source2), colorMap);
+  }
+  static createFromParsedTheme(source2, colorMap) {
+    return resolveParsedThemeRules(source2, colorMap);
+  }
+  _cachedMatchRoot = new CachedFn(
+    (scopeName) => this._root.match(scopeName)
+  );
+  getColorMap() {
+    return this._colorMap.getColorMap();
+  }
+  getDefaults() {
+    return this._defaults;
+  }
+  match(scopePath) {
+    if (scopePath === null) {
+      return this._defaults;
     }
-    if (commonCount && !options.oneChangePerToken) {
-      basePath.lastComponent = { count: commonCount, previousComponent: basePath.lastComponent, added: false, removed: false };
+    const scopeName = scopePath.scopeName;
+    const matchingTrieElements = this._cachedMatchRoot.get(scopeName);
+    const effectiveRule = matchingTrieElements.find(
+      (v2) => _scopePathMatchesParentScopes(scopePath.parent, v2.parentScopes)
+    );
+    if (!effectiveRule) {
+      return null;
     }
-    basePath.oldPos = oldPos;
-    return newPos;
+    return new StyleAttributes(
+      effectiveRule.fontStyle,
+      effectiveRule.foreground,
+      effectiveRule.background
+    );
   }
-  equals(left, right, options) {
-    if (options.comparator) {
-      return options.comparator(left, right);
-    } else {
-      return left === right || !!options.ignoreCase && left.toLowerCase() === right.toLowerCase();
-    }
+};
+var ScopeStack = class _ScopeStack {
+  constructor(parent, scopeName) {
+    this.parent = parent;
+    this.scopeName = scopeName;
   }
-  removeEmpty(array2) {
-    const ret = [];
-    for (let i2 = 0; i2 < array2.length; i2++) {
-      if (array2[i2]) {
-        ret.push(array2[i2]);
-      }
+  parent;
+  scopeName;
+  static push(path2, scopeNames) {
+    for (const name of scopeNames) {
+      path2 = new _ScopeStack(path2, name);
     }
-    return ret;
-  }
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  castInput(value, options) {
-    return value;
+    return path2;
   }
-  // eslint-disable-next-line @typescript-eslint/no-unused-vars
-  tokenize(value, options) {
-    return Array.from(value);
+  static from(...segments) {
+    let result = null;
+    for (let i2 = 0; i2 < segments.length; i2++) {
+      result = new _ScopeStack(result, segments[i2]);
+    }
+    return result;
   }
-  join(chars) {
-    return chars.join("");
+  push(scopeName) {
+    return new _ScopeStack(this, scopeName);
   }
-  postProcess(changeObjects, options) {
-    return changeObjects;
+  getSegments() {
+    let item = this;
+    const result = [];
+    while (item) {
+      result.push(item.scopeName);
+      item = item.parent;
+    }
+    result.reverse();
+    return result;
   }
-  get useLongestToken() {
-    return false;
+  toString() {
+    return this.getSegments().join(" ");
   }
-  buildValues(lastComponent, newTokens, oldTokens) {
-    const components = [];
-    let nextComponent;
-    while (lastComponent) {
-      components.push(lastComponent);
-      nextComponent = lastComponent.previousComponent;
-      delete lastComponent.previousComponent;
-      lastComponent = nextComponent;
+  extends(other) {
+    if (this === other) {
+      return true;
     }
-    components.reverse();
-    const componentLen = components.length;
-    let componentPos = 0, newPos = 0, oldPos = 0;
-    for (; componentPos < componentLen; componentPos++) {
-      const component = components[componentPos];
-      if (!component.removed) {
-        if (!component.added && this.useLongestToken) {
-          let value = newTokens.slice(newPos, newPos + component.count);
-          value = value.map(function(value2, i2) {
-            const oldValue = oldTokens[oldPos + i2];
-            return oldValue.length > value2.length ? oldValue : value2;
-          });
-          component.value = this.join(value);
-        } else {
-          component.value = this.join(newTokens.slice(newPos, newPos + component.count));
-        }
-        newPos += component.count;
-        if (!component.added) {
-          oldPos += component.count;
-        }
-      } else {
-        component.value = this.join(oldTokens.slice(oldPos, oldPos + component.count));
-        oldPos += component.count;
-      }
+    if (this.parent === null) {
+      return false;
     }
-    return components;
+    return this.parent.extends(other);
+  }
+  getExtensionIfDefined(base2) {
+    const result = [];
+    let item = this;
+    while (item && item !== base2) {
+      result.push(item.scopeName);
+      item = item.parent;
+    }
+    return item === base2 ? result.reverse() : void 0;
   }
 };
-
-// ../../node_modules/.pnpm/diff@9.0.0/node_modules/diff/libesm/diff/line.js
-var LineDiff = class extends Diff {
-  constructor() {
-    super(...arguments);
-    this.tokenize = tokenize;
+function _scopePathMatchesParentScopes(scopePath, parentScopes) {
+  if (parentScopes.length === 0) {
+    return true;
   }
-  equals(left, right, options) {
-    if (options.ignoreWhitespace) {
-      if (!options.newlineIsToken || !left.includes("\n")) {
-        left = left.trim();
-      }
-      if (!options.newlineIsToken || !right.includes("\n")) {
-        right = right.trim();
+  for (let index2 = 0; index2 < parentScopes.length; index2++) {
+    let scopePattern = parentScopes[index2];
+    let scopeMustMatch = false;
+    if (scopePattern === ">") {
+      if (index2 === parentScopes.length - 1) {
+        return false;
       }
-    } else if (options.ignoreNewlineAtEof && !options.newlineIsToken) {
-      if (left.endsWith("\n")) {
-        left = left.slice(0, -1);
+      scopePattern = parentScopes[++index2];
+      scopeMustMatch = true;
+    }
+    while (scopePath) {
+      if (_matchesScope(scopePath.scopeName, scopePattern)) {
+        break;
       }
-      if (right.endsWith("\n")) {
-        right = right.slice(0, -1);
+      if (scopeMustMatch) {
+        return false;
       }
+      scopePath = scopePath.parent;
     }
-    return super.equals(left, right, options);
+    if (!scopePath) {
+      return false;
+    }
+    scopePath = scopePath.parent;
   }
-};
-var lineDiff = new LineDiff();
-function diffLines(oldStr, newStr, options) {
-  return lineDiff.diff(oldStr, newStr, options);
+  return true;
 }
-function tokenize(value, options) {
-  if (options.stripTrailingCr) {
-    value = value.replace(/\r\n/g, "\n");
+function _matchesScope(scopeName, scopePattern) {
+  return scopePattern === scopeName || scopeName.startsWith(scopePattern) && scopeName[scopePattern.length] === ".";
+}
+var StyleAttributes = class {
+  constructor(fontStyle, foregroundId, backgroundId) {
+    this.fontStyle = fontStyle;
+    this.foregroundId = foregroundId;
+    this.backgroundId = backgroundId;
   }
-  const retLines = [], linesAndNewlines = value.split(/(\n|\r\n)/);
-  if (!linesAndNewlines[linesAndNewlines.length - 1]) {
-    linesAndNewlines.pop();
-  }
-  for (let i2 = 0; i2 < linesAndNewlines.length; i2++) {
-    const line = linesAndNewlines[i2];
-    if (i2 % 2 && !options.newlineIsToken) {
-      retLines[retLines.length - 1] += line;
-    } else {
-      retLines.push(line);
-    }
-  }
-  return retLines;
-}
-
-// ../../packages/core/src/place/linemap.ts
-var LINE_MAP_MAX_EDIT_LENGTH = 256;
-function splitLines(text10) {
-  if (text10 === "") return [];
-  const lines = text10.replace(/\r\n/g, "\n").split("\n");
-  if (lines.at(-1) === "") lines.pop();
-  return lines;
-}
-function lineMap(from, to) {
-  const mapped = [];
-  let oldLine = 1;
-  let newLine = 1;
-  const changes = diffLines(from, to, {
-    stripTrailingCr: true,
-    ignoreNewlineAtEof: true,
-    maxEditLength: LINE_MAP_MAX_EDIT_LENGTH
-  });
-  if (changes === void 0) return () => null;
-  for (const change of changes) {
-    if (change.added) newLine += change.count;
-    else {
-      for (let index2 = 0; index2 < change.count; index2++) {
-        mapped[oldLine++] = change.removed ? null : newLine++;
-      }
-    }
-  }
-  return (line) => Number.isInteger(line) && line > 0 ? mapped[line] ?? null : null;
-}
-
-// ../../packages/core/src/place/lines.ts
-function matches(lines, start, quote) {
-  return start >= 0 && start + quote.length <= lines.length && quote.every((line, index2) => lines[start + index2] === line);
-}
-function placeLines(target, last, next2) {
-  if (next2 === null) return { status: "unplaced", reason: "file-gone" };
-  const hashKey = target.side === "old" ? "oldHash" : "newHash";
-  const textKey = target.side === "old" ? "oldText" : "newText";
-  const previousText = last.sides[textKey];
-  const nextText = next2[textKey];
-  if (nextText === void 0) return { status: "unplaced", reason: "file-gone" };
-  const lines = splitLines(nextText);
-  const placed = (start2) => ({
-    status: "placed",
-    location: { kind: "lines", path: target.path, side: target.side, start: start2, end: start2 + target.lines.length - 1 }
-  });
-  const validRange = last.start > 0 && last.end - last.start + 1 === target.lines.length;
-  if (validRange && last.sides[hashKey] !== void 0 && last.sides[hashKey] === next2[hashKey] && matches(lines, last.start - 1, target.lines))
-    return placed(last.start);
-  if (validRange && previousText !== void 0) {
-    const map4 = lineMap(previousText, nextText);
-    const start2 = map4(last.start);
-    if (start2 !== null && target.lines.every((_3, index2) => map4(last.start + index2) === start2 + index2) && matches(lines, start2 - 1, target.lines))
-      return placed(start2);
-  }
-  const sequence = [...target.before, ...target.lines, ...target.after];
-  const found = firstTwoMatches(lines, sequence);
-  if (found.length > 1) return { status: "unplaced", reason: "ambiguous" };
-  const start = found[0];
-  return start === void 0 ? { status: "unplaced", reason: "lines-gone" } : placed(start + target.before.length + 1);
-}
-
-// ../../packages/core/src/place/place.ts
-function placeThread(target, ctx) {
-  const last = ctx.last?.location;
-  switch (target.kind) {
-    case "review":
-      return { status: "placed", location: { kind: "review" } };
-    case "topic":
-      return ctx.topics.has(target.slug) ? { status: "placed", location: { kind: "topic", slug: target.slug } } : { status: "unplaced", reason: "topic-gone" };
-    case "writeup-span":
-      return placeSpan(ctx.writeup, {
-        ...target,
-        blockId: last?.kind === "writeup-span" ? last.blockId : target.blockId
-      });
-    default: {
-      const previousPath = last?.kind === target.kind && "path" in last ? last.path : target.path;
-      const renamed = ctx.renamedFrom.get(previousPath);
-      if (renamed === null) return { status: "unplaced", reason: "file-gone" };
-      const path2 = renamed ?? previousPath;
-      if (target.kind === "file") {
-        return ctx.files.has(path2) ? { status: "placed", location: { kind: "file", path: path2 } } : { status: "unplaced", reason: "file-gone" };
-      }
-      if (target.kind === "lines") {
-        const previous3 = last?.kind === "lines" && last.side === target.side ? last : target;
-        return placeLines(
-          { ...target, path: path2 },
-          {
-            start: previous3.start,
-            end: previous3.end,
-            sides: ctx.last?.sides ?? {}
-          },
-          ctx.files.get(path2) ?? null
-        );
-      }
-      const doc = ctx.docs.get(path2);
-      if (!doc) return { status: "unplaced", reason: "file-gone" };
-      if (target.kind === "html-span") {
-        return doc.kind === "html" ? placeHtmlSpan(doc.text, { ...target, path: path2 }) : { status: "unplaced", reason: "block-gone" };
-      }
-      return doc.kind === "markdown" ? placeSpan(doc.blocks, { ...target, path: path2, blockId: last?.kind === "doc-span" ? last.blockId : target.blockId }) : { status: "unplaced", reason: "block-gone" };
-    }
-  }
-}
-
-// ../../packages/core/src/place/renames.ts
-function composeRenames(steps) {
-  const composed = /* @__PURE__ */ new Map();
-  for (let index2 = steps.length - 1; index2 >= 0; index2--) {
-    const step = steps[index2];
-    if (!step) continue;
-    const pending = [];
-    for (const [from, to] of step) {
-      const next2 = to === null ? null : composed.get(to);
-      pending.push([from, next2 === void 0 ? to : next2]);
-    }
-    for (const [from, to] of pending) composed.set(from, to);
-  }
-  return composed;
-}
-
-// ../../packages/core/src/render/hash.ts
-async function blockHash(text10) {
-  const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(text10));
-  return Array.from(new Uint8Array(digest).subarray(0, 4), (byte) => byte.toString(16).padStart(2, "0")).join("");
-}
-
-// ../../packages/core/src/render/blocks.ts
-var sectionBlockId = (section, identity) => `${section}-${identity}`;
-function resectionBlocks(blocks, section) {
-  return blocks.map((block) => ({
-    ...block,
-    section,
-    id: sectionBlockId(section, block.id.slice(block.section.length + 1))
-  }));
-}
-function renderData(element6) {
-  element6.data ??= { position: {} };
-  return element6.data;
-}
-function blockText(html7) {
-  return toString(fromHtml(html7, { fragment: true }));
-}
-function visitElements(node3, visit3) {
-  if (node3.type === "element") visit3(node3);
-  if ("children" in node3) for (const child of node3.children) visitElements(child, visit3);
-}
-var MAX_BLOCK_DEPTH = 64;
-var blockTags = /* @__PURE__ */ new Set([
-  "blockquote",
-  "dd",
-  "details",
-  "div",
-  "dl",
-  "dt",
-  "h1",
-  "h2",
-  "h3",
-  "h4",
-  "h5",
-  "h6",
-  "hr",
-  "li",
-  "ol",
-  "p",
-  "pre",
-  "section",
-  "summary",
-  "table",
-  "ul"
-]);
-function hasBlockChildren(node3) {
-  return "children" in node3 && node3.children.some((child) => child.type === "element" && (blockTags.has(child.tagName) || hasBlockChildren(child)));
-}
-function isDiagram(node3) {
-  return node3.type === "element" && renderData(node3).emendDiagram !== void 0;
-}
-function hasDiagram(node3) {
-  return isDiagram(node3) || "children" in node3 && node3.children.some(hasDiagram);
-}
-function hasContent(nodes) {
-  return nodes.some((node3) => node3.type === "element" || node3.type === "text" && normalizeText(node3.value) !== "");
-}
-function* divideAtDiagrams(node3) {
-  if (isDiagram(node3) || !hasDiagram(node3)) {
-    yield node3;
-    return;
-  }
-  let children2 = [];
-  for (const child of node3.children) {
-    if (child.type !== "element") {
-      children2.push(child);
-      continue;
-    }
-    for (const piece of divideAtDiagrams(child)) {
-      if (isDiagram(piece)) {
-        if (hasContent(children2)) yield { ...node3, children: children2 };
-        children2 = [];
-        yield piece;
-      } else children2.push(piece);
-    }
-  }
-  if (hasContent(children2)) yield { ...node3, children: children2 };
-}
-function* atomicBlock(kind, node3) {
-  for (const piece of divideAtDiagrams(node3)) {
-    const source2 = renderData(piece).emendDiagram;
-    yield source2 === void 0 ? { kind, node: piece } : { kind: "diagram", node: piece, source: source2 };
-  }
-}
-function flattenRoots(node3) {
-  if (node3.type === "root") {
-    return node3.children.flatMap(flattenRoots);
-  }
-  if (node3.type === "element") {
-    node3.children = node3.children.flatMap(flattenRoots).filter((child) => child.type !== "doctype");
-  }
-  return [node3];
-}
-function* splitChildren(children2, depth) {
-  let inline = [];
-  for (const child of children2) {
-    if (child.type === "element" && (blockTags.has(child.tagName) || hasBlockChildren(child) || hasDiagram(child))) {
-      if (hasContent(inline)) yield { kind: "paragraph", node: { type: "root", children: inline } };
-      inline = [];
-      yield* splitBlocks(child, depth);
-    } else if (child.type !== "comment" && child.type !== "doctype") inline.push(child);
-  }
-  if (hasContent(inline)) yield { kind: "paragraph", node: { type: "root", children: inline } };
-}
-function blockKind(tag) {
-  if (/^h[1-6]$/.test(tag)) return "heading";
-  if (tag === "li" || tag === "dt" || tag === "dd") return "item";
-  if (tag === "pre") return "code";
-  if (tag === "table") return "table";
-  if (tag === "blockquote") return "quote";
-  return "paragraph";
-}
-function* strayListContent(children2, depth) {
-  for (const fragment2 of splitChildren(children2, depth)) {
-    yield fragment2.kind === "diagram" ? fragment2 : { ...fragment2, kind: "paragraph" };
-  }
-}
-function* splitBlocks(node3, depth = 0) {
-  if (node3.type === "root") {
-    yield* splitChildren(node3.children, depth + 1);
-    return;
-  }
-  if (node3.type !== "element") return;
-  const source2 = renderData(node3).emendDiagram;
-  if (source2 !== void 0) {
-    yield { kind: "diagram", node: node3, source: source2 };
-    return;
-  }
-  const tag = node3.tagName;
-  if (tag === "hr") return;
-  const kind = blockKind(tag);
-  if (depth >= MAX_BLOCK_DEPTH) {
-    yield* atomicBlock(kind, node3);
-    return;
-  }
-  if (tag === "ul" || tag === "ol") {
-    let ordinal = typeof node3.properties.start === "number" ? node3.properties.start : 1;
-    let stray = [];
-    for (const child of node3.children) {
-      if (child.type !== "element" || child.tagName !== "li") {
-        stray.push(child);
-        continue;
-      }
-      yield* strayListContent(stray, depth + 1);
-      stray = [];
-      const properties2 = { ...node3.properties };
-      if (tag === "ol") properties2.start = ordinal++;
-      for (const fragment2 of atomicBlock("item", child)) {
-        if (fragment2.kind === "diagram") yield fragment2;
-        else if (fragment2.node.type === "element") {
-          yield { ...fragment2, node: { ...node3, properties: properties2, children: [fragment2.node] } };
-        }
-      }
-    }
-    yield* strayListContent(stray, depth + 1);
-    return;
-  }
-  if (kind === "paragraph" && hasBlockChildren(node3)) {
-    yield* splitChildren(node3.children, depth + 1);
-    return;
-  }
-  yield* atomicBlock(kind, node3);
-}
-function identityText(node3) {
-  if (node3.type === "element" && renderData(node3).emendFootnoteMarker) return "";
-  if (node3.type === "element" && renderData(node3).emendMedia !== void 0)
-    return `\0media${renderData(node3).emendMedia}`;
-  if (node3.type === "text") return node3.value;
-  return "children" in node3 ? node3.children.map(identityText).join("") : "";
-}
-function stringifyBlock(node3, stringify4) {
-  const parts = [];
-  const pending = [node3];
-  for (let next2 = pending.pop(); next2 !== void 0; next2 = pending.pop()) {
-    if (typeof next2 === "string") parts.push(next2);
-    else if (next2.type === "root") {
-      for (const child of next2.children.toReversed()) pending.push(child);
-    } else if (next2.type === "element" && next2.children.length > 0) {
-      const shell = stringify4({ ...next2, children: [] });
-      const closing2 = `</${next2.tagName}>`;
-      if (shell.endsWith(closing2)) {
-        parts.push(shell.slice(0, -closing2.length));
-        pending.push(closing2);
-      } else parts.push(shell);
-      for (const child of next2.children.toReversed()) pending.push(child);
-    } else parts.push(stringify4(next2));
-  }
-  return parts.join("");
-}
-async function blocksFromTree(tree, section, stringify4) {
-  const blocks = [];
-  const occurrences = /* @__PURE__ */ new Map();
-  const append = async ({ kind, node: node3, source: source2 }) => {
-    const html7 = kind === "diagram" ? "" : stringifyBlock(node3, stringify4);
-    const text10 = source2 ?? blockText(html7);
-    if (kind !== "diagram" && normalizeText(text10) === "") return;
-    const hash2 = await blockHash(normalizeText(source2 ?? identityText(node3)));
-    const count = (occurrences.get(hash2) ?? 0) + 1;
-    occurrences.set(hash2, count);
-    blocks.push({
-      id: sectionBlockId(section, `${hash2}${count === 1 ? "" : `-${count}`}`),
-      section,
-      kind,
-      html: html7,
-      text: text10,
-      ...source2 === void 0 ? {} : { source: source2 }
-    });
-  };
-  tree.children = flattenRoots(tree);
-  for (const fragment2 of splitBlocks(tree)) await append(fragment2);
-  return blocks;
-}
-
-// ../../node_modules/.pnpm/@shikijs+types@4.5.0/node_modules/@shikijs/types/dist/index.mjs
-var ShikiError = class extends Error {
-  constructor(message) {
-    super(message);
-    this.name = "ShikiError";
-  }
-};
-
-// ../../node_modules/.pnpm/@shikijs+vscode-textmate@10.1.0/node_modules/@shikijs/vscode-textmate/dist/index.js
-function clone2(something) {
-  return doClone(something);
-}
-function doClone(something) {
-  if (Array.isArray(something)) {
-    return cloneArray(something);
-  }
-  if (something instanceof RegExp) {
-    return something;
-  }
-  if (typeof something === "object") {
-    return cloneObj(something);
-  }
-  return something;
-}
-function cloneArray(arr) {
-  let r4 = [];
-  for (let i2 = 0, len = arr.length; i2 < len; i2++) {
-    r4[i2] = doClone(arr[i2]);
-  }
-  return r4;
-}
-function cloneObj(obj) {
-  let r4 = {};
-  for (let key2 in obj) {
-    r4[key2] = doClone(obj[key2]);
-  }
-  return r4;
-}
-function mergeObjects(target, ...sources) {
-  sources.forEach((source2) => {
-    for (let key2 in source2) {
-      target[key2] = source2[key2];
-    }
-  });
-  return target;
-}
-function basename(path2) {
-  const idx = ~path2.lastIndexOf("/") || ~path2.lastIndexOf("\\");
-  if (idx === 0) {
-    return path2;
-  } else if (~idx === path2.length - 1) {
-    return basename(path2.substring(0, path2.length - 1));
-  } else {
-    return path2.substr(~idx + 1);
-  }
-}
-var CAPTURING_REGEX_SOURCE = /\$(\d+)|\${(\d+):\/(downcase|upcase)}/g;
-var RegexSource = class {
-  static hasCaptures(regexSource) {
-    if (regexSource === null) {
-      return false;
-    }
-    CAPTURING_REGEX_SOURCE.lastIndex = 0;
-    return CAPTURING_REGEX_SOURCE.test(regexSource);
-  }
-  static replaceCaptures(regexSource, captureSource, captureIndices) {
-    return regexSource.replace(CAPTURING_REGEX_SOURCE, (match, index2, commandIndex, command) => {
-      let capture = captureIndices[parseInt(index2 || commandIndex, 10)];
-      if (capture) {
-        let result = captureSource.substring(capture.start, capture.end);
-        while (result[0] === ".") {
-          result = result.substring(1);
-        }
-        switch (command) {
-          case "downcase":
-            return result.toLowerCase();
-          case "upcase":
-            return result.toUpperCase();
-          default:
-            return result;
-        }
-      } else {
-        return match;
-      }
-    });
-  }
-};
-function strcmp(a2, b3) {
-  if (a2 < b3) {
-    return -1;
-  }
-  if (a2 > b3) {
-    return 1;
-  }
-  return 0;
-}
-function strArrCmp(a2, b3) {
-  if (a2 === null && b3 === null) {
-    return 0;
-  }
-  if (!a2) {
-    return -1;
-  }
-  if (!b3) {
-    return 1;
-  }
-  let len1 = a2.length;
-  let len2 = b3.length;
-  if (len1 === len2) {
-    for (let i2 = 0; i2 < len1; i2++) {
-      let res = strcmp(a2[i2], b3[i2]);
-      if (res !== 0) {
-        return res;
-      }
-    }
-    return 0;
-  }
-  return len1 - len2;
-}
-function isValidHexColor(hex3) {
-  if (/^#[0-9a-f]{6}$/i.test(hex3)) {
-    return true;
-  }
-  if (/^#[0-9a-f]{8}$/i.test(hex3)) {
-    return true;
-  }
-  if (/^#[0-9a-f]{3}$/i.test(hex3)) {
-    return true;
-  }
-  if (/^#[0-9a-f]{4}$/i.test(hex3)) {
-    return true;
-  }
-  return false;
-}
-function escapeRegExpCharacters(value) {
-  return value.replace(/[\-\\\{\}\*\+\?\|\^\$\.\,\[\]\(\)\#\s]/g, "\\$&");
-}
-var CachedFn = class {
-  constructor(fn) {
-    this.fn = fn;
-  }
-  fn;
-  cache = /* @__PURE__ */ new Map();
-  get(key2) {
-    if (this.cache.has(key2)) {
-      return this.cache.get(key2);
-    }
-    const value = this.fn(key2);
-    this.cache.set(key2, value);
-    return value;
-  }
-};
-var Theme = class {
-  constructor(_colorMap, _defaults, _root) {
-    this._colorMap = _colorMap;
-    this._defaults = _defaults;
-    this._root = _root;
-  }
-  _colorMap;
-  _defaults;
-  _root;
-  static createFromRawTheme(source2, colorMap) {
-    return this.createFromParsedTheme(parseTheme(source2), colorMap);
-  }
-  static createFromParsedTheme(source2, colorMap) {
-    return resolveParsedThemeRules(source2, colorMap);
-  }
-  _cachedMatchRoot = new CachedFn(
-    (scopeName) => this._root.match(scopeName)
-  );
-  getColorMap() {
-    return this._colorMap.getColorMap();
-  }
-  getDefaults() {
-    return this._defaults;
-  }
-  match(scopePath) {
-    if (scopePath === null) {
-      return this._defaults;
-    }
-    const scopeName = scopePath.scopeName;
-    const matchingTrieElements = this._cachedMatchRoot.get(scopeName);
-    const effectiveRule = matchingTrieElements.find(
-      (v2) => _scopePathMatchesParentScopes(scopePath.parent, v2.parentScopes)
-    );
-    if (!effectiveRule) {
-      return null;
-    }
-    return new StyleAttributes(
-      effectiveRule.fontStyle,
-      effectiveRule.foreground,
-      effectiveRule.background
-    );
-  }
-};
-var ScopeStack = class _ScopeStack {
-  constructor(parent, scopeName) {
-    this.parent = parent;
-    this.scopeName = scopeName;
-  }
-  parent;
-  scopeName;
-  static push(path2, scopeNames) {
-    for (const name of scopeNames) {
-      path2 = new _ScopeStack(path2, name);
-    }
-    return path2;
-  }
-  static from(...segments) {
-    let result = null;
-    for (let i2 = 0; i2 < segments.length; i2++) {
-      result = new _ScopeStack(result, segments[i2]);
-    }
-    return result;
-  }
-  push(scopeName) {
-    return new _ScopeStack(this, scopeName);
-  }
-  getSegments() {
-    let item = this;
-    const result = [];
-    while (item) {
-      result.push(item.scopeName);
-      item = item.parent;
-    }
-    result.reverse();
-    return result;
-  }
-  toString() {
-    return this.getSegments().join(" ");
-  }
-  extends(other) {
-    if (this === other) {
-      return true;
-    }
-    if (this.parent === null) {
-      return false;
-    }
-    return this.parent.extends(other);
-  }
-  getExtensionIfDefined(base2) {
-    const result = [];
-    let item = this;
-    while (item && item !== base2) {
-      result.push(item.scopeName);
-      item = item.parent;
-    }
-    return item === base2 ? result.reverse() : void 0;
-  }
-};
-function _scopePathMatchesParentScopes(scopePath, parentScopes) {
-  if (parentScopes.length === 0) {
-    return true;
-  }
-  for (let index2 = 0; index2 < parentScopes.length; index2++) {
-    let scopePattern = parentScopes[index2];
-    let scopeMustMatch = false;
-    if (scopePattern === ">") {
-      if (index2 === parentScopes.length - 1) {
-        return false;
-      }
-      scopePattern = parentScopes[++index2];
-      scopeMustMatch = true;
-    }
-    while (scopePath) {
-      if (_matchesScope(scopePath.scopeName, scopePattern)) {
-        break;
-      }
-      if (scopeMustMatch) {
-        return false;
-      }
-      scopePath = scopePath.parent;
-    }
-    if (!scopePath) {
-      return false;
-    }
-    scopePath = scopePath.parent;
-  }
-  return true;
-}
-function _matchesScope(scopeName, scopePattern) {
-  return scopePattern === scopeName || scopeName.startsWith(scopePattern) && scopeName[scopePattern.length] === ".";
-}
-var StyleAttributes = class {
-  constructor(fontStyle, foregroundId, backgroundId) {
-    this.fontStyle = fontStyle;
-    this.foregroundId = foregroundId;
-    this.backgroundId = backgroundId;
-  }
-  fontStyle;
-  foregroundId;
-  backgroundId;
-};
-function parseTheme(source2) {
-  if (!source2) {
-    return [];
+  fontStyle;
+  foregroundId;
+  backgroundId;
+};
+function parseTheme(source2) {
+  if (!source2) {
+    return [];
   }
   if (!source2.settings || !Array.isArray(source2.settings)) {
     return [];
@@ -35951,7 +35394,7 @@ function isSpecialTheme(theme) {
   return isNoneTheme(theme);
 }
 var RE_NEWLINE = /(\r?\n)/g;
-function splitLines2(code4, preserveEnding = false) {
+function splitLines(code4, preserveEnding = false) {
   if (code4.length === 0) return [["", 0]];
   const parts = code4.split(RE_NEWLINE);
   let index2 = 0;
@@ -36394,7 +35837,7 @@ var RE_COMMA = /,/;
 var RE_SPACE = / /;
 function codeToTokensBase(primitive, code4, options = {}) {
   const { theme: themeName = primitive.getLoadedThemes()[0] } = options;
-  if (isPlainLang(primitive.resolveLangAlias(options.lang || "text")) || isNoneTheme(themeName)) return splitLines2(code4).map((line) => [{
+  if (isPlainLang(primitive.resolveLangAlias(options.lang || "text")) || isNoneTheme(themeName)) return splitLines(code4).map((line) => [{
     content: line[0],
     offset: line[1]
   }]);
@@ -36425,7 +35868,7 @@ function tokenizeWithTheme(code4, grammar, theme, colorMap, options) {
 function _tokenizeWithTheme(code4, grammar, theme, colorMap, options) {
   const colorReplacements = resolveColorReplacements(theme, options);
   const { tokenizeMaxLineLength = 0, tokenizeTimeLimit = 500, includeExplanation = false } = options;
-  const lines = splitLines2(code4);
+  const lines = splitLines(code4);
   let stateStack = options.grammarState ? getGrammarStack(options.grammarState, theme.name) ?? INITIAL : options.grammarContextCode != null ? _tokenizeWithTheme(options.grammarContextCode, grammar, theme, colorMap, {
     ...options,
     grammarState: void 0,
@@ -36534,7 +35977,7 @@ function explainThemeScopesFull(themeSelectors, scopes) {
 function matchesOne(selector, scope) {
   return selector === scope || scope.substring(0, selector.length) === selector && scope[selector.length] === ".";
 }
-function matches2(selectors, scope, parentScopes) {
+function matches(selectors, scope, parentScopes) {
   if (!matchesOne(selectors.at(-1), scope)) return false;
   let selectorParentIndex = selectors.length - 2;
   let parentIndex = parentScopes.length - 1;
@@ -36547,7 +35990,7 @@ function matches2(selectors, scope, parentScopes) {
 }
 function explainThemeScope(themeSettingsSelectors, scope, parentScopes) {
   const result = [];
-  for (const { selectors, settings } of themeSettingsSelectors) for (const selectorPieces of selectors) if (matches2(selectorPieces, scope, parentScopes)) {
+  for (const { selectors, settings } of themeSettingsSelectors) for (const selectorPieces of selectors) if (matches(selectorPieces, scope, parentScopes)) {
     result.push(settings);
     break;
   }
@@ -37544,8 +36987,8 @@ function toHtml(tree, options) {
     throw new Error("Invalid quote `" + quote + "`, expected `'` or `\"`");
   }
   const state = {
-    one: one3,
-    all: all3,
+    one: one2,
+    all: all2,
     settings: {
       omitOptionalTags: options_.omitOptionalTags || false,
       allowParseErrors: options_.allowParseErrors || false,
@@ -37575,10 +37018,10 @@ function toHtml(tree, options) {
     void 0
   );
 }
-function one3(node3, index2, parent) {
+function one2(node3, index2, parent) {
   return handle(node3, index2, parent, this);
 }
-function all3(parent) {
+function all2(parent) {
   const results = [];
   const children2 = parent && parent.children || emptyChildren2;
   let index2 = -1;
@@ -37601,7 +37044,7 @@ function addClassToHast(node3, className) {
   return node3;
 }
 function createPositionConverter(code4) {
-  const lines = splitLines2(code4, true).map(([line]) => line);
+  const lines = splitLines(code4, true).map(([line]) => line);
   function indexToPos(index2) {
     if (index2 === code4.length) return {
       line: lines.length - 1,
@@ -38149,7 +37592,7 @@ var defaultAnsiColors = {
 };
 function tokenizeAnsiWithTheme(theme, fileContents, options) {
   const colorReplacements = resolveColorReplacements(theme, options);
-  const lines = splitLines2(fileContents);
+  const lines = splitLines(fileContents);
   const colorPalette = createColorPalette(Object.fromEntries(namedColors.map((name) => {
     const key2 = `terminal.ansi${name[0].toUpperCase()}${name.substring(1)}`;
     return [name, theme.colors?.[key2] || defaultAnsiColors[name]];
@@ -38551,36 +37994,6 @@ async function createHighlighterCore(options) {
   };
 }
 
-// ../../packages/core/src/render/highlight.ts
-var HIGHLIGHT_LINE_CHARS = 400;
-var HIGHLIGHT_FENCE_BYTES = 16384;
-var HIGHLIGHT_RENDER_BYTES = 65536;
-function limitHighlighting(languages) {
-  const loaded = new Set(languages);
-  const encoder3 = new TextEncoder();
-  return (tree, file2) => {
-    const budget = file2.data.highlightBudget ?? { highlightedBytes: 0 };
-    visitElements(tree, (element6) => {
-      if (element6.tagName !== "pre") return;
-      const code4 = element6.children[0];
-      if (code4?.type !== "element" || code4.tagName !== "code") return;
-      const classes = code4.properties.className;
-      if (!Array.isArray(classes)) return;
-      const languageClass = classes.find((value) => typeof value === "string" && value.startsWith("language-"));
-      if (typeof languageClass !== "string") return;
-      const language = languageClass.slice(9);
-      if (!loaded.has(language) && !isSpecialLang(language)) return;
-      const bytes = encoder3.encode(toString(code4)).byteLength;
-      if (bytes > HIGHLIGHT_FENCE_BYTES || budget.highlightedBytes + bytes > HIGHLIGHT_RENDER_BYTES || budget.highlightedBytes >= HIGHLIGHT_RENDER_BYTES) {
-        code4.properties.className = classes.filter(
-          (value) => typeof value !== "string" || !value.startsWith("language-")
-        );
-        if (code4.properties.className.length === 0) delete code4.properties.className;
-      } else budget.highlightedBytes += bytes;
-    });
-  };
-}
-
 // ../../node_modules/.pnpm/unist-util-is@6.0.1/node_modules/unist-util-is/lib/index.js
 var convert = (
   // Note: overloads in JSDoc can’t yet use different `@template`s.
@@ -38840,6 +38253,28 @@ function wrap(visitor) {
   }
 }
 
+// ../../node_modules/.pnpm/hast-util-to-string@3.0.1/node_modules/hast-util-to-string/lib/index.js
+function toString(node3) {
+  if ("children" in node3) {
+    return all3(node3);
+  }
+  return "value" in node3 ? node3.value : "";
+}
+function one3(node3) {
+  if (node3.type === "text") {
+    return node3.value;
+  }
+  return "children" in node3 ? all3(node3) : "";
+}
+function all3(node3) {
+  let index2 = -1;
+  const result = [];
+  while (++index2 < node3.children.length) {
+    result[index2] = one3(node3.children[index2]);
+  }
+  return result.join("");
+}
+
 // ../../node_modules/.pnpm/@shikijs+rehype@4.5.0/node_modules/@shikijs/rehype/dist/core-BvUdHGey.mjs
 var RE_TAILING_CURLY_COLON = /(.+)\{:([\w-]+)\}$/;
 var InlineCodeHandlers = { "tailing-curly-colon": (_tree, node3) => {
@@ -55088,21 +54523,283 @@ function assertDone(name, asyncName, complete) {
     );
   }
 }
-function vfile(value) {
-  return looksLikeAVFile(value) ? value : new VFile(value);
+function vfile(value) {
+  return looksLikeAVFile(value) ? value : new VFile(value);
+}
+function looksLikeAVFile(value) {
+  return Boolean(
+    value && typeof value === "object" && "message" in value && "messages" in value
+  );
+}
+function looksLikeAValue(value) {
+  return typeof value === "string" || isUint8Array2(value);
+}
+function isUint8Array2(value) {
+  return Boolean(
+    value && typeof value === "object" && "byteLength" in value && "byteOffset" in value
+  );
+}
+
+// ../../packages/core/src/render/hash.ts
+async function blockHash(text10) {
+  const digest = await globalThis.crypto.subtle.digest("SHA-256", new TextEncoder().encode(text10));
+  return Array.from(new Uint8Array(digest).subarray(0, 4), (byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+
+// ../../packages/core/src/render/blocks.ts
+var sectionBlockId = (section, identity) => `${section}-${identity}`;
+function resectionBlocks(blocks, section) {
+  return blocks.map((block) => ({
+    ...block,
+    section,
+    id: sectionBlockId(section, block.id.slice(block.section.length + 1))
+  }));
+}
+function renderData(element6) {
+  element6.data ??= { position: {} };
+  return element6.data;
+}
+function blockText(html7) {
+  return toString(fromHtml(html7, { fragment: true }));
+}
+function visitElements(node3, visit3) {
+  if (node3.type === "element") visit3(node3);
+  if ("children" in node3) for (const child of node3.children) visitElements(child, visit3);
+}
+var MAX_BLOCK_DEPTH = 64;
+var blockTags = /* @__PURE__ */ new Set([
+  "blockquote",
+  "dd",
+  "details",
+  "div",
+  "dl",
+  "dt",
+  "h1",
+  "h2",
+  "h3",
+  "h4",
+  "h5",
+  "h6",
+  "hr",
+  "li",
+  "ol",
+  "p",
+  "pre",
+  "section",
+  "summary",
+  "table",
+  "ul"
+]);
+function hasBlockChildren(node3) {
+  return "children" in node3 && node3.children.some((child) => child.type === "element" && (blockTags.has(child.tagName) || hasBlockChildren(child)));
+}
+function isDiagram(node3) {
+  return node3.type === "element" && renderData(node3).emendDiagram !== void 0;
+}
+function hasDiagram(node3) {
+  return isDiagram(node3) || "children" in node3 && node3.children.some(hasDiagram);
+}
+function hasContent(nodes) {
+  return nodes.some((node3) => node3.type === "element" || node3.type === "text" && normalizeText(node3.value) !== "");
+}
+function* divideAtDiagrams(node3) {
+  if (isDiagram(node3) || !hasDiagram(node3)) {
+    yield node3;
+    return;
+  }
+  let children2 = [];
+  for (const child of node3.children) {
+    if (child.type !== "element") {
+      children2.push(child);
+      continue;
+    }
+    for (const piece of divideAtDiagrams(child)) {
+      if (isDiagram(piece)) {
+        if (hasContent(children2)) yield { ...node3, children: children2 };
+        children2 = [];
+        yield piece;
+      } else children2.push(piece);
+    }
+  }
+  if (hasContent(children2)) yield { ...node3, children: children2 };
+}
+function* atomicBlock(kind, node3) {
+  for (const piece of divideAtDiagrams(node3)) {
+    const source2 = renderData(piece).emendDiagram;
+    yield source2 === void 0 ? { kind, node: piece } : { kind: "diagram", node: piece, source: source2 };
+  }
+}
+function flattenRoots(node3) {
+  if (node3.type === "root") {
+    return node3.children.flatMap(flattenRoots);
+  }
+  if (node3.type === "element") {
+    node3.children = node3.children.flatMap(flattenRoots).filter((child) => child.type !== "doctype");
+  }
+  return [node3];
+}
+function* splitChildren(children2, depth) {
+  let inline = [];
+  for (const child of children2) {
+    if (child.type === "element" && (blockTags.has(child.tagName) || hasBlockChildren(child) || hasDiagram(child))) {
+      if (hasContent(inline)) yield { kind: "paragraph", node: { type: "root", children: inline } };
+      inline = [];
+      yield* splitBlocks(child, depth);
+    } else if (child.type !== "comment" && child.type !== "doctype") inline.push(child);
+  }
+  if (hasContent(inline)) yield { kind: "paragraph", node: { type: "root", children: inline } };
+}
+function blockKind(tag) {
+  if (/^h[1-6]$/.test(tag)) return "heading";
+  if (tag === "li" || tag === "dt" || tag === "dd") return "item";
+  if (tag === "pre") return "code";
+  if (tag === "table") return "table";
+  if (tag === "blockquote") return "quote";
+  return "paragraph";
+}
+function* strayListContent(children2, depth) {
+  for (const fragment2 of splitChildren(children2, depth)) {
+    yield fragment2.kind === "diagram" ? fragment2 : { ...fragment2, kind: "paragraph" };
+  }
+}
+function* splitBlocks(node3, depth = 0) {
+  if (node3.type === "root") {
+    yield* splitChildren(node3.children, depth + 1);
+    return;
+  }
+  if (node3.type !== "element") return;
+  const source2 = renderData(node3).emendDiagram;
+  if (source2 !== void 0) {
+    yield { kind: "diagram", node: node3, source: source2 };
+    return;
+  }
+  const tag = node3.tagName;
+  if (tag === "hr") return;
+  const kind = blockKind(tag);
+  if (depth >= MAX_BLOCK_DEPTH) {
+    yield* atomicBlock(kind, node3);
+    return;
+  }
+  if (tag === "ul" || tag === "ol") {
+    let ordinal = typeof node3.properties.start === "number" ? node3.properties.start : 1;
+    let stray = [];
+    for (const child of node3.children) {
+      if (child.type !== "element" || child.tagName !== "li") {
+        stray.push(child);
+        continue;
+      }
+      yield* strayListContent(stray, depth + 1);
+      stray = [];
+      const properties2 = { ...node3.properties };
+      if (tag === "ol") properties2.start = ordinal++;
+      for (const fragment2 of atomicBlock("item", child)) {
+        if (fragment2.kind === "diagram") yield fragment2;
+        else if (fragment2.node.type === "element") {
+          yield { ...fragment2, node: { ...node3, properties: properties2, children: [fragment2.node] } };
+        }
+      }
+    }
+    yield* strayListContent(stray, depth + 1);
+    return;
+  }
+  if (kind === "paragraph" && hasBlockChildren(node3)) {
+    yield* splitChildren(node3.children, depth + 1);
+    return;
+  }
+  yield* atomicBlock(kind, node3);
+}
+function identityText(node3) {
+  if (node3.type === "element" && renderData(node3).emendFootnoteMarker) return "";
+  if (node3.type === "element" && renderData(node3).emendMedia !== void 0)
+    return `\0media${renderData(node3).emendMedia}`;
+  if (node3.type === "text") return node3.value;
+  return "children" in node3 ? node3.children.map(identityText).join("") : "";
 }
-function looksLikeAVFile(value) {
-  return Boolean(
-    value && typeof value === "object" && "message" in value && "messages" in value
-  );
+function stringifyBlock(node3, stringify4) {
+  const parts = [];
+  const pending = [node3];
+  for (let next2 = pending.pop(); next2 !== void 0; next2 = pending.pop()) {
+    if (typeof next2 === "string") parts.push(next2);
+    else if (next2.type === "root") {
+      for (const child of next2.children.toReversed()) pending.push(child);
+    } else if (next2.type === "element" && next2.children.length > 0) {
+      const shell = stringify4({ ...next2, children: [] });
+      const closing2 = `</${next2.tagName}>`;
+      if (shell.endsWith(closing2)) {
+        parts.push(shell.slice(0, -closing2.length));
+        pending.push(closing2);
+      } else parts.push(shell);
+      for (const child of next2.children.toReversed()) pending.push(child);
+    } else parts.push(stringify4(next2));
+  }
+  return parts.join("");
 }
-function looksLikeAValue(value) {
-  return typeof value === "string" || isUint8Array2(value);
+async function blocksFromTree(tree, section, stringify4) {
+  const blocks = [];
+  const elementIds = /* @__PURE__ */ new Map();
+  visitElements(tree, (element6) => {
+    const id2 = element6.properties.id;
+    if (typeof id2 === "string") elementIds.set(id2, (elementIds.get(id2) ?? 0) + 1);
+  });
+  const occurrences = /* @__PURE__ */ new Map();
+  const append = async ({ kind, node: node3, source: source2 }) => {
+    let html7 = kind === "diagram" ? "" : stringifyBlock(node3, stringify4);
+    const text10 = source2 ?? blockText(html7);
+    if (kind !== "diagram" && normalizeText(text10) === "") return;
+    const hash2 = await blockHash(normalizeText(source2 ?? identityText(node3)));
+    const count = (occurrences.get(hash2) ?? 0) + 1;
+    occurrences.set(hash2, count);
+    if (kind === "heading" && node3.type === "element") {
+      const authorId = node3.properties.id;
+      if (typeof authorId !== "string" || !authorId.startsWith("user-content-") || elementIds.get(authorId) !== 1 || authorId.length > LIMITS.headingIdChars || Array.from(authorId).some((char) => {
+        const code4 = char.charCodeAt(0);
+        return code4 < 32 || code4 >= 127 && code4 <= 159;
+      }))
+        node3.properties.id = `heading-${hash2}${count === 1 ? "" : `-${count}`}`;
+      html7 = stringifyBlock(node3, stringify4);
+    }
+    blocks.push({
+      id: sectionBlockId(section, `${hash2}${count === 1 ? "" : `-${count}`}`),
+      section,
+      kind,
+      html: html7,
+      text: text10,
+      ...source2 === void 0 ? {} : { source: source2 }
+    });
+  };
+  tree.children = flattenRoots(tree);
+  for (const fragment2 of splitBlocks(tree)) await append(fragment2);
+  return blocks;
 }
-function isUint8Array2(value) {
-  return Boolean(
-    value && typeof value === "object" && "byteLength" in value && "byteOffset" in value
-  );
+
+// ../../packages/core/src/render/highlight.ts
+var HIGHLIGHT_LINE_CHARS = 400;
+var HIGHLIGHT_FENCE_BYTES = 16384;
+var HIGHLIGHT_RENDER_BYTES = 65536;
+function limitHighlighting(languages) {
+  const loaded = new Set(languages);
+  const encoder3 = new TextEncoder();
+  return (tree, file2) => {
+    const budget = file2.data.highlightBudget ?? { highlightedBytes: 0 };
+    visitElements(tree, (element6) => {
+      if (element6.tagName !== "pre") return;
+      const code4 = element6.children[0];
+      if (code4?.type !== "element" || code4.tagName !== "code") return;
+      const classes = code4.properties.className;
+      if (!Array.isArray(classes)) return;
+      const languageClass = classes.find((value) => typeof value === "string" && value.startsWith("language-"));
+      if (typeof languageClass !== "string") return;
+      const language = languageClass.slice(9);
+      if (!loaded.has(language) && !isSpecialLang(language)) return;
+      const bytes = encoder3.encode(toString(code4)).byteLength;
+      if (bytes > HIGHLIGHT_FENCE_BYTES || budget.highlightedBytes + bytes > HIGHLIGHT_RENDER_BYTES || budget.highlightedBytes >= HIGHLIGHT_RENDER_BYTES) {
+        code4.properties.className = classes.filter(
+          (value) => typeof value !== "string" || !value.startsWith("language-")
+        );
+        if (code4.properties.className.length === 0) delete code4.properties.className;
+      } else budget.highlightedBytes += bytes;
+    });
+  };
 }
 
 // ../../packages/core/src/render/issue-refs.ts
@@ -55149,7 +54846,7 @@ function linkIssueRefs() {
 }
 
 // ../../packages/core/src/render/line-breaks.ts
-function splitLines3(value) {
+function splitLines2(value) {
   const parts = [];
   value.split(/\r\n|\r|\n/).forEach((line, index2) => {
     if (index2 > 0) parts.push({ type: "break" });
@@ -55162,7 +54859,7 @@ function breakText(node3) {
   const next2 = [];
   for (const child of node3.children) {
     if (child.type === "text" && child.value && /[\r\n]/.test(child.value)) {
-      next2.push(...splitLines3(child.value));
+      next2.push(...splitLines2(child.value));
     } else {
       breakText(child);
       next2.push(child);
@@ -55207,6 +54904,41 @@ function limitReferences() {
   };
 }
 
+// ../../packages/core/src/links.ts
+function resolveDocLink(base2, href, docs2) {
+  const hasControl = (value) => Array.from(value).some((char) => {
+    const code4 = char.charCodeAt(0);
+    return code4 < 32 || code4 >= 127 && code4 <= 159;
+  });
+  if (!href || hasControl(href) || href.includes("\\")) return null;
+  const hash2 = href.indexOf("#");
+  const rawPath = hash2 < 0 ? href : href.slice(0, hash2);
+  if (rawPath.startsWith("/") || rawPath.includes("?") || /%2f|%5c/i.test(href)) return null;
+  let parts;
+  let fragment2;
+  try {
+    parts = rawPath.split("/").map((part) => decodeURIComponent(part));
+    fragment2 = hash2 < 0 ? void 0 : decodeURIComponent(href.slice(hash2 + 1));
+  } catch {
+    return null;
+  }
+  if (parts.some((part) => hasControl(part) || part.includes("\\") || part.includes(":")) || fragment2 !== void 0 && hasControl(fragment2))
+    return null;
+  if (rawPath !== "" && (rawPath.endsWith("/") || parts.at(-1) === "." || parts.at(-1) === "..")) return null;
+  const path2 = rawPath === "" ? base2.split("/") : base2.split("/").slice(0, -1);
+  if (rawPath !== "")
+    for (const part of parts) {
+      if (part === ".") continue;
+      if (part === "") return null;
+      if (part === "..") {
+        if (!path2.length) return null;
+        path2.pop();
+      } else path2.push(part);
+    }
+  const resolved = path2.join("/");
+  return docs2.has(resolved) ? { path: resolved, ...fragment2 ? { fragment: fragment2 } : {} } : null;
+}
+
 // ../../packages/core/src/render/sanitize.ts
 var prefix = "user-content-";
 var forbiddenTags = [
@@ -55297,7 +55029,10 @@ function restoreFootnotes() {
       if (!("children" in parent)) continue;
       for (const [index2, child] of parent.children.entries()) {
         if (child.type === FOOTNOTE_NODE) {
-          parent.children[index2] = child.data.element;
+          const element6 = child.data.element;
+          parent.children[index2] = element6;
+          const link4 = element6.children[0];
+          if (element6.tagName === "sup" && link4?.type === "element") renderData(link4).emendFootnoteMarker = true;
         } else pending.push(child);
       }
     }
@@ -55385,6 +55120,8 @@ function wrapMedia(node3, media) {
 function hardenLinks() {
   return (tree, file2) => {
     const media = file2.data.media;
+    const docs2 = file2.data.docs;
+    const base2 = typeof file2.data.docBase === "string" ? file2.data.docBase : "";
     visitElements(tree, (element6) => {
       const classes = renderData(element6).emendClasses;
       if (Array.isArray(classes) && classes.every(
@@ -55401,6 +55138,21 @@ function hardenLinks() {
         delete element6.properties.href;
         delete element6.properties.rel;
         delete element6.properties.target;
+        if (docs2 && element6.tagName === "a" && !renderData(element6).emendFootnoteMarker && !hasBlockChildren(element6) && typeof href === "string") {
+          const hash2 = href.indexOf("#");
+          const query = href.indexOf("?");
+          const lookup = query >= 0 && (hash2 < 0 || query < hash2) ? href.slice(0, query) + (hash2 < 0 ? "" : href.slice(hash2)) : href;
+          file2.data.docBaseUsed = true;
+          if (lookup.startsWith("#")) file2.data.docPathUsed = true;
+          const link4 = resolveDocLink(base2, lookup, docs2);
+          if (link4) {
+            const params = new URLSearchParams({ tab: "docs", doc: link4.path });
+            const ids = docs2.get(link4.path);
+            const id2 = link4.fragment && ids?.has(`${prefix}${link4.fragment}`) ? `${prefix}${link4.fragment}` : void 0;
+            const heading3 = id2 ? `#h-${encodeURIComponent(id2)}` : "";
+            element6.properties.href = `?${params}${heading3}`;
+          }
+        }
       }
       if (element6.tagName === "img") {
         const path2 = media ? mediaKey(src, media) : null;
@@ -55521,7 +55273,7 @@ async function createProcessor() {
   }).use(rehypeStringify);
 }
 var processorPromise;
-async function renderMarkdownWithBudget(markdown2, section, highlightBudget, repoUrl, media) {
+async function renderMarkdownWithBudget(markdown2, section, highlightBudget, repoUrl, media, docs2, docBase = "", effects) {
   BlockId.parse(`${section}-00000000`);
   processorPromise ??= createProcessor().catch((error62) => {
     processorPromise = void 0;
@@ -55529,10 +55281,22 @@ async function renderMarkdownWithBudget(markdown2, section, highlightBudget, rep
   });
   const processor = await processorPromise;
   const { source: source2, tables } = prepareTables(markdown2);
+  const data = {
+    highlightBudget,
+    largeTables: tables,
+    repoUrl,
+    media,
+    docs: docs2,
+    docBase,
+    docBaseUsed: false,
+    docPathUsed: false
+  };
   const tree = await processor.run(processor.parse(source2), {
     value: source2,
-    data: { highlightBudget, largeTables: tables, repoUrl, media }
+    data
   });
+  if (effects && data.docBaseUsed) effects.docBaseUsed = true;
+  if (effects && data.docPathUsed) effects.docPathUsed = true;
   return blocksFromTree(
     tree,
     section,
@@ -55548,11 +55312,489 @@ async function renderCommentHtml(markdown2, repoUrl) {
   });
   return commentProcessor.stringify(tree);
 }
-function renderMarkdown(markdown2, section, repoUrl) {
-  return renderMarkdownWithBudget(markdown2, section, { highlightedBytes: 0 }, repoUrl);
+async function renderDoc(markdown2, path2, repoUrl, docs2, effects) {
+  return renderMarkdownWithBudget(
+    markdown2,
+    `doc-${await blockHash(path2)}`,
+    { highlightedBytes: 0 },
+    repoUrl,
+    void 0,
+    docs2,
+    path2,
+    effects
+  );
+}
+var metadataProcessor = sanitizedPipeline().use(isolateDiagrams).use(rehypeStringify);
+async function renderMetadataBlocks(markdown2) {
+  const { source: source2, tables } = prepareTables(markdown2);
+  const tree = await metadataProcessor.run(metadataProcessor.parse(source2), {
+    value: source2,
+    data: { largeTables: tables }
+  });
+  return blocksFromTree(
+    tree,
+    "metadata",
+    (node3) => metadataProcessor.stringify(node3.type === "root" ? node3 : { type: "root", children: [node3] })
+  );
+}
+
+// ../../packages/core/src/doc-title.ts
+var TITLE_PREFIX_BYTES = 64 * 1024;
+var discardedRanges = [
+  [0, 31],
+  [127, 159],
+  [847, 847],
+  [1564, 1564],
+  [4447, 4448],
+  [8203, 8207],
+  [8234, 8238],
+  [8288, 8303],
+  [12644, 12644],
+  [65024, 65039],
+  [65279, 65279],
+  [65440, 65440],
+  [65529, 65531],
+  [917504, 917631],
+  [917760, 917999]
+];
+function cleanDocTitle(value) {
+  return Array.from(value.replace(/[\s\x85]/gu, " ")).filter((char) => {
+    const code4 = char.codePointAt(0) ?? 0;
+    return !discardedRanges.some(([from, to]) => code4 >= from && code4 <= to);
+  }).join("").replace(/ +/g, " ").trim().toWellFormed().slice(0, LIMITS.titleChars).replace(/[\uD800-\uDBFF]$/, "").trim();
+}
+function htmlTitle(bytes) {
+  const tree = parseDocHtml(new TextDecoder().decode(bytes.subarray(0, TITLE_PREFIX_BYTES)));
+  if (!tree) return void 0;
+  const head2 = htmlPart(tree, "head");
+  if (head2 && defaultTreeAdapter.isElementNode(head2)) {
+    const title = head2.childNodes.find(
+      (node3) => defaultTreeAdapter.isElementNode(node3) && node3.namespaceURI === html_exports.NS.HTML && node3.tagName === "title"
+    );
+    const cleaned = title ? cleanDocTitle(nodeText(title, 4 * LIMITS.titleChars)) : "";
+    if (cleaned) return cleaned;
+  }
+  const body3 = htmlPart(tree, "body");
+  if (body3)
+    for (const node3 of docNodes(body3)) {
+      if (defaultTreeAdapter.isElementNode(node3) && node3.namespaceURI === html_exports.NS.HTML && node3.tagName === "h1")
+        return cleanDocTitle(nodeText(node3, 4 * LIMITS.titleChars)) || void 0;
+    }
+  return void 0;
+}
+function markdownTitle(blocks) {
+  const heading3 = blocks.find((block) => block.kind === "heading" && /^<h1(?:\s|>)/.test(block.html));
+  return heading3 ? cleanDocTitle(heading3.text) || void 0 : void 0;
+}
+async function inferDocTitle(kind, bytes) {
+  return kind === "html" ? htmlTitle(bytes) : markdownTitle(await renderMetadataBlocks(new TextDecoder().decode(bytes)));
+}
+
+// ../../packages/core/src/doc-headings.ts
+function htmlHeadings(source2) {
+  const tree = parseDocHtml(source2);
+  const body3 = tree ? htmlPart(tree, "body") : void 0;
+  const headings = [];
+  if (body3)
+    for (const node3 of docNodes(body3)) {
+      if (!defaultTreeAdapter.isElementNode(node3) || node3.namespaceURI !== html_exports.NS.HTML || node3.tagName !== "h2" && node3.tagName !== "h3")
+        continue;
+      headings.push({
+        level: node3.tagName === "h2" ? 2 : 3,
+        text: cleanDocTitle(nodeText(node3, 4 * LIMITS.headingTextChars)).slice(0, LIMITS.headingTextChars)
+      });
+      if (headings.length === LIMITS.headingsPerDoc) break;
+    }
+  return headings;
+}
+function markdownHeadings(blocks) {
+  const headings = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const block of blocks) {
+    if (block.kind !== "heading") continue;
+    if (!/^<h[23](?:\s|>)/.test(block.html)) continue;
+    const node3 = fromHtml(block.html, { fragment: true }).children[0];
+    if (node3?.type !== "element" || typeof node3.properties.id !== "string") continue;
+    if (seen.has(node3.properties.id)) continue;
+    seen.add(node3.properties.id);
+    headings.push({
+      level: node3.tagName === "h2" ? 2 : 3,
+      text: cleanDocTitle(block.text).slice(0, LIMITS.headingTextChars),
+      id: node3.properties.id
+    });
+    if (headings.length === LIMITS.headingsPerDoc) break;
+  }
+  return headings;
+}
+
+// ../../node_modules/.pnpm/diff@9.0.0/node_modules/diff/libesm/diff/base.js
+var Diff = class {
+  diff(oldStr, newStr, options = {}) {
+    let callback;
+    if (typeof options === "function") {
+      callback = options;
+      options = {};
+    } else if ("callback" in options) {
+      callback = options.callback;
+    }
+    const oldString = this.castInput(oldStr, options);
+    const newString = this.castInput(newStr, options);
+    const oldTokens = this.removeEmpty(this.tokenize(oldString, options));
+    const newTokens = this.removeEmpty(this.tokenize(newString, options));
+    return this.diffWithOptionsObj(oldTokens, newTokens, options, callback);
+  }
+  diffWithOptionsObj(oldTokens, newTokens, options, callback) {
+    var _a4;
+    const done = (value) => {
+      value = this.postProcess(value, options);
+      if (callback) {
+        setTimeout(function() {
+          callback(value);
+        }, 0);
+        return void 0;
+      } else {
+        return value;
+      }
+    };
+    const newLen = newTokens.length, oldLen = oldTokens.length;
+    let editLength = 1;
+    let maxEditLength = newLen + oldLen;
+    if (options.maxEditLength != null) {
+      maxEditLength = Math.min(maxEditLength, options.maxEditLength);
+    }
+    const maxExecutionTime = (_a4 = options.timeout) !== null && _a4 !== void 0 ? _a4 : Infinity;
+    const abortAfterTimestamp = Date.now() + maxExecutionTime;
+    const bestPath = [{ oldPos: -1, lastComponent: void 0 }];
+    let newPos = this.extractCommon(bestPath[0], newTokens, oldTokens, 0, options);
+    if (bestPath[0].oldPos + 1 >= oldLen && newPos + 1 >= newLen) {
+      return done(this.buildValues(bestPath[0].lastComponent, newTokens, oldTokens));
+    }
+    let minDiagonalToConsider = -Infinity, maxDiagonalToConsider = Infinity;
+    const execEditLength = () => {
+      for (let diagonalPath = Math.max(minDiagonalToConsider, -editLength); diagonalPath <= Math.min(maxDiagonalToConsider, editLength); diagonalPath += 2) {
+        let basePath;
+        const removePath = bestPath[diagonalPath - 1], addPath = bestPath[diagonalPath + 1];
+        if (removePath) {
+          bestPath[diagonalPath - 1] = void 0;
+        }
+        let canAdd = false;
+        if (addPath) {
+          const addPathNewPos = addPath.oldPos - diagonalPath;
+          canAdd = addPath && 0 <= addPathNewPos && addPathNewPos < newLen;
+        }
+        const canRemove = removePath && removePath.oldPos + 1 < oldLen;
+        if (!canAdd && !canRemove) {
+          bestPath[diagonalPath] = void 0;
+          continue;
+        }
+        if (!canRemove || canAdd && removePath.oldPos < addPath.oldPos) {
+          basePath = this.addToPath(addPath, true, false, 0, options);
+        } else {
+          basePath = this.addToPath(removePath, false, true, 1, options);
+        }
+        newPos = this.extractCommon(basePath, newTokens, oldTokens, diagonalPath, options);
+        if (basePath.oldPos + 1 >= oldLen && newPos + 1 >= newLen) {
+          return done(this.buildValues(basePath.lastComponent, newTokens, oldTokens)) || true;
+        } else {
+          bestPath[diagonalPath] = basePath;
+          if (basePath.oldPos + 1 >= oldLen) {
+            maxDiagonalToConsider = Math.min(maxDiagonalToConsider, diagonalPath - 1);
+          }
+          if (newPos + 1 >= newLen) {
+            minDiagonalToConsider = Math.max(minDiagonalToConsider, diagonalPath + 1);
+          }
+        }
+      }
+      editLength++;
+    };
+    if (callback) {
+      (function exec() {
+        setTimeout(function() {
+          if (editLength > maxEditLength || Date.now() > abortAfterTimestamp) {
+            return callback(void 0);
+          }
+          if (!execEditLength()) {
+            exec();
+          }
+        }, 0);
+      })();
+    } else {
+      while (editLength <= maxEditLength && Date.now() <= abortAfterTimestamp) {
+        const ret = execEditLength();
+        if (ret) {
+          return ret;
+        }
+      }
+    }
+  }
+  addToPath(path2, added, removed, oldPosInc, options) {
+    const last = path2.lastComponent;
+    if (last && !options.oneChangePerToken && last.added === added && last.removed === removed) {
+      return {
+        oldPos: path2.oldPos + oldPosInc,
+        lastComponent: { count: last.count + 1, added, removed, previousComponent: last.previousComponent }
+      };
+    } else {
+      return {
+        oldPos: path2.oldPos + oldPosInc,
+        lastComponent: { count: 1, added, removed, previousComponent: last }
+      };
+    }
+  }
+  extractCommon(basePath, newTokens, oldTokens, diagonalPath, options) {
+    const newLen = newTokens.length, oldLen = oldTokens.length;
+    let oldPos = basePath.oldPos, newPos = oldPos - diagonalPath, commonCount = 0;
+    while (newPos + 1 < newLen && oldPos + 1 < oldLen && this.equals(oldTokens[oldPos + 1], newTokens[newPos + 1], options)) {
+      newPos++;
+      oldPos++;
+      commonCount++;
+      if (options.oneChangePerToken) {
+        basePath.lastComponent = { count: 1, previousComponent: basePath.lastComponent, added: false, removed: false };
+      }
+    }
+    if (commonCount && !options.oneChangePerToken) {
+      basePath.lastComponent = { count: commonCount, previousComponent: basePath.lastComponent, added: false, removed: false };
+    }
+    basePath.oldPos = oldPos;
+    return newPos;
+  }
+  equals(left, right, options) {
+    if (options.comparator) {
+      return options.comparator(left, right);
+    } else {
+      return left === right || !!options.ignoreCase && left.toLowerCase() === right.toLowerCase();
+    }
+  }
+  removeEmpty(array2) {
+    const ret = [];
+    for (let i2 = 0; i2 < array2.length; i2++) {
+      if (array2[i2]) {
+        ret.push(array2[i2]);
+      }
+    }
+    return ret;
+  }
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  castInput(value, options) {
+    return value;
+  }
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  tokenize(value, options) {
+    return Array.from(value);
+  }
+  join(chars) {
+    return chars.join("");
+  }
+  postProcess(changeObjects, options) {
+    return changeObjects;
+  }
+  get useLongestToken() {
+    return false;
+  }
+  buildValues(lastComponent, newTokens, oldTokens) {
+    const components = [];
+    let nextComponent;
+    while (lastComponent) {
+      components.push(lastComponent);
+      nextComponent = lastComponent.previousComponent;
+      delete lastComponent.previousComponent;
+      lastComponent = nextComponent;
+    }
+    components.reverse();
+    const componentLen = components.length;
+    let componentPos = 0, newPos = 0, oldPos = 0;
+    for (; componentPos < componentLen; componentPos++) {
+      const component = components[componentPos];
+      if (!component.removed) {
+        if (!component.added && this.useLongestToken) {
+          let value = newTokens.slice(newPos, newPos + component.count);
+          value = value.map(function(value2, i2) {
+            const oldValue = oldTokens[oldPos + i2];
+            return oldValue.length > value2.length ? oldValue : value2;
+          });
+          component.value = this.join(value);
+        } else {
+          component.value = this.join(newTokens.slice(newPos, newPos + component.count));
+        }
+        newPos += component.count;
+        if (!component.added) {
+          oldPos += component.count;
+        }
+      } else {
+        component.value = this.join(oldTokens.slice(oldPos, oldPos + component.count));
+        oldPos += component.count;
+      }
+    }
+    return components;
+  }
+};
+
+// ../../node_modules/.pnpm/diff@9.0.0/node_modules/diff/libesm/diff/line.js
+var LineDiff = class extends Diff {
+  constructor() {
+    super(...arguments);
+    this.tokenize = tokenize;
+  }
+  equals(left, right, options) {
+    if (options.ignoreWhitespace) {
+      if (!options.newlineIsToken || !left.includes("\n")) {
+        left = left.trim();
+      }
+      if (!options.newlineIsToken || !right.includes("\n")) {
+        right = right.trim();
+      }
+    } else if (options.ignoreNewlineAtEof && !options.newlineIsToken) {
+      if (left.endsWith("\n")) {
+        left = left.slice(0, -1);
+      }
+      if (right.endsWith("\n")) {
+        right = right.slice(0, -1);
+      }
+    }
+    return super.equals(left, right, options);
+  }
+};
+var lineDiff = new LineDiff();
+function diffLines(oldStr, newStr, options) {
+  return lineDiff.diff(oldStr, newStr, options);
+}
+function tokenize(value, options) {
+  if (options.stripTrailingCr) {
+    value = value.replace(/\r\n/g, "\n");
+  }
+  const retLines = [], linesAndNewlines = value.split(/(\n|\r\n)/);
+  if (!linesAndNewlines[linesAndNewlines.length - 1]) {
+    linesAndNewlines.pop();
+  }
+  for (let i2 = 0; i2 < linesAndNewlines.length; i2++) {
+    const line = linesAndNewlines[i2];
+    if (i2 % 2 && !options.newlineIsToken) {
+      retLines[retLines.length - 1] += line;
+    } else {
+      retLines.push(line);
+    }
+  }
+  return retLines;
+}
+
+// ../../packages/core/src/place/linemap.ts
+var LINE_MAP_MAX_EDIT_LENGTH = 256;
+function splitLines3(text10) {
+  if (text10 === "") return [];
+  const lines = text10.replace(/\r\n/g, "\n").split("\n");
+  if (lines.at(-1) === "") lines.pop();
+  return lines;
+}
+function lineMap(from, to) {
+  const mapped = [];
+  let oldLine = 1;
+  let newLine = 1;
+  const changes = diffLines(from, to, {
+    stripTrailingCr: true,
+    ignoreNewlineAtEof: true,
+    maxEditLength: LINE_MAP_MAX_EDIT_LENGTH
+  });
+  if (changes === void 0) return () => null;
+  for (const change of changes) {
+    if (change.added) newLine += change.count;
+    else {
+      for (let index2 = 0; index2 < change.count; index2++) {
+        mapped[oldLine++] = change.removed ? null : newLine++;
+      }
+    }
+  }
+  return (line) => Number.isInteger(line) && line > 0 ? mapped[line] ?? null : null;
+}
+
+// ../../packages/core/src/place/lines.ts
+function matches2(lines, start, quote) {
+  return start >= 0 && start + quote.length <= lines.length && quote.every((line, index2) => lines[start + index2] === line);
+}
+function placeLines(target, last, next2) {
+  if (next2 === null) return { status: "unplaced", reason: "file-gone" };
+  const hashKey = target.side === "old" ? "oldHash" : "newHash";
+  const textKey = target.side === "old" ? "oldText" : "newText";
+  const previousText = last.sides[textKey];
+  const nextText = next2[textKey];
+  if (nextText === void 0) return { status: "unplaced", reason: "file-gone" };
+  const lines = splitLines3(nextText);
+  const placed = (start2) => ({
+    status: "placed",
+    location: { kind: "lines", path: target.path, side: target.side, start: start2, end: start2 + target.lines.length - 1 }
+  });
+  const validRange = last.start > 0 && last.end - last.start + 1 === target.lines.length;
+  if (validRange && last.sides[hashKey] !== void 0 && last.sides[hashKey] === next2[hashKey] && matches2(lines, last.start - 1, target.lines))
+    return placed(last.start);
+  if (validRange && previousText !== void 0) {
+    const map4 = lineMap(previousText, nextText);
+    const start2 = map4(last.start);
+    if (start2 !== null && target.lines.every((_3, index2) => map4(last.start + index2) === start2 + index2) && matches2(lines, start2 - 1, target.lines))
+      return placed(start2);
+  }
+  const sequence = [...target.before, ...target.lines, ...target.after];
+  const found = firstTwoMatches(lines, sequence);
+  if (found.length > 1) return { status: "unplaced", reason: "ambiguous" };
+  const start = found[0];
+  return start === void 0 ? { status: "unplaced", reason: "lines-gone" } : placed(start + target.before.length + 1);
+}
+
+// ../../packages/core/src/place/place.ts
+function placeThread(target, ctx) {
+  const last = ctx.last?.location;
+  switch (target.kind) {
+    case "review":
+      return { status: "placed", location: { kind: "review" } };
+    case "topic":
+      return ctx.topics.has(target.slug) ? { status: "placed", location: { kind: "topic", slug: target.slug } } : { status: "unplaced", reason: "topic-gone" };
+    case "writeup-span":
+      return placeSpan(ctx.writeup, {
+        ...target,
+        blockId: last?.kind === "writeup-span" ? last.blockId : target.blockId
+      });
+    default: {
+      const previousPath = last?.kind === target.kind && "path" in last ? last.path : target.path;
+      const renamed = ctx.renamedFrom.get(previousPath);
+      if (renamed === null) return { status: "unplaced", reason: "file-gone" };
+      const path2 = renamed ?? previousPath;
+      if (target.kind === "file") {
+        return ctx.files.has(path2) ? { status: "placed", location: { kind: "file", path: path2 } } : { status: "unplaced", reason: "file-gone" };
+      }
+      if (target.kind === "lines") {
+        const previous3 = last?.kind === "lines" && last.side === target.side ? last : target;
+        return placeLines(
+          { ...target, path: path2 },
+          {
+            start: previous3.start,
+            end: previous3.end,
+            sides: ctx.last?.sides ?? {}
+          },
+          ctx.files.get(path2) ?? null
+        );
+      }
+      const doc = ctx.docs.get(path2);
+      if (!doc) return { status: "unplaced", reason: "file-gone" };
+      if (target.kind === "html-span") {
+        return doc.kind === "html" ? placeHtmlSpan(doc.text, { ...target, path: path2 }) : { status: "unplaced", reason: "block-gone" };
+      }
+      return doc.kind === "markdown" ? placeSpan(doc.blocks, { ...target, path: path2, blockId: last?.kind === "doc-span" ? last.blockId : target.blockId }) : { status: "unplaced", reason: "block-gone" };
+    }
+  }
 }
-async function renderDoc(markdown2, path2, repoUrl) {
-  return renderMarkdown(markdown2, `doc-${await blockHash(path2)}`, repoUrl);
+
+// ../../packages/core/src/place/renames.ts
+function composeRenames(steps) {
+  const composed = /* @__PURE__ */ new Map();
+  for (let index2 = steps.length - 1; index2 >= 0; index2--) {
+    const step = steps[index2];
+    if (!step) continue;
+    const pending = [];
+    for (const [from, to] of step) {
+      const next2 = to === null ? null : composed.get(to);
+      pending.push([from, next2 === void 0 ? to : next2]);
+    }
+    for (const [from, to] of pending) composed.set(from, to);
+  }
+  return composed;
 }
 
 // ../../packages/core/src/render/writeup.ts
@@ -55566,7 +55808,16 @@ async function renderWriteup(writeup, topics, meta3 = {}) {
       key: key2,
       label,
       topic,
-      blocks: await renderMarkdownWithBudget(markdown2, key2, highlightBudget, meta3.repoUrl, meta3.media)
+      blocks: await renderMarkdownWithBudget(
+        markdown2,
+        key2,
+        highlightBudget,
+        meta3.repoUrl,
+        meta3.media,
+        meta3.docs,
+        "",
+        meta3.effects
+      )
     });
   };
   await append("overview", "Overview", writeup.overview);
@@ -55595,15 +55846,26 @@ var parse7 = (bytes, format) => {
   const value = JSON.parse(decode4(bytes));
   return format === "writeup" ? value.sections.flatMap((s3) => s3.blocks) : value;
 };
-function serializeRendered(value) {
+function serializeRendered(value, pathDependent = false) {
   const blocks = Array.isArray(value) ? value : value.sections.flatMap((s3) => s3.blocks);
   return {
     bytes: new TextEncoder().encode(JSON.stringify(value)).buffer,
     ids: new TextEncoder().encode(blocks.map(({ id: id2 }) => id2).join("\n")).buffer,
-    count: blocks.length
+    count: blocks.length,
+    pathDependent
   };
 }
 var executeWork = async (work) => {
+  if (work.kind === "doc-metadata") {
+    if (work.format === "html")
+      return {
+        kind: "doc-metadata",
+        title: await inferDocTitle("html", new Uint8Array(work.bytes)),
+        headings: htmlHeadings(decode4(work.bytes))
+      };
+    const blocks = await renderMetadataBlocks(decode4(work.bytes));
+    return { kind: "doc-metadata", title: markdownTitle(blocks), headings: markdownHeadings(blocks) };
+  }
   if (work.kind === "line-count") {
     const bytes = new Uint8Array(work.bytes);
     let count = bytes.length && bytes.at(-1) !== 10 ? 1 : 0;
@@ -55627,19 +55889,29 @@ var executeWork = async (work) => {
     const bytes = encoder3.encode(JSON.stringify(doc)).buffer;
     return { kind: "placement-doc", bytes, textBytes, encodedBytes: bytes.byteLength };
   }
-  if (work.kind === "writeup")
+  if (work.kind === "writeup") {
+    const effects = {};
+    const rendered = await renderWriteup(work.source, work.topics, {
+      links: work.links,
+      repoUrl: work.repoUrl,
+      media: new Map(work.media),
+      docs: work.docs,
+      effects
+    });
     return {
       kind: "writeup",
-      ...serializeRendered(
-        await renderWriteup(work.source, work.topics, {
-          links: work.links,
-          repoUrl: work.repoUrl,
-          media: new Map(work.media)
-        })
-      )
+      ...serializeRendered(rendered, effects.docBaseUsed)
+    };
+  }
+  if (work.kind === "doc") {
+    const effects = {};
+    const blocks = await renderDoc(decode4(work.source), work.path, work.repoUrl, work.docs, effects);
+    return {
+      kind: "doc",
+      ...serializeRendered(blocks, effects.docBaseUsed),
+      selfDependent: effects.docPathUsed
     };
-  if (work.kind === "doc")
-    return { kind: "doc", ...serializeRendered(await renderDoc(decode4(work.source), work.path, work.repoUrl)) };
+  }
   if (work.kind === "comment-md") {
     const html7 = [];
     for (const body3 of work.bodies) {
@@ -55677,8 +55949,8 @@ var executeWork = async (work) => {
     }
     return doc;
   };
-  const docs = /* @__PURE__ */ new Map();
-  for (const [path2, encoded] of work.parsedDocs ?? []) docs.set(path2, placementDoc(encoded));
+  const docs2 = /* @__PURE__ */ new Map();
+  for (const [path2, encoded] of work.parsedDocs ?? []) docs2.set(path2, placementDoc(encoded));
   const decoded = /* @__PURE__ */ new Map();
   const text10 = (hash2) => {
     const cached2 = decoded.get(hash2);
@@ -55697,9 +55969,9 @@ var executeWork = async (work) => {
   for (const [path2, doc] of work.docs) {
     if (doc.kind === "html") {
       if (!htmlTexts.has(doc.hash)) htmlTexts.set(doc.hash, docText(text10(doc.hash)));
-      docs.set(path2, { kind: "html", text: htmlTexts.get(doc.hash) ?? null });
+      docs2.set(path2, { kind: "html", text: htmlTexts.get(doc.hash) ?? null });
     } else
-      docs.set(path2, {
+      docs2.set(path2, {
         kind: "markdown",
         blocks: doc.hash ? parse7(work.texts.get(doc.hash) ?? new ArrayBuffer(0), "doc") : []
       });
@@ -55719,7 +55991,7 @@ var executeWork = async (work) => {
         id: thread.id,
         placement: placeThread(target, {
           writeup,
-          docs,
+          docs: docs2,
           files,
           topics: work.topics,
           last: thread.last && carriedLocation ? { location: carriedLocation, sides: thread.last.sides ? sides(thread.last.sides) : void 0 } : null,
@@ -55731,9 +56003,14 @@ var executeWork = async (work) => {
 };
 
 // src/server/publish/worker.ts
+var docs;
 parentPort?.on("message", async (work) => {
+  if (work.kind === "doc-context") {
+    docs = work.docs;
+    return;
+  }
   try {
-    const result = await executeWork(work);
+    const result = await executeWork(work.kind === "doc" || work.kind === "writeup" ? { ...work, docs } : work);
     parentPort?.postMessage(
       { ok: true, result },
       "ids" in result ? [result.bytes, result.ids] : "bytes" in result ? [result.bytes] : []