refactor: rename @option to @opt for brevity

- Rename @option decorator to @opt
- Rename OptionDef to OptDef and OptionOptions to OptOptions
- Update all metadata keys from 'option' to 'opt'
- Update all internal variables from 'optionDefs' to 'optDefs'
- Update all examples, tests, and documentation

Author: sigmaSd

README.md

@@ -6,7 +6,7 @@ decorators and inheritance.
 ## Features
 
 - **Perfect Type Safety** - Fully typed results based on your class definitions.
-- **Unified Decorators** - Simplify configuration with `@option` and `@arg`
+- **Unified Decorators** - Simplify configuration with `@opt` and `@arg`
   objects.
 - **Explicit Flags** - Clear distinction between CLI options and internal state.
 - **Subcommands** - Hierarchical command structure with full type safety.
@@ -17,7 +17,7 @@ decorators and inheritance.
 ## Quick Start
 
 ```typescript
-import { arg, Args, cli, option } from "@sigma/parse";
+import { Args, cli, opt } from "@sigma/parse";
 
 @cli({ name: "calculator", description: "A simple calculator" })
 class Calculator extends Args {
@@ -27,7 +27,7 @@ class Calculator extends Args {
   @arg({ type: "number", description: "second number", required: true })
   b!: number;
 
-  @option({ description: "operation to perform" })
+  @opt({ description: "operation to perform" })
   operation = "add";
 }
 
@@ -45,14 +45,14 @@ console.log(`${args.a} ${args.operation} ${args.b} = ...`);
 Your main command class must extend `Args` to get the static `parse` method:
 
 ```typescript
-import { Args, cli, option } from "@sigma/parse";
+import { Args, cli, opt } from "@sigma/parse";
 
 @cli({ name: "myapp", description: "My application" })
 class MyApp extends Args {
-  @option({ description: "Enable verbose logging", short: "v" })
+  @opt({ description: "Enable verbose logging", short: "v" })
   verbose = false;
 
-  @option({ description: "Port number", type: "number" })
+  @opt({ description: "Port number", type: "number" })
   port = 8080;
 }
 
@@ -66,14 +66,14 @@ Subcommands are plain classes (no need to extend `Args`). Link them using
 `@subCommand`:
 
 ```typescript
-import { Args, cli, command, option, subCommand } from "@sigma/parse";
+import { Args, cli, opt, subCommand } from "@sigma/parse";
 
 @command
 class ServeCommand {
-  @option({ description: "Port to serve on" })
+  @opt({ description: "Port to serve on" })
   port = 3000;
 
-  @option({ description: "Enable development mode", short: "d" })
+  @opt({ description: "Enable development mode", short: "d" })
   dev = false;
 }
 
@@ -98,7 +98,7 @@ if (args.serve) {
 
 ### Property Decorators
 
-- `@option(options)` - Mark a property as a CLI flag (`--flag`).
+- `@opt(options)` - Mark a property as a CLI flag (`--flag`).
   - `description`: Help text.
   - `type`: Explicit type (`"string"`, `"number"`, `"boolean"`, `"string[]"`,
     `"number[]"`).
@@ -123,7 +123,7 @@ if (args.serve) {
 **Explicitly Required** (must be provided on CLI):
 
 ```typescript
-@option({ type: "string", required: true })
+@opt({ type: "string", required: true })
 apiKey!: string;
 ```
 
@@ -147,19 +147,19 @@ verbose = false; // becomes -v, --verbose
 ### Built-in Validators
 
 ```typescript
-import { Args, cli, oneOf, option, pattern, range } from "@sigma/parse";
+import { Args, cli, opt, pattern, range } from "@sigma/parse";
 
 @cli({ name: "example" })
 class Example extends Args {
-  @option()
+  @opt()
   @range(1, 100)
   score = 50;
 
-  @option()
+  @opt()
   @oneOf(["dev", "prod"])
   env = "dev";
 
-  @option()
+  @opt()
   @pattern(/^[a-z]+$/)
   user = "admin";
 }

bench/bench.ts

@@ -1,6 +1,6 @@
 // deno-lint-ignore-file no-import-prefix
 import { parseArgs } from "jsr:@std/cli@1/parse-args";
-import { arg, Args, cli, command, option, subCommand } from "../src/index.ts";
+import { arg, Args, cli, command, opt, subCommand } from "../src/index.ts";
 import { Command } from "jsr:@cliffy/command@1.0.0-rc.8";
 
 const args = ["deno", "run", "-A", "script.ts", "hello world"];
