@tinkerlandai/indiana-iam 0.3.0 → 0.4.0

package/src/build-options.d.ts

@@ -14,7 +14,7 @@ export type IndianaIamBuildOptions = {
   strict?: boolean;
   /** Font family declared by the compiled CSS that renders the root element. */
   rootFont?: string;
-  /** Drop inline SVG resources from compiled CSS instead of skipping the CSS. */
+  /** Drop inline SVG resources with a coverage gap instead of skipping the CSS (default: true). */
   omitSvgResources?: boolean;
   logger?: BuildLogger;
   /** Key holding only app-manifests:write; defaults to `INDIANA_IAM_KEY`. Without one the IAM is not uploaded. */

package/src/build-runtime.mjs

@@ -1,10 +1,13 @@
 import fs from "node:fs/promises";
 import { expandDomNodes } from './node-hashes.mjs';
+import {applySourceAttributes} from './source-attributes.mjs';
+import {applySourceCollections,markUnobservedData,checkedCollectionFragment} from './source-collections.mjs';
 // Only these two reviewed local assets form the executable preview runtime.
 const machine = await fs.readFile(new URL("../assets/state-machine.js", import.meta.url), "utf8");
+await fs.writeFile(new URL('./ui-state-machine.mjs', import.meta.url), '/* Generated from assets/state-machine.js by build-runtime.mjs. */\n'+machine);
 const controller = await fs.readFile(new URL("../assets/document-controller.js", import.meta.url), "utf8");
 if (!machine.includes("export function createStateMachine(")) throw new Error("Unexpected state runtime export");
-await fs.writeFile(new URL("../assets/document-runtime.js", import.meta.url), "/* Generated by scripts/build-runtime.mjs. */\n(() => {\n" + machine.replace("export function createStateMachine(", "function createStateMachine(") + "\n" + controller + "\n})();\n");
+await fs.writeFile(new URL("../assets/document-runtime.js", import.meta.url), "/* Generated by scripts/build-runtime.mjs. */\n(() => {\n" + machine.replace("export function createStateMachine(", "function createStateMachine(") + "\n" + [checkedCollectionFragment,applySourceAttributes,applySourceCollections,markUnobservedData].map(fn=>fn.toString()).join('\n')+'\n'+ controller + "\n})();\n");
 const viewerUrl=new URL('../assets/viewer.js',import.meta.url),viewer=await fs.readFile(viewerUrl,'utf8');
 if(!viewer.includes('/* BEGIN HTML DOM DERIVATION */'))throw Error('Missing DOM derivation asset boundary');
 await fs.writeFile(viewerUrl,viewer.replace(/\/\* BEGIN HTML DOM DERIVATION \*\/[\s\S]*?\/\* END HTML DOM DERIVATION \*\//,'/* BEGIN HTML DOM DERIVATION */\n'+expandDomNodes.toString()+'\n  /* END HTML DOM DERIVATION */'));

package/src/build-styles.mjs

@@ -30,8 +30,8 @@ function checkedMounts(mounts) {
 }
 
 /** Explicit public build inputs only. Never runs builds, reads env, downloads URLs or imports App code. */
-export async function attachBuildStyles(manifest, { root, files = [], publicFiles = [], optimizePublicImages = false, rootFont = "", omitSvgResources = false, mounts = nextStaticMounts() }) {
-  if (!Array.isArray(files) || files.length > 16 || !Array.isArray(publicFiles) || publicFiles.length > 128 || (!files.length && !publicFiles.length)) throw new Error("Choose up to 16 CSS files and 128 public assets");
+export async function attachBuildStyles(manifest, { root, files = [], publicFiles = [], referencedImages = false, optimizePublicImages = false, rootFont = "", omitSvgResources = false, mounts = nextStaticMounts() }) {
+  if (!Array.isArray(files) || files.length > 16 || !Array.isArray(publicFiles) || publicFiles.length > 128 || (!files.length && !publicFiles.length && !referencedImages)) throw new Error("Choose up to 16 CSS files and 128 public assets");
   if (rootFont && !/^[A-Za-z][A-Za-z0-9 _-]{0,63}$/.test(rootFont)) throw new Error("Invalid root font family");
   root = await fs.realpath(root);
   const cssTree = dependency("css-tree").value;
@@ -45,9 +45,9 @@ export async function attachBuildStyles(manifest, { root, files = [], publicFile
   const fileOf = pathname => { const mount = [...served].sort((a, b) => b.urlPath.length - a.urlPath.length).find(m => pathname.startsWith(m.urlPath)); if (!mount) throw new Error("CSS asset is outside the public build directories"); return mount.directory + "/" + pathname.slice(mount.urlPath.length); };
   const inputs = new Map(), assets = new Map(manifest.assets.map(a => [a.assetKey, a]));
   let total = 0, publicSourceBytes = 0;
-  async function read(file, publicImage = false) {
+  async function read(file, publicImage = false, sourceImage = false) {
     const absolute = path.resolve(root, file), real = await fs.realpath(absolute);
-    if ((await fs.lstat(absolute)).isSymbolicLink() || !allowed.some(base => real.startsWith(base + path.sep))) throw new Error("Asset must be inside a real public build directory");
+    if ((await fs.lstat(absolute)).isSymbolicLink() || !(sourceImage ? real.startsWith(root+path.sep) : allowed.some(base => real.startsWith(base + path.sep)))) throw new Error("Asset must be inside a real public build directory");
     const relative = path.relative(root, real).split(path.sep).join("/");
     if (inputs.has(relative)) return inputs.get(relative);
     const stat = await fs.stat(real);
@@ -113,14 +113,50 @@ export async function attachBuildStyles(manifest, { root, files = [], publicFile
       assets.set(key, {assetKey:key, sourceUrl, mime, bytes:bytes.length, sha256:digest, dataUrl:'data:'+mime+';base64,'+bytes.toString('base64')});
     }
   }
+  if(referencedImages){
+    const urls=[...new Set(manifest.documents.flatMap(doc=>documentNodes(doc).map(n=>n.attributes?.src).filter(v=>typeof v==='string'&&/^\/(?!\/)[A-Za-z0-9_./-]+\.(?:png|jpe?g|webp|gif)$/i.test(v))))].sort();
+    if(urls.length>128)throw Error('Referenced image budget exceeded');
+    for(const url of urls){
+      if(assets.size>=128)throw Error('Referenced image budget exceeded');
+      if([...assets.values()].some(a=>a.sourceUrl===url))continue;
+      const source=url.startsWith('/__iam_source__/'),file=source?url.slice('/__iam_source__/'.length):fileOf(url);
+      if(file.split('/').some(p=>!p||p==='..'||source&&p.startsWith('.'))||/(?:^|\/)(?:api|server|secrets?|credentials)(?:\/|\.)/i.test(file))continue;
+      try{
+        const input=await read(file,false,source);let bytes=input.bytes,mime=types.get(path.extname(file).toLowerCase());
+        const valid=mime==='image/png'?bytes.subarray(0,8).equals(Buffer.from([137,80,78,71,13,10,26,10])):mime==='image/jpeg'?bytes[0]===255&&bytes[1]===216&&bytes[2]===255:mime==='image/webp'?bytes.subarray(0,4).toString()==='RIFF'&&bytes.subarray(8,12).toString()==='WEBP':/^GIF8[79]a$/.test(bytes.subarray(0,6).toString());
+        if(!valid)throw Error('Referenced raster signature mismatch');
+        if(bytes.length>65536){
+          const sharp=dependency('sharp').value;if(sharp.versions.sharp!=='0.35.5')throw Error('Pinned image encoder required');
+          const image=sharp(bytes,{limitInputPixels:16777216,failOn:'warning'}),metadata=await image.metadata();if((metadata.pages||1)!==1)throw Error('Animated source images require an explicit adapter');
+          bytes=await image.rotate().resize({width:800,height:800,fit:'inside',withoutEnlargement:true}).webp({quality:90,effort:4}).toBuffer();mime='image/webp';
+          manifest.coverage.gaps.push({code:'REFERENCED_IMAGE_PREVIEW_OPTIMIZED',file,detail:'Build preview profile for rasters over 64 KiB: auto-orient, fit inside 800x800, WebP quality 90; source bytes remain hashed. Lossy preview, not original pixels.'});
+        }
+        const digest=sha256(bytes),assetKey=identity('asset',{sourceUrl:url,mime,sha256:digest});assets.set(assetKey,{assetKey,sourceUrl:url,mime,bytes:bytes.length,sha256:digest,dataUrl:'data:'+mime+';base64,'+bytes.toString('base64')});
+      }catch(error){
+        // A missing reference is a fidelity gap. Unsafe files/budgets fail the packaging step.
+        if(error.code!=='ENOENT')throw error;
+        manifest.coverage.gaps.push({code:'REFERENCED_IMAGE_MISSING',file,detail:'Referenced raster is absent from the local public build; no network fetch performed.'});
+      }
+    }
+  }
   if (optimizePublicImages && publicFiles.length) manifest.coverage.gaps.push({code:'PUBLIC_IMAGES_OPTIMIZED', file:publicFiles[0], detail:'Explicit sharp 0.35.5 profile: auto-orient, fit inside 800x800 without enlargement, WebP quality 90 effort 4; metadata stripped. Source bytes hashed independently; not pixel-identical originals.'});
   const sheets = [], families = new Set();
   for (const file of [...new Set(files)].sort()) {
     if (!file.endsWith(".css")) throw new Error("Compiled CSS file required");
     const input = await read(file), ast = cssTree.parse(new TextDecoder("utf-8", { fatal: true }).decode(input.bytes), { parseCustomProperty: true });
     const urls = [];
+    // A build may retain a remote font import. Keep its local stylesheet, but
+    // never fetch or copy the external dependency into an offline projection.
+    cssTree.walk(ast, { visit: "Atrule", enter(node, item, list) {
+      if (node.name.toLowerCase() !== "import") return;
+      const target = node.prelude?.children?.first;
+      if (!["String", "Url"].includes(target?.type) || !/^(?:https?:)?\/\//i.test(target.value))
+        throw new Error("Precompile CSS imports before packaging");
+      list.remove(item);
+      if (!manifest.coverage.gaps.some(g => g.code === "BUILD_EXTERNAL_STYLESHEET_OMITTED" && g.file === input.relative))
+        manifest.coverage.gaps.push({ code: "BUILD_EXTERNAL_STYLESHEET_OMITTED", file: input.relative, detail: "External CSS import omitted without network access; local compiled styles retained. Remote fonts or rules remain unavailable." });
+    }});
     cssTree.walk(ast, node => {
-      if (node.type === "Atrule" && node.name.toLowerCase() === "import") throw new Error("Precompile CSS imports before packaging");
       if (node.type === "Atrule" && node.name.toLowerCase() === "font-face") node.block?.children.forEach(declaration => { if (declaration.type === "Declaration" && declaration.property === "font-family") families.add(cssTree.generate(declaration.value).replace(/^["']|["']$/g, "")); });
       if (node.type === "Url") urls.push(node);
     });
@@ -128,7 +164,7 @@ export async function attachBuildStyles(manifest, { root, files = [], publicFile
     sheets.push(cssTree.generate(ast));
   }
   if (rootFont && !families.has(rootFont)) throw new Error("Root font must exist in compiled font faces");
-  const css = sheets.join("\n") + "\n.iam-page{min-height:100vh}.iam-icon{display:inline-flex;align-items:center;justify-content:center;width:1.1em;height:1.1em}.iam-placeholder{padding:1rem;border:1px dashed #d4d4d4}" + (rootFont ? "\nbody{font-family:" + JSON.stringify(rootFont) + "," + JSON.stringify(rootFont + " Fallback") + ",sans-serif}" : "");
+  const css = sheets.join("\n") + "\n[hidden]{display:none!important}.iam-state{display:contents}.iam-page{min-height:100vh}.iam-icon{display:inline-flex;align-items:center;justify-content:center;width:1.1em;height:1.1em}.iam-placeholder{padding:1rem;border:1px dashed #d4d4d4}" + (rootFont ? "\nbody{font-family:" + JSON.stringify(rootFont) + "," + JSON.stringify(rootFont + " Fallback") + ",sans-serif}" : "");
   if (/<\/(?:style|script)/i.test(css)) throw new Error("HTML closing tag in compiled CSS");
   if (files.length) for (const doc of manifest.documents) { doc.css = css; sealDocument(doc); }
   // One content-addressed image in the envelope; DOM instances carry references.
@@ -142,6 +178,13 @@ export async function attachBuildStyles(manifest, { root, files = [], publicFile
       doc.html = doc.html.replaceAll('src="' + asset.sourceUrl + '"', 'src="' + reference + '"');
     }
     storeDocumentNodes(doc, nodes, new Map(manifest.elements.map(element => [element.elementKey, element])));
+    // Resource replacement changes element and ancestor hashes. Keep target
+    // fingerprints tied to the final document, never the pre-packaging HTML.
+    const finalNodes=documentNodes(doc);
+    for(const target of manifest.routeTree?.targets??[]){
+      if(target.routeKey!==doc.pageKey)continue;const node=finalNodes.find(n=>n.nodeId===target.nodeId);if(!node)continue;
+      target.contentHash=node.contentHash;if(target.subtreeHash!==undefined)target.subtreeHash=node.subtreeHash;
+    }
   }
   manifest.coverage.gaps = manifest.coverage.gaps.filter(g => g.code !== 'PUBLIC_ASSET_NOT_PACKAGED' || ![...assets.values()].some(a => g.detail.startsWith(a.sourceUrl + ':')));
   refreshRenderHashes(manifest);

package/src/build.mjs

@@ -65,7 +65,7 @@ export async function finishBuildRelease({
   mounts,
   publicDirectory,
   rootFont = "",
-  omitSvgResources = false,
+  omitSvgResources = true,
   upload = {},
   strict = false,
   logger = console,
@@ -75,7 +75,7 @@ export async function finishBuildRelease({
     const analysis = await analyzeSource({ root, name, entry, automaticAnchors });
     if (deriveReleaseId(analysis) !== releaseId) throw new Error("Source changed during the build; rebuild before publishing IAM");
     const css = cssDirectory ? await compiledCss(root, cssDirectory) : [];
-    const plain = () => generateAppManifest({ root, analysis, releaseId });
+    const plain = () => generateAppManifest({ root, analysis, releaseId, referencedImages:true, mounts });
     let result;
     if (!css.length) result = await plain();
     else if (css.length > MAX_BUILD_CSS) {
@@ -83,7 +83,7 @@ export async function finishBuildRelease({
       result = await plain();
     } else
       try {
-        result = await generateAppManifest({ root, analysis, releaseId, buildCss: css, mounts, rootFont, omitSvgResources });
+        result = await generateAppManifest({ root, analysis, releaseId, buildCss: css, referencedImages:true, mounts, rootFont, omitSvgResources });
       } catch (error) {
         report(logger, "warn", "compiled CSS skipped: " + (error instanceof Error ? error.message : String(error)));
         result = await plain();

package/src/component-registry.mjs

@@ -0,0 +1,229 @@
+/** Follow finite source selectors to their literal component registry, retaining alternatives as assumptions. */
+export function componentRegistry({
+  ts,
+  node,
+  module,
+  locals,
+  binding,
+  functionFrom,
+  value,
+  component,
+  variable,
+  location,
+  unknown,
+  imported,
+}) {
+  let steps = 0;
+  const choices = [],
+    variables = new Set(),
+    seen = new Set();
+  const unwrap = (n) => {
+    while (
+      n &&
+      (ts.isParenthesizedExpression(n) ||
+        ts.isAsExpression(n) ||
+        ts.isNonNullExpression(n) ||
+        ts.isSatisfiesExpression(n))
+    )
+      n = n.expression;
+    return n;
+  };
+  const localEnvironment = (fn, m, parent) => {
+    const env = new Map(parent);
+    if (ts.isBlock(fn.body))
+      for (const s of fn.body.statements)
+        if (ts.isVariableStatement(s))
+          for (const d of s.declarationList.declarations)
+            if (ts.isIdentifier(d.name))
+              env.set(d.name.text, { node: d.initializer, module: m, env });
+    return env;
+  };
+  const returns = (fn) =>
+    ts.isBlock(fn.body)
+      ? fn.body.statements
+          .filter((s) => ts.isReturnStatement(s))
+          .map((s) => s.expression)
+      : [fn.body];
+  function walk(raw, m, env, path = [], record = null, depth = 0) {
+    const n = unwrap(raw);
+    if (!n || depth > 24 || ++steps > 3000 || choices.length > 32) return;
+    if (!path.length && !(ts.isIdentifier(n) && env.has(n.text))) {
+      const c = component(n, m);
+      if (c) {
+        const optionValue =
+          typeof record?.key === "string" ? record.key : c.symbol;
+        choices.push({
+          component: c,
+          value: optionValue,
+          label:
+            typeof record?.label === "string"
+              ? record.label
+              : typeof record?.labelKey === "string"
+                ? record.labelKey
+                : c.symbol,
+          source: location(m, n, c.symbol),
+          scope: typeof record?.scope === "string" ? record.scope : null,
+        });
+        return;
+      }
+    }
+    const identity = m.file + ":" + n.pos + ":" + n.end + ":" + path.join("/");
+    if (seen.has(identity)) return;
+    seen.add(identity);
+    if (ts.isIdentifier(n)) {
+      const local = env.get(n.text);
+      if (local) {
+        walk(local.node, local.module, local.env, path, record, depth + 1);
+        return;
+      }
+      const ref = binding(m, n.text);
+      if (ref) walk(ref.node, ref.module, new Map(), path, record, depth + 1);
+      return;
+    }
+    if (ts.isPropertyAccessExpression(n)) {
+      walk(n.expression, m, env, [n.name.text, ...path], record, depth + 1);
+      return;
+    }
+    if (ts.isElementAccessExpression(n)) {
+      const key = value(n.argumentExpression, m);
+      walk(
+        n.expression,
+        m,
+        env,
+        [
+          typeof key === "number" || typeof key === "string"
+            ? String(key)
+            : "[]",
+          ...path,
+        ],
+        record,
+        depth + 1,
+      );
+      return;
+    }
+    if (
+      ts.isBinaryExpression(n) &&
+      [ts.SyntaxKind.QuestionQuestionToken, ts.SyntaxKind.BarBarToken].includes(
+        n.operatorToken.kind,
+      )
+    ) {
+      walk(n.left, m, env, path, record, depth + 1);
+      walk(n.right, m, env, path, record, depth + 1);
+      return;
+    }
+    if (ts.isConditionalExpression(n)) {
+      walk(n.whenTrue, m, env, path, record, depth + 1);
+      walk(n.whenFalse, m, env, path, record, depth + 1);
+      return;
+    }
+    if (ts.isArrayLiteralExpression(n)) {
+      const [key, ...rest] = path;
+      if (key === "[]")
+        for (const item of n.elements)
+          walk(item, m, env, rest, record, depth + 1);
+      else if (/^\d+$/.test(key ?? "") && n.elements[Number(key)])
+        walk(n.elements[Number(key)], m, env, rest, record, depth + 1);
+      return;
+    }
+    if (ts.isObjectLiteralExpression(n) && path.length) {
+      const [key, ...rest] = path,
+        fields = n.properties.filter(
+          (p) =>
+            ts.isPropertyAssignment(p) || ts.isShorthandPropertyAssignment(p),
+        );
+      const field = fields.find((p) => p.name.text === key);
+      if (!field) return;
+      const meta = Object.fromEntries(
+        fields.flatMap((p) => {
+          if (!["key", "label", "labelKey", "scope"].includes(p.name.text))
+            return [];
+          const v = value(
+            ts.isPropertyAssignment(p) ? p.initializer : p.name,
+            m,
+          );
+          return typeof v === "string" ? [[p.name.text, v]] : [];
+        }),
+      );
+      walk(
+        ts.isPropertyAssignment(field) ? field.initializer : field.name,
+        m,
+        env,
+        rest,
+        Object.keys(meta).length ? meta : record,
+        depth + 1,
+      );
+      return;
+    }
+    if (ts.isCallExpression(n)) {
+      if (
+        ts.isPropertyAccessExpression(n.expression) &&
+        ["find", "filter"].includes(n.expression.name.text)
+      ) {
+        const fn = unwrap(n.arguments[0]);
+        if (
+          n.expression.name.text === "find" &&
+          fn &&
+          ts.isArrowFunction(fn) &&
+          ts.isBinaryExpression(unwrap(fn.body))
+        ) {
+          const comparison = unwrap(fn.body);
+          if (
+            comparison.operatorToken.kind ===
+            ts.SyntaxKind.EqualsEqualsEqualsToken
+          )
+            for (const side of [comparison.left, comparison.right])
+              if (ts.isIdentifier(side)) {
+                const key = variable(side.text);
+                if (key) variables.add(key);
+              }
+        }
+        walk(
+          n.expression.expression,
+          m,
+          env,
+          n.expression.name.text === "find" ? ["[]", ...path] : path,
+          record,
+          depth + 1,
+        );
+        return;
+      }
+      const callback = unwrap(n.arguments[0]);
+      if (
+        callback &&
+        (ts.isArrowFunction(callback) || ts.isFunctionExpression(callback)) &&
+        imported(m, n.expression.getText(m.source))?.specifier === "react" &&
+        imported(m, n.expression.getText(m.source))?.name === "useMemo"
+      ) {
+        const local = localEnvironment(callback, m, env);
+        for (const returned of returns(callback))
+          walk(returned, m, local, path, record, depth + 1);
+        return;
+      }
+      if (ts.isIdentifier(n.expression)) {
+        const ref = binding(m, n.expression.text),
+          fn = ref && functionFrom(ref.node);
+        if (
+          fn &&
+          !fn.modifiers?.some((a) => a.kind === ts.SyntaxKind.AsyncKeyword)
+        ) {
+          const local = localEnvironment(fn, ref.module, new Map());
+          for (const returned of returns(fn))
+            walk(returned, ref.module, local, path, record, depth + 1);
+        }
+      }
+    }
+  }
+  const env = new Map(
+    [...locals].map(([key, init]) => [key, { node: init, module, env: null }]),
+  );
+  for (const entry of env.values()) entry.env = env;
+  walk(node, module, env);
+  const options = [
+    ...new Map(
+      choices.map((c) => [c.value + "\0" + c.component.key, c]),
+    ).values(),
+  ];
+  return options.length > 1 && options.length <= 32
+    ? { options, variableKey: variables.size === 1 ? [...variables][0] : null }
+    : null;
+}

package/src/dependencies.mjs

@@ -2,7 +2,7 @@ import { createRequire } from "node:module";
 
 const require = createRequire(import.meta.url);
 
-/** Loads one of this package's pinned dependencies (sharp is an optional peer). */
+/** Loads one of this package's pinned dependencies including the image encoder. */
 export function dependency(name) {
   try {
     return { value: require(name), resolve: (path) => require.resolve(path) };
@@ -13,7 +13,7 @@ export function dependency(name) {
     )
       throw error;
     throw new Error(
-      `Missing ${name}. Reinstall @tinkerlandai/indiana-iam with its dependencies${name === "sharp" ? ", and install sharp 0.35.5 to optimize public images" : ""}.`,
+      `Missing ${name}. Reinstall @tinkerlandai/indiana-iam with its dependencies.`,
     );
   }
 }

package/src/framework-routes.mjs

@@ -1,4 +1,5 @@
 import { tanstackRoutes } from "./tanstack-routes.mjs";
+import { routeLazyComponent } from "./route-lazy.mjs";
 import { pagesRoute } from "./routing.mjs";
 import { routeCompositions } from "./route-composition.mjs";
 import { compositionIdentity, flattenComposition } from "./render-index.mjs";
@@ -294,7 +295,8 @@ export function frameworkRoutes({
         properties.get("element") ?? properties.get("Component"),
         module,
         route,
-      );
+      ) ?? (!properties.has("element") && !properties.has("Component") && properties.has("lazy")
+        ? routeLazyComponent(properties.get("lazy"), module, { ts, resolution, resolveModule }) : null);
       const index = properties.get("index")?.kind === ts.SyntaxKind.TrueKeyword;
       if (
         properties.has("index") &&

package/src/generate.mjs

@@ -33,6 +33,7 @@ export async function generateAppManifest({
   releaseId,
   buildCss = [],
   publicAssets = [],
+  referencedImages = false,
   optimizePublicImages = false,
   rootFont = "",
   omitSvgResources = false,
@@ -51,11 +52,12 @@ export async function generateAppManifest({
     releasePath(releaseId);
     manifest.release.runtimeBinding = { schemaVersion: 1, releaseId };
   }
-  if (buildCss.length || publicAssets.length)
+  if (buildCss.length || publicAssets.length || referencedImages)
     await attachBuildStyles(manifest, {
       root,
       files: buildCss,
       publicFiles: publicAssets,
+      referencedImages,
       optimizePublicImages,
       rootFont,
       omitSvgResources,

package/src/graph-sources.mjs

@@ -0,0 +1,54 @@
+import { canonical } from "./integrity.mjs";
+/** Lossless references to repeated source locations; semantic identities and hashes stay unchanged. */
+export function internGraphSources(graph) {
+  const rows = [
+      "variables",
+      "bindings",
+      "transitions",
+      "states",
+      "navigation",
+      "uncovered",
+    ].flatMap((key) => graph[key]),
+    counts = new Map();
+  for (const row of rows) {
+    const key = canonical(row.source);
+    counts.set(key, (counts.get(key) ?? 0) + 1);
+  }
+  const pool = [],
+    indices = new Map();
+  for (const row of rows) {
+    const key = canonical(row.source);
+    if (counts.get(key) < 2) continue;
+    let index = indices.get(key);
+    if (index === undefined) {
+      index = pool.length;
+      indices.set(key, index);
+      pool.push(row.source);
+    }
+    row.source = index;
+  }
+  if (pool.length) graph.sourcePool = pool;
+  const scopes = [],
+    scopeIndices = new Map(),
+    scopeCounts = new Map();
+  for (const v of graph.variables)
+    scopeCounts.set(v.scopeKey, (scopeCounts.get(v.scopeKey) ?? 0) + 1);
+  for (const v of graph.variables)
+    if (scopeCounts.get(v.scopeKey) > 1) {
+      let i = scopeIndices.get(v.scopeKey);
+      if (i === undefined) {
+        i = scopes.length;
+        scopeIndices.set(v.scopeKey, i);
+        scopes.push(v.scopeKey);
+      }
+      v.scopeKey = i;
+    }
+  if (scopes.length) graph.scopePool = scopes;
+}
+export function graphSource(graph, row) {
+  return typeof row?.source === "number"
+    ? Number.isInteger(row.source)
+      ? graph.sourcePool?.[row.source]
+      : undefined
+    : row?.source;
+}

package/src/index.d.ts

@@ -32,6 +32,8 @@ export type GenerateOptions = {
   releaseId?: string;
   buildCss?: string[];
   publicAssets?: string[];
+  /** Package only projected local raster references; large images use the bounded build preview profile. */
+  referencedImages?: boolean;
   optimizePublicImages?: boolean;
   rootFont?: string;
   omitSvgResources?: boolean;

package/src/library-entry.mjs

@@ -82,3 +82,7 @@ export async function renderIamViewer(manifest, context) {
     .replace('<link rel="stylesheet" href="viewer.css" />', base ? '<link rel="stylesheet" href="'+asset(assets.css,'.css')+'" integrity="'+integrity(assets.css)+'" crossorigin="anonymous">' : '<style>' + assets.css.replaceAll(/<\/style/gi, "<\\/style") + '</style>')
     .replace('<script src="viewer.js"></script>', '<script id="iam-context" type="application/json">' + json(context) + '</script>' + (base ? '<script src="'+asset(assets.js,'.js')+'" integrity="'+integrity(assets.js)+'" crossorigin="anonymous"></script>' : '<script>' + script + '</script>'));
 }
+
+export { previewUiDocument as previewIamUiDocument } from './ui-preview.mjs';
+
+export { tabUiScenes as iamTabUiScenes } from './tab-scenes.mjs';

package/src/lucide-source.mjs

@@ -0,0 +1,18 @@
+import { createRequire } from "node:module";
+// Pinned, inert geometry data. Merchant packages and React components are never imported.
+const require = createRequire(import.meta.url),
+  catalog = require("lucide-static/icon-nodes.json");
+export const LUCIDE_SOURCE_VERSION = "1.34.0";
+export const LUCIDE_SOURCE = Symbol("source-lucide");
+export function lucideSource(name) {
+  const key = name
+    .replace(/Icon$/, "")
+    .replace(/([A-Z])([A-Z][a-z])/g, "$1-$2")
+    .replace(/([a-z0-9])([A-Z])/g, "$1-$2")
+    .replace(/([a-zA-Z])(\d)/g, "$1-$2")
+    .toLowerCase();
+  return Object.hasOwn(catalog, key) ? { [LUCIDE_SOURCE]: key } : null;
+}
+export function lucideGeometry(value) {
+  return catalog[value?.[LUCIDE_SOURCE]] ?? null;
+}

package/src/next-loader.cjs

@@ -7,10 +7,16 @@ module.exports = function indianaIamLoader(source, inputMap) {
   const { root } = this.getOptions();
   Promise.all([
     import("./transform.mjs"),
-    fs.realpath(this.resourcePath),
+    fs.realpath(this.resourcePath).catch((error) => {
+      // Turbopack can retype loader output (e.g. icon.svg -> icon.svg.js).
+      // Such virtual modules have no original source binding to instrument.
+      if (error.code === "ENOENT" || error.code === "ENOTDIR") return null;
+      throw error;
+    }),
     fs.realpath(root),
   ])
     .then(([{ transformSourceForIam }, resource, directory]) => {
+      if (!resource) return done(null, source, inputMap);
       const file = path.relative(directory, resource).split(path.sep).join("/");
       if (file.startsWith("../") || path.isAbsolute(file))
         return done(null, source, inputMap);

package/src/next.cjs

@@ -0,0 +1,5 @@
+/** Next transpiles next.config.ts to CommonJS before loading its plugins. */
+exports.withIndianaIam = (nextConfig = {}, options = {}) => async (phase, context) => {
+  const { withIndianaIam } = await import("./next.mjs");
+  return withIndianaIam(nextConfig, options)(phase, context);
+};

package/src/node-hashes.mjs

@@ -1,21 +1,21 @@
 import { documentDom } from "./dom-payload.mjs";
-import { canonical, sealNodes, sealDocument } from './integrity.mjs';
+import { canonical, identity, sealNodes, sealDocument } from './integrity.mjs';
 import { dependency } from './dependencies.mjs';
 import { sourceMappingsHash } from './compact-dom.mjs';
 
 /** HTML already owns the DOM values and ordering. Store only the source map
  * in preorder, rather than repeating attributes, text and every tree edge. */
-export function expandDomNodes(document, body) {
+export function expandDomNodes(document, body, deriveTextId) {
   if(document.nodeEncoding!=='html-preorder-v1'||document.nodeHashMode!=='derived-v1'||!document.sourceMappingsHash||document.nodes.length>12000)throw Error('Invalid HTML-derived DOM mode');
   let index=0;const result=[];
-  function visit(node,parentId,depth){
+  function visit(node,parentId,depth,childIndex=0){
     if(depth>128||![1,3].includes(node.nodeType))throw Error('Invalid HTML-derived DOM structure');
     const ref=document.nodes[index++];
     if(!ref||Object.keys(ref).some(key=>!['nodeId','elementKey','source','synthetic'].includes(key)))throw Error('Mixed HTML-derived DOM values');
-    const element=node.nodeType===1,nodeId=element?node.getAttribute('data-iam-node'):ref.nodeId;
+    const element=node.nodeType===1,nodeId=element?node.getAttribute('data-iam-node'):ref.nodeId??deriveTextId?.(document.pageKey,parentId,childIndex);
     if(!/^node_[a-f0-9]{64}$/.test(nodeId??'')||element&&Object.hasOwn(ref,'nodeId')||Object.hasOwn(ref,'synthetic')&&ref.synthetic!==true)throw Error('HTML-derived DOM identity differs');
     const full={...ref,nodeId,synthetic:ref.synthetic??false,parentId,kind:element?'element':'text',tag:element?node.tagName.toLowerCase():null,text:element?null:node.data,attributes:element?Object.fromEntries([...node.attributes].filter(a=>!a.name.startsWith('data-iam-')).map(a=>[a.name,a.value])):{},children:[]};
-    result.push(full);for(const child of node.childNodes)full.children.push(visit(child,nodeId,depth+1));return nodeId;
+    result.push(full);for(const [i,child]of [...node.childNodes].entries())full.children.push(visit(child,nodeId,depth+1,i));return nodeId;
   }
   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;
@@ -23,7 +23,7 @@ export function expandDomNodes(document, body) {
 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);}finally{dom.window.close();}
+  try{return expandDomNodes(decoded,dom.window.document.body,(page,parentId,index)=>identity('node',{page,parentId,index,kind:3}));}finally{dom.window.close();}
 }
 
 /** Node hashes are pure derived values. IDs, source mappings and algorithms never change. */
@@ -38,8 +38,9 @@ export function storeDocumentNodes(document, nodes, elements) {
   document.sourceMappingsHash = sourceMappingsHash(nodes, elements);
   document.nodeEncoding = 'html-preorder-v1';
   document.nodeHashMode = 'derived-v1';
-  document.nodes = nodes.map(({nodeId,kind,elementKey,synthetic,source}) => ({
-    ...(kind === 'text' ? {nodeId} : {}),
+  const byId=new Map(nodes.map(node=>[node.nodeId,node]));
+  document.nodes = nodes.map(({nodeId,parentId,kind,elementKey,synthetic,source}) => ({
+    ...(kind === 'text' && nodeId!==identity('node',{page:document.pageKey,parentId,index:byId.get(parentId)?.children.indexOf(nodeId)??0,kind:3}) ? {nodeId} : {}),
     elementKey,
     ...(synthetic ? {synthetic:true} : {}),
     ...(source && canonical(source) !== canonical(elements.get(elementKey)?.source) ? {source} : {}),