@takazudo/zudo-doc 4.2.1 → 4.4.0

package/dist/header/nav-overflow-script.js

@@ -1,4 +1,21 @@
 import { AFTER_NAVIGATE_EVENT } from "../transitions/page-events.js";
+import {
+  NAV_CHEVRON_ACTIVE,
+  NAV_CHEVRON_INACTIVE,
+  NAV_CHILD_ACTIVE,
+  NAV_CHILD_INACTIVE,
+  NAV_MENU_CHILD_ACTIVE,
+  NAV_MENU_CHILD_INACTIVE,
+  NAV_MENU_PARENT,
+  NAV_MENU_PARENT_ACTIVE_SUFFIX,
+  NAV_MENU_PLAIN,
+  NAV_MENU_PLAIN_ACTIVE_SUFFIX,
+  NAV_TOP_ACTIVE,
+  NAV_TOP_INACTIVE
+} from "./nav-class-tokens.js";
+const clsArgs = (tokens) => tokens.map((token) => JSON.stringify(token)).join(", ");
+const clsLiteral = (tokens) => JSON.stringify(tokens.join(" "));
+const clsAppend = (tokens) => JSON.stringify(" " + tokens.join(" "));
 const NAV_OVERFLOW_SCRIPT = `(function () {
   var cleanupNavOverflow = null;
 
@@ -56,12 +73,12 @@ const NAV_OVERFLOW_SCRIPT = `(function () {
     function setTopActive(a, active) {
       if (!a) return;
       if (active) {
-        a.classList.add("bg-fg", "text-bg");
-        a.classList.remove("text-muted", "hover:underline", "focus:underline");
+        a.classList.add(${clsArgs(NAV_TOP_ACTIVE)});
+        a.classList.remove(${clsArgs(NAV_TOP_INACTIVE)});
         a.setAttribute("aria-current", "page");
       } else {
-        a.classList.remove("bg-fg", "text-bg");
-        a.classList.add("text-muted", "hover:underline", "focus:underline");
+        a.classList.remove(${clsArgs(NAV_TOP_ACTIVE)});
+        a.classList.add(${clsArgs(NAV_TOP_INACTIVE)});
         a.removeAttribute("aria-current");
       }
     }
@@ -79,19 +96,19 @@ const NAV_OVERFLOW_SCRIPT = `(function () {
           if (childActive) {
             anyChild = true;
             c.setAttribute("data-active", "");
-            c.classList.add("font-bold", "text-accent");
-            c.classList.remove("text-fg");
+            c.classList.add(${clsArgs(NAV_CHILD_ACTIVE)});
+            c.classList.remove(${clsArgs(NAV_CHILD_INACTIVE)});
           } else {
             c.removeAttribute("data-active");
-            c.classList.remove("font-bold", "text-accent");
-            c.classList.add("text-fg");
+            c.classList.remove(${clsArgs(NAV_CHILD_ACTIVE)});
+            c.classList.add(${clsArgs(NAV_CHILD_INACTIVE)});
           }
         });
         topActive = parentMatch || anyChild;
         var svg = topA ? topA.querySelector("svg") : null;
         if (svg) {
-          if (topActive) { svg.classList.add("text-bg"); svg.classList.remove("text-muted"); }
-          else { svg.classList.add("text-muted"); svg.classList.remove("text-bg"); }
+          if (topActive) { svg.classList.add(${clsArgs(NAV_CHEVRON_ACTIVE)}); svg.classList.remove(${clsArgs(NAV_CHEVRON_INACTIVE)}); }
+          else { svg.classList.add(${clsArgs(NAV_CHEVRON_INACTIVE)}); svg.classList.remove(${clsArgs(NAV_CHEVRON_ACTIVE)}); }
         }
       } else {
         topActive = activePath !== "" && navPathname(topA) === activePath;
@@ -173,9 +190,9 @@ const NAV_OVERFLOW_SCRIPT = `(function () {
             a.href = parentLink.href;
             var parentText = parentLink.textContent ? parentLink.textContent.trim().replace(/\\s+/g, " ") : "";
             a.textContent = parentText;
-            a.className = "block px-hsp-md py-vsp-2xs text-small font-bold hover:bg-accent/10 hover:underline focus-visible:underline text-fg";
+            a.className = ${clsLiteral(NAV_MENU_PARENT)};
             if (parentLink.getAttribute("aria-current") === "page") {
-              a.className += " text-accent";
+              a.className += ${clsAppend(NAV_MENU_PARENT_ACTIVE_SUFFIX)};
             }
             li.appendChild(a);
             moreMenu.appendChild(li);
@@ -187,8 +204,8 @@ const NAV_OVERFLOW_SCRIPT = `(function () {
             a.textContent = child.textContent ? child.textContent.trim() : "";
             var isChildActive = child.hasAttribute("data-active");
             a.className = isChildActive
-              ? "block pl-hsp-xl pr-hsp-md py-vsp-2xs text-small font-bold text-accent hover:bg-accent/10 hover:underline focus-visible:underline"
-              : "block pl-hsp-xl pr-hsp-md py-vsp-2xs text-small text-muted hover:bg-accent/10 hover:text-fg hover:underline focus-visible:underline";
+              ? ${clsLiteral(NAV_MENU_CHILD_ACTIVE)}
+              : ${clsLiteral(NAV_MENU_CHILD_INACTIVE)};
             li.appendChild(a);
             moreMenu.appendChild(li);
           });
@@ -198,9 +215,9 @@ const NAV_OVERFLOW_SCRIPT = `(function () {
           var a2 = document.createElement("a");
           a2.href = anchor.href;
           a2.textContent = anchor.textContent ? anchor.textContent.trim() : "";
-          a2.className = "block px-hsp-md py-vsp-2xs text-small hover:bg-accent/10 hover:underline focus-visible:underline text-fg";
+          a2.className = ${clsLiteral(NAV_MENU_PLAIN)};
           if (anchor.getAttribute("aria-current") === "page") {
-            a2.className += " font-bold text-accent";
+            a2.className += ${clsAppend(NAV_MENU_PLAIN_ACTIVE_SUFFIX)};
           }
           li2.appendChild(a2);
           moreMenu.appendChild(li2);

package/dist/home-page/index.d.ts

@@ -1,6 +1,7 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { ComponentChildren, JSX } from "preact";
+import type { TagItem } from "../nav-indexing/types.js";
 import type { DocNavNode } from "../doc-page-props/index.js";
 import type { ChromeContext } from "../factory-context/index.js";
 import type { Settings } from "../settings.js";
@@ -12,9 +13,10 @@ export interface HomePageViewProps {
      *  `hostBindings.homeExtras({ locale })` call when `extras` is absent. */
     locale: string;
     /**
-     * Extra content rendered after the links row, inside the hero text column.
-     * A VALUE (already-rendered children) — the host-PAGE path. Takes
-     * precedence over `ctx.hostBindings.homeExtras` when both are present.
+     * Extra content rendered INLINE at the end of the links row, `/`-separated
+     * from whatever precedes it (the primary link and/or the GitHub link). A
+     * VALUE (already-rendered children) — the host-PAGE path. Takes precedence
+     * over `ctx.hostBindings.homeExtras` when both are present.
      *
      * This value-vs-renderer asymmetry (prop = value, `hostBindings.homeExtras`
      * = renderer) is INTENTIONAL, not an oversight to "unify": a host page
@@ -24,6 +26,17 @@ export interface HomePageViewProps {
      * locale })`.
      */
     extras?: ComponentChildren;
+    /**
+     * Overrides the default first hero link, which is otherwise
+     * `settings.headerNav[0]` + `t("nav.overview", locale)`. `path` is
+     * locale-relative (the view prefixes it with the locale-URL prefix and
+     * resolves it through `withBase`, same as the default); `labelKey`
+     * resolves through `t(labelKey, locale)`.
+     */
+    heroLink?: {
+        path: string;
+        labelKey: string;
+    };
     /** Prepared nav tree for the `SiteTreeNav` grid (already grouped via
      *  `groupSatelliteNodes` by the caller — the two routes group their own
      *  locale-specific tree before handing it here). */
@@ -32,9 +45,25 @@ export interface HomePageViewProps {
     categoryOrder: string[];
     /** Root-category slugs that should start collapsed in `SiteTreeNav`. */
     initiallyCollapsedCategorySlugs?: string[];
-    /** Unique tag count for the current locale — gates the "all tags" section
-     *  together with `settings.docTags`. */
+    /** Unique tag count for the current locale — gates the "Tags" section
+     *  together with `settings.docTags`. Part of the documented public
+     *  `@takazudo/zudo-doc/home-page` props shape (kept for back-compat). */
     tagCount: number;
+    /**
+     * Alphabetically-sorted tag list (tag + doc count + pre-resolved href) for
+     * the current locale. When provided (and non-empty) the section renders the
+     * tag chips (first {@link HomePageViewProps.tagLimit}) plus a "see all tags"
+     * nav. When omitted — legacy callers that pass only `tagCount` — the section
+     * falls back to the pre-#3027 single "All Tags" link, so existing
+     * `@takazudo/zudo-doc/home-page` consumers are not broken.
+     */
+    tags?: TagItem[];
+    /**
+     * Max number of tag chips rendered in the home "Tags" section before a "…"
+     * overflow indicator is shown. The full set stays reachable via the
+     * "see all tags" link. @default 30
+     */
+    tagLimit?: number;
     /**
      * Opt the home page into the **wide** content layout (full-viewport
      * category grid instead of the standard capped reading column). Threaded to

package/dist/home-page/index.js

@@ -1,13 +1,20 @@
 import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { Fragment as Fragment2 } from "preact";
 import { Island } from "@takazudo/zfb";
+import { AutoLogo } from "../auto-logo/index.js";
 import { DocLayoutWithDefaults } from "../doclayout/index.js";
 import { SiteTreeNav } from "../site-tree-nav-island/index.js";
+import { TagNav } from "../nav-indexing/tag-nav.js";
+import { CategoryLinkIcon } from "../tree-nav-shared/index.js";
 import { createHeadWithDefaults } from "../head-with-defaults/index.js";
 import { resolveThemePackSsrSlug } from "../theme/theme-pack-provider.js";
 import { deriveComposeMetaTitle, deriveBodyEndIslands } from "../chrome/derive.js";
 import { derivePrimaryChromeSlots } from "../chrome/primary-slots.js";
 import { assertChromeContext } from "../chrome/assert-chrome-context.js";
 import { prepareHomeData } from "./prepare-home-data.js";
+function cssUrl(url) {
+  return `url("${url.replace(/[\\"]/g, "\\$&")}")`;
+}
 function createHomePageView(ctx) {
   assertChromeContext(ctx, "createHomePageView");
   const settings = ctx.settings;
@@ -26,17 +33,53 @@ function createHomePageView(ctx) {
   function HomePageView({
     locale,
     extras,
+    heroLink,
     tree,
     categoryOrder,
     initiallyCollapsedCategorySlugs,
     tagCount,
+    tags,
+    tagLimit = 30,
     wide
   }) {
     const prefix = locale === defaultLocale ? "" : `/${locale}`;
     const ctaNav = settings.headerNav[0] ?? null;
-    const overview = ctaNav ? withBase(`${prefix}${ctaNav.path}`) : null;
-    const logoUrl = withBase("/img/logo.svg");
+    const primary = heroLink ? { href: withBase(`${prefix}${heroLink.path}`), label: t(heroLink.labelKey, locale) } : ctaNav ? { href: withBase(`${prefix}${ctaNav.path}`), label: t("nav.overview", locale) } : null;
+    const logoSetting = settings.logo ?? "auto";
     const resolvedExtras = extras ?? homeExtras?.({ locale });
+    const hasExtras = resolvedExtras != null && typeof resolvedExtras !== "boolean";
+    const rowItems = [];
+    if (primary) {
+      rowItems.push(
+        /* @__PURE__ */ jsx("a", { href: primary.href, class: "text-fg underline hover:text-accent", children: primary.label })
+      );
+    }
+    if (settings.githubUrl) {
+      rowItems.push(
+        /* @__PURE__ */ jsxs(
+          "a",
+          {
+            href: settings.githubUrl,
+            class: "inline-flex items-center gap-[0.3em] text-fg underline hover:text-accent",
+            target: "_blank",
+            rel: "noopener noreferrer",
+            children: [
+              /* @__PURE__ */ jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", class: "w-[1em] h-[1em] shrink-0", children: /* @__PURE__ */ jsx(
+                "path",
+                {
+                  fill: "currentColor",
+                  d: "M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"
+                }
+              ) }),
+              "GitHub"
+            ]
+          }
+        )
+      );
+    }
+    if (hasExtras) {
+      rowItems.push(resolvedExtras);
+    }
     return /* @__PURE__ */ jsxs(
       DocLayoutWithDefaults,
       {
@@ -55,46 +98,30 @@ function createHomePageView(ctx) {
         enableClientRouter: settings.dynamicPageTransition,
         children: [
           /* @__PURE__ */ jsx("div", { class: "flex justify-center mb-vsp-xl", children: /* @__PURE__ */ jsxs("div", { class: "flex flex-col items-center text-center gap-hsp-md lg:flex-row lg:text-left lg:gap-hsp-xl", children: [
-            /* @__PURE__ */ jsx(
+            logoSetting === "auto" ? /* @__PURE__ */ jsx(
+              AutoLogo,
+              {
+                seed: settings.siteName,
+                class: "w-[320px] max-w-full aspect-[1200/630] text-fg shrink-0"
+              }
+            ) : logoSetting !== false ? /* @__PURE__ */ jsx(
               "div",
               {
                 class: "w-[320px] max-w-full aspect-[1200/630] bg-fg shrink-0",
                 style: {
-                  WebkitMask: `url(${logoUrl}) center/contain no-repeat`,
-                  mask: `url(${logoUrl}) center/contain no-repeat`
+                  WebkitMask: `${cssUrl(withBase(logoSetting))} center/contain no-repeat`,
+                  mask: `${cssUrl(withBase(logoSetting))} center/contain no-repeat`
                 },
                 "aria-hidden": "true"
               }
-            ),
+            ) : null,
             /* @__PURE__ */ jsxs("div", { children: [
               /* @__PURE__ */ jsx("h1", { class: "text-heading font-bold mb-vsp-2xs", children: settings.siteName }),
               /* @__PURE__ */ jsx("p", { class: "text-muted text-small mb-vsp-sm", children: settings.siteDescription }),
-              /* @__PURE__ */ jsxs("div", { class: "flex items-center justify-center lg:justify-start gap-hsp-md text-small", children: [
-                overview && /* @__PURE__ */ jsxs(Fragment, { children: [
-                  /* @__PURE__ */ jsx("a", { href: overview, class: "text-fg underline hover:text-accent", children: t("nav.overview", locale) }),
-                  /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" })
-                ] }),
-                settings.githubUrl && /* @__PURE__ */ jsxs(
-                  "a",
-                  {
-                    href: settings.githubUrl,
-                    class: "inline-flex items-center gap-[0.3em] text-fg underline hover:text-accent",
-                    target: "_blank",
-                    rel: "noopener noreferrer",
-                    children: [
-                      /* @__PURE__ */ jsx("svg", { viewBox: "0 0 16 16", "aria-hidden": "true", class: "w-[1em] h-[1em] shrink-0", children: /* @__PURE__ */ jsx(
-                        "path",
-                        {
-                          fill: "currentColor",
-                          d: "M8 0C3.58 0 0 3.58 0 8c0 3.54 2.29 6.53 5.47 7.59.4.07.55-.17.55-.38 0-.19-.01-.82-.01-1.49-2.01.37-2.53-.49-2.69-.94-.09-.23-.48-.94-.82-1.13-.28-.15-.68-.52-.01-.53.63-.01 1.08.58 1.23.82.72 1.21 1.87.87 2.33.66.07-.52.28-.87.51-1.07-1.78-.2-3.64-.89-3.64-3.95 0-.87.31-1.59.82-2.15-.08-.2-.36-1.02.08-2.12 0 0 .67-.21 2.2.82.64-.18 1.32-.27 2-.27.68 0 1.36.09 2 .27 1.53-1.04 2.2-.82 2.2-.82.44 1.1.16 1.92.08 2.12.51.56.82 1.27.82 2.15 0 3.07-1.87 3.75-3.65 3.95.29.25.54.73.54 1.48 0 1.07-.01 1.93-.01 2.2 0 .21.15.46.55.38A8.013 8.013 0 0016 8c0-4.42-3.58-8-8-8z"
-                        }
-                      ) }),
-                      "GitHub"
-                    ]
-                  }
-                )
-              ] }),
-              resolvedExtras
+              /* @__PURE__ */ jsx("div", { class: "flex items-center justify-center lg:justify-start gap-hsp-md text-small", children: rowItems.map((item, index) => /* @__PURE__ */ jsxs(Fragment2, { children: [
+                index > 0 && /* @__PURE__ */ jsx("span", { class: "text-muted", children: "/" }),
+                item
+              ] }, index)) })
             ] })
           ] }) }),
           Island({
@@ -109,17 +136,47 @@ function createHomePageView(ctx) {
               }
             )
           }),
-          settings.docTags && tagCount > 0 && /* @__PURE__ */ jsxs("section", { class: "mt-vsp-xl", children: [
-            /* @__PURE__ */ jsx("h2", { class: "text-title font-bold mb-vsp-md", children: t("doc.allTags", locale) }),
+          settings.docTags && tagCount > 0 && /* @__PURE__ */ jsx("section", { class: "mt-vsp-xl", children: tags && tags.length > 0 ? /* @__PURE__ */ jsxs(Fragment, { children: [
+            /* @__PURE__ */ jsx("h2", { class: "text-title font-bold mb-vsp-md", children: t("doc.tags", locale) }),
             /* @__PURE__ */ jsx(
+              TagNav,
+              {
+                variant: "all",
+                tags: tags.slice(0, tagLimit),
+                labels: {
+                  tags: t("doc.tags", locale),
+                  taggedWith: t("doc.taggedWith", locale)
+                }
+              }
+            ),
+            tags.length > tagLimit && /* @__PURE__ */ jsx("div", { class: "mt-vsp-sm text-title text-muted", "aria-hidden": "true", children: "\u2026" }),
+            /* @__PURE__ */ jsx("div", { class: "mt-vsp-md", children: /* @__PURE__ */ jsxs(
               "a",
               {
                 href: withBase(`${prefix}/docs/tags`),
-                class: "text-accent underline hover:text-accent-hover",
-                children: t("doc.allTags", locale)
+                class: "group inline-flex items-center gap-hsp-xs text-accent hover:underline",
+                children: [
+                  /* @__PURE__ */ jsx(CategoryLinkIcon, { className: "w-icon-sm text-accent" }),
+                  /* @__PURE__ */ jsx("span", { children: t("doc.seeAllTags", locale) })
+                ]
               }
-            )
-          ] })
+            ) })
+          ] }) : (
+            // Legacy fallback: caller passed only `tagCount` (no tag list) —
+            // reproduce the pre-#3027 single "All Tags" link so existing
+            // `@takazudo/zudo-doc/home-page` consumers are unaffected.
+            /* @__PURE__ */ jsxs(Fragment, { children: [
+              /* @__PURE__ */ jsx("h2", { class: "text-title font-bold mb-vsp-md", children: t("doc.allTags", locale) }),
+              /* @__PURE__ */ jsx(
+                "a",
+                {
+                  href: withBase(`${prefix}/docs/tags`),
+                  class: "text-accent underline hover:text-accent-hover",
+                  children: t("doc.allTags", locale)
+                }
+              )
+            ] })
+          ) })
         ]
       }
     );

package/dist/home-page/prepare-home-data.d.ts

@@ -1,6 +1,7 @@
 import type { RouteContext } from "../factory-context/index.js";
 import type { NavSourceOptions } from "../nav-source-docs/index.js";
 import type { DocNavNode } from "../doc-page-props/index.js";
+import type { TagItem } from "../nav-indexing/types.js";
 export interface PrepareHomeDataOptions {
     /**
      * Override nav-source filtering. Default: `{}` for the default locale;
@@ -22,7 +23,15 @@ export interface HomeData {
      *  `HomePageViewProps.tree`). */
     tree: DocNavNode[];
     categoryOrder: string[];
+    /** Unique tag count for the current locale — gates the home "Tags" section
+     *  together with `settings.docTags`. Retained (equals `tags.length`) as the
+     *  documented `HomePageViewProps.tagCount` gate stays part of the public
+     *  `@takazudo/zudo-doc/home-page` API. */
     tagCount: number;
+    /** Alphabetically-sorted tag list (tag + doc count + pre-resolved,
+     *  locale-prefixed href) for the home "Tags" section — spreads onto
+     *  `HomePageViewProps.tags`. Empty when no tags exist for the locale. */
+    tags: TagItem[];
 }
 /**
  * Prepare the home-page nav tree / category order / tag count for `locale`.

package/dist/home-page/prepare-home-data.js

@@ -26,11 +26,18 @@ function prepareHomeData(ctx, locale, options) {
   const tree = ctx.buildNavTree(navDocs, locale, categoryMeta, (slug, loc) => ctx.docsUrl(slug, loc));
   const categoryOrder = ctx.getCategoryOrder();
   const grouped = ctx.groupSatelliteNodes(tree, categoryOrder);
-  const tagCount = ctx.collectTags(
+  const tagMap = ctx.collectTags(
     navDocs.filter((d) => !d.data.category_no_page),
     (entrySlug, data) => data.slug ?? ctx.toRouteSlug(entrySlug)
-  ).size;
-  return { tree: grouped, categoryOrder, tagCount };
+  );
+  const tagPrefix = locale === ctx.defaultLocale ? "" : `/${locale}`;
+  const tags = [...tagMap.values()].sort((a, b) => a.tag.localeCompare(b.tag, locale)).map((info) => ({
+    tag: info.tag,
+    count: info.count,
+    // Tag segment URL-encoded — href sites only; route params stay raw.
+    href: ctx.withBase(`${tagPrefix}/docs/tags/${encodeURIComponent(info.tag)}`)
+  }));
+  return { tree: grouped, categoryOrder, tagCount: tagMap.size, tags };
 }
 export {
   prepareHomeData

package/dist/html-preview-wrapper/highlight-runtime.d.ts

@@ -0,0 +1,40 @@
+import type { HighlightCodeOptions, HighlightCodeResult } from "@takazudo/zfb-md-wasm";
+type HighlightModule = Pick<typeof import("@takazudo/zfb-md-wasm"), "highlightCode">;
+export type HighlightModuleImporter = () => Promise<HighlightModule>;
+export interface HtmlPreviewHighlightRuntime {
+    highlightCode(code: string, options: HighlightCodeOptions): Promise<HighlightCodeResult>;
+}
+/**
+ * Build the HTML Preview's lazy zfb highlighting adapter.
+ *
+ * The cached value is only the public package-root module import. A rejected
+ * import is evicted so a later source-panel mount can retry a transient chunk
+ * load. Calls to `highlightCode` are deliberately not cached: the upstream
+ * package owns WASM initialization and trap recovery, while the component owns
+ * request cancellation and stale-result protection.
+ */
+export declare function createHighlightRuntime(importModule: HighlightModuleImporter): HtmlPreviewHighlightRuntime;
+/**
+ * Return markup only when zfb produced a usable result.
+ *
+ * An unknown non-empty language is a supported outcome: zfb returns safely
+ * escaped `hi-root` markup plus a warning. Error diagnostics and `html: null`
+ * represent invalid options/internal failure and must retain the JSX-escaped
+ * fallback instead.
+ */
+export declare function getUsableHighlightHtml(result: HighlightCodeResult): string | null;
+export interface HighlightRequestOptions {
+    code: string;
+    language: string;
+    onSettled: (html: string | null) => void;
+    runtime?: HtmlPreviewHighlightRuntime;
+}
+/**
+ * Start one highlight request and return its effect cleanup.
+ *
+ * Rejections are expected at this boundary (missing optional peer, resource
+ * load failure, or a current-call WASM trap). They resolve the UI to its plain
+ * fallback. Cleanup suppresses both successful and failed late completions.
+ */
+export declare function startHighlightRequest({ code, language, onSettled, runtime, }: HighlightRequestOptions): () => void;
+export {};

package/dist/html-preview-wrapper/highlight-runtime.js

@@ -0,0 +1,58 @@
+function createHighlightRuntime(importModule) {
+  let modulePromise = null;
+  function loadModule() {
+    if (!modulePromise) {
+      const pending = importModule().catch((error) => {
+        if (modulePromise === pending) {
+          modulePromise = null;
+        }
+        throw error;
+      });
+      modulePromise = pending;
+    }
+    return modulePromise;
+  }
+  return {
+    async highlightCode(code, options) {
+      const { highlightCode } = await loadModule();
+      return highlightCode(code, options);
+    }
+  };
+}
+const defaultRuntime = createHighlightRuntime(
+  () => import("@takazudo/zfb-md-wasm")
+);
+function getUsableHighlightHtml(result) {
+  if (result.html == null || result.diagnostics.some((diagnostic) => diagnostic.severity === "error")) {
+    return null;
+  }
+  return result.html;
+}
+function startHighlightRequest({
+  code,
+  language,
+  onSettled,
+  runtime = defaultRuntime
+}) {
+  let cancelled = false;
+  void Promise.resolve().then(() => runtime.highlightCode(code, { language })).then(
+    (result) => {
+      if (!cancelled) {
+        onSettled(getUsableHighlightHtml(result));
+      }
+    },
+    () => {
+      if (!cancelled) {
+        onSettled(null);
+      }
+    }
+  );
+  return () => {
+    cancelled = true;
+  };
+}
+export {
+  createHighlightRuntime,
+  getUsableHighlightHtml,
+  startHighlightRequest
+};

package/dist/html-preview-wrapper/highlighted-code.d.ts

@@ -6,8 +6,9 @@ export interface HighlightedCodeProps {
     language: string;
 }
 /**
- * Syntax-highlighted code block backed by Shiki. Falls back to a
- * plain `<pre><code>` block while Shiki is loading or if it fails.
+ * Syntax-highlighted code block backed by zfb's semantic-class WASM API.
+ * Falls back to a plain `<pre><code>` block while the runtime is loading or
+ * when the current request cannot produce safe markup.
  *
  * JSX port of src/components/html-preview/highlighted-code.tsx.
  */

package/dist/html-preview-wrapper/highlighted-code.js

@@ -1,41 +1,22 @@
 import { jsx } from "preact/jsx-runtime";
 import { useEffect, useState } from "preact/hooks";
-let highlighterPromise = null;
-function getHighlighter() {
-  if (!highlighterPromise) {
-    highlighterPromise = import("shiki").then(
-      ({ createHighlighter }) => createHighlighter({
-        themes: ["catppuccin-latte", "vitesse-dark"],
-        langs: ["html", "css", "javascript"]
-      })
-    ).catch((err) => {
-      highlighterPromise = null;
-      throw err;
-    });
-  }
-  return highlighterPromise;
-}
+import { startHighlightRequest } from "./highlight-runtime.js";
 function HighlightedCode({
   code,
   language
 }) {
-  const [html, setHtml] = useState(null);
+  const [highlighted, setHighlighted] = useState(null);
+  const html = highlighted?.code === code && highlighted.language === language ? highlighted.html : null;
   useEffect(() => {
-    let cancelled = false;
-    getHighlighter().then((highlighter) => {
-      if (cancelled) return;
-      const lang = highlighter.getLoadedLanguages().includes(language) ? language : "text";
-      const result = highlighter.codeToHtml(code, {
-        lang,
-        themes: { light: "catppuccin-latte", dark: "vitesse-dark" },
-        defaultColor: false
-      });
-      setHtml(result);
-    }).catch(() => {
+    return startHighlightRequest({
+      code,
+      language,
+      onSettled(nextHtml) {
+        setHighlighted(
+          nextHtml == null ? null : { code, language, html: nextHtml }
+        );
+      }
     });
-    return () => {
-      cancelled = true;
-    };
   }, [code, language]);
   if (!html) {
     return /* @__PURE__ */ jsx("pre", { class: "m-0 p-hsp-md bg-code-bg text-caption leading-relaxed overflow-x-auto", children: /* @__PURE__ */ jsx("code", { class: "font-mono whitespace-pre", children: code }) });

package/dist/i18n-defaults/index.js

@@ -29,6 +29,7 @@ const defaultTranslations = {
     "doc.tags": "Tags",
     "doc.taggedWith": "Pages tagged with",
     "doc.allTags": "All Tags",
+    "doc.seeAllTags": "See all tags",
     "doc.created": "Created",
     "doc.updated": "Updated",
     "doc.noTags": "No tags found.",
@@ -87,6 +88,7 @@ const defaultTranslations = {
     "doc.tags": "\u30BF\u30B0",
     "doc.taggedWith": "\u30BF\u30B0\u4ED8\u304D\u30DA\u30FC\u30B8",
     "doc.allTags": "\u3059\u3079\u3066\u306E\u30BF\u30B0",
+    "doc.seeAllTags": "\u3059\u3079\u3066\u306E\u30BF\u30B0\u3092\u898B\u308B",
     "doc.created": "\u4F5C\u6210",
     "doc.updated": "\u66F4\u65B0",
     "doc.noTags": "\u30BF\u30B0\u304C\u898B\u3064\u304B\u308A\u307E\u305B\u3093\u3002",
@@ -146,6 +148,7 @@ const defaultTranslations = {
     "doc.tags": "Tags",
     "doc.taggedWith": "Seiten mit Tag",
     "doc.allTags": "Alle Tags",
+    "doc.seeAllTags": "Alle Tags anzeigen",
     "doc.created": "Erstellt",
     "doc.updated": "Aktualisiert",
     "doc.noTags": "Keine Tags gefunden.",