@seamapi/cli 0.11.0 → 0.13.0

package/lib/command-spec.js

@@ -0,0 +1,290 @@
+export const globalFlags = [
+    {
+        long: 'help',
+        short: 'h',
+        description: 'Display this help guide.',
+        values: [],
+        takesValue: false,
+        isRequired: false,
+    },
+    {
+        long: 'interactive',
+        short: 'i',
+        description: 'Always prompt to review and edit properties, prefilled with the given arguments.',
+        values: [],
+        takesValue: false,
+        isRequired: false,
+    },
+    {
+        long: 'json',
+        short: null,
+        description: 'Write the response to stdout as JSON. Enabled automatically when stdout is not a terminal, disable with --no-json.',
+        values: [],
+        takesValue: false,
+        isRequired: false,
+    },
+    {
+        long: 'non-interactive',
+        short: 'y',
+        description: 'Never prompt: exit with an error if the command or any required property is missing.',
+        values: [],
+        takesValue: false,
+        isRequired: false,
+    },
+    {
+        long: 'remote-api-defs',
+        short: null,
+        description: 'Use the API definitions served by the Seam API.',
+        values: [],
+        takesValue: false,
+        isRequired: false,
+    },
+    {
+        long: 'update',
+        short: null,
+        description: 'Force an update of the cached Seam API definitions.',
+        values: [],
+        takesValue: false,
+        isRequired: false,
+    },
+    {
+        long: 'version',
+        short: null,
+        description: 'Print the CLI version.',
+        values: [],
+        takesValue: false,
+        isRequired: false,
+    },
+];
+export const flagTokens = (flag) => {
+    const tokens = [];
+    if (flag.long != null)
+        tokens.push(`--${flag.long}`);
+    if (flag.short != null)
+        tokens.push(`-${flag.short}`);
+    return tokens;
+};
+export const getCommandSpec = (blueprint) => {
+    const commands = sortByPath(dedupeByPath([
+        ...blueprint.routes
+            .flatMap((route) => route.endpoints)
+            .map(toCommandDefinition)
+            // Command and flag names end up unquoted or single-quoted in shell
+            // scripts, so drop any the definitions should never contain rather
+            // than emit something a shell could read as syntax.
+            .filter((command) => command.path.every(isSafeToken)),
+        ...localCommands,
+    ]));
+    return { commands, groups: toCommandGroups(commands), globalFlags };
+};
+export const findCommand = (spec, path) => spec.commands.find((command) => isSamePath(command.path, path));
+export const findGroup = (spec, path) => spec.groups.find((group) => isSamePath(group.path, path));
+const isSamePath = (a, b) => a.length === b.length && a.every((word, index) => word === b[index]);
+const stringFlag = (long, description) => ({
+    long,
+    short: null,
+    description,
+    values: [],
+    takesValue: true,
+    isRequired: false,
+});
+/**
+ * Commands handled by the CLI itself, which have no endpoint in the blueprint.
+ *
+ * Keep in sync with the command handling in `src/bin/cli.ts` and the extra
+ * commands offered by `interactForCommandSelection`.
+ */
+const localCommands = [
+    {
+        path: ['completion', 'bash'],
+        kind: 'cli',
+        title: 'Print the bash completion script.',
+        description: '',
+        flags: [],
+    },
+    {
+        path: ['completion', 'fish'],
+        kind: 'cli',
+        title: 'Print the fish completion script.',
+        description: '',
+        flags: [],
+    },
+    {
+        path: ['completion', 'zsh'],
+        kind: 'cli',
+        title: 'Print the zsh completion script.',
+        description: '',
+        flags: [],
+    },
+    {
+        path: ['config', 'reveal-location'],
+        kind: 'cli',
+        title: 'Print the path to the CLI configuration file.',
+        description: '',
+        flags: [],
+    },
+    {
+        path: ['config', 'use-remote-api-defs'],
+        kind: 'cli',
+        title: 'Choose whether to use the API definitions served by Seam.',
+        description: '',
+        flags: [],
+    },
+    {
+        path: ['health', 'get-health'],
+        kind: 'api',
+        title: 'Report the health of the Seam API.',
+        description: '',
+        flags: [],
+    },
+    {
+        path: ['login'],
+        kind: 'cli',
+        title: 'Log in to Seam.',
+        description: 'Prompts for a personal access token unless one is passed with --token.',
+        flags: [
+            stringFlag('server', 'Seam API server to log in to.'),
+            stringFlag('token', 'Personal access token to log in with.'),
+            stringFlag('workspace-id', 'Workspace to select after logging in.'),
+        ],
+    },
+    {
+        path: ['logout'],
+        kind: 'cli',
+        title: 'Log out of Seam.',
+        description: '',
+        flags: [],
+    },
+    {
+        path: ['select', 'server'],
+        kind: 'cli',
+        title: 'Select the Seam API server.',
+        description: '',
+        flags: [stringFlag('server', 'Seam API server to select.')],
+    },
+    {
+        path: ['select', 'workspace'],
+        kind: 'cli',
+        title: 'Select the current workspace.',
+        description: '',
+        flags: [],
+    },
+    {
+        path: ['wizard'],
+        kind: 'cli',
+        title: 'Set up Seam in the current project.',
+        description: 'Takes a project from zero to a working Seam integration. Run seam wizard --help for its own options.',
+        flags: [],
+    },
+];
+const toCommandDefinition = (endpoint) => {
+    const description = toPlainText(endpoint.description);
+    return {
+        path: toCommandPath(endpoint.path),
+        kind: 'api',
+        title: endpoint.title === ''
+            ? firstSentence(description)
+            : toPlainText(endpoint.title),
+        description,
+        flags: [...endpoint.request.parameters]
+            .map(toCommandFlag)
+            .filter((flag) => flag.long == null || isSafeToken(flag.long))
+            .sort((a, b) => compare(a.long ?? a.short, b.long ?? b.short)),
+    };
+};
+const toCommandFlag = (parameter) => ({
+    long: toFlagName(parameter.name),
+    short: null,
+    description: toPlainText(parameter.description),
+    values: toFlagValues(parameter),
+    takesValue: true,
+    isRequired: parameter.isRequired,
+});
+const toFlagValues = (parameter) => {
+    if (parameter.format === 'enum') {
+        return parameter.values.map(({ name }) => name).filter(isSafeToken);
+    }
+    if (parameter.format === 'list' && parameter.itemFormat === 'enum') {
+        return parameter.itemEnumValues.map(({ name }) => name).filter(isSafeToken);
+    }
+    // Nothing marks parameters as boolean-only flags, so minimist reads the next
+    // argument as the value.
+    if (parameter.format === 'boolean')
+        return ['true', 'false'];
+    return [];
+};
+/**
+ * Whether a word is safe to write into a shell script. Command, flag, and
+ * enum names come from the API definitions and are embedded unquoted or
+ * single-quoted in completion scripts, so never emit one that a shell could
+ * read as syntax.
+ */
+const isSafeToken = (token) => /^[\w.:@/+-]+$/.test(token);
+const toCommandGroups = (commands) => {
+    const groups = new Map();
+    for (const command of commands) {
+        for (const [depth, name] of command.path.entries()) {
+            const key = command.path.slice(0, depth).join(' ');
+            const entries = groups.get(key) ?? new Map();
+            groups.set(key, entries);
+            // An entry is an API command if any command it holds calls the API.
+            const kind = command.kind === 'api' ? 'api' : (entries.get(name)?.kind ?? 'cli');
+            // A command and a group may share a name, e.g., a hypothetical
+            // `seam devices` alongside `seam devices list`. Prefer the command
+            // title, since it describes what running the name does.
+            if (depth === command.path.length - 1) {
+                entries.set(name, { isCommand: true, kind, description: command.title });
+                continue;
+            }
+            const entry = entries.get(name);
+            entries.set(name, {
+                isCommand: entry?.isCommand ?? false,
+                kind,
+                description: entry?.description ?? '',
+            });
+        }
+    }
+    // Groups have no description of their own in the API definitions, so name
+    // the commands they hold instead. Leave the list whole: help wraps it, and
+    // completion shortens it to fit a menu column.
+    const summarizeGroup = (key) => [...(groups.get(key)?.keys() ?? [])].join(', ');
+    return [...groups]
+        .map(([key, entries]) => ({
+        path: key === '' ? [] : key.split(' '),
+        subcommands: [...entries]
+            .map(([name, entry]) => ({
+            name,
+            kind: entry.kind,
+            description: entry.isCommand
+                ? entry.description
+                : summarizeGroup(key === '' ? name : `${key} ${name}`),
+        }))
+            .sort((a, b) => compare(a.name, b.name)),
+    }))
+        .sort((a, b) => compare(a.path.join(' '), b.path.join(' ')));
+};
+const dedupeByPath = (commands) => {
+    const byPath = new Map();
+    for (const command of commands) {
+        const key = command.path.join(' ');
+        if (byPath.has(key))
+            continue;
+        byPath.set(key, command);
+    }
+    return [...byPath.values()];
+};
+const sortByPath = (commands) => [...commands].sort((a, b) => compare(a.path.join(' '), b.path.join(' ')));
+const compare = (a, b) => (a ?? '') < (b ?? '') ? -1 : (a ?? '') > (b ?? '') ? 1 : 0;
+const toCommandPath = (path) => path.replace(/^\//, '').split('/').map(toFlagName);
+const toFlagName = (name) => name.replace(/_/g, '-');
+/** Reduce documentation markdown to a single line of prose. */
+export const toPlainText = (markdown) => markdown
+    .replace(/\[([^\]]*)\]\([^)]*\)/g, '$1')
+    .replace(/[`*]/g, '')
+    .replace(/\s+/g, ' ')
+    .trim();
+export const firstSentence = (text) => {
+    const [sentence] = text.split(/(?<=\.)\s/);
+    return sentence ?? text;
+};
+//# sourceMappingURL=command-spec.js.map

package/lib/command-spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-spec.js","sourceRoot":"","sources":["../src/lib/command-spec.ts"],"names":[],"mappings":"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"}

package/lib/completion/describe.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Reduce a description to one short line that is safe to embed in a
+ * single-quoted shell string.
+ *
+ * Completion menus give a description a single narrow column, and the shells
+ * offer no way to escape a quote inside the generated scripts, so drop any
+ * character that would end the string early. A colon goes too, since zsh reads
+ * it as the separator in a `_describe` entry.
+ */
+export declare const describeForShell: (description: string) => string;

package/lib/completion/describe.js

@@ -0,0 +1,16 @@
+import { firstSentence } from '../command-spec.js';
+import { ellipsis } from '../util/ellipsis.js';
+const maxDescriptionLength = 72;
+/**
+ * Reduce a description to one short line that is safe to embed in a
+ * single-quoted shell string.
+ *
+ * Completion menus give a description a single narrow column, and the shells
+ * offer no way to escape a quote inside the generated scripts, so drop any
+ * character that would end the string early. A colon goes too, since zsh reads
+ * it as the separator in a `_describe` entry.
+ */
+export const describeForShell = (description) => ellipsis(firstSentence(description)
+    .replace(/['"`$\\:]/g, '')
+    .trim(), maxDescriptionLength);
+//# sourceMappingURL=describe.js.map

