@takazudo/zudo-doc 5.13.0 → 5.14.0

package/dist/asset-path/index.js

@@ -0,0 +1,149 @@
+const CONTROL_CHARS = /[\u0000-\u001f\u007f-\u009f]/;
+function normalizeAssetPath(path) {
+  if (path.length === 0) throw new Error("Asset path must not be empty");
+  if (path.startsWith("/")) throw new Error(`Asset path must be relative: ${path}`);
+  if (path.includes("\\")) throw new Error(`Asset path must use POSIX separators: ${path}`);
+  if (CONTROL_CHARS.test(path)) throw new Error("Asset path must not contain control characters");
+  const normalized = path.normalize("NFC");
+  const segments = normalized.split("/");
+  if (segments.some((segment) => segment.length === 0)) {
+    throw new Error(`Asset path must not contain empty segments: ${path}`);
+  }
+  if (segments.some((segment) => segment === "." || segment === "..")) {
+    throw new Error(`Asset path must not contain dot segments: ${path}`);
+  }
+  return normalized;
+}
+function encodeAssetPathForUrl(path) {
+  return normalizeAssetPath(path).split("/").map(encodeURIComponent).join("/");
+}
+function normalizedBase(base) {
+  if (base === "" || base === "/") return "";
+  const withLeadingSlash = base.startsWith("/") ? base : `/${base}`;
+  return withLeadingSlash.replace(/\/+$/, "");
+}
+function withBase(base, path) {
+  const prefix = normalizedBase(base);
+  return prefix + (path.startsWith("/") ? path : `/${path}`);
+}
+function decodeAuthoredHref(href, options) {
+  if (CONTROL_CHARS.test(href)) return null;
+  const hashIndex = href.indexOf("#");
+  const pathAndQuery = hashIndex === -1 ? href : href.slice(0, hashIndex);
+  const fragment = hashIndex === -1 ? void 0 : href.slice(hashIndex);
+  if (pathAndQuery.includes("?")) return null;
+  let dir;
+  try {
+    dir = normalizeSettingPath(options.dir, "dir");
+  } catch {
+    return null;
+  }
+  const prefix = `/${dir}/`;
+  const base = normalizedBase(options.base);
+  const candidates = [pathAndQuery];
+  if (base !== "" && pathAndQuery.startsWith(`${base}/`)) {
+    candidates.push(pathAndQuery.slice(base.length));
+  }
+  const pathname = candidates.find((candidate) => candidate.startsWith(prefix));
+  if (pathname === void 0) return null;
+  const encodedPath = pathname.slice(prefix.length);
+  if (encodedPath.length === 0) return null;
+  try {
+    const decodedSegments = encodedPath.split("/").map((segment) => decodeURIComponent(segment));
+    if (decodedSegments.some((segment) => segment.includes("/"))) return null;
+    const path = normalizeAssetPath(decodedSegments.join("/"));
+    return fragment === void 0 ? { path } : { path, fragment };
+  } catch {
+    return null;
+  }
+}
+function assetViewerHref(options) {
+  const routePrefix = normalizeSettingPath(options.routePrefix, "routePrefix");
+  const href = withBase(
+    options.base,
+    `/${routePrefix}/${encodeAssetPathForUrl(options.path)}/`
+  );
+  if (options.fragment == null || options.fragment === "") return href;
+  if (CONTROL_CHARS.test(options.fragment)) {
+    throw new Error("Asset URL fragment must not contain control characters");
+  }
+  return href + (options.fragment.startsWith("#") ? options.fragment : `#${options.fragment}`);
+}
+function assetRawHref(options) {
+  const dir = normalizeSettingPath(options.dir, "dir");
+  return withBase(options.base, `/${dir}/${encodeAssetPathForUrl(options.path)}`);
+}
+function normalizeSettingPath(value, label) {
+  if (value.length === 0) throw new Error(`assetViewer.${label} must not be empty`);
+  if (value.startsWith("/") || value.endsWith("/")) {
+    throw new Error(`assetViewer.${label} must be relative with no leading or trailing slash`);
+  }
+  if (value.includes("\\") || CONTROL_CHARS.test(value)) {
+    throw new Error(`assetViewer.${label} must be a safe POSIX path`);
+  }
+  const normalized = value.normalize("NFC");
+  const segments = normalized.split("/");
+  if (segments.some((segment) => segment === "" || segment === "." || segment === "..")) {
+    throw new Error(`assetViewer.${label} must not contain empty or dot segments`);
+  }
+  return normalized;
+}
+function validateAssetViewerSettings(settings) {
+  const dir = normalizeSettingPath(settings.dir, "dir");
+  const routePrefix = normalizeSettingPath(settings.routePrefix, "routePrefix");
+  if (dir === routePrefix) {
+    throw new Error("assetViewer.dir and assetViewer.routePrefix must be different");
+  }
+  if (dir === "assets/client" || routePrefix === "assets/client") {
+    throw new Error('assetViewer.dir and assetViewer.routePrefix must not equal reserved "assets/client"');
+  }
+}
+function escapeRegex(char) {
+  return /[\\^$.*+?()[\]{}|]/.test(char) ? `\\${char}` : char;
+}
+function globToRegex(glob) {
+  let source = "^";
+  for (let index = 0; index < glob.length; index += 1) {
+    const char = glob[index] ?? "";
+    if (char === "*") {
+      if (glob[index + 1] === "*") {
+        index += 1;
+        if (glob[index + 1] === "/") {
+          index += 1;
+          source += "(?:.*/)?";
+        } else {
+          source += ".*";
+        }
+      } else {
+        source += "[^/]*";
+      }
+    } else if (char === "?") {
+      source += "[^/]";
+    } else if (char === "{") {
+      const close = glob.indexOf("}", index + 1);
+      if (close === -1) {
+        source += "\\{";
+      } else {
+        const alternatives = glob.slice(index + 1, close).split(",");
+        source += `(?:${alternatives.map((value) => [...value].map(escapeRegex).join("")).join("|")})`;
+        index = close;
+      }
+    } else {
+      source += escapeRegex(char);
+    }
+  }
+  return new RegExp(`${source}$`);
+}
+function matchExclude(path, globs) {
+  const normalized = normalizeAssetPath(path);
+  return globs.some((glob) => globToRegex(glob.normalize("NFC")).test(normalized));
+}
+export {
+  assetRawHref,
+  assetViewerHref,
+  decodeAuthoredHref,
+  encodeAssetPathForUrl,
+  matchExclude,
+  normalizeAssetPath,
+  validateAssetViewerSettings
+};

