idcmd 0.0.1 → 0.0.2

package/public/live-reload.js

@@ -0,0 +1,18 @@
+(() => {
+  const protocol = location.protocol === "https:" ? "wss:" : "ws:";
+  const socket = new WebSocket(
+    `${protocol}//${location.host}/_idcmd/live-reload`
+  );
+
+  socket.addEventListener("message", (event) => {
+    if (event.data === "reload") {
+      location.reload();
+    }
+  });
+
+  socket.addEventListener("close", () => {
+    setTimeout(() => {
+      location.reload();
+    }, 1000);
+  });
+})();

package/public/llm-menu.js

@@ -0,0 +1,153 @@
+const COPY_SELECTOR = 'a[data-copy-markdown="1"]';
+const LABEL_SELECTOR = '[data-copy-markdown-label="1"]';
+const RESET_DELAY_MS = 2000;
+
+const setLinkDisabled = (link, disabled) => {
+  if (disabled) {
+    link.setAttribute("aria-disabled", "true");
+    link.style.pointerEvents = "none";
+    link.style.opacity = "0.8";
+    return;
+  }
+
+  link.removeAttribute("aria-disabled");
+  link.style.pointerEvents = "";
+  link.style.opacity = "";
+};
+
+const setLinkLabel = (link, next) => {
+  const label = link.querySelector(LABEL_SELECTOR);
+  if (label) {
+    label.textContent = next;
+  }
+};
+
+const toAbsoluteUrl = (href) => {
+  try {
+    return new URL(href, window.location.href).toString();
+  } catch {
+    return href;
+  }
+};
+
+const createHiddenTextarea = (text) => {
+  const textarea = document.createElement("textarea");
+  textarea.value = text;
+  textarea.setAttribute("readonly", "true");
+  textarea.style.position = "fixed";
+  textarea.style.left = "-9999px";
+  textarea.style.top = "0";
+  return textarea;
+};
+
+const safeExecCommandCopy = () => {
+  try {
+    return document.execCommand("copy");
+  } catch {
+    return false;
+  }
+};
+
+const copyViaExecCommand = (text) => {
+  const textarea = createHiddenTextarea(text);
+  document.body.append(textarea);
+  textarea.focus();
+  textarea.select();
+  const ok = safeExecCommandCopy();
+  textarea.remove();
+  return ok;
+};
+
+const copyText = async (text) => {
+  const { clipboard } = navigator;
+  if (clipboard?.writeText) {
+    try {
+      await clipboard.writeText(text);
+      return true;
+    } catch {
+      // Fall back below.
+    }
+  }
+
+  return copyViaExecCommand(text);
+};
+
+const closeMenuIfPresent = (link) => {
+  const details = link.closest("details");
+  if (details instanceof HTMLDetailsElement) {
+    details.open = false;
+  }
+};
+
+const getOriginalLabel = (link) =>
+  link.querySelector(LABEL_SELECTOR)?.textContent ??
+  "Copy Markdown to Clipboard";
+
+const fetchMarkdownText = async (href) => {
+  const res = await fetch(toAbsoluteUrl(href), { credentials: "same-origin" });
+  if (!res.ok) {
+    return null;
+  }
+  return res.text();
+};
+
+const copyMarkdownFromHref = async (href) => {
+  try {
+    const text = await fetchMarkdownText(href);
+    if (!text) {
+      return false;
+    }
+    return copyText(text);
+  } catch {
+    return false;
+  }
+};
+
+const startCopyOperation = (link) => {
+  setLinkDisabled(link, true);
+  setLinkLabel(link, "Copying...");
+};
+
+const finishCopyOperation = (link, ok) => {
+  setLinkLabel(link, ok ? "Copied" : "Copy failed");
+  closeMenuIfPresent(link);
+};
+
+const scheduleResetOperation = (link, originalLabel) => {
+  window.setTimeout(() => {
+    setLinkLabel(link, originalLabel);
+    setLinkDisabled(link, false);
+  }, RESET_DELAY_MS);
+};
+
+const handleCopyClick = async (link, originalLabel) => {
+  const href = link.getAttribute("href");
+  if (!href) {
+    return;
+  }
+
+  startCopyOperation(link);
+  const ok = await copyMarkdownFromHref(href);
+  finishCopyOperation(link, ok);
+  scheduleResetOperation(link, originalLabel);
+};
+
+const attachCopyHandler = (link) => {
+  const originalLabel = getOriginalLabel(link);
+  link.addEventListener("click", async (event) => {
+    event.preventDefault();
+    if (link.getAttribute("aria-disabled") === "true") {
+      return;
+    }
+    await handleCopyClick(link, originalLabel);
+  });
+};
+
+const initCopyMarkdownButtons = () => {
+  const links = [...document.querySelectorAll(COPY_SELECTOR)];
+  for (const link of links) {
+    attachCopyHandler(link);
+  }
+};
+
+initCopyMarkdownButtons();

