polen 0.11.0-next.15 → 0.11.0-next.16

package/build/vite/plugins/examples.js

@@ -0,0 +1,149 @@
+import { Examples as ExamplesModule } from '#api/examples/$';
+import * as Catalog from '#api/examples/schemas/catalog';
+import { generateExampleTypes } from '#api/examples/type-generator';
+import { createTypeUsageIndex } from '#api/examples/type-usage-indexer';
+import { Diagnostic } from '#lib/diagnostic/$';
+import { ViteReactive } from '#lib/vite-reactive/$';
+import { createAssetReader } from '#lib/vite-reactive/reactive-asset-plugin';
+import { ViteVirtual } from '#lib/vite-virtual';
+import { debugPolen } from '#singletons/debug';
+import { FileSystem } from '@effect/platform';
+import * as NodeFileSystem from '@effect/platform-node/NodeFileSystem';
+import { Str } from '@wollybeard/kit';
+import { Effect } from 'effect';
+import * as Path from 'node:path';
+import { polenVirtual } from '../vi.js';
+// Virtual modules provided by this plugin
+export const viProjectExamples = polenVirtual([`project`, `examples`]);
+/**
+ * Examples plugin with versioning support
+ */
+export const Examples = ({ config, schemaReader, dependentVirtualModules = [], }) => {
+    const debug = debugPolen.sub(`vite-examples`);
+    const examplesDir = Path.join(config.paths.project.rootDir, 'examples');
+    // Track last generated example names to detect changes
+    let lastGeneratedExampleNames = null;
+    const reader = createAssetReader(() => {
+        return Effect.gen(function* () {
+            const loadedCatalog = yield* schemaReader.read();
+            const scanExamplesResult = yield* ExamplesModule.scan({
+                dir: examplesDir,
+                schemaCatalog: loadedCatalog?.data ?? undefined,
+            });
+            // Generate TypeScript types if examples have changed
+            const currentExampleNames = scanExamplesResult.catalog.examples.map(e => e.name).sort();
+            const exampleNamesChanged = lastGeneratedExampleNames === null
+                || currentExampleNames.length !== lastGeneratedExampleNames.length
+                || currentExampleNames.some((id, i) => id !== lastGeneratedExampleNames[i]);
+            if (exampleNamesChanged) {
+                debug(`Examples changed, regenerating types`);
+                yield* generateExampleTypes(scanExamplesResult.catalog, config.paths.project.rootDir);
+                lastGeneratedExampleNames = currentExampleNames;
+            }
+            debug('Found examples', { count: scanExamplesResult.catalog.examples.length });
+            return scanExamplesResult;
+        });
+    });
+    const scanExamples = async () => {
+        return await Effect.runPromise(reader.read().pipe(Effect.provide(NodeFileSystem.layer)));
+    };
+    // Map diagnostic to its control configuration
+    const getControlForDiagnostic = (diagnostic) => {
+        if (diagnostic.source === 'examples-scanner') {
+            switch (diagnostic.name) {
+                case 'unused-default':
+                    return config.examples.diagnostics?.unusedVersions;
+                case 'duplicate-content':
+                    return config.examples.diagnostics?.duplicateContent;
+                case 'missing-versions':
+                    return config.examples.diagnostics?.missingVersions;
+                case 'unknown-version':
+                    // Always show errors for unknown versions (they are discarded from catalog)
+                    return {
+                        enabled: true,
+                        dev: { severity: 'error' },
+                        build: { severity: 'error' },
+                    };
+            }
+        }
+        else if (diagnostic.source === 'examples-validation') {
+            return config.examples.diagnostics?.validation;
+        }
+        return undefined;
+    };
+    // Apply DiagnosticControl filtering and report diagnostics
+    const reportDiagnostics = (diagnostics, phase = 'dev') => {
+        Diagnostic.filterAndReport(diagnostics, getControlForDiagnostic, phase);
+    };
+    const plugins = [
+        ViteReactive.ReactiveAssetPlugin({
+            name: 'examples',
+            reader,
+            filePatterns: {
+                watch: [examplesDir],
+                isRelevant: (file) => {
+                    return file.includes(examplesDir) && (file.endsWith('.graphql')
+                        || file.endsWith('.gql')
+                        || file.endsWith('index.md')
+                        || file.endsWith('index.mdx'));
+                },
+            },
+            dependentVirtualModules: [viProjectExamples, ...dependentVirtualModules],
+            hooks: {
+                async shouldFullReload() {
+                    // Always trigger full reload for examples changes
+                    return true;
+                },
+                async onDiagnostics(data) {
+                    // Report diagnostics with DiagnosticControl filtering
+                    reportDiagnostics(data.diagnostics, 'dev');
+                },
+            },
+        }),
+        {
+            name: 'polen:examples-virtual',
+            ...ViteVirtual.IdentifiedLoader.toHooks({
+                identifier: viProjectExamples,
+                async loader() {
+                    debug(`Loading viProjectExamples virtual module`);
+                    const scanExamplesResult = await scanExamples();
+                    reportDiagnostics(scanExamplesResult.diagnostics, 'dev');
+                    // Generate type usage index if schemas are available
+                    let catalogWithIndex = scanExamplesResult.catalog;
+                    const schemaReaderResult = await Effect.runPromise(schemaReader.read().pipe(Effect.provide(NodeFileSystem.layer)));
+                    const schemasCatalog = schemaReaderResult?.data;
+                    if (schemasCatalog) {
+                        const typeUsageIndex = createTypeUsageIndex(scanExamplesResult.catalog.examples, schemasCatalog);
+                        // The index will be properly encoded by the Catalog schema
+                        catalogWithIndex = {
+                            ...scanExamplesResult.catalog,
+                            typeUsageIndex: typeUsageIndex, // Will be encoded by Catalog.encode
+                        };
+                    }
+                    // Generate the module code with both catalog and component exports
+                    const s = Str.Builder();
+                    s `import { Effect } from 'effect'`;
+                    s `import * as Catalog from '#api/examples/schemas/catalog'`;
+                    const indexFilePath = scanExamplesResult.catalog.index?.path;
+                    if (indexFilePath) {
+                        s ``;
+                        s `export { default as IndexComponent } from '${indexFilePath}'`;
+                    }
+                    else {
+                        s ``;
+                        s `export const IndexComponent = null`;
+                    }
+                    // Encode the catalog to ensure HashMap and other Effect types are properly serialized
+                    const encodedCatalog = Catalog.encodeSync(catalogWithIndex);
+                    s ``;
+                    s `const catalogData = ${JSON.stringify(encodedCatalog)}`;
+                    s ``;
+                    s `export const examplesCatalog = Effect.runSync(Catalog.decode(catalogData))`;
+                    return s.render();
+                },
+            }),
+        },
+    ];
+    return { plugins, reader };
+};
+//# sourceMappingURL=examples.js.map

