@ciwergrp/nuxid 1.10.0 → 1.11.0

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@ciwergrp/nuxid",
   "configKey": "nuxid",
-  "version": "1.10.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/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.10.0",
+  "version": "1.11.0",
   "description": "All-in-one essential modules for Nuxt",
   "repository": {
     "type": "git",