package/public/openai-black.svg

@@ -0,0 +1,15 @@
+<svg width="721" height="721" viewBox="0 0 721 721" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_1637_2934)">
+<g clip-path="url(#clip1_1637_2934)">
+<path d="M304.246 294.611V249.028C304.246 245.189 305.687 242.309 309.044 240.392L400.692 187.612C413.167 180.415 428.042 177.058 443.394 177.058C500.971 177.058 537.44 221.682 537.44 269.182C537.44 272.54 537.44 276.379 536.959 280.218L441.954 224.558C436.197 221.201 430.437 221.201 424.68 224.558L304.246 294.611ZM518.245 472.145V363.224C518.245 356.505 515.364 351.707 509.608 348.349L389.174 278.296L428.519 255.743C431.877 253.826 434.757 253.826 438.115 255.743L529.762 308.523C556.154 323.879 573.905 356.505 573.905 388.171C573.905 424.636 552.315 458.225 518.245 472.141V472.145ZM275.937 376.182L236.592 353.152C233.235 351.235 231.794 348.354 231.794 344.515V238.956C231.794 187.617 271.139 148.749 324.4 148.749C344.555 148.749 363.264 155.468 379.102 167.463L284.578 222.164C278.822 225.521 275.942 230.319 275.942 237.039V376.186L275.937 376.182ZM360.626 425.122L304.246 393.455V326.283L360.626 294.616L417.002 326.283V393.455L360.626 425.122ZM396.852 570.989C376.698 570.989 357.989 564.27 342.151 552.276L436.674 497.574C442.431 494.217 445.311 489.419 445.311 482.699V343.552L485.138 366.582C488.495 368.499 489.936 371.379 489.936 375.219V480.778C489.936 532.117 450.109 570.985 396.852 570.985V570.989ZM283.134 463.99L191.486 411.211C165.094 395.854 147.343 363.229 147.343 331.562C147.343 294.616 169.415 261.509 203.48 247.593V356.991C203.48 363.71 206.361 368.508 212.117 371.866L332.074 441.437L292.729 463.99C289.372 465.907 286.491 465.907 283.134 463.99ZM277.859 542.68C223.639 542.68 183.813 501.895 183.813 451.514C183.813 447.675 184.294 443.836 184.771 439.997L279.295 494.698C285.051 498.056 290.812 498.056 296.568 494.698L417.002 425.127V470.71C417.002 474.549 415.562 477.429 412.204 479.346L320.557 532.126C308.081 539.323 293.206 542.68 277.854 542.68H277.859ZM396.852 599.776C454.911 599.776 503.37 558.513 514.41 503.812C568.149 489.896 602.696 439.515 602.696 388.176C602.696 354.587 588.303 321.962 562.392 298.45C564.791 288.373 566.231 278.296 566.231 268.224C566.231 199.611 510.571 148.267 446.274 148.267C433.322 148.267 420.846 150.184 408.37 154.505C386.775 133.392 357.026 119.958 324.4 119.958C266.342 119.958 217.883 161.22 206.843 215.921C153.104 229.837 118.557 280.218 118.557 331.557C118.557 365.146 132.95 397.771 158.861 421.283C156.462 431.36 155.022 441.437 155.022 451.51C155.022 520.123 210.682 571.466 274.978 571.466C287.931 571.466 300.407 569.549 312.883 565.228C334.473 586.341 364.222 599.776 396.852 599.776Z" fill="black"/>
+</g>
+</g>
+<defs>
+<clipPath id="clip0_1637_2934">
+<rect width="720" height="720" fill="white" transform="translate(0.606934 0.0999756)"/>
+</clipPath>
+<clipPath id="clip1_1637_2934">
+<rect width="484.139" height="479.818" fill="white" transform="translate(118.557 119.958)"/>
+</clipPath>
+</defs>
+</svg>