package/build/vite/plugins/examples.js.map

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

package/build/vite/plugins/hooks.d.ts

@@ -0,0 +1,12 @@
+import { Api } from '#api/$';
+import { ViteVirtual } from '#lib/vite-virtual';
+import type * as Vite from 'vite';
+export declare const viProjectHooks: ViteVirtual.Identifier.Identifier;
+export interface Options {
+    config: Api.Config.Config;
+}
+/**
+ * Hooks plugin that handles user-defined hooks from hooks.ts or hooks.tsx
+ */
+export declare const Hooks: ({ config }: Options) => Vite.Plugin;
+//# sourceMappingURL=hooks.d.ts.map

package/build/vite/plugins/hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAE/C,OAAO,KAAK,KAAK,IAAI,MAAM,MAAM,CAAA;AAEjC,eAAO,MAAM,cAAc,mCAAsE,CAAA;AAEjG,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAA;CAC1B;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,YAAY,OAAO,KAAG,IAAI,CAAC,MAkChD,CAAA"}

package/build/vite/plugins/hooks.js

@@ -0,0 +1,41 @@
+import { Api } from '#api/$';
+import { ViteVirtual } from '#lib/vite-virtual';
+import { polenVirtual } from '#vite/vi';
+export const viProjectHooks = polenVirtual([`project`, `hooks`], { allowPluginProcessing: true });
+/**
+ * Hooks plugin that handles user-defined hooks from hooks.ts or hooks.tsx
+ */
+export const Hooks = ({ config }) => {
+    return {
+        name: 'polen:hooks-virtual',
+        ...ViteVirtual.IdentifiedLoader.toHooks({
+            identifier: viProjectHooks,
+            async loader() {
+                const fs = await import('node:fs/promises');
+                const path = await import('node:path');
+                const hooksPathTs = path.join(config.paths.project.rootDir, 'hooks.ts');
+                const hooksPathTsx = path.join(config.paths.project.rootDir, 'hooks.tsx');
+                let hooksPath = null;
+                try {
+                    await fs.access(hooksPathTsx);
+                    hooksPath = hooksPathTsx;
+                }
+                catch {
+                    try {
+                        await fs.access(hooksPathTs);
+                        hooksPath = hooksPathTs;
+                    }
+                    catch {
+                        // No hooks file found
+                    }
+                }
+                if (!hooksPath) {
+                    // Return an empty module if no hooks file exists
+                    return `// No hooks file found`;
+                }
+                return `export * from '${hooksPath}'`;
+            },
+        }),
+    };
+};
+//# sourceMappingURL=hooks.js.map

