@cogenta/render 0.1.0

package/dist/astro/integration.d.ts

@@ -0,0 +1,57 @@
+import type { AstroIntegration } from 'astro';
+import type { RenderConfig } from '../config.js';
+import { type LoadedTheme, type LoadThemeOptions } from '../theme/load-theme.js';
+/**
+ * The Astro integration that puts the active theme in front of Astro.
+ *
+ * Astro is the theme engine by ADR-0008, so this is where the configuration's
+ * `theme.name` becomes something Vite can resolve. Two things are exposed and
+ * no more:
+ *
+ * - the alias `@theme`, pointing at the theme's `src/`, so that a site's pages
+ *   import `@theme/layouts/Base.astro` and a theme swap is a configuration
+ *   change rather than a rewrite of every import;
+ * - the virtual module `virtual:cogenta/theme`, holding the manifest and the
+ *   site block of the configuration.
+ *
+ * What is *not* exposed matters as much: the content token, the database URL
+ * and the rest of the Cogenta configuration never enter Vite's module graph,
+ * because everything in it is reachable from theme code.
+ */
+export declare const THEME_ALIAS = "@theme";
+export declare const THEME_VIRTUAL_MODULE = "virtual:cogenta/theme";
+export interface CogentaIntegrationOptions {
+    readonly config: RenderConfig;
+    /** Directory the theme is resolved from. Astro's project root by default. */
+    readonly cwd?: string | undefined;
+    /**
+     * Run the installation check before the build starts.
+     *
+     * Off by default because `cogenta theme install` already refused a theme
+     * that fails it; on for a site that installs themes out of band and wants
+     * the guarantee at build time too.
+     */
+    readonly verify?: boolean | undefined;
+    readonly importManifest?: LoadThemeOptions['importManifest'];
+}
+/** What the theme exposes to the site, serialised into the virtual module. */
+export interface ThemeModule {
+    readonly manifest: LoadedTheme['manifest'];
+    readonly site: RenderConfig['site'];
+}
+export declare function cogentaTheme(options: CogentaIntegrationOptions): AstroIntegration;
+interface MinimalVitePlugin {
+    readonly name: string;
+    resolveId(id: string): string | undefined;
+    load(id: string): string | undefined;
+}
+/**
+ * Serialises the theme into a module the site can import.
+ *
+ * `JSON.stringify` rather than a builder: the manifest came from a third-party
+ * theme, and generating code from untrusted values is how a manifest becomes
+ * an injection.
+ */
+export declare function themeVirtualModule(module: ThemeModule): MinimalVitePlugin;
+export {};
+//# sourceMappingURL=integration.d.ts.map

package/dist/astro/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../src/astro/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAChD,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,gBAAgB,EAAa,MAAM,wBAAwB,CAAA;AAE3F;;;;;;;;;;;;;;;;GAgBG;AAEH,eAAO,MAAM,WAAW,WAAW,CAAA;AACnC,eAAO,MAAM,oBAAoB,0BAA0B,CAAA;AAI3D,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,6EAA6E;IAC7E,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;IACjC;;;;;;OAMG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAA;IACrC,QAAQ,CAAC,cAAc,CAAC,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,CAAA;CAC7D;AAED,8EAA8E;AAC9E,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,QAAQ,EAAE,WAAW,CAAC,UAAU,CAAC,CAAA;IAC1C,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC,MAAM,CAAC,CAAA;CACpC;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,yBAAyB,GAAG,gBAAgB,CA2BjF;AAWD,UAAU,iBAAiB;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;IACzC,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CACrC;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAUzE"}

package/dist/astro/integration.js

