@djangocfg/ui-tools 2.1.203 → 2.1.205

package/dist/index.cjs

@@ -1,6 +1,6 @@
 'use strict';
 
-var chunkXMZWMGKE_cjs = require('./chunk-XMZWMGKE.cjs');
+var chunkHJMDAPQH_cjs = require('./chunk-HJMDAPQH.cjs');
 var chunk46VDB3BJ_cjs = require('./chunk-46VDB3BJ.cjs');
 require('./chunk-F2N7P5XU.cjs');
 var chunk6RG7HOVF_cjs = require('./chunk-6RG7HOVF.cjs');
@@ -791,21 +791,21 @@ function AudioLoadingFallback() {
 }
 chunkWGEGR3DF_cjs.__name(AudioLoadingFallback, "AudioLoadingFallback");
 var LazyHybridAudioPlayer = createLazyComponent(
-  () => import('./components-OZEGOPNP.cjs').then((mod) => ({ default: mod.HybridAudioPlayer })),
+  () => import('./components-F2ZYYCH4.cjs').then((mod) => ({ default: mod.HybridAudioPlayer })),
   {
     displayName: "LazyHybridAudioPlayer",
     fallback: /* @__PURE__ */ jsxRuntime.jsx(AudioLoadingFallback, {})
   }
 );
 var LazyHybridSimplePlayer = createLazyComponent(
-  () => import('./components-OZEGOPNP.cjs').then((mod) => ({ default: mod.HybridSimplePlayer })),
+  () => import('./components-F2ZYYCH4.cjs').then((mod) => ({ default: mod.HybridSimplePlayer })),
   {
     displayName: "LazyHybridSimplePlayer",
     fallback: /* @__PURE__ */ jsxRuntime.jsx(AudioLoadingFallback, {})
   }
 );
 var LazyHybridCompactPlayer = createLazyComponent(
-  () => import('./components-OZEGOPNP.cjs').then((mod) => ({ default: mod.HybridCompactPlayer })),
+  () => import('./components-F2ZYYCH4.cjs').then((mod) => ({ default: mod.HybridCompactPlayer })),
   {
     displayName: "LazyHybridCompactPlayer",
     fallback: /* @__PURE__ */ jsxRuntime.jsxs("div", { className: "flex items-center gap-2 h-8 px-1 animate-pulse", children: [
@@ -906,135 +906,143 @@ chunkWGEGR3DF_cjs.__name(CronSchedulerFallback, "CronSchedulerFallback");
 
 Object.defineProperty(exports, "AudioReactiveCover", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.AudioReactiveCover; }
+  get: function () { return chunkHJMDAPQH_cjs.AudioReactiveCover; }
 });
 Object.defineProperty(exports, "COLOR_SCHEMES", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.COLOR_SCHEMES; }
+  get: function () { return chunkHJMDAPQH_cjs.COLOR_SCHEMES; }
 });
 Object.defineProperty(exports, "COLOR_SCHEME_INFO", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.COLOR_SCHEME_INFO; }
+  get: function () { return chunkHJMDAPQH_cjs.COLOR_SCHEME_INFO; }
 });
 Object.defineProperty(exports, "EFFECT_ANIMATIONS", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.EFFECT_ANIMATIONS; }
+  get: function () { return chunkHJMDAPQH_cjs.EFFECT_ANIMATIONS; }
 });
 Object.defineProperty(exports, "GlowEffect", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.GlowEffect; }
+  get: function () { return chunkHJMDAPQH_cjs.GlowEffect; }
 });
 Object.defineProperty(exports, "HybridAudioPlayer", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.HybridAudioPlayer; }
+  get: function () { return chunkHJMDAPQH_cjs.HybridAudioPlayer; }
 });
 Object.defineProperty(exports, "HybridAudioProvider", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.HybridAudioProvider; }
+  get: function () { return chunkHJMDAPQH_cjs.HybridAudioProvider; }
 });
 Object.defineProperty(exports, "HybridSimplePlayer", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.HybridSimplePlayer; }
+  get: function () { return chunkHJMDAPQH_cjs.HybridSimplePlayer; }
 });
 Object.defineProperty(exports, "HybridWaveform", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.HybridWaveform; }
+  get: function () { return chunkHJMDAPQH_cjs.HybridWaveform; }
 });
 Object.defineProperty(exports, "INTENSITY_CONFIG", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.INTENSITY_CONFIG; }
