@nice2dev/game-engine 1.1.7 → 1.1.10

package/CHANGELOG.md

@@ -1,5 +1,151 @@
 # @nice2dev/game-engine — Changelog
 
+## 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
+
+- 1.1.9 — themes reach the controls again, every control has a rendered demo, no breaking changes.
+
+  **Theming.** `NiceThemeProvider`, `applyTheme` and `NiceThemePreview` write the `--nice-*` tokens
+  again, so a theme recolours the controls and not only the app's own CSS — since 1.1.7 only
+  light/dark switched. The provider's scope wins over values set on `:root`, as it did before 1.1.7:
+  put a brand colour into the theme rather than on `<html>`. Alias tokens are computed in the theme
+  scope, not only on `:root`. About 1,600 places that used a text token as a background or border, or
+  a surface token as text colour, now use the token of the right role. `--nice-warning-light` and
+  `--nice-danger-light` are the light shade of the status colour, like `--nice-success-light`
+  (new: `--nice-color-warning-light`, `--nice-color-error-light`); backgrounds use `--nice-*-bg`.
+
+  **Styles that never shipped.** Six stylesheets in `@nice2dev/ui` were unreachable from its entry
+  point, so `NiceLiveDataGrid`, `NiceTaskInbox`, `NiceBPMNDesigner`, `NiceInstanceMonitor`,
+  `NiceIntegrationHub`, `NiceRulesEngine` and `NiceVideoEditor` rendered unstyled; eleven more
+  components had no stylesheet at all; `workflow.css` read its spacing scale as pixels; and
+  `NiceModuleGrid` was styled for a `<table>` it does not render.
+
+  **Language.** `useNiceTranslation()` returns `{ t, lang }` and dates are formatted in the interface
+  language rather than the browser's (`ui-presentations` adds `useNiceLang()`). `NiceInvoiceLineEditor`
+  takes its currency and units from the active language unless you pass them. `NiceAuditLog`,
+  `NiceRecordingPanel`, the four game-engine editors and `NiceTemplateEditor` are translated, the
+  game-engine dictionary is actually registered, and 136 ui-audio strings have English defaults
+  instead of rendering raw keys.
+
+  **Canvas and document colours.** Canvas never resolves `var()`: the QR and barcode generators drew a
+  black rectangle, the whiteboard lost its colours and light presets parsed to `NaN`. Data colours are
+  resolved first now. Colours stored in documents — slide templates, theme presets, brand kits,
+  exports — are literals, so a saved document looks the same in every theme.
+
+  **Fixes found by the new demos.** All 895 controls now have a rendered showcase demo, and roughly
+  every third new demo exposed a bug. `ui-platform`: the service worker re-registered on every
+  render, a screen permission prompt appeared on mount, reconnects and start-up tasks ran twice,
+  valid EAN-13 codes were rejected. `ui-ai`: `createProviderFromConfig` dropped the endpoint path —
+  OpenAI, Anthropic and Groq were called without `/v1` and Azure always threw — and the theme
+  generator failed on every request. `ui-communication`: the local participant appeared twice in a
+  conference and `activeConversationId` was ignored. `ui-buildings`: automation days were saved as
+  indices (both forms are read now), the row toggle changed the selected rule instead of the clicked
+  one, and floor-plan devices were drawn in the corner. `ui-mobile`: `NiceTouchTable` rendered invalid
+  table markup. `ui-diagrams`: arrowheads grew with the stroke width and transition clicks never fired.
+  `ui-3d`: opening a code editor before the 3D view broke the whole app. `ui-presentations`: the editor
+  clipped slides in columns narrower than 800 px.
+
+  **Additive API only.** `@nice2dev/ui-platform` now exports its hooks, provider aliases and Props / Ref
+  types. Nothing was renamed or removed.
+
+## 1.1.8
+
+### Patch Changes
+
+- 1.1.8 — old problems closed, no breaking changes.
+
+  **English-first UI.** Text that was hardcoded Polish now goes through `t()` with an English
+  default: the planning views, the whole of `@nice2dev/ui-printing`, smart home, backup, the
+  navigation and settings panels, `@nice2dev/ui-buildings` end to end, the photo editor and the
+  presentation Q&A panel. The dictionary gains 566 keys in en, pl, de, fr, es and uk, so an app
+  with `locale="pl"` reads as before. Three prop defaults changed with it:
+  `NiceInvoiceLineEditor` (`currencySymbol` `'zł'` → `'$'`, `units` → English) and
+  `NiceTimeoutFeedback`'s two messages.
+
+  **Icons.** No emoji, unicode glyphs or inline `<svg>` are used as icons any more — not in JSX,
+  not in `icon:` data fields, not on canvas. Ten icons in `icons-business` / `icons-education`
+  that drew their artwork as `<text>` use paths now, and the behaviour-tree palette names resolve
+  to real `NiceIcon` builtins (`shield` and `repeat` are new; 176 in total).
+
+  **Fixes.** The shadcn adapter reads the host's `--primary` / `--accent` again instead of
+  producing invalid `hsl(#hex)`; `ui-diagrams` ships the 21 translation keys its components were
+  already asking for; `--nice-font-size-2xl` is declared; `NiceScheduler` warns in development
+  when it ignores a `currentDate`, `view` or `events` change; `ui-buildings` typechecks clean and
+  `DeviceProtocol` accepts `'mqtt'`.
+
+  **Docs.** `doc.json` no longer lists CSS variables no component implements; eleven components
+  document the tokens their stylesheets really read.
+
 ## 1.1.7
 
 ### 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/devtools/DeveloperExperience.js

