@nuraly/lumenui 0.1.0

package/packages/common/dist/shared/dependency-mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-mixin.d.ts","sourceRoot":"","sources":["../../src/shared/dependency-mixin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAsBjC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,IAAI,IAAI,CAAC;IAC7B,oBAAoB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC;CACtD;AAED,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAErD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,yBAAyB,GAAI,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,KAkHpD,WAAW,CAAC,eAAe,CAAC,GAAG,CACpE,CAAC"}

package/packages/common/dist/shared/dependency-mixin.js

@@ -0,0 +1,141 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Checks if the current environment is development mode using Lit's development detection
+ * @returns boolean indicating if we're in development mode
+ */
+const isDevelopmentMode = () => {
+    var _a;
+    // Use Lit's built-in development detection
+    // Check for Lit development mode indicators
+    return (
+    // Check if Lit development version is loaded (litElementVersions exists in dev)
+    globalThis.litElementVersions !== undefined ||
+        // Standard NODE_ENV check
+        (typeof process !== 'undefined' && ((_a = process.env) === null || _a === void 0 ? void 0 : _a.NODE_ENV) === 'development') ||
+        // Fallback: check for localhost
+        (typeof window !== 'undefined' && (window.location.hostname === 'localhost' ||
+            window.location.hostname === '127.0.0.1')));
+};
+/**
+ * Mixin that adds dependency validation functionality to LitElement components
+ *
+ * @param superClass - The base class to extend (typically LitElement)
+ * @returns Enhanced class with dependency validation capabilities
+ *
+ * @example
+ * ```typescript
+ * @customElement('my-component')
+ * export class MyComponent extends DependencyValidationMixin(LitElement) {
+ *   requiredComponents = ['nr-icon', 'hy-tooltip'];
+ *
+ *   override connectedCallback() {
+ *     super.connectedCallback();
+ *     this.validateDependencies();
+ *   }
+ * }
+ * ```
+ */
+export const DependencyValidationMixin = (superClass) => {
+    class DependencyValidationClass extends superClass {
+        constructor() {
+            super(...arguments);
+            /**
+             * Array of required component names that must be registered
+             * This should be set by the implementing component
+             */
+            this.requiredComponents = [];
+        }
+        /**
+         * Validates that all required component dependencies are available
+         * Only runs in development mode for performance
+         * @throws {Error} When required components are not registered
+         */
+        validateDependencies() {
+            // Only validate dependencies in development mode
+            if (!isDevelopmentMode()) {
+                return;
+            }
+            for (const componentName of this.requiredComponents) {
+                if (!this.isComponentAvailable(componentName)) {
+                    throw new Error(`Required component "${componentName}" is not registered. ` +
+                        `Please import and register the component before using ${this.tagName.toLowerCase()}. ` +
+                        `Example: import '@nuralyui/${componentName}';`);
+                }
+            }
+        }
+        /**
+         * Validates dependencies with custom error handling
+         * Only runs in development mode for performance
+         * @param onError - Custom error handler function
+         * @returns boolean indicating if all dependencies are available
+         */
+        validateDependenciesWithHandler(onError) {
+            // Only validate dependencies in development mode
+            if (!isDevelopmentMode()) {
+                return true; // Assume all dependencies are available in production
+            }
+            let allAvailable = true;
+            for (const componentName of this.requiredComponents) {
+                if (!this.isComponentAvailable(componentName)) {
+                    allAvailable = false;
+                    const error = new Error(`Required component "${componentName}" is not registered. ` +
+                        `Please import and register the component before using ${this.tagName.toLowerCase()}.`);
+                    if (onError) {
+                        onError(componentName, error);
+                    }
+                    else {
+                        console.error(error.message);
+                    }
+                }
+            }
+            return allAvailable;
+        }
+        /**
+         * Checks if a specific component is available
+         * @param componentName - The name of the component to check
+         * @returns boolean indicating if component is registered
+         */
+        isComponentAvailable(componentName) {
+            return !!customElements.get(componentName);
+        }
+        /**
+         * Gets a list of missing dependencies
+         * @returns Array of component names that are not registered
+         */
+        getMissingDependencies() {
+            return this.requiredComponents.filter(componentName => !this.isComponentAvailable(componentName));
+        }
+        /**
+         * Checks if all dependencies are available without throwing errors
+         * @returns boolean indicating if all dependencies are available
+         */
+        areDependenciesAvailable() {
+            return this.requiredComponents.every(componentName => this.isComponentAvailable(componentName));
+        }
+        /**
+         * Adds a required component to the dependency list
+         * @param componentName - The component name to add
+         */
+        addRequiredComponent(componentName) {
+            if (!this.requiredComponents.includes(componentName)) {
+                this.requiredComponents.push(componentName);
+            }
+        }
+        /**
+         * Removes a required component from the dependency list
+         * @param componentName - The component name to remove
+         */
+        removeRequiredComponent(componentName) {
+            const index = this.requiredComponents.indexOf(componentName);
+            if (index > -1) {
+                this.requiredComponents.splice(index, 1);
+            }
+        }
+    }
+    return DependencyValidationClass;
+};
+//# sourceMappingURL=dependency-mixin.js.map

