vue-context-storage 0.1.38 → 0.1.39

package/README.md

@@ -726,6 +726,44 @@ const Schema = z.object({
 })
 ```
 
+### `zNumberArray()`
+
+Creates a Zod schema for arrays of numbers serialized as URL query parameters. Handles the common issue where a single query value (`?ids=1`) is deserialized as a string `'1'` instead of an array `['1']`, which would cause `z.coerce.number().array()` to fail with `"expected array, received string"`.
+
+This helper normalizes the input by accepting both a single value and an array, coercing each element to a number.
+
+```typescript
+import { z } from 'zod'
+import { zNumberArray } from 'vue-context-storage/zod'
+
+const Schema = z.object({
+  users_ids: zNumberArray(),
+})
+
+// All of these work:
+Schema.parse({ users_ids: ['1', '2'] }) // → { users_ids: [1, 2] }
+Schema.parse({ users_ids: '1' }) // → { users_ids: [1] }
+Schema.parse({}) // → { users_ids: [] }
+```
+
+### `zStringArray()`
+
+Creates a Zod schema for arrays of strings serialized as URL query parameters. Same problem as `zNumberArray()` — a single query value (`?tags=vue`) is deserialized as a string `'vue'` instead of an array `['vue']`, which would cause `z.string().array()` to fail.
+
+```typescript
+import { z } from 'zod'
+import { zStringArray } from 'vue-context-storage/zod'
+
+const Schema = z.object({
+  tags: zStringArray(),
+})
+
+// All of these work:
+Schema.parse({ tags: ['vue', 'react'] }) // → { tags: ['vue', 'react'] }
+Schema.parse({ tags: 'vue' }) // → { tags: ['vue'] }
+Schema.parse({}) // → { tags: [] }
+```
+
 ### `createSchemaObject(schema, options?)`
 
 Creates a plain object with empty/default values based on a Zod schema. Useful for initializing reactive data from a schema definition.

package/dist/index.d.ts

@@ -1,12 +1,12 @@
-import * as vue19 from "vue";
+import * as vue9 from "vue";
 import { ComputedRef, InjectionKey, MaybeRefOrGetter, Plugin, PropType, UnwrapNestedRefs } from "vue";
 import { LocationQuery, LocationQueryValue } from "vue-router";
 
 //#region src/components/ContextStorageActivator.vue.d.ts
 declare const _default$1: typeof __VLS_export$4;
-declare const __VLS_export$4: vue19.DefineComponent<{}, () => vue19.VNode<vue19.RendererNode, vue19.RendererElement, {
+declare const __VLS_export$4: vue9.DefineComponent<{}, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, vue19.ComponentOptionsMixin, vue19.ComponentOptionsMixin, {}, string, vue19.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue19.ComponentProvideOptions, true, {}, any>;
+}>, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue9.ComponentProvideOptions, true, {}, any>;
 //#endregion
 //#region src/handlers/types.d.ts
 interface HandlerSchema<T> {
@@ -65,7 +65,7 @@ interface ContextStorageHandler<T, O> {
 //#endregion
 //#region src/components/ContextStorageCollection.vue.d.ts
 declare const _default$2: typeof __VLS_export$3;
-declare const __VLS_export$3: vue19.DefineComponent<vue19.ExtractPropTypes<{
+declare const __VLS_export$3: vue9.DefineComponent<vue9.ExtractPropTypes<{
   handlers: {
     type: PropType<ContextStorageHandlerFactory[]>;
     default: () => ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
@@ -81,9 +81,9 @@ declare const __VLS_export$3: vue19.DefineComponent<vue19.ExtractPropTypes<{
     type: PropType<ContextStorageHandlerFactory[]>;
     default: undefined;
   };
-}>, () => vue19.VNode<vue19.RendererNode, vue19.RendererElement, {
+}>, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>[] | undefined, {}, {}, {}, vue19.ComponentOptionsMixin, vue19.ComponentOptionsMixin, {}, string, vue19.PublicProps, Readonly<vue19.ExtractPropTypes<{
+}>[] | undefined, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<vue9.ExtractPropTypes<{
   handlers: {
     type: PropType<ContextStorageHandlerFactory[]>;
     default: () => ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
@@ -102,27 +102,27 @@ declare const __VLS_export$3: vue19.DefineComponent<vue19.ExtractPropTypes<{
 }>> & Readonly<{}>, {
   handlers: ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
   additionalHandlers: ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
-}, {}, {}, {}, string, vue19.ComponentProvideOptions, true, {}, any>;
+}, {}, {}, {}, string, vue9.ComponentProvideOptions, true, {}, any>;
 //#endregion
 //#region src/components/ContextStorageProvider.vue.d.ts
 declare const _default$4: typeof __VLS_export$2;
-declare const __VLS_export$2: vue19.DefineComponent<vue19.ExtractPropTypes<{
+declare const __VLS_export$2: vue9.DefineComponent<vue9.ExtractPropTypes<{
   itemKey: {
     type: StringConstructor;
     required: true;
   };
-}>, () => vue19.VNode<vue19.RendererNode, vue19.RendererElement, {
+}>, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>[] | undefined, {}, {}, {}, vue19.ComponentOptionsMixin, vue19.ComponentOptionsMixin, {}, string, vue19.PublicProps, Readonly<vue19.ExtractPropTypes<{
+}>[] | undefined, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<vue9.ExtractPropTypes<{
   itemKey: {
     type: StringConstructor;
     required: true;
   };
-}>> & Readonly<{}>, {}, {}, {}, {}, string, vue19.ComponentProvideOptions, true, {}, any>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, vue9.ComponentProvideOptions, true, {}, any>;
 //#endregion
 //#region src/components/ContextStorage.vue.d.ts
 declare const _default: typeof __VLS_export$1;
-declare const __VLS_export$1: vue19.DefineComponent<vue19.ExtractPropTypes<{
+declare const __VLS_export$1: vue9.DefineComponent<vue9.ExtractPropTypes<{
   handlers: {
     type: PropType<ContextStorageHandlerFactory[]>;
     default: () => ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
@@ -138,9 +138,9 @@ declare const __VLS_export$1: vue19.DefineComponent<vue19.ExtractPropTypes<{
     type: PropType<ContextStorageHandlerFactory[]>;
     default: undefined;
   };
-}>, () => vue19.VNode<vue19.RendererNode, vue19.RendererElement, {
+}>, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>[] | undefined, {}, {}, {}, vue19.ComponentOptionsMixin, vue19.ComponentOptionsMixin, {}, string, vue19.PublicProps, Readonly<vue19.ExtractPropTypes<{
+}>[] | undefined, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<vue9.ExtractPropTypes<{
   handlers: {
     type: PropType<ContextStorageHandlerFactory[]>;
     default: () => ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
@@ -159,7 +159,7 @@ declare const __VLS_export$1: vue19.DefineComponent<vue19.ExtractPropTypes<{
 }>> & Readonly<{}>, {
   handlers: ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
   additionalHandlers: ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
-}, {}, {}, {}, string, vue19.ComponentProvideOptions, true, {}, any>;
+}, {}, {}, {}, string, vue9.ComponentProvideOptions, true, {}, any>;
 //#endregion
 //#region src/prefix.d.ts
 /**
@@ -181,19 +181,19 @@ declare const contextStoragePrefixSegmentsInjectKey: InjectionKey<MaybeRefOrGett
 //#endregion
 //#region src/components/ContextStoragePrefix.vue.d.ts
 declare const _default$3: typeof __VLS_export;
-declare const __VLS_export: vue19.DefineComponent<vue19.ExtractPropTypes<{
+declare const __VLS_export: vue9.DefineComponent<vue9.ExtractPropTypes<{
   name: {
     type: PropType<ContextStoragePrefixSegment>;
     required: true;
   };
-}>, () => vue19.VNode<vue19.RendererNode, vue19.RendererElement, {
+}>, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, vue19.ComponentOptionsMixin, vue19.ComponentOptionsMixin, {}, string, vue19.PublicProps, Readonly<vue19.ExtractPropTypes<{
+}>, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<vue9.ExtractPropTypes<{
   name: {
     type: PropType<ContextStoragePrefixSegment>;
     required: true;
   };
-}>> & Readonly<{}>, {}, {}, {}, {}, string, vue19.ComponentProvideOptions, true, {}, any>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, vue9.ComponentProvideOptions, true, {}, any>;
 //#endregion
 //#region src/plugin.d.ts
 declare const VueContextStoragePlugin: Plugin;

package/dist/zod.d.ts

@@ -62,6 +62,64 @@ declare function zObjectArray<T extends z.ZodTypeAny>(itemSchema: T): z.ZodPipe<
  * ```
  */
 declare function zUrlBoolean(defaultValue?: boolean): z.ZodDefault<z.ZodPipe<z.ZodUnion<readonly [z.ZodBoolean, z.ZodString]>, z.ZodTransform<boolean, string | boolean>>>;
