npm - ivue - Versions diffs - 1.1.19 → 1.1.21 - Mend

ivue 1.1.19 → 1.1.21

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (84) hide show

package/coverage/{index.ts.html → ivue.ts.html} RENAMED Viewed

@@ -3,7 +3,7 @@
 <html lang="en">
 <head>
-    <title>Code coverage report for index.ts</title>
+    <title>Code coverage report for ivue.ts</title>
     <meta charset="utf-8" />
     <link rel="stylesheet" href="prettify.css" />
     <link rel="stylesheet" href="base.css" />
@@ -19,34 +19,34 @@
 <body>
 <div class='wrapper'>
     <div class='pad1'>
-        <h1><a href="index.html">All files</a> index.ts</h1>
+        <h1><a href="index.html">All files</a> ivue.ts</h1>
         <div class='clearfix'>
             <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
+                <span class="strong">94.25% </span>
                 <span class="quiet">Statements</span>
-                <span class='fraction'>160/160</span>
+                <span class='fraction'>164/174</span>
             </div>
             <div class='fl pad1y space-right2'>
                 <span class="strong">100% </span>
                 <span class="quiet">Branches</span>
-                <span class='fraction'>71/71</span>
+                <span class='fraction'>72/72</span>
             </div>
             <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
+                <span class="strong">91.66% </span>
                 <span class="quiet">Functions</span>
-                <span class='fraction'>10/10</span>
+                <span class='fraction'>11/12</span>
             </div>
             <div class='fl pad1y space-right2'>
-                <span class="strong">100% </span>
+                <span class="strong">94.25% </span>
                 <span class="quiet">Lines</span>
-                <span class='fraction'>160/160</span>
+                <span class='fraction'>164/174</span>
             </div>
@@ -519,7 +519,70 @@
 <a name='L454'></a><a href='#L454'>454</a>
 <a name='L455'></a><a href='#L455'>455</a>
 <a name='L456'></a><a href='#L456'>456</a>
-<a name='L457'></a><a href='#L457'>457</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
+<a name='L457'></a><a href='#L457'>457</a>
+<a name='L458'></a><a href='#L458'>458</a>
+<a name='L459'></a><a href='#L459'>459</a>
+<a name='L460'></a><a href='#L460'>460</a>
+<a name='L461'></a><a href='#L461'>461</a>
+<a name='L462'></a><a href='#L462'>462</a>
+<a name='L463'></a><a href='#L463'>463</a>
+<a name='L464'></a><a href='#L464'>464</a>
+<a name='L465'></a><a href='#L465'>465</a>
+<a name='L466'></a><a href='#L466'>466</a>
+<a name='L467'></a><a href='#L467'>467</a>
+<a name='L468'></a><a href='#L468'>468</a>
+<a name='L469'></a><a href='#L469'>469</a>
+<a name='L470'></a><a href='#L470'>470</a>
+<a name='L471'></a><a href='#L471'>471</a>
+<a name='L472'></a><a href='#L472'>472</a>
+<a name='L473'></a><a href='#L473'>473</a>
+<a name='L474'></a><a href='#L474'>474</a>
+<a name='L475'></a><a href='#L475'>475</a>
+<a name='L476'></a><a href='#L476'>476</a>
+<a name='L477'></a><a href='#L477'>477</a>
+<a name='L478'></a><a href='#L478'>478</a>
+<a name='L479'></a><a href='#L479'>479</a>
+<a name='L480'></a><a href='#L480'>480</a>
+<a name='L481'></a><a href='#L481'>481</a>
+<a name='L482'></a><a href='#L482'>482</a>
+<a name='L483'></a><a href='#L483'>483</a>
+<a name='L484'></a><a href='#L484'>484</a>
+<a name='L485'></a><a href='#L485'>485</a>
+<a name='L486'></a><a href='#L486'>486</a>
+<a name='L487'></a><a href='#L487'>487</a>
+<a name='L488'></a><a href='#L488'>488</a>
+<a name='L489'></a><a href='#L489'>489</a>
+<a name='L490'></a><a href='#L490'>490</a>
+<a name='L491'></a><a href='#L491'>491</a>
+<a name='L492'></a><a href='#L492'>492</a>
+<a name='L493'></a><a href='#L493'>493</a>
+<a name='L494'></a><a href='#L494'>494</a>
+<a name='L495'></a><a href='#L495'>495</a>
+<a name='L496'></a><a href='#L496'>496</a>
+<a name='L497'></a><a href='#L497'>497</a>
+<a name='L498'></a><a href='#L498'>498</a>
+<a name='L499'></a><a href='#L499'>499</a>
+<a name='L500'></a><a href='#L500'>500</a>
+<a name='L501'></a><a href='#L501'>501</a>
+<a name='L502'></a><a href='#L502'>502</a>
+<a name='L503'></a><a href='#L503'>503</a>
+<a name='L504'></a><a href='#L504'>504</a>
+<a name='L505'></a><a href='#L505'>505</a>
+<a name='L506'></a><a href='#L506'>506</a>
+<a name='L507'></a><a href='#L507'>507</a>
+<a name='L508'></a><a href='#L508'>508</a>
+<a name='L509'></a><a href='#L509'>509</a>
+<a name='L510'></a><a href='#L510'>510</a>
+<a name='L511'></a><a href='#L511'>511</a>
+<a name='L512'></a><a href='#L512'>512</a>
+<a name='L513'></a><a href='#L513'>513</a>
+<a name='L514'></a><a href='#L514'>514</a>
+<a name='L515'></a><a href='#L515'>515</a>
+<a name='L516'></a><a href='#L516'>516</a>
+<a name='L517'></a><a href='#L517'>517</a>
+<a name='L518'></a><a href='#L518'>518</a>
+<a name='L519'></a><a href='#L519'>519</a>
+<a name='L520'></a><a href='#L520'>520</a></td><td class="line-coverage quiet"><span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">1x</span>
@@ -655,6 +718,35 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -809,6 +901,39 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-yes">162x</span>
+<span class="cline-any cline-yes">162x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-no">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">1x</span>
@@ -878,8 +1003,6 @@
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-yes">34x</span>
 <span class="cline-any cline-yes">34x</span>
