@takazudo/zudo-doc 0.1.0

package/dist/header/header.d.ts

@@ -0,0 +1,158 @@
+import { ComponentChildren, JSX } from 'preact';
+import { Locale, HeaderNavItem, HeaderRightItem } from './types.js';
+
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+
+/**
+ * Boundary helpers the host injects into `<Header>`. These are the URL
+ * builders the legacy header.tsx used to import from `@/utils/base` —
+ * pulled into a single prop bag so the v2 package is host-agnostic.
+ */
+interface HeaderUrlHelpers {
+    withBase(path: string): string;
+    stripBase(path: string): string;
+    navHref(path: string, lang?: Locale, currentVersion?: string): string;
+}
+/**
+ * Boundary helpers for locale-aware behaviour the host injects into
+ * `<Header>`. Matches the surface the legacy header.tsx used from
+ * `@/config/i18n`.
+ */
+interface HeaderI18n {
+    defaultLocale: string;
+    locales: readonly string[];
+    t(key: string, lang?: string): string;
+}
+/**
+ * Props for the JSX `<Header />` port. Mirrors the Astro template's
+ * `Props` interface plus a small set of slot props that replace child
+ * Astro components and named `<slot>` outlets.
+ */
+interface HeaderProps {
+    /** Active locale; `undefined` matches the legacy "no-lang" code path. */
+    lang?: Locale;
+    /** Current page URL path (as the layout passes from `Astro.url.pathname`). */
+    currentPath?: string;
+    /** Optional active version slug. Forwarded into `navHref` for nav links. */
+    currentVersion?: string;
+    /**
+     * Children projected into the mobile `<SidebarToggle>` island —
+     * replaces the legacy `<slot name="sidebar" />`. Consumers pass the
+     * sidebar tree they want to surface in the mobile sheet.
+     */
+    sidebarSlot?: ComponentChildren;
+    /**
+     * Replacement for the `<SidebarToggle client:media="...">` element in
+     * the legacy template. Consumers wrap their preferred Preact /
+     * `<Island>` toggle (with the sidebar slot already nested inside) and
+     * the shell drops it in untouched. When omitted nothing renders in
+     * that slot — the layout is still valid (e.g. doc pages with
+     * `hide_sidebar`).
+     */
+    sidebarToggle?: ComponentChildren;
+    /**
+     * Replacement for `<ThemeToggle client:load />`. Rendered only when
+     * `colorModeEnabled` is `true` AND a `theme-toggle` entry survives
+     * `filterHeaderRightItems` — matching the original template.
+     */
+    themeToggle?: ComponentChildren;
+    /** Replacement for the `<LanguageSwitcher />` Astro child. */
+    languageSwitcher?: ComponentChildren;
+    /** Replacement for the `<VersionSwitcher />` Astro child. */
+    versionSwitcher?: ComponentChildren;
+    /** Replacement for the `<Search />` Astro child. */
+    search?: ComponentChildren;
+    /**
+     * When provided, emits `data-zfb-transition-persist={persistKey}` on the
+     * `<header>` element so zfb's client-router preserves DOM-node identity
+     * across same-locale View Transition swaps. Omit to disable persist
+     * (back-compat default — the header is re-rendered on every swap).
+     *
+     * **Locale keying**: callers MUST key by locale (e.g. `"header-en"`,
+     * `"header-ja"`). Cross-locale swaps must NOT share the same key; a
+     * key mismatch tells the router to replace the header, re-rendering
+     * the locale toggle anchors and all other SSR'd locale-specific
+     * content with fresh markup. See zudolab/zudo-doc#1546.
+     *
+     * **headerOverride scope**: hosts that supply their own `<header>`
+     * element via `headerOverride` on `<DocLayoutWithDefaults>` are
+     * responsible for adding `data-zfb-transition-persist` to their custom
+     * element themselves. This package only injects the attribute on the
+     * default `<Header>` shell. A key of `"header-${lang}"` is recommended
+     * for consistency, matching the Astro reference implementation
+     * (zudolab/zudo-doc#1546).
+     */
+    persistKey?: string;
+    /** Site-name string shown in the logo anchor (host `settings.siteName`). */
+    siteName: string;
+    /** Header-nav items in render order (host `settings.headerNav`). */
+    headerNav: HeaderNavItem[];
+    /**
+     * Header-right items, **already filtered** by the host via
+     * `filterHeaderRightItems` (see `./right-items.ts`). The renderer no
+     * longer re-checks `settings.colorMode` / `locales.length` etc — if
+     * an item is in this array, the renderer emits its markup. Slot
+     * presence (e.g. `languageSwitcher` being supplied) still gates per
+     * the legacy template: a slot left undefined renders an empty
+     * wrapper, matching prior behaviour.
+     */
+    headerRightItems: HeaderRightItem[];
+    /**
+     * Whether the host has a `colorMode` config. Required because the
+     * `theme-toggle` right-item is two-gated: the filter drops it when
+     * `colorMode` is off entirely, but the renderer also checks it before
+     * emitting the wrapping `<div>` so a `headerRightItems` array that
+     * still contains `theme-toggle` but is rendered against a config
+     * with `colorMode === false` stays a no-op (the legacy template's
+     * shape).
+     */
+    colorModeEnabled: boolean;
+    /**
+     * Whether the host has more than one locale configured (`locales.length > 1`
+     * in the legacy template's gate). The renderer needs this to keep
+     * the language-switcher slot empty on single-locale sites even when
+     * `headerRightItems` contains a `language-switcher` entry.
+     */
+    hasLocales: boolean;
+    /**
+     * Whether the host has `versions` configured. Currently informational —
+     * the version-switcher gate lives entirely in the host slot's
+     * presence — but accepted for symmetry with `colorModeEnabled` /
+     * `hasLocales` so the prop bag fully describes the feature surface.
+     */
+    hasVersions: boolean;
+    /**
+     * Resolved GitHub repo URL (no trailing slash) or `null` when
+     * unconfigured. Replaces the legacy direct call to
+     * `buildGitHubRepoUrl()` in this component.
+     */
+    githubRepoUrl: string | null;
+    /**
+     * Localised aria-label / title for the GitHub anchor — host-side
+     * translated string (the legacy `t("header.github", lang)`).
+     */
+    githubLabel: string;
+    /** URL builder helpers — see `HeaderUrlHelpers`. */
+    urlHelpers: HeaderUrlHelpers;
+    /** i18n helpers and config — see `HeaderI18n`. */
+    i18n: HeaderI18n;
+}
+/**
+ * Site-header shell — JSX port of `src/components/header.astro`.
+ *
+ * Responsibilities (matching the legacy template byte-for-byte):
+ *   1. Render the sticky `<header>` with the site logo and the desktop
+ *      nav, including the dropdown-parent / overflow-bucket markup the
+ *      controller script reshapes at runtime.
+ *   2. Iterate `headerRightItems` (already filtered by the caller via
+ *      `filterHeaderRightItems`), emitting the matching trigger button /
+ *      icon link / consumer-supplied slot for each entry.
+ *   3. Emit the inline overflow controller script. The script wires the
+ *      "..." overflow menu, manages `aria-expanded` on dropdowns, and
+ *      re-runs after View Transitions (via `AFTER_NAVIGATE_EVENT` from
+ *      `../transitions/page-events`).
+ */
+declare function Header(props: HeaderProps): JSX.Element;
+
+export { Header, type HeaderI18n, type HeaderProps, type HeaderUrlHelpers };