@@ -0,0 +1,72 @@
+import { loadTheme } from '../theme/load-theme.js';
+/**
+ * The Astro integration that puts the active theme in front of Astro.
+ *
+ * Astro is the theme engine by ADR-0008, so this is where the configuration's
+ * `theme.name` becomes something Vite can resolve. Two things are exposed and
+ * no more:
+ *
+ * - the alias `@theme`, pointing at the theme's `src/`, so that a site's pages
+ *   import `@theme/layouts/Base.astro` and a theme swap is a configuration
+ *   change rather than a rewrite of every import;
+ * - the virtual module `virtual:cogenta/theme`, holding the manifest and the
+ *   site block of the configuration.
+ *
+ * What is *not* exposed matters as much: the content token, the database URL
+ * and the rest of the Cogenta configuration never enter Vite's module graph,
+ * because everything in it is reachable from theme code.
+ */
+export const THEME_ALIAS = '@theme';
+export const THEME_VIRTUAL_MODULE = 'virtual:cogenta/theme';
+const RESOLVED_VIRTUAL_MODULE = `\0${THEME_VIRTUAL_MODULE}`;
+export function cogentaTheme(options) {
+    return {
+        name: '@cogenta/render',
+        hooks: {
+            'astro:config:setup': async ({ config, updateConfig, logger }) => {
+                const theme = await loadTheme({
+                    theme: options.config.theme,
+                    cwd: options.cwd ?? fileSystemPath(config.root),
+                    importManifest: options.importManifest,
+                    verify: options.verify ?? false,
+                });
+                logger.info(`theme ${theme.manifest.name}@${theme.manifest.version} (runtime: ${theme.manifest.runtime})`);
+                updateConfig({
+                    vite: {
+                        plugins: [themeVirtualModule({ manifest: theme.manifest, site: options.config.site })],
+                        resolve: {
+                            alias: { [THEME_ALIAS]: `${theme.root}/src` },
+                        },
+                    },
+                });
+            },
+        },
+    };
+}
+/** Astro hands roots as `URL`s; Vite wants paths. */
+function fileSystemPath(root) {
+    const href = typeof root === 'string' ? root : root.href;
+    if (!href.startsWith('file:'))
+        return href;
+    const path = decodeURIComponent(new URL(href).pathname);
+    // A Windows path arrives as `/C:/…`; the leading slash is not part of it.
+    return /^\/[A-Za-z]:/u.test(path) ? path.slice(1) : path;
+}
+/**
+ * Serialises the theme into a module the site can import.
+ *
+ * `JSON.stringify` rather than a builder: the manifest came from a third-party
+ * theme, and generating code from untrusted values is how a manifest becomes
+ * an injection.
+ */
+export function themeVirtualModule(module) {
+    return {
+        name: 'cogenta:theme',
+        resolveId: (id) => (id === THEME_VIRTUAL_MODULE ? RESOLVED_VIRTUAL_MODULE : undefined),
+        load: (id) => id === RESOLVED_VIRTUAL_MODULE
+            ? `export const manifest = ${JSON.stringify(module.manifest)}\n` +
+                `export const site = ${JSON.stringify(module.site)}\n`
+            : undefined,
+    };
+}
+//# sourceMappingURL=integration.js.map

package/dist/astro/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../../src/astro/integration.ts"],"names":[],"mappings":"AAEA,OAAO,EAA2C,SAAS,EAAE,MAAM,wBAAwB,CAAA;AAE3F;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAA;AACnC,MAAM,CAAC,MAAM,oBAAoB,GAAG,uBAAuB,CAAA;AAE3D,MAAM,uBAAuB,GAAG,KAAK,oBAAoB,EAAE,CAAA;AAuB3D,MAAM,UAAU,YAAY,CAAC,OAAkC;IAC7D,OAAO;QACL,IAAI,EAAE,iBAAiB;QACvB,KAAK,EAAE;YACL,oBAAoB,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;gBAC/D,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC;oBAC5B,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC,KAAK;oBAC3B,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC;oBAC/C,cAAc,EAAE,OAAO,CAAC,cAAc;oBACtC,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK;iBAChC,CAAC,CAAA;gBAEF,MAAM,CAAC,IAAI,CACT,SAAS,KAAK,CAAC,QAAQ,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,CAAC,OAAO,cAAc,KAAK,CAAC,QAAQ,CAAC,OAAO,GAAG,CAC9F,CAAA;gBAED,YAAY,CAAC;oBACX,IAAI,EAAE;wBACJ,OAAO,EAAE,CAAC,kBAAkB,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;wBACtF,OAAO,EAAE;4BACP,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,EAAE,GAAG,KAAK,CAAC,IAAI,MAAM,EAAE;yBAC9C;qBACF;iBACF,CAAC,CAAA;YACJ,CAAC;SACF;KACF,CAAA;AACH,CAAC;AAED,qDAAqD;AACrD,SAAS,cAAc,CAAC,IAAkB;IACxC,MAAM,IAAI,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAA;IACxD,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAA;IAC1C,MAAM,IAAI,GAAG,kBAAkB,CAAC,IAAI,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;IACvD,0EAA0E;IAC1E,OAAO,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AAC1D,CAAC;AAQD;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAmB;IACpD,OAAO;QACL,IAAI,EAAE,eAAe;QACrB,SAAS,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,oBAAoB,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,SAAS,CAAC;QACtF,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,CACX,EAAE,KAAK,uBAAuB;YAC5B,CAAC,CAAC,2BAA2B,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI;gBAC9D,uBAAuB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;YACxD,CAAC,CAAC,SAAS;KAChB,CAAA;AACH,CAAC"}

package/dist/build/index.d.ts

@@ -0,0 +1,7 @@
+export * from './integration.js';
+export * from './plan.js';
+export * from './refusal.js';
+export * from './requirements.js';
+export * from './run-build.js';
+export * from './targets.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA"}

