@statewalker/wiki.view.react 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) {{year}} Mikhail Kotelnikov
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/fragment.d.ts

@@ -0,0 +1,2 @@
+import initWikiReact from "./public/init.js";
+export { initWikiReact as default };

package/dist/fragment.js

@@ -0,0 +1,2 @@
+import initWikiReact from "./public/init.js";
+export { initWikiReact as default };

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+import { WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId } from "./public/catalog.js";
+import { OpenWikiSiteCommand, OpenWikiSitePayload } from "./public/index.js";
+export { OpenWikiSiteCommand, type OpenWikiSitePayload, WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId };

package/dist/index.js

@@ -0,0 +1,3 @@
+import { WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId } from "./public/catalog.js";
+import { OpenWikiSiteCommand } from "./public/index.js";
+export { OpenWikiSiteCommand, WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId };

package/dist/internal/site-data.js

@@ -0,0 +1,77 @@
+import { Commands } from "@statewalker/shared-commands";
+import { LoadFileCommand } from "@statewalker/workspace.core";
+import { useEffect, useState } from "react";
+import { useAppWorkspace } from "@statewalker/ui.view.react";
+//#region src/internal/site-data.ts
+/** Workspace-absolute path of a site's `site.json` manifest. */
+function siteJsonPath(project, slug) {
+	return `/${project}/sites/${slug}/site.json`;
+}
+/** Workspace-absolute path of a generated page (manifest `page.path` is a file name). */
+function pageUri(project, slug, pagePath) {
+	return `/${project}/sites/${slug}/${pagePath}`;
+}
+/** Load a site's manifest via `files:load-file`. A missing file resolves to `empty`. */
+function useSiteManifest(project, slug) {
+	const commands = useAppWorkspace().requireAdapter(Commands);
+	const [state, setState] = useState({ status: "loading" });
+	useEffect(() => {
+		let cancelled = false;
+		setState({ status: "loading" });
+		commands.call(LoadFileCommand, { path: siteJsonPath(project, slug) }).promise.then((loaded) => {
+			if (cancelled) return;
+			try {
+				const manifest = JSON.parse(new TextDecoder().decode(loaded.bytes));
+				setState({
+					status: "ready",
+					manifest
+				});
+			} catch (error) {
+				setState({
+					status: "error",
+					message: error instanceof Error ? error.message : String(error)
+				});
+			}
+		}).catch(() => {
+			if (!cancelled) setState({ status: "empty" });
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [
+		project,
+		slug,
+		commands
+	]);
+	return state;
+}
+/** Load a markdown page's text via `files:load-file`. */
+function useFileText(uri) {
+	const commands = useAppWorkspace().requireAdapter(Commands);
+	const [state, setState] = useState({ status: "loading" });
+	useEffect(() => {
+		let cancelled = false;
+		setState({ status: "loading" });
+		commands.call(LoadFileCommand, { path: uri.replace(/^file:\/\//, "") }).promise.then((loaded) => {
+			if (cancelled) return;
+			setState({
+				status: "ready",
+				text: new TextDecoder().decode(loaded.bytes)
+			});
+		}).catch((error) => {
+			if (cancelled) return;
+			setState({
+				status: "error",
+				message: error instanceof Error ? error.message : String(error)
+			});
+		});
+		return () => {
+			cancelled = true;
+		};
+	}, [uri, commands]);
+	return state;
+}
+//#endregion
+export { pageUri, siteJsonPath, useFileText, useSiteManifest };
+
+//# sourceMappingURL=site-data.js.map

package/dist/internal/site-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-data.js","names":[],"sources":["../../src/internal/site-data.ts"],"sourcesContent":["import { Commands } from \"@statewalker/shared-commands\";\nimport { useAppWorkspace } from \"@statewalker/ui.view.react\";\nimport type { SiteManifest } from \"@statewalker/wiki.core\";\nimport { LoadFileCommand } from \"@statewalker/workspace.core\";\nimport { useEffect, useState } from \"react\";\n\n/** Workspace-absolute path of a site's `site.json` manifest. */\nexport function siteJsonPath(project: string, slug: string): string {\n  return `/${project}/sites/${slug}/site.json`;\n}\n\n/** Workspace-absolute path of a generated page (manifest `page.path` is a file name). */\nexport function pageUri(project: string, slug: string, pagePath: string): string {\n  return `/${project}/sites/${slug}/${pagePath}`;\n}\n\nexport type ManifestState =\n  | { status: \"loading\" }\n  | { status: \"ready\"; manifest: SiteManifest }\n  | { status: \"empty\" }\n  | { status: \"error\"; message: string };\n\n/** Load a site's manifest via `files:load-file`. A missing file resolves to `empty`. */\nexport function useSiteManifest(project: string, slug: string): ManifestState {\n  const workspace = useAppWorkspace();\n  const commands = workspace.requireAdapter(Commands);\n  const [state, setState] = useState<ManifestState>({ status: \"loading\" });\n\n  useEffect(() => {\n    let cancelled = false;\n    setState({ status: \"loading\" });\n    commands\n      .call(LoadFileCommand, { path: siteJsonPath(project, slug) })\n      .promise.then((loaded) => {\n        if (cancelled) return;\n        try {\n          const manifest = JSON.parse(new TextDecoder().decode(loaded.bytes)) as SiteManifest;\n          setState({ status: \"ready\", manifest });\n        } catch (error) {\n          setState({\n            status: \"error\",\n            message: error instanceof Error ? error.message : String(error),\n          });\n        }\n      })\n      .catch(() => {\n        if (!cancelled) setState({ status: \"empty\" });\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [project, slug, commands]);\n\n  return state;\n}\n\nexport type FileTextState =\n  | { status: \"loading\" }\n  | { status: \"ready\"; text: string }\n  | { status: \"error\"; message: string };\n\n/** Load a markdown page's text via `files:load-file`. */\nexport function useFileText(uri: string): FileTextState {\n  const workspace = useAppWorkspace();\n  const commands = workspace.requireAdapter(Commands);\n  const [state, setState] = useState<FileTextState>({ status: \"loading\" });\n\n  useEffect(() => {\n    let cancelled = false;\n    setState({ status: \"loading\" });\n    commands\n      .call(LoadFileCommand, { path: uri.replace(/^file:\\/\\//, \"\") })\n      .promise.then((loaded) => {\n        if (cancelled) return;\n        setState({ status: \"ready\", text: new TextDecoder().decode(loaded.bytes) });\n      })\n      .catch((error: unknown) => {\n        if (cancelled) return;\n        setState({\n          status: \"error\",\n          message: error instanceof Error ? error.message : String(error),\n        });\n      });\n    return () => {\n      cancelled = true;\n    };\n  }, [uri, commands]);\n\n  return state;\n}\n"],"mappings":";;;;;;AAOA,SAAgB,aAAa,SAAiB,MAAsB;CAClE,OAAO,IAAI,QAAQ,SAAS,KAAK;AACnC;;AAGA,SAAgB,QAAQ,SAAiB,MAAc,UAA0B;CAC/E,OAAO,IAAI,QAAQ,SAAS,KAAK,GAAG;AACtC;;AASA,SAAgB,gBAAgB,SAAiB,MAA6B;CAE5E,MAAM,WADY,gBACO,CAAC,CAAC,eAAe,QAAQ;CAClD,MAAM,CAAC,OAAO,YAAY,SAAwB,EAAE,QAAQ,UAAU,CAAC;CAEvE,gBAAgB;EACd,IAAI,YAAY;EAChB,SAAS,EAAE,QAAQ,UAAU,CAAC;EAC9B,SACG,KAAK,iBAAiB,EAAE,MAAM,aAAa,SAAS,IAAI,EAAE,CAAC,CAAC,CAC5D,QAAQ,MAAM,WAAW;GACxB,IAAI,WAAW;GACf,IAAI;IACF,MAAM,WAAW,KAAK,MAAM,IAAI,YAAY,CAAC,CAAC,OAAO,OAAO,KAAK,CAAC;IAClE,SAAS;KAAE,QAAQ;KAAS;IAAS,CAAC;GACxC,SAAS,OAAO;IACd,SAAS;KACP,QAAQ;KACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;IAChE,CAAC;GACH;EACF,CAAC,CAAC,CACD,YAAY;GACX,IAAI,CAAC,WAAW,SAAS,EAAE,QAAQ,QAAQ,CAAC;EAC9C,CAAC;EACH,aAAa;GACX,YAAY;EACd;CACF,GAAG;EAAC;EAAS;EAAM;CAAQ,CAAC;CAE5B,OAAO;AACT;;AAQA,SAAgB,YAAY,KAA4B;CAEtD,MAAM,WADY,gBACO,CAAC,CAAC,eAAe,QAAQ;CAClD,MAAM,CAAC,OAAO,YAAY,SAAwB,EAAE,QAAQ,UAAU,CAAC;CAEvE,gBAAgB;EACd,IAAI,YAAY;EAChB,SAAS,EAAE,QAAQ,UAAU,CAAC;EAC9B,SACG,KAAK,iBAAiB,EAAE,MAAM,IAAI,QAAQ,cAAc,EAAE,EAAE,CAAC,CAAC,CAC9D,QAAQ,MAAM,WAAW;GACxB,IAAI,WAAW;GACf,SAAS;IAAE,QAAQ;IAAS,MAAM,IAAI,YAAY,CAAC,CAAC,OAAO,OAAO,KAAK;GAAE,CAAC;EAC5E,CAAC,CAAC,CACD,OAAO,UAAmB;GACzB,IAAI,WAAW;GACf,SAAS;IACP,QAAQ;IACR,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;GAChE,CAAC;EACH,CAAC;EACH,aAAa;GACX,YAAY;EACd;CACF,GAAG,CAAC,KAAK,QAAQ,CAAC;CAElB,OAAO;AACT"}

package/dist/internal/site-nav.js

@@ -0,0 +1,23 @@
+import { ScrollArea } from "@statewalker/ui.view.shadcn";
+import { jsx } from "react/jsx-runtime";
+//#region src/internal/site-nav.tsx
+/** Left-rail table of contents: the site's pages in manifest order, single-select. */
+function SiteNav({ pages, selected, onSelect }) {
+	return /* @__PURE__ */ jsx(ScrollArea, {
+		className: "h-full w-56 shrink-0 border-r",
+		children: /* @__PURE__ */ jsx("nav", {
+			className: "flex flex-col gap-0.5 p-2",
+			children: pages.map((page, i) => /* @__PURE__ */ jsx("button", {
+				type: "button",
+				onClick: () => onSelect(i),
+				"aria-current": i === selected ? "page" : void 0,
+				className: `rounded px-2 py-1 text-left text-sm ${i === selected ? "bg-accent font-medium" : "hover:bg-accent/50"}`,
+				children: page.title
+			}, page.id))
+		})
+	});
+}
+//#endregion
+export { SiteNav };
+
+//# sourceMappingURL=site-nav.js.map

package/dist/internal/site-nav.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"site-nav.js","names":[],"sources":["../../src/internal/site-nav.tsx"],"sourcesContent":["import { ScrollArea } from \"@statewalker/ui.view.shadcn\";\nimport type { SitePage } from \"@statewalker/wiki.core\";\nimport type { ReactElement } from \"react\";\n\ninterface SiteNavProps {\n  pages: SitePage[];\n  selected: number;\n  onSelect: (index: number) => void;\n}\n\n/** Left-rail table of contents: the site's pages in manifest order, single-select. */\nexport function SiteNav({ pages, selected, onSelect }: SiteNavProps): ReactElement {\n  return (\n    <ScrollArea className=\"h-full w-56 shrink-0 border-r\">\n      <nav className=\"flex flex-col gap-0.5 p-2\">\n        {pages.map((page, i) => (\n          <button\n            key={page.id}\n            type=\"button\"\n            onClick={() => onSelect(i)}\n            aria-current={i === selected ? \"page\" : undefined}\n            className={`rounded px-2 py-1 text-left text-sm ${\n              i === selected ? \"bg-accent font-medium\" : \"hover:bg-accent/50\"\n            }`}\n          >\n            {page.title}\n          </button>\n        ))}\n      </nav>\n    </ScrollArea>\n  );\n}\n"],"mappings":";;;;AAWA,SAAgB,QAAQ,EAAE,OAAO,UAAU,YAAwC;CACjF,OACE,oBAAC,YAAD;EAAY,WAAU;EACpB,UAAA,oBAAC,OAAD;GAAK,WAAU;GACZ,UAAA,MAAM,KAAK,MAAM,MAChB,oBAAC,UAAD;IAEE,MAAK;IACL,eAAe,SAAS,CAAC;IACzB,gBAAc,MAAM,WAAW,SAAS,KAAA;IACxC,WAAW,uCACT,MAAM,WAAW,0BAA0B;IAG5C,UAAA,KAAK;GACA,GATD,KAAK,EASJ,CACT;EACE,CAAA;CACK,CAAA;AAEhB"}

package/dist/internal/wiki-site-view.js

@@ -0,0 +1,86 @@
+import { pageUri, useFileText, useSiteManifest } from "./site-data.js";
+import { SiteNav } from "./site-nav.js";
+import { Markdown } from "@statewalker/mime.view.markdown";
+import { Button } from "@statewalker/ui.view.shadcn";
+import { useState } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/internal/wiki-site-view.tsx
+function Centered({ children }) {
+	return /* @__PURE__ */ jsx("div", {
+		className: "flex h-full items-center justify-center p-6 text-sm text-muted-foreground",
+		children
+	});
+}
+function PageBody({ uri }) {
+	const state = useFileText(uri);
+	if (state.status === "loading") return /* @__PURE__ */ jsx(Centered, { children: "Loading…" });
+	if (state.status === "error") return /* @__PURE__ */ jsxs(Centered, { children: ["Failed to load page: ", state.message] });
+	return /* @__PURE__ */ jsx("div", {
+		className: "prose prose-sm dark:prose-invert max-w-none overflow-auto p-6",
+		children: /* @__PURE__ */ jsx(Markdown, { children: state.text })
+	});
+}
+/**
+* Site-browser panel: reads a site's `site.json` manifest and renders a TOC
+* sidebar + breadcrumbs + prev/next over its pages, with the selected page's
+* markdown body rendered via the shared `Markdown` component. ADR-0002: all wiki
+* React lives here, never in `@statewalker/wiki`.
+*/
+function WikiSiteView({ project, slug }) {
+	const manifest = useSiteManifest(project, slug);
+	const [selected, setSelected] = useState(0);
+	if (manifest.status === "loading") return /* @__PURE__ */ jsx(Centered, { children: "Loading site…" });
+	if (manifest.status === "error") return /* @__PURE__ */ jsxs(Centered, { children: ["Failed to load site: ", manifest.message] });
+	if (manifest.status === "empty" || manifest.manifest.pages.length === 0) return /* @__PURE__ */ jsx(Centered, { children: "No site generated yet." });
+	const pages = manifest.manifest.pages;
+	const index = Math.min(Math.max(selected, 0), pages.length - 1);
+	const page = pages[index];
+	if (!page) return /* @__PURE__ */ jsx(Centered, { children: "No site generated yet." });
+	return /* @__PURE__ */ jsxs("div", {
+		className: "flex h-full flex-col",
+		children: [/* @__PURE__ */ jsxs("div", {
+			className: "flex items-center gap-2 border-b px-3 py-2 text-sm",
+			children: [
+				/* @__PURE__ */ jsx("span", {
+					className: "font-medium",
+					children: manifest.manifest.title
+				}),
+				/* @__PURE__ */ jsx("span", {
+					className: "text-muted-foreground",
+					children: "›"
+				}),
+				/* @__PURE__ */ jsx("span", { children: page.title }),
+				/* @__PURE__ */ jsxs("div", {
+					className: "ml-auto flex gap-1",
+					children: [/* @__PURE__ */ jsx(Button, {
+						variant: "ghost",
+						size: "sm",
+						disabled: index <= 0,
+						onClick: () => setSelected(index - 1),
+						children: "Prev"
+					}), /* @__PURE__ */ jsx(Button, {
+						variant: "ghost",
+						size: "sm",
+						disabled: index >= pages.length - 1,
+						onClick: () => setSelected(index + 1),
+						children: "Next"
+					})]
+				})
+			]
+		}), /* @__PURE__ */ jsxs("div", {
+			className: "flex min-h-0 flex-1",
+			children: [/* @__PURE__ */ jsx(SiteNav, {
+				pages,
+				selected: index,
+				onSelect: setSelected
+			}), /* @__PURE__ */ jsx("div", {
+				className: "min-w-0 flex-1",
+				children: /* @__PURE__ */ jsx(PageBody, { uri: pageUri(project, slug, page.path) })
+			})]
+		})]
+	});
+}
+//#endregion
+export { WikiSiteView };
+
+//# sourceMappingURL=wiki-site-view.js.map

package/dist/internal/wiki-site-view.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-site-view.js","names":[],"sources":["../../src/internal/wiki-site-view.tsx"],"sourcesContent":["import { Markdown } from \"@statewalker/mime.view.markdown\";\nimport { Button } from \"@statewalker/ui.view.shadcn\";\nimport { type ReactElement, useState } from \"react\";\nimport { pageUri, useFileText, useSiteManifest } from \"./site-data.js\";\nimport { SiteNav } from \"./site-nav.js\";\n\ninterface WikiSiteViewProps {\n  project: string;\n  slug: string;\n}\n\nfunction Centered({ children }: { children: React.ReactNode }): ReactElement {\n  return (\n    <div className=\"flex h-full items-center justify-center p-6 text-sm text-muted-foreground\">\n      {children}\n    </div>\n  );\n}\n\nfunction PageBody({ uri }: { uri: string }): ReactElement {\n  const state = useFileText(uri);\n  if (state.status === \"loading\") return <Centered>Loading…</Centered>;\n  if (state.status === \"error\") return <Centered>Failed to load page: {state.message}</Centered>;\n  return (\n    <div className=\"prose prose-sm dark:prose-invert max-w-none overflow-auto p-6\">\n      <Markdown>{state.text}</Markdown>\n    </div>\n  );\n}\n\n/**\n * Site-browser panel: reads a site's `site.json` manifest and renders a TOC\n * sidebar + breadcrumbs + prev/next over its pages, with the selected page's\n * markdown body rendered via the shared `Markdown` component. ADR-0002: all wiki\n * React lives here, never in `@statewalker/wiki`.\n */\nexport function WikiSiteView({ project, slug }: WikiSiteViewProps): ReactElement {\n  const manifest = useSiteManifest(project, slug);\n  const [selected, setSelected] = useState(0);\n\n  if (manifest.status === \"loading\") return <Centered>Loading site…</Centered>;\n  if (manifest.status === \"error\")\n    return <Centered>Failed to load site: {manifest.message}</Centered>;\n  if (manifest.status === \"empty\" || manifest.manifest.pages.length === 0) {\n    return <Centered>No site generated yet.</Centered>;\n  }\n\n  const pages = manifest.manifest.pages;\n  const index = Math.min(Math.max(selected, 0), pages.length - 1);\n  const page = pages[index];\n  if (!page) return <Centered>No site generated yet.</Centered>;\n\n  return (\n    <div className=\"flex h-full flex-col\">\n      <div className=\"flex items-center gap-2 border-b px-3 py-2 text-sm\">\n        <span className=\"font-medium\">{manifest.manifest.title}</span>\n        <span className=\"text-muted-foreground\">›</span>\n        <span>{page.title}</span>\n        <div className=\"ml-auto flex gap-1\">\n          <Button\n            variant=\"ghost\"\n            size=\"sm\"\n            disabled={index <= 0}\n            onClick={() => setSelected(index - 1)}\n          >\n            Prev\n          </Button>\n          <Button\n            variant=\"ghost\"\n            size=\"sm\"\n            disabled={index >= pages.length - 1}\n            onClick={() => setSelected(index + 1)}\n          >\n            Next\n          </Button>\n        </div>\n      </div>\n      <div className=\"flex min-h-0 flex-1\">\n        <SiteNav pages={pages} selected={index} onSelect={setSelected} />\n        <div className=\"min-w-0 flex-1\">\n          <PageBody uri={pageUri(project, slug, page.path)} />\n        </div>\n      </div>\n    </div>\n  );\n}\n"],"mappings":";;;;;;;AAWA,SAAS,SAAS,EAAE,YAAyD;CAC3E,OACE,oBAAC,OAAD;EAAK,WAAU;EACZ;CACE,CAAA;AAET;AAEA,SAAS,SAAS,EAAE,OAAsC;CACxD,MAAM,QAAQ,YAAY,GAAG;CAC7B,IAAI,MAAM,WAAW,WAAW,OAAO,oBAAC,UAAD,EAAA,UAAU,WAAkB,CAAA;CACnE,IAAI,MAAM,WAAW,SAAS,OAAO,qBAAC,UAAD,EAAA,UAAA,CAAU,yBAAsB,MAAM,OAAkB,EAAA,CAAA;CAC7F,OACE,oBAAC,OAAD;EAAK,WAAU;EACb,UAAA,oBAAC,UAAD,EAAA,UAAW,MAAM,KAAe,CAAA;CAC7B,CAAA;AAET;;;;;;;AAQA,SAAgB,aAAa,EAAE,SAAS,QAAyC;CAC/E,MAAM,WAAW,gBAAgB,SAAS,IAAI;CAC9C,MAAM,CAAC,UAAU,eAAe,SAAS,CAAC;CAE1C,IAAI,SAAS,WAAW,WAAW,OAAO,oBAAC,UAAD,EAAA,UAAU,gBAAuB,CAAA;CAC3E,IAAI,SAAS,WAAW,SACtB,OAAO,qBAAC,UAAD,EAAA,UAAA,CAAU,yBAAsB,SAAS,OAAkB,EAAA,CAAA;CACpE,IAAI,SAAS,WAAW,WAAW,SAAS,SAAS,MAAM,WAAW,GACpE,OAAO,oBAAC,UAAD,EAAA,UAAU,yBAAgC,CAAA;CAGnD,MAAM,QAAQ,SAAS,SAAS;CAChC,MAAM,QAAQ,KAAK,IAAI,KAAK,IAAI,UAAU,CAAC,GAAG,MAAM,SAAS,CAAC;CAC9D,MAAM,OAAO,MAAM;CACnB,IAAI,CAAC,MAAM,OAAO,oBAAC,UAAD,EAAA,UAAU,yBAAgC,CAAA;CAE5D,OACE,qBAAC,OAAD;EAAK,WAAU;EAAf,UAAA,CACE,qBAAC,OAAD;GAAK,WAAU;GAAf,UAAA;IACE,oBAAC,QAAD;KAAM,WAAU;KAAe,UAAA,SAAS,SAAS;IAAY,CAAA;IAC7D,oBAAC,QAAD;KAAM,WAAU;KAAwB,UAAA;IAAO,CAAA;IAC/C,oBAAC,QAAD,EAAA,UAAO,KAAK,MAAY,CAAA;IACxB,qBAAC,OAAD;KAAK,WAAU;KAAf,UAAA,CACE,oBAAC,QAAD;MACE,SAAQ;MACR,MAAK;MACL,UAAU,SAAS;MACnB,eAAe,YAAY,QAAQ,CAAC;MACrC,UAAA;KAEO,CAAA,GACR,oBAAC,QAAD;MACE,SAAQ;MACR,MAAK;MACL,UAAU,SAAS,MAAM,SAAS;MAClC,eAAe,YAAY,QAAQ,CAAC;MACrC,UAAA;KAEO,CAAA,CACL;;GACF;EACL,CAAA,GAAA,qBAAC,OAAD;GAAK,WAAU;GAAf,UAAA,CACE,oBAAC,SAAD;IAAgB;IAAO,UAAU;IAAO,UAAU;GAAc,CAAA,GAChE,oBAAC,OAAD;IAAK,WAAU;IACb,UAAA,oBAAC,UAAD,EAAU,KAAK,QAAQ,SAAS,MAAM,KAAK,IAAI,EAAI,CAAA;GAChD,CAAA,CACF;EACF,CAAA,CAAA;;AAET"}

