@takazudo/zudo-doc 0.2.21 → 1.0.0

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

@@ -1,5 +1,5 @@
 /** Minimal shape the active-path resolver needs from a header nav item. */
-interface NavItemLike {
+export interface NavItemLike {
     path: string;
     /**
      * The "big category" this nav entry claims (mirrors the host's
@@ -24,14 +24,14 @@ interface NavItemLike {
  *   pathForMatch("/docs/intro",   "en", "en") === "/docs/intro"
  *   pathForMatch(null,            "ja", "en") === ""
  */
-declare function pathForMatch(pathWithoutBase: string, lang: string | undefined, defaultLocale: string): string;
-declare function computeActiveNavPath(navItems: readonly NavItemLike[], pathForMatchValue: string): string | undefined;
+export declare function pathForMatch(pathWithoutBase: string, lang: string | undefined, defaultLocale: string): string;
+export 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 declare function isNavItemActive(item: NavItemLike, activeNavPath: string | undefined): boolean;
 /**
  * Category-based active-state predicate. A nav entry is active when its
  * own `categoryMatch` equals the page's resolved big category
@@ -49,6 +49,4 @@ declare function isNavItemActive(item: NavItemLike, activeNavPath: string | unde
  * `children` of its own, so the call collapses to a single
  * `categoryMatch` comparison.
  */
-declare function isNavItemActiveByCategory(item: NavItemLike, activeCategory: string | undefined): boolean;
-
-export { type NavItemLike, computeActiveNavPath, isNavItemActive, isNavItemActiveByCategory, pathForMatch };
+export declare function isNavItemActiveByCategory(item: NavItemLike, activeCategory: string | undefined): boolean;

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

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

package/dist/header/right-items.d.ts

@@ -1,5 +1,4 @@
-import { HeaderRightItem } from './types.js';
-
+import type { HeaderRightItem } from "./types.js";
 /**
  * Runtime gates for `filterHeaderRightItems`.
  *
@@ -14,7 +13,7 @@ import { HeaderRightItem } from './types.js';
  *   - `hasVersions`      — `Boolean(settings.versions)`
  *   - `hasGithubUrl`     — `Boolean(settings.githubUrl)`
  */
-interface HeaderRightItemFlags {
+export interface HeaderRightItemFlags {
     designTokenPanel: boolean;
     aiAssistant: boolean;
     colorMode: boolean;
@@ -29,6 +28,4 @@ interface HeaderRightItemFlags {
  * Items not gated by any flag (links, raw HTML, version-switcher when
  * versions are configured, search, …) pass through untouched.
  */
-declare function filterHeaderRightItems(items: HeaderRightItem[], flags: HeaderRightItemFlags): HeaderRightItem[];
-
-export { type HeaderRightItemFlags, filterHeaderRightItems };
+export declare function filterHeaderRightItems(items: HeaderRightItem[], flags: HeaderRightItemFlags): HeaderRightItem[];

package/dist/header/types.d.ts

@@ -4,37 +4,35 @@
  * package can render for any project's locale set without a generic
  * parameter (super-epic #1724, sub-issue #1729).
  */
-type Locale = string;
-interface HeaderNavChildItem {
+export type Locale = string;
+export interface HeaderNavChildItem {
     label: string;
     labelKey?: string;
     path: string;
     categoryMatch?: string;
 }
-interface HeaderNavItem extends HeaderNavChildItem {
+export interface HeaderNavItem extends HeaderNavChildItem {
     children?: HeaderNavChildItem[];
 }
-type HeaderRightComponentName = "theme-toggle" | "language-switcher" | "version-switcher" | "github-link" | "search";
-type HeaderRightTriggerName = "design-token-panel" | "ai-chat";
-interface HeaderRightComponentItem {
+export type HeaderRightComponentName = "theme-toggle" | "language-switcher" | "version-switcher" | "github-link" | "search";
+export type HeaderRightTriggerName = "design-token-panel" | "ai-chat";
+export interface HeaderRightComponentItem {
     type: "component";
     component: HeaderRightComponentName;
 }
-interface HeaderRightTriggerItem {
+export interface HeaderRightTriggerItem {
     type: "trigger";
     trigger: HeaderRightTriggerName;
 }
-interface HeaderRightLinkItem {
+export interface HeaderRightLinkItem {
     type: "link";
     href: string;
     label?: string;
     ariaLabel?: string;
     icon?: "github";
 }
-interface HeaderRightHtmlItem {
+export interface HeaderRightHtmlItem {
     type: "html";
     html: string;
 }
-type HeaderRightItem = HeaderRightComponentItem | HeaderRightTriggerItem | HeaderRightLinkItem | HeaderRightHtmlItem;
-
-export type { HeaderNavChildItem, HeaderNavItem, HeaderRightComponentItem, HeaderRightComponentName, HeaderRightHtmlItem, HeaderRightItem, HeaderRightLinkItem, HeaderRightTriggerItem, HeaderRightTriggerName, Locale };
+export type HeaderRightItem = HeaderRightComponentItem | HeaderRightTriggerItem | HeaderRightLinkItem | HeaderRightHtmlItem;

package/dist/header-with-defaults/index.d.ts

@@ -0,0 +1,77 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+import type { SidebarNavNode, SidebarRootMenuItem } from "../sidebar/types.js";
+import type { LocaleLink } from "../url-helpers/index.js";
+export interface HeaderWithDefaultsProps {
+    /** Active locale; defaults to the configured defaultLocale. */
+    lang?: string;
+    /** Current page URL path. Used to compute the active nav item. */
+    currentPath?: string;
+    /** Active version slug, when rendering inside /v/{version}/... routes. */
+    currentVersion?: string;
+    /** Slug of the active doc page. */
+    currentSlug?: string;
+    /** Header-nav category matcher used to scope the sidebar tree. */
+    navSection?: string;
+}
+/** Version config entry subset the factory reads. */
+export interface HeaderVersionEntry {
+    slug: string;
+    label?: string;
+}
+/** Settings subset read by {@link createHeaderWithDefaults}. */
+export interface HeaderWithDefaultsSettings {
+    siteName: string;
+    headerNav: Array<{
+        label: string;
+        labelKey?: string;
+        path: string;
+        categoryMatch?: string;
+        children?: Array<{
+            label: string;
+            labelKey?: string;
+            path: string;
+        }>;
+    }>;
+    headerRightItems?: unknown[];
+    designTokenPanel?: boolean;
+    aiAssistant?: boolean;
+    colorMode?: {
+        defaultMode?: string;
+    } | null | false;
+    locales: Record<string, unknown>;
+    versions?: HeaderVersionEntry[] | false;
+    githubUrl?: string | false;
+}
+/** Dependencies injected by the host stub. */
+export interface HeaderWithDefaultsDeps {
+    settings: HeaderWithDefaultsSettings;
+    defaultLocale: string;
+    locales: readonly string[];
+    t: (key: string, lang: string) => string;
+    withBase: (path: string) => string;
+    stripBase: (path: string) => string;
+    docsUrl: (slug: string, lang: string) => string;
+    navHref: (path: string, lang: string | undefined, version: string | undefined) => string;
+    versionedDocsUrl: (slug: string, versionSlug: string, lang: string) => string;
+    buildLocaleLinksForNav: (currentPath: string, lang: string, localeCount: number) => LocaleLink[] | undefined;
+    buildRootMenuItems: (lang: string, currentVersion: string | undefined) => SidebarRootMenuItem[];
+    buildSidebarNodes: (lang: string, navSection: string | undefined, currentVersion: string | undefined) => SidebarNavNode[];
+    getThemeDefaultMode: () => "light" | "dark" | undefined;
+    buildGitHubRepoUrl: () => string | null;
+    SearchWidget: (props: {
+        placeholderText: string;
+        shortcutHint: string;
+        resultCountTemplate: string;
+        searchLabel: string;
+        searchUnavailableText: string;
+        loadingIndexText: string;
+        noResultsText: string;
+    }) => JSX.Element;
+}
+/**
+ * Create a `HeaderWithDefaults` component bound to the host's settings
+ * and data-prep utilities.
+ */
+export declare function createHeaderWithDefaults(deps: HeaderWithDefaultsDeps): (props: HeaderWithDefaultsProps) => JSX.Element;

package/dist/header-with-defaults/index.js

@@ -0,0 +1,163 @@
+import { jsx } from "preact/jsx-runtime";
+import { Island } from "@takazudo/zfb";
+import { Header, filterHeaderRightItems } from "../header/index.js";
+import {
+  LanguageSwitcher,
+  VersionSwitcher
+} from "../i18n-version/index.js";
+import { ThemeToggle } from "../theme-toggle/index.js";
+import { SidebarToggle } from "../sidebar-toggle-island/index.js";
+function createHeaderWithDefaults(deps) {
+  const {
+    settings,
+    defaultLocale,
+    locales,
+    t,
+    withBase,
+    stripBase,
+    docsUrl,
+    navHref,
+    versionedDocsUrl,
+    buildLocaleLinksForNav,
+    buildRootMenuItems,
+    buildSidebarNodes,
+    getThemeDefaultMode,
+    buildGitHubRepoUrl,
+    SearchWidget
+  } = deps;
+  function HeaderWithDefaults(props) {
+    const {
+      lang: langProp = defaultLocale,
+      currentPath = "",
+      currentVersion,
+      currentSlug,
+      navSection
+    } = props;
+    const lang = langProp;
+    const rootMenuItems = buildRootMenuItems(lang, currentVersion);
+    const backToMenuLabel = t("nav.backToMenu", lang);
+    const localeLinks = buildLocaleLinksForNav(currentPath, lang, locales.length);
+    const themeDefaultMode = getThemeDefaultMode();
+    const sidebarNodes = buildSidebarNodes(lang, navSection, currentVersion);
+    const sidebarToggle = Island({
+      when: "visible",
+      children: /* @__PURE__ */ jsx(
+        SidebarToggle,
+        {
+          nodes: sidebarNodes,
+          currentSlug,
+          rootMenuItems,
+          backToMenuLabel,
+          localeLinks,
+          themeDefaultMode
+        }
+      )
+    });
+    const themeToggle = Island({
+      when: "load",
+      children: /* @__PURE__ */ jsx(ThemeToggle, { defaultMode: themeDefaultMode })
+    });
+    const searchWidget = /* @__PURE__ */ jsx(
+      SearchWidget,
+      {
+        placeholderText: t("search.placeholder", lang),
+        shortcutHint: t("search.shortcutHint", lang),
+        resultCountTemplate: t("search.resultCount", lang),
+        searchLabel: t("search.label", lang),
+        searchUnavailableText: t("search.unavailable", lang),
+        loadingIndexText: t("search.loadingIndex", lang),
+        noResultsText: t("search.noResults", lang)
+      }
+    );
+    let versionSwitcher;
+    if (settings.versions && settings.versions.length > 0) {
+      const isNonDefaultLocale = lang !== defaultLocale;
+      const versionsPageUrl = withBase(
+        isNonDefaultLocale ? `/${lang}/docs/versions` : "/docs/versions"
+      );
+      const latestUrl = currentSlug != null ? docsUrl(currentSlug, lang) : versionsPageUrl;
+      const versionUrls = {};
+      for (const v of settings.versions) {
+        versionUrls[v.slug] = currentSlug != null ? versionedDocsUrl(currentSlug, v.slug, lang) : versionsPageUrl;
+      }
+      const labels = {
+        latest: t("version.latest", lang),
+        switcher: t("version.switcher.label", lang),
+        unavailable: t("version.switcher.unavailable", lang),
+        allVersions: t("version.switcher.allVersions", lang)
+      };
+      versionSwitcher = /* @__PURE__ */ jsx(
+        VersionSwitcher,
+        {
+          versions: settings.versions.map((v) => ({
+            slug: v.slug,
+            label: v.label ?? v.slug
+          })),
+          currentVersion,
+          latestUrl,
+          versionsPageUrl,
+          versionUrls,
+          labels,
+          idSuffix: "header"
+        }
+      );
+    }
+    const languageSwitcher = localeLinks != null ? /* @__PURE__ */ jsx(
+      LanguageSwitcher,
+      {
+        links: localeLinks
+      }
+    ) : void 0;
+    const persistKey = `header-${lang}`;
+    const headerRightItems = filterHeaderRightItems(
+      settings.headerRightItems ?? [],
+      {
+        designTokenPanel: Boolean(settings.designTokenPanel),
+        aiAssistant: Boolean(settings.aiAssistant),
+        colorMode: Boolean(settings.colorMode),
+        hasLocales: Object.keys(settings.locales).length > 0,
+        hasVersions: Boolean(settings.versions),
+        hasGithubUrl: Boolean(settings.githubUrl)
+      }
+    );
+    const githubRepoUrl = buildGitHubRepoUrl();
+    const githubLabel = t("header.github", lang);
+    return /* @__PURE__ */ jsx(
+      Header,
+      {
+        lang,
+        currentPath,
+        currentVersion,
+        activeCategory: navSection,
+        sidebarToggle,
+        themeToggle,
+        search: searchWidget,
+        versionSwitcher,
+        languageSwitcher,
+        persistKey,
+        siteName: settings.siteName,
+        headerNav: settings.headerNav,
+        headerRightItems,
+        colorModeEnabled: Boolean(settings.colorMode),
+        hasLocales: locales.length > 1,
+        hasVersions: Boolean(settings.versions),
+        githubRepoUrl,
+        githubLabel,
+        urlHelpers: {
+          withBase,
+          stripBase,
+          navHref: (path, l, v) => navHref(path, l, v)
+        },
+        i18n: {
+          defaultLocale,
+          locales,
+          t
+        }
+      }
+    );
+  }
+  return HeaderWithDefaults;
+}
+export {
+  createHeaderWithDefaults
+};

package/dist/html-preview-wrapper/dedent.d.ts

@@ -5,6 +5,4 @@
  * Copied from src/utils/dedent.ts so the v2 package has no upward dependency
  * on the host project's source.
  */
-declare function dedent(text: string): string;
-
-export { dedent };
+export declare function dedent(text: string): string;

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

@@ -1,9 +1,7 @@
-import { VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface HighlightedCodeProps {
+import type { VNode } from "preact";
+export interface HighlightedCodeProps {
     code: string;
     language: string;
 }
@@ -13,6 +11,4 @@ interface HighlightedCodeProps {
  *
  * JSX port of src/components/html-preview/highlighted-code.tsx.
  */
-declare function HighlightedCode({ code, language, }: HighlightedCodeProps): VNode;
-
-export { HighlightedCode, type HighlightedCodeProps };
+export declare function HighlightedCode({ code, language, }: HighlightedCodeProps): VNode;

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

@@ -1,14 +1,12 @@
-import { VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { VNode } from "preact";
 /**
  * Global HTML preview configuration. Mirrors the `settings.htmlPreview`
  * shape from the host project so callers can pass the resolved config
  * object directly.
  */
-interface HtmlPreviewGlobalConfig {
+export interface HtmlPreviewGlobalConfig {
     /** CSS appended to every preview iframe (e.g. global component library styles). */
     css?: string;
     /** HTML injected into the `<head>` of every preview iframe. */
@@ -16,7 +14,7 @@ interface HtmlPreviewGlobalConfig {
     /** JavaScript appended to every preview iframe's `<body>`. */
     js?: string;
 }
-interface HtmlPreviewWrapperProps {
+export interface HtmlPreviewWrapperProps {
     /**
      * Site-wide HTML preview configuration (resolved from
      * `settings.htmlPreview` by the caller). When provided, its
@@ -83,8 +81,8 @@ interface HtmlPreviewWrapperProps {
  * (`HtmlPreviewWrapperInner`) and is exported, so the marker resolves to
  * THIS bare component and the bundle hydrates it in-place.
  */
-declare function HtmlPreviewWrapperInner(props: HtmlPreviewWrapperProps): VNode;
-declare namespace HtmlPreviewWrapperInner {
+export declare function HtmlPreviewWrapperInner(props: HtmlPreviewWrapperProps): VNode;
+export declare namespace HtmlPreviewWrapperInner {
     var displayName: string;
 }
 /**
@@ -103,6 +101,4 @@ declare namespace HtmlPreviewWrapperInner {
  * `HtmlPreview: HtmlPreviewWrapper` keep working (and now hydrate correctly)
  * with no call-site change.
  */
-declare function HtmlPreviewWrapper(props: HtmlPreviewWrapperProps): VNode;
-
-export { type HtmlPreviewGlobalConfig, HtmlPreviewWrapper, HtmlPreviewWrapperInner, type HtmlPreviewWrapperProps };
+export declare function HtmlPreviewWrapper(props: HtmlPreviewWrapperProps): VNode;

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

@@ -1,9 +1,7 @@
-import { VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface HtmlPreviewProps {
+import type { VNode } from "preact";
+export interface HtmlPreviewProps {
     html: string;
     css?: string;
     head?: string;
@@ -39,7 +37,7 @@ interface HtmlPreviewProps {
     /** Per-component js for code block display (before global merge) */
     componentJs?: string;
 }
-declare function containsScript(head?: string, js?: string): boolean;
+export declare function containsScript(head?: string, js?: string): boolean;
 /**
  * Resolve the iframe `sandbox` attribute value.
  *
@@ -58,7 +56,7 @@ declare function containsScript(head?: string, js?: string): boolean;
  * author-trusted MDX. See {@link HtmlPreviewProps.sandbox} for the downstream
  * trust note.
  */
-declare function resolveSandbox(sandbox: string | undefined, hasScripts: boolean): string;
+export declare function resolveSandbox(sandbox: string | undefined, hasScripts: boolean): string;
 /**
  * HTML preview widget — renders an isolated iframe with viewport
  * controls and a collapsible code section.
@@ -71,6 +69,4 @@ declare function resolveSandbox(sandbox: string | undefined, hasScripts: boolean
  * Astro, or wire up the SSR-skip placeholder pattern for non-Astro
  * consumers.
  */
-declare function HtmlPreview({ html, css, head, js, title, height, defaultOpen, sandbox, componentCss, componentHead, componentJs, }: HtmlPreviewProps): VNode;
-
-export { HtmlPreview, type HtmlPreviewProps, containsScript, resolveSandbox };
+export declare function HtmlPreview({ html, css, head, js, title, height, defaultOpen, sandbox, componentCss, componentHead, componentJs, }: HtmlPreviewProps): VNode;

package/dist/html-preview-wrapper/index.d.ts

@@ -1,5 +1,8 @@
-export { HtmlPreviewGlobalConfig, HtmlPreviewWrapper, HtmlPreviewWrapperInner, HtmlPreviewWrapperProps } from './html-preview-wrapper.js';
-export { HtmlPreview, HtmlPreviewProps } from './html-preview.js';
-export { CodeBlockData, PreviewBase, PreviewBaseProps } from './preview-base.js';
-export { HighlightedCode, HighlightedCodeProps } from './highlighted-code.js';
-import 'preact';
+export { HtmlPreviewWrapper, HtmlPreviewWrapperInner, } from "./html-preview-wrapper.js";
+export type { HtmlPreviewWrapperProps, HtmlPreviewGlobalConfig, } from "./html-preview-wrapper.js";
+export { HtmlPreview } from "./html-preview.js";
+export type { HtmlPreviewProps } from "./html-preview.js";
+export { PreviewBase } from "./preview-base.js";
+export type { PreviewBaseProps, CodeBlockData } from "./preview-base.js";
+export { HighlightedCode } from "./highlighted-code.js";
+export type { HighlightedCodeProps } from "./highlighted-code.js";

package/dist/html-preview-wrapper/preflight.d.ts

@@ -8,6 +8,4 @@
  * Copied verbatim from src/components/html-preview/preflight.ts so the
  * v2 package has no upward dependency on the host project's source.
  */
-declare const preflightCss = "\n*,\n::after,\n::before,\n::backdrop,\n::file-selector-button {\n  box-sizing: border-box;\n  margin: 0;\n  padding: 0;\n  border: 0 solid;\n}\n\nhtml,\n:host {\n  line-height: 1.5;\n  -webkit-text-size-adjust: 100%;\n  tab-size: 4;\n  font-family: ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';\n  -webkit-tap-highlight-color: transparent;\n}\n\nhr {\n  height: 0;\n  color: inherit;\n  border-top-width: 1px;\n}\n\nabbr:where([title]) {\n  -webkit-text-decoration: underline dotted;\n  text-decoration: underline dotted;\n}\n\nh1, h2, h3, h4, h5, h6 {\n  font-size: inherit;\n  font-weight: inherit;\n}\n\na {\n  color: inherit;\n  -webkit-text-decoration: inherit;\n  text-decoration: inherit;\n}\n\nb, strong {\n  font-weight: bolder;\n}\n\ncode, kbd, samp, pre {\n  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace;\n  font-size: 1em;\n}\n\nsmall {\n  font-size: 80%;\n}\n\nsub, sup {\n  font-size: 75%;\n  line-height: 0;\n  position: relative;\n  vertical-align: baseline;\n}\n\nsub { bottom: -0.25em; }\nsup { top: -0.5em; }\n\ntable {\n  text-indent: 0;\n  border-color: inherit;\n  border-collapse: collapse;\n}\n\nol, ul, menu {\n  list-style: none;\n}\n\nimg, svg, video, canvas, audio, iframe, embed, object {\n  display: block;\n  vertical-align: middle;\n}\n\nimg, video {\n  max-width: 100%;\n  height: auto;\n}\n\nbutton, input, select, optgroup, textarea, ::file-selector-button {\n  font: inherit;\n  font-feature-settings: inherit;\n  font-variation-settings: inherit;\n  letter-spacing: inherit;\n  color: inherit;\n  border-radius: 0;\n  background-color: transparent;\n  opacity: 1;\n}\n\ntextarea {\n  resize: vertical;\n}\n\n[hidden]:where(:not([hidden='until-found'])) {\n  display: none !important;\n}\n";
-
-export { preflightCss };
+export declare const preflightCss = "\n*,\n::after,\n::before,\n::backdrop,\n::file-selector-button {\n  box-sizing: border-box;\n  margin: 0;\n  padding: 0;\n  border: 0 solid;\n}\n\nhtml,\n:host {\n  line-height: 1.5;\n  -webkit-text-size-adjust: 100%;\n  tab-size: 4;\n  font-family: ui-sans-serif, system-ui, sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';\n  -webkit-tap-highlight-color: transparent;\n}\n\nhr {\n  height: 0;\n  color: inherit;\n  border-top-width: 1px;\n}\n\nabbr:where([title]) {\n  -webkit-text-decoration: underline dotted;\n  text-decoration: underline dotted;\n}\n\nh1, h2, h3, h4, h5, h6 {\n  font-size: inherit;\n  font-weight: inherit;\n}\n\na {\n  color: inherit;\n  -webkit-text-decoration: inherit;\n  text-decoration: inherit;\n}\n\nb, strong {\n  font-weight: bolder;\n}\n\ncode, kbd, samp, pre {\n  font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, 'Liberation Mono', 'Courier New', monospace;\n  font-size: 1em;\n}\n\nsmall {\n  font-size: 80%;\n}\n\nsub, sup {\n  font-size: 75%;\n  line-height: 0;\n  position: relative;\n  vertical-align: baseline;\n}\n\nsub { bottom: -0.25em; }\nsup { top: -0.5em; }\n\ntable {\n  text-indent: 0;\n  border-color: inherit;\n  border-collapse: collapse;\n}\n\nol, ul, menu {\n  list-style: none;\n}\n\nimg, svg, video, canvas, audio, iframe, embed, object {\n  display: block;\n  vertical-align: middle;\n}\n\nimg, video {\n  max-width: 100%;\n  height: auto;\n}\n\nbutton, input, select, optgroup, textarea, ::file-selector-button {\n  font: inherit;\n  font-feature-settings: inherit;\n  font-variation-settings: inherit;\n  letter-spacing: inherit;\n  color: inherit;\n  border-radius: 0;\n  background-color: transparent;\n  opacity: 1;\n}\n\ntextarea {\n  resize: vertical;\n}\n\n[hidden]:where(:not([hidden='until-found'])) {\n  display: none !important;\n}\n";

package/dist/html-preview-wrapper/preview-base.d.ts

@@ -1,14 +1,12 @@
-import { VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface CodeBlockData {
+import type { VNode } from "preact";
+export interface CodeBlockData {
     language: string;
     title: string;
     code: string;
 }
-interface PreviewBaseProps {
+export interface PreviewBaseProps {
     title?: string;
     height?: number;
     srcdoc: string;
@@ -24,6 +22,4 @@ interface PreviewBaseProps {
  * JSX port of src/components/html-preview/preview-base.tsx with
  * React → Preact hook imports and `className` → `class` attribute.
  */
-declare function PreviewBase({ title, height, srcdoc, sandbox, syncDelay, codeBlocks, defaultOpen, }: PreviewBaseProps): VNode;
-
-export { type CodeBlockData, PreviewBase, type PreviewBaseProps };
+export declare function PreviewBase({ title, height, srcdoc, sandbox, syncDelay, codeBlocks, defaultOpen, }: PreviewBaseProps): VNode;

package/dist/i18n-version/index.d.ts

@@ -1,5 +1,7 @@
-export { LanguageSwitcher, LanguageSwitcherProps } from './language-switcher.js';
-export { VERSION_SWITCHER_INIT_SCRIPT, VERSION_SWITCHER_VISIBILITY_STYLE, VersionSwitcher, VersionSwitcherProps } from './version-switcher.js';
-export { VersionBanner, VersionBannerLabels, VersionBannerProps } from './version-banner.js';
-export { LocaleLink, VersionEntry, VersionSwitcherLabels } from './types.js';
-import 'preact';
+export { LanguageSwitcher } from "./language-switcher.js";
+export type { LanguageSwitcherProps } from "./language-switcher.js";
+export { VersionSwitcher, VERSION_SWITCHER_INIT_SCRIPT, VERSION_SWITCHER_VISIBILITY_STYLE, } from "./version-switcher.js";
+export type { VersionSwitcherProps } from "./version-switcher.js";
+export { VersionBanner } from "./version-banner.js";
+export type { VersionBannerProps, VersionBannerLabels } from "./version-banner.js";
+export type { LocaleLink, VersionEntry, VersionSwitcherLabels, } from "./types.js";

package/dist/i18n-version/language-switcher.d.ts

@@ -1,10 +1,8 @@
-import { VNode } from 'preact';
-import { LocaleLink } from './types.js';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface LanguageSwitcherProps {
+import type { VNode } from "preact";
+import type { LocaleLink } from "./types.js";
+export interface LanguageSwitcherProps {
     /**
      * Pre-built locale links, ordered as they should appear in the bar.
      * The host project typically derives this with its own
@@ -19,6 +17,5 @@ interface LanguageSwitcherProps {
  * template's `localeLinks.length > 1 &&` guard so call-sites can mount
  * the component unconditionally).
  */
-declare function LanguageSwitcher({ links }: LanguageSwitcherProps): VNode | null;
-
-export { LanguageSwitcher, type LanguageSwitcherProps, LocaleLink };
+export declare function LanguageSwitcher({ links }: LanguageSwitcherProps): VNode | null;
+export type { LocaleLink };

package/dist/i18n-version/types.d.ts

@@ -4,7 +4,7 @@
  * Mirrors the shape of `LocaleLink` from src/types/locale.ts so existing
  * call-sites can pass their already-built links straight through.
  */
-interface LocaleLink {
+export interface LocaleLink {
     /** BCP-47 code, e.g. "en", "ja". Rendered as the anchor's `lang` attribute. */
     code: string;
     /** Display label (typically the uppercased code). */
@@ -20,7 +20,7 @@ interface LocaleLink {
  * Slug is the URL-segment identifier; label is the user-visible string
  * (e.g. "v2.0", "1.x").
  */
-interface VersionEntry {
+export interface VersionEntry {
     slug: string;
     label: string;
 }
@@ -29,7 +29,7 @@ interface VersionEntry {
  * than wired to a host-side i18n module so the v2 package stays
  * locale-system agnostic.
  */
-interface VersionSwitcherLabels {
+export interface VersionSwitcherLabels {
     /** Label for the "latest" entry, e.g. "Latest" / "最新". */
     latest: string;
     /** Trigger-button prefix, e.g. "Version" / "バージョン". */
@@ -39,5 +39,3 @@ interface VersionSwitcherLabels {
     /** Footer link label, e.g. "All versions". */
     allVersions: string;
 }
-
-export type { LocaleLink, VersionEntry, VersionSwitcherLabels };

package/dist/i18n-version/version-banner.d.ts

@@ -1,15 +1,13 @@
-import { VNode } from 'preact';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface VersionBannerLabels {
+import type { VNode } from "preact";
+export interface VersionBannerLabels {
     /** Banner body text (e.g. "You are viewing documentation for an older version."). */
     message: string;
     /** Link label to the latest version (e.g. "View the latest version"). */
     latestLink: string;
 }
-interface VersionBannerProps {
+export interface VersionBannerProps {
     /** Variant — drives icon/colour selection downstream and is exposed via `data-variant`. */
     type: "unmaintained" | "unreleased";
     /** Pre-resolved href to the latest version of the current page. */
@@ -25,6 +23,4 @@ interface VersionBannerProps {
  * The host typically resolves `labels` via `t("version.banner.*", lang)`
  * and `latestUrl` via the project's URL helpers.
  */
-declare function VersionBanner(props: VersionBannerProps): VNode;
-
-export { VersionBanner, type VersionBannerLabels, type VersionBannerProps };
+export declare function VersionBanner(props: VersionBannerProps): VNode;

package/dist/i18n-version/version-switcher.d.ts

@@ -1,10 +1,8 @@
-import { VNode } from 'preact';
-import { VersionEntry, VersionSwitcherLabels } from './types.js';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface VersionSwitcherProps {
+import type { VNode } from "preact";
+import type { VersionEntry, VersionSwitcherLabels } from "./types.js";
+export interface VersionSwitcherProps {
     /**
      * All known versions, in display order (latest at top of the dropdown
      * is rendered separately via `latestUrl` — this list is the
@@ -74,7 +72,7 @@ interface VersionSwitcherProps {
  * also wins over `@layer utilities` regardless of specificity, so this rule
  * reliably overrides the wrapper's `display: none` at `>= 64rem`.
  */
-declare const VERSION_SWITCHER_VISIBILITY_STYLE = "@media (min-width:64rem){.hidden:has(> [data-version-switcher]){display:block}}";
+export declare const VERSION_SWITCHER_VISIBILITY_STYLE = "@media (min-width:64rem){.hidden:has(> [data-version-switcher]){display:block}}";
 /**
  * Drop-down version switcher rendered in the header.
  *
@@ -82,7 +80,7 @@ declare const VERSION_SWITCHER_VISIBILITY_STYLE = "@media (min-width:64rem){.hid
  * `VERSION_SWITCHER_INIT_SCRIPT` — mount it once at body-end on any
  * page that includes a `<VersionSwitcher>`.
  */
-declare function VersionSwitcher(props: VersionSwitcherProps): VNode;
+export declare function VersionSwitcher(props: VersionSwitcherProps): VNode;
 /**
  * Self-contained init script for the version-switcher's interactive
  * behavior. Mount once per page (e.g. inside the layout's body-end
@@ -99,6 +97,5 @@ declare function VersionSwitcher(props: VersionSwitcherProps): VNode;
  * version-switcher; behaviour is unchanged modulo the lifecycle
  * vocabulary swap.
  */
-declare const VERSION_SWITCHER_INIT_SCRIPT: string;
-
-export { VERSION_SWITCHER_INIT_SCRIPT, VERSION_SWITCHER_VISIBILITY_STYLE, VersionEntry, VersionSwitcher, VersionSwitcherLabels, type VersionSwitcherProps };
+export declare const VERSION_SWITCHER_INIT_SCRIPT: string;
+export type { VersionEntry, VersionSwitcherLabels };