@nice2dev/ui-core 1.1.5 → 1.1.7

package/CHANGELOG.md

@@ -1,5 +1,57 @@
 # @nice2dev/ui-core — Changelog
 
+## 1.1.7
+
+### Patch Changes
+
+- Close the three items left open in the 1.1.6 response to OmniVerk.
+
+  **Every value control works without state in the parent.** The `audit-controllable-state` gate
+  counted 87 value props that were required with no `default*`, so the control could not render from a
+  manifest without data. It now reports 0 and gates CI at `--max=0`. 48 controls gained `default*` props
+  through `useControllableState` (existing `value` + handler call sites behave as before); 33 read-only
+  data lists are optional with a stable empty default; 4 props paired with a handler only by name are
+  optional; `NiceWhiteboard` and `NiceMetricsDashboard` render an empty state until a session or
+  dashboard arrives. Additive API only — nothing renamed or removed.
+
+  - `NicePivotGrid.fields`, `NiceScheduler.events` and `NiceGitHooks.hooks` are controlled only together
+    with their change handler, as `NiceScheduler` already documented for `currentDate`/`view`. A bare
+    prop stays an initial value; prop plus handler now always wins (later prop updates used to be
+    ignored). `NiceGitHooks.onHookChange` is now called; `onHooksChange` and
+    `NiceLocaleManager.onTranslationsChange` are new.
+  - `NiceCodeEditor` / `NiceCodeDiffEditor` no longer report a value written from the prop back through
+    `onChange`, and call the latest handler rather than the one captured at mount.
+  - `NiceHtmlEditor` no longer rewrites its content on every render (React 19 compares the
+    `dangerouslySetInnerHTML` object, not its string), which moved the caret; the HTML source and
+    Markdown views can be closed again.
+  - Selections seeded once from the first item (access manager, automation/scene editors, git diff
+    viewer, ribbon, setup wizard) follow data that arrives after mount.
+  - `useControllableState`: new `fallbackValue` seed that never triggers the value/default clash warning;
+    two functional updates in one tick no longer lose the first; `onChange` is called with one argument
+    when there is no meta. `UseControllableStateOptions` is now a union type alias.
+
+  **`--nice-*` is the source of truth for design tokens.** Controls read only `--nice-*` (9,225 reads in
+  339 files). The unprefixed names (`--color-primary`, `--bg-primary`, `--text-muted`, …) stay declared
+  as aliases pointing at the Nice tokens, so reading them works, but setting them no longer repaints Nice
+  controls. Apps that relied on that can import `@nice2dev/ui/css/legacy-bg-text-aliases.css` after
+  `style.css` (removed in 1.2), or set `--nice-color-primary` and friends directly. 13 tokens that were
+  read and never declared (`--color-danger`, `--text-on-primary`, `--color-white`, …) are defined; the
+  dark blocks define the canonical names, so `.nice-dark` on `<body>` no longer leaves them on light
+  values; `--nice-primary-bg` and `--nice-selected-bg` are a primary tint instead of falling through to
+  grey. New gate `audit-token-names`.
+
+  **Node ESM and `require()`.** `@nice2dev/spatial-core` imports from plain Node ESM (51 relative
+  specifiers gained extensions, enforced by `nodenext`), and so does `@nice2dev/ui-buildings`, which
+  failed through it. `require()` works for `ui-3d`, `ui-graphics` and `game-engine`. The package-exports
+  gate now loads every entry in both module systems.
+
+  **Hygiene.** Sources are prettier-formatted and CI gates on it; 640 stale `.d.ts` files were removed
+  from source trees (never published).
+
+## 1.1.6
+
+No changes in this release.
+
 ## 1.1.5
 
 No changes in this release.

package/dist/core/NiceFieldStatus.d.ts

@@ -13,4 +13,3 @@ export interface NiceFieldStatusProps {
     testId?: string;
 }
 export declare function NiceFieldStatus(props: NiceFieldStatusProps): React.ReactElement | null;
-//# sourceMappingURL=NiceFieldStatus.d.ts.map