package/dist/build/index.js

@@ -0,0 +1,7 @@
+export * from './integration.js';
+export * from './plan.js';
+export * from './refusal.js';
+export * from './requirements.js';
+export * from './run-build.js';
+export * from './targets.js';
+//# sourceMappingURL=index.js.map

package/dist/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/build/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAA;AAChC,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,mBAAmB,CAAA;AACjC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA"}

package/dist/build/integration.d.ts

@@ -0,0 +1,25 @@
+import type { AstroIntegration } from 'astro';
+import type { RuntimeRequirement } from './requirements.js';
+import { type BuildTarget, type TargetCapability } from './targets.js';
+/**
+ * The target, as an Astro integration.
+ *
+ * One theme codebase, three adapters (ADR-0008). This integration is the only
+ * place that knows which of the three is being built: it sets Astro's `output`
+ * and refuses the build if any declared runtime need cannot be honoured. The
+ * adapter itself stays in the site's `astro.config`, because an adapter is a
+ * dependency of the *deployment*, not of Cogenta — bundling one would force
+ * every static site to install a Node server it will never run.
+ */
+export interface BuildTargetOptions {
+    readonly target: BuildTarget | TargetCapability;
+    /**
+     * The runtime needs of this build, or a function producing them.
+     *
+     * A function, because the route list generally comes from the content API
+     * and the caller should not have to await it before declaring integrations.
+     */
+    readonly requirements?: readonly RuntimeRequirement[] | (() => readonly RuntimeRequirement[] | Promise<readonly RuntimeRequirement[]>) | undefined;
+}
+export declare function cogentaBuildTarget(options: BuildTargetOptions): AstroIntegration;
+//# sourceMappingURL=integration.d.ts.map

package/dist/build/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../../src/build/integration.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAA;AAE7C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAC3D,OAAO,EAAE,KAAK,WAAW,EAAiB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAErF;;;;;;;;;GASG;AAEH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAAA;IAC/C;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,CAAC,EAClB,SAAS,kBAAkB,EAAE,GAC7B,CAAC,MAAM,SAAS,kBAAkB,EAAE,GAAG,OAAO,CAAC,SAAS,kBAAkB,EAAE,CAAC,CAAC,GAC9E,SAAS,CAAA;CACd;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,gBAAgB,CAyChF"}

package/dist/build/integration.js

@@ -0,0 +1,41 @@
+import { CogentaError } from '@cogenta/core';
+import { assertRuntimeSatisfied } from './refusal.js';
+import { resolveTarget } from './targets.js';
+export function cogentaBuildTarget(options) {
+    const target = typeof options.target === 'string' ? resolveTarget(options.target) : options.target;
+    return {
+        name: '@cogenta/render:build-target',
+        hooks: {
+            'astro:config:setup': async ({ updateConfig, logger }) => {
+                const declared = options.requirements;
+                const requirements = typeof declared === 'function' ? await declared() : (declared ?? []);
+                // Before anything else Astro might do, and before a single page is
+                // rendered. A refusal after nine hundred pages is a refusal that cost
+                // an hour to arrive at.
+                assertRuntimeSatisfied(target, requirements);
+                logger.info(`target ${target.target} — astro output: ${target.astroOutput}`);
+                updateConfig({ output: target.astroOutput });
+            },
+            'astro:config:done': ({ config }) => {
+                if (target.adapter === null || config.adapter !== undefined)
+                    return;
+                // Astro would fail on its own here, in its own words. Ours name the
+                // package to install, which is the difference between a fix and a
+                // search.
+                throw new CogentaError({
+                    code: 'BUILD_TARGET_UNKNOWN',
+                    message: `The ${target.label} target needs an Astro adapter, and astro.config declares none.`,
+                    hint: `Install ${target.adapter.recommended}${target.adapter.alternatives.length === 0
+                        ? ''
+                        : ` (or ${target.adapter.alternatives.join(', ')})`} and set it as \`adapter\` in astro.config. A static build needs no adapter — use --target static if that is what you meant.`,
+                    details: {
+                        target: target.target,
+                        recommended: target.adapter.recommended,
+                        alternatives: target.adapter.alternatives,
+                    },
+                });
+            },
+        },
+    };
+}
+//# sourceMappingURL=integration.js.map

