@blackwork/docs 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,24 @@
+
+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 { defineConfig } from "./config/define-config.mjs";
+import { DefineDocsConfigOptions, defineDocsConfig } from "./config/define-docs-config.mjs";
+import { CreateDocsSourceOptions, DocEntry, DocFormat, DocsSource } from "./source/types.mjs";
+import { CreateDocMetadataOptions, DocsMetadata, DocsMetadataAlternates, DocsMetadataRobots, createDocMetadata } from "./metadata/create-doc-metadata.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";
+import { DocsRouteParams, DocsRouteResolution, ResolveDocsRouteOptions, ResolvedDocsNotFoundRoute, ResolvedDocsPageRoute, ResolvedDocsRedirectRoute, resolveDocsRoute } from "./routing/resolve-docs-route.mjs";
+import { DocsRootLayout, DocsRootLayoutProps } from "./next/root-layout.mjs";
+import { BuildDocsStaticParamsOptions, buildDocsStaticParams } from "./routing/build-static-params.mjs";
+import { createDocsSource } from "./source/create-docs-source.mjs";
+import { GenerateMetadataOptions } from "./next/metadata.mjs";
+import { DocsPageProps, GenerateStaticParamsOptions } from "./next/page.mjs";
+import * as _$react from "react";
+
+//#region src/index.d.ts
+declare const dynamicParams = false;
+declare const generateMetadata: (options?: GenerateMetadataOptions) => Promise<DocsMetadata | Record<string, never>>;
+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 ResolveDocsRouteOptions, type ResolvedDocsNotFoundRoute, type ResolvedDocsPageRoute, type ResolvedDocsRedirectRoute, buildDocsStaticParams, buildLocaleLinks, buildPager, buildSidebar, createDocMetadata, createDocsSource, defineConfig, defineDocsConfig, dynamicParams, generateMetadata, generateStaticParams, resolveDocsRoute };

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+
+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 { defineConfig } from "./config/define-config.js";
+import { DefineDocsConfigOptions, defineDocsConfig } from "./config/define-docs-config.js";
+import { CreateDocsSourceOptions, DocEntry, DocFormat, DocsSource } from "./source/types.js";
+import { CreateDocMetadataOptions, DocsMetadata, DocsMetadataAlternates, DocsMetadataRobots, createDocMetadata } from "./metadata/create-doc-metadata.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";
+import { DocsRouteParams, DocsRouteResolution, ResolveDocsRouteOptions, ResolvedDocsNotFoundRoute, ResolvedDocsPageRoute, ResolvedDocsRedirectRoute, resolveDocsRoute } from "./routing/resolve-docs-route.js";
+import { DocsRootLayout, DocsRootLayoutProps } from "./next/root-layout.js";
+import { BuildDocsStaticParamsOptions, buildDocsStaticParams } from "./routing/build-static-params.js";
+import { createDocsSource } from "./source/create-docs-source.js";
+import { GenerateMetadataOptions } from "./next/metadata.js";
+import { DocsPageProps, GenerateStaticParamsOptions } from "./next/page.js";
+import * as _$react from "react";
+
+//#region src/index.d.ts
+declare const dynamicParams = false;
+declare const generateMetadata: (options?: GenerateMetadataOptions) => Promise<DocsMetadata | Record<string, never>>;
+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 ResolveDocsRouteOptions, type ResolvedDocsNotFoundRoute, type ResolvedDocsPageRoute, type ResolvedDocsRedirectRoute, buildDocsStaticParams, buildLocaleLinks, buildPager, buildSidebar, createDocMetadata, createDocsSource, defineConfig, defineDocsConfig, dynamicParams, generateMetadata, generateStaticParams, resolveDocsRoute };

