ivue 2.0.0 → 2.1.0

package/dist/Static.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `Static()` — the static-side sibling of `Reactive()`.
+ *
+ * Lazily binds every visible static method of a capability class without
+ * touching the raw class, so methods stay referentially stable and safe to
+ * retain as callbacks (routers, watchers, command handlers) while the
+ * selected `Class` slot remains replaceable by a kernel/plugin.
+ *
+ * This is the namespace pattern's backend adapter: canonical namespace +
+ * mutable `Class` slot + late reads, for STATELESS capability classes (a
+ * function bag). Never wrap stateful/reactive instance classes with it — use
+ * `Reactive()` for those; `Static()` operates on the single class object and
+ * has no instance dimension.
+ *
+ * Ships from `ivue/extras` (not the reactive core) so the primary `ivue`
+ * entry stays minimal.
+ */
+export declare type ClassConstructor = new (...arguments_: any[]) => any;
+export declare function Static<Class extends ClassConstructor>(targetClass: Class): Class;

package/dist/extras.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"}),exports.Static=function(o){const r=class extends o{},c=new Set;for(let e=o;e!==Function.prototype;e=Object.getPrototypeOf(e))for(const t of Reflect.ownKeys(e)){if(c.has(t))continue;c.add(t);const n=Object.getOwnPropertyDescriptor(e,t);if(typeof n.value!="function")continue;const u=n.value;Object.defineProperty(r,t,{configurable:!0,enumerable:n.enumerable,get(){const i=u.bind(this);return Object.defineProperty(this,t,{...n,value:i}),i}})}return r};

package/dist/extras.d.ts

@@ -0,0 +1,9 @@
+/**
+ * `ivue/extras` — the ivue toolkit beyond the reactive core.
+ *
+ * Kept out of the primary `ivue` entry so that entry stays minimal (the
+ * 1.1kb reactive engine). Import these explicitly:
+ *
+ *   import { Static } from 'ivue/extras';
+ */
+export { Static, type ClassConstructor } from './Static';

package/dist/extras.es.js

@@ -0,0 +1,22 @@
+function f(o) {
+  const r = class extends o {
+  }, c = /* @__PURE__ */ new Set();
+  for (let e = o; e !== Function.prototype; e = Object.getPrototypeOf(e))
+    for (const t of Reflect.ownKeys(e)) {
+      if (c.has(t))
+        continue;
+      c.add(t);
+      const n = Object.getOwnPropertyDescriptor(e, t);
+      if (typeof n.value != "function")
+        continue;
+      const s = n.value;
+      Object.defineProperty(r, t, { configurable: !0, enumerable: n.enumerable, get() {
+        const i = s.bind(this);
+        return Object.defineProperty(this, t, { ...n, value: i }), i;
+      } });
+    }
+  return r;
+}
+export {
+  f as Static
+};

