projview 0.1.0

package/public/style.css

@@ -0,0 +1,551 @@
+/* ---- projview: soft dark + a little cartoonish (catppuccin-mocha-ish) ---- */
+
+:root {
+  --base: #1e1e2e;
+  --mantle: #181825;
+  --crust: #11111b;
+  --surface0: #2a2b3c;
+  --surface1: #393a4d;
+  --surface2: #494b63;
+  --text: #cdd6f4;
+  --subtext: #a6adc8;
+  --overlay: #6c7086;
+  --lavender: #b4befe;
+  --mauve: #cba6f7;
+  --peach: #fab387;
+  --green: #a6e3a1;
+  --blue: #89b4fa;
+  --pink: #f5c2e7;
+  --red: #f38ba8;
+
+  --radius: 16px;
+  --radius-sm: 10px;
+  --font: "SF Pro Rounded", ui-rounded, "Nunito", "Quicksand", system-ui, -apple-system, sans-serif;
+  --mono: "JetBrains Mono", "Fira Code", ui-monospace, SFMono-Regular, Menlo, monospace;
+  --shadow: 0 6px 20px rgba(0, 0, 0, 0.35);
+  --shadow-sm: 0 3px 10px rgba(0, 0, 0, 0.28);
+}
+
+* { box-sizing: border-box; }
+
+html, body {
+  margin: 0;
+  height: 100%;
+  background: var(--base);
+  color: var(--text);
+  font-family: var(--font);
+  font-size: 15px;
+  line-height: 1.6;
+}
+
+body {
+  display: flex;
+  overflow: hidden;
+}
+
+/* ---------------- sidebar ---------------- */
+
+#sidebar {
+  width: 300px;
+  flex: 0 0 300px;
+  height: 100vh;
+  background: var(--mantle);
+  border-right: 2px solid var(--surface0);
+  display: flex;
+  flex-direction: column;
+}
+
+#brand {
+  display: flex;
+  align-items: center;
+  gap: 12px;
+  padding: 18px 16px;
+  border-bottom: 2px solid var(--surface0);
+}
+
+#brand .logo {
+  font-size: 28px;
+  filter: drop-shadow(0 2px 4px rgba(0, 0, 0, 0.4));
+}
+
+.brand-text { display: flex; flex-direction: column; line-height: 1.2; }
+.brand-text strong { font-size: 17px; color: var(--lavender); letter-spacing: 0.2px; }
+
+#live-status {
+  display: inline-flex;
+  align-items: center;
+  gap: 6px;
+  color: var(--green);
+  font-size: 12px;
+  font-weight: 600;
+}
+#live-status .dot {
+  width: 8px; height: 8px; border-radius: 50%;
+  background: var(--green);
+  box-shadow: 0 0 8px var(--green);
+  transition: background 0.2s, box-shadow 0.2s;
+}
+#live-status.off { color: var(--overlay); }
+#live-status .dot.off { background: var(--overlay); box-shadow: none; }
+#live-status.pulse .dot { animation: blip 0.6s ease; }
+@keyframes blip {
+  0% { transform: scale(1); }
+  40% { transform: scale(2.2); }
+  100% { transform: scale(1); }
+}
+
+.open-palette {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  width: calc(100% - 24px);
+  margin: 12px;
+  padding: 8px 10px;
+  border: 2px solid var(--surface0);
+  border-radius: var(--radius-sm);
+  background: var(--base);
+  color: var(--overlay);
+  font-family: inherit;
+  font-size: 13px;
+  cursor: pointer;
+  transition: border-color 0.15s ease, color 0.15s ease;
+}
+.open-palette:hover { border-color: var(--mauve); color: var(--subtext); }
+.open-palette .op-ico { font-size: 12px; }
+.open-palette .op-text { flex: 1; text-align: left; }
+.open-palette kbd, .palette kbd {
+  font-family: var(--mono);
+  font-size: 10px;
+  background: var(--surface0);
+  color: var(--subtext);
+  border-radius: 5px;
+  padding: 2px 5px;
+}
+
+.tree {
+  flex: 1;
+  overflow-y: auto;
+  padding: 4px 8px 10px;
+}
+
+#side-foot {
+  padding: 10px 16px;
+  border-top: 2px solid var(--surface0);
+  color: var(--overlay);
+  font-size: 11px;
+}
+
+/* tree rows */
+.row {
+  display: flex;
+  align-items: center;
+  gap: 7px;
+  width: 100%;
+  padding: 5px 8px;
+  margin: 1px 0;
+  border: none;
+  border-radius: 8px;
+  background: transparent;
+  color: var(--subtext);
+  font-family: inherit;
+  font-size: 13px;
+  text-align: left;
+  cursor: pointer;
+  transition: background 0.13s ease, color 0.13s ease;
+}
+.row:hover { background: var(--surface0); color: var(--text); }
+.row .twist { flex: 0 0 12px; color: var(--overlay); font-size: 9px; text-align: center; }
+.row .ico { flex: 0 0 15px; height: 15px; display: inline-flex; align-items: center; }
+.row .ico svg { width: 15px; height: 15px; }
+.row.dir .ico { color: var(--subtext); }
+.row .ico-md { color: var(--overlay); }
+.row .ico-mmd { color: var(--mauve); }
+.row .label { overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
+.row.dir .label { font-weight: 600; color: var(--text); }
+
+.row.file.active {
+  background: linear-gradient(90deg, var(--mauve), var(--lavender));
+  color: var(--crust);
+  font-weight: 700;
+  box-shadow: var(--shadow-sm);
+}
+.row.file.active .ico { color: var(--crust); }
+
+/* nested indentation with guide lines */
+.children {
+  margin-left: 15px;
+  border-left: 1px solid var(--surface0);
+  padding-left: 3px;
+}
+
+/* ---------------- viewer ---------------- */
+
+#viewer {
+  flex: 1;
+  height: 100vh;
+  overflow-y: auto;
+  position: relative;
+}
+
+#breadcrumb {
+  position: sticky;
+  top: 0;
+  z-index: 5;
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 3px;
+  padding: 12px 40px;
+  background: rgba(30, 30, 46, 0.92);
+  backdrop-filter: blur(6px);
+  -webkit-backdrop-filter: blur(6px);
+  border-bottom: 1px solid var(--surface0);
+  font-size: 12.5px;
+}
+.crumb { background: none; border: none; font: inherit; color: var(--subtext); padding: 2px 5px; border-radius: 6px; }
+.crumb.root { color: var(--overlay); }
+.crumb.dir { cursor: pointer; }
+.crumb.dir:hover { color: var(--lavender); background: var(--surface0); }
+.crumb.current { color: var(--lavender); font-weight: 700; }
+.crumb-sep { color: var(--overlay); opacity: 0.55; }
+
+#content { max-width: 880px; margin: 0 auto; padding: 30px 48px 90px; }
+
+.empty-state {
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  height: 70vh;
+  color: var(--overlay);
+  gap: 10px;
+  text-align: center;
+}
+.empty-emoji { font-size: 56px; }
+.empty-state .muted { font-size: 13px; opacity: 0.8; }
+
+/* ---------------- markdown ---------------- */
+
+.markdown-body h1, .markdown-body h2, .markdown-body h3,
+.markdown-body h4, .markdown-body h5, .markdown-body h6 {
+  color: var(--lavender);
+  line-height: 1.3;
+  margin: 1.6em 0 0.6em;
+  scroll-margin-top: 56px;   /* clear the sticky breadcrumb when an #anchor jumps here */
+}
+.markdown-body h1 { font-size: 2em; border-bottom: 2px solid var(--surface0); padding-bottom: 0.3em; }
+.markdown-body h2 { font-size: 1.5em; border-bottom: 1px solid var(--surface0); padding-bottom: 0.25em; }
+.markdown-body h3 { font-size: 1.25em; color: var(--mauve); }
+
+.markdown-body a { color: var(--blue); text-decoration: none; border-bottom: 1px dashed var(--blue); }
+.markdown-body a:hover { color: var(--pink); border-bottom-color: var(--pink); }
+
+.markdown-body p, .markdown-body li { color: var(--text); }
+.markdown-body strong { color: var(--peach); }
+
+.markdown-body code {
+  font-family: var(--mono);
+  font-size: 0.88em;
+  background: var(--surface0);
+  padding: 2px 6px;
+  border-radius: 6px;
+  color: var(--peach);
+}
+
+.markdown-body pre,
+.markdown-body pre.hljs {
+  background: var(--crust) !important;
+  border: 2px solid var(--surface0);
+  border-radius: var(--radius);
+  padding: 16px 18px;
+  overflow-x: auto;
+  box-shadow: var(--shadow-sm);
+}
+.markdown-body pre code { background: none; padding: 0; color: inherit; font-size: 0.86em; }
+
+.markdown-body blockquote {
+  margin: 1em 0;
+  padding: 4px 18px;
+  border-left: 4px solid var(--mauve);
+  background: var(--mantle);
+  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
+  color: var(--subtext);
+}
+
+.markdown-body table {
+  border-collapse: collapse;
+  width: 100%;
+  margin: 1em 0;
+  border-radius: var(--radius-sm);
+  overflow: hidden;
+  box-shadow: var(--shadow-sm);
+}
+.markdown-body th, .markdown-body td {
+  border: 1px solid var(--surface0);
+  padding: 9px 14px;
+}
+.markdown-body th { background: var(--surface0); color: var(--lavender); }
+.markdown-body tr:nth-child(even) td { background: var(--mantle); }
+
+.markdown-body hr { border: none; border-top: 2px dashed var(--surface1); margin: 2em 0; }
+
+.markdown-body img { max-width: 100%; border-radius: var(--radius-sm); }
+
+.markdown-body ul, .markdown-body ol { padding-left: 1.5em; }
+
+/* mermaid card */
+.mermaid {
+  display: flex;
+  justify-content: center;
+  background: var(--mantle);
+  border: 2px solid var(--surface0);
+  border-radius: var(--radius);
+  padding: 22px;
+  margin: 1.4em 0;
+  box-shadow: var(--shadow-sm);
+}
+.mermaid svg { max-width: 100%; height: auto; }
+.mermaid.rendered { cursor: zoom-in; }
+.mermaid.mermaid-error { display: block; border-color: var(--red); background: rgba(243, 139, 168, 0.06); }
+.diagram-error { color: var(--red); width: 100%; text-align: left; }
+.diagram-error .err-msg {
+  margin: 8px 0;
+  background: var(--crust) !important;
+  border: 1px solid var(--red);
+  color: var(--red);
+  font-size: 0.82em;
+  white-space: pre-wrap;
+}
+.diagram-error details { margin-top: 6px; color: var(--subtext); font-size: 0.85em; }
+.diagram-error summary { cursor: pointer; }
+.diagram-error details pre { margin-top: 6px; }
+
+/* ---------------- right-side TOC ---------------- */
+
+#toc {
+  flex: 0 0 240px;
+  width: 240px;
+  height: 100vh;
+  background: var(--mantle);
+  border-left: 2px solid var(--surface0);
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+}
+.toc-head {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  padding: 16px 14px 10px;
+  font-size: 11px;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--overlay);
+  font-weight: 700;
+}
+#toc-collapse {
+  background: none; border: none; color: var(--overlay);
+  cursor: pointer; font-size: 14px; padding: 2px 7px; border-radius: 6px; line-height: 1;
+}
+#toc-collapse:hover { background: var(--surface0); color: var(--text); }
+
+#toc-list { flex: 1; overflow-y: auto; padding: 0 8px 16px; }
+.toc-item {
+  display: block;
+  width: 100%;
+  text-align: left;
+  background: none;
+  border: none;
+  border-left: 2px solid transparent;
+  color: var(--subtext);
+  font: inherit;
+  font-size: 12.5px;
+  line-height: 1.35;
+  padding: 5px 8px;
+  border-radius: 0 6px 6px 0;
+  cursor: pointer;
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  transition: color 0.12s, background 0.12s, border-color 0.12s;
+}
+.toc-item:hover { color: var(--text); background: var(--surface0); }
+.toc-item.lvl-h1 { font-weight: 700; color: var(--text); }
+.toc-item.lvl-h2 { padding-left: 18px; }
+.toc-item.lvl-h3 { padding-left: 30px; font-size: 12px; }
+.toc-item.active { color: var(--lavender); border-left-color: var(--mauve); background: var(--surface0); }
+
+#toc-reopen {
+  position: fixed;
+  top: 14px; right: 14px;
+  z-index: 20;
+  display: none;
+  width: 34px; height: 34px;
+  border-radius: 9px;
+  border: 2px solid var(--surface0);
+  background: var(--mantle);
+  color: var(--subtext);
+  cursor: pointer;
+  font-size: 15px;
+}
+#toc-reopen:hover { color: var(--lavender); border-color: var(--mauve); }
+
+body.toc-collapsed #toc { display: none; }
+body.toc-collapsed #toc-reopen { display: block; }
+body.toc-empty #toc { display: none; }
+body.toc-empty #toc-reopen { display: none; }
+
+/* ---------------- search palette (cmd+K) ---------------- */
+
+.palette {
+  position: fixed;
+  inset: 0;
+  z-index: 70;
+  display: flex;
+  justify-content: center;
+  align-items: flex-start;
+  padding-top: 12vh;
+  background: rgba(17, 17, 27, 0.55);
+  backdrop-filter: blur(3px);
+  -webkit-backdrop-filter: blur(3px);
+}
+.palette[hidden] { display: none; }
+.palette-box {
+  width: min(640px, 92vw);
+  max-height: 70vh;
+  display: flex;
+  flex-direction: column;
+  background: var(--mantle);
+  border: 2px solid var(--surface1);
+  border-radius: var(--radius);
+  box-shadow: var(--shadow);
+  overflow: hidden;
+}
+#palette-input {
+  padding: 16px 18px;
+  border: none;
+  border-bottom: 2px solid var(--surface0);
+  background: transparent;
+  color: var(--text);
+  font-family: inherit;
+  font-size: 16px;
+  outline: none;
+}
+#palette-input::placeholder { color: var(--overlay); }
+.palette-results { overflow-y: auto; padding: 6px; }
+.palette-hint { padding: 22px; text-align: center; color: var(--overlay); font-size: 13px; }
+.pg-head {
+  padding: 8px 10px 4px;
+  font-size: 10px;
+  text-transform: uppercase;
+  letter-spacing: 0.08em;
+  color: var(--overlay);
+  font-weight: 700;
+}
+.presult { padding: 7px 10px; border-radius: var(--radius-sm); cursor: pointer; }
+.presult.sel { background: var(--surface0); }
+.pr-main { display: flex; align-items: center; gap: 8px; }
+.pr-ico { flex: 0 0 15px; height: 15px; color: var(--overlay); display: inline-flex; align-items: center; }
+.pr-ico svg { width: 15px; height: 15px; }
+.presult.sel .pr-ico { color: var(--mauve); }
+.pr-name { color: var(--text); font-size: 14px; font-weight: 600; }
+.pr-badge { color: var(--peach); font-size: 11px; font-family: var(--mono); }
+.pr-path {
+  margin-left: auto;
+  color: var(--overlay);
+  font-size: 11px;
+  font-family: var(--mono);
+  overflow: hidden;
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  max-width: 45%;
+}
+.snip {
+  margin: 3px 0 0 23px;
+  font-family: var(--mono);
+  font-size: 11.5px;
+  color: var(--subtext);
+  white-space: nowrap;
+  overflow: hidden;
+  text-overflow: ellipsis;
+}
+.snip-ln { color: var(--overlay); margin-right: 8px; }
+.palette mark { background: transparent; color: var(--peach); font-weight: 700; padding: 0; }
+.palette-foot {
+  display: flex;
+  gap: 16px;
+  padding: 8px 14px;
+  border-top: 2px solid var(--surface0);
+  color: var(--overlay);
+  font-size: 11px;
+}
+
+/* in-content highlight when opening a search hit */
+mark.search-hit {
+  background: var(--peach);
+  color: var(--crust);
+  border-radius: 3px;
+  padding: 0 2px;
+  animation: hitflash 0.45s ease;
+}
+@keyframes hitflash { from { background: var(--green); } to { background: var(--peach); } }
+
+/* ---------------- toast ---------------- */
+
+.toast {
+  position: fixed;
+  bottom: 22px;
+  left: 50%;
+  transform: translateX(-50%) translateY(12px);
+  z-index: 50;
+  background: var(--surface1);
+  color: var(--text);
+  border: 2px solid var(--surface2);
+  border-radius: var(--radius-sm);
+  padding: 10px 16px;
+  font-size: 13px;
+  box-shadow: var(--shadow);
+  opacity: 0;
+  pointer-events: none;
+  transition: opacity 0.2s ease, transform 0.2s ease;
+}
+.toast.show { opacity: 1; transform: translateX(-50%) translateY(0); }
+
+/* ---------------- mermaid zoom overlay ---------------- */
+
+.zoom-overlay {
+  position: fixed;
+  inset: 0;
+  z-index: 60;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  overflow: hidden;
+  background: rgba(17, 17, 27, 0.93);
+}
+.zoom-overlay[hidden] { display: none; }
+.zoom-hint {
+  position: fixed;
+  top: 16px; left: 50%;
+  transform: translateX(-50%);
+  color: var(--overlay);
+  font-size: 12px;
+  background: var(--mantle);
+  padding: 6px 12px;
+  border-radius: 8px;
+  border: 1px solid var(--surface0);
+}
+.zoom-inner {
+  cursor: grab;
+  transform-origin: center center;
+  will-change: transform;
+  touch-action: none;
+}
+.zoom-inner:active { cursor: grabbing; }
+.zoom-inner svg { max-width: 86vw; max-height: 82vh; }
+
+/* scrollbars */
+::-webkit-scrollbar { width: 11px; height: 11px; }
+::-webkit-scrollbar-thumb { background: var(--surface1); border-radius: 20px; border: 2px solid var(--mantle); }
+::-webkit-scrollbar-thumb:hover { background: var(--surface2); }
+::-webkit-scrollbar-track { background: transparent; }