package/dist/index.mjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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{buildLocaleLinks as n}from"./navigation/build-locale-links.mjs";import{createDocMetadata as r}from"./metadata/create-doc-metadata.mjs";import{buildPager as i}from"./navigation/build-pager.mjs";import{buildSidebar as a}from"./navigation/build-sidebar.mjs";import{DocsRootLayout as o}from"./next/root-layout.mjs";import{buildDocsStaticParams as s}from"./routing/build-static-params.mjs";import{resolveDocsRoute as c}from"./routing/resolve-docs-route.mjs";import{createDocsSource as l}from"./source/create-docs-source.mjs";const u=!1,d=async(e={})=>(await import(`./next/metadata.mjs`)).generateMetadata(e),f=async(e={})=>(await import(`./next/page.mjs`)).generateStaticParams(e),p=async e=>(await import(`./next/page.mjs`)).DocsPage(e);export{p as DocsPage,o as DocsRootLayout,s as buildDocsStaticParams,n as buildLocaleLinks,i as buildPager,a as buildSidebar,r as createDocMetadata,l as createDocsSource,e as defineConfig,t as defineDocsConfig,u as dynamicParams,d as generateMetadata,f as generateStaticParams,c as resolveDocsRoute};

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

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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;

package/dist/mdx/default-docs-components.d.mts

@@ -0,0 +1,7 @@
+
+import { ComponentMap } from "@blackwork/machine";
+
+//#region src/mdx/default-docs-components.d.ts
+declare const defaultDocsComponents: ComponentMap;
+//#endregion
+export { defaultDocsComponents };

package/dist/mdx/default-docs-components.d.ts

