polen 0.11.0-next.14 → 0.11.0-next.16

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

@@ -1,261 +0,0 @@
-import type { Config } from '#api/config/index'
-import { Content } from '#api/content/$'
-import { polenVirtual } from '#api/vite/vi'
-import type { Vite } from '#dep/vite/index'
-import { FileRouter } from '#lib/file-router'
-import { reportDiagnostics } from '#lib/file-router/diagnostic-reporter'
-import { debugPolen } from '#singletons/debug'
-import { superjson } from '#singletons/superjson'
-import mdx from '@mdx-js/rollup'
-import { Arr, Cache, Path, Str } from '@wollybeard/kit'
-import { recmaCodeHike, remarkCodeHike } from 'codehike/mdx'
-import remarkFrontmatter from 'remark-frontmatter'
-import remarkGfm from 'remark-gfm'
-import { viProjectData } from './core.js'
-
-const debug = debugPolen.sub(`vite-pages`)
-
-export const viProjectRoutes = polenVirtual([`project`, `routes.jsx`], { allowPluginProcessing: true })
-export const viProjectPagesCatalog = polenVirtual([`project`, `data`, `pages-catalog.jsonsuper`], {
-  allowPluginProcessing: true,
-})
-
-export interface Options {
-  config: Config.Config
-}
-
-export interface ProjectPagesCatalog {
-  sidebarIndex: Content.SidebarIndex
-  pages: Content.Page[]
-}
-
-/**
- * Pages plugin with tree support
- */
-export const Pages = ({
-  config,
-}: Options): Vite.Plugin[] => {
-  const scanPages = Cache.memoize(debug.trace(async function scanPages() {
-    const result = await Content.scan({
-      dir: config.paths.project.absolute.pages,
-      glob: `**/*.{md,mdx}`,
-    })
-    return result
-  }))
-
-  const invalidateVirtualModules = (server: Vite.ViteDevServer) => {
-    const routesModule = server.moduleGraph.getModuleById(viProjectRoutes.id)
-    if (routesModule) {
-      server.moduleGraph.invalidateModule(routesModule)
-      debug(`Invalidated routes virtual module`)
-    }
-
-    const catalogModule = server.moduleGraph.getModuleById(viProjectPagesCatalog.id)
-    if (catalogModule) {
-      server.moduleGraph.invalidateModule(catalogModule)
-      debug(`Invalidated pages catalog virtual module`)
-    }
-
-    const projectDataModule = server.moduleGraph.getModuleById(viProjectData.id)
-    if (projectDataModule) {
-      server.moduleGraph.invalidateModule(projectDataModule)
-      debug(`Invalidated project data virtual module`)
-    }
-  }
-
-  const generateRoutesModule = (pages: Content.Page[]): string => {
-    const $ = {
-      routes: `routes`,
-    }
-
-    const s = Str.Builder()
-    s`export const ${$.routes} = []`
-
-    // Generate imports and route objects
-    for (const { route, metadata } of pages) {
-      const filePathExp = Path.format(route.file.path.absolute)
-      const pathExp = FileRouter.routeToPathExpression(route)
-      const $$ = {
-        ...$,
-        Component: Str.Case.camel(`page ` + Str.titlizeSlug(pathExp)),
-      }
-
-      s`
-        import ${$$.Component} from '${filePathExp}'
-
-        ${$$.routes}.push({
-          path: '${pathExp}',
-          Component: ${$$.Component},
-          metadata: ${JSON.stringify(metadata)}
-        })
-      `
-    }
-
-    return s.render()
-  }
-
-  const chConfig = {
-    components: { code: 'CodeBlock' },
-    syntaxHighlighting: {
-      theme: `github-light`,
-    },
-  }
-
-  return [
-    // Plugin 1: MDX Processing
-    {
-      enforce: `pre`,
-      ...mdx({
-        jsxImportSource: `polen/react`,
-        providerImportSource: `polen/mdx`,
-        remarkPlugins: [
-          // Parse frontmatter blocks so they're removed from content
-          remarkFrontmatter,
-          remarkGfm,
-          [remarkCodeHike, chConfig],
-        ],
-        recmaPlugins: [
-          [recmaCodeHike, chConfig],
-        ],
-        rehypePlugins: [],
-      }),
-    },
-
-    // Plugin 2: Pages Management
-    {
-      name: `polen:pages`,
-
-      // Dev server configuration
-      configureServer(server) {
-        // Add pages directory to watcher
-        debug(`configureServer: watch pages directory`, config.paths.project.absolute.pages)
-        server.watcher.add(config.paths.project.absolute.pages)
-
-        // Handle file additions and deletions
-        const handleFileStructureChange = async (file: string, event: `add` | `unlink`) => {
-          if (!Content.isPageFile(file, config.paths.project.absolute.pages)) return
-
-          debug(`Page file ${event === `add` ? `added` : `deleted`}:`, file)
-
-          // Clear cache and rescan
-          scanPages.clear()
-          const newScanResult = await scanPages()
-
-          // Invalidate virtual modules
-          invalidateVirtualModules(server)
-
-          // Report any diagnostics
-          reportDiagnostics(newScanResult.diagnostics)
-
-          // Trigger full reload to ensure routes are updated
-          server.ws.send({ type: `full-reload` })
-        }
-
-        server.watcher.on(`add`, (file) => handleFileStructureChange(file, `add`))
-        server.watcher.on(`unlink`, (file) => handleFileStructureChange(file, `unlink`))
-      },
-
-      // Hot update handling for existing files
-      async handleHotUpdate({ file, server, modules }) {
-        debug(`handleHotUpdate`, file)
-        if (!Content.isPageFile(file, config.paths.project.absolute.pages)) return
-
-        debug(`Page file changed:`, file)
-
-        // Get current pages before clearing cache
-        const oldPages = await scanPages()
-
-        // Clear cache and rescan
-        scanPages.clear()
-        const newScanResult = await scanPages()
-
-        // Check if the visible pages list changed. This can happen when:
-        // - A page's frontmatter `hidden` field changes (true <-> false)
-        // - A page's frontmatter affects its route (though we don't support this yet)
-        // If only the content changed (not frontmatter), we can use fast HMR.
-        const pageStructureChanged = !oldPages || !Arr.equalShallowly(
-          oldPages.list.map(p => Path.format(p.route.file.path.absolute)),
-          newScanResult.list.map(p => Path.format(p.route.file.path.absolute)),
-        )
-
-        if (!pageStructureChanged) {
-          debug(`Page content changed, allowing HMR`)
-          // Let default HMR handle the MDX file change
-          return modules
-        }
-
-        //
-        // ━━ Manual Invalidation
-        //
-
-        debug(`Page structure changed, triggering full reload`)
-
-        // Invalidate virtual modules and trigger reload
-        invalidateVirtualModules(server)
-        reportDiagnostics(newScanResult.diagnostics)
-        server.ws.send({ type: `full-reload` })
-        return []
-      },
-      resolveId(id) {
-        if (id === viProjectPagesCatalog.id) {
-          return viProjectPagesCatalog.resolved
-        }
-      },
-      load: {
-        async handler(id) {
-          if (id !== viProjectPagesCatalog.resolved) return
-          debug(`hook load`)
-
-          const scanResult = await scanPages()
-
-          reportDiagnostics(scanResult.diagnostics)
-          debug(`found visible`, { count: scanResult.list.length })
-
-          //
-          // ━━ Build Sidebar
-          //
-
-          const sidebarIndex = Content.buildSidebarIndex(scanResult)
-
-          //
-          // ━━ Put It All together
-          //
-
-          const projectPagesCatalog: ProjectPagesCatalog = {
-            sidebarIndex,
-            pages: scanResult.list,
-          }
-
-          // Return just the JSON string - let the JSON plugin handle the transformation
-          return superjson.stringify(projectPagesCatalog)
-        },
-      },
-    },
-    // Plugin 3: Virtual Module for React Router Routes
-    {
-      name: `polen:routes`,
-      resolveId(id) {
-        if (id === viProjectRoutes.id) {
-          return viProjectRoutes.resolved
-        }
-      },
-      load: {
-        handler: async (id) => {
-          if (id !== viProjectRoutes.resolved) return
-
-          debug(`Loading viProjectRoutes virtual module`)
-
-          const scanResult = await scanPages()
-          reportDiagnostics(scanResult.diagnostics)
-          const code = generateRoutesModule(scanResult.list)
-
-          // Generate the module code
-          return {
-            code,
-            moduleType: `js`,
-          }
-        },
-      },
-    },
-  ]
-}

