@nice2dev/ui-audio 1.1.10 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,75 @@
 # @nice2dev/ui-audio — Changelog
 
+## 1.2.0
+
+### Minor Changes
+
+- 3a4939d: 1.2.0 — the API cleanup announced for this version, dictionaries per language by default, and
+  three new controls. **Breaking:** every removal has a replacement, listed name by name in
+  `documentation/omniverk/OMNIVERK_UPGRADE_1.2.0.md`.
+
+  **Removed (breaking).** All 118 `@deprecated` names: the aliases without the `Nice` prefix in
+  `ui-audio`, `ui-graphics` and `ui-3d`; `NiceBarcodeGenerator` (→ `NiceBarcode`), `NiceFloorPlanCanvas`
+  (→ `NiceSpatialEditor` in `@nice2dev/ui-buildings`), the v2 props and types of `NiceTopNav`,
+  `NiceProgress.showLabel`, `NiceCountryPicker.showDialCode` / `showFlag`, `type` on
+  `NiceDateTimePicker` / `NiceDateRangeBox` (→ `dateFormatPreset`); `ZoneOccupancy` in
+  `ui-buildings` and `events`, the `SmartHome*` types; the icon variant `flat` (→ `cutout`) and
+  `NiceIconEditor` (→ `NiceVectorEditor`); `NiceSizeLegacy`; the `snapGrid` module of `ui-diagrams` (→
+  `@nice2dev/spatial-core`); the opt-in stylesheet `@nice2dev/ui/css/legacy-bg-text-aliases.css`, which
+  formed an alias cycle with `style.css`. Props that were accepted and never read — 19 on
+  `NiceModuleGrid`, and more on `NiceAutocomplete`, `NiceTaskInbox`, `NiceConsentBanner`, the
+  building and communication controls, four `ui-audio` panels and `NiceStreamDashboard` — are gone
+  from the types. `NiceResourceAllocation` in `ui-erp` is `NiceCapacityPlanner` (the one in `ui`
+  keeps its name); `NiceGenericPlayerStageVisualizer` (→ `NiceStageVisualizer`) and
+  `NiceCubeBrowserProps` are removed. The `@nice2dev/ui/overlays` entry calls its modal, drawer,
+  bottom sheet and context menu `NiceOverlayModal`, `NiceOverlayDrawer`, `NiceOverlayBottomSheet` and
+  `NiceOverlayContextMenu`: the old names belonged to different components of `@nice2dev/ui`.
+
+  **Dictionaries per language.** `NiceI18nProvider` loads only the language in use, with `import()`
+  (it was `NiceI18nLazyProvider` in 1.1.10, which stays as the same component); the controls show their
+  built-in English until it arrives — `await loadNiceDictionary(lang)` before the first render to start
+  in the language. Nothing on the main entry of `@nice2dev/i18n` imports a dictionary any more:
+  `NICE_I18N_DICTIONARIES`, `createTranslator`, `NICE_I18N_VARIANTS` / `resolvePlVariant` and the
+  translation tooling moved to the new entry `@nice2dev/i18n/all`, and `@nice2dev/ui-core` no longer
+  re-exports the dictionary map. `@nice2dev/ui` with what it bundles: 1283 kB → 952 kB gzip loaded up
+  front. The `ui-audio` controls read the app's `NiceI18nProvider` now; their own provider overrides it.
+
+  **New controls.** `NiceRecurrenceEditor`, `NiceStopwatch`, `NiceCountdownTimer` (`@nice2dev/ui`) and
+  `NicePasswordGenerator` (`@nice2dev/auth`), plus `recurrenceDates()` and `generatePassword()`.
+  `NiceScheduler` honours a weekly rule's `byDay`, which it ignored.
+
+  **Visible changes.** The palette meets WCAG AA for text on every fill: darker fills in the light
+  theme, dark text on the fills of the dark theme (new `--nice-text-on-success` / `-error` / `-info` /
+  `-accent` / `-warning`; `NiceThemeText` takes `onSuccess`, `onError`, `onInfo`, `onWarning`). Mobile
+  and platform panels follow the app theme instead of `prefers-color-scheme`. Swipes in
+  `NiceSwipeActions`, `NiceTouchTable` and `NiceMobileCalendar` work with a mouse and a pen. The
+  `ui-forms` editors have the intended spacing (it was four times too large). `NiceMAM`,
+  `NiceTranscoder`, `NiceVideoAnnotator` and `NiceStreamDashboard` use `nice-`-prefixed BEM classes.
+
+  **Fixes.** Controls that invented results ask the host instead: `NiceIntegrationHub`,
+  `NiceMLStudio` (`onExperimentRun` may return metrics), `NiceRemoteManagement`
+  (`onCaptureScreenshot`), `NicePoseDetector` (`detector`), `NiceBatchScannerProvider`,
+  `NiceCacheStrategies`; `NiceLowCodeStudio` accepts dropped components. Controls that did nothing
+  work or say why they are off: `NiceStreamDashboard` adds sources, sends chat and runs the chosen
+  transition (new `onAddPlatform`, `onSendChatMessage`, `onTransition`, `onScreenshot`,
+  `onOpenAudioMixer`, `onOpenSettings`; `receiveChatMessage` feeds incoming chat), `NiceMLStudio`
+  downloads through `onModelDownload`, `NiceETLBuilder` saves through `onSave` (its Save button had
+  no handler), `NiceTranscoder` makes jobs of picked and dropped files, `NiceAutomationEditor` offers
+  the trigger types its model has. Texts of about fifty components go
+  through `t()` in six languages, among them the AI data grid, chart and form builders, the ML
+  studio, the report designer, the song picker, `NiceProtocolConfig`, `NiceETLBuilder` and
+  `NiceInlineHelp` — every key the controls pass to `t()` now has a dictionary entry, so none of
+  them stays English under another language; `NiceDataGridAI` sorts on a query in any language, not
+  only in English. `NiceWindow`, `NiceConsole`, `NiceFileManager` and `NiceGitManager` no longer
+  crash when `accessMode` switches to or from `'hidden'`. Ids come from `createId()` (`@nice2dev/ui-core`), so nothing throws
+  outside a secure context as `crypto.randomUUID()` did on plain http. `ui-3d` runs on three r183
+  without its deprecation warnings. `NiceRemoteManagement` calls the handlers of the latest render.
+  The AI hint popover and the `ui-platform` panels follow the app theme, not the system's or a
+  `.dark` class on the host. `NiceCommandPalette` has styles and its search filters;
+  `NiceTimeoutFeedback` starts its clock; `NiceOfflineBanner` takes `online`; Monaco's workers in
+  `NiceCodeEditor` load; the `ui-audio` panels that used Bootstrap classes use Nice controls; colours
+  that reached a canvas as `var(…)` (karaoke lanes and notes) are resolved first.
+
 ## 1.1.10
 
 ### Patch Changes

