[READ-ONLY] Mirror of https://github.com/bombshell-dev/docs.
bomb.sh/docs
docs(clack): document showInstructions opt-out (#59)
authored by
paul valladares
and committed by
GitHub
(Jul 3, 2026, 8:03 PM -0500)
cd8496ce
3860be3c
+39
-14
+2
-2
package.json
+2
-2
package.json
···
16
16
"dependencies": {
17
17
"@astrojs/starlight": "^0.37.1",
18
18
"@bomb.sh/args": "^0.3.1",
19
-
"@clack/core": "^1.4.0",
20
-
"@clack/prompts": "^1.5.0",
19
+
"@clack/core": "^1.4.3",
20
+
"@clack/prompts": "^1.7.0",
21
21
"@types/node": "^22.19.3",
22
22
"@webcontainer/api": "^1.6.1",
23
23
"@webcontainer/snapshot": "^0.1.0",
+12
-11
pnpm-lock.yaml
+12
-11
pnpm-lock.yaml
···
15
15
specifier: ^0.3.1
16
16
version: 0.3.1
17
17
'@clack/core':
18
-
specifier: ^1.4.0
19
-
version: 1.4.0
18
+
specifier: ^1.4.3
19
+
version: 1.4.3
20
20
'@clack/prompts':
21
-
specifier: ^1.5.0
22
-
version: 1.5.0
21
+
specifier: ^1.7.0
22
+
version: 1.7.0
23
23
'@types/node':
24
24
specifier: ^22.19.3
25
25
version: 22.19.3
···
140
140
resolution: {integrity: sha512-8XqW8xGn++Eqqbz3e9wKuK7mxryeRjs4LOHLxbh2lwKeSbuNR4NFifDZT4KzvjU6HMOPbiNTsWpniK5EJfTWkg==}
141
141
engines: {node: '>=18'}
142
142
143
-
'@clack/core@1.4.0':
144
-
resolution: {integrity: sha512-7Wctjq6f7c1CPz8sPpkwUnz8yRgVANkpNupb81q432FjcJg4l+Sw7XANdNSdWfAKq0IHI0JTcUeK5dxs/HrGPw==}
143
+
'@clack/core@1.4.3':
144
+
resolution: {integrity: sha512-/kr3UWNtdJfxZtPgDqUOmG2pvwlmcLGheex5yiZKdwbzZJxhV+HMNR9QNmyY5cGwTNV6LrR7Jtp+KjhUAP1qBQ==}
145
145
engines: {node: '>= 20.12.0'}
146
146
147
-
'@clack/prompts@1.5.0':
148
-
resolution: {integrity: sha512-wKh+wTjmrUoUdkZg8KpJO5X+p9PWV+KE9mePseq9UYWkukgTKsGS47RRL2HstwVcvDQH+PenrPJWII8+MfiiyA==}
147
+
'@clack/prompts@1.7.0':
148
+
resolution: {integrity: sha512-y7/yvZ2TPAnR9+jnc00klvNNLkJiXFFrQA/hlLCcxA9a2A4zQIOimyFQ9XfwYKiGD1fb5GY8vbKIIgO8d5Tb2A==}
149
149
engines: {node: '>= 20.12.0'}
150
150
151
151
'@cloudflare/kv-asset-handler@0.4.2':
···
2210
2210
tsconfck@3.1.6:
2211
2211
resolution: {integrity: sha512-ks6Vjr/jEw0P1gmOVwutM3B7fWxoWBL2KRDb1JfqGVawBmO5UsvmWOQFGHBPl5yxYz4eERr19E6L7NMv+Fej4w==}
2212
2212
engines: {node: ^18 || >=20}
2213
+
deprecated: unmaintained
2213
2214
hasBin: true
2214
2215
peerDependencies:
2215
2216
typescript: ^5.0.0
···
2669
2670
dependencies:
2670
2671
fontkit: 2.0.4
2671
2672
2672
-
'@clack/core@1.4.0':
2673
+
'@clack/core@1.4.3':
2673
2674
dependencies:
2674
2675
fast-wrap-ansi: 0.2.0
2675
2676
sisteransi: 1.0.5
2676
2677
2677
-
'@clack/prompts@1.5.0':
2678
+
'@clack/prompts@1.7.0':
2678
2679
dependencies:
2679
-
'@clack/core': 1.4.0
2680
+
'@clack/core': 1.4.3
2680
2681
fast-string-width: 3.0.2
2681
2682
fast-wrap-ansi: 0.2.0
2682
2683
sisteransi: 1.0.5
+25
-1
src/content/docs/clack/packages/prompts.mdx
+25
-1
src/content/docs/clack/packages/prompts.mdx
···
198
198
199
199
### Selection
200
200
201
-
`select`, `multiselect`, and `groupMultiselect` show persistent keyboard hint footers while active (v1.6.0), matching `autocomplete`. There is no option to disable them.
201
+
`select`, `multiselect`, and `groupMultiselect` show persistent keyboard hint footers while active (v1.6.0), matching `autocomplete`. Pass `showInstructions: false` to hide them (v1.7.0). Default: `true`.
202
202
203
203
#### Simple value
204
204
···
222
222
<font color="#06989A">│</font> ○ Astro (Content-focused)
223
223
<font color="#06989A">│</font> ○ SvelteKit (Compile-time framework)
224
224
<font color="#06989A">│</font> <font color="#AAAAAA">↑/↓ to navigate • Enter: confirm</font>
225
+
<font color="#06989A">└</font></pre>
226
+
227
+
#### Hide instructions
228
+
229
+
```ts twoslash
230
+
import { select } from '@clack/prompts';
231
+
232
+
const framework = await select({
233
+
message: 'Pick a framework',
234
+
options: [
235
+
{ value: 'next', label: 'Next.js', hint: 'React framework' },
236
+
{ value: 'astro', label: 'Astro', hint: 'Content-focused' },
237
+
{ value: 'svelte', label: 'SvelteKit', hint: 'Compile-time framework' },
238
+
],
239
+
showInstructions: false,
240
+
});
241
+
```
242
+
243
+
<pre class="cli-preview"><font color="#555753">│</font>
244
+
<font color="#06989A">◆</font> Pick a framework
245
+
<font color="#06989A">│</font> <font color="#4E9A06">●</font> Next.js (React framework)
246
+
<font color="#06989A">│</font> ○ Astro (Content-focused)
247
+
<font color="#06989A">│</font> ○ SvelteKit (Compile-time framework)
225
248
<font color="#06989A">└</font></pre>
226
249
227
250
#### Complex value
···
607
630
- `cursorAt`: The value the cursor should be positioned at initially.
608
631
- `selectableGroups`: Whether entire groups can be selected at once (default: `true`).
609
632
- `groupSpacing`: Number of blank lines between groups (default: `0`).
633
+
- `showInstructions`: Whether to show keyboard instructions below the option list (default: `true`) (v1.7.0).
610
634
- All [Common Options](#common-options)
611
635
612
636
### Group