@nice2dev/game-engine 1.1.9 → 1.2.0

package/CHANGELOG.md

@@ -1,5 +1,144 @@
 # @nice2dev/game-engine — 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
+
+- The package description on npm shows a dash instead of the mis-encoded "—".
+- 1.1.10 — the additive part of OmniVerk's 1.2.0 list: ui-audio builds without optional packages, one
+  i18n context, dictionaries per language, data props optional. No breaking changes.
+
+  **`@nice2dev/ui-audio` no longer breaks the consumer's build.** It imported `react-bootstrap`,
+  `recharts`, `react-window`, `react-youtube` and `pitchy` statically while declaring none of them
+  (only optional entries in `peerDependenciesMeta`), so a Vite app without them failed with "failed to
+  resolve import". Loading them with `import()` is no way out: Vite 8 (Rolldown) resolves dynamic
+  imports at build time and fails the same way, which made `hls.js` and `phaser` mandatory too.
+  `react-bootstrap`, `recharts`, `react-window` and `phaser` are now gone from the code
+  (`NiceBarFillEditor` uses Nice controls, `NiceVocalPerformanceReport` uses `NiceChart` /
+  `NicePieChart`, the karaoke editor list uses `NiceVirtualScroller`, `NiceKaraokePhaserRenderer`
+  renders with the DOM and keeps its name); `pitchy`, `react-youtube` and `hls.js` are regular
+  `dependencies`. Found on the way: in live mode the vocal performance report subtracted UltraStar note
+  numbers from MIDI pitch, so every singer got thousands of cents of deviation and 0 % accuracy — it now
+  compares pitch within the octave, as the scoring does; `NiceBarFillEditor` put a colour into a
+  percentage slider.
+
+  **Every package declares what its bundle imports.** A new CI gate checks every `import`, `import()`
+  and `require()` in the published `dist` against `dependencies` and non-optional `peerDependencies`.
+  To reach zero: `@nice2dev/licensing` no longer has `require('webpack')` in its main bundle (the webpack
+  plugin uses `compiler.webpack`; webpack 4 gets a warning instead of feature flags) and `react` is a
+  required peer; `@nice2dev/erp-adapter` lists `@microsoft/signalr` in `dependencies` (still loaded on
+  first use); `@nice2dev/icons-cursor` declares its `react-dom` peer; `@nice2dev/ui-printing` treats
+  `@nice2dev/ui` as a required peer.
+
+  **One copy of each package, one i18n context.** `@nice2dev/ui` carried its own copy of
+  `@nice2dev/ui-core` and `@nice2dev/i18n`, and `ui-forms`, `ui-api`, `ui-bi`, `ui-designers`, `ui-math`
+  and `ui-video` each carried a copy of all of `@nice2dev/ui` (about 4.4 MB each). Every copy had its own
+  React contexts: a `NiceI18nProvider` imported from `@nice2dev/i18n` did not reach the controls of
+  `@nice2dev/ui`, which kept their English defaults and `lang` `'en'`, and the dictionaries ended up in
+  an app several times. These packages now import `@nice2dev/*` instead (`ui-forms` 4.4 MB → 82 kB).
+  Keep every `@nice2dev/*` package on the same version.
+
+  **Dictionaries per language.** `NiceI18nLazyProvider` takes the same props as `NiceI18nProvider`
+  (`t`, `lang`, `overrides`, plus `fallback` and `onError`) but loads only the active language's
+  dictionary, with `import()`; until it arrives the controls show their built-in English (or
+  `fallback`), and with `t` nothing is loaded at all. Also `loadNiceDictionary(lang)`, to start in a
+  language without a flash of English, and `getLoadedNiceDictionary(lang)`. Exported from
+  `@nice2dev/i18n`, `@nice2dev/ui-core` and `@nice2dev/ui`; in the `i18n` build every language is its own
+  file. `NiceI18nProvider` and `NICE_I18N_DICTIONARIES` are unchanged and still bring all 30 dictionaries.
+  `NiceTestWrapper` (ui-core) and `NiceShowcase` (ui) use the lazy provider now, so they no longer pull
+  every dictionary into the apps that bundle them.
+
+  **Data props are optional.** These controls threw a `TypeError` without data and now render empty:
+  `NiceTreeView.nodes`, `NiceAccordion.items`, `NiceCascadeSelect.options`, `NiceAutocomplete.options`,
+  `NiceAuditLog.entries`, `NiceDocumentVersionList.versions`, `NicePermissionMatrix.roles` / `actions`,
+  `WizardStep.content`, `NiceDiagramViewer.document`, `NiceOrgChartVisualizer.data`,
+  `NiceSpatialViewer.document`, and in `@nice2dev/events` the lists of `NiceGiftRegistry`,
+  `NiceParticipantList`, `NiceExpenseSplit`, `NiceSeatingChart`, `NiceMediaCollage` and `NiceEventMedia`.
+  `NiceMap` without `center` centres on its markers (the whole world without markers), `NiceCountdown`
+  without `targetDate` shows zero and never calls `onComplete`, `NiceChat` without `onSend` is read-only
+  (no input), and `NiceInvitationDesigner` gains `defaultTemplate`. A CI ratchet counts the required
+  array props that remain.
+
+  **Smaller fixes.** `NicePieChart` draws a 100 % slice as a full circle instead of nothing. In
+  development `NiceThemeProvider` warns when `--nice-primary` / `--nice-color-primary` (or another linked
+  pair) resolves to nothing on `:root` — usually an alias cycle in the app's CSS; the theming guides say
+  which side to set. `@nice2dev/game-engine` exports `createAnimationClip`, `AnimatorController` and
+  `createAnimatorController` (two modules exported each name, so `export *` dropped all three); the other
+  implementations are `StateMachineAnimatorController`, `createStateMachineAnimatorController`,
+  `createTimelineAnimationClip` and `createRetargetingAnimationClip`.
+
+  Nothing was renamed or removed.
+
 ## 1.1.9
 
 ### Patch Changes