package/dist/index.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const l=require("vue"),g=Object.hasOwn,y=Object.getPrototypeOf,w=Object.getOwnPropertyDescriptor,m=Object.getOwnPropertyNames,a=Object.defineProperty,d=Object.prototype,b=Symbol.for("ivue.raw"),p=Symbol.for("ivue.scope"),h=Symbol.for("ivue.processed");function s(e){const r=l.toRaw(e);if(r!==e)return r[b]??(r[b]=r);const n=e[b];return n?n===e?n:l.toRaw(n):e[b]=e}function O(e,r,n,o){a(e,r,{configurable:!0,enumerable:!1,get(){const t=s(this);return t[n]??(t[n]=o.bind(t))},set(t){s(this)[n]=t}})}function S(e,r,n,o,t){const f=r[0]==="$";a(e,r,{configurable:!0,enumerable:!1,get:function(){const c=s(this);if(n in c)return c[n];const i=o.call(c);return f?(c[n]=i,i):(l.isRef(i)?c[n]=i:a(e,r,{configurable:!0,enumerable:!1,get(){return o.call(s(this))},set:t?function(u){return t.call(s(this),u)}:void 0}),i)},set:t?function(c){return t.call(s(this),c)}:void 0})}const v=e=>{var r;return typeof e=="function"&&!!e.prototype&&!((r=w(e,"prototype"))!=null&&r.writable)};exports.Reactive=function(e){const r=[];let n=e.prototype;for(;n&&n!==d;)r.push(n),n=y(n);r.reverse();for(const o of r){if(g(o,h))continue;const t=m(o),f=[];for(const c of t){if(c==="constructor")continue;const i=w(o,c);if(typeof i.value=="function"){const u=Symbol(c);f.push(u),O(o,c,u,i.value)}else if(i.get){const u=Symbol(c);f.push(u),S(o,c,u,i.get,i.set)}}a(o,h,{value:f})}return g(e.prototype,"$stopEffects")||(a(e.prototype,"$watch",{enumerable:!1,configurable:!0,writable:!0,value:function(...o){const t=s(this);return(t[p]??(t[p]=l.effectScope(!0))).run(()=>l.watch(...o))}}),a(e.prototype,"$watchEffect",{enumerable:!1,configurable:!0,writable:!0,value:function(...o){const t=s(this);return(t[p]??(t[p]=l.effectScope(!0))).run(()=>l.watchEffect(...o))}}),a(e.prototype,"$stopEffects",{enumerable:!1,configurable:!0,writable:!0,value:function(){const o=s(this);try{const t=o[p];t&&t.stop()}finally{delete o[p];let t=y(o);for(;t&&t!==d;){const f=t[h];if(f)for(const c of f)delete o[c];t=y(t)}}}})),e},exports.isClass=v,exports.propsWithDefaults=(e,r,n)=>{const o={};for(const t in r){const f=e==null?void 0:e[t],c=r[t];o[t]={...c},c.required||f===void 0||(typeof f=="object"&&f!==null?o[t].default=()=>n?n(f):structuredClone(f):v(f)?o[t].default=()=>f:o[t].default=f)}return o};

package/lib/Static.ts

@@ -0,0 +1,50 @@
+/**
+ * `Static()` — the static-side sibling of `Reactive()`.
+ *
+ * Lazily binds every visible static method of a capability class without
+ * touching the raw class, so methods stay referentially stable and safe to
+ * retain as callbacks (routers, watchers, command handlers) while the
+ * selected `Class` slot remains replaceable by a kernel/plugin.
+ *
+ * This is the namespace pattern's backend adapter: canonical namespace +
+ * mutable `Class` slot + late reads, for STATELESS capability classes (a
+ * function bag). Never wrap stateful/reactive instance classes with it — use
+ * `Reactive()` for those; `Static()` operates on the single class object and
+ * has no instance dimension.
+ *
+ * Ships from `ivue/extras` (not the reactive core) so the primary `ivue`
+ * entry stays minimal.
+ */
+export type ClassConstructor = new (...arguments_: any[]) => any;
+
+export function Static<Class extends ClassConstructor>(targetClass: Class): Class {
+  const SelectedClass = class extends targetClass {};
+  const visitedKeys = new Set<PropertyKey>();
+
+  for (
+    let currentClass: ClassConstructor = targetClass;
+    currentClass !== Function.prototype;
+    currentClass = Object.getPrototypeOf(currentClass)
+  ) {
+    for (const key of Reflect.ownKeys(currentClass)) {
+      if (visitedKeys.has(key)) continue;
+      visitedKeys.add(key);
+
+      const descriptor = Object.getOwnPropertyDescriptor(currentClass, key)!;
+      if (typeof descriptor.value !== 'function') continue;
+      const method = descriptor.value;
+
+      Object.defineProperty(SelectedClass, key, {
+        configurable: true,
+        enumerable: descriptor.enumerable,
+        get(this: ClassConstructor) {
+          const boundMethod = method.bind(this);
+          Object.defineProperty(this, key, { ...descriptor, value: boundMethod });
+          return boundMethod;
+        },
+      });
+    }
+  }
+
+  return SelectedClass as Class;
+}

package/lib/__tests__/Static.vitest.spec.ts

