/**
 * Plugin API types.
 */

import type { Logger } from "../logging/logger";
import type { Site, Collection, Entry, Block } from "../core/model";
import Handlebars from "handlebars";
import type { WebetteEnv } from "../config/env";

export type PluginContext = {
  rootDir: string;
  env: WebetteEnv;
  logger: Logger;
  readContent: boolean;
  exportDir: string;
  pluginId: string;
  addExpectedOutput: (relativePath: string) => void;
  addExpectedDir: (relativeDir: string) => void;
};

export interface Plugin {
  // Optional identifier; if missing we derive one from the filename
  pluginId?: string;
  // Called after env/site load, before scanning
  onInit?: (ctx: PluginContext) => Promise<void> | void;
  // Called after scan/routes, before content resolution
  onScan?: (site: Site, ctx: PluginContext) => Promise<Site | void> | Site | void;
  // Called after content resolution, before timestamps/export
  onResolved?: (site: Site, ctx: PluginContext) => Promise<Site | void> | Site | void;
  // Per-block mutation after resolution (subBlocks handled recursively)
  transformBlock?: (block: Block, ctx: PluginContext & { entry: Entry; collection: Collection }) => Promise<Block | void> | Block | void;
  // Per-entry mutation after blocks
  transformEntry?: (entry: Entry, ctx: PluginContext & { collection: Collection }) => Promise<Entry | void> | Entry | void;
  // Template extensions (helpers/partials/layouts)
  extendTemplates?: (hb: typeof Handlebars, ctx: PluginContext) => Promise<void> | void;
}

export type LoadedPlugin = Plugin & { pluginId: string };