polen 0.10.0-next.9 → 0.11.0-next.1

package/build/template/sources/schema-source.js

@@ -0,0 +1,63 @@
+import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper';
+import PROJECT_SCHEMA_METADATA from 'virtual:polen/project/schema-metadata';
+import { createSchemaSource } from '../../api/schema-source/index.js';
+import { polenUrlPathAssets } from '../lib/polen-url.js';
+// Environment-specific IO implementation
+const io = import.meta.env.SSR
+    ? {
+        // Server-side: Read from filesystem
+        read: async (path) => {
+            // Dynamic import to keep fs out of client bundle
+            const { readFile } = await import('node:fs/promises');
+            // Extract the path after the assets route
+            // e.g., "/assets/schemas/latest.json" -> "schemas/latest.json"
+            const assetsRoute = PROJECT_DATA.server.routes.assets;
+            const routePattern = new RegExp(`^${assetsRoute}/(.+)$`);
+            const match = path.match(routePattern);
+            const assetPath = match ? match[1] : path;
+            // In SSR, we need to read from the correct location
+            // During dev, assets are served from Polen's node_modules
+            // In production, they're in the build output directory
+            let fullPath;
+            if (import.meta.env.DEV) {
+                // Development: Read from Polen's Vite cache
+                fullPath = `${PROJECT_DATA.paths.framework.devAssets.absolute}/${assetPath}`;
+            }
+            else {
+                // Production: Read from build output
+                // The server runs from the project root, and assets are in build/assets/
+                fullPath =
+                    `${PROJECT_DATA.paths.project.relative.build.root}/${PROJECT_DATA.paths.project.relative.build.relative.assets.root}/${assetPath}`;
+            }
+            return readFile(fullPath, 'utf-8');
+        },
+    }
+    : {
+        // Client-side: Fetch from HTTP
+        read: async (path) => {
+            const response = await fetch(path);
+            if (!response.ok) {
+                throw new Error(`Failed to fetch: ${path} (${response.status} ${response.statusText})`);
+            }
+            return response.text();
+        },
+    };
+// Create and export the source object directly
+export const schemaSource = createSchemaSource({
+    io,
+    versions: PROJECT_SCHEMA_METADATA.versions,
+    assetsPath: polenUrlPathAssets(),
+});
+// HMR cache invalidation for development
+if (import.meta.hot) {
+    import.meta.hot.on('polen:schema-invalidate', () => {
+        console.log('[HMR] Schema cache invalidated');
+        schemaSource.clearCache();
+        // Brute force approach: reload the page to ensure fresh data
+        // This guarantees all components see the updated schema immediately
+        // TODO: When we have reactive data fetching, remove this reload
+        //       and let the reactive system handle updates gracefully
+        window.location.reload();
+    });
+}
+//# sourceMappingURL=schema-source.js.map

