import type { JsonValue, ManifestAttribute, ManifestConstraints, ManifestDocument } from '../migration/migration-types.js';
/**
 * Default placeholder copy used for generated compound child body fields.
 */
export declare const DEFAULT_COMPOUND_CHILD_BODY_PLACEHOLDER = "Add supporting details for this internal item.";
type StarterManifestSourceType = NonNullable<ManifestAttribute['wp']['type']>;
type WordPressAttributeSource = NonNullable<ManifestAttribute['wp']['source']>;
interface StarterManifestAttributeDefinition {
    constraints?: Partial<ManifestConstraints>;
    defaultValue?: JsonValue;
    enumValues?: Array<string | number | boolean> | null;
    kind: ManifestAttribute['ts']['kind'];
    required: boolean;
    selector?: string | null;
    source?: WordPressAttributeSource | null;
    sourceType: StarterManifestSourceType;
}
interface BlockJsonAttributeDefinition {
    defaultValue?: JsonValue;
    enumValues?: Array<string | number | boolean> | null;
    selector?: string;
    source?: WordPressAttributeSource;
    type: StarterManifestSourceType;
}
export interface AttributeDescription {
    lines: string[];
}
/**
 * Emitted attribute metadata shared between block.json, manifest, and type emitters.
 */
export interface EmittedAttributeDefinition {
    blockJson: BlockJsonAttributeDefinition;
    description?: AttributeDescription;
    manifest: StarterManifestAttributeDefinition;
    name: string;
    optional: boolean;
    typeExpression: string;
}
type BuiltInAttributeValueResolver<TContext, TValue> = TValue | ((context: TContext) => TValue);
export interface BuiltInAttributeTemplateSpec<TContext> {
    attributeType: 'boolean' | 'number' | 'string';
    blockJsonDefaultValue?: BuiltInAttributeValueResolver<TContext, JsonValue | undefined>;
    constraints?: BuiltInAttributeValueResolver<TContext, Partial<ManifestConstraints> | undefined>;
    defaultValue?: BuiltInAttributeValueResolver<TContext, JsonValue | undefined>;
    description?: BuiltInAttributeValueResolver<TContext, AttributeDescription | undefined>;
    enumValues?: BuiltInAttributeValueResolver<TContext, Array<string | number | boolean> | null | undefined>;
    manifestDefaultValue?: BuiltInAttributeValueResolver<TContext, JsonValue | undefined>;
    name: string;
    optional: boolean;
    selector?: BuiltInAttributeValueResolver<TContext, string | null | undefined>;
    source?: BuiltInAttributeValueResolver<TContext, WordPressAttributeSource | null | undefined>;
    typeExpression: BuiltInAttributeValueResolver<TContext, string>;
}
export declare function describe(...lines: string[]): AttributeDescription;
export declare function buildAttributesFromSpecs<TContext>(specs: readonly BuiltInAttributeTemplateSpec<TContext>[], context: TContext): EmittedAttributeDefinition[];
/**
 * Builds the manifest document for a generated built-in block artifact.
 *
 * @param sourceType Generated TypeScript source type name referenced by the manifest.
 * @param attributes Emitted attribute definitions used to populate the manifest.
 * @returns A starter manifest document for the generated block.
 */
export declare function buildManifestDocument(sourceType: string, attributes: readonly EmittedAttributeDefinition[]): ManifestDocument;
/**
 * Builds the block.json attributes object for a generated built-in block artifact.
 *
 * @param attributes Emitted attribute definitions used to populate block.json.
 * @returns A block.json-compatible attributes record.
 */
export declare function buildBlockJsonAttributes(attributes: readonly EmittedAttributeDefinition[]): Record<string, Record<string, unknown>>;
/**
 * Builds the canonical block preview examples derived from emitted defaults,
 * enums, and supported scalar constraints.
 */
export declare function buildBlockJsonExampleAttributes(attributes: readonly EmittedAttributeDefinition[]): Record<string, JsonValue>;
export {};