package/build/vite/plugins/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/vite/plugins/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AAC5B,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,UAAU,CAAA;AAGvC,MAAM,CAAC,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAA;AAMjG;;GAEG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,CAAC,EAAE,MAAM,EAAW,EAAe,EAAE;IACxD,OAAO;QACL,IAAI,EAAE,qBAAqB;QAC3B,GAAG,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC;YACtC,UAAU,EAAE,cAAc;YAC1B,KAAK,CAAC,MAAM;gBACV,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;gBAC3C,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAA;gBAEtC,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,UAAU,CAAC,CAAA;gBACvE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,WAAW,CAAC,CAAA;gBAEzE,IAAI,SAAS,GAAG,IAAI,CAAA;gBACpB,IAAI,CAAC;oBACH,MAAM,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAA;oBAC7B,SAAS,GAAG,YAAY,CAAA;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,CAAC;wBACH,MAAM,EAAE,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;wBAC5B,SAAS,GAAG,WAAW,CAAA;oBACzB,CAAC;oBAAC,MAAM,CAAC;wBACP,sBAAsB;oBACxB,CAAC;gBACH,CAAC;gBAED,IAAI,CAAC,SAAS,EAAE,CAAC;oBACf,iDAAiD;oBACjD,OAAO,wBAAwB,CAAA;gBACjC,CAAC;gBAED,OAAO,kBAAkB,SAAS,GAAG,CAAA;YACvC,CAAC;SACF,CAAC;KACH,CAAA;AACH,CAAC,CAAA"}

package/build/vite/plugins/index.d.ts

@@ -1,8 +1,9 @@
 export { Branding } from './branding.js';
 export { Build } from './build.js';
 export { Core } from './core.js';
+export { Examples } from './examples.js';
 export { Main } from './main.js';
 export { Pages } from './pages.js';
-export { SchemaAssets } from './schema-assets.js';
+export { Schemas } from './schemas.js';
 export { Serve } from './serve.js';
 //# sourceMappingURL=index.d.ts.map

package/build/vite/plugins/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA"}

package/build/vite/plugins/index.js

@@ -1,8 +1,9 @@
 export { Branding } from './branding.js';
 export { Build } from './build.js';
 export { Core } from './core.js';
+export { Examples } from './examples.js';
 export { Main } from './main.js';
 export { Pages } from './pages.js';
-export { SchemaAssets } from './schema-assets.js';
+export { Schemas } from './schemas.js';
 export { Serve } from './serve.js';
 //# sourceMappingURL=index.js.map

package/build/vite/plugins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vite/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACjD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/vite/plugins/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAChC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA"}

package/build/vite/plugins/main.d.ts

@@ -1,4 +1,4 @@
-import type { Api } from '#api/index';
+import type { Api } from '#api/$';
 import type { Vite } from '#dep/vite/index';
 export declare const Main: (config: Api.Config.Config) => Vite.PluginOption;
 //# sourceMappingURL=main.d.ts.map

package/build/vite/plugins/main.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAW3C,eAAO,MAAM,IAAI,GACf,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,KACxB,IAAI,CAAC,YA2BP,CAAA"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/main.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAW3C,eAAO,MAAM,IAAI,GACf,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,KACxB,IAAI,CAAC,YA2BP,CAAA"}

package/build/vite/plugins/manifest.d.ts