+/**
+ * Creates a Zod schema for arrays of numbers serialized as URL query parameters.
+ *
+ * URL query parameters serialize arrays as repeated keys:
+ * `?users_ids=1&users_ids=2` → `['1', '2']` (array of strings)
+ *
+ * But when only one value is present:
+ * `?users_ids=1` → `'1'` (just a string, not an array)
+ *
+ * `z.coerce.number().array()` would fail with "expected array, received string"
+ * for the single-value case. This helper normalizes the input by wrapping
+ * a single value into an array before coercing each element to a number.
+ *
+ * @example
+ * ```ts
+ * import { z } from 'zod'
+ * import { zNumberArray } from 'vue-context-storage/zod'
+ *
+ * const Schema = z.object({
+ *   users_ids: zNumberArray(),
+ * })
+ *
+ * // All of these work:
+ * Schema.parse({ users_ids: ['1', '2'] })  // → { users_ids: [1, 2] }
+ * Schema.parse({ users_ids: '1' })          // → { users_ids: [1] }
+ * Schema.parse({})                           // → { users_ids: [] }
+ * ```
+ */
+declare function zNumberArray(): z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodCoercedNumber<unknown>>, z.ZodPipe<z.ZodCoercedNumber<unknown>, z.ZodTransform<number[], number>>]>>;
+/**
+ * Creates a Zod schema for arrays of strings serialized as URL query parameters.
+ *
+ * URL query parameters serialize arrays as repeated keys:
+ * `?tags=vue&tags=react` → `['vue', 'react']` (array of strings)
+ *
+ * But when only one value is present:
+ * `?tags=vue` → `'vue'` (just a string, not an array)
+ *
+ * `z.string().array()` would fail with "expected array, received string"
+ * for the single-value case. This helper normalizes the input by wrapping
+ * a single value into an array.
+ *
+ * @example
+ * ```ts
+ * import { z } from 'zod'
+ * import { zStringArray } from 'vue-context-storage/zod'
+ *
+ * const Schema = z.object({
+ *   tags: zStringArray(),
+ * })
+ *
+ * // All of these work:
+ * Schema.parse({ tags: ['vue', 'react'] })  // → { tags: ['vue', 'react'] }
+ * Schema.parse({ tags: 'vue' })              // → { tags: ['vue'] }
+ * Schema.parse({})                            // → { tags: [] }
+ * ```
+ */
+declare function zStringArray(): z.ZodDefault<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodPipe<z.ZodString, z.ZodTransform<string[], string>>]>>;
 /**
  * Creates an object with empty values based on a Zod schema.
  * Useful for initializing forms.
@@ -78,4 +136,4 @@ declare function createEmptyObject<T extends ZodRawShape>(schema: ZodObject<T>,
   withSchema?: false;
 }): z.infer<ZodObject<T>>;
 //#endregion
-export { MaybeWithSchema, SCHEMA_SYMBOL, createEmptyObject, zObjectArray, zUrlBoolean };
+export { MaybeWithSchema, SCHEMA_SYMBOL, createEmptyObject, zNumberArray, zObjectArray, zStringArray, zUrlBoolean };

package/dist/zod.js

@@ -12,6 +12,12 @@ function zUrlBoolean(defaultValue = false) {
 		return val === "1" || val === "true";
 	}).default(defaultValue);
 }
+function zNumberArray() {
+	return z.union([z.coerce.number().array(), z.coerce.number().transform((v) => [v])]).default([]);
+}
+function zStringArray() {
+	return z.union([z.string().array(), z.string().transform((v) => [v])]).default([]);
+}
 function createEmptyObject(schema, options) {
 	const shape = schema.shape;
 	const result = {};
@@ -71,4 +77,4 @@ function createEmptyObject(schema, options) {
 }
 
 //#endregion
-export { SCHEMA_SYMBOL, createEmptyObject, zObjectArray, zUrlBoolean };
+export { SCHEMA_SYMBOL, createEmptyObject, zNumberArray, zObjectArray, zStringArray, zUrlBoolean };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vue-context-storage",
   "type": "module",
-  "version": "0.1.38",
+  "version": "0.1.39",
   "description": "Vue 3 context storage system with URL query synchronization support",
   "author": "",
   "license": "MIT",