polen 0.9.1-next.2 → 0.10.0-next.11

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,363 +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.
+Find complete example projects in the [examples](./examples) directory:
 
-Polen supports:
+- `pokemon` - Fun Pokemon API documentation
+- `github` - GitHub GraphQL API (coming soon)
+- `minimal` - Minimal setup example
 
-- [CommonMark](https://commonmark.org/).
-- [GitHub Flavored Markdown](https://github.github.com/gfm/).
+## Why Polen?
 
-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).
+- **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
 
-If you're new to Markdown, here are some great resources to get started:
+## Contributing
 
-- **[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
-
-Syntax features available to you include:
-
-**Via CommonMark:**
-
-- 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.
-
-### 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/configurator.d.ts

@@ -1,7 +1,7 @@
 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 PackagePaths } from '../../package-paths.ts';
 import type { Schema } from '../schema/index.ts';
 export declare const BuildArchitectureEnum: {
     readonly ssg: "ssg";
@@ -144,6 +144,10 @@ export interface Config {
                     };
                 };
                 pages: string;
+                public: {
+                    root: string;
+                    logo: string;
+                };
             };
             absolute: {
                 build: {
@@ -152,6 +156,10 @@ export interface Config {
                     serverEntrypoint: string;
                 };
                 pages: string;
+                public: {
+                    root: string;
+                    logo: string;
+                };
             };
         };
         framework: PackagePaths;

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":"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"}

package/build/api/config/configurator.js

@@ -1,7 +1,7 @@
 import { assertPathAbsolute } from '#lib/kit-temp';
+import { packagePaths } from '#package-paths';
 import { Path } from '@wollybeard/kit';
 import { z } from 'zod';
-import { packagePaths } from "../../package-paths.js";
 export const BuildArchitectureEnum = {
     ssg: `ssg`,
     spa: `spa`,
@@ -11,7 +11,11 @@ export const BuildArchitecture = z.nativeEnum(BuildArchitectureEnum);
 const buildPaths = (rootDir) => {
     if (!Path.isAbsolute(rootDir))
         throw new Error(`Root dir path must be absolute: ${rootDir}`);
-    const ensureAbsolute = Path.ensureAbsoluteWith(rootDir);
+    const rootAbsolute = Path.ensureAbsoluteWith(rootDir);
+    const buildAbsolutePath = rootAbsolute(`build`);
+    const buildAbsolute = Path.ensureAbsoluteWith(buildAbsolutePath);
+    const publicAbsolutePath = rootAbsolute(`public`);
+    const publicAbsolute = Path.ensureAbsoluteWith(publicAbsolutePath);
     return {
         project: {
             rootDir,
@@ -24,14 +28,22 @@ const buildPaths = (rootDir) => {
                     },
                 },
                 pages: `pages`,
+                public: {
+                    root: 'public',
+                    logo: 'logo.svg',
+                },
             },
             absolute: {
+                pages: rootAbsolute(`pages`),
                 build: {
-                    root: ensureAbsolute(`build`),
-                    serverEntrypoint: ensureAbsolute(`build/app.js`),
-                    assets: ensureAbsolute(`build/assets`),
+                    root: buildAbsolute('.'),
+                    serverEntrypoint: buildAbsolute(`app.js`),
+                    assets: buildAbsolute(`assets`),
+                },
+                public: {
+                    root: publicAbsolute('.'),
+                    logo: publicAbsolute('logo.svg'),
                 },
-                pages: ensureAbsolute(`pages`),
             },
         },
         framework: packagePaths,

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/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,