@sap/cds-dk 10.0.7 → 10.1.0

package/bin/completion/scripts/cds.ps1

@@ -0,0 +1,329 @@
+# 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'
+#   __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');
+        '--out' = ':file';
+        '--output-file' = ':file'
+    };
+    'build' = @{
+        '--for' = @('hana', 'helm', 'java', 'mtx', 'mtx-extension', 'mtx-sidecar', 'nodejs');
+        '--log-level' = @('debug', 'error', 'info', 'warn');
+        '--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';
+        '_' = ':file:cds,json'
+    };
+    'completion' = @{
+        '--shell' = @('bash', 'fish', 'gitbash', 'ps', 'zsh')
+    };
+    'deploy' = @{
+        '--to' = @('hana', 'sqlite');
+        '--on' = @('cf', 'k8s');
+        '_' = ':file:cds,json'
+    };
+    'import' = @{
+        '--from' = @('asyncapi', 'edmx', 'openapi');
+        '--as' = @('cds', 'csn', 'json');
+        '_' = ':file:json,xml,edmx'
+    };
+    'init' = @{
+        '--java:package' = ':dir'
+    };
+    'inspect' = @{
+        '--kind' = @('aspect', 'entity', 'service', 'type');
+        '_' = ':file: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';
+        '_' = ':file:cds,json'
+    };
+    'up' = @{
+        '--to' = @('cf', 'k8s')
+    };
+    'version' = @{
+        '--omit' = @('dev', 'optional', 'peer')
+    };
+    'watch' = @{
+        '--experimental-hot-reload' = @('false', 'true');
+        '--livereload' = @('false');
+        '--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', '--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).
+    # 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 { '*' }
+        # Parse extension list from ':file:cds,json' → @('.cds', '.json')
+        $exts = if ($sentinel -like ':file:*') {
+            ($sentinel -replace '^:file:', '').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)
+                }
+        }
+    }
+
+    # 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:*') {
+                _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)
+    }
+}

package/bin/completion/scripts/cds.sh

