polen 0.10.0 → 0.11.0-next.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polen",
-  "version": "0.10.0",
+  "version": "0.11.0-next.2",
   "type": "module",
   "description": "A framework for delightful GraphQL developer portals",
   "author": {
@@ -87,18 +87,18 @@
     "@graphql-inspector/core": "^6.2.1",
     "@graphql-tools/load": "^8.1.0",
     "@hiogawa/vite-plugin-ssr-css": "^0.0.1",
-    "@hono/node-server": "^1.15.0",
+    "@hono/node-server": "^1.16.0",
     "@mdx-js/mdx": "^3.1.0",
     "@mdx-js/react": "^3.1.0",
     "@mdx-js/rollup": "^3.1.0",
     "@radix-ui/react-icons": "^1.3.2",
     "@radix-ui/themes": "^3.2.1",
-    "@rolldown/pluginutils": "1.0.0-beta.24",
+    "@rolldown/pluginutils": "1.0.0-beta.27",
     "@rollup/pluginutils": "^5.2.0",
     "@types/jsesc": "^3.0.3",
     "@vitejs/plugin-react": "^4.6.0",
     "@vitejs/plugin-react-oxc": "^0.2.3",
-    "@vltpkg/semver": "0.0.0-16",
+    "@vltpkg/semver": "0.0.0-17",
     "@vue/reactivity": "^3.5.17",
     "@wollybeard/kit": "^0.41.0",
     "@wollybeard/projector": "^0.3.0",
@@ -107,12 +107,12 @@
     "codehike": "^1.0.7",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
-    "es-toolkit": "^1.39.6",
+    "es-toolkit": "^1.39.7",
     "fuse.js": "^7.1.0",
     "graffle": "8.0.0-next.163",
     "graphql": "^16.11.0",
     "gray-matter": "^4.0.3",
-    "hono": "^4.8.4",
+    "hono": "^4.8.5",
     "jsesc": "^3.1.0",
     "jsonc-parser": "^3.3.1",
     "react": "^19.1.0",
@@ -126,22 +126,21 @@
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
     "resolve.imports": "^2.0.3",
-    "rolldown": "1.0.0-beta.24",
+    "rolldown": "1.0.0-beta.27",
     "simple-git": "^3.28.0",
     "source-map": "^0.7.4",
     "superjson": "^2.2.2",
     "tinyglobby": "^0.2.14",
-    "tree-sitter-graphql-grammar-wasm": "^1.0.0",
+    "tree-sitter-graphql-grammar-wasm": "^1.1.0",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "vite": "npm:rolldown-vite@^7.0.4",
+    "vite": "npm:rolldown-vite@^7.0.9",
     "vite-plugin-inspect": "^11.3.0",
-    "vite-plugin-restart": "^0.4.2",
-    "web-tree-sitter": "^0.25.6",
+    "web-tree-sitter": "^0.25.8",
     "youch-core": "^0.3.3",
-    "zx": "8.6.1"
+    "zx": "8.7.1"
   },
   "devDependencies": {
     "@actions/core": "^1.11.1",
@@ -151,15 +150,15 @@
     "@actions/io": "^1.1.3",
     "@changesets/cli": "^2.29.5",
     "@molt/command": "^0.9.0",
-    "@octokit/core": "^7.0.2",
+    "@octokit/core": "^7.0.3",
     "@octokit/types": "^14.1.0",
-    "@playwright/browser-chromium": "^1.53.2",
+    "@playwright/browser-chromium": "^1.54.1",
     "@testing-library/react": "^16.3.0",
     "@tsconfig/node-lts": "^22.0.2",
     "@tsconfig/node22": "^22.0.2",
     "@tsconfig/strictest": "^2.0.5",
     "@types/jsdom": "^21.1.7",
-    "@types/node": "^24.0.10",
+    "@types/node": "^24.0.14",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "@types/semver": "^7.7.0",
@@ -167,10 +166,10 @@
     "dripip": "^0.10.0",
     "fast-check": "^4.2.0",
     "fs-jetpack": "^5.1.0",
-    "get-port-please": "^3.1.2",
+    "get-port-please": "^3.2.0",
     "globals": "^16.3.0",
     "jsdom": "^26.1.0",
-    "playwright": "1.53.2",
+    "playwright": "1.54.1",
     "publint": "^0.3.12",
     "semver": "^7.7.2",
     "strip-ansi": "^7.1.0",

package/src/api/api.ts

@@ -2,4 +2,5 @@ export * from './builder/index.js'
 export * from './config-resolver/index.js'
 export * from './config/index.js'
 export * as Project from './project/index.js'
+export * from './schema/index.js'
 export * from './static/index.js'

package/src/api/config/configurator.ts

@@ -240,22 +240,6 @@ export interface ConfigInput {
      * @default false
      */
     isSelfContainedMode?: boolean
-    /**
-     * Tweak the watch behavior.
-     */
-    watch?: {
-      /**
-       * Restart the development server when some arbitrary files change.
-       *
-       * Use this to restart when files that are not already watched by vite change.
-       *
-       * @see https://github.com/antfu/vite-plugin-restart
-       */
-      /**
-       * File paths to watch and restart the development server when they change.
-       */
-      also?: string[]
-    }
     /**
      * Whether to enable debug mode.
      *
@@ -289,6 +273,13 @@ const buildPaths = (rootDir: string): Config[`paths`] => {
 
   const publicAbsolutePath = rootAbsolute(`public`)
   const publicAbsolute = Path.ensureAbsoluteWith(publicAbsolutePath)
+
+  const assetsAbsolute = Path.ensureAbsoluteWith(buildAbsolute(`assets`))
+
+  // Dev assets paths
+  const devAssetsRelative = 'node_modules/.vite/polen-assets'
+  const devAssetsAbsolute = Path.join(packagePaths.rootDir, devAssetsRelative)
+
   return {
     project: {
       rootDir,
@@ -297,7 +288,12 @@ const buildPaths = (rootDir: string): Config[`paths`] => {
           root: `build`,
           relative: {
             serverEntrypoint: `app.js`,
-            assets: `assets`,
+            assets: {
+              root: `assets`,
+              relative: {
+                schemas: `schemas`,
+              },
+            },
           },
         },
         pages: `pages`,
@@ -311,7 +307,10 @@ const buildPaths = (rootDir: string): Config[`paths`] => {
         build: {
           root: buildAbsolute(`.`),
           serverEntrypoint: buildAbsolute(`app.js`),
-          assets: buildAbsolute(`assets`),
+          assets: {
+            root: buildAbsolute(`assets`),
+            schemas: assetsAbsolute(`schemas`),
+          },
         },
         public: {
           root: publicAbsolute(`.`),
@@ -319,7 +318,14 @@ const buildPaths = (rootDir: string): Config[`paths`] => {
         },
       },
     },
-    framework: packagePaths,
+    framework: {
+      ...packagePaths,
+      devAssets: {
+        relative: devAssetsRelative,
+        absolute: devAssetsAbsolute,
+        schemas: Path.join(devAssetsAbsolute, 'schemas'),
+      },
+    },
   }
 }
 
@@ -331,9 +337,9 @@ export interface Config {
   }
   server: {
     port: number
-  }
-  watch: {
-    also: string[]
+    routes: {
+      assets: string
+    }
   }
   templateVariables: TemplateVariables
   schemaAugmentations: SchemaAugmentation.Augmentation[]
@@ -353,7 +359,12 @@ export interface Config {
         build: {
           root: string
           relative: {
-            assets: string
+            assets: {
+              root: string
+              relative: {
+                schemas: string
+              }
+            }
             serverEntrypoint: string
           }
         }
@@ -366,7 +377,10 @@ export interface Config {
       absolute: {
         build: {
           root: string
-          assets: string
+          assets: {
+            root: string
+            schemas: string
+          }
           serverEntrypoint: string
         }
         pages: string
@@ -376,7 +390,13 @@ export interface Config {
         }
       }
     }
-    framework: PackagePaths
+    framework: PackagePaths & {
+      devAssets: {
+        relative: string
+        absolute: string
+        schemas: string
+      }
+    }
   }
   advanced: {
     isSelfContainedMode: boolean
@@ -392,15 +412,15 @@ const configInputDefaults: Config = {
     title: `My Developer Portal`,
   },
   schemaAugmentations: [],
-  watch: {
-    also: [],
-  },
   build: {
     architecture: BuildArchitecture.enum.ssg,
     base: `/`,
   },
   server: {
     port: 3000,
+    routes: {
+      assets: '/assets',
+    },
   },
   schema: null,
   ssr: {
@@ -499,14 +519,13 @@ export const normalizeInput = async (
     config.advanced.explorer = configInput.advanced.explorer
   }
 
-  if (configInput?.advanced?.watch?.also) {
-    config.watch.also = configInput.advanced.watch.also
-  }
-
   if (configInput?.server?.port !== undefined) {
     config.server.port = configInput.server.port
   }
 
+  // Server routes are not configurable by users yet, use defaults
+  // config.server.routes is already set from defaultConfig
+
   // Process warnings configuration
   if (configInput?.warnings?.interactiveWithoutSchema?.enabled !== undefined) {
     config.warnings.interactiveWithoutSchema.enabled = configInput.warnings.interactiveWithoutSchema.enabled

package/src/api/config/merge.ts

@@ -48,22 +48,6 @@ export const mergeInputs = (
   if (base.advanced ?? overrides.advanced) {
     merged.advanced = spreadShallow(base.advanced, overrides.advanced)
 
-    // Merge advanced.watch config
-    if (base.advanced?.watch ?? overrides.advanced?.watch) {
-      merged.advanced.watch = spreadShallow(
-        base.advanced?.watch,
-        overrides.advanced?.watch,
-      )
-
-      // Merge watch.also arrays
-      if (base.advanced?.watch?.also ?? overrides.advanced?.watch?.also) {
-        merged.advanced.watch.also = [
-          ...(base.advanced?.watch?.also ?? []),
-          ...(overrides.advanced?.watch?.also ?? []),
-        ]
-      }
-    }
-
     // Merge Vite configs if present
     if (base.advanced?.vite ?? overrides.advanced?.vite) {
       merged.advanced.vite = Vite.mergeConfig(

package/src/api/content/metadata.ts

@@ -1,4 +1,4 @@
-import { z } from 'zod/v4'
+import { z } from 'zod'
 
 /**
  * Schema for validating front matter content

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

@@ -2,7 +2,7 @@ import { Grafaid } from '#lib/grafaid/index'
 import { GraphqlChange } from '#lib/graphql-change/index'
 import type { GraphqlChangeset } from '#lib/graphql-changeset/index'
 import { Arr } from '@wollybeard/kit'
-import type { Schema } from '../../schema.js'
+import type { NonEmptyChangeSets } from '../../schema.js'
 
 /**
  * Configuration for defining schemas programmatically in memory.
@@ -68,7 +68,7 @@ export const normalize = (configInput: ConfigInput): Config => {
 
 export const read = async (
   configInput: ConfigInput,
-): Promise<null | Schema> => {
+): Promise<null | NonEmptyChangeSets> => {
   const config = normalize(configInput)
 
   if (!Arr.isntEmpty(config.versions)) {
@@ -109,9 +109,7 @@ export const read = async (
 
   changesets.reverse()
 
-  const schema: Schema = {
-    versions: changesets,
-  }
+  const schema: NonEmptyChangeSets = changesets
 
   return schema
 }

package/src/api/schema/data-sources/schema-directory/file-name-expression/file-name-expression.ts

@@ -1,6 +1,6 @@
 import { Path } from '@wollybeard/kit'
 
-export type Expression = ExpressionPrevious
+export type Expression = ExpressionVersioned | ExpressionSingle
 
 export const parseOrThrow = (fileNameOrSerializedExpression: string): Expression => {
   const result = parse(fileNameOrSerializedExpression)
@@ -18,41 +18,57 @@ export const parse = (fileName: string): null | Expression => {
   }
   const serializedExpression = path.name
 
-  const previous = parseExpressionPreviousSerialized(serializedExpression)
-  if (previous) return { ...previous, filePath: fileName, type: `FileNameExpressionPrevious` }
+  const versioned = parseExpressionVersionedSerialized(serializedExpression)
+  if (versioned) return { ...versioned, filePath: fileName, type: `FileNameExpressionVersioned` }
 
-  // const latest = parseExpressionLatestSerialized(serializedExpression)
-  // if (latest) return { ...latest, filePath: fileName, type: `FileNameExpressionLatest` }
+  const single = parseExpressionSingleSerialized(serializedExpression)
+  if (single) return { ...single, filePath: fileName, type: `FileNameExpressionSingle` }
 
   return null
 }
 
 // ----
 
-export interface ExpressionPrevious {
-  type: `FileNameExpressionPrevious`
+export interface ExpressionVersioned {
+  type: `FileNameExpressionVersioned`
   date: Date
   filePath: string
 }
 
-const parseExpressionPreviousSerialized = (
+const parseExpressionVersionedSerialized = (
   serializedExpression: string,
-): Pick<ExpressionPrevious, `date`> | null => {
-  const match = expressionPreviousSerializedPattern.exec(serializedExpression)
+): Pick<ExpressionVersioned, `date`> | null => {
+  const match = expressionVersionedSerializedPattern.exec(serializedExpression)
   if (!match) return null
   const { year, month, day } = match.groups as { year: string; month: string; day: string }
   const date = new Date(parseInt(year), parseInt(month) - 1, parseInt(day))
   return { date }
 }
 
-const expressionPreviousSerializedPattern = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/
+const expressionVersionedSerializedPattern = /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/
 
-// export const isExpressionPrevious = (expression: Expression): expression is ExpressionPrevious => {
-//   return expression.type === `FileNameExpressionPrevious`
+// export const isExpressionVersioned = (expression: Expression): expression is ExpressionVersioned => {
+//   return expression.type === `FileNameExpressionVersioned`
 // }
 
 // ----
 
+export interface ExpressionSingle {
+  type: `FileNameExpressionSingle`
+  filePath: string
+}
+
+const parseExpressionSingleSerialized = (
+  serializedExpression: string,
+): {} | null => {
+  if (serializedExpression === `schema`) {
+    return {}
+  }
+  return null
+}
+
+// ----
+
 // export interface ExpressionLatest {
 //   type: `FileNameExpressionLatest`
 //   filePath: string

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

@@ -4,7 +4,8 @@ import type { GraphqlChangeset } from '#lib/graphql-changeset/index'
 import { debugPolen } from '#singletons/debug'
 import { Arr, Path } from '@wollybeard/kit'
 import { glob } from 'tinyglobby'
-import type { Schema } from '../../schema.js'
+import type { NonEmptyChangeSets } from '../../schema.js'
+import { readSingleSchemaFile } from '../schema-file/schema-file.js'
 import { FileNameExpression } from './file-name-expression/index.js'
 
 // const debug = debugPolen.sub([`schema`, `data-source-schema-directory`])
@@ -15,15 +16,19 @@ const defaultPaths = {
 }
 
 /**
- * Configuration for loading multiple schema versions from a directory.
+ * Configuration for loading schema(s) from a directory.
  *
- * Enables the schema changelog feature by loading SDL files with date prefixes.
+ * Supports two modes:
+ * 1. Multiple versioned schemas with date prefixes (enables changelog feature)
+ * 2. Single schema file named 'schema.graphql' (non-versioned, like file data source)
  */
 export interface ConfigInput {
   /**
-   * Path to the directory containing dated SDL files.
+   * Path to the directory containing schema files.
    *
-   * Files should be named with ISO date prefixes: `YYYY-MM-DD.graphql`
+   * Supports two patterns:
+   * 1. Multiple versioned files with ISO date prefixes: `YYYY-MM-DD.graphql`
+   * 2. Single file named: `schema.graphql`
    *
    * @default './schema'
    *
@@ -36,12 +41,17 @@ export interface ConfigInput {
    * path: './graphql/versions'
    * ```
    *
-   * Directory structure example:
+   * Directory structure examples:
    * ```
+   * // Versioned schemas (enables changelog)
    * schema/
    *   2024-01-15.graphql
    *   2024-03-20.graphql
    *   2024-06-10.graphql
+   *
+   * // Single schema (non-versioned)
+   * schema/
+   *   schema.graphql
    * ```
    */
   path?: string
@@ -61,7 +71,7 @@ export const normalizeConfig = (configInput: ConfigInput): Config => {
   return config
 }
 
-export const readOrThrow = async (configInput: ConfigInput): Promise<null | Schema> => {
+export const readOrThrow = async (configInput: ConfigInput): Promise<null | NonEmptyChangeSets> => {
   const config = normalizeConfig(configInput)
 
   debug(`will search`, config)
@@ -80,7 +90,42 @@ export const readOrThrow = async (configInput: ConfigInput): Promise<null | Sche
   const fileNameExpressions = Arr.map(filePaths, FileNameExpression.parseOrThrow)
   debug(`parsed file names`, fileNameExpressions)
 
-  const versions = await Promise.all(Arr.map(fileNameExpressions, async fileNameExpression => {
+  // Separate versioned (dated) and single schema files
+  const versionedExpressions = fileNameExpressions.filter(
+    (expr): expr is FileNameExpression.ExpressionVersioned => expr.type === `FileNameExpressionVersioned`,
+  )
+  const singleExpressions = fileNameExpressions.filter(
+    (expr): expr is FileNameExpression.ExpressionSingle => expr.type === `FileNameExpressionSingle`,
+  )
+
+  // If we have versioned files, use them (versioned takes precedence)
+  if (Arr.isntEmpty(versionedExpressions)) {
+    return await readVersionedSchemas(versionedExpressions)
+  }
+
+  // If we have a single schema file, use it
+  if (Arr.isntEmpty(singleExpressions)) {
+    if (singleExpressions.length > 1) {
+      throw new Error(
+        `Multiple single schema files found, expected exactly one: ${
+          singleExpressions.map(e => e.filePath).join(', ')
+        }`,
+      )
+    }
+    return await readSingleSchemaFile(singleExpressions[0].filePath)
+  }
+
+  // Should not happen since we already checked for empty filePaths
+  throw new Error(`No schema files found despite non-empty file paths`)
+}
+
+/**
+ * Read multiple versioned schema files and create changesets
+ */
+const readVersionedSchemas = async (
+  versionedExpressions: FileNameExpression.ExpressionVersioned[],
+): Promise<NonEmptyChangeSets> => {
+  const versions = await Promise.all(Arr.map(versionedExpressions, async fileNameExpression => {
     const schemaFile = await Grafaid.Schema.read(fileNameExpression.filePath)
     // Should never happen since these paths come from the glob.
     if (!schemaFile) throw new Error(`Failed to read schema file: ${fileNameExpression.filePath}`)
@@ -90,7 +135,7 @@ export const readOrThrow = async (configInput: ConfigInput): Promise<null | Sche
       schema: schemaFile.content,
     }
   }))
-  debug(`read schemas`)
+  debug(`read versioned schemas`)
 
   versions.sort((a, b) => a.date.getTime() - b.date.getTime())
 
@@ -118,11 +163,6 @@ export const readOrThrow = async (configInput: ConfigInput): Promise<null | Sche
 
   changesets.reverse()
 
-  const schema: Schema = {
-    versions: changesets,
-  }
-
-  debug(`computed schema`)
-
-  return schema
+  debug(`computed versioned schema`)
+  return changesets as NonEmptyChangeSets
 }

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

@@ -2,7 +2,7 @@ import { Grafaid } from '#lib/grafaid/index'
 import { GraphqlChange } from '#lib/graphql-change/index'
 import type { GraphqlChangeset } from '#lib/graphql-changeset/index'
 import { Path } from '@wollybeard/kit'
-import type { Schema } from '../../schema.js'
+import type { NonEmptyChangeSets } from '../../schema.js'
 
 const defaultPaths = {
   schemaFile: `./schema.graphql`,
@@ -46,13 +46,24 @@ export const normalizeConfig = (configInput: ConfigInput): Config => {
 
 export const readOrThrow = async (
   configInput: ConfigInput,
-): Promise<null | Schema> => {
+): Promise<null | NonEmptyChangeSets> => {
   const config = normalizeConfig(configInput)
 
   const schemaFile = await Grafaid.Schema.read(config.path)
   if (!schemaFile) return null
 
-  const date = new Date()
+  return await readSingleSchemaFile(config.path)
+}
+
+/**
+ * Create a single changeset from a schema file path.
+ * This is the core logic for handling single (unversioned) schemas.
+ */
+export const readSingleSchemaFile = async (filePath: string): Promise<NonEmptyChangeSets> => {
+  const schemaFile = await Grafaid.Schema.read(filePath)
+  if (!schemaFile) throw new Error(`Failed to read schema file: ${filePath}`)
+
+  const date = new Date() // Generate date here for unversioned schema
   const after = schemaFile.content
   const before = Grafaid.Schema.empty
   const changes = await GraphqlChange.calcChangeset({
@@ -60,16 +71,14 @@ export const readOrThrow = async (
     after,
   })
 
-  const schemaVersion: GraphqlChangeset.ChangeSet = {
+  const changeset: GraphqlChangeset.ChangeSet = {
     date,
     after,
     before,
     changes,
   }
 
-  const schema: Schema = {
-    versions: [schemaVersion],
-  }
+  const schema: NonEmptyChangeSets = [changeset]
 
   return schema
 }

package/src/api/schema/metadata.ts

@@ -0,0 +1,23 @@
+import { Fs } from '@wollybeard/kit'
+import { z } from 'zod'
+
+export const SchemaMetadataSchema = z.object({
+  /** Whether a schema is present in the project */
+  hasSchema: z.boolean(),
+  /** Array of available version identifiers */
+  versions: z.array(z.string()),
+})
+
+export type SchemaMetadata = z.infer<typeof SchemaMetadataSchema>
+
+export const getMetadata = async (path: string): Promise<SchemaMetadata> => {
+  const result = await Fs.readJson(path)
+  if (!result) {
+    return {
+      hasSchema: false,
+      versions: [],
+    }
+  }
+
+  return SchemaMetadataSchema.parse(result)
+}

package/src/api/schema/read.ts

@@ -1,6 +1,6 @@
 import { Arr } from '@wollybeard/kit'
 import * as DataSources from './data-sources/data-sources.js'
-import type { Schema } from './schema.js'
+import type { NonEmptyChangeSets } from './schema.js'
 
 export type DataSourceType = `file` | `directory` | `memory` | `data`
 
@@ -55,14 +55,14 @@ export interface Config {
     /**
      * Pre-built schema object to use directly.
      */
-    data?: Schema
+    data?: NonEmptyChangeSets
   }
   projectRoot: string
 }
 
 export const readOrThrow = async (
   config: Config,
-): Promise<null | Schema> => {
+): Promise<null | NonEmptyChangeSets> => {
   if (config.enabled === false) {
     return null
   }