---
title: "API reference, DroppyKit"
description: "Every public type in DroppyKit, 175 of them, grouped by what they are for."
canonical: "https://getdroppy.app/docs/droppykit/api"
last-updated: "2026-09-09"
---

# API reference

Every public type in DroppyKit, 175 of them, grouped by what they are for.

Read straight from the compiler’s symbol graph, so a type that is not on this page is not in the module.

## The droplet

What every droplet is built out of.

[DropletThe runtime object representing one droplet inside the host process.](https://getdroppy.app/docs/droppykit/api/droplet) [DropletIDStable identifier of a droplet across the whole system.](https://getdroppy.app/docs/droppykit/api/droplet-id) [DropletHostEverything the host offers a droplet.](https://getdroppy.app/docs/droppykit/api/droplet-host) [DropletURLHandlingAdopt to receive URLs opened at droppy://droplet/<your-id>/….](https://getdroppy.app/docs/droppykit/api/droplet-urlhandling) [DropletURLRequestA URL Droppy received on a droplet's behalf.](https://getdroppy.app/docs/droppykit/api/droplet-urlrequest)

## Shelf widgets

A card on the expanded shelf, alone or sharing the row.

[ShelfWidgetProvidingAdopt to contribute one or more widgets to the notch shelf.](https://getdroppy.app/docs/droppykit/api/shelf-widget-providing) [ShelfWidgetDynamicLayoutProvidingOptional live-layout refinement for a shelf widget provider.](https://getdroppy.app/docs/droppykit/api/shelf-widget-dynamic-layout-providing) [ShelfWidgetDescriptorStatic description of one shelf widget, rendered by the host without calling into the widget's views.](https://getdroppy.app/docs/droppykit/api/shelf-widget-descriptor) [ShelfWidgetContextContext passed to widget view factories on every mount.](https://getdroppy.app/docs/droppykit/api/shelf-widget-context) [ShelfWidgetIDStable identifier of one shelf widget a droplet provides.](https://getdroppy.app/docs/droppykit/api/shelf-widget-id) [ShelfWidgetLayoutTraitsDeclarative layout parameters for one shelf widget.](https://getdroppy.app/docs/droppykit/api/shelf-widget-layout-traits) [ShelfWidgetContentHeightHow tall the widget's card should be inside the shelf.](https://getdroppy.app/docs/droppykit/api/shelf-widget-content-height) [ShelfWidgetFocusPolicyWhether the widget participates in shelf keyboard focus.](https://getdroppy.app/docs/droppykit/api/shelf-widget-focus-policy) [ShelfWidgetPlacementA widget's horizontal position within its shelf row.](https://getdroppy.app/docs/droppykit/api/shelf-widget-placement) [ShelfWidgetPrewarmPolicyWhether the shelf may mount the widget invisibly ahead of time.](https://getdroppy.app/docs/droppykit/api/shelf-widget-prewarm-policy) [ShelfWidgetNotchWrapTraitsHow a widget's header row wraps around the camera, declared in notchWrap.](https://getdroppy.app/docs/droppykit/api/shelf-widget-notch-wrap-traits) [ShelfWidgetNotchWrapThe bands beside the camera for a widget the host wrapped around the notch, handed down in notchWrap.](https://getdroppy.app/docs/droppykit/api/shelf-widget-notch-wrap)

## Live activities

A compact row beside the notch, and its detail.

[LiveActivityProvidingAdopt to show a compact live activity in the notch or island: small leading and trailing accessories beside the (simulated) notch.](https://getdroppy.app/docs/droppykit/api/live-activity-providing) [LiveActivityStateState of a droplet's compact live activity.](https://getdroppy.app/docs/droppykit/api/live-activity-state) [LiveActivityContextStructure](https://getdroppy.app/docs/droppykit/api/live-activity-context) [LiveActivityPresentationStateContext passed to makeExpanded(context:).](https://getdroppy.app/docs/droppykit/api/live-activity-presentation-state) [CompactLiveActivityContextContext passed to the seat-aware compact factories (DroppyKit 0.7.0).](https://getdroppy.app/docs/droppykit/api/compact-live-activity-context) [CompactLiveActivityPresentationMetadataOpaque host-facing metadata for a compact live activity's leading accessory.](https://getdroppy.app/docs/droppykit/api/compact-live-activity-presentation-metadata)

## Expanded surfaces

A takeover on the notch.

[ExpandedSurfaceProvidingA provider of expanded surfaces: content, size, and the far end of the host's lifecycle.](https://getdroppy.app/docs/droppykit/api/expanded-surface-providing) [ExpandedSurfaceHostingAdopt to take the expanded shelf over with your own content.](https://getdroppy.app/docs/droppykit/api/expanded-surface-hosting) [ExpandedSurfaceDescriptorStatic description of one expanded surface, readable by the host without mounting anything.](https://getdroppy.app/docs/droppykit/api/expanded-surface-descriptor) [ExpandedSurfaceContextWhat the host tells expanded-surface content about its mount.](https://getdroppy.app/docs/droppykit/api/expanded-surface-context) [ExpandedSurfaceIDStable identifier of one expanded surface a droplet provides.](https://getdroppy.app/docs/droppykit/api/expanded-surface-id) [ExpandedSurfacePresentationOne live presentation of an expanded surface, as the host records it.](https://getdroppy.app/docs/droppykit/api/expanded-surface-presentation) [ExpandedSurfacePresentationRequestA request to take the expanded shelf over with one of your surfaces.](https://getdroppy.app/docs/droppykit/api/expanded-surface-presentation-request) [ExpandedSurfaceSizeProposalWhat the host offers before asking a droplet how big its surface wants to be.](https://getdroppy.app/docs/droppykit/api/expanded-surface-size-proposal) [ExpandedSurfaceHostSuppressionWhich of the host's own expanded-shelf behaviors stand down while a takeover is on screen.](https://getdroppy.app/docs/droppykit/api/expanded-surface-host-suppression) [ExpandedSurfaceDismissalReasonWhy an expanded surface stopped being presented.](https://getdroppy.app/docs/droppykit/api/expanded-surface-dismissal-reason)

## Other surfaces

Settings, the lock screen, the menu bar, HUDs.

[SettingsPaneProvidingAdopt to contribute a settings pane to the Droplets shop detail page and to embedded settings surfaces.](https://getdroppy.app/docs/droppykit/api/settings-pane-providing) [SettingsPaneContextContext passed to makeSettingsPane(context:).](https://getdroppy.app/docs/droppykit/api/settings-pane-context) [SettingsPanePresentationWhere a settings pane is being presented.](https://getdroppy.app/docs/droppykit/api/settings-pane-presentation) [SettingsPagesProvidingAdopt to give your droplet's Settings page pages of its own (DroppyKit 1.13.0).](https://getdroppy.app/docs/droppykit/api/settings-pages-providing) [DropletSettingsPageLinkA row that opens one of your droplet's own Settings pages (DroppyKit 1.13.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-page-link) [DropletSettingsPageIconA link row's tile from an image: the image at the tile's size, with high quality interpolation, or nothing when there is none (DroppyKit 1.13.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-page-icon) [DropletSettingsPageThe root of one of your droplet's own Settings pages (DroppyKit 1.13.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-page) [DropletSettingsPageOpenerHow a DropletSettingsPageLink asks the host for a page (DroppyKit 1.13.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-page-opener) [HUDPresentingMarker capability for droplets that present transient HUDs.](https://getdroppy.app/docs/droppykit/api/hudpresenting) [LockScreenStatusProvidingAdopt to publish a status entry on Droppy's lock screen surface.](https://getdroppy.app/docs/droppykit/api/lock-screen-status-providing) [LockScreenStatusEntryOne entry in the lock screen status widget strip.](https://getdroppy.app/docs/droppykit/api/lock-screen-status-entry) [MenuBarExtraProvidingAdopt to contribute a menu bar extra.](https://getdroppy.app/docs/droppykit/api/menu-bar-extra-providing) [MenuBarExtraDescriptorStatic description of a menu bar extra a droplet contributes.](https://getdroppy.app/docs/droppykit/api/menu-bar-extra-descriptor) [DropletSurfaceKindThe kind of surface a droplet view is currently rendered on.](https://getdroppy.app/docs/droppykit/api/droplet-surface-kind)

## Host services

Everything a droplet can ask Droppy to do.

[DropletPreferencesServicePersistent, droplet-scoped settings.](https://getdroppy.app/docs/droppykit/api/droplet-preferences-service) [DropletEnvironmentServiceRead-only facts about the host and the machine it is running on.](https://getdroppy.app/docs/droppykit/api/droplet-environment-service) [DropletHUDServicePresents transient HUDs on the notch surface.](https://getdroppy.app/docs/droppykit/api/droplet-hudservice) [DropletHUDRequestA transient HUD to show in the notch.](https://getdroppy.app/docs/droppykit/api/droplet-hudrequest) [DropletHUDPriorityHow loudly a HUD asks for attention.](https://getdroppy.app/docs/droppykit/api/droplet-hudpriority) [DropletShelfServiceOpens and closes Droppy's shelf, and reveals this droplet's widgets in it.](https://getdroppy.app/docs/droppykit/api/droplet-shelf-service) [DropletLiveActivityServiceDrives this droplet's live activity.](https://getdroppy.app/docs/droppykit/api/droplet-live-activity-service) [DropletLiveActivitySeatWhere a droplet's activity currently sits (DroppyKit 0.6.0).](https://getdroppy.app/docs/droppykit/api/droplet-live-activity-seat) [DropletLiveActivityYieldReasonWhy a droplet's activity is not holding the compact slot (DroppyKit 0.6.0).](https://getdroppy.app/docs/droppykit/api/droplet-live-activity-yield-reason) [DropletNotchSurfaceServicePresents and dismisses expanded (takeover) surfaces on the notch.](https://getdroppy.app/docs/droppykit/api/droplet-notch-surface-service) [DropletShortcutsServiceRegisters global keyboard shortcuts the user can rebind in Droppy's Settings, Shortcuts page.](https://getdroppy.app/docs/droppykit/api/droplet-shortcuts-service) [DropletKeyboardShortcutA key equivalent, as the user recorded it.](https://getdroppy.app/docs/droppykit/api/droplet-keyboard-shortcut) [ShortcutsProvidingA droplet whose own shortcuts Droppy lists on its Shortcuts page, in a section with the droplet's name and icon.](https://getdroppy.app/docs/droppykit/api/shortcuts-providing) [DropletShortcutEntryOne shortcut a droplet keeps itself, listed on Droppy's Shortcuts page.](https://getdroppy.app/docs/droppykit/api/droplet-shortcut-entry) [DropletWorkspaceServiceThings a droplet can ask the system to do on the user's behalf.](https://getdroppy.app/docs/droppykit/api/droplet-workspace-service) [DropletFeedbackServicePlays Droppy's own sound and haptic feedback, so a droplet feels like the rest of the app instead of inventing its own vocabulary.](https://getdroppy.app/docs/droppykit/api/droplet-feedback-service) [DropletFeedbackCueOne of the host's own feedback cues.](https://getdroppy.app/docs/droppykit/api/droplet-feedback-cue) [DropletPermissionsServiceChecks and requests the macOS permissions behind a capability.](https://getdroppy.app/docs/droppykit/api/droplet-permissions-service) [DropletPermissionStatusWhether the host currently holds a system permission.](https://getdroppy.app/docs/droppykit/api/droplet-permission-status) [DropletInstallStateServiceReports what the user has switched on, so a droplet can avoid doing work for a widget nobody is showing.](https://getdroppy.app/docs/droppykit/api/droplet-install-state-service) [DropletInstallStateWhich of this droplet's pieces the user currently has switched on.](https://getdroppy.app/docs/droppykit/api/droplet-install-state) [DropletLogServiceWrites into Droppy's own log stream, tagged with the droplet id.](https://getdroppy.app/docs/droppykit/api/droplet-log-service) [DropletLogLevelSeverity of a droplet log line.](https://getdroppy.app/docs/droppykit/api/droplet-log-level) [DropletNotchGeometryHow the notch surface is physically shaped on one display.](https://getdroppy.app/docs/droppykit/api/droplet-notch-geometry) [DropletExpandedShelfStateWhat the host's expanded shelf is currently showing.](https://getdroppy.app/docs/droppykit/api/droplet-expanded-shelf-state) [DropletSurfaceAppearanceThe appearance Droppy is drawing its surfaces in.](https://getdroppy.app/docs/droppykit/api/droplet-surface-appearance) [DroppyKitHostBridgeExtension points a host process installs into DroppyKit at launch.](https://getdroppy.app/docs/droppykit/api/droppy-kit-host-bridge)

## Launchers

Droppy's commands, droplets, settings and content, for a launcher.

[DropletLauncherServiceDroppy's commands, settings, droplets and content, for a droplet that draws a launcher.](https://getdroppy.app/docs/droppykit/api/droplet-launcher-service) [DropletUnavailableLauncherServiceThe service a host without a launcher bridge, or a droplet without the launcher capability, is given.](https://getdroppy.app/docs/droppykit/api/droplet-unavailable-launcher-service) [DropletLauncherItemOne thing Droppy offers a launcher: a command, a settings page, a droplet, a note, a clipboard entry, a web answer.](https://getdroppy.app/docs/droppykit/api/droplet-launcher-item) [DropletLauncherIconHow a launcher draws an item's icon.](https://getdroppy.app/docs/droppykit/api/droplet-launcher-icon) [DropletLauncherActionSomething that can be done with an item.](https://getdroppy.app/docs/droppykit/api/droplet-launcher-action) [DropletLauncherOutcomeWhat the launcher does after the host ran an action.](https://getdroppy.app/docs/droppykit/api/droplet-launcher-outcome) [DropletLauncherDetailContextWhat a detail surface is given by the launcher that shows it.](https://getdroppy.app/docs/droppykit/api/droplet-launcher-detail-context) [DroppyPanelSurfaceDroppy's own launcher surface, for a droplet that draws a floating panel of its own: a launcher, a palette, a picker.](https://getdroppy.app/docs/droppykit/api/droppy-panel-surface) [DroppyKitSurfaceBridgeWhere DroppyPanelSurface gets the host's own surface.](https://getdroppy.app/docs/droppykit/api/droppy-kit-surface-bridge) [DroppyShortcutRecorderDroppy's own shortcut recorder, for a droplet that keeps shortcuts of its own (DroppyKit 1.14.0).](https://getdroppy.app/docs/droppykit/api/droppy-shortcut-recorder) [DroppyPanelActivationDroppy made the active app while a droplet's own floating panel is up, and the foreground handed back when it closes (DroppyKit 1.15.0).](https://getdroppy.app/docs/droppykit/api/droppy-panel-activation)

## Tools for AI apps

Actions an AI app can run through Droppy's MCP server.

[MCPToolProvidingAdopt to offer typed tools to AI apps through Droppy's MCP server (DroppyKit 1.21.0).](https://getdroppy.app/docs/droppykit/api/mcptool-providing) [DropletMCPToolOne action a droplet offers to AI apps through Droppy's MCP server.](https://getdroppy.app/docs/droppykit/api/droplet-mcptool)

## Manifest and bundle

What ships, and what the host reads before it loads.

[DropletManifestThe contents of a droplet's droplet.json.](https://getdroppy.app/docs/droppykit/api/droplet-manifest) [DropletManifestErrorWhy a droplet.json was refused.](https://getdroppy.app/docs/droppykit/api/droplet-manifest-error) [DropletCreatorWho made a droplet.](https://getdroppy.app/docs/droppykit/api/droplet-creator) [DropletCreatorAvatarThe rules a creator avatar has to satisfy.](https://getdroppy.app/docs/droppykit/api/droplet-creator-avatar) [DropletCategoryThe shelf of the Store a droplet sits on.](https://getdroppy.app/docs/droppykit/api/droplet-category) [DropletSourceWhere a droplet's source lives.](https://getdroppy.app/docs/droppykit/api/droplet-source) [DropletSurfaceA surface a droplet says it provides.](https://getdroppy.app/docs/droppykit/api/droplet-surface) [DropletKitRequirementWhich DroppyKit a droplet was built against.](https://getdroppy.app/docs/droppykit/api/droplet-kit-requirement) [DropletPermissionCapability strings a .droplet declares under DroppyPermissions in its Info.plist.](https://getdroppy.app/docs/droppykit/api/droplet-permission) [DropletIconThe rules a droplet's icon has to satisfy.](https://getdroppy.app/docs/droppykit/api/droplet-icon) [DropletIconRendererEnumeration](https://getdroppy.app/docs/droppykit/api/droplet-icon-renderer) [DropletIconErrorWhy an Icon Composer document was refused.](https://getdroppy.app/docs/droppykit/api/droplet-icon-error) [DropletIconValidationChecks an Icon Composer document without rendering it.](https://getdroppy.app/docs/droppykit/api/droplet-icon-validation) [DroppyIconStyleOne of the six ways macOS 26 and later draws an app icon, plus the tint.](https://getdroppy.app/docs/droppykit/api/droppy-icon-style) [DroppyIconStyleObserverThe user's icon style, kept current.](https://getdroppy.app/docs/droppykit/api/droppy-icon-style-observer) [DroppySystemIconRendererDraws an icon the way the Dock does, in any DroppyIconStyle, through the system's own icon renderer.](https://getdroppy.app/docs/droppykit/api/droppy-system-icon-renderer) [DropletBundleInfoParsed metadata of one .droplet bundle, read from its Info.plist without loading any code.](https://getdroppy.app/docs/droppykit/api/droplet-bundle-info) [DropletBundleInfoErrorErrors thrown while reading a .droplet's metadata.](https://getdroppy.app/docs/droppykit/api/droplet-bundle-info-error) [DropletInfoPlistKeyInfo.plist keys of a .droplet bundle.](https://getdroppy.app/docs/droppykit/api/droplet-info-plist-key)

## Surface geometry

The shapes and sizes Droppy draws its surfaces at.

[DroppyNotchShellShapeThe U-shaped shell Droppy's notch surface is drawn in.](https://getdroppy.app/docs/droppykit/api/droppy-notch-shell-shape) [DroppyShellMetricsThe geometry Droppy draws its surfaces at.](https://getdroppy.app/docs/droppykit/api/droppy-shell-metrics)

## Design system

Droppy's own tokens, rows and controls.

[AdaptiveColorsSemantic color palette for droplet UI.](https://getdroppy.app/docs/droppykit/api/adaptive-colors) [DroppySpacingStandardized spacing values on a 4pt grid.](https://getdroppy.app/docs/droppykit/api/droppy-spacing) [DroppyRadiusStandardized corner radius values (tiered radii standard).](https://getdroppy.app/docs/droppykit/api/droppy-radius) [DroppyOpacityStandardized opacity values for consistent layering.](https://getdroppy.app/docs/droppykit/api/droppy-opacity) [DroppyAnimationDroppy's named animation presets.](https://getdroppy.app/docs/droppykit/api/droppy-animation) [DroppyKitMotionBridgeHost-installed motion hooks.](https://getdroppy.app/docs/droppykit/api/droppy-kit-motion-bridge) [DroppyTransitionThe content transitions Droppy's own notch surfaces use (DroppyKit 1.8.0).](https://getdroppy.app/docs/droppykit/api/droppy-transition) [DroppyLiveActivityMetricsNative metrics for compact and interactive live-activity rows.](https://getdroppy.app/docs/droppykit/api/droppy-live-activity-metrics) [DroppySettingsControlMetricsShared metric constants for settings rows.](https://getdroppy.app/docs/droppykit/api/droppy-settings-control-metrics) [DroppySettingsLayoutMetricsShared layout metrics for settings rows and cards.](https://getdroppy.app/docs/droppykit/api/droppy-settings-layout-metrics) [DroppyAccentButtonStyleThe accent pill for a primary action: Liquid Glass with the accent washed over it (0.18 at rest, 0.24 under the pointer, 0.30 pressed) and the adaptive label ink, exactly the host's DroppyAccentButtonStyle.](https://getdroppy.app/docs/droppykit/api/droppy-accent-button-style) [DroppyQuietButtonStyleThe quiet pill for a secondary action: plain Liquid Glass with the adaptive label ink, the host's DroppyPillButtonStyle.](https://getdroppy.app/docs/droppykit/api/droppy-quiet-button-style) [DroppyCircleButtonStyleThe circular icon button for an icon-only action: the Liquid Glass disc the File Tray puts on an item (remove, pin) and the shelf's floating close chip, the host's DroppyCircleButtonStyle.](https://getdroppy.app/docs/droppykit/api/droppy-circle-button-style) [DroppyButtonChromeNeutral chrome fill shared by Droppy's quiet filled control family.](https://getdroppy.app/docs/droppykit/api/droppy-button-chrome) [DroppyButtonSizeSize variants of the Droppy button family.](https://getdroppy.app/docs/droppykit/api/droppy-button-size) [DroppyGlassControlThe Liquid Glass control recipe: the fill vocabulary, the ink, and the wash for one state.](https://getdroppy.app/docs/droppykit/api/droppy-glass-control) [DroppyGlassControlChromeThe Liquid Glass control as a modifier, so a style with its own sizing (the pill family, the disc) and a Menu label (which cannot take a ButtonStyle) draw the identical control.](https://getdroppy.app/docs/droppykit/api/droppy-glass-control-chrome) [DroppyGlassButtonStyleThe glass control as a button style for labels that size themselves: shape and fill in, the ink from the fill unless the label sets its own (an accent glyph, red for a destructive action).](https://getdroppy.app/docs/droppykit/api/droppy-glass-button-style) [DroppyLiveActivityControlStyleA 24pt circular control matching Droppy's collapsed media interaction.](https://getdroppy.app/docs/droppykit/api/droppy-live-activity-control-style) [DroppyLiveActivityControlProminenceVisual prominence for an inline live-activity control.](https://getdroppy.app/docs/droppykit/api/droppy-live-activity-control-prominence) [DroppyWashCircleButtonStyleThe circular control of Droppy's timer widgets: a flat wash, a semibold glyph, and the 0.94 press.](https://getdroppy.app/docs/droppykit/api/droppy-wash-circle-button-style) [DroppyWashPillButtonStyleThe labelled control of Droppy's timer widgets: Pomodoro's Start Timer pill and its Focus and Break pills, a flat wash under rounded semibold type.](https://getdroppy.app/docs/droppykit/api/droppy-wash-pill-button-style) [DroppyWashToneWhat a wash control carries: nothing but the white, or a colour.](https://getdroppy.app/docs/droppykit/api/droppy-wash-tone) [DropletSettingsPaneThe root of a droplet's settings pane (DroppyKit 1.9.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-pane) [DropletSettingsSectionA titled group of rows inside a DropletSettingsPane (DroppyKit 1.9.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-section) [DropletSettingsCardCard wrapper for grouping settings rows.](https://getdroppy.app/docs/droppykit/api/droplet-settings-card) [DropletSettingsDividerDivider between ordinary rows inside a DropletSettingsCard.](https://getdroppy.app/docs/droppykit/api/droplet-settings-divider) [DropletControlRowBase settings row: title with optional icon and info tip on the left, any accessory control on the right.](https://getdroppy.app/docs/droppykit/api/droplet-control-row) [DropletToggleRowStandard toggle row: title and info tip on the left, small switch on the right.](https://getdroppy.app/docs/droppykit/api/droplet-toggle-row) [DropletMiniToggleRowCompact nested toggle row for stacked rules and reorder lists.](https://getdroppy.app/docs/droppykit/api/droplet-mini-toggle-row) [DropletStackedRowRow whose content stacks beneath the title block instead of trailing on the right.](https://getdroppy.app/docs/droppykit/api/droplet-stacked-row) [DropletSliderRowStandard slider row: title on the left, slider and click-to-type value pill on the right, on one line like a System Settings slider.](https://getdroppy.app/docs/droppykit/api/droplet-slider-row) [DropletGroupedPickerRowTitle and info tip above a picker, inset evenly inside the native card.](https://getdroppy.app/docs/droppykit/api/droplet-grouped-picker-row) [DropletValuePillThe read-only value of a settings row.](https://getdroppy.app/docs/droppykit/api/droplet-value-pill) [DropletSettingsToolbarPillDroppy's Liquid Glass pill for the Settings toolbar, drawn by the host (DroppyKit 1.18.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-toolbar-pill) [DropletSettingsToolbarButtonOne action of a page, as a pill in Droppy's Settings toolbar (DroppyKit 1.18.0): "New item", "Add application".](https://getdroppy.app/docs/droppykit/api/droplet-settings-toolbar-button) [DropletSettingsToolbarMenuA pill in Droppy's Settings toolbar that opens a menu (DroppyKit 1.18.0): "Add" with what can be added, a sort order, or what can be done to the page's subject as a whole.](https://getdroppy.app/docs/droppykit/api/droplet-settings-toolbar-menu) [DropletSettingsToolbarMenuItemOne row of a DropletSettingsToolbarMenu (DroppyKit 1.18.0): an action, a separator, or a small section title.](https://getdroppy.app/docs/droppykit/api/droplet-settings-toolbar-menu-item) [DropletSettingsToolbarSearchFieldA search over the page, as a pill in Droppy's Settings toolbar (DroppyKit 1.18.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-toolbar-search-field) [DropletSettingsToolbarSwitchA page's own on/off switch, as a pill in Droppy's Settings toolbar (DroppyKit 1.18.0), where every feature page of Droppy keeps its own.](https://getdroppy.app/docs/droppykit/api/droplet-settings-toolbar-switch) [DropletSettingsToolbarMetricsThe numbers Droppy draws its Settings toolbar pills with (DroppyKit 1.18.0).](https://getdroppy.app/docs/droppykit/api/droplet-settings-toolbar-metrics) [DropletConfirmationDialogA confirmation drawn by Droppy using its own glass dialog (DroppyKit 1.19.0).](https://getdroppy.app/docs/droppykit/api/droplet-confirmation-dialog) [SettingsUnifiedSegmentedRowOne value out of a short list, as the native pop-up button a System Settings row carries: the current choice with the up/down chevrons, a checkmarked menu of every option, keyboard and VoiceOver behaviour courtesy of AppKit.](https://getdroppy.app/docs/droppykit/api/settings-unified-segmented-row) [SettingsPickerOptionOne option of a segmented settings picker.](https://getdroppy.app/docs/droppykit/api/settings-picker-option) [SettingsGroupPositionVertical position of a grouped row within its parent DropletSettingsCard.](https://getdroppy.app/docs/droppykit/api/settings-group-position) [SettingsSelectionChromeOne rule for "this is the option you picked", across every selectable control DroppyKit publishes.](https://getdroppy.app/docs/droppykit/api/settings-selection-chrome) [SettingsAdaptiveColorBuilds a Color that resolves per appearance, so a token can be written as a (ColorScheme) -> Color function and still be read at a call site with no ColorScheme in scope.](https://getdroppy.app/docs/droppykit/api/settings-adaptive-color) [SettingsInfoTipLightweight info button that shows a text popover on hover.](https://getdroppy.app/docs/droppykit/api/settings-info-tip) [SettingsSearchEntryOne entry the host's settings search can surface for a droplet.](https://getdroppy.app/docs/droppykit/api/settings-search-entry) [GroupedCornersDescribes which corners of a cell round when composing grouped rows, where outer corners follow the parent card's curvature and inner edges stay flat.](https://getdroppy.app/docs/droppykit/api/grouped-corners) [DroppyKitThemeBridgeEnumeration](https://getdroppy.app/docs/droppykit/api/droppy-kit-theme-bridge) [DroppyKitThemeResolutionHost-installed theme hooks.](https://getdroppy.app/docs/droppykit/api/droppy-kit-theme-resolution) [DroppyMarkdownEditorDroppy's markdown editing surface.](https://getdroppy.app/docs/droppykit/api/droppy-markdown-editor) [DroppyMarkdownEditorCommandsA handle onto the host editor's command bus (DroppyKit 0.2.2).](https://getdroppy.app/docs/droppykit/api/droppy-markdown-editor-commands) [DroppyMarkdownEditorContextEverything the host editor needs beyond the text binding (DroppyKit 0.2.2).](https://getdroppy.app/docs/droppykit/api/droppy-markdown-editor-context) [DroppyMarkdownHighlightColorMarker-pen palette for ==highlight== spans (DroppyKit 0.2.2).](https://getdroppy.app/docs/droppykit/api/droppy-markdown-highlight-color) [DroppyMarkdownToolbarActionA formatting command a droplet's toolbar can send to the host editor (DroppyKit 0.2.2).](https://getdroppy.app/docs/droppykit/api/droppy-markdown-toolbar-action) [DroppyNowPlayingPlayerDroppy's floating player, the real one: the same view, glass, artwork, controls and lyrics button the floating player and the lock screen draw, showing whatever is playing on the Mac.](https://getdroppy.app/docs/droppykit/api/droppy-now-playing-player) [DroppyNowPlayingPlayerProviderWhat the host hands DroppyNowPlayingPlayer.](https://getdroppy.app/docs/droppykit/api/droppy-now-playing-player-provider) [DroppyNowPlayingPlayerLayoutWhat a droplet asked DroppyNowPlayingPlayer for: hosts read it.](https://getdroppy.app/docs/droppykit/api/droppy-now-playing-player-layout) [settingsSectionHeader(_:)Single source of truth for the section headers that sit above settings cards.](https://getdroppy.app/docs/droppykit/api/settings-section-header) [settingsUnifiedSegmentLabel(icon:title:isSelected:isEnabled:)One option of a settings pop-up: its SF Symbol, then its title, in the menu's own font.](https://getdroppy.app/docs/droppykit/api/settings-unified-segment-label-icon-title-is-selected-is-enabled) [settingsUnifiedPickerRow(title:subtitle:icon:iconColor:options:accessibilityLabel:groupPosition:isEnabled:isSelected:action:content:)The canonical picker row: a title on the left and the native pop-up on the right, one line, inside a DropletSettingsCard.](https://getdroppy.app/docs/droppykit/api/settings-unified-picker-row-title-subtitle-icon-icon-color-options-accessibility-label-group-position-is-enabled-is-selected-action-content)

## Versioning

The handshake between a droplet and its host.

[DroppyKitBuildVersion constants of this DroppyKit build.](https://getdroppy.app/docs/droppykit/api/droppy-kit-build) [SemanticVersionA three-component semantic version, compared numerically.](https://getdroppy.app/docs/droppykit/api/semantic-version) [DropletCompatibilityVerdictOutcome of evaluating one bundle against one host.](https://getdroppy.app/docs/droppykit/api/droplet-compatibility-verdict) [DropletHostDescriptorWhat one host advertises to the handshake.](https://getdroppy.app/docs/droppykit/api/droplet-host-descriptor)