package/public/openai-white.svg

@@ -0,0 +1,15 @@
+<svg width="721" height="721" viewBox="0 0 721 721" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_1637_2935)">
+<g clip-path="url(#clip1_1637_2935)">
+<path d="M304.246 295.411V249.828C304.246 245.989 305.687 243.109 309.044 241.191L400.692 188.412C413.167 181.215 428.042 177.858 443.394 177.858C500.971 177.858 537.44 222.482 537.44 269.982C537.44 273.34 537.44 277.179 536.959 281.018L441.954 225.358C436.197 222 430.437 222 424.68 225.358L304.246 295.411ZM518.245 472.945V364.024C518.245 357.304 515.364 352.507 509.608 349.149L389.174 279.096L428.519 256.543C431.877 254.626 434.757 254.626 438.115 256.543L529.762 309.323C556.154 324.679 573.905 357.304 573.905 388.971C573.905 425.436 552.315 459.024 518.245 472.941V472.945ZM275.937 376.982L236.592 353.952C233.235 352.034 231.794 349.154 231.794 345.315V239.756C231.794 188.416 271.139 149.548 324.4 149.548C344.555 149.548 363.264 156.268 379.102 168.262L284.578 222.964C278.822 226.321 275.942 231.119 275.942 237.838V376.986L275.937 376.982ZM360.626 425.922L304.246 394.255V327.083L360.626 295.416L417.002 327.083V394.255L360.626 425.922ZM396.852 571.789C376.698 571.789 357.989 565.07 342.151 553.075L436.674 498.374C442.431 495.017 445.311 490.219 445.311 483.499V344.352L485.138 367.382C488.495 369.299 489.936 372.179 489.936 376.018V481.577C489.936 532.917 450.109 571.785 396.852 571.785V571.789ZM283.134 464.79L191.486 412.01C165.094 396.654 147.343 364.029 147.343 332.362C147.343 295.416 169.415 262.309 203.48 248.393V357.791C203.48 364.51 206.361 369.308 212.117 372.665L332.074 442.237L292.729 464.79C289.372 466.707 286.491 466.707 283.134 464.79ZM277.859 543.48C223.639 543.48 183.813 502.695 183.813 452.314C183.813 448.475 184.294 444.636 184.771 440.797L279.295 495.498C285.051 498.856 290.812 498.856 296.568 495.498L417.002 425.927V471.509C417.002 475.349 415.562 478.229 412.204 480.146L320.557 532.926C308.081 540.122 293.206 543.48 277.854 543.48H277.859ZM396.852 600.576C454.911 600.576 503.37 559.313 514.41 504.612C568.149 490.696 602.696 440.315 602.696 388.976C602.696 355.387 588.303 322.762 562.392 299.25C564.791 289.173 566.231 279.096 566.231 269.024C566.231 200.411 510.571 149.067 446.274 149.067C433.322 149.067 420.846 150.984 408.37 155.305C386.775 134.192 357.026 120.758 324.4 120.758C266.342 120.758 217.883 162.02 206.843 216.721C153.104 230.637 118.557 281.018 118.557 332.357C118.557 365.946 132.95 398.571 158.861 422.083C156.462 432.16 155.022 442.237 155.022 452.309C155.022 520.922 210.682 572.266 274.978 572.266C287.931 572.266 300.407 570.349 312.883 566.028C334.473 587.141 364.222 600.576 396.852 600.576Z" fill="white"/>
+</g>
+</g>
+<defs>
+<clipPath id="clip0_1637_2935">
+<rect width="720" height="720" fill="white" transform="translate(0.606934 0.899902)"/>
+</clipPath>
+<clipPath id="clip1_1637_2935">
+<rect width="484.139" height="479.818" fill="white" transform="translate(118.557 120.758)"/>
+</clipPath>
+</defs>
+</svg>

