polen 0.11.0-next.11 → 0.11.0-next.13

package/build/template/stores/toast.js

@@ -0,0 +1,105 @@
+import { proxy } from 'valtio';
+/**
+ * Toast notification types
+ */
+export const Type = {
+    info: 'info',
+    success: 'success',
+    warning: 'warning',
+    error: 'error',
+};
+/**
+ * Initial state for the toast store
+ */
+export const initialState = {
+    toasts: [],
+};
+/**
+ * Default values for toast properties
+ */
+const toastDefaults = {
+    duration: 5000,
+    actions: [],
+};
+/**
+ * Toast notification store
+ *
+ * Manages toast notifications with auto-dismiss functionality and type-specific convenience methods.
+ */
+export const store = proxy({
+    ...initialState,
+    /**
+     * Add a new toast notification
+     * @param toast - Toast configuration (id will be auto-generated)
+     * @returns Generated toast ID
+     */
+    add(toast) {
+        const id = `${Date.now()}-${Math.random().toString(36).substring(2, 11)}`;
+        store.toasts.push({ ...toast, id });
+        // Auto-remove after duration (default 5 seconds). Set duration to 0 to disable auto-dismiss
+        if (toast.duration !== 0) {
+            setTimeout(() => store.remove(id), toast.duration || toastDefaults.duration);
+        }
+        return id;
+    },
+    /**
+     * Remove a toast by ID
+     * @param id - Toast ID to remove
+     */
+    remove(id) {
+        const index = store.toasts.findIndex(t => t.id === id);
+        if (index > -1) {
+            store.toasts.splice(index, 1);
+        }
+    },
+    /**
+     * Reset store to initial state
+     */
+    reset() {
+        Object.assign(store, initialState);
+    },
+    /**
+     * Set store state
+     * @param data - New state data
+     */
+    set(data) {
+        Object.assign(store, data);
+    },
+    /**
+     * Show an info toast
+     * @param message - Toast message
+     * @param options - Additional toast options
+     * @returns Generated toast ID
+     */
+    info(message, options) {
+        return store.add({ ...toastDefaults, ...options, message, type: Type.info });
+    },
+    /**
+     * Show a success toast
+     * @param message - Toast message
+     * @param options - Additional toast options
+     * @returns Generated toast ID
+     */
+    success(message, options) {
+        return store.add({ ...toastDefaults, ...options, message, type: Type.success });
+    },
+    /**
+     * Show a warning toast
+     * @param message - Toast message
+     * @param options - Additional toast options
+     * @returns Generated toast ID
+     */
+    warning(message, options) {
+        return store.add({ ...toastDefaults, ...options, message, type: Type.warning });
+    },
+    /**
+     * Show an error toast
+     * @param message - Toast message
+     * @param options - Additional toast options
+     * @returns Generated toast ID
+     */
+    error(message, options) {
+        return store.add({ ...toastDefaults, ...options, message, type: Type.error });
+    },
+});
+//# sourceMappingURL=toast.js.map

package/build/template/stores/toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toast.js","sourceRoot":"","sources":["../../../src/template/stores/toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAA;AAE9B;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,IAAI,EAAE,MAAM;IACZ,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;CACN,CAAA;AAmCV;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAU;IACjC,MAAM,EAAE,EAAE;CACX,CAAA;AAED;;GAEG;AACH,MAAM,aAAa,GAAG;IACpB,QAAQ,EAAE,IAAI;IACd,OAAO,EAAE,EAAE;CACa,CAAA;AAE1B;;;;GAIG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC;IACzB,GAAG,YAAY;IAEf;;;;OAIG;IACH,GAAG,CAAC,KAAwB;QAC1B,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAA;QACzE,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,KAAK,EAAE,EAAE,EAAE,CAAC,CAAA;QAEnC,4FAA4F;QAC5F,IAAI,KAAK,CAAC,QAAQ,KAAK,CAAC,EAAE,CAAC;YACzB,UAAU,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,QAAQ,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAA;QAC9E,CAAC;QAED,OAAO,EAAE,CAAA;IACX,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU;QACf,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAA;QACtD,IAAI,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;YACf,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAA;QAC/B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK;QACH,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,YAAY,CAAC,CAAA;IACpC,CAAC;IAED;;;OAGG;IACH,GAAG,CAAC,IAAW;QACb,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;IAC5B,CAAC;IAED;;;;;OAKG;IACH,IAAI,CAAC,OAAe,EAAE,OAAsB;QAC1C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IAC9E,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAe,EAAE,OAAsB;QAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IACjF,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,OAAe,EAAE,OAAsB;QAC7C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,CAAC,CAAA;IACjF,CAAC;IAED;;;;;OAKG;IACH,KAAK,CAAC,OAAe,EAAE,OAAsB;QAC3C,OAAO,KAAK,CAAC,GAAG,CAAC,EAAE,GAAG,aAAa,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;IAC/E,CAAC;CACF,CAAC,CAAA"}