@@ -0,0 +1,99 @@
+import { describe, expect, it } from 'vitest';
+import { Static } from '../Static';
+
+describe('Static', () => {
+  it('returns a subclass and leaves the raw class untouched', () => {
+    class $Mailer {
+      static send(message: string) {
+        return `sent:${message}`;
+      }
+    }
+
+    const Mailer = Static($Mailer);
+
+    expect(Mailer).not.toBe($Mailer);
+    expect(Object.getPrototypeOf(Mailer)).toBe($Mailer);
+    // the raw class keeps its plain data-property descriptor
+    const rawDescriptor = Object.getOwnPropertyDescriptor($Mailer, 'send')!;
+    expect(typeof rawDescriptor.value).toBe('function');
+    expect(rawDescriptor.get).toBeUndefined();
+  });
+
+  it('binds methods lazily with stable identity, safe to detach', () => {
+    class $Counter {
+      static total = 0;
+      static bump() {
+        this.total++;
+        return this.total;
+      }
+    }
+
+    const Counter = Static($Counter);
+    const firstRead = Counter.bump;
+
+    expect(Counter.bump).toBe(firstRead); // cached after first access
+    const detached = Counter.bump;
+    expect(detached()).toBe(1); // `this` survives detachment
+    expect(Counter.total).toBe(1);
+  });
+
+  it('walks the static inheritance chain; child overrides win', () => {
+    class $Base {
+      static describe() {
+        return 'base';
+      }
+      static inheritedOnly() {
+        return 'inherited';
+      }
+    }
+    class $Child extends $Base {
+      static describe() {
+        return 'child';
+      }
+    }
+
+    const Child = Static($Child);
+    const describe = Child.describe;
+    const inheritedOnly = Child.inheritedOnly;
+
+    expect(describe()).toBe('child');
+    expect(inheritedOnly()).toBe('inherited');
+  });
+
+  it('skips non-function statics and preserves enumerability', () => {
+    class $Config {
+      static baseUrl = 'https://example.test';
+      static resolve(path: string) {
+        return this.baseUrl + path;
+      }
+    }
+
+    const Config = Static($Config);
+
+    expect(Config.baseUrl).toBe('https://example.test');
+    // class static methods are non-enumerable by construction — the lazy
+    // accessor and the materialized bound method must both preserve that
+    const before = Object.getOwnPropertyDescriptor(Config, 'resolve')!;
+    expect(before.enumerable).toBe(false);
+    Config.resolve; // materialize the bound method
+    const after = Object.getOwnPropertyDescriptor(Config, 'resolve')!;
+    expect(after.enumerable).toBe(false);
+    expect(Config.resolve('/path')).toBe('https://example.test/path');
+  });
+
+  it('binds `this` to the wrapped class, so statics compose', () => {
+    class $Report {
+      static header() {
+        return 'HEADER';
+      }
+      static render() {
+        return `${this.header()}|body`;
+      }
+    }
+
+    const Report = Static($Report);
+    const render = Report.render;
+
+    expect(render()).toBe('HEADER|body');
+  });
+});

package/lib/__tests__/coverage-completion.vitest.spec.ts

@@ -3,6 +3,7 @@
  */
 import { describe, expect, it } from 'vitest';
 import * as packageEntry from '../index';
+import * as extrasEntry from '../extras';
 import { Kernel, kernel } from '../kernel';
 
 describe('package entry (index.ts)', () => {
@@ -11,6 +12,12 @@ describe('package entry (index.ts)', () => {
   });
 });
 