package/dist/build/integration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.js","sourceRoot":"","sources":["../../src/build/integration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AAErD,OAAO,EAAoB,aAAa,EAAyB,MAAM,cAAc,CAAA;AA2BrF,MAAM,UAAU,kBAAkB,CAAC,OAA2B;IAC5D,MAAM,MAAM,GAAG,OAAO,OAAO,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAA;IAElG,OAAO;QACL,IAAI,EAAE,8BAA8B;QACpC,KAAK,EAAE;YACL,oBAAoB,EAAE,KAAK,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,EAAE;gBACvD,MAAM,QAAQ,GAAG,OAAO,CAAC,YAAY,CAAA;gBACrC,MAAM,YAAY,GAAG,OAAO,QAAQ,KAAK,UAAU,CAAC,CAAC,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;gBAEzF,mEAAmE;gBACnE,sEAAsE;gBACtE,wBAAwB;gBACxB,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;gBAE5C,MAAM,CAAC,IAAI,CAAC,UAAU,MAAM,CAAC,MAAM,oBAAoB,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;gBAC5E,YAAY,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,WAAW,EAAE,CAAC,CAAA;YAC9C,CAAC;YAED,mBAAmB,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE;gBAClC,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS;oBAAE,OAAM;gBACnE,oEAAoE;gBACpE,kEAAkE;gBAClE,UAAU;gBACV,MAAM,IAAI,YAAY,CAAC;oBACrB,IAAI,EAAE,sBAAsB;oBAC5B,OAAO,EAAE,OAAO,MAAM,CAAC,KAAK,iEAAiE;oBAC7F,IAAI,EAAE,WAAW,MAAM,CAAC,OAAO,CAAC,WAAW,GACzC,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,MAAM,KAAK,CAAC;wBACtC,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,QAAQ,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GACpD,8HAA8H;oBAC9H,OAAO,EAAE;wBACP,MAAM,EAAE,MAAM,CAAC,MAAM;wBACrB,WAAW,EAAE,MAAM,CAAC,OAAO,CAAC,WAAW;wBACvC,YAAY,EAAE,MAAM,CAAC,OAAO,CAAC,YAAY;qBAC1C;iBACF,CAAC,CAAA;YACJ,CAAC;SACF;KACF,CAAA;AACH,CAAC"}

package/dist/build/plan.d.ts

@@ -0,0 +1,41 @@
+import type { BlockRegistry } from '@cogenta/blocks';
+import type { ThemeManifest } from '../theme/manifest.js';
+import { type BuildRoute, type PluginRuntimeDeclaration, type RuntimeRequirement } from './requirements.js';
+import { type BuildTarget, type TargetCapability } from './targets.js';
+/**
+ * Deciding, before anything is rendered, how each route is produced.
+ *
+ * Two modes and no third: a route is either rendered ahead of time, or on
+ * request. Incremental rendering is explicitly out of this lot — the tag-based
+ * render cache has to be proven first — and leaving it out of the vocabulary
+ * here is what keeps it out of the build.
+ */
+export type RouteMode = 'prerendered' | 'on-demand';
+export interface PlannedRoute {
+    readonly path: string;
+    readonly mode: RouteMode;
+    /** Names of the elements that forced `on-demand`. Empty for a prerendered route. */
+    readonly needs: readonly string[];
+}
+export interface BuildPlan {
+    readonly target: TargetCapability;
+    readonly routes: readonly PlannedRoute[];
+    /** Every declared need in this build, static ones included. */
+    readonly requirements: readonly RuntimeRequirement[];
+}
+export interface PlanBuildInput {
+    readonly target: BuildTarget | TargetCapability;
+    readonly routes: readonly BuildRoute[];
+    readonly blocks: BlockRegistry;
+    readonly theme?: Pick<ThemeManifest, 'name' | 'runtime'> | undefined;
+    readonly plugins?: readonly PluginRuntimeDeclaration[] | undefined;
+}
+/**
+ * Plans a build, or refuses it.
+ *
+ * The refusal happens here rather than at render time on purpose: the operator
+ * learns that the build cannot work before a single page is produced, instead
+ * of after nine hundred of them.
+ */
+export declare function planBuild(input: PlanBuildInput): BuildPlan;
+//# sourceMappingURL=plan.d.ts.map

package/dist/build/plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/build/plan.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD,OAAO,EACL,KAAK,UAAU,EAEf,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAE,KAAK,WAAW,EAAiB,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAErF;;;;;;;GAOG;AAEH,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,WAAW,CAAA;AAEnD,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,oFAAoF;IACpF,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAClC;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAA;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAA;IACxC,+DAA+D;IAC/D,QAAQ,CAAC,YAAY,EAAE,SAAS,kBAAkB,EAAE,CAAA;CACrD;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,gBAAgB,CAAA;IAC/C,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAA;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,wBAAwB,EAAE,GAAG,SAAS,CAAA;CACnE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,CAuC1D"}

package/dist/build/plan.js