package/lib/completion/describe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"describe.js","sourceRoot":"","sources":["../../src/lib/completion/describe.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAA;AAClD,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAA;AAE9C,MAAM,oBAAoB,GAAG,EAAE,CAAA;AAE/B;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,WAAmB,EAAU,EAAE,CAC9D,QAAQ,CACN,aAAa,CAAC,WAAW,CAAC;KACvB,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC;KACzB,IAAI,EAAE,EACT,oBAAoB,CACrB,CAAA"}

package/lib/completion/index.d.ts

@@ -0,0 +1,28 @@
+import type { Blueprint } from '@seamapi/blueprint';
+export declare const completionShells: readonly ["bash", "fish", "zsh"];
+export type CompletionShell = (typeof completionShells)[number];
+export declare const isCompletionShell: (shell: unknown) => shell is CompletionShell;
+/** File name to install the completion script for each shell as. */
+export declare const completionFileNames: Record<CompletionShell, string>;
+export declare const renderCompletion: (shell: CompletionShell, blueprint: Blueprint) => string;
+/**
+ * Render the completion loader installed by system packages.
+ *
+ * The loader runs 'seam completion' the first time the shell completes a seam
+ * command, so installed completions always match the CLI's current Seam API
+ * definitions instead of the definitions packaged at release time. Each shell
+ * loads its completion file on demand, so the CLI runs once per shell session
+ * at first completion, never at shell startup.
+ *
+ * The loader degrades to no completions when the seam command is missing or
+ * does not produce a completion script: a script is only evaluated when it
+ * starts with the exact first line 'seam completion' generates, so nothing
+ * else the CLI may print, e.g., 'Not logged in' from a version without the
+ * completion command, is ever evaluated as shell code.
+ */
+export declare const renderCompletionStub: (shell: CompletionShell) => string;
+/**
+ * First line of each generated completion script, which the loaders require
+ * before evaluating one. Must match the output of {@link renderCompletion}.
+ */
+export declare const completionScriptSentinels: Record<CompletionShell, string>;