package/public/right-rail-scrollspy.js

@@ -0,0 +1,262 @@
+const TOC_ROOT_SELECTOR = '[data-toc-root="1"]';
+const TOC_LINK_SELECTOR = 'a[data-toc-link="1"][href^="#"]';
+const TOC_SCROLL_CONTAINER_SELECTOR = '[data-toc-scroll-container="1"]';
+
+const NAVBAR_GAP_PX = 16;
+const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+
+const getTopOffset = () => {
+  const header = document.querySelector("header");
+  const headerHeight = header?.getBoundingClientRect().height ?? 0;
+  return Math.ceil(headerHeight + NAVBAR_GAP_PX);
+};
+
+const decodeAnchorId = (href) => {
+  if (!href?.startsWith("#")) {
+    return null;
+  }
+
+  const raw = href.slice(1);
+  if (!raw) {
+    return null;
+  }
+
+  try {
+    return decodeURIComponent(raw);
+  } catch {
+    return raw;
+  }
+};
+
+const toEntry = (link) => {
+  const id = decodeAnchorId(link.getAttribute("href"));
+  if (!id) {
+    return null;
+  }
+
+  // ids like "11-overview" are valid HTML ids but invalid CSS selectors unless escaped.
+  // eslint-disable-next-line unicorn/prefer-query-selector
+  const heading = document.getElementById(id);
+  if (!heading) {
+    return null;
+  }
+
+  return { heading, link, y: 0 };
+};
+
+const buildEntries = (tocRoot) =>
+  [...tocRoot.querySelectorAll(TOC_LINK_SELECTOR)]
+    .map(toEntry)
+    .filter((entry) => entry !== null);
+
+const measureEntries = (entries) => {
+  for (const entry of entries) {
+    entry.y = entry.heading.getBoundingClientRect().top + window.scrollY;
+  }
+};
+
+const setScrollMarginTop = (topOffset) => {
+  document.documentElement.style.setProperty(
+    "--scroll-margin-top",
+    `${topOffset}px`
+  );
+};
+
+const binarySearchLastAtOrAbove = (entries, anchorLine) => {
+  let lo = 0;
+  let hi = entries.length;
+
+  // Find the first entry with y > anchorLine, then step back one.
+  while (lo < hi) {
+    const mid = Math.floor((lo + hi) / 2);
+    if (entries[mid].y <= anchorLine) {
+      lo = mid + 1;
+    } else {
+      hi = mid;
+    }
+  }
+
+  return lo - 1;
+};
+
+const findActiveIndex = (entries, topOffset) => {
+  const anchorLine = window.scrollY + topOffset + 1;
+  const best = binarySearchLastAtOrAbove(entries, anchorLine);
+  return Math.max(0, best);
+};
+
+const parseTransformValues = (transform, prefix) =>
+  transform
+    .slice(prefix.length, -1)
+    .split(",")
+    .map((value) => Number.parseFloat(value.trim()));
+
+const getNumberAtIndex = (values, index) => {
+  const [value] = values.slice(index, index + 1);
+  return Number.isFinite(value) ? value : 0;
+};
+
+const getMatrix3dTranslateY = (values) => getNumberAtIndex(values, 13);
+
+const getMatrixTranslateY = (values) => getNumberAtIndex(values, 5);
+
+const getComputedTranslateY = (element) => {
+  const { transform } = window.getComputedStyle(element);
+  if (!transform || transform === "none") {
+    return 0;
+  }
+
+  if (transform.startsWith("matrix3d(")) {
+    const values = parseTransformValues(transform, "matrix3d(");
+    return getMatrix3dTranslateY(values);
+  }
+
+  if (transform.startsWith("matrix(")) {
+    const values = parseTransformValues(transform, "matrix(");
+    return getMatrixTranslateY(values);
+  }
+
+  return 0;
+};
+
+const setTranslateY = (element, next) => {
+  element.style.transform = `translate3d(0, ${next}px, 0)`;
+};
+
+const getElementCenterY = (element) => {
+  const rect = element.getBoundingClientRect();
+  return rect.top + rect.height / 2;
+};
+
+const getCenteredTranslateY = (scrollContainer, list, link) => {
+  const containerHeight = scrollContainer.clientHeight;
+  const listHeight = list.scrollHeight;
+
+  if (listHeight <= containerHeight + 1) {
+    return 0;
+  }
+
+  const delta = getElementCenterY(scrollContainer) - getElementCenterY(link);
+  const currentTranslate = getComputedTranslateY(list);
+  const minTranslate = containerHeight - listHeight;
+  return clamp(currentTranslate + delta, minTranslate, 0);
+};
+
+const centerLinkIfNeeded = (state, link) => {
+  const { scrollContainer, tocList } = state;
+  if (!scrollContainer || !tocList) {
+    return;
+  }
+
+  const next = getCenteredTranslateY(scrollContainer, tocList, link);
+  const current = getComputedTranslateY(tocList);
+  if (Math.abs(current - next) < 0.5) {
+    return;
+  }
+
+  setTranslateY(tocList, next);
+};
+
+const setActiveLink = (state, index) => {
+  if (index === state.activeIndex) {
+    return;
+  }
+
+  const previous = state.entries[state.activeIndex];
+  previous?.link.removeAttribute("aria-current");
+
+  state.activeIndex = index;
+  const current = state.entries[state.activeIndex];
+  current.link.setAttribute("aria-current", "location");
+
+  if (state.centerActiveItem) {
+    centerLinkIfNeeded(state, current.link);
+  }
+};
+
+const updateActive = (state) => {
+  setActiveLink(state, findActiveIndex(state.entries, state.topOffset));
+};
+
+const scheduleUpdate = (state) => {
+  if (state.isTicking) {
+    return;
+  }
+
+  state.isTicking = true;
+  requestAnimationFrame(() => {
+    state.isTicking = false;
+    updateActive(state);
+  });
+};
+
+const refreshLayout = (state) => {
+  state.topOffset = getTopOffset();
+  setScrollMarginTop(state.topOffset);
+  measureEntries(state.entries);
+  updateActive(state);
+
+  if (state.centerActiveItem) {
+    const current = state.entries[state.activeIndex];
+    if (current) {
+      centerLinkIfNeeded(state, current.link);
+    }
+  }
+};
+
+const createState = () => {
+  const { body } = document;
+  const tocRoot = document.querySelector(TOC_ROOT_SELECTOR);
+  const entries = tocRoot ? buildEntries(tocRoot) : [];
+  if (
+    !body ||
+    body.dataset.scrollspy !== "1" ||
+    !tocRoot ||
+    entries.length === 0
+  ) {
+    return null;
+  }
+
+  const centerActiveItem = body.dataset.scrollspyCenter === "1";
+  const scrollContainer = tocRoot.querySelector(TOC_SCROLL_CONTAINER_SELECTOR);
+  const tocList = scrollContainer?.querySelector("ul") ?? null;
+
+  return {
+    activeIndex: -1,
+    centerActiveItem,
+    entries,
+    isTicking: false,
+    scrollContainer,
+    tocList,
+    topOffset: getTopOffset(),
+  };
+};
+
+const start = (state) => {
+  // Disable independent TOC scrolling whenever scrollspy is active.
+  // The TOC list position is controlled by JS (either centered or left as-is).
+  document.body.dataset.tocFollow = "1";
+
+  window.addEventListener("scroll", () => scheduleUpdate(state), {
+    passive: true,
+  });
+  window.addEventListener("resize", () => refreshLayout(state));
+  window.addEventListener("load", () => {
+    refreshLayout(state);
+    setTimeout(() => refreshLayout(state), 250);
+    setTimeout(() => refreshLayout(state), 1000);
+  });
+
+  refreshLayout(state);
+};
+
+const init = () => {
+  const state = createState();
+  if (!state) {
+    return;
+  }
+
+  start(state);
+};
+
+init();

