robindoc 3.4.0 → 3.5.0

package/lib/core/types/initialize.d.ts

@@ -0,0 +1,7 @@
+import { type Structure } from "./structure";
+export type StructureTemplate = Structure | (() => Structure | Promise<Structure>);
+export type Options = {
+    processError?: (status: number, statusText: string) => void | null | never;
+    matcher?: string[];
+};
+//# sourceMappingURL=initialize.d.ts.map

package/lib/core/types/initialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"initialize.d.ts","sourceRoot":"","sources":["../../../src/core/types/initialize.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,aAAa,CAAC;AAE7C,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;AAEnF,MAAM,MAAM,OAAO,GAAG;IAClB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,GAAG,KAAK,CAAC;IAC3E,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB,CAAC"}

package/lib/core/utils/initialize-robindoc.d.ts

@@ -1,21 +1,21 @@
 import React from "react";
 import { type ArticleProps as ArticlePropsBase } from "../../components/elements/article";
 import { type SidebarProps as SidebarPropsBase } from "../../components/elements/sidebar";
-import { type Structure } from "../types/structure";
+import { type StructureTemplate, type Options } from "../types/initialize";
 type PageProps = Omit<Partial<ArticlePropsBase>, "uri" | "content" | "provider" | "pathname" | "pages"> & {
     pathname: string;
 };
 type SidebarProps = Omit<SidebarPropsBase, "tree">;
-export declare const initializeRobindoc: (structureTemplate: Structure | (() => Structure | Promise<Structure>)) => {
+export declare const initializeRobindoc: (structureTemplate: StructureTemplate, options?: Options) => {
     Page: React.FC<PageProps>;
     Sidebar: React.FC<SidebarProps>;
     getStaticParams: <T extends string = "segments">(prefix?: string, segmentsParamKey?: T) => Promise<Record<T, string[]>[]>;
-    getMetadata: (pathname: string) => Promise<Record<string, string>>;
+    getMetadata: (pathname: string) => Promise<Record<string, string> | null>;
     getPageData: (pathname: string) => Promise<{
         title: string;
         raw: string;
-    }>;
-    getPageInstruction: (pathname: string) => Promise<import("../types/content").Page>;
+    } | null>;
+    getPageInstruction: (pathname: string) => Promise<import("../types/content").Page | null>;
 };
 export {};
 //# sourceMappingURL=initialize-robindoc.d.ts.map