package/packages/common/dist/shared/dependency-mixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency-mixin.js","sourceRoot":"","sources":["../../src/shared/dependency-mixin.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,64 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+import { LitElement } from 'lit';
+type Constructor<T = {}> = new (...args: any[]) => T;
+/**
+ * Interface for components that support event handling operations
+ */
+export interface EventHandlerCapable {
+    /**
+     * Dispatch a custom event with consistent structure
+     * @param eventName - The name of the event
+     * @param detail - The event detail object
+     */
+    dispatchCustomEvent(eventName: string, detail: any): void;
+    /**
+     * Dispatch events with metadata
+     */
+    dispatchEventWithMetadata(eventName: string, detail: any): void;
+    /**
+     * Dispatch input-related events
+     */
+    dispatchInputEvent(eventName: string, detail: any): void;
+    /**
+     * Dispatch focus-related events
+     */
+    dispatchFocusEvent(eventName: string, detail: any): void;
+    /**
+     * Dispatch validation events
+     */
+    dispatchValidationEvent(eventName: string, detail: any): void;
+    /**
+     * Dispatch action events
+     */
+    dispatchActionEvent(eventName: string, detail: any): void;
+    /**
+     * Check if a key is allowed when component is readonly
+     */
+    isReadonlyKeyAllowed(keyDownEvent: KeyboardEvent): boolean;
+    /**
+     * Check if key is an activation key (Enter/Space)
+     */
+    isActivationKey(keyDownEvent: KeyboardEvent): boolean;
+}
+/**
+ * Mixin that provides standardized event handling capabilities
+ *
+ * @param superClass - The base class to extend
+ * @returns Enhanced class with event handling capabilities
+ *
+ * @example
+ * ```typescript
+ * export class MyComponent extends EventHandlerMixin(LitElement) {
+ *   handleClick() {
+ *     this.dispatchCustomEvent('my-click', { value: 'test' });
+ *   }
+ * }
+ * ```
+ */
+export declare const EventHandlerMixin: <T extends Constructor<LitElement>>(superClass: T) => Constructor<EventHandlerCapable> & T;
+export {};
+//# sourceMappingURL=event-handler-mixin.d.ts.map

package/packages/common/dist/shared/event-handler-mixin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler-mixin.d.ts","sourceRoot":"","sources":["../../src/shared/event-handler-mixin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AAEjC,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC;;;;OAIG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,yBAAyB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAEhE;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAEzD;;OAEG;IACH,uBAAuB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAE9D;;OAEG;IACH,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,CAAC;IAE1D;;OAEG;IACH,oBAAoB,CAAC,YAAY,EAAE,aAAa,GAAG,OAAO,CAAC;IAE3D;;OAEG;IACH,eAAe,CAAC,YAAY,EAAE,aAAa,GAAG,OAAO,CAAC;CACvD;AAED;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,KAoH/C,WAAW,CAAC,mBAAmB,CAAC,GAAG,CACrE,CAAC"}