package/lib/completion/index.js

@@ -0,0 +1,92 @@
+import { getCommandSpec } from '../command-spec.js';
+import { renderBashCompletion } from './render-bash.js';
+import { renderFishCompletion } from './render-fish.js';
+import { renderZshCompletion } from './render-zsh.js';
+export const completionShells = ['bash', 'fish', 'zsh'];
+export const isCompletionShell = (shell) => completionShells.includes(shell);
+/** File name to install the completion script for each shell as. */
+export const completionFileNames = {
+    bash: 'seam.bash',
+    fish: 'seam.fish',
+    zsh: 'seam.zsh',
+};
+const renderers = {
+    bash: renderBashCompletion,
+    fish: renderFishCompletion,
+    zsh: renderZshCompletion,
+};
+export const renderCompletion = (shell, blueprint) => renderers[shell](getCommandSpec(blueprint));
+/**
+ * Render the completion loader installed by system packages.
+ *
+ * The loader runs 'seam completion' the first time the shell completes a seam
+ * command, so installed completions always match the CLI's current Seam API
+ * definitions instead of the definitions packaged at release time. Each shell
+ * loads its completion file on demand, so the CLI runs once per shell session
+ * at first completion, never at shell startup.
+ *
+ * The loader degrades to no completions when the seam command is missing or
+ * does not produce a completion script: a script is only evaluated when it
+ * starts with the exact first line 'seam completion' generates, so nothing
+ * else the CLI may print, e.g., 'Not logged in' from a version without the
+ * completion command, is ever evaluated as shell code.
+ */
+export const renderCompletionStub = (shell) => stubs[shell];
+/**
+ * First line of each generated completion script, which the loaders require
+ * before evaluating one. Must match the output of {@link renderCompletion}.
+ */
+export const completionScriptSentinels = {
+    bash: '# bash completion for the seam command.',
+    fish: '# fish completion for the seam command.',
+    zsh: '#compdef seam',
+};
+const stubHeader = (shell) => `# ${shell} completion loader for the seam command.
+#
+# Generated by @seamapi/cli. Loads completions from the CLI on first use, so
+# they always match the CLI's current Seam API definitions. Requires the seam
+# command on PATH. Print the underlying script with 'seam completion ${shell}'.`;
+const stubs = {
+    bash: `${stubHeader('bash')}
+#
+# Install to /usr/share/bash-completion/completions/seam
+
+if command -v seam > /dev/null 2>&1; then
+  __seam_completion_script="$(seam completion bash 2> /dev/null)"
+  # Evaluate only a completion script, never anything else the CLI printed.
+  case "$__seam_completion_script" in
+    '${completionScriptSentinels.bash}'*) eval "$__seam_completion_script" ;;
+  esac
+  unset __seam_completion_script
+fi
+`,
+    fish: `${stubHeader('fish')}
+#
+# Install to /usr/share/fish/vendor_completions.d/seam.fish
+
+if command --query seam
+    set -l __seam_completion_script (seam completion fish 2> /dev/null | string collect)
+    # Source only a completion script, never anything else the CLI printed.
+    if string match --quiet '${completionScriptSentinels.fish}*' -- $__seam_completion_script
+        printf '%s\\n' $__seam_completion_script | source
+    end
+end
+`,
+    zsh: `#compdef seam
+${stubHeader('zsh')}
+#
+# Install to a directory in fpath as _seam
+
+local __seam_completion_script
+__seam_completion_script="$(seam completion zsh 2> /dev/null)"
+
+# Evaluate only a completion script, never anything else the CLI printed.
+# The script ends by dispatching on funcstack, so evaluating it while this
+# autoloaded _seam runs both redefines _seam and completes the in-flight
+# request.
+if [[ "$__seam_completion_script" == '${completionScriptSentinels.zsh}'* ]]; then
+  eval "$__seam_completion_script"
+fi
+`,
+};
+//# sourceMappingURL=index.js.map

