@blackwork/docs 0.4.2 → 0.5.0

package/README.md

@@ -204,6 +204,61 @@ export const docsConfig = defineDocsConfig({
 })
 ```
 
+Home content and shared shell labels accept either one string or a locale map:
+
+```ts
+export const docsConfig = defineDocsConfig({
+  home: {
+    badge: {
+      alt: {
+        en: 'Latest package version',
+        zh: '最新包版本',
+      },
+      href: 'https://www.npmjs.com/package/example',
+      src: 'https://img.shields.io/npm/v/example?label=npm',
+    },
+    description: {
+      en: 'Documentation for the project.',
+      zh: '项目文档。',
+    },
+    primaryAction: {
+      href: '/guide/getting-started',
+      label: { en: 'Getting Started', zh: '快速开始' },
+    },
+  },
+  theme: {
+    socialLinks: [
+      {
+        type: 'github',
+        link: 'https://github.com/example/project',
+        label: 'GitHub',
+        ariaLabel: {
+          en: 'Source code on GitHub',
+          zh: '在 GitHub 查看源码',
+        },
+      },
+    ],
+    labels: {
+      next: { en: 'Next', zh: '下一页' },
+      previous: { en: 'Previous', zh: '上一页' },
+      scrollToTop: { en: 'Scroll to top', zh: '回到顶部' },
+    },
+    toc: {
+      title: { en: 'On This Page', zh: '本页内容' },
+    },
+  },
+})
+```
+
+The home badge can be localized text or a badge image with localized alt text
+and an optional link. Internal home action and highlight links are localized to
+the matching document route automatically. Add every configured locale to each
+text map so the shell does not need to fall back to English.
+
+`theme.socialLinks` controls the shared header social icons. The default theme
+renders these links before the language and theme controls, with the same
+separator and spacing used by the shared `LayoutHeader` component.
+
 ## Next.js Entry Files
 
 `next.config.ts`
@@ -303,31 +358,6 @@ export default function DocsRoutePage({
 
 ## Tailwind Setup
 
-### Tailwind CSS v3
-
-If your app uses Tailwind CSS, include both `blackwork` and `@blackwork/docs` build output in the content scan:
-
-```ts
-import typography from '@tailwindcss/typography'
-import { theme } from 'blackwork/tailwind-config'
-import animate from 'tailwindcss-animate'
-import type { Config } from 'tailwindcss'
-
-export default {
-  darkMode: 'selector',
-  content: [
-    './src/**/*.{js,mjs,cjs,ts,jsx,tsx,mdx}',
-    './contents/**/*.{md,mdx}',
-    './node_modules/blackwork/dist/**/*.{js,mjs,cjs}',
-    './node_modules/@blackwork/docs/dist/**/*.{js,mjs,cjs}',
-  ],
-  theme,
-  plugins: [typography, animate],
-} satisfies Config
-```
-
-### Tailwind CSS v4
-
 Import the Blackwork and docs package Tailwind entries explicitly:
 
 ```css

package/dist/_virtual/_rolldown/runtime.cjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/config/defaults.cjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/config/defaults.mjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/config/define-config.cjs

@@ -1,9 +1,9 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com
  * license: MIT
  */
-const e=require(`./defaults.cjs`),t=(e={})=>{let t=e.layout??`docs`;return{layout:t,sidebar:e.sidebar??(t===`content`?!1:`auto`)}},n=e=>{if(e)return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,t(n)]))};function r(t={}){return{root:t.root??e.defaultDocsConfig.content.root,enableDefaultLocaleRedirect:t.enableDefaultLocaleRedirect??e.defaultDocsConfig.content.enableDefaultLocaleRedirect,...t.defaultLocale===void 0?{}:{defaultLocale:t.defaultLocale},...t.locales===void 0?{}:{locales:t.locales},...t.sections===void 0?{}:{sections:n(t.sections)}}}function i(t={}){return{site:{...e.defaultDocsConfig.site,...t.site},content:r(t.content),theme:{...e.defaultDocsConfig.theme,...t.theme},docs:{...e.defaultDocsConfig.docs,...t.docs},home:{...e.defaultDocsConfig.home,...t.home},mdx:{...e.defaultDocsConfig.mdx,...t.mdx},slots:{...e.defaultDocsConfig.slots,...t.slots}}}exports.defineConfig=i;
+const e=require(`./defaults.cjs`),t=(e={})=>{let t=e.layout??`docs`;return{layout:t,sidebar:e.sidebar??(t===`content`?!1:`auto`),...e.label===void 0?{}:{label:e.label}}},n=e=>{if(e)return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,t(n)]))};function r(t={}){return{root:t.root??e.defaultDocsConfig.content.root,enableDefaultLocaleRedirect:t.enableDefaultLocaleRedirect??e.defaultDocsConfig.content.enableDefaultLocaleRedirect,...t.defaultLocale===void 0?{}:{defaultLocale:t.defaultLocale},...t.locales===void 0?{}:{locales:t.locales},...t.sections===void 0?{}:{sections:n(t.sections)}}}function i(t={}){return{site:{...e.defaultDocsConfig.site,...t.site},content:r(t.content),theme:{...e.defaultDocsConfig.theme,...t.theme},docs:{...e.defaultDocsConfig.docs,...t.docs},home:{...e.defaultDocsConfig.home,...t.home},mdx:{...e.defaultDocsConfig.mdx,...t.mdx},slots:{...e.defaultDocsConfig.slots,...t.slots}}}exports.defineConfig=i;

package/dist/config/define-config.mjs

@@ -1,9 +1,9 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com
  * license: MIT
  */
