/**
 * Helpers for authoring projection descriptor meta beside each projection.
 */
import type { ProjectionDescriptorMeta, ProjectionOptionDescriptor, ProjectionSurfaceMeta } from './descriptor-types.js';
/** Aggregate surface: whole IR, no entity/command selection. */
export declare function aggregateSurface(id: string): ProjectionSurfaceMeta;
/** Entity-scoped surface that errors without `request.entity`. */
export declare function entitySurface(id: string): ProjectionSurfaceMeta;
/** Command-scoped surface that errors without entity + command. */
export declare function commandSurface(id: string): ProjectionSurfaceMeta;
/** Configuration-driven surface (options bag selects work, not request.entity). */
export declare function configurationSurface(id: string): ProjectionSurfaceMeta;
/** Optional entity filter on an otherwise aggregate surface. */
export declare function optionalEntitySurface(id: string): ProjectionSurfaceMeta;
/** Optional command filter (zod.command-style). */
export declare function optionalCommandSurface(id: string): ProjectionSurfaceMeta;
export declare function optionalOption(name: string, type: ProjectionOptionDescriptor['type'], extras?: Partial<Omit<ProjectionOptionDescriptor, 'name' | 'type' | 'required'>>): ProjectionOptionDescriptor;
export declare function requiredOption(name: string, type: ProjectionOptionDescriptor['type'], extras?: Partial<Omit<ProjectionOptionDescriptor, 'name' | 'type' | 'required'>>): ProjectionOptionDescriptor;
/**
 * Meta for projections whose generate() scopes are not yet audited.
 * Descriptor exists (parity) but `safelyInvokable` stays false.
 */
export declare function unresolvedDescriptorMeta(surfaceIds: readonly string[], artifactCategories: readonly string[]): ProjectionDescriptorMeta;
//# sourceMappingURL=descriptor-helpers.d.ts.map