polen 0.10.0-next.14 → 0.10.0-next.4

package/src/template/server/ssg/generate.ts

@@ -1,91 +1,95 @@
 import { Hono } from '#dep/hono/index'
 import type { ReactRouter } from '#dep/react-router/index'
-import { asyncParallel, chunk } from '#lib/kit-temp'
-import { debugPolen } from '#singletons/debug'
+import { app } from '#template/server/app'
 import * as NodeFs from 'node:fs/promises'
 import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper'
-import viteClientAssetManifest from 'virtual:polen/vite/client/manifest'
-import { createPageHtmlResponse } from '../create-page-html-response.tsx'
-import { injectManifestIntoHtml } from '../manifest.ts'
+import { renderPage } from '../render-page.jsx'
 import { getRoutesPaths } from './get-route-paths.ts'
 
 export const generate = async (view: ReactRouter.StaticHandler) => {
-  const debug = debugPolen.sub(`ssg`)
+  const handler: Hono.Handler = async (ctx) => {
+    // For SSG, we need to create a request with the base path prepended
+    // so React Router can match it correctly
+    const url = new URL(ctx.req.raw.url)
+    const basePath = PROJECT_DATA.basePath === '/' ? '' : PROJECT_DATA.basePath.slice(0, -1)
 
-  const routePaths = getRoutesPaths()
-  const totalPaths = routePaths.length
-  debug(`start`, { totalPaths })
+    // Create a new request with the base path prepended to the pathname
+    const modifiedRequest = new Request(
+      `${url.protocol}//${url.host}${basePath}${url.pathname}${url.search}`,
+      {
+        method: ctx.req.raw.method,
+        headers: ctx.req.raw.headers,
+        body: ctx.req.raw.body,
+      },
+    )
 
-  // Process routes in batches using the new utilities
-  const batchSize = 50
-  const batches = chunk(routePaths, batchSize)
+    const staticHandlerContext = await view.query(modifiedRequest)
+    if (staticHandlerContext instanceof Response) {
+      return staticHandlerContext
+    }
+    return renderPage(staticHandlerContext)
+  }
 
-  const result = await asyncParallel(
-    batches,
-    async (batchPaths, batchIndex) => {
-      const batchApp = new Hono.Hono()
+  const routePaths = getRoutesPaths()
 
-      // Create a custom handler for batch processing that includes base path handling
-      const batchHandler: Hono.Handler = async (ctx) => {
-        // For SSG, we need to create a request with the base path prepended
-        const url = new URL(ctx.req.raw.url)
-        const basePath = PROJECT_DATA.basePath === '/' ? '' : PROJECT_DATA.basePath.slice(0, -1)
+  for (const routePath of routePaths) {
+    app.get(routePath, handler)
+  }
 
-        // Create a new request with the base path prepended to the pathname
-        const modifiedRequest = new Request(
-          `${url.protocol}//${url.host}${basePath}${url.pathname}${url.search}`,
-          {
-            method: ctx.req.raw.method,
-            headers: ctx.req.raw.headers,
-            body: ctx.req.raw.body,
-          },
-        )
+  // For large schemas, we need to process in smaller batches to avoid memory issues
+  const BATCH_SIZE = 50
+  const totalPaths = routePaths.length
+  console.log(`[info] Generating ${totalPaths} static pages...`)
 
-        const staticHandlerContext = await view.query(modifiedRequest)
-        if (staticHandlerContext instanceof Response) {
-          return staticHandlerContext
-        }
+  for (let i = 0; i < totalPaths; i += BATCH_SIZE) {
+    const batchPaths = routePaths.slice(i, i + BATCH_SIZE)
+    const batchApp = new Hono.Hono()
 
-        // SSG uses manifest-based transformation directly
-        const transformHtml = (html: string) => {
-          return injectManifestIntoHtml(html, viteClientAssetManifest, PROJECT_DATA.basePath)
-        }
-        return createPageHtmlResponse(staticHandlerContext, { transformHtml })
-      }
+    // Create a custom handler for batch processing that includes base path handling
+    const batchHandler: Hono.Handler = async (ctx) => {
+      // For SSG, we need to create a request with the base path prepended
+      const url = new URL(ctx.req.raw.url)
+      const basePath = PROJECT_DATA.basePath === '/' ? '' : PROJECT_DATA.basePath.slice(0, -1)
 
-      // Register only the routes for this batch
-      for (const routePath of batchPaths) {
-        batchApp.get(routePath, batchHandler)
-      }
+      // Create a new request with the base path prepended to the pathname
+      const modifiedRequest = new Request(
+        `${url.protocol}//${url.host}${basePath}${url.pathname}${url.search}`,
+        {
+          method: ctx.req.raw.method,
+          headers: ctx.req.raw.headers,
+          body: ctx.req.raw.body,
+        },
+      )
 
-      debug(`batch:start`, {
-        batchIndex: batchIndex + 1,
-        totalBatches: batches.length,
-        pagesInBatch: batchPaths.length,
-      })
+      const staticHandlerContext = await view.query(modifiedRequest)
+      if (staticHandlerContext instanceof Response) {
+        return staticHandlerContext
+      }
+      return renderPage(staticHandlerContext)
+    }
 
-      const ssgResult = await Hono.SSG.toSSG(batchApp, NodeFs, {
-        concurrency: 5, // Reduced concurrency for memory efficiency
-        dir: PROJECT_DATA.paths.relative.build.root,
-      })
+    // Register only the routes for this batch
+    for (const routePath of batchPaths) {
+      batchApp.get(routePath, batchHandler)
+    }
 
-      if (!ssgResult.success) {
-        throw new Error(`Failed to generate static site at batch ${batchIndex + 1}`, {
-          cause: ssgResult.error,
-        })
-      }
+    console.log(
+      `[info] Processing batch ${Math.floor(i / BATCH_SIZE) + 1}/${
+        Math.ceil(totalPaths / BATCH_SIZE)
+      } (${batchPaths.length} pages)...`,
+    )
 
-      return ssgResult
-    },
-    {
-      concurrency: 1, // Process batches sequentially to avoid memory issues
-      failFast: true, // Stop on first batch failure
-    },
-  )
+    const result = await Hono.SSG.toSSG(batchApp, NodeFs, {
+      concurrency: 5, // Reduced concurrency for memory efficiency
+      dir: PROJECT_DATA.paths.relative.build.root,
+    })
 
-  if (!result.success) {
-    throw new Error(`SSG generation failed`, { cause: result.errors[0] })
+    if (!result.success) {
+      throw new Error(`Failed to generate static site at batch ${Math.floor(i / BATCH_SIZE) + 1}`, {
+        cause: result.error,
+      })
+    }
   }
 
-  debug(`complete`, { totalPaths })
+  console.log(`[info] Successfully generated ${totalPaths} static pages.`)
 }

package/src/template/server/ssg/get-route-paths.ts

@@ -3,7 +3,7 @@ import { visit } from 'graphql'
 // Or your specific import path for this type
 import { ReactRouterAid } from '#lib/react-router-aid/index'
 import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper'
-import { routes } from '../../routes.tsx'
+import { routes } from '../../routes.jsx'
 
 // todo: Frameworks tend to colocate ssg data loaders with routes to solve the following
 // problem which is we have to map data loaders to paramterized routes.

package/src/template/server/view.ts

@@ -1,6 +1,6 @@
 import { createStaticHandler } from 'react-router'
 import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper'
-import { routes } from '../routes.tsx'
+import { routes } from '../routes.jsx'
 
 export const view = createStaticHandler(routes, {
   basename: PROJECT_DATA.basePath === `/` ? undefined : PROJECT_DATA.basePath.slice(0, -1), // Remove trailing slash for React Router

package/src/template/styles/code-block.css

@@ -33,36 +33,6 @@
   color-scheme: dark;
 }
 
-/* Shiki token colors for light theme (github-light) */
-:root {
-  --shiki-color-text: #24292e;
-  --shiki-color-background: #f6f8fa;
-  --shiki-token-constant: #005cc5;
-  --shiki-token-string: #032f62;
-  --shiki-token-comment: #6a737d;
-  --shiki-token-keyword: #d73a49;
-  --shiki-token-parameter: #e36209;
-  --shiki-token-function: #6f42c1;
-  --shiki-token-string-expression: #032f62;
-  --shiki-token-punctuation: #24292e;
-  --shiki-token-link: #032f62;
-}
-
-/* Shiki token colors for dark theme (tokyo-night) */
-.dark {
-  --shiki-color-text: #c0caf5;
-  --shiki-color-background: #1a1b26;
-  --shiki-token-constant: #ff9e64;
-  --shiki-token-string: #9ece6a;
-  --shiki-token-comment: #565f89;
-  --shiki-token-keyword: #bb9af7;
-  --shiki-token-parameter: #e0af68;
-  --shiki-token-function: #7aa2f7;
-  --shiki-token-string-expression: #9ece6a;
-  --shiki-token-punctuation: #c0caf5;
-  --shiki-token-link: #9ece6a;
-}
-
 /* Shiki code blocks */
 pre.shiki {
   margin: 1rem 0;
@@ -71,8 +41,6 @@ pre.shiki {
   overflow-x: auto;
   font-size: 14px;
   line-height: 1.6;
-  background-color: var(--shiki-color-background);
-  color: var(--shiki-color-text);
 }
 
 pre.shiki code {

package/build/api/content/$$.d.ts

@@ -1,7 +0,0 @@
-export * from './metadata.ts';
-export * from './navbar.ts';
-export * from './page.ts';
-export * from './scan.ts';
-export * from './sidebar.ts';
-export * from './utils.ts';
-//# sourceMappingURL=$$.d.ts.map

package/build/api/content/$$.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/api/content/$$.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/build/api/content/$$.js

@@ -1,7 +0,0 @@
-export * from "./metadata.js";
-export * from "./navbar.js";
-export * from "./page.js";
-export * from "./scan.js";
-export * from "./sidebar.js";
-export * from "./utils.js";
-//# sourceMappingURL=$$.js.map

package/build/api/content/$$.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../src/api/content/$$.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,YAAY,CAAA"}

package/build/api/content/$.d.ts

@@ -1,2 +0,0 @@
-export * as Content from './$$.ts';
-//# sourceMappingURL=$.d.ts.map

package/build/api/content/$.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/api/content/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA"}

package/build/api/content/$.js

@@ -1,2 +0,0 @@
-export * as Content from "./$$.js";
-//# sourceMappingURL=$.js.map

package/build/api/content/$.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../src/api/content/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA"}

package/build/api/content/metadata.d.ts

@@ -1,10 +0,0 @@
-import { z } from 'zod/v4';
-/**
- * Schema for validating front matter content
- */
-export declare const MetadataSchema: z.ZodObject<{
-    description: z.ZodOptional<z.ZodString>;
-    hidden: z.ZodDefault<z.ZodBoolean>;
-}, z.core.$strip>;
-export type Metadata = z.infer<typeof MetadataSchema>;
-//# sourceMappingURL=metadata.d.ts.map

package/build/api/content/metadata.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/api/content/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B;;GAEG;AACH,eAAO,MAAM,cAAc;;;iBAGzB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/build/api/content/metadata.js

@@ -1,9 +0,0 @@
-import { z } from 'zod/v4';
-/**
- * Schema for validating front matter content
- */
-export const MetadataSchema = z.object({
-    description: z.string().optional(),
-    hidden: z.boolean().default(false),
-});
-//# sourceMappingURL=metadata.js.map

package/build/api/content/metadata.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/api/content/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACnC,CAAC,CAAA"}

package/build/api/content/navbar.d.ts

@@ -1,10 +0,0 @@
-import type { Page } from './page.ts';
-export interface NavbarItem {
-    pathExp: string;
-    title: string;
-}
-/**
- * Generate navbar items from a list of pages
- */
-export declare const createNavbar: (pages: Page[]) => NavbarItem[];
-//# sourceMappingURL=navbar.d.ts.map

package/build/api/content/navbar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"navbar.d.ts","sourceRoot":"","sources":["../../../src/api/content/navbar.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,MAAM,CAAA;CACd;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,IAAI,EAAE,KAAG,UAAU,EAiDtD,CAAA"}

package/build/api/content/navbar.js

@@ -1,45 +0,0 @@
-import { Str } from '@wollybeard/kit';
-/**
- * Generate navbar items from a list of pages
- */
-export const createNavbar = (pages) => {
-    const navbarItems = [];
-    // Group pages by their top-level directory/segment
-    const topLevelGroups = new Map();
-    pages.forEach(page => {
-        // Skip hidden pages
-        if (page.metadata.hidden)
-            return;
-        const firstSegment = page.route.logical.path[0];
-        if (firstSegment) {
-            if (!topLevelGroups.has(firstSegment)) {
-                topLevelGroups.set(firstSegment, []);
-            }
-            topLevelGroups.get(firstSegment).push(page);
-        }
-    });
-    // Add each top-level group to navbar
-    topLevelGroups.forEach((pages, segment) => {
-        // For directories, check if there's an index page
-        const indexPage = pages.find(p => p.route.logical.path.length === 1
-            && p.route.file.path.relative.name === 'index');
-        // For single non-index files at top level
-        const singlePage = pages.length === 1 && pages[0].route.logical.path.length === 1
-            && pages[0].route.file.path.relative.name !== 'index';
-        // Include in navbar if:
-        // 1. It's a directory with an index page, OR
-        // 2. It's a single top-level page (not index)
-        if (indexPage || singlePage) {
-            const title = Str.titlizeSlug(segment);
-            const pathExp = `/${segment}`;
-            navbarItems.push({
-                pathExp,
-                title,
-            });
-        }
-    });
-    // Sort navbar items alphabetically for consistency
-    navbarItems.sort((a, b) => a.title.localeCompare(b.title));
-    return navbarItems;
-};
-//# sourceMappingURL=navbar.js.map

package/build/api/content/navbar.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"navbar.js","sourceRoot":"","sources":["../../../src/api/content/navbar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAA;AAQrC;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAa,EAAgB,EAAE;IAC1D,MAAM,WAAW,GAAiB,EAAE,CAAA;IAEpC,mDAAmD;IACnD,MAAM,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAA;IAEhD,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;QACnB,oBAAoB;QACpB,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM;YAAE,OAAM;QAEhC,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QAC/C,IAAI,YAAY,EAAE,CAAC;YACjB,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;gBACtC,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,EAAE,CAAC,CAAA;YACtC,CAAC;YACD,cAAc,CAAC,GAAG,CAAC,YAAY,CAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QAC9C,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,qCAAqC;IACrC,cAAc,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxC,kDAAkD;QAClD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAC/B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;eAC9B,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAC/C,CAAA;QAED,0CAA0C;QAC1C,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;eAC7E,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,KAAK,OAAO,CAAA;QAExD,wBAAwB;QACxB,6CAA6C;QAC7C,8CAA8C;QAC9C,IAAI,SAAS,IAAI,UAAU,EAAE,CAAC;YAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,WAAW,CAAC,OAAO,CAAC,CAAA;YACtC,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAA;YAE7B,WAAW,CAAC,IAAI,CAAC;gBACf,OAAO;gBACP,KAAK;aACN,CAAC,CAAA;QACJ,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,mDAAmD;IACnD,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAA;IAE1D,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}

package/build/api/content/page.d.ts

@@ -1,11 +0,0 @@
-import type { FileRouter } from '#lib/file-router/index';
-import type { Metadata } from './metadata.ts';
-export type { Metadata };
-/**
- * A route with its associated metadata
- */
-export interface Page {
-    route: FileRouter.Route;
-    metadata: Metadata;
-}
-//# sourceMappingURL=page.d.ts.map

package/build/api/content/page.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/api/content/page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,YAAY,EAAE,QAAQ,EAAE,CAAA;AAExB;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAA;IACvB,QAAQ,EAAE,QAAQ,CAAA;CACnB"}

package/build/api/content/page.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=page.js.map

package/build/api/content/page.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../src/api/content/page.ts"],"names":[],"mappings":""}

package/build/api/content/scan.d.ts

@@ -1,19 +0,0 @@
-import { FileRouter } from '#lib/file-router/index';
-import { Tree } from '@wollybeard/kit';
-import type { Page } from './page.ts';
-export interface ScanResult {
-    list: Page[];
-    tree: Tree.Tree<Page>;
-    diagnostics: FileRouter.Diagnostic[];
-}
-/**
- * Scan a directory for pages and extract metadata from their front matter
- * By default, hidden pages are filtered out from both the pages list and route tree.
- */
-export declare const scan: (options: {
-    dir: string;
-    glob?: string;
-    /** Include hidden pages in the result (useful for debugging or admin interfaces) */
-    includeHidden?: boolean;
-}) => Promise<ScanResult>;
-//# sourceMappingURL=scan.d.ts.map

package/build/api/content/scan.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"scan.d.ts","sourceRoot":"","sources":["../../../src/api/content/scan.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACnD,OAAO,EAAY,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAGhD,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAErC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,IAAI,EAAE,CAAA;IACZ,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACrB,WAAW,EAAE,UAAU,CAAC,UAAU,EAAE,CAAA;CACrC;AAED;;;GAGG;AACH,eAAO,MAAM,IAAI,GAAU,SAAS;IAClC,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,oFAAoF;IACpF,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,KAAG,OAAO,CAAC,UAAU,CAmErB,CAAA"}

package/build/api/content/scan.js

@@ -1,90 +0,0 @@
-import { FileRouter } from '#lib/file-router/index';
-import { Fs, Path, Tree } from '@wollybeard/kit';
-import matter from 'gray-matter';
-import { MetadataSchema } from "./metadata.js";
-/**
- * Scan a directory for pages and extract metadata from their front matter
- * By default, hidden pages are filtered out from both the pages list and route tree.
- */
-export const scan = async (options) => {
-    // Scan for routes
-    const routeScanResult = await FileRouter.scan({
-        dir: options.dir,
-        glob: options.glob ?? '**/*.{md,mdx}',
-    });
-    // Create pages with metadata (id/parentId now come from route)
-    const allPages = await Promise.all(routeScanResult.routes.map(route => readRoute(route)));
-    // Apply filtering if needed
-    const pages = options.includeHidden
-        ? allPages
-        : allPages.filter(page => !page.metadata.hidden);
-    // Build tree from pages using Tree.fromList
-    // Transform pages to include id/parentId at the top level for Tree.fromList
-    const pagesWithIds = pages.map(page => ({
-        ...page,
-        id: page.route.id,
-        parentId: page.route.parentId,
-    }));
-    // Handle cases where there might be multiple root nodes
-    // If all pages are at root level (no parentId), create a virtual root
-    const hasMultipleRoots = pagesWithIds.filter(p => !p.parentId).length > 1;
-    let tree;
-    if (hasMultipleRoots) {
-        // Create a virtual root node to hold all root-level pages
-        const virtualRoot = {
-            route: {
-                id: '__virtual_root__',
-                parentId: null,
-                file: {
-                    path: {
-                        absolute: Path.parse(''),
-                        relative: Path.parse(''),
-                    },
-                },
-                logical: {
-                    path: [],
-                },
-            },
-            metadata: { hidden: true },
-            id: '__virtual_root__',
-            parentId: null,
-        };
-        // Update pages to have virtual root as parent if they don't have one
-        const pagesWithVirtualRoot = pagesWithIds.map(page => ({
-            ...page,
-            parentId: page.parentId || '__virtual_root__',
-        }));
-        tree = Tree.fromList([virtualRoot, ...pagesWithVirtualRoot]);
-    }
-    else {
-        tree = Tree.fromList(pagesWithIds);
-    }
-    return {
-        list: pages,
-        tree,
-        diagnostics: routeScanResult.diagnostics,
-    };
-};
-/**
- * Read a single route file and extract metadata from its front matter
- */
-const readRoute = async (route) => {
-    const filePath = Path.format(route.file.path.absolute);
-    const fileContent = await Fs.read(filePath);
-    // Empty files still get default metadata (not hidden by default)
-    // This allows placeholder pages to exist in the navigation
-    if (!fileContent) {
-        return { route, metadata: { hidden: false } };
-    }
-    // Parse front matter
-    const { data } = matter(fileContent);
-    // Validate and parse the data
-    const parsed = MetadataSchema.safeParse(data);
-    if (!parsed.success) {
-        // Log warning but continue with defaults
-        console.warn(`Invalid front matter in ${filePath}:`, parsed.error.issues);
-    }
-    const metadata = parsed.success ? parsed.data : { hidden: false };
-    return { route, metadata };
-};
-//# sourceMappingURL=scan.js.map

package/build/api/content/scan.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"scan.js","sourceRoot":"","sources":["../../../src/api/content/scan.ts"],"names":[],"mappings":"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"}

package/build/api/content/sidebar.d.ts

@@ -1,104 +0,0 @@
-import type { ScanResult } from './scan.ts';
-/**
- * Represents a complete sidebar structure with navigation items.
- * This is the main data structure used to render sidebars in the UI.
- */
-export interface Sidebar {
-    /** Array of navigation items that can be either direct links or sections containing multiple links */
-    items: Item[];
-}
-/**
- * A sidebar navigation item that can be either a direct link or a section containing multiple links.
- * @see {@link ItemLink} for direct navigation links
- * @see {@link ItemSection} for grouped navigation sections
- */
-export type Item = ItemLink | ItemSection;
-/**
- * A direct navigation link in the sidebar.
- * Used for pages that don't have child pages.
- *
- * @example
- * ```ts
- * const link: ItemLink = {
- *   type: 'ItemLink',
- *   title: 'Getting Started',
- *   pathExp: 'guide/getting-started'
- * }
- * ```
- */
-export interface ItemLink {
-    /** Discriminator for TypeScript union types */
-    type: `ItemLink`;
-    /** Display title for the link (e.g., "Getting Started") */
-    title: string;
-    /** Path expression relative to the base path, without leading slash (e.g., "guide/getting-started") */
-    pathExp: string;
-}
-/**
- * A collapsible section in the sidebar that groups related links.
- * Used for directories that contain multiple pages.
- *
- * @example
- * ```ts
- * const section: ItemSection = {
- *   type: 'ItemSection',
- *   title: 'Guide',
- *   pathExp: 'guide',
- *   isLinkToo: true, // Has an index page
- *   links: [
- *     { type: 'ItemLink', title: 'Installation', pathExp: 'guide/installation' },
- *     { type: 'ItemLink', title: 'Configuration', pathExp: 'guide/configuration' }
- *   ]
- * }
- * ```
- */
-export interface ItemSection {
-    /** Discriminator for TypeScript union types */
-    type: `ItemSection`;
-    /** Display title for the section (e.g., "Guide", "API Reference") */
-    title: string;
-    /** Path expression for the section's index page, if it exists (e.g., "guide") */
-    pathExp: string;
-    /** Whether this section also acts as a link (true if the directory has an index page) */
-    isLinkToo: boolean;
-    /** Child navigation links within this section */
-    links: ItemLink[];
-}
-/**
- * A mapping of route paths to their corresponding sidebar structures.
- * Used to store different sidebars for different sections of a site.
- *
- * @example
- * ```ts
- * const sidebarIndex: SidebarIndex = {
- *   '/guide': { items: [...] },     // Sidebar for /guide section
- *   '/api': { items: [...] },       // Sidebar for /api section
- *   '/reference': { items: [...] }  // Sidebar for /reference section
- * }
- * ```
- */
-export type SidebarIndex = Record<string, Sidebar>;
-/**
- * Builds sidebars for all top-level directories that contain both an index page and nested content.
- *
- * This function analyzes a scan result to identify which directories should have sidebars.
- * A directory gets a sidebar if it meets these criteria:
- * 1. It's a top-level directory (e.g., /guide, /api, /docs)
- * 2. It has an index page (e.g., /guide/index.md)
- * 3. It has nested pages (e.g., /guide/getting-started.md, /guide/configuration.md)
- *
- * @param scanResult - The result of scanning pages, containing both a flat list and tree structure
- * @returns A mapping of route paths to sidebar structures
- *
- * @example
- * ```ts
- * const scanResult = await Content.scan({ dir: './pages' })
- * const sidebars = buildSidebarIndex(scanResult)
- * // Returns: {
- * //   '/guide': { items: [...] },
- * //   '/api': { items: [...] }
- * // }
- * ```
- */
-export declare const buildSidebarIndex: (scanResult: ScanResult) => SidebarIndex;
-//# sourceMappingURL=sidebar.d.ts.map

package/build/api/content/sidebar.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"sidebar.d.ts","sourceRoot":"","sources":["../../../src/api/content/sidebar.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAE3C;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB,sGAAsG;IACtG,KAAK,EAAE,IAAI,EAAE,CAAA;CACd;AAED;;;;GAIG;AACH,MAAM,MAAM,IAAI,GAAG,QAAQ,GAAG,WAAW,CAAA;AAEzC;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,QAAQ;IACvB,+CAA+C;IAC/C,IAAI,EAAE,UAAU,CAAA;IAChB,2DAA2D;IAC3D,KAAK,EAAE,MAAM,CAAA;IACb,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,IAAI,EAAE,aAAa,CAAA;IACnB,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAA;IACb,iFAAiF;IACjF,OAAO,EAAE,MAAM,CAAA;IACf,yFAAyF;IACzF,SAAS,EAAE,OAAO,CAAA;IAClB,iDAAiD;IACjD,KAAK,EAAE,QAAQ,EAAE,CAAA;CAClB;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,iBAAiB,GAAI,YAAY,UAAU,KAAG,YAqC1D,CAAA"}