@optique/discover 1.2.0-dev.2281 → 1.2.0-dev.2282

package/README.md

@@ -116,6 +116,14 @@ If you do not want to maintain the static module map by hand, generate one:
 optique-discover ./commands --output ./commands.generated.ts --extension .ts
 ~~~~
 
+The generated module starts with a fixed header containing lint, formatter,
+TypeScript check suppression, and generated-file marker comments for tools
+that support file-level comments.  Biome suppressions appear first because
+Biome expects file-level suppressions at the beginning of the file.  Command
+module exports are still validated at runtime by `commandsFromModules()`.
+Prettier and Oxfmt users should exclude the generated module through formatter
+configuration, such as *.prettierignore* or Oxfmt ignore paths.
+
 Then import the generated module from your CLI entry point:
 
 ~~~~ typescript

package/dist/cli.cjs

@@ -2,7 +2,7 @@
 const require_chunk = require('./chunk-CUT6urMc.cjs');
 require('./command-C-NgG0KJ.cjs');
 require('./src-C3_a7SFM.cjs');
-const require_generator = require('./generator-CkGpilfc.cjs');
+const require_generator = require('./generator-CyGtPDkA.cjs');
 const require_main_check = require('./main-check-CwunSNpK.cjs');
 const __optique_core_constructs = require_chunk.__toESM(require("@optique/core/constructs"));
 const __optique_core_message = require_chunk.__toESM(require("@optique/core/message"));
@@ -15,7 +15,7 @@ const node_process = require_chunk.__toESM(require("node:process"));
 
 //#region deno.json
 var name = "@optique/discover";