-<span class="cline-any cline-neutral">&nbsp;</span>
-<span class="cline-any cline-yes">40x</span>
 <span class="cline-any cline-yes">4x</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
 <span class="cline-any cline-neutral">&nbsp;</span>
@@ -975,10 +1098,14 @@
 <span class="cline-any cline-yes">8x</span>
 <span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-yes">1x</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-neutral">&nbsp;</span>
+<span class="cline-any cline-yes">1x</span>
 <span class="cline-any cline-neutral">&nbsp;</span></td><td class="text"><pre class="prettyprint lang-js">/* eslint-disable @typescript-eslint/ban-types */
 /* eslint-disable @typescript-eslint/no-explicit-any */
 import type { ComputedRef, ExtractPropTypes, Ref, ToRef } from 'vue';
-import { UnwrapRef, computed, reactive, toRef } from 'vue';
+import { UnwrapRef, computed, reactive, ref, toRef } from 'vue';
+import type { Ref as DemiRef } from 'vue-demi';
 &nbsp;
 /** Types */
 /**
@@ -998,26 +1125,43 @@ export interface ExtendWithToRefs&lt;T extends AnyClass&gt; {
  */
 export type IVueToRefsFn&lt;T extends AnyClass&gt; = (
   props?: (keyof InstanceType&lt;T&gt;)[]
-) =&gt; IVueToRefsFnReturn&lt;InstanceType&lt;T&gt;&gt;;
+) =&gt; IVueRefs&lt;InstanceType&lt;T&gt;&gt;;
 &nbsp;
 /**
  * Converts a class properties to a composable .value Refs using ToRef vue type,
  * also knows NOT to convert functions to .value Refs but to leave them as is.
  */
