# Script Kit 1.76.10 - July 2023 Release

- Download from https://www.scriptkit.com/
- Join our Discord: https://discord.gg/qnUX4XqJQd
- Sponsor to Keep Script Kit Growing ❤️ (and unlock the debugger): https://github.com/sponsors/johnlindquist/sponsorships?sponsor=johnlindquist

## Features

### Windows arm64 Build

We now have "arm64" builds for Windows: https://github.com/johnlindquist/kitapp/releases/tag/v1.76.10

> arm64 Windows limitations: Unfortunately, the "keyboard" libraries for Windows are not yet available for arm64. So, you won't be able to use snippets, "setSelectedText", and other keyboard-related features. I'd recommend AutoHotkey as a workaround until the libraries are available.

### Scripts Caching

Instead of waiting for the main menu to parse/load the scripts, the previous scripts results are now cached. This shaves off the ~100ms delay when opening the main menu from the keyboard shortcut. (There are also some clever technical tricks under the hood that would require a blog post to explain)

> Note: If you have a script that uses a shortcut which displays choices that don't change often, consider adding the `// Cache: true` metadata to the script for that extra 100ms boost.


### Scripts Grouping and `groupChoices`

Use the `//Group` metadata to group scripts together in the main menu. For example:

```js
// Group: Favorite
```

![http://res.cloudinary.com/johnlindquist/image/upload/v1687909106/clipboard/bnsocw9vxhqafkmmyivv.png](http://res.cloudinary.com/johnlindquist/image/upload/v1687909106/clipboard/bnsocw9vxhqafkmmyivv.png)

The you can search for "Favorite" from the menu to filter to the scripts with that metadata.


You can also add the `.group` property to any choice, then pass your choices to `groupChoices` to use the grouping behavior in your own scripts.

```js
// Name: Group Choices
// Cache: true

import "@johnlindquist/kit"
import { faker } from "@faker-js/faker"
import _ from "lodash"

let faang = ["Facebook", "Apple", "Amazon", "Netflix", "Google"]

let people = Array.from({ length: 25 }).map(() => {
  let name = faker.person.fullName()
  return {
    name,
    value: name,
    description: faker.color.human(),
    group: _.sample(faang), // Grouping by a random company
  }
})

let groupedChoices = groupChoices(people)

let result = await mini("Arg Group Demo", groupedChoices)
await editor(result)
```

![http://res.cloudinary.com/johnlindquist/image/upload/v1687909060/clipboard/urzyst1cz3wd6olsk7lx.png](http://res.cloudinary.com/johnlindquist/image/upload/v1687909060/clipboard/urzyst1cz3wd6olsk7lx.png)

### Flags "Submenu"

When using `flags`, pressing "right" (or `cmd+k`) now displays the available actions (AKA "flags") to the side in a separate searchable list with its own state.

This is a first pass at a "submenu" feature. We'll explore nested submenus in the future.

![http://res.cloudinary.com/johnlindquist/image/upload/v1687909291/clipboard/p7bwm9rxnhzquye3oxac.png](http://res.cloudinary.com/johnlindquist/image/upload/v1687909291/clipboard/p7bwm9rxnhzquye3oxac.png)

### Searching Off-loaded to Main Process

Previously, the searching logic was done in the renderer process. This creating some technical limitations on how we could pass results from a script to the list.

Now, you will be able pass "scored" choice results directly from the script to the list enabling you move the search logic to your script/server/API and display highlighted "scored" choices in the list. More information on this in the future.

### `// Pass` and `.pass` Metadata

The `// Pass` metadata on a script (and `.pass` property on a choice) will pass the current input of the prompt directly to the script so you can type input from the main menu that will be passed to the script.

![http://res.cloudinary.com/johnlindquist/image/upload/v1687909936/clipboard/p4bnehjxxkivrbderwhy.png](http://res.cloudinary.com/johnlindquist/image/upload/v1687909936/clipboard/p4bnehjxxkivrbderwhy.png)

```js
// Name: Grocery List
// Pass: true

import "@johnlindquist/kit"

let note = arg?.pass || (await arg("Enter an item"))

await editor(note)
```

You can also do this with your own choices by using the `.pass` property on a choice and using the `groupChoices` (as discussed above) to bring up the more advanced list.

### Choice `.miss` Property

Adding `.miss` to a choice will make the choice only appear if the search doesn't match any other choices. This is useful for showing a "No Results" choice:

```js
// Name: Miss Demo

import "@johnlindquist/kit"

await mini("Select an Item", [
  "One",
  "Two",
  {
    name: "No Choices Available",
    miss: true,
    disableSubmit: true,
    nameClassName: `text-red-500`,
  },
])
```

![http://res.cloudinary.com/johnlindquist/image/upload/v1687910247/clipboard/s2dtq4wzty61sl3ig0ym.png](http://res.cloudinary.com/johnlindquist/image/upload/v1687910247/clipboard/s2dtq4wzty61sl3ig0ym.png)

## Choice `.skip` Property

Using `.skip` allows you to create a choice that can't be searched/selected:

> Note: This is used internally for the "groupChoice()" headers

```js
// Name: Separator Demo

import "@johnlindquist/kit"

await arg("A demo for skip", [
  "Apple",
  "Banana",
  "Cherry",
  {
    name: "Separator",
    height: PROMPT.ITEM.HEIGHT.XXXS,
    html: `<div class="border-t border-gray-200 w-full"></div>`,
    skip: true,
  },
  "Celery",
  "Cucumber",
  "Lettuce",
])
```

## Thanks for Using Script Kit!

Happy Scripting!

\- John Lindquist