@resee-movies/nuxt-ux 0.4.0 → 0.5.0

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

@@ -0,0 +1,34 @@
+import type { FormFieldState } from '@primevue/forms';
+import { type InjectionKey } from 'vue';
+import type { FormInstance, FormValues } from '../types/form.js';
+/**
+ * The injection key for acquiring a {@link FormInstance} object within the
+ * descendant component of a Form. Consider using {@link injectFormInstance}
+ * instead.
+ */
+export declare const FormSymbol: InjectionKey<FormInstance>;
+/**
+ * Helper method to create a new stateful object for a Form. You shouldn't ever
+ * need to use this directly.
+ *
+ * @private
+ */
+export declare function createFormInstance(): FormInstance;
+/**
+ * Provides the object that a Form uses to convey stateful information to the
+ * DI registry. You shouldn't ever need to use this directly.
+ *
+ * @private
+ */
+export declare function provideFormInstance(): FormInstance;
+/**
+ * Injects the stateful object provided by an ancestor Form instance. If not
+ * available, a dummy state object is generated.
+ */
+export declare function injectFormInstance(): FormInstance;
+/**
+ * Takes a Primevue Form's `states` object, and extracts the current values
+ * of each named property. In doing so, it will deref proxies, and create
+ * shallow clones of any arrays/objects it encounters.
+ */
+export declare function getValuesFromFormState<T extends FormValues = FormValues>(state: Record<string, FormFieldState>): T;

package/dist/runtime/utils/form.js

@@ -0,0 +1,34 @@
+import { isObjectLike } from "@resee-movies/utilities/objects/is-object-like";
+import { inject, provide, ref, toRaw, toValue } from "vue";
+export const FormSymbol = Symbol("form");
+export function createFormInstance() {
+  return {
+    hasSubmitted: ref(false),
+    isSubmitting: ref(false),
+    isDisabled: ref(false)
+  };
+}
+export function provideFormInstance() {
+  const instance = createFormInstance();
+  provide(FormSymbol, instance);
+  return instance;
+}
+export function injectFormInstance() {
+  return inject(FormSymbol, () => createFormInstance(), true);
+}
+export function getValuesFromFormState(state) {
+  const result = {};
+  for (const [key, value] of Object.entries(state)) {
+    const rawValue = toRaw(toValue(value.value));
+    let processed;
+    if (Array.isArray(rawValue)) {
+      processed = Array.from(rawValue);
+    } else if (isObjectLike(rawValue)) {
+      processed = { ...rawValue };
+    } else {
+      processed = rawValue;
+    }
+    Object.defineProperty(result, key, { value: processed, enumerable: true });
+  }
+  return result;
+}

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

@@ -0,0 +1,6 @@
+/**
+ * Takes a string and replaces all substrings which match the form `{PROPERTY}`,
+ * where "PROPERTY" is a key of the provided `placeholders` object, with the value
+ * at that key.
+ */
+export declare function swapStringPlaceholders(target: string, placeholders?: Record<string, unknown>): string;

package/dist/runtime/utils/string.js

@@ -0,0 +1,3 @@
+export function swapStringPlaceholders(target, placeholders) {
+  return placeholders ? target.replace(/\{\s*(\w+?)\s*}/g, (_, token) => String(placeholders[token] || "")) : target;
+}

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

@@ -0,0 +1,21 @@
+import * as z from 'zod/mini';
+export declare function toValidationError(str: string, placeholders?: Record<string, string | number>): {
+    error: string;
+};
+export type BooleanInputRequirements = {
+    required?: boolean;
+};
+export declare function createBooleanValidator(requirements: BooleanInputRequirements): z.ZodMiniBoolean<unknown> | undefined;
+export type TextInputRequirements = {
+    required?: boolean;
+    type?: 'text' | 'email' | 'url';
+    minLength?: string | number;
+    maxLength?: string | number;
+};
+export declare function createTextValidator(requirements: TextInputRequirements): z.ZodMiniString<string> | z.ZodMiniUnion<readonly [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>]>;

package/dist/runtime/utils/validation.js

