obix-adapter-native 0.2.1

package/README.md

@@ -0,0 +1,31 @@
+# obix-adapter-native
+
+**The Native projection — the only OBIX adapter that touches the DOM.**
+
+```bash
+npm install obix-adapter-native
+```
+
+## API
+
+```ts
+import { mount } from "obix-adapter-native";
+const handle = mount(artifact, document.querySelector("#app"), { props: { limitSeconds: 5 } });
+handle.instance.dispatch("Start");
+handle.unmount();
+```
+
+Builds the DOM from `artifact.template`, wires `obix-runtime` bindings by
+child-index path, and drives state through the **reactive** projection — so every
+transition still goes through `obix-ir.applyAction`.
+
+## Dependency role
+
+`obix-spec`, `obix-ir`, `obix-adapter-reactive`, `obix-runtime`. It is the single
+DOM boundary: SSR and the four pure adapters never import it, and
+`obix-adapter-ssr` structurally cannot.
+
+## Level 0 status
+
+✅ `mount`, text / attribute / boolean / ARIA bindings, single-element `obix:if`,
+native events, `every` effects. Deferred: loops, slots, composition, hydration.

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { type ReactiveInstance } from "obix-adapter-reactive";
+import type { DOPArtifact, State, Props } from "obix-spec";
+export interface MountHandle<S extends object, P extends object> {
+    instance: ReactiveInstance<S, P>;
+    unmount(): void;
+}
+export interface MountOptions<S extends object, P extends object> {
+    state?: S;
+    props?: Partial<P>;
+}
+export declare function mount<S extends object = State, P extends object = Props>(artifact: DOPArtifact<S, P>, container: Element, opts?: MountOptions<S, P>): MountHandle<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":"AAWA,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAW1E,OAAO,KAAK,EACV,WAAW,EACX,KAAK,EACL,KAAK,EAGN,MAAM,WAAW,CAAC;AAEnB,MAAM,WAAW,WAAW,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM;IAC7D,QAAQ,EAAE,gBAAgB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACjC,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,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;CACpB;AAED,wBAAgB,KAAK,CAAC,CAAC,SAAS,MAAM,GAAG,KAAK,EAAE,CAAC,SAAS,MAAM,GAAG,KAAK,EACtE,QAAQ,EAAE,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,EAC3B,SAAS,EAAE,OAAO,EAClB,IAAI,GAAE,YAAY,CAAC,CAAC,EAAE,CAAC,CAAM,GAC5B,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC,CA0EnB"}

package/dist/index.js

@@ -0,0 +1,112 @@
+import { toReactive } from "obix-adapter-reactive";
+import { bindText, bindAttr, bindBool, bindAria, bindEvent, bindPresence, createBindingGroup, } from "obix-runtime";
+import { SCOPE_ATTR } from "obix-spec";
+export function mount(artifact, container, opts = {}) {
+    if (!artifact.template) {
+        throw new Error(`[OBIX] mount("${artifact.name}"): artifact has no template descriptor`);
+    }
+    const instance = toReactive(artifact)(opts);
+    const group = createBindingGroup();
+    const scope = () => {
+        const s = instance.state;
+        const p = instance.props;
+        const d = {};
+        for (const [k, fn] of Object.entries(artifact.derived)) {
+            try {
+                d[k] = fn(instance.state, instance.props);
+            }
+            catch {
+                d[k] = undefined;
+            }
+        }
+        return { ...p, ...s, ...d };
+    };
+    const resolve = (expr) => {
+        const parts = expr.trim().split(".");
+        let cur = scope()[parts[0]];
+        for (let i = 1; i < parts.length && cur != null; i++)
+            cur = cur[parts[i]];
+        return cur;
+    };
+    const nodeByPath = new Map();
+    const root = buildElement(artifact.template.root, [], nodeByPath);
+    for (const b of artifact.template.bindings) {
+        const key = b.path.join(".");
+        const node = nodeByPath.get(key);
+        if (!node)
+            continue;
+        if (b.kind === "text") {
+            group.add(bindText(node, () => resolve(b.expr)));
+        }
+        else if (b.kind === "attr") {
+            group.add(bindAttr(node, b.target, () => resolve(b.expr)));
+        }
+        else if (b.kind === "bool") {
+            group.add(bindBool(node, b.target, () => resolve(b.expr)));
+        }
+        else if (b.kind === "aria") {
+            group.add(bindAria(node, b.target, () => resolve(b.expr)));
+        }
+        else if (b.kind === "conditional") {
+            const el = node;
+            const anchor = document.createComment(`obix:if ${b.expr}`);
+            el.parentNode?.insertBefore(anchor, el.nextSibling);
+            group.add(bindPresence(el, anchor, () => resolve(b.expr)));
+        }
+    }
+    for (const ev of artifact.template.events) {
+        const node = nodeByPath.get(ev.path.join("."));
+        if (!node)
+            continue;
+        group.addCleanup(bindEvent(node, ev.event, () => instance.dispatch(ev.action)));
+    }
+    const unsub = instance.subscribe(() => group.update());
+    if (artifact.style?.token)
+        root.setAttribute(SCOPE_ATTR, artifact.style.token);
+    container.appendChild(root);
+    instance.startEffects();
+    return {
+        instance,
+        unmount() {
+            instance.stopEffects();
+            unsub();
+            group.dispose();
+            root.remove();
+        },
+    };
+}
+function buildElement(el, path, index) {
+    const node = document.createElement(el.tag);
+    index.set(path.join("."), node);
+    for (const a of el.attrs) {
+        if (a.directive === "event" || a.directive === "conditional")
+            continue;
+        if (a.interpolation != null)
+            continue;
+        if (a.value === null)
+            node.setAttribute(a.name, "");
+        else
+            node.setAttribute(a.name, a.value);
+    }
+    el.children.forEach((child, i) => {
+        const childPath = [...path, i];
+        const dom = buildNode(child, childPath, index);
+        if (dom)
+            node.appendChild(dom);
+    });
+    return node;
+}
+function buildNode(node, path, index) {
+    if (node.kind === "text") {
+        const t = document.createTextNode(node.value.replace(/\s+/g, " "));
+        index.set(path.join("."), t);
+        return t;
+    }
+    if (node.kind === "interpolation") {
+        const t = document.createTextNode("");
+        index.set(path.join("."), t);
+        return t;
+    }
+    return buildElement(node, path, index);
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "obix-adapter-native",
+  "version": "0.2.1",
+  "description": "OBIX Native projection — the only adapter that touches the DOM. Mounts a component using the reactive projection + obix-runtime bindings. Depends on spec, ir, obix-adapter-reactive and obix-runtime.",
+  "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",
+    "obix-adapter-reactive": "0.2.1",
+    "obix-runtime": "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-native"
+  }
+}