obix-test 0.3.0

package/README.md

@@ -0,0 +1,57 @@
+# obix-test
+
+**Headless verification for the OBIX suite.** Depends on `obix-core`.
+
+```bash
+npm install --save-dev obix-test
+```
+
+## `mountForTest(def, opts?)`
+
+Runs a component's `obix-core` store on a virtual clock — no DOM.
+
+```ts
+import test from "node:test";
+import assert from "node:assert/strict";
+import { mountForTest } from "obix-test";
+import { Timer } from "./Timer.ts";
+
+test("timer quiesces at the limit", () => {
+  const t = mountForTest(Timer, { props: { limitSeconds: 5 } });
+  t.dispatch("Start");
+  t.advance(8000);                 // fire the 1s `tick` effect eight times
+  assert.equal(t.state.seconds, 5);
+  assert.equal(t.state.running, false);
+  assert.equal(t.select("finished"), true);
+  assert.match(t.renderText(), /Finished/);
+});
+```
+
+`renderText()` performs the same `{marker}` text substitution the DOM binder
+does, so rendered output is assertable without a browser. `advance(ms)` drives
+declared `{ every, while, dispatch }` effects deterministically.
+
+## `checkEquivalence(def, { trace, from?, props? })`
+
+Folds `trace` three ways — a **direct reference evaluator**, `toFunc().replay`,
+and `toClass()` method calls — and reports any step where state or a derived
+value diverges. The reference evaluator shares no code with the projections.
+
+```ts
+const report = checkEquivalence(Timer, {
+  trace: [["Start"], ["Tick"], ["Tick"], ["Stop"]],
+  props: { limitSeconds: 5 },
+});
+assert.ok(report.equivalent, report.divergences.join("\n"));
+// report.history[report.steps] === { seconds: 2, running: false }
+```
+
+## `createVirtualClock()`
+
+The deterministic `Scheduler` used by `mountForTest`, exported for direct use
+with `obix-core.createStore({ scheduler })`.
+
+## Status
+
+Level 0. DOM-level mount / hydration tests are deferred (the DOM binder itself
+is unit-tested inside `obix-core`).

package/dist/equivalence.d.ts

@@ -0,0 +1,13 @@
+import { type ComponentDef, type Trace } from "obix-core";
+export interface EquivalenceReport {
+    equivalent: boolean;
+    steps: number;
+    history: unknown[];
+    divergences: string[];
+}
+export declare function checkEquivalence<S extends object, P extends object>(def: ComponentDef<S, P>, options?: {
+    trace: Trace;
+    from?: S;
+    props?: Partial<P>;
+}): EquivalenceReport;
+//# sourceMappingURL=equivalence.d.ts.map

package/dist/equivalence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"equivalence.d.ts","sourceRoot":"","sources":["../src/equivalence.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,KAAK,YAAY,EAGjB,KAAK,KAAK,EACX,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IAEd,OAAO,EAAE,OAAO,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAiCD,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EACjE,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EACvB,OAAO,GAAE;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CAAkB,GACtE,iBAAiB,CAoCnB"}

package/dist/equivalence.js