@@ -0,0 +1,48 @@
+import { assertRuntimeSatisfied } from './refusal.js';
+import { collectRuntimeRequirements, } from './requirements.js';
+import { resolveTarget } from './targets.js';
+/**
+ * Plans a build, or refuses it.
+ *
+ * The refusal happens here rather than at render time on purpose: the operator
+ * learns that the build cannot work before a single page is produced, instead
+ * of after nine hundred of them.
+ */
+export function planBuild(input) {
+    const target = typeof input.target === 'string' ? resolveTarget(input.target) : input.target;
+    const requirements = collectRuntimeRequirements({
+        routes: input.routes,
+        blocks: input.blocks,
+        theme: input.theme,
+        plugins: input.plugins,
+    });
+    assertRuntimeSatisfied(target, requirements);
+    // Site-wide needs — the theme, a plugin — put every route on demand: there
+    // is no page they do not touch.
+    const siteWideNeeds = requirements
+        .filter((requirement) => requirement.origin !== 'block' && requirement.runtime !== 'static')
+        .map((requirement) => `${requirement.origin} ${requirement.name}`);
+    const blockNeedsByRoute = new Map();
+    for (const requirement of requirements) {
+        if (requirement.origin !== 'block' || requirement.runtime === 'static')
+            continue;
+        for (const placement of requirement.placements) {
+            const existing = blockNeedsByRoute.get(placement.route);
+            const need = `block ${requirement.name}`;
+            if (existing === undefined)
+                blockNeedsByRoute.set(placement.route, [need]);
+            else if (!existing.includes(need))
+                existing.push(need);
+        }
+    }
+    const routes = input.routes.map((route) => {
+        const needs = [...siteWideNeeds, ...(blockNeedsByRoute.get(route.path) ?? [])];
+        // On a static target this list is always empty — the refusal above
+        // guarantees it — so the branch reads the same for the three targets.
+        return needs.length === 0
+            ? { path: route.path, mode: 'prerendered', needs: [] }
+            : { path: route.path, mode: 'on-demand', needs };
+    });
+    return { target, routes, requirements };
+}
+//# sourceMappingURL=plan.js.map

package/dist/build/plan.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.js","sourceRoot":"","sources":["../../src/build/plan.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAA;AACrD,OAAO,EAEL,0BAA0B,GAG3B,MAAM,mBAAmB,CAAA;AAC1B,OAAO,EAAoB,aAAa,EAAyB,MAAM,cAAc,CAAA;AAmCrF;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,KAAqB;IAC7C,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAA;IAE5F,MAAM,YAAY,GAAG,0BAA0B,CAAC;QAC9C,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;KACvB,CAAC,CAAA;IAEF,sBAAsB,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;IAE5C,2EAA2E;IAC3E,gCAAgC;IAChC,MAAM,aAAa,GAAG,YAAY;SAC/B,MAAM,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,KAAK,OAAO,IAAI,WAAW,CAAC,OAAO,KAAK,QAAQ,CAAC;SAC3F,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,GAAG,WAAW,CAAC,MAAM,IAAI,WAAW,CAAC,IAAI,EAAE,CAAC,CAAA;IAEpE,MAAM,iBAAiB,GAAG,IAAI,GAAG,EAAoB,CAAA;IACrD,KAAK,MAAM,WAAW,IAAI,YAAY,EAAE,CAAC;QACvC,IAAI,WAAW,CAAC,MAAM,KAAK,OAAO,IAAI,WAAW,CAAC,OAAO,KAAK,QAAQ;YAAE,SAAQ;QAChF,KAAK,MAAM,SAAS,IAAI,WAAW,CAAC,UAAU,EAAE,CAAC;YAC/C,MAAM,QAAQ,GAAG,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;YACvD,MAAM,IAAI,GAAG,SAAS,WAAW,CAAC,IAAI,EAAE,CAAA;YACxC,IAAI,QAAQ,KAAK,SAAS;gBAAE,iBAAiB,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,CAAC,CAAA;iBACrE,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACxD,CAAC;IACH,CAAC;IAED,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAgB,EAAE;QACtD,MAAM,KAAK,GAAG,CAAC,GAAG,aAAa,EAAE,GAAG,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAA;QAC9E,mEAAmE;QACnE,sEAAsE;QACtE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;YACvB,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,EAAE,EAAE;YACtD,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,CAAA;IACpD,CAAC,CAAC,CAAA;IAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,CAAA;AACzC,CAAC"}

package/dist/build/refusal.d.ts