package/dist/public/catalog.d.ts

@@ -0,0 +1,64 @@
+import { Spec } from "@json-render/core";
+import { z } from "zod";
+//#region src/public/catalog.d.ts
+/**
+ * Catalog declaration for the wiki site-browser panel — typed schema only. The
+ * `WikiSiteView` React binding lives in `init.tsx` (ADR-0002 logic/renderer split).
+ * The single element carries `{ project, slug }`; the component reads `site.json`.
+ */
+export declare const wikiSiteCatalog: import("@json-render/core").Catalog<{
+  spec: import("@json-render/core").SchemaType<"object", {
+    root: import("@json-render/core").SchemaType<"string", unknown>;
+    elements: import("@json-render/core").SchemaType<"record", import("@json-render/core").SchemaType<"object", {
+      type: import("@json-render/core").SchemaType<"ref", string>;
+      props: import("@json-render/core").SchemaType<"propsOf", string>;
+      children: import("@json-render/core").SchemaType<"array", import("@json-render/core").SchemaType<"string", unknown>>;
+      slots: {
+        optional: true;
+        kind: "record";
+        inner?: import("@json-render/core").SchemaType<"array", import("@json-render/core").SchemaType<"string", unknown>> | undefined;
+      };
+      visible: {
+        optional: true;
+        kind: "any";
+        inner?: unknown;
+      };
+      repeat: {
+        optional: true;
+        kind: "any";
+        inner?: unknown;
+      };
+    }>>;
+  }>;
+  catalog: import("@json-render/core").SchemaType<"object", {
+    components: import("@json-render/core").SchemaType<"map", {
+      props: import("@json-render/core").SchemaType<"zod", unknown>;
+      slots: import("@json-render/core").SchemaType<"array", import("@json-render/core").SchemaType<"string", unknown>>;
+      description: import("@json-render/core").SchemaType<"string", unknown>;
+      example: import("@json-render/core").SchemaType<"any", unknown>;
+    }>;
+    actions: import("@json-render/core").SchemaType<"map", {
+      params: import("@json-render/core").SchemaType<"zod", unknown>;
+      description: import("@json-render/core").SchemaType<"string", unknown>;
+    }>;
+  }>;
+}, {
+  components: {
+    WikiSiteView: {
+      props: z.ZodObject<{
+        project: z.ZodString;
+        slug: z.ZodString;
+      }, z.core.$strip>;
+    };
+  };
+  actions: {};
+}>;
+export declare const WIKI_SITE_CATALOG_ID = "wiki-site";
+/** Build the one-element spec for a (project, slug) site. */
+export declare function makeWikiSiteSpec(project: string, slug: string): Spec;
+/** Deterministic panel id so reopening the same site focuses the tab. */
+export declare function wikiSitePanelId(project: string, slug: string): string;
+/** Deterministic spec id; pairs with `wikiSitePanelId`. */
+export declare function wikiSiteSpecId(project: string, slug: string): string;
+//#endregion
+//# sourceMappingURL=catalog.d.ts.map

