obix-template 0.2.1

package/README.md

@@ -0,0 +1,34 @@
+# obix-template
+
+**Pure semantic template analysis for OBIX.**
+
+```bash
+npm install obix-template
+```
+
+## Purpose
+
+| Export | Role |
+|---|---|
+| `analyzeBindings(root)` | `BindingDescriptor[]` — text / attr / bool / aria / conditional, each with a child-index `path` |
+| `analyzeEvents(root)` | `EventDescriptor[]` — every `on:event="Action"` |
+| `analyzeTemplate(root)` | `TemplateDescriptor` = root + bindings + events |
+| `extractDependencies(expr)` | root identifier(s) an expression reads |
+| `resolveBinding(expr, scope)` | evaluate an identifier / dotted path against a flat scope |
+| `bindingScope(state, props, derived)` | build that flat scope (derived > state > props) |
+
+## Constraints
+
+- **No JavaScript parsing.** Level 0 binding expressions are identifiers or
+  dotted paths.
+- **No DOM.** Returns plain descriptors; `obix-adapter-native` and
+  `obix-adapter-ssr` decide what to do with them.
+
+## Dependency role
+
+Depends only on `obix-spec`. Consumed by `obix-compiler`,
+`obix-accessibility` and `obix-language-server`.
+
+## Level 0 status
+
+✅ Complete for the Level 0 binding set.

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+import type { TemplateElement, TemplateDescriptor, BindingDescriptor, EventDescriptor } from "obix-spec";
+export declare function extractDependencies(expr: string): string[];
+export declare function analyzeBindings(root: TemplateElement): BindingDescriptor[];
+export declare function analyzeEvents(root: TemplateElement): EventDescriptor[];
+export declare function analyzeTemplate(root: TemplateElement): TemplateDescriptor;
+export declare function resolveBinding(expr: string, scope: Record<string, unknown>): unknown;
+export declare function bindingScope(state: Record<string, unknown>, props: Record<string, unknown>, derived: Record<string, unknown>): Record<string, unknown>;
+//# 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,KAAK,EACV,eAAe,EACf,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EAChB,MAAM,WAAW,CAAC;AAKnB,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAI1D;AAGD,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,iBAAiB,EAAE,CAwB1E;AAGD,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,GAAG,eAAe,EAAE,CAWtE;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,GAAG,kBAAkB,CAEzE;AAOD,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAQpF;AAGD,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC/B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzB"}

package/dist/index.js

@@ -0,0 +1,78 @@
+const PATH = /^[A-Za-z_$][\w$]*(?:\.[A-Za-z_$][\w$]*)*$/;
+export function extractDependencies(expr) {
+    const e = expr.trim();
+    if (!PATH.test(e))
+        return [];
+    return [e.split(".")[0]];
+}
+export function analyzeBindings(root) {
+    const out = [];
+    walk(root, [], (node, path) => {
+        if (node.kind === "interpolation") {
+            out.push({ kind: "text", target: "", expr: node.expr, deps: extractDependencies(node.expr), path });
+            return;
+        }
+        if (node.kind !== "element")
+            return;
+        for (const attr of node.attrs) {
+            if (attr.directive === "event")
+                continue;
+            if (attr.directive === "conditional") {
+                const expr = (attr.value ?? "").trim();
+                out.push({ kind: "conditional", target: "", expr, deps: extractDependencies(expr), path });
+                continue;
+            }
+            if (!attr.interpolation)
+                continue;
+            const expr = attr.interpolation;
+            const deps = extractDependencies(expr);
+            if (attr.directive === "aria")
+                out.push({ kind: "aria", target: attr.name, expr, deps, path });
+            else if (attr.directive === "bool")
+                out.push({ kind: "bool", target: attr.name, expr, deps, path });
+            else
+                out.push({ kind: "attr", target: attr.name, expr, deps, path });
+        }
+    });
+    return out;
+}
+export function analyzeEvents(root) {
+    const out = [];
+    walk(root, [], (node, path) => {
+        if (node.kind !== "element")
+            return;
+        for (const attr of node.attrs) {
+            if (attr.directive === "event" && attr.value) {
+                out.push({ event: attr.name.slice(3), action: attr.value, path });
+            }
+        }
+    });
+    return out;
+}
+export function analyzeTemplate(root) {
+    return { root, bindings: analyzeBindings(root), events: analyzeEvents(root) };
+}
+export function resolveBinding(expr, scope) {
+    const parts = expr.trim().split(".");
+    let cur = scope[parts[0]];
+    for (let i = 1; i < parts.length; i++) {
+        if (cur == null)
+            return undefined;
+        cur = cur[parts[i]];
+    }
+    return cur;
+}
+export function bindingScope(state, props, derived) {
+    return { ...props, ...state, ...derived };
+}
+function walk(node, path, visit) {
+    visit(node, path);
+    node.children.forEach((child, i) => {
+        const childPath = [...path, i];
+        if (child.kind === "element")
+            walk(child, childPath, visit);
+        else
+            visit(child, childPath);
+    });
+}
+//# 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,36 @@
+{
+  "name": "obix-template",
+  "version": "0.2.1",
+  "description": "Pure semantic template analysis for OBIX: binding + event descriptor construction and dependency extraction. No JS parsing, no DOM. Depends only on obix-spec.",
+  "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"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20.11.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/obinexusmk2/obix-monorepo-2026.git",
+    "directory": "packages/obix-template"
+  }
+}