@takazudo/zudo-doc 0.2.21 → 1.0.0

package/dist/theme/color-scheme-provider.d.ts

@@ -1,17 +1,15 @@
-import * as preact from 'preact';
-import { ComponentChildren } from 'preact';
-
+import type { ComponentChildren } from "preact";
 /**
  * Subset of the host's `ColorModeConfig` that the v2 provider actually
  * consumes. Kept locally so the v2 package does not need to import a host
  * type module — the caller maps its own settings into this shape (or
  * passes `null` for the persisted-tweak / no-light-dark path).
  */
-interface ColorSchemeProviderColorMode {
+export interface ColorSchemeProviderColorMode {
     defaultMode: "light" | "dark";
     respectPrefersColorScheme: boolean;
 }
-interface ColorSchemeProviderProps {
+export interface ColorSchemeProviderProps {
     /**
      * Pre-computed `:root { --zd-* }` CSS string. The caller resolves the
      * active color scheme (or the configured light+dark pair) and renders
@@ -27,6 +25,4 @@ interface ColorSchemeProviderProps {
     /** Optional children; preserved for forward compatibility. */
     children?: ComponentChildren;
 }
-declare function ColorSchemeProvider({ cssText, colorMode, }: ColorSchemeProviderProps): preact.JSX.Element;
-
-export { type ColorSchemeProviderColorMode, type ColorSchemeProviderProps, ColorSchemeProvider as default };
+export default function ColorSchemeProvider({ cssText, colorMode, }: ColorSchemeProviderProps): import("preact").JSX.Element;

package/dist/theme/color-tweak-export-modal.d.ts

@@ -1,7 +1,5 @@
-import * as preact from 'preact';
-import { DesignTokenManifest } from './design-token-serde.js';
-import { TweakState, ColorTweakState } from './design-token-types.js';
-
+import { type DesignTokenManifest } from "./design-token-serde.js";
+import { type ColorTweakState, type TweakState } from "./design-token-types.js";
 interface DesignTokenExportModalProps {
     onClose: () => void;
     /** Full unified tweak state — the modal serializes all four categories. */
@@ -14,6 +12,5 @@ interface DesignTokenExportModalProps {
      *  access (tests) can omit and we'll treat the entire color block as changed. */
     colorDefaults?: ColorTweakState;
 }
-declare function ColorTweakExportModal({ onClose, state, manifest, colorDefaults, }: DesignTokenExportModalProps): preact.JSX.Element;
-
-export { ColorTweakExportModal as default };
+export default function ColorTweakExportModal({ onClose, state, manifest, colorDefaults, }: DesignTokenExportModalProps): import("preact").JSX.Element;
+export {};

package/dist/theme/design-token-serde.d.ts

@@ -1,5 +1,3 @@
-import { ColorTweakState, TweakState } from './design-token-types.js';
-
 /**
  * Design-token SerDe — unified JSON export / import for the design-token panel.
  *
@@ -44,11 +42,11 @@ interface TokenDef {
     /** Read-only tokens are displayed but not editable. */
     readonly?: true;
 }
-
-declare const DESIGN_TOKEN_SCHEMA: "zudo-doc-design-tokens/v1";
+import { type ColorTweakState, type TweakState } from "./design-token-types.js";
+export declare const DESIGN_TOKEN_SCHEMA: "zudo-doc-design-tokens/v1";
 /** External JSON value for a base-color / semantic-color entry. */
 type ColorSlotValue = number | "bg" | "fg";
-interface DesignTokenJsonColorBase {
+export interface DesignTokenJsonColorBase {
     bg?: number;
     fg?: number;
     cursor?: number;
@@ -56,15 +54,15 @@ interface DesignTokenJsonColorBase {
     "sel-bg"?: number;
     "sel-fg"?: number;
 }
-interface DesignTokenJsonColor {
+export interface DesignTokenJsonColor {
     palette?: string[];
     base?: DesignTokenJsonColorBase;
     /** Palette-index (or "bg"/"fg") mappings, same keys as `SEMANTIC_DEFAULTS`. */
     semantic?: Record<string, ColorSlotValue>;
 }
 /** External token map keyed by CSS var name. */
-type DesignTokenJsonOverrides = Record<string, string>;
-interface DesignTokenJson {
+export type DesignTokenJsonOverrides = Record<string, string>;
+export interface DesignTokenJson {
     $schema: typeof DESIGN_TOKEN_SCHEMA;
     exportedAt: string;
     color?: DesignTokenJsonColor;
@@ -78,12 +76,12 @@ interface DesignTokenJson {
  * doesn't ship its own manifest; this is intentionally a caller concern
  * so each consumer keeps full control over the editable token set.
  */
-interface DesignTokenManifest {
+export interface DesignTokenManifest {
     spacing: readonly TokenDef[];
     font: readonly TokenDef[];
     size: readonly TokenDef[];
 }
-interface SerializeOptions {
+export interface SerializeOptions {
     /** Token manifest (spacing / font / size arrays) used to compute
      *  diff-only output and resolve CSS-var names. Required. */
     manifest: DesignTokenManifest;
@@ -98,7 +96,7 @@ interface SerializeOptions {
     /** Override the `exportedAt` stamp (test-only). */
     now?: () => Date;
 }
-interface DeserializeResult {
+export interface DeserializeResult {
     /** The reconstructed tweak state, with unknown-token values dropped. */
     state: TweakState;
     /** CSS var names present in the payload that don't match any known token. */
@@ -107,7 +105,7 @@ interface DeserializeResult {
      *  (e.g. "semantic mapping dropped because value isn't a number"). */
     warnings: string[];
 }
-interface DeserializeOptions {
+export interface DeserializeOptions {
     /** Token manifest (spacing / font / size arrays) used to resolve CSS-var
      *  names back to internal token ids. Required. */
     manifest: DesignTokenManifest;
@@ -118,7 +116,7 @@ interface DeserializeOptions {
 }
 /** Thrown when the payload is not a v1 schema object. The error `.reason`
  *  helps the UI render a precise inline message. */
-declare class DesignTokenSchemaError extends Error {
+export declare class DesignTokenSchemaError extends Error {
     readonly reason: "not-object" | "schema-missing" | "schema-mismatch";
     readonly actualSchema?: unknown;
     constructor(reason: "not-object" | "schema-missing" | "schema-mismatch", message: string, actualSchema?: unknown);
@@ -129,7 +127,7 @@ declare class DesignTokenSchemaError extends Error {
  * By default this is diff-only against `opts.colorDefaults` + manifest
  * defaults; set `opts.includeDefaults = true` to dump everything.
  */
-declare function serialize(state: TweakState, opts: SerializeOptions): DesignTokenJson;
+export declare function serialize(state: TweakState, opts: SerializeOptions): DesignTokenJson;
 /**
  * Parse a design-token JSON document and lift it back into a tweak state.
  *
@@ -140,6 +138,5 @@ declare function serialize(state: TweakState, opts: SerializeOptions): DesignTok
  * Missing fields fall back to `opts.colorDefaults` (or, absent that, a
  * minimal neutral default) so the result is always a valid `TweakState`.
  */
-declare function deserialize(input: unknown, opts: DeserializeOptions): DeserializeResult;
-
-export { DESIGN_TOKEN_SCHEMA, type DeserializeOptions, type DeserializeResult, type DesignTokenJson, type DesignTokenJsonColor, type DesignTokenJsonColorBase, type DesignTokenJsonOverrides, type DesignTokenManifest, DesignTokenSchemaError, type SerializeOptions, deserialize, serialize };
+export declare function deserialize(input: unknown, opts: DeserializeOptions): DeserializeResult;
+export {};

package/dist/theme/design-token-types.d.ts

@@ -1,4 +1,4 @@
-interface ColorTweakState {
+export interface ColorTweakState {
     palette: string[];
     background: number;
     foreground: number;
@@ -7,13 +7,11 @@ interface ColorTweakState {
     selectionFg: number;
     semanticMappings: Record<string, number | "bg" | "fg">;
 }
-type TokenOverrides = Record<string, string>;
-interface TweakState {
+export type TokenOverrides = Record<string, string>;
+export interface TweakState {
     color: ColorTweakState;
     spacing: TokenOverrides;
     font: TokenOverrides;
     size: TokenOverrides;
 }
-declare function emptyOverrides(): TokenOverrides;
-
-export { type ColorTweakState, type TokenOverrides, type TweakState, emptyOverrides };
+export declare function emptyOverrides(): TokenOverrides;

package/dist/theme/iframe-bridge.d.ts

@@ -1,44 +1,42 @@
-declare const BRIDGE_SOURCE: "zudo-doc-theme-bridge";
-type CssVarPair = readonly [name: string, value: string];
-interface ApplyCssVarsMessage {
+export declare const BRIDGE_SOURCE: "zudo-doc-theme-bridge";
+export type CssVarPair = readonly [name: string, value: string];
+export interface ApplyCssVarsMessage {
     source: typeof BRIDGE_SOURCE;
     type: "apply-css-vars";
     vars: ReadonlyArray<CssVarPair>;
 }
-interface ClearCssVarsMessage {
+export interface ClearCssVarsMessage {
     source: typeof BRIDGE_SOURCE;
     type: "clear-css-vars";
     names: ReadonlyArray<string>;
 }
-interface ReadyMessage {
+export interface ReadyMessage {
     source: typeof BRIDGE_SOURCE;
     type: "ready";
 }
-interface ErrorMessage {
+export interface ErrorMessage {
     source: typeof BRIDGE_SOURCE;
     type: "error";
     reason: string;
 }
-type BridgeMessage = ApplyCssVarsMessage | ClearCssVarsMessage | ReadyMessage | ErrorMessage;
+export type BridgeMessage = ApplyCssVarsMessage | ClearCssVarsMessage | ReadyMessage | ErrorMessage;
 /**
  * Type guard. Accepts any postMessage payload and confirms it is a bridge
  * envelope. Foreign messages are ignored silently.
  */
-declare function isBridgeMessage(value: unknown): value is BridgeMessage;
+export declare function isBridgeMessage(value: unknown): value is BridgeMessage;
 /** Send `apply-css-vars` to the iframe. No-op when the iframe has not loaded. */
-declare function sendApplyCssVars(iframe: HTMLIFrameElement | null, vars: ReadonlyArray<CssVarPair>): void;
+export declare function sendApplyCssVars(iframe: HTMLIFrameElement | null, vars: ReadonlyArray<CssVarPair>): void;
 /** Send `clear-css-vars` to the iframe so it removes inline overrides. */
-declare function sendClearCssVars(iframe: HTMLIFrameElement | null, names: ReadonlyArray<string>): void;
+export declare function sendClearCssVars(iframe: HTMLIFrameElement | null, names: ReadonlyArray<string>): void;
 /**
  * Install a message listener inside the preview iframe document that applies
  * any incoming CSS-var batches onto `documentElement.style`. Returns a
  * teardown function. Intended to be called once at iframe boot.
  */
-declare function installIframeReceiver(target?: Window): () => void;
+export declare function installIframeReceiver(target?: Window): () => void;
 /**
  * Install a `ready` listener on the panel side so callers can defer the
  * initial CSS-var sync until the iframe document has booted.
  */
-declare function onIframeReady(expectedSource: Window | null, callback: () => void): () => void;
-
-export { type ApplyCssVarsMessage, BRIDGE_SOURCE, type BridgeMessage, type ClearCssVarsMessage, type CssVarPair, type ErrorMessage, type ReadyMessage, installIframeReceiver, isBridgeMessage, onIframeReady, sendApplyCssVars, sendClearCssVars };
+export declare function onIframeReady(expectedSource: Window | null, callback: () => void): () => void;

package/dist/theme/index.d.ts

@@ -1,9 +1,7 @@
-export { default as ThemeToggle } from './theme-toggle.js';
-export { default as ColorSchemeProvider, ColorSchemeProviderColorMode, ColorSchemeProviderProps } from './color-scheme-provider.js';
-export { default as ColorTweakExportModal } from './color-tweak-export-modal.js';
-export { DESIGN_TOKEN_SCHEMA, DeserializeOptions, DeserializeResult, DesignTokenJson, DesignTokenJsonColor, DesignTokenJsonColorBase, DesignTokenJsonOverrides, DesignTokenManifest, DesignTokenSchemaError, SerializeOptions, deserialize, serialize } from './design-token-serde.js';
-export { ColorTweakState, TokenOverrides, TweakState, emptyOverrides } from './design-token-types.js';
-export { ApplyCssVarsMessage, BRIDGE_SOURCE, BridgeMessage, ClearCssVarsMessage, CssVarPair, ErrorMessage, ReadyMessage, installIframeReceiver, isBridgeMessage, onIframeReady, sendApplyCssVars, sendClearCssVars } from './iframe-bridge.js';
-import 'preact';
-import '../theme-toggle/index.js';
-import '../theme-toggle/color-scheme-sync.js';
+export { default as ThemeToggle } from "./theme-toggle.js";
+export { default as ColorSchemeProvider } from "./color-scheme-provider.js";
+export type { ColorSchemeProviderProps, ColorSchemeProviderColorMode, } from "./color-scheme-provider.js";
+export { default as ColorTweakExportModal } from "./color-tweak-export-modal.js";
+export { DESIGN_TOKEN_SCHEMA, DesignTokenSchemaError, deserialize, serialize, type DesignTokenJson, type DesignTokenJsonColor, type DesignTokenJsonColorBase, type DesignTokenJsonOverrides, type DesignTokenManifest, type DeserializeOptions, type DeserializeResult, type SerializeOptions, } from "./design-token-serde.js";
+export { emptyOverrides, type ColorTweakState, type TokenOverrides, type TweakState, } from "./design-token-types.js";
+export { BRIDGE_SOURCE, isBridgeMessage, installIframeReceiver, onIframeReady, sendApplyCssVars, sendClearCssVars, type BridgeMessage, type ApplyCssVarsMessage, type ClearCssVarsMessage, type ReadyMessage, type ErrorMessage, type CssVarPair, } from "./iframe-bridge.js";

package/dist/theme/theme-toggle.d.ts

@@ -1,10 +1,7 @@
-import { VNode } from 'preact';
-import { ThemeToggleProps } from '../theme-toggle/index.js';
-import '../theme-toggle/color-scheme-sync.js';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
+import type { VNode } from "preact";
+import { type ThemeToggleProps } from "../theme-toggle/index.js";
 /**
  * Default-export click-toggle for color scheme. Wraps the bare
  * `<ThemeToggle>` in `<Island when="load">` so the SSG renderer emits a
@@ -13,6 +10,4 @@ import '../theme-toggle/color-scheme-sync.js';
  * want to control hydration timing themselves) should import the bare
  * component from `@takazudo/zudo-doc/theme-toggle` instead.
  */
-declare function ThemeToggle(props?: ThemeToggleProps): VNode;
-
-export { ThemeToggle as default };
+export default function ThemeToggle(props?: ThemeToggleProps): VNode;

package/dist/theme-toggle/color-scheme-sync.d.ts

@@ -1,11 +1,11 @@
-type ColorSchemeMode = "light" | "dark";
-declare const COLOR_SCHEME_CHANGED_EVENT = "color-scheme-changed";
+export type ColorSchemeMode = "light" | "dark";
+export declare const COLOR_SCHEME_CHANGED_EVENT = "color-scheme-changed";
 /**
  * Read the active color scheme from `<html data-theme>`. Falls back to
  * `defaultMode` when the attribute is missing or holds an unexpected
  * value (e.g. before the ColorSchemeProvider bootstrap script ran).
  */
-declare function readColorSchemeFromDom(defaultMode: ColorSchemeMode): ColorSchemeMode;
+export declare function readColorSchemeFromDom(defaultMode: ColorSchemeMode): ColorSchemeMode;
 /**
  * Apply `next` as the active color scheme: mutate the DOM, persist the
  * preference, and notify every subscriber (including other mounted
@@ -28,11 +28,9 @@ declare function readColorSchemeFromDom(defaultMode: ColorSchemeMode): ColorSche
  * round-trip keeps them) is a zdtp design question tracked upstream at
  * Takazudo/zudo-design-token-panel#343. See zudo-doc#2037.
  */
-declare function applyColorScheme(next: ColorSchemeMode): void;
+export declare function applyColorScheme(next: ColorSchemeMode): void;
 /**
  * Subscribe to color-scheme changes. Returns an unsubscribe function
  * (suitable as a `useEffect` cleanup).
  */
-declare function subscribeColorSchemeChanged(listener: () => void): () => void;
-
-export { COLOR_SCHEME_CHANGED_EVENT, type ColorSchemeMode, applyColorScheme, readColorSchemeFromDom, subscribeColorSchemeChanged };
+export declare function subscribeColorSchemeChanged(listener: () => void): () => void;

package/dist/theme-toggle/index.d.ts

@@ -1,12 +1,8 @@
-import * as preact from 'preact';
-import { ColorSchemeMode } from './color-scheme-sync.js';
-
-interface ThemeToggleProps {
+import { type ColorSchemeMode } from "./color-scheme-sync.js";
+export interface ThemeToggleProps {
     defaultMode?: ColorSchemeMode;
 }
-declare function ThemeToggle({ defaultMode, }: ThemeToggleProps): preact.JSX.Element;
-declare namespace ThemeToggle {
+export declare function ThemeToggle({ defaultMode, }: ThemeToggleProps): import("preact").JSX.Element;
+export declare namespace ThemeToggle {
     var displayName: string;
 }
-
-export { ThemeToggle, type ThemeToggleProps };

package/dist/toc/cx.d.ts

@@ -10,6 +10,5 @@
 type ClassValue = string | number | bigint | boolean | null | undefined | ClassValue[] | {
     [key: string]: unknown;
 };
-declare function cx(...args: ClassValue[]): string;
-
-export { cx };
+export declare function cx(...args: ClassValue[]): string;
+export {};

package/dist/toc/index.d.ts

@@ -1,6 +1,8 @@
-export { Toc, TocProps } from './toc.js';
-export { MobileToc, MobileTocProps } from './mobile-toc.js';
-export { UseActiveHeadingResult, getActiveHeadingId, useActiveHeading } from './use-active-heading.js';
-export { HeadingItem } from './types.js';
-export { getTocTitle } from './toc-title.js';
-import 'preact';
+export { Toc } from "./toc.js";
+export type { TocProps } from "./toc.js";
+export { MobileToc } from "./mobile-toc.js";
+export type { MobileTocProps } from "./mobile-toc.js";
+export { useActiveHeading, getActiveHeadingId } from "./use-active-heading.js";
+export type { UseActiveHeadingResult } from "./use-active-heading.js";
+export type { HeadingItem } from "./types.js";
+export { getTocTitle } from "./toc-title.js";

package/dist/toc/mobile-toc.d.ts

@@ -1,10 +1,8 @@
-import { VNode } from 'preact';
-import { HeadingItem } from './types.js';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface MobileTocProps {
+import type { VNode } from "preact";
+import type { HeadingItem } from "./types.js";
+export interface MobileTocProps {
     headings: readonly HeadingItem[];
     title?: string;
 }
@@ -38,9 +36,7 @@ interface MobileTocProps {
  * crawlers can still find the locale label in the static markup. When
  * headings are present the full interactive toggle UI is rendered.
  */
-declare function MobileToc({ headings, title, }: MobileTocProps): VNode;
-declare namespace MobileToc {
+export declare function MobileToc({ headings, title, }: MobileTocProps): VNode;
+export declare namespace MobileToc {
     var displayName: string;
 }
-
-export { MobileToc, type MobileTocProps };

package/dist/toc/mobile-toc.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from "preact/jsx-runtime";
 import { useMemo, useState } from "preact/hooks";
-import { SmartBreak } from "./smart-break.js";
+import { SmartBreak } from "../smart-break/index.js";
 import { cx } from "./cx.js";
 function MobileToc({
   headings,

package/dist/toc/toc-title.d.ts

@@ -5,6 +5,4 @@
  * first, then falls back to the full tag, then falls back to the English
  * default so callers always receive a non-empty string.
  */
-declare function getTocTitle(lang?: string): string;
-
-export { getTocTitle };
+export declare function getTocTitle(lang?: string): string;

package/dist/toc/toc.d.ts

@@ -1,10 +1,8 @@
-import { VNode } from 'preact';
-import { HeadingItem } from './types.js';
-
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
-
-interface TocProps {
+import type { VNode } from "preact";
+import type { HeadingItem } from "./types.js";
+export interface TocProps {
     headings: readonly HeadingItem[];
     /**
      * Section label used by MobileToc. The desktop Toc no longer renders
@@ -52,9 +50,7 @@ interface TocProps {
  * `<nav aria-label="Table of contents">` landmark provides the section
  * semantics for screen readers. Issue #1655 / T1.
  */
-declare function Toc({ headings, title }: TocProps): VNode;
-declare namespace Toc {
+export declare function Toc({ headings, title }: TocProps): VNode;
+export declare namespace Toc {
     var displayName: string;
 }
-
-export { Toc, type TocProps };

package/dist/toc/toc.js

@@ -2,7 +2,7 @@
 import { jsx } from "preact/jsx-runtime";
 import { useMemo } from "preact/hooks";
 import { useActiveHeading } from "./use-active-heading.js";
-import { SmartBreak } from "./smart-break.js";
+import { SmartBreak } from "../smart-break/index.js";
 import { cx } from "./cx.js";
 function Toc({ headings, title = "On this page" }) {
   const filtered = useMemo(

package/dist/toc/types.d.ts

@@ -7,10 +7,8 @@
  * types byte-aligned with the engine so a page module's `headings`
  * export drops in directly.
  */
-interface HeadingItem {
+export interface HeadingItem {
     readonly depth: number;
     readonly slug: string;
     readonly text: string;
 }
-
-export type { HeadingItem };

package/dist/toc/use-active-heading.d.ts

@@ -1,5 +1,4 @@
-import { HeadingItem } from './types.js';
-
+import type { HeadingItem } from "./types.js";
 /**
  * Pure helper that picks the active heading id given the heading slug
  * order and a slug→element map. Extracted from the hook so it is unit-
@@ -12,8 +11,8 @@ import { HeadingItem } from './types.js';
  * midline, treat it as already active. Otherwise activate the
  * predecessor of the first visible heading.
  */
-declare function getActiveHeadingId(headingIds: readonly string[], elementMap: ReadonlyMap<string, HTMLElement>, viewportHeight: number): string | null;
-interface UseActiveHeadingResult {
+export declare function getActiveHeadingId(headingIds: readonly string[], elementMap: ReadonlyMap<string, HTMLElement>, viewportHeight: number): string | null;
+export interface UseActiveHeadingResult {
     activeId: string | null;
     activate: (id: string) => void;
 }
@@ -25,6 +24,4 @@ interface UseActiveHeadingResult {
  * the smooth-scroll completes (`scrollend`, with a timeout fallback
  * for older Safari).
  */
-declare function useActiveHeading(headings: readonly HeadingItem[]): UseActiveHeadingResult;
-
-export { type UseActiveHeadingResult, getActiveHeadingId, useActiveHeading };
+export declare function useActiveHeading(headings: readonly HeadingItem[]): UseActiveHeadingResult;

package/dist/transitions/index.d.ts

@@ -1 +1 @@
-export { AFTER_NAVIGATE_EVENT, BEFORE_NAVIGATE_EVENT, onAfterNavigate, onBeforeNavigate } from './page-events.js';
+export { BEFORE_NAVIGATE_EVENT, AFTER_NAVIGATE_EVENT, onBeforeNavigate, onAfterNavigate, } from "./page-events.js";

package/dist/transitions/page-events.d.ts

@@ -6,7 +6,7 @@
  * to "page-loading-begin" / Astro's `astro:before-preparation` in
  * the v2 vocabulary.
  */
-declare const BEFORE_NAVIGATE_EVENT = "zfb:before-preparation";
+export declare const BEFORE_NAVIGATE_EVENT = "zfb:before-preparation";
 /**
  * Event name fired once the new page's `<body>` has been swapped in.
  * Today resolves to `"zfb:after-swap"` — dispatched by zfb's
@@ -15,7 +15,7 @@ declare const BEFORE_NAVIGATE_EVENT = "zfb:before-preparation";
  * both first-paint and post-swap behavior). Direct successor to
  * Astro's `astro:page-load`.
  */
-declare const AFTER_NAVIGATE_EVENT = "zfb:after-swap";
+export declare const AFTER_NAVIGATE_EVENT = "zfb:after-swap";
 /**
  * Subscribe to "navigation start" — runs `handler` each time the user
  * navigates away from the current page. zfb's `<ClientRouter />`
@@ -26,7 +26,7 @@ declare const AFTER_NAVIGATE_EVENT = "zfb:after-swap";
  * Returns an unsubscribe function. SSR-safe: if `document` is undefined
  * (server / non-browser host) returns a no-op unsubscribe.
  */
-declare function onBeforeNavigate(handler: () => void): () => void;
+export declare function onBeforeNavigate(handler: () => void): () => void;
 /**
  * Subscribe to "navigation end" — runs `handler` after each page-body
  * swap. Mirrors Astro's `astro:page-load`: fires once on first load,
@@ -36,6 +36,4 @@ declare function onBeforeNavigate(handler: () => void): () => void;
  * Returns an unsubscribe function. SSR-safe: returns a no-op when
  * called outside a browser.
  */
-declare function onAfterNavigate(handler: () => void): () => void;
-
-export { AFTER_NAVIGATE_EVENT, BEFORE_NAVIGATE_EVENT, onAfterNavigate, onBeforeNavigate };
+export declare function onAfterNavigate(handler: () => void): () => void;

package/dist/tree-nav-shared/index.d.ts

@@ -0,0 +1,22 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+export declare const INDENT = "clamp(0.8rem, 1.2vw, 1.625rem)";
+export declare const CONNECTOR_OFFSET = "clamp(0.2rem, 0.3vw, 0.5rem)";
+export declare const CONNECTOR_WIDTH = "clamp(0.4rem, 0.6vw, 1rem)";
+export declare const BASE_PAD = "clamp(0.4rem, 0.8vw, 1.3rem)";
+export declare function connectorLeft(depth: number): string;
+export declare function CategoryLinkIcon({ className }: {
+    className?: string;
+}): import("preact").JSX.Element;
+export declare function ConnectorLines({ depth, isLast, widthScale, topPad, }: {
+    depth: number;
+    isLast: boolean;
+    widthScale?: number;
+    /**
+     * Padding-top of the inner content row that holds the link text. The horizontal
+     * connector and (when `isLast`) the vertical clip both anchor to the first-line
+     * midpoint computed as `topPad + 0.5lh`, so multi-line labels keep the connector
+     * aligned with the first line instead of the row's vertical center.
+     */
+    topPad?: string;
+}): import("preact").JSX.Element | null;

package/dist/tree-nav-shared/index.js

@@ -0,0 +1,66 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+const INDENT = "clamp(0.8rem, 1.2vw, 1.625rem)";
+const CONNECTOR_OFFSET = "clamp(0.2rem, 0.3vw, 0.5rem)";
+const CONNECTOR_WIDTH = "clamp(0.4rem, 0.6vw, 1rem)";
+const BASE_PAD = "clamp(0.4rem, 0.8vw, 1.3rem)";
+function connectorLeft(depth) {
+  return `calc(${depth} * ${INDENT} + ${CONNECTOR_OFFSET})`;
+}
+const CATEGORY_LINK_PATH = "M5.746 5.74 0 11.49l20.987 20.96C34.126 45.572 41.963 53.45 41.948 53.523c-.012.062-9.456 9.544-20.986 21.07L0 95.55l5.714 5.715c3.142 3.143 5.748 5.715 5.79 5.715s2.63-2.563 5.75-5.696l17.939-18.001c21.867-21.94 29.443-29.599 29.443-29.768 0-.114-.665-.804-5.084-5.275C51.872 40.47 11.71.125 11.565.036 11.525.01 8.906 2.578 5.746 5.74m38.345-.066c-3.132 3.13-5.696 5.71-5.696 5.732-.001.022 2.16 2.185 4.8 4.807 2.641 2.623 8.382 8.338 12.758 12.702 15.38 15.337 23.763 23.641 24.314 24.086.19.153.346.336.346.405 0 .07-1.738 1.847-3.887 3.976a17515 17515 0 0 0-20.35 20.264 19555 19555 0 0 1-17.223 17.158c-.416.409-.757.77-.757.8 0 .083 11.415 11.485 11.457 11.445.235-.22 53.542-53.528 53.542-53.543C103.395 53.472 49.891.02 49.837 0c-.028-.01-2.613 2.543-5.746 5.674";
+function CategoryLinkIcon({ className }) {
+  return /* @__PURE__ */ jsx(
+    "svg",
+    {
+      xmlns: "http://www.w3.org/2000/svg",
+      fill: "currentColor",
+      viewBox: "0 0 103.395 107.049",
+      "aria-hidden": "true",
+      className: `shrink-0 ${className ?? ""}`,
+      children: /* @__PURE__ */ jsx("path", { d: CATEGORY_LINK_PATH })
+    }
+  );
+}
+function ConnectorLines({
+  depth,
+  isLast,
+  widthScale = 1,
+  topPad = "0px"
+}) {
+  if (depth === 0) return null;
+  const left = connectorLeft(depth);
+  const width = widthScale === 1 ? CONNECTOR_WIDTH : `calc(${CONNECTOR_WIDTH} * ${widthScale})`;
+  const firstLineMid = `calc(${topPad} + 0.5lh)`;
+  return /* @__PURE__ */ jsxs(Fragment, { children: [
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: "absolute border-l border-dashed border-muted",
+        style: {
+          left,
+          top: 0,
+          bottom: isLast ? `calc(100% - ${firstLineMid})` : 0
+        }
+      }
+    ),
+    /* @__PURE__ */ jsx(
+      "div",
+      {
+        className: "absolute border-t border-dashed border-muted",
+        style: {
+          left,
+          width,
+          top: firstLineMid
+        }
+      }
+    )
+  ] });
+}
+export {
+  BASE_PAD,
+  CONNECTOR_OFFSET,
+  CONNECTOR_WIDTH,
+  CategoryLinkIcon,
+  ConnectorLines,
+  INDENT,
+  connectorLeft
+};

package/dist/url-helpers/index.d.ts

@@ -0,0 +1,37 @@
+import type { Settings } from "../settings.js";
+import type { FactoryI18n } from "../factory-context/index.js";
+/** Represents a locale switcher link (mirrors the host `LocaleLink`). */
+export interface LocaleLink {
+    code: string;
+    label: string;
+    href: string;
+    active: boolean;
+}
+/** The settings fields the URL helpers read. */
+export type UrlHelperSettings = Pick<Settings, "base" | "trailingSlash" | "siteUrl" | "defaultLocaleOnlyPrefixes">;
+/** The full set of URL helpers built from `(settings, i18n)`. */
+export interface UrlHelpers {
+    /** Normalized base path with no trailing slash (empty string when "/"). */
+    normalizedBase: string;
+    applyTrailingSlash(url: string): string;
+    withBase(path: string): string;
+    stripBase(path: string): string;
+    absoluteUrl(pageUrl: string): string | undefined;
+    docsUrl(slug: string, lang?: string): string;
+    isExternal(href: string): boolean;
+    resolveHref(href: string): string;
+    navHref(path: string, lang: string | undefined, currentVersion: string | undefined): string;
+    getPathForLocale(path: string, currentLang: string, targetLang: string): string;
+    buildLocaleLinks(currentPath: string, currentLang: string): LocaleLink[];
+    isDefaultLocaleOnlyPath(path: string): boolean;
+    versionedDocsUrl(slug: string, versionSlug: string, lang?: string): string;
+}
+/**
+ * Build the URL helper set from the host's settings + i18n surface.
+ *
+ * Equivalent to the legacy `src/utils/base.ts` module functions, but with the
+ * project singletons injected rather than imported — so the same logic ships
+ * from the package. The host stub calls this once with its concrete settings and
+ * i18n and re-exports the result.
+ */
+export declare function makeUrlHelpers(settings: UrlHelperSettings, i18n: FactoryI18n): UrlHelpers;