+  get: function () { return chunkHJMDAPQH_cjs.INTENSITY_CONFIG; }
 });
 Object.defineProperty(exports, "INTENSITY_INFO", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.INTENSITY_INFO; }
+  get: function () { return chunkHJMDAPQH_cjs.INTENSITY_INFO; }
 });
 Object.defineProperty(exports, "MeshEffect", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.MeshEffect; }
+  get: function () { return chunkHJMDAPQH_cjs.MeshEffect; }
 });
 Object.defineProperty(exports, "OrbsEffect", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.OrbsEffect; }
+  get: function () { return chunkHJMDAPQH_cjs.OrbsEffect; }
 });
 Object.defineProperty(exports, "SpotlightEffect", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.SpotlightEffect; }
+  get: function () { return chunkHJMDAPQH_cjs.SpotlightEffect; }
 });
 Object.defineProperty(exports, "VARIANT_INFO", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.VARIANT_INFO; }
+  get: function () { return chunkHJMDAPQH_cjs.VARIANT_INFO; }
 });
 Object.defineProperty(exports, "VisualizationProvider", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.VisualizationProvider; }
+  get: function () { return chunkHJMDAPQH_cjs.VisualizationProvider; }
 });
 Object.defineProperty(exports, "calculateGlowLayers", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.calculateGlowLayers; }
+  get: function () { return chunkHJMDAPQH_cjs.calculateGlowLayers; }
 });
 Object.defineProperty(exports, "calculateMeshGradients", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.calculateMeshGradients; }
+  get: function () { return chunkHJMDAPQH_cjs.calculateMeshGradients; }
 });
 Object.defineProperty(exports, "calculateOrbs", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.calculateOrbs; }
+  get: function () { return chunkHJMDAPQH_cjs.calculateOrbs; }
 });
 Object.defineProperty(exports, "calculateSpotlight", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.calculateSpotlight; }
+  get: function () { return chunkHJMDAPQH_cjs.calculateSpotlight; }
 });
 Object.defineProperty(exports, "formatTime", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.formatTime; }
+  get: function () { return chunkHJMDAPQH_cjs.formatTime; }
 });
 Object.defineProperty(exports, "getColors", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.getColors; }
+  get: function () { return chunkHJMDAPQH_cjs.getColors; }
 });
 Object.defineProperty(exports, "getEffectConfig", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.getEffectConfig; }
+  get: function () { return chunkHJMDAPQH_cjs.getEffectConfig; }
 });
 Object.defineProperty(exports, "prepareEffectColors", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.prepareEffectColors; }
+  get: function () { return chunkHJMDAPQH_cjs.prepareEffectColors; }
+});
+Object.defineProperty(exports, "useAudioBus", {
+  enumerable: true,
+  get: function () { return chunkHJMDAPQH_cjs.useAudioBus; }
+});
+Object.defineProperty(exports, "useAudioBusStore", {
+  enumerable: true,
+  get: function () { return chunkHJMDAPQH_cjs.useAudioBusStore; }
 });
 Object.defineProperty(exports, "useAudioVisualization", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useAudioVisualization; }
+  get: function () { return chunkHJMDAPQH_cjs.useAudioVisualization; }
 });
 Object.defineProperty(exports, "useHybridAudio", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useHybridAudio; }
+  get: function () { return chunkHJMDAPQH_cjs.useHybridAudio; }
 });
 Object.defineProperty(exports, "useHybridAudioAnalysis", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useHybridAudioAnalysis; }
+  get: function () { return chunkHJMDAPQH_cjs.useHybridAudioAnalysis; }
 });
 Object.defineProperty(exports, "useHybridAudioContext", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useHybridAudioContext; }
+  get: function () { return chunkHJMDAPQH_cjs.useHybridAudioContext; }
 });
 Object.defineProperty(exports, "useHybridAudioControls", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useHybridAudioControls; }
+  get: function () { return chunkHJMDAPQH_cjs.useHybridAudioControls; }
 });
 Object.defineProperty(exports, "useHybridAudioLevels", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useHybridAudioLevels; }
+  get: function () { return chunkHJMDAPQH_cjs.useHybridAudioLevels; }
 });
 Object.defineProperty(exports, "useHybridAudioState", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useHybridAudioState; }