package/lib/completion/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lib/completion/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAoB,cAAc,EAAE,MAAM,oBAAoB,CAAA;AACrE,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAErD,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAA;AAIhE,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAc,EAA4B,EAAE,CAC5E,gBAAgB,CAAC,QAAQ,CAAC,KAAwB,CAAC,CAAA;AAErD,oEAAoE;AACpE,MAAM,CAAC,MAAM,mBAAmB,GAAoC;IAClE,IAAI,EAAE,WAAW;IACjB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,UAAU;CAChB,CAAA;AAED,MAAM,SAAS,GAA2D;IACxE,IAAI,EAAE,oBAAoB;IAC1B,IAAI,EAAE,oBAAoB;IAC1B,GAAG,EAAE,mBAAmB;CACzB,CAAA;AAED,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,KAAsB,EACtB,SAAoB,EACZ,EAAE,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAA;AAExD;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,KAAsB,EAAU,EAAE,CACrE,KAAK,CAAC,KAAK,CAAC,CAAA;AAEd;;;GAGG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAoC;IACxE,IAAI,EAAE,yCAAyC;IAC/C,IAAI,EAAE,yCAAyC;IAC/C,GAAG,EAAE,eAAe;CACrB,CAAA;AAED,MAAM,UAAU,GAAG,CAAC,KAAsB,EAAU,EAAE,CACpD,KAAK,KAAK;;;;uEAI2D,KAAK,IAAI,CAAA;AAEhF,MAAM,KAAK,GAAoC;IAC7C,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;;;;;;;;OAQtB,yBAAyB,CAAC,IAAI;;;;CAIpC;IACC,IAAI,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC;;;;;;;+BAOE,yBAAyB,CAAC,IAAI;;;;CAI5D;IACC,GAAG,EAAE;EACL,UAAU,CAAC,KAAK,CAAC;;;;;;;;;;;wCAWqB,yBAAyB,CAAC,GAAG;;;CAGpE;CACA,CAAA"}

