polen 0.11.0-next.13 → 0.11.0-next.15

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

@@ -1,108 +0,0 @@
-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 { debugPolen } from '#singletons/debug'
-import { Fs } from '@wollybeard/kit'
-import type { Plugin } from 'vite'
-
-const viLogo = polenVirtual([`project`, `assets`, `logo.svg`])
-
-const generateDefaultLogo = async () => {
-  return `<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 128 128" width="128" height="128">
-  <circle cx="64" cy="64" r="48" fill="none" stroke="black" stroke-width="8"/>
-</svg>`
-}
-
-export function Branding(config: Config.Config): Plugin {
-  const debug = debugPolen.sub(`vite-plugin:branding`)
-  debug(`initialized`)
-
-  return {
-    name: `polen:branding`,
-    enforce: `pre`,
-
-    async buildStart() {
-      this.addWatchFile(config.paths.project.absolute.public.logo)
-    },
-
-    async handleHotUpdate({ file, server }) {
-      return await handleWatchedFileChange({
-        watchedFile: config.paths.project.absolute.public.logo,
-        changedFile: file,
-        moduleId: viLogo.resolved,
-        server,
-        debug: debug,
-      })
-    },
-
-    resolveId(id) {
-      if (id === viLogo.id) {
-        return viLogo.resolved
-      }
-    },
-
-    async load(id) {
-      if (id === viLogo.resolved) {
-        const logoFileContent = await Fs.read(config.paths.project.absolute.public.logo)
-        const content = logoFileContent ? logoFileContent : await generateDefaultLogo()
-        const dataUrl = `data:image/svg+xml;base64,${Buffer.from(content).toString(`base64`)}`
-        return `export default ${JSON.stringify(dataUrl)}`
-      }
-    },
-  }
-}
-
-interface HandleWatchedFileChangeParams {
-  watchedFile: string
-  changedFile: string
-  moduleId: string
-  server: Vite.ViteDevServer
-  debug: (msg: string, data?: any) => void
-}
-
-const handleWatchedFileChange = async (
-  params: HandleWatchedFileChangeParams,
-): Promise<Vite.ModuleNode[] | void> => {
-  const { watchedFile, changedFile, moduleId, server, debug } = params
-
-  // Check if change is for watched file
-  if (changedFile !== watchedFile) return
-
-  // Check current existence
-  const existsNow = await Fs.exists(watchedFile)
-
-  // Check previous existence via module graph
-  const module = server.moduleGraph.getModuleById(moduleId)
-  const existedBefore = !!module
-
-  // Early return if no mutation
-  if (!existedBefore && !existsNow) {
-    debug(`no mutation detected - file didn't exist before or after`, { file: changedFile })
-    return
-  }
-
-  const mutationType = getMutationType({
-    before: existedBefore,
-    after: existsNow,
-  } as ExistenceDiff)
-
-  debug(`file ${mutationType}`, { file: changedFile })
-
-  switch (mutationType) {
-    case MutationType.Create:
-      // Full reload needed - module never existed
-      server.ws.send({
-        type: `full-reload`,
-        path: `*`,
-      })
-      break
-
-    case MutationType.Update:
-    case MutationType.Delete:
-      // Invalidate module for HMR
-      server.moduleGraph.invalidateModule(module!)
-      // Return empty array to prevent default HMR
-      return []
-  }
-}

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