package/packages/common/dist/shared/event-handler-mixin.js

@@ -0,0 +1,95 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+/**
+ * Mixin that provides standardized event handling capabilities
+ *
+ * @param superClass - The base class to extend
+ * @returns Enhanced class with event handling capabilities
+ *
+ * @example
+ * ```typescript
+ * export class MyComponent extends EventHandlerMixin(LitElement) {
+ *   handleClick() {
+ *     this.dispatchCustomEvent('my-click', { value: 'test' });
+ *   }
+ * }
+ * ```
+ */
+export const EventHandlerMixin = (superClass) => {
+    class EventHandlerMixinClass extends superClass {
+        /**
+         * Dispatch a custom event with consistent structure and bubbling
+         */
+        dispatchCustomEvent(eventName, detail) {
+            this.dispatchEvent(new CustomEvent(eventName, {
+                detail,
+                bubbles: true,
+                composed: true
+            }));
+        }
+        /**
+         * Event dispatcher with additional metadata
+         * Adds common properties like timestamp and component info
+         */
+        dispatchEventWithMetadata(eventName, detail) {
+            var _a;
+            const eventDetail = Object.assign(Object.assign({}, detail), { timestamp: Date.now(), componentName: ((_a = this.tagName) === null || _a === void 0 ? void 0 : _a.toLowerCase()) || 'unknown' });
+            this.dispatchCustomEvent(eventName, eventDetail);
+        }
+        /**
+         * Dispatch input-related events with consistent structure
+         * Common pattern for form components
+         */
+        dispatchInputEvent(eventName, detail) {
+            const inputDetail = Object.assign({ target: detail.target || this, value: detail.value, originalEvent: detail.originalEvent }, detail);
+            this.dispatchCustomEvent(eventName, inputDetail);
+        }
+        /**
+         * Dispatch focus-related events with cursor and selection info
+         */
+        dispatchFocusEvent(eventName, detail) {
+            const focusDetail = Object.assign({ target: detail.target || this, value: detail.value, focused: detail.focused, cursorPosition: detail.cursorPosition, selectedText: detail.selectedText }, detail);
+            this.dispatchCustomEvent(eventName, focusDetail);
+        }
+        /**
+         * Dispatch validation events with error information
+         */
+        dispatchValidationEvent(eventName, detail) {
+            var _a;
+            const validationDetail = Object.assign({ target: detail.target || this, value: detail.value, isValid: (_a = detail.isValid) !== null && _a !== void 0 ? _a : false, error: detail.error }, detail);
+            this.dispatchCustomEvent(eventName, validationDetail);
+        }
+        /**
+         * Dispatch action events (copy, clear, etc.)
+         */
+        dispatchActionEvent(eventName, detail) {
+            const actionDetail = Object.assign({ target: detail.target || this, action: detail.action, previousValue: detail.previousValue, newValue: detail.newValue }, detail);
+            this.dispatchCustomEvent(eventName, actionDetail);
+        }
+        /**
+         * Standard readonly key filtering - reusable across components
+         */
+        isReadonlyKeyAllowed(keyDownEvent) {
+            const allowedReadonlyKeys = [
+                'Tab', 'Escape', 'ArrowLeft', 'ArrowRight', 'ArrowUp', 'ArrowDown',
+                'Home', 'End', 'PageUp', 'PageDown'
+            ];
+            if (keyDownEvent.ctrlKey || keyDownEvent.metaKey) {
+                const allowedCombinations = ['KeyA', 'KeyC'];
+                return allowedCombinations.includes(keyDownEvent.code);
+            }
+            return allowedReadonlyKeys.includes(keyDownEvent.key);
+        }
+        /**
+         * Handle common activation keys (Enter/Space)
+         */
+        isActivationKey(keyDownEvent) {
+            return keyDownEvent.key === 'Enter' || keyDownEvent.key === ' ';
+        }
+    }
+    return EventHandlerMixinClass;
+};
+//# sourceMappingURL=event-handler-mixin.js.map

