wiki-formant 0.23.0 → 0.23.1

package/dist/react.d.ts

@@ -423,6 +423,13 @@ export declare function RailShell({ children, prefix, label, className }: RailSh
  * matched on the PATH ONLY, deliberately: `?edit=` and `?history=` are modes a
  * page enters, not destinations a rail selects, and reading them would drag
  * `useSearchParams` into a statically-rendered wiki.
+ *
+ * The path is decoded first. Next serves a catch-all route's prerender with the
+ * joined segments percent-encoded — `/wiki/tech%2Fcore-concepts` for
+ * `/wiki/tech/core-concepts` — so an encoded path matches neither its own href
+ * nor its section's prefix, and React does not patch a className on hydration.
+ * Both wikis were shipping every page below the top level with nothing in the
+ * rail marked, and it only came right if you arrived by client navigation.
  */
 export declare function isRailLinkActive(activePath: string, href: string, tree?: boolean): boolean;
 export type { WikiLinkComponent, WikiLinkProps } from './react-server.js';

package/dist/react.js

@@ -137,8 +137,15 @@ export function TableOfContents({ containerSelector, headings: providedHeadings,
             // article per mutation is what makes a rail janky.
             timer = setTimeout(() => {
                 const root = document.querySelector(containerSelector);
-                if (!root)
+                // No container is an answer, not a reason to skip: a rail that bailed
+                // here kept the LAST page's headings, so a section index reached from
+                // one of its own articles listed that article's sections under "on this
+                // page". It only looked right when a loading skeleton happened to render
+                // the container and scan to nothing.
+                if (!root) {
+                    setScanned(prev => (prev.length ? [] : prev));
                     return;
+                }
                 const used = new Set();
                 const next = [];
                 for (const el of Array.from(root.querySelectorAll('h1, h2, h3'))) {
@@ -747,10 +754,29 @@ export function RailShell({ children, prefix, label, className }) {
  * matched on the PATH ONLY, deliberately: `?edit=` and `?history=` are modes a
  * page enters, not destinations a rail selects, and reading them would drag
  * `useSearchParams` into a statically-rendered wiki.
+ *
+ * The path is decoded first. Next serves a catch-all route's prerender with the
+ * joined segments percent-encoded — `/wiki/tech%2Fcore-concepts` for
+ * `/wiki/tech/core-concepts` — so an encoded path matches neither its own href
+ * nor its section's prefix, and React does not patch a className on hydration.
+ * Both wikis were shipping every page below the top level with nothing in the
+ * rail marked, and it only came right if you arrived by client navigation.
  */
 export function isRailLinkActive(activePath, href, tree = false) {
-    return tree ? activePath === href || activePath.startsWith(`${href}/`) : activePath === href;
+    const path = decodePath(activePath);
+    return tree ? path === href || path.startsWith(`${href}/`) : path === href;
 }
+/** `decodeURIComponent` throws on a stray `%`; a path it cannot read is its own answer. */
+const decodePath = (path) => {
+    if (!path.includes('%'))
+        return path;
+    try {
+        return decodeURIComponent(path);
+    }
+    catch {
+        return path;
+    }
+};
 // ---- rendered-article passes --------------------------------------------------
 /**
  * The `wiki-formant/dom` passes over a rendered article: tab groups, copy

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wiki-formant",
-  "version": "0.23.0",
+  "version": "0.23.1",
   "description": "The portable half of a wiki: derived taxonomy and facet controls, a version-negotiating MCP transport, markdown twins, block rendering, a rich-text editor engine, and conditional-GET plumbing.",
   "type": "module",
   "license": "MIT",
@@ -18,7 +18,9 @@
     "markdown",
     "agent"
   ],
-  "sideEffects": ["*.css"],
+  "sideEffects": [
+    "*.css"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",