package/dist/chrome/derive.js

@@ -13,6 +13,7 @@ import { createThemePackSwitcherIsland } from "../doc-body-end-islands/theme-pac
 import { DEFAULT_THEME_PACK_SLUG } from "../theme-pack-switcher/theme-pack-sync.js";
 import { SearchWidget } from "../search-widget/index.js";
 import { createMdxComponents } from "../mdx-components/index.js";
+import { createAssetCard, createAssetCode } from "../asset-components/index.js";
 import { createCategoryNavWrapper } from "../category-nav/index.js";
 import { createNoteTrayIndexWrapper } from "../note-tray-index/index.js";
 import { createCategoryTreeNavWrapper } from "../category-tree-nav/index.js";
@@ -200,8 +201,27 @@ function deriveBodyEndIslands(ctx) {
   });
   const HostBodyEnd = HostBodyEndIslands;
   function BodyEndIslands(props) {
+    const addsForcedImageEnlarge = props.forceImageEnlarge === true && !ctx.settings.imageEnlarge;
+    const ForceImageEnlarge = addsForcedImageEnlarge ? createBodyEndIslands({
+      settings: {
+        aiAssistant: false,
+        imageEnlarge: true,
+        mermaid: false,
+        dynamicPageTransition: false,
+        designTokenPanel: false,
+        findInPage: false,
+        themePackSwitcher: false
+      }
+    }) : null;
     return /* @__PURE__ */ jsxs(Fragment, { children: [
-      /* @__PURE__ */ jsx(HostBodyEnd, { ...props }),
+      /* @__PURE__ */ jsx(
+        HostBodyEnd,
+        {
+          ...props,
+          forceImageEnlarge: addsForcedImageEnlarge ? false : props.forceImageEnlarge
+        }
+      ),
+      ForceImageEnlarge ? /* @__PURE__ */ jsx(ForceImageEnlarge, { basePath: props.basePath }) : null,
       /* @__PURE__ */ jsx(DesignTokenPanelIsland, {}),
       /* @__PURE__ */ jsx(ThemePackSwitcherIsland, {})
     ] });
@@ -300,18 +320,34 @@ function deriveMdxComponents(ctx) {
       ...props
     });
   }
