@resee-movies/nuxt-ux 0.13.1 → 0.15.0

package/dist/runtime/composables/use-two-frame-ref-toggle.d.ts

@@ -0,0 +1,25 @@
+import { type Ref } from 'vue';
+/**
+ * Configuration for the {@link useTwoFrameRefToggle} composable.
+ *
+ * - `direction` (default: "one-way"): The order in which the refs will be updated,
+ *   depending on whether they are being toggled true or false.
+ *   - `"one-way"`: refA -> refB, always.
+ *   - `"reverse"`: refA -> refB, if true. refB -> refA, if false.
+ * - `defaultValue` (default: false): The initial value to set the refs as.
+ */
+type UseTwoFrameRefToggleOptions = {
+    direction?: 'one-way' | 'reverse';
+    defaultValue?: boolean;
+};
+/**
+ * Returns two boolean refs and an `update` method that accepts a boolean that the
+ * refs will be updated to. The setting of the ref values is staggered, with one
+ * happening one re-paint after the first.
+ *
+ * Why? This sort of one-two-step can be very useful in certain scenarios - like
+ * when CSS properties need to be applied in a specific order (e.x. initial state,
+ * and then some kind of transition).
+ */
+export declare function useTwoFrameRefToggle(options?: UseTwoFrameRefToggleOptions): [refA: Ref<boolean>, refB: Ref<boolean>, updateMethod: (value: boolean) => void];
+export {};

package/dist/runtime/composables/use-two-frame-ref-toggle.js

@@ -0,0 +1,24 @@
+import { ref } from "vue";
+export function useTwoFrameRefToggle(options) {
+  const refA = ref(options?.defaultValue ?? false);
+  const refB = ref(options?.defaultValue ?? false);
+  const update = (value) => {
+    if (refA.value === value) {
+      return;
+    }
+    const refOrder = !value && options?.direction === "reverse" ? [refB, refA] : [refA, refB];
+    refOrder[0].value = value;
+    let frameId;
+    if (frameId) {
+      cancelAnimationFrame(frameId);
+      frameId = void 0;
+    }
+    frameId = requestAnimationFrame(() => {
+      frameId = requestAnimationFrame(() => {
+        refOrder[1].value = value;
+        frameId = void 0;
+      });
+    });
+  };
+  return [refA, refB, update];
+}

package/dist/runtime/utils/validation.d.ts

@@ -12,10 +12,10 @@ export type TextInputRequirements = {
     minLength?: string | number;
     maxLength?: string | number;
 };
-export declare function createTextValidator(requirements: TextInputRequirements): z.ZodMiniString<string> | z.ZodMiniUnion<readonly [z.ZodMiniNull, z.ZodMiniString<string>]>;
+export declare function createTextValidator(requirements: TextInputRequirements): z.ZodMiniString<string> | z.ZodMiniUnion<readonly [z.ZodMiniUndefined, z.ZodMiniNull, z.ZodMiniString<string>]>;
 export type ListInputRequirements = {
     required?: boolean;
     minRequired?: string | number;
     maxRequired?: string | number;
 };
-export declare function createListValidator(requirements: ListInputRequirements): z.ZodMiniArray<z.ZodMiniUnknown> | z.ZodMiniUnion<readonly [z.ZodMiniNull, z.ZodMiniArray<z.ZodMiniUnknown>]>;
+export declare function createListValidator(requirements: ListInputRequirements): z.ZodMiniArray<z.ZodMiniUnknown> | z.ZodMiniUnion<readonly [z.ZodMiniUndefined, z.ZodMiniNull, z.ZodMiniArray<z.ZodMiniUnknown>]>;

package/dist/runtime/utils/validation.js

@@ -34,7 +34,7 @@ export function createTextValidator(requirements) {
     }
   }
   const stringSchema = z.string(toValidationError(locale.validation.required)).check(z.trim(), ...checkFns);
-  return requirements.required ? stringSchema : z.union([z.null(), stringSchema]);
+  return requirements.required ? stringSchema : z.union([z.undefined(), z.null(), stringSchema]);
 }
 export function createListValidator(requirements) {
   const { locale } = useReseeUx();
@@ -52,5 +52,5 @@ export function createListValidator(requirements) {
     );
   }
   const arraySchema = z.array(z.unknown(), toValidationError(locale.validation.required)).check(...checkFns);
-  return requirements.required ? arraySchema : z.union([z.null(), arraySchema]);
+  return requirements.required ? arraySchema : z.union([z.undefined(), z.null(), arraySchema]);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resee-movies/nuxt-ux",
-  "version": "0.13.1",
+  "version": "0.15.0",
   "description": "The next-gen user experience library for ReSee Movies - currently in development. ",
   "repository": {
     "url": "https://github.com/ReSee-Movies/nuxt-ux.git"