@sap/cds-dk 10.0.7 → 10.1.1

package/bin/completion/scripts/cds.ps1

@@ -0,0 +1,403 @@
+# This file was generated from bin/completion/templates/cds-tmpl.ps1 by
+# 'cds completion --generate' and is written to bin/completion/scripts/cds.ps1.
+#
+# Do not edit directly — modify the template and regenerate.
+#
+# All static completion data is stored in a single hashtable ($_CDS_COMPLETIONS)
+# for O(1) lookup. The ScriptBlock registered with Register-ArgumentCompleter
+# follows the same fastest-first strategy as the bash/zsh templates:
+#   1. Top-level commands  — when cursor is on the subcommand token.
+#   2. Shortcut resolution — single-char alias → canonical command name.
+#   3. Flags               — when $wordToComplete starts with '-'.
+#   3.5. Option values     — static values for known flags (e.g. --to sqlite).
+#   3.6. Comma values      — comma-separable list (e.g. cds add ai,hana).
+#   4. Positionals         — static known values per subcommand.
+#   4.5. File sentinel     — files only (flags shown only when $wordToComplete starts with '-').
+#   5. Dynamic fallback    — calls 'cds completion' for everything else.
+
+$_CDS_COMMAND = "cds"
+
+# Completion data map:
+#   __commands    — array of all top-level subcommand names
+#   __shortcuts   — hashtable of shortcut → canonical command name
+#   __positionals — hashtable of command → array of known positional string values
+#   __optionValues — hashtable of command → hashtable of flag → array of values,
+#                   or one of the file sentinels ':file', ':dir', ':file:ext1,ext2', ':file+dir:ext1,ext2'
+#   __commaCases  — hashtable of command → hashtable of flag → array of comma-separable values
+#   <cmd>         — array of flags/options for that subcommand (used by step 3)
+$_CDS_COMPLETIONS = @{
+    '__commands' = @('add', 'bind', 'build', 'compile', 'completion', 'debug', 'deploy', 'env', 'eval', 'export', 'gen', 'help', 'import', 'init', 'inspect', 'lint', 'login', 'logout', 'minify', 'mock', 'parse', 'pull', 'push', 'repl', 'run', 'serve', 'subscribe', 'test', 'unsubscribe', 'up', 'upgrade', 'upgrade-tenant', 'version', 'watch');
+    '__shortcuts' = @{
+    'i' = 'init';
+    'a' = 'add';
+    'y' = 'bind';
+    'm' = 'import';
+    'c' = 'compile';
+    'p' = 'parse';
+    's' = 'serve';
+    'w' = 'watch';
+    'e' = 'env';
+    'b' = 'build';
+    'd' = 'deploy';
+    'l' = 'login';
+    'o' = 'logout';
+    't' = 'test';
+    'v' = 'version';
+    'h' = 'help';
+    'r' = 'repl'
+    };
+    '__positionals' = @{
+    'help' = @('add', 'bind', 'build', 'compile', 'completion', 'debug', 'deploy', 'env', 'eval', 'export', 'gen', 'help', 'import', 'init', 'inspect', 'lint', 'login', 'logout', 'minify', 'mock', 'parse', 'pull', 'push', 'repl', 'run', 'serve', 'subscribe', 'test', 'unsubscribe', 'up', 'upgrade', 'upgrade-tenant', 'version', 'watch')
+    };
+    '__optionValues' = @{
+    'bind' = @{
+        '--on' = @('cf', 'k8s');
+        '--for' = @('development', 'hybrid', 'production');
+        '-4' = @('development', 'hybrid', 'production');
+        '--out' = ':file';
+        '--output-file' = ':file';
+        '--credentials' = ':file:json';
+        '-c' = ':file:json'
+    };
+    'build' = @{
+        '--for' = @('hana', 'helm', 'java', 'mtx', 'mtx-extension', 'mtx-sidecar', 'nodejs');
+        '--log-level' = @('debug', 'error', 'info', 'warn');
+        '--project' = ':dir';
+        '--dest' = ':dir';
+        '--src' = ':dir'
+    };
+    'compile' = @{
+        '--to' = @('asyncapi', 'cdl', 'edm', 'edmx', 'edmx-v2', 'edmx-v4', 'hana', 'hdbtable', 'json', 'openapi', 'sql', 'xsuaa', 'yml');
+        '--for' = @('odata', 'sql');
+        '--dialect' = @('h2', 'hana', 'postgres', 'sqlite');
+        '--sql-dialect' = @('h2', 'hana', 'postgres', 'sqlite');
+        '--log-level' = @('debug', 'error', 'info', 'warn');
+        '--odata-version' = @('4.0', '4.01');
+        '--flavor' = @('files', 'inferred', 'parsed', 'sources', 'xtended');
+        '--service' = @('all');
+        '--lang' = @('all');
+        '--dest' = ':dir';
+        '--openapi:config-file' = ':file:json';
+        '_' = ':file+dir:cds,json'
+    };
+    'completion' = @{
+        '--shell' = @('bash', 'fish', 'gitbash', 'ps', 'zsh')
+    };
+    'deploy' = @{
+        '--to' = @('hana', 'sqlite');
+        '--on' = @('cf', 'k8s');
+        '--for' = @('development', 'hybrid', 'production');
+        '-4' = @('development', 'hybrid', 'production');
+        '--vcap-file' = ':file:json';
+        '--delta-from' = ':file:json';
+        '_' = ':file+dir:cds,json'
+    };
+    'env' = @{
+        '--for' = @('development', 'hybrid', 'production');
+        '-4' = @('development', 'hybrid', 'production')
+    };
+    'export' = @{
+        '--as' = @('cdl', 'csn');
+        '--for' = @('mvn', 'npm');
+        '_' = ':file+dir:cds,json';
+        '--to' = ':dir'
+    };
+    'import' = @{
+        '--from' = @('asyncapi', 'edmx', 'openapi');
+        '--as' = @('cds', 'csn', 'json');
+        '--out' = ':dir';
+        '-o' = ':dir';
+        '_' = ':file:json,xml,edmx'
+    };
+    'init' = @{
+        '--java:package' = ':dir';
+        '--base' = ':dir'
+    };
+    'inspect' = @{
+        '--kind' = @('aspect', 'entity', 'service', 'type');
+        '--list' = @('all', 'associations', 'compositions', 'elements', 'ids', 'keys', 'names', 'sources');
+        '-l' = @('all', 'associations', 'compositions', 'elements', 'ids', 'keys', 'names', 'sources');
+        '_' = ':file+dir:cds,json'
+    };
+    'lint' = @{
+        '_' = ':file+dir:js,ts,cds'
+    };
+    'minify' = @{
+        '_' = ':file+dir:cds,json'
+    };
+    'parse' = @{
+        '--to' = @('asyncapi', 'cdl', 'edm', 'edmx', 'edmx-v2', 'edmx-v4', 'hana', 'hdbtable', 'json', 'openapi', 'sql', 'xsuaa', 'yml');
+        '--for' = @('odata', 'sql');
+        '--dialect' = @('h2', 'hana', 'postgres', 'sqlite');
+        '--sql-dialect' = @('h2', 'hana', 'postgres', 'sqlite');
+        '--log-level' = @('debug', 'error', 'info', 'warn');
+        '--odata-version' = @('4.0', '4.01');
+        '--flavor' = @('files', 'inferred', 'parsed', 'sources', 'xtended');
+        '--service' = @('all');
+        '--lang' = @('all');
+        '--dest' = ':dir';
+        '--openapi:config-file' = ':file:json';
+        '_' = ':file+dir:cds,json'
+    };
+    'repl' = @{
+        '--use' = @('entities', 'ql', 'services', 'xl');
+        '-u' = @('entities', 'ql', 'services', 'xl');
+        '_' = ':dir';
+        '--run' = ':dir';
+        '-r' = ':dir'
+    };
+    'run' = @{
+        '--to' = @('fiori', 'odata', 'rest');
+        '-2' = @('fiori', 'odata', 'rest');
+        '_' = ':dir';
+        '--from' = ':dir';
+        '-f' = ':dir';
+        '--with' = ':dir';
+        '-w' = ':dir'
+    };
+    'serve' = @{
+        '--to' = @('fiori', 'odata', 'rest');
+        '-2' = @('fiori', 'odata', 'rest');
+        '_' = ':dir';
+        '--from' = ':dir';
+        '-f' = ':dir';
+        '--with' = ':dir';
+        '-w' = ':dir'
+    };
+    'up' = @{
+        '--to' = @('cf', 'k8s');
+        '--overlay' = ':file:mtaext'
+    };
+    'version' = @{
+        '--omit' = @('dev', 'optional', 'peer')
+    };
+    'watch' = @{
+        '--to' = @('fiori', 'odata', 'rest');
+        '-2' = @('fiori', 'odata', 'rest');
+        '--experimental-hot-reload' = @('false', 'true');
+        '--livereload' = @('false');
+        '_' = ':dir';
+        '--from' = ':dir';
+        '-f' = ':dir';
+        '--with' = ':dir';
+        '-w' = ':dir';
+        '--include' = ':dir';
+        '--exclude' = ':dir'
+    }
+    };
+    '__commaCases' = @{
+    'add' = @{
+        '_' = @('ai', 'ams', 'app-frontend', 'application-logging', 'approuter', 'attachments', 'audit-logging', 'cf-manifest', 'cjs', 'cloud-logging', 'completion', 'connectivity', 'console', 'data', 'destination', 'dynatrace', 'enterprise-messaging', 'enterprise-messaging-shared', 'event-mesh', 'event-mesh-shared', 'extensibility', 'extension', 'file-based-messaging', 'github-actions', 'h2', 'hana', 'hana-serverless', 'handler', 'html5-repo', 'http', 'ias', 'initial', 'kafka', 'kyma', 'lint', 'liquibase', 'local-messaging', 'malware-scanner', 'mta', 'mtx', 'multitenancy', 'notifications', 'pipeline', 'portal', 'postgres', 'react', 'redis', 'redis-messaging', 'sample', 'side-by-side-extensibility', 'sqlite', 'telemetry', 'test', 'tiny-sample', 'toggles', 'typer', 'typescript', 'ui5', 'vue', 'workzone', 'workzone-standard', 'xsuaa')
+    };
+    'init' = @{
+        '--add' = @('ai', 'ams', 'app-frontend', 'application-logging', 'approuter', 'attachments', 'audit-logging', 'cf-manifest', 'cjs', 'cloud-logging', 'completion', 'connectivity', 'console', 'data', 'destination', 'dynatrace', 'enterprise-messaging', 'enterprise-messaging-shared', 'event-mesh', 'event-mesh-shared', 'extensibility', 'extension', 'file-based-messaging', 'github-actions', 'h2', 'hana', 'hana-serverless', 'handler', 'html5-repo', 'http', 'ias', 'initial', 'kafka', 'kyma', 'lint', 'liquibase', 'local-messaging', 'malware-scanner', 'mta', 'mtx', 'multitenancy', 'notifications', 'pipeline', 'portal', 'postgres', 'react', 'redis', 'redis-messaging', 'sample', 'side-by-side-extensibility', 'sqlite', 'telemetry', 'test', 'tiny-sample', 'toggles', 'typer', 'typescript', 'ui5', 'vue', 'workzone', 'workzone-standard', 'xsuaa')
+    }
+    };
+    'add' = @('--base', '--cdm', '--cloudevents', '--composition-records', '--content-type', '--data:for', '--dry', '--filter', '--for', '--for-app', '--force', '--into', '--java:mvn', '--keys-only', '--out', '--package', '--plan', '--records', '--sap', '--shell', '--unified-runtime', '--with-telemetry', '--y');
+    'bind' = @('--credentials', '--exec', '--for', '--kind', '--no-create-service-key', '--on', '--out', '--output-file', '--to', '--to-app-services');
+    'build' = @('--dest', '--for', '--log-level', '--no-clean', '--no-ws-pack', '--options-model', '--opts', '--project', '--src', '--ws', '--ws-pack');
+    'compile' = @('--all', '--asyncapi:merged', '--beta', '--clean', '--conceptual', '--dest', '--dialect', '--docs', '--files', '--flavor', '--for', '--from', '--lang', '--locations', '--log-level', '--min', '--odata-version', '--openapi:config-file', '--openapi:diagram', '--openapi:servers', '--openapi:url', '--parse', '--plain', '--resolved', '--service', '--sort', '--sources', '--sql-dialect', '--to');
+    'completion' = @('--add', '--curr', '--generate', '--line', '--prev', '--profile', '--remove', '--shell');
+    'debug' = @('--cf', '--force', '--host', '--k8s', '--no-devtools', '--port');
+    'deploy' = @('--auto-undeploy', '--delta-from', '--dry', '--for', '--model-only', '--no-build', '--no-save', '--on', '--out', '--resolve-bindings', '--script', '--store-credentials', '--to', '--tunnel-address', '--vcap-file', '--with-auto-schema-evolution', '--with-mocks', '--xdry');
+    'env' = @('--for', '--json', '--keys', '--list', '--mocked', '--process-env', '--properties', '--raw', '--resolve-bindings', '--sources');
+    'eval' = @();
+    'export' = @('--artifact', '--as', '--cleanse', '--data', '--debug', '--dry', '--for', '--from', '--inspect', '--keep', '--mvn', '--plugin', '--reuse', '--services', '--skip', '--texts', '--to');
+    'help' = @();
+    'import' = @('--as', '--asyncapi', '--config', '--data-product', '--dependencies', '--destination', '--dry', '--edmx', '--for', '--force', '--from', '--group', '--include-namespaces', '--into-namespace', '--keep-namespace', '--name', '--no-copy', '--no-save', '--odata', '--odata-v2-annotations', '--openapi', '--out', '--resolve-bindings', '--rfc', '--services');
+    'init' = @('--add', '--base', '--force', '--java', '--java:mvn', '--java:package', '--lint:custom', '--lint:custom:example', '--no-db', '--nodejs', '--verbose');
+    'inspect' = @('--kind', '--list', '--stats');
+    'lint' = @('--cache', '--cache-file', '--cache-location', '--cache-strategy', '--color', '--concurrency', '--config', '--debug', '--env-info', '--exit-on-fatal-error', '--ext', '--fix', '--fix-dry-run', '--fix-type', '--flag', '--format', '--global', '--help', '--ignore-pattern', '--init', '--inspect-config', '--max-warnings', '--mcp', '--no-color', '--no-config-lookup', '--no-error-on-unmatched-pattern', '--no-ignore', '--no-inline-config', '--no-warn-ignored', '--output-file', '--parser', '--parser-options', '--pass-on-no-patterns', '--pass-on-unpruned-suppressions', '--plugin', '--print-config', '--prune-suppressions', '--quiet', '--report-unused-disable-directives', '--report-unused-disable-directives-severity', '--report-unused-inline-configs', '--rule', '--stats', '--stdin', '--stdin-filename', '--suppress-all', '--suppress-rule', '--suppressions-location', '--version');
+    'login' = @('--client', '--mtls', '--passcode', '--plain', '--save-refresh-token', '--subdomain', '--user');
+    'logout' = @('--clear-invalid', '--delete-settings', '--subdomain', '--url');
+    'minify' = @('--cleanse', '--debug', '--dry', '--inspect', '--keep', '--skip');
+    'mock' = @('--at', '--from', '--in-memory', '--in-memory?', '--mocked', '--port', '--project', '--projects', '--resolve-bindings', '--service', '--to', '--watch', '--with', '--with-bindings', '--with-mocks', '--with-mtx', '--workers');
+    'parse' = @('--all', '--asyncapi:merged', '--beta', '--clean', '--conceptual', '--dest', '--dialect', '--docs', '--files', '--flavor', '--for', '--from', '--lang', '--locations', '--log-level', '--min', '--odata-version', '--openapi:config-file', '--openapi:diagram', '--openapi:servers', '--openapi:url', '--parse', '--plain', '--resolved', '--service', '--sort', '--sources', '--sql-dialect', '--to');
+    'pull' = @('--client', '--from', '--mtls', '--passcode', '--subdomain', '--user');
+    'push' = @('--async', '--client', '--mtls', '--passcode', '--subdomain', '--sync', '--to', '--user');
+    'repl' = @('--ql', '--run', '--use');
+    'run' = @('--at', '--from', '--in-memory', '--in-memory?', '--mocked', '--port', '--project', '--projects', '--resolve-bindings', '--service', '--to', '--watch', '--with', '--with-bindings', '--with-mocks', '--with-mtx', '--workers');
+    'serve' = @('--at', '--from', '--in-memory', '--in-memory?', '--mocked', '--port', '--project', '--projects', '--resolve-bindings', '--service', '--to', '--watch', '--with', '--with-bindings', '--with-mocks', '--with-mtx', '--workers');
+    'subscribe' = @('--body', '--local', '--resolve-bindings', '--to', '--user');
+    'test' = @('--exclude', '--failed', '--files', '--include', '--list', '--passed', '--quiet', '--recent', '--silent', '--timeout', '--unmute', '--verbose', '--workers');
+    'unsubscribe' = @('--from', '--local', '--resolve-bindings', '--user');
+    'up' = @('--namespace', '--overlay', '--to');
+    'upgrade' = @('--at', '--fix', '--local', '--report', '--resolve-bindings', '--user');
+    'upgrade-tenant' = @('--at', '--local', '--resolve-bindings', '--user');
+    'version' = @('--abs', '--all', '--depth', '--info', '--json', '--markdown', '--omit');
+    'watch' = @('--debug', '--exclude', '--experimental-hot-reload', '--ext', '--in-memory', '--in-memory?', '--include', '--inspect', '--inspect-brk', '--livereload', '--open', '--port', '--with-mocks', '--with-mtx')
+}
+
+# $wordToComplete : the token currently being typed (may be empty if cursor is after a space)
+# $commandAst     : the full parsed command AST; .CommandElements is the token array
+# $cursorPosition : byte offset of the cursor in the command string
+Register-ArgumentCompleter -Native -CommandName $_CDS_COMMAND -ScriptBlock {
+    param($wordToComplete, $commandAst, $cursorPosition)
+
+    $map = $_CDS_COMPLETIONS
+    $cmdSegments = $commandAst.CommandElements
+    if ($null -eq $wordToComplete) { $wordToComplete = '' }
+
+    # Helper: emit file/dir completions for a sentinel value.
+    # Sentinel formats: ':file' (any file), ':dir' (directories only),
+    #                   ':file:ext1,ext2' (files with specific extensions),
+    #                   ':file+dir:ext1,ext2' (files with extensions + directories).
+    # Uses relative paths (preserving any typed prefix) so the completed text stays short.
+    function _CdsFileComplete($sentinel, $word) {
+        $base   = if ($word) { $word } else { '' }
+        $search = if ($word) { "$word*" } else { '*' }
+        $inclDirs = $sentinel -like ':file+dir:*'
+        # Parse extension list from ':file:cds,json' or ':file+dir:cds,json' → @('.cds', '.json')
+        $exts = if ($sentinel -like ':file:*' -or $inclDirs) {
+            ($sentinel -replace '^:file(\+dir)?:', '').Split(',') | ForEach-Object { ".$_" }
+        } else { $null }
+        if ($sentinel -eq ':dir') {
+            Get-ChildItem -Path $search -Directory -ErrorAction SilentlyContinue |
+                ForEach-Object {
+                    $rel = $base + $_.Name
+                    [System.Management.Automation.CompletionResult]::new($rel, $_.Name, 'ProviderItem', $_.Name)
+                }
+        } else {
+            Get-ChildItem -Path $search -File -ErrorAction SilentlyContinue |
+                Where-Object { $null -eq $exts -or $exts -contains $_.Extension } |
+                ForEach-Object {
+                    $rel = $base + $_.Name
+                    [System.Management.Automation.CompletionResult]::new($rel, $_.Name, 'ProviderItem', $_.Name)
+                }
+            if ($inclDirs) {
+                Get-ChildItem -Path $search -Directory -ErrorAction SilentlyContinue |
+                    ForEach-Object {
+                        $rel = $base + $_.Name
+                        [System.Management.Automation.CompletionResult]::new($rel, $_.Name, 'ProviderContainer', $_.Name)
+                    }
+            }
+        }
+    }
+
+    # Step 1: top-level command completion — cursor is on the subcommand token itself.
+    # Either no subcommand yet (count=1) or the user is still typing it (count=2, partial match).
+    $isTopLevel = $cmdSegments.Count -eq 1 -or ($cmdSegments.Count -eq 2 -and $wordToComplete -ne '' -and $cmdSegments[1].Extent.Text -eq $wordToComplete)
+    if ($isTopLevel) {
+        foreach ($cmd in $map['__commands']) {
+            if ($cmd.StartsWith($wordToComplete)) {
+                [System.Management.Automation.CompletionResult]::new($cmd, $cmd, 'ParameterValue', $cmd)
+            }
+        }
+        return
+    }
+
+    # Step 2: resolve shortcut to canonical command name so the rest of the
+    # logic only needs to handle canonical names.
+    $subCmd = $cmdSegments[1].Extent.Text
+    $resolved = $map['__shortcuts'][$subCmd]
+    if ($null -ne $resolved) { $subCmd = $resolved }
+
+    # Compute $previousWord — the token immediately before the cursor.
+    # When $wordToComplete is empty the cursor is after a space, so the last completed
+    # token is the previous word. When non-empty the cursor is mid-token, so look one
+    # further back. EndOffset filtering keeps only tokens that end before the cursor.
+    $prevCandidates = $cmdSegments | Where-Object { $_.Extent.EndOffset -le $cursorPosition }
+    $previousWord = if ($wordToComplete -eq '') {
+        ($prevCandidates | Select-Object -Last 1).Extent.Text
+    } else {
+        ($prevCandidates | Select-Object -Last 2 | Select-Object -First 1).Extent.Text
+    }
+
+    # Step 3: flag/option completion — triggered when $wordToComplete starts with '-'.
+    if ($wordToComplete.StartsWith('-')) {
+        $entry = $map[$subCmd]
+        if ($null -ne $entry) {
+            foreach ($opt in $entry) {
+                if ($opt.StartsWith($wordToComplete)) {
+                    [System.Management.Automation.CompletionResult]::new($opt, $opt, 'ParameterValue', $opt)
+                }
+            }
+            return
+        }
+    }
+
+    # Step 3.5: option-value completion — triggered when the previous word is a known option.
+    $optVals = $map['__optionValues'][$subCmd]
+    if ($null -ne $optVals) {
+        $entry = $optVals[$previousWord]
+        if ($null -ne $entry) {
+            if ($entry -eq ':dir' -or $entry -eq ':file' -or $entry -like ':file:*' -or $entry -like ':file+dir:*') {
+                _CdsFileComplete $entry $wordToComplete
+            } else {
+                foreach ($val in $entry) {
+                    if ($val.StartsWith($wordToComplete)) {
+                        [System.Management.Automation.CompletionResult]::new($val, $val, 'ParameterValue', $val)
+                    }
+                }
+            }
+            return
+        }
+    }
+
+    # Step 3.6: comma-separated option-value completion.
+    $commaVals = $map['__commaCases'][$subCmd]
+    if ($null -ne $commaVals) {
+        # Primary lookup: previous word is the option flag (e.g. '--add').
+        $entry = $commaVals[$previousWord]
+        if ($null -eq $entry -and $previousWord.EndsWith(',')) {
+            # Space-separated continuation: user typed "cds add ai, <tab>" so $previousWord="ai,"
+            # and $wordToComplete is empty. Scan backwards through segments to find the flag.
+            $prevSegs = @($cmdSegments | ForEach-Object { $_.Extent.Text })
+            $prevIdx = [array]::LastIndexOf($prevSegs, $previousWord) - 1
+            while ($prevIdx -ge 0 -and -not $prevSegs[$prevIdx].StartsWith('-')) { $prevIdx-- }
+            if ($prevIdx -ge 0) { $entry = $commaVals[$prevSegs[$prevIdx]] }
+        }
+        # Positional fallback: previous word is not a flag (it's the subcommand or a value).
+        if ($null -eq $entry -and -not $previousWord.StartsWith('-')) {
+            $entry = $commaVals['_']
+        }
+        if ($null -ne $entry) {
+            # For space-separated comma continuation, fold previousWord into the prefix/alreadyUsed.
+            $spaceComma = $previousWord.EndsWith(',')
+            $commaWord = if ($spaceComma) { $previousWord + $wordToComplete } else { $wordToComplete }
+            $parts = $commaWord.Split(',')
+            $prefix = if ($parts.Count -gt 1) { ($parts[0..($parts.Count-2)] -join ',') + ',' } else { '' }
+            $partial = $parts[-1]
+            $alreadyUsed = @{}
+            foreach ($u in $parts[0..($parts.Count-2)]) { if ($u) { $alreadyUsed[$u] = $true } }
+            foreach ($val in $entry) {
+                if (-not $alreadyUsed.ContainsKey($val) -and $val.StartsWith($partial)) {
+                    # When space-separated (prev="ai,"), PS replaces only $wordToComplete (=''),
+                    # so return just $val — the prefix is already on the line.
+                    $full = if ($spaceComma) { $val } else { $prefix + $val }
+                    [System.Management.Automation.CompletionResult]::new($full, $val, 'ParameterValue', $val)
+                }
+            }
+            return
+        }
+    }
+
+    # Step 4: static string positionals (e.g. cds help <tab>).
+    $positionals = $map['__positionals'][$subCmd]
+    if ($null -ne $positionals) {
+        $matched = $false
+        foreach ($pos in $positionals) {
+            if ($pos.StartsWith($wordToComplete)) {
+                [System.Management.Automation.CompletionResult]::new($pos, $pos, 'ParameterValue', $pos)
+                $matched = $true
+            }
+        }
+        if ($matched) { return }
+    }
+
+    # Step 4.5: default file sentinel — files only, no flags appended.
+    $defaultFile = $map['__optionValues'][$subCmd]?['_']
+    if ($null -ne $defaultFile) {
+        _CdsFileComplete $defaultFile $wordToComplete
+        return
+    }
+
+    # Step 5: dynamic fallback — calls 'cds completion' for subcommands whose arguments
+    # cannot be determined statically (e.g. service names, model names, unknown flags).
+    # Single-quoting $previousWord/$wordToComplete prevents bare word 'h' from being
+    # interpreted as the 'help' shortcut by the completion handler.
+    $options = & $_CDS_COMMAND completion --shell ps --prev "'$previousWord'" --curr "'$wordToComplete'" --line "'$commandAst'"
+    foreach ($option in $options) {
+        [System.Management.Automation.CompletionResult]::new($option, $option, 'ParameterValue', $option)
+    }
+}