-  const mdxExtrasDefault = {
-    Details,
-    HtmlPreview: HtmlPreviewBound,
-    Island: IslandPassthrough,
-    // PresetGenerator stays a package stub (render nothing): it is the
-    // showcase's project-bound interactive island; downstream projects stub it.
-    PresetGenerator: (_props) => null
+  const assetComponentContext = {
+    base: ctx.settings.base,
+    assetManifest: ctx.assetManifest,
+    routePrefix: ctx.assetManifest?.routePrefix ?? ctx.settings.assetViewerRoutePrefix,
+    dir: ctx.assetManifest?.dir ?? ctx.settings.assetViewerDir
   };
-  const mdxExtras = { ...mdxExtrasDefault, ...ctx.hostBindings.mdxExtras ?? {} };
   function createMdxComponentsBound(lang = ctx.defaultLocale, currentVersion, currentSlug = "") {
+    const localizedAssetContext = {
+      ...assetComponentContext,
+      t: (key) => ctx.t(key, lang)
+    };
+    const mdxExtrasDefault = {
+      Asset: createAssetCard(localizedAssetContext),
+      AssetCode: createAssetCode(localizedAssetContext),
+      Details,
+      HtmlPreview: HtmlPreviewBound,
+      Island: IslandPassthrough,
+      // PresetGenerator stays a package stub (render nothing): it is the
+      // showcase's project-bound interactive island; downstream projects stub it.
+      PresetGenerator: (_props) => null
+    };
+    const mdxExtras = {
+      ...mdxExtrasDefault,
+      ...ctx.hostBindings.mdxExtras ?? {}
+    };
     return createMdxComponents({
       settings: ctx.settings,
+      assetManifest: ctx.assetManifest,
       locale: lang,
       currentVersion,
       currentSlug,

package/dist/chrome/index.d.ts

@@ -36,6 +36,8 @@ export declare function createChrome<S extends Settings = Settings>(context: Rou
     SiteTreeNavWrapper: import("../factory-context/index.js").FactoryComponent;
     BodyEndIslands: (props: import("../doc-body-end-islands/index.js").BodyEndIslandsProps) => JSX.Element;
     HomePageView: (props: import("../home-page/index.js").HomePageViewProps) => JSX.Element;
+    AssetPageView: (props: import("../asset-page/index.js").AssetPageViewProps) => JSX.Element;
+    AssetIndexPageView: (props: import("../asset-index-page/index.js").AssetIndexPageViewProps) => JSX.Element;
 };
 /** The wired page-chrome surface returned by {@link createChrome}. */
 export type Chrome = ReturnType<typeof createChrome>;

package/dist/chrome/index.js

@@ -4,6 +4,8 @@ import { createRenderDocPage } from "../doc-page-renderer/index.js";
 import { createVersionsPageView } from "../versions-page/index.js";
 import { createTagPages } from "../tag-pages/index.js";
 import { createHomePageView } from "../home-page/index.js";
+import { createAssetPageView } from "../asset-page/index.js";
+import { createAssetIndexPageView } from "../asset-index-page/index.js";
 import {
   deriveComposeMetaTitle,
   deriveBodyEndIslands,
@@ -31,6 +33,8 @@ function createChrome(context, hostBindings = {}) {
   const { SiteTreeNavWrapper } = deriveMdxComponents(ctx);
   const BodyEndIslands = deriveBodyEndIslands(ctx);
   const HomePageView = createHomePageView(ctx);
+  const AssetPageView = createAssetPageView(ctx);
+  const AssetIndexPageView = createAssetIndexPageView(ctx);
   return {
     composeMetaTitle,
     HeadWithDefaults,
@@ -44,7 +48,9 @@ function createChrome(context, hostBindings = {}) {
     TagsIndexPageView,
     SiteTreeNavWrapper,
     BodyEndIslands,
-    HomePageView
+    HomePageView,
+    AssetPageView,
+    AssetIndexPageView
   };
 }
 export {

package/dist/chrome-bindings.d.ts

@@ -29,6 +29,8 @@ export interface SearchWidgetSlotProps {
 export interface BodyEndIslandsSlotProps {
     basePath: string;
     aiChatBodyLabel?: string;
+    /** Asset image pages force one ImageEnlarge mount independently of the site setting. */
+    forceImageEnlarge?: boolean;
 }
 /**
  * Props the chrome passes to the `DocHistory` island slot — matches
@@ -83,6 +85,8 @@ export interface HeaderSlotProps {
     currentVersion?: string;
     currentSlug?: string;
     navSection?: string;
+    /** Omit the mobile sidebar toggle and its drawer landmark. */
+    hideSidebarToggle?: boolean;
 }
 /** Props supplied at every package `Footer` replacement call site. */
 export interface FooterSlotProps {

package/dist/client-router/raw-link-attrs.d.ts

@@ -0,0 +1,8 @@
+/** Attributes that make a raw asset link bypass zfb's client router. */
+export declare const RAW_LINK_ATTRS: {
+    readonly download: "";
+};
+/** Attributes that make a link perform a full browser reload. */
+export declare const RELOAD_LINK_ATTRS: {
+    readonly "data-zfb-reload": "";
+};

package/dist/client-router/raw-link-attrs.js

@@ -0,0 +1,6 @@
+const RAW_LINK_ATTRS = { download: "" };
+const RELOAD_LINK_ATTRS = { "data-zfb-reload": "" };
+export {
+  RAW_LINK_ATTRS,
+  RELOAD_LINK_ATTRS
+};

package/dist/compiled.css

@@ -610,6 +610,9 @@
 .h-\[14px\] {
   height: 14px;
 }
+.h-\[70vh\] {
+  height: 70vh;
+}
 .h-\[90vh\] {
   height: 90vh;
 }
@@ -652,6 +655,9 @@
 .min-h-0 {
   min-height: var(--spacing-0);
 }
+.min-h-\[20rem\] {
+  min-height: 20rem;
+}
 .min-h-\[60vh\] {
   min-height: 60vh;
 }
@@ -935,6 +941,13 @@
     margin-block-end: calc(var(--spacing-vsp-lg) * calc(1 - var(--tw-space-y-reverse)));
   }
 }
+.space-y-vsp-sm {
+  :where(& > :not(:last-child)) {
+    --tw-space-y-reverse: 0;
+    margin-block-start: calc(var(--spacing-vsp-sm) * var(--tw-space-y-reverse));
+    margin-block-end: calc(var(--spacing-vsp-sm) * calc(1 - var(--tw-space-y-reverse)));
+  }
+}
 .gap-x-hsp-2xs {
   column-gap: var(--spacing-hsp-2xs);
 }
@@ -1208,6 +1221,9 @@
 .p-hsp-sm {
   padding: var(--spacing-hsp-sm);
 }
+.p-hsp-xl {
+  padding: var(--spacing-hsp-xl);
+}
 .px-hsp-2xl {
   padding-inline: var(--spacing-hsp-2xl);
 }
@@ -1307,6 +1323,9 @@
 .pr-hsp-xl {
   padding-right: var(--spacing-hsp-xl);
 }
+.pr-hsp-xs {
+  padding-right: var(--spacing-hsp-xs);
+}
 .pb-\[50vh\] {
   padding-bottom: 50vh;
 }
@@ -1904,6 +1923,14 @@
     border-color: var(--color-accent);
   }
 }
+.focus-visible\:bg-accent\/10 {
+  &:focus-visible {
+    background-color: var(--color-accent);
+    @supports (color: color-mix(in lab, red, red)) {
+      background-color: color-mix(in oklab, var(--color-accent) 10%, transparent);
+    }
+  }
+}
 .focus-visible\:text-accent {
   &:focus-visible {
     color: var(--color-accent);
@@ -1975,6 +2002,11 @@
     margin-right: var(--spacing-0);
   }
 }
+.sm\:block {
+  @media (width >= 640px) {
+    display: block;
+  }
+}
 .sm\:flex {
   @media (width >= 640px) {
     display: flex;
@@ -2168,6 +2200,11 @@
     padding-top: var(--spacing-vsp-2xl);
   }
 }
+.lg\:pr-hsp-sm {
+  @media (width >= 1024px) {
+    padding-right: var(--spacing-hsp-sm);
+  }
+}
 .lg\:text-left {
   @media (width >= 1024px) {
     text-align: left;
@@ -3362,6 +3399,104 @@ button[data-zd-pending] {
   opacity: 0.7;
   pointer-events: none;
 }
+.zd-asset-page .zd-asset-code {
+  counter-reset: line;
+}
+.zd-asset-page .zd-asset-code .line {
+  display: block;
+  width: 100%;
+}
+.zd-asset-page .zd-asset-code .line::before {
+  counter-increment: line;
+  content: counter(line);
+  display: inline-block;
+  box-sizing: border-box;
+  width: var(--zd-asset-gutter, 4ch);
+  padding-right: var(--spacing-hsp-lg);
+  color: var(--color-muted);
+  text-align: right;
+  user-select: none;
+}
+.zd-asset-page .zd-asset-code .line:target {
+  background: var(--color-accent);
+  @supports (color: color-mix(in lab, red, red)) {
+    background: color-mix(in srgb, var(--color-accent) 15%, transparent);
+  }
+  box-shadow: inset 3px 0 0 var(--color-accent);
+}
+.zd-asset-page .zd-asset-filebar {
+  position: sticky;
+  top: 3.5rem;
+  z-index: var(--z-index-local-2);
+}
+.zd-asset-page .zd-asset-code + .code-buttons {
+  display: none;
+}
+.zd-asset-page .zd-asset-stage.is-checker {
+  background-color: var(--color-bg);
+  background-image: linear-gradient(45deg, var(--color-muted) 25%, transparent 25%), linear-gradient(-45deg, var(--color-muted) 25%, transparent 25%), linear-gradient(45deg, transparent 75%, var(--color-muted) 75%), linear-gradient(-45deg, transparent 75%, var(--color-muted) 75%);
+  @supports (color: color-mix(in lab, red, red)) {
+    background-image: linear-gradient(45deg, color-mix(in srgb, var(--color-muted) 10%, var(--color-bg)) 25%, transparent 25%), linear-gradient(-45deg, color-mix(in srgb, var(--color-muted) 10%, var(--color-bg)) 25%, transparent 25%), linear-gradient(45deg, transparent 75%, color-mix(in srgb, var(--color-muted) 10%, var(--color-bg)) 75%), linear-gradient(-45deg, transparent 75%, color-mix(in srgb, var(--color-muted) 10%, var(--color-bg)) 75%);
+  }
+  background-position: 0 0, 0 var(--spacing-hsp-sm), var(--spacing-hsp-sm) calc(-1 * var(--spacing-hsp-sm)), calc(-1 * var(--spacing-hsp-sm)) 0;
+  background-size: calc(2 * var(--spacing-hsp-sm)) calc(2 * var(--spacing-hsp-sm));
+}
+.zd-asset-page .zd-asset-stage.is-dark {
+  background: var(--color-code-bg);
+}
+.zd-asset-page .zd-asset-stage.is-1to1 img {
+  max-width: none;
+}
+.zd-asset-page .zd-asset-media-grid {
+  display: grid;
+  gap: var(--spacing-vsp-lg);
+}
+.zd-asset-page .zd-asset-media-rail {
+  display: flex;
+  flex-direction: column;
+  align-items: start;
+  gap: var(--spacing-vsp-md);
+}
+.zd-asset-page .zd-asset-media-rail > * {
+  width: 100%;
+}
+@media (min-width: 1024px) {
+  .zd-asset-page .zd-asset-media-grid {
+    grid-template-columns: minmax(0, 1fr) 20rem;
+    align-items: start;
+  }
+}
+[data-zd-asset-tree]:where(ul), [data-zd-asset-tree] :where(ul) {
+  margin: 0;
+  padding: 0;
+  list-style: none;
+}
+[data-zd-asset-tree] :where(li) {
+  margin: 0;
+}
+[data-zd-asset-tree] :where(ul) {
+  margin-left: var(--spacing-hsp-md);
+  padding-left: var(--spacing-hsp-md);
+  border-left: 1px solid currentColor;
+  @supports (color: color-mix(in lab, red, red)) {
+    border-left: 1px solid color-mix(in srgb, currentColor 18%, transparent);
+  }
+}
+[data-zd-asset-tree] :where(summary) {
+  list-style: none;
+}
+[data-zd-asset-tree] :where(summary)::-webkit-details-marker {
+  display: none;
+}
+[data-zd-asset-tree] :where(summary)::marker {
+  content: "";
+}
+[data-zd-asset-tree] details[open] > summary > svg:first-child {
+  transform: rotate(90deg);
+}
+[data-zd-asset-tree] details:not([open]) > summary > svg:nth-child(3), [data-zd-asset-tree] details[open] > summary > svg:nth-child(2) {
+  display: none;
+}
 @property --tw-translate-x {
   syntax: "*";
   inherits: false;

package/dist/config.d.ts

@@ -367,6 +367,16 @@ export interface ZudoDocConfig {
      * @default []
      */
     docHistoryExclude?: string[];
+    /** Generate a viewer page for every file under `public/<assetViewerDir>/**`. @default false */
+    assetViewer?: boolean;
+    /** Directory under `public/` holding viewable assets (also the raw URL prefix `/<dir>/…`). `client/` is reserved by zfb. @default "assets" */
+    assetViewerDir?: string;
+    /** URL prefix of the generated viewer pages (`/<prefix>/<path>/`). Must differ from `assetViewerDir`. @default "files" */
+    assetViewerRoutePrefix?: string;
+    /** Glob patterns (relative to the asset dir) excluded from viewer generation. @default [] */
+    assetViewerExclude?: string[];
+    /** When `true` (and `assetViewer` is `true`), generate a listing page at `/<assetViewerRoutePrefix>/` showing every managed asset as a folder tree. No effect when `assetViewer` is `false`. @default false */
+    assetViewerIndex?: boolean;
     /**
      * Body-foot utility area (doc-history / view-source), or `false` to disable.
      * @default false
@@ -485,8 +495,9 @@ export interface ZudoDocConfig {
      */
     colorSchemes?: Record<string, ColorScheme>;
     /**
-     * Override the UI-string translation table. When omitted, the shipped
-     * en/ja/de defaults (`@takazudo/zudo-doc/i18n-defaults`) are used.
+     * Override individual UI strings by locale and key. Shipped en/ja/de
+     * defaults (`@takazudo/zudo-doc/i18n-defaults`) are retained for keys the
+     * project does not supply.
      * @default undefined (`defaultTranslations` is used)
      */
     translations?: PresetTranslations;

package/dist/config.js

@@ -5,6 +5,32 @@ import { defaultTranslations } from "./i18n-defaults/index.js";
 import { defaultColorSchemes } from "./color-schemes-defaults/index.js";
 import { assertNoCommaInVersionSlugs } from "./version-availability/index.js";
 import { assertNoEmptyStringFaviconOrLogo } from "./config-assertions/index.js";
+import { validateAssetViewerSettings } from "./asset-path/index.js";
+function mergeDefaultTranslations(overrides) {
+  if (overrides === void 0) return defaultTranslations;
+  const merged = {};
+  const locales = /* @__PURE__ */ new Set([
+    ...Object.keys(defaultTranslations),
+    ...Object.keys(overrides)
+  ]);
+  for (const locale of locales) {
+    merged[locale] = {
+      ...defaultTranslations[locale] ?? {},
+      ...overrides[locale] ?? {}
+    };
+  }
+  return merged;
+}
+function assertValidAssetViewerSettings(dir, routePrefix) {
+  try {
+    validateAssetViewerSettings({ dir, routePrefix });
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    throw new TypeError(
+      `zudo-doc: ${message.replaceAll("assetViewer.dir", "assetViewerDir").replaceAll("assetViewer.routePrefix", "assetViewerRoutePrefix").replace("must be different", "must differ")}`
+    );
+  }
+}
 const DEFAULT_SETTINGS = {
   colorScheme: "Default Dark",
   colorMode: {
@@ -67,6 +93,11 @@ const DEFAULT_SETTINGS = {
   frontmatterPreview: false,
   docHistory: false,
   docHistoryExclude: [],
+  assetViewer: false,
+  assetViewerDir: "assets",
+  assetViewerRoutePrefix: "files",
+  assetViewerExclude: [],
+  assetViewerIndex: false,
   bodyFootUtilArea: false,
   htmlPreview: void 0,
   versions: false,
@@ -105,6 +136,10 @@ function zudoDoc(user = {}) {
     ...settingsOverrides
   } = user;
   const settings = { ...DEFAULT_SETTINGS, ...settingsOverrides };
+  assertValidAssetViewerSettings(
+    settings.assetViewerDir,
+    settings.assetViewerRoutePrefix
+  );
   assertNoCommaInVersionSlugs(settings.versions);
   assertNoEmptyStringFaviconOrLogo(settings);
   const fragment = zudoDocPreset({
@@ -114,7 +149,7 @@ function zudoDoc(user = {}) {
       tagVocabulary: userTagVocabularyEntries
     })),
     directiveVocabulary: userDirectives ?? defaultDirectiveVocabulary,
-    translations: userTranslations ?? defaultTranslations,
+    translations: mergeDefaultTranslations(userTranslations),
     colorSchemes: userColorSchemes ?? defaultColorSchemes,
     tagVocabulary: userTagVocabularyEntries ?? []
   });

package/dist/content/content-link.d.ts

@@ -1,6 +1,18 @@
 /** @jsxRuntime automatic */
 /** @jsxImportSource preact */
 import type { JSX } from "preact";
+import type { AssetManifest } from "../route-context-payload/types.js";
 type Props = JSX.IntrinsicElements["a"];
 export declare function ContentLink({ href, className, children, ...rest }: Props): JSX.Element;
+export interface CreateContentLinkOptions {
+    base: string;
+    assetManifest: AssetManifest | null;
+    routePrefix: string;
+    dir: string;
+}
+/**
+ * Bind ContentLink to an asset manifest. Only exact manifest entries are
+ * decorated and redirected; every other anchor follows ContentLink verbatim.
+ */
+export declare function createContentLink({ base, assetManifest, routePrefix, dir, }: CreateContentLinkOptions): (props: Props) => JSX.Element;
 export {};

package/dist/content/content-link.js

@@ -1,5 +1,7 @@
-import { jsx } from "preact/jsx-runtime";
+import { jsx, jsxs } from "preact/jsx-runtime";
 import { SmartBreak as SmartBreakBase } from "../smart-break/index.js";
+import { decodeAuthoredHref, assetViewerHref } from "../asset-path/index.js";
+import { AssetFileIcon, formatAssetBytes } from "../asset-components/index.js";
 const SmartBreak = SmartBreakBase;
 function ContentLink({ href, className, children, ...rest }) {
   const classes = typeof className === "string" ? className.split(" ") : [];
@@ -18,6 +20,44 @@ function ContentLink({ href, className, children, ...rest }) {
     }
   );
 }
+function createContentLink({
+  base,
+  assetManifest,
+  routePrefix,
+  dir
+}) {
+  return function ManifestAwareContentLink(props) {
+    const { href, className, children } = props;
+    const classes = typeof className === "string" ? className.split(" ") : [];
+    if (assetManifest === null || typeof href !== "string" || href.startsWith("#") || classes.includes("block") || classes.includes("hash-link")) {
+      return /* @__PURE__ */ jsx(ContentLink, { ...props });
+    }
+    const decoded = decodeAuthoredHref(href, { base, dir });
+    const entry = decoded ? assetManifest.entries.find((candidate) => candidate.path === decoded.path) : void 0;
+    if (!decoded || !entry) return /* @__PURE__ */ jsx(ContentLink, { ...props });
+    return /* @__PURE__ */ jsx(
+      ContentLink,
+      {
+        ...props,
+        href: assetViewerHref({
+          base,
+          routePrefix,
+          path: entry.path,
+          fragment: decoded.fragment
+        }),
+        children: /* @__PURE__ */ jsxs("span", { className: "inline-flex items-baseline gap-x-hsp-xs font-mono", children: [
+          /* @__PURE__ */ jsx(AssetFileIcon, { className: "h-icon-sm w-icon-sm shrink-0" }),
+          /* @__PURE__ */ jsx("span", { children }),
+          /* @__PURE__ */ jsxs("span", { className: "text-caption text-muted", children: [
+            "(",
+            formatAssetBytes(entry.bytes),
+            ")"
+          ] })
+        ] })
+      }
+    );
+  };
+}
 function extractText(children) {
   if (typeof children === "string") return children;
   if (typeof children === "number") return String(children);
@@ -39,5 +79,6 @@ function decodeEntities(s) {
   ).replace(/&/g, "&");
 }
 export {
-  ContentLink
+  ContentLink,
+  createContentLink
 };

package/dist/content/index.d.ts

@@ -19,7 +19,7 @@ export { HeadingH2 } from "./heading-h2.js";
 export { HeadingH3 } from "./heading-h3.js";
 export { HeadingH4 } from "./heading-h4.js";
 export { ContentParagraph } from "./content-paragraph.js";
-export { ContentLink } from "./content-link.js";
+export { ContentLink, createContentLink, type CreateContentLinkOptions, } from "./content-link.js";
 export { ContentStrong } from "./content-strong.js";
 export { ContentBlockquote } from "./content-blockquote.js";
 export { ContentUl } from "./content-ul.js";