@@ -0,0 +1,14 @@
+import { type RuntimeRequirement } from './requirements.js';
+import { type TargetCapability } from './targets.js';
+export declare function unsatisfiedRequirements(target: TargetCapability, requirements: readonly RuntimeRequirement[]): readonly RuntimeRequirement[];
+/** Targets that would carry every one of these needs. Feeds option 1. */
+export declare function targetsThatCanCarry(requirements: readonly RuntimeRequirement[], except: TargetCapability): readonly TargetCapability[];
+/**
+ * The message a human reads. Kept separate from the error so it can be
+ * asserted verbatim in a test: a refusal whose wording drifts is a refusal
+ * nobody can act on, and this project treats the wording as the deliverable.
+ */
+export declare function formatRuntimeRefusal(target: TargetCapability, unsatisfied: readonly RuntimeRequirement[]): string;
+/** Throws unless every declared runtime need is one this target can honour. */
+export declare function assertRuntimeSatisfied(target: TargetCapability, requirements: readonly RuntimeRequirement[]): void;
+//# sourceMappingURL=refusal.d.ts.map

package/dist/build/refusal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refusal.d.ts","sourceRoot":"","sources":["../../src/build/refusal.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,kBAAkB,EAAY,MAAM,mBAAmB,CAAA;AACrE,OAAO,EAAsC,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAmBxF,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,gBAAgB,EACxB,YAAY,EAAE,SAAS,kBAAkB,EAAE,GAC1C,SAAS,kBAAkB,EAAE,CAE/B;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,SAAS,kBAAkB,EAAE,EAC3C,MAAM,EAAE,gBAAgB,GACvB,SAAS,gBAAgB,EAAE,CAM7B;AAyCD;;;;GAIG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,gBAAgB,EACxB,WAAW,EAAE,SAAS,kBAAkB,EAAE,GACzC,MAAM,CAkCR;AAED,+EAA+E;AAC/E,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,gBAAgB,EACxB,YAAY,EAAE,SAAS,kBAAkB,EAAE,GAC1C,IAAI,CAoBN"}

package/dist/build/refusal.js

@@ -0,0 +1,110 @@
+import { CogentaError } from '@cogenta/core';
+import { routesOf } from './requirements.js';
+import { BUILD_TARGETS, TARGET_CAPABILITIES } from './targets.js';
+/**
+ * The refusal.
+ *
+ * This is the most important text in the build. It is read by someone who has
+ * just been told their deploy failed, usually late, usually without the
+ * architecture document open. So it names three things and nothing else:
+ * **what** element is at fault, **why** the target cannot carry it, and the
+ * **three** ways out — an edge function, an external service, or removal.
+ *
+ * What it deliberately does not do is degrade. Rendering the page without the
+ * block, or freezing a snapshot of it at build time, would ship a site that is
+ * quietly wrong; the operator would find out from a reader.
+ */
+/** Beyond this, placements are counted rather than listed: a wall of paths is not read. */
+const MAX_PLACEMENTS_SHOWN = 5;
+export function unsatisfiedRequirements(target, requirements) {
+    return requirements.filter((requirement) => !target.satisfies.includes(requirement.runtime));
+}
+/** Targets that would carry every one of these needs. Feeds option 1. */
+export function targetsThatCanCarry(requirements, except) {
+    return BUILD_TARGETS.map((name) => TARGET_CAPABILITIES[name]).filter((candidate) => candidate.target !== except.target &&
+        requirements.every((requirement) => candidate.satisfies.includes(requirement.runtime)));
+}
+/** Why a build-time-only target cannot carry this need, in the operator's terms. */
+function reasonFor(requirement) {
+    const what = requirement.runtime === 'server'
+        ? 'a server at request time'
+        : 'a function running at request time';
+    const noun = requirement.origin === 'block' ? 'This block' : `This ${requirement.origin}`;
+    return (`${noun} declares runtime: ${requirement.runtime}, meaning it needs ${what} — ` +
+        'it is rendered from data read when the page is asked for. A static build ' +
+        'renders every page once and then serves files, so the only thing it could ' +
+        'ship is a snapshot, wrong from the first content change after the build.');
+}
+function describePlacements(requirement) {
+    if (requirement.placements.length === 0) {
+        return 'Applies to the whole site.';
+    }
+    const shown = requirement.placements
+        .slice(0, MAX_PLACEMENTS_SHOWN)
+        .map((placement) => `${placement.route} (block ${placement.key})`);
+    const hidden = requirement.placements.length - shown.length;
+    const routes = routesOf(requirement).length;
+    const tail = hidden > 0 ? `, and ${hidden} more` : '';
+    return `Placed ${requirement.placements.length} time(s) on ${routes} route(s): ${shown.join(', ')}${tail}.`;
+}
+function removalFor(requirement) {
+    switch (requirement.origin) {
+        case 'block':
+            return `remove the "${requirement.name}" blocks listed above from their pages`;
+        case 'theme':
+            return `use a theme declaring runtime: static, or ask the author of "${requirement.name}" for one`;
+        case 'plugin':
+            return `uninstall the plugin "${requirement.name}"`;
+    }
+}
+/**
+ * The message a human reads. Kept separate from the error so it can be
+ * asserted verbatim in a test: a refusal whose wording drifts is a refusal
+ * nobody can act on, and this project treats the wording as the deliverable.
+ */
+export function formatRuntimeRefusal(target, unsatisfied) {
+    const capable = targetsThatCanCarry(unsatisfied, target);
+    const lines = [];
+    lines.push(`Build refused for the ${target.label} target: ${unsatisfied.length} element(s) need a runtime it cannot provide.`);
+    lines.push('');
+    for (const requirement of unsatisfied) {
+        lines.push(`  ${requirement.origin} "${requirement.name}" — runtime: ${requirement.runtime}`);
+        lines.push(`    Why: ${reasonFor(requirement)}`);
+        lines.push(`    Where: ${describePlacements(requirement)}`);
+        lines.push('');
+    }
+    lines.push('Three ways out, and there is no fourth:');
+    lines.push('');
+    lines.push(capable.length === 0
+        ? '  1. Serve these pages from a request-time target. No configured target carries these needs, which means the need itself has to change.'
+        : `  1. Build for a target that has a request: ${capable
+            .map((candidate) => `--target ${candidate.target}`)
+            .join(' or ')}. ` +
+            'Edge keeps the CDN in front and runs only these pages as functions; Node needs a process you keep alive.');
+    lines.push('  2. Move the work to an external service the browser calls after load — a search endpoint, a comments service, a listing API. The page stays static and the element is replaced by that integration.');
+    lines.push(`  3. Remove the element from this site: ${unsatisfied.map(removalFor).join('; ')}. The content itself is untouched either way.`);
+    return lines.join('\n');
+}
+/** Throws unless every declared runtime need is one this target can honour. */
+export function assertRuntimeSatisfied(target, requirements) {
+    const unsatisfied = unsatisfiedRequirements(target, requirements);
+    if (unsatisfied.length === 0)
+        return;
+    const runtimes = [...new Set(unsatisfied.map((requirement) => requirement.runtime))];
+    throw new CogentaError({
+        code: 'BUILD_RUNTIME_UNSATISFIED',
+        message: formatRuntimeRefusal(target, unsatisfied),
+        hint: 'Build for a target with a request (--target edge or --target node), replace the element with an external service, or remove it. The message above names each element and where it sits.',
+        details: {
+            target: target.target,
+            runtimes,
+            elements: unsatisfied.map((requirement) => ({
+                origin: requirement.origin,
+                name: requirement.name,
+                runtime: requirement.runtime,
+                routes: routesOf(requirement),
+            })),
+        },
+    });
+}
+//# sourceMappingURL=refusal.js.map