@@ -125,16 +125,16 @@ function getEngineError(code, context) {
 }
 /** Format an engine error for console output */
 function formatEngineError(err) {
-    const icon = err.severity === 'error' ? '❌' : err.severity === 'warning' ? '⚠️' : 'ℹ️';
-    const lines = [`${icon} [Nice2Dev ${err.code}] ${err.message}`];
+    const label = err.severity === 'error' ? 'Error' : err.severity === 'warning' ? 'Warning' : 'Info';
+    const lines = [`${label}: [Nice2Dev ${err.code}] ${err.message}`];
     if (err.suggestion) {
-        lines.push(`   💡 ${err.suggestion}`);
+        lines.push(`   Tip: ${err.suggestion}`);
     }
     if (err.docsSection) {
-        lines.push(`   📖 Docs: https://nice2dev.com/docs/game-engine/${err.docsSection}`);
+        lines.push(`   Docs: https://nice2dev.com/docs/game-engine/${err.docsSection}`);
     }
     if (err.context) {
-        lines.push(`   📋 Context: ${JSON.stringify(err.context)}`);
+        lines.push(`   Context: ${JSON.stringify(err.context)}`);
     }
     return lines.join('\n');
 }

package/dist/cjs/dialogue/DialogueSystem.js

@@ -704,7 +704,7 @@ const DialogueBox = ({ text, characterName, portrait, emotion = 'neutral', textE
                     opacity: isComplete ? 1 : 0.5,
                     fontSize: '12px',
                 },
-            }, isComplete ? '▼ Click to continue' : '...'),
+            }, isComplete ? 'Click to continue' : '...'),
         ]),
     ]);
 };

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/AssetBrowser.js

@@ -540,7 +540,7 @@ class AssetBrowser {
             id: 'favorites',
             name: 'Favorites',
             description: 'Your favorite assets',
-            icon: '⭐',
+            icon: 'star',
             color: '#f9e2af',
             assetIds: [],
             createdAt: Date.now(),
@@ -551,7 +551,7 @@ class AssetBrowser {
             id: 'recent',
             name: 'Recent',
             description: 'Recently used assets',
-            icon: '🕐',
+            icon: 'clock',
             color: '#89b4fa',
             assetIds: [],
             createdAt: Date.now(),
@@ -562,7 +562,7 @@ class AssetBrowser {
             id: 'unused',
             name: 'Unused',
             description: 'Assets not referenced by any scene',
-            icon: '📦',
+            icon: 'box',
             color: '#cdd6f4',
             assetIds: [],
             createdAt: Date.now(),
@@ -997,7 +997,7 @@ class AssetBrowser {
             id: `collection_${Date.now()}`,
             name,
             description,
-            icon: '📁',
+            icon: 'folder',
             color: '#cdd6f4',
             assetIds: [],
             createdAt: Date.now(),
@@ -1146,30 +1146,31 @@ class AssetBrowser {
         }
         return `${(bytes / (1024 * 1024 * 1024)).toFixed(2)} GB`;
     }
+    /** NiceIcon name for an asset type. */
     getAssetTypeIcon(type) {
         const icons = {
-            image: '🖼️',
-            sprite: '🎨',
-            spritesheet: '📊',
-            tilemap: '🗺️',
-            audio: '🔊',
-            music: '🎵',
-            sfx: '💥',
-            model: '🎲',
-            material: '🎨',
-            shader: '✨',
-            script: '📜',
-            scene: '🎬',
-            prefab: '📦',
-            animation: '🎞️',
-            font: '🔤',
-            particle: '💫',
-            terrain: '🏔️',
-            video: '🎥',
-            json: '📋',
-            other: '📄',
+            image: 'image',
+            sprite: 'palette',
+            spritesheet: 'grid',
+            tilemap: 'map-pin',
+            audio: 'volume',
+            music: 'music',
+            sfx: 'zap',
+            model: 'box',
+            material: 'palette',
+            shader: 'wand',
+            script: 'code',
+            scene: 'video',
+            prefab: 'box',
+            animation: 'video',
+            font: 'type',
+            particle: 'star',
+            terrain: 'mountain',
+            video: 'video',
+            json: 'file',
+            other: 'file',
         };
-        return icons[type] ?? '📄';
+        return icons[type] ?? 'file';
     }
 }
 // ============================================================