package/dist/cjs/ai/StateMachine.js

@@ -509,6 +509,55 @@ class StateMachine {
         return new StateMachine(JSON.parse(JSON.stringify(this.definition)));
     }
 }
+// ============================================================
+// Animation State Machine
+// ============================================================
+/** Extended state machine for animation control */
+class AnimatorController extends StateMachine {
+    constructor(definition) {
+        super(definition);
+        this.motionValues = new Map();
+        this.blendTrees = new Map();
+    }
+    /** Get blended motion value for animation sampling */
+    getMotionValue(layerId) {
+        return this.motionValues.get(layerId) || 0;
+    }
+    /** Get current motion/clip name */
+    getMotionClip(layerId) {
+        const state = this.getCurrentState(layerId);
+        return state?.motion || null;
+    }
+    /** Register a blend tree for a state */
+    registerBlendTree(stateId, blendTree) {
+        this.blendTrees.set(stateId, blendTree);
+    }
+    /** Sample blend tree for current parameters */
+    sampleBlendTree(stateId) {
+        const blendTree = this.blendTrees.get(stateId);
+        if (!blendTree) {
+            return null;
+        }
+        const params = {};
+        for (const [name, value] of this.getParameterMap()) {
+            if (typeof value === 'number') {
+                params[name] = value;
+            }
+        }
+        return blendTree.sample(params);
+    }
+    getParameterMap() {
+        const map = new Map();
+        const definition = this.getDefinition();
+        for (const param of definition.parameters) {
+            const value = this.getParameter(param.name);
+            if (value !== undefined) {
+                map.set(param.name, value);
+            }
+        }
+        return map;
+    }
+}
 class BlendTree {
     constructor(type, parameterX, parameterY) {
         this.motions = [];
@@ -642,6 +691,9 @@ class BlendTree {
 function createStateMachine(definition) {
     return new StateMachine(definition);
 }
+function createAnimatorController(definition) {
+    return new AnimatorController(definition);
+}
 function createBlendTree1D(parameter) {
     return new BlendTree('1d', parameter);
 }
@@ -731,8 +783,10 @@ function createSMContext(params) {
     };
 }
 
+exports.AnimatorController = AnimatorController;
 exports.BlendTree = BlendTree;
 exports.StateMachine = StateMachine;
+exports.createAnimatorController = createAnimatorController;
 exports.createBlendTree1D = createBlendTree1D;
 exports.createBlendTree2D = createBlendTree2D;
 exports.createSMCondition = createSMCondition;

package/dist/cjs/editor/AnimationRetargeting.js

@@ -735,7 +735,20 @@ function createBone(name, parentId = null, transform) {
         children: [],
     };
 }
+function createAnimationClip(name, sourceSkeletonId, duration = 1, frameRate = 30) {
+    return {
+        id: `clip_${Date.now()}`,
+        name,
+        duration,
+        frameRate,
+        tracks: [],
+        hasRootMotion: false,
+        isLooping: false,
+        sourceSkeletonId,
+    };
+}
 
 exports.AnimationRetargeting = AnimationRetargeting;
+exports.createAnimationClip = createAnimationClip;
 exports.createAnimationRetargeting = createAnimationRetargeting;
 exports.createBone = createBone;

package/dist/cjs/editor/TimelineEditor.js

@@ -715,6 +715,17 @@ function createTrack(name, type) {
             return baseTrack;
     }
 }
