use-scroll-animate 7.7.0 → 7.9.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (49) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/bin/usa-codemod-8.mjs +74 -0
  3. package/dist/components/angular.d.cts +4 -0
  4. package/dist/components/angular.d.ts +4 -0
  5. package/dist/components/fx-ai.cjs +130 -0
  6. package/dist/components/fx-ai.cjs.map +1 -0
  7. package/dist/components/fx-ai.d.cts +66 -0
  8. package/dist/components/fx-ai.d.ts +66 -0
  9. package/dist/components/fx-ai.js +126 -0
  10. package/dist/components/fx-ai.js.map +1 -0
  11. package/dist/components/fx2.cjs +6 -0
  12. package/dist/components/fx2.cjs.map +1 -1
  13. package/dist/components/fx2.d.cts +23 -1
  14. package/dist/components/fx2.d.ts +23 -1
  15. package/dist/components/fx2.js +5 -1
  16. package/dist/components/fx2.js.map +1 -1
  17. package/dist/components/lite.cjs +1 -0
  18. package/dist/components/lite.cjs.map +1 -1
  19. package/dist/components/lite.js +1 -0
  20. package/dist/components/lite.js.map +1 -1
  21. package/dist/components/solid.d.cts +4 -0
  22. package/dist/components/solid.d.ts +4 -0
  23. package/dist/components/svelte.d.cts +4 -0
  24. package/dist/components/svelte.d.ts +4 -0
  25. package/dist/components/ui.cjs +1 -0
  26. package/dist/components/ui.cjs.map +1 -1
  27. package/dist/components/ui.d.cts +4 -0
  28. package/dist/components/ui.d.ts +4 -0
  29. package/dist/components/ui.js +2 -1
  30. package/dist/components/ui.js.map +1 -1
  31. package/dist/components/vue.d.cts +4 -0
  32. package/dist/components/vue.d.ts +4 -0
  33. package/dist/components/widgets.cjs +733 -128
  34. package/dist/components/widgets.cjs.map +1 -1
  35. package/dist/components/widgets.d.cts +118 -3
  36. package/dist/components/widgets.d.ts +118 -3
  37. package/dist/components/widgets.js +724 -129
  38. package/dist/components/widgets.js.map +1 -1
  39. package/dist/components.d.cts +4 -0
  40. package/dist/components.d.ts +4 -0
  41. package/dist/components.umd.js +2 -2
  42. package/dist/components.umd.js.map +1 -1
  43. package/dist/widgets.umd.js +1 -1
  44. package/dist/widgets.umd.js.map +1 -1
  45. package/docs/ROADMAP.md +2 -2
  46. package/docs/components.md +42 -0
  47. package/docs/deprecations.md +4 -0
  48. package/docs/upgrading-8.md +34 -0
  49. package/package.json +23 -2
@@ -223,7 +223,9 @@ declare function defineSkeletonReveal(tag?: string): CustomElementConstructor |
223
223
  * pops the chosen star and throws a small sparkle burst, the other stars
224
224
  * ripple in sequence. `max`, `step` (`1` · `0.5`), `readonly`, `label`,
225
225
  * `icon` (`star` · `heart`). Keyboard: it is a `role="slider"` — arrows,
226
- * Home / End. Event `usa:change` (`{ value }`). Reduced motion: no pop,
226
+ * Home / End. Events `change`, `usa:change` (`{ value }`). Form-associated
227
+ * (7.9): with `name` the value is submitted like `<usa-rating>`'s, which it
228
+ * replaces in 8.0. Reduced motion: no pop,
227
229
  * burst or ripple.
228
230
  */