package/packages/common/dist/shared/event-handler-mixin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-handler-mixin.js","sourceRoot":"","sources":["../../src/shared/event-handler-mixin.ts"],"names":[],"mappings":"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"}

package/packages/common/dist/shared/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+export { NuralyUIBaseMixin, BaseMixin, type NuralyUIBaseElement } from './base-mixin.js';
+export { ThemeAwareMixin, type ThemeAware } from './theme-mixin.js';
+export { DependencyValidationMixin, type DependencyAware } from './dependency-mixin.js';
+export { EventHandlerMixin, type EventHandlerCapable } from './event-handler-mixin.js';
+export { throttle, debounce, rafThrottle } from './utils.js';
+export * from './controllers/index.js';
+export * from './validation.types.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/common/dist/shared/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGvF,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAG7D,cAAc,wBAAwB,CAAC;AAGvC,cAAc,uBAAuB,CAAC"}

package/packages/common/dist/shared/index.js

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+// Export all shared mixins and utilities
+export { NuralyUIBaseMixin, BaseMixin } from './base-mixin.js';
+export { ThemeAwareMixin } from './theme-mixin.js';
+export { DependencyValidationMixin } from './dependency-mixin.js';
+export { EventHandlerMixin } from './event-handler-mixin.js';
+// Export utility functions
+export { throttle, debounce, rafThrottle } from './utils.js';
+// Export shared controllers
+export * from './controllers/index.js';
+// Export shared validation types
+export * from './validation.types.js';
+//# sourceMappingURL=index.js.map

package/packages/common/dist/shared/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/shared/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,yCAAyC;AACzC,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAA4B,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,eAAe,EAAmB,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAwB,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,iBAAiB,EAA4B,MAAM,0BAA0B,CAAC;AAEvF,2BAA2B;AAC3B,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE7D,4BAA4B;AAC5B,cAAc,wBAAwB,CAAC;AAEvC,iCAAiC;AACjC,cAAc,uBAAuB,CAAC"}

package/packages/common/dist/shared/render-utils.d.ts