package/build/template/sources/schema-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-source.js","sourceRoot":"","sources":["../../../src/template/sources/schema-source.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,sCAAsC,CAAA;AAC/D,OAAO,uBAAuB,MAAM,uCAAuC,CAAA;AAC3E,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAA;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExD,yCAAyC;AACzC,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG;IAC5B,CAAC,CAAC;QACA,oCAAoC;QACpC,IAAI,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE;YAC3B,iDAAiD;YACjD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;YAErD,0CAA0C;YAC1C,+DAA+D;YAC/D,MAAM,WAAW,GAAG,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAA;YACrD,MAAM,YAAY,GAAG,IAAI,MAAM,CAAC,IAAI,WAAW,QAAQ,CAAC,CAAA;YACxD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAA;YACtC,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;YAEzC,oDAAoD;YACpD,0DAA0D;YAC1D,uDAAuD;YACvD,IAAI,QAAgB,CAAA;YACpB,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;gBACxB,4CAA4C;gBAC5C,QAAQ,GAAG,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,SAAS,CAAC,QAAQ,IAAI,SAAS,EAAE,CAAA;YAC9E,CAAC;iBAAM,CAAC;gBACN,qCAAqC;gBACrC,yEAAyE;gBACzE,QAAQ;oBACN,GAAG,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,YAAY,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,IAAI,SAAS,EAAE,CAAA;YACtI,CAAC;YAED,OAAO,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAA;QACpC,CAAC;KACF;IACD,CAAC,CAAC;QACA,+BAA+B;QAC/B,IAAI,EAAE,KAAK,EAAE,IAAY,EAAE,EAAE;YAC3B,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,CAAA;YAClC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,KAAK,QAAQ,CAAC,MAAM,IAAI,QAAQ,CAAC,UAAU,GAAG,CAAC,CAAA;YACzF,CAAC;YACD,OAAO,QAAQ,CAAC,IAAI,EAAE,CAAA;QACxB,CAAC;KACF,CAAA;AAEH,+CAA+C;AAC/C,MAAM,CAAC,MAAM,YAAY,GAAG,kBAAkB,CAAC;IAC7C,EAAE;IACF,QAAQ,EAAE,uBAAuB,CAAC,QAAQ;IAC1C,UAAU,EAAE,kBAAkB,EAAE;CACjC,CAAC,CAAA;AAEF,yCAAyC;AACzC,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC;IACpB,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,yBAAyB,EAAE,GAAG,EAAE;QACjD,OAAO,CAAC,GAAG,CAAC,gCAAgC,CAAC,CAAA;QAC7C,YAAY,CAAC,UAAU,EAAE,CAAA;QAEzB,6DAA6D;QAC7D,oEAAoE;QACpE,gEAAgE;QAChE,8DAA8D;QAC9D,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAA;IAC1B,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polen",
-  "version": "0.10.0-next.9",
+  "version": "0.11.0-next.1",
   "type": "module",
   "description": "A framework for delightful GraphQL developer portals",
   "author": {
@@ -33,44 +33,47 @@
   },
   "imports": {
     "#*": {
-      "source": "./src/*.ts",
       "default": "./build/*.js"
     },
-    "#lib/mask": "./src/lib/mask/$.ts",
-    "#lib/mask/mask": "./src/lib/mask/$$.ts",
-    "#lib/task": "./src/lib/task/$.ts",
-    "#lib/task/task": "./src/lib/task/$$.ts",
-    "#lib/deployment": "./src/lib/deployment/$.ts",
-    "#lib/deployment/deployment": "./src/lib/deployment/$$.ts",
-    "#template/components/content/$$": "./src/template/components/content/$$.ts"
+    "#lib/mask": {
+      "default": "./build/lib/mask/$.js"
+    },
+    "#lib/mask/mask": {
+      "default": "./build/lib/mask/$$.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"
+    }
   },
   "exports": {
     ".": {
-      "source": "./src/exports/index.ts",
       "default": "./build/exports/index.js"
     },
-    "./components": {
-      "source": "./src/exports/components.ts",
-      "default": "./build/exports/components.js"
-    },
     "./polen": {
-      "source": "./src/exports/polen.ts",
       "default": "./build/exports/polen.js"
     },
     "./react": {
-      "source": "./src/exports/react.ts",
       "default": "./build/exports/react.js"
     },
+    "./mdx": {
+      "default": "./build/exports/mdx.js"
+    },
     "./react-dom/server": {
-      "source": "./src/exports/react-dom/server.ts",
       "default": "./build/exports/react-dom/server.js"
     },
     "./react/jsx-dev-runtime": {
-      "source": "./src/exports/react/jsx-dev-runtime.ts",
       "default": "./build/exports/react/jsx-dev-runtime.js"
     },
     "./react/jsx-runtime": {
-      "source": "./src/exports/react/jsx-runtime.ts",
       "default": "./build/exports/react/jsx-runtime.js"
     }
   },
@@ -83,39 +86,38 @@
     "@0no-co/graphql.web": "^1.1.2",
     "@graphql-inspector/core": "^6.2.1",
     "@graphql-tools/load": "^8.1.0",
-    "@hono/node-server": "^1.14.4",
+    "@hiogawa/vite-plugin-ssr-css": "^0.0.1",
+    "@hono/node-server": "^1.15.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.16",
-    "@rollup/pluginutils": "^5.1.4",
-    "@shikijs/rehype": "^3.6.0",
-    "@shikijs/transformers": "^3.6.0",
-    "@shikijs/twoslash": "^3.6.0",
-    "@swc/core": "^1.12.1",
+    "@rolldown/pluginutils": "1.0.0-beta.24",
+    "@rollup/pluginutils": "^5.2.0",
     "@types/jsesc": "^3.0.3",
-    "@vitejs/plugin-react": "^4.5.2",
+    "@vitejs/plugin-react": "^4.6.0",
     "@vitejs/plugin-react-oxc": "^0.2.3",
-    "@vltpkg/semver": "0.0.0-15",
-    "@vue/reactivity": "^3.5.16",
+    "@vltpkg/semver": "0.0.0-16",
+    "@vue/reactivity": "^3.5.17",
     "@wollybeard/kit": "^0.41.0",
-    "@wollybeard/projector": "^0.2.0",
+    "@wollybeard/projector": "^0.3.0",
     "ansis": "^4.1.0",
     "clean-stack": "^5.2.0",
+    "codehike": "^1.0.7",
     "consola": "^3.4.2",
     "defu": "^6.1.4",