@@ -0,0 +1,54 @@
+import { toClass, toFunc, } from "obix-core";
+const eq = (a, b) => JSON.stringify(a) === JSON.stringify(b);
+function directFold(def, trace, from, props) {
+    const states = [from];
+    const deriveds = [computeDerived(def, from, props)];
+    let cur = from;
+    for (const [name, payload] of trace) {
+        const fn = def.actions?.[name];
+        if (!fn)
+            throw new Error(`equivalence: unknown action "${name}"`);
+        cur = fn(cur, payload, props);
+        states.push(cur);
+        deriveds.push(computeDerived(def, cur, props));
+    }
+    return { states, deriveds };
+}
+function computeDerived(def, state, props) {
+    const out = {};
+    for (const [k, fn] of Object.entries(def.derived ?? {}))
+        out[k] = fn(state, props);
+    return out;
+}
+export function checkEquivalence(def, options = { trace: [] }) {
+    const from = (options.from ?? def.state);
+    const props = { ...(def.props ?? {}), ...(options.props ?? {}) };
+    const trace = options.trace;
+    const divergences = [];
+    const ref = directFold(def, trace, from, props);
+    const F = toFunc(def);
+    for (let i = 1; i <= trace.length; i++) {
+        const state = F.replay(trace.slice(0, i), from, props);
+        if (!eq(state, ref.states[i])) {
+            divergences.push(`step ${i}: toFunc ${JSON.stringify(state)} ≠ reference ${JSON.stringify(ref.states[i])}`);
+        }
+    }
+    const instance = new (toClass(def))({ state: from, props });
+    for (let i = 0; i < trace.length; i++) {
+        const [name, payload] = trace[i];
+        instance[name](payload);
+        if (!eq(instance.state, ref.states[i + 1])) {
+            divergences.push(`step ${i + 1}: toClass ${JSON.stringify(instance.state)} ≠ reference ${JSON.stringify(ref.states[i + 1])}`);
+        }
+        if (!eq(instance.derived(), ref.deriveds[i + 1])) {
+            divergences.push(`step ${i + 1}: toClass derived ${JSON.stringify(instance.derived())} ≠ reference ${JSON.stringify(ref.deriveds[i + 1])}`);
+        }
+    }
+    return {
+        equivalent: divergences.length === 0,
+        steps: trace.length,
+        history: ref.states,
+        divergences,
+    };
+}
+//# sourceMappingURL=equivalence.js.map

