add cleanOutput option, fixes #10

Author: lsmith77

src/generator.ts

@@ -44,6 +44,21 @@ export async function generate(context: CliGeneratorContext): Promise<void> {
   options.genCtx = genCtx;
 
   try {
+    if (pluginOptions.cleanOutput) {
+      try {
+        const root = path.parse(outputDir).root;
+        if (outputDir === root) {
+          throw new Error("Refusing to remove root directory");
+        }
+        if (fs.existsSync(outputDir)) {
+          fs.rmSync(outputDir, { recursive: true, force: true });
+        }
+      } catch (err) {
+        throw new Error(
+          `Failed to clean output directory "${outputDir}": ${err instanceof Error ? err.message : String(err)}`,
+        );
+      }
+    }
     fs.mkdirSync(outputDir, { recursive: true });
   } catch (error) {
     throw new Error(
@@ -328,6 +343,7 @@ function resolvePluginOptions(raw: Record<string, unknown>): PluginOptions {
     includeRelationships: raw['includeRelationships'] !== false,
     includeValidation: raw['includeValidation'] !== false,
     output: typeof raw['output'] === 'string' ? raw['output'] : undefined,
+    cleanOutput: raw['cleanOutput'] === true,
     title: typeof raw['title'] === 'string' ? raw['title'] : undefined,
   };
 }

src/types.ts

@@ -88,6 +88,10 @@ export type PluginOptions = {
   includeValidation?: boolean;
   output?: string;
   title?: string;
+  /**
+   * If true, delete the output directory before generating files.
+   */
+  cleanOutput?: boolean;
 };
 
 // ── Page Props ──────────────────────────────────────────────────────────