@nice2dev/ui 1.0.25 → 1.0.27

package/dist/index.d.ts

@@ -66,6 +66,7 @@ import { CrossTabMessage } from '@nice2dev/ui-core';
 import { CSSProperties } from 'react';
 import { default as default_2 } from 'react';
 import { DEFAULT_VARIANT_CONFIG } from '@nice2dev/ui-core';
+import { defaultValidationMessage } from '@nice2dev/ui-core';
 import { DENSITY_VALUES } from '@nice2dev/ui-core';
 import { DensityVariant } from '@nice2dev/ui-core';
 import { deprecateProp } from '@nice2dev/ui-core';
@@ -74,6 +75,8 @@ import { deserializeTheme } from '@nice2dev/ui-core';
 import { Dispatch } from 'react';
 import { DisplayPreferences } from '@nice2dev/ui-core';
 import { endMark } from '@nice2dev/ui-core';
+import { evaluateValidation } from '@nice2dev/ui-core';
+import { evaluateValidationRule } from '@nice2dev/ui-core';
 import { FillVariant } from '@nice2dev/ui-core';
 import { filterGroupToWhere } from '@nice2dev/ui-core';
 import { filterNiceThemePacksByTag } from '@nice2dev/ui-core';
@@ -131,6 +134,7 @@ import { HelpProp } from '@nice2dev/ui-core';
 import { ICUValues } from '@nice2dev/ui-core';
 import { IndexedDBAdapter } from '@nice2dev/ui-core';
 import { InputStyleVariant } from '@nice2dev/ui-core';
+import { isRecordValid } from '@nice2dev/ui-core';
 import { ITracelessPolicy } from '@nice2dev/ui-core';
 import { JSX as JSX_2 } from 'react';
 import { KeyboardShortcut } from '@nice2dev/ui-core';
@@ -206,6 +210,9 @@ import { NiceFavoriteItem } from '@nice2dev/ui-core';
 import { NiceFieldState } from '@nice2dev/ui-core';
 import { NiceFieldStatus } from '@nice2dev/ui-core';
 import { NiceFieldStatusProps } from '@nice2dev/ui-core';
+import { NiceFieldValidationIssue } from '@nice2dev/ui-core';
+import { NiceFieldValidationOp } from '@nice2dev/ui-core';
+import { NiceFieldValidationRule } from '@nice2dev/ui-core';
 import { NiceFilterCondition } from '@nice2dev/ui-core';
 import { NiceFilterGroup } from '@nice2dev/ui-core';
 import { NiceFilterOperator } from '@nice2dev/ui-core';
@@ -3116,6 +3123,8 @@ export declare const DefaultLoadingFallback: default_2.FC<{
 /** Default cross-platform component type mapping. */
 export declare const defaultTypeMapping: NiceComponentTypeMapping;
 
+export { defaultValidationMessage }
+
 /** Default global registry instance. */
 export declare const defaultViewRegistry: NiceViewRegistry;
 
@@ -4295,6 +4304,10 @@ declare interface ESLintRuleContext {
     };
 }
 