229
231
  interface UsaStarRatingElement extends UsaElement {
@@ -1091,6 +1093,114 @@ interface UsaUploadProgressElement extends UsaElement {
1091
1093
  declare function formatBytes(n: number): string;
1092
1094
  declare function defineUploadProgress(tag?: string): CustomElementConstructor | undefined;
1093
1095
 
1096
+ /**
1097
+ * `<usa-chat-composer>` (7.8) — an AI chat input: the textarea grows with its
1098
+ * text (up to `rows` lines, default 6), Enter sends (Shift+Enter = new line),
1099
+ * the send button pops when there is text and morphs into a Stop button while
1100
+ * `busy` — then a soft "thinking" glow runs round the composer. Sending emits
1101
+ * `usa:send` { text } (cancelable — call `preventDefault()` to keep the text)
1102
+ * and clears it; Stop emits `usa:stop`. `placeholder`, `label`, `send()`,
1103
+ * `clear()`, `value`. Reduced motion: no glow, no pop.
1104
+ */
1105
+ interface UsaChatComposerElement extends UsaElement {
1106
+ value: string;
1107
+ busy: boolean;
1108
+ send(): boolean;
1109
+ clear(): void;
1110
+ }
1111
+ declare function defineChatComposer(tag?: string): CustomElementConstructor | undefined;
1112
+
1113
+ /**
1114
+ * `<usa-suggestion-chips>` (7.8) — follow-up prompt chips for AI chats:
1115
+ * `items="Summarise|Translate|Explain like I'm 5"` (or child `<button>`s /
1116
+ * text lines). The chips slide in one after another when they appear (and
1117
+ * again after `setItems()`); picking one pulses it, emits `usa:pick`
1118
+ * { text, index } and, with `dismiss`, the others fade away. A labelled list
1119
+ * of real buttons, arrow keys move between them; reduced motion: no slide or
1120
+ * pulse.
1121
+ */
1122
+ interface UsaSuggestionChipsElement extends UsaElement {
1123
+ items: string[];
1124
+ setItems(items: string[]): void;
1125
+ }
1126
+ /** "a | b|c" → ["a", "b", "c"] (7.8). */
1127
+ declare function parseChips(s: string): string[];
1128
+ declare function defineSuggestionChips(tag?: string): CustomElementConstructor | undefined;
1129
+
1130
+ /**
1131
+ * `<usa-voice-button>` (7.8) — a push-to-talk mic button: click (or Space /
1132
+ * Enter) toggles `listening`; while listening a halo breathes round the
1133
+ * button and `bars` (default 5) wave beside it. Feed it the live input level
1134
+ * with `level` (0–1, e.g. from an `AnalyserNode` or a speech API) and the
1135
+ * bars and halo follow it; without levels they run an idle wave. `usa:start`
1136
+ * / `usa:stop`. A real `<button aria-pressed>`; `label`. Reduced motion: no
1137
+ * halo or wave — the pressed state shows by colour.
1138
+ */
1139
+ interface UsaVoiceButtonElement extends UsaElement {
1140
+ listening: boolean;
1141
+ level: number;
1142
+ toggle(force?: boolean): void;
1143
+ }
1144
+ /** Bar heights (0–1) for a level and a phase, centre bars tallest (7.8). */
1145
+ declare function waveBars(level: number, n?: number, phase?: number): number[];
1146
+ declare function defineVoiceButton(tag?: string): CustomElementConstructor | undefined;
1147
+
1148
+ /**
1149
+ * `<usa-command-palette>` (7.9) — a ⌘K command palette on the native
1150
+ * `<dialog>` (top layer, Esc, focus returns to the opener): it scales in,
1151
+ * the results filter as you type (fuzzy, matched letters highlighted) and
1152
+ * stagger in, a highlight glides to the active row (↑ / ↓, Enter runs it).
1153
+ * Commands come from child `<option value="id" data-group="Navigation"
1154
+ * data-keys="mod+n">Label</option>` elements or `setCommands([{ id, label,
1155
+ * group?, keys? }])`. `inline` renders it open in the page (no dialog,
1156
+ * e.g. for docs). `hotkey` (default `mod+k`; `none` to disable) opens it
1157
+ * from anywhere; `placeholder`, `label`. `show()`, `close()`, `toggle()`,
1158
+ * `opened`; `usa:run` { id, label }, `usa:open`, `usa:close`. A `combobox` +
1159
+ * `listbox`; reduced motion: no scale, stagger or glide.
1160
+ */
1161
+ interface PaletteCommand {
1162
+ id: string;
1163
+ label: string;
1164
+ group?: string;
1165
+ keys?: string;
1166
+ }
1167
+ interface UsaCommandPaletteElement extends UsaElement {
1168
+ readonly opened: boolean;
1169
+ commands: PaletteCommand[];
1170
+ setCommands(list: PaletteCommand[]): void;
1171
+ show(): void;
1172
+ close(): void;
1173
+ toggle(): void;
1174
+ }
1175
+ /**
1176
+ * Fuzzy match: every query letter in order. Returns a score (higher is
1177
+ * better; -1 = no match) and the matched indexes (7.9).
1178
+ */
1179
+ declare function fuzzyMatch(query: string, text: string): {
1180
+ score: number;
1181
+ hits: number[];
1182
+ };
1183
+ /** "mod+shift+k" → ["⌘", "⇧", "K"] on Apple platforms, ["Ctrl", "Shift", "K"] elsewhere (7.9). */
1184
+ declare function keyLabels(keys: string, apple?: boolean): string[];
1185
+ /** Does a KeyboardEvent match "mod+k"-style keys? (7.9) */
1186
+ declare function matchesKeys(e: KeyboardEvent, keys: string, apple?: boolean): boolean;
1187
+ declare function defineCommandPalette(tag?: string): CustomElementConstructor | undefined;
1188
+
1189
+ /**
1190
+ * `<usa-shortcut keys="mod+k">` (7.9) — a keyboard-shortcut hint rendered
1191
+ * as keycaps (⌘ on Apple platforms, Ctrl elsewhere). When the user presses
1192
+ * the combination anywhere on the page the caps press down one after another
1193
+ * and `usa:trigger` fires (`listen="false"` to only display it; `for="id"`
1194
+ * clicks that element). Optional `label` text after the caps. The caps are
1195
+ * `<kbd>` with an accessible text like "Control K"; reduced motion: no
1196
+ * press animation.
1197
+ */
1198
+ interface UsaShortcutElement extends UsaElement {
1199
+ readonly labels: string[];
1200
+ press(): void;
1201
+ }
1202
+ declare function defineShortcut(tag?: string): CustomElementConstructor | undefined;
1203
+
1094
1204
  /**
1095
1205
  * motionary/components/widgets — the 6.x animated UI widgets, in their own
1096
1206
  * entry so `motionary/components` and `components/lite` keep their size
@@ -1169,8 +1279,13 @@ declare global {
1169
1279
  'usa-field': UsaFieldElement;
1170
1280
  'usa-otp': UsaOtpElement;
1171
1281
  'usa-upload-progress': UsaUploadProgressElement;
1282
+ 'usa-chat-composer': UsaChatComposerElement;
1283
+ 'usa-suggestion-chips': UsaSuggestionChipsElement;
1284
+ 'usa-voice-button': UsaVoiceButtonElement;
1285
+ 'usa-command-palette': UsaCommandPaletteElement;
1286
+ 'usa-shortcut': UsaShortcutElement;
1172
1287
  }
1173
1288
  }
1174
1289
 
1175
- export { CAROUSEL_EFFECTS, EQ_PRESETS, MENU_EFFECTS, MODAL_EFFECTS, NAV_INDICATORS, PRESENCE_STATES, PROGRESS_VARIANTS, SEGMENTED_VARIANTS, SHEET_SIDES, SKELETON_VARIANTS, SPARK_VARIANTS, SWITCH_VARIANTS, TAB_INDICATORS, TIP_PLACEMENTS, TOAST_POSITIONS, TOGGLE_VARIANTS, WEATHER_CONDITIONS, WIDGETS, WIDGET_TAGS, badgeProgress, cartTotal, defineAddToCart, defineBadgeWall, defineBarChart, defineCarousel, defineCartDrawer, defineColorPicker, defineCompare, defineCountdown, defineCubeGallery, defineDatePicker, defineDisclosure, defineDock, defineEqualizer, defineField, defineFileDrop, defineGauge, defineGlobe, defineKanban, defineKeyframeEditor, defineKpi, defineLeaderboard, defineLocationCard, defineLyrics, defineMasonryFlow, defineMenu, defineMenuToggle, defineMessageList, defineMilestones, defineModal, defineMusicPlayer, defineNavMorph, defineNotificationBell, defineOdometer, defineOtp, definePagination, definePresence, definePrizeWheel, defineProductGallery, defineProgressRing, definePullCord, defineReactions, defineSegmented, defineSheet, defineSkeletonReveal, defineSparkline, defineStarRating, defineStepper, defineStories, defineSwipeDeck, defineSwitch, defineTabBar, defineTip, defineToastStack, defineUploadProgress, defineVolumeKnob, defineWeatherCard, defineWidgets, defineXpBar, formatBytes, formatDistance, haversine, hexToHsv, hsvToHex, initials, levelFor, monthGrid, pageWindow, parseISODate, parseLRC, parseMarkers, parseReactions, passwordStrength, project, rankRows, sanitizeCode, sparkPoints, splitTime, stackToast, wheelAngle, wrapIndex };
1176
- export type { BellNotice, CartItem, ChatMessage, GlobeMarker, LeaderRow, PresenceState, StackToastOptions, UsaAddToCartElement, UsaBadgeWallElement, UsaBarChartElement, UsaCarouselElement, UsaCartDrawerElement, UsaColorPickerElement, UsaCompareElement, UsaCountdownElement, UsaCubeGalleryElement, UsaDatePickerElement, UsaDisclosureElement, UsaDockElement, UsaEqualizerElement, UsaFieldElement, UsaFileDropElement, UsaGaugeElement, UsaGlobeElement, UsaKanbanElement, UsaKeyframeEditorElement, UsaKpiElement, UsaLeaderboardElement, UsaLocationCardElement, UsaLyricsElement, UsaMasonryFlowElement, UsaMenuElement, UsaMenuToggleElement, UsaMessageListElement, UsaMilestonesElement, UsaModalElement, UsaMusicPlayerElement, UsaNavMorphElement, UsaNotificationBellElement, UsaOdometerElement, UsaOtpElement, UsaPaginationElement, UsaPresenceElement, UsaPrizeWheelElement, UsaProductGalleryElement, UsaProgressRingElement, UsaPullCordElement, UsaReactionsElement, UsaSegmentedElement, UsaSheetElement, UsaSkeletonRevealElement, UsaSparklineElement, UsaStarRatingElement, UsaStepperElement, UsaStoriesElement, UsaSwipeDeckElement, UsaSwitchElement, UsaTabBarElement, UsaTipElement, UsaToastStackElement, UsaUploadProgressElement, UsaVolumeKnobElement, UsaWeatherCardElement, UsaXpBarElement, WallBadge };
1290
+ export { CAROUSEL_EFFECTS, EQ_PRESETS, MENU_EFFECTS, MODAL_EFFECTS, NAV_INDICATORS, PRESENCE_STATES, PROGRESS_VARIANTS, SEGMENTED_VARIANTS, SHEET_SIDES, SKELETON_VARIANTS, SPARK_VARIANTS, SWITCH_VARIANTS, TAB_INDICATORS, TIP_PLACEMENTS, TOAST_POSITIONS, TOGGLE_VARIANTS, WEATHER_CONDITIONS, WIDGETS, WIDGET_TAGS, badgeProgress, cartTotal, defineAddToCart, defineBadgeWall, defineBarChart, defineCarousel, defineCartDrawer, defineChatComposer, defineColorPicker, defineCommandPalette, defineCompare, defineCountdown, defineCubeGallery, defineDatePicker, defineDisclosure, defineDock, defineEqualizer, defineField, defineFileDrop, defineGauge, defineGlobe, defineKanban, defineKeyframeEditor, defineKpi, defineLeaderboard, defineLocationCard, defineLyrics, defineMasonryFlow, defineMenu, defineMenuToggle, defineMessageList, defineMilestones, defineModal, defineMusicPlayer, defineNavMorph, defineNotificationBell, defineOdometer, defineOtp, definePagination, definePresence, definePrizeWheel, defineProductGallery, defineProgressRing, definePullCord, defineReactions, defineSegmented, defineSheet, defineShortcut, defineSkeletonReveal, defineSparkline, defineStarRating, defineStepper, defineStories, defineSuggestionChips, defineSwipeDeck, defineSwitch, defineTabBar, defineTip, defineToastStack, defineUploadProgress, defineVoiceButton, defineVolumeKnob, defineWeatherCard, defineWidgets, defineXpBar, formatBytes, formatDistance, fuzzyMatch, haversine, hexToHsv, hsvToHex, initials, keyLabels, levelFor, matchesKeys, monthGrid, pageWindow, parseChips, parseISODate, parseLRC, parseMarkers, parseReactions, passwordStrength, project, rankRows, sanitizeCode, sparkPoints, splitTime, stackToast, waveBars, wheelAngle, wrapIndex };
1291
+ export type { BellNotice, CartItem, ChatMessage, GlobeMarker, LeaderRow, PaletteCommand, PresenceState, StackToastOptions, UsaAddToCartElement, UsaBadgeWallElement, UsaBarChartElement, UsaCarouselElement, UsaCartDrawerElement, UsaChatComposerElement, UsaColorPickerElement, UsaCommandPaletteElement, UsaCompareElement, UsaCountdownElement, UsaCubeGalleryElement, UsaDatePickerElement, UsaDisclosureElement, UsaDockElement, UsaEqualizerElement, UsaFieldElement, UsaFileDropElement, UsaGaugeElement, UsaGlobeElement, UsaKanbanElement, UsaKeyframeEditorElement, UsaKpiElement, UsaLeaderboardElement, UsaLocationCardElement, UsaLyricsElement, UsaMasonryFlowElement, UsaMenuElement, UsaMenuToggleElement, UsaMessageListElement, UsaMilestonesElement, UsaModalElement, UsaMusicPlayerElement, UsaNavMorphElement, UsaNotificationBellElement, UsaOdometerElement, UsaOtpElement, UsaPaginationElement, UsaPresenceElement, UsaPrizeWheelElement, UsaProductGalleryElement, UsaProgressRingElement, UsaPullCordElement, UsaReactionsElement, UsaSegmentedElement, UsaSheetElement, UsaShortcutElement, UsaSkeletonRevealElement, UsaSparklineElement, UsaStarRatingElement, UsaStepperElement, UsaStoriesElement, UsaSuggestionChipsElement, UsaSwipeDeckElement, UsaSwitchElement, UsaTabBarElement, UsaTipElement, UsaToastStackElement, UsaUploadProgressElement, UsaVoiceButtonElement, UsaVolumeKnobElement, UsaWeatherCardElement, UsaXpBarElement, WallBadge };
@@ -223,7 +223,9 @@ declare function defineSkeletonReveal(tag?: string): CustomElementConstructor |
223
223
  * pops the chosen star and throws a small sparkle burst, the other stars
224
224
  * ripple in sequence. `max`, `step` (`1` · `0.5`), `readonly`, `label`,
225
225
  * `icon` (`star` · `heart`). Keyboard: it is a `role="slider"` — arrows,
226
- * Home / End. Event `usa:change` (`{ value }`). Reduced motion: no pop,
226
+ * Home / End. Events `change`, `usa:change` (`{ value }`). Form-associated
227
+ * (7.9): with `name` the value is submitted like `<usa-rating>`'s, which it
228
+ * replaces in 8.0. Reduced motion: no pop,
227
229
  * burst or ripple.
228
230
  */
229
231
  interface UsaStarRatingElement extends UsaElement {
@@ -1091,6 +1093,114 @@ interface UsaUploadProgressElement extends UsaElement {
1091
1093
  declare function formatBytes(n: number): string;
1092
1094
  declare function defineUploadProgress(tag?: string): CustomElementConstructor | undefined;
1093
1095
 
1096
+ /**
1097
+ * `<usa-chat-composer>` (7.8) — an AI chat input: the textarea grows with its
1098
+ * text (up to `rows` lines, default 6), Enter sends (Shift+Enter = new line),
1099
+ * the send button pops when there is text and morphs into a Stop button while
1100
+ * `busy` — then a soft "thinking" glow runs round the composer. Sending emits
1101
+ * `usa:send` { text } (cancelable — call `preventDefault()` to keep the text)
1102
+ * and clears it; Stop emits `usa:stop`. `placeholder`, `label`, `send()`,
1103
+ * `clear()`, `value`. Reduced motion: no glow, no pop.
1104
+ */
1105
+ interface UsaChatComposerElement extends UsaElement {
1106
+ value: string;
1107
+ busy: boolean;
1108
+ send(): boolean;
1109
+ clear(): void;
1110
+ }
1111
+ declare function defineChatComposer(tag?: string): CustomElementConstructor | undefined;
1112
+
1113
+ /**
1114
+ * `<usa-suggestion-chips>` (7.8) — follow-up prompt chips for AI chats:
1115
+ * `items="Summarise|Translate|Explain like I'm 5"` (or child `<button>`s /
1116
+ * text lines). The chips slide in one after another when they appear (and
1117
+ * again after `setItems()`); picking one pulses it, emits `usa:pick`
1118
+ * { text, index } and, with `dismiss`, the others fade away. A labelled list
1119
+ * of real buttons, arrow keys move between them; reduced motion: no slide or
1120
+ * pulse.
1121
+ */
1122
+ interface UsaSuggestionChipsElement extends UsaElement {
1123
+ items: string[];
1124
+ setItems(items: string[]): void;
1125
+ }
1126
+ /** "a | b|c" → ["a", "b", "c"] (7.8). */
1127
+ declare function parseChips(s: string): string[];
1128
+ declare function defineSuggestionChips(tag?: string): CustomElementConstructor | undefined;
1129
+
1130
+ /**
1131
+ * `<usa-voice-button>` (7.8) — a push-to-talk mic button: click (or Space /
1132
+ * Enter) toggles `listening`; while listening a halo breathes round the
1133
+ * button and `bars` (default 5) wave beside it. Feed it the live input level
1134
+ * with `level` (0–1, e.g. from an `AnalyserNode` or a speech API) and the
1135
+ * bars and halo follow it; without levels they run an idle wave. `usa:start`
1136
+ * / `usa:stop`. A real `<button aria-pressed>`; `label`. Reduced motion: no
1137
+ * halo or wave — the pressed state shows by colour.
1138
+ */
1139
+ interface UsaVoiceButtonElement extends UsaElement {
1140
+ listening: boolean;
1141
+ level: number;
1142
+ toggle(force?: boolean): void;
1143
+ }
1144
+ /** Bar heights (0–1) for a level and a phase, centre bars tallest (7.8). */
1145
+ declare function waveBars(level: number, n?: number, phase?: number): number[];
1146
+ declare function defineVoiceButton(tag?: string): CustomElementConstructor | undefined;
1147
+
1148
+ /**
1149
+ * `<usa-command-palette>` (7.9) — a ⌘K command palette on the native
1150
+ * `<dialog>` (top layer, Esc, focus returns to the opener): it scales in,
1151
+ * the results filter as you type (fuzzy, matched letters highlighted) and
1152
+ * stagger in, a highlight glides to the active row (↑ / ↓, Enter runs it).
1153
+ * Commands come from child `<option value="id" data-group="Navigation"
1154
+ * data-keys="mod+n">Label</option>` elements or `setCommands([{ id, label,
1155
+ * group?, keys? }])`. `inline` renders it open in the page (no dialog,
1156
+ * e.g. for docs). `hotkey` (default `mod+k`; `none` to disable) opens it
1157
+ * from anywhere; `placeholder`, `label`. `show()`, `close()`, `toggle()`,
1158
+ * `opened`; `usa:run` { id, label }, `usa:open`, `usa:close`. A `combobox` +
1159
+ * `listbox`; reduced motion: no scale, stagger or glide.
1160
+ */
1161
+ interface PaletteCommand {
1162
+ id: string;
1163
+ label: string;
1164
+ group?: string;
1165
+ keys?: string;
1166
+ }
1167
+ interface UsaCommandPaletteElement extends UsaElement {
1168
+ readonly opened: boolean;
1169
+ commands: PaletteCommand[];
1170
+ setCommands(list: PaletteCommand[]): void;
1171
+ show(): void;
1172
+ close(): void;
1173
+ toggle(): void;
1174
+ }
1175
+ /**
1176
+ * Fuzzy match: every query letter in order. Returns a score (higher is
1177
+ * better; -1 = no match) and the matched indexes (7.9).
1178
+ */
1179
+ declare function fuzzyMatch(query: string, text: string): {
1180
+ score: number;
1181
+ hits: number[];
1182
+ };
1183
+ /** "mod+shift+k" → ["⌘", "⇧", "K"] on Apple platforms, ["Ctrl", "Shift", "K"] elsewhere (7.9). */
1184
+ declare function keyLabels(keys: string, apple?: boolean): string[];
1185
+ /** Does a KeyboardEvent match "mod+k"-style keys? (7.9) */
1186
+ declare function matchesKeys(e: KeyboardEvent, keys: string, apple?: boolean): boolean;
1187
+ declare function defineCommandPalette(tag?: string): CustomElementConstructor | undefined;
1188
+
1189
+ /**
1190
+ * `<usa-shortcut keys="mod+k">` (7.9) — a keyboard-shortcut hint rendered
1191
+ * as keycaps (⌘ on Apple platforms, Ctrl elsewhere). When the user presses
1192
+ * the combination anywhere on the page the caps press down one after another
1193
+ * and `usa:trigger` fires (`listen="false"` to only display it; `for="id"`
1194
+ * clicks that element). Optional `label` text after the caps. The caps are
1195
+ * `<kbd>` with an accessible text like "Control K"; reduced motion: no
1196
+ * press animation.
1197
+ */
1198
+ interface UsaShortcutElement extends UsaElement {
1199
+ readonly labels: string[];
1200
+ press(): void;
1201
+ }
1202
+ declare function defineShortcut(tag?: string): CustomElementConstructor | undefined;
1203
+
1094
1204
  /**
1095
1205
  * motionary/components/widgets — the 6.x animated UI widgets, in their own
1096
1206
  * entry so `motionary/components` and `components/lite` keep their size
@@ -1169,8 +1279,13 @@ declare global {
1169
1279
  'usa-field': UsaFieldElement;
1170
1280
  'usa-otp': UsaOtpElement;
1171
1281
  'usa-upload-progress': UsaUploadProgressElement;
1282
+ 'usa-chat-composer': UsaChatComposerElement;
1283
+ 'usa-suggestion-chips': UsaSuggestionChipsElement;
1284
+ 'usa-voice-button': UsaVoiceButtonElement;
1285
+ 'usa-command-palette': UsaCommandPaletteElement;
1286
+ 'usa-shortcut': UsaShortcutElement;
1172
1287
  }
1173
1288
  }
1174
1289
 
1175
- export { CAROUSEL_EFFECTS, EQ_PRESETS, MENU_EFFECTS, MODAL_EFFECTS, NAV_INDICATORS, PRESENCE_STATES, PROGRESS_VARIANTS, SEGMENTED_VARIANTS, SHEET_SIDES, SKELETON_VARIANTS, SPARK_VARIANTS, SWITCH_VARIANTS, TAB_INDICATORS, TIP_PLACEMENTS, TOAST_POSITIONS, TOGGLE_VARIANTS, WEATHER_CONDITIONS, WIDGETS, WIDGET_TAGS, badgeProgress, cartTotal, defineAddToCart, defineBadgeWall, defineBarChart, defineCarousel, defineCartDrawer, defineColorPicker, defineCompare, defineCountdown, defineCubeGallery, defineDatePicker, defineDisclosure, defineDock, defineEqualizer, defineField, defineFileDrop, defineGauge, defineGlobe, defineKanban, defineKeyframeEditor, defineKpi, defineLeaderboard, defineLocationCard, defineLyrics, defineMasonryFlow, defineMenu, defineMenuToggle, defineMessageList, defineMilestones, defineModal, defineMusicPlayer, defineNavMorph, defineNotificationBell, defineOdometer, defineOtp, definePagination, definePresence, definePrizeWheel, defineProductGallery, defineProgressRing, definePullCord, defineReactions, defineSegmented, defineSheet, defineSkeletonReveal, defineSparkline, defineStarRating, defineStepper, defineStories, defineSwipeDeck, defineSwitch, defineTabBar, defineTip, defineToastStack, defineUploadProgress, defineVolumeKnob, defineWeatherCard, defineWidgets, defineXpBar, formatBytes, formatDistance, haversine, hexToHsv, hsvToHex, initials, levelFor, monthGrid, pageWindow, parseISODate, parseLRC, parseMarkers, parseReactions, passwordStrength, project, rankRows, sanitizeCode, sparkPoints, splitTime, stackToast, wheelAngle, wrapIndex };
1176
- export type { BellNotice, CartItem, ChatMessage, GlobeMarker, LeaderRow, PresenceState, StackToastOptions, UsaAddToCartElement, UsaBadgeWallElement, UsaBarChartElement, UsaCarouselElement, UsaCartDrawerElement, UsaColorPickerElement, UsaCompareElement, UsaCountdownElement, UsaCubeGalleryElement, UsaDatePickerElement, UsaDisclosureElement, UsaDockElement, UsaEqualizerElement, UsaFieldElement, UsaFileDropElement, UsaGaugeElement, UsaGlobeElement, UsaKanbanElement, UsaKeyframeEditorElement, UsaKpiElement, UsaLeaderboardElement, UsaLocationCardElement, UsaLyricsElement, UsaMasonryFlowElement, UsaMenuElement, UsaMenuToggleElement, UsaMessageListElement, UsaMilestonesElement, UsaModalElement, UsaMusicPlayerElement, UsaNavMorphElement, UsaNotificationBellElement, UsaOdometerElement, UsaOtpElement, UsaPaginationElement, UsaPresenceElement, UsaPrizeWheelElement, UsaProductGalleryElement, UsaProgressRingElement, UsaPullCordElement, UsaReactionsElement, UsaSegmentedElement, UsaSheetElement, UsaSkeletonRevealElement, UsaSparklineElement, UsaStarRatingElement, UsaStepperElement, UsaStoriesElement, UsaSwipeDeckElement, UsaSwitchElement, UsaTabBarElement, UsaTipElement, UsaToastStackElement, UsaUploadProgressElement, UsaVolumeKnobElement, UsaWeatherCardElement, UsaXpBarElement, WallBadge };
1290
+ export { CAROUSEL_EFFECTS, EQ_PRESETS, MENU_EFFECTS, MODAL_EFFECTS, NAV_INDICATORS, PRESENCE_STATES, PROGRESS_VARIANTS, SEGMENTED_VARIANTS, SHEET_SIDES, SKELETON_VARIANTS, SPARK_VARIANTS, SWITCH_VARIANTS, TAB_INDICATORS, TIP_PLACEMENTS, TOAST_POSITIONS, TOGGLE_VARIANTS, WEATHER_CONDITIONS, WIDGETS, WIDGET_TAGS, badgeProgress, cartTotal, defineAddToCart, defineBadgeWall, defineBarChart, defineCarousel, defineCartDrawer, defineChatComposer, defineColorPicker, defineCommandPalette, defineCompare, defineCountdown, defineCubeGallery, defineDatePicker, defineDisclosure, defineDock, defineEqualizer, defineField, defineFileDrop, defineGauge, defineGlobe, defineKanban, defineKeyframeEditor, defineKpi, defineLeaderboard, defineLocationCard, defineLyrics, defineMasonryFlow, defineMenu, defineMenuToggle, defineMessageList, defineMilestones, defineModal, defineMusicPlayer, defineNavMorph, defineNotificationBell, defineOdometer, defineOtp, definePagination, definePresence, definePrizeWheel, defineProductGallery, defineProgressRing, definePullCord, defineReactions, defineSegmented, defineSheet, defineShortcut, defineSkeletonReveal, defineSparkline, defineStarRating, defineStepper, defineStories, defineSuggestionChips, defineSwipeDeck, defineSwitch, defineTabBar, defineTip, defineToastStack, defineUploadProgress, defineVoiceButton, defineVolumeKnob, defineWeatherCard, defineWidgets, defineXpBar, formatBytes, formatDistance, fuzzyMatch, haversine, hexToHsv, hsvToHex, initials, keyLabels, levelFor, matchesKeys, monthGrid, pageWindow, parseChips, parseISODate, parseLRC, parseMarkers, parseReactions, passwordStrength, project, rankRows, sanitizeCode, sparkPoints, splitTime, stackToast, waveBars, wheelAngle, wrapIndex };
1291
+ export type { BellNotice, CartItem, ChatMessage, GlobeMarker, LeaderRow, PaletteCommand, PresenceState, StackToastOptions, UsaAddToCartElement, UsaBadgeWallElement, UsaBarChartElement, UsaCarouselElement, UsaCartDrawerElement, UsaChatComposerElement, UsaColorPickerElement, UsaCommandPaletteElement, UsaCompareElement, UsaCountdownElement, UsaCubeGalleryElement, UsaDatePickerElement, UsaDisclosureElement, UsaDockElement, UsaEqualizerElement, UsaFieldElement, UsaFileDropElement, UsaGaugeElement, UsaGlobeElement, UsaKanbanElement, UsaKeyframeEditorElement, UsaKpiElement, UsaLeaderboardElement, UsaLocationCardElement, UsaLyricsElement, UsaMasonryFlowElement, UsaMenuElement, UsaMenuToggleElement, UsaMessageListElement, UsaMilestonesElement, UsaModalElement, UsaMusicPlayerElement, UsaNavMorphElement, UsaNotificationBellElement, UsaOdometerElement, UsaOtpElement, UsaPaginationElement, UsaPresenceElement, UsaPrizeWheelElement, UsaProductGalleryElement, UsaProgressRingElement, UsaPullCordElement, UsaReactionsElement, UsaSegmentedElement, UsaSheetElement, UsaShortcutElement, UsaSkeletonRevealElement, UsaSparklineElement, UsaStarRatingElement, UsaStepperElement, UsaStoriesElement, UsaSuggestionChipsElement, UsaSwipeDeckElement, UsaSwitchElement, UsaTabBarElement, UsaTipElement, UsaToastStackElement, UsaUploadProgressElement, UsaVoiceButtonElement, UsaVolumeKnobElement, UsaWeatherCardElement, UsaXpBarElement, WallBadge };