@rezi-ui/core 0.1.0-alpha.1

package/dist/forms/validation.d.ts

@@ -0,0 +1,67 @@
+/**
+ * packages/core/src/forms/validation.ts — Form validation utilities.
+ *
+ * Why: Provides validation execution for forms including synchronous validation,
+ * asynchronous validation with debouncing, and field-level validation helpers.
+ *
+ * @see docs/recipes/form-validation.md (GitHub issue #119)
+ */
+import type { ValidationResult } from "./types.js";
+/** Default debounce delay for async validation in milliseconds. */
+export declare const DEFAULT_ASYNC_DEBOUNCE_MS = 300;
+/**
+ * Execute synchronous validation on form values.
+ *
+ * @param values - Current form values
+ * @param validate - Sync validation function
+ * @returns Errors object with field keys and error messages
+ */
+export declare function runSyncValidation<T extends Record<string, unknown>>(values: T, validate: ((values: T) => ValidationResult<T>) | undefined): ValidationResult<T>;
+/**
+ * Execute field-level validation from a form validator.
+ *
+ * @param values - Current form values
+ * @param field - Field to validate
+ * @param validate - Full form validation function
+ * @returns Error message for the field, or undefined if valid
+ */
+export declare function runFieldValidation<T extends Record<string, unknown>>(values: T, field: keyof T, validate: ((values: T) => ValidationResult<T>) | undefined): string | undefined;
+/**
+ * Merge sync and async validation errors.
+ * Async errors take precedence over sync errors for the same field.
+ *
+ * @param syncErrors - Errors from sync validation
+ * @param asyncErrors - Errors from async validation
+ * @returns Merged errors object
+ */
+export declare function mergeValidationErrors<T extends Record<string, unknown>>(syncErrors: ValidationResult<T>, asyncErrors: ValidationResult<T>): ValidationResult<T>;
+/**
+ * Check if validation result has any errors.
+ *
+ * @param errors - Validation errors object
+ * @returns True if there are no errors
+ */
+export declare function isValidationClean<T extends Record<string, unknown>>(errors: ValidationResult<T>): boolean;
+/**
+ * Create a debounced async validation runner.
+ * Returns a function that delays validation execution and cancels pending calls.
+ *
+ * @param validateAsync - Async validation function
+ * @param debounceMs - Debounce delay in milliseconds
+ * @param onResult - Callback when validation completes
+ * @returns Object with run and cancel methods
+ */
+export declare function createDebouncedAsyncValidator<T extends Record<string, unknown>>(validateAsync: (values: T) => Promise<ValidationResult<T>>, debounceMs: number, onResult: (errors: ValidationResult<T>) => void): Readonly<{
+    run: (values: T) => void;
+    cancel: () => void;
+}>;
+/**
+ * Run async validation immediately (without debounce).
+ * Used during form submission.
+ *
+ * @param values - Current form values
+ * @param validateAsync - Async validation function
+ * @returns Promise resolving to errors object
+ */
+export declare function runAsyncValidation<T extends Record<string, unknown>>(values: T, validateAsync: ((values: T) => Promise<ValidationResult<T>>) | undefined): Promise<ValidationResult<T>>;
+//# sourceMappingURL=validation.d.ts.map

package/dist/forms/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/forms/validation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,mEAAmE;AACnE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GACzD,gBAAgB,CAAC,CAAC,CAAC,CAKrB;AAED;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClE,MAAM,EAAE,CAAC,EACT,KAAK,EAAE,MAAM,CAAC,EACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,gBAAgB,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GACzD,MAAM,GAAG,SAAS,CAMpB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrE,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC,EAC/B,WAAW,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC/B,gBAAgB,CAAC,CAAC,CAAC,CAErB;AAED;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjE,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAC1B,OAAO,CAQT;AAED;;;;;;;;GAQG;AACH,wBAAgB,6BAA6B,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7E,aAAa,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,EAC1D,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,KAAK,IAAI,GAC9C,QAAQ,CAAC;IACV,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IACzB,MAAM,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC,CA2CD;AAED;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACxE,MAAM,EAAE,CAAC,EACT,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,SAAS,GACvE,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAW9B"}

package/dist/forms/validation.js

