idcmd 0.0.1 → 0.0.3

package/templates/default/site/public/_idcmd/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/templates/default/site/public/_idcmd/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/templates/default/site/public/_idcmd/nav-prefetch.js

@@ -0,0 +1,30 @@
+(() => {
+  const selector = 'a[data-prefetch="hover"][href]';
+  const prefetched = new Set();
+
+  const prefetch = (href) => {
+    if (!href || prefetched.has(href)) {
+      return;
+    }
+    prefetched.add(href);
+
+    const link = document.createElement("link");
+    link.rel = "prefetch";
+    link.href = href;
+    document.head.append(link);
+  };
+
+  const onOver = (event) => {
+    const { target } = event;
+    if (!(target instanceof Element)) {
+      return;
+    }
+    const link = target.closest(selector);
+    if (!(link instanceof HTMLAnchorElement)) {
+      return;
+    }
+    prefetch(link.href);
+  };
+
+  document.addEventListener("mouseover", onOver, { passive: true });
+})();

package/templates/default/site/public/_idcmd/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/templates/default/site/public/anthropic-white.svg

@@ -0,0 +1,16 @@
+<svg version="1.1" id="Layer_1" xmlns:x="ns_extend;" xmlns:i="ns_ai;" xmlns:graph="ns_graphs;" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" x="0px" y="0px" viewBox="0 0 92.2 65" style="enable-background:new 0 0 92.2 65;" xml:space="preserve">
+ <style type="text/css">
+  .st0{fill:#FFFFFF;}
+ </style>
+ <metadata>
+  <sfw xmlns="ns_sfw;">
+   <slices>
+   </slices>
+   <sliceSourceBounds bottomLeftOrigin="true" height="65" width="92.2" x="-43.7" y="-98">
+   </sliceSourceBounds>
+  </sfw>
+ </metadata>
+ <path class="st0" d="M66.5,0H52.4l25.7,65h14.1L66.5,0z M25.7,0L0,65h14.4l5.3-13.6h26.9L51.8,65h14.4L40.5,0C40.5,0,25.7,0,25.7,0z
+	 M24.3,39.3l8.8-22.8l8.8,22.8H24.3z">
+ </path>
+</svg>

package/templates/default/site/public/favicon.svg

@@ -0,0 +1,13 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 64 64" role="img" aria-label="IDC favicon">
+  <rect width="64" height="64" rx="12" fill="#0B0B0B" />
+  <text
+    x="32"
+    y="40"
+    font-family="JetBrains Mono, ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace"
+    font-size="22"
+    text-anchor="middle"
+    fill="#F9FAFB"
+  >
+    idc
+  </text>
+</svg>

package/templates/default/site/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/templates/default/site/server/routes/api/hello.ts

@@ -0,0 +1,2 @@
+export const GET = (): Response =>
+  Response.json({ message: "Hello from idcmd route!", ok: true });

package/templates/default/site/server/server.ts

@@ -0,0 +1,4 @@
+// Optional: this file is here as the obvious place to put server-side code.
+// V1 runs the built-in idcmd server; add custom endpoints via `site/server/routes/**`.
+
+export const serverPlaceholder = true;

package/templates/default/site/site.jsonc

@@ -0,0 +1,21 @@
+{
+  "name": "__IDCMD_SITE_NAME__",
+  "description": "__IDCMD_SITE_DESCRIPTION__",
+  "baseUrl": "__IDCMD_SITE_BASE_URL__",
+  "groups": [{ "id": "main", "label": "Navigation", "order": 1 }],
+  "search": {
+    "scope": "full",
+  },
+  "rightRail": {
+    "enabled": true,
+    "visibleFrom": "xl",
+    "placement": "viewport",
+    "tocLevels": [2, 3],
+    "smoothScroll": false,
+    "scrollSpy": {
+      "enabled": true,
+      "centerActiveItem": true,
+      "updateHash": "never",
+    },
+  },
+}