type FrameMasterPlugin<
  Options extends PluginOptions = Required<PluginOptions>,
> = Required<{
  name: string; // Unique plugin name
  version: string; // Semver version
}> &
  Partial<{
    router: RouterPlugin; // Request handling hooks
    serverStart: ServerStart; // Server startup hooks
    priority: number; // Execution order (0 = highest)
    requirement: Requirement; // Dependencies & version requirements
    runtimePlugins: Bun.BunPlugin[]; // Bun plugins for runtime
    directives: Directive[]; // File directives
    serverConfig: ServerConfig; // Server configuration overrides
    fileSystemWatchDir: string[]; // Directories to watch (dev only)
    onFileSystemChange: FileChangeCallback; // File change handler
    websocket: WebSocketHandlers; // WebSocket event handlers
    build: BuildOptionsPlugin; // Build hooks
    cli: CLIExtension; // CLI commands
  }>;

type RouterPlugin = Partial<{
  // Before request processing
  before_request: (master: masterRequest) => void | Promise<void>;
 
  // Main request handler
  request: (master: masterRequest) => void | Promise<void>;
 
  // After request processing
  after_request: (
    master: masterRequest,
  ) => void | Response | Promise<void | Response>;
 
  // HTML transformation
  html_rewrite: {
    initContext?: (req: masterRequest) => unknown;
    rewrite?: (
      reWriter: HTMLRewriter,
      master: masterRequest,
      context: unknown,
    ) => void | Promise<void>;
    after?: (
      HTML: string,
      master: masterRequest,
      context: unknown,
    ) => void | Promise<void>;
  };
}>;

type ServerStart = Partial<{
  /**
   * Executed on the main thread when server starts
   */
  main: () => Promise<unknown> | unknown;
 
  /**
   * Executed only in development mode on main thread
   * ONLY DEV MODE
   */
  dev_main: () => Promise<unknown> | unknown;
}>;

type BuildOptionsPlugin = {
  /**
   * Build configuration - static object or dynamic function
   */
  buildConfig?:
    | Partial<Bun.BuildConfig>
    | ((
        builder: Builder,
      ) => Partial<Bun.BuildConfig> | Promise<Partial<Bun.BuildConfig>>);
 
  /**
   * Called before Bun.build() - setup, validation
   */
  beforeBuild?: (
    buildConfig: Bun.BuildConfig,
    builder: Builder,
  ) => void | Promise<void>;
 
  /**
   * Called after Bun.build() - post-processing
   */
  afterBuild?: (
    buildConfig: Bun.BuildConfig,
    result: Bun.BuildOutput,
    builder: Builder,
  ) => void | Promise<void>;
 
  /**
   * Enable build logging
   */
  enableLoging?: boolean;
};

type Requirement = Partial<{
  /**
   * Required Frame-Master plugins with versions
   * @example { "frame-master-auth": "^1.0.0" }
   */
  frameMasterPlugins: Record<string, string>;
 
  /**
   * Required Frame-Master version
   * @example "^2.0.0"
   */
  frameMasterVersion: string;
 
  /**
   * Required Bun runtime version
   * @example ">=1.0.0 <2.0.0"
   */
  bunVersion: string;
}>;

type WebSocketHandlers = Partial<{
  onOpen: (ws: Bun.ServerWebSocket<undefined>) => Promise<void> | void;
  onMessage: (
    ws: Bun.ServerWebSocket<undefined>,
    message: string | ArrayBufferView,
  ) => Promise<void> | void;
  onClose: (ws: Bun.ServerWebSocket<undefined>) => Promise<void> | void;
}>;

type WatchEventType = "change" | "rename";
 
type FileChangeCallback = (
  eventType: WatchEventType,
  filePath: string,
  absolutePath: string,
) => void | Promise<void>;

import type { Command } from "commander";
 
type CLIExtension = (command: Command) => Command;