-import{defaultDocsConfig as e}from"./defaults.mjs";const t=(e={})=>{let t=e.layout??`docs`;return{layout:t,sidebar:e.sidebar??(t===`content`?!1:`auto`)}},n=e=>{if(e)return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,t(n)]))};function r(t={}){return{root:t.root??e.content.root,enableDefaultLocaleRedirect:t.enableDefaultLocaleRedirect??e.content.enableDefaultLocaleRedirect,...t.defaultLocale===void 0?{}:{defaultLocale:t.defaultLocale},...t.locales===void 0?{}:{locales:t.locales},...t.sections===void 0?{}:{sections:n(t.sections)}}}function i(t={}){return{site:{...e.site,...t.site},content:r(t.content),theme:{...e.theme,...t.theme},docs:{...e.docs,...t.docs},home:{...e.home,...t.home},mdx:{...e.mdx,...t.mdx},slots:{...e.slots,...t.slots}}}export{i as defineConfig};
+import{defaultDocsConfig as e}from"./defaults.mjs";const t=(e={})=>{let t=e.layout??`docs`;return{layout:t,sidebar:e.sidebar??(t===`content`?!1:`auto`),...e.label===void 0?{}:{label:e.label}}},n=e=>{if(e)return Object.fromEntries(Object.entries(e).map(([e,n])=>[e,t(n)]))};function r(t={}){return{root:t.root??e.content.root,enableDefaultLocaleRedirect:t.enableDefaultLocaleRedirect??e.content.enableDefaultLocaleRedirect,...t.defaultLocale===void 0?{}:{defaultLocale:t.defaultLocale},...t.locales===void 0?{}:{locales:t.locales},...t.sections===void 0?{}:{sections:n(t.sections)}}}function i(t={}){return{site:{...e.site,...t.site},content:r(t.content),theme:{...e.theme,...t.theme},docs:{...e.docs,...t.docs},home:{...e.home,...t.home},mdx:{...e.mdx,...t.mdx},slots:{...e.slots,...t.slots}}}export{i as defineConfig};

package/dist/config/define-docs-config.cjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/config/define-docs-config.mjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/config/load-content-config.cjs

@@ -1,9 +1,9 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com
  * license: MIT
  */
-const e=require(`../_virtual/_rolldown/runtime.cjs`);let t=require(`node:fs`),n=require(`node:path`),r=require(`jiti`);r=e.__toESM(r,1);const i=`content.config.ts`,a=e=>typeof e==`object`&&!!e&&!Array.isArray(e),o=({rootDir:e=process.cwd(),contentConfigPath:r=i}={})=>{let a=(0,n.resolve)(e,r);return(0,t.existsSync)(a)?a:void 0},s=({rootDir:e=process.cwd(),contentConfigPath:t=i}={})=>{let n=o({rootDir:e,contentConfigPath:t});if(!n)return;let s=(0,r.default)(require(`url`).pathToFileURL(__filename).href)(n),c=s?.docsContentConfig??s?.default;if(!a(c))throw TypeError(`[blackwork-docs] ${n} must export a docs content config object via "docsContentConfig" or default export.`);return c};exports.loadDocsContentConfig=s,exports.resolveDocsContentConfigPath=o;
+const e=require(`../_virtual/_rolldown/runtime.cjs`);let t=require(`node:fs`),n=require(`node:path`),r=require(`jiti`);r=e.__toESM(r,1);const i=`content.config.ts`,a=e=>typeof e==`object`&&!!e&&!Array.isArray(e),o=({rootDir:e=process.cwd(),contentConfigPath:r=i}={})=>{let a=(0,n.resolve)(e,r);return(0,t.existsSync)(a)?a:void 0},s=({rootDir:e=process.cwd(),contentConfigPath:t=i}={})=>{let n=o({rootDir:e,contentConfigPath:t});if(!n)return;let s=(0,r.default)(require(`url`).pathToFileURL(__filename).href,{requireCache:!1})(n),c=s?.docsContentConfig??s?.default;if(!a(c))throw TypeError(`[blackwork-docs] ${n} must export a docs content config object via "docsContentConfig" or default export.`);return c};exports.loadDocsContentConfig=s,exports.resolveDocsContentConfigPath=o;

package/dist/config/load-content-config.mjs

@@ -1,9 +1,9 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com
  * license: MIT
  */
-import{existsSync as e}from"node:fs";import{resolve as t}from"node:path";import n from"jiti";const r=`content.config.ts`,i=e=>typeof e==`object`&&!!e&&!Array.isArray(e),a=({rootDir:n=process.cwd(),contentConfigPath:i=r}={})=>{let a=t(n,i);return e(a)?a:void 0},o=({rootDir:e=process.cwd(),contentConfigPath:t=r}={})=>{let o=a({rootDir:e,contentConfigPath:t});if(!o)return;let s=n(import.meta.url)(o),c=s?.docsContentConfig??s?.default;if(!i(c))throw TypeError(`[blackwork-docs] ${o} must export a docs content config object via "docsContentConfig" or default export.`);return c};export{o as loadDocsContentConfig,a as resolveDocsContentConfigPath};
+import{existsSync as e}from"node:fs";import{resolve as t}from"node:path";import n from"jiti";const r=`content.config.ts`,i=e=>typeof e==`object`&&!!e&&!Array.isArray(e),a=({rootDir:n=process.cwd(),contentConfigPath:i=r}={})=>{let a=t(n,i);return e(a)?a:void 0},o=({rootDir:e=process.cwd(),contentConfigPath:t=r}={})=>{let o=a({rootDir:e,contentConfigPath:t});if(!o)return;let s=n(import.meta.url,{requireCache:!1})(o),c=s?.docsContentConfig??s?.default;if(!i(c))throw TypeError(`[blackwork-docs] ${o} must export a docs content config object via "docsContentConfig" or default export.`);return c};export{o as loadDocsContentConfig,a as resolveDocsContentConfigPath};

package/dist/config/types.d.mts

@@ -1,5 +1,6 @@
 
-import { DocsHomeConfig as DocsHomeConfig$1, DocsSlotsConfig as DocsSlotsConfig$1 } from "../theme/types.mjs";
+import { DocsHomeConfig as DocsHomeConfig$1, DocsSlotsConfig as DocsSlotsConfig$1, DocsThemeLocalizedText } from "../theme/types.mjs";
+import { SocialLinkIconType } from "blackwork";
 import { ComponentMap } from "@blackwork/machine";
 
 //#region src/config/types.d.ts
@@ -27,9 +28,15 @@ interface DocsSidebarGroupConfig {
 }
 type DocsSidebarConfigNode = DocsSidebarGroupConfig | DocsSidebarItemConfig;
 type DocsSidebarMode = 'auto' | false | DocsSidebarConfigNode[];
