@domphy/press 0.19.0 → 0.19.2

package/dist/{build-6Q2QN246.js → build-DKE372GH.js}

@@ -277,10 +277,53 @@ function announcementBar(config) {
     ...idAttr ? { dataId: idAttr } : {}
   };
 }
-function header(config) {
+function localeSwitcher(ctx) {
+  const { config, route } = ctx;
+  if (!config.locales) return null;
+  const entries = Object.entries(config.locales);
+  if (entries.length <= 1) return null;
+  let currentKey = "/";
+  let barePath = route;
+  for (const [key] of entries) {
+    if (key !== "/" && route.startsWith(key.replace(/\/$/, ""))) {
+      currentKey = key;
+      barePath = route.slice(key.replace(/\/$/, "").length) || "/";
+      break;
+    }
+  }
+  const currentLocale = config.locales[currentKey];
+  if (!currentLocale) return null;
+  const links = entries.map(([key, locale]) => {
+    const prefix = key === "/" ? "" : key.replace(/\/$/, "");
+    const href = prefix + (barePath === "/" ? "/" : barePath);
+    return {
+      a: locale.label,
+      href,
+      class: `dp-locale-option${key === currentKey ? " active" : ""}`,
+      ...key === currentKey ? { ariaCurrent: "true" } : {},
+      lang: locale.lang
+    };
+  });
+  return {
+    div: [
+      { span: ["\u{1F310} ", currentLocale.label], class: "dp-locale-current" },
+      { div: links, class: "dp-locale-menu" }
+    ],
+    class: "dp-locale-switcher",
+    ariaLabel: "Select language"
+  };
+}
+function header(ctx) {
+  const { config } = ctx;
   const searchEnabled = config.themeConfig.search !== false;
-  const logoEl = config.themeConfig.logo ? { a: [{ img: null, src: config.themeConfig.logo, alt: config.title, class: "dp-logo-img" }], href: config.base, class: "dp-logo" } : { a: config.title, href: config.base, class: "dp-logo" };
+  const logo = config.themeConfig.logo;
+  const logoInner = logo ? typeof logo === "string" ? [{ img: null, src: logo, alt: config.title, class: "dp-logo-img" }] : [
+    { img: null, src: logo.light, alt: config.title, class: "dp-logo-img dp-logo-light" },
+    { img: null, src: logo.dark, alt: config.title, class: "dp-logo-img dp-logo-dark" }
+  ] : [];
+  const logoEl = logo ? { a: logoInner, href: config.base, class: "dp-logo" } : { a: config.title, href: config.base, class: "dp-logo" };
   const socialEls = (config.themeConfig.socialLinks ?? []).map(socialLinkEl);
+  const localeEl = localeSwitcher(ctx);
   return {
     header: [
       logoEl,
@@ -307,6 +350,7 @@ function header(config) {
             class: "dp-search-slot"
           }] : [],
           ...socialEls,
+          ...localeEl ? [localeEl] : [],
           { button: "\u25D0", type: "button", class: "dp-theme-toggle", ariaLabel: "Toggle dark mode", dataThemeToggle: "" },
           { button: "\u2630", type: "button", class: "dp-menu-toggle", ariaLabel: "Toggle menu", dataMenuToggle: "" }
         ],
@@ -377,9 +421,10 @@ function tocAside(ctx) {
   const [minLevel, maxLevel] = ctx.config.themeConfig.outline?.level ?? [2, 3];
   const entries = ctx.toc.filter((e) => e.level >= minLevel && e.level <= maxLevel);
   if (entries.length === 0) return null;
+  const tocTitle = ctx.config.themeConfig.tocTitle ?? "On this page";
   return {
     aside: [
-      { div: "On this page", class: "dp-aside-title" },
+      { div: tocTitle, class: "dp-aside-title" },
       { nav: entries.map((e) => ({ a: e.text, href: `#${e.slug}`, class: `dp-toc-${e.level}` })), class: "dp-toc" }
     ],
     class: "dp-aside"
@@ -427,25 +472,37 @@ function pageBadge(frontmatter) {
   if (!text2) return null;
   return { span: text2, class: `dp-badge dp-badge-${type} dp-page-badge` };
 }
+function resolveSlot(ctx, key, fallback) {
+  const override = ctx.config.themeConfig.slots?.[key];
+  return override ? override(ctx) : fallback(ctx);
+}
 function pageShell(ctx) {
+  const slots = ctx.config.themeConfig.slots;
+  const showSidebar = ctx.frontmatter.sidebar !== false;
   const main = [];
   const badge = pageBadge(ctx.frontmatter);
   if (badge) main.push({ div: [badge], class: "dp-page-badge-row" });
   main.push({ div: ctx.body, class: "dp-content" });
-  const pn = prevNext(ctx);
+  const pn = resolveSlot(ctx, "prevNext", prevNext);
   if (pn) main.push(pn);
-  const footer = docFooter(ctx);
-  if (footer) main.push(footer);
-  const shellChildren = [sidebar(ctx), { main, class: "dp-main" }];
-  const aside = tocAside(ctx);
-  if (aside) shellChildren.push(aside);
+  const docFooterEl = resolveSlot(ctx, "docFooter", docFooter);
+  if (docFooterEl) main.push(docFooterEl);
+  const sidebarEl = showSidebar ? resolveSlot(ctx, "sidebar", sidebar) : null;
+  const shellChildren = [
+    ...sidebarEl ? [sidebarEl] : [],
+    { main, class: `dp-main${showSidebar ? "" : " dp-main-full"}` }
+  ];
+  const asideEl = resolveSlot(ctx, "aside", tocAside);
+  if (asideEl && showSidebar) shellChildren.push(asideEl);
+  const headerEl = resolveSlot(ctx, "header", header);
   const bar = announcementBar(ctx.config);
+  const footerContent = slots?.footer ? slots.footer(ctx) : { footer: ctx.config.themeConfig.footerMessage ?? "", class: "dp-footer" };
   return {
     div: [
       ...bar ? [bar] : [],
-      header(ctx.config),
+      ...headerEl ? [headerEl] : [],
       { div: shellChildren, class: "dp-shell" },
-      { footer: ctx.config.themeConfig.footerMessage ?? "", class: "dp-footer" }
+      ...footerContent ? [footerContent] : []
     ]
   };
 }
@@ -483,7 +540,7 @@ function homeShell(ctx) {
   return {
     div: [
       ...bar ? [bar] : [],
-      header(ctx.config),
+      header(ctx),
       { main, class: "dp-main dp-main-home" },
       { footer: ctx.config.themeConfig.footerMessage ?? "", class: "dp-footer" }
     ]
@@ -669,6 +726,47 @@ function shapeContainers(tokens) {
       output.push(token);
       continue;
     }
+    if (token.type === "container_card-grid_open") {
+      token.tag = "div";
+      token.attrSet("class", "custom-block card-grid");
+      output.push(token);
+      continue;
+    }
+    if (token.type === "container_card-grid_close") {
+      token.tag = "div";
+      output.push(token);
+      continue;
+    }
+    if (token.type === "container_card_open") {
+      token.tag = "div";
+      token.attrSet("class", "custom-block card");
+      const title = containerTitle(token.info.trim(), "card");
+      output.push(token);
+      if (title) output.push(...buildTitleTokens(Token, "p", "paragraph_open", "paragraph_close", "card-title", title));
+      continue;
+    }
+    if (token.type === "container_card_close") {
+      token.tag = "div";
+      output.push(token);
+      continue;
+    }
+    if (token.type === "container_link-card_open") {
+      const info = token.info.trim().slice("link-card".length).trim();
+      const linkMatch = info.match(/^\[([^\]]+)\]\(([^)]+)\)/);
+      const href = linkMatch ? linkMatch[2] : "#";
+      const title = linkMatch ? linkMatch[1] : info;
+      token.tag = "a";
+      token.attrSet("class", "custom-block link-card");
+      token.attrSet("href", href);
+      output.push(token);
+      if (title) output.push(...buildTitleTokens(Token, "p", "paragraph_open", "paragraph_close", "link-card-title", title));
+      continue;
+    }
+    if (token.type === "container_link-card_close") {
+      token.tag = "a";
+      output.push(token);
+      continue;
+    }
     if (token.type === "container_code-group_open") {
       let depth = 0, closeIndex = -1;
       for (let j = i; j < tokens.length; j++) {
@@ -726,7 +824,7 @@ function createParser(docsDir, highlight) {
   md.use(emojiPlugin);
   const noopRender = () => "";
   const ADMONITION_NAMES = Object.keys(ADMONITION_TITLES);
-  for (const name of [...ADMONITION_NAMES, "details", "code-group", "steps"]) {
+  for (const name of [...ADMONITION_NAMES, "details", "code-group", "steps", "card", "card-grid", "link-card"]) {
     md.use(container, name, { render: noopRender });
   }
   md.core.ruler.push("press_containers", (state) => {
@@ -915,6 +1013,21 @@ a:hover{text-decoration:underline}
 .dp-theme-toggle,.dp-menu-toggle{border:1px solid ${border};background:${bgSoft};color:${text};border-radius:${ts(2)};width:${ts(8.5)};height:${ts(8.5)};cursor:pointer;font-size:16px}
 .dp-menu-toggle{display:none}
 
+/* --------------------------------------------------------- locale switcher */
+.dp-locale-switcher{position:relative;display:flex;align-items:center}
+.dp-locale-current{color:${textSoft};font-size:13px;font-weight:500;cursor:pointer;user-select:none;padding:${ts(1)} ${ts(2)};border:1px solid ${border};border-radius:${ts(1.5)};background:${bgSoft};white-space:nowrap;display:flex;align-items:center;gap:${ts(1)}}
+.dp-locale-current::after{content:" \u25BE";font-size:10px;opacity:.6}
+.dp-locale-menu{display:none;position:absolute;top:calc(100% + ${ts(2)});right:0;background:${bgSoft};border:1px solid ${border};border-radius:${ts(2)};padding:${ts(1.5)};min-width:${ts(32)};z-index:200;flex-direction:column;gap:${ts(0.5)};box-shadow:0 4px 16px rgba(0,0,0,.1)}
+.dp-locale-switcher:hover .dp-locale-menu,.dp-locale-switcher:focus-within .dp-locale-menu{display:flex}
+.dp-locale-option{display:block;padding:${ts(1.25)} ${ts(2.5)};border-radius:${ts(1.25)};font-size:13px;color:${textSoft}}
+.dp-locale-option:hover{background:${bgMute};color:${text};text-decoration:none}
+.dp-locale-option.active{color:${brand};font-weight:600}
+
+/* -------------------------------------------------- logo light/dark variant */
+[data-theme="dark"] .dp-logo-light{display:none}
+[data-theme="light"] .dp-logo-dark,.dp-logo-dark{display:none}
+[data-theme="dark"] .dp-logo-dark{display:block}
+
 /* ------------------------------------------------------------ social links */
 .dp-social-link{display:inline-flex;align-items:center;justify-content:center;width:${ts(8.5)};height:${ts(8.5)};border-radius:${ts(2)};color:${textSoft};background:${bgSoft};border:1px solid ${border};font-size:10px;font-weight:700;flex-shrink:0}
 .dp-social-link:hover{color:${text};border-color:${textSoft};text-decoration:none}
@@ -938,6 +1051,7 @@ a:hover{text-decoration:underline}
 .dp-sidebar a[aria-current="page"]{color:${brand};font-weight:600;background:${bgSoft}}
 .dp-sidebar-link-with-badge{display:flex;align-items:center}
 .dp-main{padding:${ts(8)} ${ts(12)} ${ts(20)};min-width:0}
+.dp-main-full{grid-column:1 / -1;max-width:${contentMax};margin:0 auto}
 .dp-content{max-width:${contentMax}}
 .dp-aside{position:sticky;top:${headerH};max-height:calc(100vh - ${headerH});overflow-y:auto;padding:${ts(8)} ${ts(6)};font-size:13px}
 .dp-aside-title{font-weight:700;margin-bottom:${ts(2)};color:${text}}
@@ -947,6 +1061,15 @@ a:hover{text-decoration:underline}
 .dp-toc-3{padding-left:${ts(3)}}
 .dp-toc-4{padding-left:${ts(6)}}
 
+/* -------------------------------------------------- card / link-card / card-grid */
+.custom-block.card{background:${bgSoft};border:1px solid ${border};border-radius:${ts(3)};padding:${ts(5)} ${ts(6)};margin:${ts(3)} 0}
+.custom-block.card .card-title{font-size:16px;font-weight:600;color:${textStrong};margin:0 0 ${ts(2)}}
+.custom-block.card-grid{display:grid;grid-template-columns:repeat(auto-fill,minmax(${ts(56)},1fr));gap:${ts(4)};margin:${ts(4)} 0}
+a.custom-block.link-card{display:block;background:${bgSoft};border:1px solid ${border};border-radius:${ts(3)};padding:${ts(5)} ${ts(6)};margin:${ts(3)} 0;transition:border-color .15s,background .15s;text-decoration:none;color:${text}}
+a.custom-block.link-card:hover{border-color:${brand};background:${bgMute};text-decoration:none}
+a.custom-block.link-card .link-card-title{font-size:16px;font-weight:600;color:${brand};margin:0 0 ${ts(2)}}
+.custom-block.card-grid .custom-block.card,.custom-block.card-grid a.custom-block.link-card{margin:0}
+
 /* ------------------------------------------------------------------ badges */
 .dp-badge{display:inline-block;padding:${ts(0.5)} ${ts(1.75)};border-radius:${ts(2.5)};font-size:11px;font-weight:700;line-height:1.4;white-space:nowrap;vertical-align:middle}
 .dp-badge-tip{background:color-mix(in srgb,${brand} 12%,${bg});color:${brand}}
@@ -1281,6 +1404,10 @@ async function buildSite(options) {
   for (const page of localePages) {
     const source = readFileSync2(page.filePath, "utf8");
     const doc = await renderDoc(source, { filePath: page.filePath, docsDir: srcDir, repoRoot: srcDir, highlight });
+    if (doc.frontmatter.draft === true) {
+      console.log(`  \u21B7 ${page.route} (draft, skipped)`);
+      continue;
+    }
     sanitizeStyles(doc.body);
     const textParts = [];
     flattenText(doc.body, textParts);

package/dist/cli.js

@@ -25,7 +25,7 @@ if (command === "build") {
   const srcDir = resolve(process.cwd(), flag("--src") ?? config.srcDir ?? ".");
   const outDir = resolve(process.cwd(), flag("--out") ?? config.outDir ?? "dist");
   const publicDir = resolve(process.cwd(), "public");
-  const { buildSite } = await import("./build-6Q2QN246.js");
+  const { buildSite } = await import("./build-DKE372GH.js");
   await buildSite({
     config: { ...config, srcDir: config.srcDir ?? ".", outDir: config.outDir ?? "dist" },
     srcDir,
@@ -39,7 +39,7 @@ if (command === "build") {
   const srcDir = resolve(process.cwd(), flag("--src") ?? config.srcDir ?? ".");
   const outDir = resolve(process.cwd(), flag("--out") ?? config.outDir ?? ".press-dev");
   const publicDir = resolve(process.cwd(), "public");
-  const { buildSite } = await import("./build-6Q2QN246.js");
+  const { buildSite } = await import("./build-DKE372GH.js");
   const { startDevServer } = await import("./serve-LQBYPP6C.js");
   async function rebuild() {
     const start = Date.now();

package/dist/index.d.ts

@@ -33,11 +33,31 @@ interface EditLink {
     pattern: string;
     text?: string;
 }
+/** Override built-in layout slots. Each function receives the full LayoutContext
+ *  and must return a DomphyElement (or null to omit the slot entirely). */
+interface LayoutSlots {
+    /** Replace the entire header bar. */
+    header?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the sidebar navigation. */
+    sidebar?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the TOC aside panel. */
+    aside?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the prev/next pagination row. */
+    prevNext?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the doc footer (edit link + last updated). */
+    docFooter?: (ctx: unknown) => DomphyElement | null;
+    /** Replace the page footer bar. */
+    footer?: (ctx: unknown) => DomphyElement | null;
+}
 interface ThemeConfig {
     nav: NavItem[];
     /** Keys are route prefixes (e.g. "/guide/"). Longest match wins. */
     sidebar: Record<string, SidebarItem[]>;
-    logo?: string;
+    /** Single URL or separate light/dark variants. */
+    logo?: string | {
+        light: string;
+        dark: string;
+    };
     search?: false | {
         placeholder?: string;
         limit?: number;
@@ -49,6 +69,8 @@ interface ThemeConfig {
     outline?: {
         level: [number, number];
     };
+    /** TOC section heading text. Default "On this page". */
+    tocTitle?: string;
     /** Enable mermaid diagrams. Pass { cdn } to override CDN URL. */
     mermaid?: boolean | {
         cdn?: string;
@@ -59,6 +81,8 @@ interface ThemeConfig {
         text: string;
         dismissible?: boolean;
     };
+    /** Override individual layout slots with custom components. */
+    slots?: LayoutSlots;
 }
 interface LocaleConfig {
     label: string;