package/build/template/utils/try-with-toast.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Execute an async function with automatic error handling and toast notifications
+ *
+ * @param fn - Async function to execute
+ * @param errorMessage - Optional custom error message for the toast (defaults to error message)
+ * @returns Promise that resolves to null on success or Error on failure
+ */
+export declare const tryWithToast: <T>(fn: () => Promise<T>, errorMessage?: string) => Promise<Error | null>;
+//# sourceMappingURL=try-with-toast.d.ts.map

package/build/template/utils/try-with-toast.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-with-toast.d.ts","sourceRoot":"","sources":["../../../src/template/utils/try-with-toast.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAU,CAAC,EAClC,IAAI,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,eAAe,MAAM,KACpB,OAAO,CAAC,KAAK,GAAG,IAAI,CA4BtB,CAAA"}

package/build/template/utils/try-with-toast.js

@@ -0,0 +1,37 @@
+import { Stores } from '../stores/$.js';
+/**
+ * Execute an async function with automatic error handling and toast notifications
+ *
+ * @param fn - Async function to execute
+ * @param errorMessage - Optional custom error message for the toast (defaults to error message)
+ * @returns Promise that resolves to null on success or Error on failure
+ */
+export const tryWithToast = async (fn, errorMessage) => {
+    try {
+        await fn();
+        return null;
+    }
+    catch (error) {
+        // Log to console in all environments
+        console.error('Error in tryWithToast:', error);
+        // Determine the error message
+        const baseMessage = error instanceof Error ? error.message : String(error);
+        const toastMessage = errorMessage || baseMessage;
+        // In development, show detailed error info
+        if (import.meta.env.DEV) {
+            Stores.Toast.store.error(toastMessage, {
+                description: error instanceof Error
+                    ? `${error.name}: ${error.message}${error.stack ? '\n\nStack trace available in console.' : ''}`
+                    : `Error details: ${String(error)}`,
+                duration: 10000, // Longer duration in dev for debugging
+            });
+        }
+        else {
+            // In production, show simplified message
+            Stores.Toast.store.error(toastMessage);
+        }
+        // Return the error for downstream fallback logic
+        return error instanceof Error ? error : new Error(baseMessage);
+    }
+};
+//# sourceMappingURL=try-with-toast.js.map

