@nuraly/runtime 0.1.4 → 0.1.5

package/components/ui/nuraly-ui/packages/common/dist/shared/controllers/dropdown.controller.d.ts

@@ -1,4 +1,3 @@
-/// <reference types="react" />
 import { ReactiveController, ReactiveControllerHost } from 'lit';
 import { DropdownController, DropdownHost, DropdownPosition, DropdownSpace } from './dropdown.interface.js';
 /**

package/components/ui/nuraly-ui/packages/common/dist/shared/controllers/dropdown.interface.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="react" />
-/// <reference types="node" />
 /**
  * Shared dropdown controller interface
  */

package/components/ui/nuraly-ui/packages/common/dist/shared/controllers/theme.controller.d.ts

@@ -3,7 +3,6 @@
  * Copyright 2023 Nuraly, Laabidi Aymen
  * SPDX-License-Identifier: MIT
  */
-/// <reference types="react" />
 import { ReactiveController, ReactiveControllerHost } from 'lit';
 import { ThemeVariant } from '../themes.js';
 /**

package/components/ui/nuraly-ui/packages/common/dist/shared/event-handler-mixin.d.ts

@@ -3,7 +3,6 @@
  * Copyright 2023 Nuraly, Laabidi Aymen
  * SPDX-License-Identifier: MIT
  */
-/// <reference types="react" />
 import { LitElement } from 'lit';
 declare type Constructor<T = {}> = new (...args: any[]) => T;
 /**

package/components/ui/nuraly-ui/packages/common/dist/shared/theme-mixin.d.ts

@@ -3,7 +3,6 @@
  * Copyright 2023 Nuraly, Laabidi Aymen
  * SPDX-License-Identifier: MIT
  */
-/// <reference types="react" />
 import { LitElement } from 'lit';
 /**
  * Theme detection and management mixin for Lit components

package/components/ui/nuraly-ui/packages/common/dist/shared/themes.d.ts

@@ -3,7 +3,6 @@
  * Copyright 2023 Nuraly, Laabidi Aymen
  * SPDX-License-Identifier: BSD-3-Clause
  */
-/// <reference types="react" />
 /**
  * Theme utilities and type definitions
  *

package/components/ui/nuraly-ui/packages/common/dist/shared/utils.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Throttles a function call to limit execution frequency
+ * Useful for performance optimization of frequently called functions
+ *
+ * @param func - Function to throttle
+ * @param limit - Milliseconds to limit between calls
+ * @returns Throttled function that will execute at most once per limit period
+ *
+ * @example
+ * ```typescript
+ * const throttledScroll = throttle((event) => {
+ *   console.log('Scroll event:', event);
+ * }, 16); // 60fps limit
+ *
+ * window.addEventListener('scroll', throttledScroll);
+ * ```
+ */
+export declare function throttle<T extends (...args: any[]) => any>(func: T, limit: number): (...args: Parameters<T>) => void;
+/**
+ * Debounces a function call to delay execution until after a period of inactivity
+ * Useful for search inputs, resize handlers, etc.
+ *
+ * @param func - Function to debounce
+ * @param delay - Milliseconds to wait after last call
+ * @returns Debounced function that will execute after delay period of inactivity
+ *
+ * @example
+ * ```typescript
+ * const debouncedSearch = debounce((query: string) => {
+ *   console.log('Searching for:', query);
+ * }, 300); // Wait 300ms after user stops typing
+ *
+ * input.addEventListener('input', (e) => debouncedSearch(e.target.value));
+ * ```
+ */
+export declare function debounce<T extends (...args: any[]) => any>(func: T, delay: number): (...args: Parameters<T>) => void;
+/**
+ * RAF (RequestAnimationFrame) throttle for smooth animations
+ * Ensures function is called at most once per animation frame
+ *
+ * @param func - Function to throttle to animation frames
+ * @returns Function that will execute at most once per animation frame
+ *
+ * @example
+ * ```typescript
+ * const rafThrottledUpdate = rafThrottle(() => {
+ *   // Expensive DOM updates
+ *   updateUI();
+ * });
+ *
+ * element.addEventListener('mousemove', rafThrottledUpdate);
+ * ```
+ */
+export declare function rafThrottle<T extends (...args: any[]) => any>(func: T): (...args: Parameters<T>) => void;
+//# sourceMappingURL=utils.d.ts.map

package/components/ui/nuraly-ui/packages/common/dist/shared/validation.types.d.ts