package/README.md

@@ -147,20 +147,20 @@ This library is **backend-agnostic**. All API-dependent operations are exposed a
 
 > All controls are also exported `Nice*`-prefixed (e.g. `NiceWaveform`); the unprefixed names are kept for backward compatibility.
 
-| Module                | Components                                                                                                                                                                                         |
-| --------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **DAW Studio**        | `NiceAudioStudio` (turnkey multi-track workspace)                                                                                                                                                  |
-| **Editor**            | `Waveform`, `PianoRoll`, `CCLane`, `AudioTimeline`                                                                                                                                                 |
-| **Editor Panels**     | `AutoSavePanel`, `UndoRedoPanel`, `ZoomSnapControls`, `MasterFXPanel`, `RecordingOptionsPanel`, `CCAutomationLaneEditor`, `ArpeggiatorPanel`, `LFOPanel`, `StepSequencerPanel`                     |
-| **Karaoke**           | `NiceKaraokeManager` (orchestrator), `KaraokeLyrics`, `KaraokeTimeline`, `BarFillEditor`, `AudioPitchAnalyzer`, `NiceKaraokeSummaryOverlay`, `NiceVocalPerformanceReport`, `NicePadKaraokeOverlay` |
-| **Karaoke — songs**   | `NiceKaraokeSongBrowser`, `NiceKaraokeUploader` (`parseUltraStarText`), `NiceMusicLibraryExplorer`                                                                                                 |
-| **Karaoke — session** | `NiceKaraokeSetupPanel`, `NiceKaraokeSessionJoin`, `NiceKaraokeSelectionMode` (`useCanPickSong`), `NiceLatencyCalibrator`                                                                          |
-| **Karaoke Editor**    | `KaraokeEditorManager`, `KaraokePhaserRenderer`                                                                                                                                                    |
-| **Player**            | `GenericPlayer`, `GenericPlayerControls`, `GenericPlayerStage`, `GenericPlayerStageVisualizer`, `YouTubePlayer`                                                                                    |
-| **Input / FX**        | `NiceAudioInputPicker`, `NiceVocalEffectsRack`, `NiceAudioEffectsRack`                                                                                                                             |
-| **Visualizer**        | `StageVisualizer`, `ModeSwitcher`                                                                                                                                                                  |
-| **Playlist**          | `GenericPlaylist`, `GenericPlaylistItem`, `PlaylistTagEditor`, `DynamicRuleEditor`, `PlaylistDualPane`, `PlaylistBrowser`, `PlaylistList`, `PlaylistSidebar`                                       |
-| **Effects**           | `NoteRiver`, `NoteParticles`                                                                                                                                                                       |
+| Module                | Components                                                                                                                                                                                                         |
+| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| **DAW Studio**        | `NiceAudioStudio` (turnkey multi-track workspace)                                                                                                                                                                  |
+| **Editor**            | `NiceWaveform`, `PianoRoll`, `NiceCCLane`, `NiceAudioTimeline`                                                                                                                                                     |
+| **Editor Panels**     | `AutoSavePanel`, `UndoRedoPanel`, `ZoomSnapControls`, `MasterFXPanel`, `RecordingOptionsPanel`, `NiceCCAutomationLaneEditor`, `NiceArpeggiatorPanel`, `NiceLFOPanel`, `NiceStepSequencerPanel`                     |
+| **Karaoke**           | `NiceKaraokeManager` (orchestrator), `NiceKaraokeLyrics`, `NiceKaraokeTimeline`, `NiceBarFillEditor`, `NiceAudioPitchAnalyzer`, `NiceKaraokeSummaryOverlay`, `NiceVocalPerformanceReport`, `NicePadKaraokeOverlay` |
+| **Karaoke — songs**   | `NiceKaraokeSongBrowser`, `NiceKaraokeUploader` (`parseUltraStarText`), `NiceMusicLibraryExplorer`                                                                                                                 |
+| **Karaoke — session** | `NiceKaraokeSetupPanel`, `NiceKaraokeSessionJoin`, `NiceKaraokeSelectionMode` (`useCanPickSong`), `NiceLatencyCalibrator`                                                                                          |
+| **Karaoke Editor**    | `NiceKaraokeEditorManager`, `NiceKaraokePhaserRenderer`                                                                                                                                                            |
+| **Player**            | `NiceGenericPlayer`, `NiceGenericPlayerControls`, `NiceGenericPlayerStage`, `NiceYouTubePlayer`                                                                                                                    |
+| **Input / FX**        | `NiceAudioInputPicker`, `NiceVocalEffectsRack`, `NiceAudioEffectsRack`                                                                                                                                             |
+| **Visualizer**        | `NiceStageVisualizer`, `NiceModeSwitcher`                                                                                                                                                                          |
+| **Playlist**          | `NiceGenericPlaylist`, `GenericPlaylistItem`, `NicePlaylistTagEditor`, `NiceDynamicRuleEditor`, `NicePlaylistDualPane`, `NicePlaylistBrowser`, `PlaylistList`, `NicePlaylistSidebar`                               |
+| **Effects**           | `NiceNoteRiver`, `NiceNoteParticles`                                                                                                                                                                               |
 
 ### Hooks
 
