obix-adapter-oop 0.2.1

package/README.md

@@ -0,0 +1,32 @@
+# obix-adapter-oop
+
+**The OOP projection — a generated class.**
+
+```bash
+npm install obix-adapter-oop
+```
+
+## API
+
+```ts
+const Timer = toOOP(artifact);
+const t = new Timer({ props: { limitSeconds: 5 } });
+t.Start();          // generated method -> dispatch("Start") -> applyAction(...)
+t.Tick();
+t.state;            // read-only; assigning throws
+t.props;            // frozen
+t.finished;         // generated derived getter
+t.render(); t.validate();
+```
+
+`state` and `props` are `#private`. `props` is frozen. Assigning `state` throws.
+Every generated `Start` / `Tick` / … method delegates to `dispatch`, which calls
+`obix-ir.applyAction`. There is never a second implementation of an action.
+
+## Dependency role
+
+`obix-spec` + `obix-ir`. Consumed by `obix-equivalence` and `obix-timer`.
+
+## Level 0 status
+
+✅ Complete.

package/dist/index.d.ts

@@ -0,0 +1,18 @@
+import type { DOPArtifact, State, Props, Payload, ActionTrace, ValidationResult } from "obix-spec";
+export interface OOPInstance<S extends object, P extends object> {
+    readonly state: S;
+    readonly props: P;
+    dispatch(actionName: string, payload?: Payload): S;
+    replay(trace: ActionTrace): S;
+    render(): string;
+    validate(): ValidationResult;
+    [action: string]: unknown;
+}
+export interface OOPConstructor<S extends object, P extends object> {
+    new (opts?: {
+        state?: S;
+        props?: Partial<P>;
+    }): OOPInstance<S, P>;
+}
+export declare function toOOP<S extends object = State, P extends object = Props>(artifact: DOPArtifact<S, P>): OOPConstructor<S, P>;
+//# 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":"AASA,OAAO,KAAK,EACV,WAAW,EACX,KAAK,EACL,KAAK,EACL,OAAO,EACP,WAAW,EACX,gBAAgB,EACjB,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IAC7D,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,CAAC,CAAC;IACnD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,CAAC,CAAC;IAC9B,MAAM,IAAI,MAAM,CAAC;IACjB,QAAQ,IAAI,gBAAgB,CAAC;IAC7B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IAChE,KAAK,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,CAAC,CAAC;QAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;KAAE,GAAG,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;CACnE;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,KAAK,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK,EACtE,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,GAC1B,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CA6DtB"}

package/dist/index.js

@@ -0,0 +1,54 @@
+import { applyAction } from "obix-ir";
+export function toOOP(artifact) {
+    class Component {
+        #state;
+        #props;
+        constructor(opts = {}) {
+            this.#state = opts.state ?? artifact.initialState;
+            this.#props = Object.freeze({ ...artifact.props, ...(opts.props ?? {}) });
+        }
+        get state() {
+            return this.#state;
+        }
+        set state(_v) {
+            throw new TypeError(`[OBIX] ${artifact.name}.state is read-only`);
+        }
+        get props() {
+            return this.#props;
+        }
+        dispatch(actionName, payload) {
+            this.#state = applyAction(artifact, this.#state, actionName, payload, this.#props);
+            return this.#state;
+        }
+        replay(trace) {
+            for (const [name, payload] of trace)
+                this.dispatch(name, payload);
+            return this.#state;
+        }
+        render() {
+            return artifact.render ? artifact.render(this.#state, this.#props) : "";
+        }
+        validate() {
+            return artifact.validate ? artifact.validate(this.#state, this.#props) : { valid: true, violations: [] };
+        }
+    }
+    for (const name of Object.keys(artifact.actions)) {
+        Object.defineProperty(Component.prototype, name, {
+            value(payload) {
+                return this.dispatch(name, payload);
+            },
+            writable: false,
+            enumerable: false,
+        });
+    }
+    for (const name of Object.keys(artifact.derived)) {
+        Object.defineProperty(Component.prototype, name, {
+            get() {
+                return artifact.derived[name](this.state, this.props);
+            },
+            enumerable: false,
+        });
+    }
+    return Component;
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAwBtC,MAAM,UAAU,KAAK,CACnB,QAA2B;IAE3B,MAAM,SAAS;QACb,MAAM,CAAI;QACV,MAAM,CAAI;QAEV,YAAY,OAA0C,EAAE;YACtD,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,YAAY,CAAC;YAClD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,EAAE,GAAG,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,CAAM,CAAC;QACjF,CAAC;QAED,IAAI,KAAK;YACP,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QACD,IAAI,KAAK,CAAC,EAAK;YACb,MAAM,IAAI,SAAS,CAAC,UAAU,QAAQ,CAAC,IAAI,qBAAqB,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,KAAK;YACP,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,QAAQ,CAAC,UAAkB,EAAE,OAAiB;YAC5C,IAAI,CAAC,MAAM,GAAG,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YACnF,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM,CAAC,KAAkB;YACvB,KAAK,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,KAAK;gBAAE,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAClE,OAAO,IAAI,CAAC,MAAM,CAAC;QACrB,CAAC;QAED,MAAM;YACJ,OAAO,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1E,CAAC;QAED,QAAQ;YACN,OAAO,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAAC;QAC3G,CAAC;KACF;IAGD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE;YAC/C,KAAK,CAAkB,OAAiB;gBACtC,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACtC,CAAC;YACD,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;IAGD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACjD,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,SAAS,EAAE,IAAI,EAAE;YAC/C,GAAG;gBACD,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YACzD,CAAC;YACD,UAAU,EAAE,KAAK;SAClB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,SAA4C,CAAC;AACtD,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "obix-adapter-oop",
+  "version": "0.2.1",
+  "description": "OBIX OOP projection — a generated class with private state/props, frozen props, read-only external state, and generated action methods that all delegate to obix-ir.applyAction. Depends on obix-spec and obix-ir.",
+  "license": "MIT",
+  "type": "module",
+  "private": false,
+  "sideEffects": false,
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json"
+  },
+  "dependencies": {
+    "obix-spec": "0.2.1",
+    "obix-ir": "0.2.1"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/obinexusmk2/obix-monorepo-2026.git",
+    "directory": "packages/obix-adapter-oop"
+  }
+}