package/dist/public/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","names":[],"sources":["../../src/public/catalog.ts"],"mappings":";;;;;;;;qBASa,6CAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAExB;MAAgB,OAAK,EAAA;;;;;;;;qBAKZ;;wBAGG,iBAAiB,iBAAiB,eAAe;;wBAcjD,gBAAgB,iBAAiB;;wBAKjC,eAAe,iBAAiB"}

package/dist/public/catalog.js

@@ -0,0 +1,43 @@
+import { schema } from "@statewalker/render.view.react";
+import { defineCatalog } from "@json-render/core";
+import { z } from "zod";
+//#region src/public/catalog.ts
+/**
+* Catalog declaration for the wiki site-browser panel — typed schema only. The
+* `WikiSiteView` React binding lives in `init.tsx` (ADR-0002 logic/renderer split).
+* The single element carries `{ project, slug }`; the component reads `site.json`.
+*/
+const wikiSiteCatalog = defineCatalog(schema, {
+	components: { WikiSiteView: { props: z.object({
+		project: z.string(),
+		slug: z.string()
+	}) } },
+	actions: {}
+});
+const WIKI_SITE_CATALOG_ID = "wiki-site";
+/** Build the one-element spec for a (project, slug) site. */
+function makeWikiSiteSpec(project, slug) {
+	return {
+		root: "panel",
+		elements: { panel: {
+			type: "WikiSiteView",
+			props: {
+				project,
+				slug
+			},
+			children: []
+		} }
+	};
+}
+/** Deterministic panel id so reopening the same site focuses the tab. */
+function wikiSitePanelId(project, slug) {
+	return `wiki-site:${project}/${slug}`;
+}
+/** Deterministic spec id; pairs with `wikiSitePanelId`. */
+function wikiSiteSpecId(project, slug) {
+	return `spec:wiki-site:${project}/${slug}`;
+}
+//#endregion
+export { WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId };
+
+//# sourceMappingURL=catalog.js.map