package/src/build.ts

@@ -0,0 +1,230 @@
+import { expandMarkdownForAgent } from "./content/components/expand";
+import { generateLlmsTxt } from "./content/llms";
+import { discoverNavigation } from "./content/navigation";
+import { scanContentFiles, slugFromContentFile } from "./content/paths";
+import { getProjectPaths } from "./project/paths";
+import { renderDocument, renderMarkdownPage } from "./render/page-renderer";
+import { generateSearchIndexFromContent } from "./search/index";
+import { renderSearchPageContent } from "./search/page";
+import {
+  collectSitemapPagesFromContent,
+  generateRobotsTxt,
+  generateSitemapXml,
+} from "./seo/files";
+import { loadSiteConfig, resolveRightRailConfig } from "./site/config";
+import { resolveCanonicalUrl } from "./site/urls";
+
+const MAX_INDEX_BYTES = 5 * 1024 * 1024;
+const MAX_BUILD_SECONDS = 60;
+const MIN_SEARCH_QUERY_LENGTH = 2;
+
+const project = await getProjectPaths();
+
+// Find all content files in `content/` (`content/<slug>.md`).
+const contentFiles: string[] = [];
+
+const buildStart = performance.now();
+
+for await (const file of scanContentFiles()) {
+  contentFiles.push(file);
+}
+
+console.log(`Found ${contentFiles.length} content pages`);
+
+const siteConfig = await loadSiteConfig();
+
+// Discover navigation once for all pages
+console.log("Discovering navigation...");
+const navigation = await discoverNavigation();
+console.log(
+  `Found ${navigation.length} groups with ${navigation.reduce((acc, g) => acc + g.items.length, 0)} total pages`
+);
+
+// Ensure dist directory exists
+await Bun.write(`${project.distDir}/.gitkeep`, "");
+
+const shouldCopyPublicPath = (relativePath: string): boolean =>
+  // Do not overwrite the minified `dist/styles.css` produced by `build:css`.
+  relativePath !== "styles.css";
+
+const copyPublicFileToDist = async (relativePath: string): Promise<void> => {
+  const file = Bun.file(`${project.publicDir}/${relativePath}`);
+  if (!(await file.exists())) {
+    return;
+  }
+  await Bun.write(`${project.distDir}/${relativePath}`, file);
+};
+
+const copyPublicToDist = async (): Promise<void> => {
+  const publicFiles = new Bun.Glob("**/*").scan(project.publicDir);
+  for await (const relativePath of publicFiles) {
+    if (shouldCopyPublicPath(relativePath)) {
+      await copyPublicFileToDist(relativePath);
+    }
+  }
+};
+
+const writeMarkdownOutputs = async (
+  slug: string,
+  markdown: string
+): Promise<void> => {
+  const flatMarkdownPath =
+    slug === "index"
+      ? `${project.distDir}/index.md`
+      : `${project.distDir}/${slug}.md`;
+
+  const expanded = await expandMarkdownForAgent(markdown, {
+    currentPath: slug === "index" ? "/" : `/${slug}/`,
+    instanceId: `${slug}:build-md`,
+    isDev: false,
+    slug,
+  });
+
+  await Bun.write(flatMarkdownPath, expanded);
+  console.log(`  markdown -> ${flatMarkdownPath}`);
+};
+
+await copyPublicToDist();
+
+const resolveCssSource = async (): Promise<string | null> => {
+  if (await Bun.file(`${project.distDir}/styles.css`).exists()) {
+    return `${project.distDir}/styles.css`;
+  }
+  if (await Bun.file(`${project.publicDir}/styles.css`).exists()) {
+    return `${project.publicDir}/styles.css`;
+  }
+  return null;
+};
+
+const cssSource = await resolveCssSource();
+const inlineCss = cssSource ? await Bun.file(cssSource).text() : undefined;
+const cssPath = inlineCss ? undefined : "/styles.css";
+
+const renderStaticSearchPage = (): Promise<string> => {
+  const topPages = navigation
+    .flatMap((group) => group.items)
+    .slice(0, 8)
+    .map((item) => ({ href: item.href, title: item.title }));
+
+  const contentHtml = renderSearchPageContent({
+    minQueryLength: MIN_SEARCH_QUERY_LENGTH,
+    query: "",
+    results: [],
+    topPages,
+  });
+
+  const rightRail = resolveRightRailConfig(siteConfig.rightRail);
+  const canonicalUrl = resolveCanonicalUrl(
+    { configuredBaseUrl: siteConfig.baseUrl, isDev: false },
+    "/search/"
+  );
+
+  return renderDocument({
+    canonicalUrl,
+    contentHtml,
+    cssPath,
+    currentPath: "/search/",
+    description: siteConfig.description,
+    inlineCss,
+    navigation,
+    rightRail,
+    searchQuery: "",
+    showRightRail: false,
+    siteName: siteConfig.name,
+    title: `Search - ${siteConfig.name}`,
+    tocItems: [],
+  });
+};
+
+await Bun.write(
+  `${project.distDir}/search/index.html`,
+  await renderStaticSearchPage()
+);
+console.log(`  generated ${project.distDir}/search/index.html`);
+
+for (const file of contentFiles) {
+  const filePath = `${project.contentDir}/${file}`;
+  const markdown = await Bun.file(filePath).text();
+
+  const slug = slugFromContentFile(file);
+  const currentPath = slug === "index" ? "/" : `/${slug}/`;
+
+  const html = await renderMarkdownPage(markdown, {
+    cssPath,
+    currentPath,
+    inlineCss,
+    navigation,
+    siteConfig,
+  });
+
+  let outPath: string;
+  if (slug === "index") {
+    outPath = `${project.distDir}/index.html`;
+  } else if (slug === "404") {
+    outPath = `${project.distDir}/404.html`;
+  } else {
+    outPath = `${project.distDir}/${slug}/index.html`;
+  }
+
+  await Bun.write(outPath, html);
+  console.log(`  ${filePath} -> ${outPath}`);
+  await writeMarkdownOutputs(slug, markdown);
+
+  if (slug === "404") {
+    const nested404Path = `${project.distDir}/404/index.html`;
+    await Bun.write(nested404Path, html);
+    console.log(`  ${filePath} -> ${nested404Path}`);
+  }
+}
+
+const llmsTxt = await generateLlmsTxt();
+await Bun.write(`${project.distDir}/llms.txt`, llmsTxt);
+console.log(`  generated ${project.distDir}/llms.txt`);
+
+const searchIndex = await generateSearchIndexFromContent({ siteConfig });
+await Bun.write(
+  `${project.distDir}/search-index.json`,
+  JSON.stringify(searchIndex)
+);
+const searchIndexBytes = Bun.file(`${project.distDir}/search-index.json`).size;
+console.log(
+  `  generated dist/search-index.json (${(searchIndexBytes / (1024 * 1024)).toFixed(2)} MB)`
+);
+if (searchIndexBytes > MAX_INDEX_BYTES) {
+  console.warn(
+    `Warning: search index exceeds target of 5 MB (${searchIndexBytes} bytes)`
+  );
+}
+
+if (siteConfig.baseUrl) {
+  const sitemapPages = await collectSitemapPagesFromContent();
+  await Bun.write(
+    `${project.distDir}/sitemap.xml`,
+    generateSitemapXml(sitemapPages, siteConfig.baseUrl)
+  );
+  console.log(`  generated ${project.distDir}/sitemap.xml`);
+
+  await Bun.write(
+    `${project.distDir}/robots.txt`,
+    generateRobotsTxt(siteConfig.baseUrl)
+  );
+  console.log(`  generated ${project.distDir}/robots.txt`);
+} else {
+  console.log(
+    "Warning: site.jsonc missing baseUrl; skipping sitemap.xml and robots.txt."
+  );
+}
+
+if (cssSource) {
+  console.log(`Using CSS from ${cssSource}`);
+} else {
+  console.log("Warning: No styles.css found. Run build:css first.");
+}
+
+const buildSeconds = (performance.now() - buildStart) / 1000;
+console.log(`Build duration: ${buildSeconds.toFixed(2)}s`);
+if (buildSeconds > MAX_BUILD_SECONDS) {
+  console.warn(`Warning: build exceeds target of ${MAX_BUILD_SECONDS}s`);
+}
+
+console.log("\nBuild complete!");