@tinkerlandai/indiana-iam 0.7.0 → 0.7.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tinkerlandai/indiana-iam",
-  "version": "0.7.0",
+  "version": "0.7.1",
   "description": "Build-time Indiana App Manifest (IAM) generator for Next.js, Vite and React Native / Expo source.",
   "license": "UNLICENSED",
   "repository": {
@@ -59,6 +59,7 @@
     "micromark-extension-gfm": "3.0.0",
     "micromark-extension-mdxjs": "3.0.0",
     "pako": "3.0.2",
+    "parse5": "7.3.0",
     "sharp": "0.35.5",
     "tailwind-merge": "3.7.0",
     "tailwindcss": "4.3.3",

package/src/document-material.mjs

@@ -1,4 +1,4 @@
-import { documentNodes } from "./node-hashes.mjs";
+import { documentStructure } from "./node-hashes.mjs";
 import { documentDom } from "./dom-payload.mjs";
 import { sha256, canonical } from "./integrity.mjs";
 const resourceHashes = new WeakMap();
@@ -36,7 +36,7 @@ export function documentMaterial(
     (document) => document.documentKey === render.documentKey,
   );
   if (!document) throw Error("Missing IAM preview document");
-  const concreteNodes = documentNodes(document);
+  const concreteNodes = documentStructure(document);
   const elementKeys = new Set(concreteNodes.map((node) => node.elementKey));
   const ui = manifest.routeTree.ui;
   const collections =

package/src/library-entry.mjs

@@ -7,6 +7,7 @@ import {privateUrl}from'./privacy.mjs';
 import{renderGuardFor}from'./render-index.mjs';
 import { documentScript } from "./shared-scripts.mjs";
 import { documentNodes } from './node-hashes.mjs';
+export { documentStructure as iamDocumentStructure } from './node-hashes.mjs';
 export { documentNodes as iamDocumentNodes } from './node-hashes.mjs';
 export { documentDom as iamDocumentDom } from './dom-payload.mjs';
 export { rebindIamSource } from './rebind.mjs';

package/src/node-hashes.mjs

@@ -1,7 +1,7 @@
 import { documentDom } from "./dom-payload.mjs";
 import { canonical, identity, sealNodes, sealDocument } from './integrity.mjs';
-import { dependency } from './dependencies.mjs';
 import { sourceMappingsHash } from './compact-dom.mjs';
+import { parseFragment } from 'parse5';
 
 /** HTML already owns the DOM values and ordering. Store only the source map
  * in preorder, rather than repeating attributes, text and every tree edge. */
@@ -20,15 +20,32 @@ export function expandDomNodes(document, body, deriveTextId) {
   if(body.childNodes.length!==1||visit(body.firstChild,null,0)!==document.rootNodeId||index!==document.nodes.length)throw Error('HTML-derived DOM coverage differs');
   return result;
 }
-function domNodes(document){
-  const decoded = {...document, ...documentDom(document)};
-  const {JSDOM}=dependency('jsdom').value,dom=new JSDOM('<!doctype html><html><body>'+decoded.html+'</body></html>');
-  try{return expandDomNodes(decoded,dom.window.document.body,(page,parentId,index)=>identity('node',{page,parentId,index,kind:3}));}finally{dom.window.close();}
+
+/** Adapt the same HTML parser's inert tree to the existing source-map expansion.
+ * Maps need tree values, not a window, CSSOM, scripts or derived node hashes. */
+export function documentStructure(document) {
+  const decoded = { ...document, ...documentDom(document) };
+  const adapt = node => ({
+    nodeType: node.tagName ? 1 : node.nodeName === '#text' ? 3 : 8,
+    tagName: node.tagName,
+    data: node.value,
+    get attributes() {
+      return (node.attrs ?? []).map(attr => ({
+        name: attr.prefix ? attr.prefix + ':' + attr.name : attr.name,
+        value: attr.value,
+      }));
+    },
+    getAttribute(name) { return this.attributes.find(attr => attr.name === name)?.value ?? null; },
+    get childNodes() { return (node.childNodes ?? []).map(adapt); },
+    get firstChild() { return this.childNodes[0]; },
+  });
+  return expandDomNodes(decoded, adapt(parseFragment(decoded.html)),
+    (page, parentId, index) => identity('node', { page, parentId, index, kind: 3 }));
 }
 
 /** Node hashes are pure derived values. IDs, source mappings and algorithms never change. */
 export function documentNodes(document) {
-  const values=domNodes(document);
+  const values=documentStructure(document);
   sealNodes(values, document.rootNodeId);
   return values;
 }

package/src/tab-scenes.mjs

@@ -1,7 +1,6 @@
-import { JSDOM, VirtualConsole } from "jsdom";
 import { documentDom } from "./dom-payload.mjs";
 import { createStateMachine } from "./ui-state-machine.mjs";
-import { previewUiDocument } from "./ui-preview.mjs";
+import { inspectUiDocument, inertUiDocument } from "./ui-preview.mjs";
 import {graphSource} from './graph-sources.mjs';
 
 /** Build thumbnail states and edges by dispatching the IAM's actual scalar transitions. */
@@ -13,12 +12,9 @@ export function tabUiScenes(manifest, tabKey) {
     document = manifest.documents.find(
       (d) => d.documentKey === render.documentKey,
     );
-  const dom = new JSDOM(documentDom(document).html, {
-    virtualConsole: new VirtualConsole(),
-  });
+  const doc = inertUiDocument(documentDom(document).html);
   try {
-    const doc = dom.window.document,
-      nodes = new Map(
+    const nodes = new Map(
         [...doc.querySelectorAll("[data-iam-node]")].map((n) => [
           n.getAttribute("data-iam-node"),
           n,
@@ -118,32 +114,31 @@ export function tabUiScenes(manifest, tabKey) {
           ([key, value]) => initial[key] !== value || key === tab.variableKey,
         ),
       );
-      const options = { ...base, values: { ...values, ...changed } },
-        preview = previewUiDocument(manifest, document, options),
-        sceneDom = new JSDOM(preview.html, {
-          virtualConsole: new VirtualConsole(),
-        });
-      const focused = [
-        ...sceneDom.window.document.querySelectorAll("[data-iam-node]"),
-      ]
-        .find((n) => n.getAttribute("data-iam-node") === base.focusNodeId)
-        ?.cloneNode(true);
-      focused
-        ?.querySelectorAll("[hidden],[role=tablist]")
-        .forEach((n) => n.remove());
-      const headings = focused
-        ? [...focused.querySelectorAll("h1,h2,h3,h4,label,[role=columnheader]")]
-            .map((n) => n.textContent.replace(/\s+/g, " ").trim())
-            .filter(Boolean)
-        : [];
-      const content = focused?.textContent.replace(/\s+/g, " ").trim() ?? "";
-      const fields = focused
-        ? [...focused.querySelectorAll("input,textarea,select")].map((n) => ({
-            tag: n.tagName.toLowerCase(),
-            label: n.getAttribute("aria-label") ?? "",
-            placeholder: n.getAttribute("placeholder") ?? "",
-          }))
-        : [];
+      const options = { ...base, values: { ...values, ...changed } };
+      const { preview, headings, content, fields } = inspectUiDocument(
+        manifest, document, options, (doc, preview) => {
+          const focused = [...doc.querySelectorAll("[data-iam-node]")]
+            .find((n) => n.getAttribute("data-iam-node") === base.focusNodeId)
+            ?.cloneNode(true);
+          focused?.querySelectorAll("[hidden],[role=tablist]")
+            .forEach((n) => n.remove());
+          return {
+            preview,
+            headings: focused
+              ? [...focused.querySelectorAll("h1,h2,h3,h4,label,[role=columnheader]")]
+                  .map((n) => n.textContent.replace(/\s+/g, " ").trim()).filter(Boolean)
+              : [],
+            content: focused?.textContent.replace(/\s+/g, " ").trim() ?? "",
+            fields: focused
+              ? [...focused.querySelectorAll("input,textarea,select")].map((n) => ({
+                  tag: n.tagName.toLowerCase(),
+                  label: n.getAttribute("aria-label") ?? "",
+                  placeholder: n.getAttribute("placeholder") ?? "",
+                }))
+              : [],
+          };
+        },
+      );
       const allowedIds = new Set([
         ...ancestors.map((n) => n.getAttribute("data-iam-node")),
         ...(scope
@@ -177,7 +172,6 @@ export function tabUiScenes(manifest, tabKey) {
         transitionKey: result.transitionKey,
         changedNodeIds: tab.contentNodeIds ?? [],
       });
-      sceneDom.window.close();
     }
     const edges = [];
     for (const from of scenes)
@@ -209,6 +203,6 @@ export function tabUiScenes(manifest, tabKey) {
       }
     return { tabKey, scenes, edges };
   } finally {
-    dom.window.close();
+    doc.body.replaceChildren();
   }
 }

package/src/ui-preview.mjs

@@ -1,6 +1,6 @@
-import { JSDOM, VirtualConsole } from "jsdom";
+import { JSDOM } from "jsdom";
 import { documentDom } from "./dom-payload.mjs";
-import {documentNodes} from './node-hashes.mjs';
+import {documentStructure} from './node-hashes.mjs';
 import { createStateMachine } from "./ui-state-machine.mjs";
 import { applySourceAttributes } from "./source-attributes.mjs";
 import {
@@ -10,14 +10,27 @@ import {
 
 /** Inert source alternatives for UI inspection. This never changes the admitted render or SDK targets. */
 export function previewUiDocument(manifest, document, options = {}) {
+  return inspectUiDocument(manifest, document, options, (doc, preview) => ({
+    html: doc.documentElement.outerHTML,
+    ...preview,
+  }));
+}
+
+/** An isolated inert document needs no browsing context, CSSOM or per-scene window. */
+export function inertUiDocument(html) {
+  const fragment = JSDOM.fragment(html);
+  const doc = fragment.ownerDocument.implementation.createHTMLDocument();
+  doc.body.replaceChildren(fragment);
+  return doc;
+}
+
+/** Inspect an inert preview without serializing and reparsing it. */
+export function inspectUiDocument(manifest, document, options, inspect) {
   const graph = manifest.routeTree,
     render = graph.renders.find((r) => r.documentKey === document.documentKey);
   if (!render) throw Error("Unknown UI preview render");
-  const dom = new JSDOM(documentDom(document).html, {
-    virtualConsole: new VirtualConsole(),
-  });
+  const doc = inertUiDocument(documentDom(document).html);
   try {
-    const doc = dom.window.document;
     const nodes = new Map(
       [...doc.querySelectorAll("[data-iam-node]")].map((n) => [
         n.getAttribute("data-iam-node"),
@@ -194,17 +207,21 @@ export function previewUiDocument(manifest, document, options = {}) {
       options.strategy === "content",
       selections,
     );
+    let mapped;
+    const sourceNode = id => {
+      mapped ??= new Map(documentStructure(document).map(n => [n.nodeId, n]));
+      return mapped.get(id);
+    };
     if(options.strategy==='content') {
-      const mapped=new Map(documentNodes(document).map(n=>[n.nodeId,n]));
       const sources=new Map(manifest.elements.map(e=>[e.elementKey,e.source]));
       for(const field of doc.querySelectorAll('[data-iam-observation="remote"],[data-iam-observation="unobserved"],[data-iam-input-unobserved]')) {
         const hidden=field.closest('[hidden]');if(hidden&&(!focus||focus.contains(hidden)))continue;
-        const id=field.getAttribute('data-iam-node'),node=mapped.get(id),source=node&&(node.source??sources.get(node.elementKey));if(source&&!unobserved.some(u=>u.groupKey===id))unobserved.push({groupKey:id,expression:'Data unobserved',source});
+        const id=field.getAttribute('data-iam-node'),node=sourceNode(id),source=node&&(node.source??sources.get(node.elementKey));if(source&&!unobserved.some(u=>u.groupKey===id))unobserved.push({groupKey:id,expression:'Data unobserved',source});
       }
     }
     if (focus) {
       const template=focus.closest('[data-iam-source-template="unobserved"]');
-      if(template){const id=template.getAttribute('data-iam-node'),node=documentNodes(document).find(n=>n.nodeId===id),source=node&&(node.source??manifest.elements.find(e=>e.elementKey===node.elementKey)?.source);if(source)unobserved.push({groupKey:id,expression:'Source template · collection data unobserved',source});}
+      if(template){const id=template.getAttribute('data-iam-node'),node=sourceNode(id),source=node&&(node.source??manifest.elements.find(e=>e.elementKey===node.elementKey)?.source);if(source)unobserved.push({groupKey:id,expression:'Source template · collection data unobserved',source});}
     }
     const assumptions = [...groups].flatMap(([key, rows]) => {
       if (!selections.has(key)) return [];
@@ -246,16 +263,15 @@ export function previewUiDocument(manifest, document, options = {}) {
         requires,
       };
     });
-    return {
-      html: doc.documentElement.outerHTML,
+    return inspect(doc, {
       assumptions,
       conditionChoices,
       values,
       componentChoices,
       collectionChoices,
       unobserved,
-    };
+    });
   } finally {
-    dom.window.close();
+    doc.body.replaceChildren();
   }
 }