@maropost-ui/liquidsky-ui 0.0.8

package/README.md

@@ -0,0 +1,182 @@
+# @liquidsky/ui
+# 0.0.8
+A shared UI component library, composables, and utilities for Vue 3 + Vuetify applications. This package provides reusable components and common functionality to accelerate development across multiple frontend applications.
+
+
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-blue.svg)](https://www.typescriptlang.org/)
+[![Vue 3](https://img.shields.io/badge/Vue-3.5-green.svg)](https://vuejs.org/)
+[![Vuetify](https://img.shields.io/badge/Vuetify-3.7-purple.svg)](https://vuetifyjs.com/)
+[![vue Router](https://img.shields.io/badge/vue--router-4.4.5-orange.svg)](https://router.vuejs.org/)
+
+
+## Features
+
+- **🎨 UI Components**: Pre-built, accessible Vue components built with Vuetify
+- **🔧 Composables**: Reusable Vue 3 composition API functions
+- **📦 Directives**: Custom Vue directives for enhanced functionality
+- **📝 TypeScript Support**: Full TypeScript definitions and type safety
+- **📖 Documentation**: Auto-generated component documentation
+
+## Peer Dependencies
+
+The following packages are required as peer dependencies:
+
+- `vue` (^3.5.11) - Vue.js framework
+- `vue-router` (^4.4.5) - Vue router
+- `date-fns-tz` (^3.2.0) - Date utilities with timezone support
+- `lz-string` (^1.5.0) - String compression library
+
+
+## Quick Start
+
+```bash
+npm install @liquidsky/ui
+```
+```typescript
+import { AppBreadcrumb } from '@liquidsky/ui'
+```
+
+## @liquidsky/ui Local Development Guide
+Use these methods to test @liquidsky/ui changes in your consuming project (e.g., commerce-frontend or commerce-backoffice) without publishing to npm. Both leverage npm's linking and packaging features for rapid iteration in your app workflow.
+
+
+
+### 🚀 Method 1: npm link (Recommended for Active Development)
+Creates a symlink for instant hot-reloading of changes.
+
+> **Note:** This method does **not** work well with Webpack. If you are using Vite, this is the preferred approach. Otherwise, use Method 2.
+
+#### Steps:
+
+1. **Clone the repository:**
+   ```bash
+   git clone <repo-url> liquidsky-frontend
+   cd liquidsky-frontend
+   git checkout main
+   ```
+
+2. **Install dependencies and build the package:**
+   ```bash
+   npm install
+   npm run dev
+   ```
+
+3. **Create a local npm link:**
+   ```bash
+   npm link
+   ```
+
+4. **In your consuming project (e.g., `commerce-frontend`):**
+   ```bash
+   cd /path/to/your/consuming-project
+   npm link @liquidsky/ui
+   ```
+
+Now, any changes you make in the `liquidsky-frontend` package will be reflected in your consuming project after rebuilding the library. This is useful for rapid development and testing across multiple projects locally.
+
+### 📦 Method 2: Local npm pack (For Stable Builds)
+Generates a distributable .tgz file for one-off installs.
+
+#### Step 1: Clone and build the library
+```bash
+git clone <repo-url> liquidsky-frontend
+cd liquidsky-frontend
+git checkout main
+npm install
+npm run build
+```
+#### Step 2: Create package
+```bash
+npm pack
+Creates liquidsky-ui-<version>.tgz.
+```
+
+#### Step 3: Install in consuming project
+```bash
+cd /path/to/commerce-backoffice  # or your project
+npm install ../../path/to/liquidsky-frontend/liquidsky-ui-<version>.tgz
+```
+
+## Documentation
+
+This package features automated Storybook documentation that stays synchronized with your components and keeps docs always up-to-date with your code.
+
+```bash 
+# Start Storybook dev server (recommended for development)
+npm run storybook
+
+# Build Storybook for static deployment
+npm run storybook:build
+```
+
+Default URL: http://localhost:6006
+
+### 📂 Story Organization
+
+```
+stories/
+├── custom-components/   # Component stories
+│   ├── AppBreadcrumbs.stories.ts
+│   └── AppDropdown.stories.tsx
+├── composables/         # Composables stories
+|── Directive 
+|── vuetify-components   # All vuetify component stories 
+├── utils/               # Utility stories
+```
+
+## Best Practices for Auto-Documentation
+
+### 1. Use JSDoc Comments
+
+```typescript
+/**
+ * @description Search functionality composable with route integration
+ * @example
+ * ```typescript
+ * const { keyword, submitSearch } = useSearch()
+ * submitSearch()
+ * ```
+ */
+export function useSearch(): SearchInterface
+```
+
+### 2. Document Component Props
+
+```typescript
+export interface SearchBarProps {
+  /** Search placeholder text */
+  placeholder?: string
+  /** Enable automatic route integration */
+  useRouteIntegration?: boolean
+}
+```
+
+### 3. Provide Usage Examples
+
+```vue
+<!--
+Usage Example:
+<TheSearchBar 
+  placeholder="Search products..."
+  @search="handleSearch"
+/>
+-->
+```
+
+### 4. Use TypeScript Types
+
+```typescript
+// Explicit return types help documentation
+export function useValidation(): ValidationInterface {
+  // ...
+}
+```
+
+## Contributing
+
+1. Follow the existing code style and patterns
+2. Add JSDoc comments for new functions and components
+3. Update this README when adding new features
+4. Ensure all components are properly typed with TypeScript
+
+

package/dist/AppDialogWrapper-CNldRmy-.js

@@ -0,0 +1,5 @@
+import { AppDialogWrapper as p } from "./index.js";
+export {
+  p as default
+};
+//# sourceMappingURL=AppDialogWrapper-CNldRmy-.js.map

package/dist/AppDialogWrapper-CNldRmy-.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppDialogWrapper-CNldRmy-.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/AppMultiCellValue-H5eP9IvV.js

@@ -0,0 +1,5 @@
+import { AppMultiCellValue as l } from "./index.js";
+export {
+  l as default
+};
+//# sourceMappingURL=AppMultiCellValue-H5eP9IvV.js.map

package/dist/AppMultiCellValue-H5eP9IvV.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppMultiCellValue-H5eP9IvV.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/AppPriceDisplay-BbxtY7SY.js

@@ -0,0 +1,5 @@
+import { AppPriceDisplay as p } from "./index.js";
+export {
+  p as default
+};
+//# sourceMappingURL=AppPriceDisplay-BbxtY7SY.js.map

package/dist/AppPriceDisplay-BbxtY7SY.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppPriceDisplay-BbxtY7SY.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/AppTooltip-nmMkVWSP.js

@@ -0,0 +1,5 @@
+import { AppTooltip as p } from "./index.js";
+export {
+  p as default
+};
+//# sourceMappingURL=AppTooltip-nmMkVWSP.js.map

package/dist/AppTooltip-nmMkVWSP.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppTooltip-nmMkVWSP.js","sources":[],"sourcesContent":[],"names":[],"mappings":";"}

package/dist/components/AppDropdown/index.d.ts

@@ -0,0 +1,11 @@
+export { default as AppDropdown } from './AppDropdown.vue';
+export { default as DropdownItem } from './DropdownItem.vue';
+export { default as DropdownChip } from './DropdownChip.vue';
+export { default as DropdownLoading } from './DropdownLoading.vue';
+export { default as DropdownNoData } from './DropdownNoData.vue';
+export { default as DropdownAppendItem } from './DropdownAppendItem.vue';
+export { default as CreateNewItem } from './CreateNewItem.vue';
+export { default as useDropdownSearch } from './useDropdownSearch';
+export { default as useDropdownData } from './useDropdownData';
+export { default as useDropdownSelection } from './useDropdownSelection';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/AppDropdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/AppDropdown/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAG3D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAG/D,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/components/AppDropdown/useDropdownData.d.ts

@@ -0,0 +1,22 @@
+import { type Ref } from "vue";
+import type { AppDropdownService, DataFetcher } from "../../types/AppDropdownProps";
+/**
+ * Composable for managing dropdown data fetching, pagination, and loading states
+ */
+export default function useDropdownData<T = any>(dataFetcher?: DataFetcher<T>, service?: AppDropdownService<T>, customParams?: Record<string, any>, exclude?: number[], compactItem?: (item: T) => T, attrs?: Record<string, any>, search?: Ref<string>, defaultItems?: Ref<T[]>, model?: Ref<T | T[] | undefined>, onToggleSelectAll?: () => void): {
+    isLoading: Ref<number, number>;
+    items: Ref<T[], T[]>;
+    page: Ref<number, number>;
+    hasItems: Ref<boolean, boolean>;
+    isFetching: Ref<boolean, boolean>;
+    totalItems: Ref<number, number>;
+    allItems: import("vue").ComputedRef<T[]>;
+    isLoadMoreEnabled: import("vue").ComputedRef<boolean>;
+    isExisting: import("vue").ComputedRef<boolean>;
+    fetchItems: () => Promise<void>;
+    loadMoreItems: () => Promise<void>;
+    onIntersect: (isIntersecting: boolean) => void;
+    onFocusHandler: (isFocused: boolean) => void;
+    handleClearSelection: () => void;
+};
+//# sourceMappingURL=useDropdownData.d.ts.map

package/dist/components/AppDropdown/useDropdownData.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDropdownData.d.ts","sourceRoot":"","sources":["../../../src/components/AppDropdown/useDropdownData.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAErD,OAAO,KAAK,EAGV,kBAAkB,EAClB,WAAW,EACZ,MAAM,8BAA8B,CAAC;AAEtC;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,CAAC,CAAC,GAAG,GAAG,EAC7C,WAAW,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,EAC5B,OAAO,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,EAC/B,YAAY,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EACtC,OAAO,GAAE,MAAM,EAAO,EACtB,WAAW,GAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAe,EACzC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAC/B,MAAM,GAAE,GAAG,CAAC,MAAM,CAAW,EAC7B,YAAY,GAAE,GAAG,CAAC,CAAC,EAAE,CAAW,EAChC,KAAK,GAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,CAAkB,EAChD,iBAAiB,GAAE,MAAM,IAAe;;;;;;;;;;;;kCA0MH,OAAO;gCAST,OAAO;;EAgC3C"}

package/dist/components/AppDropdown/useDropdownSearch.d.ts

@@ -0,0 +1,16 @@
+import { Ref } from "vue";
+/**
+ * Composable for managing dropdown search functionality with debouncing and emoji filtering
+ *
+ * @returns Object containing search state and handlers
+ */
+export default function useDropdownSearch(): {
+    search: Ref<string, string>;
+    isSelecting: Ref<boolean, boolean>;
+    handleItemSelection: () => void;
+    createDebouncedSearchHandler: (page: Ref<number>, hasItems: Ref<boolean>, fetchItems: () => void) => import("../../composables/useDebounce").DebouncedFunction<[]> & {
+        cancel: () => void;
+    };
+    stripEmojis: (value: string | null | undefined) => string;
+};
+//# sourceMappingURL=useDropdownSearch.d.ts.map

package/dist/components/AppDropdown/useDropdownSearch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDropdownSearch.d.ts","sourceRoot":"","sources":["../../../src/components/AppDropdown/useDropdownSearch.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAO,MAAM,KAAK,CAAC;AAI/B;;;;GAIG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB;;;+BAYP,IAAI;yCAa5B,GAAG,CAAC,MAAM,CAAC,YACP,GAAG,CAAC,OAAO,CAAC,cACV,MAAM,IAAI;;;;EAkCzB"}

package/dist/components/AppDropdown/useDropdownSelection.d.ts

@@ -0,0 +1,17 @@
+import { type Ref } from "vue";
+/**
+ * Composable for managing dropdown item selection, title resolution, and chip management
+ */
+export default function useDropdownSelection<T = any>(model: Ref<T | T[] | undefined>, attrs?: Record<string, any>, defaultItems?: Ref<T[]>, search?: Ref<string>, modelSelectAll?: Ref<{
+    select_all: boolean;
+    ids: T[];
+}>, totalItems?: Ref<number>, maxVisibleChips?: number): {
+    chipCollapsableText: import("vue").ComputedRef<string>;
+    removeItem: (itemIndex: number) => void;
+    isItemSelected: (item: T) => boolean;
+    getItemTitle: (itemArg: any) => string;
+    getIsSelected: (slotProps: any, slotItem: any) => boolean;
+    getListItemProps: (slotProps: any) => any;
+    createNewItem: () => void;
+};
+//# sourceMappingURL=useDropdownSelection.d.ts.map

package/dist/components/AppDropdown/useDropdownSelection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDropdownSelection.d.ts","sourceRoot":"","sources":["../../../src/components/AppDropdown/useDropdownSelection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAI9C;;GAEG;AACH,MAAM,CAAC,OAAO,UAAU,oBAAoB,CAAC,CAAC,GAAG,GAAG,EAClD,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,SAAS,CAAC,EAC/B,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAM,EAC/B,YAAY,GAAE,GAAG,CAAC,CAAC,EAAE,CAAW,EAChC,MAAM,GAAE,GAAG,CAAC,MAAM,CAAW,EAC7B,cAAc,GAAE,GAAG,CAAC;IAAE,UAAU,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,CAAC,EAAE,CAAA;CAAE,CAAuC,EAC5F,UAAU,GAAE,GAAG,CAAC,MAAM,CAAU,EAChC,eAAe,GAAE,MAAU;;4BAkBI,MAAM;2BAWP,CAAC,KAAG,OAAO;4BAyBV,GAAG,KAAG,MAAM;+BAuCT,GAAG,YAAY,GAAG,KAAG,OAAO;kCAYzB,GAAG;;EAuCzC"}

package/dist/components/TheUnifiedNavigation/index.d.ts

@@ -0,0 +1,6 @@
+export { default as TheUnifiedNavigation } from './TheUnifiedNavigation.vue';
+export { default as UnifiedNavigationBlock } from './UnifiedNavigationBlock.vue';
+export { default as NavigationToggleButton } from './NavigationToggleButton.vue';
+export { default as SubMenuDialog } from './SubMenuDialog.vue';
+export { default as UnifiedNavigationNode } from './UnifiedNavigationNode.vue';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/TheUnifiedNavigation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/TheUnifiedNavigation/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,4BAA4B,CAAA;AAG5E,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,8BAA8B,CAAA;AAChF,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,6BAA6B,CAAA"}

package/dist/components/index.d.ts

@@ -0,0 +1,36 @@
+export { default as AppBreadcrumb } from "./AppBreadcrumb.vue";
+export { default as AppClipboard } from "./AppClipboard.vue";
+export { default as AppConfirmationDialog } from "./AppConfirmationDialog.vue";
+export { default as AppDataTable } from "./AppDataTable/AppDataTable.vue";
+export { default as DataTableFilter } from "./AppDataTable/DataTableFilter.vue";
+export { default as DataTableLocalSearch } from "./AppDataTable/DataTableLocalSearch.vue";
+export { default as SavedFilterDialog } from "./AppDataTable/SavedFilterDialog.vue";
+export { default as AppDialogWrapper } from "./AppDialogWrapper.vue";
+export { default as AppDrawerWrapper } from "./AppDrawerWrapper.vue";
+export { default as AppDropdown } from "./AppDropdown/AppDropdown.vue";
+export { default as AppExpandableList } from "./AppExpandableList.vue";
+export { default as AppFilterButton } from "./AppFilterButton.vue";
+export { default as AppMultiCellValue } from "./AppMultiCellValue.vue";
+export { default as AppNumberInput } from "./AppNumberInput.vue";
+export { default as AppNumber } from "./AppNumber.vue";
+export { default as AppPageTitle } from "./AppPageTitle.vue";
+export { default as AppPriceDisplay } from "./AppPriceDisplay.vue";
+export { default as AppSnackbar } from "./AppSnackbar.vue";
+export { default as AppTableActionMenu } from "./AppTableActionMenu.vue";
+export { default as AppTooltip } from "./AppTooltip.vue";
+export { default as AppGridTable } from "./AppGridTable.vue";
+export { default as TheAccountDropdown } from "./TheAccountDropdown.vue";
+export { default as TheAppsDropdown } from "./TheAppsDropdown.vue";
+export { default as TheHeader } from "./TheHeader.vue";
+export { default as TheNavigation } from "./TheNavigation.vue";
+export { default as TheNotificationDrawer } from "./TheNotificationDrawer.vue";
+export { default as TheNotificationIcon } from "./TheNotificationIcon.vue";
+export { default as TheSearchBar } from "./TheSearchBar.vue";
+export { default as TheSecondaryNavigation } from "./TheSecondaryNavigation.vue";
+export { default as TheTimezone } from "./TheTimezone/TheTimezone.vue";
+export { default as TheUserDropdown } from "./TheUserDropdown.vue";
+export { TheUnifiedNavigation } from "./TheUnifiedNavigation";
+export { default as AlertModal } from "./AlertModal.vue";
+export { default as TheOnboardingBanner } from "./TheOnboardingBanner.vue";
+export { default as TheOnboardingScreenChecklists } from "./TheOnboardingScreenChecklists.vue";
+//# sourceMappingURL=index.d.ts.map

package/dist/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/components/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAE/E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC1E,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,oCAAoC,CAAC;AAChF,OAAO,EAAE,OAAO,IAAI,oBAAoB,EAAE,MAAM,yCAAyC,CAAC;AAC1F,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAEpF,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAG7D,OAAO,EAAE,OAAO,IAAI,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACjF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,+BAA+B,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,6BAA6B,EAAE,MAAM,qCAAqC,CAAC"}

package/dist/composables/index.d.ts

@@ -0,0 +1,11 @@
+export { default as useBackNavigation } from "./useBackNavigation";
+export { default as useQueryFilters } from "./useQueryFilters";
+export { default as useRefHistory } from "./useRefHistory";
+export { default as useSearch } from "./useSearch";
+export { default as useValidation } from "./useValidation";
+export { default as useClipboard } from "./useClipboard";
+export { default as useDebounce } from "./useDebounce";
+export { default as useEmoji } from "./useEmoji";
+export { default as toRefs } from "./toRefs";
+export { default as useUnitConversion } from "./useUnitConversion";
+//# sourceMappingURL=index.d.ts.map

package/dist/composables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAC/D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAC3D,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACzD,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,eAAe,CAAC;AACvD,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,OAAO,IAAI,MAAM,EAAE,MAAM,UAAU,CAAC;AAC7C,OAAO,EAAE,OAAO,IAAI,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/composables/toRefs.d.ts

@@ -0,0 +1,18 @@
+import type { MaybeRef, MaybeRefOrGetter, ToRefs } from 'vue';
+export interface ToRefsOptions {
+    /**
+     * Replace the original ref with a copy on property update.
+     *
+     * @default true
+     */
+    replaceRef?: MaybeRefOrGetter<boolean>;
+}
+/**
+ * Extended `toRefs` that also accepts refs of an object.
+ *
+ * @see https://vueuse.org/toRefs
+ * @param objectRef A ref or normal object or array.
+ * @param options Options
+ */
+export default function toRefs<T extends object>(objectRef: MaybeRef<T>, options?: ToRefsOptions): ToRefs<T>;
+//# sourceMappingURL=toRefs.d.ts.map

package/dist/composables/toRefs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toRefs.d.ts","sourceRoot":"","sources":["../../src/composables/toRefs.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,KAAK,CAAA;AAG7D,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,UAAU,CAAC,EAAE,gBAAgB,CAAC,OAAO,CAAC,CAAA;CACvC;AAED;;;;;;GAMG;AACH,MAAM,CAAC,OAAO,UAAU,MAAM,CAAC,CAAC,SAAS,MAAM,EAC7C,SAAS,EAAE,QAAQ,CAAC,CAAC,CAAC,EACtB,OAAO,GAAE,aAAkB,GAC1B,MAAM,CAAC,CAAC,CAAC,CAqCX"}

package/dist/composables/useBackNavigation.d.ts

@@ -0,0 +1,33 @@
+import type { RouteLocationRaw } from 'vue-router';
+/**
+ * @description
+ * A Vue composable that provides intelligent back navigation functionality with smart fallback handling.
+ *
+ * This composable solves the common problem of users getting stuck when there's no browser history
+ * to go back to. It automatically detects if meaningful navigation history exists and either:
+ * - Goes back one step in the browser history if available
+ * - Falls back to the specified route if no history exists
+ *
+ * Perfect for use in breadcrumbs, back buttons, or any navigation component that needs
+ * reliable back functionality.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <v-btn @click="navigateBackOrFallback({ name: 'Dashboard' })">
+ *     <v-icon>mdi-arrow-left</v-icon>
+ *     Back
+ *   </v-btn>
+ * </template>
+ *
+ * <script setup>
+ * import { useBackNavigation } from '@liquidsky/ui'
+ *
+ * const { navigateBackOrFallback } = useBackNavigation()
+ * </script>
+ * ```
+ */
+export default function useBackNavigation(): {
+    navigateBackOrFallback: (fallbackRoute: RouteLocationRaw) => void;
+};
+//# sourceMappingURL=useBackNavigation.d.ts.map

package/dist/composables/useBackNavigation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBackNavigation.d.ts","sourceRoot":"","sources":["../../src/composables/useBackNavigation.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAA;AAElD;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,CAAC,OAAO,UAAU,iBAAiB;4CAcQ,gBAAgB;EAchE"}

package/dist/composables/useClipboard.d.ts

@@ -0,0 +1,48 @@
+import { type Ref } from 'vue';
+interface UseClipboardOptions {
+    duration?: number;
+    legacy?: boolean;
+}
+/**
+ * @description
+ * A Vue composable for copying text to the clipboard with modern Clipboard API support
+ * and legacy fallback for older browsers.
+ *
+ * This composable provides a reactive interface for clipboard operations with:
+ * - Modern Clipboard API support when available
+ * - Legacy fallback using `document.execCommand`for older browsers
+ * - Permission checking for clipboard operations
+ * - Reactive state management for success/error feedback
+ * - Automatic timeout-based state reset
+ *
+ * @param options - Configuration options for the composable
+ * @returns Object containing reactive state and methods for clipboard operations
+ *
+ * @example
+ ```js
+ import { useClipboard } from '@liquidsky/ui'
+  
+ const { copy, copied, error, isSupported } = useClipboard({ duration: 2000 })
+
+  // Copy text to clipboard
+  await copy('Hello World!')
+  
+  // Check if copy was successful
+  if (copied.value) {
+    console.log('Text copied successfully!')
+  }
+  
+  // Handle errors
+  if (error.value) {
+    console.error('Copy failed:', error.value.message)
+  }
+  ```
+ */
+export default function useClipboard(options?: UseClipboardOptions): {
+    copied: Ref<boolean, boolean>;
+    error: Ref<Error | null, Error | null>;
+    copy: (text: string) => Promise<void>;
+    isSupported: import("vue").ComputedRef<boolean | undefined>;
+};
+export {};
+//# sourceMappingURL=useClipboard.d.ts.map

package/dist/composables/useClipboard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useClipboard.d.ts","sourceRoot":"","sources":["../../src/composables/useClipboard.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiB,KAAK,GAAG,EAAE,MAAM,KAAK,CAAA;AAE7C,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,MAAM,CAAC,EAAE,OAAO,CAAA;CACjB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,CAAC,OAAO,UAAU,YAAY,CAAC,OAAO,GAAE,mBAAwB;;;iBAkC1C,MAAM,KAAG,OAAO,CAAC,IAAI,CAAC;;EAuDjD"}

package/dist/composables/useDebounce.d.ts

@@ -0,0 +1,38 @@
+export type DebouncedFunction<TArgs extends any[]> = (...args: TArgs) => void;
+/**
+/**
+ * @description
+ * useDebounce - A composable utility for debouncing function calls in Vue.
+ *
+ * This composable returns a debounced version of the provided function, ensuring that
+ * the function is only executed after a specified period of inactivity (`waitMs`).
+ * Useful for optimizing performance in scenarios such as search input, resize events,
+ * or any situation where you want to limit how often a function is called in response
+ * to rapid, repeated events.
+ *
+ * The returned debounced function is stable (does not change between renders) and
+ * includes a `.cancel()` method to clear any pending invocation.
+ *
+ * @param fn - The function to debounce.
+ * @param waitMs - The number of milliseconds to wait after the last call before invoking `fn`.
+ * @returns A debounced function with a `cancel` method.
+ *
+ * @example
+ * ```ts
+ * import useDebounce from '@liquidsky/ui'
+ *
+ * const debouncedSearch = useDebounce((query) => {
+ *   fetchResults(query)
+ * }, 300)
+ *
+ * // Usage in a component:
+ * debouncedSearch('hello')
+ *
+ * // To cancel a pending call:
+ * debouncedSearch.cancel()
+ * ```
+ */
+export default function useDebounce<TArgs extends any[] = any[]>(fn: (...args: TArgs) => void, waitMs: number): DebouncedFunction<TArgs> & {
+    cancel: () => void;
+};
+//# sourceMappingURL=useDebounce.d.ts.map

package/dist/composables/useDebounce.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDebounce.d.ts","sourceRoot":"","sources":["../../src/composables/useDebounce.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,iBAAiB,CAAC,KAAK,SAAS,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,MAAM,CAAC,OAAO,UAAU,WAAW,CAAC,KAAK,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAC7D,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,KAAK,IAAI,EAC5B,MAAM,EAAE,MAAM;YAIwC,MAAM,IAAI;EAkBjE"}

package/dist/composables/useEmoji.d.ts

@@ -0,0 +1,26 @@
+/**
+/**
+ * @description
+ * A Vue composable providing utility functions for working with emoji characters in strings.
+ *
+ * Features:
+ * - Detects if a string contains any emoji characters.
+ * - Removes all emoji characters from a string.
+ *
+ * Useful for input validation, sanitizing user content, or any scenario where emoji handling is required.
+ *
+ * @example
+ * ```js
+ * import useEmoji from '@liquidsky/ui'
+ *
+ * const { containsEmoji, stripEmojis } = useEmoji()
+ *
+ * containsEmoji('Hello 👋') // true
+ * stripEmojis('Hello 👋 World 🌍!') // 'Hello  World !'
+ * ```
+ */
+export default function useEmoji(): {
+    containsEmoji: (value: string | null | undefined) => boolean;
+    stripEmojis: (value: string | null | undefined) => string;
+};
+//# sourceMappingURL=useEmoji.d.ts.map

package/dist/composables/useEmoji.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEmoji.d.ts","sourceRoot":"","sources":["../../src/composables/useEmoji.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,UAAU,QAAQ;2BAIA,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,OAAO;yBASrC,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM;EAU/D"}

package/dist/composables/useQueryFilters.d.ts

@@ -0,0 +1,52 @@
+import { type Ref } from 'vue';
+export interface FilterLogic {
+    data: Ref<Record<string, any>>;
+    filterData: Ref<Record<string, any>>;
+    appliedFilters: Ref<Record<string, any>>;
+    cancelFilter: (additionalParams?: object) => void;
+    applyFilter: (additionalParams?: object) => void;
+    decompress: (text: any) => string;
+    compress: (text: any) => string;
+}
+/**
+ * @description
+ * A composable function to manage query filters, including synchronization
+ * with Vue Router's query parameters for filtering and clearing filters.
+ *
+ * @returns {FilterLogic} Returns an object with the following properties:
+ * - `data`: Ref<Object> - Reactive object to store filter data
+ * - `filterData`: Ref<Object> - Reactive object to store filter data
+ * - `appliedFilters`: Ref<Object> - Reactive object to store applied filters
+ * - `cancelFilter`: Function - Function to cancel the filter
+ * - `applyFilter`: Function - Function to apply the filter
+ * - `compress`: Function - Function to compress the filter
+ * - `decompress`: Function - Function to decompress the filter
+ *
+ * Basic usage
+ * ```js
+ * import { useQueryFilters } from '@liquidsky/ui'
+ *
+ * const { data, filterData, appliedFilters, cancelFilter, applyFilter, compress, decompress } = useQueryFilters()
+ *
+ * // Use in template
+ * // <input v-model="data.keyword" @keyup.enter="applyFilter" />
+ * ```
+ *
+ * With event handlers
+ * ```js
+ * const { data, filterData, appliedFilters, cancelFilter, applyFilter, compress, decompress } = useQueryFilters()
+ *
+ * // Handle filter application
+ * const handleFilter = () => {
+ *   applyFilter()
+ * }
+ *
+ * // Handle filter cancellation
+ * const handleCancel = () => {
+ *   cancelFilter()
+ * }
+ * ```
+ *
+ */
+export default function useQueryFilters(): FilterLogic;
+//# sourceMappingURL=useQueryFilters.d.ts.map

package/dist/composables/useQueryFilters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useQueryFilters.d.ts","sourceRoot":"","sources":["../../src/composables/useQueryFilters.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,GAAG,EAAY,MAAM,KAAK,CAAA;AAGpD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;IAC9B,UAAU,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;IACpC,cAAc,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAA;IACxC,YAAY,EAAE,CAAC,gBAAgB,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IACjD,WAAW,EAAE,CAAC,gBAAgB,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAChD,UAAU,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAA;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,MAAM,CAAA;CAChC;AAGD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,CAAC,OAAO,UAAU,eAAe,IAAI,WAAW,CAqGrD"}