@@ -0,0 +1,108 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Validation event detail structure that validation controllers emit
+ */
+export interface ValidationEventDetail {
+    /** Whether the field is currently valid */
+    isValid: boolean;
+    /** Current validation message */
+    validationMessage: string;
+    /** Current validation state */
+    validationState: string;
+    /** Array of error messages */
+    errors: string[];
+    /** Array of warning messages */
+    warnings: string[];
+    /** Complete validation result object */
+    validationResult: any;
+}
+/**
+ * Validation status information returned by getValidationStatus()
+ */
+export interface ValidationStatus {
+    /** Whether the field is currently valid */
+    isValid: boolean;
+    /** Whether validation is currently in progress */
+    isValidating?: boolean;
+    /** Array of error messages */
+    errors: string[];
+    /** Array of warning messages */
+    warnings: string[];
+}
+/**
+ * Generic validation rule interface
+ */
+export interface ValidationRule {
+    /** Validation function */
+    validator: (value: any) => boolean | Promise<boolean>;
+    /** Error/warning message */
+    message: string;
+    /** Validation level */
+    level?: 'error' | 'warning';
+    /** Whether this rule blocks form submission */
+    blocking?: boolean;
+}
+/**
+ * Interface for components that support validation through events and API
+ * This is the shared pattern used by input, textarea, and other form field components
+ */
+export interface ValidatableComponent {
+    /** Field name for form submission */
+    name?: string;
+    /** Field value */
+    value: any;
+    /** Required field indicator */
+    required?: boolean;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Readonly state */
+    readonly?: boolean;
+    /** Current validation message */
+    validationMessage?: string;
+    /** Add a validation rule */
+    addRule?(rule: ValidationRule): void;
+    /** Remove validation rules matching predicate */
+    removeRule?(predicate: (rule: ValidationRule) => boolean): void;
+    /** Clear all validation rules */
+    clearRules?(): void;
+    /** Get current validation status */
+    getValidationStatus(): ValidationStatus;
+    /** Trigger validation manually */
+    validate(): Promise<boolean> | boolean;
+    /** Clear validation state */
+    clearValidation?(): void;
+    /** Dispatches 'nr-validation' events with ValidationEventDetail */
+    addEventListener(type: 'nr-validation', listener: (event: CustomEvent<ValidationEventDetail>) => void): void;
+    /** Removes 'nr-validation' event listeners */
+    removeEventListener(type: 'nr-validation', listener: (event: CustomEvent<ValidationEventDetail>) => void): void;
+}
+/**
+ * Form field information for form integration
+ */
+export interface FormFieldInfo {
+    element: HTMLElement & ValidatableComponent;
+    name: string;
+    value: any;
+    isValid: boolean;
+    validationMessage: string;
+    required: boolean;
+    touched: boolean;
+    dirty: boolean;
+}
+/**
+ * Constants for validation events
+ */
+export declare const VALIDATION_EVENTS: {
+    readonly VALIDATION: "nr-validation";
+    readonly FIELD_FOCUS: "nr-focus";
+    readonly FIELD_BLUR: "nr-blur";
+    readonly FIELD_CHANGE: "nr-change";
+    readonly FIELD_INPUT: "nr-input";
+    readonly FIELD_CLEAR: "nr-clear";
+};
+export declare type ValidationEventType = typeof VALIDATION_EVENTS[keyof typeof VALIDATION_EVENTS];
+//# sourceMappingURL=validation.types.d.ts.map

package/components/ui/nuraly-ui/src/components/radio-group/radio-group.component.ts

@@ -420,7 +420,7 @@ export class NrRadioGroupElement extends NuralyUIBaseMixin(LitElement) {
       [RadioButtonType.Default, () => this.renderOptionDefault()],
       [RadioButtonType.Button, () => this.renderOptionsWithButtons()],
       [RadioButtonType.Slot, () => this.renderOptionsWithSlots()],
-      ['button-slot', () => this.renderButtonsWithSlots()], // Special case for button with slots
+      [RadioButtonType.ButtonSlot, () => this.renderButtonsWithSlots()], // Special case for button with slots
     ])} `;
   }
 }

package/components/ui/nuraly-ui/src/components/radio-group/radio-group.types.ts

@@ -29,6 +29,7 @@ export enum RadioButtonType {
   Default = 'default',
   Button = 'button',
   Slot = 'slot',
+  ButtonSlot = 'button-slot',
 }
 
 export enum RadioButtonSize {