package/dist/public/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","names":[],"sources":["../../src/public/catalog.ts"],"sourcesContent":["import { defineCatalog, type Spec } from \"@json-render/core\";\nimport { schema } from \"@statewalker/render.view.react\";\nimport { z } from \"zod\";\n\n/**\n * Catalog declaration for the wiki site-browser panel — typed schema only. The\n * `WikiSiteView` React binding lives in `init.tsx` (ADR-0002 logic/renderer split).\n * The single element carries `{ project, slug }`; the component reads `site.json`.\n */\nexport const wikiSiteCatalog = defineCatalog(schema, {\n  components: {\n    WikiSiteView: { props: z.object({ project: z.string(), slug: z.string() }) },\n  },\n  actions: {},\n});\n\nexport const WIKI_SITE_CATALOG_ID = \"wiki-site\";\n\n/** Build the one-element spec for a (project, slug) site. */\nexport function makeWikiSiteSpec(project: string, slug: string): Spec {\n  return {\n    root: \"panel\",\n    elements: {\n      panel: {\n        type: \"WikiSiteView\",\n        props: { project, slug },\n        children: [],\n      },\n    },\n  } as Spec;\n}\n\n/** Deterministic panel id so reopening the same site focuses the tab. */\nexport function wikiSitePanelId(project: string, slug: string): string {\n  return `wiki-site:${project}/${slug}`;\n}\n\n/** Deterministic spec id; pairs with `wikiSitePanelId`. */\nexport function wikiSiteSpecId(project: string, slug: string): string {\n  return `spec:wiki-site:${project}/${slug}`;\n}\n"],"mappings":";;;;;;;;;AASA,MAAa,kBAAkB,cAAc,QAAQ;CACnD,YAAY,EACV,cAAc,EAAE,OAAO,EAAE,OAAO;EAAE,SAAS,EAAE,OAAO;EAAG,MAAM,EAAE,OAAO;CAAE,CAAC,EAAE,EAC7E;CACA,SAAS,CAAC;AACZ,CAAC;AAED,MAAa,uBAAuB;;AAGpC,SAAgB,iBAAiB,SAAiB,MAAoB;CACpE,OAAO;EACL,MAAM;EACN,UAAU,EACR,OAAO;GACL,MAAM;GACN,OAAO;IAAE;IAAS;GAAK;GACvB,UAAU,CAAC;EACb,EACF;CACF;AACF;;AAGA,SAAgB,gBAAgB,SAAiB,MAAsB;CACrE,OAAO,aAAa,QAAQ,GAAG;AACjC;;AAGA,SAAgB,eAAe,SAAiB,MAAsB;CACpE,OAAO,kBAAkB,QAAQ,GAAG;AACtC"}

package/dist/public/index.d.ts

@@ -0,0 +1,3 @@
+import { WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId } from "./catalog.js";
+import { OpenWikiSiteCommand as OpenWikiSiteCommand$1, OpenWikiSitePayload } from "@statewalker/wiki.core";
+export { OpenWikiSiteCommand$1 as OpenWikiSiteCommand, type OpenWikiSitePayload, WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId };

package/dist/public/index.js

@@ -0,0 +1,3 @@
+import { WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId } from "./catalog.js";
+import { OpenWikiSiteCommand as OpenWikiSiteCommand$1 } from "@statewalker/wiki.core";
+export { OpenWikiSiteCommand$1 as OpenWikiSiteCommand, WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId };

package/dist/public/init.d.ts

@@ -0,0 +1,10 @@
+//#region src/public/init.d.ts
+/**
+ * Renderer-fragment init for `@statewalker/wiki.view.react`. Registers the
+ * `wiki-site` json-render catalog (binding `WikiSiteView`) and the `wiki:open-site`
+ * command that opens a generated thematic site as a dock panel. ADR-0002: all wiki
+ * React lives here, never in `@statewalker/wiki`.
+ */
+export default function initWikiReact(ctx: Record<string, unknown>): () => Promise<void>;
+//#endregion
+//# sourceMappingURL=init.d.ts.map

