fix: first commit on custom autocomplete

package.json

@@ -1,7 +1,7 @@
 {
   "name": "@oclif/core",
   "description": "base library for oclif CLIs",
-  "version": "4.5.5",
+  "version": "4.5.6-autocomplete.0",
   "author": "Salesforce",
   "bugs": "https://github.com/oclif/core/issues",
   "dependencies": {

src/interfaces/index.ts

@@ -12,6 +12,7 @@ export type {
   ArgDefinition,
   ArgInput,
   BooleanFlag,
+  Completion,
   CustomOptions,
   Deprecation,
   Flag,

src/interfaces/parser.ts

@@ -231,6 +231,21 @@ export type OptionFlagProps = FlagProps & {
    * Should only be used on one flag at a time.
    */
   allowStdin?: boolean | 'only'
+  /**
+   * Optional dynamic completion configuration.
+   * Provides intelligent autocomplete suggestions for flag values based on context.
+   * Requires autocomplete plugin to be installed.
+   *
+   * @example
+   * ```typescript
+   * completion: {
+   *   options: async (ctx) => {
+   *     return ['option1', 'option2', 'option3']
+   *   }
+   * }
+   * ```
+   */
+  completion?: Completion
 }
 
 export type FlagParserContext = Command & {token: FlagToken}
@@ -439,6 +454,33 @@ export type ParserInput = {
   '--'?: boolean | undefined
 }
 
+/**
+ * Completion configuration for a flag
+ */
+export type Completion = {
+  /**
+   * Function that returns completion options
+   *
+   * @returns Promise resolving to array of completion strings
+   *
+   * @example
+   * ```typescript
+   * static flags = {
+   *   'target-org': Flags.string({
+   *     description: 'Target org',
+   *     completion: {
+   *       options: async () => {
+   *         const orgs = await getAuthenticatedOrgs()
+   *         return orgs.map(o => o.alias)
+   *       }
+   *     }
+   *   })
+   * }
+   * ```
+   */
+  options(): Promise<string[]>
+}
+
 export type ParserContext = Command & {
   token?: FlagToken | ArgToken | undefined
 }

test/interfaces/parser.test.ts

@@ -0,0 +1,29 @@
+import {expect} from 'chai'
+
+import * as Interfaces from '../../src/interfaces'
+
+describe('Completion types', () => {
+  it('allows completion property on OptionFlag', () => {
+    const completion: Interfaces.Completion = {
+      async options() {
+        return ['option1', 'option2']
+      },
+    }
+
+    expect(completion).to.exist
+    expect(completion.options).to.be.a('function')
+  })
+
+  it('completion function returns promise of strings', async () => {
+    const completion: Interfaces.Completion = {
+      async options() {
+        return ['a', 'b', 'c']
+      },
+    }
+
+    const result = await completion.options()
+
+    expect(result).to.be.an('array')
+    expect(result).to.deep.equal(['a', 'b', 'c'])
+  })
+})