@gradial/aci 0.1.52-rc.8 → 0.1.52

package/dist/next/render.js

@@ -1,17 +1,27 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-export async function renderBlock(block, registry, extraProps) {
+export async function renderBlock(block, registry, key, extraProps) {
     const entry = registry.find((r) => r.id === block.component);
     if (!entry) {
-        return (_jsxs("div", { className: "mx-auto my-4 max-w-[var(--max-width-container)] rounded-card border-2 border-red-600 bg-red-50 px-5 py-4 font-mono text-sm leading-relaxed text-red-900", children: [_jsx("strong", { children: "Unknown block:" }), " ", _jsx("code", { children: block.component }), _jsx("br", {}), _jsxs("span", { className: "text-red-800 opacity-70", children: ["id: ", block.id] })] }, block.id));
+        return (_jsxs("div", { className: "mx-auto my-4 max-w-[var(--max-width-container)] rounded-card border-2 border-red-600 bg-red-50 px-5 py-4 font-mono text-sm leading-relaxed text-red-900", children: [_jsx("strong", { children: "Unknown block:" }), " ", _jsx("code", { children: block.component }), _jsx("br", {}), _jsxs("span", { className: "text-red-800 opacity-70", children: ["id: ", block.id] })] }, key));
     }
     const Component = entry.component;
     const hasBlockSlots = !!entry.contract.blockSlots;
-    const componentProps = { ...block.props, ...extraProps };
+    // sdk I-19 (ADR 0051): root identity props are applied last so neither
+    // content props nor tenant slotProps can overwrite them.
+    const componentProps = {
+        ...block.props,
+        ...extraProps,
+        'data-aci-block': block.id,
+        'data-aci-component': block.component,
+    };
     if (hasBlockSlots) {
         componentProps.renderChildren = (blocks) => renderBlocks(blocks, registry, extraProps);
     }
-    return _jsx(Component, { ...componentProps }, block.id);
+    return _jsx(Component, { ...componentProps }, key);
 }
 export async function renderBlocks(blocks, registry, extraProps) {
-    return Promise.all(blocks.map((block) => renderBlock(block, registry, extraProps)));
+    // Sibling keys are index+id composites: one fragment placed twice repeats
+    // its authored block id, and React reconciliation keys must be unique per
+    // sibling (ADR 0051 covers analytics identity, not reconciliation).
+    return Promise.all(blocks.map((block, index) => renderBlock(block, registry, `${index}:${block.id}`, extraProps)));
 }

package/dist/next/server.d.ts

@@ -3,7 +3,6 @@ import { type ReleaseObjectReader } from '../providers/object.js';
 import type { RenderInput } from '../content/types.js';
 export { FragmentNotFoundError, PageNotFoundError, LayoutNotFoundError };
 export interface FetchConfig {
-    siteId?: string;
     bucket?: string;
     keyPrefix?: string;
     region?: string;
@@ -13,8 +12,6 @@ export interface FetchConfig {
     roleArn?: string;
     endpoint?: string;
     releaseId?: string;
-    edgeConfig?: string;
-    deploymentId?: string;
 }
 export interface ServerRenderInput<TPage, TSite extends SiteConfig = SiteConfig> {
     route: string;
@@ -54,4 +51,13 @@ export declare class DamAssetNotFoundError extends Error {
     constructor(assetPath: string, cause?: unknown);
 }
 export declare function getDamAssetResponse(assetPath: string, config?: FetchConfig): Promise<Response>;
+/**
+ * The release a read uses: the caller's explicit release (the catch-all passes
+ * the one its `/__r/{releaseId}` path names), else the release the hosting
+ * router dispatched this request to (release-context.ts — the same release,
+ * for code such as the not-found seat that receives no route params), else a
+ * process pin. A routed release outranks the pin because the catch-all of the
+ * same request renders the routed release regardless of the pin. There is no
+ * further source: without one of the three the read fails.
+ */
 export declare function resolveReleaseId(config?: FetchConfig): Promise<string>;

package/dist/next/server.js

@@ -7,8 +7,7 @@ import { S3ContentProvider } from '../providers/s3.js';
 import { VercelReleaseObjectReader } from '../providers/vercel-object-reader.js';
 import { GRADIAL_RENDER_INPUT_HEADER, getPendingRenderInput } from '../runtime/page.js';
 import { attachRenderProofReceipt, selectVerifiedPage, } from '../internal/render-proof.js';
-import { getUncachedEdgeConfigValue } from './edge-config.js';
-import { activeReleaseV1Key, clampDeploymentCompatibleReleaseV1, decodeActiveReleaseV1, decodeDeploymentCompatibilityV1, deploymentCompatibilityKey, } from './vercel-edge-projection-v1.js';
+import { routedRelease } from './release-context.js';
 export { FragmentNotFoundError, PageNotFoundError, LayoutNotFoundError };
 const releaseObjectReaderSymbol = Symbol.for('@gradial/aci.release-object-reader');
 const objectProviders = new WeakMap();
@@ -44,8 +43,9 @@ export async function getFragment(name, config = {}) {
     const runtimeInput = await getPageRuntimeRenderInput();
     if (runtimeInput) {
         const fragments = runtimeInput.fragments || {};
-        if (name in fragments)
+        if (Object.hasOwn(fragments, name))
             return fragments[name];
+        throw new FragmentNotFoundError(name, new Error('fragment is not bound by the selected page'));
     }
     const provider = await resolveProviderWithFallback(config);
     return await provider.getFragment(name);
@@ -291,15 +291,25 @@ async function safeResponseText(res) {
         return '';
     }
 }
+/**
+ * The release a read uses: the caller's explicit release (the catch-all passes
+ * the one its `/__r/{releaseId}` path names), else the release the hosting
+ * router dispatched this request to (release-context.ts — the same release,
+ * for code such as the not-found seat that receives no route params), else a
+ * process pin. A routed release outranks the pin because the catch-all of the
+ * same request renders the routed release regardless of the pin. There is no
+ * further source: without one of the three the read fails.
+ */
 export async function resolveReleaseId(config = {}) {
     if (config.releaseId)
         return config.releaseId;
+    const routed = await routedRelease();
+    if (routed.releaseId)
+        return routed.releaseId;
     if (process.env.ACI_RELEASE_ID)
         return process.env.ACI_RELEASE_ID;
-    const activeReleaseId = await activeReleaseFromEdgeConfig(config);
-    if (activeReleaseId)
-        return activeReleaseId;
-    throw new Error('ACI release ID is required. Pass releaseId from the release-scoped route or set ACI_RELEASE_ID.');
+    throw new Error('ACI release ID is required. Pass releaseId from the release-scoped route or set ACI_RELEASE_ID.'
+        + (routed.rejected ? ` The request carried a release context that was not used: ${routed.rejected}.` : ''));
 }
 async function resolveS3Provider(config) {
     const releaseId = await resolveReleaseId(config);
@@ -386,34 +396,9 @@ function sameS3ProviderConfig(left, right) {
         && left.roleArn === right.roleArn
         && left.endpoint === right.endpoint;
 }
-async function activeReleaseFromEdgeConfig(config) {
-    const edgeConfig = config.edgeConfig || process.env.EDGE_CONFIG || '';
-    const siteId = config.siteId || process.env.ACI_SITE_ID || '';
-    if (!edgeConfig || !siteId)
-        return '';
-    const active = await activeReleasePointer(edgeConfig, siteId);
-    if (active == null)
-        return '';
-    const deploymentId = config.deploymentId || process.env.VERCEL_DEPLOYMENT_ID || '';
-    if (!deploymentId)
-        return active.releaseId;
-    const compatibilityValue = await getEdgeConfigValue(edgeConfig, deploymentCompatibilityKey(siteId, deploymentId));
-    if (compatibilityValue == null)
-        return active.releaseId;
-    return clampDeploymentCompatibleReleaseV1(active, decodeDeploymentCompatibilityV1(compatibilityValue));
-}
-async function getEdgeConfigValue(edgeConfig, key) {
-    return getUncachedEdgeConfigValue(edgeConfig, key);
-}
 function releaseKey(config, releaseId) {
     return joinKey(config.keyPrefix || process.env.ACI_S3_KEY_PREFIX || '', 'releases', releaseId);
 }
-async function activeReleasePointer(edgeConfig, siteId) {
-    const value = await getEdgeConfigValue(edgeConfig, activeReleaseV1Key(siteId));
-    if (value == null)
-        return null;
-    return decodeActiveReleaseV1(value);
-}
 class InjectedReaderProvider {
     releaseId;
     reader;

package/dist/preview/core.d.ts

@@ -37,6 +37,7 @@ export interface PreviewCookie {
 export declare const PREVIEW_TOKEN_COOKIE = "aci_preview";
 export declare const PREVIEW_RELEASE_COOKIE = "aci_preview_release";
 export declare function validatePreviewToken(token: string, signKey: string): Promise<PreviewClaims | null>;
+export declare function parseCookies(header: string): Map<string, string>;
 export declare function extractPreviewToken(source: PreviewTokenSource): string | undefined;
 export declare function previewSignKey(): string | undefined;
 export declare function resolvePreviewContext(options: PreviewResolveOptions): Promise<PreviewContext>;

package/dist/preview/core.js

@@ -18,6 +18,33 @@ export async function validatePreviewToken(token, signKey) {
         return null;
     }
 }
+// parseCookies is the SDK-side raw Cookie-header parser for callers that only
+// have the header string (the Astro integration; Next hands us its own parsed
+// cookies). It is deliberately not the canonical edge parser
+// (internal/domain/edge/identity.ts parseCookieHeader): SDK source cannot
+// import internal/domain/edge — assemble-dist re-roots the emitted tree and
+// the relative specifier depth changes — and framework cookie writers
+// URI-encode values, so this one decodes them (falling back to the raw value
+// on a malformed escape rather than throwing mid-request).
+export function parseCookies(header) {
+    const cookies = new Map();
+    for (const part of header.split(';')) {
+        const separator = part.indexOf('=');
+        if (separator < 0)
+            continue;
+        const name = part.slice(0, separator).trim();
+        if (!name)
+            continue;
+        const value = part.slice(separator + 1).trim();
+        try {
+            cookies.set(name, decodeURIComponent(value));
+        }
+        catch {
+            cookies.set(name, value);
+        }
+    }
+    return cookies;
+}
 export function extractPreviewToken(source) {
     const query = source.query?.get('preview_token');
     if (query)

package/dist/react/VideoPlayer.d.ts

@@ -11,21 +11,20 @@ export interface VideoPlayerProps extends Omit<VideoHTMLAttributes<HTMLVideoElem
  */
 export declare function VideoPlayer({ video, ...attrs }: VideoPlayerProps): import("react").DetailedReactHTMLElement<{
     id?: string | undefined | undefined;
+    title: string;
     role?: import("react").AriaRole | undefined;
     prefix?: string | undefined | undefined;
-    title: string;
     rel?: string | undefined | undefined;
     content?: string | undefined | undefined;
     slot?: string | undefined | undefined;
     style?: import("react").CSSProperties | undefined;
     dir?: string | undefined | undefined;
     hidden?: boolean | undefined | undefined;
+    children?: import("react").ReactNode;
     dangerouslySetInnerHTML?: {
         __html: string | TrustedHTML;
     } | undefined | undefined;
-    children?: import("react").ReactNode;
     className?: string | undefined | undefined;
-    lang?: string | undefined | undefined;
     crossOrigin?: "" | "anonymous" | "use-credentials" | undefined;
     defaultChecked?: boolean | undefined | undefined;
     defaultValue?: string | number | readonly string[] | undefined;
@@ -38,6 +37,7 @@ export declare function VideoPlayer({ video, ...attrs }: VideoPlayerProps): impo
     contextMenu?: string | undefined | undefined;
     draggable?: (boolean | "true" | "false") | undefined;
     enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+    lang?: string | undefined | undefined;
     nonce?: string | undefined | undefined;
     spellCheck?: (boolean | "true" | "false") | undefined;
     tabIndex?: number | undefined | undefined;

package/dist/react/index.d.ts

@@ -13,6 +13,7 @@ export interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 's
 }
 export declare function Image({ image, value, ...attrs }: ImageProps): import("react").DetailedReactHTMLElement<import("../types/image.js").ImageAttrs, HTMLElement> | import("react").DetailedReactHTMLElement<{
     id?: string | undefined | undefined;
+    title?: string | undefined | undefined;
     role?: import("react").AriaRole | undefined;
     prefix?: string | undefined | undefined;
     width?: number | string | undefined | undefined;
@@ -21,7 +22,6 @@ export declare function Image({ image, value, ...attrs }: ImageProps): import("r
     srcSet?: string | undefined | undefined;
     loading?: "eager" | "lazy" | undefined | undefined;
     decoding?: "async" | "auto" | "sync" | undefined | undefined;
-    title?: string | undefined | undefined;
     rel?: string | undefined | undefined;
     content?: string | undefined | undefined;
     referrerPolicy?: import("react").HTMLAttributeReferrerPolicy | undefined;
@@ -29,12 +29,11 @@ export declare function Image({ image, value, ...attrs }: ImageProps): import("r
     style?: import("react").CSSProperties | undefined;
     dir?: string | undefined | undefined;
     hidden?: boolean | undefined | undefined;
+    children?: ReactNode;
     dangerouslySetInnerHTML?: {
         __html: string | TrustedHTML;
     } | undefined | undefined;
-    children?: ReactNode;
     className?: string | undefined | undefined;
-    lang?: string | undefined | undefined;
     crossOrigin?: "" | "anonymous" | "use-credentials" | undefined;
     fetchPriority?: "high" | "low" | "auto" | undefined | undefined;
     useMap?: string | undefined | undefined;
@@ -49,6 +48,7 @@ export declare function Image({ image, value, ...attrs }: ImageProps): import("r
     contextMenu?: string | undefined | undefined;
     draggable?: (boolean | "true" | "false") | undefined;
     enterKeyHint?: "enter" | "done" | "go" | "next" | "previous" | "search" | "send" | undefined | undefined;
+    lang?: string | undefined | undefined;
     nonce?: string | undefined | undefined;
     spellCheck?: (boolean | "true" | "false") | undefined;
     tabIndex?: number | undefined | undefined;

package/dist/registry.d.ts

@@ -1,4 +1,4 @@
-import type { ComponentContract, InferComponentProps } from './types/component.js';
+import type { ComponentContract, ComponentContractID, InferComponentProps } from './types/component.js';
 export type AnyComponent = (abstract new (...args: any[]) => any) | ((props: any) => any) | Record<string, any>;
 export interface RegistryEntry {
     id: string;
@@ -6,7 +6,9 @@ export interface RegistryEntry {
     contract: ComponentContract;
 }
 export type Registry = readonly RegistryEntry[];
-type ValidatedEntry<T> = T extends readonly [infer C extends ComponentContract, infer Comp] ? Comp extends (props: InferComponentProps<C>) => any ? T : Comp extends (props: InferComponentProps<C> & infer _) => any ? T : Comp extends new (props: InferComponentProps<C>, ...args: any[]) => any ? T : Comp extends Record<string, any> ? T : never : never;
+type ValidatedEntry<T> = T extends readonly [infer C extends ComponentContract, infer Comp] ? Comp extends (props: InferComponentProps<C>) => any ? RootIdentityChecked<C, Comp, T> : Comp extends (props: InferComponentProps<C> & infer _) => any ? RootIdentityChecked<C, Comp, T> : Comp extends new (props: InferComponentProps<C>, ...args: any[]) => any ? RootIdentityChecked<C, Comp, T> : Comp extends Record<string, any> ? T : never : never;
+type DeclaredProps<Comp> = Comp extends (props: infer P) => any ? P : Comp extends abstract new (props: infer P, ...args: any[]) => any ? P : Record<string, any>;
+type RootIdentityChecked<C extends ComponentContract, Comp, T> = 'data-aci-block' extends keyof DeclaredProps<Comp> ? 'data-aci-component' extends keyof DeclaredProps<Comp> ? T : `${ComponentContractID<C>}: props type must extend RootIdentityProps from @gradial/aci` : `${ComponentContractID<C>}: props type must extend RootIdentityProps from @gradial/aci`;
 type ValidatedEntries<T extends readonly (readonly [ComponentContract, AnyComponent])[]> = {
     [K in keyof T]: ValidatedEntry<T[K]>;
 };

package/dist/testing/conformance/checks.d.ts

@@ -1,4 +1,4 @@
-import type { ConformanceCheckResult, ConformanceCheckName, ConformanceContext } from './types.js';
+import type { ConformanceCheckResult, ConformanceCheckName, ConformanceContext, ConformanceCheckFn } from './types.js';
 export declare function checkConfig(ctx: ConformanceContext): ConformanceCheckResult[];
 export declare function checkRegistry(ctx: ConformanceContext): ConformanceCheckResult[];
 export declare function checkPageEntry(ctx: ConformanceContext): ConformanceCheckResult[];
@@ -9,4 +9,4 @@ export declare function checkNoRequestTimeAssetRoute(ctx: ConformanceContext): C
 export declare function checkBuildSucceeds(ctx: ConformanceContext): ConformanceCheckResult[];
 export declare function checkContentCompile(ctx: ConformanceContext): ConformanceCheckResult[];
 export declare function checkSdkVersion(ctx: ConformanceContext): ConformanceCheckResult[];
-export declare const CHECK_REGISTRY: Record<ConformanceCheckName, (ctx: ConformanceContext) => ConformanceCheckResult[]>;
+export declare const CHECK_REGISTRY: Record<ConformanceCheckName, ConformanceCheckFn>;

package/dist/testing/conformance/checks.js

@@ -9,6 +9,7 @@
 import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { join, relative } from 'node:path';
 import { execSync } from 'node:child_process';
+import { checkRootIdentity } from './root-identity.js';
 // ---------------------------------------------------------------------------
 // Helpers
 // ---------------------------------------------------------------------------
@@ -445,4 +446,5 @@ export const CHECK_REGISTRY = {
     buildSucceeds: checkBuildSucceeds,
     contentCompile: checkContentCompile,
     sdkVersion: checkSdkVersion,
+    rootIdentity: checkRootIdentity,
 };

package/dist/testing/conformance/index.d.ts

@@ -1,3 +1,4 @@
 export { conformancePreset, runConformanceChecks } from './preset.js';
 export { checkConfig, checkRegistry, checkPageEntry, checkMiddleware, checkNoFileContentProvider, checkNoCustomContent, checkNoRequestTimeAssetRoute, checkBuildSucceeds, checkContentCompile, checkSdkVersion, CHECK_REGISTRY, } from './checks.js';
+export { checkRootIdentity, findRootIdentityFailures, formatRootIdentityFailures, astroAuthoredBlocks, type RootIdentityFailure, } from './root-identity.js';
 export type { ConformanceFramework, ConformanceCheckName, ConformancePresetOptions, ConformanceCheckResult, ConformanceResult, ConformanceContext, ConformanceCheckFn, } from './types.js';

package/dist/testing/conformance/index.js

@@ -1,2 +1,3 @@
 export { conformancePreset, runConformanceChecks } from './preset.js';
 export { checkConfig, checkRegistry, checkPageEntry, checkMiddleware, checkNoFileContentProvider, checkNoCustomContent, checkNoRequestTimeAssetRoute, checkBuildSucceeds, checkContentCompile, checkSdkVersion, CHECK_REGISTRY, } from './checks.js';
+export { checkRootIdentity, findRootIdentityFailures, formatRootIdentityFailures, astroAuthoredBlocks, } from './root-identity.js';

package/dist/testing/conformance/next-stubs.d.ts

@@ -0,0 +1,6 @@
+export declare function resolve(specifier: string, context: unknown, nextResolve: (specifier: string, context: unknown) => Promise<{
+    url: string;
+}>): Promise<{
+    url: string;
+    shortCircuit?: boolean;
+}>;

package/dist/testing/conformance/next-stubs.js

@@ -0,0 +1,9 @@
+// Node module customization hook for the rootIdentity check: outside Next's
+// bundler, `next/link` and `next/image` resolve to CommonJS interop objects
+// that react-dom/server cannot render. Swap them for plain-element stubs.
+export async function resolve(specifier, context, nextResolve) {
+    if (specifier === 'next/link' || specifier === 'next/image') {
+        return { url: new URL(`./stubs/${specifier.replace('/', '-')}.js`, import.meta.url).href, shortCircuit: true };
+    }
+    return nextResolve(specifier, context);
+}

package/dist/testing/conformance/preset.d.ts

@@ -2,9 +2,10 @@ import type { ConformancePresetOptions, ConformanceResult } from './types.js';
 /**
  * Run all resolved checks and return an aggregate result.
  * This is the programmatic API — call it directly if you don't want the
- * node:test integration.
+ * node:test integration. It is async: the rootIdentity check renders
+ * components, so `await` the result before reading `.passed`.
  */
-export declare function runConformanceChecks(options: ConformancePresetOptions): ConformanceResult;
+export declare function runConformanceChecks(options: ConformancePresetOptions): Promise<ConformanceResult>;
 /**
  * Register a conformance test suite using node:test.
  *

package/dist/testing/conformance/preset.js

@@ -10,6 +10,7 @@
  * conformancePreset({
  *   framework: 'next',
  *   siteId: 'site_mysite',
+ *   registry: 'src/cms/registry.ts',
  * });
  * ```
  *
@@ -29,6 +30,9 @@ const ALL_CHECKS = [
     'noCustomContent',
     'noRequestTimeAssetRoute',
     'sdkVersion',
+    // Renders every registered component (ADR 0051); on Astro it scans dist/,
+    // building first when absent.
+    'rootIdentity',
     // Expensive checks last — these shell out
     'contentCompile',
     'buildSucceeds',
@@ -51,19 +55,21 @@ function resolveChecks(input) {
 /**
  * Run all resolved checks and return an aggregate result.
  * This is the programmatic API — call it directly if you don't want the
- * node:test integration.
+ * node:test integration. It is async: the rootIdentity check renders
+ * components, so `await` the result before reading `.passed`.
  */
-export function runConformanceChecks(options) {
+export async function runConformanceChecks(options) {
     const ctx = {
         framework: options.framework,
         siteId: options.siteId ?? '',
         rootDir: options.rootDir || process.cwd(),
+        registry: options.registry,
     };
     const checks = resolveChecks(options.checks);
-    const allResults = checks.flatMap((name) => {
-        const checkFn = CHECK_REGISTRY[name];
-        return checkFn(ctx);
-    });
+    const allResults = [];
+    for (const name of checks) {
+        allResults.push(...(await CHECK_REGISTRY[name](ctx)));
+    }
     const failures = allResults.filter((r) => !r.ok);
     return {
         passed: failures.length === 0,
@@ -84,11 +90,12 @@ export function conformancePreset(options) {
             framework: options.framework,
             siteId: options.siteId ?? '',
             rootDir: options.rootDir || process.cwd(),
+            registry: options.registry,
         };
         for (const checkName of checks) {
-            await t.test(checkName, () => {
+            await t.test(checkName, async () => {
                 const checkFn = CHECK_REGISTRY[checkName];
-                const results = checkFn(ctx);
+                const results = await checkFn(ctx);
                 for (const result of results) {
                     assert.ok(result.ok, `${result.label}${result.detail ? ` (${result.detail})` : ''}`);
                 }

package/dist/testing/conformance/root-identity.d.ts

@@ -0,0 +1,31 @@
+import type { ConformanceCheckResult, ConformanceContext } from './types.js';
+import type { Registry } from '../../registry.js';
+import type { KernelPageBlock } from '../../content/types.js';
+export interface RootIdentityFailure {
+    component: string;
+    file?: string;
+    missing: string[];
+}
+/** Minimal React surface the renderer needs; injected so tests can pass fakes. */
+export interface ReactRuntime {
+    renderToStaticMarkup: (element: unknown) => string;
+}
+/**
+ * Render each block through the SDK renderer and report every component
+ * whose root element lacks the identity attributes. `blocks` are the blocks
+ * to exercise; registry entries not covered by a block are probed with empty
+ * props so an unused component cannot hide a forgotten spread.
+ */
+export declare function findRootIdentityFailures(registry: Registry, blocks: readonly KernelPageBlock[], react: ReactRuntime, fileFor?: (component: string) => string | undefined): Promise<RootIdentityFailure[]>;
+/** The failure message: one line of what, the list, one line of fix. */
+export declare function formatRootIdentityFailures(failures: readonly RootIdentityFailure[], framework: 'next' | 'astro'): string;
+export declare function checkRootIdentity(ctx: ConformanceContext): Promise<ConformanceCheckResult[]>;
+/**
+ * Every block the Astro scan must find in dist/: page blocks by their own id,
+ * plus fragments (navbar, footer) by fragment id, which is the block id the
+ * renderer synthesizes when a layout slot default places them.
+ */
+export declare function astroAuthoredBlocks(contentDir: string): Array<{
+    id: string;
+    component: string;
+}>;