@@ -0,0 +1,135 @@
+/**
+ * packages/core/src/forms/validation.ts — Form validation utilities.
+ *
+ * Why: Provides validation execution for forms including synchronous validation,
+ * asynchronous validation with debouncing, and field-level validation helpers.
+ *
+ * @see docs/recipes/form-validation.md (GitHub issue #119)
+ */
+/** Default debounce delay for async validation in milliseconds. */
+export const DEFAULT_ASYNC_DEBOUNCE_MS = 300;
+/**
+ * Execute synchronous validation on form values.
+ *
+ * @param values - Current form values
+ * @param validate - Sync validation function
+ * @returns Errors object with field keys and error messages
+ */
+export function runSyncValidation(values, validate) {
+    if (!validate) {
+        return {};
+    }
+    return validate(values);
+}
+/**
+ * Execute field-level validation from a form validator.
+ *
+ * @param values - Current form values
+ * @param field - Field to validate
+ * @param validate - Full form validation function
+ * @returns Error message for the field, or undefined if valid
+ */
+export function runFieldValidation(values, field, validate) {
+    if (!validate) {
+        return undefined;
+    }
+    const errors = validate(values);
+    return errors[field];
+}
+/**
+ * Merge sync and async validation errors.
+ * Async errors take precedence over sync errors for the same field.
+ *
+ * @param syncErrors - Errors from sync validation
+ * @param asyncErrors - Errors from async validation
+ * @returns Merged errors object
+ */
+export function mergeValidationErrors(syncErrors, asyncErrors) {
+    return { ...syncErrors, ...asyncErrors };
+}
+/**
+ * Check if validation result has any errors.
+ *
+ * @param errors - Validation errors object
+ * @returns True if there are no errors
+ */
+export function isValidationClean(errors) {
+    const keys = Object.keys(errors);
+    for (const key of keys) {
+        if (errors[key] !== undefined && errors[key] !== "") {
+            return false;
+        }
+    }
+    return true;
+}
+/**
+ * Create a debounced async validation runner.
+ * Returns a function that delays validation execution and cancels pending calls.
+ *
+ * @param validateAsync - Async validation function
+ * @param debounceMs - Debounce delay in milliseconds
+ * @param onResult - Callback when validation completes
+ * @returns Object with run and cancel methods
+ */
+export function createDebouncedAsyncValidator(validateAsync, debounceMs, onResult) {
+    let timeoutId;
+    let cancelled = false;
+    // Monotonic token used to ignore stale debounced callbacks and in-flight promises.
+    let token = 0;
+    return Object.freeze({
+        run(values) {
+            // Cancel any pending validation
+            if (timeoutId !== undefined) {
+                clearTimeout(timeoutId);
+            }
+            cancelled = false;
+            token++;
+            const myToken = token;
+            timeoutId = setTimeout(() => {
+                if (cancelled || myToken !== token)
+                    return;
+                validateAsync(values)
+                    .then((errors) => {
+                    if (!cancelled && myToken === token) {
+                        onResult(errors);
+                    }
+                })
+                    .catch(() => {
+                    // Swallow async validation errors - form remains valid
+                    if (!cancelled && myToken === token) {
+                        onResult({});
+                    }
+                });
+            }, debounceMs);
+        },
+        cancel() {
+            cancelled = true;
+            token++;
+            if (timeoutId !== undefined) {
+                clearTimeout(timeoutId);
+                timeoutId = undefined;
+            }
+        },
+    });
+}
+/**
+ * Run async validation immediately (without debounce).
+ * Used during form submission.
+ *
+ * @param values - Current form values
+ * @param validateAsync - Async validation function
+ * @returns Promise resolving to errors object
+ */
+export async function runAsyncValidation(values, validateAsync) {
+    if (!validateAsync) {
+        return {};
+    }
+    try {
+        return await validateAsync(values);
+    }
+    catch {
+        // Async validation errors are swallowed - form remains valid
+        return {};
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/forms/validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.js","sourceRoot":"","sources":["../../src/forms/validation.ts"],"names":[],"mappings":"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"}

package/dist/icons/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * packages/core/src/icons/index.ts — Icon system exports.
+ */
+export { FILE_ICONS, STATUS_ICONS, ARROW_ICONS, GIT_ICONS, UI_ICONS, SPINNER_FRAMES, icons, resolveIcon, getIconChar, getSpinnerFrame, type IconDefinition, type IconCategory, type IconPath, type FileIconName, type StatusIconName, type ArrowIconName, type GitIconName, type UiIconName, type SpinnerVariant, } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/icons/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEL,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,cAAc,EACd,KAAK,EAEL,WAAW,EACX,WAAW,EACX,eAAe,EAEf,KAAK,cAAc,EACnB,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,YAAY,EACjB,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,cAAc,GACpB,MAAM,eAAe,CAAC"}

package/dist/icons/index.js

@@ -0,0 +1,9 @@
+/**
+ * packages/core/src/icons/index.ts — Icon system exports.
+ */
+export { 
+// Icon definitions
+FILE_ICONS, STATUS_ICONS, ARROW_ICONS, GIT_ICONS, UI_ICONS, SPINNER_FRAMES, icons, 
+// Resolution
+resolveIcon, getIconChar, getSpinnerFrame, } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/icons/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/icons/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO;AACL,mBAAmB;AACnB,UAAU,EACV,YAAY,EACZ,WAAW,EACX,SAAS,EACT,QAAQ,EACR,cAAc,EACd,KAAK;AACL,aAAa;AACb,WAAW,EACX,WAAW,EACX,eAAe,GAWhB,MAAM,eAAe,CAAC"}