@@ -1,4 +1,4 @@
-import type { Api } from '#api/index';
+import type { Api } from '#api/$';
 import { Vite } from '#dep/vite/index';
 export declare const Manifest: (config: Api.Config.Config) => Vite.Plugin;
 //# sourceMappingURL=manifest.d.ts.map

package/build/vite/plugins/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAOtC,eAAO,MAAM,QAAQ,GAAI,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,KAAG,IAAI,CAAC,MA2BzD,CAAA"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAOtC,eAAO,MAAM,QAAQ,GAAI,QAAQ,GAAG,CAAC,MAAM,CAAC,MAAM,KAAG,IAAI,CAAC,MA2BzD,CAAA"}

package/build/vite/plugins/navbar.d.ts

@@ -0,0 +1,16 @@
+import { Api } from '#api/$';
+import type { AssetReader } from '#lib/vite-reactive/reactive-asset-plugin';
+import { ViteVirtual } from '#lib/vite-virtual';
+import type * as Vite from 'vite';
+export declare const viProjectNavbar: ViteVirtual.Identifier.Identifier;
+export interface Options {
+    config: Api.Config.Config;
+    schemaReader: AssetReader<Api.Schema.InputSource.LoadedCatalog | null, any, any>;
+    examplesReader: AssetReader<any, any, any>;
+    pagesReader: AssetReader<any, any, any>;
+}
+/**
+ * Navbar plugin that generates the navigation structure based on available content
+ */
+export declare const Navbar: ({ config, schemaReader, examplesReader, pagesReader, }: Options) => Vite.Plugin;
+//# sourceMappingURL=navbar.d.ts.map

package/build/vite/plugins/navbar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"navbar.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/navbar.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AAG5B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0CAA0C,CAAA;AAC3E,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAK/C,OAAO,KAAK,KAAK,IAAI,MAAM,MAAM,CAAA;AAEjC,eAAO,MAAM,eAAe,mCAAsC,CAAA;AAElE,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAA;IACzB,YAAY,EAAE,WAAW,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,aAAa,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAChF,cAAc,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAC1C,WAAW,EAAE,WAAW,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;CACxC;AAED;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,wDAKpB,OAAO,KAAG,IAAI,CAAC,MAyEjB,CAAA"}

package/build/vite/plugins/navbar.js

@@ -0,0 +1,60 @@
+import { Api } from '#api/$';
+import { createNavbar } from '#api/content/navbar';
+import { Catalog } from '#lib/catalog/$';
+import { ViteVirtual } from '#lib/vite-virtual';
+import { debugPolen } from '#singletons/debug';
+import { polenVirtual } from '#vite/vi';
+import * as NodeFileSystem from '@effect/platform-node/NodeFileSystem';
+import { Effect } from 'effect';
+export const viProjectNavbar = polenVirtual([`project`, `navbar`]);
+/**
+ * Navbar plugin that generates the navigation structure based on available content
+ */
+export const Navbar = ({ config, schemaReader, examplesReader, pagesReader, }) => {
+    return {
+        name: 'polen:navbar-virtual',
+        ...ViteVirtual.IdentifiedLoader.toHooks({
+            identifier: viProjectNavbar,
+            async loader() {
+                const debug = debugPolen.sub(`module-project-navbar`);
+                debug(`load`, { id: viProjectNavbar.id });
+                const navbar = [];
+                // ━ Schema presence causes adding some navbar items
+                const loadedSchemaCatalog = await Effect.runPromise(schemaReader.read().pipe(Effect.provide(NodeFileSystem.layer)));
+                if (loadedSchemaCatalog?.data) {
+                    // IMPORTANT: Always ensure paths start with '/' for React Router compatibility.
+                    // Without the leading slash, React Router treats paths as relative, which causes
+                    // hydration mismatches between SSR (where base path is prepended) and client
+                    // (where basename is configured). This ensures consistent behavior.
+                    const referencePath = Api.Schema.Routing.createReferenceBasePath();
+                    navbar.push({ pathExp: referencePath, title: `Reference`, position: 'right' });
+                    // Check if we have revisions to show changelog
+                    const catalog = loadedSchemaCatalog.data;
+                    const hasMultipleRevisions = Catalog.fold((versioned) => {
+                        // For versioned catalogs, count total revisions across all entries
+                        const totalRevisions = versioned.entries.reduce((sum, entry) => sum + entry.revisions.length, 0);
+                        return totalRevisions > 1;
+                    }, (unversioned) => unversioned.schema.revisions?.length > 1)(catalog);
+                    if (hasMultipleRevisions) {
+                        navbar.push({ pathExp: `/changelog`, title: `Changelog`, position: 'right' });
+                    }
+                }
+                // ━ Examples presence causes adding navbar item
+                const loadedExamplesCatalog = await Effect.runPromise(examplesReader.read().pipe(Effect.provide(NodeFileSystem.layer)));
+                // Use config.examples.enabled if explicitly set, otherwise auto-detect
+                const examplesEnabled = config.examples.enabled
+                    ?? (loadedExamplesCatalog.catalog.examples.length > 0);
+                if (examplesEnabled) {
+                    navbar.push({ pathExp: '/examples', title: 'Examples', position: 'right' });
+                }
+                // ━━ Scan pages and add to navbar
+                const scanResult = await Effect.runPromise(pagesReader.read().pipe(Effect.provide(NodeFileSystem.layer)));
+                const data = createNavbar(scanResult.list);
+                navbar.push(...data);
+                // Return a JavaScript module that exports the navbar
+                return `export const navbar = ${JSON.stringify(navbar)}`;
+            },
+        }),
+    };
+};
+//# sourceMappingURL=navbar.js.map