+describe('extras entry (extras.ts)', () => {
+  it('re-exports the toolkit beyond the core', () => {
+    expect(typeof extrasEntry.Static).toBe('function');
+  });
+});
+
 describe('Kernel', () => {
   it('sets, gets, falls back, clears', () => {
     const container = new Kernel();

package/lib/extras.ts

@@ -0,0 +1,9 @@
+/**
+ * `ivue/extras` — the ivue toolkit beyond the reactive core.
+ *
+ * Kept out of the primary `ivue` entry so that entry stays minimal (the
+ * 1.1kb reactive engine). Import these explicitly:
+ *
+ *   import { Static } from 'ivue/extras';
+ */
+export { Static, type ClassConstructor } from './Static';

package/package.json

@@ -1,17 +1,22 @@
 {
   "name": "ivue",
-  "version": "2.0.0",
+  "version": "2.1.0",
   "description": "Infinite Vue – Class Based Architecture for Vue 3",
   "type": "module",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.es.js",
-      "require": "./dist/index.umd.js"
+      "require": "./dist/index.cjs"
+    },
+    "./extras": {
+      "types": "./dist/extras.d.ts",
+      "import": "./dist/extras.es.js",
+      "require": "./dist/extras.cjs"
     },
     "./package.json": "./package.json"
   },
-  "main": "./dist/index.umd.js",
+  "main": "./dist/index.cjs",
   "module": "./dist/index.es.js",
   "types": "./dist/index.d.ts",
   "scripts": {

package/dist/index.umd.js

@@ -1 +0,0 @@
-(function(l,f){typeof exports=="object"&&typeof module<"u"?f(exports,require("vue")):typeof define=="function"&&define.amd?define(["exports","vue"],f):f((l=typeof globalThis<"u"?globalThis:l||self).ivue={},l.Vue)})(this,function(l,f){"use strict";const g=Object.hasOwn,d=Object.getPrototypeOf,v=Object.getOwnPropertyDescriptor,O=Object.getOwnPropertyNames,a=Object.defineProperty,m=Object.prototype,y=Symbol.for("ivue.raw"),b=Symbol.for("ivue.scope"),h=Symbol.for("ivue.processed");function s(e){const r=f.toRaw(e);if(r!==e)return r[y]??(r[y]=r);const n=e[y];return n?n===e?n:f.toRaw(n):e[y]=e}function j(e,r,n,o){a(e,r,{configurable:!0,enumerable:!1,get(){const t=s(this);return t[n]??(t[n]=o.bind(t))},set(t){s(this)[n]=t}})}function S(e,r,n,o,t){const u=r[0]==="$";a(e,r,{configurable:!0,enumerable:!1,get:function(){const c=s(this);if(n in c)return c[n];const i=o.call(c);return u?(c[n]=i,i):(f.isRef(i)?c[n]=i:a(e,r,{configurable:!0,enumerable:!1,get(){return o.call(s(this))},set:t?function(p){return t.call(s(this),p)}:void 0}),i)},set:t?function(c){return t.call(s(this),c)}:void 0})}const w=e=>{var r;return typeof e=="function"&&!!e.prototype&&!((r=v(e,"prototype"))!=null&&r.writable)};l.Reactive=function(e){const r=[];let n=e.prototype;for(;n&&n!==m;)r.push(n),n=d(n);r.reverse();for(const o of r){if(g(o,h))continue;const t=O(o),u=[];for(const c of t){if(c==="constructor")continue;const i=v(o,c);if(typeof i.value=="function"){const p=Symbol(c);u.push(p),j(o,c,p,i.value)}else if(i.get){const p=Symbol(c);u.push(p),S(o,c,p,i.get,i.set)}}a(o,h,{value:u})}return g(e.prototype,"$stopEffects")||(a(e.prototype,"$watch",{enumerable:!1,configurable:!0,writable:!0,value:function(...o){const t=s(this);return(t[b]??(t[b]=f.effectScope(!0))).run(()=>f.watch(...o))}}),a(e.prototype,"$watchEffect",{enumerable:!1,configurable:!0,writable:!0,value:function(...o){const t=s(this);return(t[b]??(t[b]=f.effectScope(!0))).run(()=>f.watchEffect(...o))}}),a(e.prototype,"$stopEffects",{enumerable:!1,configurable:!0,writable:!0,value:function(){const o=s(this);try{const t=o[b];t&&t.stop()}finally{delete o[b];let t=d(o);for(;t&&t!==m;){const u=t[h];if(u)for(const c of u)delete o[c];t=d(t)}}}})),e},l.isClass=w,l.propsWithDefaults=(e,r,n)=>{const o={};for(const t in r){const u=e==null?void 0:e[t],c=r[t];o[t]={...c},c.required||u===void 0||(typeof u=="object"&&u!==null?o[t].default=()=>n?n(u):structuredClone(u):w(u)?o[t].default=()=>u:o[t].default=u)}return o},Object.defineProperty(l,Symbol.toStringTag,{value:"Module"})});