ligarb 0.8.2 → 0.9.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bbc72fa10dd440a8c1da528db02f314735cae034beed2ae921ba3112caee7fbd
-  data.tar.gz: 14a5b2b990c3bb507f02982c7d9b823f9525a7964b4bd37c69e243316788820a
+  metadata.gz: fff2a914d9209b69c1b9c35d4133accfe0d5dcc4e272779959baa9c3bba64cf0
+  data.tar.gz: da08e338979034ba836c2321adb4820f91231e942a6bedb0e7ffb31128271c52
 SHA512:
-  metadata.gz: 528b2af5e5039875052fba85d6765ce8489109bd726ad51732294746b04891bd6c7cd7927ebb98d09ccf97ac4dd3de6107111418691f855760f7e89db9e4f73b
-  data.tar.gz: 6749c352bf7da3170bdbc9605422c8e7c4b59770f3f57dfa030bf96f07d47034e8f95c953815293e3267be477760e95379752cd2e082f550bbd2ca1a7251a1c2
+  metadata.gz: 6880ee104849e3904dad11583a8b635dc3bf105acea215df197ab4acbe1dcffa432b5c45c0c471d84424f22c7f287c2b11dc553f987c99d2613948d1f01eb766
+  data.tar.gz: c230438379c7ff16c808b38835fe0ea764b88433e109ce0573caba710163ec3efddb86975251faa145525176946a543b70eb44670fc55718998fade9098bf7c7

data/assets/mermaid_check.mjs

@@ -0,0 +1,116 @@
+// Build-time mermaid syntax checker for ligarb.
+//
+// Usage: node mermaid_check.mjs <path/to/mermaid.min.js>
+//   stdin:  JSON array of {"id": <any>, "text": <mermaid source>}
+//   stdout: JSON array of {"id": <any>, "error": <message or null>,
+//                          "kind": "syntax" | "environment"}
+//
+// Loads the browser UMD bundle of mermaid in Node by stubbing just enough
+// of the DOM (mermaid.parse() only parses; it never renders, but DOMPurify
+// refuses to initialize without something that looks like a document).
+//
+// The DOM stub is intentionally minimal, so it cannot satisfy DOMPurify when a
+// node label contains HTML (e.g. "A[1<br>2]"): sanitizing real markup needs a
+// real DOM tree to walk, which the stub does not provide. That surfaces as a
+// generic JS error (e.g. TypeError "Right-hand side of 'instanceof'..."), NOT a
+// diagram syntax error. classifyError() tells the two apart so callers only
+// warn about genuine mermaid problems and not these harness limitations.
+
+const noop = () => {};
+
+// Catch-all stub: any property access returns another stub, so the bundle's
+// incidental DOM touches during initialization succeed silently.
+function makeStub(name, overrides = {}) {
+  const target = function () {};
+  Object.assign(target, overrides);
+  return new Proxy(target, {
+    get(t, prop) {
+      if (prop === Symbol.toPrimitive) return () => "";
+      if (prop === "toString") return () => "";
+      if (typeof prop === "symbol") return undefined;
+      if (!(prop in t)) t[prop] = makeStub(name + "." + String(prop));
+      return t[prop];
+    },
+    set(t, prop, v) {
+      t[prop] = v;
+      return true;
+    },
+    apply() {
+      return makeStub(name + "()");
+    },
+    construct() {
+      return makeStub("new " + name);
+    },
+  });
+}
+
+globalThis.window = globalThis;
+// nodeType 9 = DOCUMENT_NODE; DOMPurify checks it to decide it has a real DOM.
+globalThis.document = makeStub("document", { nodeType: 9 });
+globalThis.navigator = { userAgent: "node" };
+globalThis.addEventListener = noop;
+globalThis.location = { href: "http://localhost/", protocol: "http:" };
+globalThis.Element = function Element() {};
+globalThis.HTMLTemplateElement = function HTMLTemplateElement() {};
+globalThis.Node = function Node() {};
+globalThis.NodeFilter = { SHOW_ELEMENT: 1, SHOW_TEXT: 4, SHOW_COMMENT: 128 };
+globalThis.NamedNodeMap = function NamedNodeMap() {};
+globalThis.HTMLFormElement = function HTMLFormElement() {};
+globalThis.DOMParser = function DOMParser() {
+  return makeStub("domparser");
+};
+
+const { readFileSync } = await import("fs");
+const vm = await import("vm");
+
+const mermaidPath = process.argv[2];
+if (!mermaidPath) {
+  console.error("usage: node mermaid_check.mjs <mermaid.min.js>");
+  process.exit(2);
+}
+
+// The bundle starts with "use strict" + top-level `var`, so indirect eval
+// would not create the global binding it expects; a classic script does.
+vm.runInThisContext(readFileSync(mermaidPath, "utf8"), {
+  filename: "mermaid.min.js",
+});
+
+const mermaid = globalThis.mermaid;
+if (!mermaid || typeof mermaid.parse !== "function") {
+  console.error("mermaid.parse is not available after loading the bundle");
+  process.exit(2);
+}
+
+// Decide whether a thrown error is a genuine mermaid diagram problem
+// ("syntax") or an artifact of our minimal DOM stub ("environment").
+//
+//   - jison grammar errors carry a structured `.hash`  -> syntax
+//   - mermaid's typed errors (e.g. UnknownDiagramError) -> syntax
+//   - generic JS runtime errors (TypeError/ReferenceError/RangeError/EvalError)
+//     with no hash come from the DOM stub                -> environment
+//   - anything else is reported as syntax, erring toward visibility
+function classifyError(e) {
+  if (e && e.hash !== undefined) return "syntax";
+  const name = e && e.name;
+  if (name && name.endsWith("DiagramError")) return "syntax";
+  if (["TypeError", "ReferenceError", "RangeError", "EvalError"].includes(name)) {
+    return "environment";
+  }
+  return "syntax";
+}
+
+const blocks = JSON.parse(readFileSync(0, "utf8"));
+const results = [];
+for (const block of blocks) {
+  try {
+    await mermaid.parse(block.text);
+    results.push({ id: block.id, error: null, kind: "syntax" });
+  } catch (e) {
+    results.push({
+      id: block.id,
+      error: String(e && e.message ? e.message : e),
+      kind: classifyError(e),
+    });
+  }
+}
+console.log(JSON.stringify(results));

