@imaginario27/air-ui-utils 1.1.1 → 1.2.1

package/CHANGELOG.md

@@ -0,0 +1,203 @@
+# Changelog
+
+All notable changes to this package are documented in this file.
+
+Historical releases were reconstructed from git history (GitHub repository) and npm publish dates.
+Future releases will include detailed entries generated with Changesets.
+
+## 1.2.0 - 2026-03-18
+
+Release type: minor.
+Commits found in range: 1.
+
+### Changed
+
+1. update dependencies and improve toggles ([a119bf4](https://github.com/imaginario27/air-ui/commit/a119bf4396147b8e24652682ada438744416c0b1))
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.1.1 - 2026-02-18
+
+Release type: minor.
+Commits found in range: 1.
+
+### Added
+
+1. Improves breadcrumbs, fixes tab styling issues and adds new functionalities to tabs an tables. ([6f35018](https://github.com/imaginario27/air-ui/commit/6f35018388a750e726ce95570c77d6b9c05deb8f))
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.14 - 2026-02-09
+
+Release type: patch.
+Commits found in range: 1.
+
+### Added
+
+1. add transitions to dropdowns and modals ([9c837a5](https://github.com/imaginario27/air-ui/commit/9c837a567265118b6607e9633632ed8e7a216fad))
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.13 - 2026-02-06
+
+Release type: patch.
+Commits found in range: 1.
+
+### Added
+
+1. adds missing utils docs pages and fixes general issues ([3f31a47](https://github.com/imaginario27/air-ui/commit/3f31a477d1bb1c04b2065b940093cfa59c6089ae))
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.12 - 2026-02-05
+
+Release type: patch.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.11 - 2026-02-04
+
+Release type: patch.
+Commits found in range: 1.
+
+### Fixed
+
+1. removes export depedencies and jsPDF + bumps package versions ([9139e12](https://github.com/imaginario27/air-ui/commit/9139e1221a00638c4cdb8021006c7276d2ccaed5))
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.10 - 2026-02-02
+
+Release type: patch.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.9 - 2026-02-02
+
+Release type: patch.
+Commits found in range: 1.
+
+### Added
+
+1. Add utils docs pages + Updates components props ([6f65f04](https://github.com/imaginario27/air-ui/commit/6f65f044b0ccc85dcc00f3ba6735232ce957a02b))
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.8 - 2026-01-31
+
+Release type: patch.
+Commits found in range: 4.
+
+### Added
+
+1. Replaces the Nuxt MDI icon module with Nuxt Icon module ([b3343f1](https://github.com/imaginario27/air-ui/commit/b3343f152ee8726f4312059428bec15097b64ce8))
+2. improve getting started pages and UI components ([999f965](https://github.com/imaginario27/air-ui/commit/999f9654e821630af762593dc712d47a46913e35))
+
+### Fixed
+
+1. Fixes packages bump version ([7fe0732](https://github.com/imaginario27/air-ui/commit/7fe0732ec573c05b08c687f802c7c4e5c3a78c24))
+
+### Changed
+
+1. Bumps package version ([0eaefbc](https://github.com/imaginario27/air-ui/commit/0eaefbcbe5fe8cbcf3b6297a80873687a631258b))
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.7 - 2025-12-10
+
+Release type: patch.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.6 - 2025-12-10
+
+Release type: patch.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.5 - 2025-12-09
+
+Release type: patch.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.4 - 2025-12-09
+
+Release type: patch.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.3 - 2025-12-09
+
+Release type: patch.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.2 - 2025-12-07
+
+Release type: patch.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.1 - 2025-12-07
+
+Release type: patch.
+Commits found in range: 1.
+
+### Changed
+
+1. Init ([f153db6](https://github.com/imaginario27/air-ui/commit/f153db6d125daee38fd029ac4bcdb81190893024))
+
+- Package: @imaginario27/air-ui-utils.
+
+## 1.0.0 - 2025-12-05
+
+Release type: initial.
+Commits found in range: 0.
+
+### Changed
+
+1. Historical release reconstructed from npm publish metadata (no package commits found in this publish window).
+
+- Package: @imaginario27/air-ui-utils.
+

package/models/types/formValidation.ts

@@ -0,0 +1,21 @@
+export type RuleValidationValue = string | number | null
+
+export interface RuleValidationItem {
+    item: RuleValidationValue
+    operator: RuleValidationValue
+    value: RuleValidationValue
+}
+
+export type ArrayValidator<T> = (value: T[]) => string | null
+
+/**
+ * Configuration options for the ready-to-use RulesField validator factory.
+ */
+export interface CreateRulesFieldValidatorOptions {
+    required?: boolean
+    requiredFieldMessage?: string
+    incompleteRuleMessage?: string
+    maxRules?: number
+    maxRulesMessage?: string
+    validators?: ArrayValidator<RuleValidationItem>[]
+}

package/models/types/pdfExportTable.ts

@@ -1,6 +1,6 @@
-export interface HeaderConfig {
-    field: string
-    callback?: (value: any) => string
-}
-
+export interface HeaderConfig {
+    field: string
+    callback?: (value: any) => string
+}
+
 export type Headers = Record<string, string | HeaderConfig>

package/nuxt.config.ts

@@ -1,13 +1,13 @@
-// https://nuxt.com/docs/api/configuration/nuxt-config
-
-export default defineNuxtConfig({
-    compatibilityDate: "2024-11-01",
-    devtools: { enabled: false },
-    ssr: false,
-
-    imports: {
-        dirs: [
-            "models/**"
-        ],
-    },
+// https://nuxt.com/docs/api/configuration/nuxt-config
+
+export default defineNuxtConfig({
+    compatibilityDate: "2024-11-01",
+    devtools: { enabled: false },
+    ssr: false,
+
+    imports: {
+        dirs: [
+            "models/**"
+        ],
+    },
 })

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@imaginario27/air-ui-utils",
-    "version": "1.1.1",
+    "version": "1.2.1",
     "author": "imaginario27",
     "type": "module",
     "homepage": "https://air-ui.netlify.app/",
@@ -21,17 +21,17 @@
         "typecheck": "vue-tsc --noEmit -p tsconfig.typecheck.json"
     },
     "dependencies": {
-        "nuxt": "4.3.1",
-        "vue": "3.5.28",
-        "vue-router": "5.0.2"
+        "nuxt": "4.4.2",
+        "vue": "3.5.30",
+        "vue-router": "5.0.4"
     },
     "devDependencies": {
         "@nuxt/test-utils": "4.0.0",
-        "@vitest/coverage-v8": "4.0.18",
-        "happy-dom": "20.6.2",
+        "@vitest/coverage-v8": "4.1.0",
+        "happy-dom": "20.8.4",
         "prettier": "3.8.1",
         "ts-node": "10.9.2",
         "typescript": "5.9.3",
-        "vitest": "4.0.18"
+        "vitest": "4.1.0"
     }
 }

package/tsconfig.json

@@ -1,7 +1,7 @@
-{
-    // https://nuxt.com/docs/guide/concepts/typescript
-    "extends": "./.nuxt/tsconfig.json",
-    "compilerOptions": {
-        "types": ["vitest/globals"],
-    }
-}
+{
+    // https://nuxt.com/docs/guide/concepts/typescript
+    "extends": "./.nuxt/tsconfig.json",
+    "compilerOptions": {
+        "types": ["vitest/globals"],
+    }
+}

package/utils/formValidation.ts

@@ -1,4 +1,12 @@
 
+import { FieldError } from '../models/constants/form'
+import type {
+    ArrayValidator,
+    CreateRulesFieldValidatorOptions,
+    RuleValidationItem,
+    RuleValidationValue,
+} from '../models/types/formValidation'
+
 /**
  * Validates a field value to ensure it is not empty, null, or undefined.
  *
@@ -102,7 +110,7 @@ export const validateDateRange = (
     const start = new Date(startDate)
     const end = new Date(endDate)
 
-    if (isNaN(start.getTime()) || isNaN(end.getTime()) || start > end) {
+    if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime()) || start > end) {
         return invalidRangeMessage
     }
 
@@ -197,3 +205,160 @@ export const validateArrayField = (
 
     return null
 }
+
+/**
+ * Composes multiple array validators into a single validator function.
+ *
+ * Validators run in order and validation stops at the first error found.
+ *
+ * @typeParam T - Item type in the validated array.
+ * @param validators - List of validators to execute sequentially.
+ * @returns A validator function that returns the first error message, or null if all validators pass.
+ */
+export const composeArrayValidators = <T>(
+    validators: ArrayValidator<T>[],
+): ArrayValidator<T> => {
+    return (value: T[]) => {
+        for (const validator of validators) {
+            const error = validator(value)
+            if (error) {
+                return error
+            }
+        }
+
+        return null
+    }
+}
+
+/**
+ * Validates that the array contains at least one complete rule.
+ *
+ * A rule is considered complete when item, operator, and value are all present.
+ *
+ * @param value - Rules array to validate.
+ * @param requiredFieldMessage - Optional custom message returned when no complete rule exists.
+ * @returns Validation error message or null.
+ */
+export const validateAtLeastOneRule = (
+    value: RuleValidationItem[],
+    requiredFieldMessage = 'Add at least one complete rule.',
+): string | null => {
+    const hasCompleteRule = value.some(rule => isRuleComplete(rule))
+
+    if (!hasCompleteRule) {
+        return requiredFieldMessage
+    }
+
+    return null
+}
+
+/**
+ * Validates that no rule is partially filled.
+ *
+ * Empty rows are allowed. Rows with some data must be fully complete.
+ *
+ * @param value - Rules array to validate.
+ * @param incompleteRuleMessage - Optional custom message returned when incomplete rows are found.
+ * @returns Validation error message or null.
+ */
+export const validateRuleCompleteness = (
+    value: RuleValidationItem[],
+    incompleteRuleMessage = 'Complete all rule fields before continuing.',
+): string | null => {
+    const hasIncompleteRule = value.some(rule => !isRuleEmpty(rule) && !isRuleComplete(rule))
+
+    if (hasIncompleteRule) {
+        return incompleteRuleMessage
+    }
+
+    return null
+}
+
+/**
+ * Validates that the number of rules does not exceed the specified limit.
+ *
+ * @param value - Rules array to validate.
+ * @param maxRules - Maximum number of allowed rules.
+ * @param maxRulesMessage - Optional custom message returned when max is exceeded.
+ * @returns Validation error message or null.
+ */
+export const validateMaxRules = (
+    value: RuleValidationItem[],
+    maxRules: number,
+    maxRulesMessage?: string,
+): string | null => {
+    const normalizedMax = Math.floor(maxRules)
+    if (normalizedMax <= 0) {
+        return null
+    }
+
+    if (value.length > normalizedMax) {
+        return maxRulesMessage ?? `No more than ${normalizedMax} rule${normalizedMax > 1 ? 's' : ''} allowed.`
+    }
+
+    return null
+}
+
+/**
+ * Creates a ready-to-use validator function for RulesField values.
+ *
+ * By default, this validator:
+ * 1) Rejects incomplete rows
+ * 2) Requires at least one complete row
+ *
+ * You can add extra custom validators that run after the built-in checks.
+ *
+ * @param options - Validation behavior options.
+ * @param options.required - Whether at least one complete rule is required.
+ * @param options.requiredFieldMessage - Custom message for missing complete rules.
+ * @param options.incompleteRuleMessage - Custom message for incomplete rows.
+ * @param options.validators - Additional custom validators.
+ * @returns A validator compatible with form field validator APIs.
+ */
+export const createRulesFieldValidator = (
+    options: CreateRulesFieldValidatorOptions = {},
+): ArrayValidator<RuleValidationItem> => {
+    const {
+        required = true,
+        requiredFieldMessage,
+        incompleteRuleMessage,
+        maxRules,
+        maxRulesMessage,
+        validators = [],
+    } = options
+
+    const baseValidators: ArrayValidator<RuleValidationItem>[] = []
+
+    if (incompleteRuleMessage) {
+        baseValidators.push(value => validateRuleCompleteness(value, incompleteRuleMessage))
+    } else {
+        baseValidators.push(validateRuleCompleteness)
+    }
+
+    if (required) {
+        baseValidators.push(value => validateAtLeastOneRule(value, requiredFieldMessage))
+    }
+
+    if (typeof maxRules === 'number') {
+        baseValidators.push(value => validateMaxRules(value, maxRules, maxRulesMessage))
+    }
+
+    return composeArrayValidators([...baseValidators, ...validators])
+}
+
+// Helper functions for rule validation
+const hasValue = (value: RuleValidationValue): boolean => {
+    if (typeof value === 'string') {
+        return value.trim() !== ''
+    }
+
+    return value !== null
+}
+
+const isRuleEmpty = (rule: RuleValidationItem): boolean => {
+    return !hasValue(rule.item) && !hasValue(rule.operator) && !hasValue(rule.value)
+}
+
+const isRuleComplete = (rule: RuleValidationItem): boolean => {
+    return hasValue(rule.item) && hasValue(rule.operator) && hasValue(rule.value)
+}