@@ -0,0 +1,103 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+import { TemplateResult, nothing } from 'lit';
+/**
+ * Options for rendering a clear button
+ */
+export interface ClearButtonOptions {
+    /** Whether clear is allowed on this component */
+    allowClear: boolean;
+    /** Current value (empty value means no clear button shown) */
+    value: any;
+    /** Whether the component is disabled */
+    disabled?: boolean;
+    /** Whether the component is readonly */
+    readonly?: boolean;
+    /** Click handler for the clear action */
+    onClear: (e: Event) => void;
+    /** ARIA label for accessibility */
+    ariaLabel?: string;
+    /** Icon name to use (defaults to 'x') */
+    iconName?: string;
+    /** Icon size (defaults to 'small') */
+    iconSize?: string;
+    /** CSS class for the button */
+    cssClass?: string;
+}
+/**
+ * Options for rendering a label
+ */
+export interface LabelOptions {
+    /** CSS class for the label element */
+    cssClass?: string;
+    /** Part attribute for shadow DOM styling */
+    part?: string;
+    /** Associated input element ID */
+    forId?: string;
+    /** CSS class for the required indicator */
+    requiredClass?: string;
+}
+/**
+ * Options for rendering a validation message
+ */
+export interface ValidationMessageOptions {
+    /** CSS class for the message container */
+    cssClass?: string;
+    /** The current validation/status state */
+    statusClass?: string;
+    /** Element ID for aria-describedby */
+    id?: string;
+}
+/**
+ * Renders a clear button for form components.
+ * Used by input, textarea, and select components.
+ *
+ * @param options - Configuration for the clear button
+ * @returns TemplateResult or nothing if not applicable
+ */
+export declare function renderClearButton(options: ClearButtonOptions): TemplateResult | typeof nothing;
+/**
+ * Renders a label element for form components.
+ * Used by textarea, colorpicker, and timepicker components.
+ *
+ * @param label - The label text (returns nothing if falsy)
+ * @param required - Whether to show a required indicator
+ * @param options - Additional rendering options
+ * @returns TemplateResult or nothing if no label
+ */
+export declare function renderLabel(label: string | undefined, required?: boolean, options?: LabelOptions): TemplateResult | typeof nothing;
+/**
+ * Renders a validation message for form components.
+ * Used by input, textarea, and select components.
+ *
+ * @param message - The validation message (returns nothing if falsy)
+ * @param options - Additional rendering options
+ * @returns TemplateResult or nothing if no message
+ */
+export declare function renderValidationMessage(message: string | undefined, options?: ValidationMessageOptions): TemplateResult | typeof nothing;
+/**
+ * Renders a validation icon based on the validation state.
+ * Used by input and textarea components.
+ *
+ * @param state - The validation state ('error', 'warning', 'success', etc.)
+ * @param hasFeedback - Whether to show feedback (returns nothing if false)
+ * @returns TemplateResult or nothing if no feedback
+ */
+export declare function renderValidationIcon(state: string | undefined, hasFeedback?: boolean): TemplateResult | typeof nothing;
+/**
+ * Renders helper text or validation messages.
+ * Used by colorpicker and timepicker components.
+ *
+ * @param text - Helper text or validation message
+ * @param options - Additional options
+ * @returns TemplateResult or nothing if no text
+ */
+export declare function renderHelperText(text: string | undefined, options?: {
+    cssClass?: string;
+    isError?: boolean;
+    part?: string;
+}): TemplateResult | typeof nothing;
+//# sourceMappingURL=render-utils.d.ts.map

package/packages/common/dist/shared/render-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-utils.d.ts","sourceRoot":"","sources":["../../src/shared/render-utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAQ,cAAc,EAAE,OAAO,EAAE,MAAM,KAAK,CAAC;AAGpD;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;IACpB,8DAA8D;IAC9D,KAAK,EAAE,GAAG,CAAC;IACX,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,yCAAyC;IACzC,OAAO,EAAE,CAAC,CAAC,EAAE,KAAK,KAAK,IAAI,CAAC;IAC5B,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,yCAAyC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,sCAAsC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4CAA4C;IAC5C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sCAAsC;IACtC,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,cAAc,GAAG,OAAO,OAAO,CAyB9F;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,QAAQ,CAAC,EAAE,OAAO,EAClB,OAAO,CAAC,EAAE,YAAY,GACrB,cAAc,GAAG,OAAO,OAAO,CAiBjC;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,MAAM,GAAG,SAAS,EAC3B,OAAO,CAAC,EAAE,wBAAwB,GACjC,cAAc,GAAG,OAAO,OAAO,CAYjC;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,WAAW,CAAC,EAAE,OAAO,GACpB,cAAc,GAAG,OAAO,OAAO,CA8BjC;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,GAAG,SAAS,EACxB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GAChE,cAAc,GAAG,OAAO,OAAO,CAWjC"}

package/packages/common/dist/shared/render-utils.js

