polen 0.10.0-next.4 → 0.10.0-next.6

package/src/api/content/scan.ts

@@ -0,0 +1,82 @@
+import { FileRouter } from '#lib/file-router/index'
+import { Fs, Path, Tree } from '@wollybeard/kit'
+import matter from 'gray-matter'
+import { MetadataSchema } from './metadata.ts'
+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 const scan = async (options: {
+  dir: string
+  glob?: string
+  /** Include hidden pages in the result (useful for debugging or admin interfaces) */
+  includeHidden?: boolean
+}): Promise<ScanResult> => {
+  // 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,
+  }))
+
+  const 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: FileRouter.Route): Promise<Page> => {
+  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 }
+}

package/src/api/content/sidebar.ts

@@ -0,0 +1,136 @@
+import { FileRouter } from '#lib/file-router/index'
+import { Tree } from '@wollybeard/kit'
+import { Str } from '@wollybeard/kit'
+import type { Page } from './page.ts'
+
+export interface Sidebar {
+  items: Item[]
+}
+
+export type Item = ItemLink | ItemSection
+
+export interface ItemLink {
+  type: `ItemLink`
+  title: string
+  pathExp: string
+}
+
+export interface ItemSection {
+  type: `ItemSection`
+  title: string
+  pathExp: string
+  isLinkToo: boolean
+  links: ItemLink[]
+}
+
+/**
+ * Build sidebar from page tree structure
+ */
+export const buildFromPageTree = (pageTree: Tree.Tree<Page>, basePath: FileRouter.Path): Sidebar => {
+  const links: ItemLink[] = []
+  const sections: ItemSection[] = []
+
+  // Process only the children of the root node
+  if (pageTree.root) {
+    for (const child of pageTree.root.children) {
+      processPageNode(child, basePath, [], links, sections)
+    }
+  }
+
+  const items = [...links, ...sections]
+
+  return {
+    items,
+  }
+}
+
+const processPageNode = (
+  node: Tree.Node<Page>,
+  basePath: FileRouter.Path,
+  parentPath: string[],
+  links: ItemLink[],
+  sections: ItemSection[],
+): void => {
+  const page = node.value
+  const routeName = page.route.logical.path.slice(-1)[0] || 'index'
+  const currentPath = [...parentPath, routeName]
+
+  // If this page has children, treat it as a section
+  if (node.children.length > 0) {
+    const sectionPath = [...basePath, ...currentPath]
+    const sectionPathExp = FileRouter.pathToExpression(sectionPath)
+    const sectionTitle = Str.titlizeSlug(routeName)
+
+    // Check if any child is an index page
+    const hasIndexChild = node.children.some(child => isIndexPage(child.value))
+
+    const section: ItemSection = {
+      type: `ItemSection`,
+      title: sectionTitle,
+      pathExp: sectionPathExp.startsWith('/') ? sectionPathExp.slice(1) : sectionPathExp,
+      isLinkToo: hasIndexChild, // Section is linkable if it has an index page
+      links: [],
+    }
+
+    // Process all children as links for this section
+    for (const child of node.children) {
+      const childPage = child.value
+
+      if (child.children.length > 0) {
+        // This child has children - only collect its descendants, not the child itself
+        collectPagesFromNode(child, basePath, section.links)
+      } else if (!childPage.metadata.hidden && !isIndexPage(childPage)) {
+        // This is a leaf node - add it as a link
+        section.links.push(pageToItemLink(childPage, basePath))
+      }
+    }
+
+    sections.push(section)
+  } else {
+    // This is a standalone file - add as top-level link
+    if (!page.metadata.hidden && !isIndexPage(page)) {
+      links.push(pageToItemLink(page, basePath))
+    }
+  }
+}
+
+const collectPagesFromNode = (
+  node: Tree.Node<Page>,
+  basePath: FileRouter.Path,
+  links: ItemLink[],
+): void => {
+  // Only process children, not the node itself (to avoid double-adding intermediate directories)
+  for (const child of node.children) {
+    const childPage = child.value
+    if (childPage && !childPage.metadata.hidden && !isIndexPage(childPage)) {
+      links.push(pageToItemLink(childPage, basePath))
+    }
+
+    // Recursively process grandchildren
+    if (child.children.length > 0) {
+      collectPagesFromNode(child, basePath, links)
+    }
+  }
+}
+
+const pageToItemLink = (page: Page, basePath: FileRouter.Path): ItemLink => {
+  const pagePathExp = FileRouter.routeToPathExpression(page.route)
+  const pageRelative = FileRouter.makeRelativeUnsafe(page.route, basePath)
+  const pageRelativePathExp = FileRouter.routeToPathExpression(pageRelative)
+
+  // Remove leading slash for title generation
+  const titlePath = pageRelativePathExp.startsWith('/') ? pageRelativePathExp.slice(1) : pageRelativePathExp
+
+  // Use only the last segment for the title
+  const titleSegment = pageRelative.logical.path[pageRelative.logical.path.length - 1] || titlePath
+
+  return {
+    type: `ItemLink`,
+    pathExp: pagePathExp.startsWith('/') ? pagePathExp.slice(1) : pagePathExp,
+    title: Str.titlizeSlug(titleSegment),
+  }
+}
+
+const isIndexPage = (page: Page): boolean => {
+  return page.route.file.path.relative.name === 'index'
+}