package/src/api/vite/plugins/schema-assets.ts

@@ -1,378 +0,0 @@
-import type { Config } from '#api/config/index'
-import { SchemaAugmentation } from '#api/schema-augmentation/index'
-import { createSchemaSource } from '#api/schema-source/index'
-import { Schema } from '#api/schema/index'
-import type { Vite } from '#dep/vite/index'
-import { GraphqlChangeset } from '#lib/graphql-changeset'
-import { SchemaLifecycle } from '#lib/schema-lifecycle'
-import { ViteVirtual } from '#lib/vite-virtual'
-import { debugPolen } from '#singletons/debug'
-import { Cache } from '@wollybeard/kit'
-import * as NodeFs from 'node:fs/promises'
-import * as NodePath from 'node:path'
-import { polenVirtual } from '../vi.js'
-
-export const viProjectSchemaMetadata = polenVirtual([`project`, `schema-metadata`])
-
-/**
- * Vite plugin that generates JSON assets for GraphQL schemas at build time.
- *
- * This plugin:
- * - Reads GraphQL schema files from the project
- * - Applies schema augmentations
- * - Converts schemas to AST format and emits as JSON assets
- * - Creates a metadata file with available versions
- * - Provides a virtual module for accessing schema metadata
- *
- * The generated assets enable client-side loading of different schema versions
- * without requiring all schemas to be bundled into the main JavaScript bundle.
- *
- * @param config - Polen configuration object
- * @returns Vite plugin instance
- */
-export const SchemaAssets = (config: Config.Config): Vite.Plugin => {
-  const debug = debugPolen.sub(`vite-plugin:schema-assets`)
-  let viteServer: Vite.ViteDevServer | null = null
-
-  // Helper to load and process schema data
-  const loadAndProcessSchemaData = Cache.memoize(async () => {
-    const schemaResult = await Schema.readOrThrow({
-      ...config.schema,
-      projectRoot: config.paths.project.rootDir,
-    })
-
-    if (!schemaResult.data) {
-      const metadata: Schema.SchemaMetadata = { hasSchema: false, versions: [] }
-      return {
-        schemaData: null,
-        metadata,
-        source: schemaResult.source,
-      }
-    }
-
-    // Apply augmentations
-    schemaResult.data.forEach(version => {
-      if (version.after) {
-        SchemaAugmentation.apply(version.after.data, config.schemaAugmentations)
-      }
-    })
-
-    // Build metadata
-    const versionStrings: string[] = []
-    for (const [index, version] of schemaResult.data.entries()) {
-      const versionName = index === 0 ? Schema.VERSION_LATEST : Schema.dateToVersionString(version.date)
-      versionStrings.push(versionName)
-    }
-
-    const metadata = {
-      hasSchema: true,
-      versions: versionStrings,
-    }
-
-    debug(`schemaDataLoaded`, { versionCount: schemaResult.data.length })
-
-    return {
-      schemaData: schemaResult.data,
-      metadata,
-      source: schemaResult.source,
-    }
-  })
-
-  // Helper to create schema source with filesystem IO
-  const createDevSchemaSource = (metadata: Schema.SchemaMetadata) => {
-    return createSchemaSource({
-      io: {
-        read: async () => {
-          throw new Error('Read not supported in dev asset writer')
-        },
-        write: async (path: string, content: string) => {
-          await NodeFs.writeFile(path, content, 'utf-8')
-        },
-        clearDirectory: async (path: string) => {
-          try {
-            const files = await NodeFs.readdir(path)
-            await Promise.all(files.map(file => NodeFs.rm(NodePath.join(path, file), { force: true })))
-          } catch (error) {
-            // Directory might not exist, which is fine
-          }
-        },
-        removeFile: async (path: string) => {
-          await NodeFs.rm(path, { force: true })
-        },
-      },
-      versions: metadata.versions,
-      assetsPath: config.paths.framework.devAssets.absolute,
-    })
-  }
-
-  // Helper to create lifecycle data from schema data
-  const createLifecycleData = (
-    schemaData: GraphqlChangeset.ChangelogLinked,
-    metadata: Schema.SchemaMetadata,
-  ): SchemaLifecycle.SchemaLifecycle => {
-    return SchemaLifecycle.create(schemaData)
-  }
-
-  // Helper to write assets using schema-source API
-  const writeDevAssets = async (
-    schemaData: GraphqlChangeset.ChangelogLinked,
-    metadata: Schema.SchemaMetadata,
-  ) => {
-    // schemaData is now guaranteed to be non-null NonEmptyChangeSets
-
-    const devAssetsDir = config.paths.framework.devAssets.schemas
-    await NodeFs.mkdir(devAssetsDir, { recursive: true })
-
-    const lifecycle = createLifecycleData(schemaData, metadata)
-
-    const schemaSource = createDevSchemaSource(metadata)
-    await schemaSource.writeAllAssets(schemaData, metadata, lifecycle)
-    debug(`devAssetsWritten`, { versionCount: schemaData.length })
-  }
-
-  return {
-    name: `polen:schema-assets`,
-
-    configureServer(server) {
-      viteServer = server
-
-      // Clear all assets when dev server starts
-      const clearAssets = async () => {
-        try {
-          // Create a basic schema source just for clearing
-          const schemaSource = createDevSchemaSource({ hasSchema: false, versions: [] })
-          await schemaSource.clearAllAssets()
-          debug(`devAssetsCleared`, {})
-        } catch (error) {
-          // Ignore errors during clearing
-        }
-      }
-
-      // Clear assets immediately
-      void clearAssets()
-
-      // Set up file watching for schema source files
-      if (config.schema?.dataSources?.directory?.path) {
-        // Watch the entire directory for directory mode
-        server.watcher.add(config.schema.dataSources.directory.path)
-        debug(`watchingSchemaDirectory`, { path: config.schema.dataSources.directory.path })
-      }
-
-      if (config.schema?.dataSources?.file?.path) {
-        // Watch the specific file for file mode
-        server.watcher.add(config.schema.dataSources.file.path)
-        debug(`watchingSchemaFile`, { path: config.schema.dataSources.file.path })
-      }
-
-      if (config.schema?.dataSources?.introspection?.url) {
-        // Watch the introspection file if introspection is configured
-        const introspectionFilePath = NodePath.join(config.paths.project.rootDir, `schema.introspection.json`)
-        server.watcher.add(introspectionFilePath)
-        debug(`watchingIntrospectionFile`, { path: introspectionFilePath })
-      }
-
-      // Handle file removal
-      server.watcher.on('unlink', async (file) => {
-        const isSchemaFile = config.schema && (() => {
-          const absoluteFile = NodePath.resolve(file)
-
-          // Check if file path matches the configured schema file
-          if (config.schema.dataSources?.file?.path) {
-            const absoluteSchemaFile = NodePath.resolve(
-              config.paths.project.rootDir,
-              config.schema.dataSources.file.path,
-            )
-            if (absoluteFile === absoluteSchemaFile) return true
-          }
-
-          // Check if file path is within the configured schema directory
-          if (config.schema.dataSources?.directory?.path) {
-            const absoluteSchemaDir = NodePath.resolve(
-              config.paths.project.rootDir,
-              config.schema.dataSources.directory.path,
-            )
-            if (absoluteFile.startsWith(absoluteSchemaDir + NodePath.sep)) return true
-          }
-
-          // Check if file is the introspection file
-          if (config.schema.dataSources?.introspection?.url) {
-            const absoluteIntrospectionFile = NodePath.resolve(
-              config.paths.project.rootDir,
-              `schema.introspection.json`,
-            )
-            if (absoluteFile === absoluteIntrospectionFile) return true
-          }
-
-          return false
-        })()
-
-        if (isSchemaFile) {
-          debug(`schemaFileRemoved`, { file })
-
-          try {
-            // Clear cache and regenerate
-            loadAndProcessSchemaData.clear()
-            const { schemaData, metadata, source } = await loadAndProcessSchemaData()
-
-            // If file was deleted but can be recreated, attempt recreation
-            if (!schemaData && source.reCreate) {
-              debug(`attemptingSchemaRecreation`, { sourceType: source.type })
-              try {
-                const recreatedData = await source.reCreate()
-                if (recreatedData) {
-                  // Clear cache again and reload after recreation
-                  loadAndProcessSchemaData.clear()
-                  const reloadResult = await loadAndProcessSchemaData()
-                  if (reloadResult.schemaData) {
-                    await writeDevAssets(reloadResult.schemaData, reloadResult.metadata)
-                    debug(`hmr:schemaRecreatedAndWritten`, { versionCount: reloadResult.schemaData.length })
-                  }
-                } else {
-                  debug(`hmr:schemaRecreationFailed`, { reason: 'reCreate returned null' })
-                }
-              } catch (recreationError) {
-                debug(`hmr:schemaRecreationFailed`, { error: recreationError })
-              }
-            } else if (schemaData) {
-              // Write new assets without the removed file
-              await writeDevAssets(schemaData, metadata)
-              debug(`hmr:schemaAssetsUpdatedAfterRemoval`, { versionCount: schemaData.length })
-            } else {
-              // No schema data and cannot recreate - clear all assets
-              const schemaSource = createDevSchemaSource({ hasSchema: false, versions: [] })
-              await schemaSource.clearAllAssets()
-              debug(`hmr:allAssetsCleared`, {})
-            }
-          } catch (error) {
-            debug(`hmr:schemaRemovalFailed`, { error })
-          }
-
-          // Send HMR invalidation signal
-          server.ws.send({
-            type: 'custom',
-            event: 'polen:schema-invalidate',
-            data: { timestamp: Date.now() },
-          })
-
-          debug(`hmr:schemaInvalidationSent`, {})
-        }
-      })
-    },
-
-    async buildStart() {
-      debug(`buildStart`, {})
-
-      // Load and process schema data
-      const { schemaData, metadata } = await loadAndProcessSchemaData()
-
-      if (!schemaData) {
-        debug(`noSchemaFound`, {})
-        return
-      }
-
-      // Handle asset generation differently for dev vs build
-      if (viteServer) {
-        // Dev mode: Write assets directly to filesystem
-        await writeDevAssets(schemaData, metadata)
-        debug(`devMode:schemaAssetsWritten`, {})
-        return
-      }
-
-      // Build mode: Create schema source for emitting files
-      const schemaSource = createSchemaSource({
-        io: {
-          read: async () => {
-            throw new Error('Read not supported in build asset emitter')
-          },
-          write: async (path: string, content: string) => {
-            // Convert absolute path to relative filename for Vite
-            const relativePath = NodePath.relative(config.paths.framework.devAssets.absolute, path)
-            const fileName = `${config.paths.project.relative.build.relative.assets.root}/${relativePath}`
-
-            this.emitFile({
-              type: `asset`,
-              fileName,
-              source: content,
-            })
-          },
-        },
-        versions: metadata.versions,
-        assetsPath: config.paths.framework.devAssets.absolute,
-      })
-
-      const lifecycle = createLifecycleData(schemaData, metadata)
-
-      // Emit all assets using the high-level API
-      await schemaSource.writeAllAssets(schemaData, metadata, lifecycle)
-      debug(`buildMode:allAssetsEmitted`, { versionCount: schemaData.length })
-    },
-
-    async handleHotUpdate({ file, server }) {
-      const isSchemaFile = config.schema && (() => {
-        const absoluteFile = NodePath.resolve(file)
-
-        // Check if file path matches the configured schema file
-        if (config.schema.dataSources?.file?.path) {
-          const absoluteSchemaFile = NodePath.resolve(config.paths.project.rootDir, config.schema.dataSources.file.path)
-          if (absoluteFile === absoluteSchemaFile) return true
-        }
-
-        // Check if file path is within the configured schema directory
-        if (config.schema.dataSources?.directory?.path) {
-          const absoluteSchemaDir = NodePath.resolve(
-            config.paths.project.rootDir,
-            config.schema.dataSources.directory.path,
-          )
-          if (absoluteFile.startsWith(absoluteSchemaDir + NodePath.sep)) return true
-        }
-
-        // Check if file is the introspection file
-        if (config.schema.dataSources?.introspection?.url) {
-          const absoluteIntrospectionFile = NodePath.resolve(
-            config.paths.project.rootDir,
-            `schema.introspection.json`,
-          )
-          if (absoluteFile === absoluteIntrospectionFile) return true
-        }
-
-        return false
-      })()
-      if (isSchemaFile) {
-        debug(`schemaFileChanged`, { file })
-
-        // Regenerate schema assets
-        try {
-          loadAndProcessSchemaData.clear()
-          const { schemaData, metadata } = await loadAndProcessSchemaData()
-
-          if (schemaData) {
-            debug(`hmr:schemaRegenerated`, { versionCount: schemaData.length })
-
-            // Write new assets to filesystem
-            await writeDevAssets(schemaData, metadata)
-          }
-        } catch (error) {
-          debug(`hmr:schemaRegenerationFailed`, { error })
-        }
-
-        // Send HMR invalidation signal
-        server.ws.send({
-          type: 'custom',
-          event: 'polen:schema-invalidate',
-          data: { timestamp: Date.now() },
-        })
-
-        debug(`hmr:schemaInvalidationSent`, {})
-      }
-    },
-
-    ...ViteVirtual.IdentifiedLoader.toHooks({
-      identifier: viProjectSchemaMetadata,
-      async loader() {
-        debug(`virtualModuleLoad`, { id: viProjectSchemaMetadata.id })
-        const { metadata } = await loadAndProcessSchemaData()
-        return `export default ${JSON.stringify(metadata)}`
-      },
-    }),
-  }
-}