package/build/template/utils/try-with-toast.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"try-with-toast.js","sourceRoot":"","sources":["../../../src/template/utils/try-with-toast.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAC/B,EAAoB,EACpB,YAAqB,EACE,EAAE;IACzB,IAAI,CAAC;QACH,MAAM,EAAE,EAAE,CAAA;QACV,OAAO,IAAI,CAAA;IACb,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qCAAqC;QACrC,OAAO,CAAC,KAAK,CAAC,wBAAwB,EAAE,KAAK,CAAC,CAAA;QAE9C,8BAA8B;QAC9B,MAAM,WAAW,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;QAC1E,MAAM,YAAY,GAAG,YAAY,IAAI,WAAW,CAAA;QAEhD,2CAA2C;QAC3C,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACxB,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,EAAE;gBACrC,WAAW,EAAE,KAAK,YAAY,KAAK;oBACjC,CAAC,CAAC,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,uCAAuC,CAAC,CAAC,CAAC,EAAE,EAAE;oBAChG,CAAC,CAAC,kBAAkB,MAAM,CAAC,KAAK,CAAC,EAAE;gBACrC,QAAQ,EAAE,KAAK,EAAE,uCAAuC;aACzD,CAAC,CAAA;QACJ,CAAC;aAAM,CAAC;YACN,yCAAyC;YACzC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;QACxC,CAAC;QAED,iDAAiD;QACjD,OAAO,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,WAAW,CAAC,CAAA;IAChE,CAAC;AACH,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polen",
-  "version": "0.11.0-next.11",
+  "version": "0.11.0-next.13",
   "type": "module",
   "description": "A framework for delightful GraphQL developer portals",
   "author": {
@@ -38,23 +38,137 @@
     "#api/iso": {
       "default": "./build/api/iso/$.js"
     },
+    "#lib/apple-touch-icon": {
+      "default": "./build/lib/apple-touch-icon/$.js"
+    },
+    "#lib/errors": {
+      "default": "./build/lib/errors/$.js"
+    },
+    "#lib/errors/errors": {
+      "default": "./build/lib/errors/$$.js"
+    },
+    "#lib/extensible-data": {
+      "default": "./build/lib/extensible-data/$.js"
+    },
+    "#lib/favicon": {
+      "default": "./build/lib/favicon/$.js"
+    },
+    "#lib/file-router": {
+      "default": "./build/lib/file-router/$.js"
+    },
+    "#lib/file-router/file-router": {
+      "default": "./build/lib/file-router/$$.js"
+    },
+    "#lib/grafaid": {
+      "default": "./build/lib/grafaid/$.js"
+    },
+    "#lib/grafaid/grafaid": {
+      "default": "./build/lib/grafaid/$$.js"
+    },
+    "#lib/grafaid-old": {
+      "default": "./build/lib/grafaid-old/$.js"
+    },
+    "#lib/graphql-change": {
+      "default": "./build/lib/graphql-change/$.js"
+    },
+    "#lib/graphql-change/graphql-change": {
+      "default": "./build/lib/graphql-change/$$.js"
+    },
+    "#lib/graphql-changeset": {
+      "default": "./build/lib/graphql-changeset/$.js"
+    },
+    "#lib/graphql-path": {
+      "default": "./build/lib/graphql-path/$.js"
+    },
+    "#lib/graphql-path/graphql-path": {
+      "default": "./build/lib/graphql-path/$$.js"
+    },
+    "#lib/graphql-schema-loader": {
+      "default": "./build/lib/graphql-schema-loader/$.js"
+    },
+    "#lib/hono-aid": {
+      "default": "./build/lib/hono-aid/$.js"
+    },
+    "#lib/html-utils": {
+      "default": "./build/lib/html-utils/$.js"
+    },
     "#lib/mask": {
       "default": "./build/lib/mask/$.js"
     },
     "#lib/mask/mask": {
       "default": "./build/lib/mask/$$.js"
     },
+    "#lib/path-map": {
+      "default": "./build/lib/path-map/$.js"
+    },
+    "#lib/path-map/path-map": {
+      "default": "./build/lib/path-map/$$.js"
+    },
+    "#lib/react-router-aid": {
+      "default": "./build/lib/react-router-aid/$.js"
+    },
+    "#lib/react-router-aid/react-router-aid": {
+      "default": "./build/lib/react-router-aid/$$.js"
+    },
+    "#lib/react-router-loader": {
+      "default": "./build/lib/react-router-loader/$.js"
+    },
+    "#lib/react-router-loader/react-router-loader": {
+      "default": "./build/lib/react-router-loader/$$.js"
+    },
+    "#lib/schema-lifecycle": {
+      "default": "./build/lib/schema-lifecycle/$.js"
+    },
+    "#lib/schema-lifecycle/schema-lifecycle": {
+      "default": "./build/lib/schema-lifecycle/$$.js"
+    },
+    "#lib/stack-processor": {
+      "default": "./build/lib/stack-processor/$.js"
+    },
+    "#lib/superjson-codec": {
+      "default": "./build/lib/superjson-codec/$.js"
+    },
+    "#lib/superjson-codec/superjson-codec": {
+      "default": "./build/lib/superjson-codec/$$.js"
+    },
     "#lib/task": {
       "default": "./build/lib/task/$.js"
     },
     "#lib/task/task": {
       "default": "./build/lib/task/$$.js"
     },
-    "#template/components/content/$$": {
-      "default": "./build/template/components/content/$$.js"
-    },
     "#lib/theme": {
       "default": "./build/lib/theme/$.js"
+    },
+    "#lib/theme/theme": {
+      "default": "./build/lib/theme/$$.js"
+    },
+    "#lib/vite-plugin-config": {
+      "default": "./build/lib/vite-plugin-config/$.js"
+    },
+    "#lib/vite-plugin-json": {
+      "default": "./build/lib/vite-plugin-json/$.js"
+    },
+    "#lib/vite-plugin-mdx": {
+      "default": "./build/lib/vite-plugin-mdx/$.js"
+    },
+    "#lib/vite-plugin-reactive-data": {
+      "default": "./build/lib/vite-plugin-reactive-data/$.js"
+    },
+    "#lib/vite-plugins": {
+      "default": "./build/lib/vite-plugins/$.js"
+    },
+    "#lib/vite-plugins/vite-plugins": {
+      "default": "./build/lib/vite-plugins/$$.js"
+    },
+    "#lib/vite-virtual": {
+      "default": "./build/lib/vite-virtual/$.js"
+    },
+    "#lib/vite-virtual/vite-virtual": {
+      "default": "./build/lib/vite-virtual/$$.js"
+    },
+    "#template/components/content/$$": {
+      "default": "./build/template/components/content/$$.js"
     }
   },
   "exports": {
@@ -138,6 +252,7 @@
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
     "unified": "^11.0.5",
+    "valtio": "^2.1.5",
     "vfile": "^6.0.3",
     "vite": "npm:rolldown-vite@^7.0.9",
     "vite-plugin-inspect": "^11.3.0",

package/src/api/api.ts

@@ -3,6 +3,7 @@ export * from './iso/$$.js'
 
 // Server-only exports
 export * from './builder/index.js'
+export * from './cache/$.js'
 export * from './config-resolver/index.js'
 export * from './config/index.js'
 export * as Project from './project/index.js'

package/src/api/cache/$$.ts

@@ -0,0 +1 @@
+export * from './cache.js'

package/src/api/cache/$.ts

@@ -0,0 +1 @@
+export * as Cache from './$$.js'

package/src/api/cache/cache.ts

@@ -0,0 +1,210 @@
+import { packagePaths } from '#package-paths'
+import { debugPolen } from '#singletons/debug'
+import * as NodeFs from 'node:fs/promises'
+import * as NodePath from 'node:path'
+
+const debug = debugPolen.sub(`api:cache`)
+
+/**
+ * Delete all Polen-generated caches.
+ *
+ * This includes:
+ * - Development assets (polen-assets)
+ * - Build output (dist)
+ * - Vite cache (.vite)
+ */
+export const deleteAll = async (projectRoot: string): Promise<void> => {
+  debug(`deleteAll`, { projectRoot })
+
+  const cachePaths = [
+    NodePath.join(projectRoot, `polen-assets`),
+    NodePath.join(projectRoot, `dist`),
+    NodePath.join(projectRoot, `node_modules`, `.vite`),
+  ]
+
+  const deletionPromises = cachePaths.map(async (cachePath) => {
+    try {
+      await NodeFs.rm(cachePath, { recursive: true, force: true })
+      debug(`deleted`, { path: cachePath })
+    } catch (error) {
+      // Ignore errors - cache directories might not exist
+      debug(`deleteFailed`, { path: cachePath, error })
+    }
+  })
+
+  await Promise.all(deletionPromises)
+  debug(`deleteAllComplete`)
+}
+
+// Types
+
+export interface CacheInfo {
+  rootPath: string
+  developmentAssets: CacheEntry & {
+    tree?: TreeNode[]
+  }
+  vite: CacheEntry & {
+    optimizedDependencies?: Array<{
+      name: string
+      size: number
+    }>
+  }
+}
+
+interface CacheEntry {
+  path: string
+  exists: boolean
+  size?: number
+}
+
+export interface TreeNode {
+  name: string
+  type: 'file' | 'directory'
+  size?: number
+  children?: TreeNode[]
+}
+
+// Helpers
+
+const getDirectorySize = async (dirPath: string): Promise<number> => {
+  let totalSize = 0
+
+  try {
+    const entries = await NodeFs.readdir(dirPath, { withFileTypes: true })
+
+    for (const entry of entries) {
+      const fullPath = NodePath.join(dirPath, entry.name)
+
+      if (entry.isDirectory()) {
+        totalSize += await getDirectorySize(fullPath)
+      } else {
+        const stats = await NodeFs.stat(fullPath)
+        totalSize += stats.size
+      }
+    }
+  } catch (error) {
+    debug(`getDirectorySize:error`, { path: dirPath, error })
+  }
+
+  return totalSize
+}
+
+const buildDirectoryTree = async (
+  dirPath: string,
+  currentDepth: number,
+  maxDepth: number,
+): Promise<TreeNode[]> => {
+  if (currentDepth >= maxDepth) {
+    return []
+  }
+
+  const tree: TreeNode[] = []
+
+  try {
+    const entries = await NodeFs.readdir(dirPath, { withFileTypes: true })
+
+    for (const entry of entries) {
+      const fullPath = NodePath.join(dirPath, entry.name)
+      const node: TreeNode = {
+        name: entry.name,
+        type: entry.isDirectory() ? 'directory' : 'file',
+      }
+
+      if (entry.isFile()) {
+        try {
+          const stats = await NodeFs.stat(fullPath)
+          node.size = stats.size
+        } catch {
+          // Ignore stat errors
+        }
+      }
+
+      if (entry.isDirectory() && currentDepth + 1 < maxDepth) {
+        node.children = await buildDirectoryTree(fullPath, currentDepth + 1, maxDepth)
+      }
+
+      tree.push(node)
+    }
+  } catch (error) {
+    debug(`buildDirectoryTree:error`, { path: dirPath, error })
+  }
+
+  return tree
+}
+
+/**
+ * Get information about Polen's internal caches.
+ */
+export const info = async (options?: { depth?: number }): Promise<CacheInfo> => {
+  const depth = options?.depth ?? 2
+  const cacheRoot = NodePath.join(packagePaths.rootDir, `node_modules`, `.vite`)
+  const devAssetsPath = NodePath.join(cacheRoot, `polen-assets`)
+  const depsPath = NodePath.join(cacheRoot, `deps`)
+
+  debug(`info`, { cacheRoot, depth })
+
+  // Check development assets
+  let devAssetsExists = false
+  let devAssetsSize: number | undefined
+  let devAssetsTree: TreeNode[] | undefined
+
+  try {
+    await NodeFs.access(devAssetsPath)
+    devAssetsExists = true
+    devAssetsSize = await getDirectorySize(devAssetsPath)
+    devAssetsTree = await buildDirectoryTree(devAssetsPath, 0, depth)
+  } catch {
+    // Directory doesn't exist
+  }
+
+  // Check vite cache
+  let viteExists = false
+  let viteSize: number | undefined
+  let optimizedDeps: Array<{ name: string; size: number }> | undefined
+
+  try {
+    await NodeFs.access(cacheRoot)
+    viteExists = true
+    viteSize = await getDirectorySize(cacheRoot)
+
+    // Get optimized dependencies
+    try {
+      const depFiles = await NodeFs.readdir(depsPath)
+      optimizedDeps = []
+
+      for (const file of depFiles) {
+        if (file.endsWith('.js') && !file.startsWith('chunk-')) {
+          const filePath = NodePath.join(depsPath, file)
+          const stats = await NodeFs.stat(filePath)
+          optimizedDeps.push({
+            name: file.replace('.js', ''),
+            size: stats.size,
+          })
+        }
+      }
+
+      // Sort by size descending
+      optimizedDeps.sort((a, b) => b.size - a.size)
+    } catch {
+      // deps directory doesn't exist
+    }
+  } catch {
+    // Cache doesn't exist
+  }
+
+  return {
+    rootPath: cacheRoot,
+    developmentAssets: {
+      path: devAssetsPath,
+      exists: devAssetsExists,
+      size: devAssetsSize,
+      tree: devAssetsTree,
+    },
+    vite: {
+      path: cacheRoot,
+      exists: viteExists,
+      size: viteSize,
+      optimizedDependencies: optimizedDeps,
+    },
+  }
+}

package/src/api/content/navbar.test.ts

@@ -25,13 +25,13 @@ describe('createNavbar', () => {
   it('excludes hidden pages', () => {
     const pages = [createPage(['visible'], 'index', false), createPage(['hidden'], 'index', true)]
     const result = createNavbar(pages)
-    expect(result).toEqual([{ pathExp: '/visible', title: 'Visible' }])
+    expect(result).toEqual([{ pathExp: '/visible', title: 'Visible', position: 'left' }])
   })
 
   it('includes directories with index pages', () => {
     const pages = [createPage(['guide'], 'index'), createPage(['guide', 'intro'], 'intro')]
     const result = createNavbar(pages)
-    expect(result).toEqual([{ pathExp: '/guide', title: 'Guide' }])
+    expect(result).toEqual([{ pathExp: '/guide', title: 'Guide', position: 'left' }])
   })
 
   it('excludes directories without index pages', () => {
@@ -43,7 +43,7 @@ describe('createNavbar', () => {
   it('includes single top-level pages', () => {
     const pages = [createPage(['about'], 'about')]
     const result = createNavbar(pages)
-    expect(result).toEqual([{ pathExp: '/about', title: 'About' }])
+    expect(result).toEqual([{ pathExp: '/about', title: 'About', position: 'left' }])
   })
 
   it('sorts results alphabetically', () => {

package/src/api/content/navbar.ts

@@ -4,6 +4,7 @@ import type { Page } from './page.js'
 export interface NavbarItem {
   pathExp: string
   title: string
+  position?: 'left' | 'right'
 }
 
 /**
@@ -50,6 +51,7 @@ export const createNavbar = (pages: Page[]): NavbarItem[] => {
       navbarItems.push({
         pathExp,
         title,
+        position: 'left',
       })
     }
   })

package/src/api/content/page.ts

@@ -1,4 +1,4 @@
-import type { FileRouter } from '#lib/file-router/index'
+import type { FileRouter } from '#lib/file-router'
 import type { Metadata } from './metadata.js'
 
 export type { Metadata }

package/src/api/content/scan.ts

@@ -1,4 +1,4 @@
-import { FileRouter } from '#lib/file-router/index'
+import { FileRouter } from '#lib/file-router'
 import { Fs, Path, Tree } from '@wollybeard/kit'
 import matter from 'gray-matter'
 import { MetadataSchema } from './metadata.js'

package/src/api/content/sidebar.ts

@@ -1,4 +1,4 @@
-import { FileRouter } from '#lib/file-router/index'
+import { FileRouter } from '#lib/file-router'
 import { Str } from '@wollybeard/kit'
 import type { Page } from './page.js'
 import type { ScanResult } from './scan.js'

package/src/api/iso/schema/$$.ts

@@ -1,5 +1,3 @@
 export * from './constants.js'
 export * as Routing from './routing.js'
-
-// Re-export types from server layer that are needed in template
-export type { ChangelogData, ChangeSets, NonEmptyChangeSets } from '../../schema/schema.js'
+export * as Validation from './validation.js'