package/src/api/schema/data-sources/schema-directory/schema-directory.ts

@@ -1,7 +1,7 @@
 import { Grafaid } from '#lib/grafaid/index'
 import { GraphqlChange } from '#lib/graphql-change/index'
 import type { GraphqlChangeset } from '#lib/graphql-changeset/index'
-import { debug as debugPolen } from '#singletons/debug'
+import { debugPolen } from '#singletons/debug'
 import { Arr, Path } from '@wollybeard/kit'
 import { glob } from 'tinyglobby'
 import type { Schema } from '../../schema.ts'

package/src/api/vite/plugins/branding/index.ts

@@ -2,7 +2,7 @@ import type { Config } from '#api/api'
 import { polenVirtual } from '#api/vite/vi'
 import type { Vite } from '#dep/vite/index'
 import { type ExistenceDiff, getMutationType, MutationType } from '#lib/mutation-type'
-import { debug } from '#singletons/debug'
+import { debugPolen } from '#singletons/debug'
 import { Fs } from '@wollybeard/kit'
 import type { Plugin } from 'vite'
 
@@ -15,8 +15,8 @@ const generateDefaultLogo = async () => {
 }
 
 export function Branding(config: Config.Config): Plugin {
-  const _debug = debug.sub('vite-plugin:branding')
-  _debug('initialized')
+  const debug = debugPolen.sub('vite-plugin:branding')
+  debug('initialized')
 
   return {
     name: 'polen:branding',
@@ -32,7 +32,7 @@ export function Branding(config: Config.Config): Plugin {
         changedFile: file,
         moduleId: viLogo.resolved,
         server,
-        debug: _debug,
+        debug: debug,
       })
     },
 

package/src/api/vite/plugins/core.ts

@@ -6,7 +6,7 @@ import type { Vite } from '#dep/vite/index'
 import { VitePluginJson } from '#lib/vite-plugin-json/index'
 import { VitePluginReactiveData } from '#lib/vite-plugin-reactive-data/index'
 import { ViteVirtual } from '#lib/vite-virtual/index'
-import { debug } from '#singletons/debug'
+import { debugPolen } from '#singletons/debug'
 import { superjson } from '#singletons/superjson'
 import { Json, Str } from '@wollybeard/kit'
 import type { ProjectData } from '../../../project-data.ts'
@@ -16,7 +16,7 @@ import { createLogger } from '../logger.ts'
 import { polenVirtual } from '../vi.ts'
 import { Pages } from './pages.ts'
 
-const _debug = debug.sub(`vite-plugin-core`)
+const debug = debugPolen.sub(`vite-plugin-core`)
 
 const viTemplateVariables = polenVirtual([`template`, `variables`])
 const viTemplateSchemaAugmentations = polenVirtual([`template`, `schema-augmentations`])
@@ -87,7 +87,7 @@ export const Core = (config: Config.Config): Vite.PluginOption[] => {
       name: `polen:internal-import-alias`,
       enforce: 'pre' as const,
       resolveId(id, importer) {
-        const d = debug.sub(`vite-plugin:internal-import-alias`)
+        const d = debugPolen.sub(`vite-plugin:internal-import-alias`)
 
         const isPolenImporter = Boolean(
           importer
@@ -183,7 +183,7 @@ export const Core = (config: Config.Config): Vite.PluginOption[] => {
         {
           identifier: viProjectData,
           async loader() {
-            _debug(`loadingViProjectDataVirtualModule`)
+            debug(`loadingViProjectDataVirtualModule`)
             const schema = await readSchema()
 
             // ━ Schema presence causes adding some navbar items