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.
- package/CHANGELOG.md +29 -0
- package/bin/usa-codemod-8.mjs +74 -0
- package/dist/components/angular.d.cts +4 -0
- package/dist/components/angular.d.ts +4 -0
- package/dist/components/fx-ai.cjs +130 -0
- package/dist/components/fx-ai.cjs.map +1 -0
- package/dist/components/fx-ai.d.cts +66 -0
- package/dist/components/fx-ai.d.ts +66 -0
- package/dist/components/fx-ai.js +126 -0
- package/dist/components/fx-ai.js.map +1 -0
- package/dist/components/fx2.cjs +6 -0
- package/dist/components/fx2.cjs.map +1 -1
- package/dist/components/fx2.d.cts +23 -1
- package/dist/components/fx2.d.ts +23 -1
- package/dist/components/fx2.js +5 -1
- package/dist/components/fx2.js.map +1 -1
- package/dist/components/lite.cjs +1 -0
- package/dist/components/lite.cjs.map +1 -1
- package/dist/components/lite.js +1 -0
- package/dist/components/lite.js.map +1 -1
- package/dist/components/solid.d.cts +4 -0
- package/dist/components/solid.d.ts +4 -0
- package/dist/components/svelte.d.cts +4 -0
- package/dist/components/svelte.d.ts +4 -0
- package/dist/components/ui.cjs +1 -0
- package/dist/components/ui.cjs.map +1 -1
- package/dist/components/ui.d.cts +4 -0
- package/dist/components/ui.d.ts +4 -0
- package/dist/components/ui.js +2 -1
- package/dist/components/ui.js.map +1 -1
- package/dist/components/vue.d.cts +4 -0
- package/dist/components/vue.d.ts +4 -0
- package/dist/components/widgets.cjs +733 -128
- package/dist/components/widgets.cjs.map +1 -1
- package/dist/components/widgets.d.cts +118 -3
- package/dist/components/widgets.d.ts +118 -3
- package/dist/components/widgets.js +724 -129
- package/dist/components/widgets.js.map +1 -1
- package/dist/components.d.cts +4 -0
- package/dist/components.d.ts +4 -0
- package/dist/components.umd.js +2 -2
- package/dist/components.umd.js.map +1 -1
- package/dist/widgets.umd.js +1 -1
- package/dist/widgets.umd.js.map +1 -1
- package/docs/ROADMAP.md +2 -2
- package/docs/components.md +42 -0
- package/docs/deprecations.md +4 -0
- package/docs/upgrading-8.md +34 -0
- 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.
|
|
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.
|
|
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 };
|