@@ -15,7 +15,7 @@ Deno.bench("Args API", { group: "parse" }, () => {
     @arg({ description: "script to run", type: "string" })
     script?: string;
 
-    @option({ short: "A", type: "boolean" })
+    @opt({ short: "A", type: "boolean" })
     A?: boolean;
 
     @arg({ description: "script arguments", rest: true, type: "string[]" })

examples/cli_api_example.ts

@@ -12,45 +12,45 @@ import {
   cli,
   command,
   oneOf,
-  option,
+  opt,
   range,
   subCommand,
 } from "../mod.ts";
 
 // Simple example with basic options
 @cli({ name: "calculator", description: "A simple calculator application" })
 class Calculator extends Args {
-  @option({
+  @opt({
     description: "First number to operate on",
     type: "number",
     required: true,
   })
   a!: number;
 
-  @option({
+  @opt({
     description: "Second number to operate on",
     type: "number",
     required: true,
   })
   b!: number;
 
-  @option({
+  @opt({
     description: "Operation to perform",
   })
   @addValidator(oneOf(["add", "subtract", "multiply", "divide"]))
   operation = "add";
 
-  @option({ description: "Show detailed output" })
+  @opt({ description: "Show detailed output" })
   verbose = false;
 }
 
 // Subcommands are plain classes (no need to extend Args)
 @command
 class BuildCommand {
-  @option({ description: "Enable production optimizations" })
+  @opt({ description: "Enable production optimizations" })
   production = false;
 
-  @option({ description: "Output directory" })
+  @opt({ description: "Output directory" })
   output = "dist";
 
   @arg({ description: "Project directory to build", type: "string" })
@@ -59,24 +59,24 @@ class BuildCommand {
 
 @command
 class ServeCommand {
-  @option({ description: "Port to serve on" })
+  @opt({ description: "Port to serve on" })
   @addValidator(range(1, 65535))
   port = 3000;
 
-  @option({ description: "Enable development mode" })
+  @opt({ description: "Enable development mode" })
   dev = false;
 
-  @option({ description: "Host to bind to" })
+  @opt({ description: "Host to bind to" })
   host = "localhost";
 }
 
 // Main app with subcommands (extends Args)
 @cli({ name: "buildtool", description: "A project build and development tool" })
 class BuildTool extends Args {
-  @option({ description: "Enable verbose logging" })
+  @opt({ description: "Enable verbose logging" })
   verbose = false;
 
-  @option({ description: "Configuration file to use" })
+  @opt({ description: "Configuration file to use" })
   config = "build.config.js";
 
   @subCommand(BuildCommand)
@@ -105,11 +105,11 @@ class FileProcessor extends Args {
   })
   includes?: string[];
 
-  @option({ description: "Processing operation" })
+  @opt({ description: "Processing operation" })
   @addValidator(oneOf(["copy", "transform", "validate"]))
   operation = "copy";
 
-  @option({ description: "Enable verbose output" })
+  @opt({ description: "Enable verbose output" })
   verbose = false;
 }
 
@@ -248,7 +248,7 @@ console.log(`
 NEW API DESIGN:
 @cli({ name: "myapp", description: "My app" })
 class MyApp extends Args {  // Main command extends Args
-  @option({ description: "Verbose mode" })
+  @opt({ description: "Verbose mode" })
   verbose = false;
 
   @subCommand(ServeCommand)
@@ -257,10 +257,10 @@ class MyApp extends Args {  // Main command extends Args
 
 @command
 class ServeCommand {        // Subcommands are plain classes
-  @option({ description: "Port" })
+  @opt({ description: "Port" })
   port = 3000;
   
-  @option({ description: "Dev mode" })
+  @opt({ description: "Dev mode" })
   dev = false;
 }
 

examples/error-handling.ts

@@ -5,14 +5,7 @@
  * more robust CLI applications that don't always exit on errors.
  */
 
-import {
-  Args,
-  cli,
-  command,
-  isParseError,
-  option,
-  subCommand,
-} from "../mod.ts";
+import { Args, cli, command, isParseError, opt, subCommand } from "../mod.ts";
 
 // Example 1: Default behavior (exits on errors)
 console.log("=== Example 1: Default Behavior (Process Exit) ===");
@@ -23,10 +16,10 @@ try {
     description: "App with default error handling",
   })
   class DefaultConfig extends Args {
-    @option()
+    @opt()
     port: number = 8080;
 
-    @option()
+    @opt()
     debug: boolean = false;
   }
 
@@ -46,10 +39,10 @@ try {
     exitOnHelp: false,
   })
   class GracefulConfig extends Args {
-    @option()
+    @opt()
     port: number = 8080;
 
-    @option()
+    @opt()
     debug: boolean = false;
   }
 
@@ -95,10 +88,10 @@ try {
     onHelp: handleHelp,
   })
   class CustomConfig extends Args {
-    @option({ description: "Server port number" })
+    @opt({ description: "Server port number" })
     port: number = 8080;
 
-    @option({ description: "Enable debug logging" })
+    @opt({ description: "Enable debug logging" })
     debug: boolean = false;
   }
 
@@ -112,13 +105,13 @@ console.log("\n=== Example 4: Server Application ===");
 
 @command
 class StartCommand {
-  @option({ description: "Port to listen on" })
+  @opt({ description: "Port to listen on" })
   port: number = 3000;
 
-  @option({ description: "Host to bind to" })
+  @opt({ description: "Host to bind to" })
   host: string = "localhost";
 
-  @option({
+  @opt({
     description: "Configuration file path",
     required: true,
     type: "string",
@@ -128,7 +121,7 @@ class StartCommand {
 
 @command
 class StopCommand {
-  @option({ description: "Force stop without graceful shutdown" })
+  @opt({ description: "Force stop without graceful shutdown" })
   force: boolean = false;
 }
 
@@ -181,7 +174,7 @@ class ServerApp {
           @subCommand(StopCommand)
           stop?: StopCommand;
 
-          @option({ description: "Global verbose flag" })
+          @opt({ description: "Global verbose flag" })
           verbose: boolean = false;
         }
 
@@ -253,10 +246,10 @@ class _TestRunner {
           exitOnHelp: false,
         })
         class TestConfig extends Args {
-          @option()
+          @opt()
           port: number = 8080;
 
-          @option()
+          @opt()
           debug: boolean = false;
         }
 
@@ -309,13 +302,13 @@ class _ConfigManager {
         },
       })
       class AppConfig extends Args {
-        @option({ description: "Database URL", required: true, type: "string" })
+        @opt({ description: "Database URL", required: true, type: "string" })
         dbUrl!: string;
 
-        @option({ description: "API port" })
+        @opt({ description: "API port" })
         port: number = 3000;
 
-        @option({ description: "Environment" })
+        @opt({ description: "Environment" })
         env: string = "development";
       }