@nuraly/lumenui 0.1.0

package/packages/common/README.md

@@ -0,0 +1,137 @@
+# @nuralyui/common
+
+Common UI components package for Nuraly UI Library. This package contains basic building blocks that are commonly used across the component library and in applications.
+
+[![npm version](https://badge.fury.io/js/@nuralyui%2Fcommon.svg)](https://badge.fury.io/js/@nuralyui%2Fcommon)
+[![License](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+
+## 🧩 Shared Utilities (what this package provides)
+
+#### Mixins
+Base mixins that provide common functionality to all Nuraly UI components:
+- **`NuralyUIBaseMixin`** / **`BaseMixin`**: Combined mixin with theme, dependency, and event handling
+- **`ThemeAwareMixin`**: Theme management and observation
+- **`DependencyValidationMixin`**: Component dependency validation
+- **`EventHandlerMixin`**: Enhanced event handling capabilities
+
+#### Controllers
+Reactive controllers for component behavior:
+- **`ThemeController`**: Theme observation and management
+- **`SharedDropdownController`**: Dropdown positioning and behavior
+
+#### Theme Utilities
+- Theme detection and management
+- Theme variant types and utilities
+- getCurrentTheme, theme constants
+
+#### Utility Functions
+- `throttle`, `debounce`, `rafThrottle`
+- Performance optimization helpers
+
+> Note: As of 0.1.x, @nuralyui/common no longer re-exports UI components (icon, badge, divider, label). Those should be consumed from their own packages or via the grouped packages like `@nuralyui/forms` or `@nuralyui/layout`.
+
+## 🚀 Installation
+
+```bash
+npm install @nuralyui/common
+```
+
+Or using yarn:
+
+```bash
+yarn add @nuralyui/common
+```
+
+## 📖 Usage
+
+### Import Shared Utilities
+
+```javascript
+// Import mixins for creating custom components
+import { NuralyUIBaseMixin, ThemeAwareMixin } from '@nuralyui/common/mixins';
+
+// Import controllers
+import { ThemeController, SharedDropdownController } from '@nuralyui/common/controllers';
+
+// Import theme utilities
+import { getCurrentTheme, type ThemeVariant } from '@nuralyui/common/themes';
+
+// Import utility functions
+import { throttle, debounce, rafThrottle } from '@nuralyui/common/utils';
+```
+
+### Creating Custom Components with Mixins
+
+```typescript
+import { LitElement, html } from 'lit';
+import { customElement } from 'lit/decorators.js';
+import { NuralyUIBaseMixin } from '@nuralyui/common/mixins';
+
+@customElement('my-component')
+export class MyComponent extends NuralyUIBaseMixin(LitElement) {
+  render() {
+    return html`
+      <div data-theme="${this.currentTheme}">
+        My themed component
+      </div>
+    `;
+  }
+}
+```
+
+### Using Controllers
+
+```typescript
+import { LitElement, html } from 'lit';
+import { ThemeController } from '@nuralyui/common/controllers';
+
+export class MyComponent extends LitElement {
+  private themeController = new ThemeController(this);
+
+  render() {
+    return html`
+      <div class="${this.themeController.isDark ? 'dark' : 'light'}">
+        Theme: ${this.themeController.currentTheme}
+      </div>
+    `;
+  }
+}
+```
+
+### HTML Usage (utilities only)
+
+Utilities don’t render by themselves. Use them inside your own components or with the grouped/component packages.
+
+## 🎯 Why Use @nuralyui/common?
+
+### Guidance
+- Install components from their own packages (e.g., `@nuralyui/icon`) or grouped packages (`@nuralyui/forms`, `@nuralyui/layout`).
+- Use `@nuralyui/common` for mixins, controllers, themes, and utilities.
+
+## 📚 Component Documentation
+
+For component docs, see the individual packages or grouped packages:
+- [Icon](https://github.com/Nuralyio/NuralyUI/tree/main/src/components/icon)
+- [Badge](https://github.com/Nuralyio/NuralyUI/tree/main/src/components/badge)
+- [Divider](https://github.com/Nuralyio/NuralyUI/tree/main/src/components/divider)
+- [Label](https://github.com/Nuralyio/NuralyUI/tree/main/src/components/label)
+
+## 🔗 Related Packages
+
+- [@nuralyui/themes](https://www.npmjs.com/package/@nuralyui/themes) - Theme packages for Nuraly UI
+- Individual component packages available on npm under `@nuralyui/*`
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://github.com/NuralyUI/NuralyUI/blob/main/CONTRIBUTING.md) for details.
+
+## 📄 License
+
+BSD-3-Clause © [Laabidi Aymen](https://github.com/NuralyUI)
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/NuralyUI/NuralyUI)
+- [Documentation](https://nuralyui.github.io)
+- [NPM Organization](https://www.npmjs.com/org/nuralyui)
+- [Report Issues](https://github.com/NuralyUI/NuralyUI/issues)

package/packages/common/dist/LICENSE

@@ -0,0 +1,28 @@
+BSD 3-Clause License
+
+Copyright (c) 2019 Google LLC. All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are met:
+
+1. Redistributions of source code must retain the above copyright notice, this
+   list of conditions and the following disclaimer.
+
+2. Redistributions in binary form must reproduce the above copyright notice,
+   this list of conditions and the following disclaimer in the documentation
+   and/or other materials provided with the distribution.
+
+3. Neither the name of the copyright holder nor the names of its
+   contributors may be used to endorse or promote products derived from
+   this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

package/packages/common/dist/README.md

@@ -0,0 +1,137 @@
+# @nuralyui/common
+
+Common UI components package for Nuraly UI Library. This package contains basic building blocks that are commonly used across the component library and in applications.
+
+[![npm version](https://badge.fury.io/js/@nuralyui%2Fcommon.svg)](https://badge.fury.io/js/@nuralyui%2Fcommon)
+[![License](https://img.shields.io/badge/license-BSD--3--Clause-blue.svg)](https://opensource.org/licenses/BSD-3-Clause)
+
+## 🧩 Shared Utilities (what this package provides)
+
+#### Mixins
+Base mixins that provide common functionality to all Nuraly UI components:
+- **`NuralyUIBaseMixin`** / **`BaseMixin`**: Combined mixin with theme, dependency, and event handling
+- **`ThemeAwareMixin`**: Theme management and observation
+- **`DependencyValidationMixin`**: Component dependency validation
+- **`EventHandlerMixin`**: Enhanced event handling capabilities
+
+#### Controllers
+Reactive controllers for component behavior:
+- **`ThemeController`**: Theme observation and management
+- **`SharedDropdownController`**: Dropdown positioning and behavior
+
+#### Theme Utilities
+- Theme detection and management
+- Theme variant types and utilities
+- getCurrentTheme, theme constants
+
+#### Utility Functions
+- `throttle`, `debounce`, `rafThrottle`
+- Performance optimization helpers
+
+> Note: As of 0.1.x, @nuralyui/common no longer re-exports UI components (icon, badge, divider, label). Those should be consumed from their own packages or via the grouped packages like `@nuralyui/forms` or `@nuralyui/layout`.
+
+## 🚀 Installation
+
+```bash
+npm install @nuralyui/common
+```
+
+Or using yarn:
+
+```bash
+yarn add @nuralyui/common
+```
+
+## 📖 Usage
+
+### Import Shared Utilities
+
+```javascript
+// Import mixins for creating custom components
+import { NuralyUIBaseMixin, ThemeAwareMixin } from '@nuralyui/common/mixins';
+
+// Import controllers
+import { ThemeController, SharedDropdownController } from '@nuralyui/common/controllers';
+
+// Import theme utilities
+import { getCurrentTheme, type ThemeVariant } from '@nuralyui/common/themes';
+
+// Import utility functions
+import { throttle, debounce, rafThrottle } from '@nuralyui/common/utils';
+```
+
+### Creating Custom Components with Mixins
+
+```typescript
+import { LitElement, html } from 'lit';
+import { customElement } from 'lit/decorators.js';
+import { NuralyUIBaseMixin } from '@nuralyui/common/mixins';
+
+@customElement('my-component')
+export class MyComponent extends NuralyUIBaseMixin(LitElement) {
+  render() {
+    return html`
+      <div data-theme="${this.currentTheme}">
+        My themed component
+      </div>
+    `;
+  }
+}
+```
+
+### Using Controllers
+
+```typescript
+import { LitElement, html } from 'lit';
+import { ThemeController } from '@nuralyui/common/controllers';
+
+export class MyComponent extends LitElement {
+  private themeController = new ThemeController(this);
+
+  render() {
+    return html`
+      <div class="${this.themeController.isDark ? 'dark' : 'light'}">
+        Theme: ${this.themeController.currentTheme}
+      </div>
+    `;
+  }
+}
+```
+
+### HTML Usage (utilities only)
+
+Utilities don’t render by themselves. Use them inside your own components or with the grouped/component packages.
+
+## 🎯 Why Use @nuralyui/common?
+
+### Guidance
+- Install components from their own packages (e.g., `@nuralyui/icon`) or grouped packages (`@nuralyui/forms`, `@nuralyui/layout`).
+- Use `@nuralyui/common` for mixins, controllers, themes, and utilities.
+
+## 📚 Component Documentation
+
+For component docs, see the individual packages or grouped packages:
+- [Icon](https://github.com/Nuralyio/NuralyUI/tree/main/src/components/icon)
+- [Badge](https://github.com/Nuralyio/NuralyUI/tree/main/src/components/badge)
+- [Divider](https://github.com/Nuralyio/NuralyUI/tree/main/src/components/divider)
+- [Label](https://github.com/Nuralyio/NuralyUI/tree/main/src/components/label)
+
+## 🔗 Related Packages
+
+- [@nuralyui/themes](https://www.npmjs.com/package/@nuralyui/themes) - Theme packages for Nuraly UI
+- Individual component packages available on npm under `@nuralyui/*`
+
+## 🤝 Contributing
+
+We welcome contributions! Please see our [Contributing Guide](https://github.com/NuralyUI/NuralyUI/blob/main/CONTRIBUTING.md) for details.
+
+## 📄 License
+
+BSD-3-Clause © [Laabidi Aymen](https://github.com/NuralyUI)
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/NuralyUI/NuralyUI)
+- [Documentation](https://nuralyui.github.io)
+- [NPM Organization](https://www.npmjs.com/org/nuralyui)
+- [Report Issues](https://github.com/NuralyUI/NuralyUI/issues)

package/packages/common/dist/VERSIONS.md

@@ -0,0 +1,4 @@
+# @nuralyui/common
+
+Version: 0.1.4
+Build Date: 2026-03-18

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

@@ -0,0 +1,2 @@
+export * from '../constants.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from '../constants.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC"}

package/packages/common/dist/constants.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Shared constants for Nuraly UI components
+ *
+ * @module @nuralyui/common/constants
+ *
+ * @example
+ * ```typescript
+ * import { COMPONENT_PREFIX } from '@nuralyui/common/constants';
+ * ```
+ */
+export {};
+//# sourceMappingURL=constants.d.ts.map

package/packages/common/dist/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AAMH,OAAO,EAAE,CAAC"}

package/packages/common/dist/constants.js

@@ -0,0 +1,7 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+export {};
+//# sourceMappingURL=constants.js.map

package/packages/common/dist/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

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

@@ -0,0 +1,2 @@
+export * from '../controllers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from '../controllers.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,mBAAmB,CAAC"}

package/packages/common/dist/controllers.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Shared controllers for Nuraly UI components
+ *
+ * @module @nuralyui/common/controllers
+ *
+ * @example
+ * ```typescript
+ * import { ThemeController, SharedDropdownController } from '@nuralyui/common/controllers';
+ *
+ * class MyComponent extends LitElement {
+ *   private themeController = new ThemeController(this);
+ * }
+ * ```
+ */
+export * from './shared/controllers/index.js';
+//# sourceMappingURL=controllers.d.ts.map

package/packages/common/dist/controllers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllers.d.ts","sourceRoot":"","sources":["../src/controllers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAGH,cAAc,+BAA+B,CAAC"}

package/packages/common/dist/controllers.js

@@ -0,0 +1,22 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Shared controllers for Nuraly UI components
+ *
+ * @module @nuralyui/common/controllers
+ *
+ * @example
+ * ```typescript
+ * import { ThemeController, SharedDropdownController } from '@nuralyui/common/controllers';
+ *
+ * class MyComponent extends LitElement {
+ *   private themeController = new ThemeController(this);
+ * }
+ * ```
+ */
+// Export all controllers
+export * from './shared/controllers/index.js';
+//# sourceMappingURL=controllers.js.map

package/packages/common/dist/controllers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"controllers.js","sourceRoot":"","sources":["../src/controllers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH,yBAAyB;AACzB,cAAc,+BAA+B,CAAC"}

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

@@ -0,0 +1,25 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * @nuralyui/common
+ *
+ * Common UI components package for Nuraly UI Library.
+ * Contains basic building blocks used across the component library.
+ *
+ * This package exposes shared utilities only (mixins, controllers, themes, utils).
+ * Components should be imported from their own packages (e.g., @nuralyui/button).
+ *
+ * @example
+ * ```typescript
+ * import { NuralyUIBaseMixin } from '@nuralyui/common/mixins';
+ * import { ThemeController } from '@nuralyui/common/controllers';
+ * ```
+ */
+export * from './mixins.js';
+export * from './controllers.js';
+export * from './themes.js';
+export * from './utils.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAKH,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

package/packages/common/dist/index.js

@@ -0,0 +1,27 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * @nuralyui/common
+ *
+ * Common UI components package for Nuraly UI Library.
+ * Contains basic building blocks used across the component library.
+ *
+ * This package exposes shared utilities only (mixins, controllers, themes, utils).
+ * Components should be imported from their own packages (e.g., @nuralyui/button).
+ *
+ * @example
+ * ```typescript
+ * import { NuralyUIBaseMixin } from '@nuralyui/common/mixins';
+ * import { ThemeController } from '@nuralyui/common/controllers';
+ * ```
+ */
+// This file exports shared utilities only.
+// Export shared utilities
+export * from './mixins.js';
+export * from './controllers.js';
+export * from './themes.js';
+export * from './utils.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;GAcG;AAEH,2CAA2C;AAE3C,0BAA0B;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,kBAAkB,CAAC;AACjC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC"}

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

@@ -0,0 +1,2 @@
+export * from '../mixins.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mixins/index.ts"],"names":[],"mappings":"AACA,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,3 @@
+// Re-export the main mixins entry so TS emits dist/mixins/index.js
+export * from '../mixins.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mixins/index.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,cAAc,cAAc,CAAC"}

package/packages/common/dist/mixins.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Shared mixins for Nuraly UI components
+ *
+ * @module @nuralyui/common/mixins
+ *
+ * @example
+ * ```typescript
+ * import { NuralyUIBaseMixin } from '@nuralyui/common/mixins';
+ *
+ * class MyComponent extends NuralyUIBaseMixin(LitElement) {
+ *   // Your component code
+ * }
+ * ```
+ */
+export { NuralyUIBaseMixin, BaseMixin, type NuralyUIBaseElement } from './shared/base-mixin.js';
+export { ThemeAwareMixin, type ThemeAware } from './shared/theme-mixin.js';
+export { DependencyValidationMixin, type DependencyAware } from './shared/dependency-mixin.js';
+export { EventHandlerMixin, type EventHandlerCapable } from './shared/event-handler-mixin.js';
+export * from './shared/validation.types.js';
+export * from './shared/validation.types.js';
+//# sourceMappingURL=mixins.d.ts.map

package/packages/common/dist/mixins.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixins.d.ts","sourceRoot":"","sources":["../src/mixins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAGH,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAAE,KAAK,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,eAAe,EAAE,KAAK,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAE,KAAK,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG9F,cAAc,8BAA8B,CAAC;AAG7C,cAAc,8BAA8B,CAAC"}

package/packages/common/dist/mixins.js

@@ -0,0 +1,29 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: BSD-3-Clause
+ */
+/**
+ * Shared mixins for Nuraly UI components
+ *
+ * @module @nuralyui/common/mixins
+ *
+ * @example
+ * ```typescript
+ * import { NuralyUIBaseMixin } from '@nuralyui/common/mixins';
+ *
+ * class MyComponent extends NuralyUIBaseMixin(LitElement) {
+ *   // Your component code
+ * }
+ * ```
+ */
+// Export all mixins
+export { NuralyUIBaseMixin, BaseMixin } from './shared/base-mixin.js';
+export { ThemeAwareMixin } from './shared/theme-mixin.js';
+export { DependencyValidationMixin } from './shared/dependency-mixin.js';
+export { EventHandlerMixin } from './shared/event-handler-mixin.js';
+// Also export validation types
+export * from './shared/validation.types.js';
+// Export validation types
+export * from './shared/validation.types.js';
+//# sourceMappingURL=mixins.js.map

package/packages/common/dist/mixins.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mixins.js","sourceRoot":"","sources":["../src/mixins.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;GAaG;AAEH,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,SAAS,EAA4B,MAAM,wBAAwB,CAAC;AAChG,OAAO,EAAE,eAAe,EAAmB,MAAM,yBAAyB,CAAC;AAC3E,OAAO,EAAE,yBAAyB,EAAwB,MAAM,8BAA8B,CAAC;AAC/F,OAAO,EAAE,iBAAiB,EAA4B,MAAM,iCAAiC,CAAC;AAE9F,+BAA+B;AAC/B,cAAc,8BAA8B,CAAC;AAE7C,0BAA0B;AAC1B,cAAc,8BAA8B,CAAC"}

package/packages/common/dist/shared/base-mixin.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+import { LitElement } from 'lit';
+import { ThemeAware } from './theme-mixin.js';
+import { DependencyAware } from './dependency-mixin.js';
+import { EventHandlerCapable } from './event-handler-mixin.js';
+/**
+ * Base interface combining theme awareness, dependency validation, and event handling
+ */
+export interface NuralyUIBaseElement extends ThemeAware, DependencyAware, EventHandlerCapable {
+}
+type Constructor<T = {}> = new (...args: any[]) => T;
+/**
+ * Global base mixin that combines ThemeAwareMixin and DependencyValidationMixin
+ * This mixin provides a single entry point for all common functionality needed
+ * by Nuraly UI components, reducing boilerplate code in individual components.
+ *
+ * @param superClass - The base class to extend (typically LitElement)
+ * @returns Enhanced class with both theme management and dependency validation capabilities
+ *
+ * @example
+ * ```typescript
+ * @customElement('my-component')
+ * export class MyComponent extends NuralyUIBaseMixin(LitElement) {
+ *   requiredComponents = ['nr-icon'];
+ *
+ *   render() {
+ *     return html`<div data-theme="${this.currentTheme}">Content</div>`;
+ *   }
+ * }
+ * ```
+ */
+export declare const NuralyUIBaseMixin: <T extends Constructor<LitElement>>(superClass: T) => (new (...args: any[]) => DependencyAware) & (new (...args: any[]) => ThemeAware) & (new (...args: any[]) => EventHandlerCapable) & T;
+/**
+ * Alternative shorter name for convenience
+ */
+export declare const BaseMixin: <T extends Constructor<LitElement>>(superClass: T) => (new (...args: any[]) => DependencyAware) & (new (...args: any[]) => ThemeAware) & (new (...args: any[]) => EventHandlerCapable) & T;
+export {};
+//# sourceMappingURL=base-mixin.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base-mixin.d.ts","sourceRoot":"","sources":["../../src/shared/base-mixin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,KAAK,CAAC;AACjC,OAAO,EAAmB,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/D,OAAO,EAA6B,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAqB,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAElF;;GAEG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU,EAAE,eAAe,EAAE,mBAAmB;CAAG;AAEhG,KAAK,WAAW,CAAC,CAAC,GAAG,EAAE,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAErD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,GAAI,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,yIAIjF,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,SAAS,GATY,CAAC,SAAS,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC,yIASxC,CAAC"}

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

@@ -0,0 +1,38 @@
+/**
+ * @license
+ * Copyright 2023 Nuraly, Laabidi Aymen
+ * SPDX-License-Identifier: MIT
+ */
+import { ThemeAwareMixin } from './theme-mixin.js';
+import { DependencyValidationMixin } from './dependency-mixin.js';
+import { EventHandlerMixin } from './event-handler-mixin.js';
+/**
+ * Global base mixin that combines ThemeAwareMixin and DependencyValidationMixin
+ * This mixin provides a single entry point for all common functionality needed
+ * by Nuraly UI components, reducing boilerplate code in individual components.
+ *
+ * @param superClass - The base class to extend (typically LitElement)
+ * @returns Enhanced class with both theme management and dependency validation capabilities
+ *
+ * @example
+ * ```typescript
+ * @customElement('my-component')
+ * export class MyComponent extends NuralyUIBaseMixin(LitElement) {
+ *   requiredComponents = ['nr-icon'];
+ *
+ *   render() {
+ *     return html`<div data-theme="${this.currentTheme}">Content</div>`;
+ *   }
+ * }
+ * ```
+ */
+export const NuralyUIBaseMixin = (superClass) => {
+    // Apply all base mixins in the correct order:
+    // EventHandlerMixin first, then DependencyValidationMixin, then ThemeAwareMixin
+    return DependencyValidationMixin(ThemeAwareMixin(EventHandlerMixin(superClass)));
+};
+/**
+ * Alternative shorter name for convenience
+ */
+export const BaseMixin = NuralyUIBaseMixin;
+//# sourceMappingURL=base-mixin.js.map