package/dist/core/NiceInlineHelp.d.ts

@@ -66,4 +66,3 @@ export interface NiceHelpIconProps {
  */
 export declare const NiceHelpIcon: React.FC<NiceHelpIconProps>;
 export default NiceInlineHelp;
-//# sourceMappingURL=NiceInlineHelp.d.ts.map

package/dist/core/NiceThemeProvider.d.ts

@@ -35,4 +35,3 @@ export interface NiceThemeProviderProps {
     children: React.ReactNode;
 }
 export declare const NiceThemeProvider: React.FC<NiceThemeProviderProps>;
-//# sourceMappingURL=NiceThemeProvider.d.ts.map

package/dist/core/NiceThemeVariants.d.ts

@@ -52,4 +52,3 @@ export interface NiceThemeVariantConfiguratorProps {
 export declare function NiceThemeVariantConfigurator({ showPresets, showPreview, showCSS, collapsible, className, style, }: NiceThemeVariantConfiguratorProps): React.JSX.Element;
 export type { ThemeVariantConfig, RadiusVariant, ShadowVariant, FillVariant as _FillVariant, ButtonStyleVariant, InputStyleVariant, CardStyleVariant, AnimationIntensity, DensityVariant, } from './themeVariants';
 export { DEFAULT_VARIANT_CONFIG, VARIANT_PRESETS, applyVariantConfig, generateVariantCSS, } from './themeVariants';
-//# sourceMappingURL=NiceThemeVariants.d.ts.map

package/dist/core/NiceUserPreferences.d.ts

@@ -301,4 +301,3 @@ export interface NicePreferencesPanelProps {
  */
 export declare function NicePreferencesPanel({ showGlobal, showControls, showExportImport, showSync, className, style, }: NicePreferencesPanelProps): React.JSX.Element;
 export {};
-//# sourceMappingURL=NiceUserPreferences.d.ts.map

package/dist/core/a11y-advanced.d.ts

@@ -154,4 +154,3 @@ export declare function checkContrastAAA(foreground: string, background: string,
  * Run a comprehensive WCAG 2.2 AAA audit on the current document.
  */
 export declare function auditWCAG22AAA(): WCAGCheckResult[];
-//# sourceMappingURL=a11y-advanced.d.ts.map

package/dist/core/a11y.d.ts

@@ -309,4 +309,3 @@ export interface AccessibleClickProps {
  */
 export declare function useAccessibleClick(options?: UseAccessibleClickOptions): AccessibleClickProps;
 export {};
-//# sourceMappingURL=a11y.d.ts.map

package/dist/core/access-control.d.ts

@@ -56,4 +56,3 @@ export declare function accessModeAttrs(mode: NiceAccessMode): {
     'aria-disabled'?: boolean;
     tabIndex?: number;
 };
-//# sourceMappingURL=access-control.d.ts.map

package/dist/core/adapters.d.ts

@@ -175,4 +175,3 @@ export declare function generateFromOpenAPI(swaggerUrl: string, schemaName: stri
 export declare function generateColumnsFromSchema(schema: OpenAPISchema): GridColumnDef[];
 /** Generate form fields from schema object directly (no fetch). */
 export declare function generateFormFieldsFromSchema(schema: OpenAPISchema): FormFieldDef[];
-//# sourceMappingURL=adapters.d.ts.map

package/dist/core/ai.d.ts

@@ -188,4 +188,3 @@ export declare function useTextImprovement(): {
     isLoading: boolean;
 };
 export default NiceAIProvider;
-//# sourceMappingURL=ai.d.ts.map

package/dist/core/animations.d.ts

@@ -45,4 +45,3 @@ export declare function useNiceCollapse(ref: React.RefObject<HTMLElement | null>
  */
 export declare function niceStaggerDelay(index: number, interval?: number): string;
 export declare function getNiceAnimationClass(preset: NiceAnimationPreset, phase: 'enter' | 'exit'): string;
-//# sourceMappingURL=animations.d.ts.map

package/dist/core/colorBlind.d.ts

@@ -38,4 +38,3 @@ export declare function createColorBlindController(target?: HTMLElement | null):
     set: (mode: NiceColorBlindMode) => void;
     clear: () => void;
 };
-//# sourceMappingURL=colorBlind.d.ts.map

package/dist/core/datasource-advanced.d.ts

@@ -258,4 +258,3 @@ export interface NiceSSEDataSource<T> extends NiceDataSource<T> {
  * Writes (insert/update/remove) are delegated to the base data source.
  */
 export declare function createSSEDataSource<T extends Record<string, any>>(config: NiceSSEConfig<T>): NiceSSEDataSource<T>;
-//# sourceMappingURL=datasource-advanced.d.ts.map

package/dist/core/datasource-aggregation.d.ts

@@ -218,4 +218,3 @@ export declare const BatchOperations: {
         addNew?: boolean;
     }): T[];
 };
-//# sourceMappingURL=datasource-aggregation.d.ts.map

package/dist/core/datasource-hooks.d.ts

@@ -90,4 +90,3 @@ export interface NiceLookupSourceState {
     reload: () => void;
 }
 export declare function useNiceLookupSource<T = any>(source: NiceDataSource<T> | null | undefined, valueField: string, labelField: string, opts?: UseNiceLookupSourceOptions): NiceLookupSourceState;
-//# sourceMappingURL=datasource-hooks.d.ts.map

package/dist/core/datasource-offline.d.ts

@@ -198,4 +198,3 @@ export declare function createUserPreferencesStore(storageKey?: string): {
      */
     merge(prefs: Partial<NiceUserPreferences>): void;
 };
-//# sourceMappingURL=datasource-offline.d.ts.map

package/dist/core/datasource.d.ts

@@ -178,4 +178,3 @@ export interface NiceCustomDataSourceHandlers<T = any> {
  */
 export declare function createCustomDataSource<T extends Record<string, any> = any>(handlers: NiceCustomDataSourceHandlers<T>): NiceDataSource<T>;
 export {};
-//# sourceMappingURL=datasource.d.ts.map

package/dist/core/deprecation.d.ts

@@ -34,4 +34,3 @@ export declare function forwardDeprecated<T>(opts: {
     newValue: T | undefined;
     removeIn?: string;
 }): T | undefined;
-//# sourceMappingURL=deprecation.d.ts.map

package/dist/core/displayMode.d.ts

@@ -43,4 +43,3 @@ export interface DisplayModeViewProps {
  * (when focused) activates edit mode just like clicking it.
  */
 export declare const DisplayModeView: React.FC<DisplayModeViewProps>;
-//# sourceMappingURL=displayMode.d.ts.map

package/dist/core/displayStyle.d.ts

@@ -76,4 +76,3 @@ export interface NiceDisplayStyleInfo {
 }
 /** Metadata for all built-in display styles. */
 export declare const NICE_DISPLAY_STYLE_INFO: NiceDisplayStyleInfo[];
-//# sourceMappingURL=displayStyle.d.ts.map

package/dist/core/filterToSql.d.ts

@@ -22,4 +22,3 @@ export declare function sortModelToOrderBy(sort: NiceSortExpression[], opts?: Fi
 export declare function matchesFilterCondition(row: Record<string, unknown>, c: NiceFilterCondition): boolean;
 /** Evaluate a {@link NiceFilterGroup} tree against a row (empty group ⇒ matches). */
 export declare function matchesFilterGroup(row: Record<string, unknown>, group: NiceFilterGroup): boolean;
-//# sourceMappingURL=filterToSql.d.ts.map

package/dist/core/helpContext.d.ts

@@ -94,4 +94,3 @@ export declare function useComponentHelp(componentName: string): {
     showHelpIcon: boolean;
 };
 export default NiceHelpProvider;
-//# sourceMappingURL=helpContext.d.ts.map

package/dist/core/hooks.d.ts

@@ -158,4 +158,3 @@ export declare function generatePaletteFromColor(baseColor: string): {
     text: string;
     textInverse: string;
 };
-//# sourceMappingURL=hooks.d.ts.map

package/dist/core/i18n.d.ts

@@ -7,4 +7,3 @@
 export { NiceI18nProvider, useNiceTranslation } from '@nice2dev/i18n';
 export type { NiceTranslateFn, NiceSupportedLang, NiceI18nProviderProps } from '@nice2dev/i18n';
 export { NICE_SUPPORTED_LANGS, NICE_I18N_DICTIONARIES } from '@nice2dev/i18n';
-//# sourceMappingURL=i18n.d.ts.map

package/dist/core/i18nDictionaries.d.ts

@@ -1,4 +1,3 @@
 export declare const NICE_SUPPORTED_LANGS: readonly ["en", "pl", "de", "fr", "es", "it", "pt", "nl", "sv", "no", "da", "fi", "cs", "sk", "hu", "ro", "bg", "uk", "ja", "ko", "zh", "ar"];
 export type NiceSupportedLang = (typeof NICE_SUPPORTED_LANGS)[number];
 export declare const NICE_I18N_DICTIONARIES: Record<NiceSupportedLang, Record<string, string>>;
-//# sourceMappingURL=i18nDictionaries.d.ts.map

package/dist/core/icons.d.ts

@@ -42,4 +42,3 @@ export declare function useNiceIcon(): {
 };
 /** Array of all built-in icon names available without a custom resolver. */
 export declare const NICE_BUILTIN_ICONS: string[];
-//# sourceMappingURL=icons.d.ts.map

package/dist/core/icuMessageFormat.d.ts

@@ -7,4 +7,3 @@
 export { formatICU, createICUTranslator } from '@nice2dev/i18n';
 export type { ICUFormatOptions } from '@nice2dev/i18n';
 export type ICUValues = Record<string, string | number | Date>;
-//# sourceMappingURL=icuMessageFormat.d.ts.map

package/dist/core/leak-detector.d.ts

@@ -260,4 +260,3 @@ export declare function useMemoryMonitor(intervalMs?: number, warnThresholdMB?:
  * Display leak detector status in React DevTools (via component props)
  */
 export declare const LeakDetectorStatus: React.FC;
-//# sourceMappingURL=leak-detector.d.ts.map

package/dist/core/omniverkTypes.d.ts

@@ -161,4 +161,3 @@ export interface NiceTenantInfo {
     /** Tenant locale (BCP 47, e.g. 'pl-PL'). */
     locale?: string;
 }
-//# sourceMappingURL=omniverkTypes.d.ts.map

package/dist/core/pluginSystem.d.ts

@@ -124,4 +124,3 @@ export interface NicePluginSystem {
  * (e.g. one per workspace, one for tests).
  */
 export declare function createNicePluginSystem(options?: NicePluginSystemOptions): NicePluginSystem;
-//# sourceMappingURL=pluginSystem.d.ts.map

package/dist/core/profiling.d.ts

@@ -273,4 +273,3 @@ export declare const ProfilerOverlay: React.FC<ProfilerOverlayProps>;
  */
 export declare function setupReactDevToolsIntegration(): void;
 export {};
-//# sourceMappingURL=profiling.d.ts.map

package/dist/core/responsive.d.ts

@@ -104,4 +104,3 @@ export interface SafeAreaInsets {
  * Returns CSS env() values as numbers.
  */
 export declare function useSafeAreaInsets(): SafeAreaInsets;
-//# sourceMappingURL=responsive.d.ts.map

package/dist/core/rtl.d.ts

@@ -44,4 +44,3 @@ export declare const logicalProps: {
     };
 };
 export {};
-//# sourceMappingURL=rtl.d.ts.map

package/dist/core/sanitizeHtml.d.ts

@@ -13,4 +13,3 @@ export declare function sanitizeHtml(html: string): string;
  * Rejects javascript:, vbscript:, data:text/html, and other dangerous schemes.
  */
 export declare function isSafeUrl(url: string): boolean;
-//# sourceMappingURL=sanitizeHtml.d.ts.map

package/dist/core/spatialNav.d.ts

@@ -72,4 +72,3 @@ export interface NiceFocusableProps extends NiceBaseProps {
 }
 /** Thin wrapper that registers its element with the spatial-nav provider. */
 export declare const NiceFocusable: React.FC<NiceFocusableProps>;
-//# sourceMappingURL=spatialNav.d.ts.map

package/dist/core/standardProps.d.ts

@@ -114,4 +114,3 @@ export declare function warnControlledClash(componentName: string, value: unknow
 /** Re-export common types this module is built upon. */
 export type { NiceBaseProps, NiceFormFieldProps, NiceSize, NiceVariant } from './types';
 export type NiceReactNode = React.ReactNode;
-//# sourceMappingURL=standardProps.d.ts.map

package/dist/core/testing.d.ts

@@ -104,4 +104,3 @@ export declare function createMockDataSource<T extends Record<string, unknown>>(
  * Returns an array of violations (empty = passed).
  */
 export declare function checkAriaCompliance(element: HTMLElement): string[];
-//# sourceMappingURL=testing.d.ts.map

package/dist/core/theme.d.ts

@@ -251,4 +251,3 @@ export interface NiceThemeContextValue {
 }
 export declare const NiceThemeContext: import("react").Context<NiceThemeContextValue | null>;
 export declare function useNiceTheme(): NiceThemeContextValue;
-//# sourceMappingURL=theme.d.ts.map

package/dist/core/themeGallery.d.ts

@@ -101,4 +101,3 @@ export declare const themeCoffee: NiceTheme;
 export declare const themeWine: NiceTheme;
 /** All 100 gallery themes in a single array. */
 export declare const NICE_THEME_GALLERY: NiceTheme[];
-//# sourceMappingURL=themeGallery.d.ts.map

package/dist/core/themePacks.d.ts

@@ -50,4 +50,3 @@ export type NiceThemePackId = keyof typeof NICE_THEME_PACKS;
 export declare function getNiceThemePack(id: string): NiceThemePack | undefined;
 /** Filter packs by tag (e.g. 'dark', 'serif', 'retro'). */
 export declare function filterNiceThemePacksByTag(tag: string): NiceThemePack[];
-//# sourceMappingURL=themePacks.d.ts.map

package/dist/core/themePacksExtended.d.ts

@@ -56,4 +56,3 @@ export type NiceThemePackIdExtended = keyof typeof NICE_THEME_PACKS_EXTENDED;
 export declare function getNiceThemePackExtended(id: string): NiceThemePack | undefined;
 /** Filter extended packs by tag. */
 export declare function filterNiceThemePacksExtendedByTag(tag: string): NiceThemePack[];
-//# sourceMappingURL=themePacksExtended.d.ts.map

package/dist/core/themePresets.d.ts

@@ -7,4 +7,3 @@ export declare const niceThemeMaterial: NiceTheme;
 export declare const niceThemeBootstrap: NiceTheme;
 export declare const niceThemeFluent: NiceTheme;
 export declare const NICE_THEME_PRESETS: NiceTheme[];
-//# sourceMappingURL=themePresets.d.ts.map

package/dist/core/themeVariants.d.ts

@@ -201,4 +201,3 @@ export declare function removeVariantConfig(scopeId: string, element?: HTMLEleme
 export declare function applyVariantsToTheme(theme: NiceTheme, config: Partial<ThemeVariantConfig>): NiceTheme & {
     variantConfig: ThemeVariantConfig;
 };
-//# sourceMappingURL=themeVariants.d.ts.map

package/dist/core/touch.d.ts

@@ -205,4 +205,3 @@ export interface UseVirtualKeyboardResult {
  * Uses viewport height changes as the primary detection method.
  */
 export declare function useVirtualKeyboard(): UseVirtualKeyboardResult;
-//# sourceMappingURL=touch.d.ts.map

package/dist/core/traceless.d.ts

@@ -458,4 +458,3 @@ declare const _default: {
     auditStorageCompliance: typeof auditStorageCompliance;
 };
 export default _default;
-//# sourceMappingURL=traceless.d.ts.map

package/dist/core/tutorials.d.ts

@@ -103,4 +103,3 @@ export interface NiceTutorialButtonProps {
  * unconditionally as `<NiceTutorialButton steps={resolveTutorial(...)} />`.
  */
 export declare const NiceTutorialButton: React.FC<NiceTutorialButtonProps>;
-//# sourceMappingURL=tutorials.d.ts.map

package/dist/core/types.d.ts

@@ -124,4 +124,3 @@ export type NiceOption<T = string> = {
     /** Grouping key for grouped dropdowns. */
     group?: string;
 };
-//# sourceMappingURL=types.d.ts.map

package/dist/core/useControllableState.d.ts

@@ -1,14 +1,30 @@
 import type { NiceChangeMeta, NiceOnChange } from './standardProps';
-export interface UseControllableStateOptions<T, TEvent = unknown> {
-    /** Controlled value. When defined, hook is in controlled mode. */
-    value?: T;
+/**
+ * Where uncontrolled state is seeded from. Two roles that used to share one field:
+ * `defaultValue` is the consumer's raw `default*` prop (the only thing the
+ * value+default clash warning looks at), `fallbackValue` is the control's own
+ * empty seed (`''`, `[]`, `0`) and never triggers a warning. One of them must be
+ * a `T`, so the returned value is always a `T`.
+ */
+export type UseControllableStateSeed<T> = {
     /** Initial value used in uncontrolled mode. */
     defaultValue: T;
+    /** Seed used when `defaultValue` is undefined. */
+    fallbackValue?: T;
+} | {
+    /** The consumer's `default*` prop, possibly undefined. */
+    defaultValue?: T | undefined;
+    /** Seed used when `defaultValue` is undefined. Never triggers the clash warning. */
+    fallbackValue: T;
+};
+export type UseControllableStateOptions<T, TEvent = unknown> = {
+    /** Controlled value. When defined, hook is in controlled mode. */
+    value?: T;
     /** Change callback invoked in both modes. */
     onChange?: NiceOnChange<T, TEvent>;
     /** Component name (used for dev warnings). */
     componentName?: string;
-}
+} & UseControllableStateSeed<T>;
 export type UseControllableStateReturn<T, TEvent = unknown> = readonly [
     T,
     (next: T | ((prev: T) => T), meta?: NiceChangeMeta<TEvent>) => void,
@@ -16,4 +32,3 @@ export type UseControllableStateReturn<T, TEvent = unknown> = readonly [
     boolean
 ];
 export declare function useControllableState<T, TEvent = unknown>(opts: UseControllableStateOptions<T, TEvent>): UseControllableStateReturn<T, TEvent>;
-//# sourceMappingURL=useControllableState.d.ts.map

package/dist/core/useGamepad.d.ts

@@ -67,4 +67,3 @@ export interface NavigationActions {
 }
 /** Create a standard UI-navigation action map for {@link useGamepad}. */
 export declare function createNavigationActions(handlers: NavigationActions): Record<string, GamepadAction>;
-//# sourceMappingURL=useGamepad.d.ts.map

package/dist/core/useThemeIsDark.d.ts

@@ -19,4 +19,3 @@ import type { RefObject } from 'react';
  * sync without consumers wiring `useDarkMode`.
  */
 export declare function useThemeIsDark(ref?: RefObject<HTMLElement | null>): boolean;
-//# sourceMappingURL=useThemeIsDark.d.ts.map

package/dist/core/validation.d.ts

@@ -43,4 +43,3 @@ export declare function evaluateValidationRule(rule: NiceFieldValidationRule, re
 export declare function evaluateValidation(rules: NiceFieldValidationRule[] | undefined, record: Record<string, unknown>): NiceFieldValidationIssue[];
 /** Convenience: does the record satisfy every `error`-severity rule? */
 export declare function isRecordValid(rules: NiceFieldValidationRule[] | undefined, record: Record<string, unknown>): boolean;
-//# sourceMappingURL=validation.d.ts.map