-    "es-toolkit": "^1.39.3",
+    "es-toolkit": "^1.39.6",
     "fuse.js": "^7.1.0",
     "graffle": "8.0.0-next.163",
     "graphql": "^16.11.0",
     "gray-matter": "^4.0.3",
-    "hono": "^4.7.11",
+    "hono": "^4.8.4",
     "jsesc": "^3.1.0",
     "jsonc-parser": "^3.3.1",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
-    "react-router": "^7.6.2",
+    "react-router": "^7.6.3",
     "rehype-stringify": "^10.0.1",
     "remark": "^15.0.1",
     "remark-frontmatter": "^5.0.0",
@@ -124,21 +126,22 @@
     "remark-parse": "^11.0.0",
     "remark-rehype": "^11.1.2",
     "resolve.imports": "^2.0.3",
-    "rolldown": "1.0.0-beta.16",
-    "shiki": "^3.6.0",
+    "rolldown": "1.0.0-beta.24",
     "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",
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
     "unified": "^11.0.5",
     "vfile": "^6.0.3",
-    "vite": "npm:rolldown-vite@~6.3.21",
-    "vite-plugin-inspect": "^11.2.0",
+    "vite": "npm:rolldown-vite@^7.0.4",
+    "vite-plugin-inspect": "^11.3.0",
     "vite-plugin-restart": "^0.4.2",