@@ -0,0 +1,132 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+import { html, nothing } from 'lit';
+import { ifDefined } from 'lit/directives/if-defined.js';
+/**
+ * Renders a clear button for form components.
+ * Used by input, textarea, and select components.
+ *
+ * @param options - Configuration for the clear button
+ * @returns TemplateResult or nothing if not applicable
+ */
+export function renderClearButton(options) {
+    const { allowClear, value, disabled = false, readonly: isReadonly = false, onClear, ariaLabel = 'Clear value', iconName = 'x', iconSize = 'small', cssClass = 'clear-button', } = options;
+    if (!allowClear || !value || disabled || isReadonly)
+        return nothing;
+    return html `
+    <button
+      class="${cssClass}"
+      type="button"
+      @click=${onClear}
+      aria-label="${ariaLabel}"
+    >
+      <nr-icon name="${iconName}" size="${iconSize}"></nr-icon>
+    </button>
+  `;
+}
+/**
+ * Renders a label element for form components.
+ * Used by textarea, colorpicker, and timepicker components.
+ *
+ * @param label - The label text (returns nothing if falsy)
+ * @param required - Whether to show a required indicator
+ * @param options - Additional rendering options
+ * @returns TemplateResult or nothing if no label
+ */
+export function renderLabel(label, required, options) {
+    if (!label)
+        return nothing;
+    const cssClass = (options === null || options === void 0 ? void 0 : options.cssClass) || 'label';
+    const part = (options === null || options === void 0 ? void 0 : options.part) || 'label';
+    const requiredClass = (options === null || options === void 0 ? void 0 : options.requiredClass) || 'required-indicator';
+    return html `
+    <label
+      class="${cssClass}"
+      part="${part}"
+      for="${ifDefined(options === null || options === void 0 ? void 0 : options.forId)}"
+    >
+      ${label}
+      ${required ? html `<span class="${requiredClass}">*</span>` : nothing}
+    </label>
+  `;
+}
+/**
+ * Renders a validation message for form components.
+ * Used by input, textarea, and select components.
+ *
+ * @param message - The validation message (returns nothing if falsy)
+ * @param options - Additional rendering options
+ * @returns TemplateResult or nothing if no message
+ */
+export function renderValidationMessage(message, options) {
+    if (!message)
+        return nothing;
+    const cssClass = (options === null || options === void 0 ? void 0 : options.cssClass) || 'validation-message';
+    const statusClass = (options === null || options === void 0 ? void 0 : options.statusClass) || '';
+    const id = (options === null || options === void 0 ? void 0 : options.id) || 'validation-message';
+    return html `
+    <div class="${cssClass} ${statusClass}" id="${id}" role="alert" aria-live="polite">
+      ${message}
+    </div>
+  `;
+}
+/**
+ * Renders a validation icon based on the validation state.
+ * Used by input and textarea components.
+ *
+ * @param state - The validation state ('error', 'warning', 'success', etc.)
+ * @param hasFeedback - Whether to show feedback (returns nothing if false)
+ * @returns TemplateResult or nothing if no feedback
+ */
+export function renderValidationIcon(state, hasFeedback) {
+    if (!hasFeedback || !state)
+        return nothing;
+    let iconName = '';
+    let iconClass = '';
+    switch (state) {
+        case 'error':
+            iconName = 'error';
+            iconClass = 'validation-error';
+            break;
+        case 'warning':
+            iconName = 'warning';
+            iconClass = 'validation-warning';
+            break;
+        case 'success':
+            iconName = 'check-circle';
+            iconClass = 'validation-success';
+            break;
+        default:
+            return nothing;
+    }
+    return html `
+    <nr-icon
+      class="validation-icon ${iconClass}"
+      name="${iconName}"
+      size="small"
+    ></nr-icon>
+  `;
+}
+/**
+ * Renders helper text or validation messages.
+ * Used by colorpicker and timepicker components.
+ *
+ * @param text - Helper text or validation message
+ * @param options - Additional options
+ * @returns TemplateResult or nothing if no text
+ */
+export function renderHelperText(text, options) {
+    if (!text)
+        return nothing;
+    const cssClass = (options === null || options === void 0 ? void 0 : options.cssClass) || 'helper-text';
+    const errorClass = (options === null || options === void 0 ? void 0 : options.isError) ? `${cssClass}--error` : '';
+    return html `
+    <div class="${cssClass} ${errorClass}" part="${ifDefined(options === null || options === void 0 ? void 0 : options.part)}">
+      ${text}
+    </div>
+  `;
+}
+//# sourceMappingURL=render-utils.js.map

package/packages/common/dist/shared/render-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-utils.js","sourceRoot":"","sources":["../../src/shared/render-utils.ts"],"names":[],"mappings":"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"}