polen 0.10.0-next.14 → 0.10.0-next.15

package/build/template/server/ssg/get-route-paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-route-paths.js","sourceRoot":"","sources":["../../../../src/template/server/ssg/get-route-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,6CAA6C;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,YAAY,MAAM,sCAAsC,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAkB,CAAA;AAEzC,wFAAwF;AACxF,uEAAuE;AACvE,yCAAyC;AACzC,MAAM,kCAAkC,GAAG;IACzC,cAAc,EAAE,kBAAkB;CACnC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,GAAa,EAAE;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,MAAM,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAEnE,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,IAAI,GAAG,KAAK,kCAAkC,CAAC,cAAc,EAAE,CAAC;YAC9D,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;gBACpD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;gBAClE,KAAK,CAAC,GAAG,EAAE;oBACT,SAAS,CAAC,QAAQ;wBAChB,KAAK,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;oBAChD,CAAC;iBACF,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,cAAc,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAA;QACzD,CAAC;aAAM,CAAC;YACN,cAAc;YACd,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA,CAAC,gCAAgC;AAClE,CAAC,CAAA"}
+{"version":3,"file":"get-route-paths.js","sourceRoot":"","sources":["../../../../src/template/server/ssg/get-route-paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,6CAA6C;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAA;AAC5D,OAAO,YAAY,MAAM,sCAAsC,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAA;AAExC,wFAAwF;AACxF,uEAAuE;AACvE,yCAAyC;AACzC,MAAM,kCAAkC,GAAG;IACzC,cAAc,EAAE,kBAAkB;CACnC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,GAAa,EAAE;IAC3C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAA;IAC/B,MAAM,gBAAgB,GAAG,cAAc,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAA;IAEnE,KAAK,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAC;QACnC,IAAI,GAAG,KAAK,kCAAkC,CAAC,cAAc,EAAE,CAAC;YAC9D,IAAI,YAAY,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;gBACpD,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAA;gBAClE,KAAK,CAAC,GAAG,EAAE;oBACT,SAAS,CAAC,QAAQ;wBAChB,KAAK,CAAC,GAAG,CAAC,cAAc,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAA;oBAChD,CAAC;iBACF,CAAC,CAAA;YACJ,CAAC;QACH,CAAC;aAAM,IAAI,cAAc,CAAC,mBAAmB,CAAC,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAA;QACzD,CAAC;aAAM,CAAC;YACN,cAAc;YACd,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;QAChB,CAAC;IACH,CAAC;IAED,OAAO,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAA,CAAC,gCAAgC;AAClE,CAAC,CAAA"}

package/build/template/server/transformers/inject-polen-data.d.ts

@@ -0,0 +1,6 @@
+/**
+ * HTML transformer that injects Polen global data based on request context
+ * This runs in both dev and production modes to ensure consistent behavior
+ */
+export declare const createPolenDataInjector: () => import("#lib/html-utils/html-transformer").HtmlTransformer;
+//# sourceMappingURL=inject-polen-data.d.ts.map

package/build/template/server/transformers/inject-polen-data.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-polen-data.d.ts","sourceRoot":"","sources":["../../../../src/template/server/transformers/inject-polen-data.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,kEAsBnC,CAAA"}

package/build/template/server/transformers/inject-polen-data.js

@@ -0,0 +1,28 @@
+import { createHtmlTransformer } from '#lib/html-utils/html-transformer';
+import { injectGlobalDataIntoHTML } from '#lib/html-utils/inject-global-data';
+import * as Theme from '#lib/theme/theme';
+/**
+ * HTML transformer that injects Polen global data based on request context
+ * This runs in both dev and production modes to ensure consistent behavior
+ */
+export const createPolenDataInjector = () => {
+    return createHtmlTransformer((html, ctx) => {
+        // Create theme manager to read cookies
+        const themeManager = Theme.createThemeManager({
+            cookieName: `polen-theme-preference`,
+        });
+        // Get theme from request cookies
+        const cookies = ctx.req.header(`cookie`) || ``;
+        const cookieTheme = themeManager.readCookie(cookies);
+        // Use existing Polen global data if available, otherwise create new
+        const polenData = globalThis.__POLEN__ || {
+            serverContext: {
+                theme: cookieTheme || 'system', // No cookie means system preference
+                isDev: !__BUILDING__, // true in dev, false in production
+            },
+        };
+        // Just inject the Polen data, no additional code
+        return injectGlobalDataIntoHTML(html, '__POLEN__', polenData);
+    });
+};
+//# sourceMappingURL=inject-polen-data.js.map

package/build/template/server/transformers/inject-polen-data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-polen-data.js","sourceRoot":"","sources":["../../../../src/template/server/transformers/inject-polen-data.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AACxE,OAAO,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAA;AAC7E,OAAO,KAAK,KAAK,MAAM,kBAAkB,CAAA;AAGzC;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,EAAE;IAC1C,OAAO,qBAAqB,CAAC,CAAC,IAAI,EAAE,GAAG,EAAE,EAAE;QACzC,uCAAuC;QACvC,MAAM,YAAY,GAAG,KAAK,CAAC,kBAAkB,CAAC;YAC5C,UAAU,EAAE,wBAAwB;SACrC,CAAC,CAAA;QAEF,iCAAiC;QACjC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAA;QAC9C,MAAM,WAAW,GAAG,YAAY,CAAC,UAAU,CAAC,OAAO,CAAC,CAAA;QAEpD,oEAAoE;QACpE,MAAM,SAAS,GAAoB,UAAU,CAAC,SAAS,IAAI;YACzD,aAAa,EAAE;gBACb,KAAK,EAAE,WAAW,IAAI,QAAQ,EAAE,oCAAoC;gBACpE,KAAK,EAAE,CAAC,YAAY,EAAE,mCAAmC;aAC1D;SACF,CAAA;QAED,iDAAiD;QACjD,OAAO,wBAAwB,CAAC,IAAI,EAAE,WAAW,EAAE,SAAS,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/build/template/server/transformers/inject-theme-init.d.ts

@@ -0,0 +1,6 @@
+/**
+ * HTML transformer that injects theme initialization script
+ * This must run AFTER inject-polen-data transformer since it depends on window.__POLEN__
+ */
+export declare const createThemeInitInjector: () => import("#lib/html-utils/html-transformer").HtmlTransformer;
+//# sourceMappingURL=inject-theme-init.d.ts.map

package/build/template/server/transformers/inject-theme-init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-theme-init.d.ts","sourceRoot":"","sources":["../../../../src/template/server/transformers/inject-theme-init.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,uBAAuB,kEAuBnC,CAAA"}

package/build/template/server/transformers/inject-theme-init.js

@@ -0,0 +1,29 @@
+import { createHtmlTransformer } from '#lib/html-utils/html-transformer';
+/**
+ * HTML transformer that injects theme initialization script
+ * This must run AFTER inject-polen-data transformer since it depends on window.__POLEN__
+ */
+export const createThemeInitInjector = () => {
+    return createHtmlTransformer((html, ___ctx) => {
+        // Theme initialization script that runs immediately to prevent FOUC
+        const themeInitScript = `
+<script>
+  // Apply theme immediately to prevent FOUC
+  (function() {
+    let theme = globalThis.__POLEN__.serverContext.theme;
+    
+    // If system preference, detect actual theme
+    if (theme === 'system') {
+      theme = globalThis.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+    }
+    
+    document.documentElement.setAttribute('data-theme', theme);
+    document.documentElement.className = 'radix-themes ' + theme;
+  })();
+</script>`;
+        // Inject the script right after the Polen data script
+        // This ensures __POLEN__ is available when this script runs
+        return html.replace('</head>', `${themeInitScript}\n</head>`);
+    });
+};
+//# sourceMappingURL=inject-theme-init.js.map

package/build/template/server/transformers/inject-theme-init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-theme-init.js","sourceRoot":"","sources":["../../../../src/template/server/transformers/inject-theme-init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAA;AAExE;;;GAGG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,EAAE;IAC1C,OAAO,qBAAqB,CAAC,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE;QAC5C,oEAAoE;QACpE,MAAM,eAAe,GAAG;;;;;;;;;;;;;;UAclB,CAAA;QAEN,sDAAsD;QACtD,4DAA4D;QAC5D,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,eAAe,WAAW,CAAC,CAAA;IAC/D,CAAC,CAAC,CAAA;AACJ,CAAC,CAAA"}

package/build/template/server/view.js

@@ -1,6 +1,6 @@
 import { createStaticHandler } from 'react-router';
 import PROJECT_DATA from 'virtual:polen/project/data.jsonsuper';
-import { routes } from "../routes.js";
+import { routes } from '../routes.js';
 export const view = createStaticHandler(routes, {
     basename: PROJECT_DATA.basePath === `/` ? undefined : PROJECT_DATA.basePath.slice(0, -1), // Remove trailing slash for React Router
 });

package/build/template/server/view.js.map

@@ -1 +1 @@
-{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/template/server/view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,YAAY,MAAM,sCAAsC,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAe,CAAA;AAEtC,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE;IAC9C,QAAQ,EAAE,YAAY,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,yCAAyC;CACpI,CAAC,CAAA"}
+{"version":3,"file":"view.js","sourceRoot":"","sources":["../../../src/template/server/view.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAA;AAClD,OAAO,YAAY,MAAM,sCAAsC,CAAA;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAA;AAErC,MAAM,CAAC,MAAM,IAAI,GAAG,mBAAmB,CAAC,MAAM,EAAE;IAC9C,QAAQ,EAAE,YAAY,CAAC,QAAQ,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,yCAAyC;CACpI,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "polen",
-  "version": "0.10.0-next.14",
+  "version": "0.10.0-next.15",
   "type": "module",
   "description": "A framework for delightful GraphQL developer portals",
   "author": {
@@ -33,90 +33,66 @@
   },
   "imports": {
     "#*": {
-      "source": "./src/*.ts",
       "default": "./build/*.js"
     },
     "#lib/mask": {
-      "source": "./src/lib/mask/$.ts",
       "default": "./build/lib/mask/$.js"
     },
     "#lib/mask/mask": {
-      "source": "./src/lib/mask/$$.ts",
       "default": "./build/lib/mask/$$.js"
     },
     "#lib/task": {
-      "source": "./src/lib/task/$.ts",
       "default": "./build/lib/task/$.js"
     },
     "#lib/task/task": {
-      "source": "./src/lib/task/$$.ts",
       "default": "./build/lib/task/$$.js"
     },
-    "#lib/deployment": {
-      "source": "./src/lib/deployment/$.ts",
-      "default": "./build/lib/deployment/$.js"
-    },
-    "#lib/deployment/deployment": {
-      "source": "./src/lib/deployment/$$.ts",
-      "default": "./build/lib/deployment/$$.js"
-    },
     "#lib/graphql-document": {
-      "source": "./src/lib/graphql-document/$.ts",
       "default": "./build/lib/graphql-document/$.js"
     },
     "#lib/graphql-document/graphql-document": {
-      "source": "./src/lib/graphql-document/$$.ts",
       "default": "./build/lib/graphql-document/$$.js"
     },
     "#lib/graphql-document/components/index": {
-      "source": "./src/lib/graphql-document/components/index.ts",
       "default": "./build/lib/graphql-document/components/index.js"
     },
     "#lib/graphql-document/components/GraphQLDocumentWithSchema": {
-      "source": "./src/lib/graphql-document/components/GraphQLDocumentWithSchema.tsx",
       "default": "./build/lib/graphql-document/components/GraphQLDocumentWithSchema.js"
     },
     "#lib/graphql-document/components/GraphQLDocument": {
-      "source": "./src/lib/graphql-document/components/GraphQLDocument.tsx",
       "default": "./build/lib/graphql-document/components/GraphQLDocument.js"
     },
     "#lib/graphql-document/schema-context": {
-      "source": "./src/lib/graphql-document/schema-context.tsx",
       "default": "./build/lib/graphql-document/schema-context.js"
     },
     "#template/components/content/$$": {
-      "source": "./src/template/components/content/$$.ts",
       "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",
       "import": "./build/exports/components.js",
       "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"
     },
     "./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"
     }
   },
@@ -129,39 +105,36 @@
     "@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/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",
     "ansis": "^4.1.0",
     "clean-stack": "^5.2.0",
     "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",
@@ -170,8 +143,7 @@
     "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",
@@ -180,11 +152,11 @@
     "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"
+    "youch-core": "^0.3.3",
+    "zx": "8.6.1"
   },
   "devDependencies": {
     "@actions/core": "^1.11.1",
@@ -192,48 +164,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",
+    "@playwright/browser-chromium": "^1.53.2",
     "@testing-library/react": "^16.3.0",
-    "@tsconfig/node-lts": "^22.0.1",
+    "@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.3",
+    "@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",
+    "globals": "^16.3.0",
     "jsdom": "^26.1.0",
-    "playwright": "1.53.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": {
@@ -241,26 +201,20 @@
     "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",
     "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",
@@ -269,7 +223,7 @@
     "prepack": "pnpm build",
     "build:cli:chmodx": "chmod +x ./build/cli/index.js",
     "postbuild": "pnpm run build:cli:chmodx && pnpm run build:copy-assets",
-    "build:copy-assets": "cp -r src/template/styles build/template/",
+    "build:copy-assets": "mkdir -p build/template && cp -r src/template/styles build/template/",
     "test": "vitest",
     "check": "pnpm run '/^check:(?!pedantic:).+/'",
     "checkAll": "pnpm run '/^check:.+/'",

package/src/api/api.ts

@@ -1,4 +1,4 @@
-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 * from './static/index.js'

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'

package/src/api/config/configurator.ts

@@ -3,8 +3,8 @@ import { assertPathAbsolute } from '#lib/kit-temp'
 import { type PackagePaths, packagePaths } from '#package-paths'
 import { Path } from '@wollybeard/kit'
 import { z } from 'zod'
-import type { SchemaAugmentation } from '../../api/schema-augmentation/index.ts'
-import type { Schema } from '../schema/index.ts'
+import type { SchemaAugmentation } from '../../api/schema-augmentation/index.js'
+import type { Schema } from '../schema/index.js'
 
 export const BuildArchitectureEnum = {
   ssg: `ssg`,
@@ -18,6 +18,11 @@ export type BuildArchitecture = typeof BuildArchitectureEnum[keyof typeof BuildA
 
 type SchemaConfigInput = Omit<Schema.Config, `projectRoot`>
 
+/**
+ * Polen configuration input.
+ *
+ * All options are optional. Polen provides sensible defaults for a great developer experience out of the box.
+ */
 export interface ConfigInput {
   /**
    * Path to the root directory of your project.
@@ -28,13 +33,52 @@ export interface ConfigInput {
    */
   root?: string
   /**
-   * Enable a special module explorer for the source code that Polen assembles for your app.
+   * Configuration for how Polen loads your GraphQL schema.
    *
-   * Powered by [Vite Inspect](https://github.com/antfu-collective/vite-plugin-inspect).
+   * Polen supports multiple schema sources:
+   * - `file` - Load from a single SDL file (default: schema.graphql)
+   * - `directory` - Load multiple SDL files with date prefixes (enables changelog)
+   * - `memory` - Define schemas programmatically in configuration
    *
-   * @default true
+   * @example
+   * ```ts
+   * // Single file
+   * schema: {
+   *   useDataSources: 'file',
+   *   dataSources: {
+   *     file: { path: './my-schema.graphql' }
+   *   }
+   * }
+   *
+   * // Multiple versions for changelog
+   * schema: {
+   *   useDataSources: 'directory',
+   *   dataSources: {
+   *     directory: { path: './schema' }
+   *   }
+   * }
+   * ```
    */
   schema?: SchemaConfigInput
+  /**
+   * Programmatically add descriptions and metadata to your GraphQL schema.
+   *
+   * Use this to enhance your schema documentation without modifying the SDL files.
+   *
+   * @example
+   * ```ts
+   * schemaAugmentations: [{
+   *   Query: {
+   *     description: 'The root query type',
+   *     fields: {
+   *       users: {
+   *         description: 'Get a list of all users'
+   *       }
+   *     }
+   *   }
+   * }]
+   * ```
+   */
   schemaAugmentations?: SchemaAugmentation.Augmentation[]
   templateVariables?: {
     /**
@@ -46,17 +90,36 @@ export interface ConfigInput {
      */
     title?: string
   }
+  /**
+   * Build configuration for your developer portal.
+   */
   build?: {
+    /**
+     * The build architecture for your developer portal.
+     *
+     * - `ssg` - Static Site Generation: Pre-renders all pages at build time. Best for public docs.
+     * - `ssr` - Server-Side Rendering: Renders pages on each request. Enables dynamic features.
+     * - `spa` - Single Page Application: Client-side rendering only.
+     *
+     * @default 'ssg'
+     */
     architecture?: BuildArchitecture
     /**
      * Base public path for the deployed site.
      *
      * Use this when deploying to a subdirectory (e.g., GitHub Pages project sites).
      *
-     * Examples:
-     * - `/` (default) - Deploy to root
-     * - `/my-project/` - Deploy to subdirectory
-     * - `/pr-123/` - PR preview deployments
+     * @example
+     * ```ts
+     * // Deploy to root
+     * base: '/'
+     *
+     * // Deploy to subdirectory
+     * base: '/my-project/'
+     *
+     * // PR preview deployments
+     * base: '/pr-123/'
+     * ```
      *
      * Must start and end with `/`.
      *
@@ -64,7 +127,24 @@ export interface ConfigInput {
      */
     base?: string
   }
+  /**
+   * Advanced configuration options.
+   *
+   * These settings are for advanced use cases and debugging.
+   */
   advanced?: {
+    /**
+     * Enable a special module explorer for the source code that Polen assembles for your app.
+     *
+     * This opens an interactive UI to inspect the module graph and transformations.
+     * Useful for debugging build issues or understanding Polen's internals.
+     *
+     * Access the explorer at `/__inspect/` when running the dev server.
+     *
+     * Powered by [Vite Inspect](https://github.com/antfu-collective/vite-plugin-inspect).
+     *
+     * @default false
+     */
     explorer?: boolean
     /**
      * Force the CLI to resolve Polen imports in your project to itself rather than
@@ -144,20 +224,20 @@ const buildPaths = (rootDir: string): Config[`paths`] => {
         },
         pages: `pages`,
         public: {
-          root: 'public',
-          logo: 'logo.svg',
+          root: `public`,
+          logo: `logo.svg`,
         },
       },
       absolute: {
         pages: rootAbsolute(`pages`),
         build: {
-          root: buildAbsolute('.'),
+          root: buildAbsolute(`.`),
           serverEntrypoint: buildAbsolute(`app.js`),
           assets: buildAbsolute(`assets`),
         },
         public: {
-          root: publicAbsolute('.'),
-          logo: publicAbsolute('logo.svg'),
+          root: publicAbsolute(`.`),
+          logo: publicAbsolute(`logo.svg`),
         },
       },
     },
@@ -256,7 +336,6 @@ export const normalizeInput = async (
    * If this is omitted, then relative root paths will throw an error.
    */
   baseRootDirPath: string,
-  // eslint-disable-next-line
 ): Promise<Config> => {
   assertPathAbsolute(baseRootDirPath)
 

package/src/api/config/define.ts

@@ -1,5 +1,5 @@
 import { Fn } from '@wollybeard/kit'
-import type { ConfigInput } from './configurator.ts'
+import type { ConfigInput } from './configurator.js'
 
 /**
  * Define a Polen configuration.

package/src/api/config/index.ts

@@ -1 +1 @@
-export * as Config from './config.ts'
+export * as Config from './config.js'

package/src/api/config/load.ts

@@ -5,7 +5,7 @@ import { debugPolen } from '#singletons/debug'
 import type { Prom } from '@wollybeard/kit'
 import { Path } from '@wollybeard/kit'
 import * as Module from 'node:module'
-import type { ConfigInput } from './configurator.ts'
+import type { ConfigInput } from './configurator.js'
 
 export const fileNameBases = [`polen.config`, `.polen.config`]
 export const fileNameExtensionsTypeScript = [`.ts`, `.js`, `.mjs`, `.mts`]
@@ -55,16 +55,13 @@ export const load = async (options: LoadOptions): Promise<ConfigInput> => {
     configInput = {}
   } else {
     // If the user's config is a TypeScript file, we will use TSX to import it.
-    // TODO: Use NodeJS's native ESM support for TypeScript files.
 
     let module: { default?: Prom.Maybe<ConfigInput>; config?: Prom.Maybe<ConfigInput> }
     if (fileNameExtensionsTypeScript.some(_ => filePath.endsWith(_))) {
       // @see https://tsx.is/dev-api/ts-import#usage
       const { tsImport } = await import(`tsx/esm/api`)
-      // eslint-disable-next-line
       module = await tsImport(filePath, import.meta.url)
     } else {
-      // eslint-disable-next-line
       module = await import(filePath)
     }
     debug(`imported config module`)

package/src/api/config/merge.ts

@@ -1,5 +1,5 @@
 import { Vite } from '#dep/vite/index'
-import type { ConfigInput } from './configurator.ts'
+import type { ConfigInput } from './configurator.js'
 
 /**
  * Deep merge two Polen config inputs.
@@ -7,7 +7,6 @@ import type { ConfigInput } from './configurator.ts'
  */
 export const mergeInputs = (
   base: ConfigInput,
-  // eslint-disable-next-line
   overrides?: ConfigInput | undefined,
 ): ConfigInput => {
   if (!overrides) {

package/src/api/config-resolver/config-resolver.ts

@@ -1,2 +1,2 @@
-export * from './resolve.ts'
-export * from './vite.ts'
+export * from './resolve.js'
+export * from './vite.js'