@takazudo/zudo-doc 5.13.0 → 5.14.0

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

@@ -0,0 +1,21 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { JSX } from "preact";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { AssetIndexEntry } from "../route-context-payload/types.js";
+import type { Settings } from "../settings.js";
+export { ASSET_INDEX_PAGE_SCRIPT } from "./script.js";
+export interface AssetTreeNode {
+    name: string;
+    dirs: AssetTreeNode[];
+    files: AssetIndexEntry[];
+    fileCount: number;
+    bytes: number;
+}
+export interface AssetIndexPageViewProps {
+    entries: AssetIndexEntry[];
+}
+/** Build a sorted directory tree and aggregate every directory's subtree totals. */
+export declare function buildAssetTree(entries: AssetIndexEntry[]): AssetTreeNode;
+/** Build the package-owned wide asset index from a chrome context. */
+export declare function createAssetIndexPageView<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: AssetIndexPageViewProps) => JSX.Element;

package/dist/asset-index-page/index.js

@@ -0,0 +1,175 @@
+import { jsx, jsxs } from "preact/jsx-runtime";
+import { assetViewerHref } from "../asset-path/index.js";
+import { formatAssetBytes } from "../asset-components/index.js";
+import { assertChromeContext } from "../chrome/assert-chrome-context.js";
+import { deriveBodyEndIslands, deriveComposeMetaTitle } from "../chrome/derive.js";
+import { derivePrimaryChromeSlots } from "../chrome/primary-slots.js";
+import { DocLayoutWithDefaults } from "../doclayout/index.js";
+import { createHeadWithDefaults } from "../head-with-defaults/index.js";
+import {
+  ChevronRight,
+  FileArchive,
+  FileCode,
+  FileGeneric,
+  FileImage,
+  FilePdf,
+  FileText,
+  FileVideo,
+  Folder,
+  FolderOpen
+} from "../icons/index.js";
+import { resolveThemePackSsrSlug } from "../theme/theme-pack-provider.js";
+import { ASSET_INDEX_PAGE_SCRIPT } from "./script.js";
+import { ASSET_INDEX_PAGE_SCRIPT as ASSET_INDEX_PAGE_SCRIPT2 } from "./script.js";
+const ARCHIVE_EXTENSIONS = /* @__PURE__ */ new Set(["zip", "tar", "gz", "tgz", "7z", "rar"]);
+function basename(path) {
+  return path.split("/").at(-1) ?? path;
+}
+function freezeTree(node) {
+  const dirs = [...node.dirs.values()].sort((a, b) => a.name.localeCompare(b.name)).map(freezeTree);
+  const files = [...node.files].sort((a, b) => basename(a.path).localeCompare(basename(b.path)));
+  return {
+    name: node.name,
+    dirs,
+    files,
+    fileCount: files.length + dirs.reduce((total, dir) => total + dir.fileCount, 0),
+    bytes: files.reduce((total, file) => total + file.bytes, 0) + dirs.reduce((total, dir) => total + dir.bytes, 0)
+  };
+}
+function buildAssetTree(entries) {
+  const root = { name: "", dirs: /* @__PURE__ */ new Map(), files: [] };
+  for (const entry of entries) {
+    let node = root;
+    for (const segment of entry.dir.split("/").filter(Boolean)) {
+      let child = node.dirs.get(segment);
+      if (!child) {
+        child = { name: segment, dirs: /* @__PURE__ */ new Map(), files: [] };
+        node.dirs.set(segment, child);
+      }
+      node = child;
+    }
+    node.files.push(entry);
+  }
+  return freezeTree(root);
+}
+function folderCount(node) {
+  return node.dirs.reduce((total, dir) => total + 1 + folderCount(dir), 0);
+}
+function formatDuration(seconds) {
+  const rounded = Math.round(seconds);
+  return `${Math.floor(rounded / 60)}:${String(rounded % 60).padStart(2, "0")}`;
+}
+function kindLabel(asset) {
+  if (asset.language) return asset.language;
+  return asset.mime.split("/").at(-1)?.toUpperCase() ?? asset.kind.toUpperCase();
+}
+function facetLabel(asset, linesLabel) {
+  if (asset.lines !== void 0) return linesLabel.replace("{count}", String(asset.lines));
+  if (asset.kind === "video" && asset.durationSec !== void 0) return formatDuration(asset.durationSec);
+  if (asset.width !== void 0 && asset.height !== void 0) return `${asset.width} \xD7 ${asset.height}`;
+  if (asset.durationSec !== void 0) return formatDuration(asset.durationSec);
+  return null;
+}
+function iconFor(asset) {
+  const extension = basename(asset.path).split(".").at(-1)?.toLowerCase();
+  if (asset.kind === "other" && extension && ARCHIVE_EXTENSIONS.has(extension)) return FileArchive;
+  const icons = {
+    code: FileCode,
+    text: FileText,
+    image: FileImage,
+    video: FileVideo,
+    pdf: FilePdf,
+    other: FileGeneric
+  };
+  return icons[asset.kind];
+}
+function countLabel(count, plural, single) {
+  return (count === 1 ? single : plural).replace("{count}", String(count));
+}
+function AssetTree({ node, base, routePrefix, fileCountLabel, fileCountSingleLabel, linesLabel, root = false }) {
+  return /* @__PURE__ */ jsxs("ul", { "data-zd-asset-tree": root ? true : void 0, children: [
+    node.dirs.map((dir) => /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("details", { open: true, children: [
+      /* @__PURE__ */ jsxs("summary", { class: "flex cursor-pointer items-center gap-hsp-xs rounded px-hsp-sm py-vsp-3xs text-small hover:bg-accent/10 focus-visible:bg-accent/10", children: [
+        /* @__PURE__ */ jsx(ChevronRight, { className: "h-icon-xs w-icon-xs shrink-0 text-muted transition-transform" }),
+        /* @__PURE__ */ jsx(Folder, { className: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
+        /* @__PURE__ */ jsx(FolderOpen, { className: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
+        /* @__PURE__ */ jsxs("span", { class: "min-w-0 truncate font-mono text-fg", children: [
+          dir.name,
+          "/"
+        ] }),
+        /* @__PURE__ */ jsxs("span", { class: "ml-auto hidden whitespace-nowrap pl-hsp-lg text-caption text-muted sm:block", children: [
+          countLabel(dir.fileCount, fileCountLabel, fileCountSingleLabel),
+          " \xB7 ",
+          formatAssetBytes(dir.bytes)
+        ] })
+      ] }),
+      /* @__PURE__ */ jsx(AssetTree, { node: dir, base, routePrefix, fileCountLabel, fileCountSingleLabel, linesLabel })
+    ] }) })),
+    node.files.map((asset) => {
+      const Icon = iconFor(asset);
+      const facet = facetLabel(asset, linesLabel);
+      const meta = [kindLabel(asset), facet, formatAssetBytes(asset.bytes)].filter(Boolean).join(" \xB7 ");
+      return /* @__PURE__ */ jsx("li", { children: /* @__PURE__ */ jsxs("a", { href: assetViewerHref({ base, routePrefix, path: asset.path }), title: asset.name, class: "flex min-w-0 items-center gap-hsp-xs rounded px-hsp-sm py-vsp-3xs text-small text-fg hover:bg-accent/10 hover:text-accent hover:underline focus-visible:bg-accent/10 focus-visible:text-accent focus-visible:underline", children: [
+        /* @__PURE__ */ jsx(Icon, { className: "h-icon-sm w-icon-sm shrink-0 text-muted" }),
+        /* @__PURE__ */ jsx("span", { class: "min-w-0 truncate font-mono", children: basename(asset.path) }),
+        /* @__PURE__ */ jsx("span", { class: "ml-auto hidden whitespace-nowrap pl-hsp-lg text-caption text-muted sm:block", children: meta })
+      ] }) });
+    })
+  ] });
+}
+function createAssetIndexPageView(ctx) {
+  assertChromeContext(ctx, "createAssetIndexPageView");
+  const settings = ctx.settings;
+  const locale = ctx.defaultLocale;
+  const t = ctx.t;
+  const composeMetaTitle = deriveComposeMetaTitle(ctx);
+  const HeadWithDefaults = createHeadWithDefaults(ctx);
+  const { Header: HeaderWithDefaults, Footer: FooterWithDefaults, Breadcrumb: BreadcrumbWithDefaults } = derivePrimaryChromeSlots(ctx);
+  const BodyEndIslands = deriveBodyEndIslands(ctx);
+  const dataThemePack = resolveThemePackSsrSlug(ctx.themePackRegistry, settings);
+  return function AssetIndexPageView({ entries }) {
+    const routePrefix = ctx.assetManifest?.routePrefix ?? settings.assetViewerRoutePrefix;
+    const dir = ctx.assetManifest?.dir ?? settings.assetViewerDir;
+    const indexUrl = ctx.withBase(`/${routePrefix}/`);
+    const tree = buildAssetTree(entries);
+    const folders = folderCount(tree);
+    const fileCountLabel = t("asset.fileCount", locale);
+    const fileCountSingleLabel = t("asset.fileCountSingle", locale);
+    const folderCountLabel = t("asset.folderCount", locale);
+    const folderCountSingleLabel = t("asset.folderCountSingle", locale);
+    const title = t("asset.crumb", locale);
+    return /* @__PURE__ */ jsx(DocLayoutWithDefaults, { title: composeMetaTitle(title), head: /* @__PURE__ */ jsx(HeadWithDefaults, { title, description: t("asset.indexDescription", locale), canonical: ctx.absoluteUrl(indexUrl) }), lang: locale, dataThemePack, noindex: settings.noindex, hideSidebar: true, hideToc: true, sidebarOverride: false, contentWide: true, breadcrumbOverride: /* @__PURE__ */ jsx(BreadcrumbWithDefaults, { items: [{ label: "", href: ctx.withBase("/") }, { label: title }] }), headerOverride: /* @__PURE__ */ jsx(HeaderWithDefaults, { lang: locale, currentPath: indexUrl, hideSidebarToggle: true }), footerOverride: /* @__PURE__ */ jsx(FooterWithDefaults, { lang: locale }), bodyEndComponents: /* @__PURE__ */ jsx(BodyEndIslands, { basePath: settings.base ?? "/" }), enableClientRouter: settings.dynamicPageTransition, children: /* @__PURE__ */ jsxs("div", { "data-zd-asset-index-page": true, children: [
+      /* @__PURE__ */ jsxs("header", { children: [
+        /* @__PURE__ */ jsxs("div", { class: "mb-vsp-xs flex flex-wrap items-center gap-hsp-xs text-micro tracking-wide uppercase", children: [
+          /* @__PURE__ */ jsx("span", { class: "rounded-full border border-muted px-hsp-sm py-vsp-3xs text-fg", children: title }),
+          /* @__PURE__ */ jsx("span", { class: "rounded-full border border-muted px-hsp-sm py-vsp-3xs text-muted", children: t("asset.indexBadge", locale) })
+        ] }),
+        /* @__PURE__ */ jsx("h1", { class: "mb-vsp-xs border-b border-fg pb-vsp-xs font-mono text-heading font-bold leading-tight", children: title }),
+        /* @__PURE__ */ jsxs("div", { "data-doc-metainfo": true, class: "mb-vsp-md flex flex-wrap items-center gap-x-hsp-md gap-y-vsp-2xs text-caption text-fg", children: [
+          /* @__PURE__ */ jsx("span", { children: countLabel(tree.fileCount, fileCountLabel, fileCountSingleLabel) }),
+          /* @__PURE__ */ jsx("span", { children: countLabel(folders, folderCountLabel, folderCountSingleLabel) }),
+          /* @__PURE__ */ jsx("span", { children: formatAssetBytes(tree.bytes) })
+        ] }),
+        /* @__PURE__ */ jsx("p", { class: "mb-vsp-lg text-title text-muted", children: t("asset.indexDescription", locale) })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { class: "mb-vsp-sm flex flex-wrap items-center justify-between gap-hsp-sm text-caption", children: [
+        /* @__PURE__ */ jsxs("span", { class: "font-mono text-muted", children: [
+          "public/",
+          dir,
+          "/"
+        ] }),
+        /* @__PURE__ */ jsxs("span", { class: "flex gap-hsp-sm", children: [
+          /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-index-action": "expand", class: "text-fg hover:text-accent focus-visible:text-accent", children: t("asset.expandAll", locale) }),
+          /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-index-action": "collapse", class: "text-fg hover:text-accent focus-visible:text-accent", children: t("asset.collapseAll", locale) })
+        ] })
+      ] }),
+      entries.length > 0 ? /* @__PURE__ */ jsx(AssetTree, { root: true, node: tree, base: settings.base, routePrefix, fileCountLabel, fileCountSingleLabel, linesLabel: t("asset.lines", locale) }) : /* @__PURE__ */ jsx("p", { class: "text-small text-muted", "data-zd-asset-index-empty": true, children: t("asset.indexEmpty", locale) }),
+      /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: ASSET_INDEX_PAGE_SCRIPT } })
+    ] }) });
+  };
+}
+export {
+  ASSET_INDEX_PAGE_SCRIPT2 as ASSET_INDEX_PAGE_SCRIPT,
+  buildAssetTree,
+  createAssetIndexPageView
+};

package/dist/asset-index-page/script.d.ts

@@ -0,0 +1,2 @@
+/** Inline bootstrap for the asset-index disclosure controls. */
+export declare const ASSET_INDEX_PAGE_SCRIPT: string;

package/dist/asset-index-page/script.js

@@ -0,0 +1,4 @@
+const ASSET_INDEX_PAGE_SCRIPT = String.raw`(()=>{const init=()=>{document.querySelectorAll('[data-zd-asset-index-page]').forEach(page=>{if(page.hasAttribute('data-zd-asset-index-ready'))return;page.setAttribute('data-zd-asset-index-ready','true');page.querySelectorAll('[data-zd-asset-index-action]').forEach(button=>{button.removeAttribute('disabled');button.addEventListener('click',()=>{const open=button.getAttribute('data-zd-asset-index-action')==='expand';page.querySelectorAll('[data-zd-asset-tree] details').forEach(details=>{details.open=open})})})})};if(!document.__zdAssetIndexPageInit){document.__zdAssetIndexPageInit=init;document.addEventListener('zfb:after-swap',init)}document.__zdAssetIndexPageInit()})();`;
+export {
+  ASSET_INDEX_PAGE_SCRIPT
+};

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

@@ -0,0 +1,67 @@
+/** @jsxRuntime automatic */
+/** @jsxImportSource preact */
+import type { ComponentChildren, JSX, VNode } from "preact";
+import type { ChromeContext } from "../factory-context/index.js";
+import type { AssetRecord } from "../plugins/internal/asset-viewer/types.js";
+import type { Settings } from "../settings.js";
+export { ASSET_PAGE_SCRIPT } from "./script.js";
+export type { AssetRecord } from "../plugins/internal/asset-viewer/types.js";
+export interface AssetPageViewProps {
+    entry: AssetRecord;
+}
+export declare function AssetEyebrow({ asset, badge }: {
+    asset: AssetRecord;
+    badge: string;
+}): VNode;
+export declare function AssetHeader({ asset, locale, badge, updatedLabel, linesLabel }: {
+    asset: AssetRecord;
+    locale: string;
+    badge: string;
+    updatedLabel: string;
+    linesLabel?: string;
+}): VNode;
+export declare function AssetActions({ rawUrl, downloadLabel, openRawLabel, copyLabel, wrapLabel, code, bottom }: {
+    rawUrl: string;
+    downloadLabel: string;
+    openRawLabel: string;
+    copyLabel: string;
+    wrapLabel: string;
+    code?: boolean;
+    bottom?: boolean;
+}): VNode;
+export declare function AssetCodeBody({ asset, copyLabel, wrapLabel, truncatedLabel, linesLabel }: {
+    asset: AssetRecord;
+    copyLabel: string;
+    wrapLabel: string;
+    truncatedLabel: string;
+    linesLabel?: string;
+}): VNode;
+export declare function AssetImageStage({ asset, rawUrl }: {
+    asset: AssetRecord;
+    rawUrl: string;
+}): VNode;
+export declare function AssetVideoStage({ asset, rawUrl }: {
+    asset: AssetRecord;
+    rawUrl: string;
+}): VNode;
+export declare function AssetPdfStage({ asset, rawUrl, children }: {
+    asset: AssetRecord;
+    rawUrl: string;
+    children: ComponentChildren;
+}): VNode;
+export declare function AssetDownloadPanel({ asset, rawUrl, noPreview, downloadLabel, copyLabel }: {
+    asset: AssetRecord;
+    rawUrl: string;
+    noPreview: string;
+    downloadLabel: string;
+    copyLabel: string;
+}): VNode;
+export declare function AssetLinkedFrom({ asset, label }: {
+    asset: AssetRecord;
+    label: string;
+}): VNode | null;
+export declare function AssetDetails({ asset }: {
+    asset: AssetRecord;
+}): VNode;
+/** Build the package-owned wide asset viewer page from a chrome context. */
+export declare function createAssetPageView<S extends Settings = Settings>(ctx: ChromeContext<S>): (props: AssetPageViewProps) => JSX.Element;

package/dist/asset-page/index.js

@@ -0,0 +1,244 @@
+import { Fragment, jsx, jsxs } from "preact/jsx-runtime";
+import { BodyFootUtilArea } from "../body-foot-util/index.js";
+import { deriveBodyEndIslands } from "../chrome/derive.js";
+import { deriveComposeMetaTitle } from "../chrome/derive.js";
+import { derivePrimaryChromeSlots } from "../chrome/primary-slots.js";
+import { assertChromeContext } from "../chrome/assert-chrome-context.js";
+import { DocLayoutWithDefaults } from "../doclayout/index.js";
+import { formatDate } from "../format-date/index.js";
+import { buildGitHubSourceUrl } from "../github-helpers/index.js";
+import { createHeadWithDefaults } from "../head-with-defaults/index.js";
+import { assetRawHref, assetViewerHref } from "../asset-path/index.js";
+import { formatAssetBytes } from "../asset-components/index.js";
+import { resolveThemePackSsrSlug } from "../theme/theme-pack-provider.js";
+import { ASSET_PAGE_SCRIPT } from "./script.js";
+import { ASSET_PAGE_SCRIPT as ASSET_PAGE_SCRIPT2 } from "./script.js";
+function formatDuration(seconds) {
+  const rounded = Math.round(seconds);
+  const minutes = Math.floor(rounded / 60);
+  const remainder = (rounded % 60).toString().padStart(2, "0");
+  return `${minutes}:${remainder}`;
+}
+function kindLabel(asset) {
+  if (asset.language) return asset.language;
+  return asset.mime.split("/").at(-1)?.toUpperCase() ?? asset.kind.toUpperCase();
+}
+function facetLabel(asset, linesLabel) {
+  if (asset.lines !== void 0) return linesLabel ?? `${asset.lines} lines`;
+  if (asset.kind === "video" && asset.durationSec !== void 0) {
+    return formatDuration(asset.durationSec);
+  }
+  if (asset.width !== void 0 && asset.height !== void 0) return `${asset.width} \xD7 ${asset.height}`;
+  if (asset.durationSec !== void 0) return formatDuration(asset.durationSec);
+  return null;
+}
+function AssetEyebrow({ asset, badge }) {
+  return /* @__PURE__ */ jsxs("div", { class: "mb-vsp-xs flex flex-wrap items-center gap-hsp-xs text-micro tracking-wide uppercase", children: [
+    /* @__PURE__ */ jsx("span", { class: "rounded-full border border-muted px-hsp-sm py-vsp-3xs text-fg", children: badge }),
+    /* @__PURE__ */ jsx("span", { class: "rounded-full border border-muted px-hsp-sm py-vsp-3xs text-muted", children: kindLabel(asset) })
+  ] });
+}
+function AssetHeader({ asset, locale, badge, updatedLabel, linesLabel }) {
+  const facet = facetLabel(asset, linesLabel);
+  return /* @__PURE__ */ jsxs("header", { children: [
+    /* @__PURE__ */ jsx(AssetEyebrow, { asset, badge }),
+    /* @__PURE__ */ jsx("h1", { class: "mb-vsp-xs border-b border-fg pb-vsp-xs font-mono text-heading font-bold leading-tight", children: asset.name }),
+    /* @__PURE__ */ jsxs("div", { "data-doc-metainfo": true, class: "mb-vsp-md flex flex-wrap items-center gap-x-hsp-md gap-y-vsp-2xs text-caption text-fg", children: [
+      asset.dir && /* @__PURE__ */ jsx("span", { children: asset.dir }),
+      facet && /* @__PURE__ */ jsx("span", { children: facet }),
+      /* @__PURE__ */ jsx("span", { children: formatAssetBytes(asset.bytes) }),
+      asset.updatedDate && /* @__PURE__ */ jsxs("span", { children: [
+        updatedLabel,
+        " ",
+        formatDate(asset.updatedDate, locale)
+      ] }),
+      asset.author && /* @__PURE__ */ jsx("span", { children: asset.author })
+    ] }),
+    asset.description && /* @__PURE__ */ jsx("p", { class: "mb-vsp-lg text-title text-muted", "data-doc-description": true, children: asset.description })
+  ] });
+}
+function actionClass(primary = false) {
+  return `${primary ? "border-accent bg-accent text-bg" : "border-muted bg-surface text-fg"} inline-flex items-center justify-center rounded border px-hsp-md py-vsp-2xs text-caption font-medium hover:border-accent focus-visible:border-accent`;
+}
+function AssetActions({ rawUrl, downloadLabel, openRawLabel, copyLabel, wrapLabel, code = false, bottom = false }) {
+  return /* @__PURE__ */ jsxs("div", { class: `${bottom ? "mt-vsp-lg border-t border-muted pt-vsp-md" : "mb-vsp-md"} flex flex-wrap gap-hsp-sm`, "data-zd-asset-actions": true, children: [
+    /* @__PURE__ */ jsx("a", { download: true, href: rawUrl, class: `${actionClass(true)} hover:underline focus-visible:underline`, children: downloadLabel }),
+    /* @__PURE__ */ jsx("a", { href: rawUrl, "data-zfb-reload": true, target: "_blank", rel: "noopener", class: `${actionClass()} hover:underline focus-visible:underline`, children: openRawLabel }),
+    code && /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-action": "copy", class: actionClass(), children: copyLabel }),
+    code && /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-action": "wrap", class: actionClass(), children: wrapLabel })
+  ] });
+}
+function AssetCodeBody({ asset, copyLabel, wrapLabel, truncatedLabel, linesLabel }) {
+  const highlightedCode = asset.html?.match(/^<pre\b[^>]*>\s*(<code\b[\s\S]*<\/code>)\s*<\/pre>$/)?.[1] ?? "";
+  return /* @__PURE__ */ jsxs("section", { children: [
+    /* @__PURE__ */ jsxs("div", { class: "zd-asset-filebar flex flex-wrap items-center justify-between gap-hsp-sm border border-muted bg-surface px-hsp-md py-vsp-2xs text-caption", children: [
+      /* @__PURE__ */ jsxs("span", { class: "font-mono", children: [
+        asset.name,
+        " \xB7 ",
+        linesLabel ?? `${asset.lines ?? 0} lines`,
+        " \xB7 ",
+        formatAssetBytes(asset.bytes),
+        " \xB7 ",
+        kindLabel(asset)
+      ] }),
+      /* @__PURE__ */ jsxs("span", { class: "flex gap-hsp-sm", children: [
+        /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-action": "copy", class: "text-fg hover:text-accent focus-visible:text-accent", children: copyLabel }),
+        /* @__PURE__ */ jsx("button", { type: "button", disabled: true, "data-zd-asset-action": "wrap", class: "text-fg hover:text-accent focus-visible:text-accent", children: wrapLabel })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsx("pre", { class: "hi-root zd-asset-code", "data-lang": asset.language ?? "text", dangerouslySetInnerHTML: { __html: highlightedCode } }),
+    asset.truncated && /* @__PURE__ */ jsx("p", { class: "mt-vsp-xs text-caption text-muted", children: truncatedLabel })
+  ] });
+}
+function EnlargeIcon() {
+  return /* @__PURE__ */ jsx("svg", { viewBox: "0 0 24 24", "aria-hidden": "true", children: /* @__PURE__ */ jsx("path", { fill: "none", stroke: "currentColor", "stroke-linecap": "round", "stroke-linejoin": "round", "stroke-width": "2", d: "M8 3H3v5m13-5h5v5M8 21H3v-5m13 5h5v-5M3 8l6-6m12 6-6-6M3 16l6 6m12-6-6 6" }) });
+}
+function AssetImageStage({ asset, rawUrl }) {
+  return /* @__PURE__ */ jsxs("section", { children: [
+    /* @__PURE__ */ jsxs("div", { class: "mb-vsp-xs flex flex-wrap gap-hsp-sm text-caption", children: [
+      /* @__PURE__ */ jsxs("div", { class: "flex rounded border border-muted", children: [
+        /* @__PURE__ */ jsx("button", { type: "button", "aria-pressed": "true", "data-zd-asset-action": "fit", class: "px-hsp-sm py-vsp-3xs", children: "Fit" }),
+        /* @__PURE__ */ jsx("button", { type: "button", "aria-pressed": "false", "data-zd-asset-action": "1to1", class: "border-l border-muted px-hsp-sm py-vsp-3xs", children: "1:1" })
+      ] }),
+      /* @__PURE__ */ jsxs("div", { class: "flex rounded border border-muted", children: [
+        /* @__PURE__ */ jsx("button", { type: "button", "aria-pressed": "true", "data-zd-asset-action": "checker", class: "px-hsp-sm py-vsp-3xs", children: "Checker" }),
+        /* @__PURE__ */ jsx("button", { type: "button", "aria-pressed": "false", "data-zd-asset-action": "dark", class: "border-l border-muted px-hsp-sm py-vsp-3xs", children: "Dark" })
+      ] })
+    ] }),
+    /* @__PURE__ */ jsxs("figure", { class: "zd-enlargeable zd-asset-stage is-checker flex min-h-[20rem] items-center justify-center overflow-auto rounded border border-muted bg-surface p-hsp-lg", children: [
+      /* @__PURE__ */ jsx("img", { src: rawUrl, alt: asset.description ?? asset.name, width: asset.width, height: asset.height }),
+      /* @__PURE__ */ jsx("button", { type: "button", class: "zd-enlarge-btn", hidden: true, "aria-label": "Enlarge image", children: /* @__PURE__ */ jsx(EnlargeIcon, {}) })
+    ] })
+  ] });
+}
+function AssetVideoStage({ asset, rawUrl }) {
+  return /* @__PURE__ */ jsx("div", { class: "zd-asset-stage flex items-center justify-center rounded border border-muted bg-surface p-hsp-lg", children: /* @__PURE__ */ jsx("video", { controls: true, preload: "metadata", src: rawUrl, width: asset.width, height: asset.height, class: "max-w-full" }) });
+}
+function AssetPdfStage({ asset, rawUrl, children }) {
+  return /* @__PURE__ */ jsxs("section", { children: [
+    /* @__PURE__ */ jsx("iframe", { title: asset.name, src: `${rawUrl}#view=FitH`, class: "zd-asset-pdf h-[70vh] w-full rounded border border-muted" }),
+    /* @__PURE__ */ jsx("div", { class: "mt-vsp-sm", children })
+  ] });
+}
+function AssetDownloadPanel({ asset, rawUrl, noPreview, downloadLabel, copyLabel }) {
+  return /* @__PURE__ */ jsxs("section", { class: "rounded border border-dashed border-muted p-hsp-xl text-center", children: [
+    /* @__PURE__ */ jsx("div", { "aria-hidden": "true", class: "mb-vsp-xs text-heading", children: "\u2193" }),
+    /* @__PURE__ */ jsx("h2", { class: "font-mono text-title font-bold", children: asset.name }),
+    /* @__PURE__ */ jsxs("p", { class: "mb-vsp-sm text-caption text-muted", children: [
+      kindLabel(asset),
+      " \xB7 ",
+      formatAssetBytes(asset.bytes)
+    ] }),
+    /* @__PURE__ */ jsx("p", { class: "mb-vsp-md text-small text-muted", children: noPreview }),
+    /* @__PURE__ */ jsxs("div", { class: "flex flex-wrap justify-center gap-hsp-sm", children: [
+      /* @__PURE__ */ jsx("a", { download: true, href: rawUrl, class: `${actionClass(true)} hover:underline focus-visible:underline`, children: downloadLabel }),
+      /* @__PURE__ */ jsx("button", { type: "button", "data-zd-asset-action": "copy-url", "data-zd-copy-url": rawUrl, class: actionClass(), children: copyLabel })
+    ] })
+  ] });
+}
+function AssetLinkedFrom({ asset, label }) {
+  if (asset.linkedFrom.length === 0) return null;
+  return /* @__PURE__ */ jsxs("section", { class: "mt-vsp-lg", children: [
+    /* @__PURE__ */ jsx("h2", { class: "mb-vsp-xs text-title font-bold", children: label }),
+    /* @__PURE__ */ jsx("ul", { class: "space-y-vsp-sm", children: asset.linkedFrom.map((link) => /* @__PURE__ */ jsxs("li", { class: "border-l border-muted pl-hsp-md", children: [
+      /* @__PURE__ */ jsx("p", { class: "text-caption text-muted", children: link.crumb }),
+      /* @__PURE__ */ jsx("a", { href: link.href, class: "text-accent hover:underline focus-visible:underline", children: link.title }),
+      /* @__PURE__ */ jsx("p", { class: "text-caption italic text-muted", children: link.context })
+    ] })) })
+  ] });
+}
+function AssetDetails({ asset }) {
+  const rows = [["Type", asset.mime], ["Size", formatAssetBytes(asset.bytes)], ["Path", asset.path]];
+  if (asset.width !== void 0 && asset.height !== void 0) rows.splice(1, 0, ["Dimensions", `${asset.width} \xD7 ${asset.height}`]);
+  if (asset.updatedDate) rows.push(["Updated", asset.updatedDate]);
+  return /* @__PURE__ */ jsxs("section", { children: [
+    /* @__PURE__ */ jsx("h2", { class: "mb-vsp-xs text-title font-bold", children: "Details" }),
+    /* @__PURE__ */ jsx("dl", { class: "grid grid-cols-[auto_1fr] gap-x-hsp-md gap-y-vsp-2xs text-caption", children: rows.map(([term, value]) => /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx("dt", { class: "font-medium text-muted", children: term }),
+      /* @__PURE__ */ jsx("dd", { class: "min-w-0 break-words text-fg", children: value })
+    ] })) })
+  ] });
+}
+function MediaLayout({ stage, details, linked }) {
+  return /* @__PURE__ */ jsxs("div", { class: "zd-asset-media-grid", children: [
+    /* @__PURE__ */ jsx("div", { class: "min-w-0", children: stage }),
+    /* @__PURE__ */ jsxs("div", { class: "zd-asset-media-rail", children: [
+      /* @__PURE__ */ jsx("div", { class: "rounded border border-muted p-hsp-lg", children: details }),
+      linked
+    ] })
+  ] });
+}
+function createAssetPageView(ctx) {
+  assertChromeContext(ctx, "createAssetPageView");
+  const settings = ctx.settings;
+  const locale = ctx.defaultLocale;
+  const t = ctx.t;
+  const composeMetaTitle = deriveComposeMetaTitle(ctx);
+  const HeadWithDefaults = createHeadWithDefaults(ctx);
+  const { Header: HeaderWithDefaults, Footer: FooterWithDefaults, Breadcrumb: BreadcrumbWithDefaults } = derivePrimaryChromeSlots(ctx);
+  const BodyEndIslands = deriveBodyEndIslands(ctx);
+  const dataThemePack = resolveThemePackSsrSlug(ctx.themePackRegistry, settings);
+  return function AssetPageView({ entry: asset }) {
+    const routePrefix = ctx.assetManifest?.routePrefix ?? settings.assetViewerRoutePrefix;
+    const dir = ctx.assetManifest?.dir ?? settings.assetViewerDir;
+    const viewerUrl = assetViewerHref({ base: settings.base, routePrefix, path: asset.path });
+    const rawUrl = assetRawHref({ base: settings.base, dir, path: asset.path });
+    const linesLabel = t("asset.lines", locale).replace(
+      "{count}",
+      String(asset.lines ?? 0)
+    );
+    const dirSegments = asset.dir.split("/").filter(Boolean);
+    const indexUrl = ctx.withBase(`/${routePrefix}/`);
+    const breadcrumbItems = [
+      { label: "", href: ctx.withBase("/") },
+      { label: t("asset.crumb", locale), ...settings.assetViewerIndex ? { href: indexUrl } : {} },
+      ...dirSegments.map((label) => ({ label })),
+      { label: asset.name }
+    ];
+    const linked = /* @__PURE__ */ jsx(AssetLinkedFrom, { asset, label: t("asset.linkedFrom", locale) });
+    const details = /* @__PURE__ */ jsx(AssetDetails, { asset });
+    const downloadPanel = /* @__PURE__ */ jsx(AssetDownloadPanel, { asset, rawUrl, noPreview: t("asset.noPreview", locale), downloadLabel: t("asset.download", locale), copyLabel: t("asset.copy", locale) });
+    let body;
+    const isMedia = asset.previewable && asset.sniffOk && ["image", "video", "pdf"].includes(asset.kind);
+    if (!asset.previewable || !asset.sniffOk) body = /* @__PURE__ */ jsxs(Fragment, { children: [
+      downloadPanel,
+      /* @__PURE__ */ jsx(AssetDetails, { asset }),
+      linked
+    ] });
+    else if (asset.kind === "image") body = /* @__PURE__ */ jsx(MediaLayout, { stage: /* @__PURE__ */ jsx(AssetImageStage, { asset, rawUrl }), details, linked });
+    else if (asset.kind === "video") body = /* @__PURE__ */ jsx(MediaLayout, { stage: /* @__PURE__ */ jsx(AssetVideoStage, { asset, rawUrl }), details, linked });
+    else if (asset.kind === "pdf") body = /* @__PURE__ */ jsx(MediaLayout, { stage: /* @__PURE__ */ jsx(AssetPdfStage, { asset, rawUrl, children: downloadPanel }), details, linked });
+    else body = /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(AssetCodeBody, { asset, copyLabel: t("asset.copy", locale), wrapLabel: t("asset.wrap", locale), truncatedLabel: t("asset.truncated", locale), linesLabel }),
+      /* @__PURE__ */ jsx(AssetDetails, { asset }),
+      linked
+    ] });
+    const showSource = settings.bodyFootUtilArea !== false && settings.bodyFootUtilArea.viewSourceLink !== false;
+    return /* @__PURE__ */ jsx(DocLayoutWithDefaults, { title: composeMetaTitle(asset.name), head: /* @__PURE__ */ jsx(HeadWithDefaults, { title: asset.name, description: asset.description, canonical: ctx.absoluteUrl(viewerUrl) }), lang: locale, dataThemePack, noindex: settings.noindex, hideSidebar: true, hideToc: true, sidebarOverride: false, contentWide: true, breadcrumbOverride: /* @__PURE__ */ jsx(BreadcrumbWithDefaults, { items: breadcrumbItems }), headerOverride: /* @__PURE__ */ jsx(HeaderWithDefaults, { lang: locale, currentPath: viewerUrl, hideSidebarToggle: true }), footerOverride: /* @__PURE__ */ jsx(FooterWithDefaults, { lang: locale }), bodyEndComponents: /* @__PURE__ */ jsx(BodyEndIslands, { basePath: settings.base ?? "/", forceImageEnlarge: asset.kind === "image" && asset.previewable && asset.sniffOk }), enableClientRouter: settings.dynamicPageTransition, children: /* @__PURE__ */ jsxs("div", { class: "zd-asset-page", "data-zd-asset-page": true, children: [
+      asset.linkedFrom[0] && /* @__PURE__ */ jsx("p", { class: "mb-vsp-xs text-caption", children: /* @__PURE__ */ jsxs("a", { href: asset.linkedFrom[0].href, class: "text-muted hover:text-accent focus-visible:text-accent hover:underline focus-visible:underline", children: [
+        "\u2190 Back to ",
+        asset.linkedFrom[0].title
+      ] }) }),
+      /* @__PURE__ */ jsx(AssetHeader, { asset, locale, badge: t("asset.badge", locale), updatedLabel: t("doc.updated", locale), linesLabel }),
+      /* @__PURE__ */ jsx(AssetActions, { rawUrl, downloadLabel: t("asset.download", locale), openRawLabel: t("asset.openRaw", locale), copyLabel: t("asset.copy", locale), wrapLabel: t("asset.wrap", locale), code: !isMedia && asset.previewable && asset.sniffOk }),
+      body,
+      /* @__PURE__ */ jsx(AssetActions, { rawUrl, downloadLabel: t("asset.download", locale), openRawLabel: t("asset.openRaw", locale), copyLabel: t("asset.copy", locale), wrapLabel: t("asset.wrap", locale), bottom: true }),
+      showSource && /* @__PURE__ */ jsx(BodyFootUtilArea, { sourceUrl: buildGitHubSourceUrl(settings.githubUrl, `public/${dir}`, asset.path), viewSourceLabel: t("doc.viewSource", locale), docHistoryIsland: null }),
+      /* @__PURE__ */ jsx("script", { dangerouslySetInnerHTML: { __html: ASSET_PAGE_SCRIPT } })
+    ] }) });
+  };
+}
+export {
+  ASSET_PAGE_SCRIPT2 as ASSET_PAGE_SCRIPT,
+  AssetActions,
+  AssetCodeBody,
+  AssetDetails,
+  AssetDownloadPanel,
+  AssetEyebrow,
+  AssetHeader,
+  AssetImageStage,
+  AssetLinkedFrom,
+  AssetPdfStage,
+  AssetVideoStage,
+  createAssetPageView
+};

package/dist/asset-page/script.d.ts

@@ -0,0 +1,2 @@
+/** Inline bootstrap for asset-page controls. Kept dependency-free for SSR. */
+export declare const ASSET_PAGE_SCRIPT: string;

package/dist/asset-page/script.js

@@ -0,0 +1,4 @@
+const ASSET_PAGE_SCRIPT = String.raw`(()=>{const init=()=>{document.querySelectorAll('[data-zd-asset-page]').forEach(page=>{if(page.hasAttribute('data-zd-asset-ready'))return;page.setAttribute('data-zd-asset-ready','true');const pre=page.querySelector('.zd-asset-code');page.addEventListener('click',event=>{const target=event.target;if(!(target instanceof Element))return;const button=target.closest('button');const action=target.closest('[data-zd-asset-action]')?.getAttribute('data-zd-asset-action');if(action==='copy'||action==='wrap'){const proxy=pre?.closest('.code-block-wrapper')?.querySelector('.code-btn-'+action);if(proxy instanceof HTMLElement)proxy.click();return}if(action==='copy-url'&&button){navigator.clipboard.writeText(button.dataset.zdCopyUrl||location.href);return}const section=target.closest('section');const stage=section?.querySelector('.zd-asset-stage');if(action==='fit'||action==='1to1'){stage?.classList.toggle('is-1to1',action==='1to1');section?.querySelectorAll('[data-zd-asset-action="fit"],[data-zd-asset-action="1to1"]').forEach(item=>item.setAttribute('aria-pressed',String(item===button)));return}if((action==='checker'||action==='dark')&&button){stage?.classList.toggle('is-checker',action==='checker');stage?.classList.toggle('is-dark',action==='dark');section?.querySelectorAll('[data-zd-asset-action="checker"],[data-zd-asset-action="dark"]').forEach(item=>item.setAttribute('aria-pressed',String(item===button)));return}const line=target.closest('.zd-asset-code .line');const lineOffset=line?event.clientX-line.getBoundingClientRect().left:Infinity;const gutterWidth=line?parseFloat(getComputedStyle(line,'::before').width):0;if(line&&lineOffset<gutterWidth){location.hash=line.id}});if(pre){const wait=()=>{const wrapper=pre.closest('.code-block-wrapper');if(!wrapper){requestAnimationFrame(wait);return}page.querySelectorAll('[data-zd-asset-action="copy"],[data-zd-asset-action="wrap"]').forEach(button=>button.removeAttribute('disabled'))};requestAnimationFrame(wait)}})};if(!document.__zdAssetPageInit){document.__zdAssetPageInit=init;document.addEventListener('zfb:after-swap',init)}document.__zdAssetPageInit()})();`;
+export {
+  ASSET_PAGE_SCRIPT
+};

package/dist/asset-path/index.d.ts

@@ -0,0 +1,53 @@
+/** Browser-safe canonical path and URL helpers for the asset viewer. */
+export interface DecodedAssetHref {
+    /** Normalized path relative to the configured public asset directory. */
+    path: string;
+    /** The authored fragment, including its leading `#`, when present. */
+    fragment?: string;
+}
+export interface AssetViewerHrefOptions {
+    base: string;
+    routePrefix: string;
+    path: string;
+    /** A fragment with or without its leading `#`. */
+    fragment?: string;
+}
+export interface AssetRawHrefOptions {
+    base: string;
+    dir: string;
+    path: string;
+}
+export interface AssetViewerPathSettings {
+    dir: string;
+    routePrefix: string;
+}
+/**
+ * Normalize a public asset path to NFC POSIX form.
+ *
+ * Paths are relative file paths, never URLs: empty segments, leading slashes,
+ * dot segments, backslashes and control characters are rejected.
+ */
+export declare function normalizeAssetPath(path: string): string;
+/** Encode each path segment independently, retaining POSIX `/` separators. */
+export declare function encodeAssetPathForUrl(path: string): string;
+/**
+ * Decode a root-relative authored href that points inside `/<dir>/`.
+ *
+ * Decoding happens exactly once. A literal query makes the href ineligible;
+ * `%3F` remains a valid filename character. Fragments are preserved verbatim.
+ */
+export declare function decodeAuthoredHref(href: string, options: {
+    base: string;
+    dir: string;
+}): DecodedAssetHref | null;
+/** Build the base-prefixed, trailing-slashed asset viewer route exactly once. */
+export declare function assetViewerHref(options: AssetViewerHrefOptions): string;
+/** Build the base-prefixed URL for the raw public asset. */
+export declare function assetRawHref(options: AssetRawHrefOptions): string;
+/** Validate the two relative URL/disk namespaces used by the asset viewer. */
+export declare function validateAssetViewerSettings(settings: AssetViewerPathSettings): void;
+/**
+ * Match a normalized asset path against small, whole-path glob patterns.
+ * `*` and `?` do not cross `/`; `**` does; `{a,b}` selects literal alternatives.
+ */
+export declare function matchExclude(path: string, globs: readonly string[]): boolean;