-export type IVueToRefsFnReturn&lt;T = any&gt; = {
+export type IVueRefs&lt;T = any&gt; = {
   [K in keyof T]: T[K] extends Function ? T[K] : ToRef&lt;T[K]&gt;;
 };
 &nbsp;
 /**
- * Unwraps the returned Refs of composable method T to a reactive type definition.
+ * Unwraps Ref Recursively, helps resolve fully the bare value types of any type T
+ * because sometimes the Refs are returned as they are with `.value` from computeds,
+ * thus inferring nested ComputedRef&lt;ComputedRef&lt;ComputedRef&lt;Ref&gt;&gt;&gt; types, which
+ * are difficult to fully resolve to bare values without this utility.
+ * Also support Vue 3 Demi for vue-use library support.
  */
-export type UnwrapComposable&lt;T extends (...args: any[]) =&gt; any&gt; = {
-  [K in keyof ReturnType&lt;T&gt;]: UnwrapRef&lt;ReturnType&lt;T&gt;&gt;[K] extends Function
-    ? UnwrapRef&lt;ReturnType&lt;T&gt;&gt;[K] // Handle function
-    : UnwrapRef&lt;ReturnType&lt;T&gt;&gt;[K] extends Ref
-    ? UnwrapRef&lt;ReturnType&lt;T&gt;&gt;[K]['value']
-    : UnwrapRef&lt;ReturnType&lt;T&gt;&gt;[K]; // Handle property
-};
+export type UnwrapRefRecursively&lt;T = any&gt; = T extends Ref | DemiRef
+  ? UnwrapRefRecursively&lt;T['value']&gt;
+  : T;
+&nbsp;
+/**
+ * Helper type for UseComposable.
+ */
+export type UnwrapComposableReturn&lt;T&gt; = T extends Ref | DemiRef
+  ? UnwrapRefRecursively&lt;T&gt;
+  : {
+      [K in keyof T]: T[K] extends Ref | DemiRef
+        ? UnwrapRefRecursively&lt;T[K]&gt;
+        : T[K];
+    };
+&nbsp;
+/**
+ * Fully unwraps to bare value types any Vue 3 composable return definition type.
+ */
+export type UseComposable&lt;T extends (...args: any[]) =&gt; any&gt; =
+  UnwrapComposableReturn&lt;ReturnType&lt;T&gt;&gt;;
 &nbsp;
 /**
  * Extracts object defined emit types by converting them to a plain interface
@@ -1044,6 +1188,9 @@ export type ExtendSlots&lt;T&gt; = PrefixKeys&lt;T, 'before--'&gt; &amp;
   PrefixKeys&lt;T, 'after--'&gt;;
 &nbsp;
 /** Helper Types. */
+/**
+ * Any JavaScript class of any type.
+ */
 export type AnyClass = abstract new (...args: any[]) =&gt; any;
 &nbsp;
 /**
@@ -1071,7 +1218,15 @@ export type PrefixKeys&lt;T, P extends string | undefined = undefined&gt; = {
 };
 &nbsp;
 /**
- * Get Interface's property's function arguments Parmeters&lt;F&gt; parameter by key K
+ * Get Interface's property's function arguments Parmeters&lt;F&gt;
+ */
+export type IFnParameters&lt;
+  T extends Record&lt;any, any&gt;,
+  K extends string
+&gt; = Parameters&lt;Required&lt;Pick&lt;T, K&gt;&gt;[K]&gt;;
+&nbsp;
+/**
+ * Get Interface's [T] property's [P] function arguments Parmeters&lt;F&gt; parameter by key [K]
  */
 export type IFnParameter&lt;
   T extends Record&lt;any, any&gt;,
@@ -1114,7 +1269,7 @@ export type ValueOf&lt;T extends Record&lt;any, any&gt;, K&gt; = T[K];
 export const descriptorsMap = new Map();
 &nbsp;
 /**
- * Get descriptors of an entire class prototype chain as a Map.
+ * Get descriptors of an entire class prototype ancestors chain as a Map.
  * Completely emulates JavaScript class inheritance chain for getters and setters.
  *
  * @param className
@@ -1149,7 +1304,7 @@ export function getAllClassDescriptors(className: AnyClass): Descriptors {
         }
       }
     );
-    /** Walk up the prototype chain. */
+    /** Walk up the prototype ancestors chain. */
     prototype = Object.getPrototypeOf(prototype);
   }
 &nbsp;