-    "youch-core": "^0.3.2",
-    "zx": "8.5.5"
+    "web-tree-sitter": "^0.25.6",
+    "youch-core": "^0.3.3",
+    "zx": "8.6.1"
   },
   "devDependencies": {
     "@actions/core": "^1.11.1",
@@ -146,45 +149,36 @@
     "@actions/github": "^6.0.1",
     "@actions/glob": "^0.5.0",
     "@actions/io": "^1.1.3",
-    "@changesets/cli": "^2.29.4",
-    "@eslint/js": "^9.29.0",
+    "@changesets/cli": "^2.29.5",
     "@molt/command": "^0.9.0",
     "@octokit/core": "^7.0.2",
     "@octokit/types": "^14.1.0",
-    "@playwright/browser-chromium": "^1.53.0",
-    "@stylistic/eslint-plugin": "^4.4.1",
-    "@tsconfig/node-lts": "^22.0.1",
+    "@playwright/browser-chromium": "^1.53.2",
+    "@testing-library/react": "^16.3.0",
+    "@tsconfig/node-lts": "^22.0.2",
     "@tsconfig/node22": "^22.0.2",
     "@tsconfig/strictest": "^2.0.5",
-    "@types/node": "^24.0.3",
+    "@types/jsdom": "^21.1.7",
+    "@types/node": "^24.0.10",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
     "@types/semver": "^7.7.0",
-    "@typescript-eslint/eslint-plugin": "^8.34.1",
-    "@typescript-eslint/parser": "^8.34.1",
-    "dprint": "^0.50.0",
+    "dprint": "^0.50.1",
     "dripip": "^0.10.0",
-    "eslint": "^9.29.0",
-    "eslint-plugin-deprecation": "^3.0.0",
-    "eslint-plugin-only-warn": "^1.1.0",
-    "eslint-plugin-react-hooks": "^5.2.0",
-    "eslint-plugin-react-refresh": "^0.4.20",
-    "eslint-plugin-tsdoc": "^0.4.0",
-    "eslint-plugin-unused-imports": "^4.1.4",
-    "fast-check": "^4.1.1",
+    "fast-check": "^4.2.0",
     "fs-jetpack": "^5.1.0",
     "get-port-please": "^3.1.2",
-    "globals": "^16.2.0",
-    "playwright": "1.53.0",
+    "globals": "^16.3.0",
+    "jsdom": "^26.1.0",
+    "playwright": "1.53.2",
     "publint": "^0.3.12",
     "semver": "^7.7.2",
     "strip-ansi": "^7.1.0",
     "type-fest": "^4.41.0",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.34.1",
     "vite-tsconfig-paths": "^5.1.4",
-    "vitest": "^3.2.3",
-    "zod": "3.25.67"
+    "vitest": "^3.2.4",
+    "zod": "3.25.74"
   },
   "packageManager": "pnpm@10.11.1",
   "scripts": {
@@ -192,30 +186,24 @@
     "sandbox:watch": "tsx --watch src/sandbox",
     "sb": "pnpm sandbox",
     "sb:w": "pnpm sandbox:watch",
-    "polen": "node --no-warnings --experimental-transform-types --conditions source ./src/cli/index.ts",
+    "polen": "tsx ./src/cli/index.ts",
     "test:examples": "playwright test --config 'tests/playwright.config.ts' --project=examples",
     "test:integration": "playwright test --config 'tests/playwright.config.ts' --project=integration",
     "test:unit": "vitest",
     "dev": "pnpm build:watch:emit",
-    "dev:pokemon": "pnpm polen dev --project examples/pokemon",
     "dev:hive": "pnpm polen dev --project examples/hive",
-    "dev:github": "pnpm polen dev --project examples/github",
-    "dev:demo-index": "node --no-warnings --experimental-transform-types --conditions source ./src/lib/demos/ui/landing-page-cli.ts --mode dev --serve",
-    "build:demos": "zx ./scripts/build-demos.mjs",
+    "dev:pokemon": "pnpm polen dev --project examples/pokemon",
     "build:clean": "pnpm tsc --build tsconfig.build.json --clean && rm -rf build",
     "build": "tsc --build tsconfig.build.json",
     "build:watch": "tsc --build tsconfig.build.json --watch",
     "build:watch:emit": "pnpm build:watch --noCheck",
     "build:emit": "pnpm build --noCheck",
     "prebuild": "pnpm build:clean",
-    "_fix:lint": "eslint . --fix",
     "fix:format": "dprint fmt",
     "check:format": "dprint check",
-    "_check:lint": "eslint . --max-warnings 0",
     "check:types": "tsc --noEmit",
     "check:pedantic:package": "publint run --strict",
     "precheck:pedantic:package": "pnpm build",
-    "release:version": "changeset version && git commit -am \"chore: release\" && git push",
     "prepublishOnly": "pnpm build",
     "prepack": "pnpm build",
     "build:cli:chmodx": "chmod +x ./build/cli/index.js",

package/src/api/api.ts

@@ -1,4 +1,6 @@
-export * from './builder/index.ts'
-export * from './config-resolver/index.ts'
-export * from './config/index.ts'
-export * from './static/index.ts'
+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/builder/builder.ts

@@ -1,40 +1,26 @@
 import { ConfigResolver } from '#api/config-resolver/index'
+import type { ConfigInput } from '#api/config/configurator'
 import { Config } from '#api/config/index'
 import { Vite } from '#dep/vite/index'
 import { Fs } from '@wollybeard/kit'
 import consola from 'consola'
 
-const buildDefaults = {
-  debug: false,
-  architecture: Config.BuildArchitecture.enum.ssg,
+interface BuildInput {
+  dir: string
+  overrides?: Partial<ConfigInput>
 }
 
-interface BuildConfigInput {
-  debug?: boolean
-  architecture?: Config.BuildArchitecture
-  base?: string
-}
-
-export const build = async (buildConfigInput: BuildConfigInput) => {
-  const buildConfig = { ...buildDefaults, ...buildConfigInput }
-
+export const build = async (input: BuildInput) => {
   const viteUserConfig = await ConfigResolver.fromFile({
-    dir: process.cwd(),
-    overrides: {
-      build: {
-        architecture: buildConfig.architecture,
-        ...(buildConfig.base ? { base: buildConfig.base } : {}),
-      },
-      advanced: {
-        debug: buildConfig.debug,
-      },
-    },
+    dir: input.dir,
+    overrides: input.overrides,
   })
 
   const builder = await Vite.createBuilder(viteUserConfig)
   await builder.buildApp()
 
-  if (buildConfig.architecture === `ssg`) {
+  const architecture = viteUserConfig._polen.build.architecture
+  if (architecture === `ssg`) {
     consola.info(`Generating static site...`)
     await import(viteUserConfig._polen.paths.project.absolute.build.serverEntrypoint)
     // Clean up server file which should now be done being used for SSG geneation.
@@ -42,9 +28,8 @@ export const build = async (buildConfigInput: BuildConfigInput) => {
     // todo: there is also some kind of prompt js asset that we probably need to clean up or review...
     consola.success(`Done`)
     consola.info(`try it: npx serve ${viteUserConfig._polen.paths.project.relative.build.root} -p 4000`)
-  } else if (buildConfig.architecture === `ssr`) {
+  } else if (architecture === `ssr`) {
     consola.info(`try it: node ${viteUserConfig._polen.paths.project.relative.build.root}/app.js`)
-    // todo: no hardcoded port
-    consola.info(`Then visit http://localhost:3001`)
+    consola.info(`Then visit http://localhost:${viteUserConfig._polen.server.port}`)
   }
 }

package/src/api/builder/index.ts

@@ -1 +1 @@
-export * as Builder from './builder.ts'
+export * as Builder from './builder.js'

package/src/api/config/config.ts

@@ -1,4 +1,4 @@
-export * from './configurator.ts'
-export * from './define.ts'
-export * from './load.ts'
-export * from './merge.ts'
+export * from './configurator.js'
+export * from './define.js'
+export * from './load.js'
+export * from './merge.js'