+export { evaluateValidation }
+
+export { evaluateValidationRule }
+
 declare interface EventCondition {
     field: string;
     operator: 'eq' | 'neq' | 'gt' | 'lt' | 'gte' | 'lte' | 'contains' | 'exists';
@@ -5706,6 +5719,8 @@ export declare interface InvoiceTotals {
 /** Check if a user can perform an action on a resource. Deny overrides allow. */
 export declare function isAllowed(resolved: NiceResolvedPermissions, resource: string, action: RbacAction): boolean;
 
+export { isRecordValid }
+
 /** Check if a version satisfies min/max constraints. */
 export declare function isVersionCompatible(version: SemVer, min?: SemVer, max?: SemVer): boolean;
 
@@ -8282,8 +8297,44 @@ export declare interface NiceCardProps extends NiceBaseProps {
     bordered?: boolean;
     /** Makes the entire card clickable. */
     onClick?: () => void;
+    /**
+     * Make the card behave as a selectable option (radio): cursor/hover affordance,
+     * `role="radio"` + `aria-checked`, keyboard select (Space/Enter). Inside a
+     * {@link NiceCardRadioGroup} this is implied for cards that carry a `value`.
+     */
+    selectable?: boolean;
+    /** Whether the card is currently selected (controlled; auto-wired inside a NiceCardRadioGroup). */
+    selected?: boolean;
+    /** The option value bound to this card (used for selection + the group's onChange). */
+    value?: NiceCardValue;
+    /** Fired with `value` when the card is selected. */
+    onSelect?: (value: NiceCardValue) => void;
+    /** Radio group name (auto-wired inside a NiceCardRadioGroup). */
+    name?: string;
+}
+
+/**
+ * {@link NiceCardRadioGroup} — wraps NiceCards into a single-select radio group:
+ * child cards that carry a `value` become selectable and report selection via
+ * `onChange` (the "binding + event on select"). Adds `role="radiogroup"`.
+ */
+export declare const NiceCardRadioGroup: default_2.FC<NiceCardRadioGroupProps>;
+
+/** Props for {@link NiceCardRadioGroup} — coordinates single-selection across child NiceCards. */
+export declare interface NiceCardRadioGroupProps extends NiceBaseProps {
+    /** Selected value (controlled). */
+    value?: NiceCardValue;
+    /** Fired with the newly-selected value. */
+    onChange?: (value: NiceCardValue) => void;
+    /** Radio group name applied to child cards. */
+    name?: string;
+    /** Child NiceCards (each with a `value`). */
+    children: default_2.ReactNode;
 }
 
+/** Value type used by selectable cards / card radio groups. */
+export declare type NiceCardValue = string | number;
+
 export declare function NiceCardView<T extends NiceCardViewItem>({ items, renderCard, columns, gap, searchable, searchField, searchPlaceholder, loading, emptyText, onCardClick, className, style, accessMode, id, }: NiceCardViewProps<T>): default_2.JSX.Element | null;
 
 /** An item displayed by the {@link NiceCardView} component. */
@@ -12086,6 +12137,12 @@ export { NiceFieldStatus }
 
 export { NiceFieldStatusProps }
 
+export { NiceFieldValidationIssue }
+
+export { NiceFieldValidationOp }
+
+export { NiceFieldValidationRule }
+
 /** A custom column in the {@link NiceFileManager} detail view. */
 export declare interface NiceFileColumnDef {
     /** Column key. */
@@ -22767,6 +22824,24 @@ export { NiceUserPreferencesProvider }
 
 export { NiceUserPreferencesProviderProps }
 
+/**
+ * {@link NiceValidationBuilder} — visual editor for {@link NiceFieldValidationRule} lists,
+ * mirroring NiceFilterBuilder. Rules are enforced at runtime by the forms via
+ * `evaluateValidation` and can be reused by host codegen.
+ */
+export declare const NiceValidationBuilder: default_2.FC<NiceValidationBuilderProps>;
+
+/** Props for {@link NiceValidationBuilder}. */
+export declare interface NiceValidationBuilderProps extends NiceBaseProps {
+    /** Fields that rules may target (reuses the filter field descriptor). */
+    fields: NiceFilterField[];
+    /** The validation rules (controlled). */
+    value: NiceFieldValidationRule[];
+    onChange: (rules: NiceFieldValidationRule[]) => void;
+    /** Optional "?" guided tour. Off by default; `true` uses the built-in tour. */
+    tutorial?: NiceComponentTutorial;
+}
+
 export declare const NiceValidationGroup: default_2.FC<NiceValidationGroupProps>;
 
 /** Props for the {@link NiceValidationGroup} component — a context provider that orchestrates validation of all child {@link NiceValidator} instances. */