@@ -1,179 +0,0 @@
-import type { Config } from '#api/config/index'
-import type { PolenBuildManifest } from '#api/static/manifest'
-import { Vite } from '#dep/vite/index'
-import { ViteVirtual } from '#lib/vite-virtual'
-import { debugPolen } from '#singletons/debug'
-import { Fs, Path } from '@wollybeard/kit'
-import packageJson from '../../../../package.json' with { type: 'json' }
-import { isKitUnusedExternalImport, isRadixModuleLevelDirective } from '../log-filters.js'
-import { polenVirtual } from '../vi.js'
-
-export const Build = (config: Config.Config): Vite.Plugin[] => {
-  const debug = debugPolen.sub(`vite-build`)
-  debug(`construct`)
-  // let viteConfigResolved: Vite.ResolvedConfig
-
-  // const outDir = Path.join(config.paths.project.rootDir, `dist`)
-
-  return [
-    Manifest(config),
-    BuildManifest(config),
-    {
-      name: `polen:build-client`,
-      apply: `build`,
-      applyToEnvironment: Vite.isEnvironmentClient,
-      // HACK: For some reason the ?url import doesn't lead to a rewrite in the build.
-      // Furthermore we need to rely on the manifest to get its final name because it is
-      // generated by the client build before the server build.
-      // However, we still need the asset in development.
-      // But we cannot exclude the import in build.
-      // So this does that for us but it is really hacky.
-      // FIXME
-      // 1. Raise issue about having ?url lead to expected build path rewrite?
-      // 2. And: Move asset generation to server build?
-      // 3. And/or: Use Vite Environments API?
-      generateBundle(_, bundle, isWrite) {
-        if (isWrite) {
-          for (const chunkOrAsset of Object.values(bundle)) {
-            if (chunkOrAsset.type === `asset` && chunkOrAsset.names.includes(`entry.client.jsx`)) {
-              delete bundle[chunkOrAsset.fileName]
-            }
-          }
-        }
-      },
-      onLog(_, message) {
-        if (isRadixModuleLevelDirective(message)) return
-        if (isKitUnusedExternalImport(message)) return
-      },
-      config() {
-        return {
-          environments: {
-            client: {
-              build: {
-                manifest: true,
-                rollupOptions: {
-                  input: [config.paths.framework.template.absolute.client.entrypoint],
-                  external: id => id.startsWith(`node:`),
-                  onwarn(message) {
-                    if (isKitUnusedExternalImport(message)) return
-                  },
-                },
-              },
-            },
-          },
-        }
-      },
-    },
-
-    {
-      name: `polen-ssr-build`,
-      apply: `build`,
-      applyToEnvironment: Vite.isEnvironmentSsr,
-      config() {
-        return {
-          // Have to configure this here??
-          // @see https://github.com/vitejs/vite/issues/20098
-          ssr: {
-            noExternal: true,
-            // Exclude lightningcss from bundling due to native bindings
-            // @see https://github.com/parcel-bundler/lightningcss/issues/701
-            external: ['lightningcss'],
-          },
-          environments: {
-            ssr: {
-              build: {
-                // NO EFFECT (see above)
-                // Bundle all dependencies instead of externalizing them
-                // noExternal: true,
-                // The SSR build will follow the client build, and emptying the dir would lose the output of the client build.
-                emptyOutDir: false,
-                rollupOptions: {
-                  input: [config.paths.framework.template.absolute.server.entrypoint],
-                  output: {
-                    entryFileNames: config.paths.project.relative.build.relative.serverEntrypoint,
-                  },
-                },
-              },
-            },
-          },
-        }
-      },
-      onLog(_, message) {
-        if (isKitUnusedExternalImport(message)) return
-      },
-      // generateBundle(_, bundle, isWrite) {
-      //   if (isWrite) {
-      //     for (const chunkOrAsset of Object.values(bundle)) {
-      //       console.log(chunkOrAsset)
-      //       if (chunkOrAsset.type === `chunk`) {
-      //         if (chunkOrAsset.facadeModuleId === viClientManifest.resolved) {
-      //           delete bundle[chunkOrAsset.fileName]
-      //         }
-      //       }
-      //     }
-      //   }
-      // },
-      async closeBundle() {
-        /**
-         * clean up the manifest. Was generated by client. For server build. Not needed after (unless debugging).
-         */
-        if (!config.advanced.debug) {
-          await Fs.remove(Path.join(config.paths.project.absolute.build.root, `.vite`))
-        }
-      },
-    },
-  ]
-}
-
-const viClientManifest = polenVirtual([`vite`, `client`, `manifest`])
-
-const Manifest = (config: Config.Config): Vite.Plugin => {
-  let configEnv: Vite.ConfigEnv
-
-  return {
-    name: `polen-manifest`,
-    config(_, configEnv_) {
-      configEnv = configEnv_
-    },
-    ...ViteVirtual.IdentifiedLoader.toHooks(
-      {
-        identifier: viClientManifest,
-        loader: async () => {
-          // In development just return an empty manifest
-          if (configEnv.mode === Vite.ModeName.development) {
-            return `export default {}`
-          }
-
-          const manifestPath = Path.join(config.paths.project.absolute.build.root, `.vite`, `manifest.json`)
-          const module = await import(manifestPath, { with: { type: `json` } }) as {
-            default: Vite.Manifest
-          }
-
-          return `export default ${JSON.stringify(module.default)}`
-        },
-      },
-    ),
-  }
-}
-
-const BuildManifest = (config: Config.Config): Vite.Plugin => {
-  return {
-    name: `polen:build-manifest`,
-    apply: `build`,
-    applyToEnvironment: Vite.isEnvironmentClient,
-    async generateBundle() {
-      const manifest: PolenBuildManifest = {
-        type: config.build.architecture === `ssr` ? `ssr` : `ssg`,
-        version: packageJson.version,
-        basePath: config.build.base ?? `/`,
-      }
-
-      // Emit the manifest as an asset
-      this.emitFile({
-        type: `asset`,
-        fileName: `.polen/build.json`,
-        source: JSON.stringify(manifest, null, 2),
-      })
-    },
-  }
-}

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

