@kolkrabbi/kol-workshop 0.3.5 → 0.3.6

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kolkrabbi/kol-workshop",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "private": false,
   "description": "KOL workshop/docs system — a handrolled markdown engine, search, tag system (incl. a d3 tag graph), docs viewer, and docs shell. Sits above @kolkrabbi/kol-{theme,icons,component,framework}; content is consumer-injected (the package never globs docs).",
   "license": "MIT",
@@ -16,8 +16,8 @@
     "@kolkrabbi/kol-brand": "^0.1.2",
     "@kolkrabbi/kol-component": "0.14.1",
     "@kolkrabbi/kol-icons": "0.8.11",
-    "@kolkrabbi/kol-framework": "0.8.1",
-    "@kolkrabbi/kol-theme": "0.13.3"
+    "@kolkrabbi/kol-theme": "0.13.3",
+    "@kolkrabbi/kol-framework": "0.8.1"
   },
   "peerDependencies": {
     "react": "^18.3.0 || ^19.0.0",

package/src/docs/DocumentationReader.jsx

@@ -168,18 +168,27 @@ const DocumentationReader = ({
 
   /**
    * Resolve a .md link URL to an app route, or null if not a known doc.
-   * Extracts the doc ID from the filename portion of the URL.
+   * Extracts the doc ID from the filename portion of the URL. Bare basenames
+   * miss two inventory id dialects (wave-4): index files (`00-overview/INDEX`
+   * → id `00-overview-INDEX`) and collision-prefixed ids (`03-components/
+   * 01-inventory` → `03-components-01-inventory`) — both gain the parent
+   * folder, so try `${parentDir}-${basename}` as the fallback.
    */
   const resolveDocLink = (url) => {
     if (!url || !url.includes('.md')) return null
     // Strip anchor fragment
     const [pathPart, anchor] = url.split('#')
-    const basename = pathPart.split('/').pop().replace(/\.md$/, '')
-    if (knownDocIds.has(basename)) {
-      const route = docHref(basename)
-      return anchor ? `${route}#${anchor}` : route
-    }
-    return null
+    const segs = pathPart.split('/')
+    const basename = segs.pop().replace(/\.md$/, '')
+    const parentDir = segs.filter((s) => s && s !== '.' && s !== '..').pop()
+    const id = knownDocIds.has(basename)
+      ? basename
+      : parentDir && knownDocIds.has(`${parentDir}-${basename}`)
+        ? `${parentDir}-${basename}`
+        : null
+    if (!id) return null
+    const route = docHref(id)
+    return anchor ? `${route}#${anchor}` : route
   }
 
   // Bind the resolved link + tag helpers so call sites stay terse. Hashtag

package/src/engine/parse-markdown.js

@@ -316,10 +316,14 @@ export const parseDocsMarkdown = (markdown) => {
       const blocks = getTargetBlocks()
       const lastBlock = blocks[blocks.length - 1]
 
+      /* Split on UNESCAPED pipes only, then unescape: Obsidian tables carry
+       * `[[target\|display]]` wikilinks, and a naive split('|') exploded the
+       * link across two cells and left literal `\` in the text — the reason
+       * hub INDEX pages (tables of wikilinks) rendered as junk (wave-4). */
       const cells = trimmed
         .slice(1, -1)
-        .split('|')
-        .map((cell) => cell.trim())
+        .split(/(?<!\\)\|/)
+        .map((cell) => cell.trim().replace(/\\\|/g, '|'))
 
       // Separator row (|---|---|)
       const isSeparator = cells.every((cell) => /^:?-+:?$/.test(cell))