package/lib/core/utils/initialize-robindoc.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"initialize-robindoc.d.ts","sourceRoot":"","sources":["../../../src/core/utils/initialize-robindoc.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAA0B,KAAK,YAAY,IAAI,gBAAgB,EAAE,0CAAyC;AACjH,OAAO,EAA0B,KAAK,YAAY,IAAI,gBAAgB,EAAE,0CAAyC;AAEjH,OAAO,EAAE,KAAK,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAOpD,KAAK,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG;IACtG,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;AAUnD,eAAO,MAAM,kBAAkB,GAAI,mBAAmB,SAAS,GAAG,CAAC,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;;;sBAmDrE,CAAC,SAAS,MAAM,wBACnC,MAAM,qBACI,CAAC;4BAiBc,MAAM;4BAgBN,MAAM;;;;mCAeC,MAAM;CAarD,CAAC"}
+{"version":3,"file":"initialize-robindoc.d.ts","sourceRoot":"","sources":["../../../src/core/utils/initialize-robindoc.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAA0B,KAAK,YAAY,IAAI,gBAAgB,EAAE,0CAAyC;AACjH,OAAO,EAA0B,KAAK,YAAY,IAAI,gBAAgB,EAAE,0CAAyC;AAEjH,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAO3E,KAAK,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,KAAK,GAAG,SAAS,GAAG,UAAU,GAAG,UAAU,GAAG,OAAO,CAAC,GAAG;IACtG,QAAQ,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,KAAK,YAAY,GAAG,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;AAenD,eAAO,MAAM,kBAAkB,GAAI,mBAAmB,iBAAiB,EAAE,UAAS,OAAY;;;sBA0D3D,CAAC,SAAS,MAAM,wBACnC,MAAM,qBACI,CAAC;4BAiBc,MAAM;4BAwBN,MAAM;;;;mCAuBC,MAAM;CAqBrD,CAAC"}

package/lib/core/utils/initialize-robindoc.js

@@ -1,2 +1,2 @@
-import t from"react";import{Article as e}from"../../components/elements/article/index.js";import{Sidebar as r}from"../../components/elements/sidebar/index.js";import{parseStructure as a}from"./parse-structure.js";import{getConfiguration as n}from"./get-configuration.js";import{getMetadata as i}from"./get-metadata.js";import{normalizePathname as o,removeTrailingSlash as s}from"./path-tools.js";import{loadContent as c}from"./load-content.js";const u=u=>{const p=(async t=>"function"==typeof t?t():t)(u).then(t=>a(t.items||[],n(t.configuration||{})));return{Page:async({pathname:r,...a})=>{const{pages:n}=await p,i=o(r),s=n[i];if(!s)throw new Error(`Can not find data for "${i}". Please check structure`);const c=Object.keys(n),u=c.indexOf(i),m=c[u-1],f=u<c.length-1&&c[u+1],d=m&&{pathname:m,title:n[m].title},g=f&&{pathname:f,title:n[f].title},l=s.crumbs.map(t=>({title:n[t].title,pathname:t})),h=Object.entries(n).reduce((t,[e,{origPath:r}])=>(r&&t.push({clientPath:e,origPath:r}),t),[]);return t.createElement(e,{pathname:i,provider:s.configuration.provider,uri:s.uri,title:s.title,breadcrumbs:l,prev:d||void 0,next:g||void 0,pages:h,...a})},Sidebar:async e=>{const{tree:a}=await p;return t.createElement(r,{tree:a,...e})},getStaticParams:async(t="",e="segments")=>{const{pages:r}=await p,a=Object.keys(r),n=s(t);return a.reduce((t,r)=>r.startsWith(n)?(t.push({[e]:r.substring(n.length+1).split("/")}),t):t,[])},getMetadata:async t=>{const{pages:e}=await p,r=o(t),a=e[r];if(!a)throw new Error(`Can not find data for "${r}". Please check structure`);return await i({uri:a.uri,provider:a.configuration.provider})},getPageData:async t=>{const{pages:e}=await p,r=o(t),a=e[r];if(!a)throw new Error(`Can not find data for "${r}". Please check structure`);const n=a.title,{data:i}=await c(a.uri,a.configuration.provider);return{title:n,raw:i}},getPageInstruction:async t=>{const{pages:e}=await p,r=o(t),a=e[r];if(!a)throw new Error(`Can not find data for "${r}". Please check structure`);return a}}};export{u as initializeRobindoc};
+import r from"react";import{Article as t}from"../../components/elements/article/index.js";import{Sidebar as e}from"../../components/elements/sidebar/index.js";import{parseStructure as o}from"./parse-structure.js";import{getConfiguration as s}from"./get-configuration.js";import{getMetadata as n}from"./get-metadata.js";import{normalizePathname as a,removeTrailingSlash as c}from"./path-tools.js";import{loadContent as i}from"./load-content.js";const p=(p,u={})=>{const l=(async r=>{let t;t="function"==typeof r?await r():r;const e=s(t.configuration||{});return o(t.items||[],e)})(p),m=u.matcher?.map(r=>new RegExp(`^${r.replace(/^\^|\$$/g,"")}$`));return{Page:async({pathname:e,...o})=>{const s=a(e);if(m&&!m.every(r=>r.test(e))){const r=`Pathname "${s}" doesn't pass matcher rules check`;if(u.processError)return u.processError(404,r)||null;throw new Error(r)}const{pages:n}=await l,c=n[s];if(!c){const r=`Can not find data for "${s}". Please check structure`;if(u.processError)return u.processError(404,r)||null;throw new Error(r)}const i=Object.keys(n),p=i.indexOf(s),f=i[p-1],h=p<i.length-1&&i[p+1],d=f&&{pathname:f,title:n[f].title},g=h&&{pathname:h,title:n[h].title},w=c.crumbs.map(r=>({title:n[r].title,pathname:r})),E=Object.entries(n).reduce((r,[t,{origPath:e}])=>(e&&r.push({clientPath:t,origPath:e}),r),[]);return r.createElement(t,{pathname:s,provider:c.configuration.provider,uri:c.uri,title:c.title,breadcrumbs:w,prev:d||void 0,next:g||void 0,pages:E,...o})},Sidebar:async t=>{const{tree:o}=await l;return r.createElement(e,{tree:o,...t})},getStaticParams:async(r="",t="segments")=>{const{pages:e}=await l,o=Object.keys(e),s=c(r);return o.reduce((r,e)=>e.startsWith(s)?(r.push({[t]:e.substring(s.length+1).split("/")}),r):r,[])},getMetadata:async r=>{const t=a(r);if(m&&!m.every(t=>t.test(r))){const r=`Pathname "${t}" doesn't pass matcher rules check`;if(u.processError)return u.processError(404,r)||null;throw new Error(r)}const{pages:e}=await l,o=e[t];if(!o){const r=`Can not find data for "${t}". Please check structure`;if(u.processError)return u.processError(404,r)||null;throw new Error(r)}return await n({uri:o.uri,provider:o.configuration.provider})},getPageData:async r=>{const t=a(r);if(m&&!m.every(t=>t.test(r))){const r=`Pathname "${t}" doesn't pass matcher rules check`;if(u.processError)return u.processError(404,r)||null;throw new Error(r)}const{pages:e}=await l,o=e[t];if(!o){const r=`Can not find data for "${t}". Please check structure`;if(u.processError)return u.processError(404,r)||null;throw new Error(r)}const s=o.title,{data:n}=await i(o.uri,o.configuration.provider);return{title:s,raw:n}},getPageInstruction:async r=>{const t=a(r);if(m&&!m.every(t=>t.test(r))){const r=`Pathname "${t}" doesn't pass matcher rules check`;if(u.processError)return u.processError(404,r)||null;throw new Error(r)}const{pages:e}=await l,o=e[t];if(!o){const r=`Can not find data for "${t}". Please check structure`;if(u.processError)return u.processError(404,r)||null;throw new Error(r)}return o}}};export{p as initializeRobindoc};
 //# sourceMappingURL=initialize-robindoc.js.map

package/lib/core/utils/initialize-robindoc.js.map

@@ -1 +1 @@
-{"version":3,"file":"initialize-robindoc.js","sources":["../../../src/core/utils/initialize-robindoc.tsx"],"sourcesContent":["import React from \"react\";\n\nimport { Article as ArticleBase, type ArticleProps as ArticlePropsBase } from \"@src/components/elements/article\";\nimport { Sidebar as SidebarBase, type SidebarProps as SidebarPropsBase } from \"@src/components/elements/sidebar\";\n\nimport { type Structure } from \"../types/structure\";\nimport { parseStructure } from \"./parse-structure\";\nimport { getConfiguration } from \"./get-configuration\";\nimport { getMetadata as getMetadataBase } from \"./get-metadata\";\nimport { normalizePathname, removeTrailingSlash } from \"./path-tools\";\nimport { loadContent } from \"./load-content\";\n\ntype PageProps = Omit<Partial<ArticlePropsBase>, \"uri\" | \"content\" | \"provider\" | \"pathname\" | \"pages\"> & {\n    pathname: string;\n};\n\ntype SidebarProps = Omit<SidebarPropsBase, \"tree\">;\n\nconst loadStructure = async (structureTemplate: Structure | (() => Structure | Promise<Structure>)) => {\n    if (typeof structureTemplate === \"function\") {\n        return structureTemplate();\n    } else {\n        return structureTemplate;\n    }\n};\n\nexport const initializeRobindoc = (structureTemplate: Structure | (() => Structure | Promise<Structure>)) => {\n    const structureParsedPromise = loadStructure(structureTemplate).then((structure) =>\n        parseStructure(structure.items || [], getConfiguration(structure.configuration || {})),\n    );\n\n    const Page: React.FC<PageProps> = async ({ pathname, ...props }) => {\n        const { pages } = await structureParsedPromise;\n        const pathnameNormalized = normalizePathname(pathname);\n        const pageInstruction = pages[pathnameNormalized];\n\n        if (!pageInstruction) {\n            throw new Error(`Can not find data for \"${pathnameNormalized}\". Please check structure`);\n        }\n\n        const paths = Object.keys(pages);\n        const targetPageIndex = paths.indexOf(pathnameNormalized);\n        const prevPagePathname = paths[targetPageIndex - 1];\n        const nextPagePathname = targetPageIndex < paths.length - 1 && paths[targetPageIndex + 1];\n        const prev = prevPagePathname && { pathname: prevPagePathname, title: pages[prevPagePathname].title };\n        const next = nextPagePathname && { pathname: nextPagePathname, title: pages[nextPagePathname].title };\n\n        const breadcrumbs = pageInstruction.crumbs.map((crumb) => ({ title: pages[crumb].title, pathname: crumb }));\n        const clientPages = Object.entries(pages).reduce<{ clientPath: string; origPath: string }[]>(\n            (acc, [clientPath, { origPath }]) => {\n                if (origPath) acc.push({ clientPath, origPath });\n                return acc;\n            },\n            [],\n        );\n\n        return (\n            <ArticleBase\n                pathname={pathnameNormalized}\n                provider={pageInstruction.configuration.provider}\n                uri={pageInstruction.uri}\n                title={pageInstruction.title}\n                breadcrumbs={breadcrumbs}\n                prev={prev || undefined}\n                next={next || undefined}\n                pages={clientPages}\n                {...props}\n            />\n        );\n    };\n\n    const Sidebar: React.FC<SidebarProps> = async (props) => {\n        const { tree } = await structureParsedPromise;\n\n        return <SidebarBase tree={tree} {...props} />;\n    };\n\n    const getStaticParams = async <T extends string = \"segments\">(\n        prefix: string = \"\",\n        segmentsParamKey: T = \"segments\" as T,\n    ) => {\n        const { pages } = await structureParsedPromise;\n        const pagesArr = Object.keys(pages);\n        const prefixWithoutTrailingSlash = removeTrailingSlash(prefix);\n\n        return pagesArr.reduce<Record<T, string[]>[]>((acc, cur) => {\n            if (!cur.startsWith(prefixWithoutTrailingSlash)) return acc;\n\n            acc.push({\n                [segmentsParamKey]: cur.substring(prefixWithoutTrailingSlash.length + 1).split(\"/\"),\n            } as Record<T, string[]>);\n\n            return acc;\n        }, []);\n    };\n\n    const getMetadata = async (pathname: string) => {\n        const { pages } = await structureParsedPromise;\n        const pathnameNormalized = normalizePathname(pathname);\n        const pageInstruction = pages[pathnameNormalized];\n\n        if (!pageInstruction) {\n            throw new Error(`Can not find data for \"${pathnameNormalized}\". Please check structure`);\n        }\n\n        const metadata = await getMetadataBase({\n            uri: pageInstruction.uri,\n            provider: pageInstruction.configuration.provider,\n        });\n        return metadata;\n    };\n\n    const getPageData = async (pathname: string) => {\n        const { pages } = await structureParsedPromise;\n        const pathnameNormalized = normalizePathname(pathname);\n        const pageInstruction = pages[pathnameNormalized];\n\n        if (!pageInstruction) {\n            throw new Error(`Can not find data for \"${pathnameNormalized}\". Please check structure`);\n        }\n\n        const title = pageInstruction.title;\n        const { data } = await loadContent(pageInstruction.uri, pageInstruction.configuration.provider);\n\n        return { title, raw: data };\n    };\n\n    const getPageInstruction = async (pathname: string) => {\n        const { pages } = await structureParsedPromise;\n        const pathnameNormalized = normalizePathname(pathname);\n        const pageInstruction = pages[pathnameNormalized];\n\n        if (!pageInstruction) {\n            throw new Error(`Can not find data for \"${pathnameNormalized}\". Please check structure`);\n        }\n\n        return pageInstruction;\n    };\n\n    return { Page, Sidebar, getStaticParams, getMetadata, getPageData, getPageInstruction };\n};\n"],"names":["initializeRobindoc","structureTemplate","structureParsedPromise","async","loadStructure","then","structure","parseStructure","items","getConfiguration","configuration","Page","pathname","props","pages","pathnameNormalized","normalizePathname","pageInstruction","Error","paths","Object","keys","targetPageIndex","indexOf","prevPagePathname","nextPagePathname","length","prev","title","next","breadcrumbs","crumbs","map","crumb","clientPages","entries","reduce","acc","clientPath","origPath","push","React","ArticleBase","provider","uri","undefined","Sidebar","tree","createElement","SidebarBase","getStaticParams","prefix","segmentsParamKey","pagesArr","prefixWithoutTrailingSlash","removeTrailingSlash","cur","startsWith","substring","split","getMetadata","getMetadataBase","getPageData","data","loadContent","raw","getPageInstruction"],"mappings":"4bAkBA,MAQaA,EAAsBC,IAC/B,MAAMC,EATYC,OAAOF,GACQ,mBAAtBA,EACAA,IAEAA,EAKoBG,CAAcH,GAAmBI,KAAMC,GAClEC,EAAeD,EAAUE,OAAS,GAAIC,EAAiBH,EAAUI,eAAiB,CAAA,KA+GtF,MAAO,CAAEC,KA5GyBR,OAASS,cAAaC,MACpD,MAAMC,MAAEA,SAAgBZ,EAClBa,EAAqBC,EAAkBJ,GACvCK,EAAkBH,EAAMC,GAE9B,IAAKE,EACD,MAAM,IAAIC,MAAM,0BAA0BH,8BAG9C,MAAMI,EAAQC,OAAOC,KAAKP,GACpBQ,EAAkBH,EAAMI,QAAQR,GAChCS,EAAmBL,EAAMG,EAAkB,GAC3CG,EAAmBH,EAAkBH,EAAMO,OAAS,GAAKP,EAAMG,EAAkB,GACjFK,EAAOH,GAAoB,CAAEZ,SAAUY,EAAkBI,MAAOd,EAAMU,GAAkBI,OACxFC,EAAOJ,GAAoB,CAAEb,SAAUa,EAAkBG,MAAOd,EAAMW,GAAkBG,OAExFE,EAAcb,EAAgBc,OAAOC,IAAKC,IAAK,CAAQL,MAAOd,EAAMmB,GAAOL,MAAOhB,SAAUqB,KAC5FC,EAAcd,OAAOe,QAAQrB,GAAOsB,OACtC,CAACC,GAAMC,GAAcC,gBACbA,GAAUF,EAAIG,KAAK,CAAEF,aAAYC,aAC9BF,GAEX,IAGJ,OACII,gBAACC,EAAW,CACR9B,SAAUG,EACV4B,SAAU1B,EAAgBP,cAAciC,SACxCC,IAAK3B,EAAgB2B,IACrBhB,MAAOX,EAAgBW,MACvBE,YAAaA,EACbH,KAAMA,QAAQkB,EACdhB,KAAMA,QAAQgB,EACd/B,MAAOoB,KACHrB,KAyEHiC,QApE2B3C,MAAOU,IAC3C,MAAMkC,KAAEA,SAAe7C,EAEvB,OAAOuC,EAAAO,cAACC,EAAW,CAACF,KAAMA,KAAUlC,KAiEhBqC,gBA9DA/C,MACpBgD,EAAiB,GACjBC,EAAsB,cAEtB,MAAMtC,MAAEA,SAAgBZ,EAClBmD,EAAWjC,OAAOC,KAAKP,GACvBwC,EAA6BC,EAAoBJ,GAEvD,OAAOE,EAASjB,OAA8B,CAACC,EAAKmB,IAC3CA,EAAIC,WAAWH,IAEpBjB,EAAIG,KAAK,CACLY,CAACA,GAAmBI,EAAIE,UAAUJ,EAA2B5B,OAAS,GAAGiC,MAAM,OAG5EtB,GANiDA,EAOzD,KA8CgCuB,YA3CnBzD,MAAOS,IACvB,MAAME,MAAEA,SAAgBZ,EAClBa,EAAqBC,EAAkBJ,GACvCK,EAAkBH,EAAMC,GAE9B,IAAKE,EACD,MAAM,IAAIC,MAAM,0BAA0BH,8BAO9C,aAJuB8C,EAAgB,CACnCjB,IAAK3B,EAAgB2B,IACrBD,SAAU1B,EAAgBP,cAAciC,YAgCMmB,YA3BlC3D,MAAOS,IACvB,MAAME,MAAEA,SAAgBZ,EAClBa,EAAqBC,EAAkBJ,GACvCK,EAAkBH,EAAMC,GAE9B,IAAKE,EACD,MAAM,IAAIC,MAAM,0BAA0BH,8BAG9C,MAAMa,EAAQX,EAAgBW,OACxBmC,KAAEA,SAAeC,EAAY/C,EAAgB2B,IAAK3B,EAAgBP,cAAciC,UAEtF,MAAO,CAAEf,QAAOqC,IAAKF,IAe0CG,mBAZxC/D,MAAOS,IAC9B,MAAME,MAAEA,SAAgBZ,EAClBa,EAAqBC,EAAkBJ,GACvCK,EAAkBH,EAAMC,GAE9B,IAAKE,EACD,MAAM,IAAIC,MAAM,0BAA0BH,8BAG9C,OAAOE"}
+{"version":3,"file":"initialize-robindoc.js","sources":["../../../src/core/utils/initialize-robindoc.tsx"],"sourcesContent":["import React from \"react\";\n\nimport { Article as ArticleBase, type ArticleProps as ArticlePropsBase } from \"@src/components/elements/article\";\nimport { Sidebar as SidebarBase, type SidebarProps as SidebarPropsBase } from \"@src/components/elements/sidebar\";\n\nimport { type StructureTemplate, type Options } from \"../types/initialize\";\nimport { parseStructure } from \"./parse-structure\";\nimport { getConfiguration } from \"./get-configuration\";\nimport { getMetadata as getMetadataBase } from \"./get-metadata\";\nimport { normalizePathname, removeTrailingSlash } from \"./path-tools\";\nimport { loadContent } from \"./load-content\";\n\ntype PageProps = Omit<Partial<ArticlePropsBase>, \"uri\" | \"content\" | \"provider\" | \"pathname\" | \"pages\"> & {\n    pathname: string;\n};\n\ntype SidebarProps = Omit<SidebarPropsBase, \"tree\">;\n\nconst loadStructure = async (structureTemplate: StructureTemplate) => {\n    let structure;\n    if (typeof structureTemplate === \"function\") {\n        structure = await structureTemplate();\n    } else {\n        structure = structureTemplate;\n    }\n\n    const configuration = getConfiguration(structure.configuration || {});\n\n    return parseStructure(structure.items || [], configuration);\n};\n\nexport const initializeRobindoc = (structureTemplate: StructureTemplate, options: Options = {}) => {\n    const structureParsedPromise = loadStructure(structureTemplate);\n    const matchingRules = options.matcher?.map((rule) => new RegExp(`^${rule.replace(/^\\^|\\$$/g, \"\")}$`));\n\n    const Page: React.FC<PageProps> = async ({ pathname, ...props }) => {\n        const pathnameNormalized = normalizePathname(pathname);\n        if (matchingRules && !matchingRules.every((rule) => rule.test(pathname))) {\n            const errorMessage = `Pathname \"${pathnameNormalized}\" doesn't pass matcher rules check`;\n            if (options.processError) return options.processError(404, errorMessage) || null;\n            throw new Error(errorMessage);\n        }\n\n        const { pages } = await structureParsedPromise;\n        const pageInstruction = pages[pathnameNormalized];\n\n        if (!pageInstruction) {\n            const errorMessage = `Can not find data for \"${pathnameNormalized}\". Please check structure`;\n            if (options.processError) return options.processError(404, errorMessage) || null;\n            throw new Error(errorMessage);\n        }\n\n        const paths = Object.keys(pages);\n        const targetPageIndex = paths.indexOf(pathnameNormalized);\n        const prevPagePathname = paths[targetPageIndex - 1];\n        const nextPagePathname = targetPageIndex < paths.length - 1 && paths[targetPageIndex + 1];\n        const prev = prevPagePathname && { pathname: prevPagePathname, title: pages[prevPagePathname].title };\n        const next = nextPagePathname && { pathname: nextPagePathname, title: pages[nextPagePathname].title };\n\n        const breadcrumbs = pageInstruction.crumbs.map((crumb) => ({ title: pages[crumb].title, pathname: crumb }));\n        const clientPages = Object.entries(pages).reduce<{ clientPath: string; origPath: string }[]>(\n            (acc, [clientPath, { origPath }]) => {\n                if (origPath) acc.push({ clientPath, origPath });\n                return acc;\n            },\n            [],\n        );\n\n        return (\n            <ArticleBase\n                pathname={pathnameNormalized}\n                provider={pageInstruction.configuration.provider}\n                uri={pageInstruction.uri}\n                title={pageInstruction.title}\n                breadcrumbs={breadcrumbs}\n                prev={prev || undefined}\n                next={next || undefined}\n                pages={clientPages}\n                {...props}\n            />\n        );\n    };\n\n    const Sidebar: React.FC<SidebarProps> = async (props) => {\n        const { tree } = await structureParsedPromise;\n\n        return <SidebarBase tree={tree} {...props} />;\n    };\n\n    const getStaticParams = async <T extends string = \"segments\">(\n        prefix: string = \"\",\n        segmentsParamKey: T = \"segments\" as T,\n    ) => {\n        const { pages } = await structureParsedPromise;\n        const pagesArr = Object.keys(pages);\n        const prefixWithoutTrailingSlash = removeTrailingSlash(prefix);\n\n        return pagesArr.reduce<Record<T, string[]>[]>((acc, cur) => {\n            if (!cur.startsWith(prefixWithoutTrailingSlash)) return acc;\n\n            acc.push({\n                [segmentsParamKey]: cur.substring(prefixWithoutTrailingSlash.length + 1).split(\"/\"),\n            } as Record<T, string[]>);\n\n            return acc;\n        }, []);\n    };\n\n    const getMetadata = async (pathname: string) => {\n        const pathnameNormalized = normalizePathname(pathname);\n        if (matchingRules && !matchingRules.every((rule) => rule.test(pathname))) {\n            const errorMessage = `Pathname \"${pathnameNormalized}\" doesn't pass matcher rules check`;\n            if (options.processError) return options.processError(404, errorMessage) || null;\n            throw new Error(errorMessage);\n        }\n\n        const { pages } = await structureParsedPromise;\n        const pageInstruction = pages[pathnameNormalized];\n\n        if (!pageInstruction) {\n            const errorMessage = `Can not find data for \"${pathnameNormalized}\". Please check structure`;\n            if (options.processError) return options.processError(404, errorMessage) || null;\n            throw new Error(errorMessage);\n        }\n\n        const metadata = await getMetadataBase({\n            uri: pageInstruction.uri,\n            provider: pageInstruction.configuration.provider,\n        });\n        return metadata;\n    };\n\n    const getPageData = async (pathname: string) => {\n        const pathnameNormalized = normalizePathname(pathname);\n        if (matchingRules && !matchingRules.every((rule) => rule.test(pathname))) {\n            const errorMessage = `Pathname \"${pathnameNormalized}\" doesn't pass matcher rules check`;\n            if (options.processError) return options.processError(404, errorMessage) || null;\n            throw new Error(errorMessage);\n        }\n\n        const { pages } = await structureParsedPromise;\n        const pageInstruction = pages[pathnameNormalized];\n\n        if (!pageInstruction) {\n            const errorMessage = `Can not find data for \"${pathnameNormalized}\". Please check structure`;\n            if (options.processError) return options.processError(404, errorMessage) || null;\n            throw new Error(errorMessage);\n        }\n\n        const title = pageInstruction.title;\n        const { data } = await loadContent(pageInstruction.uri, pageInstruction.configuration.provider);\n\n        return { title, raw: data };\n    };\n\n    const getPageInstruction = async (pathname: string) => {\n        const pathnameNormalized = normalizePathname(pathname);\n        if (matchingRules && !matchingRules.every((rule) => rule.test(pathname))) {\n            const errorMessage = `Pathname \"${pathnameNormalized}\" doesn't pass matcher rules check`;\n            if (options.processError) return options.processError(404, errorMessage) || null;\n            throw new Error(errorMessage);\n        }\n\n        const { pages } = await structureParsedPromise;\n        const pageInstruction = pages[pathnameNormalized];\n\n        if (!pageInstruction) {\n            const errorMessage = `Can not find data for \"${pathnameNormalized}\". Please check structure`;\n            if (options.processError) return options.processError(404, errorMessage) || null;\n            throw new Error(errorMessage);\n        }\n\n        return pageInstruction;\n    };\n\n    return { Page, Sidebar, getStaticParams, getMetadata, getPageData, getPageInstruction };\n};\n"],"names":["initializeRobindoc","structureTemplate","options","structureParsedPromise","async","structure","configuration","getConfiguration","parseStructure","items","loadStructure","matchingRules","matcher","map","rule","RegExp","replace","Page","pathname","props","pathnameNormalized","normalizePathname","every","test","errorMessage","processError","Error","pages","pageInstruction","paths","Object","keys","targetPageIndex","indexOf","prevPagePathname","nextPagePathname","length","prev","title","next","breadcrumbs","crumbs","crumb","clientPages","entries","reduce","acc","clientPath","origPath","push","React","ArticleBase","provider","uri","undefined","Sidebar","tree","createElement","SidebarBase","getStaticParams","prefix","segmentsParamKey","pagesArr","prefixWithoutTrailingSlash","removeTrailingSlash","cur","startsWith","substring","split","getMetadata","getMetadataBase","getPageData","data","loadContent","raw","getPageInstruction"],"mappings":"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"}

package/lib/styles.css

@@ -87,41 +87,6 @@
     width: 100%;
     left: 0;
   }
