fix(types): disallow parseArgs option defaults

Author: chenjiahan

packages/rstack/src/cli/args.ts

@@ -1,9 +1,18 @@
 import {
   parseArgs as nodeParseArgs,
-  type ParseArgsConfig,
+  type ParseArgsConfig as NodeParseArgsConfig,
+  type ParseArgsOptionDescriptor as NodeParseArgsOptionDescriptor,
   type ParseArgsOptionsConfig,
 } from 'node:util';
 
+type ParseArgsOptionDescriptor = Omit<NodeParseArgsOptionDescriptor, 'default'> & {
+  default?: never;
+};
+
+type ParseArgsConfig = Omit<NodeParseArgsConfig, 'options'> & {
+  options?: Record<string, ParseArgsOptionDescriptor>;
+};
+
 type CamelCase<Value extends string> = Value extends `${infer Head}-${infer Tail}`
   ? `${Head}${Capitalize<CamelCase<Tail>>}`
   : Value;

packages/rstack/tests/cli/args.test.ts

@@ -1,6 +1,20 @@
 import { expect, test } from 'rstack/test';
 import { parseArgs } from '../../src/cli/args.ts';
 
+const assertDefaultIsUnsupported = (): void => {
+  parseArgs({
+    options: {
+      option: {
+        type: 'string',
+        // @ts-expect-error `default` is intentionally unsupported by this helper.
+        default: 'default',
+      },
+    },
+  });
+};
+
+void assertDefaultIsUnsupported;
+
 test.each([
   ['--long-option', 'kebab'],
   ['--longOption', 'camel'],