@@ -0,0 +1,7 @@
+
+import { ComponentMap } from "@blackwork/machine";
+
+//#region src/mdx/default-docs-components.d.ts
+declare const defaultDocsComponents: ComponentMap;
+//#endregion
+export { defaultDocsComponents };

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

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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};

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

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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`);const e=require(`./default-docs-components.cjs`);let t=require(`@blackwork/machine`);const n=(...n)=>(0,t.mergeComponents)(e.defaultDocsComponents,...n);exports.mergeDocsComponents=n;

package/dist/mdx/merge-docs-components.d.mts

@@ -0,0 +1,7 @@
+
+import { ComponentMap } from "@blackwork/machine";
+
+//#region src/mdx/merge-docs-components.d.ts
+declare const mergeDocsComponents: (...layers: Array<ComponentMap | undefined>) => ComponentMap;
+//#endregion
+export { mergeDocsComponents };

package/dist/mdx/merge-docs-components.d.ts

@@ -0,0 +1,7 @@
+
+import { ComponentMap } from "@blackwork/machine";
+
+//#region src/mdx/merge-docs-components.d.ts
+declare const mergeDocsComponents: (...layers: Array<ComponentMap | undefined>) => ComponentMap;
+//#endregion
+export { mergeDocsComponents };

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

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+import{defaultDocsComponents as e}from"./default-docs-components.mjs";import{mergeComponents as t}from"@blackwork/machine";const n=(...n)=>t(e,...n);export{n as mergeDocsComponents};

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

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=require(`../config/define-config.cjs`),t=require(`../navigation/build-locale-links.cjs`),n=e=>e===`/`?e:e.endsWith(`/`)?e.slice(0,-1):e,r=(e,t)=>{if(!e)return t;let n=e.endsWith(`/`)?e.slice(0,-1):e;return t===`/`?`${n}/`:`${n}${t}`},i=(e,t)=>t?`${e} | ${t}`:e;function a({config:a,entry:o,pathname:s,source:c}){let l=e.defineConfig(a),u=t.buildLocaleLinks({config:l,entry:o,source:c}),d=u.length>0?Object.fromEntries(u.map(e=>[e.lang||e.locale,r(l.site.url,e.href)])):void 0,f={title:i(o.title,l.site.title),description:o.description||l.site.description||``,alternates:{canonical:r(l.site.url,o.href),...d?{languages:d}:{}}};return n(s??o.href)!==n(o.href)&&(f.robots={index:!1,follow:!0}),f}exports.createDocMetadata=a;

package/dist/metadata/create-doc-metadata.d.mts

@@ -0,0 +1,33 @@
+
+import { DocsConfig, NormalizedDocsConfig } from "../config/types.mjs";
+import { DocEntry, DocsSource } from "../source/types.mjs";
+
+//#region src/metadata/create-doc-metadata.d.ts
+interface DocsMetadataAlternates {
+  canonical?: string;
+  languages?: Record<string, string>;
+}
+interface DocsMetadataRobots {
+  index?: boolean;
+  follow?: boolean;
+}
+interface DocsMetadata {
+  title: string;
+  description: string;
+  alternates: DocsMetadataAlternates;
+  robots?: DocsMetadataRobots;
+}
+interface CreateDocMetadataOptions {
+  config?: DocsConfig | NormalizedDocsConfig;
+  entry: DocEntry;
+  pathname?: string;
+  source: DocsSource;
+}
+declare function createDocMetadata({
+  config,
+  entry,
+  pathname,
+  source
+}: CreateDocMetadataOptions): DocsMetadata;
+//#endregion
+export { CreateDocMetadataOptions, DocsMetadata, DocsMetadataAlternates, DocsMetadataRobots, createDocMetadata };

package/dist/metadata/create-doc-metadata.d.ts

@@ -0,0 +1,33 @@
+
+import { DocsConfig, NormalizedDocsConfig } from "../config/types.js";
+import { DocEntry, DocsSource } from "../source/types.js";
+
+//#region src/metadata/create-doc-metadata.d.ts
+interface DocsMetadataAlternates {
+  canonical?: string;
+  languages?: Record<string, string>;
+}
+interface DocsMetadataRobots {
+  index?: boolean;
+  follow?: boolean;
+}
+interface DocsMetadata {
+  title: string;
+  description: string;
+  alternates: DocsMetadataAlternates;
+  robots?: DocsMetadataRobots;
+}
+interface CreateDocMetadataOptions {
+  config?: DocsConfig | NormalizedDocsConfig;
+  entry: DocEntry;
+  pathname?: string;
+  source: DocsSource;
+}
+declare function createDocMetadata({
+  config,
+  entry,
+  pathname,
+  source
+}: CreateDocMetadataOptions): DocsMetadata;
+//#endregion
+export { CreateDocMetadataOptions, DocsMetadata, DocsMetadataAlternates, DocsMetadataRobots, createDocMetadata };

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

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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{buildLocaleLinks as t}from"../navigation/build-locale-links.mjs";const n=e=>e===`/`?e:e.endsWith(`/`)?e.slice(0,-1):e,r=(e,t)=>{if(!e)return t;let n=e.endsWith(`/`)?e.slice(0,-1):e;return t===`/`?`${n}/`:`${n}${t}`},i=(e,t)=>t?`${e} | ${t}`:e;function a({config:a,entry:o,pathname:s,source:c}){let l=e(a),u=t({config:l,entry:o,source:c}),d=u.length>0?Object.fromEntries(u.map(e=>[e.lang||e.locale,r(l.site.url,e.href)])):void 0,f={title:i(o.title,l.site.title),description:o.description||l.site.description||``,alternates:{canonical:r(l.site.url,o.href),...d?{languages:d}:{}}};return n(s??o.href)!==n(o.href)&&(f.robots={index:!1,follow:!0}),f}export{a as createDocMetadata};

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

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=require(`../config/define-config.cjs`),t=(e,t)=>{let n=Object.entries(e.content.locales??{});return e.content.locales?.[t]||n.find(([e,n])=>e===t||n.code===t)?.[1]};function n({config:n,entry:r,source:i}){let a=e.defineConfig(n);return i.getLocaleCodes().flatMap(e=>{let n=i.getEntry(e,r.slugSegments);if(!n)return[];let o=t(a,e);return{locale:e,href:n.href,label:o?.label,lang:o?.lang,current:e===r.locale}})}exports.buildLocaleLinks=n;

package/dist/navigation/build-locale-links.d.mts

@@ -0,0 +1,24 @@
+
+import { DocsConfig, NormalizedDocsConfig } from "../config/types.mjs";
+import { DocEntry, DocsSource } from "../source/types.mjs";
+
+//#region src/navigation/build-locale-links.d.ts
+interface DocsLocaleLink {
+  locale: string;
+  href: string;
+  label?: string;
+  lang?: string;
+  current: boolean;
+}
+interface BuildLocaleLinksOptions {
+  config?: DocsConfig | NormalizedDocsConfig;
+  entry: DocEntry;
+  source: DocsSource;
+}
+declare function buildLocaleLinks({
+  config,
+  entry,
+  source
+}: BuildLocaleLinksOptions): DocsLocaleLink[];
+//#endregion
+export { BuildLocaleLinksOptions, DocsLocaleLink, buildLocaleLinks };

package/dist/navigation/build-locale-links.d.ts

@@ -0,0 +1,24 @@
+
+import { DocsConfig, NormalizedDocsConfig } from "../config/types.js";
+import { DocEntry, DocsSource } from "../source/types.js";
+
+//#region src/navigation/build-locale-links.d.ts
+interface DocsLocaleLink {
+  locale: string;
+  href: string;
+  label?: string;
+  lang?: string;
+  current: boolean;
+}
+interface BuildLocaleLinksOptions {
+  config?: DocsConfig | NormalizedDocsConfig;
+  entry: DocEntry;
+  source: DocsSource;
+}
+declare function buildLocaleLinks({
+  config,
+  entry,
+  source
+}: BuildLocaleLinksOptions): DocsLocaleLink[];
+//#endregion
+export { BuildLocaleLinksOptions, DocsLocaleLink, buildLocaleLinks };

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

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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";const t=(e,t)=>{let n=Object.entries(e.content.locales??{});return e.content.locales?.[t]||n.find(([e,n])=>e===t||n.code===t)?.[1]};function n({config:n,entry:r,source:i}){let a=e(n);return i.getLocaleCodes().flatMap(e=>{let n=i.getEntry(e,r.slugSegments);if(!n)return[];let o=t(a,e);return{locale:e,href:n.href,label:o?.label,lang:o?.lang,current:e===r.locale}})}export{n as buildLocaleLinks};

package/dist/navigation/build-pager.cjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=require(`./resolve-sidebar.cjs`),t=e=>e?{href:e.href,title:e.title}:null;function n({entries:n,currentHref:r,sidebar:i}){let a=i?e.flattenResolvedSidebarItems(i).filter(e=>!e.isExternal):n,o=a.findIndex(e=>e.href===r);return o<0?{previous:null,next:null}:{previous:t(a[o-1]),next:t(a[o+1])}}exports.buildPager=n;

package/dist/navigation/build-pager.d.mts

@@ -0,0 +1,25 @@
+
+import { DocEntry } from "../source/types.mjs";
+import { DocsResolvedSidebarNode } from "./resolve-sidebar.mjs";
+
+//#region src/navigation/build-pager.d.ts
+interface DocsPagerLink {
+  href: string;
+  title: string;
+}
+interface DocsPager {
+  previous: DocsPagerLink | null;
+  next: DocsPagerLink | null;
+}
+interface BuildPagerOptions {
+  entries: DocEntry[];
+  currentHref: string;
+  sidebar?: DocsResolvedSidebarNode[];
+}
+declare function buildPager({
+  entries,
+  currentHref,
+  sidebar
+}: BuildPagerOptions): DocsPager;
+//#endregion
+export { BuildPagerOptions, DocsPager, DocsPagerLink, buildPager };

package/dist/navigation/build-pager.d.ts

@@ -0,0 +1,25 @@
+
+import { DocEntry } from "../source/types.js";
+import { DocsResolvedSidebarNode } from "./resolve-sidebar.js";
+
+//#region src/navigation/build-pager.d.ts
+interface DocsPagerLink {
+  href: string;
+  title: string;
+}
+interface DocsPager {
+  previous: DocsPagerLink | null;
+  next: DocsPagerLink | null;
+}
+interface BuildPagerOptions {
+  entries: DocEntry[];
+  currentHref: string;
+  sidebar?: DocsResolvedSidebarNode[];
+}
+declare function buildPager({
+  entries,
+  currentHref,
+  sidebar
+}: BuildPagerOptions): DocsPager;
+//#endregion
+export { BuildPagerOptions, DocsPager, DocsPagerLink, buildPager };

package/dist/navigation/build-pager.mjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+import{flattenResolvedSidebarItems as e}from"./resolve-sidebar.mjs";const t=e=>e?{href:e.href,title:e.title}:null;function n({entries:n,currentHref:r,sidebar:i}){let a=i?e(i).filter(e=>!e.isExternal):n,o=a.findIndex(e=>e.href===r);return o<0?{previous:null,next:null}:{previous:t(a[o-1]),next:t(a[o+1])}}export{n as buildPager};

package/dist/navigation/build-sidebar.cjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=require(`./resolve-sidebar.cjs`);function t({config:t,entries:n,currentHref:r,sectionKey:i}){return e.flattenResolvedSidebarItems(e.resolveSidebar({config:t,entries:n,currentHref:r,sectionKey:i})).map(e=>({depth:e.depth,href:e.href,slugSegments:[...e.slugSegments],title:e.title,...e.parentHref?{parentHref:e.parentHref}:{},isActive:e.isActive,...e.isExternal?{isExternal:!0}:{}}))}exports.buildSidebar=t;

package/dist/navigation/build-sidebar.d.mts

@@ -0,0 +1,28 @@
+
+import { DocsConfig, NormalizedDocsConfig } from "../config/types.mjs";
+import { DocEntry } from "../source/types.mjs";
+
+//#region src/navigation/build-sidebar.d.ts
+interface DocsSidebarItem {
+  depth: number;
+  href: string;
+  slugSegments: string[];
+  title: string;
+  parentHref?: string;
+  isActive: boolean;
+  isExternal?: boolean;
+}
+interface BuildSidebarOptions {
+  config?: DocsConfig | NormalizedDocsConfig;
+  entries: DocEntry[];
+  currentHref?: string;
+  sectionKey?: string;
+}
+declare function buildSidebar({
+  config,
+  entries,
+  currentHref,
+  sectionKey
+}: BuildSidebarOptions): DocsSidebarItem[];
+//#endregion
+export { BuildSidebarOptions, DocsSidebarItem, buildSidebar };

package/dist/navigation/build-sidebar.d.ts

@@ -0,0 +1,28 @@
+
+import { DocsConfig, NormalizedDocsConfig } from "../config/types.js";
+import { DocEntry } from "../source/types.js";
+
+//#region src/navigation/build-sidebar.d.ts
+interface DocsSidebarItem {
+  depth: number;
+  href: string;
+  slugSegments: string[];
+  title: string;
+  parentHref?: string;
+  isActive: boolean;
+  isExternal?: boolean;
+}
+interface BuildSidebarOptions {
+  config?: DocsConfig | NormalizedDocsConfig;
+  entries: DocEntry[];
+  currentHref?: string;
+  sectionKey?: string;
+}
+declare function buildSidebar({
+  config,
+  entries,
+  currentHref,
+  sectionKey
+}: BuildSidebarOptions): DocsSidebarItem[];
+//#endregion
+export { BuildSidebarOptions, DocsSidebarItem, buildSidebar };

package/dist/navigation/build-sidebar.mjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+import{flattenResolvedSidebarItems as e,resolveSidebar as t}from"./resolve-sidebar.mjs";function n({config:n,entries:r,currentHref:i,sectionKey:a}){return e(t({config:n,entries:r,currentHref:i,sectionKey:a})).map(e=>({depth:e.depth,href:e.href,slugSegments:[...e.slugSegments],title:e.title,...e.parentHref?{parentHref:e.parentHref}:{},isActive:e.isActive,...e.isExternal?{isExternal:!0}:{}}))}export{n as buildSidebar};

package/dist/navigation/resolve-sidebar.cjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=require(`../config/define-config.cjs`),t=e=>e.join(`/`),n=(e,n)=>{let r=[];for(let i=1;i<e.slugSegments.length;i+=1){let a=n.get(t(e.slugSegments.slice(0,i)));a&&r.push(a)}return r},r=e=>e[0]?.locale??`en`,i=(e,t)=>t?e.filter(e=>e.slugSegments[0]===t):e,a=({defaultLocale:e,fallback:t,label:n,locale:r,onError:i})=>typeof n==`string`?n:n?.[r]?n[r]:e&&n?.[e]?n[e]:t||i(),o=({href:e,siteUrl:t})=>{try{let n=new URL(e),r=t?new URL(t):void 0;return!r||n.origin!==r.origin?null:n.pathname}catch{return e}},s=({defaultLocale:e,href:t,locale:n})=>{let r=(t.split(/[?#]/u,1)[0]||`/`).split(`/`).filter(Boolean);return r[0]===n||e&&r[0]===e?r.slice(1):r},c=({href:e,locale:t,sectionKey:n})=>Error(`[blackwork-docs] Invalid sidebar item in section "${n}": href "${e}" does not match any document entry in locale "${t}". Add the page or remove the sidebar item.`),l=({currentHref:e,defaultLocale:n,entryLookup:r,item:i,locale:l,sectionKey:u,siteUrl:d})=>{let f=o({href:i.href,siteUrl:d});if(f===null)return{type:`item`,depth:0,href:i.href,slugSegments:[],title:a({defaultLocale:n,label:i.label,locale:l,onError:()=>{throw Error(`[blackwork-docs] Invalid sidebar item in section "${u}": external href "${i.href}" requires a label for locale "${l}" or defaultLocale "${n??`unknown`}".`)}}),isActive:i.href===e,isExternal:!0};let p=s({defaultLocale:n,href:f,locale:l}),m=r.get(t(p));if(!m)throw c({href:i.href,locale:l,sectionKey:u});return{type:`item`,depth:0,href:m.href,slugSegments:[...m.slugSegments],title:a({defaultLocale:n,fallback:m.title,label:i.label,locale:l,onError:()=>{throw c({href:i.href,locale:l,sectionKey:u})}}),isActive:m.href===e,isExternal:!1}},u=({currentHref:e,defaultLocale:t,entryLookup:n,locale:r,node:i,sectionKey:o,siteUrl:s})=>i.type===`item`?l({currentHref:e,defaultLocale:t,entryLookup:n,item:i,locale:r,sectionKey:o,siteUrl:s}):{type:`group`,title:a({defaultLocale:t,label:i.label,locale:r,onError:()=>{throw Error(`[blackwork-docs] Invalid sidebar group in section "${o}": label is required for locale "${r}" or defaultLocale "${t??`unknown`}".`)}}),items:i.items.map(i=>l({currentHref:e,defaultLocale:t,entryLookup:n,item:i,locale:r,sectionKey:o,siteUrl:s}))},d=({currentHref:e,entries:r})=>{let i=new Map(r.map(e=>[t(e.slugSegments),e]));return r.map(t=>{let r=n(t,i).at(-1);return{type:`item`,depth:Math.max(t.slugSegments.length-1,0),href:t.href,slugSegments:[...t.slugSegments],title:t.title,...r?{parentHref:r.href}:{},isActive:t.href===e,isExternal:!1}})},f=e=>e.flatMap(e=>e.type===`group`?e.items:e);function p({config:n,currentHref:a,entries:o,sectionKey:s}){let c=e.defineConfig(n),l=r(o),f=(s?c.content.sections?.[s]:void 0)?.sidebar??`auto`;if(f===!1)return[];if(f===`auto`)return d({currentHref:a,entries:i(o,s)});let p=new Map(o.map(e=>[t(e.slugSegments),e]));return f.map(e=>u({currentHref:a,defaultLocale:c.content.defaultLocale,entryLookup:p,locale:l,node:e,sectionKey:s??`root`,siteUrl:c.site.url}))}exports.flattenResolvedSidebarItems=f,exports.resolveSidebar=p;

package/dist/navigation/resolve-sidebar.d.mts

@@ -0,0 +1,20 @@
+
+//#region src/navigation/resolve-sidebar.d.ts
+interface DocsResolvedSidebarItem {
+  type: 'item';
+  depth: number;
+  href: string;
+  slugSegments: string[];
+  title: string;
+  parentHref?: string;
+  isActive: boolean;
+  isExternal: boolean;
+}
+interface DocsResolvedSidebarGroup {
+  type: 'group';
+  title: string;
+  items: DocsResolvedSidebarItem[];
+}
+type DocsResolvedSidebarNode = DocsResolvedSidebarGroup | DocsResolvedSidebarItem;
+//#endregion
+export { DocsResolvedSidebarNode };

package/dist/navigation/resolve-sidebar.d.ts

@@ -0,0 +1,20 @@
+
+//#region src/navigation/resolve-sidebar.d.ts
+interface DocsResolvedSidebarItem {
+  type: 'item';
+  depth: number;
+  href: string;
+  slugSegments: string[];
+  title: string;
+  parentHref?: string;
+  isActive: boolean;
+  isExternal: boolean;
+}
+interface DocsResolvedSidebarGroup {
+  type: 'group';
+  title: string;
+  items: DocsResolvedSidebarItem[];
+}
+type DocsResolvedSidebarNode = DocsResolvedSidebarGroup | DocsResolvedSidebarItem;
+//#endregion
+export { DocsResolvedSidebarNode };

package/dist/navigation/resolve-sidebar.mjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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";const t=e=>e.join(`/`),n=(e,n)=>{let r=[];for(let i=1;i<e.slugSegments.length;i+=1){let a=n.get(t(e.slugSegments.slice(0,i)));a&&r.push(a)}return r},r=e=>e[0]?.locale??`en`,i=(e,t)=>t?e.filter(e=>e.slugSegments[0]===t):e,a=({defaultLocale:e,fallback:t,label:n,locale:r,onError:i})=>typeof n==`string`?n:n?.[r]?n[r]:e&&n?.[e]?n[e]:t||i(),o=({href:e,siteUrl:t})=>{try{let n=new URL(e),r=t?new URL(t):void 0;return!r||n.origin!==r.origin?null:n.pathname}catch{return e}},s=({defaultLocale:e,href:t,locale:n})=>{let r=(t.split(/[?#]/u,1)[0]||`/`).split(`/`).filter(Boolean);return r[0]===n||e&&r[0]===e?r.slice(1):r},c=({href:e,locale:t,sectionKey:n})=>Error(`[blackwork-docs] Invalid sidebar item in section "${n}": href "${e}" does not match any document entry in locale "${t}". Add the page or remove the sidebar item.`),l=({currentHref:e,defaultLocale:n,entryLookup:r,item:i,locale:l,sectionKey:u,siteUrl:d})=>{let f=o({href:i.href,siteUrl:d});if(f===null)return{type:`item`,depth:0,href:i.href,slugSegments:[],title:a({defaultLocale:n,label:i.label,locale:l,onError:()=>{throw Error(`[blackwork-docs] Invalid sidebar item in section "${u}": external href "${i.href}" requires a label for locale "${l}" or defaultLocale "${n??`unknown`}".`)}}),isActive:i.href===e,isExternal:!0};let p=s({defaultLocale:n,href:f,locale:l}),m=r.get(t(p));if(!m)throw c({href:i.href,locale:l,sectionKey:u});return{type:`item`,depth:0,href:m.href,slugSegments:[...m.slugSegments],title:a({defaultLocale:n,fallback:m.title,label:i.label,locale:l,onError:()=>{throw c({href:i.href,locale:l,sectionKey:u})}}),isActive:m.href===e,isExternal:!1}},u=({currentHref:e,defaultLocale:t,entryLookup:n,locale:r,node:i,sectionKey:o,siteUrl:s})=>i.type===`item`?l({currentHref:e,defaultLocale:t,entryLookup:n,item:i,locale:r,sectionKey:o,siteUrl:s}):{type:`group`,title:a({defaultLocale:t,label:i.label,locale:r,onError:()=>{throw Error(`[blackwork-docs] Invalid sidebar group in section "${o}": label is required for locale "${r}" or defaultLocale "${t??`unknown`}".`)}}),items:i.items.map(i=>l({currentHref:e,defaultLocale:t,entryLookup:n,item:i,locale:r,sectionKey:o,siteUrl:s}))},d=({currentHref:e,entries:r})=>{let i=new Map(r.map(e=>[t(e.slugSegments),e]));return r.map(t=>{let r=n(t,i).at(-1);return{type:`item`,depth:Math.max(t.slugSegments.length-1,0),href:t.href,slugSegments:[...t.slugSegments],title:t.title,...r?{parentHref:r.href}:{},isActive:t.href===e,isExternal:!1}})},f=e=>e.flatMap(e=>e.type===`group`?e.items:e);function p({config:n,currentHref:a,entries:o,sectionKey:s}){let c=e(n),l=r(o),f=(s?c.content.sections?.[s]:void 0)?.sidebar??`auto`;if(f===!1)return[];if(f===`auto`)return d({currentHref:a,entries:i(o,s)});let p=new Map(o.map(e=>[t(e.slugSegments),e]));return f.map(e=>u({currentHref:a,defaultLocale:c.content.defaultLocale,entryLookup:p,locale:l,node:e,sectionKey:s??`root`,siteUrl:c.site.url}))}export{f as flattenResolvedSidebarItems,p as resolveSidebar};

package/dist/next/context.cjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=require(`../config/define-config.cjs`),t=require(`../source/create-docs-source.cjs`),n=require(`./load-generated-manifest.cjs`),r=async({config:r,rootDir:i}={})=>{let a=e.defineConfig(r);return{normalizedConfig:a,source:await n.loadGeneratedDocsSource()??t.createDocsSource({rootDir:i,config:a})}};exports.createNextDocsContext=r;

package/dist/next/context.mjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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{createDocsSource as t}from"../source/create-docs-source.mjs";import{loadGeneratedDocsSource as n}from"./load-generated-manifest.mjs";const r=async({config:r,rootDir:i}={})=>{let a=e(r);return{normalizedConfig:a,source:await n()??t({rootDir:i,config:a})}};export{r as createNextDocsContext};

package/dist/next/load-doc-content.cjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.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`);const e=require(`../mdx/merge-docs-components.cjs`);let t=require(`node:fs`),n=require(`@blackwork/machine/server`);const r=e=>e.format===`mdx`?`mdx`:`markdown`,i=async({config:i,entry:a})=>(0,n.compile)(a.loadSource?await a.loadSource():(0,t.readFileSync)(a.sourcePath,`utf8`),{format:r(a),components:e.mergeDocsComponents(i.mdx.components)});exports.loadDocContent=i;