@@ -1231,7 +1386,7 @@ export function ivue&lt;T extends AnyClass&gt;(
 export const propsMap: Map&lt;object, Set&lt;string&gt; | any&gt; = new Map();
 &nbsp;
 /**
- * Get properties of an entire class prototype chain as a Map.
+ * Get properties of an entire class prototype ancestors chain as a Map.
  */
 export function getAllClassProperties(obj: object): Set&lt;string&gt; {
   /* Retrieve props from cache */
@@ -1259,6 +1414,39 @@ export function getAllClassProperties(obj: object): Set&lt;string&gt; {
   return allProps;
 }
 &nbsp;
+/**
+ * `iref()` is an alias for Vue ref() function but returns an unwrapped type without the .value
+ * `iref()` does not alter the behavior of ref(), but simply transforms the type to an unwrapped raw value.
+ * @param val T
+ * @returns {UnwrapRef&lt;T&gt;}
+ */
+export function iref&lt;T&gt;(val?: T): UnwrapRef&lt;T&gt; {
+  return ref(val) as unknown as UnwrapRef&lt;T&gt;;
+}
+&nbsp;
+/**
+ * Two modes of operation:
+ * 1. `iuse()` converts the types of a Composable / Ref to pure raw type definition.
+ * Returns for all properties of an object an unwrapped raw type definition,
+ * unwraps direct Refs &amp; ComputedRefs as well.
+ *
+ * 2. If AnyClass is supplied into `iuse(AnyClass, ...args)` and that class's ...args,
+ * it returns a 'ivue(AnyClass, ...args).toRefs()` object for all properties but casts
+ * their types as raw (no-Ref) types to fit with reactive() structure of the
+ * ivue wrapper class context.
+ */
+export <span class="fstat-no" title="function not covered" >function iuse&lt;T extends AnyClass | Object&gt;(</span>
+<span class="cstat-no" title="statement not covered" >  val?: T,</span>
+<span class="cstat-no" title="statement not covered" >  ...args: InferredArgs&lt;T&gt;</span>
+<span class="cstat-no" title="statement not covered" >): T extends AnyClass ? InstanceType&lt;T&gt; : UnwrapComposableReturn&lt;T&gt; {</span>
+<span class="cstat-no" title="statement not covered" >  return isClass(val)</span>
+<span class="cstat-no" title="statement not covered" >    ? ivue(</span>
+<span class="cstat-no" title="statement not covered" >        val as T extends AnyClass ? T : any,</span>
+<span class="cstat-no" title="statement not covered" >        ...(args as InferredArgs&lt;T&gt;)</span>
+<span class="cstat-no" title="statement not covered" >      ).toRefs()</span>
+<span class="cstat-no" title="statement not covered" >    : (val as unknown as UnwrapComposableReturn&lt;T&gt;);</span>
+<span class="cstat-no" title="statement not covered" >}</span>
+&nbsp;
 /**
  * Convert reactive ivue class to Vue 3 refs.
  *
@@ -1274,7 +1462,7 @@ export function ivueToRefs&lt;T extends AnyClass&gt;(
 ): ExtendWithToRefs&lt;T&gt;['toRefs'] {
   return function (
     props?: (keyof InstanceType&lt;T&gt;)[]
-  ): IVueToRefsFnReturn&lt;InstanceType&lt;T&gt;&gt; {
+  ): IVueRefs&lt;InstanceType&lt;T&gt;&gt; {
     /** Resulting refs store. */
     const result: Record&lt;string | number | symbol, any&gt; = {};
 &nbsp;
@@ -1334,15 +1522,13 @@ export function ivueToRefs&lt;T extends AnyClass&gt;(
           /** Convert simple reactive prop to a Ref. */
           result[prop] = toRef(vue, prop);
         }
-        /** Delete prop from props as it was already processed. */
-        allProps?.delete(prop as string);
       });
 &nbsp;
       /** Memory optimization. */
       allProps = null;
     }
 &nbsp;
-    return result as IVueToRefsFnReturn&lt;InstanceType&lt;T&gt;&gt;;
+    return result as IVueRefs&lt;InstanceType&lt;T&gt;&gt;;
   };
 }
 &nbsp;
@@ -1431,6 +1617,9 @@ export function propsWithDefaults&lt;T extends VuePropsObject&gt;(
   }
   return typedProps as VuePropsWithDefaults&lt;T&gt;;
 }
+&nbsp;
+/** Necessary ivue.ts to be treated as a module. */
+export {};
 &nbsp;</pre></td></tr></table></pre>
                 <div class='push'></div><!-- for sticky footer -->