@@ -0,0 +1,261 @@
+#!/bin/bash
+# This file was generated from bin/completion/templates/cds-tmpl.sh by
+# 'cds completion --generate' and is written to bin/completion/scripts/cds.sh.
+#
+# Do not edit directly — modify the template and regenerate.
+#
+# Completion strategy (fastest-first):
+#   1. Shortcuts    — single-character aliases resolved before any other logic.
+#   2. Top-level    — all known subcommands when no subcommand has been typed yet.
+#   3. Flags        — matched when the current token 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. File positionals — files/dirs for subcommands that take a path argument.
+#   4.6. String positionals — fixed word list (e.g. cds help <tab>).
+#   5. Dynamic fallback — calls 'cds completion' for anything not covered above.
+#
+# compopt -o nospace suppresses the trailing space bash normally appends after a
+# completion, which is required for path completions (so the user can keep typing
+# a subdirectory) and for flag names (so '=' can follow immediately).
+CDS_COMMAND="cds"
+
+_completeCds()
+{
+    local current previous cmd
+    COMPREPLY=()
+    current="${COMP_WORDS[COMP_CWORD]}"
+    previous="${COMP_WORDS[COMP_CWORD - 1]}"
+    # The subcommand is always the second token (index 1).
+    cmd="${COMP_WORDS[1]}"
+    # Step 1: resolve single-character shortcuts to their canonical command name
+    # so that subsequent case statements only need to handle canonical names.
+    case "$cmd" in
+        i) cmd=init ;;
+        a) cmd=add ;;
+        y) cmd=bind ;;
+        m) cmd=import ;;
+        c) cmd=compile ;;
+        p) cmd=parse ;;
+        s) cmd=serve ;;
+        w) cmd=watch ;;
+        e) cmd=env ;;
+        b) cmd=build ;;
+        d) cmd=deploy ;;
+        l) cmd=login ;;
+        o) cmd=logout ;;
+        t) cmd=test ;;
+        v) cmd=version ;;
+        h) cmd=help ;;
+        r) cmd=repl ;;
+    esac
+
+    # Step 2: top-level — offer all known subcommands when no subcommand has been
+    # typed yet (COMP_WORDS includes the command itself, so ≤ 2 means "cds <cursor>").
+    if [[ "${#COMP_WORDS[@]}" -le 2 ]]; then
+        COMPREPLY=( $(compgen -W ""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"" -- "$current") )
+        compopt -o nospace
+        return 0
+    fi
+
+    # Step 3: flag/option completion — only triggered when the token starts with '-'.
+    if [[ "$current" == -* ]]; then
+        case "$cmd" in
+            add) COMPREPLY=( $(compgen -W ""--base" "--cdm" "--cloudevents" "--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"" -- "$current") ) ;;
+            bind) COMPREPLY=( $(compgen -W ""--credentials" "--exec" "--for" "--kind" "--no-create-service-key" "--on" "--out" "--output-file" "--to" "--to-app-services"" -- "$current") ) ;;
+            build) COMPREPLY=( $(compgen -W ""--dest" "--for" "--log-level" "--no-clean" "--no-ws-pack" "--options-model" "--opts" "--project" "--src" "--ws" "--ws-pack"" -- "$current") ) ;;
+            compile) COMPREPLY=( $(compgen -W ""--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"" -- "$current") ) ;;
+            completion) COMPREPLY=( $(compgen -W ""--add" "--curr" "--generate" "--line" "--prev" "--profile" "--remove" "--shell"" -- "$current") ) ;;
+            debug) COMPREPLY=( $(compgen -W ""--cf" "--force" "--host" "--k8s" "--no-devtools" "--port"" -- "$current") ) ;;
+            deploy) COMPREPLY=( $(compgen -W ""--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"" -- "$current") ) ;;
+            env) COMPREPLY=( $(compgen -W ""--for" "--json" "--keys" "--list" "--mocked" "--process-env" "--properties" "--raw" "--resolve-bindings" "--sources"" -- "$current") ) ;;
+            export) COMPREPLY=( $(compgen -W ""--artifact" "--as" "--cleanse" "--data" "--debug" "--dry" "--for" "--from" "--inspect" "--keep" "--mvn" "--plugin" "--reuse" "--services" "--skip" "--texts" "--to"" -- "$current") ) ;;
+            import) COMPREPLY=( $(compgen -W ""--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"" -- "$current") ) ;;
+            init) COMPREPLY=( $(compgen -W ""--add" "--base" "--force" "--java" "--java:mvn" "--java:package" "--lint:custom" "--lint:custom:example" "--no-db" "--nodejs" "--verbose"" -- "$current") ) ;;
+            inspect) COMPREPLY=( $(compgen -W ""--kind" "--list" "--stats"" -- "$current") ) ;;
+            lint) COMPREPLY=( $(compgen -W ""--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"" -- "$current") ) ;;
+            login) COMPREPLY=( $(compgen -W ""--client" "--mtls" "--passcode" "--plain" "--save-refresh-token" "--subdomain" "--user"" -- "$current") ) ;;
+            logout) COMPREPLY=( $(compgen -W ""--clear-invalid" "--delete-settings" "--subdomain" "--url"" -- "$current") ) ;;
+            minify) COMPREPLY=( $(compgen -W ""--cleanse" "--debug" "--dry" "--inspect" "--keep" "--skip"" -- "$current") ) ;;
+            mock) COMPREPLY=( $(compgen -W ""--at" "--from" "--in-memory" "--in-memory?" "--mocked" "--port" "--project" "--projects" "--resolve-bindings" "--service" "--to" "--watch" "--with" "--with-bindings" "--with-mocks" "--with-mtx" "--workers"" -- "$current") ) ;;
+            parse) COMPREPLY=( $(compgen -W ""--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"" -- "$current") ) ;;
+            pull) COMPREPLY=( $(compgen -W ""--client" "--from" "--mtls" "--passcode" "--subdomain" "--user"" -- "$current") ) ;;
+            push) COMPREPLY=( $(compgen -W ""--async" "--client" "--mtls" "--passcode" "--subdomain" "--sync" "--to" "--user"" -- "$current") ) ;;
+            repl) COMPREPLY=( $(compgen -W ""--ql" "--run" "--use"" -- "$current") ) ;;
+            run) COMPREPLY=( $(compgen -W ""--at" "--from" "--in-memory" "--in-memory?" "--mocked" "--port" "--project" "--projects" "--resolve-bindings" "--service" "--to" "--watch" "--with" "--with-bindings" "--with-mocks" "--with-mtx" "--workers"" -- "$current") ) ;;
+            serve) COMPREPLY=( $(compgen -W ""--at" "--from" "--in-memory" "--in-memory?" "--mocked" "--port" "--project" "--projects" "--resolve-bindings" "--service" "--to" "--watch" "--with" "--with-bindings" "--with-mocks" "--with-mtx" "--workers"" -- "$current") ) ;;
+            subscribe) COMPREPLY=( $(compgen -W ""--body" "--local" "--resolve-bindings" "--to" "--user"" -- "$current") ) ;;
+            test) COMPREPLY=( $(compgen -W ""--exclude" "--failed" "--files" "--include" "--list" "--passed" "--quiet" "--recent" "--silent" "--timeout" "--unmute" "--verbose" "--workers"" -- "$current") ) ;;
+            unsubscribe) COMPREPLY=( $(compgen -W ""--from" "--local" "--resolve-bindings" "--user"" -- "$current") ) ;;
+            up) COMPREPLY=( $(compgen -W ""--namespace" "--overlay" "--to"" -- "$current") ) ;;
+            upgrade) COMPREPLY=( $(compgen -W ""--at" "--fix" "--local" "--report" "--resolve-bindings" "--user"" -- "$current") ) ;;
+            upgrade-tenant) COMPREPLY=( $(compgen -W ""--at" "--local" "--resolve-bindings" "--user"" -- "$current") ) ;;
+            version) COMPREPLY=( $(compgen -W ""--abs" "--all" "--depth" "--info" "--json" "--markdown" "--omit"" -- "$current") ) ;;
+            watch) COMPREPLY=( $(compgen -W ""--debug" "--exclude" "--experimental-hot-reload" "--ext" "--in-memory" "--in-memory?" "--include" "--inspect" "--inspect-brk" "--livereload" "--open" "--port" "--with-mocks" "--with-mtx"" -- "$current") ) ;;
+        esac
+        if [[ "${#COMPREPLY[@]}" -gt 0 ]]; then
+            compopt -o nospace
+            return 0
+        fi
+    fi
+
+    # Step 3.5: option-value completion — triggered when the previous word is a known option.
+    case "$cmd" in
+        bind)
+            case "$previous" in
+            --on) COMPREPLY=( $(compgen -W ""cf" "k8s"" -- "$current") ) ; return 0 ;;
+            --out) COMPREPLY=( $(compgen -f -- "$current") ) ; return 0 ;;
+            --output-file) COMPREPLY=( $(compgen -f -- "$current") ) ; return 0 ;;
+            esac ;;
+        build)
+            case "$previous" in
+            --for) COMPREPLY=( $(compgen -W ""hana" "helm" "java" "mtx" "mtx-extension" "mtx-sidecar" "nodejs"" -- "$current") ) ; return 0 ;;
+            --log-level) COMPREPLY=( $(compgen -W ""debug" "info" "warn" "error"" -- "$current") ) ; return 0 ;;
+            --dest) COMPREPLY=( $(compgen -d -- "$current") ) ; return 0 ;;
+            --src) COMPREPLY=( $(compgen -d -- "$current") ) ; return 0 ;;
+            esac ;;
+        compile)
+            case "$previous" in
+            --to) COMPREPLY=( $(compgen -W ""json" "yml" "edm" "edmx" "edmx-v2" "edmx-v4" "sql" "hdbtable" "hana" "cdl" "xsuaa" "openapi" "asyncapi"" -- "$current") ) ; return 0 ;;
+            --for) COMPREPLY=( $(compgen -W ""odata" "sql"" -- "$current") ) ; return 0 ;;
+            --dialect) COMPREPLY=( $(compgen -W ""sqlite" "h2" "postgres" "hana"" -- "$current") ) ; return 0 ;;
+            --sql-dialect) COMPREPLY=( $(compgen -W ""sqlite" "h2" "postgres" "hana"" -- "$current") ) ; return 0 ;;
+            --log-level) COMPREPLY=( $(compgen -W ""debug" "info" "warn" "error"" -- "$current") ) ; return 0 ;;
+            --odata-version) COMPREPLY=( $(compgen -W ""4.0" "4.01"" -- "$current") ) ; return 0 ;;
+            --flavor) COMPREPLY=( $(compgen -W ""sources" "files" "parsed" "xtended" "inferred"" -- "$current") ) ; return 0 ;;
+            --service) COMPREPLY=( $(compgen -W ""all"" -- "$current") ) ; return 0 ;;
+            --lang) COMPREPLY=( $(compgen -W ""all"" -- "$current") ) ; return 0 ;;
+            --dest) COMPREPLY=( $(compgen -d -- "$current") ) ; return 0 ;;
+            esac ;;
+        completion)
+            case "$previous" in
+            --shell) COMPREPLY=( $(compgen -W ""bash" "fish" "gitbash" "ps" "zsh"" -- "$current") ) ; return 0 ;;
+            esac ;;
+        deploy)
+            case "$previous" in
+            --to) COMPREPLY=( $(compgen -W ""sqlite" "hana"" -- "$current") ) ; return 0 ;;
+            --on) COMPREPLY=( $(compgen -W ""cf" "k8s"" -- "$current") ) ; return 0 ;;
+            esac ;;
+        import)
+            case "$previous" in
+            --from) COMPREPLY=( $(compgen -W ""asyncapi" "edmx" "openapi"" -- "$current") ) ; return 0 ;;
+            --as) COMPREPLY=( $(compgen -W ""cds" "csn" "json"" -- "$current") ) ; return 0 ;;
+            esac ;;
+        init)
+            case "$previous" in
+            --java:package) COMPREPLY=( $(compgen -d -- "$current") ) ; return 0 ;;
+            esac ;;
+        inspect)
+            case "$previous" in
+            --kind) COMPREPLY=( $(compgen -W ""entity" "aspect" "type" "service"" -- "$current") ) ; return 0 ;;
+            esac ;;
+        parse)
+            case "$previous" in
+            --to) COMPREPLY=( $(compgen -W ""json" "yml" "edm" "edmx" "edmx-v2" "edmx-v4" "sql" "hdbtable" "hana" "cdl" "xsuaa" "openapi" "asyncapi"" -- "$current") ) ; return 0 ;;
+            --for) COMPREPLY=( $(compgen -W ""odata" "sql"" -- "$current") ) ; return 0 ;;
+            --dialect) COMPREPLY=( $(compgen -W ""sqlite" "h2" "postgres" "hana"" -- "$current") ) ; return 0 ;;
+            --sql-dialect) COMPREPLY=( $(compgen -W ""sqlite" "h2" "postgres" "hana"" -- "$current") ) ; return 0 ;;
+            --log-level) COMPREPLY=( $(compgen -W ""debug" "info" "warn" "error"" -- "$current") ) ; return 0 ;;
+            --odata-version) COMPREPLY=( $(compgen -W ""4.0" "4.01"" -- "$current") ) ; return 0 ;;
+            --flavor) COMPREPLY=( $(compgen -W ""sources" "files" "parsed" "xtended" "inferred"" -- "$current") ) ; return 0 ;;
+            --service) COMPREPLY=( $(compgen -W ""all"" -- "$current") ) ; return 0 ;;
+            --lang) COMPREPLY=( $(compgen -W ""all"" -- "$current") ) ; return 0 ;;
+            --dest) COMPREPLY=( $(compgen -d -- "$current") ) ; return 0 ;;
+            esac ;;
+        up)
+            case "$previous" in
+            --to) COMPREPLY=( $(compgen -W ""cf" "k8s"" -- "$current") ) ; return 0 ;;
+            esac ;;
+        version)
+            case "$previous" in
+            --omit) COMPREPLY=( $(compgen -W ""dev" "optional" "peer"" -- "$current") ) ; return 0 ;;
+            esac ;;
+        watch)
+            case "$previous" in
+            --experimental-hot-reload) COMPREPLY=( $(compgen -W ""true" "false"" -- "$current") ) ; return 0 ;;
+            --livereload) COMPREPLY=( $(compgen -W ""false"" -- "$current") ) ; return 0 ;;
+            --include) COMPREPLY=( $(compgen -d -- "$current") ) ; return 0 ;;
+            --exclude) COMPREPLY=( $(compgen -d -- "$current") ) ; return 0 ;;
+            esac ;;
+
+    esac
+
+    # Step 3.6: comma-separated option-value completion.
+    # Splits $current on commas, filters out already-used values, prepends the prefix.
+    case "$cmd" in
+        add)
+            case "$previous" in
+            *)
+                [[ "$previous" == -* ]] && return 0
+                local prefix="" partial="" IFS=,
+                if [[ "$current" == *,* ]]; then
+                    prefix="${current%,*},"
+                    partial="${current##*,}"
+                else
+                    partial="$current"
+                fi
+                local -a _used
+                read -ra _used <<< "${prefix%,}"
+                local _all=("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")
+                for v in "${_all[@]}"; do
+                    [[ " ${_used[*]} " == *" $v "* ]] && continue
+                    [[ "$v" == "$partial"* ]] && COMPREPLY+=("$prefix$v")
+                done
+                [[ ${#COMPREPLY[@]} -gt 0 ]] && { compopt -o nospace; return 0; } ;;
+            esac ;;
+        init)
+            case "$previous" in
+            --add)
+                local prefix="" partial="" IFS=,
+                if [[ "$current" == *,* ]]; then
+                    prefix="${current%,*},"
+                    partial="${current##*,}"
+                else
+                    partial="$current"
+                fi
+                local -a _used
+                read -ra _used <<< "${prefix%,}"
+                local _all=("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")
+                for v in "${_all[@]}"; do
+                    [[ " ${_used[*]} " == *" $v "* ]] && continue
+                    [[ "$v" == "$partial"* ]] && COMPREPLY+=("$prefix$v")
+                done
+                [[ ${#COMPREPLY[@]} -gt 0 ]] && { compopt -o nospace; return 0; } ;;
+            esac ;;
+
+    esac
+
+    # Step 4: file-sentinel positionals — fill COMPREPLY with files and return.
+    case "$cmd" in
+            compile) COMPREPLY=( $(compgen -f -- "$current" | grep -E '\.(cds|json)$') ) ;;
+            deploy) COMPREPLY=( $(compgen -f -- "$current" | grep -E '\.(cds|json)$') ) ;;
+            import) COMPREPLY=( $(compgen -f -- "$current" | grep -E '\.(json|xml|edmx)$') ) ;;
+            inspect) COMPREPLY=( $(compgen -f -- "$current" | grep -E '\.(cds|json)$') ) ;;
+            parse) COMPREPLY=( $(compgen -f -- "$current" | grep -E '\.(cds|json)$') ) ;;
+    esac
+    if [[ "${#COMPREPLY[@]}" -gt 0 ]]; then
+        compopt -o nospace
+        return 0
+    fi
+
+    # Step 4.6: string positionals (e.g. cds help <tab>).
+    case "$cmd" in
+            help) COMPREPLY=( $(compgen -W ""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"" -- "$current") ) ;;
+    esac
+    if [[ "${#COMPREPLY[@]}" -gt 0 ]]; then
+        compopt -o nospace
+        return 0
+    fi
+
+    # 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 $previous/$current prevents bare word 'h' from being interpreted
+    # as the 'help' shortcut by the completion handler before it is processed.
+    local options
+    options=$($CDS_COMMAND completion --shell bash --prev "'$previous'" --curr "'$current'" --line "'${COMP_WORDS[*]}'")
+    COMPREPLY=( $(compgen -W "${options}" -- "${current}") )
+    compopt -o nospace
+    return 0
+}
+
+# Register the completion function for the 'cds' command.
+complete -F _completeCds "$CDS_COMMAND"