vue-context-storage 0.1.44 → 0.1.45

package/README.md

@@ -769,12 +769,12 @@ The library introspects the Zod schema before validation and wraps non-array val
 
 ```typescript
 const Schema = z.object({
-  tags: z.string().array().default([]),
-  ids: z.number().array().default([]),
-  statuses: z.enum(['active', 'inactive']).array().default([]),
+  tags: z.string().array(),
+  ids: z.number().array(),
+  statuses: z.enum(['active', 'inactive']).array(),
   filters: z
     .object({
-      categories: z.string().array().default([]),
+      categories: z.string().array(),
     })
     .default({ categories: [] }),
 })
@@ -782,7 +782,7 @@ const Schema = z.object({
 // All of these work automatically:
 // ?tags=vue          → { tags: ['vue'], ... }
 // ?tags=vue&tags=ts  → { tags: ['vue', 'ts'], ... }
-// (no tags param)    → { tags: [], ... }
+// (no tags param)    → { tags: [], ... }  (falls back to the value in your reactive state)
 ```
 
 Arrays of objects are also handled automatically. They deserialize from indexed query parameters (`?items[0][product]=Apple`) into indexed objects (`{ '0': { product: 'Apple' } }`), and the library converts them back to arrays sorted by numeric key wherever the schema expects `.array()` — coercion is applied recursively inside array elements as well:
