elseware-docs-engine 1.1.0 → 1.1.2

package/dist/index.d.mts

@@ -34,7 +34,10 @@ interface DocsContextType {
 
 declare function useDocs(): DocsContextType;
 
-declare function useCurrentPage(): DocsPage | null;
+interface UseCurrentPageProps {
+    debug?: boolean;
+}
+declare function useCurrentPage({ debug }?: UseCurrentPageProps): DocsPage | null;
 
 declare function useSidebar(): elseware_ui.MenuNode[];
 
@@ -44,12 +47,12 @@ interface GenerateDocsRoutesProps {
 }
 declare function generateDocsRoutes({ basePath, element, }: GenerateDocsRoutesProps): RouteObject[];
 
-declare function findPageByPath(nodes: DocsNode[], targetPath: string, parentPath?: string): DocsPage | null;
 interface ResolvedDocsPage extends DocsPage {
     id: string;
     fullPath: string;
 }
 declare function isPage(node: DocsNode): node is DocsPage;
+declare function findPageByPath(nodes: DocsNode[], targetPath: string, parentPath?: string): DocsPage | null;
 declare function resolveDocs(nodes: DocsNode[], parentPath?: string): ResolvedDocsPage[];
 declare function findFirstPage(nodes: DocsNode[], parentPath?: string): string | null;
 

package/dist/index.d.ts

@@ -34,7 +34,10 @@ interface DocsContextType {
 
 declare function useDocs(): DocsContextType;
 
-declare function useCurrentPage(): DocsPage | null;
+interface UseCurrentPageProps {
+    debug?: boolean;
+}
+declare function useCurrentPage({ debug }?: UseCurrentPageProps): DocsPage | null;
 
 declare function useSidebar(): elseware_ui.MenuNode[];
 
@@ -44,12 +47,12 @@ interface GenerateDocsRoutesProps {
 }
 declare function generateDocsRoutes({ basePath, element, }: GenerateDocsRoutesProps): RouteObject[];
 
-declare function findPageByPath(nodes: DocsNode[], targetPath: string, parentPath?: string): DocsPage | null;
 interface ResolvedDocsPage extends DocsPage {
     id: string;
     fullPath: string;
 }
 declare function isPage(node: DocsNode): node is DocsPage;
+declare function findPageByPath(nodes: DocsNode[], targetPath: string, parentPath?: string): DocsPage | null;
 declare function resolveDocs(nodes: DocsNode[], parentPath?: string): ResolvedDocsPage[];
 declare function findFirstPage(nodes: DocsNode[], parentPath?: string): string | null;
 

package/dist/index.js

@@ -1,3 +1,3 @@
-'use strict';require('elseware-ui/styles.css');var react=require('react'),jsxRuntime=require('react/jsx-runtime'),elsewareUi=require('elseware-ui'),reactRouterDom=require('react-router-dom');var a=react.createContext(void 0);function h({docs:e,basePath:t,children:r}){return jsxRuntime.jsx(a.Provider,{value:{docs:e,basePath:t},children:r})}var l=h;function m({docs:e,basePath:t="/docs",children:r}){let o=t.startsWith("/")?t:`/${t}`;return jsxRuntime.jsx(l,{docs:e,basePath:o,children:r})}var b=m;function x({content:e}){return jsxRuntime.jsx(elsewareUi.DocumentationPanel,{value:e})}var v=x;function s(){let e=react.useContext(a);if(!e)throw new Error("useDocs must be used within DocsProvider");return e}function d(e,t,r=""){for(let o of e){let i=`${r}${o.path}`.replace(/\/+/g,"/");if(n(o)){if(i.replace(/^\//,"")===t.replace(/^\//,""))return {...o,path:i};continue}let c=d(o.children,t,i);if(c)return c}return null}function n(e){return "content"in e}function P(e,t=""){let r=[];return e.forEach(o=>{let i=`${t}${o.path}`.replace(/\/+/g,"/");if(n(o)){r.push({...o,id:i.replace(/\//g,"-").replace(/^-/,""),fullPath:i});return}r.push(...P(o.children,i));}),r}function z(e,t=""){for(let r of e){let o=`${t}${r.path}`.replace(/\/+/g,"/");if(n(r))return o;let i=z(r.children,o);if(i)return i}return null}function J(){let{docs:e}=s(),r=reactRouterDom.useParams()["*"]??"";return d(e,r)}function p(e,t,r=""){return e.map(o=>{let i=`${r}${o.path}`.replace(/\/+/g,"/");return n(o)?{type:"item",name:o.title,to:`/${t}${i}`.replace(/\/+/g,"/")}:{type:"group",name:o.title,items:p(o.children,t,i)}})}function g(e,t){return p(e,t)}function Z(){let{docs:e,basePath:t}=s();return g(e,t)}function te({basePath:e="/docs",element:t}){return [{path:`${e}/*`,element:t}]}
-exports.DocsEngine=b;exports.DocsPageRenderer=v;exports.findFirstPage=z;exports.findPageByPath=d;exports.generateDocsRoutes=te;exports.isPage=n;exports.resolveDocs=P;exports.useCurrentPage=J;exports.useDocs=s;exports.useSidebar=Z;//# sourceMappingURL=index.js.map
+'use strict';require('elseware-ui/styles.css');var react=require('react'),jsxRuntime=require('react/jsx-runtime'),elsewareUi=require('elseware-ui'),reactRouterDom=require('react-router-dom');var a=react.createContext(void 0);function b({docs:e,basePath:t,children:r}){return jsxRuntime.jsx(a.Provider,{value:{docs:e,basePath:t},children:r})}var g=b;function y({docs:e,basePath:t="/docs",children:r}){let o=t.startsWith("/")?t:`/${t}`;return jsxRuntime.jsx(g,{docs:e,basePath:o,children:r})}var x=y;function k({content:e}){return jsxRuntime.jsx(elsewareUi.DocumentationPanel,{value:e})}var D=k;function s(){let e=react.useContext(a);if(!e)throw new Error("useDocs must be used within DocsProvider");return e}function c(e){return "/"+e.replace(/\/+/g,"/").replace(/^\/|\/$/g,"")}function n(e){return "content"in e}function d(e,t,r=""){let o=c(t);for(let i of e){let l=c(`${r}/${i.path}`);if(n(i)){if(l===o)return i}else {let p=d(i.children,t,l);if(p)return p}}return null}function R(e,t=""){let r=[];return e.forEach(o=>{let i=c(`${t}/${o.path}`);if(n(o)){r.push({...o,id:i.replace(/\//g,"-").replace(/^-/,""),fullPath:i});return}r.push(...R(o.children,i));}),r}function S(e,t=""){for(let r of e){let o=c(`${t}/${r.path}`);if(n(r))return o;let i=S(r.children,o);if(i)return i}return null}function X({debug:e=false}={}){let{docs:t}=s(),r=reactRouterDom.useParams(),o=r["*"]??"";return e&&(console.log("params",r),console.log("pagePath",o)),d(t,o)}function f(e){return "/"+e.replace(/\/+/g,"/").replace(/^\/|\/$/g,"")}function h(e,t,r=""){return e.map(o=>{let i=f(`${r}/${o.path}`);return n(o)?{type:"item",name:o.title,to:f(`${t}/${i}`)}:{type:"group",name:o.title,items:h(o.children,t,i)}})}function u(e,t){return h(e,t)}function re(){let{docs:e,basePath:t}=s();return u(e,t)}function $(e){return e.replace(/^\/+/,"").replace(/\/+$/,"")}function ne({basePath:e="/docs",element:t}){return [{path:`${$(e)}/*`,element:t}]}
+exports.DocsEngine=x;exports.DocsPageRenderer=D;exports.findFirstPage=S;exports.findPageByPath=d;exports.generateDocsRoutes=ne;exports.isPage=n;exports.resolveDocs=R;exports.useCurrentPage=X;exports.useDocs=s;exports.useSidebar=re;//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context/DocsContext.ts","../src/context/DocsProvider.tsx","../src/engine/DocsEngine.tsx","../src/components/DocsPageRenderer.tsx","../src/hooks/useDocs.ts","../src/utils/page.ts","../src/hooks/useCurrentPage.ts","../src/utils/generateSidebar.ts","../src/hooks/useSidebar.ts","../src/utils/generateRoutes.tsx"],"names":["DocsContext","createContext","DocsProvider","docs","basePath","children","jsx","DocsProvider_default","DocsEngine","normalizedBasePath","DocsEngine_default","DocsPageRenderer","content","DocumentationPanel","DocsPageRenderer_default","useDocs","context","useContext","findPageByPath","nodes","targetPath","parentPath","node","fullPath","isPage","found","resolveDocs","pages","currentPath","findFirstPage","nested","useCurrentPage","pagePath","useParams","mapNodes","generateSidebar","useSidebar","generateDocsRoutes","element"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext } from \"react\";\nimport { DocsCategory } from \"../types/docs\";\n\nexport interface DocsContextType {\n  docs: DocsCategory[];\n  basePath: string;\n}\n\nexport const DocsContext = createContext<DocsContextType | undefined>(\n  undefined,\n);\n","import React from \"react\";\n\nimport { DocsContext } from \"./DocsContext\";\n\nimport { DocsCategory } from \"../types/docs\";\n\ninterface DocsProviderProps {\n  docs: DocsCategory[];\n  basePath: string;\n  children: React.ReactNode;\n}\n\nfunction DocsProvider({ docs, basePath, children }: DocsProviderProps) {\n  return (\n    <DocsContext.Provider value={{ docs, basePath }}>\n      {children}\n    </DocsContext.Provider>\n  );\n}\n\nexport default DocsProvider;\n","import React from \"react\";\n\nimport DocsProvider from \"../context/DocsProvider\";\n\nimport { DocsCategory } from \"../types/docs\";\n\ninterface DocsEngineProps {\n  docs: DocsCategory[];\n  basePath?: string;\n  children: React.ReactNode;\n}\n\nfunction DocsEngine({ docs, basePath = \"/docs\", children }: DocsEngineProps) {\n  const normalizedBasePath = basePath.startsWith(\"/\")\n    ? basePath\n    : `/${basePath}`;\n\n  return (\n    <DocsProvider docs={docs} basePath={normalizedBasePath}>\n      {children}\n    </DocsProvider>\n  );\n}\n\nexport default DocsEngine;\n","import React from \"react\";\n\nimport { DocumentationPanel } from \"elseware-ui\";\n\ninterface DocsPageRendererProps {\n  content: string;\n}\n\nfunction DocsPageRenderer({\n  content,\n}: DocsPageRendererProps) {\n  return <DocumentationPanel value={content} />;\n}\n\nexport default DocsPageRenderer;","import { useContext } from \"react\";\n\nimport { DocsContext } from \"../context/DocsContext\";\n\nexport function useDocs() {\n  const context = useContext(DocsContext);\n\n  if (!context) {\n    throw new Error(\"useDocs must be used within DocsProvider\");\n  }\n\n  return context;\n}\n","import { DocsNode, DocsPage } from \"../types/docs\";\n\nexport function findPageByPath(\n  nodes: DocsNode[],\n  targetPath: string,\n  parentPath = \"\",\n): DocsPage | null {\n  for (const node of nodes) {\n    const fullPath = `${parentPath}${node.path}`.replace(/\\/+/g, \"/\");\n\n    if (isPage(node)) {\n      if (fullPath.replace(/^\\//, \"\") === targetPath.replace(/^\\//, \"\")) {\n        return {\n          ...node,\n          path: fullPath,\n        };\n      }\n\n      continue;\n    }\n\n    const found = findPageByPath(node.children, targetPath, fullPath);\n\n    if (found) {\n      return found;\n    }\n  }\n\n  return null;\n}\n\nexport interface ResolvedDocsPage extends DocsPage {\n  id: string;\n  fullPath: string;\n}\n\nexport function isPage(node: DocsNode): node is DocsPage {\n  return \"content\" in node;\n}\n\nexport function resolveDocs(\n  nodes: DocsNode[],\n  parentPath = \"\",\n): ResolvedDocsPage[] {\n  const pages: ResolvedDocsPage[] = [];\n\n  nodes.forEach((node) => {\n    const currentPath = `${parentPath}${node.path}`.replace(/\\/+/g, \"/\");\n\n    if (isPage(node)) {\n      pages.push({\n        ...node,\n        id: currentPath.replace(/\\//g, \"-\").replace(/^-/, \"\"),\n        fullPath: currentPath,\n      });\n\n      return;\n    }\n\n    pages.push(...resolveDocs(node.children, currentPath));\n  });\n\n  return pages;\n}\n\nexport function findFirstPage(\n  nodes: DocsNode[],\n  parentPath = \"\",\n): string | null {\n  for (const node of nodes) {\n    const fullPath = `${parentPath}${node.path}`.replace(/\\/+/g, \"/\");\n\n    if (isPage(node)) {\n      return fullPath;\n    }\n\n    const nested = findFirstPage(node.children, fullPath);\n\n    if (nested) {\n      return nested;\n    }\n  }\n\n  return null;\n}\n","import { useParams } from \"react-router-dom\";\n\nimport { useDocs } from \"./useDocs\";\n\nimport { findPageByPath } from \"../utils/page\";\n\nexport function useCurrentPage() {\n  const { docs } = useDocs();\n\n  const params = useParams();\n\n  const pagePath = params[\"*\"] ?? \"\";\n\n  return findPageByPath(docs, pagePath);\n}","import { MenuNode } from \"elseware-ui\";\n\nimport { DocsCategory, DocsNode } from \"../types/docs\";\n\nimport { isPage } from \"./page\";\n\nfunction mapNodes(\n  nodes: DocsNode[],\n  basePath: string,\n  parentPath = \"\",\n): MenuNode[] {\n  return nodes.map((node) => {\n    const fullPath = `${parentPath}${node.path}`.replace(/\\/+/g, \"/\");\n\n    if (isPage(node)) {\n      return {\n        type: \"item\",\n        name: node.title,\n        to: `/${basePath}${fullPath}`.replace(/\\/+/g, \"/\"),\n      };\n    }\n\n    return {\n      type: \"group\",\n      name: node.title,\n      items: mapNodes(node.children, basePath, fullPath),\n    };\n  });\n}\n\nexport function generateSidebar(\n  docs: DocsCategory[],\n\n  basePath: string,\n): MenuNode[] {\n  return mapNodes(docs, basePath);\n}\n","import { generateSidebar } from \"../utils/generateSidebar\";\n\nimport { useDocs } from \"./useDocs\";\n\nexport function useSidebar() {\n  const { docs, basePath } = useDocs();\n\n  return generateSidebar(docs, basePath);\n}","import React from \"react\";\n\nimport { RouteObject } from \"react-router-dom\";\n\ninterface GenerateDocsRoutesProps {\n  basePath?: string;\n  element: React.ReactNode;\n}\n\nexport function generateDocsRoutes({\n  basePath = \"/docs\",\n  element,\n}: GenerateDocsRoutesProps): RouteObject[] {\n  return [\n    {\n      path: `${basePath}/*`,\n      element,\n    },\n  ];\n}"]}
+{"version":3,"sources":["../src/context/DocsContext.ts","../src/context/DocsProvider.tsx","../src/engine/DocsEngine.tsx","../src/components/DocsPageRenderer.tsx","../src/hooks/useDocs.ts","../src/utils/page.ts","../src/hooks/useCurrentPage.ts","../src/utils/generateSidebar.ts","../src/hooks/useSidebar.ts","../src/utils/generateRoutes.tsx"],"names":["DocsContext","createContext","DocsProvider","docs","basePath","children","jsx","DocsProvider_default","DocsEngine","normalizedBasePath","DocsEngine_default","DocsPageRenderer","content","DocumentationPanel","DocsPageRenderer_default","useDocs","context","useContext","normalizePath","path","isPage","node","findPageByPath","nodes","targetPath","parentPath","normalizedTarget","currentPath","result","resolveDocs","pages","findFirstPage","child","useCurrentPage","debug","params","useParams","pagePath","mapNodes","fullPath","generateSidebar","useSidebar","normalizeRoutePath","generateDocsRoutes","element"],"mappings":"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","file":"index.js","sourcesContent":["import { createContext } from \"react\";\nimport { DocsCategory } from \"../types/docs\";\n\nexport interface DocsContextType {\n  docs: DocsCategory[];\n  basePath: string;\n}\n\nexport const DocsContext = createContext<DocsContextType | undefined>(\n  undefined,\n);\n","import React from \"react\";\n\nimport { DocsContext } from \"./DocsContext\";\n\nimport { DocsCategory } from \"../types/docs\";\n\ninterface DocsProviderProps {\n  docs: DocsCategory[];\n  basePath: string;\n  children: React.ReactNode;\n}\n\nfunction DocsProvider({ docs, basePath, children }: DocsProviderProps) {\n  return (\n    <DocsContext.Provider value={{ docs, basePath }}>\n      {children}\n    </DocsContext.Provider>\n  );\n}\n\nexport default DocsProvider;\n","import React from \"react\";\n\nimport DocsProvider from \"../context/DocsProvider\";\n\nimport { DocsCategory } from \"../types/docs\";\n\ninterface DocsEngineProps {\n  docs: DocsCategory[];\n  basePath?: string;\n  children: React.ReactNode;\n}\n\nfunction DocsEngine({ docs, basePath = \"/docs\", children }: DocsEngineProps) {\n  const normalizedBasePath = basePath.startsWith(\"/\")\n    ? basePath\n    : `/${basePath}`;\n\n  return (\n    <DocsProvider docs={docs} basePath={normalizedBasePath}>\n      {children}\n    </DocsProvider>\n  );\n}\n\nexport default DocsEngine;\n","import React from \"react\";\n\nimport { DocumentationPanel } from \"elseware-ui\";\n\ninterface DocsPageRendererProps {\n  content: string;\n}\n\nfunction DocsPageRenderer({\n  content,\n}: DocsPageRendererProps) {\n  return <DocumentationPanel value={content} />;\n}\n\nexport default DocsPageRenderer;","import { useContext } from \"react\";\n\nimport { DocsContext } from \"../context/DocsContext\";\n\nexport function useDocs() {\n  const context = useContext(DocsContext);\n\n  if (!context) {\n    throw new Error(\"useDocs must be used within DocsProvider\");\n  }\n\n  return context;\n}\n","import { DocsNode, DocsPage } from \"../types/docs\";\n\nfunction normalizePath(path: string) {\n  return \"/\" + path.replace(/\\/+/g, \"/\").replace(/^\\/|\\/$/g, \"\");\n}\n\nexport interface ResolvedDocsPage extends DocsPage {\n  id: string;\n  fullPath: string;\n}\n\nexport function isPage(node: DocsNode): node is DocsPage {\n  return \"content\" in node;\n}\n\nexport function findPageByPath(\n  nodes: DocsNode[],\n  targetPath: string,\n  parentPath = \"\",\n): DocsPage | null {\n  const normalizedTarget = normalizePath(targetPath);\n\n  for (const node of nodes) {\n    const currentPath = normalizePath(`${parentPath}/${node.path}`);\n\n    if (isPage(node)) {\n      if (currentPath === normalizedTarget) {\n        return node;\n      }\n    } else {\n      const result = findPageByPath(node.children, targetPath, currentPath);\n\n      if (result) {\n        return result;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function resolveDocs(\n  nodes: DocsNode[],\n  parentPath = \"\",\n): ResolvedDocsPage[] {\n  const pages: ResolvedDocsPage[] = [];\n\n  nodes.forEach((node) => {\n    const currentPath = normalizePath(`${parentPath}/${node.path}`);\n\n    if (isPage(node)) {\n      pages.push({\n        ...node,\n\n        id: currentPath.replace(/\\//g, \"-\").replace(/^-/, \"\"),\n\n        fullPath: currentPath,\n      });\n\n      return;\n    }\n\n    pages.push(...resolveDocs(node.children, currentPath));\n  });\n\n  return pages;\n}\n\nexport function findFirstPage(\n  nodes: DocsNode[],\n  parentPath = \"\",\n): string | null {\n  for (const node of nodes) {\n    const currentPath = normalizePath(`${parentPath}/${node.path}`);\n\n    if (isPage(node)) {\n      return currentPath;\n    }\n\n    const child = findFirstPage(node.children, currentPath);\n\n    if (child) {\n      return child;\n    }\n  }\n\n  return null;\n}\n","import { useParams } from \"react-router-dom\";\n\nimport { useDocs } from \"./useDocs\";\n\nimport { findPageByPath } from \"../utils/page\";\n\ninterface UseCurrentPageProps {\n  debug?: boolean;\n}\n\nexport function useCurrentPage({ debug = false }: UseCurrentPageProps = {}) {\n  const { docs } = useDocs();\n\n  const params = useParams();\n\n  const pagePath = params[\"*\"] ?? \"\";\n\n  if (debug) {\n    console.log(\"params\", params);\n\n    console.log(\"pagePath\", pagePath);\n  }\n\n  return findPageByPath(docs, pagePath);\n}\n","import { MenuNode } from \"elseware-ui\";\n\nimport { DocsCategory, DocsNode } from \"../types/docs\";\n\nimport { isPage } from \"./page\";\n\nfunction normalizePath(path: string) {\n  return \"/\" + path.replace(/\\/+/g, \"/\").replace(/^\\/|\\/$/g, \"\");\n}\n\nfunction mapNodes(\n  nodes: DocsNode[],\n  basePath: string,\n  parentPath = \"\",\n): MenuNode[] {\n  return nodes.map((node) => {\n    const fullPath = normalizePath(`${parentPath}/${node.path}`);\n\n    if (isPage(node)) {\n      return {\n        type: \"item\",\n\n        name: node.title,\n\n        to: normalizePath(`${basePath}/${fullPath}`),\n      };\n    }\n\n    return {\n      type: \"group\",\n\n      name: node.title,\n\n      items: mapNodes(node.children, basePath, fullPath),\n    };\n  });\n}\n\nexport function generateSidebar(\n  docs: DocsCategory[],\n  basePath: string,\n): MenuNode[] {\n  return mapNodes(docs, basePath);\n}\n","import { generateSidebar } from \"../utils/generateSidebar\";\n\nimport { useDocs } from \"./useDocs\";\n\nexport function useSidebar() {\n  const { docs, basePath } = useDocs();\n\n  return generateSidebar(docs, basePath);\n}","import React from \"react\";\n\nimport { RouteObject } from \"react-router-dom\";\n\ninterface GenerateDocsRoutesProps {\n  basePath?: string;\n  element: React.ReactNode;\n}\n\nfunction normalizeRoutePath(path: string) {\n  return path.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\");\n}\n\nexport function generateDocsRoutes({\n  basePath = \"/docs\",\n  element,\n}: GenerateDocsRoutesProps): RouteObject[] {\n  const normalizedBase = normalizeRoutePath(basePath);\n\n  return [\n    {\n      path: `${normalizedBase}/*`,\n      element,\n    },\n  ];\n}\n"]}

package/dist/index.mjs

@@ -1,3 +1,3 @@
-import'elseware-ui/styles.css';import {createContext,useContext}from'react';import {jsx}from'react/jsx-runtime';import {DocumentationPanel}from'elseware-ui';import {useParams}from'react-router-dom';var a=createContext(void 0);function h({docs:e,basePath:t,children:r}){return jsx(a.Provider,{value:{docs:e,basePath:t},children:r})}var l=h;function m({docs:e,basePath:t="/docs",children:r}){let o=t.startsWith("/")?t:`/${t}`;return jsx(l,{docs:e,basePath:o,children:r})}var b=m;function x({content:e}){return jsx(DocumentationPanel,{value:e})}var v=x;function s(){let e=useContext(a);if(!e)throw new Error("useDocs must be used within DocsProvider");return e}function d(e,t,r=""){for(let o of e){let i=`${r}${o.path}`.replace(/\/+/g,"/");if(n(o)){if(i.replace(/^\//,"")===t.replace(/^\//,""))return {...o,path:i};continue}let c=d(o.children,t,i);if(c)return c}return null}function n(e){return "content"in e}function P(e,t=""){let r=[];return e.forEach(o=>{let i=`${t}${o.path}`.replace(/\/+/g,"/");if(n(o)){r.push({...o,id:i.replace(/\//g,"-").replace(/^-/,""),fullPath:i});return}r.push(...P(o.children,i));}),r}function z(e,t=""){for(let r of e){let o=`${t}${r.path}`.replace(/\/+/g,"/");if(n(r))return o;let i=z(r.children,o);if(i)return i}return null}function J(){let{docs:e}=s(),r=useParams()["*"]??"";return d(e,r)}function p(e,t,r=""){return e.map(o=>{let i=`${r}${o.path}`.replace(/\/+/g,"/");return n(o)?{type:"item",name:o.title,to:`/${t}${i}`.replace(/\/+/g,"/")}:{type:"group",name:o.title,items:p(o.children,t,i)}})}function g(e,t){return p(e,t)}function Z(){let{docs:e,basePath:t}=s();return g(e,t)}function te({basePath:e="/docs",element:t}){return [{path:`${e}/*`,element:t}]}
-export{b as DocsEngine,v as DocsPageRenderer,z as findFirstPage,d as findPageByPath,te as generateDocsRoutes,n as isPage,P as resolveDocs,J as useCurrentPage,s as useDocs,Z as useSidebar};//# sourceMappingURL=index.mjs.map
+import'elseware-ui/styles.css';import {createContext,useContext}from'react';import {jsx}from'react/jsx-runtime';import {DocumentationPanel}from'elseware-ui';import {useParams}from'react-router-dom';var a=createContext(void 0);function b({docs:e,basePath:t,children:r}){return jsx(a.Provider,{value:{docs:e,basePath:t},children:r})}var g=b;function y({docs:e,basePath:t="/docs",children:r}){let o=t.startsWith("/")?t:`/${t}`;return jsx(g,{docs:e,basePath:o,children:r})}var x=y;function k({content:e}){return jsx(DocumentationPanel,{value:e})}var D=k;function s(){let e=useContext(a);if(!e)throw new Error("useDocs must be used within DocsProvider");return e}function c(e){return "/"+e.replace(/\/+/g,"/").replace(/^\/|\/$/g,"")}function n(e){return "content"in e}function d(e,t,r=""){let o=c(t);for(let i of e){let l=c(`${r}/${i.path}`);if(n(i)){if(l===o)return i}else {let p=d(i.children,t,l);if(p)return p}}return null}function R(e,t=""){let r=[];return e.forEach(o=>{let i=c(`${t}/${o.path}`);if(n(o)){r.push({...o,id:i.replace(/\//g,"-").replace(/^-/,""),fullPath:i});return}r.push(...R(o.children,i));}),r}function S(e,t=""){for(let r of e){let o=c(`${t}/${r.path}`);if(n(r))return o;let i=S(r.children,o);if(i)return i}return null}function X({debug:e=false}={}){let{docs:t}=s(),r=useParams(),o=r["*"]??"";return e&&(console.log("params",r),console.log("pagePath",o)),d(t,o)}function f(e){return "/"+e.replace(/\/+/g,"/").replace(/^\/|\/$/g,"")}function h(e,t,r=""){return e.map(o=>{let i=f(`${r}/${o.path}`);return n(o)?{type:"item",name:o.title,to:f(`${t}/${i}`)}:{type:"group",name:o.title,items:h(o.children,t,i)}})}function u(e,t){return h(e,t)}function re(){let{docs:e,basePath:t}=s();return u(e,t)}function $(e){return e.replace(/^\/+/,"").replace(/\/+$/,"")}function ne({basePath:e="/docs",element:t}){return [{path:`${$(e)}/*`,element:t}]}
+export{x as DocsEngine,D as DocsPageRenderer,S as findFirstPage,d as findPageByPath,ne as generateDocsRoutes,n as isPage,R as resolveDocs,X as useCurrentPage,s as useDocs,re as useSidebar};//# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/context/DocsContext.ts","../src/context/DocsProvider.tsx","../src/engine/DocsEngine.tsx","../src/components/DocsPageRenderer.tsx","../src/hooks/useDocs.ts","../src/utils/page.ts","../src/hooks/useCurrentPage.ts","../src/utils/generateSidebar.ts","../src/hooks/useSidebar.ts","../src/utils/generateRoutes.tsx"],"names":["DocsContext","createContext","DocsProvider","docs","basePath","children","jsx","DocsProvider_default","DocsEngine","normalizedBasePath","DocsEngine_default","DocsPageRenderer","content","DocumentationPanel","DocsPageRenderer_default","useDocs","context","useContext","findPageByPath","nodes","targetPath","parentPath","node","fullPath","isPage","found","resolveDocs","pages","currentPath","findFirstPage","nested","useCurrentPage","pagePath","useParams","mapNodes","generateSidebar","useSidebar","generateDocsRoutes","element"],"mappings":"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","file":"index.mjs","sourcesContent":["import { createContext } from \"react\";\nimport { DocsCategory } from \"../types/docs\";\n\nexport interface DocsContextType {\n  docs: DocsCategory[];\n  basePath: string;\n}\n\nexport const DocsContext = createContext<DocsContextType | undefined>(\n  undefined,\n);\n","import React from \"react\";\n\nimport { DocsContext } from \"./DocsContext\";\n\nimport { DocsCategory } from \"../types/docs\";\n\ninterface DocsProviderProps {\n  docs: DocsCategory[];\n  basePath: string;\n  children: React.ReactNode;\n}\n\nfunction DocsProvider({ docs, basePath, children }: DocsProviderProps) {\n  return (\n    <DocsContext.Provider value={{ docs, basePath }}>\n      {children}\n    </DocsContext.Provider>\n  );\n}\n\nexport default DocsProvider;\n","import React from \"react\";\n\nimport DocsProvider from \"../context/DocsProvider\";\n\nimport { DocsCategory } from \"../types/docs\";\n\ninterface DocsEngineProps {\n  docs: DocsCategory[];\n  basePath?: string;\n  children: React.ReactNode;\n}\n\nfunction DocsEngine({ docs, basePath = \"/docs\", children }: DocsEngineProps) {\n  const normalizedBasePath = basePath.startsWith(\"/\")\n    ? basePath\n    : `/${basePath}`;\n\n  return (\n    <DocsProvider docs={docs} basePath={normalizedBasePath}>\n      {children}\n    </DocsProvider>\n  );\n}\n\nexport default DocsEngine;\n","import React from \"react\";\n\nimport { DocumentationPanel } from \"elseware-ui\";\n\ninterface DocsPageRendererProps {\n  content: string;\n}\n\nfunction DocsPageRenderer({\n  content,\n}: DocsPageRendererProps) {\n  return <DocumentationPanel value={content} />;\n}\n\nexport default DocsPageRenderer;","import { useContext } from \"react\";\n\nimport { DocsContext } from \"../context/DocsContext\";\n\nexport function useDocs() {\n  const context = useContext(DocsContext);\n\n  if (!context) {\n    throw new Error(\"useDocs must be used within DocsProvider\");\n  }\n\n  return context;\n}\n","import { DocsNode, DocsPage } from \"../types/docs\";\n\nexport function findPageByPath(\n  nodes: DocsNode[],\n  targetPath: string,\n  parentPath = \"\",\n): DocsPage | null {\n  for (const node of nodes) {\n    const fullPath = `${parentPath}${node.path}`.replace(/\\/+/g, \"/\");\n\n    if (isPage(node)) {\n      if (fullPath.replace(/^\\//, \"\") === targetPath.replace(/^\\//, \"\")) {\n        return {\n          ...node,\n          path: fullPath,\n        };\n      }\n\n      continue;\n    }\n\n    const found = findPageByPath(node.children, targetPath, fullPath);\n\n    if (found) {\n      return found;\n    }\n  }\n\n  return null;\n}\n\nexport interface ResolvedDocsPage extends DocsPage {\n  id: string;\n  fullPath: string;\n}\n\nexport function isPage(node: DocsNode): node is DocsPage {\n  return \"content\" in node;\n}\n\nexport function resolveDocs(\n  nodes: DocsNode[],\n  parentPath = \"\",\n): ResolvedDocsPage[] {\n  const pages: ResolvedDocsPage[] = [];\n\n  nodes.forEach((node) => {\n    const currentPath = `${parentPath}${node.path}`.replace(/\\/+/g, \"/\");\n\n    if (isPage(node)) {\n      pages.push({\n        ...node,\n        id: currentPath.replace(/\\//g, \"-\").replace(/^-/, \"\"),\n        fullPath: currentPath,\n      });\n\n      return;\n    }\n\n    pages.push(...resolveDocs(node.children, currentPath));\n  });\n\n  return pages;\n}\n\nexport function findFirstPage(\n  nodes: DocsNode[],\n  parentPath = \"\",\n): string | null {\n  for (const node of nodes) {\n    const fullPath = `${parentPath}${node.path}`.replace(/\\/+/g, \"/\");\n\n    if (isPage(node)) {\n      return fullPath;\n    }\n\n    const nested = findFirstPage(node.children, fullPath);\n\n    if (nested) {\n      return nested;\n    }\n  }\n\n  return null;\n}\n","import { useParams } from \"react-router-dom\";\n\nimport { useDocs } from \"./useDocs\";\n\nimport { findPageByPath } from \"../utils/page\";\n\nexport function useCurrentPage() {\n  const { docs } = useDocs();\n\n  const params = useParams();\n\n  const pagePath = params[\"*\"] ?? \"\";\n\n  return findPageByPath(docs, pagePath);\n}","import { MenuNode } from \"elseware-ui\";\n\nimport { DocsCategory, DocsNode } from \"../types/docs\";\n\nimport { isPage } from \"./page\";\n\nfunction mapNodes(\n  nodes: DocsNode[],\n  basePath: string,\n  parentPath = \"\",\n): MenuNode[] {\n  return nodes.map((node) => {\n    const fullPath = `${parentPath}${node.path}`.replace(/\\/+/g, \"/\");\n\n    if (isPage(node)) {\n      return {\n        type: \"item\",\n        name: node.title,\n        to: `/${basePath}${fullPath}`.replace(/\\/+/g, \"/\"),\n      };\n    }\n\n    return {\n      type: \"group\",\n      name: node.title,\n      items: mapNodes(node.children, basePath, fullPath),\n    };\n  });\n}\n\nexport function generateSidebar(\n  docs: DocsCategory[],\n\n  basePath: string,\n): MenuNode[] {\n  return mapNodes(docs, basePath);\n}\n","import { generateSidebar } from \"../utils/generateSidebar\";\n\nimport { useDocs } from \"./useDocs\";\n\nexport function useSidebar() {\n  const { docs, basePath } = useDocs();\n\n  return generateSidebar(docs, basePath);\n}","import React from \"react\";\n\nimport { RouteObject } from \"react-router-dom\";\n\ninterface GenerateDocsRoutesProps {\n  basePath?: string;\n  element: React.ReactNode;\n}\n\nexport function generateDocsRoutes({\n  basePath = \"/docs\",\n  element,\n}: GenerateDocsRoutesProps): RouteObject[] {\n  return [\n    {\n      path: `${basePath}/*`,\n      element,\n    },\n  ];\n}"]}
+{"version":3,"sources":["../src/context/DocsContext.ts","../src/context/DocsProvider.tsx","../src/engine/DocsEngine.tsx","../src/components/DocsPageRenderer.tsx","../src/hooks/useDocs.ts","../src/utils/page.ts","../src/hooks/useCurrentPage.ts","../src/utils/generateSidebar.ts","../src/hooks/useSidebar.ts","../src/utils/generateRoutes.tsx"],"names":["DocsContext","createContext","DocsProvider","docs","basePath","children","jsx","DocsProvider_default","DocsEngine","normalizedBasePath","DocsEngine_default","DocsPageRenderer","content","DocumentationPanel","DocsPageRenderer_default","useDocs","context","useContext","normalizePath","path","isPage","node","findPageByPath","nodes","targetPath","parentPath","normalizedTarget","currentPath","result","resolveDocs","pages","findFirstPage","child","useCurrentPage","debug","params","useParams","pagePath","mapNodes","fullPath","generateSidebar","useSidebar","normalizeRoutePath","generateDocsRoutes","element"],"mappings":"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","file":"index.mjs","sourcesContent":["import { createContext } from \"react\";\nimport { DocsCategory } from \"../types/docs\";\n\nexport interface DocsContextType {\n  docs: DocsCategory[];\n  basePath: string;\n}\n\nexport const DocsContext = createContext<DocsContextType | undefined>(\n  undefined,\n);\n","import React from \"react\";\n\nimport { DocsContext } from \"./DocsContext\";\n\nimport { DocsCategory } from \"../types/docs\";\n\ninterface DocsProviderProps {\n  docs: DocsCategory[];\n  basePath: string;\n  children: React.ReactNode;\n}\n\nfunction DocsProvider({ docs, basePath, children }: DocsProviderProps) {\n  return (\n    <DocsContext.Provider value={{ docs, basePath }}>\n      {children}\n    </DocsContext.Provider>\n  );\n}\n\nexport default DocsProvider;\n","import React from \"react\";\n\nimport DocsProvider from \"../context/DocsProvider\";\n\nimport { DocsCategory } from \"../types/docs\";\n\ninterface DocsEngineProps {\n  docs: DocsCategory[];\n  basePath?: string;\n  children: React.ReactNode;\n}\n\nfunction DocsEngine({ docs, basePath = \"/docs\", children }: DocsEngineProps) {\n  const normalizedBasePath = basePath.startsWith(\"/\")\n    ? basePath\n    : `/${basePath}`;\n\n  return (\n    <DocsProvider docs={docs} basePath={normalizedBasePath}>\n      {children}\n    </DocsProvider>\n  );\n}\n\nexport default DocsEngine;\n","import React from \"react\";\n\nimport { DocumentationPanel } from \"elseware-ui\";\n\ninterface DocsPageRendererProps {\n  content: string;\n}\n\nfunction DocsPageRenderer({\n  content,\n}: DocsPageRendererProps) {\n  return <DocumentationPanel value={content} />;\n}\n\nexport default DocsPageRenderer;","import { useContext } from \"react\";\n\nimport { DocsContext } from \"../context/DocsContext\";\n\nexport function useDocs() {\n  const context = useContext(DocsContext);\n\n  if (!context) {\n    throw new Error(\"useDocs must be used within DocsProvider\");\n  }\n\n  return context;\n}\n","import { DocsNode, DocsPage } from \"../types/docs\";\n\nfunction normalizePath(path: string) {\n  return \"/\" + path.replace(/\\/+/g, \"/\").replace(/^\\/|\\/$/g, \"\");\n}\n\nexport interface ResolvedDocsPage extends DocsPage {\n  id: string;\n  fullPath: string;\n}\n\nexport function isPage(node: DocsNode): node is DocsPage {\n  return \"content\" in node;\n}\n\nexport function findPageByPath(\n  nodes: DocsNode[],\n  targetPath: string,\n  parentPath = \"\",\n): DocsPage | null {\n  const normalizedTarget = normalizePath(targetPath);\n\n  for (const node of nodes) {\n    const currentPath = normalizePath(`${parentPath}/${node.path}`);\n\n    if (isPage(node)) {\n      if (currentPath === normalizedTarget) {\n        return node;\n      }\n    } else {\n      const result = findPageByPath(node.children, targetPath, currentPath);\n\n      if (result) {\n        return result;\n      }\n    }\n  }\n\n  return null;\n}\n\nexport function resolveDocs(\n  nodes: DocsNode[],\n  parentPath = \"\",\n): ResolvedDocsPage[] {\n  const pages: ResolvedDocsPage[] = [];\n\n  nodes.forEach((node) => {\n    const currentPath = normalizePath(`${parentPath}/${node.path}`);\n\n    if (isPage(node)) {\n      pages.push({\n        ...node,\n\n        id: currentPath.replace(/\\//g, \"-\").replace(/^-/, \"\"),\n\n        fullPath: currentPath,\n      });\n\n      return;\n    }\n\n    pages.push(...resolveDocs(node.children, currentPath));\n  });\n\n  return pages;\n}\n\nexport function findFirstPage(\n  nodes: DocsNode[],\n  parentPath = \"\",\n): string | null {\n  for (const node of nodes) {\n    const currentPath = normalizePath(`${parentPath}/${node.path}`);\n\n    if (isPage(node)) {\n      return currentPath;\n    }\n\n    const child = findFirstPage(node.children, currentPath);\n\n    if (child) {\n      return child;\n    }\n  }\n\n  return null;\n}\n","import { useParams } from \"react-router-dom\";\n\nimport { useDocs } from \"./useDocs\";\n\nimport { findPageByPath } from \"../utils/page\";\n\ninterface UseCurrentPageProps {\n  debug?: boolean;\n}\n\nexport function useCurrentPage({ debug = false }: UseCurrentPageProps = {}) {\n  const { docs } = useDocs();\n\n  const params = useParams();\n\n  const pagePath = params[\"*\"] ?? \"\";\n\n  if (debug) {\n    console.log(\"params\", params);\n\n    console.log(\"pagePath\", pagePath);\n  }\n\n  return findPageByPath(docs, pagePath);\n}\n","import { MenuNode } from \"elseware-ui\";\n\nimport { DocsCategory, DocsNode } from \"../types/docs\";\n\nimport { isPage } from \"./page\";\n\nfunction normalizePath(path: string) {\n  return \"/\" + path.replace(/\\/+/g, \"/\").replace(/^\\/|\\/$/g, \"\");\n}\n\nfunction mapNodes(\n  nodes: DocsNode[],\n  basePath: string,\n  parentPath = \"\",\n): MenuNode[] {\n  return nodes.map((node) => {\n    const fullPath = normalizePath(`${parentPath}/${node.path}`);\n\n    if (isPage(node)) {\n      return {\n        type: \"item\",\n\n        name: node.title,\n\n        to: normalizePath(`${basePath}/${fullPath}`),\n      };\n    }\n\n    return {\n      type: \"group\",\n\n      name: node.title,\n\n      items: mapNodes(node.children, basePath, fullPath),\n    };\n  });\n}\n\nexport function generateSidebar(\n  docs: DocsCategory[],\n  basePath: string,\n): MenuNode[] {\n  return mapNodes(docs, basePath);\n}\n","import { generateSidebar } from \"../utils/generateSidebar\";\n\nimport { useDocs } from \"./useDocs\";\n\nexport function useSidebar() {\n  const { docs, basePath } = useDocs();\n\n  return generateSidebar(docs, basePath);\n}","import React from \"react\";\n\nimport { RouteObject } from \"react-router-dom\";\n\ninterface GenerateDocsRoutesProps {\n  basePath?: string;\n  element: React.ReactNode;\n}\n\nfunction normalizeRoutePath(path: string) {\n  return path.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\");\n}\n\nexport function generateDocsRoutes({\n  basePath = \"/docs\",\n  element,\n}: GenerateDocsRoutesProps): RouteObject[] {\n  const normalizedBase = normalizeRoutePath(basePath);\n\n  return [\n    {\n      path: `${normalizedBase}/*`,\n      element,\n    },\n  ];\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "elseware-docs-engine",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "private": false,
   "description": "React documentation engine by elseware Technology",
   "license": "MIT",