+function createAnimationClip(trackId, startTime, duration) {
+    return {
+        id: `clip_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
+        name: 'Animation Clip',
+        type: 'animation',
+        trackId,
+        startTime,
+        duration,
+        curves: [],
+    };
+}
 function createAudioClip(trackId, startTime, duration, audioSource) {
     return {
         id: `clip_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`,
@@ -808,6 +819,7 @@ function createSignalMarker(name, time, signalName, payload) {
 exports.TimelinePlayer = TimelinePlayer;
 exports.TimelineRecorder = TimelineRecorder;
 exports.applyEasing = applyEasing;
+exports.createAnimationClip = createAnimationClip;
 exports.createAnimationCurve = createAnimationCurve;
 exports.createAudioClip = createAudioClip;
 exports.createCameraClip = createCameraClip;

package/dist/cjs/index.js

@@ -152,6 +152,7 @@ var SceneGraph = require('./native-engine/SceneGraph.js');
 var AssetPipeline = require('./native-engine/AssetPipeline.js');
 var PhysicsEngine = require('./native-engine/PhysicsEngine.js');
 var AudioEngine = require('./native-engine/AudioEngine.js');
+var AnimationSystem = require('./native-engine/AnimationSystem.js');
 var InputSystem = require('./native-engine/InputSystem.js');
 var NetworkingSystem = require('./native-engine/NetworkingSystem.js');
 var AsepriteImporter = require('./import/AsepriteImporter.js');
@@ -862,6 +863,7 @@ exports.createKeyframe = TimelineEditor.createKeyframe;
 exports.createMarker = TimelineEditor.createMarker;
 exports.createPropertyClip = TimelineEditor.createPropertyClip;
 exports.createSignalMarker = TimelineEditor.createSignalMarker;
+exports.createTimelineAnimationClip = TimelineEditor.createAnimationClip;
 exports.createTimelineDefinition = TimelineEditor.createTimelineDefinition;
 exports.createTimelinePlayer = TimelineEditor.createTimelinePlayer;
 exports.createTimelineRecorder = TimelineEditor.createTimelineRecorder;
@@ -907,6 +909,7 @@ exports.createUndoRedoManager = UndoRedoPro.createUndoRedoManager;
 exports.AnimationRetargeting = AnimationRetargeting.AnimationRetargeting;
 exports.createAnimationRetargeting = AnimationRetargeting.createAnimationRetargeting;
 exports.createBone = AnimationRetargeting.createBone;
+exports.createRetargetingAnimationClip = AnimationRetargeting.createAnimationClip;
 exports.DialogueManager = DialogueSystem$1.DialogueManager;
 exports.createCondition = DialogueSystem$1.createCondition;
 exports.createConditionGroup = DialogueSystem$1.createConditionGroup;
@@ -1140,6 +1143,7 @@ exports.createBlackboard = BehaviorTree.createBlackboard;
 exports.createNodeRegistry = BehaviorTree.createNodeRegistry;
 exports.BlendTree = StateMachine.BlendTree;
 exports.StateMachine = StateMachine.StateMachine;
+exports.StateMachineAnimatorController = StateMachine.AnimatorController;
 exports.createBlendTree1D = StateMachine.createBlendTree1D;
 exports.createBlendTree2D = StateMachine.createBlendTree2D;
 exports.createSMCondition = StateMachine.createSMCondition;
@@ -1151,6 +1155,7 @@ exports.createSMParameter = StateMachine.createSMParameter;
 exports.createSMState = StateMachine.createSMState;
 exports.createSMTransition = StateMachine.createSMTransition;
 exports.createStateMachine = StateMachine.createStateMachine;
+exports.createStateMachineAnimatorController = StateMachine.createAnimatorController;
 exports.VSDebugger = VisualScripting2.VSDebugger;
 exports.VSGraphExecutor = VisualScripting2.VSGraphExecutor;
 exports.VS_TYPE_COLORS = VisualScripting2.VS_TYPE_COLORS;
@@ -1244,6 +1249,9 @@ exports.PhysicsWorld = PhysicsEngine.PhysicsWorld;
 exports.createPhysicsWorld = PhysicsEngine.createPhysicsWorld;
 exports.AudioEngine = AudioEngine.AudioEngine;
 exports.createAudioEngine = AudioEngine.createAudioEngine;
+exports.AnimatorController = AnimationSystem.AnimatorController;
+exports.createAnimationClip = AnimationSystem.createAnimationClip;
+exports.createAnimatorController = AnimationSystem.createAnimatorController;
 exports.InputSystem = InputSystem.InputSystem;
 exports.UISystem = InputSystem.UISystem;
 exports.createInputSystem = InputSystem.createInputSystem;