@@ -803,7 +803,7 @@ const Schema = z.object({
 
 #### Boolean Coercion
 
-The query handler serializes booleans as `'1'`/`'0'` strings in URL parameters (e.g. `?active=1`). Standard `z.boolean()` cannot be used because `Boolean('0')` is `true` in JavaScript. The library automatically converts `'1'` → `true` and `'0'` → `false` when the schema expects a boolean field. **No special helpers are needed** — plain `z.boolean()` works out of the box:
+The query handler serializes booleans as `'1'`/`'0'` strings in URL parameters (e.g. `?active=1`). Standard `z.coerce.boolean()` cannot be used because `Boolean('0')` is `true` in JavaScript. The library automatically converts `'1'` → `true` and `'0'` → `false` when the schema expects a boolean field. **No special helpers are needed** — plain `z.boolean()` works out of the box:
 
 ```typescript
 const Schema = z.object({
@@ -817,13 +817,13 @@ const Schema = z.object({
 
 #### Number Coercion
 
-URL query parameters are always strings (`?page=5` → `'5'`), so plain `z.number()` would reject them with `"expected number, received string"`. The library automatically converts numeric strings to numbers wherever the schema expects a number — including inside nested objects and `z.array(z.number())`. **`z` is not required** — plain `z.number()` works out of the box:
+URL query parameters are always strings (`?page=5` → `'5'`), so plain `z.number()` would reject them with `"expected number, received string"`. The library automatically converts numeric strings to numbers wherever the schema expects a number — including inside nested objects and `z.array(z.number())`. **`z.coerce` is not required** — plain `z.number()` works out of the box:
 
 ```typescript
 const Schema = z.object({
   page: z.number().default(1),
   score: z.number().nullable(),
-  ids: z.array(z.number()).default([]),
+  ids: z.array(z.number()),
 })
 
 // ?page=5            → { page: 5, ... }
@@ -833,7 +833,7 @@ const Schema = z.object({
 
 Coercion is conservative: a non-numeric string (`?page=abc`) or an empty value is **not** forced to a number (`Number('')` would be `0`). Instead the schema validation fails and the field falls back to its initial data, so missing/garbage input never silently becomes `0`. `null` is preserved for `.nullable()` fields.
 
-> `z.number()` still works and remains useful when you want Zod's own coercion semantics (e.g. coercing booleans or accepting empty strings as `0`).
+> `z.coerce.number()` still works and remains useful when you want Zod's own coercion semantics (e.g. coercing booleans or accepting empty strings as `0`).
 
 ### `createEmptyZodObject(schema, options?)`
 

package/dist/index.d.ts

@@ -1,13 +1,13 @@
-import * as vue0 from "vue";
+import * as vue9 from "vue";
 import { ComputedRef, InjectionKey, MaybeRefOrGetter, Plugin, PropType, UnwrapNestedRefs } from "vue";
 import { LocationQuery, LocationQueryValue } from "vue-router";
 import { ZodObject, ZodRawShape, z } from "zod";
 
 //#region src/components/ContextStorageActivator.vue.d.ts
 declare const _default$1: typeof __VLS_export$4;
-declare const __VLS_export$4: vue0.DefineComponent<{}, () => vue0.VNode<vue0.RendererNode, vue0.RendererElement, {
+declare const __VLS_export$4: vue9.DefineComponent<{}, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, vue0.ComponentOptionsMixin, vue0.ComponentOptionsMixin, {}, string, vue0.PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, vue0.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> {
@@ -66,7 +66,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: vue0.DefineComponent<vue0.ExtractPropTypes<{
+declare const __VLS_export$3: vue9.DefineComponent<vue9.ExtractPropTypes<{
   handlers: {
     type: PropType<ContextStorageHandlerFactory[]>;
     default: () => ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
@@ -82,9 +82,9 @@ declare const __VLS_export$3: vue0.DefineComponent<vue0.ExtractPropTypes<{
     type: PropType<ContextStorageHandlerFactory[]>;
     default: undefined;
   };
-}>, () => vue0.VNode<vue0.RendererNode, vue0.RendererElement, {
+}>, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>[] | undefined, {}, {}, {}, vue0.ComponentOptionsMixin, vue0.ComponentOptionsMixin, {}, string, vue0.PublicProps, Readonly<vue0.ExtractPropTypes<{
+}>[] | undefined, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<vue9.ExtractPropTypes<{
   handlers: {
     type: PropType<ContextStorageHandlerFactory[]>;
     default: () => ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
@@ -103,27 +103,27 @@ declare const __VLS_export$3: vue0.DefineComponent<vue0.ExtractPropTypes<{
 }>> & Readonly<{}>, {
   handlers: ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
   additionalHandlers: ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
-}, {}, {}, {}, string, vue0.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: vue0.DefineComponent<vue0.ExtractPropTypes<{
+declare const __VLS_export$2: vue9.DefineComponent<vue9.ExtractPropTypes<{
   itemKey: {
     type: StringConstructor;
     required: true;
   };
-}>, () => vue0.VNode<vue0.RendererNode, vue0.RendererElement, {
+}>, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>[] | undefined, {}, {}, {}, vue0.ComponentOptionsMixin, vue0.ComponentOptionsMixin, {}, string, vue0.PublicProps, Readonly<vue0.ExtractPropTypes<{
+}>[] | undefined, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<vue9.ExtractPropTypes<{
   itemKey: {
     type: StringConstructor;
     required: true;
   };
-}>> & Readonly<{}>, {}, {}, {}, {}, string, vue0.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: vue0.DefineComponent<vue0.ExtractPropTypes<{
+declare const __VLS_export$1: vue9.DefineComponent<vue9.ExtractPropTypes<{
   handlers: {
     type: PropType<ContextStorageHandlerFactory[]>;
     default: () => ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
@@ -139,9 +139,9 @@ declare const __VLS_export$1: vue0.DefineComponent<vue0.ExtractPropTypes<{
     type: PropType<ContextStorageHandlerFactory[]>;
     default: undefined;
   };
-}>, () => vue0.VNode<vue0.RendererNode, vue0.RendererElement, {
+}>, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>[] | undefined, {}, {}, {}, vue0.ComponentOptionsMixin, vue0.ComponentOptionsMixin, {}, string, vue0.PublicProps, Readonly<vue0.ExtractPropTypes<{
+}>[] | undefined, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<vue9.ExtractPropTypes<{
   handlers: {
     type: PropType<ContextStorageHandlerFactory[]>;
     default: () => ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
@@ -160,7 +160,7 @@ declare const __VLS_export$1: vue0.DefineComponent<vue0.ExtractPropTypes<{
 }>> & Readonly<{}>, {
   handlers: ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
   additionalHandlers: ContextStorageHandlerFactory<{}, RegisterOptions<{}>>[];
-}, {}, {}, {}, string, vue0.ComponentProvideOptions, true, {}, any>;
+}, {}, {}, {}, string, vue9.ComponentProvideOptions, true, {}, any>;
 //#endregion
 //#region src/prefix.d.ts
 /**
@@ -182,19 +182,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: vue0.DefineComponent<vue0.ExtractPropTypes<{
+declare const __VLS_export: vue9.DefineComponent<vue9.ExtractPropTypes<{
   name: {
     type: PropType<ContextStoragePrefixSegment>;
     required: true;
   };
-}>, () => vue0.VNode<vue0.RendererNode, vue0.RendererElement, {
+}>, () => vue9.VNode<vue9.RendererNode, vue9.RendererElement, {
   [key: string]: any;
-}>, {}, {}, {}, vue0.ComponentOptionsMixin, vue0.ComponentOptionsMixin, {}, string, vue0.PublicProps, Readonly<vue0.ExtractPropTypes<{
+}>, {}, {}, {}, vue9.ComponentOptionsMixin, vue9.ComponentOptionsMixin, {}, string, vue9.PublicProps, Readonly<vue9.ExtractPropTypes<{
   name: {
     type: PropType<ContextStoragePrefixSegment>;
     required: true;
   };
-}>> & Readonly<{}>, {}, {}, {}, {}, string, vue0.ComponentProvideOptions, true, {}, any>;
+}>> & Readonly<{}>, {}, {}, {}, {}, string, vue9.ComponentProvideOptions, true, {}, any>;
 //#endregion
 //#region src/plugin.d.ts
 declare const VueContextStoragePlugin: Plugin;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "vue-context-storage",
   "type": "module",
-  "version": "0.1.44",
+  "version": "0.1.45",
   "description": "Vue 3 reactive state management — sync state with the URL query, localStorage, and sessionStorage",
   "author": "",
   "license": "MIT",