package/public/toast.js

@@ -0,0 +1,15 @@
+/* transient bottom toast for non-blocking notices */
+
+import { $ } from './dom.js';
+
+const toastEl = $('toast');
+let toastTimer;
+
+export function toast(msg) {
+  toastEl.textContent = msg;
+  toastEl.hidden = false;
+  void toastEl.offsetWidth;   // reflow so the transition replays on rapid repeats
+  toastEl.classList.add('show');
+  clearTimeout(toastTimer);
+  toastTimer = setTimeout(() => toastEl.classList.remove('show'), 2600);
+}

package/public/toc.js

@@ -0,0 +1,51 @@
+/* right-side table of contents (h1-h3) + scroll-spy + collapse */
+
+import { $ } from './dom.js';
+import { scrollToFragment } from './viewer.js';
+
+const contentEl = $('content');
+const viewerEl = $('viewer');
+const tocListEl = $('toc-list');
+
+let tocEntries = [];   // [{ id, el, link }]
+
+export function buildToc() {
+  const headings = [...contentEl.querySelectorAll('h1, h2, h3')].filter((h) => h.id);
+  tocEntries = [];
+  if (!headings.length) {
+    document.body.classList.add('toc-empty');
+    tocListEl.replaceChildren();
+    return;
+  }
+  document.body.classList.remove('toc-empty');
+  const frag = document.createDocumentFragment();
+  for (const h of headings) {
+    const link = document.createElement('button');
+    link.className = `toc-item lvl-${h.tagName.toLowerCase()}`;
+    link.textContent = h.textContent;
+    link.addEventListener('click', () => scrollToFragment(h.id));
+    frag.appendChild(link);
+    tocEntries.push({ id: h.id, el: h, link });
+  }
+  tocListEl.replaceChildren(frag);
+  updateScrollSpy();
+}
+
+function updateScrollSpy() {
+  if (!tocEntries.length) return;
+  const top = viewerEl.scrollTop + 90;
+  let current = tocEntries[0];
+  for (const entry of tocEntries) {
+    if (entry.el.offsetTop <= top) current = entry; else break;
+  }
+  for (const entry of tocEntries) entry.link.classList.toggle('active', entry === current);
+}
+
+let spyRaf = 0;
+viewerEl.addEventListener('scroll', () => {
+  if (spyRaf) return;
+  spyRaf = requestAnimationFrame(() => { spyRaf = 0; updateScrollSpy(); });
+});
+
+$('toc-collapse').addEventListener('click', () => document.body.classList.add('toc-collapsed'));
+$('toc-reopen').addEventListener('click', () => document.body.classList.remove('toc-collapsed'));