@nordicsemiconductor/pc-nrfconnect-shared 220.0.0 → 223.0.0

package/Changelog.md

@@ -7,6 +7,33 @@ This project does _not_ adhere to
 [Semantic Versioning](https://semver.org/spec/v2.0.0.html) but contrary to it
 every new version is a new major version.
 
+## 223.0.0 - 2025-07-28
+
+### Changed
+
+-   Return value of `getDownloadableApps` has less fields now and some more
+    exports were removed, because they were only needed in the launcher and
+    having them in shared made changes harder in the launcher.
+
+## 222.0.0 - 2025-07-23
+
+### Added
+
+-   Automatic publishing of shared.
+
+## 221.0.0 - 2025-07-21
+
+### Added
+
+-   Custom tailwind font-size `text-2xs` (0.625rem/10px).
+-   Narrower Dropdown variant.
+-   Automatic character limit derivation for number input components based on
+    their range constraints.
+
+### Fixed
+
+-   Running build scripts failed on Windows.
+
 ## 220.0.0 - 2025-07-16
 
 ### Added

package/README.md

@@ -1,7 +1,5 @@
 # Shared commodities for developing nRF Connect for Desktop
 
-[![Build Status](https://dev.azure.com/NordicSemiconductor/Wayland/_apis/build/status/pc-nrfconnect-shared?branchName=master)](https://dev.azure.com/NordicSemiconductor/Wayland/_build/latest?definitionId=31&branchName=master)
-
 This project provides shared commodities for developing nRF Connect for Desktop
 apps and their launcher:
 
@@ -10,30 +8,41 @@ apps and their launcher:
 -   Configurations
 -   Test facilities
 
+## Developing a new feature or fixing an error
+
+Whenever something is changed in pc-nrfconnect-shared, an entry should be added
+to `Changelog.md`.
+
+If there is no latest entry there yet, and you do not intend to release the
+change as a new version right ahead, add a new section with the heading
+`## Unreleased` at the top.
+
 ## Releasing
 
-This project uses GitHub Actions for automated releases. To release a new
-version:
+To release, two files must be up-to-date:
+
+-   `package.json` contain the correct version number (one more than the last
+    release).
+-   `Changelog.md` must contain an entry, with that version number and today's
+    date.
 
-### Prepare the release
+By running `npm run prepare-shared-release` you update the version in
+`package.json` and in `Changelog.md` a potential `## Unreleased` heading is
+updated to the right version and today‘s date.
 
--   Update the version in `package.json`.
--   Add a changelog entry in `Changelog.md` with the format:
-    `## X.0.0 - YYYY-MM-DD`.
--   Commit and push your changes
+When those conditions are met, a new release of shared will automatically be
+created when the according PR is merged into main.
 
-### Create the release
+## Unpublishing a version
 
--   Go to the the
-    [Release shared](https://github.com/NordicSemiconductor/pc-nrfconnect-shared/actions/workflows/release-shared.yml)
-    action.
--   Click "Run workflow".
--   Optionally select a ref to release, but usually this should be `main` and
-    can be left empty.
+If you need to unpublish a specific version from npm (e.g., due to a critical
+bug), you can use the "Unpublish npm version" GitHub Action:
 
-The workflow will:
+1. Go to the
+   [Unpublish npm version GitHub Action](https://github.com/NordicSemiconductor/pc-nrfconnect-shared/actions/workflows/unpublish-npm-version.yml)
+   and run the workflow.
+1. Enter the version to unpublish (e.g., `221.0.0`)
 
--   Check if a release is possible.
--   Build and test the package.
--   Create a GitHub release.
--   Publish to npm.
+**Warning:** Unpublishing a version from npm is irreversible and should only be
+done in exceptional circumstances (e.g., security vulnerabilities, critical
+bugs).

package/config/tailwind.config.js

@@ -16,7 +16,11 @@ module.exports = {
     ],
     theme: {
         colors,
-        extend: {},
+        extend: {
+            fontSize: {
+                '2xs': '0.625rem', // 10px
+            },
+        },
     },
     corePlugins: {
         preflight: false,

package/ipc/apps.ts

@@ -11,7 +11,7 @@ import type {
     NrfutilModuleVersion,
     UrlString,
 } from './MetaFiles';
-import { LOCAL, Source, SourceName } from './sources';
+import { LOCAL, SourceName } from './sources';
 
 export interface AppSpec {
     name: string;
@@ -75,18 +75,11 @@ export type LaunchableApp = LocalApp | InstalledDownloadableApp | WithdrawnApp;
 
 export type App = LocalApp | DownloadableApp;
 
-export interface AppWithError extends AppSpec {
-    reason: unknown;
-    path: string;
-}
-
-const channel = {
+export const channel = {
     getDownloadableApps: 'apps:get-downloadable-apps',
     installDownloadableApp: 'apps:install-downloadable-app',
 };
 
-export type SourceWithError = { source: Source; reason?: string };
-
 export const isDownloadable = (app?: App): app is DownloadableApp =>
     app != null && app?.source !== LOCAL;
 
@@ -115,10 +108,8 @@ export const isUpdatable = (app?: App): app is InstalledDownloadableApp =>
         latestVersionHasDifferentChecksum(app));
 
 // getDownloadableApps
-type GetDownloadableAppsResult = {
+export type GetDownloadableAppsResult = {
     apps: DownloadableApp[];
-    appsWithErrors: AppWithError[];
-    sourcesWithErrors: SourceWithError[];
 };
 
 type GetDownloadableApps = () => GetDownloadableAppsResult;

package/ipc/sources.ts

@@ -4,16 +4,11 @@
  * SPDX-License-Identifier: LicenseRef-Nordic-4-Clause
  */
 
-import { UrlString } from './MetaFiles';
-
 enum StandardSourceNames {
     OFFICIAL = 'official',
     LOCAL = 'local',
 }
 
 export const { LOCAL, OFFICIAL } = StandardSourceNames;
-export const allStandardSourceNames: SourceName[] = [OFFICIAL, LOCAL];
 
 export type SourceName = string;
-export type SourceUrl = UrlString;
-export type Source = { name: SourceName; url: SourceUrl };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@nordicsemiconductor/pc-nrfconnect-shared",
-    "version": "220.0.0",
+    "version": "223.0.0",
     "description": "Shared commodities for developing pc-nrfconnect-* packages",
     "repository": {
         "type": "git",

package/release_notes.md

@@ -1,8 +1,5 @@
-### Added
-
--   Option to persist the Group collapse state.
-
 ### Changed
 
--   Use `tsx` instead of `ts-node`.
--   Switched releasing shared from Azure to GitHub Actions.
+-   Return value of `getDownloadableApps` has less fields now and some more
+    exports were removed, because they were only needed in the launcher and
+    having them in shared made changes harder in the launcher.

package/scripts/check-app-properties.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2022 Nordic Semiconductor ASA

package/scripts/check-for-typescript.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2015 Nordic Semiconductor ASA

package/scripts/create-source.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2025 Nordic Semiconductor ASA

package/scripts/esbuild.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 /*
  * Copyright (c) 2015 Nordic Semiconductor ASA
  *

package/scripts/installHusky.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2022 Nordic Semiconductor ASA

package/scripts/is-releasable.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2025 Nordic Semiconductor ASA
@@ -18,7 +18,7 @@ import getReleaseNumbers from './get-release-numbers';
 import { getLatestEntry } from './latest-changelog-entry';
 
 const fail = (message: string) => {
-    console.log(`::error::${message}`);
+    console.log(message);
     process.exit(1);
 };
 

package/scripts/latest-changelog-entry.test.ts

@@ -7,7 +7,7 @@
 import { getLatestEntry } from './latest-changelog-entry';
 
 describe('getLatestEntry', () => {
-    it('should extract the latest changelog entry correctly', () => {
+    it('extracts the latest changelog entry', () => {
         const changelog = `# Changelog
 
 All notable changes to this project will be documented in this file.
@@ -29,7 +29,7 @@ All notable changes to this project will be documented in this file.
         expect(result.content).toBe('### Changed\n\n-   Something');
     });
 
-    it('should handle changelog with only one entry', () => {
+    it('handles changelog with only one entry', () => {
         const changelog = `# Changelog
 
 All notable changes to this project will be documented in this file.
@@ -46,7 +46,7 @@ All notable changes to this project will be documented in this file.
         expect(result.content).toBe('### Added\n\n-   Something else');
     });
 
-    it('should handle changelog with empty content', () => {
+    it('handles changelog with empty content', () => {
         const changelog = `# Changelog
 
 All notable changes to this project will be documented in this file.
@@ -65,7 +65,7 @@ All notable changes to this project will be documented in this file.
         expect(result.content).toBe('');
     });
 
-    it('should handle changelog with nothing before the first entry', () => {
+    it('handles changelog with nothing before the first entry', () => {
         const changelog = `## 33.0.0 - 2022-02-01
 
 ### Added

package/scripts/latest-changelog-entry.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2025 Nordic Semiconductor ASA

package/scripts/nordic-publish.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 "use strict";var Cd=Object.create;var Us=Object.defineProperty;var gd=Object.getOwnPropertyDescriptor;var Dd=Object.getOwnPropertyNames;var _d=Object.getPrototypeOf,Bd=Object.prototype.hasOwnProperty;var A=(t,e)=>()=>(e||t((e={exports:{}}).exports,e),e.exports);var yd=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of Dd(e))!Bd.call(t,i)&&i!==r&&Us(t,i,{get:()=>e[i],enumerable:!(n=gd(e,i))||n.enumerable});return t};var Dt=(t,e,r)=>(r=t!=null?Cd(_d(t)):{},yd(e||!t||!t.__esModule?Us(r,"default",{value:t,enumerable:!0}):r,t));var jr=A(pi=>{var Cn=class extends Error{constructor(e,r,n){super(n),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name,this.code=r,this.exitCode=e,this.nestedError=void 0}},hi=class extends Cn{constructor(e){super(1,"commander.invalidArgument",e),Error.captureStackTrace(this,this.constructor),this.name=this.constructor.name}};pi.CommanderError=Cn;pi.InvalidArgumentError=hi});var gn=A(Fi=>{var{InvalidArgumentError:vd}=jr(),Ai=class{constructor(e,r){switch(this.description=r||"",this.variadic=!1,this.parseArg=void 0,this.defaultValue=void 0,this.defaultValueDescription=void 0,this.argChoices=void 0,e[0]){case"<":this.required=!0,this._name=e.slice(1,-1);break;case"[":this.required=!1,this._name=e.slice(1,-1);break;default:this.required=!0,this._name=e;break}this._name.length>3&&this._name.slice(-3)==="..."&&(this.variadic=!0,this._name=this._name.slice(0,-3))}name(){return this._name}_concatValue(e,r){return r===this.defaultValue||!Array.isArray(r)?[e]:r.concat(e)}default(e,r){return this.defaultValue=e,this.defaultValueDescription=r,this}argParser(e){return this.parseArg=e,this}choices(e){return this.argChoices=e.slice(),this.parseArg=(r,n)=>{if(!this.argChoices.includes(r))throw new vd(`Allowed choices are ${this.argChoices.join(", ")}.`);return this.variadic?this._concatValue(r,n):r},this}argRequired(){return this.required=!0,this}argOptional(){return this.required=!1,this}};function bd(t){let e=t.name()+(t.variadic===!0?"...":"");return t.required?"<"+e+">":"["+e+"]"}Fi.Argument=Ai;Fi.humanReadableArgName=bd});var mi=A(Hs=>{var{humanReadableArgName:xd}=gn(),Ei=class{constructor(){this.helpWidth=void 0,this.sortSubcommands=!1,this.sortOptions=!1,this.showGlobalOptions=!1}visibleCommands(e){let r=e.commands.filter(n=>!n._hidden);if(e._hasImplicitHelpCommand()){let[,n,i]=e._helpCommandnameAndArgs.match(/([^ ]+) *(.*)/),s=e.createCommand(n).helpOption(!1);s.description(e._helpCommandDescription),i&&s.arguments(i),r.push(s)}return this.sortSubcommands&&r.sort((n,i)=>n.name().localeCompare(i.name())),r}compareOptions(e,r){let n=i=>i.short?i.short.replace(/^-/,""):i.long.replace(/^--/,"");return n(e).localeCompare(n(r))}visibleOptions(e){let r=e.options.filter(s=>!s.hidden),n=e._hasHelpOption&&e._helpShortFlag&&!e._findOption(e._helpShortFlag),i=e._hasHelpOption&&!e._findOption(e._helpLongFlag);if(n||i){let s;n?i?s=e.createOption(e._helpFlags,e._helpDescription):s=e.createOption(e._helpShortFlag,e._helpDescription):s=e.createOption(e._helpLongFlag,e._helpDescription),r.push(s)}return this.sortOptions&&r.sort(this.compareOptions),r}visibleGlobalOptions(e){if(!this.showGlobalOptions)return[];let r=[];for(let n=e.parent;n;n=n.parent){let i=n.options.filter(s=>!s.hidden);r.push(...i)}return this.sortOptions&&r.sort(this.compareOptions),r}visibleArguments(e){return e._argsDescription&&e._args.forEach(r=>{r.description=r.description||e._argsDescription[r.name()]||""}),e._args.find(r=>r.description)?e._args:[]}subcommandTerm(e){let r=e._args.map(n=>xd(n)).join(" ");return e._name+(e._aliases[0]?"|"+e._aliases[0]:"")+(e.options.length?" [options]":"")+(r?" "+r:"")}optionTerm(e){return e.flags}argumentTerm(e){return e.name()}longestSubcommandTermLength(e,r){return r.visibleCommands(e).reduce((n,i)=>Math.max(n,r.subcommandTerm(i).length),0)}longestOptionTermLength(e,r){return r.visibleOptions(e).reduce((n,i)=>Math.max(n,r.optionTerm(i).length),0)}longestGlobalOptionTermLength(e,r){return r.visibleGlobalOptions(e).reduce((n,i)=>Math.max(n,r.optionTerm(i).length),0)}longestArgumentTermLength(e,r){return r.visibleArguments(e).reduce((n,i)=>Math.max(n,r.argumentTerm(i).length),0)}commandUsage(e){let r=e._name;e._aliases[0]&&(r=r+"|"+e._aliases[0]);let n="";for(let i=e.parent;i;i=i.parent)n=i.name()+" "+n;return n+r+" "+e.usage()}commandDescription(e){return e.description()}subcommandDescription(e){return e.summary()||e.description()}optionDescription(e){let r=[];return e.argChoices&&r.push(`choices: ${e.argChoices.map(n=>JSON.stringify(n)).join(", ")}`),e.defaultValue!==void 0&&(e.required||e.optional||e.isBoolean()&&typeof e.defaultValue=="boolean")&&r.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),e.presetArg!==void 0&&e.optional&&r.push(`preset: ${JSON.stringify(e.presetArg)}`),e.envVar!==void 0&&r.push(`env: ${e.envVar}`),r.length>0?`${e.description} (${r.join(", ")})`:e.description}argumentDescription(e){let r=[];if(e.argChoices&&r.push(`choices: ${e.argChoices.map(n=>JSON.stringify(n)).join(", ")}`),e.defaultValue!==void 0&&r.push(`default: ${e.defaultValueDescription||JSON.stringify(e.defaultValue)}`),r.length>0){let n=`(${r.join(", ")})`;return e.description?`${e.description} ${n}`:n}return e.description}formatHelp(e,r){let n=r.padWidth(e,r),i=r.helpWidth||80,s=2,a=2;function o(x,C){if(C){let T=`${x.padEnd(n+a)}${C}`;return r.wrap(T,i-s,n+a)}return x}function u(x){return x.join(`
 `).replace(/^/gm," ".repeat(s))}let c=[`Usage: ${r.commandUsage(e)}`,""],l=r.commandDescription(e);l.length>0&&(c=c.concat([r.wrap(l,i,0),""]));let f=r.visibleArguments(e).map(x=>o(r.argumentTerm(x),r.argumentDescription(x)));f.length>0&&(c=c.concat(["Arguments:",u(f),""]));let m=r.visibleOptions(e).map(x=>o(r.optionTerm(x),r.optionDescription(x)));if(m.length>0&&(c=c.concat(["Options:",u(m),""])),this.showGlobalOptions){let x=r.visibleGlobalOptions(e).map(C=>o(r.optionTerm(C),r.optionDescription(C)));x.length>0&&(c=c.concat(["Global Options:",u(x),""]))}let F=r.visibleCommands(e).map(x=>o(r.subcommandTerm(x),r.subcommandDescription(x)));return F.length>0&&(c=c.concat(["Commands:",u(F),""])),c.join(`
 `)}padWidth(e,r){return Math.max(r.longestOptionTermLength(e,r),r.longestGlobalOptionTermLength(e,r),r.longestSubcommandTermLength(e,r),r.longestArgumentTermLength(e,r))}wrap(e,r,n,i=40){let s=" \\f\\t\\v\xA0\u1680\u2000-\u200A\u202F\u205F\u3000\uFEFF",a=new RegExp(`[\\n][${s}]+`);if(e.match(a))return e;let o=r-n;if(o<i)return e;let u=e.slice(0,n),c=e.slice(n).replace(`\r

package/scripts/nordic-publish.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2015 Nordic Semiconductor ASA

package/scripts/nrfconnect-license.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2021 Nordic Semiconductor ASA

package/scripts/postinstall.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2015 Nordic Semiconductor ASA

package/scripts/prepare-shared-release.ts

@@ -1,4 +1,4 @@
-#!/usr/bin/env -S npx tsx
+#!/usr/bin/env tsx
 
 /*
  * Copyright (c) 2023 Nordic Semiconductor ASA

package/src/Device/DeviceSelector/DeviceSelector.test.tsx

@@ -105,7 +105,7 @@ const validFirmware = {
 };
 
 describe('DeviceSelector', () => {
-    it('should have no device selected by default', () => {
+    it('has no device selected by default', () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -119,7 +119,7 @@ describe('DeviceSelector', () => {
         expect(screen.getByText('Select device')).toBeInTheDocument();
     });
 
-    it('should show no connected devices', () => {
+    it('shows an information when no devices are connected', () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -134,7 +134,7 @@ describe('DeviceSelector', () => {
         expect(screen.getByText('Nordic development kit')).toBeInTheDocument();
     });
 
-    it('should list connected devices', () => {
+    it('shows a list of connected devices', () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -149,7 +149,7 @@ describe('DeviceSelector', () => {
         expect(screen.getByText(DEVICE_SERIAL_NUMBER)).toBeInTheDocument();
     });
 
-    it('should unlist disconnected devices', () => {
+    it('does not show disconnected devices', () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -164,7 +164,7 @@ describe('DeviceSelector', () => {
         expect(screen.queryByText(DEVICE_SERIAL_NUMBER)).toBeNull();
     });
 
-    it('should show more device info when selecting the expand button', () => {
+    it('shows more device info when selecting the expand button', () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -181,7 +181,7 @@ describe('DeviceSelector', () => {
         expect(screen.getAllByText(/COM/)).toHaveLength(2);
     });
 
-    it('can select connected devices', async () => {
+    it('allows selecting a device', async () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -203,7 +203,7 @@ describe('DeviceSelector', () => {
         expect(screen.getAllByText(DEVICE_SERIAL_NUMBER)).toHaveLength(2);
     });
 
-    it('can deselect selected devices', async () => {
+    it('allows disconnecting a device', async () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -223,7 +223,7 @@ describe('DeviceSelector', () => {
         expect(screen.getByText('Select device')).toBeInTheDocument();
     });
 
-    it('should allow device selection when custom devices are enabled and no valid firmware is defined', async () => {
+    it('allows selecting a device when custom devices are enabled and no valid firmware is defined', async () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -259,7 +259,7 @@ describe('DeviceSelector', () => {
         expect(screen.getAllByText(DEVICE_SERIAL_NUMBER)).toHaveLength(2);
     });
 
-    it('should deselect device when custom devices are disabled and no valid firmware is defined', async () => {
+    it('allows deselecting a device when custom devices are disabled and no valid firmware is defined', async () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -295,7 +295,7 @@ describe('DeviceSelector', () => {
         await screen.findByText('Select device');
     });
 
-    it('should show firmware prompt when a valid firmware is defined', async () => {
+    it('shows firmware prompt when a valid firmware is defined', async () => {
         render(
             <DeviceSelector
                 deviceListing={{
@@ -317,7 +317,7 @@ describe('DeviceSelector', () => {
         );
     });
 
-    it('should select device when cancelling firmware prompt', async () => {
+    it('selects a device when cancelling firmware prompt', async () => {
         render(
             <DeviceSelector
                 deviceListing={{

package/src/Dialog/Dialog.test.tsx

@@ -28,18 +28,17 @@ describe('Dialog', () => {
         </Dialog>
     );
 
-    test('is rendered when visible', () => {
+    it('is rendered when visible', () => {
         render(dialog());
         expect(screen.getByRole('dialog')).toBeInTheDocument();
-        test;
     });
 
-    test('is not rendered when not visible', () => {
+    it('is not rendered when not visible', () => {
         render(dialog(false));
         expect(screen.queryByRole('dialog')).not.toBeInTheDocument();
     });
 
-    test('shows the expected content', () => {
+    it('shows the expected content', () => {
         render(dialog());
 
         expect(screen.getByText('Test Title')).toBeInTheDocument();
@@ -55,7 +54,7 @@ describe('InfoDialog creator', () => {
         </InfoDialog>
     );
 
-    test('shows the expected content', () => {
+    it('shows the expected content', () => {
         render(dialog());
 
         expect(screen.getByText('Info')).toBeInTheDocument();
@@ -63,7 +62,7 @@ describe('InfoDialog creator', () => {
         expect(screen.getByText('Close')).toBeInTheDocument();
     });
 
-    test('invokes the expected action', () => {
+    it('invokes the expected action', () => {
         render(dialog());
 
         const closeButton = screen.getByText('Close');
@@ -80,7 +79,7 @@ describe('ErrorDialog creator', () => {
         </ErrorDialog>
     );
 
-    test('shows the expected content', () => {
+    it('shows the expected content', () => {
         render(dialog());
 
         expect(screen.getByText('Error')).toBeInTheDocument();
@@ -88,7 +87,7 @@ describe('ErrorDialog creator', () => {
         expect(screen.getByText('Close')).toBeInTheDocument();
     });
 
-    test('invokes the expected action', () => {
+    it('invokes the expected action', () => {
         render(dialog());
 
         const closeButton = screen.getByText('Close');
@@ -111,7 +110,7 @@ describe('ConfirmationDialog creator', () => {
         </ConfirmationDialog>
     );
 
-    test('shows the expected content', () => {
+    it('shows the expected content', () => {
         render(dialog());
 
         expect(screen.getByText('Confirm')).toBeInTheDocument();
@@ -121,7 +120,7 @@ describe('ConfirmationDialog creator', () => {
         expect(screen.getByText('Cancel')).toBeInTheDocument();
     });
 
-    test('invokes the expected action', () => {
+    it('invokes the expected action', () => {
         render(dialog());
 
         fireEvent.click(screen.getByText('Optional'));

package/src/Dropdown/Dropdown.test.tsx

@@ -22,7 +22,7 @@ const items = [
 ];
 
 describe('Dropdown', () => {
-    it('renders a list of items', () => {
+    it('shows a list of items', () => {
         render(
             <Dropdown
                 items={items}
@@ -34,7 +34,7 @@ describe('Dropdown', () => {
         expect(screen.getByText('Bar')).toBeInTheDocument();
     });
 
-    it('calls onSelect when item is clicked', () => {
+    it('calls onSelect', () => {
         const onSelect = jest.fn();
         const item = items[1];
         render(
@@ -49,7 +49,7 @@ describe('Dropdown', () => {
         expect(onSelect).toHaveBeenCalledWith(item);
     });
 
-    it('correct item is selected', () => {
+    it('selects the correct item', () => {
         render(
             <Dropdown
                 items={items}

package/src/Dropdown/Dropdown.tsx

@@ -28,6 +28,7 @@ export type DropdownProps<T> = {
     selectedItem: DropdownItem<T>;
     numItemsBeforeScroll?: number;
     className?: string;
+    size?: 'sm' | 'md';
 };
 
 export default <T,>({
@@ -42,6 +43,7 @@ export default <T,>({
     selectedItem,
     numItemsBeforeScroll = 0,
     className = '',
+    size = 'md',
 }: DropdownProps<T>) => {
     const [isActive, setIsActive] = useState(false);
 
@@ -74,7 +76,12 @@ export default <T,>({
                     minWidth ? '' : 'tw-w-full',
                     transparentButtonBg
                         ? 'tw-bg-transparent'
-                        : 'tw-h-8 tw-bg-gray-700 tw-px-2 tw-text-white'
+                        : classNames(
+                              'tw-bg-gray-700 tw-text-white',
+                              size === 'sm'
+                                  ? 'tw-h-6 tw-pl-2 tw-pr-1 tw-text-2xs'
+                                  : 'tw-h-8 tw-px-2'
+                          )
                 )}
                 onClick={() => setIsActive(!isActive)}
                 disabled={disabled}
@@ -85,8 +92,9 @@ export default <T,>({
                         : selectedItem.label}
                 </span>
                 <span
-                    className={`mdi mdi-chevron-down tw-text-lg/none ${classNames(
-                        isActive && 'tw-rotate-180'
+                    className={`mdi mdi-chevron-down ${classNames(
+                        isActive && 'tw-rotate-180',
+                        size === 'sm' ? 'tw-text-base' : 'tw-text-lg'
                     )}`}
                 />
             </button>
@@ -116,7 +124,10 @@ export default <T,>({
                 {items.map(item => (
                     <button
                         type="button"
-                        className="tw-bg-transparent tw-clear-both tw-block tw-h-6 tw-w-full tw-whitespace-nowrap tw-border-0 tw-px-2 tw-py-1 tw-text-left tw-font-normal tw-text-white hover:tw-bg-gray-600 focus:tw-bg-gray-600"
+                        className={classNames(
+                            'tw-bg-transparent tw-clear-both tw-block tw-h-6 tw-w-full tw-whitespace-nowrap tw-border-0 tw-px-2 tw-py-1 tw-text-left tw-font-normal tw-text-white hover:tw-bg-gray-600 focus:tw-bg-gray-600',
+                            size === 'sm' && 'tw-text-2xs'
+                        )}
                         key={JSON.stringify(item.value)}
                         onClick={() => onClickItem(item)}
                     >

package/src/Dropdown/DropdownHelpers.test.ts

@@ -10,40 +10,39 @@ import {
     getSelectedDropdownItem,
 } from './DropdownHelpers';
 
+const itemList = [
+    { label: 'foo label', value: 'foo' },
+    { label: 'bar label', value: 'bar' },
+];
+
 describe('getSelectedDropdownItem', () => {
+    it('returns the item with the correct value', () => {
+        expect(getSelectedDropdownItem(itemList, 'bar')).toBe(itemList[1]);
+    });
+
     it('returns the first item if value is undefined', () => {
-        const itemList = [{ label: 'foo', value: 'foo' }];
         expect(getSelectedDropdownItem(itemList, undefined)).toBe(itemList[0]);
     });
 
     it('returns the first item if value is not found', () => {
-        const itemList = [{ label: 'foo', value: 'foo' }];
-        expect(getSelectedDropdownItem(itemList, 'bar')).toBe(itemList[0]);
-    });
-
-    it('returns the item with the correct value', () => {
-        const itemList = [
-            { label: 'foo', value: 'foo' },
-            { label: 'bar', value: 'bar' },
-        ];
-        expect(getSelectedDropdownItem(itemList, 'bar')).toBe(itemList[1]);
-    });
-
-    it('returns the item with the correct value when value is a boolean', () => {
-        const itemList = [
-            { label: 'on', value: 'on' },
-            { label: 'off', value: 'off' },
-        ];
-        expect(getSelectedDropdownItem(itemList, true)).toBe(itemList[0]);
+        expect(getSelectedDropdownItem(itemList, 'unknown')).toBe(itemList[0]);
     });
 
     it('returns the notFound item if value is not found', () => {
-        const itemList = [{ label: 'foo', value: 'foo' }];
         const notFound = { label: 'not found', value: 'not found' };
-        expect(getSelectedDropdownItem(itemList, 'bar', notFound)).toBe(
+        expect(getSelectedDropdownItem(itemList, 'unknown', notFound)).toBe(
             notFound
         );
     });
+
+    it('handles booleans as the strings `on` and `off`', () => {
+        const booleanList = [
+            { label: 'on label', value: 'on' },
+            { label: 'off label', value: 'off' },
+        ];
+        expect(getSelectedDropdownItem(booleanList, true).value).toBe('on');
+        expect(getSelectedDropdownItem(booleanList, false).value).toBe('off');
+    });
 });
 
 describe('convertToDropDownItems', () => {