polen 0.10.0-next.9 → 0.10.0

package/README.md

@@ -1,89 +1,14 @@
-# 🌺 Polen
+<div align="center">
+  <a href="https://polen.js.org/">
+    <img src="https://raw.githubusercontent.com/the-guild-org/polen/main/website/public/logo.svg" alt="Polen Logo" width="200" />
+  </a>
 
-A framework for delightful GraphQL developer portals
+# Polen
 
-## What is Polen?
+**A framework for delightful GraphQL developer portals**
 
-Polen transforms your GraphQL schema into a beautiful, interactive developer portal with zero configuration. It automatically generates:
+[Website](https://polen.js.org/) · [Demos](https://polen.js.org/overview/demos) · [Get Started](https://polen.js.org/overview/getting-started)
 
-- 📖 **Schema Reference** - Interactive documentation for all types, fields, and operations
-- 📝 **Changelog** - Track schema evolution over time
-- 📄 **Custom Pages** - Add guides, tutorials, and API documentation with Markdown/MDX
-- 🎨 **Beautiful UI** - Modern, responsive design out of the box
-- 🚀 **Instant Deploy** - Static site generation for easy hosting anywhere
+</div>
 
-## Quick Start
-
-```sh
-# Install Polen
-npm add polen
-
-# Create a GraphQL schema file
-echo "type Query { hello: String }" > schema.graphql
-
-# Build your developer portal
-npx polen build
-
-# Preview locally
-node build/app.js
-```
-
-Visit http://localhost:3001 to see your developer portal!
-
-## Live Demos
-
-Experience Polen in action with our live documentation sites:
-
-### 🌐 [View All Demos](https://the-guild-org.github.io/polen/)
-
-Featured examples:
-
-- **[Pokemon GraphQL API](https://the-guild-org.github.io/polen/latest/pokemon/)** - Explore a fun GraphQL API with rich schema documentation
-- **GitHub GraphQL API** (Coming soon) - Browse GitHub's extensive GraphQL API documentation
-
-## Documentation
-
-- **[Getting Started](./docs/getting-started.md)** - Installation and quick start guide
-- **[Schema Configuration](./docs/guide/schema.md)** - Configure your GraphQL schema
-- **[Custom Pages](./docs/guide/pages.md)** - Add documentation with Markdown and MDX
-- **[Build & Deploy](./docs/guide/build.md)** - Build configuration and deployment options
-- **[CLI Reference](./docs/cli/index.md)** - All available commands
-- **[Package API](./docs/api/package.md)** - Programmatic usage
-
-### Features
-
-- **[Static Rebase](./docs/features/static-rebase.md)** - Update base paths without rebuilding
-- **[Syntax Highlighting](./docs/features/syntax-highlighting.md)** - Beautiful code blocks with language support
-
-## Examples
-
-Find complete example projects in the [examples](./examples) directory:
-
-- `pokemon` - Fun Pokemon API documentation
-- `github` - GitHub GraphQL API (coming soon)
-- `minimal` - Minimal setup example
-
-## Why Polen?
-
-- **Zero Configuration** - Works out of the box with just a GraphQL schema
-- **Developer Focused** - Built specifically for GraphQL API documentation
-- **Modern Stack** - React, TypeScript, and Vite for fast builds
-- **Flexible** - Customize everything from branding to page structure
-- **Static or Server** - Deploy as static files or run as a Node.js server
-
-## Contributing
-
-We welcome contributions! See [DEVELOPMENT.md](./DEVELOPMENT.md) for:
-
-- Development setup
-- Architecture overview
-- Testing guidelines
-- Contribution process
-
-## Changelog
-
-See [releases](https://github.com/the-guild-org/polen/releases) for a detailed changelog.
-
-## License
-
-MIT © [The Guild](https://the-guild.dev)
+---

package/build/api/api.d.ts

@@ -1,5 +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 './static/index.js';
 //# sourceMappingURL=api.d.ts.map

package/build/api/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api/api.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../src/api/api.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,cAAc,mBAAmB,CAAA"}

package/build/api/api.js

@@ -1,5 +1,6 @@
-export * from "./builder/index.js";
-export * from "./config-resolver/index.js";
-export * from "./config/index.js";
-export * from "./static/index.js";
+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 './static/index.js';
 //# sourceMappingURL=api.js.map

package/build/api/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api/api.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../src/api/api.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,mBAAmB,CAAA;AACjC,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAA;AAC7C,cAAc,mBAAmB,CAAA"}

package/build/api/builder/builder.d.ts

@@ -1,9 +1,8 @@
-import { Config } from '#api/config/index';
-interface BuildConfigInput {
-    debug?: boolean;
-    architecture?: Config.BuildArchitecture;
-    base?: string;
+import type { ConfigInput } from '#api/config/configurator';
+interface BuildInput {
+    dir: string;
+    overrides?: Partial<ConfigInput>;
 }
-export declare const build: (buildConfigInput: BuildConfigInput) => Promise<void>;
+export declare const build: (input: BuildInput) => Promise<void>;
 export {};
 //# sourceMappingURL=builder.d.ts.map

package/build/api/builder/builder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/api/builder/builder.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAU1C,UAAU,gBAAgB;IACxB,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,iBAAiB,CAAA;IACvC,IAAI,CAAC,EAAE,MAAM,CAAA;CACd;AAED,eAAO,MAAM,KAAK,GAAU,kBAAkB,gBAAgB,kBAgC7D,CAAA"}
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../../../src/api/builder/builder.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAA;AAM3D,UAAU,UAAU;IAClB,GAAG,EAAE,MAAM,CAAA;IACX,SAAS,CAAC,EAAE,OAAO,CAAC,WAAW,CAAC,CAAA;CACjC;AAED,eAAO,MAAM,KAAK,GAAU,OAAO,UAAU,kBAsB5C,CAAA"}

package/build/api/builder/builder.js

@@ -1,49 +1,28 @@
-var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExtension) || function (path, preserveJsx) {
-    if (typeof path === "string" && /^\.\.?\//.test(path)) {
-        return path.replace(/\.(tsx)$|((?:\.d)?)((?:\.[^./]+?)?)\.([cm]?)ts$/i, function (m, tsx, d, ext, cm) {
-            return tsx ? preserveJsx ? ".jsx" : ".js" : d && (!ext || !cm) ? m : (d + ext + "." + cm.toLowerCase() + "js");
-        });
-    }
-    return path;
-};
 import { ConfigResolver } from '#api/config-resolver/index';
 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,
-};
-export const build = async (buildConfigInput) => {
-    const buildConfig = { ...buildDefaults, ...buildConfigInput };
+export const build = async (input) => {
     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(__rewriteRelativeImportExtension(viteUserConfig._polen.paths.project.absolute.build.serverEntrypoint, true));
+        await import(viteUserConfig._polen.paths.project.absolute.build.serverEntrypoint);
         // Clean up server file which should now be done being used for SSG geneation.
         await Fs.remove(viteUserConfig._polen.paths.project.absolute.build.serverEntrypoint);
         // 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}`);
     }
 };
 //# sourceMappingURL=builder.js.map

package/build/api/builder/builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/api/builder/builder.ts"],"names":[],"mappings":";;;;;;;;AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACpC,OAAO,OAAO,MAAM,SAAS,CAAA;AAE7B,MAAM,aAAa,GAAG;IACpB,KAAK,EAAE,KAAK;IACZ,YAAY,EAAE,MAAM,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG;CAChD,CAAA;AAQD,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EAAE,gBAAkC,EAAE,EAAE;IAChE,MAAM,WAAW,GAAG,EAAE,GAAG,aAAa,EAAE,GAAG,gBAAgB,EAAE,CAAA;IAE7D,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC;QACnD,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE;QAClB,SAAS,EAAE;YACT,KAAK,EAAE;gBACL,YAAY,EAAE,WAAW,CAAC,YAAY;gBACtC,GAAG,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACxD;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE,WAAW,CAAC,KAAK;aACzB;SACF;KACF,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;IACxD,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;IAExB,IAAI,WAAW,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;QACvC,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACzC,MAAM,MAAM,kCAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,QAAC,CAAA;QACjF,8EAA8E;QAC9E,MAAM,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;QACpF,kGAAkG;QAClG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,CAAC,IAAI,CAAC,qBAAqB,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,CAAA;IACtG,CAAC;SAAM,IAAI,WAAW,CAAC,YAAY,KAAK,KAAK,EAAE,CAAC;QAC9C,OAAO,CAAC,IAAI,CAAC,gBAAgB,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,CAAA;QAC9F,0BAA0B;QAC1B,OAAO,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAA;IAClD,CAAC;AACH,CAAC,CAAA"}
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../src/api/builder/builder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAE3D,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,EAAE,EAAE,EAAE,MAAM,iBAAiB,CAAA;AACpC,OAAO,OAAO,MAAM,SAAS,CAAA;AAO7B,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EAAE,KAAiB,EAAE,EAAE;IAC/C,MAAM,cAAc,GAAG,MAAM,cAAc,CAAC,QAAQ,CAAC;QACnD,GAAG,EAAE,KAAK,CAAC,GAAG;QACd,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAA;IAEF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,cAAc,CAAC,CAAA;IACxD,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAA;IAExB,MAAM,YAAY,GAAG,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAA;IAC7D,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;QAC3B,OAAO,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAA;QACzC,MAAM,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;QACjF,8EAA8E;QAC9E,MAAM,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAA;QACpF,kGAAkG;QAClG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACvB,OAAO,CAAC,IAAI,CAAC,qBAAqB,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,UAAU,CAAC,CAAA;IACtG,CAAC;SAAM,IAAI,YAAY,KAAK,KAAK,EAAE,CAAC;QAClC,OAAO,CAAC,IAAI,CAAC,gBAAgB,cAAc,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,CAAA;QAC9F,OAAO,CAAC,IAAI,CAAC,+BAA+B,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAA;IAClF,CAAC;AACH,CAAC,CAAA"}

package/build/api/builder/index.d.ts

@@ -1,2 +1,2 @@
-export * as Builder from './builder.ts';
+export * as Builder from './builder.js';
 //# sourceMappingURL=index.d.ts.map

package/build/api/builder/index.js

@@ -1,2 +1,2 @@
-export * as Builder from "./builder.js";
+export * as Builder from './builder.js';
 //# sourceMappingURL=index.js.map

package/build/api/config/config.d.ts

@@ -1,5 +1,5 @@
-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';
 //# sourceMappingURL=config.d.ts.map

package/build/api/config/config.js

@@ -1,5 +1,5 @@
-export * from "./configurator.js";
-export * from "./define.js";
-export * from "./load.js";
-export * from "./merge.js";
+export * from './configurator.js';
+export * from './define.js';
+export * from './load.js';
+export * from './merge.js';
 //# sourceMappingURL=config.js.map

package/build/api/config/configurator.d.ts

@@ -1,8 +1,8 @@
 import type { Vite } from '#dep/vite/index';
 import { type PackagePaths } from '#package-paths';
 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 declare const BuildArchitectureEnum: {
     readonly ssg: "ssg";
     readonly spa: "spa";
@@ -15,23 +15,71 @@ export declare const BuildArchitecture: z.ZodNativeEnum<{
 }>;
 export type BuildArchitecture = typeof BuildArchitectureEnum[keyof typeof BuildArchitectureEnum];
 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.
+     * Configuration for how Polen loads your GraphQL schema.
+     *
+     * 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
      *
-     * Relative paths will be resolved relative to this config file.
+     * @example
+     * ```ts
+     * // Single file
+     * schema: {
+     *   useDataSources: 'file',
+     *   dataSources: {
+     *     file: { path: './my-schema.graphql' }
+     *   }
+     * }
      *
-     * @default The directory where the config file is located.
+     * // Multiple versions for changelog
+     * schema: {
+     *   useDataSources: 'directory',
+     *   dataSources: {
+     *     directory: { path: './schema' }
+     *   }
+     * }
+     * ```
      */
-    root?: string;
+    schema?: SchemaConfigInput;
     /**
-     * Enable a special module explorer for the source code that Polen assembles for your app.
+     * Programmatically enhance your GraphQL schema documentation without modifying the schema files.
      *
-     * Powered by [Vite Inspect](https://github.com/antfu-collective/vite-plugin-inspect).
+     * Perfect for adding implementation details, usage examples, deprecation notices,
+     * or any additional context that helps developers understand your API better.
      *
-     * @default true
+     * @example
+     * ```ts
+     * schemaAugmentations: [
+     *   {
+     *     type: 'description',
+     *     on: {
+     *       type: 'TargetType',
+     *       name: 'User'
+     *     },
+     *     placement: 'after',
+     *     content: '\n\nSee the [User Guide](/guides/users) for detailed usage.'
+     *   },
+     *   {
+     *     type: 'description',
+     *     on: {
+     *       type: 'TargetField',
+     *       targetType: 'Query',
+     *       name: 'users'
+     *     },
+     *     placement: 'after',
+     *     content: '\n\n**Rate limit:** 100 requests per minute'
+     *   }
+     * ]
+     * ```
      */
-    schema?: SchemaConfigInput;
     schemaAugmentations?: SchemaAugmentation.Augmentation[];
     templateVariables?: {
         /**
@@ -39,21 +87,52 @@ export interface ConfigInput {
          *
          * Used in the navigation bar and in the title tag.
          *
-         * @default `My Developer Portal`
+         * If not provided, Polen will try to use your project's package.json name
+         * field, converting it to title case (e.g., "my-project" → "My Project").
+         *
+         * @default Your package.json name (title-cased) or "My Developer Portal"
+         * @example
+         * ```ts
+         * // Explicit title
+         * title: 'Acme GraphQL API'
+         *
+         * // Falls back to package.json name
+         * // If package.json has { "name": "acme-graphql" }
+         * // Title will be "Acme Graphql"
+         * ```
          */
         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 `/`.
          *
@@ -61,7 +140,86 @@ export interface ConfigInput {
          */
         base?: string;
     };
+    /**
+     * Server configuration for development and production.
+     */
+    server?: {
+        /**
+         * Port for the server to listen on.
+         *
+         * - In development: The port for the Vite dev server
+         * - In production SSR: The default port for the Node.js server
+         *
+         * For production SSR builds, this can be overridden at runtime
+         * using the PORT environment variable.
+         *
+         * @default 3000
+         * @example
+         * ```ts
+         * // Use a specific port
+         * server: {
+         *   port: 4000
+         * }
+         *
+         * // Or via CLI flags:
+         * // polen dev --port 4000
+         * // polen build --port 4000
+         * ```
+         */
+        port?: number;
+    };
+    /**
+     * Configuration for developer experience warnings.
+     *
+     * Polen can show helpful warnings for common issues or misconfigurations.
+     * Each warning type can be individually enabled or disabled.
+     *
+     * @example
+     * ```ts
+     * warnings: {
+     *   interactiveWithoutSchema: {
+     *     enabled: false // Disable warning when interactive code blocks are used without a schema
+     *   }
+     * }
+     * ```
+     */
+    warnings?: {
+        /**
+         * Warning shown when GraphQL code blocks have the `interactive` flag
+         * but no schema is configured.
+         *
+         * Interactive features require a schema to provide field validation,
+         * type information, and auto-completion.
+         *
+         * @default { enabled: true }
+         */
+        interactiveWithoutSchema?: {
+            /**
+             * Whether to show this warning.
+             *
+             * @default true
+             */
+            enabled?: boolean;
+        };
+    };
+    /**
+     * 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
@@ -123,6 +281,9 @@ export interface Config {
         architecture: BuildArchitecture;
         base: string;
     };
+    server: {
+        port: number;
+    };
     watch: {
         also: string[];
     };
@@ -132,6 +293,11 @@ export interface Config {
     ssr: {
         enabled: boolean;
     };
+    warnings: {
+        interactiveWithoutSchema: {
+            enabled: boolean;
+        };
+    };
     paths: {
         project: {
             rootDir: string;

package/build/api/config/configurator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"configurator.d.ts","sourceRoot":"","sources":["../../../src/api/config/configurator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configurator.d.ts","sourceRoot":"","sources":["../../../src/api/config/configurator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAE3C,OAAO,EAAE,KAAK,YAAY,EAAgB,MAAM,gBAAgB,CAAA;AAEhE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAA;AAChF,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAA;AAEhD,eAAO,MAAM,qBAAqB;;;;CAIxB,CAAA;AAEV,eAAO,MAAM,iBAAiB;;;;EAAsC,CAAA;AAEpE,MAAM,MAAM,iBAAiB,GAAG,OAAO,qBAAqB,CAAC,MAAM,OAAO,qBAAqB,CAAC,CAAA;AAEhG,KAAK,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;AAE3D;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,MAAM,CAAC,EAAE,iBAAiB,CAAA;IAC1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA8BG;IACH,mBAAmB,CAAC,EAAE,kBAAkB,CAAC,YAAY,EAAE,CAAA;IACvD,iBAAiB,CAAC,EAAE;QAClB;;;;;;;;;;;;;;;;;;WAkBG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;KACf,CAAA;IACD;;OAEG;IACH,KAAK,CAAC,EAAE;QACN;;;;;;;;WAQG;QACH,YAAY,CAAC,EAAE,iBAAiB,CAAA;QAChC;;;;;;;;;;;;;;;;;;;;WAoBG;QACH,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD;;OAEG;IACH,MAAM,CAAC,EAAE;QACP;;;;;;;;;;;;;;;;;;;;;WAqBG;QACH,IAAI,CAAC,EAAE,MAAM,CAAA;KACd,CAAA;IACD;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,EAAE;QACT;;;;;;;;WAQG;QACH,wBAAwB,CAAC,EAAE;YACzB;;;;eAIG;YACH,OAAO,CAAC,EAAE,OAAO,CAAA;SAClB,CAAA;KACF,CAAA;IACD;;;;OAIG;IACH,QAAQ,CAAC,EAAE;QACT;;;;;;;;;;;WAWG;QACH,QAAQ,CAAC,EAAE,OAAO,CAAA;QAClB;;;;;;;;;;;;;;WAcG;QACH,mBAAmB,CAAC,EAAE,OAAO,CAAA;QAC7B;;WAEG;QACH,KAAK,CAAC,EAAE;YACN;;;;;;eAMG;YACH;;eAEG;YACH,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;SAChB,CAAA;QACD;;;;;;;;WAQG;QACH,KAAK,CAAC,EAAE,OAAO,CAAA;QACf;;;;;WAKG;QACH,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,CAAA;KACvB,CAAA;CACF;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAA;CACd;AA6CD,MAAM,WAAW,MAAM;IACrB,MAAM,EAAE,WAAW,CAAA;IACnB,KAAK,EAAE;QACL,YAAY,EAAE,iBAAiB,CAAA;QAC/B,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAA;KACb,CAAA;IACD,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,EAAE,CAAA;KACf,CAAA;IACD,iBAAiB,EAAE,iBAAiB,CAAA;IACpC,mBAAmB,EAAE,kBAAkB,CAAC,YAAY,EAAE,CAAA;IACtD,MAAM,EAAE,IAAI,GAAG,iBAAiB,CAAA;IAChC,GAAG,EAAE;QACH,OAAO,EAAE,OAAO,CAAA;KACjB,CAAA;IACD,QAAQ,EAAE;QACR,wBAAwB,EAAE;YACxB,OAAO,EAAE,OAAO,CAAA;SACjB,CAAA;KACF,CAAA;IACD,KAAK,EAAE;QACL,OAAO,EAAE;YACP,OAAO,EAAE,MAAM,CAAA;YACf,QAAQ,EAAE;gBACR,KAAK,EAAE;oBACL,IAAI,EAAE,MAAM,CAAA;oBACZ,QAAQ,EAAE;wBACR,MAAM,EAAE,MAAM,CAAA;wBACd,gBAAgB,EAAE,MAAM,CAAA;qBACzB,CAAA;iBACF,CAAA;gBACD,KAAK,EAAE,MAAM,CAAA;gBACb,MAAM,EAAE;oBACN,IAAI,EAAE,MAAM,CAAA;oBACZ,IAAI,EAAE,MAAM,CAAA;iBACb,CAAA;aACF,CAAA;YACD,QAAQ,EAAE;gBACR,KAAK,EAAE;oBACL,IAAI,EAAE,MAAM,CAAA;oBACZ,MAAM,EAAE,MAAM,CAAA;oBACd,gBAAgB,EAAE,MAAM,CAAA;iBACzB,CAAA;gBACD,KAAK,EAAE,MAAM,CAAA;gBACb,MAAM,EAAE;oBACN,IAAI,EAAE,MAAM,CAAA;oBACZ,IAAI,EAAE,MAAM,CAAA;iBACb,CAAA;aACF,CAAA;SACF,CAAA;QACD,SAAS,EAAE,YAAY,CAAA;KACxB,CAAA;IACD,QAAQ,EAAE;QACR,mBAAmB,EAAE,OAAO,CAAA;QAC5B,QAAQ,EAAE,OAAO,CAAA;QACjB,KAAK,EAAE,OAAO,CAAA;QACd,IAAI,CAAC,EAAE,IAAI,CAAC,UAAU,CAAA;KACvB,CAAA;CACF;AAmCD,eAAO,MAAM,cAAc,GACzB,aAAa,WAAW,GAAG,SAAS;AACpC;;;;;;;GAOG;AACH,iBAAiB,MAAM,KACtB,OAAO,CAAC,MAAM,CAmFhB,CAAA"}

package/build/api/config/configurator.js

@@ -1,6 +1,6 @@
 import { assertPathAbsolute } from '#lib/kit-temp';
 import { packagePaths } from '#package-paths';
-import { Path } from '@wollybeard/kit';
+import { Err, Manifest, Path, Str } from '@wollybeard/kit';
 import { z } from 'zod';
 export const BuildArchitectureEnum = {
     ssg: `ssg`,
@@ -29,20 +29,20 @@ const buildPaths = (rootDir) => {
                 },
                 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`),
                 },
             },
         },
@@ -62,10 +62,18 @@ const configInputDefaults = {
         architecture: BuildArchitecture.enum.ssg,
         base: `/`,
     },
+    server: {
+        port: 3000,
+    },
     schema: null,
     ssr: {
         enabled: true,
     },
+    warnings: {
+        interactiveWithoutSchema: {
+            enabled: true,
+        },
+    },
     paths: buildPaths(process.cwd()),
     advanced: {
         isSelfContainedMode: false,
@@ -105,15 +113,17 @@ baseRootDirPath) => {
     if (configInput?.advanced?.debug !== undefined) {
         config.advanced.debug = configInput.advanced.debug;
     }
-    if (configInput?.root !== undefined) {
-        if (!baseRootDirPath && !Path.isAbsolute(configInput.root)) {
-            throw new Error(`Root path must be absolute or baseRootPath must be provided to resolve relative root paths. Provided: ${configInput.root}`);
+    // Always use the baseRootDirPath as the project root
+    // This is either the --project directory or the config file directory
+    config.paths = buildPaths(baseRootDirPath);
+    // Try to read package.json name as fallback for title
+    if (!configInput?.templateVariables?.title) {
+        const packageJson = await Manifest.resource.read(config.paths.project.rootDir);
+        // todo: let the user know there was an error...
+        if (!Err.is(packageJson) && packageJson.name) {
+            // Package name will be used as default, but can still be overridden below
+            config.templateVariables.title = Str.Case.title(packageJson.name);
         }
-        const root = Path.ensureAbsolute(configInput.root, baseRootDirPath);
-        config.paths = buildPaths(root);
-    }
-    else if (baseRootDirPath) {
-        config.paths = buildPaths(baseRootDirPath);
     }
     if (configInput?.advanced?.vite) {
         config.advanced.vite = configInput.advanced.vite;
@@ -137,6 +147,13 @@ baseRootDirPath) => {
     if (configInput?.advanced?.watch?.also) {
         config.watch.also = configInput.advanced.watch.also;
     }
+    if (configInput?.server?.port !== undefined) {
+        config.server.port = configInput.server.port;
+    }
+    // Process warnings configuration
+    if (configInput?.warnings?.interactiveWithoutSchema?.enabled !== undefined) {
+        config.warnings.interactiveWithoutSchema.enabled = configInput.warnings.interactiveWithoutSchema.enabled;
+    }
     return config;
 };
 //# sourceMappingURL=configurator.js.map

package/build/api/config/configurator.js.map

@@ -1 +1 @@
-{"version":3,"file":"configurator.js","sourceRoot":"","sources":["../../../src/api/config/configurator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"configurator.js","sourceRoot":"","sources":["../../../src/api/config/configurator.ts"],"names":[],"mappings":"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"}

package/build/api/config/define.d.ts

@@ -1,4 +1,4 @@
-import type { ConfigInput } from './configurator.ts';
+import type { ConfigInput } from './configurator.js';
 /**
  * Define a Polen configuration.
  * This is an identity function that provides type safety for config files.