feat(dlx): add CLI-style option names for cognitive consistency

Add option names that align with npm/npx/pnpm CLI flags:

DlxPackageOptions:
- yes: Skip confirmation prompts (aligns with npx --yes/-y)
- force: Force reinstallation (already existed)
- quiet: Suppress output (aligns with npx -q, pnpm -s) - reserved for future use
- call: Shell command to execute (aligns with npx --call) - reserved for future use

DlxBinaryOptions:
- yes: Skip confirmation prompts (aligns with npx --yes/-y)
- force: Force re-download (already existed)
- quiet: Suppress output - reserved for future use

Logic updates:
- Map yes flag to force behavior in both functions
- yes = true implies force = true (auto-approve/skip prompts)

This provides cognitive consistency between programmatic API and CLI tools,
making the API more intuitive for users familiar with npx/pnpm.

Author: jdalton

src/dlx-binary.ts

@@ -37,17 +37,47 @@ function getFs() {
 }
 
 export interface DlxBinaryOptions {
-  /** URL to download the binary from. */
+  /**
+   * URL to download the binary from.
+   */
   url: string
-  /** Optional name for the cached binary (defaults to URL hash). */
+
+  /**
+   * Optional name for the cached binary (defaults to URL hash).
+   */
   name?: string | undefined
-  /** Expected checksum (sha256) for verification. */
+
+  /**
+   * Expected checksum (sha256) for verification.
+   */
   checksum?: string | undefined
-  /** Cache TTL in milliseconds (default: 7 days). */
+
+  /**
+   * Cache TTL in milliseconds (default: 7 days).
+   */
   cacheTtl?: number | undefined
-  /** Force re-download even if cached. */
+
+  /**
+   * Force re-download even if cached.
+   * Aligns with npm/npx --force flag.
+   */
   force?: boolean | undefined
-  /** Additional spawn options. */
+
+  /**
+   * Skip confirmation prompts (auto-approve).
+   * Aligns with npx --yes/-y flag.
+   */
+  yes?: boolean | undefined
+
+  /**
+   * Suppress output (quiet mode).
+   * Aligns with npx --quiet/-q and pnpm --silent/-s flags.
+   */
+  quiet?: boolean | undefined
+
+  /**
+   * Additional spawn options.
+   */
   spawnOptions?: SpawnOptions | undefined
 }
 
@@ -367,12 +397,16 @@ export async function dlxBinary(
   const {
     cacheTtl = /*@__INLINE__*/ require('#constants/time').DLX_BINARY_CACHE_TTL,
     checksum,
-    force = false,
+    force: userForce = false,
     name,
     spawnOptions,
     url,
+    yes,
   } = { __proto__: null, ...options } as DlxBinaryOptions
 
+  // Map --yes flag to force behavior (auto-approve/skip prompts)
+  const force = yes === true ? true : userForce
+
   // Generate cache paths similar to pnpm/npx structure.
   const cacheDir = getDlxCachePath()
   const binaryName = name || `binary-${process.platform}-${os.arch()}`

src/dlx-package.ts

@@ -96,8 +96,10 @@ export interface DownloadPackageResult {
 export interface DlxPackageOptions {
   /**
    * Package to install (e.g., '@cyclonedx/cdxgen@10.0.0').
+   * Aligns with npx --package flag.
    */
   package: string
+
   /**
    * Binary name to execute (optional - auto-detected in most cases).
    *
@@ -117,10 +119,31 @@ export interface DlxPackageOptions {
    * { package: 'some-tool', binaryName: 'specific-tool' }
    */
   binaryName?: string | undefined
+
   /**
    * Force reinstallation even if package exists.
+   * Aligns with npx --yes/-y flag behavior.
    */
   force?: boolean | undefined
+
+  /**
+   * Skip confirmation prompts (auto-approve).
+   * Aligns with npx --yes/-y flag.
+   */
+  yes?: boolean | undefined
+
+  /**
+   * Suppress output (quiet mode).
+   * Aligns with npx --quiet/-q and pnpm --silent/-s flags.
+   */
+  quiet?: boolean | undefined
+
+  /**
+   * Shell command to execute in package context.
+   * Aligns with npx --call flag.
+   */
+  call?: string | undefined
+
   /**
    * Additional spawn options for the execution.
    */
@@ -449,6 +472,7 @@ export async function downloadPackage(
     binaryName,
     force: userForce,
     package: packageSpec,
+    yes,
   } = {
     __proto__: null,
     ...options,
@@ -458,11 +482,14 @@ export async function downloadPackage(
   const { name: packageName, version: packageVersion } =
     parsePackageSpec(packageSpec)
 
-  // Auto-force for version ranges to get latest within range.
-  // User can still override with explicit force: false if they want cache.
+  // Determine force behavior:
+  // 1. Explicit force takes precedence
+  // 2. --yes flag implies force (auto-approve/skip prompts)
+  // 3. Version ranges auto-force to get latest
   const isVersionRange =
     packageVersion !== undefined && rangeOperatorsRegExp.test(packageVersion)
-  const force = userForce !== undefined ? userForce : isVersionRange
+  const force =
+    userForce !== undefined ? userForce : yes === true ? true : isVersionRange
 
   // Build full package spec for installation.
   const fullPackageSpec = packageVersion