@@ -0,0 +1,56 @@
+import { toInteger } from "@resee-movies/utilities/numbers/to-integer";
+import * as z from "zod/mini";
+import { useReseeUx } from "../composables/use-resee-ux.js";
+import { swapStringPlaceholders } from "./string.js";
+export function toValidationError(str, placeholders) {
+  return { error: swapStringPlaceholders(str, placeholders) };
+}
+export function createBooleanValidator(requirements) {
+  const { locale } = useReseeUx();
+  return requirements.required ? z.coerce.boolean().check(z.refine((val) => val === true, toValidationError(locale.validation.required))) : void 0;
+}
+export function createTextValidator(requirements) {
+  const { locale } = useReseeUx();
+  const checkFns = [];
+  if (requirements.required) {
+    checkFns.push(z.minLength(1, toValidationError(locale.validation.required)));
+  }
+  if (requirements.type === "email") {
+    checkFns.push(z.email(toValidationError(locale.validation.invalidEmail)));
+  } else if (requirements.type === "url") {
+    checkFns.push(z.url(toValidationError(locale.validation.invalidUrl)));
+  } else {
+    const minLength = toInteger(requirements.minLength);
+    const maxLength = toInteger(requirements.maxLength);
+    if (minLength) {
+      checkFns.push(
+        z.minLength(minLength, toValidationError(locale.validation.tooFewChars, { count: minLength }))
+      );
+    }
+    if (maxLength) {
+      checkFns.push(
+        z.maxLength(maxLength, toValidationError(locale.validation.tooManyChars, { count: maxLength }))
+      );
+    }
+  }
+  const stringSchema = z.string(toValidationError(locale.validation.required)).check(z.trim(), ...checkFns);
+  return requirements.required ? stringSchema : z.union([z.null(), stringSchema]);
+}
+export function createListValidator(requirements) {
+  const { locale } = useReseeUx();
+  const checkFns = [];
+  const minRequired = toInteger(requirements.minRequired) || (requirements.required ? 1 : void 0);
+  const maxRequired = toInteger(requirements.maxRequired);
+  if (minRequired) {
+    checkFns.push(
+      z.minLength(minRequired, toValidationError(locale.validation.tooFewOptions, { count: minRequired }))
+    );
+  }
+  if (maxRequired) {
+    checkFns.push(
+      z.maxLength(maxRequired, toValidationError(locale.validation.tooManyOptions, { count: maxRequired }))
+    );
+  }
+  const arraySchema = z.array(z.unknown(), toValidationError(locale.validation.required)).check(...checkFns);
+  return requirements.required ? arraySchema : z.union([z.null(), arraySchema]);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@resee-movies/nuxt-ux",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "The next-gen user experience library for ReSee Movies - currently in development. ",
   "repository": {
     "url": "https://github.com/ReSee-Movies/nuxt-ux.git"
@@ -36,8 +36,8 @@
   ],
   "scripts": {
     "dev": "npm run dev:prepare && nuxi dev playground",
+    "dev:preview": "npm run dev:build && nuxi preview playground",
     "dev:build": "nuxi build playground",
-    "dev:preview": "nuxi preview playground",
     "dev:prepare": "nuxt-module-build build --stub && nuxt-module-build prepare && nuxi prepare playground",
     "prepare": "nuxt-module-build prepare && nuxt-module-build build",
     "release": "dotenv release-it --",
@@ -48,40 +48,42 @@
     "test:coverage": "vitest run --coverage"
   },
   "devDependencies": {
-    "@nuxt/devtools": "^2.6.5",
-    "@nuxt/eslint": "^1.9.0",
-    "@nuxt/eslint-config": "^1.9.0",
+    "@nuxt/devtools": "^3.1.1",
+    "@nuxt/eslint": "^1.11.0",
+    "@nuxt/eslint-config": "^1.11.0",
     "@nuxt/kit": "^4.1.3",
     "@nuxt/module-builder": "^1.0.2",
     "@nuxt/schema": "^4.1.3",
-    "@nuxt/test-utils": "^3.19.2",
-    "@release-it/conventional-changelog": "^10.0.1",
-    "@types/node": "^22.18.8",
+    "@nuxt/test-utils": "^3.20.1",
+    "@release-it/conventional-changelog": "^10.0.2",
+    "@types/node": "^24.10.1",
     "@vitest/coverage-v8": "^3.2.4",
-    "@vue/language-server": "^3.1.0",
     "@vue/test-utils": "^2.4.6",
-    "dotenv-cli": "^10.0.0",
-    "eslint": "^9.36.0",
-    "happy-dom": "^18.0.1",
-    "nuxt": "^4.1.2",
-    "release-it": "^19.0.5",
+    "dotenv-cli": "^11.0.0",
+    "eslint": "^9.39.1",
+    "happy-dom": "^20.0.11",
+    "nuxt": "^4.2.1",
+    "release-it": "^19.0.6",
     "typescript": "^5.9.3",
+    "vite-plugin-devtools-json": "^1.0.0",
     "vitest": "^3.2.4",
-    "vue-tsc": "^3.1.0"
+    "vue-tsc": "^3.1.5"
   },
   "dependencies": {
     "@egoist/tailwindcss-icons": "^1.9.0",
     "@iconify-json/ph": "^1.2.2",
-    "@iconify-json/simple-icons": "^1.2.53",
-    "@iconify-json/solar": "^1.2.4",
-    "@nuxt/fonts": "^0.11.4",
+    "@iconify-json/simple-icons": "^1.2.61",
+    "@iconify-json/solar": "^1.2.5",
+    "@nuxt/fonts": "^0.12.1",
     "@primeuix/utils": "^0.6.1",
-    "@primevue/nuxt-module": "^4.4.0",
+    "@primevue/forms": "^4.5.1",
+    "@primevue/nuxt-module": "^4.5.1",
     "@resee-movies/utilities": "^0.10.0",
-    "@tailwindcss/postcss": "^4.1.14",
-    "@tailwindcss/vite": "^4.1.14",
-    "@vueuse/core": "^13.9.0",
-    "primevue": "^4.4.0",
-    "tailwindcss": "^4.1.14"
+    "@tailwindcss/postcss": "^4.1.17",
+    "@tailwindcss/vite": "^4.1.17",
+    "@vueuse/core": "^14.1.0",
+    "primevue": "^4.5.1",
+    "tailwindcss": "^4.1.17",
+    "zod": "^4.1.13"
   }
 }