@@ -1438,7 +1627,7 @@ export function propsWithDefaults&lt;T extends VuePropsObject&gt;(
             <div class='footer quiet pad2 space-top1 center small'>
                 Code coverage generated by
                 <a href="https://istanbul.js.org/" target="_blank" rel="noopener noreferrer">istanbul</a>
-                at 2024-08-13T00:42:34.338Z
+                at 2024-08-19T00:40:48.849Z
             </div>
         <script src="prettify.js"></script>
         <script>

package/dist/index.es.js CHANGED Viewed

@@ -1,6 +1,6 @@
-import { reactive as y, computed as g, ref as O, toRef as d } from "vue";
+import { reactive as O, computed as g, ref as h, toRef as d } from "vue";
 const l = /* @__PURE__ */ new Map();
-function h(e) {
+function j(e) {
   if (l.has(e))
     return l.get(e);
   const r = /* @__PURE__ */ new Map();
@@ -12,18 +12,18 @@ function h(e) {
     }), t = Object.getPrototypeOf(t);
   return l.set(e, r), r;
 }
-function v(e, ...r) {
+function w(e, ...r) {
   var n, f;
-  const t = h(e), i = t != null && t.size ? {} : null, s = y(new e(...r));
+  const t = j(e), i = t != null && t.size ? {} : null, s = O(new e(...r));
   for (const [c, o] of t)
     ((n = e == null ? void 0 : e.ivue) == null ? void 0 : n[c]) !== !1 && Object.defineProperty(s, c, { get: o.get ? () => {
       var u, a;
       return c in i ? i[c] : i[c] = g({ get: (u = o.get) == null ? void 0 : u.bind(s), set: (a = o.set) == null ? void 0 : a.bind(s) });
     } : void 0, set: (f = o.set) == null ? void 0 : f.bind(s), enumerable: !1 });
-  return Object.defineProperty(s, "toRefs", { get: () => w(s, t, i), enumerable: !1 }), "init" in s && s.init(), s;
+  return Object.defineProperty(s, "toRefs", { get: () => m(s, t, i), enumerable: !1 }), "init" in s && s.init(), s;
 }
 const p = /* @__PURE__ */ new Map();
-function j(e) {
+function P(e) {
   if (p.has(e.constructor))
     return p.get(e.constructor);
   const r = e.constructor, t = /* @__PURE__ */ new Set();
@@ -35,12 +35,12 @@ function j(e) {
   return p.set(r, t), t;
 }
 function M(e) {
-  return O(e);
+  return h(e);
 }
-function A(e) {
-  return e;
+function A(e, ...r) {
+  return y(e) ? w(e, ...r).toRefs() : e;
 }
-function w(e, r, t) {
+function m(e, r, t) {
   return function(i) {
     var n, f;
     const s = {};
@@ -58,7 +58,7 @@ function w(e, r, t) {
           typeof e[o] == "function" ? s[o] = e[o].bind(e) : s[o] = d(e, o);
       }
     else {
-      let c = new Set(j(e));
+      let c = new Set(P(e));
       r.forEach((o, u) => {
         var a, b;
         s[u] = u in t ? t[u] : t[u] = g({ get: (a = o.get) == null ? void 0 : a.bind(e), set: (b = o.set) == null ? void 0 : b.bind(e) }), c == null || c.delete(u);
@@ -69,24 +69,24 @@ function w(e, r, t) {
     return s;
   };
 }
-function P(e) {
+function y(e) {
   var r;
   return typeof e == "function" && !!e.prototype && !((r = Object.getOwnPropertyDescriptor(e, "prototype")) != null && r.writable);
 }
 function D(e, r) {
   for (const t in r)
-    typeof (e == null ? void 0 : e[t]) == "object" && (e == null ? void 0 : e[t]) !== null || P(e == null ? void 0 : e[t]) ? r[t].default = () => e == null ? void 0 : e[t] : r[t].default = e == null ? void 0 : e[t];
+    typeof (e == null ? void 0 : e[t]) == "object" && (e == null ? void 0 : e[t]) !== null || y(e == null ? void 0 : e[t]) ? r[t].default = () => e == null ? void 0 : e[t] : r[t].default = e == null ? void 0 : e[t];
   return r;
 }
 export {
   l as descriptorsMap,
-  h as getAllClassDescriptors,
-  j as getAllClassProperties,
+  j as getAllClassDescriptors,
+  P as getAllClassProperties,
   M as iref,
-  P as isClass,
+  y as isClass,
   A as iuse,
-  v as ivue,
-  w as ivueToRefs,
+  w as ivue,
+  m as ivueToRefs,
   p as propsMap,
   D as propsWithDefaults
 };

package/dist/index.umd.js CHANGED Viewed

	@@ -1 +1 @@
1	- (function(s,l){typeof exports=="object"&&typeof module<"u"?l(exports,require("vue")):typeof define=="function"&&define.amd?define(["exports","vue"],l):l((s=typeof globalThis<"u"?globalThis:s\|\|self).ivue={},s.Vue)})(this,function(s,l){"use strict";const d=new Map;function b(t){if(d.has(t))return d.get(t);const r=new Map;let e=t.prototype;for(;e.constructor!==Object;)Object.entries(Object.getOwnPropertyDescriptors(e)).forEach(([c,o])=>{const i=r.get(c);i!==o&&(o!=null&&o.get\|\|o!=null&&o.set)&&(i!=null&&i.get&&(o.get=i==null?void 0:i.get),i!=null&&i.set&&(o.set=i==null?void 0:i.set),r.set(c,o))}),e=Object.getPrototypeOf(e);return d.set(t,r),r}const g=new Map;function y(t){if(g.has(t.constructor))return g.get(t.constructor);const r=t.constructor,e=new Set;do Object.getOwnPropertyNames(t).forEach(c=>{["caller","callee","arguments","constructor"].includes(c)\|\|e.add(c)}),t=Object.getPrototypeOf(t);while(t.constructor!==Object);return g.set(r,e),e}function O(t,r,e){return function(c){var i,p;const o={};if(Array.isArray(c)&&c.length)for(let u=0;u<c.length;u++){const n=c[u];if(r.has(n))if(n in e)o[n]=e[n];else{const f=r.get(n);o[n]=e[n]=l.computed({get:(i=f==null?void 0:f.get)==null?void 0:i.bind(t),set:(p=f==null?void 0:f.set)==null?void 0:p.bind(t)})}else typeof t[n]=="function"?o[n]=t[n].bind(t):o[n]=l.toRef(t,n)}else{let u=new Set(y(t));r.forEach((n,f)=>{var a,j;o[f]=f in e?e[f]:e[f]=l.computed({get:(a=n.get)==null?void 0:a.bind(t),set:(j=n.set)==null?void 0:j.bind(t)}),u==null\|\|u.delete(f)}),u.forEach(n=>{typeof t[n]=="function"?o[n]=t[n].bind(t):o[n]=l.toRef(t,n)}),u=null}return o}}function h(t){var r;return typeof t=="function"&&!!t.prototype&&!((r=Object.getOwnPropertyDescriptor(t,"prototype"))!=null&&r.writable)}s.descriptorsMap=d,s.getAllClassDescriptors=b,s.getAllClassProperties=y,s.iref=function(t){return l.ref(t)},s.isClass=h,s.iuse=function(t~~){return t},s.ivue=function(t~~,...r){~~var~~ ~~i,p;const e=~~b(t)~~,c=e!=null&&e.size~~?~~{}:null,o=l.reactive~~(~~new~~ t~~(...~~r)~~);for~~(~~const[u,n]of e~~)~~((i=t==null?void 0~~:t.ivue~~)==null?void 0:i[u])!==!1&&Object.defineProperty(o,u,{get:n.get?()=>{var f,a;return u in c?c[u]:c[u]~~=~~l.computed({get:(f=n.get)==null?void 0:f.bind(o),set:(a=n.set)==null?void 0:a.bind(o)})}:void 0,set:(p=n.set)==null?void 0:p.bind(o),enumerable:!1});return Object.defineProperty(o,"toRefs",{get:()=>~~O(o,~~e,c),enumerable:!1}),"init"in o&&o~~.~~init(),o},s.~~ivueToRefs=O,s.propsMap=g,s.propsWithDefaults=function(t,r){for(const e in r)typeof(t==null?void 0:t[e])=="object"&&(t==null?void 0:t[e])!==null\|\|h(t==null?void 0:t[e])?r[e].default=()=>t==null?void 0:t[e]:r[e].default=t==null?void 0:t[e];return r},Object.defineProperty(s,Symbol.toStringTag,{value:"Module"})});
1	+ (function(i,l){typeof exports=="object"&&typeof module<"u"?l(exports,require("vue")):typeof define=="function"&&define.amd?define(["exports","vue"],l):l((i=typeof globalThis<"u"?globalThis:i\|\|self).ivue={},i.Vue)})(this,function(i,l){"use strict";const d=new Map;function y(t){if(d.has(t))return d.get(t);const r=new Map;let e=t.prototype;for(;e.constructor!==Object;)Object.entries(Object.getOwnPropertyDescriptors(e)).forEach(([c,o])=>{const s=r.get(c);s!==o&&(o!=null&&o.get\|\|o!=null&&o.set)&&(s!=null&&s.get&&(o.get=s==null?void 0:s.get),s!=null&&s.set&&(o.set=s==null?void 0:s.set),r.set(c,o))}),e=Object.getPrototypeOf(e);return d.set(t,r),r}function O(t,...r){var s,p;const e=y(t),c=e!=null&&e.size?{}:null,o=l.reactive(new t(...r));for(const[u,n]of e)((s=t==null?void 0:t.ivue)==null?void 0:s[u])!==!1&&Object.defineProperty(o,u,{get:n.get?()=>{var f,a;return u in c?c[u]:c[u]=l.computed({get:(f=n.get)==null?void 0:f.bind(o),set:(a=n.set)==null?void 0:a.bind(o)})}:void 0,set:(p=n.set)==null?void 0:p.bind(o),enumerable:!1});return Object.defineProperty(o,"toRefs",{get:()=>j(o,e,c),enumerable:!1}),"init"in o&&o.init(),o}const g=new Map;function h(t){if(g.has(t.constructor))return g.get(t.constructor);const r=t.constructor,e=new Set;do Object.getOwnPropertyNames(t).forEach(c=>{["caller","callee","arguments","constructor"].includes(c)\|\|e.add(c)}),t=Object.getPrototypeOf(t);while(t.constructor!==Object);return g.set(r,e),e}function j(t,r,e){return function(c){var s,p;const o={};if(Array.isArray(c)&&c.length)for(let u=0;u<c.length;u++){const n=c[u];if(r.has(n))if(n in e)o[n]=e[n];else{const f=r.get(n);o[n]=e[n]=l.computed({get:(s=f==null?void 0:f.get)==null?void 0:s.bind(t),set:(p=f==null?void 0:f.set)==null?void 0:p.bind(t)})}else typeof t[n]=="function"?o[n]=t[n].bind(t):o[n]=l.toRef(t,n)}else{let u=new Set(h(t));r.forEach((n,f)=>{var a,w;o[f]=f in e?e[f]:e[f]=l.computed({get:(a=n.get)==null?void 0:a.bind(t),set:(w=n.set)==null?void 0:w.bind(t)}),u==null\|\|u.delete(f)}),u.forEach(n=>{typeof t[n]=="function"?o[n]=t[n].bind(t):o[n]=l.toRef(t,n)}),u=null}return o}}function b(t){var r;return typeof t=="function"&&!!t.prototype&&!((r=Object.getOwnPropertyDescriptor(t,"prototype"))!=null&&r.writable)}i.descriptorsMap=d,i.getAllClassDescriptors=y,i.getAllClassProperties=h,i.iref=function(t){return l.ref(t)},i.isClass=b,i.iuse=function(t,...r){return b(t)?O(t,...r).toRefs():t},i.ivue=O,i.ivueToRefs=j,i.propsMap=g,i.propsWithDefaults=function(t,r){for(const e in r)typeof(t==null?void 0:t[e])=="object"&&(t==null?void 0:t[e])!==null\|\|b(t==null?void 0:t[e])?r[e].default=()=>t==null?void 0:t[e]:r[e].default=t==null?void 0:t[e];return r},Object.defineProperty(i,Symbol.toStringTag,{value:"Module"})});

package/dist/src/ivue.d.ts CHANGED Viewed

@@ -24,7 +24,7 @@ export declare type IVueRefs<T = any> = {
     [K in keyof T]: T[K] extends Function ? T[K] : ToRef<T[K]>;
 };
 /**
- * Unwraps Refs Recursively, helps resolve fully the bare value types of any type T
+ * Unwraps Ref Recursively, helps resolve fully the bare value types of any type T
  * because sometimes the Refs are returned as they are with `.value` from computeds,
  * thus inferring nested ComputedRef<ComputedRef<ComputedRef<Ref>>> types, which
  * are difficult to fully resolve to bare values without this utility.
@@ -34,13 +34,13 @@ export declare type UnwrapRefRecursively<T = any> = T extends Ref | DemiRef ? Un
 /**
  * Helper type for UseComposable.
  */
-export declare type UnwrapComposable<T> = T extends Ref | DemiRef ? UnwrapRefRecursively<T> : {
+export declare type UnwrapComposableReturn<T> = T extends Ref | DemiRef ? UnwrapRefRecursively<T> : {
     [K in keyof T]: T[K] extends Ref | DemiRef ? UnwrapRefRecursively<T[K]> : T[K];
 };
 /**
  * Fully unwraps to bare value types any Vue 3 composable return definition type.
  */
-export declare type UseComposable<T extends (...args: any[]) => any> = UnwrapComposable<ReturnType<T>>;
+export declare type UseComposable<T extends (...args: any[]) => any> = UnwrapComposableReturn<ReturnType<T>>;
 /**
  * Extracts object defined emit types by converting them to a plain interface
  */
@@ -113,7 +113,7 @@ export declare type ValueOf<T extends Record<any, any>, K> = T[K];
  */
 export declare const descriptorsMap: Map<any, any>;
 /**
- * Get descriptors of an entire class prototype chain as a Map.
+ * Get descriptors of an entire class prototype ancestors chain as a Map.
  * Completely emulates JavaScript class inheritance chain for getters and setters.
  *
  * @param className
@@ -147,22 +147,28 @@ export declare function ivue<T extends AnyClass>(className: T, ...args: Inferred
  */
 export declare const propsMap: Map<object, Set<string> | any>;
 /**
- * Get properties of an entire class prototype chain as a Map.
+ * Get properties of an entire class prototype ancestors chain as a Map.
  */
 export declare function getAllClassProperties(obj: object): Set<string>;
 /**
- * `iref` is an unwrapped type alias for Vue ref() function.
- * `iref` does not alter the behavior of ref(), but simply
- * transforms the type to an unwrapped ref value.
- * @param val
- * @returns
+ * `iref()` is an alias for Vue ref() function but returns an unwrapped type without the .value
+ * `iref()` does not alter the behavior of ref(), but simply transforms the type to an unwrapped raw value.
+ * @param val T
+ * @returns {UnwrapRef<T>}
  */
 export declare function iref<T>(val?: T): UnwrapRef<T>;
 /**
- * `iuse` stands for composable.
- * Returns unwrapped composable type definition without the Refs.
+ * Two modes of operation:
+ * 1. `iuse()` converts the types of a Composable / Ref to pure raw type definition.
+ * Returns for all properties of an object an unwrapped raw type definition,
+ * unwraps direct Refs & ComputedRefs as well.
+ *
+ * 2. If AnyClass is supplied into `iuse(AnyClass, ...args)` and that class's ...args,
+ * it returns a 'ivue(AnyClass, ...args).toRefs()` object for all properties but casts
+ * their types as raw (no-Ref) types to fit with reactive() structure of the
+ * ivue wrapper class context.
  */
-export declare function iuse<T extends Object>(val?: T): UnwrapComposable<T>;
+export declare function iuse<T extends AnyClass | Object>(val?: T, ...args: InferredArgs<T>): T extends AnyClass ? InstanceType<T> : UnwrapComposableReturn<T>;
 /**
  * Convert reactive ivue class to Vue 3 refs.
  *

package/docs/docs/.vitepress/config.ts CHANGED Viewed

@@ -46,6 +46,14 @@ export default defineConfig({
             text: 'Using Lifecycle Hooks',
             link: '/pages/usage#using-lifecycle-hooks',
           },
+          {
+            text: 'Using Pinia Store',
+            link: '/pages/usage#using-pinia-store',
+          },
+          {
+            text: 'Using Quasar Framework',
+            link: '/pages/usage#using-quasar-framework',
+          },
         ],
       },
@@ -126,13 +134,11 @@ export default defineConfig({
           { text: 'UseComposable', link: '/pages/api#UseComposable' },
         ],
       },
       {
         collapsed: false,
         text: 'Source Code',
-        items: [
-          { text: 'Browse Code', link: '/pages/browse-code' },
-        ],
+        items: [{ text: 'Browse Code', link: '/pages/browse-code' }],
       },
     ],
   },