@@ -213,12 +213,6 @@ This package ships unstyled component logic. Import the shared CSS bundle once a
 import '@nice2dev/ui/style.css';
 ```
 
-Optional: opt into the legacy shorthand token aliases (`--bg-*`, `--text-*`, `--border-*`, ...) when migrating from a custom design-token system:
-
-```tsx
-import '@nice2dev/ui/css/legacy-bg-text-aliases.css';
-```
-
 ## License
 
 MIT © NiceToDev

package/dist/assets/scoringWorker-3JjtDDtu.js

@@ -0,0 +1 @@
+(function(){"use strict";function k(t){return t>=.95?"Perfect":t>=.8?"Great":t>=.6?"Good":t>=.4?"OK":t>=.2?"Bad":"Awful"}function O(t){return t>=50?3:t>=30?2.5:t>=20?2:t>=10?1.5:1}function V(t,s,n){const{semitoneTolerance:c,preWindow:r,postExtra:a}=n,S=n.segMs??.25,w=typeof n.completionBonusFactor=="number"?n.completionBonusFactor:.15,H=typeof n.goldFullBonusFactor=="number"?n.goldFullBonusFactor:.3,N=typeof n.difficultyMult=="number"?n.difficultyMult:1,G=!!n.disableGoldNotes;let v=0,z=0,A=0;const W=[];let u=0,E=0,T=0;const B=new Map;t.forEach((o,h)=>{const d=o.startTime,Q=o.startTime+o.duration,U=d-r,X=Q+a,K=s.filter(e=>e.t>=U&&e.t<=X&&e.hz>0);if(!K||K.length===0)return;const m=Math.max(1,Math.ceil((o.duration||.25)/S)),Y=Math.max(10,Math.round(100*(o.duration||1))),Z=Math.max(1,Math.round(Y/m));let x=0;const y=[];for(let e=0;e<m;e++){const M=d+e*(o.duration/m),F=d+(e+1)*(o.duration/m),R=Math.min(.06,o.duration/m*.2),f=M-R,g=F+R,i=s.filter(l=>l.t>=f&&l.t<=g&&l.hz>0);if(!i||i.length===0)continue;let L=0;i.forEach(l=>{const ot=12*Math.log2(l.hz/440)+69,nt=Math.abs(ot-o.pitch);L+=nt});const $=L/i.length;let b=0;if(c<=0)b=$===0?1:0;else{const l=c*2;b=Math.max(0,1-Math.min($/l,1))}if(b<=0)continue;const tt=!G&&o.isGold?2:1,p=Math.round(Z*tt*b);p>0&&(v+=p,x+=p,y.push({segIndex:e,frac:b,add:p,segStart:f,segEnd:g,visualStart:M,visualEnd:F}))}const P=o.line??0;B.has(P)||B.set(P,{total:0,hit:0,comboBonus:0});const C=B.get(P);if(C.total++,x>0){u++,u>E&&(E=u),C.hit++;const e=O(u),M=e>1?Math.round(x*(e-1)):0;T+=M,C.comboBonus+=M;const F=Math.max(1,Math.ceil((o.duration||.25)/S)),f=y.length>=F,g=f?Math.round(Math.max(10,Math.round(100*(o.duration||1)))*w*(!G&&o.isGold?1.5:1)*N):0,i=f&&!G&&o.isGold?Math.round(Math.max(10,Math.round(100*(o.duration||1)))*H*N):0;z+=g,A+=i,W.push({noteKey:`${o.line??0}-${o.idx??0}`,segments:y,totalAdded:x,completed:f,completionBonus:g,goldFullBonus:i})}else u=0});const D=[];for(const[o,h]of B.entries()){const d=h.total>0?h.hit/h.total:0;D.push({verseIndex:o,hitFraction:d,label:k(d),comboBonus:h.comboBonus})}const J={maxCombo:E,currentCombo:u,totalComboBonus:T},I=T+z+A;return{classicScore:v,bonusScore:I,totalScore:v+I,perNote:W,combo:J,verseRatings:D}}function _(t,s){let n=0;for(const c of t){const r=Math.max(10,Math.round(100*(c.duration||1))),a=!s&&c.isGold?2:1;n+=r*a}return n}function j(t,s){return s<=0?0:Math.min(1e4,Math.round(t/s*1e4))}function q(t,s,n){const c=_(s,n);if(c<=0)return{...t,classicScore:0,bonusScore:0,totalScore:0};const r=j(t.classicScore,c),a=Math.round(t.bonusScore/c*1e4);return{...t,classicScore:r,bonusScore:a,totalScore:r+a}}self.onmessage=t=>{const{id:s,notes:n,points:c,params:r}=t.data,a=V(n,c,r),S=q(a,n,r.disableGoldNotes),w={id:s,result:S};self.postMessage(w)}})();

package/dist/core/i18n.d.ts

@@ -4,6 +4,7 @@ export interface NiceI18nProviderProps {
     t: NiceTranslateFn;
     children: React.ReactNode;
 }
+/** Overrides the app's global translator for the audio controls below it. */
 export declare const NiceI18nProvider: React.FC<NiceI18nProviderProps>;
 export declare function useNiceTranslation(): {
     t: NiceTranslateFn;

package/dist/dmx/DmxEditor.d.ts

@@ -7,18 +7,8 @@ export interface DmxEditorProps {
     pollInterval?: number;
     className?: string;
     style?: React.CSSProperties;
-    /** Optional precomputed channel list (standalone usage without a service). */
-    channels?: Array<{
-        id: number;
-        name?: string;
-        value: number;
-    }>;
-    /** Optional callback when a channel value changes (standalone usage). */
-    onChannelChange?: (channelId: number, value: number) => void;
-    /** Optional fixtures (informational). */
-    fixtures?: unknown[];
     /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
     tutorial?: import('@nice2dev/ui-core').NiceComponentTutorial;
 }
-export declare function DmxEditor({ service, channels: _channels, onChannelChange: _onChannelChange, fixtures: _fixtures, ...rest }: DmxEditorProps): React.JSX.Element;
+export declare function DmxEditor({ service, ...rest }: DmxEditorProps): React.JSX.Element;
 export default DmxEditor;

package/dist/editor/panels/CCAutomationLaneEditor.d.ts

@@ -13,16 +13,6 @@ interface Props {
     automation?: UseCCAutomation;
     /** Change the active CC number */
     onChangeCCNumber?: (cc: number) => void;
-    /** Optional precomputed automation points used in standalone/demo usage. */
-    points?: Array<{
-        time: number;
-        value: number;
-    }>;
-    /** Optional callback invoked with new automation points (alias of writing through `automation`). */
-    onChange?: (points: Array<{
-        time: number;
-        value: number;
-    }>) => void;
 }
 declare const CCAutomationLaneEditor: React.FC<Props>;
 export default CCAutomationLaneEditor;

package/dist/editor/panels/StepSequencerPanel.d.ts

@@ -1,13 +1,8 @@
 import { default as React } from 'react';
 import { UseStepSequencerResult } from '../../hooks/useStepSequencer';
 interface Props {
+    /** The sequencer to edit — `useStepSequencer()`. Without it the panel shows a placeholder. */
     seq?: UseStepSequencerResult;
-    /** Optional standalone props (used when no `seq` hook is provided). */
-    steps?: number;
-    tracks?: string[];
-    bpm?: number;
-    pattern?: unknown;
-    onChange?: (pattern: unknown) => void;
 }
 declare const StepSequencerPanel: React.FC<Props>;
 export default StepSequencerPanel;

package/dist/editor/panels/selectValue.d.ts

@@ -0,0 +1,2 @@
+/** NiceSelect reports `string | string[]`; a single-select panel wants the one value. */
+export declare const firstValue: (v: string | string[]) => string;

package/dist/effects/noteThemeColors.d.ts

@@ -1,7 +1,3 @@
-/**
- * noteThemeColors — reads CSS custom properties from the active theme
- * and returns a palette for NoteRiver / NoteParticles.
- */
 export interface NotePalette {
     base: string;
     staffLine: string;