package/dist/public/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","names":[],"sources":["../../src/public/init.tsx"],"mappings":";;;;;;;wBAsCwB,cAAc,KAAK,gCAAgC"}

package/dist/public/init.js

@@ -0,0 +1,88 @@
+import { WikiSiteView } from "../internal/wiki-site-view.js";
+import { WIKI_SITE_CATALOG_ID, makeWikiSiteSpec, wikiSiteCatalog, wikiSitePanelId, wikiSiteSpecId } from "./catalog.js";
+import { LayoutStore, SpecStore, catalogsSlot, restorePanelSpecsFromLayout } from "@statewalker/render.core";
+import { defineRegistry } from "@statewalker/render.view.react";
+import { Commands } from "@statewalker/shared-commands";
+import { newRegistry } from "@statewalker/shared-registry";
+import { Slots } from "@statewalker/shared-slots";
+import { ShowDockPanelCommand } from "@statewalker/shell.core";
+import { dockTabIconSlot } from "@statewalker/shell.view.react";
+import { OpenWikiSiteCommand } from "@statewalker/wiki.core";
+import { getWorkspace } from "@statewalker/workspace.core";
+import { BookText } from "lucide-react";
+import { jsx } from "react/jsx-runtime";
+//#region src/public/init.tsx
+/** Split a restored panel id suffix (`<project>/<slug>`) back into its parts. */
+function splitSiteId(id) {
+	const slash = id.indexOf("/");
+	return slash < 0 ? {
+		project: id,
+		slug: ""
+	} : {
+		project: id.slice(0, slash),
+		slug: id.slice(slash + 1)
+	};
+}
+/**
+* Renderer-fragment init for `@statewalker/wiki.view.react`. Registers the
+* `wiki-site` json-render catalog (binding `WikiSiteView`) and the `wiki:open-site`
+* command that opens a generated thematic site as a dock panel. ADR-0002: all wiki
+* React lives here, never in `@statewalker/wiki`.
+*/
+function initWikiReact(ctx) {
+	const [register, cleanup] = newRegistry();
+	const workspace = getWorkspace(ctx);
+	const slots = workspace.requireAdapter(Slots);
+	const store = workspace.requireAdapter(SpecStore);
+	const commands = workspace.requireAdapter(Commands);
+	const layoutStore = workspace.requireAdapter(LayoutStore);
+	register(workspace.onLoad(() => {
+		restorePanelSpecsFromLayout({
+			store,
+			layout: layoutStore.get(),
+			panelIdPrefix: "wiki-site:",
+			catalogId: WIKI_SITE_CATALOG_ID,
+			buildSpec: (id) => {
+				const { project, slug } = splitSiteId(id);
+				return makeWikiSiteSpec(project, slug);
+			},
+			buildSpecId: (id) => {
+				const { project, slug } = splitSiteId(id);
+				return wikiSiteSpecId(project, slug);
+			}
+		});
+	}));
+	const { registry } = defineRegistry(wikiSiteCatalog, {
+		components: { WikiSiteView: ({ props }) => /* @__PURE__ */ jsx(WikiSiteView, {
+			project: props.project,
+			slug: props.slug
+		}) },
+		actions: {}
+	});
+	register(slots.register(catalogsSlot, WIKI_SITE_CATALOG_ID, registry));
+	register(commands.listen(OpenWikiSiteCommand, (command) => {
+		const { project, slug } = command.payload;
+		const specId = wikiSiteSpecId(project, slug);
+		const panelId = wikiSitePanelId(project, slug);
+		if (!store.get(specId)) store.create({
+			id: specId,
+			catalogId: WIKI_SITE_CATALOG_ID,
+			spec: makeWikiSiteSpec(project, slug)
+		});
+		commands.call(ShowDockPanelCommand, {
+			panelId,
+			specId,
+			title: slug
+		}).promise.then(() => command.resolve()).catch((error) => command.reject(error));
+		return true;
+	}));
+	register(slots.provide(dockTabIconSlot, {
+		panelIdPrefix: "wiki-site:",
+		Icon: BookText
+	}));
+	return cleanup;
+}
+//#endregion
+export { initWikiReact as default };
+
+//# sourceMappingURL=init.js.map