-}.r-footer {
-  border-top: 1px solid var(--r-main-300);
-  padding-top: 16px;
-  padding-bottom: 16px;
-}
-
-.r-footer-row {
-  display: flex;
-  justify-content: space-between;
-  align-items: center;
-  gap: 32px;
-}
-
-.r-footer-additional {
-  margin-top: 20px;
-  justify-content: flex-end;
-}
-
-.r-copyright {
-  color: var(--r-main-800);
-}
-
-.r-powered {
-  font-size: 14px;
-  display: block;
-  color: var(--r-main-600);
-}
-
-.r-powered-link {
-  font-weight: 600;
-  text-decoration: none;
-  color: var(--r-main-950);
-}
-.r-powered-link:hover {
-  color: var(--r-primary-900);
 }.r-root {
   --r-header-height: 60px;
   position: relative;
@@ -376,6 +341,41 @@
     grid-template-columns: 1fr 640px 1fr;
     grid-template-rows: auto 1fr auto;
   }
+}.r-footer {
+  border-top: 1px solid var(--r-main-300);
+  padding-top: 16px;
+  padding-bottom: 16px;
+}
+
+.r-footer-row {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  gap: 32px;
+}
+
+.r-footer-additional {
+  margin-top: 20px;
+  justify-content: flex-end;
+}
+
+.r-copyright {
+  color: var(--r-main-800);
+}
+
+.r-powered {
+  font-size: 14px;
+  display: block;
+  color: var(--r-main-600);
+}
+
+.r-powered-link {
+  font-weight: 600;
+  text-decoration: none;
+  color: var(--r-main-950);
+}
+.r-powered-link:hover {
+  color: var(--r-primary-900);
 }.r-blog-container {
   min-height: calc(100dvh - var(--r-header-height));
   overflow-wrap: break-word;
@@ -390,10 +390,6 @@
     grid-template-columns: 760px 220px;
     grid-template-rows: auto 1fr auto;
   }