package/build/vite/plugins/navbar.js.map

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

package/build/vite/plugins/pages.d.ts

@@ -1,10 +1,13 @@
+import type { Api } from '#api/$';
 import { Content } from '#api/content/$';
-import type { Api } from '#api/index';
 import type { Vite } from '#dep/vite/index';
-export declare const viProjectRoutes: import("../../lib/vite-virtual/identifier.js").Identifier;
-export declare const viProjectPagesCatalog: import("../../lib/vite-virtual/identifier.js").Identifier;
+import { ViteReactive } from '#lib/vite-reactive/$';
+import type { ViteVirtual } from '#lib/vite-virtual/$';
+export declare const viProjectRoutes: ViteVirtual.Identifier.Identifier;
+export declare const viProjectPages: ViteVirtual.Identifier.Identifier;
 export interface Options {
     config: Api.Config.Config;
+    dependentVirtualModules?: ViteVirtual.Identifier.Identifier[];
 }
 export interface ProjectPagesCatalog {
     sidebarIndex: Content.SidebarIndex;
@@ -13,5 +16,8 @@ export interface ProjectPagesCatalog {
 /**
  * Pages plugin with tree support
  */
-export declare const Pages: ({ config, }: Options) => Vite.Plugin[];
+export declare const Pages: ({ config, dependentVirtualModules, }: Options) => {
+    plugins: Vite.Plugin<any>[];
+    reader: ViteReactive.AssetReader<Content.ScanResult, Error, import("@effect/platform/FileSystem").FileSystem>;
+};
 //# sourceMappingURL=pages.d.ts.map

package/build/vite/plugins/pages.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/pages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,YAAY,CAAA;AACrC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAgB3C,eAAO,MAAM,eAAe,2DAA2E,CAAA;AACvG,eAAO,MAAM,qBAAqB,2DAEhC,CAAA;AAEF,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAA;CAC1B;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAA;IAClC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,aAEnB,OAAO,KAAG,IAAI,CAAC,MAAM,EAoOvB,CAAA"}
+{"version":3,"file":"pages.d.ts","sourceRoot":"","sources":["../../../src/vite/plugins/pages.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAA;AACjC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAA;AACxC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,iBAAiB,CAAA;AAG3C,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAA;AAEnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAQtD,eAAO,MAAM,eAAe,mCAA2E,CAAA;AAEvG,eAAO,MAAM,cAAc,mCAEzB,CAAA;AAEF,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAA;IACzB,uBAAuB,CAAC,EAAE,WAAW,CAAC,UAAU,CAAC,UAAU,EAAE,CAAA;CAC9D;AAED,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,OAAO,CAAC,YAAY,CAAA;IAClC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,CAAA;CACtB;AAED;;GAEG;AACH,eAAO,MAAM,KAAK,GAAI,sCAGnB,OAAO;;;CA+IT,CAAA"}