package/dist/public/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","names":[],"sources":["../../src/public/init.tsx"],"sourcesContent":["import {\n  catalogsSlot,\n  LayoutStore,\n  restorePanelSpecsFromLayout,\n  SpecStore,\n} from \"@statewalker/render.core\";\nimport { defineRegistry } from \"@statewalker/render.view.react\";\nimport { Commands } from \"@statewalker/shared-commands\";\nimport { newRegistry } from \"@statewalker/shared-registry\";\nimport { Slots } from \"@statewalker/shared-slots\";\nimport { ShowDockPanelCommand } from \"@statewalker/shell.core\";\nimport { dockTabIconSlot } from \"@statewalker/shell.view.react\";\nimport { OpenWikiSiteCommand } from \"@statewalker/wiki.core\";\nimport { getWorkspace } from \"@statewalker/workspace.core\";\nimport { BookText } from \"lucide-react\";\nimport { WikiSiteView } from \"../internal/wiki-site-view.js\";\nimport {\n  makeWikiSiteSpec,\n  WIKI_SITE_CATALOG_ID,\n  wikiSiteCatalog,\n  wikiSitePanelId,\n  wikiSiteSpecId,\n} from \"./catalog.js\";\n\n/** Split a restored panel id suffix (`<project>/<slug>`) back into its parts. */\nfunction splitSiteId(id: string): { project: string; slug: string } {\n  const slash = id.indexOf(\"/\");\n  return slash < 0\n    ? { project: id, slug: \"\" }\n    : { project: id.slice(0, slash), slug: id.slice(slash + 1) };\n}\n\n/**\n * Renderer-fragment init for `@statewalker/wiki.view.react`. Registers the\n * `wiki-site` json-render catalog (binding `WikiSiteView`) and the `wiki:open-site`\n * command that opens a generated thematic site as a dock panel. ADR-0002: all wiki\n * React lives here, never in `@statewalker/wiki`.\n */\nexport default function initWikiReact(ctx: Record<string, unknown>): () => Promise<void> {\n  const [register, cleanup] = newRegistry();\n  const workspace = getWorkspace(ctx);\n  const slots = workspace.requireAdapter(Slots);\n  const store = workspace.requireAdapter(SpecStore);\n  const commands = workspace.requireAdapter(Commands);\n  const layoutStore = workspace.requireAdapter(LayoutStore);\n\n  // Pre-allocate specs for restored wiki-site tabs on workspace-connect,\n  // reading the layout held by the LayoutStore adapter (see mime.view.pdf).\n  register(\n    workspace.onLoad(() => {\n      restorePanelSpecsFromLayout({\n        store,\n        layout: layoutStore.get(),\n        panelIdPrefix: \"wiki-site:\",\n        catalogId: WIKI_SITE_CATALOG_ID,\n        buildSpec: (id) => {\n          const { project, slug } = splitSiteId(id);\n          return makeWikiSiteSpec(project, slug);\n        },\n        buildSpecId: (id) => {\n          const { project, slug } = splitSiteId(id);\n          return wikiSiteSpecId(project, slug);\n        },\n      });\n    }),\n  );\n\n  const { registry } = defineRegistry(wikiSiteCatalog, {\n    components: {\n      WikiSiteView: ({ props }) => <WikiSiteView project={props.project} slug={props.slug} />,\n    },\n    actions: {},\n  });\n  register(slots.register(catalogsSlot, WIKI_SITE_CATALOG_ID, registry));\n\n  register(\n    commands.listen(OpenWikiSiteCommand, (command) => {\n      const { project, slug } = command.payload;\n      const specId = wikiSiteSpecId(project, slug);\n      const panelId = wikiSitePanelId(project, slug);\n      if (!store.get(specId)) {\n        store.create({\n          id: specId,\n          catalogId: WIKI_SITE_CATALOG_ID,\n          spec: makeWikiSiteSpec(project, slug),\n        });\n      }\n      void commands\n        .call(ShowDockPanelCommand, { panelId, specId, title: slug })\n        .promise.then(() => command.resolve())\n        .catch((error) => command.reject(error));\n      return true;\n    }),\n  );\n\n  register(slots.provide(dockTabIconSlot, { panelIdPrefix: \"wiki-site:\", Icon: BookText }));\n\n  return cleanup;\n}\n"],"mappings":";;;;;;;;;;;;;;;AAyBA,SAAS,YAAY,IAA+C;CAClE,MAAM,QAAQ,GAAG,QAAQ,GAAG;CAC5B,OAAO,QAAQ,IACX;EAAE,SAAS;EAAI,MAAM;CAAG,IACxB;EAAE,SAAS,GAAG,MAAM,GAAG,KAAK;EAAG,MAAM,GAAG,MAAM,QAAQ,CAAC;CAAE;AAC/D;;;;;;;AAQA,SAAwB,cAAc,KAAmD;CACvF,MAAM,CAAC,UAAU,WAAW,YAAY;CACxC,MAAM,YAAY,aAAa,GAAG;CAClC,MAAM,QAAQ,UAAU,eAAe,KAAK;CAC5C,MAAM,QAAQ,UAAU,eAAe,SAAS;CAChD,MAAM,WAAW,UAAU,eAAe,QAAQ;CAClD,MAAM,cAAc,UAAU,eAAe,WAAW;CAIxD,SACE,UAAU,aAAa;EACrB,4BAA4B;GAC1B;GACA,QAAQ,YAAY,IAAI;GACxB,eAAe;GACf,WAAW;GACX,YAAY,OAAO;IACjB,MAAM,EAAE,SAAS,SAAS,YAAY,EAAE;IACxC,OAAO,iBAAiB,SAAS,IAAI;GACvC;GACA,cAAc,OAAO;IACnB,MAAM,EAAE,SAAS,SAAS,YAAY,EAAE;IACxC,OAAO,eAAe,SAAS,IAAI;GACrC;EACF,CAAC;CACH,CAAC,CACH;CAEA,MAAM,EAAE,aAAa,eAAe,iBAAiB;EACnD,YAAY,EACV,eAAe,EAAE,YAAY,oBAAC,cAAD;GAAc,SAAS,MAAM;GAAS,MAAM,MAAM;EAAO,CAAA,EACxF;EACA,SAAS,CAAC;CACZ,CAAC;CACD,SAAS,MAAM,SAAS,cAAc,sBAAsB,QAAQ,CAAC;CAErE,SACE,SAAS,OAAO,sBAAsB,YAAY;EAChD,MAAM,EAAE,SAAS,SAAS,QAAQ;EAClC,MAAM,SAAS,eAAe,SAAS,IAAI;EAC3C,MAAM,UAAU,gBAAgB,SAAS,IAAI;EAC7C,IAAI,CAAC,MAAM,IAAI,MAAM,GACnB,MAAM,OAAO;GACX,IAAI;GACJ,WAAW;GACX,MAAM,iBAAiB,SAAS,IAAI;EACtC,CAAC;EAEH,SACG,KAAK,sBAAsB;GAAE;GAAS;GAAQ,OAAO;EAAK,CAAC,CAAC,CAC5D,QAAQ,WAAW,QAAQ,QAAQ,CAAC,CAAC,CACrC,OAAO,UAAU,QAAQ,OAAO,KAAK,CAAC;EACzC,OAAO;CACT,CAAC,CACH;CAEA,SAAS,MAAM,QAAQ,iBAAiB;EAAE,eAAe;EAAc,MAAM;CAAS,CAAC,CAAC;CAExF,OAAO;AACT"}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@statewalker/wiki.view.react",
+  "version": "0.1.1",
+  "private": false,
+  "type": "module",
+  "description": "Wiki renderer fragment: search panel, indexer panel, and browsing/citation views (DockView specs / slot contributions) consuming the React-free @statewalker/wiki adapters.",
+  "homepage": "https://github.com/statewalker/statewalker-workbench",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/statewalker/statewalker-workbench.git"
+  },
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./fragment": {
+      "source": "./src/fragment.ts",
+      "types": "./dist/fragment.d.ts",
+      "import": "./dist/fragment.js",
+      "default": "./dist/fragment.js"
+    },
+    "./styles": "./src/styles.css"
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "dependencies": {
+    "@json-render/core": "^0.21.0",
+    "@statewalker/mime.view.markdown": "^0.2.0",
+    "@statewalker/mime.core": "^0.5.0",
+    "@statewalker/render.core": "^0.5.0",
+    "@statewalker/render.view.react": "^0.2.0",
+    "@statewalker/shared-commands": "^0.2.0",
+    "@statewalker/shared-registry": "^0.1.0",
+    "@statewalker/shared-slots": "^0.2.0",
+    "@statewalker/shell.core": "^0.5.0",
+    "@statewalker/shell.view.react": "^0.2.0",
+    "@statewalker/ui.view.react": "^0.2.0",
+    "@statewalker/ui.view.shadcn": "^0.1.1",
+    "@statewalker/workspace.core": "^0.5.0",
+    "lucide-react": "^1.51.0",
+    "zod": "^4.6.5",
+    "@statewalker/wiki.core": "^0.1.1"
+  },
+  "peerDependencies": {
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0"
+  },
+  "devDependencies": {
+    "@testing-library/react": "^16.3.3",
+    "@types/react": "^19.3.0",
+    "@types/react-dom": "^19.3.0",
+    "react": "^19.3.0",
+    "react-dom": "^19.3.0",
+    "tsdown": "^0.23.0",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.3"
+  },
+  "sideEffects": [
+    "**/*.css"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest --passWithNoTests",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check --write .",
+    "format": "biome format --write .",
+    "build": "tsdown"
+  }
+}

package/src/fragment.ts

@@ -0,0 +1 @@
+export { default } from "./public/init.js";

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./public/index.js";

package/src/internal/site-data.ts