package/dist/header/header.js

@@ -0,0 +1,367 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import {
+  computeActiveNavPath,
+  isNavItemActive,
+  pathForMatch
+} from "./nav-active.js";
+import { NAV_OVERFLOW_SCRIPT } from "./nav-overflow-script.js";
+function Header(props) {
+  const {
+    lang,
+    currentPath = "",
+    currentVersion,
+    sidebarSlot,
+    sidebarToggle,
+    themeToggle,
+    languageSwitcher,
+    versionSwitcher,
+    search,
+    persistKey,
+    siteName,
+    headerNav,
+    headerRightItems,
+    colorModeEnabled,
+    hasLocales,
+    githubRepoUrl,
+    githubLabel,
+    urlHelpers,
+    i18n
+  } = props;
+  const isNonDefaultLocale = lang != null && lang !== i18n.defaultLocale;
+  const pathWithoutBase = urlHelpers.stripBase(currentPath);
+  const matchPath = pathForMatch(pathWithoutBase, lang, i18n.defaultLocale);
+  const activeNavPath = computeActiveNavPath(headerNav, matchPath);
+  return /* @__PURE__ */ jsxs(
+    "header",
+    {
+      class: "sticky top-0 z-50 flex h-[3.5rem] items-center border-b border-muted bg-surface px-hsp-lg",
+      "data-header": true,
+      "data-zfb-transition-persist": persistKey,
+      children: [
+        sidebarToggle ?? // Render an inert wrapper so consumers that omit the slot still
+        // get the named-slot semantics from the legacy template
+        // (mobile sidebar contents stay accessible to assistive tech
+        // even without the toggle island).
+        /* @__PURE__ */ jsx(SidebarSlotFallback, { children: sidebarSlot }),
+        /* @__PURE__ */ jsx(
+          "a",
+          {
+            href: urlHelpers.withBase(isNonDefaultLocale ? `/${lang}/` : "/"),
+            class: "whitespace-nowrap text-title font-bold text-fg hover:underline focus:underline shrink-0",
+            "data-header-logo": true,
+            children: siteName
+          }
+        ),
+        /* @__PURE__ */ jsxs(
+          "nav",
+          {
+            "aria-label": "Main",
+            class: "relative ml-hsp-xl hidden min-w-0 flex-1 items-center gap-x-hsp-2xs whitespace-nowrap lg:flex",
+            "data-header-nav": true,
+            children: [
+              headerNav.map((item) => renderNavItem(
+                item,
+                activeNavPath,
+                lang,
+                currentVersion,
+                urlHelpers,
+                i18n
+              )),
+              /* @__PURE__ */ jsxs("div", { class: "relative shrink-0", "data-nav-more": true, style: "display:none", children: [
+                /* @__PURE__ */ jsx(
+                  "button",
+                  {
+                    type: "button",
+                    class: "px-hsp-md py-vsp-2xs text-small font-medium text-muted hover:underline cursor-pointer",
+                    "data-nav-more-toggle": true,
+                    "aria-expanded": "false",
+                    children: "\xB7\xB7\xB7"
+                  }
+                ),
+                /* @__PURE__ */ jsx(
+                  "ul",
+                  {
+                    class: "absolute right-0 top-full z-10 mt-vsp-3xs hidden min-w-[8rem] border border-muted rounded bg-surface shadow-lg whitespace-nowrap",
+                    "data-nav-more-menu": true
+                  }
+                )
+              ] })
+            ]
+          }
+        ),
+        /* @__PURE__ */ jsx(
+          "div",
+          {
+            class: "ml-auto flex shrink-0 items-center gap-x-hsp-md",
+            "data-header-right": true,
+            children: headerRightItems.map((item, i) => renderRightItem(
+              item,
+              i,
+              {
+                lang,
+                githubRepoUrl,
+                githubLabel,
+                themeToggle,
+                languageSwitcher,
+                versionSwitcher,
+                search,
+                colorModeEnabled,
+                hasLocales
+              }
+            ))
+          }
+        ),
+        /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: NAV_OVERFLOW_SCRIPT } })
+      ]
+    }
+  );
+}
+function SidebarSlotFallback({
+  children
+}) {
+  if (children === void 0 || children === null) return null;
+  return /* @__PURE__ */ jsx("span", { hidden: true, children });
+}
+function renderNavItem(item, activeNavPath, lang, currentVersion, urlHelpers, i18n) {
+  const isActive = isNavItemActive(item, activeNavPath);
+  const href = urlHelpers.navHref(item.path, lang, currentVersion);
+  const label = item.labelKey ? i18n.t(item.labelKey, lang) : item.label;
+  if (item.children && item.children.length > 0) {
+    return /* @__PURE__ */ jsxs(
+      "div",
+      {
+        class: "group relative shrink-0",
+        "data-nav-item": true,
+        "data-nav-item-dropdown": true,
+        children: [
+          /* @__PURE__ */ jsxs(
+            "a",
+            {
+              href,
+              "aria-current": isActive ? "page" : void 0,
+              "aria-haspopup": "true",
+              "aria-expanded": "false",
+              class: [
+                "flex items-center gap-x-hsp-xs px-hsp-md py-vsp-2xs text-small font-medium transition-colors",
+                isActive ? "bg-fg text-bg" : "text-muted hover:underline focus:underline"
+              ].join(" "),
+              children: [
+                label,
+                /* @__PURE__ */ jsx(
+                  "svg",
+                  {
+                    class: [
+                      "h-[0.5rem] w-[0.5rem] shrink-0",
+                      isActive ? "text-bg" : "text-muted"
+                    ].join(" "),
+                    fill: "none",
+                    viewBox: "0 0 24 24",
+                    stroke: "currentColor",
+                    "stroke-width": "3",
+                    "aria-hidden": "true",
+                    children: /* @__PURE__ */ jsx(
+                      "path",
+                      {
+                        "stroke-linecap": "round",
+                        "stroke-linejoin": "round",
+                        d: "M19 9l-7 7-7-7"
+                      }
+                    )
+                  }
+                )
+              ]
+            }
+          ),
+          /* @__PURE__ */ jsx("div", { class: "absolute left-0 top-full z-50 hidden group-hover:block group-focus-within:block pt-vsp-3xs", children: /* @__PURE__ */ jsx("div", { class: "min-w-[10rem] border border-muted rounded bg-surface shadow-lg py-vsp-3xs", children: item.children.map((child) => {
+            const childHref = urlHelpers.navHref(child.path, lang, currentVersion);
+            const childLabel = child.labelKey ? i18n.t(child.labelKey, lang) : child.label;
+            const childActive = activeNavPath === child.path;
+            return /* @__PURE__ */ jsx(
+              "a",
+              {
+                href: childHref,
+                "data-active": childActive ? "" : void 0,
+                class: [
+                  "block px-hsp-md py-vsp-2xs text-small hover:bg-accent/10 hover:underline",
+                  childActive ? "font-bold text-accent" : "text-fg"
+                ].join(" "),
+                children: childLabel
+              }
+            );
+          }) }) })
+        ]
+      }
+    );
+  }
+  return /* @__PURE__ */ jsx(
+    "a",
+    {
+      href,
+      "aria-current": isActive ? "page" : void 0,
+      "data-nav-item": true,
+      class: [
+        "px-hsp-md py-vsp-2xs text-small font-medium transition-colors shrink-0",
+        isActive ? "bg-fg text-bg" : "text-muted hover:underline focus:underline"
+      ].join(" "),
+      children: label
+    }
+  );
+}
+function renderRightItem(item, index, ctx) {
+  if (item.type === "trigger" && item.trigger === "design-token-panel") {
+    const inlineOnclick = {
+      onclick: "window.dispatchEvent(new CustomEvent('toggle-design-token-panel'))"
+    };
+    return /* @__PURE__ */ jsx(
+      "button",
+      {
+        id: "design-token-trigger",
+        type: "button",
+        class: "flex items-center justify-center text-muted transition-colors hover:text-fg",
+        "aria-label": "Toggle design token panel",
+        ...inlineOnclick,
+        children: /* @__PURE__ */ jsxs(
+          "svg",
+          {
+            xmlns: "http://www.w3.org/2000/svg",
+            width: "20",
+            height: "20",
+            viewBox: "0 0 24 24",
+            fill: "none",
+            stroke: "currentColor",
+            "stroke-width": "2",
+            "stroke-linecap": "round",
+            "stroke-linejoin": "round",
+            "aria-hidden": "true",
+            children: [
+              /* @__PURE__ */ jsx("circle", { cx: "13.5", cy: "6.5", r: "2.5" }),
+              /* @__PURE__ */ jsx("circle", { cx: "17.5", cy: "10.5", r: "2.5" }),
+              /* @__PURE__ */ jsx("circle", { cx: "8.5", cy: "7.5", r: "2.5" }),
+              /* @__PURE__ */ jsx("circle", { cx: "6.5", cy: "12.5", r: "2.5" }),
+              /* @__PURE__ */ jsx("path", { d: "M12 2C6.5 2 2 6.5 2 12s4.5 10 10 10c.926 0 1.648-.746 1.648-1.688 0-.437-.18-.835-.437-1.125-.29-.289-.438-.652-.438-1.125a1.64 1.64 0 0 1 1.668-1.668h1.996c3.051 0 5.555-2.503 5.555-5.554C21.965 6.012 17.461 2 12 2z" })
+            ]
+          }
+        )
+      },
+      `right-${index}`
+    );
+  }
+  if (item.type === "trigger" && item.trigger === "ai-chat") {
+    const inlineOnclick = {
+      onclick: "window.dispatchEvent(new CustomEvent('toggle-ai-chat'))"
+    };
+    return /* @__PURE__ */ jsx(
+      "button",
+      {
+        id: "ai-chat-trigger",
+        type: "button",
+        class: "flex items-center justify-center text-muted transition-colors hover:text-fg",
+        "aria-label": "Open AI assistant",
+        ...inlineOnclick,
+        children: /* @__PURE__ */ jsxs(
+          "svg",
+          {
+            xmlns: "http://www.w3.org/2000/svg",
+            width: "20",
+            height: "20",
+            viewBox: "0 0 24 24",
+            fill: "currentColor",
+            "aria-hidden": "true",
+            children: [
+              /* @__PURE__ */ jsx("path", { d: "M9.5 2.5Q10.5 11.5 18 13Q10.5 14.5 9.5 23.5Q8.5 14.5 1 13Q8.5 11.5 9.5 2.5Z" }),
+              /* @__PURE__ */ jsx("path", { d: "M19 0.5Q19.5 4 23.5 5Q19.5 6 19 9.5Q18.5 6 14.5 5Q18.5 4 19 0.5Z" })
+            ]
+          }
+        )
+      },
+      `right-${index}`
+    );
+  }
+  if (item.type === "component" && item.component === "version-switcher") {
+    return /* @__PURE__ */ jsx("div", { class: "hidden lg:block", children: ctx.versionSwitcher }, `right-${index}`);
+  }
+  if (item.type === "component" && item.component === "github-link" && ctx.githubRepoUrl) {
+    return /* @__PURE__ */ jsxs(
+      "a",
+      {
+        href: ctx.githubRepoUrl,
+        target: "_blank",
+        rel: "noopener noreferrer",
+        class: "flex items-center justify-center text-muted transition-colors hover:text-fg",
+        "aria-label": ctx.githubLabel,
+        title: ctx.githubLabel,
+        children: [
+          /* @__PURE__ */ jsx("span", { class: "sr-only", children: ctx.githubLabel }),
+          /* @__PURE__ */ jsx(
+            "svg",
+            {
+              xmlns: "http://www.w3.org/2000/svg",
+              width: "20",
+              height: "20",
+              viewBox: "0 0 24 24",
+              fill: "currentColor",
+              "aria-hidden": "true",
+              children: /* @__PURE__ */ jsx("path", { d: "M12 .5C5.649.5.5 5.649.5 12a11.5 11.5 0 0 0 7.86 10.915c.575.106.785-.25.785-.556 0-.274-.01-1-.016-1.962-3.198.695-3.873-1.541-3.873-1.541-.523-1.327-1.277-1.68-1.277-1.68-1.044-.714.079-.699.079-.699 1.154.082 1.761 1.186 1.761 1.186 1.026 1.758 2.692 1.25 3.348.956.104-.743.401-1.25.73-1.537-2.553-.29-5.238-1.276-5.238-5.682 0-1.255.448-2.282 1.182-3.086-.119-.29-.512-1.458.111-3.04 0 0 .964-.309 3.159 1.18A10.98 10.98 0 0 1 12 6.036c.977.005 1.963.132 2.883.387 2.193-1.49 3.155-1.18 3.155-1.18.625 1.582.232 2.75.114 3.04.736.804 1.18 1.831 1.18 3.086 0 4.417-2.689 5.389-5.25 5.673.412.355.779 1.056.779 2.129 0 1.538-.014 2.778-.014 3.156 0 .31.207.668.79.555A11.502 11.502 0 0 0 23.5 12C23.5 5.649 18.351.5 12 .5Z" })
+            }
+          )
+        ]
+      },
+      `right-${index}`
+    );
+  }
+  if (item.type === "component" && item.component === "theme-toggle") {
+    if (!ctx.colorModeEnabled) return null;
+    return /* @__PURE__ */ jsx("div", { class: "hidden lg:flex items-center", children: ctx.themeToggle }, `right-${index}`);
+  }
+  if (item.type === "component" && item.component === "language-switcher") {
+    if (!(ctx.lang && ctx.hasLocales)) return null;
+    return /* @__PURE__ */ jsx("div", { class: "hidden lg:flex items-center", children: ctx.languageSwitcher }, `right-${index}`);
+  }
+  if (item.type === "component" && item.component === "search") {
+    return /* @__PURE__ */ jsx("div", { children: ctx.search }, `right-${index}`);
+  }
+  if (item.type === "link") {
+    const label = item.label ?? item.ariaLabel;
+    const isExternal = /^https?:\/\//.test(item.href);
+    return /* @__PURE__ */ jsx(
+      "a",
+      {
+        href: item.href,
+        target: isExternal ? "_blank" : void 0,
+        rel: isExternal ? "noopener noreferrer" : void 0,
+        class: "flex items-center justify-center text-muted transition-colors hover:text-fg",
+        "aria-label": item.ariaLabel,
+        title: label,
+        children: item.icon === "github" ? /* @__PURE__ */ jsxs(Fragment, { children: [
+          label && /* @__PURE__ */ jsx("span", { class: "sr-only", children: label }),
+          /* @__PURE__ */ jsx(
+            "svg",
+            {
+              xmlns: "http://www.w3.org/2000/svg",
+              width: "20",
+              height: "20",
+              viewBox: "0 0 24 24",
+              fill: "currentColor",
+              "aria-hidden": "true",
+              children: /* @__PURE__ */ jsx("path", { d: "M12 .5C5.649.5.5 5.649.5 12a11.5 11.5 0 0 0 7.86 10.915c.575.106.785-.25.785-.556 0-.274-.01-1-.016-1.962-3.198.695-3.873-1.541-3.873-1.541-.523-1.327-1.277-1.68-1.277-1.68-1.044-.714.079-.699.079-.699 1.154.082 1.761 1.186 1.761 1.186 1.026 1.758 2.692 1.25 3.348.956.104-.743.401-1.25.73-1.537-2.553-.29-5.238-1.276-5.238-5.682 0-1.255.448-2.282 1.182-3.086-.119-.29-.512-1.458.111-3.04 0 0 .964-.309 3.159 1.18A10.98 10.98 0 0 1 12 6.036c.977.005 1.963.132 2.883.387 2.193-1.49 3.155-1.18 3.155-1.18.625 1.582.232 2.75.114 3.04.736.804 1.18 1.831 1.18 3.086 0 4.417-2.689 5.389-5.25 5.673.412.355.779 1.056.779 2.129 0 1.538-.014 2.778-.014 3.156 0 .31.207.668.79.555A11.502 11.502 0 0 0 23.5 12C23.5 5.649 18.351.5 12 .5Z" })
+            }
+          )
+        ] }) : label
+      },
+      `right-${index}`
+    );
+  }
+  if (item.type === "html") {
+    return /* @__PURE__ */ jsx(
+      "span",
+      {
+        dangerouslySetInnerHTML: { __html: item.html }
+      },
+      `right-${index}`
+    );
+  }
+  return null;
+}
+export {
+  Header
+};

