@nice2dev/ui 1.0.21 → 1.0.23

package/CHANGELOG.md

@@ -1,5 +1,203 @@
+# [1.0.23] — 2026-06-06
+
+### Added — OmniVerk wishlist (DX quality-of-life)
+
+- **`NiceSidebarNav`** — guest / read-only support: `disabledContextMenuActions`
+  (`'hide' | 'reorder' | 'rename' | 'newGroup' | 'collapseToggle'`) greys out the
+  listed destructive actions, and `readonly` is a shorthand that disables them all
+  while keeping navigation, expand/collapse, "Open in new tab" and "Copy link".
+  Plus granular section flags `showModeStrip` / `showSources` / `showFavorites` /
+  `showFooterPreferences` (`minimal` is now the shorthand for all four off).
+- **`NiceLogLevel`** — added `'trace'` (below `debug`) to mirror standard loggers.
+- **`NiceManifestSection<TSchema>`** is now generic + a `defineManifestSection()`
+  helper, so a literal JSON-Schema infers without `as JsonSchema` casts.
+- **`NiceVariant`** — `'danger'` is now an accepted alias for `'error'`
+  (normalized via `normalizeVariant`); **`NiceSize`** accepts the full-name
+  aliases `'small' | 'medium' | 'large'` (→ `sm`/`md`/`lg` via `normalizeSize`).
+- **`NiceLanguagePicker` / `NiceThemePicker`** — aligned trigger height in the
+  compact + ghost variant so the flag and the swatch share a baseline.
+
+### BREAKING — V2/V3 extermination (pre-production cleanup, no back-compat)
+
+The unified view standard is now the only model. Test-phase cleanup; production
+starts at 1.1.1.
+
+- **Removed** the legacy builders and the v1 view model entirely (use
+  **`NiceViewEditor`** + **`NiceViewDefinition`** instead): `NiceFormBuilder` /
+  `NiceFormDesigner` (`@nice2dev/ui-forms`), `NiceViewBuilder` /
+  `NiceControlConfigurator` / `NiceDashboardDesigner` (`@nice2dev/ui-designers`),
+  `NiceDashboardStudio` / `NiceReportBuilder` (`@nice2dev/ui-bi`), plus the v1
+  `viewDefinition` model and the convergence adapters (`formSchemaToV2`,
+  `viewDefinitionToV2`, `dashboardToV2`, …). Form-schema types/utils moved to
+  `formTypes` / `formUtils` (`@nice2dev/ui-forms`); `NiceFormBuilderAI` now renders
+  via `NiceSchemaForm`.
+- **Renamed** all view `*V2` → canonical (suffix dropped): `NiceViewDefinitionV2`→
+  `NiceViewDefinition`, `NiceViewRendererV2`→`NiceViewRenderer`, `NiceViewRowV2`/
+  `NiceViewCellV2`→`NiceViewRow`/`NiceViewCell`, `serialize/deserialize/
+validateViewDefinitionV2`→suffixless, `entityToViewV2`→`entityToView`,
+  `EntityToViewV2Options`→`EntityToViewOptions`.
+- **Workflow**: `NiceWorkflowDesignerV2` is now the canonical `NiceWorkflowDesigner`
+  (`@nice2dev/ui`); the older `@nice2dev/ui-designers` designer was removed and that
+  entry point re-exports the canonical one.
+- **game-engine**: `SaveSystemV2` (engine) → `SaveSystem`; the older
+  `performance/SaveSystem` → `GameSaveSystem`.
+
+### View standard — follow-ups (also in 1.0.23)
+
+- **`NiceViewEditor`** — optional `tutorial?` "?" guided-tour launcher (built-in EN
+  tour + i18n keys across en/pl/de/fr/es/uk; off by default).
+- **`NiceViewRenderer`** — new `onRunScript` prop executes view `'script'` actions
+  via a host bridge (renderer never evaluates script itself; skipped with a warning
+  when no handler).
+- Showcase: the OmniVerk sample module seeds views scaffolded via `entityToView`; the
+  NiceViewEditor demo shows the `tutorial` launcher.
+
+# [1.0.22] — 2026-06-03
+
+### Added — Module Editor controls (OmniVerk brief §5, universal/reusable)
+
+A set of framework-agnostic controls for building module/manifest editors. All
+controls are execution-agnostic — the consumer supplies `onRun` / `onSend` /
+`onTestConnection`, so sandboxing stays on the host side.
+
+- **`NiceScriptRunner`** — inline script test runner: code editor + JSON input +
+  Run + captured logs + result pane. Never evals itself; consumer provides `onRun`.
+- **`NiceLogConsole`** — reusable, controlled log/output panel (script runs,
+  webhook replays, or `NiceConsole`'s bottom dock). Level filtering + auto-scroll.
+- **`NiceKeyValueEditor`** — key/value list editor (headers / env vars /
+  credentials) with masked secret rows, per-row enable, descriptions, key
+  autocomplete and duplicate-key detection.
+- **`NiceLifecycleHooksEditor`** — bind handlers to lifecycle triggers with
+  per-binding order, enable flag and optional condition (generalises the
+  `NiceGitHooks` pattern for any trigger → handler scenario).
+- **`NiceRevisionHistory`** — revision timeline with side-by-side diff
+  (`NiceCodeDiffEditor`) and rollback; inline or lazily-loaded content.
+- **`NiceCodeEditor`** — new additive prop **`extraLibs`** feeds `.d.ts` sources
+  to Monaco for IntelliSense (e.g. a generated `ctx.d.ts`). Backward compatible.
+
+Companion controls ship in sibling packages: `NiceSchemaForm` +
+`NiceManifestEditor` (`@nice2dev/ui-forms`), `NicePaymentProviderConfig` /
+`NicePaymentMethodSelector` + `NICE_PAYMENT_PROVIDER_PROFILES`
+(`@nice2dev/ui-money`), and `NiceWebhookTester` (`@nice2dev/ui-api`). Each is
+demoed (with feedback) under its own package's showcase page.
+
+**Module-creation suite** (`@nice2dev/ui-forms`): `NiceModuleEditor` — an
+end-to-end, headless-IO tool (browse → manifest + entities + i18n → validate →
+save via a pluggable `NiceModuleDataProvider`) — plus `NiceEntityEditor`,
+`NiceI18nEditor` and `NiceArrayField` (structured array-of-objects editing, which
+also upgrades `NiceSchemaForm` so manifest arrays like `modules[]`/`dependencyRefs[]`
+are edited in a grid instead of raw JSON). Demoed in the UI Forms showcase with a
+File System Access adapter for editing real on-disk modules.
+
+**Unified view standard (one editor for forms / grids / detail / dashboards / pages).**
+The repo had several overlapping view models (form `FormSchema`, generic
+`NiceViewDefinition`, BI `Dashboard`) and a mature runtime engine
+(`NiceViewDefinitionV2` + `NiceViewRendererV2` + `NiceViewRegistry` + `NiceCodeGenerator`
+for TS/Dart/RBAC + `NiceCrossPlatformSchema`) — but **no visual editor** for it.
+This release adds that editor and converges the rest onto the one model:
+
+- **`NiceViewEditor`** (`@nice2dev/ui`) — the single visual authoring tool for
+  `NiceViewDefinitionV2`: palette (control registry) · canvas (rows/cells +
+  colSpan, Design / Preview / Source) · properties (props · data **binding**
+  `source/field/twoWay` · **role-based permissions** · events → no-code actions) ·
+  data-sources panel · live preview via `NiceViewRendererV2`. A BI control is just
+  a control bound to a data source, so charts/KPIs work inside any view (incl. forms).
+- **`NiceActionBuilder`** (`@nice2dev/ui`) — visual no-code editor over the typed
+  `NiceViewAction[]` (navigate / apiCall / setField / refresh / dialog / **script** …).
+- **`entityToViewV2`** (`@nice2dev/ui`) — scaffold a form / detail / grid view from
+  an entity (dataType → control mapping); defaults to the OmniVerk
+  `ModuleEntity`/`ModuleEntityField` shape but works with any `fields[]` entity.
+- **V2 inline scripts** — `NiceViewAction` gains a `'script'` type + `script`/`language`
+  (inline JS/C#, executed by the host — never the UI). Additive, back-compatible.
+- **`NiceModuleEditor`** gains a **Views** tab + `NiceModuleFiles.views` — author a
+  module's views (and "New view from entity") right inside the module editor; views
+  serialize as `*.view.json` and feed the existing `NiceCodeGenerator`.
+- **Convergence adapters** (back-compatible; the legacy builders keep working):
+  `formSchemaToV2` / `v2ToFormSchema` (`@nice2dev/ui-forms`),
+  `viewDefinitionToV2` / `v2ToViewDefinition` (`@nice2dev/ui-designers`),
+  `dashboardToV2` (`@nice2dev/ui-bi`). `NiceViewEditor` is the recommended path
+  going forward; the legacy `NiceFormBuilder`/`NiceFormDesigner`/`NiceViewBuilder`/
+  `NiceDashboardDesigner`/`NiceDashboardStudio`/`NiceReportBuilder` converge onto it
+  via these adapters (hard `@deprecated` tagging to follow once consumers migrate).
+  (`@nice2dev/ui-bi` gains a `@nice2dev/ui` devDependency for the type-only adapter.)
+
+**Tutorials** — a universal, decoupled tutorial launcher so any editor can expose
+an optional "?" button that runs a translated `NiceTutorial`. `@nice2dev/ui-core`
+adds `NiceTutorialButton`, `NiceTutorialsProvider`, `useNiceTutorials` /
+`useNiceTutorialsEnabled`, `resolveTutorial`/`resolveStepsI18n` and the
+`NiceComponentTutorial` prop type; `@nice2dev/ui` adds `NiceTutorialHost` (mount
+once; bridges to `NiceTutorial`; `enabled` is the global "hide all tutorials"
+switch). Steps are i18n-key aware (`t(key, enDefault)` → falls back to the inline
+English). Editors opt in via an optional `tutorial?` prop (off by default).
+Adopted with built-in EN + PL tours — `@nice2dev/ui-forms`: `NiceModuleEditor`,
+`NiceManifestEditor`, `NiceSchemaForm`, `NiceEntityEditor`, `NiceI18nEditor`,
+`NiceFormBuilder`, `NiceFormDesigner`; `@nice2dev/ui-money`:
+`NicePaymentProviderConfig`; `@nice2dev/ui-api`: `NiceWebhookTester`,
+`NiceAPIDesigner`, `NiceAPITester`, `NiceIntegrationBuilder`. `@nice2dev/ui` —
+**all editors/designers/builders/studios**: `NiceCodeEditor`, `NiceMarkdownEditor`,
+`NiceHtmlEditor`, `NiceDocumentEditor`, `NiceScriptRunner`, `NiceKeyValueEditor`,
+`NiceLifecycleHooksEditor`, `NiceRevisionHistory`, `NiceKanbanBoard`,
+`NiceQueryBuilder`, `NiceFilterBuilder`, `NiceWorkflowDesigner`,
+`NiceLowCodeStudio`, `NiceComponentDesigner`, `NicePageBuilder`,
+`NiceStateDesigner`, `NiceTestBuilder`, `NiceThemeBuilder`/`NiceThemeDesigner`,
+`NiceDiagramDesigner`, `NiceReportBuilder`, `NiceERPReportDesigner`,
+`NiceRecipeEditor`, `NicePipelineEditor`, `NiceMergeRequestBuilder`,
+`NiceAutomationRuleEditor`, `NiceSceneActionBuilder`, `NiceBackupTagEditor`,
+`NiceDataMergeBuilder`, `NiceInvoiceLineEditor`, `NiceImageEditor`,
+`NiceCropEditor`, `NicePDFAnnotationEditor`, `NiceVideoEditor`. Domain packages
+(import the launcher from `@nice2dev/ui`) — `ui-designers`:
+`NiceViewBuilder`, `NiceDashboardDesigner`, `NiceWorkflowDesigner`; `ui-3d`:
+`NiceMaterialEditor`, `NiceArmatureEditor`, `NiceMorphTargetEditor`,
+`NiceTerrainEditor`, `NiceParticleEditor`, `NiceUVEditor`; `ui-graphics`:
+`NiceFontEditor`, `NiceIconEditor`, `NiceUIDesigner`; `game-engine`:
+`NiceGameEditor`, `NiceLevelEditor`, `NiceMaterialEditor`, `NiceParticleEditor`;
+`ui-buildings`: `NiceFloorPlanEditor`, `NiceSceneEditor`, `NiceAutomationEditor`,
+`NiceSpatialEditor`; `ui-diagrams`: `NiceDecisionTreeEditor`, `NiceDiagramEditor`;
+`ui-enterprise`: `NiceContractEditor`, `NiceInvoiceDesigner`; `ui-presentations`:
+`NicePresentationEditor`. Standalone packages (which gain a `@nice2dev/ui-core`
+peer dependency and import the launcher from it) — `ui-bi`:
+`NiceDashboardStudio`, `NiceReportBuilder`, `NiceETLBuilder`; `ui-video`:
+`NiceVideoEditor`; `ui-ai`: `NiceMLStudio`; `ui-math`: `NiceMathEditor`;
+`ui-audio`: `NiceDmxEditor`. (`ui-api` likewise gains a `@nice2dev/ui-core` peer
+dependency for the launcher button.) **~75 editors across 17 packages now expose
+the optional "?" tour (off by default), every tour with EN + PL.**
+
+### Fixed
+
+- **Theming** — the new controls now drive all colours through the `--nice-*`
+  theme alias layer (e.g. `--nice-surface`, `--nice-bg-secondary`) instead of
+  undefined token names, so they follow the active light/dark theme.
+  `NiceLogConsole` no longer hard-codes a dark palette (the `theme` prop was
+  removed; it inherits the app theme).
+
 # [1.0.21] — 2026-05-30
 
+### Fixed / Reworked — NiceTutorial visual + UX overhaul
+
+- **Tooltip is now a properly themed card** (background, border, shadow,
+  padding). Previously the component shipped without a stylesheet so the
+  body floated invisibly on the dark overlay.
+- **Spotlight padding default `8 → 0`** — the highlight ring now sits flush
+  against the target. Keep the buffer by setting `step.highlightPadding`
+  per-step.
+- **`buttonsPlacement` prop** — controls where Skip/Prev/Next/Play live:
+  - `'floating-bottom'` (new default): fixed bottom-center bar that
+    never jumps between steps and never overlaps the tooltip body.
+  - `'inline'`: legacy behaviour (footer inside the tooltip).
+- **`buttonsDisplay` prop** — `'icon'` (new default), `'icon-text'`, or
+  `'text'` (legacy). Icon mode renders round 32×32 buttons; pill shape
+  for icon-text / text.
+- **Autoplay support** — opt-out via `showAutoplay={false}` (default `true`):
+  PLAY/PAUSE button, progress bar, and speed slider (range configurable
+  via `autoplaySpeedRange`, default 2–15 s). `autoplayInterval` sets the
+  initial speed (default 5000 ms). `onAutoplayChange` callback.
+- **New `labels` entries** — `play`, `pause`, `speed`, `close`. NavShell
+  zasila je z istniejących kluczy `tutorial.*` (EN + PL).
+- **Six inline SVG icons** (close / prev / next / skip / play / pause)
+  matching the existing house style. No new peer deps.
+- **i18n** — nowe klucze `tutorial.play`, `tutorial.pause`, `tutorial.speed`,
+  `tutorial.close` (EN + PL).
+
 ### Added — NiceNavShell sticky body slots
 
 - 4 nowe propsy: `showStickyHeader` (default `false`), `stickyHeaderContent`,