package/dist/build/refusal.js.map

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

package/dist/build/requirements.d.ts

@@ -0,0 +1,59 @@
+import type { BlockRegistry, BlockRuntime } from '@cogenta/blocks';
+import type { ThemeManifest } from '../theme/manifest.js';
+/**
+ * The runtime-needs manifest of a build (ADR-0004, contract D "Besoins
+ * runtime").
+ *
+ * Three kinds of thing declare a runtime need — a block, the theme, a plugin —
+ * and all three are collected here, in one list, before any target is
+ * considered. Collecting first and judging afterwards is deliberate: a build
+ * that failed on the first offending block would send an operator round the
+ * loop once per block, at 23:00, one `git push` at a time.
+ */
+/** Where a block that needs a runtime actually sits, so the message can say so. */
+export interface RuntimePlacement {
+    readonly route: string;
+    /** The block's `_key` — stable across reorders, so it stays quotable. */
+    readonly key: string;
+}
+export type RequirementOrigin = 'block' | 'theme' | 'plugin';
+export interface RuntimeRequirement {
+    readonly origin: RequirementOrigin;
+    readonly name: string;
+    readonly runtime: BlockRuntime;
+    /** Empty for a theme or a plugin: those apply to the whole site. */
+    readonly placements: readonly RuntimePlacement[];
+}
+/** The minimum a build needs to know about a placed block. */
+export interface BlockReference {
+    readonly _key: string;
+    readonly _type: string;
+}
+export interface BuildRoute {
+    /** The path a visitor requests, `/blog/hello`. */
+    readonly path: string;
+    readonly blocks: readonly BlockReference[];
+}
+export interface PluginRuntimeDeclaration {
+    readonly name: string;
+    readonly runtime: BlockRuntime;
+}
+export interface CollectRequirementsInput {
+    readonly routes: readonly BuildRoute[];
+    /** Resolves a block name to its definition. The vocabulary, plus what the site added. */
+    readonly blocks: BlockRegistry;
+    readonly theme?: Pick<ThemeManifest, 'name' | 'runtime'> | undefined;
+    readonly plugins?: readonly PluginRuntimeDeclaration[] | undefined;
+}
+/**
+ * Everything in this build that needs something at request time.
+ *
+ * `static` needs are included rather than filtered out here: a caller that
+ * wants only the problems asks for them against a target, and a caller that
+ * wants to display the site's runtime profile gets the whole picture. Filtering
+ * belongs to the judgement, not to the collection.
+ */
+export declare function collectRuntimeRequirements(input: CollectRequirementsInput): readonly RuntimeRequirement[];
+/** The routes a given requirement makes impossible to render ahead of a request. */
+export declare function routesOf(requirement: RuntimeRequirement): readonly string[];
+//# sourceMappingURL=requirements.d.ts.map

