@ciwergrp/nuxid 1.9.0 → 1.11.0

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@ciwergrp/nuxid",
   "configKey": "nuxid",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "builder": {
     "@nuxt/module-builder": "1.0.2",
     "unbuild": "3.6.1"

package/dist/runtime/helper/date/format.d.ts

@@ -1,33 +1,7 @@
 import type { FormatDistanceOptions, FormatDistanceToNowOptions, FormatISOOptions, FormatOptions, FormatRFC3339Options } from 'date-fns';
 import type { DateInput } from './input.js';
-declare const formatAliases: {
-    readonly 'YYYY-MM-DD': "yyyy-MM-dd";
-    readonly 'YYYY-MM-DD HH:mm': "yyyy-MM-dd HH:mm";
-    readonly 'YYYY-MM-DD HH:mm:ss': "yyyy-MM-dd HH:mm:ss";
-    readonly 'YYYY-MM-DD HH:mm:ss.SSS': "yyyy-MM-dd HH:mm:ss.SSS";
-    readonly 'YYYY-MM-DD HH:mm:ssZ': "yyyy-MM-dd HH:mm:ssXXX";
-    readonly 'YYYY-MM-DD HH:mm:ss.SSSZ': "yyyy-MM-dd HH:mm:ss.SSSXXX";
-    readonly 'YYYY/MM/DD': "yyyy/MM/dd";
-    readonly 'YYYY/MM/DD HH:mm': "yyyy/MM/dd HH:mm";
-    readonly 'YYYY/MM/DD HH:mm:ss': "yyyy/MM/dd HH:mm:ss";
-    readonly 'DD/MM/YYYY': "dd/MM/yyyy";
-    readonly 'MM/DD/YYYY': "MM/dd/yyyy";
-    readonly 'DD-MM-YYYY': "dd-MM-yyyy";
-    readonly 'MM-DD-YYYY': "MM-dd-yyyy";
-    readonly 'YYYY-MM': "yyyy-MM";
-    readonly 'YYYY/MM': "yyyy/MM";
-    readonly YYYY: "yyyy";
-    readonly 'DD MMM YYYY': "dd MMM yyyy";
-    readonly 'MMM DD, YYYY': "MMM dd, yyyy";
-    readonly 'HH:mm': "HH:mm";
-    readonly 'HH:mm:ss': "HH:mm:ss";
-    readonly 'HH:mm:ss.SSS': "HH:mm:ss.SSS";
-    readonly 'hh:mm A': "hh:mm a";
-    readonly 'hh:mm:ss A': "hh:mm:ss a";
-};
-export type DateFormatPreset = keyof typeof formatAliases;
-export type DateFormatInput = DateFormatPreset | (string & {});
-export declare function resolveFormatString(formatString: DateFormatInput): "yyyy-MM-dd" | "yyyy-MM-dd HH:mm" | "yyyy-MM-dd HH:mm:ss" | "yyyy-MM-dd HH:mm:ss.SSS" | "yyyy-MM-dd HH:mm:ssXXX" | "yyyy-MM-dd HH:mm:ss.SSSXXX" | "yyyy/MM/dd" | "yyyy/MM/dd HH:mm" | "yyyy/MM/dd HH:mm:ss" | "dd/MM/yyyy" | "MM/dd/yyyy" | "dd-MM-yyyy" | "MM-dd-yyyy" | "yyyy-MM" | "yyyy/MM" | "yyyy" | "dd MMM yyyy" | "MMM dd, yyyy" | "HH:mm" | "HH:mm:ss" | "HH:mm:ss.SSS" | "hh:mm a" | "hh:mm:ss a";
+export type DateFormatPreset = string;
+export type DateFormatInput = string;
 export declare function format(date: DateInput, formatString: DateFormatInput, options?: FormatOptions): string;
 export declare function formatISO(date: DateInput, options?: FormatISOOptions): string;
 export declare function formatRFC3339(date: DateInput, options?: FormatRFC3339Options): string;
@@ -40,4 +14,3 @@ export declare function toDateTimeString(date: DateInput): string;
 export declare function toIsoString(date: DateInput): string;
 export declare function toRfc3339String(date: DateInput): string;
 export declare function toRfc7231String(date: DateInput): string;
-export {};

package/dist/runtime/helper/date/format.js

@@ -7,36 +7,8 @@ import {
   formatRFC7231 as formatRFC7231Date
 } from "date-fns";
 import { toDate } from "./input.js";
-const formatAliases = {
-  "YYYY-MM-DD": "yyyy-MM-dd",
-  "YYYY-MM-DD HH:mm": "yyyy-MM-dd HH:mm",
-  "YYYY-MM-DD HH:mm:ss": "yyyy-MM-dd HH:mm:ss",
-  "YYYY-MM-DD HH:mm:ss.SSS": "yyyy-MM-dd HH:mm:ss.SSS",
-  "YYYY-MM-DD HH:mm:ssZ": "yyyy-MM-dd HH:mm:ssXXX",
-  "YYYY-MM-DD HH:mm:ss.SSSZ": "yyyy-MM-dd HH:mm:ss.SSSXXX",
-  "YYYY/MM/DD": "yyyy/MM/dd",
-  "YYYY/MM/DD HH:mm": "yyyy/MM/dd HH:mm",
-  "YYYY/MM/DD HH:mm:ss": "yyyy/MM/dd HH:mm:ss",
-  "DD/MM/YYYY": "dd/MM/yyyy",
-  "MM/DD/YYYY": "MM/dd/yyyy",
-  "DD-MM-YYYY": "dd-MM-yyyy",
-  "MM-DD-YYYY": "MM-dd-yyyy",
-  "YYYY-MM": "yyyy-MM",
-  "YYYY/MM": "yyyy/MM",
-  "YYYY": "yyyy",
-  "DD MMM YYYY": "dd MMM yyyy",
-  "MMM DD, YYYY": "MMM dd, yyyy",
-  "HH:mm": "HH:mm",
-  "HH:mm:ss": "HH:mm:ss",
-  "HH:mm:ss.SSS": "HH:mm:ss.SSS",
-  "hh:mm A": "hh:mm a",
-  "hh:mm:ss A": "hh:mm:ss a"
-};
-export function resolveFormatString(formatString) {
-  return formatAliases[formatString] ?? formatString;
-}
 export function format(date, formatString, options) {
-  return formatDate(toDate(date), resolveFormatString(formatString), options);
+  return formatDate(toDate(date), formatString, options);
 }
 export function formatISO(date, options) {
   return formatISODate(toDate(date), options);

package/dist/runtime/helper/date/parse.js

@@ -1,8 +1,7 @@
 import { parse as parseDate, parseISO as parseISODate } from "date-fns";
-import { resolveFormatString } from "./format.js";
 import { toDate } from "./input.js";
 export function parse(value, formatString, baseDate = /* @__PURE__ */ new Date(), options) {
-  return parseDate(value, resolveFormatString(formatString), toDate(baseDate), options);
+  return parseDate(value, formatString, toDate(baseDate), options);
 }
 export function parseISO(value) {
   return parseISODate(value);

package/dist/runtime/validator.d.ts

@@ -1,5 +1,5 @@
 import type { FormRules } from 'element-plus';
-export type ValidationRule = 'required' | 'time' | 'string' | 'nullable' | 'email' | 'accepted' | `accepted_if:${string}` | 'boolean' | 'filled' | 'present' | `required_if:${string}` | `required_unless:${string}` | `required_with:${string}` | `required_with_all:${string}` | `required_without:${string}` | `required_without_all:${string}` | 'prohibited' | `prohibited_if:${string}` | `prohibited_unless:${string}` | `prohibits:${string}` | `min:${number}` | `max:${number}` | `between:${number},${number}` | `size:${number}` | `same:${string}` | 'alpha' | 'alpha_num' | 'alpha_dash' | 'alphanumeric_space' | 'alpha_space' | 'numeric' | 'integer' | 'confirmed' | `digits:${number}` | `digits_between:${number},${number}` | 'bail' | `different:${string}` | `gt:${string}` | `gte:${string}` | `lt:${string}` | `lte:${string}` | `starts_with:${string}` | `ends_with:${string}` | `regex:${string}` | `date_format:${string}` | 'date' | `before:${string}` | `after:${string}` | `before_or_equal:${string}` | `after_or_equal:${string}` | 'array' | 'distinct' | `in_array:${string}` | `required_array_keys:${string}` | 'list' | 'url' | 'ip' | 'hex_color' | `in:${string}` | `multiple_of:${number}` | `decimal:${number}` | `decimal:${number},${number}` | 'lowercase' | 'uppercase' | 'uuid' | 'ulid' | `timezone:${string}` | 'timezone';
+export type ValidationRule = 'required' | 'time' | 'datetime' | 'string' | 'nullable' | 'email' | 'accepted' | `accepted_if:${string}` | 'boolean' | 'filled' | 'present' | `required_if:${string}` | `required_unless:${string}` | `required_with:${string}` | `required_with_all:${string}` | `required_without:${string}` | `required_without_all:${string}` | 'prohibited' | `prohibited_if:${string}` | `prohibited_unless:${string}` | `prohibits:${string}` | `min:${number}` | `max:${number}` | `between:${number},${number}` | `size:${number}` | `same:${string}` | 'alpha' | 'alpha_num' | 'alpha_dash' | 'alphanumeric_space' | 'alpha_space' | 'numeric' | 'integer' | 'confirmed' | `digits:${number}` | `digits_between:${number},${number}` | 'bail' | `different:${string}` | `gt:${string}` | `gte:${string}` | `lt:${string}` | `lte:${string}` | `starts_with:${string}` | `ends_with:${string}` | `regex:${string}` | `date_format:${string}` | 'date' | `before:${string}` | `after:${string}` | `before_or_equal:${string}` | `after_or_equal:${string}` | 'array' | 'distinct' | `in_array:${string}` | `required_array_keys:${string}` | 'list' | 'url' | 'ip' | 'hex_color' | `in:${string}` | `multiple_of:${number}` | `decimal:${number}` | `decimal:${number},${number}` | 'lowercase' | 'uppercase' | 'uuid' | 'ulid' | `timezone:${string}` | 'timezone';
 export interface ValidationOptions {
     messages?: Record<string, string>;
     attributes?: Record<string, string>;

package/dist/runtime/validator.js

@@ -84,17 +84,43 @@ const isAcceptedValue = (value) => {
 const isBooleanValue = (value) => {
   return value === true || value === false || value === 0 || value === 1 || value === "0" || value === "1";
 };
-const parseTimeToMinutes = (value) => {
+const parseTimeToComparable = (value) => {
   if (typeof value !== "string") {
     return null;
   }
-  const match = value.match(/^([01]\d|2[0-3]):([0-5]\d)$/);
+  const match = value.match(
+    /^([01]\d|2[0-3]):([0-5]\d)(?::([0-5]\d)(?:\.(\d{1,3}))?)?(?:(z)|([+-])([01]\d|2[0-3]):?([0-5]\d))?$/i
+  );
   if (!match) {
     return null;
   }
   const hours = Number(match[1]);
   const minutes = Number(match[2]);
-  return hours * 60 + minutes;
+  const seconds = match[3] ? Number(match[3]) : 0;
+  const milliseconds = match[4] ? Number(match[4].padEnd(3, "0")) : 0;
+  const hasZuluOffset = Boolean(match[5]);
+  const offsetSign = match[6];
+  const offsetHours = match[7] ? Number(match[7]) : 0;
+  const offsetMinutes = match[8] ? Number(match[8]) : 0;
+  const localComparableValue = hours * 36e5 + minutes * 6e4 + seconds * 1e3 + milliseconds;
+  if (hasZuluOffset) {
+    return {
+      comparableValue: localComparableValue,
+      hasOffset: true
+    };
+  }
+  if (offsetSign) {
+    const offsetComparable = (offsetHours * 60 + offsetMinutes) * 6e4;
+    const direction = offsetSign === "+" ? 1 : -1;
+    return {
+      comparableValue: localComparableValue - direction * offsetComparable,
+      hasOffset: true
+    };
+  }
+  return {
+    comparableValue: localComparableValue,
+    hasOffset: false
+  };
 };
 const parseDateToTimestamp = (value) => {
   if (typeof value !== "string") {
@@ -109,14 +135,53 @@ const parseDateToTimestamp = (value) => {
   }
   return date.getTime();
 };
+const parseDateTimeToTimestamp = (value) => {
+  if (typeof value !== "string") {
+    return null;
+  }
+  const match = value.match(
+    /^(\d{4})-(\d{2})-(\d{2})[T ]([01]\d|2[0-3]):([0-5]\d)(?::([0-5]\d)(?:\.(\d{1,3}))?)?(?:([zZ])|([+-])([01]\d|2[0-3]):?([0-5]\d))?$/
+  );
+  if (!match) {
+    return null;
+  }
+  const year = Number(match[1]);
+  const month = Number(match[2]);
+  const day = Number(match[3]);
+  const hours = Number(match[4]);
+  const minutes = Number(match[5]);
+  const seconds = match[6] ? Number(match[6]) : 0;
+  const milliseconds = match[7] ? Number(match[7].padEnd(3, "0")) : 0;
+  const utcCandidate = Date.UTC(year, month - 1, day, hours, minutes, seconds, milliseconds);
+  const utcDate = new Date(utcCandidate);
+  if (utcDate.getUTCFullYear() !== year || utcDate.getUTCMonth() !== month - 1 || utcDate.getUTCDate() !== day || utcDate.getUTCHours() !== hours || utcDate.getUTCMinutes() !== minutes || utcDate.getUTCSeconds() !== seconds || utcDate.getUTCMilliseconds() !== milliseconds) {
+    return null;
+  }
+  const hasZuluOffset = Boolean(match[8]);
+  const offsetSign = match[9];
+  const offsetHour = match[10] ? Number(match[10]) : 0;
+  const offsetMinute = match[11] ? Number(match[11]) : 0;
+  if (hasZuluOffset) {
+    return utcCandidate;
+  }
+  if (offsetSign) {
+    const totalOffsetMinutes = offsetHour * 60 + offsetMinute;
+    const direction = offsetSign === "+" ? 1 : -1;
+    return utcCandidate - direction * totalOffsetMinutes * 6e4;
+  }
+  return utcCandidate;
+};
 const compareFieldValues = (left, right, compare) => {
-  const leftTime = parseTimeToMinutes(left);
-  const rightTime = parseTimeToMinutes(right);
+  const leftTime = parseTimeToComparable(left);
+  const rightTime = parseTimeToComparable(right);
   if (leftTime !== null || rightTime !== null) {
     if (leftTime === null || rightTime === null) {
       return false;
     }
-    return compare(leftTime, rightTime);
+    if (leftTime.hasOffset !== rightTime.hasOffset) {
+      return false;
+    }
+    return compare(leftTime.comparableValue, rightTime.comparableValue);
   }
   const leftDate = parseDateToTimestamp(left);
   const rightDate = parseDateToTimestamp(right);
@@ -126,6 +191,14 @@ const compareFieldValues = (left, right, compare) => {
     }
     return compare(leftDate, rightDate);
   }
+  const leftDateTime = parseDateTimeToTimestamp(left);
+  const rightDateTime = parseDateTimeToTimestamp(right);
+  if (leftDateTime !== null || rightDateTime !== null) {
+    if (leftDateTime === null || rightDateTime === null) {
+      return false;
+    }
+    return compare(leftDateTime, rightDateTime);
+  }
   const leftNumber = Number(left);
   const rightNumber = Number(right);
   if (Number.isNaN(leftNumber) || Number.isNaN(rightNumber)) {
@@ -173,7 +246,7 @@ const createTimeValidator = (message) => {
     if (isEmptyValue(value)) {
       return callback();
     }
-    if (parseTimeToMinutes(value) === null) {
+    if (parseTimeToComparable(value) === null) {
       return callback(new Error(message));
     }
     callback();
@@ -232,6 +305,17 @@ const createDateValidator = (message) => {
     callback();
   };
 };
+const createDateTimeValidator = (message) => {
+  return (_rule, value, callback) => {
+    if (isEmptyValue(value)) {
+      return callback();
+    }
+    if (parseDateTimeToTimestamp(value) === null) {
+      return callback(new Error(message));
+    }
+    callback();
+  };
+};
 const createDateComparisonValidator = (compareDate, message, compare) => {
   return (_rule, value, callback) => {
     if (!value) {
@@ -665,7 +749,7 @@ export const createValidationRules = (definitions, formState, options = {}) => {
           break;
         case "time":
           fieldRules.push({
-            validator: createTimeValidator(getMessage(fieldName, "time", `${attributeName} must be a valid time in HH:mm format`)),
+            validator: createTimeValidator(getMessage(fieldName, "time", `${attributeName} must be a valid time`)),
             trigger: pickTrigger(fieldName, "blur")
           });
           break;
@@ -784,6 +868,12 @@ export const createValidationRules = (definitions, formState, options = {}) => {
             trigger: pickTrigger(fieldName, "blur")
           });
           break;
+        case "datetime":
+          fieldRules.push({
+            validator: createDateTimeValidator(getMessage(fieldName, "datetime", `${attributeName} must be a valid datetime`)),
+            trigger: pickTrigger(fieldName, "blur")
+          });
+          break;
         case "before":
           if (!firstParam) {
             return;

package/docs/.docs/form-validation/create-validation-rules.md

@@ -62,6 +62,17 @@ const definitions = {
 
 Optional configuration for messages, attributes, and hooks.
 
+## Date and Time Comparison Behavior
+
+Rules `gt`, `gte`, `lt`, and `lte` use type-aware parsing:
+
+- `time` (supports `HH:mm`, optional seconds/milliseconds, optional `Z`/offset)
+- `date` (`YYYY-MM-DD`)
+- `datetime` (date + time, optional `Z`/offset)
+- numeric fallback
+
+For `time`, offset-aware and non-offset values cannot be mixed in one comparison.
+
 ### options.messages
 - Summary: Custom error messages for specific rule keys.
 - Technique: Lookup key format is `{field}.{rule}`.

package/docs/.docs/form-validation/quick-start.md

@@ -64,4 +64,18 @@ const rules = createValidationRules(
 )
 ```
 
+## Time and Datetime Example
+
+```ts
+const rules = createValidationRules(
+  {
+    start_time: ['required', 'time'],
+    end_time: ['required', 'time', 'gte:start_time'],
+    starts_at: ['required', 'datetime'],
+    ends_at: ['required', 'datetime', 'gte:starts_at'],
+  },
+  form,
+)
+```
+
 See the full list of supported rules on the [Available Rules](/form-validation/rules) page.

package/docs/.docs/form-validation/rules.md

@@ -237,6 +237,42 @@ Notes:
 - Use: `'digits_between:6,8'`
 - Example: `['digits_between:6,8']`
 
+### time
+- Summary: Must be a valid time string.
+- Technique: Supports strict `HH:mm`, optional seconds/milliseconds, and optional timezone offset.
+- Use: `'time'`
+- Example: `['time']`
+- Supported formats:
+  - `HH:mm`
+  - `HH:mm:ss`
+  - `HH:mm:ss.SSS`
+  - `HH:mmZ`
+  - `HH:mm:ssZ`
+  - `HH:mm:ss.SSSZ`
+  - `HH:mm±HHmm`
+  - `HH:mm:ss±HHmm`
+  - `HH:mm:ss.SSS±HHmm`
+- Offset notes:
+  - `Z` means UTC (example: `09:30Z`).
+  - `±HH:MM` and `±HHmm` are both accepted (examples: `+07:00`, `-0530`).
+
+### datetime
+- Summary: Must be a valid datetime string.
+- Technique: Strict date + time parser with optional timezone offset.
+- Use: `'datetime'`
+- Example: `['datetime']`
+- Supported formats:
+  - `YYYY-MM-DDTHH:mm`
+  - `YYYY-MM-DD HH:mm`
+  - `YYYY-MM-DDTHH:mm:ss`
+  - `YYYY-MM-DD HH:mm:ss`
+  - `YYYY-MM-DDTHH:mm:ss.SSS`
+  - `YYYY-MM-DD HH:mm:ss.SSS`
+- Datetime timezone suffix (optional for each format):
+  - `Z`
+  - `±HH:MM`
+  - `±HHmm`
+
 ### bail
 - Summary: Placeholder (no-op).
 - Technique: No behavior; included for parity.
@@ -245,27 +281,29 @@ Notes:
 
 ### gt:field
 - Summary: Must be greater than another field.
-- Technique: Numeric comparison via `Number`.
+- Technique: Type-aware comparison in this order: `time` -> `date` (`YYYY-MM-DD`) -> `datetime` -> numeric.
 - Use: `'gt:other'`
 - Example: `['gt:other']`
 
 ### gte:field
 - Summary: Must be greater than or equal to another field.
-- Technique: Numeric comparison via `Number`.
+- Technique: Type-aware comparison in this order: `time` -> `date` (`YYYY-MM-DD`) -> `datetime` -> numeric.
 - Use: `'gte:other'`
 - Example: `['gte:other']`
 
 ### lt:field
 - Summary: Must be less than another field.
-- Technique: Numeric comparison via `Number`.
+- Technique: Type-aware comparison in this order: `time` -> `date` (`YYYY-MM-DD`) -> `datetime` -> numeric.
 - Use: `'lt:other'`
 - Example: `['lt:other']`
 
 ### lte:field
 - Summary: Must be less than or equal to another field.
-- Technique: Numeric comparison via `Number`.
+- Technique: Type-aware comparison in this order: `time` -> `date` (`YYYY-MM-DD`) -> `datetime` -> numeric.
 - Use: `'lte:other'`
 - Example: `['lte:other']`
+- Comparison notes:
+  - For `time`, comparing offset-aware values against non-offset values fails (both sides must either include offset or not).
 
 ### starts_with:a,b,c
 - Summary: Must start with any of the given prefixes.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ciwergrp/nuxid",
-  "version": "1.9.0",
+  "version": "1.11.0",
   "description": "All-in-one essential modules for Nuxt",
   "repository": {
     "type": "git",