+interface DocsThemeNavItemConfig {
+  href: string;
+  label?: DocsSidebarLabel;
+}
+type DocsThemeNavConfig = DocsThemeNavItemConfig[] | false;
 interface DocsContentSectionConfig {
   layout?: DocsSectionLayout;
   sidebar?: DocsSidebarMode;
+  label?: DocsSidebarLabel;
 }
 interface DocsContentConfig {
   root?: string;
@@ -38,15 +45,37 @@ interface DocsContentConfig {
   locales?: Record<string, DocsLocaleDefinition>;
   sections?: Record<string, DocsContentSectionConfig>;
 }
-type DocsThemeLocalizedLabel = string | Record<string, string>;
+type DocsThemeLocalizedLabel = DocsThemeLocalizedText;
+interface DocsThemeLabelsConfig {
+  changeLanguage?: DocsThemeLocalizedLabel;
+  documentationPages?: DocsThemeLocalizedLabel;
+  documentPager?: DocsThemeLocalizedLabel;
+  next?: DocsThemeLocalizedLabel;
+  openSectionNavigation?: DocsThemeLocalizedLabel;
+  openSiteNavigation?: DocsThemeLocalizedLabel;
+  previous?: DocsThemeLocalizedLabel;
+  primaryNavigation?: DocsThemeLocalizedLabel;
+  scrollToTop?: DocsThemeLocalizedLabel;
+  sections?: DocsThemeLocalizedLabel;
+  toggleTheme?: DocsThemeLocalizedLabel;
+}
 interface DocsThemeTocConfig {
   collapseLabel?: DocsThemeLocalizedLabel;
   expandLabel?: DocsThemeLocalizedLabel;
   openLabel?: DocsThemeLocalizedLabel;
   title?: DocsThemeLocalizedLabel;
 }
+interface DocsThemeSocialLinkConfig {
+  type: SocialLinkIconType;
+  link: string;
+  label?: DocsThemeLocalizedLabel;
+  ariaLabel?: DocsThemeLocalizedLabel;
+}
 interface DocsThemeConfig {
   [key: string]: unknown;
+  labels?: DocsThemeLabelsConfig;
+  nav?: DocsThemeNavConfig;
+  socialLinks?: DocsThemeSocialLinkConfig[] | false;
   toc?: DocsThemeTocConfig;
 }
 type DocsSectionConfig = Record<string, unknown>;
@@ -74,6 +103,7 @@ interface NormalizedDocsContentConfig {
 interface NormalizedDocsContentSectionConfig {
   layout: DocsSectionLayout;
   sidebar: DocsSidebarMode;
+  label?: DocsSidebarLabel;
 }
 interface NormalizedDocsConfig {
   site: DocsSiteConfig;
@@ -85,4 +115,4 @@ interface NormalizedDocsConfig {
   slots: DocsSlotsConfig;
 }
 //#endregion
-export { DocsConfig, DocsContentConfig, DocsContentSectionConfig, DocsHomeConfig, DocsLocaleDefinition, DocsMdxConfig, DocsSectionConfig, DocsSectionLayout, DocsSidebarConfigNode, DocsSidebarGroupConfig, DocsSidebarItemConfig, DocsSidebarLabel, DocsSidebarMode, DocsSiteConfig, DocsSlotsConfig, DocsThemeConfig, NormalizedDocsConfig, NormalizedDocsContentConfig, NormalizedDocsContentSectionConfig };
+export { DocsConfig, DocsContentConfig, DocsContentSectionConfig, DocsHomeConfig, DocsLocaleDefinition, DocsMdxConfig, DocsSectionConfig, DocsSectionLayout, DocsSidebarConfigNode, DocsSidebarGroupConfig, DocsSidebarItemConfig, DocsSidebarLabel, DocsSidebarMode, DocsSiteConfig, DocsSlotsConfig, DocsThemeConfig, DocsThemeNavConfig, DocsThemeNavItemConfig, NormalizedDocsConfig, NormalizedDocsContentConfig, NormalizedDocsContentSectionConfig };

package/dist/config/types.d.ts

@@ -1,6 +1,7 @@
 
-import { DocsHomeConfig as DocsHomeConfig$1, DocsSlotsConfig as DocsSlotsConfig$1 } from "../theme/types.js";
+import { DocsHomeConfig as DocsHomeConfig$1, DocsSlotsConfig as DocsSlotsConfig$1, DocsThemeLocalizedText } from "../theme/types.js";
 import { ComponentMap } from "@blackwork/machine";
+import { SocialLinkIconType } from "blackwork";
 
 //#region src/config/types.d.ts
 interface DocsLocaleDefinition {
@@ -27,9 +28,15 @@ interface DocsSidebarGroupConfig {
 }
 type DocsSidebarConfigNode = DocsSidebarGroupConfig | DocsSidebarItemConfig;
 type DocsSidebarMode = 'auto' | false | DocsSidebarConfigNode[];
+interface DocsThemeNavItemConfig {
+  href: string;
+  label?: DocsSidebarLabel;
+}
+type DocsThemeNavConfig = DocsThemeNavItemConfig[] | false;
 interface DocsContentSectionConfig {
   layout?: DocsSectionLayout;
   sidebar?: DocsSidebarMode;
+  label?: DocsSidebarLabel;
 }
 interface DocsContentConfig {
   root?: string;
@@ -38,15 +45,37 @@ interface DocsContentConfig {
   locales?: Record<string, DocsLocaleDefinition>;
   sections?: Record<string, DocsContentSectionConfig>;
 }
-type DocsThemeLocalizedLabel = string | Record<string, string>;
+type DocsThemeLocalizedLabel = DocsThemeLocalizedText;
+interface DocsThemeLabelsConfig {
+  changeLanguage?: DocsThemeLocalizedLabel;
+  documentationPages?: DocsThemeLocalizedLabel;
+  documentPager?: DocsThemeLocalizedLabel;
+  next?: DocsThemeLocalizedLabel;
+  openSectionNavigation?: DocsThemeLocalizedLabel;
+  openSiteNavigation?: DocsThemeLocalizedLabel;
+  previous?: DocsThemeLocalizedLabel;
+  primaryNavigation?: DocsThemeLocalizedLabel;
+  scrollToTop?: DocsThemeLocalizedLabel;
+  sections?: DocsThemeLocalizedLabel;
+  toggleTheme?: DocsThemeLocalizedLabel;
+}
 interface DocsThemeTocConfig {
   collapseLabel?: DocsThemeLocalizedLabel;
   expandLabel?: DocsThemeLocalizedLabel;
   openLabel?: DocsThemeLocalizedLabel;
   title?: DocsThemeLocalizedLabel;
 }
+interface DocsThemeSocialLinkConfig {
+  type: SocialLinkIconType;
+  link: string;
+  label?: DocsThemeLocalizedLabel;
+  ariaLabel?: DocsThemeLocalizedLabel;
+}
 interface DocsThemeConfig {
   [key: string]: unknown;
+  labels?: DocsThemeLabelsConfig;
+  nav?: DocsThemeNavConfig;
+  socialLinks?: DocsThemeSocialLinkConfig[] | false;
   toc?: DocsThemeTocConfig;
 }
 type DocsSectionConfig = Record<string, unknown>;
@@ -74,6 +103,7 @@ interface NormalizedDocsContentConfig {
 interface NormalizedDocsContentSectionConfig {
   layout: DocsSectionLayout;
   sidebar: DocsSidebarMode;
+  label?: DocsSidebarLabel;
 }
 interface NormalizedDocsConfig {
   site: DocsSiteConfig;
@@ -85,4 +115,4 @@ interface NormalizedDocsConfig {
   slots: DocsSlotsConfig;
 }
 //#endregion
-export { DocsConfig, DocsContentConfig, DocsContentSectionConfig, DocsHomeConfig, DocsLocaleDefinition, DocsMdxConfig, DocsSectionConfig, DocsSectionLayout, DocsSidebarConfigNode, DocsSidebarGroupConfig, DocsSidebarItemConfig, DocsSidebarLabel, DocsSidebarMode, DocsSiteConfig, DocsSlotsConfig, DocsThemeConfig, NormalizedDocsConfig, NormalizedDocsContentConfig, NormalizedDocsContentSectionConfig };
+export { DocsConfig, DocsContentConfig, DocsContentSectionConfig, DocsHomeConfig, DocsLocaleDefinition, DocsMdxConfig, DocsSectionConfig, DocsSectionLayout, DocsSidebarConfigNode, DocsSidebarGroupConfig, DocsSidebarItemConfig, DocsSidebarLabel, DocsSidebarMode, DocsSiteConfig, DocsSlotsConfig, DocsThemeConfig, DocsThemeNavConfig, DocsThemeNavItemConfig, NormalizedDocsConfig, NormalizedDocsContentConfig, NormalizedDocsContentSectionConfig };

package/dist/export/process-exported-docs.cjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/export/process-exported-docs.mjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/index.cjs

@@ -1,9 +1,9 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com
  * license: MIT
  */
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./config/define-config.cjs`),t=require(`./config/define-docs-config.cjs`),n=require(`./export/process-exported-docs.cjs`),r=require(`./navigation/build-locale-links.cjs`),i=require(`./metadata/create-doc-metadata.cjs`),a=require(`./navigation/build-pager.cjs`),o=require(`./navigation/build-sidebar.cjs`),s=require(`./next/root-layout.cjs`),c=require(`./routing/build-static-params.cjs`),l=require(`./routing/resolve-docs-route.cjs`),u=require(`./source/create-docs-source.cjs`),d=async(e={})=>(await Promise.resolve().then(()=>require(`./next/metadata.cjs`))).generateMetadata(e),f=async(e={})=>(await Promise.resolve().then(()=>require(`./next/page.cjs`))).generateStaticParams(e),p=async e=>(await Promise.resolve().then(()=>require(`./next/page.cjs`))).DocsPage(e);exports.DocsPage=p,exports.DocsRootLayout=s.DocsRootLayout,exports.buildDocsStaticParams=c.buildDocsStaticParams,exports.buildLocaleLinks=r.buildLocaleLinks,exports.buildPager=a.buildPager,exports.buildSidebar=o.buildSidebar,exports.createDocMetadata=i.createDocMetadata,exports.createDocsSource=u.createDocsSource,exports.defineConfig=e.defineConfig,exports.defineDocsConfig=t.defineDocsConfig,exports.dynamicParams=!1,exports.generateMetadata=d,exports.generateStaticParams=f,exports.processExportedDocs=n.processExportedDocs,exports.resolveDocsRoute=l.resolveDocsRoute;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const e=require(`./config/define-config.cjs`),t=require(`./config/define-docs-config.cjs`),n=require(`./export/process-exported-docs.cjs`),r=require(`./navigation/build-locale-links.cjs`),i=require(`./metadata/create-doc-metadata.cjs`),a=require(`./navigation/build-header-nav.cjs`),o=require(`./navigation/build-pager.cjs`),s=require(`./navigation/build-sidebar.cjs`),c=require(`./next/root-layout.cjs`),l=require(`./routing/build-static-params.cjs`),u=require(`./routing/resolve-docs-route.cjs`),d=require(`./source/create-docs-source.cjs`),f=async(e={})=>(await Promise.resolve().then(()=>require(`./next/metadata.cjs`))).generateMetadata(e),p=async(e={})=>(await Promise.resolve().then(()=>require(`./next/page.cjs`))).generateStaticParams(e),m=async e=>(await Promise.resolve().then(()=>require(`./next/page.cjs`))).DocsPage(e);exports.DocsPage=m,exports.DocsRootLayout=c.DocsRootLayout,exports.buildDocsStaticParams=l.buildDocsStaticParams,exports.buildHeaderNavigation=a.buildHeaderNavigation,exports.buildLocaleLinks=r.buildLocaleLinks,exports.buildPager=o.buildPager,exports.buildSidebar=s.buildSidebar,exports.createDocMetadata=i.createDocMetadata,exports.createDocsSource=d.createDocsSource,exports.defineConfig=e.defineConfig,exports.defineDocsConfig=t.defineDocsConfig,exports.dynamicParams=!1,exports.generateMetadata=f,exports.generateStaticParams=p,exports.processExportedDocs=n.processExportedDocs,exports.resolveDocsRoute=u.resolveDocsRoute;

package/dist/index.d.mts

@@ -1,10 +1,11 @@
 
 import { CreateDocsSourceOptions, DocEntry, DocFormat, DocsSource } from "./source/types.mjs";
-import { DocsConfig, DocsContentConfig, DocsContentSectionConfig, DocsHomeConfig, DocsLocaleDefinition, DocsMdxConfig, DocsSectionConfig, DocsSectionLayout, DocsSidebarConfigNode, DocsSidebarGroupConfig, DocsSidebarItemConfig, DocsSidebarLabel, DocsSidebarMode, DocsSiteConfig, DocsSlotsConfig, DocsThemeConfig, NormalizedDocsConfig, NormalizedDocsContentConfig, NormalizedDocsContentSectionConfig } from "./config/types.mjs";
+import { DocsConfig, DocsContentConfig, DocsContentSectionConfig, DocsHomeConfig, DocsLocaleDefinition, DocsMdxConfig, DocsSectionConfig, DocsSectionLayout, DocsSidebarConfigNode, DocsSidebarGroupConfig, DocsSidebarItemConfig, DocsSidebarLabel, DocsSidebarMode, DocsSiteConfig, DocsSlotsConfig, DocsThemeConfig, DocsThemeNavConfig, DocsThemeNavItemConfig, NormalizedDocsConfig, NormalizedDocsContentConfig, NormalizedDocsContentSectionConfig } from "./config/types.mjs";
 import { defineConfig } from "./config/define-config.mjs";
 import { DefineDocsConfigOptions, defineDocsConfig } from "./config/define-docs-config.mjs";
 import { ProcessExportedDocsOptions, processExportedDocs } from "./export/process-exported-docs.mjs";
 import { CreateDocMetadataOptions, DocsMetadata, DocsMetadataAlternates, DocsMetadataRobots, createDocMetadata } from "./metadata/create-doc-metadata.mjs";
+import { BuildHeaderNavOptions, buildHeaderNavigation } from "./navigation/build-header-nav.mjs";
 import { BuildLocaleLinksOptions, DocsLocaleLink, buildLocaleLinks } from "./navigation/build-locale-links.mjs";
 import { BuildPagerOptions, DocsPager, DocsPagerLink, buildPager } from "./navigation/build-pager.mjs";
 import { BuildSidebarOptions, DocsSidebarItem, buildSidebar } from "./navigation/build-sidebar.mjs";
@@ -22,4 +23,4 @@ declare const generateMetadata: (options?: GenerateMetadataOptions) => Promise<D
 declare const generateStaticParams: (options?: GenerateStaticParamsOptions) => Promise<DocsRouteParams[]>;
 declare const DocsPage: (options: DocsPageProps) => Promise<_$react.ReactElement<unknown, string | _$react.JSXElementConstructor<any>> | Iterable<_$react.ReactNode> | (string | number | bigint | boolean | _$react.ReactPortal | _$react.ReactElement<unknown, string | _$react.JSXElementConstructor<any>> | Iterable<_$react.ReactNode> | null | undefined)>;
 //#endregion
-export { type BuildDocsStaticParamsOptions, type BuildLocaleLinksOptions, type BuildPagerOptions, type BuildSidebarOptions, type CreateDocMetadataOptions, type CreateDocsSourceOptions, type DefineDocsConfigOptions, type DocEntry, type DocFormat, type DocsConfig, type DocsContentConfig, type DocsContentSectionConfig, type DocsHomeConfig, type DocsLocaleDefinition, type DocsLocaleLink, type DocsMdxConfig, type DocsMetadata, type DocsMetadataAlternates, type DocsMetadataRobots, DocsPage, type DocsPageProps, type DocsPager, type DocsPagerLink, DocsRootLayout, type DocsRootLayoutProps, type DocsRouteParams, type DocsRouteResolution, type DocsSectionConfig, type DocsSectionLayout, type DocsSidebarConfigNode, type DocsSidebarGroupConfig, type DocsSidebarItem, type DocsSidebarItemConfig, type DocsSidebarLabel, type DocsSidebarMode, type DocsSiteConfig, type DocsSlotsConfig, type DocsSource, type DocsThemeConfig, type GenerateMetadataOptions, type GenerateStaticParamsOptions, type NormalizedDocsConfig, type NormalizedDocsContentConfig, type NormalizedDocsContentSectionConfig, type ProcessExportedDocsOptions, type ResolveDocsRouteOptions, type ResolvedDocsNotFoundRoute, type ResolvedDocsPageRoute, type ResolvedDocsRedirectRoute, buildDocsStaticParams, buildLocaleLinks, buildPager, buildSidebar, createDocMetadata, createDocsSource, defineConfig, defineDocsConfig, dynamicParams, generateMetadata, generateStaticParams, processExportedDocs, resolveDocsRoute };
+export { type BuildDocsStaticParamsOptions, type BuildHeaderNavOptions, type BuildLocaleLinksOptions, type BuildPagerOptions, type BuildSidebarOptions, type CreateDocMetadataOptions, type CreateDocsSourceOptions, type DefineDocsConfigOptions, type DocEntry, type DocFormat, type DocsConfig, type DocsContentConfig, type DocsContentSectionConfig, type DocsHomeConfig, type DocsLocaleDefinition, type DocsLocaleLink, type DocsMdxConfig, type DocsMetadata, type DocsMetadataAlternates, type DocsMetadataRobots, DocsPage, type DocsPageProps, type DocsPager, type DocsPagerLink, DocsRootLayout, type DocsRootLayoutProps, type DocsRouteParams, type DocsRouteResolution, type DocsSectionConfig, type DocsSectionLayout, type DocsSidebarConfigNode, type DocsSidebarGroupConfig, type DocsSidebarItem, type DocsSidebarItemConfig, type DocsSidebarLabel, type DocsSidebarMode, type DocsSiteConfig, type DocsSlotsConfig, type DocsSource, type DocsThemeConfig, type DocsThemeNavConfig, type DocsThemeNavItemConfig, type GenerateMetadataOptions, type GenerateStaticParamsOptions, type NormalizedDocsConfig, type NormalizedDocsContentConfig, type NormalizedDocsContentSectionConfig, type ProcessExportedDocsOptions, type ResolveDocsRouteOptions, type ResolvedDocsNotFoundRoute, type ResolvedDocsPageRoute, type ResolvedDocsRedirectRoute, buildDocsStaticParams, buildHeaderNavigation, buildLocaleLinks, buildPager, buildSidebar, createDocMetadata, createDocsSource, defineConfig, defineDocsConfig, dynamicParams, generateMetadata, generateStaticParams, processExportedDocs, resolveDocsRoute };

package/dist/index.d.ts

@@ -1,10 +1,11 @@
 
 import { CreateDocsSourceOptions, DocEntry, DocFormat, DocsSource } from "./source/types.js";
-import { DocsConfig, DocsContentConfig, DocsContentSectionConfig, DocsHomeConfig, DocsLocaleDefinition, DocsMdxConfig, DocsSectionConfig, DocsSectionLayout, DocsSidebarConfigNode, DocsSidebarGroupConfig, DocsSidebarItemConfig, DocsSidebarLabel, DocsSidebarMode, DocsSiteConfig, DocsSlotsConfig, DocsThemeConfig, NormalizedDocsConfig, NormalizedDocsContentConfig, NormalizedDocsContentSectionConfig } from "./config/types.js";
+import { DocsConfig, DocsContentConfig, DocsContentSectionConfig, DocsHomeConfig, DocsLocaleDefinition, DocsMdxConfig, DocsSectionConfig, DocsSectionLayout, DocsSidebarConfigNode, DocsSidebarGroupConfig, DocsSidebarItemConfig, DocsSidebarLabel, DocsSidebarMode, DocsSiteConfig, DocsSlotsConfig, DocsThemeConfig, DocsThemeNavConfig, DocsThemeNavItemConfig, NormalizedDocsConfig, NormalizedDocsContentConfig, NormalizedDocsContentSectionConfig } from "./config/types.js";
 import { defineConfig } from "./config/define-config.js";
 import { DefineDocsConfigOptions, defineDocsConfig } from "./config/define-docs-config.js";
 import { ProcessExportedDocsOptions, processExportedDocs } from "./export/process-exported-docs.js";
 import { CreateDocMetadataOptions, DocsMetadata, DocsMetadataAlternates, DocsMetadataRobots, createDocMetadata } from "./metadata/create-doc-metadata.js";
+import { BuildHeaderNavOptions, buildHeaderNavigation } from "./navigation/build-header-nav.js";
 import { BuildLocaleLinksOptions, DocsLocaleLink, buildLocaleLinks } from "./navigation/build-locale-links.js";
 import { BuildPagerOptions, DocsPager, DocsPagerLink, buildPager } from "./navigation/build-pager.js";
 import { BuildSidebarOptions, DocsSidebarItem, buildSidebar } from "./navigation/build-sidebar.js";
@@ -22,4 +23,4 @@ declare const generateMetadata: (options?: GenerateMetadataOptions) => Promise<D
 declare const generateStaticParams: (options?: GenerateStaticParamsOptions) => Promise<DocsRouteParams[]>;
 declare const DocsPage: (options: DocsPageProps) => Promise<_$react.ReactElement<unknown, string | _$react.JSXElementConstructor<any>> | Iterable<_$react.ReactNode> | (string | number | bigint | boolean | _$react.ReactPortal | _$react.ReactElement<unknown, string | _$react.JSXElementConstructor<any>> | Iterable<_$react.ReactNode> | null | undefined)>;
 //#endregion
-export { type BuildDocsStaticParamsOptions, type BuildLocaleLinksOptions, type BuildPagerOptions, type BuildSidebarOptions, type CreateDocMetadataOptions, type CreateDocsSourceOptions, type DefineDocsConfigOptions, type DocEntry, type DocFormat, type DocsConfig, type DocsContentConfig, type DocsContentSectionConfig, type DocsHomeConfig, type DocsLocaleDefinition, type DocsLocaleLink, type DocsMdxConfig, type DocsMetadata, type DocsMetadataAlternates, type DocsMetadataRobots, DocsPage, type DocsPageProps, type DocsPager, type DocsPagerLink, DocsRootLayout, type DocsRootLayoutProps, type DocsRouteParams, type DocsRouteResolution, type DocsSectionConfig, type DocsSectionLayout, type DocsSidebarConfigNode, type DocsSidebarGroupConfig, type DocsSidebarItem, type DocsSidebarItemConfig, type DocsSidebarLabel, type DocsSidebarMode, type DocsSiteConfig, type DocsSlotsConfig, type DocsSource, type DocsThemeConfig, type GenerateMetadataOptions, type GenerateStaticParamsOptions, type NormalizedDocsConfig, type NormalizedDocsContentConfig, type NormalizedDocsContentSectionConfig, type ProcessExportedDocsOptions, type ResolveDocsRouteOptions, type ResolvedDocsNotFoundRoute, type ResolvedDocsPageRoute, type ResolvedDocsRedirectRoute, buildDocsStaticParams, buildLocaleLinks, buildPager, buildSidebar, createDocMetadata, createDocsSource, defineConfig, defineDocsConfig, dynamicParams, generateMetadata, generateStaticParams, processExportedDocs, resolveDocsRoute };
+export { type BuildDocsStaticParamsOptions, type BuildHeaderNavOptions, type BuildLocaleLinksOptions, type BuildPagerOptions, type BuildSidebarOptions, type CreateDocMetadataOptions, type CreateDocsSourceOptions, type DefineDocsConfigOptions, type DocEntry, type DocFormat, type DocsConfig, type DocsContentConfig, type DocsContentSectionConfig, type DocsHomeConfig, type DocsLocaleDefinition, type DocsLocaleLink, type DocsMdxConfig, type DocsMetadata, type DocsMetadataAlternates, type DocsMetadataRobots, DocsPage, type DocsPageProps, type DocsPager, type DocsPagerLink, DocsRootLayout, type DocsRootLayoutProps, type DocsRouteParams, type DocsRouteResolution, type DocsSectionConfig, type DocsSectionLayout, type DocsSidebarConfigNode, type DocsSidebarGroupConfig, type DocsSidebarItem, type DocsSidebarItemConfig, type DocsSidebarLabel, type DocsSidebarMode, type DocsSiteConfig, type DocsSlotsConfig, type DocsSource, type DocsThemeConfig, type DocsThemeNavConfig, type DocsThemeNavItemConfig, type GenerateMetadataOptions, type GenerateStaticParamsOptions, type NormalizedDocsConfig, type NormalizedDocsContentConfig, type NormalizedDocsContentSectionConfig, type ProcessExportedDocsOptions, type ResolveDocsRouteOptions, type ResolvedDocsNotFoundRoute, type ResolvedDocsPageRoute, type ResolvedDocsRedirectRoute, buildDocsStaticParams, buildHeaderNavigation, buildLocaleLinks, buildPager, buildSidebar, createDocMetadata, createDocsSource, defineConfig, defineDocsConfig, dynamicParams, generateMetadata, generateStaticParams, processExportedDocs, resolveDocsRoute };

package/dist/index.mjs

@@ -1,9 +1,9 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com
  * license: MIT
  */
-import{defineConfig as e}from"./config/define-config.mjs";import{defineDocsConfig as t}from"./config/define-docs-config.mjs";import{processExportedDocs as n}from"./export/process-exported-docs.mjs";import{buildLocaleLinks as r}from"./navigation/build-locale-links.mjs";import{createDocMetadata as i}from"./metadata/create-doc-metadata.mjs";import{buildPager as a}from"./navigation/build-pager.mjs";import{buildSidebar as o}from"./navigation/build-sidebar.mjs";import{DocsRootLayout as s}from"./next/root-layout.mjs";import{buildDocsStaticParams as c}from"./routing/build-static-params.mjs";import{resolveDocsRoute as l}from"./routing/resolve-docs-route.mjs";import{createDocsSource as u}from"./source/create-docs-source.mjs";const d=!1,f=async(e={})=>(await import(`./next/metadata.mjs`)).generateMetadata(e),p=async(e={})=>(await import(`./next/page.mjs`)).generateStaticParams(e),m=async e=>(await import(`./next/page.mjs`)).DocsPage(e);export{m as DocsPage,s as DocsRootLayout,c as buildDocsStaticParams,r as buildLocaleLinks,a as buildPager,o as buildSidebar,i as createDocMetadata,u as createDocsSource,e as defineConfig,t as defineDocsConfig,d as dynamicParams,f as generateMetadata,p as generateStaticParams,n as processExportedDocs,l as resolveDocsRoute};
+import{defineConfig as e}from"./config/define-config.mjs";import{defineDocsConfig as t}from"./config/define-docs-config.mjs";import{processExportedDocs as n}from"./export/process-exported-docs.mjs";import{buildLocaleLinks as r}from"./navigation/build-locale-links.mjs";import{createDocMetadata as i}from"./metadata/create-doc-metadata.mjs";import{buildHeaderNavigation as a}from"./navigation/build-header-nav.mjs";import{buildPager as o}from"./navigation/build-pager.mjs";import{buildSidebar as s}from"./navigation/build-sidebar.mjs";import{DocsRootLayout as c}from"./next/root-layout.mjs";import{buildDocsStaticParams as l}from"./routing/build-static-params.mjs";import{resolveDocsRoute as u}from"./routing/resolve-docs-route.mjs";import{createDocsSource as d}from"./source/create-docs-source.mjs";const f=!1,p=async(e={})=>(await import(`./next/metadata.mjs`)).generateMetadata(e),m=async(e={})=>(await import(`./next/page.mjs`)).generateStaticParams(e),h=async e=>(await import(`./next/page.mjs`)).DocsPage(e);export{h as DocsPage,c as DocsRootLayout,l as buildDocsStaticParams,a as buildHeaderNavigation,r as buildLocaleLinks,o as buildPager,s as buildSidebar,i as createDocMetadata,d as createDocsSource,e as defineConfig,t as defineDocsConfig,f as dynamicParams,p as generateMetadata,m as generateStaticParams,n as processExportedDocs,u as resolveDocsRoute};

package/dist/mdx/default-docs-components.cjs

@@ -1,9 +1,10 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com
  * license: MIT
  */
-require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`react`),t=require(`@blackwork/machine`);const n=(0,t.mergeComponents)(t.defaultComponents,{table:({children:t,node:n,...r})=>(0,e.createElement)(`div`,{className:`my-6 w-full overflow-x-auto`},(0,e.createElement)(`table`,r,t))});exports.defaultDocsComponents=n;
+require(`../_virtual/_rolldown/runtime.cjs`);let e=require(`react`),t=require(`react/jsx-runtime`),n=require(`@blackwork/machine`),r=require(`@blackwork/machine/runtime`);const i=e=>typeof e==`object`&&!!e,a=e=>i(e)&&typeof e.type==`string`,o=e=>a(e)&&e.type===`element`,s=e=>e?e.type===`text`?e.value??``:o(e)?(e.children??[]).map(e=>s(e)).join(``):``:``,c=e=>{let t=e?.properties?.class??e?.properties?.className;return Array.isArray(t)?t.filter(e=>typeof e==`string`):typeof t==`string`?t.split(` `):[]},l=e=>(e?.children??[]).find(e=>o(e)&&e.tagName===`code`),u=e=>c(e).find(e=>e.startsWith(`language-`))?.slice(9)??``,d=e=>{if(!e)return``;let t=(e.children??[]).filter(e=>o(e)&&e.tagName===`span`&&c(e).includes(`line`));return t.length>0?t.map(e=>s(e)).join(`
+`):(e.children??[]).map(e=>s(e)).join(``)},f=(e,t)=>{let n=e?.properties?.[`data-title`]??e?.properties?.dataTitle;return typeof n==`string`&&n.length>0?n:t??``},p=t=>t==null||typeof t==`boolean`?``:typeof t==`string`||typeof t==`number`?String(t):Array.isArray(t)?t.map(e=>p(e)).join(``):(0,e.isValidElement)(t)?p(t.props.children):``,m=t=>{if(Array.isArray(t))return t.map(e=>m(e)).find(Boolean)??``;if(!(0,e.isValidElement)(t))return``;let n=t.props.className,r=(Array.isArray(n)?n.filter(e=>typeof e==`string`):typeof n==`string`?n.split(` `):[]).find(e=>e.startsWith(`language-`));return r?r.slice(9):m(t.props.children)},h=(0,n.mergeComponents)(n.defaultComponents,{pre:({children:e,node:n,"data-title":i,...a})=>{let s=o(n)?n:void 0,c=l(s),h=f(s,i),g=u(c)||m(e),_=d(c)||p(e);return(0,t.jsx)(r.CodeBlock,{...a,fileName:h,language:g,rawCode:_,children:e})},table:({children:t,node:n,...r})=>(0,e.createElement)(`div`,{className:`my-6 w-full overflow-x-auto`},(0,e.createElement)(`table`,r,t))});exports.defaultDocsComponents=h;

package/dist/mdx/default-docs-components.mjs

@@ -1,9 +1,10 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com
  * license: MIT
  */
-import{createElement as e}from"react";import{defaultComponents as t,mergeComponents as n}from"@blackwork/machine";const r=n(t,{table:({children:t,node:n,...r})=>e(`div`,{className:`my-6 w-full overflow-x-auto`},e(`table`,r,t))});export{r as defaultDocsComponents};
+import{createElement as e,isValidElement as t}from"react";import{jsx as n}from"react/jsx-runtime";import{defaultComponents as r,mergeComponents as i}from"@blackwork/machine";import{CodeBlock as a}from"@blackwork/machine/runtime";const o=e=>typeof e==`object`&&!!e,s=e=>o(e)&&typeof e.type==`string`,c=e=>s(e)&&e.type===`element`,l=e=>e?e.type===`text`?e.value??``:c(e)?(e.children??[]).map(e=>l(e)).join(``):``:``,u=e=>{let t=e?.properties?.class??e?.properties?.className;return Array.isArray(t)?t.filter(e=>typeof e==`string`):typeof t==`string`?t.split(` `):[]},d=e=>(e?.children??[]).find(e=>c(e)&&e.tagName===`code`),f=e=>u(e).find(e=>e.startsWith(`language-`))?.slice(9)??``,p=e=>{if(!e)return``;let t=(e.children??[]).filter(e=>c(e)&&e.tagName===`span`&&u(e).includes(`line`));return t.length>0?t.map(e=>l(e)).join(`
+`):(e.children??[]).map(e=>l(e)).join(``)},m=(e,t)=>{let n=e?.properties?.[`data-title`]??e?.properties?.dataTitle;return typeof n==`string`&&n.length>0?n:t??``},h=e=>e==null||typeof e==`boolean`?``:typeof e==`string`||typeof e==`number`?String(e):Array.isArray(e)?e.map(e=>h(e)).join(``):t(e)?h(e.props.children):``,g=e=>{if(Array.isArray(e))return e.map(e=>g(e)).find(Boolean)??``;if(!t(e))return``;let n=e.props.className,r=(Array.isArray(n)?n.filter(e=>typeof e==`string`):typeof n==`string`?n.split(` `):[]).find(e=>e.startsWith(`language-`));return r?r.slice(9):g(e.props.children)},_=i(r,{pre:({children:e,node:t,"data-title":r,...i})=>{let o=c(t)?t:void 0,s=d(o),l=m(o,r),u=f(s)||g(e),_=p(s)||h(e);return n(a,{...i,fileName:l,language:u,rawCode:_,children:e})},table:({children:t,node:n,...r})=>e(`div`,{className:`my-6 w-full overflow-x-auto`},e(`table`,r,t))});export{_ as defaultDocsComponents};

package/dist/mdx/merge-docs-components.cjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/mdx/merge-docs-components.mjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/metadata/create-doc-metadata.cjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/metadata/create-doc-metadata.mjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/navigation/build-header-nav.cjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.5.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=e=>/^(https?:|mailto:|tel:)/u.test(e),t=e=>e&&`${e.charAt(0).toUpperCase()}${e.slice(1)}`,n=(e,t,n)=>typeof e==`string`?e:e?.[t]??n,r=(e,t)=>{let n=e.split(`/`).filter(Boolean);return n[0]&&t.includes(n[0])?n.slice(1):n},i=(t,n,i)=>e(t)?t:i.getCanonicalHref(n,r(t,i.getLocaleCodes())),a=(t,n,i)=>{if(!n||e(t))return!1;if(t===n)return!0;if(t===`/`)return!1;if(n.startsWith(`${t}/`))return!0;let a=r(t,i)[0],o=r(n,i)[0];return!!(a&&a===o)},o=({currentHref:e,href:t,label:n,locale:r,source:o})=>{let s=i(t,r,o);return{href:s,label:n,current:a(s,e,o.getLocaleCodes())}},s=e=>Object.entries(e.content?.sections??{}).map(([e,n])=>({href:`/${e}`,label:n.label??t(e)})),c=({config:e={},currentHref:t,locale:r,source:i})=>e.theme?.nav===!1?[]:(Array.isArray(e.theme?.nav)?e.theme.nav:s(e)).map(e=>o({currentHref:t,href:e.href,label:n(e.label,r,e.href),locale:r,source:i}));exports.buildHeaderNavigation=c;

package/dist/navigation/build-header-nav.d.mts

@@ -0,0 +1,20 @@
+
+import { DocsSource } from "../source/types.mjs";
+import { DocsThemeNavItem } from "../theme/types.mjs";
+import { DocsConfig, NormalizedDocsConfig } from "../config/types.mjs";
+
+//#region src/navigation/build-header-nav.d.ts
+interface BuildHeaderNavOptions {
+  config?: DocsConfig | NormalizedDocsConfig;
+  currentHref?: string;
+  locale: string;
+  source: DocsSource;
+}
+declare const buildHeaderNavigation: ({
+  config,
+  currentHref,
+  locale,
+  source
+}: BuildHeaderNavOptions) => DocsThemeNavItem[];
+//#endregion
+export { BuildHeaderNavOptions, buildHeaderNavigation };

package/dist/navigation/build-header-nav.d.ts

@@ -0,0 +1,20 @@
+
+import { DocsSource } from "../source/types.js";
+import { DocsThemeNavItem } from "../theme/types.js";
+import { DocsConfig, NormalizedDocsConfig } from "../config/types.js";
+
+//#region src/navigation/build-header-nav.d.ts
+interface BuildHeaderNavOptions {
+  config?: DocsConfig | NormalizedDocsConfig;
+  currentHref?: string;
+  locale: string;
+  source: DocsSource;
+}
+declare const buildHeaderNavigation: ({
+  config,
+  currentHref,
+  locale,
+  source
+}: BuildHeaderNavOptions) => DocsThemeNavItem[];
+//#endregion
+export { BuildHeaderNavOptions, buildHeaderNavigation };

package/dist/navigation/build-header-nav.mjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.5.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=e=>/^(https?:|mailto:|tel:)/u.test(e),t=e=>e&&`${e.charAt(0).toUpperCase()}${e.slice(1)}`,n=(e,t,n)=>typeof e==`string`?e:e?.[t]??n,r=(e,t)=>{let n=e.split(`/`).filter(Boolean);return n[0]&&t.includes(n[0])?n.slice(1):n},i=(t,n,i)=>e(t)?t:i.getCanonicalHref(n,r(t,i.getLocaleCodes())),a=(t,n,i)=>{if(!n||e(t))return!1;if(t===n)return!0;if(t===`/`)return!1;if(n.startsWith(`${t}/`))return!0;let a=r(t,i)[0],o=r(n,i)[0];return!!(a&&a===o)},o=({currentHref:e,href:t,label:n,locale:r,source:o})=>{let s=i(t,r,o);return{href:s,label:n,current:a(s,e,o.getLocaleCodes())}},s=e=>Object.entries(e.content?.sections??{}).map(([e,n])=>({href:`/${e}`,label:n.label??t(e)})),c=({config:e={},currentHref:t,locale:r,source:i})=>e.theme?.nav===!1?[]:(Array.isArray(e.theme?.nav)?e.theme.nav:s(e)).map(e=>o({currentHref:t,href:e.href,label:n(e.label,r,e.href),locale:r,source:i}));export{c as buildHeaderNavigation};

package/dist/navigation/build-locale-links.cjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/navigation/build-locale-links.mjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com

package/dist/navigation/build-pager.cjs

@@ -1,6 +1,6 @@
 /**
  * name: @blackwork/docs
- * version: v0.4.2
+ * version: v0.5.0
  * description: Next-first documentation framework for Blackwork projects.
  * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
  * homepage: https://chengpeiquan.com