package/lib/completion/render-bash.d.ts

@@ -0,0 +1,2 @@
+import { type CommandSpec } from '../command-spec.js';
+export declare const renderBashCompletion: (spec: CommandSpec) => string;

package/lib/completion/render-bash.js

@@ -0,0 +1,98 @@
+import { flagTokens, } from '../command-spec.js';
+export const renderBashCompletion = (spec) => {
+    const globalTokens = spec.globalFlags.flatMap(flagTokens).sort();
+    const valuelessTokens = spec.globalFlags
+        .filter(({ takesValue }) => !takesValue)
+        .flatMap(flagTokens)
+        .sort();
+    return `${[
+        header,
+        `_seam_global_flags='${globalTokens.join(' ')}'`,
+        `_seam_valueless_flags=' ${valuelessTokens.join(' ')} '`,
+        renderCase('_seam_subcommands', subcommandBranches(spec)),
+        renderCase('_seam_flags', flagBranches(spec)),
+        renderCase('_seam_flag_values', flagValueBranches(spec)),
+        completionFunction,
+        'complete -F _seam_completion seam',
+    ].join('\n\n')}\n`;
+};
+const header = `# bash completion for the seam command.
+#
+# Generated by @seamapi/cli from the Seam API definitions.
+# Do not edit: regenerate with 'seam completion bash'.
+#
+# Load it for the current shell with
+#
+#   source <(seam completion bash)
+#
+# or install it for every shell with
+#
+#   seam completion bash > /usr/share/bash-completion/completions/seam`;
+const completionFunction = `_seam_completion() {
+  local current previous word command subcommands
+  local -i index
+
+  current="\${COMP_WORDS[COMP_CWORD]}"
+  previous=''
+  if (( COMP_CWORD > 0 )); then
+    previous="\${COMP_WORDS[COMP_CWORD - 1]}"
+  fi
+
+  # --flag=value splits into three words under the default word breaks.
+  if [[ "$previous" == '=' ]] && (( COMP_CWORD > 1 )); then
+    previous="\${COMP_WORDS[COMP_CWORD - 2]}"
+  fi
+
+  # The command path is the run of words before the first flag.
+  command=''
+  for (( index = 1; index < COMP_CWORD; index++ )); do
+    word="\${COMP_WORDS[index]}"
+    if [[ "$word" == -* ]]; then
+      break
+    fi
+    command="\${command:+$command }$word"
+  done
+
+  # Completing the value of a flag that takes one.
+  if [[ "$previous" == -* && "$_seam_valueless_flags" != *" $previous "* ]]; then
+    COMPREPLY=( $(compgen -W "$(_seam_flag_values "$command $previous")" -- "$current") )
+    return 0
+  fi
+
+  if [[ "$current" == -* ]]; then
+    COMPREPLY=( $(compgen -W "$(_seam_flags "$command") $_seam_global_flags" -- "$current") )
+    return 0
+  fi
+
+  subcommands="$(_seam_subcommands "$command")"
+  if [[ -z "$subcommands" ]]; then
+    COMPREPLY=( $(compgen -W "$(_seam_flags "$command") $_seam_global_flags" -- "$current") )
+    return 0
+  fi
+
+  COMPREPLY=( $(compgen -W "$subcommands" -- "$current") )
+  return 0
+}`;
+const subcommandBranches = (spec) => spec.groups.map((group) => ({
+    pattern: group.path.join(' '),
+    words: group.subcommands.map(({ name }) => name),
+}));
+const flagBranches = (spec) => spec.commands
+    .filter(({ flags }) => flags.length > 0)
+    .map((command) => ({
+    pattern: command.path.join(' '),
+    words: command.flags.flatMap(flagTokens),
+}));
+const flagValueBranches = (spec) => spec.commands.flatMap((command) => command.flags.filter(hasValues).flatMap((flag) => flagTokens(flag).map((token) => ({
+    pattern: `${command.path.join(' ')} ${token}`,
+    words: flag.values,
+}))));
+const hasValues = (flag) => flag.values.length > 0;
+const renderCase = (name, branches) => [
+    `${name}() {`,
+    `  case "$1" in`,
+    ...branches.map(({ pattern, words }) => `    '${pattern}') echo '${words.join(' ')}' ;;`),
+    `  esac`,
+    `}`,
+].join('\n');
+//# sourceMappingURL=render-bash.js.map