package/dist/build/requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/build/requirements.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAElE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AAEzD;;;;;;;;;GASG;AAEH,mFAAmF;AACnF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,yEAAyE;IACzE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAED,MAAM,MAAM,iBAAiB,GAAG,OAAO,GAAG,OAAO,GAAG,QAAQ,CAAA;AAE5D,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,oEAAoE;IACpE,QAAQ,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,CAAA;CACjD;AAED,8DAA8D;AAC9D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,kDAAkD;IAClD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,MAAM,EAAE,SAAS,cAAc,EAAE,CAAA;CAC3C;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;CAC/B;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,yFAAyF;IACzF,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAA;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC,GAAG,SAAS,CAAA;IACpE,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,wBAAwB,EAAE,GAAG,SAAS,CAAA;CACnE;AAED;;;;;;;GAOG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,wBAAwB,GAC9B,SAAS,kBAAkB,EAAE,CA8D/B;AAED,oFAAoF;AACpF,wBAAgB,QAAQ,CAAC,WAAW,EAAE,kBAAkB,GAAG,SAAS,MAAM,EAAE,CAI3E"}

package/dist/build/requirements.js

@@ -0,0 +1,74 @@
+import { CogentaError } from '@cogenta/core';
+/**
+ * Everything in this build that needs something at request time.
+ *
+ * `static` needs are included rather than filtered out here: a caller that
+ * wants only the problems asks for them against a target, and a caller that
+ * wants to display the site's runtime profile gets the whole picture. Filtering
+ * belongs to the judgement, not to the collection.
+ */
+export function collectRuntimeRequirements(input) {
+    const requirements = [];
+    if (input.theme !== undefined) {
+        requirements.push({
+            origin: 'theme',
+            name: input.theme.name,
+            runtime: input.theme.runtime,
+            placements: [],
+        });
+    }
+    for (const plugin of input.plugins ?? []) {
+        requirements.push({
+            origin: 'plugin',
+            name: plugin.name,
+            runtime: plugin.runtime,
+            placements: [],
+        });
+    }
+    // Grouped by block name, not by placement: "collectionList needs a server,
+    // and here are the eleven pages that place it" is one decision to take.
+    // Eleven separate lines would read as eleven problems.
+    const byBlock = new Map();
+    for (const route of input.routes) {
+        for (const block of route.blocks) {
+            const definition = input.blocks.get(block._type);
+            if (definition === undefined) {
+                // Not skipped: an unknown block is exactly the case where guessing a
+                // runtime would let a server-side block through a static build.
+                throw new CogentaError({
+                    code: 'BLOCK_UNKNOWN',
+                    message: `The block "${block._type}" on ${route.path} is not registered, so its runtime needs are unknown.`,
+                    hint: `Register it — with a fallback, as contract B requires — before building. Known blocks: ${input.blocks.names().join(', ')}.`,
+                    details: { block: block._type, key: block._key, route: route.path },
+                });
+            }
+            const entry = byBlock.get(definition.name);
+            if (entry === undefined) {
+                byBlock.set(definition.name, {
+                    runtime: definition.runtime,
+                    placements: [{ route: route.path, key: block._key }],
+                });
+            }
+            else {
+                entry.placements.push({ route: route.path, key: block._key });
+            }
+        }
+    }
+    for (const [name, entry] of byBlock) {
+        requirements.push({
+            origin: 'block',
+            name,
+            runtime: entry.runtime,
+            placements: entry.placements,
+        });
+    }
+    return requirements;
+}
+/** The routes a given requirement makes impossible to render ahead of a request. */
+export function routesOf(requirement) {
+    const routes = new Set();
+    for (const placement of requirement.placements)
+        routes.add(placement.route);
+    return [...routes];
+}
+//# sourceMappingURL=requirements.js.map

package/dist/build/requirements.js.map

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