motionary 7.0.0 → 7.2.0

package/dist/components/widgets.d.cts

@@ -589,6 +589,139 @@ interface UsaKeyframeEditorElement extends UsaElement {
 }
 declare function defineKeyframeEditor(tag?: string): CustomElementConstructor | undefined;
 
+/**
+ * `<usa-music-player>` (7.1) — a music player card: the cover turns like a
+ * record while playing, the play button morphs ▶ ↔ ❚❚, mini equalizer bars
+ * dance, and the progress bar is a scrubbable slider (arrows ±5 s). Plays a
+ * child `<audio>` (or `src`), or simulates a track of `duration` seconds for
+ * demos. Attributes `title`, `artist`, `cover` (image URL), `src`,
+ * `duration`. Methods `play()`, `pause()`, `toggle()`, `seek(s)`; events
+ * `usa:play`, `usa:pause`, `usa:seek`, `usa:prev`, `usa:next`. Reduced
+ * motion: no spin or dancing bars.
+ */
+interface UsaMusicPlayerElement extends UsaElement {
+    readonly playing: boolean;
+    currentTime: number;
+    readonly duration: number;
+    play(): void;
+    pause(): void;
+    toggle(): void;
+    seek(s: number): void;
+}
+declare function defineMusicPlayer(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-volume-knob>` (7.1) — a rotary knob: drag up / down (or around),
+ * scroll, or use the keyboard (arrows ±1, PageUp / PageDown ±10, Home / End)
+ * to turn it; the value arc fills, a ring of LED ticks lights up and the
+ * pointer springs to the new angle. `role="slider"`; attributes `value`,
+ * `min` (0), `max` (100), `label`, `size`. Events `usa:input` while turning,
+ * `usa:change` when done (`{ value }`). Reduced motion: no spring.
+ */
+interface UsaVolumeKnobElement extends UsaElement {
+    value: number;
+}
+declare function defineVolumeKnob(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-equalizer>` (7.1) — a graphic equalizer: one vertical slider per
+ * band (`bands`, comma-separated labels — default 60 Hz … 16 kHz), each with
+ * a springy cap; a smooth response curve is drawn through them. Presets
+ * (`preset="flat | bass | vocal | rock | electronic"` or `applyPreset()`)
+ * glide every band to its gain. Gains are −12…+12 dB; `values` (array),
+ * keyboard per band (↑ / ↓ ±1, PageUp / PageDown ±3). Event `usa:change`
+ * (`{ values }`). Reduced motion: bands jump.
+ */
+interface UsaEqualizerElement extends UsaElement {
+    values: number[];
+    applyPreset(name: string): void;
+}
+declare const EQ_PRESETS: Record<string, number[]>;
+declare function defineEqualizer(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-lyrics>` (7.1) — synced karaoke lyrics. Lines come from `[data-t]`
+ * children (start time in seconds) or LRC text (`[mm:ss.xx] line`) in a
+ * `<script type="text/plain">` child. Set `time` (s) — or `for` the id of an
+ * `<audio>` / `<video>` / `<usa-music-player>` to follow — and the active
+ * line glows and scrolls to the centre while a highlight sweeps across it
+ * word by word; past lines dim. Click a line to emit `usa:seek` (`{ time }`).
+ * Reduced motion: no sweep or smooth scroll — the active line just switches.
+ */
+interface UsaLyricsElement extends UsaElement {
+    time: number;
+    readonly lines: {
+        t: number;
+        text: string;
+    }[];
+}
+/** Parse LRC text into sorted `{ t, text }` lines. */
+declare function parseLRC(src: string): {
+    t: number;
+    text: string;
+}[];
+declare function defineLyrics(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-bar-chart>` (7.2) — an animated bar chart from data: bars grow in a
+ * stagger on first view, value labels count with them, and new data glides
+ * every bar to its new height (bars that appear grow, bars that leave
+ * shrink). Data from `data` (`[{ label, value }]`), a `values` +
+ * `labels` attribute pair, or `<data value="…">label</data>` children.
+ * `max`, `unit`, `horizontal`. Accessible as a list of "label: value"
+ * items. Reduced motion: no growth or glide.
+ */
+interface UsaBarChartElement extends UsaElement {
+    data: {
+        label: string;
+        value: number;
+    }[];
+}
+declare function defineBarChart(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-gauge>` (7.2) — a semicircular gauge: the needle swings to `value`
+ * on a damped spring (overshoot, settle), the arc fills with a colour that
+ * follows `zones` ("60:#22c55e,85:#f59e0b,100:#ef4444" — upper bound:color)
+ * and the number counts. `min` / `max` / `unit` / `label`; `role="meter"`.
+ * Reduced motion: no swing or count.
+ */
+interface UsaGaugeElement extends UsaElement {
+    value: number;
+}
+declare function defineGauge(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-sparkline>` (7.2) — a tiny inline trend line. `values`
+ * ("3,5,4,8,6,9") or the `data` property; it draws itself on first view, a
+ * soft area fades in under it, the last point pulses, and setting new data
+ * morphs the line (point-by-point tween). `variant="line | area | bars"`,
+ * `color`. Hover / touch shows a dot + value tooltip. Decorative by default
+ * with a text summary as `aria-label` ("Trend: 3 to 9, up 200%").
+ * Reduced motion: no draw, morph or pulse.
+ */
+interface UsaSparklineElement extends UsaElement {
+    data: number[];
+}
+declare const SPARK_VARIANTS: readonly ["line", "area", "bars"];
+/** Map values to SVG points in a w×h box (with padding). */
+declare function sparkPoints(vals: number[], w?: number, h?: number, pad?: number): [number, number][];
+declare function defineSparkline(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-kpi>` (7.2) — a KPI card: the value counts up on first view (keeps
+ * prefix / suffix / decimals: "$12.4k", "98.2%"), the delta chip slides in
+ * with an arrow that points and colours by sign (`delta="+12.5%"`, or
+ * `invert` when down is good), and an optional `trend` ("4,6,5,9") draws a
+ * sparkline. `label`, `value`, `delta`, `caption`. Setting `value` later
+ * rolls from the old number to the new one and flashes the card.
+ * Reduced motion: no count, slide or flash.
+ */
+interface UsaKpiElement extends UsaElement {
+    value: string;
+}
+declare function defineKpi(tag?: string): CustomElementConstructor | undefined;
+
 /**
  * motionary/components/widgets — the 6.x animated UI widgets, in their own
  * entry so `motionary/components` and `components/lite` keep their size
@@ -642,8 +775,16 @@ declare global {
         'usa-color-picker': UsaColorPickerElement;
         'usa-file-drop': UsaFileDropElement;
         'usa-keyframe-editor': UsaKeyframeEditorElement;
+        'usa-music-player': UsaMusicPlayerElement;
+        'usa-volume-knob': UsaVolumeKnobElement;
+        'usa-equalizer': UsaEqualizerElement;
+        'usa-lyrics': UsaLyricsElement;
+        'usa-bar-chart': UsaBarChartElement;
+        'usa-gauge': UsaGaugeElement;
+        'usa-sparkline': UsaSparklineElement;
+        'usa-kpi': UsaKpiElement;
     }
 }
 
-export { CAROUSEL_EFFECTS, MENU_EFFECTS, MODAL_EFFECTS, NAV_INDICATORS, PROGRESS_VARIANTS, SEGMENTED_VARIANTS, SHEET_SIDES, SKELETON_VARIANTS, SWITCH_VARIANTS, TAB_INDICATORS, TIP_PLACEMENTS, TOAST_POSITIONS, TOGGLE_VARIANTS, WEATHER_CONDITIONS, WIDGETS, WIDGET_TAGS, defineCarousel, defineColorPicker, defineCompare, defineCubeGallery, defineDatePicker, defineDisclosure, defineDock, defineFileDrop, defineKanban, defineKeyframeEditor, defineMasonryFlow, defineMenu, defineMenuToggle, defineMilestones, defineModal, defineNavMorph, defineOdometer, definePagination, defineProgressRing, definePullCord, defineSegmented, defineSheet, defineSkeletonReveal, defineStarRating, defineStepper, defineStories, defineSwipeDeck, defineSwitch, defineTabBar, defineTip, defineToastStack, defineWeatherCard, defineWidgets, hexToHsv, hsvToHex, monthGrid, pageWindow, parseISODate, stackToast };
-export type { StackToastOptions, UsaCarouselElement, UsaColorPickerElement, UsaCompareElement, UsaCubeGalleryElement, UsaDatePickerElement, UsaDisclosureElement, UsaDockElement, UsaFileDropElement, UsaKanbanElement, UsaKeyframeEditorElement, UsaMasonryFlowElement, UsaMenuElement, UsaMenuToggleElement, UsaMilestonesElement, UsaModalElement, UsaNavMorphElement, UsaOdometerElement, UsaPaginationElement, UsaProgressRingElement, UsaPullCordElement, UsaSegmentedElement, UsaSheetElement, UsaSkeletonRevealElement, UsaStarRatingElement, UsaStepperElement, UsaStoriesElement, UsaSwipeDeckElement, UsaSwitchElement, UsaTabBarElement, UsaTipElement, UsaToastStackElement, UsaWeatherCardElement };
+export { CAROUSEL_EFFECTS, EQ_PRESETS, MENU_EFFECTS, MODAL_EFFECTS, NAV_INDICATORS, 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, defineBarChart, defineCarousel, defineColorPicker, defineCompare, defineCubeGallery, defineDatePicker, defineDisclosure, defineDock, defineEqualizer, defineFileDrop, defineGauge, defineKanban, defineKeyframeEditor, defineKpi, defineLyrics, defineMasonryFlow, defineMenu, defineMenuToggle, defineMilestones, defineModal, defineMusicPlayer, defineNavMorph, defineOdometer, definePagination, defineProgressRing, definePullCord, defineSegmented, defineSheet, defineSkeletonReveal, defineSparkline, defineStarRating, defineStepper, defineStories, defineSwipeDeck, defineSwitch, defineTabBar, defineTip, defineToastStack, defineVolumeKnob, defineWeatherCard, defineWidgets, hexToHsv, hsvToHex, monthGrid, pageWindow, parseISODate, parseLRC, sparkPoints, stackToast };
+export type { StackToastOptions, UsaBarChartElement, UsaCarouselElement, UsaColorPickerElement, UsaCompareElement, UsaCubeGalleryElement, UsaDatePickerElement, UsaDisclosureElement, UsaDockElement, UsaEqualizerElement, UsaFileDropElement, UsaGaugeElement, UsaKanbanElement, UsaKeyframeEditorElement, UsaKpiElement, UsaLyricsElement, UsaMasonryFlowElement, UsaMenuElement, UsaMenuToggleElement, UsaMilestonesElement, UsaModalElement, UsaMusicPlayerElement, UsaNavMorphElement, UsaOdometerElement, UsaPaginationElement, UsaProgressRingElement, UsaPullCordElement, UsaSegmentedElement, UsaSheetElement, UsaSkeletonRevealElement, UsaSparklineElement, UsaStarRatingElement, UsaStepperElement, UsaStoriesElement, UsaSwipeDeckElement, UsaSwitchElement, UsaTabBarElement, UsaTipElement, UsaToastStackElement, UsaVolumeKnobElement, UsaWeatherCardElement };

package/dist/components/widgets.d.ts

@@ -589,6 +589,139 @@ interface UsaKeyframeEditorElement extends UsaElement {
 }
 declare function defineKeyframeEditor(tag?: string): CustomElementConstructor | undefined;
 
+/**
+ * `<usa-music-player>` (7.1) — a music player card: the cover turns like a
+ * record while playing, the play button morphs ▶ ↔ ❚❚, mini equalizer bars
+ * dance, and the progress bar is a scrubbable slider (arrows ±5 s). Plays a
+ * child `<audio>` (or `src`), or simulates a track of `duration` seconds for
+ * demos. Attributes `title`, `artist`, `cover` (image URL), `src`,
+ * `duration`. Methods `play()`, `pause()`, `toggle()`, `seek(s)`; events
+ * `usa:play`, `usa:pause`, `usa:seek`, `usa:prev`, `usa:next`. Reduced
+ * motion: no spin or dancing bars.
+ */
+interface UsaMusicPlayerElement extends UsaElement {
+    readonly playing: boolean;
+    currentTime: number;
+    readonly duration: number;
+    play(): void;
+    pause(): void;
+    toggle(): void;
+    seek(s: number): void;
+}
+declare function defineMusicPlayer(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-volume-knob>` (7.1) — a rotary knob: drag up / down (or around),
+ * scroll, or use the keyboard (arrows ±1, PageUp / PageDown ±10, Home / End)
+ * to turn it; the value arc fills, a ring of LED ticks lights up and the
+ * pointer springs to the new angle. `role="slider"`; attributes `value`,
+ * `min` (0), `max` (100), `label`, `size`. Events `usa:input` while turning,
+ * `usa:change` when done (`{ value }`). Reduced motion: no spring.
+ */
+interface UsaVolumeKnobElement extends UsaElement {
+    value: number;
+}
+declare function defineVolumeKnob(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-equalizer>` (7.1) — a graphic equalizer: one vertical slider per
+ * band (`bands`, comma-separated labels — default 60 Hz … 16 kHz), each with
+ * a springy cap; a smooth response curve is drawn through them. Presets
+ * (`preset="flat | bass | vocal | rock | electronic"` or `applyPreset()`)
+ * glide every band to its gain. Gains are −12…+12 dB; `values` (array),
+ * keyboard per band (↑ / ↓ ±1, PageUp / PageDown ±3). Event `usa:change`
+ * (`{ values }`). Reduced motion: bands jump.
+ */
+interface UsaEqualizerElement extends UsaElement {
+    values: number[];
+    applyPreset(name: string): void;
+}
+declare const EQ_PRESETS: Record<string, number[]>;
+declare function defineEqualizer(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-lyrics>` (7.1) — synced karaoke lyrics. Lines come from `[data-t]`
+ * children (start time in seconds) or LRC text (`[mm:ss.xx] line`) in a
+ * `<script type="text/plain">` child. Set `time` (s) — or `for` the id of an
+ * `<audio>` / `<video>` / `<usa-music-player>` to follow — and the active
+ * line glows and scrolls to the centre while a highlight sweeps across it
+ * word by word; past lines dim. Click a line to emit `usa:seek` (`{ time }`).
+ * Reduced motion: no sweep or smooth scroll — the active line just switches.
+ */
+interface UsaLyricsElement extends UsaElement {
+    time: number;
+    readonly lines: {
+        t: number;
+        text: string;
+    }[];
+}
+/** Parse LRC text into sorted `{ t, text }` lines. */
+declare function parseLRC(src: string): {
+    t: number;
+    text: string;
+}[];
+declare function defineLyrics(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-bar-chart>` (7.2) — an animated bar chart from data: bars grow in a
+ * stagger on first view, value labels count with them, and new data glides
+ * every bar to its new height (bars that appear grow, bars that leave
+ * shrink). Data from `data` (`[{ label, value }]`), a `values` +
+ * `labels` attribute pair, or `<data value="…">label</data>` children.
+ * `max`, `unit`, `horizontal`. Accessible as a list of "label: value"
+ * items. Reduced motion: no growth or glide.
+ */
+interface UsaBarChartElement extends UsaElement {
+    data: {
+        label: string;
+        value: number;
+    }[];
+}
+declare function defineBarChart(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-gauge>` (7.2) — a semicircular gauge: the needle swings to `value`
+ * on a damped spring (overshoot, settle), the arc fills with a colour that
+ * follows `zones` ("60:#22c55e,85:#f59e0b,100:#ef4444" — upper bound:color)
+ * and the number counts. `min` / `max` / `unit` / `label`; `role="meter"`.
+ * Reduced motion: no swing or count.
+ */
+interface UsaGaugeElement extends UsaElement {
+    value: number;
+}
+declare function defineGauge(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-sparkline>` (7.2) — a tiny inline trend line. `values`
+ * ("3,5,4,8,6,9") or the `data` property; it draws itself on first view, a
+ * soft area fades in under it, the last point pulses, and setting new data
+ * morphs the line (point-by-point tween). `variant="line | area | bars"`,
+ * `color`. Hover / touch shows a dot + value tooltip. Decorative by default
+ * with a text summary as `aria-label` ("Trend: 3 to 9, up 200%").
+ * Reduced motion: no draw, morph or pulse.
+ */
+interface UsaSparklineElement extends UsaElement {
+    data: number[];
+}
+declare const SPARK_VARIANTS: readonly ["line", "area", "bars"];
+/** Map values to SVG points in a w×h box (with padding). */
+declare function sparkPoints(vals: number[], w?: number, h?: number, pad?: number): [number, number][];
+declare function defineSparkline(tag?: string): CustomElementConstructor | undefined;
+
+/**
+ * `<usa-kpi>` (7.2) — a KPI card: the value counts up on first view (keeps
+ * prefix / suffix / decimals: "$12.4k", "98.2%"), the delta chip slides in
+ * with an arrow that points and colours by sign (`delta="+12.5%"`, or
+ * `invert` when down is good), and an optional `trend` ("4,6,5,9") draws a
+ * sparkline. `label`, `value`, `delta`, `caption`. Setting `value` later
+ * rolls from the old number to the new one and flashes the card.
+ * Reduced motion: no count, slide or flash.
+ */
+interface UsaKpiElement extends UsaElement {
+    value: string;
+}
+declare function defineKpi(tag?: string): CustomElementConstructor | undefined;
+
 /**
  * motionary/components/widgets — the 6.x animated UI widgets, in their own
  * entry so `motionary/components` and `components/lite` keep their size
@@ -642,8 +775,16 @@ declare global {
         'usa-color-picker': UsaColorPickerElement;
         'usa-file-drop': UsaFileDropElement;
         'usa-keyframe-editor': UsaKeyframeEditorElement;
+        'usa-music-player': UsaMusicPlayerElement;
+        'usa-volume-knob': UsaVolumeKnobElement;
+        'usa-equalizer': UsaEqualizerElement;
+        'usa-lyrics': UsaLyricsElement;
+        'usa-bar-chart': UsaBarChartElement;
+        'usa-gauge': UsaGaugeElement;
+        'usa-sparkline': UsaSparklineElement;
+        'usa-kpi': UsaKpiElement;
     }
 }
 
-export { CAROUSEL_EFFECTS, MENU_EFFECTS, MODAL_EFFECTS, NAV_INDICATORS, PROGRESS_VARIANTS, SEGMENTED_VARIANTS, SHEET_SIDES, SKELETON_VARIANTS, SWITCH_VARIANTS, TAB_INDICATORS, TIP_PLACEMENTS, TOAST_POSITIONS, TOGGLE_VARIANTS, WEATHER_CONDITIONS, WIDGETS, WIDGET_TAGS, defineCarousel, defineColorPicker, defineCompare, defineCubeGallery, defineDatePicker, defineDisclosure, defineDock, defineFileDrop, defineKanban, defineKeyframeEditor, defineMasonryFlow, defineMenu, defineMenuToggle, defineMilestones, defineModal, defineNavMorph, defineOdometer, definePagination, defineProgressRing, definePullCord, defineSegmented, defineSheet, defineSkeletonReveal, defineStarRating, defineStepper, defineStories, defineSwipeDeck, defineSwitch, defineTabBar, defineTip, defineToastStack, defineWeatherCard, defineWidgets, hexToHsv, hsvToHex, monthGrid, pageWindow, parseISODate, stackToast };
-export type { StackToastOptions, UsaCarouselElement, UsaColorPickerElement, UsaCompareElement, UsaCubeGalleryElement, UsaDatePickerElement, UsaDisclosureElement, UsaDockElement, UsaFileDropElement, UsaKanbanElement, UsaKeyframeEditorElement, UsaMasonryFlowElement, UsaMenuElement, UsaMenuToggleElement, UsaMilestonesElement, UsaModalElement, UsaNavMorphElement, UsaOdometerElement, UsaPaginationElement, UsaProgressRingElement, UsaPullCordElement, UsaSegmentedElement, UsaSheetElement, UsaSkeletonRevealElement, UsaStarRatingElement, UsaStepperElement, UsaStoriesElement, UsaSwipeDeckElement, UsaSwitchElement, UsaTabBarElement, UsaTipElement, UsaToastStackElement, UsaWeatherCardElement };
+export { CAROUSEL_EFFECTS, EQ_PRESETS, MENU_EFFECTS, MODAL_EFFECTS, NAV_INDICATORS, 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, defineBarChart, defineCarousel, defineColorPicker, defineCompare, defineCubeGallery, defineDatePicker, defineDisclosure, defineDock, defineEqualizer, defineFileDrop, defineGauge, defineKanban, defineKeyframeEditor, defineKpi, defineLyrics, defineMasonryFlow, defineMenu, defineMenuToggle, defineMilestones, defineModal, defineMusicPlayer, defineNavMorph, defineOdometer, definePagination, defineProgressRing, definePullCord, defineSegmented, defineSheet, defineSkeletonReveal, defineSparkline, defineStarRating, defineStepper, defineStories, defineSwipeDeck, defineSwitch, defineTabBar, defineTip, defineToastStack, defineVolumeKnob, defineWeatherCard, defineWidgets, hexToHsv, hsvToHex, monthGrid, pageWindow, parseISODate, parseLRC, sparkPoints, stackToast };
+export type { StackToastOptions, UsaBarChartElement, UsaCarouselElement, UsaColorPickerElement, UsaCompareElement, UsaCubeGalleryElement, UsaDatePickerElement, UsaDisclosureElement, UsaDockElement, UsaEqualizerElement, UsaFileDropElement, UsaGaugeElement, UsaKanbanElement, UsaKeyframeEditorElement, UsaKpiElement, UsaLyricsElement, UsaMasonryFlowElement, UsaMenuElement, UsaMenuToggleElement, UsaMilestonesElement, UsaModalElement, UsaMusicPlayerElement, UsaNavMorphElement, UsaOdometerElement, UsaPaginationElement, UsaProgressRingElement, UsaPullCordElement, UsaSegmentedElement, UsaSheetElement, UsaSkeletonRevealElement, UsaSparklineElement, UsaStarRatingElement, UsaStepperElement, UsaStoriesElement, UsaSwipeDeckElement, UsaSwitchElement, UsaTabBarElement, UsaTipElement, UsaToastStackElement, UsaVolumeKnobElement, UsaWeatherCardElement };