package/dist/header/index.d.ts

@@ -0,0 +1,6 @@
+export { HeaderNavChildItem, HeaderNavItem, HeaderRightComponentItem, HeaderRightComponentName, HeaderRightHtmlItem, HeaderRightItem, HeaderRightLinkItem, HeaderRightTriggerItem, HeaderRightTriggerName, Locale } from './types.js';
+export { HeaderRightItemFlags, filterHeaderRightItems } from './right-items.js';
+export { Header, HeaderProps } from './header.js';
+export { NavItemLike, computeActiveNavPath, isNavItemActive, pathForMatch } from './nav-active.js';
+export { NAV_OVERFLOW_SCRIPT } from './nav-overflow-script.js';
+import 'preact';

package/dist/header/index.js

@@ -0,0 +1,18 @@
+import {
+  filterHeaderRightItems
+} from "./right-items.js";
+import { Header } from "./header.js";
+import {
+  computeActiveNavPath,
+  isNavItemActive,
+  pathForMatch
+} from "./nav-active.js";
+import { NAV_OVERFLOW_SCRIPT } from "./nav-overflow-script.js";
+export {
+  Header,
+  NAV_OVERFLOW_SCRIPT,
+  computeActiveNavPath,
+  filterHeaderRightItems,
+  isNavItemActive,
+  pathForMatch
+};