-}.r-page-container {
-  min-height: calc(100dvh - var(--r-header-height));
-  overflow-wrap: break-word;
-  box-sizing: border-box;
 }.keylink-to-content {
   position: absolute !important;
   top: 8px;
@@ -453,6 +449,10 @@
 
 .r-label-text {
   vertical-align: middle;
+}.r-page-container {
+  min-height: calc(100dvh - var(--r-header-height));
+  overflow-wrap: break-word;
+  box-sizing: border-box;
 }.r-sidebar {
   grid-area: sidebar;
   box-sizing: border-box;
@@ -929,24 +929,6 @@
   font-size: 14px;
   color: var(--r-main-600);
   margin: 12px 0 0;
-}.r-header-social {
-  display: flex;
-  flex: 1;
-  justify-content: flex-end;
-}
-@media screen and (width >= 1024px) {
-  .r-header-social {
-    flex: none;
-    justify-content: unset;
-  }
-}
-
-.r-header-social-git {
-  color: var(--r-main-700);
-  transition: color 0.2s;
-}
-.r-header-social-git:hover, .r-header-social-git:focus {
-  color: var(--r-main-950);
 }.r-dropdown {
   position: relative;
   color: var(--r-main-600);
@@ -1026,6 +1008,24 @@
 
 .r-dropdown-link._active {
   color: var(--r-primary-700);
+}.r-header-social {
+  display: flex;
+  flex: 1;
+  justify-content: flex-end;
+}
+@media screen and (width >= 1024px) {
+  .r-header-social {
+    flex: none;
+    justify-content: unset;
+  }
+}
+
+.r-header-social-git {
+  color: var(--r-main-700);
+  transition: color 0.2s;
+}
+.r-header-social-git:hover, .r-header-social-git:focus {
+  color: var(--r-main-950);
 }.r-container {
   max-width: 1180px;
   padding-right: 12px;
@@ -1473,8 +1473,6 @@
 }.r-last-modified {
   color: var(--r-main-700);
   margin-block-start: 16px;
-}.r-git-logo {
-  display: block;
 }.r-external-mark {
   position: relative;
   vertical-align: text-top;
@@ -1506,6 +1504,8 @@
   background-color: currentColor;
   border-radius: 0 0 0 4px;
   box-sizing: border-box;
+}.r-git-logo {
+  display: block;
 }.r-anchor-heading:hover .r-anchor-heading-link {
   visibility: visible;
   opacity: 1;
@@ -1755,22 +1755,6 @@
 
 .r-tab-header-code {
   font-family: var(--monospace-font, monospace, monospace);
-}.r-kbd-container {
-  display: flex;
-  gap: 4px;
-  font-size: 14px;
-  cursor: pointer;
-}
-.r-kbd-container:hover {
-  color: var(--r-main-950);
-}.r-kbd-key {
-  background-color: var(--r-main-200);
-  font-size: 12px;
-  border-radius: 4px;
-  padding: 5px 8px;
-  min-width: 24px;
-  text-align: center;
-  box-sizing: border-box;
 }.r-modal {
   position: fixed;
   left: 0;
@@ -1806,6 +1790,50 @@
   .r-modal._visible {
     transform: translateX(-50%) scale(1);
   }
+}.r-kbd-container {
+  display: flex;
+  gap: 4px;
+  font-size: 14px;
+  cursor: pointer;
+}
+.r-kbd-container:hover {
+  color: var(--r-main-950);
+}.r-kbd-key {
+  background-color: var(--r-main-200);
+  font-size: 12px;
+  border-radius: 4px;
+  padding: 5px 8px;
+  min-width: 24px;
+  text-align: center;
+  box-sizing: border-box;
+}.r-copy-text {
+  position: relative;
+  cursor: pointer;
+  background: none;
+  border: 0;
+  padding: 0;
+  font: inherit;
+  padding: 6px 0;
+}
+.r-copy-text:hover {
+  color: var(--r-main-950);
+}
+.r-copy-text::before {
+  content: "";
+  position: absolute;
+  bottom: 0;
+  left: 0;
+  width: 100%;
+  height: 1px;
+  background: linear-gradient(to right, currentColor 30%, transparent 0%, transparent 80%, currentColor 80%) repeat-x 0px/8px;
+  transition: background 0.2s;
+  box-sizing: border-box;
+  opacity: 0.6;
+}
+
+.r-copy-text:active,
+.r-copy-text._active {
+  color: var(--r-success);
 }.r-copy-button {
   position: relative;
   padding: 6px;
@@ -1849,34 +1877,6 @@
 
 .r-copy-button-svg {
   display: block;
-}.r-copy-text {
-  position: relative;
-  cursor: pointer;
-  background: none;
-  border: 0;
-  padding: 0;
-  font: inherit;
-  padding: 6px 0;
-}
-.r-copy-text:hover {
-  color: var(--r-main-950);
-}
-.r-copy-text::before {
-  content: "";
-  position: absolute;
-  bottom: 0;
-  left: 0;
-  width: 100%;
-  height: 1px;
-  background: linear-gradient(to right, currentColor 30%, transparent 0%, transparent 80%, currentColor 80%) repeat-x 0px/8px;
-  transition: background 0.2s;
-  box-sizing: border-box;
-  opacity: 0.6;
-}
-
-.r-copy-text:active,
-.r-copy-text._active {
-  color: var(--r-success);
 }.r-content-link {
   text-decoration: none;
   color: inherit;
@@ -1941,26 +1941,28 @@
   padding-inline-start: 2rem;
   margin-block-start: 1em;
   margin-block-end: 1em;
-}.r-ol {
-  padding-inline-start: 2rem;
-  margin-block-start: 1em;
-  margin-block-end: 1em;
 }.r-table {
   min-width: 100%;
   text-align: left;
   border-collapse: collapse;
   box-sizing: border-box;
+}.r-ol {
+  padding-inline-start: 2rem;
+  margin-block-start: 1em;
+  margin-block-end: 1em;
 }.r-td {
   padding: 6px 12px;
   border-bottom: 1px solid var(--r-main-400);
   border-collapse: collapse;
+}.r-thead {
+  background-color: var(--r-main-100);
 }.r-th {
   padding: 6px 12px;
   border-top: 1px solid var(--r-main-500);
   border-bottom: 1px solid var(--r-main-500);
   border-collapse: collapse;
-}.r-thead {
-  background-color: var(--r-main-100);
+}.r-task-ol {
+  list-style: none;
 }.r-task-li.r-task-li {
   margin-block-start: 2px;
   margin-block-end: 2px;
@@ -1990,8 +1992,6 @@
 
 .r-task-label-text {
   vertical-align: middle;
-}.r-task-ol {
-  list-style: none;
 }.r-task-ul {
   list-style: none;
 }.r-backdrop {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "robindoc",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "Robindoc is a framework for automatically creating documentation websites based on markdown files, built on React.js Server Components",
   "main": "./lib/index.js",
   "scripts": {