@@ -0,0 +1,90 @@
+import { Commands } from "@statewalker/shared-commands";
+import { useAppWorkspace } from "@statewalker/ui.view.react";
+import type { SiteManifest } from "@statewalker/wiki.core";
+import { LoadFileCommand } from "@statewalker/workspace.core";
+import { useEffect, useState } from "react";
+
+/** Workspace-absolute path of a site's `site.json` manifest. */
+export function siteJsonPath(project: string, slug: string): string {
+  return `/${project}/sites/${slug}/site.json`;
+}
+
+/** Workspace-absolute path of a generated page (manifest `page.path` is a file name). */
+export function pageUri(project: string, slug: string, pagePath: string): string {
+  return `/${project}/sites/${slug}/${pagePath}`;
+}
+
+export type ManifestState =
+  | { status: "loading" }
+  | { status: "ready"; manifest: SiteManifest }
+  | { status: "empty" }
+  | { status: "error"; message: string };
+
+/** Load a site's manifest via `files:load-file`. A missing file resolves to `empty`. */
+export function useSiteManifest(project: string, slug: string): ManifestState {
+  const workspace = useAppWorkspace();
+  const commands = workspace.requireAdapter(Commands);
+  const [state, setState] = useState<ManifestState>({ status: "loading" });
+
+  useEffect(() => {
+    let cancelled = false;
+    setState({ status: "loading" });
+    commands
+      .call(LoadFileCommand, { path: siteJsonPath(project, slug) })
+      .promise.then((loaded) => {
+        if (cancelled) return;
+        try {
+          const manifest = JSON.parse(new TextDecoder().decode(loaded.bytes)) as SiteManifest;
+          setState({ status: "ready", manifest });
+        } catch (error) {
+          setState({
+            status: "error",
+            message: error instanceof Error ? error.message : String(error),
+          });
+        }
+      })
+      .catch(() => {
+        if (!cancelled) setState({ status: "empty" });
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [project, slug, commands]);
+
+  return state;
+}
+
+export type FileTextState =
+  | { status: "loading" }
+  | { status: "ready"; text: string }
+  | { status: "error"; message: string };
+
+/** Load a markdown page's text via `files:load-file`. */
+export function useFileText(uri: string): FileTextState {
+  const workspace = useAppWorkspace();
+  const commands = workspace.requireAdapter(Commands);
+  const [state, setState] = useState<FileTextState>({ status: "loading" });
+
+  useEffect(() => {
+    let cancelled = false;
+    setState({ status: "loading" });
+    commands
+      .call(LoadFileCommand, { path: uri.replace(/^file:\/\//, "") })
+      .promise.then((loaded) => {
+        if (cancelled) return;
+        setState({ status: "ready", text: new TextDecoder().decode(loaded.bytes) });
+      })
+      .catch((error: unknown) => {
+        if (cancelled) return;
+        setState({
+          status: "error",
+          message: error instanceof Error ? error.message : String(error),
+        });
+      });
+    return () => {
+      cancelled = true;
+    };
+  }, [uri, commands]);
+
+  return state;
+}

package/src/internal/site-nav.tsx

@@ -0,0 +1,32 @@
+import { ScrollArea } from "@statewalker/ui.view.shadcn";
+import type { SitePage } from "@statewalker/wiki.core";
+import type { ReactElement } from "react";
+
+interface SiteNavProps {
+  pages: SitePage[];
+  selected: number;
+  onSelect: (index: number) => void;
+}
+
+/** Left-rail table of contents: the site's pages in manifest order, single-select. */
+export function SiteNav({ pages, selected, onSelect }: SiteNavProps): ReactElement {
+  return (
+    <ScrollArea className="h-full w-56 shrink-0 border-r">
+      <nav className="flex flex-col gap-0.5 p-2">
+        {pages.map((page, i) => (
+          <button
+            key={page.id}
+            type="button"
+            onClick={() => onSelect(i)}
+            aria-current={i === selected ? "page" : undefined}
+            className={`rounded px-2 py-1 text-left text-sm ${
+              i === selected ? "bg-accent font-medium" : "hover:bg-accent/50"
+            }`}
+          >
+            {page.title}
+          </button>
+        ))}
+      </nav>
+    </ScrollArea>
+  );
+}

package/src/internal/wiki-site-view.test.tsx

@@ -0,0 +1,82 @@
+import { Commands } from "@statewalker/shared-commands";
+import { AppWorkspaceProvider } from "@statewalker/ui.view.react";
+import { LoadFileCommand, Workspace } from "@statewalker/workspace.core";
+import { cleanup, fireEvent, render, screen } from "@testing-library/react";
+import { afterEach, describe, expect, it } from "vitest";
+import { WikiSiteView } from "./wiki-site-view.js";
+
+afterEach(cleanup);
+
+const MANIFEST = {
+  slug: "themes",
+  title: "Acme themes",
+  generated: "",
+  pages: [
+    { id: "founders", title: "Founders", path: "founders.md", order: 0, promptHash: "a" },
+    { id: "products", title: "Products", path: "products.md", order: 1, promptHash: "b" },
+  ],
+};
+
+const FILES: Record<string, string> = {
+  "/proj/sites/themes/site.json": JSON.stringify(MANIFEST),
+  "/proj/sites/themes/founders.md": "# Founders\n\nJane founded Acme.",
+  "/proj/sites/themes/products.md": "# Products\n\nWe make widgets.",
+};
+
+function makeWorkspace(files: Record<string, string>): Workspace {
+  const ws = new Workspace();
+  const commands = ws.requireAdapter(Commands);
+  commands.listen(LoadFileCommand, (command) => {
+    const content = files[command.payload.path];
+    if (content === undefined) {
+      command.reject(new Error(`not found: ${command.payload.path}`));
+      return true;
+    }
+    command.resolve({
+      path: command.payload.path,
+      bytes: new TextEncoder().encode(content),
+      mimeType: "text/markdown",
+    });
+    return true;
+  });
+  return ws;
+}
+
+function renderSite(ws: Workspace) {
+  return render(
+    <AppWorkspaceProvider workspace={ws}>
+      <WikiSiteView project="proj" slug="themes" />
+    </AppWorkspaceProvider>,
+  );
+}
+
+describe("WikiSiteView", () => {
+  it("renders the TOC in order and shows the first page", async () => {
+    renderSite(makeWorkspace(FILES));
+    // TOC sidebar buttons, in manifest order.
+    expect(await screen.findByRole("button", { name: "Founders" })).toBeTruthy();
+    expect(screen.getByRole("button", { name: "Products" })).toBeTruthy();
+    // First page body is shown.
+    expect(await screen.findByText("Jane founded Acme.")).toBeTruthy();
+  });
+
+  it("selecting a sidebar entry swaps the page body", async () => {
+    renderSite(makeWorkspace(FILES));
+    fireEvent.click(await screen.findByRole("button", { name: "Products" }));
+    expect(await screen.findByText("We make widgets.")).toBeTruthy();
+  });
+
+  it("prev/next navigates between pages", async () => {
+    renderSite(makeWorkspace(FILES));
+    await screen.findByText("Jane founded Acme.");
+    fireEvent.click(screen.getByRole("button", { name: "Next" }));
+    expect(await screen.findByText("We make widgets.")).toBeTruthy();
+    fireEvent.click(screen.getByRole("button", { name: "Prev" }));
+    expect(await screen.findByText("Jane founded Acme.")).toBeTruthy();
+  });
+
+  it("shows a placeholder when no site exists", async () => {
+    renderSite(makeWorkspace({}));
+    expect(await screen.findByText("No site generated yet.")).toBeTruthy();
+  });
+});

package/src/internal/wiki-site-view.tsx

@@ -0,0 +1,86 @@
+import { Markdown } from "@statewalker/mime.view.markdown";
+import { Button } from "@statewalker/ui.view.shadcn";
+import { type ReactElement, useState } from "react";
+import { pageUri, useFileText, useSiteManifest } from "./site-data.js";
+import { SiteNav } from "./site-nav.js";
+
+interface WikiSiteViewProps {
+  project: string;
+  slug: string;
+}
+
+function Centered({ children }: { children: React.ReactNode }): ReactElement {
+  return (
+    <div className="flex h-full items-center justify-center p-6 text-sm text-muted-foreground">
+      {children}
+    </div>
+  );
+}
+
+function PageBody({ uri }: { uri: string }): ReactElement {
+  const state = useFileText(uri);
+  if (state.status === "loading") return <Centered>Loading…</Centered>;
+  if (state.status === "error") return <Centered>Failed to load page: {state.message}</Centered>;
+  return (
+    <div className="prose prose-sm dark:prose-invert max-w-none overflow-auto p-6">
+      <Markdown>{state.text}</Markdown>
+    </div>
+  );
+}
+
+/**
+ * Site-browser panel: reads a site's `site.json` manifest and renders a TOC
+ * sidebar + breadcrumbs + prev/next over its pages, with the selected page's
+ * markdown body rendered via the shared `Markdown` component. ADR-0002: all wiki
+ * React lives here, never in `@statewalker/wiki`.
+ */
+export function WikiSiteView({ project, slug }: WikiSiteViewProps): ReactElement {
+  const manifest = useSiteManifest(project, slug);
+  const [selected, setSelected] = useState(0);
+
+  if (manifest.status === "loading") return <Centered>Loading site…</Centered>;
+  if (manifest.status === "error")
+    return <Centered>Failed to load site: {manifest.message}</Centered>;
+  if (manifest.status === "empty" || manifest.manifest.pages.length === 0) {
+    return <Centered>No site generated yet.</Centered>;
+  }
+
+  const pages = manifest.manifest.pages;
+  const index = Math.min(Math.max(selected, 0), pages.length - 1);
+  const page = pages[index];
+  if (!page) return <Centered>No site generated yet.</Centered>;
+
+  return (
+    <div className="flex h-full flex-col">
+      <div className="flex items-center gap-2 border-b px-3 py-2 text-sm">
+        <span className="font-medium">{manifest.manifest.title}</span>
+        <span className="text-muted-foreground">›</span>
+        <span>{page.title}</span>
+        <div className="ml-auto flex gap-1">
+          <Button
+            variant="ghost"
+            size="sm"
+            disabled={index <= 0}
+            onClick={() => setSelected(index - 1)}
+          >
+            Prev
+          </Button>
+          <Button
+            variant="ghost"
+            size="sm"
+            disabled={index >= pages.length - 1}
+            onClick={() => setSelected(index + 1)}
+          >
+            Next
+          </Button>
+        </div>
+      </div>
+      <div className="flex min-h-0 flex-1">
+        <SiteNav pages={pages} selected={index} onSelect={setSelected} />
+        <div className="min-w-0 flex-1">
+          <PageBody uri={pageUri(project, slug, page.path)} />
+        </div>
+      </div>
+    </div>
+  );
+}

package/src/public/catalog.ts

@@ -0,0 +1,41 @@
+import { defineCatalog, type Spec } from "@json-render/core";
+import { schema } from "@statewalker/render.view.react";
+import { z } from "zod";
+
+/**
+ * Catalog declaration for the wiki site-browser panel — typed schema only. The
+ * `WikiSiteView` React binding lives in `init.tsx` (ADR-0002 logic/renderer split).
+ * The single element carries `{ project, slug }`; the component reads `site.json`.
+ */
+export const wikiSiteCatalog = defineCatalog(schema, {
+  components: {
+    WikiSiteView: { props: z.object({ project: z.string(), slug: z.string() }) },
+  },
+  actions: {},
+});
+
+export const WIKI_SITE_CATALOG_ID = "wiki-site";
+
+/** Build the one-element spec for a (project, slug) site. */
+export function makeWikiSiteSpec(project: string, slug: string): Spec {
+  return {
+    root: "panel",
+    elements: {
+      panel: {
+        type: "WikiSiteView",
+        props: { project, slug },
+        children: [],
+      },
+    },
+  } as Spec;
+}
+
+/** Deterministic panel id so reopening the same site focuses the tab. */
+export function wikiSitePanelId(project: string, slug: string): string {
+  return `wiki-site:${project}/${slug}`;
+}
+
+/** Deterministic spec id; pairs with `wikiSitePanelId`. */
+export function wikiSiteSpecId(project: string, slug: string): string {
+  return `spec:wiki-site:${project}/${slug}`;
+}

package/src/public/index.ts

@@ -0,0 +1,12 @@
+// Public surface for `@statewalker/wiki.view.react`.
+
+// The open-site command contract lives in `@statewalker/wiki` (React-free) so logic
+// can dispatch it; re-exported here for renderer consumers.
+export { OpenWikiSiteCommand, type OpenWikiSitePayload } from "@statewalker/wiki.core";
+export {
+  makeWikiSiteSpec,
+  WIKI_SITE_CATALOG_ID,
+  wikiSiteCatalog,
+  wikiSitePanelId,
+  wikiSiteSpecId,
+} from "./catalog.js";

package/src/public/init.test.tsx

@@ -0,0 +1,39 @@
+import { SpecStore } from "@statewalker/render.core";
+import { Commands } from "@statewalker/shared-commands";
+import { Slots } from "@statewalker/shared-slots";
+import { ShowDockPanelCommand } from "@statewalker/shell.core";
+import { OpenWikiSiteCommand } from "@statewalker/wiki.core";
+import { Workspace } from "@statewalker/workspace.core";
+import { describe, expect, it } from "vitest";
+import { wikiSiteSpecId } from "./catalog.js";
+import initWikiReact from "./init.js";
+
+describe("initWikiReact — wiki:open-site", () => {
+  it("creates the site spec and shows a panel; re-opening reuses the same panel", async () => {
+    const ws = new Workspace();
+    ws.setAdapter(SpecStore, () => new SpecStore());
+    ws.setAdapter(Slots, () => new Slots());
+    const commands = ws.requireAdapter(Commands);
+    const store = ws.requireAdapter(SpecStore);
+
+    const shown: string[] = [];
+    commands.listen(ShowDockPanelCommand, (command) => {
+      shown.push(command.payload.panelId);
+      command.resolve();
+      return true;
+    });
+
+    const cleanup = initWikiReact({ "workspace:workspace": ws });
+
+    await commands.call(OpenWikiSiteCommand, { project: "proj", slug: "themes" }).promise;
+    expect(store.get(wikiSiteSpecId("proj", "themes"))).toBeTruthy();
+    expect(shown).toEqual(["wiki-site:proj/themes"]);
+
+    // Re-opening the same site does not duplicate the spec (the guard prevents a
+    // throwing re-create) and targets the same deterministic panel id (focus).
+    await commands.call(OpenWikiSiteCommand, { project: "proj", slug: "themes" }).promise;
+    expect(shown).toEqual(["wiki-site:proj/themes", "wiki-site:proj/themes"]);
+
+    await cleanup();
+  });
+});

package/src/public/init.tsx

@@ -0,0 +1,99 @@
+import {
+  catalogsSlot,
+  LayoutStore,
+  restorePanelSpecsFromLayout,
+  SpecStore,
+} from "@statewalker/render.core";
+import { defineRegistry } from "@statewalker/render.view.react";
+import { Commands } from "@statewalker/shared-commands";
+import { newRegistry } from "@statewalker/shared-registry";
+import { Slots } from "@statewalker/shared-slots";
+import { ShowDockPanelCommand } from "@statewalker/shell.core";
+import { dockTabIconSlot } from "@statewalker/shell.view.react";
+import { OpenWikiSiteCommand } from "@statewalker/wiki.core";
+import { getWorkspace } from "@statewalker/workspace.core";
+import { BookText } from "lucide-react";
+import { WikiSiteView } from "../internal/wiki-site-view.js";
+import {
+  makeWikiSiteSpec,
+  WIKI_SITE_CATALOG_ID,
+  wikiSiteCatalog,
+  wikiSitePanelId,
+  wikiSiteSpecId,
+} from "./catalog.js";
+
+/** Split a restored panel id suffix (`<project>/<slug>`) back into its parts. */
+function splitSiteId(id: string): { project: string; slug: string } {
+  const slash = id.indexOf("/");
+  return slash < 0
+    ? { project: id, slug: "" }
+    : { project: id.slice(0, slash), slug: id.slice(slash + 1) };
+}
+
+/**
+ * Renderer-fragment init for `@statewalker/wiki.view.react`. Registers the
+ * `wiki-site` json-render catalog (binding `WikiSiteView`) and the `wiki:open-site`
+ * command that opens a generated thematic site as a dock panel. ADR-0002: all wiki
+ * React lives here, never in `@statewalker/wiki`.
+ */
+export default function initWikiReact(ctx: Record<string, unknown>): () => Promise<void> {
+  const [register, cleanup] = newRegistry();
+  const workspace = getWorkspace(ctx);
+  const slots = workspace.requireAdapter(Slots);
+  const store = workspace.requireAdapter(SpecStore);
+  const commands = workspace.requireAdapter(Commands);
+  const layoutStore = workspace.requireAdapter(LayoutStore);
+
+  // Pre-allocate specs for restored wiki-site tabs on workspace-connect,
+  // reading the layout held by the LayoutStore adapter (see mime.view.pdf).
+  register(
+    workspace.onLoad(() => {
+      restorePanelSpecsFromLayout({
+        store,
+        layout: layoutStore.get(),
+        panelIdPrefix: "wiki-site:",
+        catalogId: WIKI_SITE_CATALOG_ID,
+        buildSpec: (id) => {
+          const { project, slug } = splitSiteId(id);
+          return makeWikiSiteSpec(project, slug);
+        },
+        buildSpecId: (id) => {
+          const { project, slug } = splitSiteId(id);
+          return wikiSiteSpecId(project, slug);
+        },
+      });
+    }),
+  );
+
+  const { registry } = defineRegistry(wikiSiteCatalog, {
+    components: {
+      WikiSiteView: ({ props }) => <WikiSiteView project={props.project} slug={props.slug} />,
+    },
+    actions: {},
+  });
+  register(slots.register(catalogsSlot, WIKI_SITE_CATALOG_ID, registry));
+
+  register(
+    commands.listen(OpenWikiSiteCommand, (command) => {
+      const { project, slug } = command.payload;
+      const specId = wikiSiteSpecId(project, slug);
+      const panelId = wikiSitePanelId(project, slug);
+      if (!store.get(specId)) {
+        store.create({
+          id: specId,
+          catalogId: WIKI_SITE_CATALOG_ID,
+          spec: makeWikiSiteSpec(project, slug),
+        });
+      }
+      void commands
+        .call(ShowDockPanelCommand, { panelId, specId, title: slug })
+        .promise.then(() => command.resolve())
+        .catch((error) => command.reject(error));
+      return true;
+    }),
+  );
+
+  register(slots.provide(dockTabIconSlot, { panelIdPrefix: "wiki-site:", Icon: BookText }));
+
+  return cleanup;
+}

package/src/styles.css

@@ -0,0 +1,9 @@
+/*
+ * Tailwind v4 content discovery for this package.
+ *
+ * The host app's `main.tsx` imports `<package>/styles` once at boot. Tailwind
+ * v4 then walks the `@source` glob and picks up class usage inside this
+ * package's source so utility classes are emitted into the host's CSS bundle.
+ */
+@source "./**/*.tsx";
+@source "./**/*.ts";