package/dist/next/load-doc-content.mjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+import{mergeDocsComponents as e}from"../mdx/merge-docs-components.mjs";import{readFileSync as t}from"node:fs";import{compile as n}from"@blackwork/machine/server";const r=e=>e.format===`mdx`?`mdx`:`markdown`,i=async({config:i,entry:a})=>n(a.loadSource?await a.loadSource():t(a.sourcePath,`utf8`),{format:r(a),components:e(i.mdx.components)});export{i as loadDocContent};

package/dist/next/load-generated-manifest.cjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=require(`../source/create-docs-source-from-manifest.cjs`),t=async()=>{try{let e=await import(`private-blackwork-docs-root/.blackwork/docs/manifest.mjs`);return e.docsManifest??e.default??null}catch{return null}},n=async()=>{let n=await t();return n?e.createDocsSourceFromManifest(n):null};exports.loadGeneratedDocsSource=n;

package/dist/next/load-generated-manifest.mjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+import{createDocsSourceFromManifest as e}from"../source/create-docs-source-from-manifest.mjs";const t=async()=>{try{let e=await import(`private-blackwork-docs-root/.blackwork/docs/manifest.mjs`);return e.docsManifest??e.default??null}catch{return null}},n=async()=>{let n=await t();return n?e(n):null};export{n as loadGeneratedDocsSource};

package/dist/next/metadata.cjs

@@ -0,0 +1,9 @@
+/**
+ * name: @blackwork/docs
+ * version: v0.1.0
+ * description: Next-first documentation framework for Blackwork projects.
+ * author: chengpeiquan <chengpeiquan@chengpeiquan.com>
+ * homepage: https://chengpeiquan.com
+ * license: MIT
+ */
+const e=require(`../metadata/create-doc-metadata.cjs`),t=require(`../routing/resolve-docs-route.cjs`),n=require(`./context.cjs`),r=async({config:r,params:i,rootDir:a}={})=>{let{normalizedConfig:o,source:s}=await n.createNextDocsContext({config:r,rootDir:a}),c=t.resolveDocsRoute({source:s,params:await i});if(c.kind===`notFound`)return{};let l=c.kind===`redirect`?s.getLegacyAliasHref(c.locale,c.slugSegments)??c.entry.href:c.entry.href;return e.createDocMetadata({config:o,entry:c.entry,pathname:l,source:s})};exports.generateMetadata=r;