//#region src/ai-editor/referenceLibrary.d.ts
interface ReferenceSummary {
  id: string;
  source: string;
  title: string;
  description: string;
  /** A display path relative to the source, not a browser-readable filesystem path. */
  sourcePath: string;
  tags: string[];
  thumbnailUrl?: string;
}
interface ReferenceSearchInput {
  query?: string;
  source?: string;
  limit?: number;
}
interface ReferenceSearchResult {
  records: ReferenceSummary[];
  warnings: string[];
}
interface ReferenceFile {
  path: string;
  language: string;
  content: string;
  truncated: boolean;
  /** UTF-8 byte offset of this source excerpt. */
  offset?: number;
  /** UTF-8 byte offset to request next; absent when this file is complete. */
  nextOffset?: number;
}
/** Design decisions for adaptation, separate from the reference's rendering implementation. */
interface ReferenceBrief {
  intent: string;
  steps: string[];
  palette: string[];
  typography: string[];
  layout: string[];
  motion: string[];
  transitions: string[];
  constraints: string[];
  timing?: Record<string, unknown>;
  sources: string[];
}
interface ReferenceDetail extends ReferenceSummary {
  brief?: ReferenceBrief;
  /** Entry points available for explicit implementation inspection. */
  sourceFiles?: string[];
  contentHash: string;
  metadata: Record<string, unknown>;
  recipe?: Record<string, unknown>;
  files: ReferenceFile[];
  relatedIds: string[];
  warnings: string[];
}
interface ReferenceStarterSummary extends ReferenceSummary {
  previewUrl?: string;
  durationMs: number;
  width: number;
  height: number;
}
interface ReferenceStarter {
  id: string;
  title: string;
  html: string;
  contentHash: string;
}
/** Customer-owned discovery and bounded source context; execution stays with the agent host. */
interface ReferenceLibrary {
  /** Optional authorable starting points, materialized without model inference. */
  exampleStarters?(): Promise<{
    records: ReferenceStarterSummary[];
    warnings: string[];
  }>;
  previewFile?(id: string): Promise<string | undefined>;
  starters?(): Promise<{
    records: ReferenceStarterSummary[];
    warnings: string[];
  }>;
  createStarter?(id: string): Promise<ReferenceStarter | undefined>;
  starterAsset?(id: string, kind: "image" | "font"): Promise<{
    bytes: Uint8Array;
    mimeType: string;
  } | undefined>;
  search(input?: ReferenceSearchInput): Promise<ReferenceSearchResult>;
  /** Read a compact brief by default. Request implementation only when a specific detail is missing. */
  get(id: string, options?: {
    includeSource?: boolean;
    filePath?: string;
    offset?: number;
  }): Promise<ReferenceDetail | undefined>;
  poster(id: string): Promise<{
    bytes: Uint8Array;
    mimeType: string;
  } | undefined>;
}
//#endregion
export { ReferenceBrief, ReferenceDetail, ReferenceFile, ReferenceLibrary, ReferenceSearchInput, ReferenceSearchResult, ReferenceSummary };
//# sourceMappingURL=referenceLibrary.d.ts.map