package/dist/equivalence.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"equivalence.js","sourceRoot":"","sources":["../src/equivalence.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { createVirtualClock } from "./virtual-clock.js";
+export type { VirtualClock } from "./virtual-clock.js";
+export { mountForTest } from "./mount.js";
+export type { MountOptions, MountedComponent } from "./mount.js";
+export { checkEquivalence } from "./equivalence.js";
+export type { EquivalenceReport } from "./equivalence.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAEvD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AACpD,YAAY,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createVirtualClock } from "./virtual-clock.js";
+export { mountForTest } from "./mount.js";
+export { checkEquivalence } from "./equivalence.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAGxD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAG1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/mount.d.ts

@@ -0,0 +1,21 @@
+import { type ComponentDef, type Store } from "obix-core";
+import { type VirtualClock } from "./virtual-clock.js";
+export interface MountOptions<S extends object, P extends object> {
+    state?: S;
+    props?: Partial<P>;
+    template?: string;
+}
+export interface MountedComponent<S extends object, P extends object> {
+    readonly store: Store<S, P>;
+    readonly state: S;
+    readonly clock: VirtualClock;
+    dispatch(action: string, payload?: unknown): S;
+    advance(ms: number): void;
+    derived(): Record<string, unknown>;
+    select(name: string): unknown;
+    readonly transitions: number;
+    renderText(): string;
+    stop(): void;
+}
+export declare function mountForTest<S extends object, P extends object>(def: ComponentDef<S, P>, opts?: MountOptions<S, P>): MountedComponent<S, P>;
+//# sourceMappingURL=mount.d.ts.map

package/dist/mount.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.d.ts","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAUA,OAAO,EAIL,KAAK,YAAY,EAGjB,KAAK,KAAK,EACX,MAAM,WAAW,CAAC;AACnB,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAqB3E,MAAM,WAAW,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IAC9D,KAAK,CAAC,EAAE,CAAC,CAAC;IACV,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAEnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IAClE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;IAE/C,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,OAAO,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B,UAAU,IAAI,MAAM,CAAC;IACrB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,EAC7D,GAAG,EAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC,EACvB,IAAI,GAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAM,GAC5B,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CA4BxB"}

package/dist/mount.js

@@ -0,0 +1,54 @@
+import { readFileSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { buildScope, createStore, resolvePath, } from "obix-core";
+import { createVirtualClock } from "./virtual-clock.js";
+const MARKER = /\{([^{}]+)\}/g;
+function stringify(v) {
+    if (v == null)
+        return "";
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    return JSON.stringify(v);
+}
+function templateSource(def, override) {
+    if (override != null)
+        return override;
+    const t = def.template;
+    if (typeof t === "string")
+        return t;
+    if (t instanceof URL) {
+        return t.protocol === "file:" ? readFileSync(fileURLToPath(t), "utf8") : "";
+    }
+    return "";
+}
+export function mountForTest(def, opts = {}) {
+    const clock = createVirtualClock();
+    const template = templateSource(def, opts.template);
+    const store = createStore(def, {
+        state: opts.state,
+        props: opts.props,
+        scheduler: clock.scheduler,
+    });
+    return {
+        store,
+        get state() {
+            return store.state;
+        },
+        clock,
+        dispatch: (action, payload) => store.dispatch(action, payload),
+        advance: (ms) => clock.advance(ms),
+        derived: () => store.derived(),
+        select: (name) => store.select(name),
+        get transitions() {
+            return store.revision;
+        },
+        renderText() {
+            const scope = buildScope(store.state, store.props, store.derived());
+            return template.replace(MARKER, (_m, path) => stringify(resolvePath(scope, path)));
+        },
+        stop: () => store.destroy(),
+    };
+}
+//# sourceMappingURL=mount.js.map

package/dist/mount.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mount.js","sourceRoot":"","sources":["../src/mount.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EACL,UAAU,EACV,WAAW,EACX,WAAW,GAKZ,MAAM,WAAW,CAAC;AACnB,OAAO,EAAE,kBAAkB,EAAqB,MAAM,oBAAoB,CAAC;AAE3E,MAAM,MAAM,GAAG,eAAe,CAAC;AAE/B,SAAS,SAAS,CAAC,CAAU;IAC3B,IAAI,CAAC,IAAI,IAAI;QAAE,OAAO,EAAE,CAAC;IACzB,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc,CAAC,GAAiB,EAAE,QAAiB;IAC1D,IAAI,QAAQ,IAAI,IAAI;QAAE,OAAO,QAAQ,CAAC;IACtC,MAAM,CAAC,GAAG,GAAG,CAAC,QAAQ,CAAC;IACvB,IAAI,OAAO,CAAC,KAAK,QAAQ;QAAE,OAAO,CAAC,CAAC;IACpC,IAAI,CAAC,YAAY,GAAG,EAAE,CAAC;QACrB,OAAO,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9E,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC;AAwBD,MAAM,UAAU,YAAY,CAC1B,GAAuB,EACvB,OAA2B,EAAE;IAE7B,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAmB,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;IACpE,MAAM,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;QAC7B,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,KAAK,EAAE,IAAI,CAAC,KAAK;QACjB,SAAS,EAAE,KAAK,CAAC,SAAS;KAC3B,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,IAAI,KAAK;YACP,OAAO,KAAK,CAAC,KAAK,CAAC;QACrB,CAAC;QACD,KAAK;QACL,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;QAC9D,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QAClC,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE;QAC9B,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC;QACpC,IAAI,WAAW;YACb,OAAO,KAAK,CAAC,QAAQ,CAAC;QACxB,CAAC;QACD,UAAU;YACR,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YACpE,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,IAAY,EAAE,EAAE,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC7F,CAAC;QACD,IAAI,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE;KAC5B,CAAC;AACJ,CAAC"}

package/dist/virtual-clock.d.ts

@@ -0,0 +1,8 @@
+import type { Scheduler } from "obix-core";
+export interface VirtualClock {
+    readonly scheduler: Scheduler;
+    readonly now: number;
+    advance(ms: number): void;
+}
+export declare function createVirtualClock(): VirtualClock;
+//# sourceMappingURL=virtual-clock.d.ts.map

package/dist/virtual-clock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-clock.d.ts","sourceRoot":"","sources":["../src/virtual-clock.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,IAAI,YAAY,CA0CjD"}

package/dist/virtual-clock.js

@@ -0,0 +1,44 @@
+export function createVirtualClock() {
+    let now = 0;
+    let seq = 1;
+    const timers = new Map();
+    const scheduler = {
+        setInterval(fn, ms) {
+            const id = seq++;
+            timers.set(id, { at: now + ms, every: Math.max(1, ms), fn });
+            return id;
+        },
+        clearInterval(handle) {
+            timers.delete(handle);
+        },
+    };
+    return {
+        scheduler,
+        get now() {
+            return now;
+        },
+        advance(ms) {
+            const target = now + ms;
+            let guard = 0;
+            while (guard++ < 1_000_000) {
+                let dueId = -1;
+                let dueAt = Infinity;
+                for (const [id, t] of timers) {
+                    if (t.at <= target && t.at < dueAt) {
+                        dueAt = t.at;
+                        dueId = id;
+                    }
+                }
+                if (dueId === -1)
+                    break;
+                const t = timers.get(dueId);
+                now = t.at;
+                t.fn();
+                if (timers.has(dueId))
+                    t.at += t.every;
+            }
+            now = target;
+        },
+    };
+}
+//# sourceMappingURL=virtual-clock.js.map

package/dist/virtual-clock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"virtual-clock.js","sourceRoot":"","sources":["../src/virtual-clock.ts"],"names":[],"mappings":"AAcA,MAAM,UAAU,kBAAkB;IAChC,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,MAAM,MAAM,GAAG,IAAI,GAAG,EAAyD,CAAC;IAEhF,MAAM,SAAS,GAAc;QAC3B,WAAW,CAAC,EAAE,EAAE,EAAE;YAChB,MAAM,EAAE,GAAG,GAAG,EAAE,CAAC;YACjB,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,GAAG,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;YAC7D,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,aAAa,CAAC,MAAM;YAClB,MAAM,CAAC,MAAM,CAAC,MAAgB,CAAC,CAAC;QAClC,CAAC;KACF,CAAC;IAEF,OAAO;QACL,SAAS;QACT,IAAI,GAAG;YACL,OAAO,GAAG,CAAC;QACb,CAAC;QACD,OAAO,CAAC,EAAE;YACR,MAAM,MAAM,GAAG,GAAG,GAAG,EAAE,CAAC;YACxB,IAAI,KAAK,GAAG,CAAC,CAAC;YACd,OAAO,KAAK,EAAE,GAAG,SAAS,EAAE,CAAC;gBAC3B,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;gBACf,IAAI,KAAK,GAAG,QAAQ,CAAC;gBACrB,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;oBAC7B,IAAI,CAAC,CAAC,EAAE,IAAI,MAAM,IAAI,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC;wBACnC,KAAK,GAAG,CAAC,CAAC,EAAE,CAAC;wBACb,KAAK,GAAG,EAAE,CAAC;oBACb,CAAC;gBACH,CAAC;gBACD,IAAI,KAAK,KAAK,CAAC,CAAC;oBAAE,MAAM;gBACxB,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC;gBAC7B,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;gBACX,CAAC,CAAC,EAAE,EAAE,CAAC;gBACP,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC;oBAAE,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC;YACzC,CAAC;YACD,GAAG,GAAG,MAAM,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "obix-test",
+  "version": "0.3.0",
+  "description": "Headless verification for the OBIX suite — virtual-clock component harness and function/class projection equivalence checking.",
+  "keywords": ["obix", "testing", "web-components", "equivalence", "virtual-time"],
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "node --test test/"
+  },
+  "dependencies": {
+    "obix-core": "0.3.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/obinexusmk2/obix-monorepo-2026.git",
+    "directory": "suite/obix-test"
+  }
+}