polen 0.10.0-next.3 → 0.10.0-next.5

package/README.md

@@ -2,34 +2,33 @@
 
 A framework for delightful GraphQL developer portals
 
-## Installation
+## What is Polen?
 
-```sh
-npm add polen
-```
+Polen transforms your GraphQL schema into a beautiful, interactive developer portal with zero configuration. It automatically generates:
 
-## Quickstart
+- 📖 **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
 
-1. Have a `schema.graphql` GraphQL schema file in your project directory.
+## Quick Start
 
-   ```graphql
-   type Query {
-     hello: String
-   }
-   ```
+```sh
+# Install Polen
+npm add polen
 
-2. Build your developer portal.
+# Create a GraphQL schema file
+echo "type Query { hello: String }" > schema.graphql
 
-   ```sh
-   npx polen build
-   ```
+# Build your developer portal
+npx polen build
 
-3. You now have a deployable developer portal. Try it locally
-   (http://localhost:3001):
+# Preview locally
+node build/app.js
+```
 
-   ```sh
-   node build/app.js
-   ```
+Visit http://localhost:3001 to see your developer portal!
 
 ## Live Demos
 
@@ -42,374 +41,49 @@ 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
 
-### Demo Versions
-
-Our demos are available at different stability levels, matching npm's dist tags:
-
-- **Stable Release** (`latest`): [/polen/latest/pokemon](https://the-guild-org.github.io/polen/latest/pokemon/)
-  - The most recent stable version (e.g., `1.0.0`)
-  - Same as `npm install polen`
+## Documentation
 
-- **Pre-release** (`next`): [/polen/next/pokemon](https://the-guild-org.github.io/polen/next/pokemon/)
-  - The latest pre-release version (e.g., `1.1.0-beta.1`)
-  - Same as `npm install polen@next`
+- **[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
 
-- **Tagged Versions**: Access any specific release
-  - e.g., [/polen/1.0.0/pokemon](https://the-guild-org.github.io/polen/1.0.0/pokemon/)
-  - Same as `npm install polen@1.0.0`
+### Features
 
-> [!TIP]
-> The correspondence between demo URLs and npm versions makes it easy to test features before upgrading. If you're using `polen@1.0.0`, visit `/polen/1.0.0/pokemon` to see exactly how your docs will look!
+- **[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 the source code for these demos and more in the [examples](./examples) directory.
-
-## Guide
-
-### Schema Reference
-
-If you [provide Polen with a schema](#providing-a-schema), Polen will
-automatically render reference documentation for it.
-
-If you provide multiple versions of your schema then the reference is based on
-the schema with the latest date.
-
-### Schema Changelog
-
-Polen can render a changelog for your schema.
-
-This feature is automatically enabled when you provide multiple versions of your
-schema. Refer to [Provide a Schema](#providing-a-schema) for details on how to
-do that.
-
-### Schema Augmentations
-
-#### Descriptions
-
-You can append/prepend/replace descriptions of types and fields in your schema.
-
-Any Markdown syntax in your content will be automatically rendered.
-
-```ts
-import { Polen } from 'polen'
-
-export default Polen.defineConfig({
-  templateVariables: {
-    title: `Pokemon Developer Portal`,
-  },
-  schemaAugmentations: [
-    {
-      type: `description`,
-      on: {
-        type: `TargetType`,
-        name: `Query`,
-      },
-      placement: `over`,
-      content:
-        `**Content from [Polen](https://github.com/the-guild-org/polen)**.`,
-    },
-  ],
-})
-```
-
-### Providing a Schema
-
-You can provide a GraphQL schema to Polen in various ways.
-
-#### File
-
-Have a single `schema.graphql` SDL file in your project directory. Example:
-
-```
-schema.graphql
-```
-
-#### Directory
-
-Have a `schema` directory in your project directory with multiple versions of
-your schema as SDL files named using format: `YYYY-MM-DD.graphql`. Example:
-
-```
-schema/
-  2023-01-13.graphql
-  2020-09-26.graphql
-```
-
-This approach allows Polen to render a changelog for your schema. Refer to
-[Changelog](#changelog).
-
-#### Memory
-
-You can provide a schema to Polen in memory via configuration.
-
-You have control to provide one or multiple schemas, with or without dates.
-
-If no dates are given then the current time is assumed.
-
-If you provide multiple versions then Polen can render a changelog for you.
-Refer to [Changelog](#changelog).
-
-Basic example:
-
-```ts
-// polen.config.ts
-import { Polen } from 'polen'
-
-export default Polen.defineConfig({
-  schema: {
-    useDataSources: `memory`,
-    dataSources: {
-      memory: {
-        versions: [
-          {
-            date: new Date('2023-01-13'),
-            value: `type Query { hello: String }`,
-          },
-        ],
-      },
-    },
-  },
-})
-```
-
-### Pages
-
-You can add pages to your developer portal by adding markdown (`.md`) or MDX (`.mdx`) files to a
-`pages` directory.
-
-#### Routing
-
-- A file becomes a page.
-- The relative (to `pages` directory) file path becomes the web path.
-- _Navigation Bar_
-  - Top level pages are listed in the navigation bar.
-- _Index Pages_
-  - A file named `index` is an index page.
-  - The file name is elided in the route. For example `foo/index.md` becomes
-    route `/foo` .
-  - Details:
-    - If both `foo/index.md` and `foo.md` exist, then the former is used, latter
-      ignored, and a warning is raised.
-
-Example:
-
-| File                  | Route      | Navigation Bar Title |
-| --------------------- | ---------- | -------------------- |
-| `pages/foo.md`        | `/foo`     | `Foo`                |
-| `pages/foo.mdx`       | `/foo`     | `Foo`                |
-| `pages/foo/index.md`  | `/foo`     | `Foo`                |
-| `pages/foo/index.mdx` | `/foo`     | `Foo`                |
-| `pages/foo/bar.md`    | `/foo/bar` | `Foo`                |
-| `pages/foo/bar.mdx`   | `/foo/bar` | `Foo`                |
-
-#### Page Ordering
-
-You can control the order of pages in the sidebar by prefixing file names with numbers followed by `_` or `-`. The numeric prefix affects only the sidebar ordering - it does not appear in the page URL or title.
-
-- _Syntax_
-  - Format: `<number>_<name>.md` or `<number>-<name>.md`
-  - Examples: `01_intro.md`, `10_getting-started.md`, `20-configuration.md`
-- _Ordering_
-  - Pages with numeric prefixes appear before pages without prefixes
-  - Pages are sorted by their numeric value (not alphabetically)
-  - Pages without prefixes are sorted alphabetically after numbered pages
-- _Collisions_
-  - If multiple files have the same name after removing the prefix (e.g., `10_about.md` and `20_about.md`), the file with the higher number is used
-  - A warning is shown for collision conflicts
-
-Example:
-
-| File                          | Route              | Sidebar Title     | Order |
-| ----------------------------- | ------------------ | ----------------- | ----- |
-| `pages/10_getting-started.md` | `/getting-started` | `Getting Started` | 1st   |
-| `pages/20_configuration.md`   | `/configuration`   | `Configuration`   | 2nd   |
-| `pages/30_advanced.md`        | `/advanced`        | `Advanced`        | 3rd   |
-| `pages/api-reference.md`      | `/api-reference`   | `Api Reference`   | 4th   |
-| `pages/troubleshooting.md`    | `/troubleshooting` | `Troubleshooting` | 5th   |
-
-#### Markdown
-
-Markdown files (`.md`) are supported using [remark](https://remark.js.org/). This is the same underlying engine as [MDX](https://mdxjs.com/) thus you can rely on consistent behavior between your `.md` and `.mdx` files.
-
-Polen supports:
-
-- [CommonMark](https://commonmark.org/).
-- [GitHub Flavored Markdown](https://github.github.com/gfm/).
-
-In the future you will be able to extend Polen in your project with additional [Remark plugins](https://github.com/remarkjs/remark/blob/main/doc/plugins.md#list-of-plugins). Track this feature in [#64](https://github.com/the-guild-org/polen/issues/64).
+Find complete example projects in the [examples](./examples) directory:
 
-If you're new to Markdown, here are some great resources to get started:
+- `pokemon` - Fun Pokemon API documentation
+- `github` - GitHub GraphQL API (coming soon)
+- `minimal` - Minimal setup example
 
-- **[CommonMark Tutorial](https://commonmark.org/help/)** - Interactive 10-minute tutorial
-- **[Markdown Guide](https://www.markdownguide.org/)** - Comprehensive reference and cheat sheets
-- **[GitHub's Markdown Guide](https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax)** - Practical guide with examples
+## Why Polen?
 
-Syntax features available to you include:
+- **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
 
-**Via CommonMark:**
+## Contributing
 
-- Headers, paragraphs, and line breaks
-- Bold, italic, and code formatting
-- Lists (ordered and unordered)
-- Links and images
-- Code blocks with syntax highlighting
-- Blockquotes
-- Horizontal rules
-
-**Via GitHub Flavored Markdown:**
-
-- Tables
-- Task lists
-- Strikethrough text
-- Autolinks
-
-#### MDX
-
-MDX begins where [Markdown](#markdown) ends. So everything stated there such as regarding supported Markdown flavours applies here too.
-
-MDX files (`.mdx`) allow you to use JSX/React components within your markdown content. This enables
-interactive documentation with live examples, custom components, and more.
-
-Example MDX page:
-
-```mdx
-# Interactive Documentation
-
-import { Button } from "@radix-ui/themes";
-
-This page demonstrates MDX features.
-
-<Button onClick={() => alert("Hello from MDX!")}>Click me!</Button>
-
-## Code Examples
-
-You can mix markdown with React components for powerful documentation:
-
-export const CodeExample = ({ language, code }) => (
-  <pre>
-    <code className={`language-${language}`}>{code}</code>
-  </pre>
-);
-
-<CodeExample
-  language="graphql"
-  code={`
-    query GetUser($id: ID!) {
-      user(id: $id) {
-        name
-        email
-      }
-    }
-  `}
-/>
-```
-
-### Build
-
-When you build you may choose between SSG and SSR. The default is SSG.
-
-#### SSG
-
-```sh
-npx polen build --type ssg
-```
-
-Deploy the contents of the `./build` directory on your favourite static site provider.
-
-#### SSR
-
-In the future Polen will have features that motivate using a server, but for now there is no particular benefit. Use `SSG` instead.
-
-#### Base Path Configuration
-
-Polen supports deploying to subdirectories through the `build.base` configuration option. This is useful for:
-
-- GitHub Pages project sites (e.g., `/my-project/`)
-- PR preview deployments (e.g., `/pr-123/`)
-- Hosting multiple Polen sites on one domain
-
-```ts
-// polen.config.ts
-import { Polen } from 'polen'
-
-export default Polen.defineConfig({
-  build: {
-    base: '/my-project/', // Must start and end with /
-  },
-})
-```
-
-When configured, Polen will output differently:
-
-- For SSG architecture:
-  - Generate static files that work in the subdirectory
-- For SSR architecture:
-  - A server that serves static assets from the correct path
-
-You can also set the base path via CLI:
-
-```bash
-npx polen build --base /my-project/
-npx polen dev --base /my-project/
-```
-
-The CLI flag takes precedence over the config file setting.
-
-#### Custom Logo
-
-You can provide a custom logo for your developer portal by placing a `logo.svg` file in your project's `public` directory:
-
-```
-public/
-  logo.svg
-```
-
-Polen will automatically use this logo in the navigation bar instead of the default Polen logo.
-
-### Package
-
-#### ESM
-
-Polen is an ESM only package. If you are using CJS, then you need
-[NodeJS version `>=22.0.0` to `require` it](https://nodejs.org/api/modules.html#loading-ecmascript-modules-using-require).
-
-#### Exports
-
-You can import a `Polen` namespace from `polen`. You can import its bare exports
-from `polen/polen`.
-
-```ts
-import { Polen } from 'polen'
-import { defineConfig } from 'polen/polen'
-
-console.log(Polen.defineConfig === defineConfig) // true
-```
-
-### Instant Schema Explorer
-
-Polen comes with a light-weight command to instantly view any GraphQL schema.
-
-Example:
-
-```sh
-npx polen open --name github
-```
-
-See docs for more details
-
-```sh
-npx polen open --help
-```
+We welcome contributions! See [DEVELOPMENT.md](./DEVELOPMENT.md) for:
 
-## Other
+- Development setup
+- Architecture overview
+- Testing guidelines
+- Contribution process
 
-### Changelog
+## Changelog
 
-Refer to
-[releases on this repo](https://github.com/the-guild-org/polen/releases).
+See [releases](https://github.com/the-guild-org/polen/releases) for a detailed changelog.
 
-### Development
+## License
 
-If you are working on Polen itself, then refer to
-[DEVELOPMENT.md](./DEVELOPMENT.md) for details about workflow, testing, etc.
+MIT © [The Guild](https://the-guild.dev)

package/build/api/api.d.ts

@@ -1,4 +1,5 @@
 export * from './builder/index.ts';
 export * from './config-resolver/index.ts';
 export * from './config/index.ts';
+export * from './static/index.ts';
 //# 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"}
+{"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"}

package/build/api/api.js

@@ -1,4 +1,5 @@
 export * from "./builder/index.js";
 export * from "./config-resolver/index.js";
 export * from "./config/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"}
+{"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"}

package/build/api/config/load.js

@@ -8,7 +8,7 @@ var __rewriteRelativeImportExtension = (this && this.__rewriteRelativeImportExte
 };
 import { assertOptionalPathAbsolute, pickFirstPathExisting } from '#lib/kit-temp';
 import { packagePaths } from '#package-paths';
-import { debug } from '#singletons/debug';
+import { debugPolen } from '#singletons/debug';
 import { Path } from '@wollybeard/kit';
 import * as Module from 'node:module';
 export const fileNameBases = [`polen.config`, `.polen.config`];
@@ -18,7 +18,7 @@ export const fileNameExtensions = [...fileNameExtensionsTypeScript, ...fileNameE
 export const fileNames = fileNameBases.flatMap(base => fileNameExtensions.map(ext => `${base}${ext}`));
 let isSelfContainedModeRegistered = false;
 export const load = async (options) => {
-    const _debug = debug.sub(`load`);
+    const debug = debugPolen.sub(`load`);
     assertOptionalPathAbsolute(options.dir);
     //
     // ━━ Enable Self-Contained Mode
@@ -31,7 +31,7 @@ export const load = async (options) => {
         const initializeData = {
             projectDirPathExp: options.dir,
         };
-        _debug(`register node module hooks`, { data: initializeData });
+        debug(`register node module hooks`, { data: initializeData });
         // TODO: would be simpler to use sync hooks
         // https://nodejs.org/api/module.html#synchronous-hooks-accepted-by-moduleregisterhooks
         // Requires NodeJS 22.15+ -- which is not working with PW until its next release.
@@ -61,7 +61,7 @@ export const load = async (options) => {
             // eslint-disable-next-line
             module = await import(__rewriteRelativeImportExtension(filePath, true));
         }
-        _debug(`imported config module`);
+        debug(`imported config module`);
         //       // Use dynamic import with file URL to support Windows
         //       const configUrl = pathToFileURL(configPath).href
         // todo: report errors nicely if this fails
@@ -82,7 +82,7 @@ export const load = async (options) => {
         configInput.advanced ??= {};
         configInput.advanced.isSelfContainedMode = true;
     }
-    _debug(`loaded config input`, configInput);
+    debug(`loaded config input`, configInput);
     return configInput;
 };
 //# sourceMappingURL=load.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/api/config/load.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"load.js","sourceRoot":"","sources":["../../../src/api/config/load.ts"],"names":[],"mappings":";;;;;;;;AACA,OAAO,EAAE,0BAA0B,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAE9C,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AACtC,OAAO,KAAK,MAAM,MAAM,aAAa,CAAA;AAGrC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,cAAc,EAAE,eAAe,CAAC,CAAA;AAC9D,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAC1E,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;AAC3D,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAG,4BAA4B,EAAE,GAAG,4BAA4B,CAAC,CAAA;AACpG,MAAM,CAAC,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,GAAG,GAAG,EAAE,CAAC,CAAC,CAAA;AAMtG,IAAI,6BAA6B,GAAG,KAAK,CAAA;AAEzC,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,EAAE,OAAoB,EAAwB,EAAE;IACvE,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACpC,0BAA0B,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IAEvC,EAAE;IACF,gCAAgC;IAChC,EAAE;IACF,6CAA6C;IAC7C,mDAAmD;IACnD,EAAE;IAEF,MAAM,0BAA0B,GAAG,YAAY,CAAC,mBAAmB,CAAA;IACnE,IAAI,0BAA0B,IAAI,CAAC,6BAA6B,EAAE,CAAC;QACjE,MAAM,cAAc,GAA+B;YACjD,iBAAiB,EAAE,OAAO,CAAC,GAAG;SAC/B,CAAA;QACD,KAAK,CAAC,4BAA4B,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;QAC7D,2CAA2C;QAC3C,uFAAuF;QACvF,iFAAiF;QACjF,MAAM,CAAC,QAAQ,CAAC,4BAA4B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAA;QACxF,6BAA6B,GAAG,IAAI,CAAA;IACtC,CAAC;IAED,EAAE;IACF,sBAAsB;IACtB,EAAE;IAEF,MAAM,SAAS,GAAG,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAA;IAC7E,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,SAAS,CAAC,CAAA;IAEvD,IAAI,WAAW,GAA4B,SAAS,CAAA;IACpD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,WAAW,GAAG,EAAE,CAAA;IAClB,CAAC;SAAM,CAAC;QACN,2EAA2E;QAC3E,8DAA8D;QAE9D,IAAI,MAA+E,CAAA;QACnF,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjE,8CAA8C;YAC9C,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAA;YAChD,2BAA2B;YAC3B,MAAM,GAAG,MAAM,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QACpD,CAAC;aAAM,CAAC;YACN,2BAA2B;YAC3B,MAAM,GAAG,MAAM,MAAM,kCAAC,QAAQ,QAAC,CAAA;QACjC,CAAC;QACD,KAAK,CAAC,wBAAwB,CAAC,CAAA;QAE/B,+DAA+D;QAC/D,yDAAyD;QAEzD,2CAA2C;QAC3C,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,MAAM,CAAC,CAAA;QAEnE,oCAAoC;QAEpC,6BAA6B;QAC7B,IAAI,CAAC,mBAAmB,EAAE,CAAC;YACzB,MAAM,IAAI,KAAK,CACb,6BAA6B,QAAQ,qFAAqF,CAC3H,CAAA;QACH,CAAC;QACD,WAAW,GAAG,mBAAmB,CAAA;IACnC,CAAC;IAED,EAAE;IACF,8CAA8C;IAC9C,EAAE;IACF,8EAA8E;IAC9E,oEAAoE;IAEpE,IAAI,0BAA0B,EAAE,CAAC;QAC/B,WAAW,CAAC,QAAQ,KAAK,EAAE,CAAA;QAC3B,WAAW,CAAC,QAAQ,CAAC,mBAAmB,GAAG,IAAI,CAAA;IACjD,CAAC;IAED,KAAK,CAAC,qBAAqB,EAAE,WAAW,CAAC,CAAA;IAEzC,OAAO,WAAW,CAAA;AACpB,CAAC,CAAA"}

package/build/api/config-resolver/resolve.js

@@ -1,4 +1,4 @@
-import { debug } from '#singletons/debug';
+import { debugPolen } from '#singletons/debug';
 import { normalizeInput } from "../config/configurator.js";
 import { load } from "../config/load.js";
 import { mergeInputs } from "../config/merge.js";
@@ -7,7 +7,7 @@ export const fromFile = async (options) => {
     const configInput = await load(options);
     const configInputMerged = mergeInputs(configInput, options.overrides);
     const config = await fromMemory(configInputMerged, options.dir);
-    debug(`resolved config`, config);
+    debugPolen(`resolved config`, config);
     return config;
 };
 export const fromMemory = async (input, 

package/build/api/config-resolver/resolve.js.map

@@ -1 +1 @@
-{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/api/config-resolver/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AACzC,OAAO,EAAoB,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAoB,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAgC,MAAM,WAAW,CAAA;AAM1E,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,OAA+B,EAAoC,EAAE;IAClG,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAA;IACvC,MAAM,iBAAiB,GAAG,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/D,KAAK,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;IAChC,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,KAAkB;AAClB;;;;GAIG;AACH,eAAwB,EACxB,EAAE;IACF,MAAM,gBAAgB,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,eAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACtF,MAAM,cAAc,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;IACzD,OAAO,cAAc,CAAA;AACvB,CAAC,CAAA"}
+{"version":3,"file":"resolve.js","sourceRoot":"","sources":["../../../src/api/config-resolver/resolve.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAC9C,OAAO,EAAoB,cAAc,EAAE,MAAM,2BAA2B,CAAA;AAC5E,OAAO,EAAE,IAAI,EAAoB,MAAM,mBAAmB,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAA;AAChD,OAAO,EAAE,gBAAgB,EAAgC,MAAM,WAAW,CAAA;AAM1E,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,OAA+B,EAAoC,EAAE;IAClG,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAA;IACvC,MAAM,iBAAiB,GAAG,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,SAAS,CAAC,CAAA;IACrE,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,CAAA;IAC/D,UAAU,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAA;IACrC,OAAO,MAAM,CAAA;AACf,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,UAAU,GAAG,KAAK,EAC7B,KAAkB;AAClB;;;;GAIG;AACH,eAAwB,EACxB,EAAE;IACF,MAAM,gBAAgB,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,eAAe,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAA;IACtF,MAAM,cAAc,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;IACzD,OAAO,cAAc,CAAA;AACvB,CAAC,CAAA"}

package/build/api/content/$$.d.ts

@@ -0,0 +1,5 @@
+export * from './metadata.ts';
+export * from './page.ts';
+export * from './scan.ts';
+export * from './sidebar.ts';
+//# sourceMappingURL=$$.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"$$.d.ts","sourceRoot":"","sources":["../../../src/api/content/$$.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}

package/build/api/content/$$.js

@@ -0,0 +1,5 @@
+export * from "./metadata.js";
+export * from "./page.js";
+export * from "./scan.js";
+export * from "./sidebar.js";
+//# sourceMappingURL=$$.js.map

package/build/api/content/$$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$$.js","sourceRoot":"","sources":["../../../src/api/content/$$.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA"}

package/build/api/content/$.d.ts

@@ -0,0 +1,2 @@
+export * as Content from './$$.ts';
+//# sourceMappingURL=$.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"$.d.ts","sourceRoot":"","sources":["../../../src/api/content/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA"}

package/build/api/content/$.js

@@ -0,0 +1,2 @@
+export * as Content from "./$$.js";
+//# sourceMappingURL=$.js.map

package/build/api/content/$.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"$.js","sourceRoot":"","sources":["../../../src/api/content/$.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,SAAS,CAAA"}

package/build/api/content/metadata.d.ts

@@ -0,0 +1,10 @@
+import { z } from 'zod/v4';
+/**
+ * Schema for validating front matter content
+ */
+export declare const MetadataSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    hidden: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+export type Metadata = z.infer<typeof MetadataSchema>;
+//# sourceMappingURL=metadata.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.d.ts","sourceRoot":"","sources":["../../../src/api/content/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B;;GAEG;AACH,eAAO,MAAM,cAAc;;;iBAGzB,CAAA;AAEF,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAA"}

package/build/api/content/metadata.js

@@ -0,0 +1,9 @@
+import { z } from 'zod/v4';
+/**
+ * Schema for validating front matter content
+ */
+export const MetadataSchema = z.object({
+    description: z.string().optional(),
+    hidden: z.boolean().default(false),
+});
+//# sourceMappingURL=metadata.js.map

package/build/api/content/metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadata.js","sourceRoot":"","sources":["../../../src/api/content/metadata.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,QAAQ,CAAA;AAE1B;;GAEG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,MAAM,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC;CACnC,CAAC,CAAA"}

package/build/api/content/page.d.ts

@@ -0,0 +1,11 @@
+import type { FileRouter } from '#lib/file-router/index';
+import type { Metadata } from './metadata.ts';
+export type { Metadata };
+/**
+ * A route with its associated metadata
+ */
+export interface Page {
+    route: FileRouter.Route;
+    metadata: Metadata;
+}
+//# sourceMappingURL=page.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"page.d.ts","sourceRoot":"","sources":["../../../src/api/content/page.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAA;AACxD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAE7C,YAAY,EAAE,QAAQ,EAAE,CAAA;AAExB;;GAEG;AACH,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,UAAU,CAAC,KAAK,CAAA;IACvB,QAAQ,EAAE,QAAQ,CAAA;CACnB"}

package/build/api/content/page.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=page.js.map

package/build/api/content/page.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"page.js","sourceRoot":"","sources":["../../../src/api/content/page.ts"],"names":[],"mappings":""}