data/assets/style.css

@@ -515,7 +515,14 @@ mark.search-highlight {
   align-items: flex-start;
 }
 
-.theme-toggle {
+.sidebar-header-actions {
+  display: flex;
+  gap: 0.35rem;
+  flex-shrink: 0;
+}
+
+.theme-toggle,
+.sidebar-collapse {
   background: none;
   border: 1px solid var(--color-border);
   border-radius: 4px;
@@ -527,11 +534,30 @@ mark.search-highlight {
   flex-shrink: 0;
 }
 
-.theme-toggle:hover {
+.theme-toggle:hover,
+.sidebar-collapse:hover {
   color: var(--color-text);
   background: var(--color-sidebar-hover);
 }
 
+/* Persistent collapse on wide screens: hide the sidebar and let content
+   reclaim the full width. The floating toggle reappears to bring it back.
+   Scoped to wide viewports so it never fights the off-canvas behavior. */
+@media (min-width: 901px) {
+  .sidebar-collapsed .sidebar {
+    transform: translateX(-100%);
+    transition: transform 0.3s ease;
+  }
+
+  .sidebar-collapsed .content {
+    margin-left: 0;
+  }
+
+  .sidebar-collapsed .sidebar-toggle {
+    display: block;
+  }
+}
+
 /* === Part / Appendix TOC === */
 .toc-part {
   margin-top: 0.5rem;
@@ -643,7 +669,9 @@ mark.search-highlight {
 }
 
 /* === Responsive === */
-@media (max-width: 768px) {
+/* Off-canvas sidebar for narrow viewports. The 900px breakpoint covers iPad
+   portrait (810–834px), which would otherwise keep the fixed desktop sidebar. */
+@media (max-width: 900px) {
   .sidebar {
     transform: translateX(-100%);
     transition: transform 0.3s ease;
@@ -657,6 +685,12 @@ mark.search-highlight {
     display: block;
   }
 
+  /* The in-header collapse button is only meaningful in the fixed desktop
+     layout; off-canvas already hides the sidebar via the floating toggle. */
+  .sidebar-collapse {
+    display: none;
+  }
+
   .content {
     margin-left: 0;
     padding: 2rem 1.5rem;