@@ -1,244 +0,0 @@
-import type { Config } from '#api/config/index'
-import { Content } from '#api/content/$'
-import { createNavbar, type NavbarItem } from '#api/content/navbar'
-import { Api } from '#api/index'
-import { VitePluginSelfContainedMode } from '#cli/_/self-contained-mode'
-import type { ReactRouter } from '#dep/react-router/index'
-import type { Vite } from '#dep/vite/index'
-import { VitePluginJson } from '#lib/vite-plugin-json'
-import { ViteVirtual } from '#lib/vite-virtual'
-import { debugPolen } from '#singletons/debug'
-import { superjson } from '#singletons/superjson'
-import { Json, Str } from '@wollybeard/kit'
-import { fileURLToPath } from 'node:url'
-import type { ProjectData } from '../../../project-data.js'
-import { SchemaAugmentation } from '../../schema-augmentation/index.js'
-import { Schema } from '../../schema/index.js'
-import { polenVirtual } from '../vi.js'
-import { Pages } from './pages.js'
-import { SchemaAssets } from './schema-assets.js'
-
-const viTemplateVariables = polenVirtual([`template`, `variables`])
-const viTemplateSchemaAugmentations = polenVirtual([`template`, `schema-augmentations`])
-export const viProjectData = polenVirtual([`project`, `data.jsonsuper`], { allowPluginProcessing: true })
-export const viProjectSchema = polenVirtual([`project`, `schema.jsonsuper`], { allowPluginProcessing: true })
-
-export interface ProjectRoutesModule {
-  routes: ReactRouter.RouteObject[]
-}
-
-export const Core = (config: Config.Config): Vite.PluginOption[] => {
-  let schemaCache: Awaited<ReturnType<typeof Schema.readOrThrow>> | null = null
-
-  const readSchema = async () => {
-    if (schemaCache === null) {
-      const schemaResult = await Schema.readOrThrow({
-        ...config.schema,
-        projectRoot: config.paths.project.rootDir,
-      })
-      // todo: augmentations scoped to a version
-      schemaResult.data?.forEach(version => {
-        if (version.after) {
-          SchemaAugmentation.apply(version.after.data, config.schemaAugmentations)
-        }
-      })
-      schemaCache = schemaResult
-    }
-    return schemaCache
-  }
-
-  const plugins: Vite.Plugin[] = []
-
-  // Note: The main use for this right now is to resolve the react imports
-  // from the mdx vite plugin which have to go through the Polen exports since Polen keeps those deps bundled.
-  //
-  // If we manage to get the mdx vite plugin that defers JSX transform to Rolldown then we can remove this!
-  //
-  if (config.advanced.isSelfContainedMode) {
-    plugins.push(VitePluginSelfContainedMode({
-      projectDirPathExp: config.paths.project.rootDir,
-    }))
-  }
-
-  const jsonsuper = VitePluginJson.create({
-    codec: {
-      validate: superjson,
-      importPath: `#singletons/superjson`,
-      importExport: `superjson`,
-    },
-    filter: {
-      moduleTypes: [`jsonsuper`],
-    },
-  })
-
-  return [
-    ...plugins,
-    SchemaAssets(config),
-    /**
-     * If a `polen*` import is encountered from the user's project, resolve it to the currently
-     * running source code of Polen rather than the user's node_modules.
-     *
-     * Useful for the following cases:
-     *
-     * 1. Main: Using Polen CLI from the source code against some local example/development project.
-     *
-     * 2. Secondary: Using Polen CLI on a project that does not have Polen installed.
-     *    (User would likely not want to do this because they would not be able to achieve type safety)
-     */
-    {
-      name: `polen:internal-import-alias`,
-      enforce: `pre` as const,
-      resolveId(id, importer) {
-        // const debug = debugPolen.sub(`vite-plugin:internal-import-alias`)
-
-        const isPolenImporter = Boolean(
-          importer
-            && (
-              importer.startsWith(config.paths.framework.sourceDir)
-              || polenVirtual.includes(importer)
-              || (importer.startsWith(config.paths.framework.rootDir) && importer.endsWith(`index.html`))
-            ),
-        )
-
-        if (!isPolenImporter) return null
-        // debug(`check candidate`, { id, importer, isPolenImporter })
-
-        const find = Str.pattern<{ groups: [`path`] }>(/^#(?<path>.+)/)
-        const match = Str.match(id, find)
-        if (!match) return null
-
-        // Use Node's resolver to handle package.json imports correctly
-        try {
-          const resolved = import.meta.resolve(id)
-          const to = fileURLToPath(resolved)
-          // debug(`did resolve`, { from: id, to })
-          return to
-        } catch {
-          // If resolution fails, return null to let other resolvers handle it
-          return null
-        }
-      },
-    },
-    jsonsuper,
-    ...Pages({
-      config,
-    }),
-    {
-      name: `polen:core`,
-      config(_, { command }) {
-        return {
-          root: config.paths.framework.rootDir,
-          // todo
-          // future: {
-          //   removePluginHookHandleHotUpdate: 'warn',
-          //   removePluginHookSsrArgument: 'warn',
-          //   removeServerModuleGraph: 'warn',
-          //   removeServerHot: 'warn',
-          //   removeServerTransformRequest: 'warn',
-          //   removeSsrLoadModule: 'warn',
-          // },
-          define: {
-            __BUILDING__: Json.encode(command === `build`),
-            __SERVING__: Json.encode(command === `serve`),
-            __COMMAND__: Json.encode(command),
-            __BUILD_ARCHITECTURE__: Json.encode(config.build.architecture),
-            __BUILD_ARCHITECTURE_SSG__: Json.encode(config.build.architecture === `ssg`),
-            'process.env.NODE_ENV': Json.encode(config.advanced.debug ? 'development' : 'production'),
-          },
-          // customLogger: createLogger(config),
-          esbuild: false,
-          build: {
-            target: `esnext`,
-            assetsDir: config.paths.project.relative.build.relative.assets.root,
-            rollupOptions: {
-              treeshake: {
-                // Aggressive tree-shaking for smallest bundles
-                moduleSideEffects: false, // Only include code if an export is actually used
-                annotations: true, // Respect @__PURE__ annotations for better dead code elimination
-                unknownGlobalSideEffects: false, // Assume global functions don't have side effects
-              },
-            },
-            minify: !config.advanced.debug,
-            outDir: config.paths.project.absolute.build.root,
-            emptyOutDir: true, // disables warning that build dir not in root dir; expected b/c root dir = framework package
-          },
-        }
-      },
-      ...ViteVirtual.IdentifiedLoader.toHooks(
-        {
-          identifier: viProjectSchema,
-          async loader() {
-            const debug = debugPolen.sub(`module-project-schema`)
-            debug(`load`, { id: viProjectSchema.id })
-
-            const schemaResult = await readSchema()
-            return superjson.stringify(schemaResult.data)
-          },
-        },
-        {
-          identifier: viTemplateVariables,
-          loader() {
-            const s = `export const templateVariables = ${JSON.stringify(config.templateVariables)}`
-            return s
-          },
-        },
-        {
-          identifier: viTemplateSchemaAugmentations,
-          loader() {
-            const s = `export const schemaAugmentations = ${JSON.stringify(config.schemaAugmentations)}`
-            return s
-          },
-        },
-        {
-          identifier: viProjectData,
-          async loader() {
-            const debug = debugPolen.sub(`module-project-data`)
-
-            debug(`load`, { id: viProjectData.id })
-
-            const schemaResult = await readSchema()
-
-            const navbar: NavbarItem[] = []
-
-            // ━ Schema presence causes adding some navbar items
-            if (schemaResult.data) {
-              // IMPORTANT: Always ensure paths start with '/' for React Router compatibility.
-              // Without the leading slash, React Router treats paths as relative, which causes
-              // hydration mismatches between SSR (where base path is prepended) and client
-              // (where basename is configured). This ensures consistent behavior.
-              const referencePath = Api.Schema.Routing.createReferenceBasePath()
-              navbar.push({ pathExp: referencePath, title: `Reference`, position: 'left' })
-              if (schemaResult.data.length > 1) {
-                navbar.push({ pathExp: `/changelog`, title: `Changelog`, position: 'right' })
-              }
-            }
-
-            //
-            // ━━ Scan pages and add to navbar
-            //
-
-            const pagesDir = config.paths.project.absolute.pages
-            const scanResult = await Content.scan({ dir: pagesDir })
-            const data = createNavbar(scanResult.list)
-            navbar.push(...data)
-
-            //
-            // ━━ Put It All together
-            //
-
-            const projectData: ProjectData = {
-              basePath: config.build.base,
-              paths: config.paths,
-              navbar, // Complete navbar with schema and pages
-              server: config.server,
-              warnings: config.warnings,
-            }
-
-            // Return just the JSON string - let the JSON plugin handle the transformation
-            return superjson.stringify(projectData)
-          },
-        },
-      ),
-    },
-  ]
-}

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

@@ -1,40 +0,0 @@
-import type { Config } from '#api/config/index'
-import type { Vite } from '#dep/vite/index'
-import { vitePluginSsrCss } from '@hiogawa/vite-plugin-ssr-css'
-import ViteReact from '@vitejs/plugin-react-oxc'
-import { Path } from '@wollybeard/kit'
-import Inspect from 'vite-plugin-inspect'
-import { Branding } from './branding.js'
-import { Build } from './build.js'
-import { Core } from './core.js'
-import { Serve } from './serve.js'
-
-export const Main = (
-  config: Config.Config,
-): Vite.PluginOption => {
-  const plugins: Vite.PluginOption = []
-
-  // Optional Plugins based on config
-
-  if (config.advanced.explorer) {
-    const outputDir = Path.join(config.paths.project.rootDir, `.bundle-explorer`)
-    const plugin = Inspect({
-      build: true,
-      outputDir,
-    })
-    plugins.push(plugin)
-  }
-
-  plugins.push(
-    ViteReact(),
-    vitePluginSsrCss({
-      entries: [`/${config.paths.framework.template.relative.client.entrypoint}`],
-    }),
-    Branding(config),
-    Core(config),
-    Serve(config),
-    Build(config),
-  )
-
-  return plugins
-}