-var version = "1.2.0-dev.2281+9d37b9cc";
+var version = "1.2.0-dev.2282+c9c50098";
 var license = "MIT";
 var exports$1 = {
 	".": "./src/index.ts",

package/dist/cli.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 import "./command-9sgrJtwh.js";
 import "./src-wHLRsXWK.js";
-import { watchCommandsModule, writeCommandsModule } from "./generator-B8UY7n7b.js";
+import { watchCommandsModule, writeCommandsModule } from "./generator-DDSCS6PX.js";
 import { isMainModuleUrl } from "./main-check-mMnKfUZs.js";
 import { object } from "@optique/core/constructs";
 import { message } from "@optique/core/message";
@@ -14,7 +14,7 @@ import process from "node:process";
 
 //#region deno.json
 var name = "@optique/discover";
-var version = "1.2.0-dev.2281+9d37b9cc";
+var version = "1.2.0-dev.2282+c9c50098";
 var license = "MIT";
 var exports = {
 	".": "./src/index.ts",

package/dist/{generator-CkGpilfc.cjs → generator-CyGtPDkA.cjs}

@@ -5,6 +5,15 @@ const node_path = require_chunk.__toESM(require("node:path"));
 const node_url = require_chunk.__toESM(require("node:url"));
 
 //#region src/generator.ts
+const generatedHeader = [
+	"// biome-ignore-all lint: generated file",
+	"// biome-ignore-all format: generated file",
+	"// Generated by optique-discover. Do not edit.",
+	"/* eslint-disable */",
+	"// @ts-nocheck",
+	"// deno-lint-ignore-file",
+	"// deno-fmt-ignore-file"
+].join("\n") + "\n\n";
 /**
 * Generates a TypeScript module that exports command entries.
 *
@@ -89,7 +98,7 @@ async function collectGeneratedCommandFiles(options, collectOptions = {}) {
 }
 function generateCommandsModuleFromFiles(options, files) {
 	if (files.length < 1) return {
-		code: "import type { ModuleCommand } from \"@optique/discover\";\n\nexport default [] satisfies readonly ModuleCommand[];\n",
+		code: `${generatedHeader}import type { ModuleCommand } from "@optique/discover";\n\nexport default [] satisfies readonly ModuleCommand[];\n`,
 		files
 	};
 	const imports = files.map(formatCommandModuleImport).join("\n");
@@ -100,7 +109,7 @@ function generateCommandsModuleFromFiles(options, files) {
 		...options.entryFileName === void 0 ? [] : [`    entryFileName: ${JSON.stringify(options.entryFileName)},`]
 	].join("\n");
 	return {
-		code: `import { commandsFromModules } from "@optique/discover";\n${imports}\n\nexport default commandsFromModules(\n  {\n${entries}\n  },\n  {\n${optionEntries}\n  },\n);\n`,
+		code: `${generatedHeader}import { commandsFromModules } from "@optique/discover";\n${imports}\n\nexport default commandsFromModules(\n  {\n${entries}\n  },\n  {\n${optionEntries}\n  },\n);\n`,
 		files
 	};
 }

package/dist/{generator-B8UY7n7b.js → generator-DDSCS6PX.js}

@@ -4,6 +4,15 @@ import { dirname, posix, relative, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 
 //#region src/generator.ts
+const generatedHeader = [
+	"// biome-ignore-all lint: generated file",
+	"// biome-ignore-all format: generated file",
+	"// Generated by optique-discover. Do not edit.",
+	"/* eslint-disable */",
+	"// @ts-nocheck",
+	"// deno-lint-ignore-file",
+	"// deno-fmt-ignore-file"
+].join("\n") + "\n\n";
 /**
 * Generates a TypeScript module that exports command entries.
 *
@@ -88,7 +97,7 @@ async function collectGeneratedCommandFiles(options, collectOptions = {}) {
 }
 function generateCommandsModuleFromFiles(options, files) {
 	if (files.length < 1) return {
-		code: "import type { ModuleCommand } from \"@optique/discover\";\n\nexport default [] satisfies readonly ModuleCommand[];\n",
+		code: `${generatedHeader}import type { ModuleCommand } from "@optique/discover";\n\nexport default [] satisfies readonly ModuleCommand[];\n`,
 		files
 	};
 	const imports = files.map(formatCommandModuleImport).join("\n");
@@ -99,7 +108,7 @@ function generateCommandsModuleFromFiles(options, files) {
 		...options.entryFileName === void 0 ? [] : [`    entryFileName: ${JSON.stringify(options.entryFileName)},`]
 	].join("\n");
 	return {
-		code: `import { commandsFromModules } from "@optique/discover";\n${imports}\n\nexport default commandsFromModules(\n  {\n${entries}\n  },\n  {\n${optionEntries}\n  },\n);\n`,
+		code: `${generatedHeader}import { commandsFromModules } from "@optique/discover";\n${imports}\n\nexport default commandsFromModules(\n  {\n${entries}\n  },\n  {\n${optionEntries}\n  },\n);\n`,
 		files
 	};
 }

package/dist/generator.cjs

@@ -1,6 +1,6 @@
 require('./command-C-NgG0KJ.cjs');
 require('./src-C3_a7SFM.cjs');
-const require_generator = require('./generator-CkGpilfc.cjs');
+const require_generator = require('./generator-CyGtPDkA.cjs');
 
 exports.generateCommandsModule = require_generator.generateCommandsModule;
 exports.watchCommandsModule = require_generator.watchCommandsModule;

package/dist/generator.js

@@ -1,5 +1,5 @@
 import "./command-9sgrJtwh.js";
 import "./src-wHLRsXWK.js";
-import { generateCommandsModule, watchCommandsModule, writeCommandsModule } from "./generator-B8UY7n7b.js";
+import { generateCommandsModule, watchCommandsModule, writeCommandsModule } from "./generator-DDSCS6PX.js";
 
 export { generateCommandsModule, watchCommandsModule, writeCommandsModule };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optique/discover",
-  "version": "1.2.0-dev.2281",
+  "version": "1.2.0-dev.2282",
   "description": "Runtime-aware command discovery for Optique CLI programs",
   "keywords": [
     "CLI",
@@ -83,8 +83,8 @@
     "optique-discover": "./dist/cli.js"
   },
   "dependencies": {
-    "@optique/core": "1.2.0-dev.2281+9d37b9cc",
-    "@optique/run": "1.2.0-dev.2281+9d37b9cc"
+    "@optique/core": "1.2.0-dev.2282+c9c50098",
+    "@optique/run": "1.2.0-dev.2282+c9c50098"
   },
   "devDependencies": {
     "@types/node": "^24.0.0",