+  get: function () { return chunkHJMDAPQH_cjs.useHybridAudioState; }
 });
 Object.defineProperty(exports, "useHybridWebAudio", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useHybridWebAudio; }
+  get: function () { return chunkHJMDAPQH_cjs.useHybridWebAudio; }
 });
 Object.defineProperty(exports, "useVisualization", {
   enumerable: true,
-  get: function () { return chunkXMZWMGKE_cjs.useVisualization; }
+  get: function () { return chunkHJMDAPQH_cjs.useVisualization; }
 });
 Object.defineProperty(exports, "NativeProvider", {
   enumerable: true,

package/dist/index.d.cts

@@ -6,10 +6,10 @@ import { Language } from 'prism-react-renderer';
 export { Language } from 'prism-react-renderer';
 import { RJSFSchema, UiSchema, WidgetProps, FieldTemplateProps, ObjectFieldTemplateProps, ArrayFieldTemplateProps, ArrayFieldItemTemplateProps, ErrorListProps } from '@rjsf/utils';
 import { FormProps, IChangeEvent } from '@rjsf/core';
+import * as zustand from 'zustand';
 import { CommonExternalProps } from 'react-json-tree';
 import { MediaPlayerInstance } from '@vidstack/react';
 import * as zustand_middleware from 'zustand/middleware';
-import * as zustand from 'zustand';
 
 interface LoadingFallbackProps {
     /** Minimum height of the loading container */
@@ -640,6 +640,24 @@ declare function calculateSpotlight(levels: AudioLevels, config: EffectConfig$1,
  */
 declare const EFFECT_ANIMATIONS = "\n  @keyframes spotlight-spin {\n    0% { transform: rotate(0deg); }\n    100% { transform: rotate(360deg); }\n  }\n\n  @keyframes orb-float-1 {\n    0%, 100% { transform: translate(-50%, -50%) translateY(0); }\n    50% { transform: translate(-50%, -50%) translateY(-15px); }\n  }\n\n  @keyframes orb-float-2 {\n    0%, 100% { transform: translate(-50%, -50%) translateX(0); }\n    50% { transform: translate(-50%, -50%) translateX(15px); }\n  }\n\n  @keyframes orb-float-3 {\n    0%, 100% { transform: translate(-50%, -50%) translate(0, 0); }\n    33% { transform: translate(-50%, -50%) translate(10px, -10px); }\n    66% { transform: translate(-50%, -50%) translate(-10px, 10px); }\n  }\n\n  @keyframes orb-float-4 {\n    0%, 100% { transform: translate(-50%, -50%) translate(0, 0); }\n    50% { transform: translate(-50%, -50%) translate(-15px, -10px); }\n  }\n\n  @keyframes mesh-float-1 {\n    0%, 100% { transform: translate(0, 0) scale(1); }\n    25% { transform: translate(-5%, 10%) scale(1.05); }\n    50% { transform: translate(5%, 5%) scale(0.95); }\n    75% { transform: translate(-3%, -5%) scale(1.02); }\n  }\n\n  @keyframes mesh-float-2 {\n    0%, 100% { transform: translate(0, 0) scale(1); }\n    33% { transform: translate(8%, -8%) scale(1.08); }\n    66% { transform: translate(-6%, 6%) scale(0.92); }\n  }\n\n  @keyframes mesh-float-3 {\n    0%, 100% { transform: translate(0, 0) scale(1); }\n    50% { transform: translate(10%, 10%) scale(1.1); }\n  }\n\n  @keyframes mesh-float-4 {\n    0%, 100% { transform: translate(0, 0) scale(1) rotate(0deg); }\n    25% { transform: translate(10%, -5%) scale(1.1) rotate(5deg); }\n    50% { transform: translate(-5%, 10%) scale(0.95) rotate(-5deg); }\n    75% { transform: translate(-10%, -10%) scale(1.05) rotate(3deg); }\n  }\n\n  @keyframes mesh-pulse {\n    0%, 100% { transform: translate(-50%, -50%) scale(1); opacity: 0.3; }\n    50% { transform: translate(-50%, -50%) scale(1.2); opacity: 0.5; }\n  }\n\n  @keyframes glow-breathe {\n    0%, 100% { opacity: 0.6; transform: scale(1); }\n    50% { opacity: 1; transform: scale(1.05); }\n  }\n\n  @keyframes glow-rotate {\n    0% { transform: rotate(0deg); }\n    100% { transform: rotate(360deg); }\n  }\n\n  @keyframes sparkle-move {\n    0% { opacity: 0; transform: scale(0.8); }\n    50% { opacity: 1; }\n    100% { opacity: 0; transform: scale(1.2); }\n  }\n";
 
+interface AudioBusStore {
+    /** ID of the currently active (playing) player, null if none */
+    activeId: string | null;
+    setActiveId: (id: string | null) => void;
+}
+declare const useAudioBusStore: zustand.UseBoundStore<zustand.StoreApi<AudioBusStore>>;
+interface UseAudioBusReturn {
+    /** Broadcast: this player is now playing — all others should stop */
+    announce: () => void;
+    /** Release: this player stopped (clears activeId if it was ours) */
+    release: () => void;
+}
+/**
+ * @param playerId  Stable unique ID for this player instance
+ * @param onStop    Called when another player announces — should pause this player
+ */
+declare function useAudioBus(playerId: string, onStop: () => void): UseAudioBusReturn;
+
 interface UseHybridAudioOptions {
     src: string;
     autoPlay?: boolean;
@@ -2298,4 +2316,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, EFFECT_ANIMATIONS, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, type HybridCompactPlayerProps, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownMessage, type MarkdownMessageProps, type MarkerData, Mermaid, type MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLottie, useMediaCacheStore, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };
+export { ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, EFFECT_ANIMATIONS, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, type HybridCompactPlayerProps, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownMessage, type MarkdownMessageProps, type MarkerData, Mermaid, type MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioBusReturn, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioBus, useAudioBusStore, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLottie, useMediaCacheStore, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };

package/dist/index.d.ts

@@ -6,10 +6,10 @@ import { Language } from 'prism-react-renderer';
 export { Language } from 'prism-react-renderer';
 import { RJSFSchema, UiSchema, WidgetProps, FieldTemplateProps, ObjectFieldTemplateProps, ArrayFieldTemplateProps, ArrayFieldItemTemplateProps, ErrorListProps } from '@rjsf/utils';
 import { FormProps, IChangeEvent } from '@rjsf/core';
+import * as zustand from 'zustand';
 import { CommonExternalProps } from 'react-json-tree';
 import { MediaPlayerInstance } from '@vidstack/react';
 import * as zustand_middleware from 'zustand/middleware';
-import * as zustand from 'zustand';
 
 interface LoadingFallbackProps {
     /** Minimum height of the loading container */
@@ -640,6 +640,24 @@ declare function calculateSpotlight(levels: AudioLevels, config: EffectConfig$1,
  */
 declare const EFFECT_ANIMATIONS = "\n  @keyframes spotlight-spin {\n    0% { transform: rotate(0deg); }\n    100% { transform: rotate(360deg); }\n  }\n\n  @keyframes orb-float-1 {\n    0%, 100% { transform: translate(-50%, -50%) translateY(0); }\n    50% { transform: translate(-50%, -50%) translateY(-15px); }\n  }\n\n  @keyframes orb-float-2 {\n    0%, 100% { transform: translate(-50%, -50%) translateX(0); }\n    50% { transform: translate(-50%, -50%) translateX(15px); }\n  }\n\n  @keyframes orb-float-3 {\n    0%, 100% { transform: translate(-50%, -50%) translate(0, 0); }\n    33% { transform: translate(-50%, -50%) translate(10px, -10px); }\n    66% { transform: translate(-50%, -50%) translate(-10px, 10px); }\n  }\n\n  @keyframes orb-float-4 {\n    0%, 100% { transform: translate(-50%, -50%) translate(0, 0); }\n    50% { transform: translate(-50%, -50%) translate(-15px, -10px); }\n  }\n\n  @keyframes mesh-float-1 {\n    0%, 100% { transform: translate(0, 0) scale(1); }\n    25% { transform: translate(-5%, 10%) scale(1.05); }\n    50% { transform: translate(5%, 5%) scale(0.95); }\n    75% { transform: translate(-3%, -5%) scale(1.02); }\n  }\n\n  @keyframes mesh-float-2 {\n    0%, 100% { transform: translate(0, 0) scale(1); }\n    33% { transform: translate(8%, -8%) scale(1.08); }\n    66% { transform: translate(-6%, 6%) scale(0.92); }\n  }\n\n  @keyframes mesh-float-3 {\n    0%, 100% { transform: translate(0, 0) scale(1); }\n    50% { transform: translate(10%, 10%) scale(1.1); }\n  }\n\n  @keyframes mesh-float-4 {\n    0%, 100% { transform: translate(0, 0) scale(1) rotate(0deg); }\n    25% { transform: translate(10%, -5%) scale(1.1) rotate(5deg); }\n    50% { transform: translate(-5%, 10%) scale(0.95) rotate(-5deg); }\n    75% { transform: translate(-10%, -10%) scale(1.05) rotate(3deg); }\n  }\n\n  @keyframes mesh-pulse {\n    0%, 100% { transform: translate(-50%, -50%) scale(1); opacity: 0.3; }\n    50% { transform: translate(-50%, -50%) scale(1.2); opacity: 0.5; }\n  }\n\n  @keyframes glow-breathe {\n    0%, 100% { opacity: 0.6; transform: scale(1); }\n    50% { opacity: 1; transform: scale(1.05); }\n  }\n\n  @keyframes glow-rotate {\n    0% { transform: rotate(0deg); }\n    100% { transform: rotate(360deg); }\n  }\n\n  @keyframes sparkle-move {\n    0% { opacity: 0; transform: scale(0.8); }\n    50% { opacity: 1; }\n    100% { opacity: 0; transform: scale(1.2); }\n  }\n";
 
+interface AudioBusStore {
+    /** ID of the currently active (playing) player, null if none */
+    activeId: string | null;
+    setActiveId: (id: string | null) => void;
+}
+declare const useAudioBusStore: zustand.UseBoundStore<zustand.StoreApi<AudioBusStore>>;
+interface UseAudioBusReturn {
+    /** Broadcast: this player is now playing — all others should stop */
+    announce: () => void;
+    /** Release: this player stopped (clears activeId if it was ours) */
+    release: () => void;
+}
+/**
+ * @param playerId  Stable unique ID for this player instance
+ * @param onStop    Called when another player announces — should pause this player
+ */
+declare function useAudioBus(playerId: string, onStop: () => void): UseAudioBusReturn;
+
 interface UseHybridAudioOptions {
     src: string;
     autoPlay?: boolean;
@@ -2298,4 +2316,4 @@ declare function useBlobUrlCleanup(key: string | null): void;
  */
 declare function generateContentKey(content: ArrayBuffer): string;
 
-export { ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, EFFECT_ANIMATIONS, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, type HybridCompactPlayerProps, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownMessage, type MarkdownMessageProps, type MarkerData, Mermaid, type MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLottie, useMediaCacheStore, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };
+export { ArrayFieldItemTemplate, ArrayFieldTemplate, type AspectRatioValue, type AudioLevels, AudioReactiveCover, type AudioReactiveCoverProps, BaseInputTemplate, type BlobSource, COLOR_SCHEMES, COLOR_SCHEME_INFO, CardLoadingFallback, CheckboxWidget, ColorWidget, type CreateLazyComponentOptions, type CreateVideoErrorFallbackOptions, CronScheduler, type CronSchedulerContextValue, type CronSchedulerProps, CronSchedulerProvider, type CronSchedulerState, CustomInput, type DASHSource, type DataUrlSource, DayChips, EFFECT_ANIMATIONS, type EffectColorScheme, type EffectColors, type EffectConfig$1 as EffectConfig, type EffectIntensity, type EffectLayer, type EffectVariant, type EqualizerOptions, type ErrorFallbackProps, ErrorListTemplate, FieldTemplate, GlowEffect, type GlowEffectData, type HLSSource, type HybridAudioContextValue, type HybridAudioControls, HybridAudioPlayer, type HybridAudioPlayerProps, HybridAudioProvider, type HybridAudioProviderProps, type HybridAudioState, type HybridCompactPlayerProps, HybridSimplePlayer, type HybridSimplePlayerProps, HybridWaveform, type HybridWaveformProps, type HybridWebAudioAPI, INTENSITY_CONFIG, INTENSITY_INFO, type ImageFile, ImageViewer, type ImageViewerProps, JsonSchemaForm, type JsonSchemaFormProps, JsonTreeComponent as JsonTree, type JsonTreeConfig, type JsonTreeProps, LazyCronScheduler, LazyHybridAudioPlayer, LazyHybridCompactPlayer, LazyHybridSimplePlayer, LazyImageViewer, LazyJsonSchemaForm, LazyJsonTree, LazyLottiePlayer, LazyMapContainer, LazyMapView, LazyMermaid, LazyOpenapiViewer, LazyPrettyCode, LazyVideoPlayer, LazyWrapper, type LazyWrapperProps, LoadingFallback, type LoadingFallbackProps, type LottieDirection, LottiePlayer, type LottiePlayerProps, type LottieSize, type LottieSpeed, type MapContainerProps, MapLoadingFallback, type MapStyleKey, type MapViewport, MarkdownMessage, type MarkdownMessageProps, type MarkerData, Mermaid, type MermaidProps, MeshEffect, type MonthDay, MonthDayGrid, NativeProvider, NumberWidget, ObjectFieldTemplate, Playground as OpenapiViewer, OrbsEffect, type PlayerMode, type PlaygroundConfig, type PlaygroundProps$1 as PlaygroundProps, PrettyCode, type PrettyCodeProps$1 as PrettyCodeProps, type ResolveFileSourceOptions, SchedulePreview, type ScheduleType, ScheduleTypeSelector, type SchemaSource, SelectWidget, type SimpleStreamSource, SliderWidget, Spinner, SpotlightEffect, StreamProvider, type StreamSource, SwitchWidget, TextWidget, TimeSelector, type UrlSource, type UseAudioBusReturn, type UseAudioVisualizationReturn, type UseCollapsibleContentOptions, type UseCollapsibleContentResult, type UseHybridAudioOptions, type UseHybridAudioReturn, type UseLottieOptions, type UseLottieReturn, type UseVisualizationReturn, VARIANT_INFO, VideoControls, VideoErrorFallback, type VideoErrorFallbackProps, VideoPlayer, type VideoPlayerContextValue, type VideoPlayerProps, VideoPlayerProvider, type VideoPlayerProviderProps, type VideoPlayerRef, type VideoSourceUnion, VidstackProvider, type VimeoSource, type VisualizationColorScheme, type VisualizationIntensity, VisualizationProvider, type VisualizationProviderProps, type VisualizationSettings, type VisualizationVariant, type WeekDay, type YouTubeSource, buildCron, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, createLazyComponent, createVideoErrorFallback, formatTime, generateContentKey, getColors, getEffectConfig, getRequiredFields, hasRequiredFields, humanizeCron, isSimpleStreamSource, isValidCron, mergeDefaults, normalizeFormData, parseCron, prepareEffectColors, resolveFileSource, resolvePlayerMode, resolveStreamSource, safeJsonParse, safeJsonStringify, useAudioBus, useAudioBusStore, useAudioCache, useAudioVisualization, useBlobUrlCleanup, useCollapsibleContent, useCronCustom, useCronMonthDays, useCronPreview, useCronScheduler, useCronSchedulerContext, useCronTime, useCronType, useCronWeekDays, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useImageCache, useLottie, useMediaCacheStore, useVideoCache, useVideoPlayerContext, useVideoPlayerSettings, useVisualization, validateRequiredFields, validateSchema };

package/dist/index.mjs

@@ -1,4 +1,4 @@
-export { AudioReactiveCover, COLOR_SCHEMES, COLOR_SCHEME_INFO, EFFECT_ANIMATIONS, GlowEffect, HybridAudioPlayer, HybridAudioProvider, HybridSimplePlayer, HybridWaveform, INTENSITY_CONFIG, INTENSITY_INFO, MeshEffect, OrbsEffect, SpotlightEffect, VARIANT_INFO, VisualizationProvider, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, formatTime, getColors, getEffectConfig, prepareEffectColors, useAudioVisualization, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useVisualization } from './chunk-O55KZXKD.mjs';
+export { AudioReactiveCover, COLOR_SCHEMES, COLOR_SCHEME_INFO, EFFECT_ANIMATIONS, GlowEffect, HybridAudioPlayer, HybridAudioProvider, HybridSimplePlayer, HybridWaveform, INTENSITY_CONFIG, INTENSITY_INFO, MeshEffect, OrbsEffect, SpotlightEffect, VARIANT_INFO, VisualizationProvider, calculateGlowLayers, calculateMeshGradients, calculateOrbs, calculateSpotlight, formatTime, getColors, getEffectConfig, prepareEffectColors, useAudioBus, useAudioBusStore, useAudioVisualization, useHybridAudio, useHybridAudioAnalysis, useHybridAudioContext, useHybridAudioControls, useHybridAudioLevels, useHybridAudioState, useHybridWebAudio, useVisualization } from './chunk-CDP3K6BI.mjs';
 export { NativeProvider, StreamProvider, VideoControls, VideoErrorFallback, VideoPlayer, VideoPlayerProvider, VidstackProvider, createVideoErrorFallback, isSimpleStreamSource, resolveFileSource, resolvePlayerMode, resolveStreamSource, useVideoPlayerContext } from './chunk-QKG4LERV.mjs';
 import './chunk-JWB2EWQO.mjs';
 export { ImageViewer } from './chunk-MADKYFI3.mjs';
@@ -767,21 +767,21 @@ function AudioLoadingFallback() {
 }
 __name(AudioLoadingFallback, "AudioLoadingFallback");
 var LazyHybridAudioPlayer = createLazyComponent(
-  () => import('./components-R4CC6JGG.mjs').then((mod) => ({ default: mod.HybridAudioPlayer })),
+  () => import('./components-3RJ5Y3TB.mjs').then((mod) => ({ default: mod.HybridAudioPlayer })),
   {
     displayName: "LazyHybridAudioPlayer",
     fallback: /* @__PURE__ */ jsx(AudioLoadingFallback, {})
   }
 );
 var LazyHybridSimplePlayer = createLazyComponent(
-  () => import('./components-R4CC6JGG.mjs').then((mod) => ({ default: mod.HybridSimplePlayer })),
+  () => import('./components-3RJ5Y3TB.mjs').then((mod) => ({ default: mod.HybridSimplePlayer })),
   {
     displayName: "LazyHybridSimplePlayer",
     fallback: /* @__PURE__ */ jsx(AudioLoadingFallback, {})
   }
 );
 var LazyHybridCompactPlayer = createLazyComponent(
-  () => import('./components-R4CC6JGG.mjs').then((mod) => ({ default: mod.HybridCompactPlayer })),
+  () => import('./components-3RJ5Y3TB.mjs').then((mod) => ({ default: mod.HybridCompactPlayer })),
   {
     displayName: "LazyHybridCompactPlayer",
     fallback: /* @__PURE__ */ jsxs("div", { className: "flex items-center gap-2 h-8 px-1 animate-pulse", children: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@djangocfg/ui-tools",
-  "version": "2.1.203",
+  "version": "2.1.205",
   "description": "Heavy React tools with lazy loading - for Electron, Vite, CRA, Next.js apps",
   "keywords": [
     "ui-tools",
@@ -78,8 +78,8 @@
     "check": "tsc --noEmit"
   },
   "peerDependencies": {
-    "@djangocfg/i18n": "^2.1.203",
-    "@djangocfg/ui-core": "^2.1.203",
+    "@djangocfg/i18n": "^2.1.205",
+    "@djangocfg/ui-core": "^2.1.205",
     "lucide-react": "^0.545.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
@@ -112,10 +112,10 @@
     "@maplibre/maplibre-gl-geocoder": "^1.7.0"
   },
   "devDependencies": {
-    "@djangocfg/i18n": "^2.1.203",
+    "@djangocfg/i18n": "^2.1.205",
     "@djangocfg/playground": "workspace:*",
-    "@djangocfg/typescript-config": "^2.1.203",
-    "@djangocfg/ui-core": "^2.1.203",
+    "@djangocfg/typescript-config": "^2.1.205",
+    "@djangocfg/ui-core": "^2.1.205",
     "@types/mapbox__mapbox-gl-draw": "^1.4.8",
     "@types/node": "^24.7.2",
     "@types/react": "^19.1.0",

package/src/index.ts

@@ -87,6 +87,10 @@ export {
 } from './tools/AudioPlayer/lazy';
 export type { HybridCompactPlayerProps } from './tools/AudioPlayer/lazy';
 
+// AudioBus — global audio exclusivity (one player at a time)
+export { useAudioBus, useAudioBusStore } from './tools/AudioPlayer/hooks/useAudioBus';
+export type { UseAudioBusReturn } from './tools/AudioPlayer/hooks/useAudioBus';
+
 // VideoPlayer (~150KB)
 export { LazyVideoPlayer } from './tools/VideoPlayer/lazy';