package/lib/completion/render-bash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-bash.js","sourceRoot":"","sources":["../../src/lib/completion/render-bash.ts"],"names":[],"mappings":"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"}

package/lib/completion/render-fish.d.ts

@@ -0,0 +1,2 @@
+import type { CommandSpec } from '../command-spec.js';
+export declare const renderFishCompletion: (spec: CommandSpec) => string;

package/lib/completion/render-fish.js

@@ -0,0 +1,58 @@
+import { describeForShell } from './describe.js';
+export const renderFishCompletion = (spec) => `${[
+    header,
+    helpers,
+    ['complete -c seam -f', ...subcommandCompletions(spec)].join('\n'),
+    flagCompletions(spec).join('\n'),
+    globalFlagCompletions(spec).join('\n'),
+].join('\n\n')}\n`;
+const header = `# fish completion for the seam command.
+#
+# Generated by @seamapi/cli from the Seam API definitions.
+# Do not edit: regenerate with 'seam completion fish'.
+#
+# Install it with
+#
+#   seam completion fish > ~/.config/fish/completions/seam.fish`;
+const helpers = `function __seam_command --description 'Print the seam command path on the command line'
+    set -l tokens (commandline -opc)
+    set -l command
+    if test (count $tokens) -gt 1
+        # The command path is the run of words before the first flag.
+        for token in $tokens[2..-1]
+            if string match -q -- '-*' $token
+                break
+            end
+            set -a command $token
+        end
+    end
+    string join ' ' -- $command
+end
+
+function __seam_using --description 'Test whether the command line names the given seam command'
+    set -l command (__seam_command)
+    test "$command" = "$argv[1]"
+end`;
+const subcommandCompletions = (spec) => spec.groups.flatMap((group) => group.subcommands.map(({ name, description }) => complete([
+    `-n '__seam_using "${group.path.join(' ')}"'`,
+    `-a '${name}'`,
+    describe(description),
+])));
+const flagCompletions = (spec) => spec.commands.flatMap((command) => command.flags.map((flag) => complete([
+    `-n '__seam_using "${command.path.join(' ')}"'`,
+    ...flagOptions(flag),
+])));
+const globalFlagCompletions = (spec) => spec.globalFlags.map((flag) => complete(flagOptions(flag)));
+const flagOptions = (flag) => [
+    ...(flag.short == null ? [] : [`-s ${flag.short}`]),
+    ...(flag.long == null ? [] : [`-l ${flag.long}`]),
+    ...(flag.takesValue ? ['-r'] : []),
+    ...(flag.values.length === 0 ? [] : [`-a '${flag.values.join(' ')}'`]),
+    describe(flag.description),
+];
+const describe = (description) => {
+    const summary = describeForShell(description);
+    return summary === '' ? '' : `-d '${summary}'`;
+};
+const complete = (options) => ['complete -c seam', ...options.filter((option) => option !== '')].join(' ');
+//# sourceMappingURL=render-fish.js.map

package/lib/completion/render-fish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-fish.js","sourceRoot":"","sources":["../../src/lib/completion/render-fish.ts"],"names":[],"mappings":"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"}

package/lib/completion/render-zsh.d.ts

@@ -0,0 +1,2 @@
+import { type CommandSpec } from '../command-spec.js';
+export declare const renderZshCompletion: (spec: CommandSpec) => string;