package/dist/header/nav-active.d.ts

@@ -0,0 +1,39 @@
+/** Minimal shape the active-path resolver needs from a header nav item. */
+interface NavItemLike {
+    path: string;
+    children?: {
+        path: string;
+    }[];
+}
+/**
+ * Strip the locale prefix from `pathWithoutBase` when the page is being
+ * served under a non-default locale. Mirrors the inline regex inside
+ * `header.astro` so the JSX port matches the legacy template's
+ * active-link behaviour.
+ *
+ * Examples:
+ *   pathForMatch("/ja/docs/intro", "ja", "en") === "/docs/intro"
+ *   pathForMatch("/docs/intro",   "en", "en") === "/docs/intro"
+ *   pathForMatch(null,            "ja", "en") === ""
+ */
+declare function pathForMatch(pathWithoutBase: string, lang: string | undefined, defaultLocale: string): string;
+/**
+ * Pick the deepest header-nav path that the current page lives under.
+ *
+ * The legacy template flattens parent + child paths, filters by
+ * `pathForMatch.startsWith(p)`, and picks the longest match — this keeps
+ * a child link active even when its parent's path is also a prefix of
+ * the current page.
+ *
+ * Returns `undefined` when no nav entry matches; callers should treat
+ * that as "no active link."
+ */
+declare function computeActiveNavPath(navItems: readonly NavItemLike[], pathForMatchValue: string): string | undefined;
+/**
+ * Active-state predicate for a top-level nav item: the item itself, or
+ * any of its children, matches the active path. Mirrors the inline
+ * `isNavItemActive` helper in the legacy template.
+ */
+declare function isNavItemActive(item: NavItemLike, activeNavPath: string | undefined): boolean;
+
+export { type NavItemLike, computeActiveNavPath, isNavItemActive, pathForMatch };

package/dist/header/nav-active.js

@@ -0,0 +1,24 @@
+function pathForMatch(pathWithoutBase, lang, defaultLocale) {
+  if (lang == null || lang === defaultLocale) return pathWithoutBase;
+  return pathWithoutBase.replace(new RegExp(`^/${lang}`), "");
+}
+function computeActiveNavPath(navItems, pathForMatchValue) {
+  const allNavPaths = navItems.flatMap((item) => {
+    const paths = [item.path];
+    if (item.children) {
+      paths.push(...item.children.map((child) => child.path));
+    }
+    return paths;
+  });
+  return allNavPaths.filter((p) => pathForMatchValue.startsWith(p)).sort((a, b) => b.length - a.length)[0];
+}
+function isNavItemActive(item, activeNavPath) {
+  if (activeNavPath === item.path) return true;
+  if (item.children?.some((child) => activeNavPath === child.path)) return true;
+  return false;
+}
+export {
+  computeActiveNavPath,
+  isNavItemActive,
+  pathForMatch
+};

package/dist/header/nav-overflow-script.d.ts

@@ -0,0 +1,3 @@
+declare const NAV_OVERFLOW_SCRIPT: string;
+
+export { NAV_OVERFLOW_SCRIPT };