@tinkerlandai/indiana-iam 0.4.0 → 0.6.0

package/src/analyze.mjs

@@ -1,7 +1,14 @@
 import fs from "node:fs/promises";
 import {referencedRasterSources} from "./source-media.mjs";
+import {sourceAliases} from './source-aliases.mjs';
+import {sourceCssModules} from './source-css-modules.mjs';
+import {mantinePrimitive} from './source-mantine.mjs';
+import {sourceMdx} from './source-mdx.mjs';
+import {attachSourceStyles} from './source-styles.mjs';
+import {sourceI18next} from './source-i18next.mjs';
 import {uiEnvironmentPrimitive} from "./source-environment.mjs";
 import {sourceChart} from "./source-charts.mjs";
+import {flowbiteShape,rootFlowbiteTheme} from "./source-flowbite.mjs";
 import path from "node:path";
 import { automaticSourceAnchors, anchorAttributes, sourceScriptKind } from "./anchors.mjs";
 import { sourceFiles } from "./source-files.mjs";
@@ -9,6 +16,8 @@ import { dependency } from "./dependencies.mjs";
 import { assembleRouteTree, readVariables } from "./route-tree.mjs";
 import { sourceEntry } from "./source-entry.mjs";
 import { frameworkRoutes, externalImport } from "./framework-routes.mjs";
+import { reactNativeRoutes, nativeModuleCandidates } from "./react-native-routes.mjs";
+import { nativeExpression, nativePrimitive } from "./react-native-projection.mjs";
 import { sourceResolution } from "./source-resolution.mjs";
 import { routeIndexDigest, refreshRenderHashes, flattenComposition } from "./render-index.mjs";
 import { storeDocumentNodes } from "./node-hashes.mjs";
@@ -41,6 +50,7 @@ import { sensitiveName, redactLiteral, privateUrl } from "./privacy.mjs";
 const isUnknown = (value) => value === UNKNOWN;
 const COMPONENT=Symbol('source-component');
 const TRANSLATION=Symbol('source-translation-catalog');
+const TRANSLATION_FORMAT=Symbol('source-translation-format');
 const UI_SETTER=Symbol('source-ui-setter');
 const UI_PRIMITIVE=Symbol('source-ui-primitive');
 
@@ -83,11 +93,11 @@ function staticStyle(value, unsupported) {
   }).join(";");
 }
 const allowedTags = new Set(
-  "main section article aside header footer nav div span p h1 h2 h3 h4 h5 h6 a button form label input select option textarea ul ol li dl dt dd table thead tbody tr th td caption fieldset legend details summary pre code blockquote strong em b i small s u mark time br hr img picture source svg path circle rect line polyline polygon ellipse g title".split(
+  "main section article aside header footer nav div span p h1 h2 h3 h4 h5 h6 a button form label input select option textarea ul ol li dl dt dd table thead tbody tfoot tr th td caption fieldset legend details summary pre code blockquote strong em b i small s del u mark time br hr wbr img picture source svg path circle rect line polyline polygon ellipse g title".split(
     " ",
   ),
 );
-const voidTags = new Set(["input", "br", "hr", "img", "source"]);
+const voidTags = new Set(["input", "br", "hr", "wbr", "img", "source"]);
 const escape = (text) =>
   redactLiteral(text).replace(
     /[&<>"']/g,
@@ -187,12 +197,17 @@ export async function analyze({
   name,
   repository = "",
   commit = "",
-  maxFiles = 5000,
-  maxBytes = 100_000_000,
+  maxFiles = Infinity,
+  maxBytes = Infinity,
   navigationPaths = [],
   entry,
   automaticAnchors = false,
+  platform = "web",
+  routerRoot,
 }) {
+  if (!["web", "ios", "android"].includes(platform)) throw Error("Unsupported IAM platform");
+  const nativePlatform = platform !== "web";
+  if (!nativePlatform && routerRoot !== undefined) throw Error("routerRoot is only supported for native Expo projects");
   root = await fs.realpath(root);
   const files = await sourceFiles(root, { maxFiles });
   const modules = new Map(),
@@ -201,7 +216,7 @@ export async function analyze({
     elements = new Map(),
     components = new Map(),
     assets = new Map();
-  const cssSources = [];
+  const cssSources = [], cssModuleFiles = new Map();
   const jsonResources=new Map(),translationResources=new Set();
   const presentation={conditions:[],tabs:[],navigation:[],regions:[],collections:[],fragments:[],attributes:[],attributeSets:[]},collectionTemplates=new Map();
   const ui = { variables: [], bindings: [], transitions: [], uncovered: [] };
@@ -210,7 +225,6 @@ export async function analyze({
   function gap(code, file, detail) {
     detail = redactLiteral(detail);
     if (
-      gaps.length < 1000 &&
       !gaps.some(
         (x) => x.code === code && x.file === file && x.detail === detail,
       )
@@ -224,10 +238,11 @@ export async function analyze({
     const real = await fs.realpath(absolute);
     if (!real.startsWith(root + path.sep))
       throw new Error("Source path escapes root");
-    if (stat.size > 1_000_000 || (byteCount += stat.size) > maxBytes)
+    if ((byteCount += stat.size) > maxBytes)
       throw new Error("Source byte budget exceeded");
     const bytes = await fs.readFile(absolute);
-    const text = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    const originalText = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
+    let text = originalText;
     inventory.push({
       file,
       sha256: sha256(bytes),
@@ -235,33 +250,32 @@ export async function analyze({
     });
     if(file.endsWith('.json')){try{jsonResources.set(file,JSON.parse(text));}catch{/* Non-resource JSON stays opaque. */}continue;}
     if (file.endsWith(".css")) {
+      if (file.endsWith('.module.css')) { cssModuleFiles.set(file, text); continue; }
       gap(
-        file.endsWith(".module.css")
-          ? "CSS_MODULES_UNSUPPORTED"
-          : "STYLE_SOURCE_PARTIAL",
+        "STYLE_SOURCE_PARTIAL",
         file,
         "Only root/dark tokens and pinned utility rules are reconstructed; scoped/custom selectors, keyframes and original font rules are not compiled",
       );
       if (!file.endsWith(".module.css")) cssSources.push({ file, text });
       continue;
     }
-    if (!/\.[cm]?[jt]sx?$/.test(file)) {
-      if (/^(?:src\/)?app\/(?:.*\/)?(?:page|layout)\.mdx$/.test(file) || /^(?:src\/)?pages\/.+\.mdx$/.test(file))
-        gap("ROUTE_MDX_UNSUPPORTED", file, "MDX route/layout source requires a dedicated adapter; its page and layout coverage is incomplete");
-      continue;
-    }
+    const mdx = /\.mdx?$/.test(file) ? sourceMdx(file, originalText, gap) : null;
+    if (mdx) text = mdx.text;
+    if (!mdx && !/\.[cm]?[jt]sx?$/.test(file)) continue;
     const source = ts.createSourceFile(
       file,
       text,
       ts.ScriptTarget.Latest,
       true,
-      sourceScriptKind(file, ts),
+      mdx ? ts.ScriptKind.TSX : sourceScriptKind(file, ts),
     );
     const module = {
       file,
       text,
       source,
-      anchors: automaticAnchors ? automaticSourceAnchors(file, source) : new Map(),
+      anchors: automaticAnchors && !nativePlatform && !mdx ? automaticSourceAnchors(file, source) : new Map(),
+      mdx,
+      originalSource: mdx ? ts.createSourceFile(file, originalText, ts.ScriptTarget.Latest, false) : source,
       bindings: new Map(),
       imports: new Map(),
       exports: new Map(),
@@ -331,16 +345,19 @@ export async function analyze({
           module.exports.set(e.name.text,local);if(e.name.text==='default')module.defaultName=local;
         }
     }
+    if (/^(?:src\/)?pages\//.test(file)) {
+      for (const statement of source.statements) {
+        const assignment = ts.isExpressionStatement(statement) && unwrap(statement.expression);
+        if (assignment && ts.isBinaryExpression(assignment) && assignment.operatorToken.kind === ts.SyntaxKind.EqualsToken && ts.isPropertyAccessExpression(assignment.left) && assignment.left.name.text === 'getLayout' && ts.isIdentifier(assignment.left.expression) && assignment.left.expression.text === module.defaultName) {
+          const fn = functionFrom(assignment.right);
+          if (fn && fn.parameters.length === 1 && ts.isIdentifier(fn.parameters[0].name) && !fn.modifiers?.some(m => m.kind === ts.SyntaxKind.AsyncKeyword)) module.bindings.set('$pageLayout', fn);
+        }
+      }
+    }
     modules.set(file, module);
   }
-  let alias = { "@/*": ["./*"] };
-  try {
-    const config = ts.parseConfigFileTextToJson(
-      "tsconfig.json",
-      await fs.readFile(path.join(root, "tsconfig.json"), "utf8"),
-    ).config;
-    alias = config.compilerOptions?.paths || alias;
-  } catch { /* Source projects may omit tsconfig.json. */ }
+  const alias = await sourceAliases(root,ts);
+  const cssModules = sourceCssModules({files: cssModuleFiles, aliases: alias, gap, redact: redactLiteral});
   function resolveModule(from, specifier) {
     let relative;
     if (specifier.startsWith("."))
@@ -359,7 +376,7 @@ export async function analyze({
       }
     if (!relative || relative.startsWith("../")) return null;
     return (
-      [
+      (nativePlatform ? nativeModuleCandidates(relative, platform) : [
         relative,
         ...[
           ".tsx",
@@ -367,11 +384,13 @@ export async function analyze({
           ".jsx",
           ".js",
           ".mjs",
+          ".mdx",
+          ".md",
           "/index.tsx",
           "/index.ts",
           "/index.jsx",
         ].map((ext) => relative + ext),
-      ]
+      ])
         .map((p) => modules.get(p))
         .find(Boolean) || null
     );
@@ -388,6 +407,7 @@ export async function analyze({
   }
   function sourceContextCall(node,module,ctx){
     const imported=externalImport(module,node.expression.getText(module.source));
+    if(['react-i18next','next-i18next'].includes(imported?.specifier)&&imported.name==='useTranslation')return {t:translationHook(node,module,ctx)};
     if(imported?.specifier==='react'&&imported.name==='useContext'&&ts.isIdentifier(node.arguments[0]))return ctx.__iamContexts?.get(contextKey(module,node.arguments[0].text))??UNKNOWN;
     const ref=ts.isIdentifier(node.expression)&&binding(module,node.expression.text),fn=ref&&functionFrom(ref.node);
     if(!fn?.body||!ts.isBlock(fn.body))return UNKNOWN;
@@ -399,14 +419,52 @@ export async function analyze({
       if(primitive?.specifier==='react-i18next'&&primitive.name==='useTranslation'&&ts.isObjectBindingPattern(decl.name)&&decl.name.elements.some(e=>(e.propertyName?.text||e.name.text)==='t'&&e.name.text===result.text)){
         const catalogs=[...ref.module.imports.values()].filter(i=>i.specifier.endsWith('.json')).map(i=>jsonResource(ref.module.file,i.specifier)).filter(Boolean);
         if(catalogs.length===1){translationResources.add(catalogs[0]);return {[TRANSLATION]:catalogs[0]};}
+        const locals={...ctx};fn.parameters.forEach((p,i)=>{if(ts.isIdentifier(p.name))locals[p.name.text]=evalExpression(node.arguments[i],module,ctx);});
+        return translationHook(call,ref.module,locals);
       }
     }
     return UNKNOWN;
   }
+  let i18nextPreview;
+  function translationHook(node,module,ctx){
+    if(externalImport(module,node.expression.getText(module.source))?.specifier==='next-i18next') {
+      const config=[...modules.values()].find(m=>/^next-i18next\.config\.[cm]?[jt]s$/.test(m.file));
+      const statement=config?.source.statements.find(s=>ts.isExpressionStatement(s)&&ts.isBinaryExpression(s.expression)&&s.expression.left.getText(config.source)==='module.exports');
+      const options=statement&&evalExpression(statement.expression.right,config,{}),language=options?.i18n?.defaultLocale;
+      const namespace=node.arguments[0]?evalExpression(node.arguments[0],module,ctx):options?.defaultNS??'common';
+      const catalog=typeof language==='string'&&typeof namespace==='string'?jsonResources.get('public/locales/'+language+'/'+namespace+'.json'):null;
+      if(catalog&&typeof catalog==='object') {translationResources.add(catalog);gap('UI_LOCALE_FALLBACK_PREVIEW',config.file,'Read-only preview uses source defaultLocale '+language+'; request locale and remote translations are unobserved.');return {[TRANSLATION]:catalog};}
+      return UNKNOWN;
+    }
+    i18nextPreview??=sourceI18next({ts,modules,binding,imported:externalImport,jsonResource})??false;
+    if(!i18nextPreview)return UNKNOWN;
+    const namespace=node.arguments[0]?evalExpression(node.arguments[0],module,ctx):i18nextPreview.namespace;
+    const options=node.arguments[1]?evalExpression(node.arguments[1],module,ctx):{};
+    if(typeof namespace!=='string'||isUnknown(options)||options?.keyPrefix!==undefined&&typeof options.keyPrefix!=='string')return UNKNOWN;
+    let catalog=i18nextPreview.resources[i18nextPreview.language]?.[namespace];
+    if(typeof options?.keyPrefix==='string')catalog=options.keyPrefix.split('.').reduce((v,k)=>v&&Object.hasOwn(v,k)?v[k]:undefined,catalog);
+    if(!catalog||typeof catalog!=='object')return UNKNOWN;
+    gap('UI_LOCALE_FALLBACK_PREVIEW',i18nextPreview.file,'Read-only preview uses the source fallback locale '+i18nextPreview.language+'; browser language, storage and runtime locale selection are not observed.');
+    translationResources.add(catalog);return {[TRANSLATION]:catalog,[TRANSLATION_FORMAT]:{prefix:i18nextPreview.prefix,suffix:i18nextPreview.suffix}};
+  }
   function basePrimitive(module,tag,seen=new Set()){
     if(seen.has(module.file+'#'+tag)||seen.size>8)return null;seen.add(module.file+'#'+tag);
     const [name,part,extra]=tag.split('.'),ref=module.imports.get(name);
     const imported=externalImport(module,tag);
+    if (ref?.specifier === 'vaul' && ref.name === 'Drawer' && !extra) {
+      const mapped = {Root:'Root',Portal:'Portal',Overlay:'Backdrop',Content:'Popup',Title:'Title',Description:'Description',Trigger:'Trigger',Close:'Close'}[part];
+      if (mapped) return {family:'Dialog',part:mapped};
+    }
+    if (ref?.specifier === '@mantine/core' && ref.name === 'Tabs' && !extra) return {family:'Tabs',part:part ?? 'Root',mantine:true};
+    if(imported?.specifier==='@headlessui/react'){
+      const part={Dialog:'Root',DialogPanel:'Popup',DialogBackdrop:'Backdrop',DialogTitle:'Title',Description:'Description'}[imported.name];
+      if(part)return {family:'Dialog',part,rootVisibility:part==='Root'};
+    }
+    if(imported?.specifier==='react-aria-components'){
+      const part={DialogTrigger:'Root',MenuTrigger:'Root',TooltipTrigger:'Root',ModalOverlay:'Backdrop',Modal:'Popup',Popover:'Popup',Dialog:'Popup',Menu:'Content',MenuItem:'Item',Button:'Trigger',Heading:'Title'}[imported.name];
+      if(part)return {family:'AriaDialog',part,...(imported.name==='Menu'?{role:'menu'}:['Modal','Popover'].includes(imported.name)?{role:null}:{})};
+    }
+    if(ref?.specifier==='cmdk'&&ref.name==='Command'&&part==='Dialog'&&!extra)return {family:'Dialog',part:'Root',rootVisibility:true};
     const radixFamilies={'dialog':'Dialog','alert-dialog':'AlertDialog','popover':'Popover','dropdown-menu':'Menu','context-menu':'Menu','tooltip':'Tooltip','hover-card':'Popover','tabs':'Tabs','collapsible':'Collapsible'};
     const radix=imported?.specifier?.match(/^@radix-ui\/react-([a-z-]+)$/)?.[1];
     if(radixFamilies[radix]) {
@@ -532,8 +590,9 @@ export async function analyze({
     return target;
   }
   function sourceLocation(module, node, symbol) {
-    const loc = module.source.getLineAndCharacterOfPosition(
-      node.getStart(module.source),
+    const generated = node.getStart(module.source);
+    const loc = module.originalSource.getLineAndCharacterOfPosition(
+      module.mdx ? module.mdx.position(generated) : generated,
     );
     return {
       file: module.file,
@@ -544,16 +603,21 @@ export async function analyze({
     };
   }
   function sourceComponent(node,module){
+    const tabler=ts.isIdentifier(node)&&externalImport(module,node.text);
+    if(tabler?.specifier==='@tabler/icons-react'&&/^Icon[A-Z]/.test(tabler.name)){
+      const icon=lucideSource(tabler.name.slice(4));
+      if(icon){gap('ICON_SOURCE_APPROXIMATION',module.file,tabler.name+': inert Lucide counterpart used for source preview; original Tabler geometry is not claimed.');return icon;}
+    }
     const imported=ts.isIdentifier(node)&&externalImport(module,node.text);if(imported?.specifier==='@radix-ui/react-slot'&&['Slot','Root'].includes(imported.name))return {[UI_PRIMITIVE]:imported};if(imported?.specifier==='lucide-react'){const icon=lucideSource(imported.name);if(icon)return icon;}
     const ref=ts.isIdentifier(node)?binding(module,node.text):null;const def=componentsByFunction.get(node)??(ref&&componentDefs.get(ref.module.file+'#'+ref.name));
     return def?{[COMPONENT]:def}:null;
   }
-  function environment(node,module,context){
+  function environment(node,module,_context){
     const value=uiEnvironmentPrimitive({ts,node,module,binding,imported:externalImport,evaluate:evalExpression});
     if(value?.kind==='empty-preference'){gap('UI_PREFERENCE_EMPTY_PREVIEW',module.file,'Source-declared SSR fallback for a UI preference; preview starts without cookies, never reads merchant browser state.');return [undefined];}
     return value;
   }
-  function query(node,module,context){return staticQuery({ts,node,module,context,binding,unknown:UNKNOWN,redact:redactLiteral,sensitive:sensitiveName,reference:sourceComponent,isReference:v=>Boolean(v?.[COMPONENT]||v?.[LUCIDE_SOURCE]||v?.[UI_PRIMITIVE]),imported:externalImport,project:(n,m,c)=>{const v=environment(n,m,c);return Array.isArray(v)?v:null;}});}
+  function query(node,module,context,allowAsyncSource=false){return staticQuery({ts,node,module,context,binding,unknown:UNKNOWN,redact:redactLiteral,sensitive:sensitiveName,reference:sourceComponent,isReference:v=>Boolean(v?.[COMPONENT]||v?.[LUCIDE_SOURCE]||v?.[UI_PRIMITIVE]),imported:externalImport,allowAsyncSource,onAsyncSource:({timerSkipped})=>gap('ASYNC_SOURCE_RETURN_PREVIEW',module.file,'Only source-declared literal data is projected; network, actions, loading/error outcomes and query callbacks are not executed.'+(timerSkipped?' A source-proven timer-only delay is skipped without invoking timers.':'')),project:(n,m,c)=>{if(ts.isIdentifier(n.expression)&&c[n.expression.text]?.[TRANSLATION]){const value=evalExpression(n,m,c);return isUnknown(value)?null:[value];}const v=environment(n,m,c);return Array.isArray(v)?v:null;}});}
   function evalExpression(
     node,
     module,
@@ -564,6 +628,14 @@ export async function analyze({
     node = unwrap(node);
     if (!node || depth > 30) return UNKNOWN;
     const ev = (n) => evalExpression(n, module, context, stack, depth + 1);
+    if (nativePlatform) {
+      const result = nativeExpression(node, module, { ts, platform, evaluate: ev, unknown: UNKNOWN,
+        shadowed: name => Object.hasOwn(context, name),
+        gap: detail => gap("RN_CAPABILITY_UNOBSERVED", module.file, detail),
+      });
+      if (result) return result.value;
+    }
+    if (ts.isAwaitExpression(node)) return query(node, module, context, true);
     const component=!(ts.isIdentifier(node)&&Object.hasOwn(context,node.text))&&sourceComponent(node,module);if(component)return component;
     if (ts.isStringLiteralLike(node) || ts.isNumericLiteral(node))
       return ts.isNumericLiteral(node) ? Number(node.text) : redactLiteral(node.text);
@@ -572,12 +644,16 @@ export async function analyze({
     if (node.kind === ts.SyntaxKind.NullKeyword) return null;
     if (ts.isIdentifier(node)) {
       if (Object.hasOwn(context, node.text)) return context[node.text];
+      const cssModule = cssModules.resolve(module, module.imports.get(node.text));
+      if (cssModule) return cssModule;
       const variableKey=context.__iamVariableKeys?.[context.__iamSetters?.[node.text]];
       if(variableKey)return {[UI_SETTER]:{variableKey,value:{op:'event',key:'value'},payload:{value:ui.variables.find(v=>v.variableKey===variableKey)?.valueType}}};
       if (node.text === "undefined") return undefined;
       const image=module.imports.get(node.text);
-      if(image?.name==='default'&&/^\.\.?\/[^?#]+\.(?:png|jpe?g|webp|gif)$/i.test(image.specifier)){
-        const file=path.posix.normalize(path.posix.join(path.posix.dirname(module.file),image.specifier));
+      if(image?.name==='default'&&/^[^?#]+\.(?:png|jpe?g|webp|gif|svg)$/i.test(image.specifier)){
+        let file=image.specifier.startsWith('.')?path.posix.normalize(path.posix.join(path.posix.dirname(module.file),image.specifier)):null;
+        if(!file)for(const[pattern,targets]of Object.entries(alias)){const parts=pattern.split('*');if(parts.length===2&&image.specifier.startsWith(parts[0])&&image.specifier.endsWith(parts[1])&&Array.isArray(targets)&&targets.length===1&&typeof targets[0]==='string'){const value=image.specifier.slice(parts[0].length,image.specifier.length-parts[1].length||undefined);file=path.posix.normalize(targets[0].replace('*',value));break;}}
+        if(!file)return UNKNOWN;
         if(!file.startsWith('../')&&!file.split('/').some(p=>p.startsWith('.'))&&!sensitiveName(file))return '/__iam_source__/'+file;
       }
       const token = module.file + "#" + node.text;
@@ -690,7 +766,13 @@ export async function analyze({
       const primitive=externalImport(module,callee);
       if(['react-router','react-router-dom'].includes(primitive?.specifier)&&primitive.name==='useLocation'&&typeof context.__iamRoutePath==='string')return {pathname:context.__iamRoutePath,search:UNKNOWN,hash:UNKNOWN};
       const translation=ts.isIdentifier(node.expression)&&context[node.expression.text]?.[TRANSLATION];
-      if(translation){const key=ev(node.arguments[0]);if(typeof key!=='string')return UNKNOWN;const value=key.split('.').reduce((value,key)=>value&&Object.hasOwn(Object(value),key)?value[key]:undefined,translation);return typeof value==='string'&&!/\{\{/.test(value)?redactLiteral(value):UNKNOWN;}
+      if(translation){
+        const key=ev(node.arguments[0]);if(typeof key!=='string')return UNKNOWN;const value=key.split('.').reduce((value,key)=>value&&Object.hasOwn(Object(value),key)?value[key]:undefined,translation);if(typeof value!=='string')return UNKNOWN;
+        const format=context[node.expression.text][TRANSLATION_FORMAT]??{prefix:'{{',suffix:'}}'},options=node.arguments[1]?ev(node.arguments[1]):{};
+        const pattern=format.prefix==='{{'&&format.suffix==='}}'?/\{\{([A-Za-z_][A-Za-z0-9_]*)\}\}/g:format.prefix==='{'&&format.suffix==='}'?/\{([A-Za-z_][A-Za-z0-9_]*)\}/g:null;if(!pattern)return UNKNOWN;
+        let missing=false;const text=value.replace(pattern,(_,k)=>{const v=options&&Object.hasOwn(Object(options),k)?options[k]:UNKNOWN;if(typeof v==='string'||typeof v==='number'&&Number.isFinite(v))return String(v);missing=true;return '';});
+        return !missing&&!/[{}]/.test(text)&&text.length<=4000?redactLiteral(text):UNKNOWN;
+      }
       if(primitive?.specifier==='react'&&primitive.name==='useMemo'&&node.arguments.length===2){
         const fn=node.arguments[0];if(ts.isArrowFunction(fn)&&!fn.modifiers?.length&&!fn.parameters.length&&!ts.isBlock(fn.body))return ev(fn.body);
       }
@@ -745,6 +827,7 @@ export async function analyze({
           args = node.arguments.map(ev),
           method = node.expression.name.text;
         if (isUnknown(target) || args.some(isUnknown)) return query(node,module,context);
+        if (typeof target === 'string' && method === 'toString' && !args.length) return target;
         if (
           typeof target === "string" &&
           [
@@ -806,10 +889,10 @@ export async function analyze({
   }
   const forwarded = new WeakMap(), objectBindings = new WeakMap();
   function componentContext(def, props) {
-    const ctx = { ...props, __iamSetters: {}, __iamStates: new Set(), __iamStateNodes: {}, __iamLocals: new Map(), __iamPropBindings: new Map(), __iamPropHandlers: new Map() };
+    const ctx = { ...props, __iamSetters: {}, __iamStates: new Set(), __iamStateNodes: {}, __iamLocals: new Map(), __iamQueryLocals: new Map(), __iamPropBindings: new Map(), __iamPropHandlers: new Map(), __iamDisclosures: [] };
     const param = def.fn?.parameters?.[0];
     if (param) {
-      if (ts.isIdentifier(param.name)) ctx[param.name.text] = props;
+      if (ts.isIdentifier(param.name)) ctx[param.name.text] = def.symbol === '$pageLayout' ? props.children : props;
       else if (ts.isObjectBindingPattern(param.name))
         for (const el of param.name.elements) {
           if (el.dotDotDotToken && ts.isIdentifier(el.name)) {
@@ -830,6 +913,7 @@ export async function analyze({
           if (handler) ctx.__iamPropHandlers.set(el.name.getText(), handler);
         }
     }
+    if (def.fn?.body&&ts.isBlock(def.fn.body)) for (const statement of def.fn.body.statements) if (ts.isFunctionDeclaration(statement) && statement.name) ctx.__iamLocals.set(statement.name.text, statement);
     if (def.fn?.body&&ts.isBlock(def.fn.body))
       for (const s of def.fn.body.statements)
         if (ts.isVariableStatement(s))
@@ -846,6 +930,7 @@ export async function analyze({
               for(const field of d.name.elements)if(ts.isIdentifier(field.name)&&!field.dotDotDotToken){
                 const key=field.propertyName?.text||field.name.text;
                 ctx[field.name.text]=!isUnknown(value)&&value&&typeof value==='object'&&Object.hasOwn(value,key)?value[key]:field.initializer?evalExpression(field.initializer,def.module,ctx):UNKNOWN;
+                ctx.__iamQueryLocals.set(field.name.text,d.initializer);
                 const inherited=value&&typeof value==='object'&&objectBindings.get(value)?.get(key);
                 if(inherited)ctx.__iamPropBindings.set(field.name.text,inherited);
                 const setter=value?.[key]?.[UI_SETTER];
@@ -853,6 +938,18 @@ export async function analyze({
               }
             } else if (ts.isArrayBindingPattern(d.name)) {
               const call = unwrap(d.initializer), hook = call && ts.isCallExpression(call) && ts.isIdentifier(call.expression) && def.module.imports.get(call.expression.text);
+              if (hook?.specifier === '@mantine/hooks' && hook.name === 'useDisclosure') {
+                const state = d.name.elements[0], handlers = d.name.elements[1]?.name;
+                if (call.arguments.length > 1 || !state || !ts.isIdentifier(state.name) || state.dotDotDotToken) {gap('DISCLOSURE_HOOK_UNOBSERVED',def.module.file,'Only a source boolean useDisclosure without lifecycle callbacks is simulated.');continue;}
+                const label = state.name.text;
+                ctx[label] = call.arguments.length ? evalExpression(call.arguments[0], def.module, ctx) : false;
+                ctx.__iamStates.add(label); ctx.__iamStateNodes[label] = d;
+                if (handlers && ts.isObjectBindingPattern(handlers)) {
+                  for (const h of handlers.elements) if (!h.dotDotDotToken && ts.isIdentifier(h.name) && ['open','close','toggle'].includes(h.propertyName?.text ?? h.name.text)) ctx.__iamDisclosures.push({label,name:h.name.text,op:h.propertyName?.text ?? h.name.text});
+                } else if (handlers && ts.isIdentifier(handlers)) for (const op of ['open','close','toggle']) ctx.__iamDisclosures.push({label,name:handlers.text+'.'+op,op});
+                gap('DISCLOSURE_SOURCE_PREVIEW',def.module.file,'Local boolean disclosure state only; hook callbacks and browser effects are not executed.');
+                continue;
+              }
               if (hook?.specifier === "react" && hook.name === "useActionState") {
                 const key = d.name.elements[0]?.name?.text, pending = d.name.elements[2]?.name?.text, initial = evalExpression(call.arguments[1], def.module, ctx);
                 if (key && !sensitiveName(key) && initial && !isUnknown(initial) && typeof initial === "object" && !Array.isArray(initial)) {
@@ -902,7 +999,7 @@ export async function analyze({
         module.file,
         "Middleware/proxy may change public routes; not executed by source analysis",
       );
-    if (!/^next\.config\.[cm]?[jt]s$/.test(module.file)) continue;
+    if (nativePlatform || !/^next\.config\.[cm]?[jt]s$/.test(module.file)) continue;
     const found = new Set();
     function readConfig(node) {
       const key = node.name?.text;
@@ -940,10 +1037,18 @@ export async function analyze({
     !/^\/(?:[^/?#[\]\\\s]+\/)*[^/?#[\]\\\s]+$/.test(routing.basePath)
   )
     throw new Error("Invalid source basePath");
-  const selection = await sourceEntry({ root, modules, resolveModule, ts, entry });
+  const selection = nativePlatform ? { discoveryModules: modules } : await sourceEntry({ root, modules, resolveModule, ts, entry });
+  if (nativePlatform) {
+    gap("RN_SOURCE_PREVIEW", "", "Inert HTML projection of React Native source. Native Yoga layout, device density, accessibility, gestures and navigation stacks are not observed; preview DOM locators never authorize native visual changes.");
+    gap("RN_METRO_CONFIG_UNOBSERVED", "", "Uses default Metro source extensions; custom resolvers, Babel plugins and Metro configuration are not executed.");
+  }
+  const flowbiteTheme=rootFlowbiteTheme({ts,modules:selection.discoveryModules,imported:externalImport,evaluate:evalExpression});
   if (selection.htmlSource) inventory.push(selection.htmlSource);
   inventory.sort((a, b) => a.file < b.file ? -1 : a.file > b.file ? 1 : 0);
-  const compositions = frameworkRoutes({ modules, ...selection, resolveModule, ts, sourceLocation, navigationPaths, gap, resolution, inlineComponent });
+  if (nativePlatform && navigationPaths.length) throw Error("Retained Web navigation paths do not describe a native back stack");
+  const compositions = nativePlatform
+    ? reactNativeRoutes({ modules, platform, entry, routerRoot, binding, sourceLocation, gap })
+    : frameworkRoutes({ modules, ...selection, resolveModule, ts, sourceLocation, navigationPaths, gap, resolution, inlineComponent });
   const pageFiles = compositions.pageFiles;
   routing.framework = compositions.framework;
   if (compositions.routeSources) routing.routeSources = compositions.routeSources;
@@ -999,7 +1104,6 @@ export async function analyze({
     const record = new Map(),
       used = new Set(),
       branches = [],attributeRequests=[];
-    let renderedCount = 0;
     function renderComponent(def, props, instance, depth) {
       if (depth === 0 && composition.entryMode === "soft") instance = composition.compositionKey + ":" + instance;
       // Component recursion and JSX nesting are separate budgets. Counting DOM
@@ -1011,7 +1115,7 @@ export async function analyze({
       used.add(def.key + ":" + instance);
       if (!page.componentKeys.includes(def.key))
         page.componentKeys.push(def.key);
-      props.__iamRoutePath=/[\[\]]/.test(route)?UNKNOWN:route;
+      props.__iamRoutePath=/[[\]]/.test(route)?UNKNOWN:route;
       const ctx = componentContext(def, props);
       ctx.__iamOutlet = props.__iamOutlet;
       ctx.__iamScope = identity("state-scope", {
@@ -1039,6 +1143,10 @@ export async function analyze({
           ui.variables.push({ variableKey, routeKey: pageKey, scopeKey: ctx.__iamScope, label:ctx.__iamViewportQueries?.[label]?'@media '+ctx.__iamViewportQueries[label]:label, valueType: typeof initialValue, initialValue, source: sourceLocation(def.module, ctx.__iamStateNodes[label], def.symbol) });
         }
       }
+      for (const disclosure of ctx.__iamDisclosures) {
+        const variableKey=ctx.__iamVariableKeys[disclosure.label];if(!variableKey)continue;
+        ctx.__iamPropHandlers.set(disclosure.name,{variableKey,value:disclosure.op==='toggle'?{op:'not',arg:{op:'var',key:variableKey}}:{op:'const',value:disclosure.op==='open'},payload:{}});
+      }
       // Rebind pure local records after scalar state identities exist. This preserves
       // useMemo/context field relationships without invoking a hook or callback.
       for(const [name,expression]of ctx.__iamLocals){
@@ -1126,9 +1234,10 @@ export async function analyze({
     }
     function uiHandler(initializer, owner, ctx, property = '') {
       let fn = initializer && ts.isJsxExpression(initializer) ? unwrap(initializer.expression) : null;
+      if(fn&&ts.isPropertyAccessExpression(fn)&&ctx.__iamPropHandlers.has(fn.getText(owner.module.source)))return ctx.__iamPropHandlers.get(fn.getText(owner.module.source));
       const eventValue = (variableKey) => ({ variableKey, value: {op:'event',key:'value'}, payload:{value:ui.variables.find(v=>v.variableKey===variableKey)?.valueType} });
       if(fn&&ts.isIdentifier(fn)&&ctx.__iamPropHandlers.has(fn.text))return ctx.__iamPropHandlers.get(fn.text);
-      if(fn&&ts.isIdentifier(fn)&&ctx.__iamSetters[fn.text]&&['onValueChange','onOpenChange'].includes(property)) {
+      if(fn&&ts.isIdentifier(fn)&&ctx.__iamSetters[fn.text]&&['onValueChange','onOpenChange',...(nativePlatform?['onChangeText']:[])].includes(property)) {
         const key=ctx.__iamVariableKeys[ctx.__iamSetters[fn.text]];return key?eventValue(key):null;
       }
       if(fn&&ts.isIdentifier(fn)&&ctx.__iamLocals.has(fn.text))fn=unwrap(ctx.__iamLocals.get(fn.text));
@@ -1136,7 +1245,7 @@ export async function analyze({
         const props=ctx[fn.expression.text],handler=props&&typeof props==='object'&&forwarded.get(props)?.handlers.find(h=>h.key===fn.name.text);
         if(handler)return handler;
       }
-      if(!fn||!ts.isArrowFunction(fn)||fn.modifiers?.some(m=>m.kind===ts.SyntaxKind.AsyncKeyword))return null;
+      if(!fn||![ts.isArrowFunction,ts.isFunctionExpression,ts.isFunctionDeclaration].some(is=>is(fn))||fn.modifiers?.some(m=>m.kind===ts.SyntaxKind.AsyncKeyword))return null;
       let statements=ts.isBlock(fn.body)?[...fn.body.statements]:[fn.body];
       if(statements.length>16)return null;
       const writes=[],payload={};
@@ -1158,7 +1267,7 @@ export async function analyze({
           if(!arg)return null;
           const forwardedWrites=(inherited.writes||[{variableKey:inherited.variableKey,value:inherited.value}]).map(write=>({...write,value:replaceEvent(write.value,arg)}));
           for(const write of forwardedWrites)inputs(write.value);
-          if(['onValueChange','onOpenChange'].includes(property))for(const [key,type]of Object.entries(inherited.payload))if(Object.hasOwn(payload,key))payload[key]=type;
+          if(['onValueChange','onOpenChange',...(nativePlatform?['onChangeText']:[])].includes(property))for(const [key,type]of Object.entries(inherited.payload))if(Object.hasOwn(payload,key))payload[key]=type;
           if(forwardedWrites.some(write=>uiExpressionType(write.value,payload)!==ui.variables.find(v=>v.variableKey===write.variableKey)?.valueType))return null;
           writes.push(...forwardedWrites);continue;
         }
@@ -1169,7 +1278,7 @@ export async function analyze({
         const value=uiExpression(functional?functional.body:input,owner,ctx,fn.parameters[0]?.name?.text||null,aliases);
         if(!value)return null;
         inputs(value);const expected=ui.variables.find(v=>v.variableKey===variableKey)?.valueType;
-        if(value.op==='event'&&value.key==='value'&&['onValueChange','onOpenChange'].includes(property))payload.value=expected;
+        if(value.op==='event'&&value.key==='value'&&['onValueChange','onOpenChange',...(nativePlatform?['onChangeText']:[])].includes(property))payload.value=expected;
         if(uiExpressionType(value,payload)!==expected)return null;
         writes.push({variableKey,value});
       }
@@ -1181,13 +1290,14 @@ export async function analyze({
         ts,
         node,
         module: owner.module,
-        locals: ctx.__iamLocals,
+        locals: new Map([...ctx.__iamLocals,...ctx.__iamQueryLocals]),
         binding,
         functionFrom,
         imported: externalImport,
       });
     }
     function remoteResultCondition(node, owner, ctx) {
+      if (queryBacked(node, owner, ctx)) return 'remote';
       let shape = false;
       const root =
         ts.isIdentifier(node) && ctx.__iamLocals.has(node.text)
@@ -1205,7 +1315,7 @@ export async function analyze({
             "data",
             "length",
             "size",
-          ].includes(n.name.text)
+          ].includes(n.name.text) || ts.isPropertyAccessExpression(n) && isUnknown(evalExpression(n.expression,owner.module,ctx))
         )
           shape = true;
         ts.forEachChild(n, inspect);
@@ -1224,7 +1334,7 @@ export async function analyze({
           next[key] = evalExpression(init, owner.module, next);
       return next;
     }
-    function finiteCollection(node, owner, ctx, instance, depth) {
+    function finiteCollection(node, owner, ctx, instance, _depth) {
       if (ctx.__iamCollectionTemplate || !ts.isConditionalExpression(node))
         return null;
       const maps = [];
@@ -1482,8 +1592,14 @@ export async function analyze({
     function renderExpr(node, owner, ctx, instance, depth) {
       node = unwrap(node);
       if (!node) return "";
-      if (depth > 45) { gap("RENDER_DEPTH_LIMIT", owner.module.file, owner.symbol + ": JSX traversal budget exceeded"); return ""; }
+      if (depth > 128) { gap("RENDER_DEPTH_LIMIT", owner.module.file, owner.symbol + ": JSX nesting budget exceeded"); return ""; }
       const m = owner.module;
+      if(ts.isCallExpression(node)&&ts.isIdentifier(node.expression)&&ctx.__iamLocals.has(node.expression.text)){
+        const fn=unwrap(ctx.__iamLocals.get(node.expression.text));
+        if(fn&&(ts.isArrowFunction(fn)||ts.isFunctionDeclaration(fn)||ts.isFunctionExpression(fn))&&!fn.modifiers?.some(v=>v.kind===ts.SyntaxKind.AsyncKeyword)&&(!ts.isBlock(fn.body)||fn.body.statements.every(s=>ts.isVariableStatement(s)||ts.isIfStatement(s)||ts.isReturnStatement(s)))&&hasSourceJsx(uiReturnExpression(fn))&&fn.parameters.length<=8&&fn.parameters.every(p=>ts.isIdentifier(p.name)&&!p.dotDotDotToken)&&!node.arguments.some(ts.isSpreadElement)){
+          return renderInvocation({callback:{fn,owner,ctx,instance:instance+'/source-helper'},args:node.arguments.map(arg=>evalExpression(arg,m,ctx)),caller:ctx},instance,depth+1);
+        }
+      }
       const collection=finiteCollection(node,owner,ctx,instance,depth);if(collection!==null)return collection;
       if(ts.isIdentifier(node)&&ctx.__iamLocals.has(node.text)&&hasSourceJsx(ctx.__iamLocals.get(node.text))){
         if(ctx.__iamActiveJsx?.has(node.text))return '';
@@ -1602,7 +1718,7 @@ export async function analyze({
           const elementKey=identity('element',{component:owner.key,state:label,unobserved:index,sourceOffset:condition.getStart(m.source)-owner.fn.getStart(m.source)}),id=identity('node',{page:pageKey,element:elementKey,instance:instance+'/unobserved-'+index}),source=sourceLocation(m,condition,owner.symbol);
           record.set(id,{elementKey,source,synthetic:true});
           elements.set(elementKey,{elementKey,componentKey:owner.key,tag:'div',source,identityStrategy:'provisional_ast_ordinal',editableProperties:[],binding:'preview_only'});
-          return '<div data-iam-node="'+id+'" data-iam-unobserved="true" hidden="" data-iam-condition="'+conditionRow.conditionKey+'" data-iam-alternative="'+(index===0)+'">'+renderExpr(branch,owner,ctx,instance+'/unobserved-'+index,depth+1)+'</div>';
+          return '<div data-iam-node="'+id+'" data-iam-unobserved="true" hidden="" data-iam-condition="'+conditionRow.conditionKey+'" data-iam-alternative="'+(index===0)+'" class="iam-state">'+renderExpr(branch,owner,ctx,instance+'/unobserved-'+index,depth+1)+'</div>';
         }).join('');
       }
       if (
@@ -1617,15 +1733,7 @@ export async function analyze({
           fn &&
           (ts.isArrowFunction(fn) || ts.isFunctionExpression(fn))
         ) {
-          const limit=ctx.__iamCollectionTemplate?128:50;
-          if (values.length > limit)
-            gap(
-              "COLLECTION_TRUNCATED",
-              m.file,
-              "Static collection limited to 50 preview items",
-            );
           return values
-            .slice(0, limit)
             .map((value, i) => {
               const next = { ...ctx };
               if (fn.parameters[0] && ts.isIdentifier(fn.parameters[0].name))
@@ -1648,6 +1756,18 @@ export async function analyze({
             .join("");
         }
         gap("DYNAMIC_COLLECTION", m.file, node.expression.getText(m.source));
+        // Inspect one source template, never a fabricated data item. It stays
+        // hidden in the page preview; a nested UI scene can inspect its structure.
+        if (fn && (ts.isArrowFunction(fn) || ts.isFunctionExpression(fn)) && !fn.modifiers?.some(m => m.kind === ts.SyntaxKind.AsyncKeyword) && hasSourceJsx(uiReturnExpression(fn)) && !ctx.__iamUnknownTemplate) {
+          const next = {...ctx,__iamUnknownTemplate:true};
+          for (const parameter of fn.parameters) {
+            if (ts.isIdentifier(parameter.name)) next[parameter.name.text] = UNKNOWN;
+            else if (ts.isObjectBindingPattern(parameter.name)) for (const field of parameter.name.elements) if (ts.isIdentifier(field.name)) next[field.name.text] = UNKNOWN;
+          }
+          const source = sourceLocation(m,node,owner.symbol),elementKey=identity('element',{component:owner.key,template:node.getStart(m.source)}),id=identity('node',{page:pageKey,element:elementKey,instance});
+          elements.set(elementKey,{elementKey,componentKey:owner.key,tag:'div',source,identityStrategy:'provisional_ast_ordinal',editableProperties:[],binding:'preview_only'});record.set(id,{elementKey,source,synthetic:true});
+          return '<div data-iam-node="'+id+'" data-iam-source-template="unobserved" hidden="">'+renderExpr(uiReturnExpression(fn),owner,next,instance+'/source-template',depth+1)+'</div>';
+        }
         return unobservedValue(node, owner, instance,queryBacked(node.expression.expression,owner,ctx));
       }
       if (!ts.isJsxElement(node) && !ts.isJsxSelfClosingElement(node)) {
@@ -1681,8 +1801,6 @@ export async function analyze({
         }
         return "";
       }
-      if (++renderedCount > 12000)
-        throw new Error("Rendered node budget exceeded");
       const opening = ts.isJsxElement(node) ? node.openingElement : node,
         tag = opening.tagName.getText(m.source),
         props = m.anchors.get(opening) ? { "data-indiana-id": m.anchors.get(opening) } : {}, uiHandlers = [], uiBindings = [], forwardedHandlers=[],uiAttributes=[];
@@ -1714,7 +1832,7 @@ export async function analyze({
         }
         for (let i = uiBindings.length - 1; i >= 0; i--) if (uiBindings[i].property === key) uiBindings.splice(i, 1);
         for (let i = uiHandlers.length - 1; i >= 0; i--) if (uiHandlers[i].key === key) uiHandlers.splice(i, 1);
-        if (["onClick", "onChange", "onInput", "onValueChange", "onOpenChange"].includes(key)) {
+        if (["onClick", "onChange", "onInput", "onValueChange", "onOpenChange", "onClose", ...(nativePlatform ? ["onPress", "onChangeText"] : [])].includes(key)) {
           props[key] = undefined;
           const supported = ctx.__iamCollectionTemplate?null:uiHandler(attr.initializer, owner, ctx, key);
           if (supported) { props[key] = undefined; uiHandlers.push({ ...supported, key, source: sourceLocation(m, attr, owner.symbol) }); }
@@ -1804,7 +1922,7 @@ export async function analyze({
           elements.set(elementKey,{elementKey,componentKey:owner.key,tag:item.tag,source,identityStrategy:'provisional_ast_ordinal',editableProperties:[],binding:'preview_only'});record.set(nodeId,{elementKey,source,synthetic:true});
           return '<'+item.tag+' data-iam-node="'+nodeId+'" '+Object.entries(item.attrs).map(([k,v])=>k+'="'+escape(v)+'"').join(' ')+'>'+item.children.map((child,i)=>draw(child,part+'/'+i)).join('')+'</'+item.tag+'>';
         };
-        return draw({tag:'svg',attrs:{xmlns:'http://www.w3.org/2000/svg',viewBox:'0 0 '+chart.width+' '+chart.height,width:chart.width,height:chart.height,role:'img','aria-label':chart.unobserved?'Chart: data unobserved':'Source chart projection','data-iam-chart':chart.unobserved?'unobserved':'source',style:'display:block;width:100%;height:auto;max-height:'+chart.height+'px'},children:chart.children},'root');
+        return draw({tag:'svg',attrs:{xmlns:'http://www.w3.org/2000/svg',viewBox:'0 0 '+chart.width+' '+chart.height,width:chart.width,height:chart.height,role:'img','aria-label':chart.unobserved?'Chart: data unobserved':'Source chart projection','data-iam-chart':chart.unobserved?'unobserved':'source',style:'display:block;width:100%;height:100%;max-height:'+chart.height+'px'},children:chart.children},'root');
       }
       const sourceIcon=evalExpression(opening.tagName,m,ctx);
       if(sourceIcon?.[LUCIDE_SOURCE])return renderLucide(sourceIcon,node,owner,props,instance,!ctx.__iamCollectionTemplate);
@@ -1813,8 +1931,8 @@ export async function analyze({
       let childCtx=ctx,tabGroup=ctx.__iamTabs;
       const provider=tag.endsWith('.Provider')?contextKey(m,tag.slice(0,-9)):contextKey(m,tag);
       if(provider){const contexts=new Map(ctx.__iamContexts);contexts.set(provider,props.value);childCtx={...childCtx,__iamContexts:contexts};}
-      if(overlay&&['Root','SubmenuRoot'].includes(overlay.part)){
-        const openProperty=overlay.family==='Transition'?'in':'open',open=props[openProperty];
+      if(overlay&&(['Root','SubmenuRoot'].includes(overlay.part)||overlay.family==='AriaDialog'&&['Backdrop','Popup'].includes(overlay.part)&&(Object.hasOwn(props,'isOpen')||Object.hasOwn(props,'defaultOpen')))){
+        const openProperty=overlay.family==='Transition'?'in':overlay.family==='AriaDialog'?'isOpen':'open',open=props[openProperty];
         overlayGroup={open:open===true||open===undefined&&props.defaultOpen===true,variable:uiBindings.find(b=>b.property===openProperty)?.value,controller:uiHandlers.find(h=>h.key==='onOpenChange')};
         if(overlay.family!=='Transition'&&open===undefined&&!props.__iamOpaqueProps&&(props.defaultOpen===undefined||typeof props.defaultOpen==='boolean')){
           const scopeKey=identity('primitive-state',{page:pageKey,instance,family:overlay.family}),variableKey=identity('ui-variable',{scope:scopeKey,label:'open'});
@@ -1844,15 +1962,64 @@ export async function analyze({
       }
       if(tabPart==='Root') {
         const valueBinding=uiBindings.find(b=>b.property==='value')?.value;
-        const controller=uiHandlers.find(h=>h.key==='onValueChange');
-        tabGroup={tabKey:identity('ui-tab',{page:pageKey,scope:ctx.__iamScope,instance}),routeKey:pageKey,renderKey:'pending',nodeId:'pending',variableKey:valueBinding?.op==='var'?valueBinding.key:null,initialValue:typeof props.value==='string'?props.value:typeof props.defaultValue==='string'?props.defaultValue:null,items:[],source:sourceLocation(m,node,owner.symbol),scopeSource:ui.variables.find(v=>v.variableKey===valueBinding?.key)?.source??sourceLocation(m,node,owner.symbol),controller};
+        let controller=uiHandlers.find(h=>h.key==='onValueChange'||basePart?.mantine&&h.key==='onChange');
+        const attribute = name => {const a=opening.attributes.properties.find(a=>ts.isJsxAttribute(a)&&a.name.text===name);return a?.initializer&&ts.isJsxExpression(a.initializer)?unwrap(a.initializer.expression):null;};
+        const input=attribute('value'),handler=attribute('onValueChange');
+        if (!controller && handler && (ts.isArrowFunction(handler)||ts.isFunctionExpression(handler)) && !handler.modifiers?.length && handler.parameters.length===1 && ts.isIdentifier(handler.parameters[0].name)) {
+          let call=ts.isBlock(handler.body)&&handler.body.statements.length===1?handler.body.statements[0]:handler.body;
+          if(ts.isExpressionStatement(call))call=call.expression;call=unwrap(call);
+          const label=call&&ts.isCallExpression(call)&&ts.isIdentifier(call.expression)&&call.arguments.length===1?ctx.__iamSetters[call.expression.text]:null,key=label&&ctx.__iamVariableKeys[label];
+          if(key&&input&&collectionStateReads(ts,input,ctx).includes(key)) controller={variableKey:key,forValue:value=>{
+            const written=evalExpression(call.arguments[0],m,{...ctx,[handler.parameters[0].name.text]:value});
+            if(typeof written!=='string'||evalExpression(input,m,{...ctx,[label]:written})!==value)return null;
+            return {variableKey:key,value:{op:'const',value:written}};
+          }};
+        }
+        const variableKey=valueBinding?.op==='var'?valueBinding.key:controller?.forValue?controller.variableKey:null;
+        tabGroup={tabKey:identity('ui-tab',{page:pageKey,scope:ctx.__iamScope,instance}),routeKey:pageKey,renderKey:'pending',nodeId:'pending',variableKey,initialValue:typeof props.value==='string'?props.value:typeof props.defaultValue==='string'?props.defaultValue:null,items:[],source:sourceLocation(m,node,owner.symbol),scopeSource:ui.variables.find(v=>v.variableKey===variableKey)?.source??sourceLocation(m,node,owner.symbol),controller};
         childCtx={...childCtx,__iamTabs:tabGroup};
       }
+      const mantineRef=m.imports.get(tag.split('.')[0]),mantineName=mantineRef?.specifier==='@mantine/core'?(mantineRef.name==='*'?tag.split('.').slice(1).join('.'):mantineRef.name+tag.split('.').slice(1).map(s=>'.'+s).join('')):null;
+      let accordion=ctx.__iamContexts?.get('$iam-mantine-accordion');
+      if(mantineName==='Accordion'){
+        const contexts=new Map(childCtx.__iamContexts);accordion={value:props.value??props.defaultValue,multiple:props.multiple===true,name:identity('accordion',{page:pageKey,instance}),classes:props.classNames};contexts.set('$iam-mantine-accordion',accordion);childCtx={...childCtx,__iamContexts:contexts};
+        gap('ACCORDION_SOURCE_PREVIEW',m.file,'Native local details/summary preview; source defaults are retained and library callbacks are not executed.');
+      }
+      if(mantineName==='Accordion.Item'&&accordion){props.open=Array.isArray(accordion.value)?accordion.value.includes(props.value):typeof props.value==='string'&&accordion.value===props.value;if(!accordion.multiple)props.name=accordion.name;}
+      if(mantineName?.startsWith('Accordion.')&&accordion){const field={Item:'item',Control:'control',Panel:'panel'}[mantineName.split('.')[1]],name=accordion.classes?.[field];if(typeof name==='string')props.className=[props.className,name].filter(v=>typeof v==='string').join(' ');}
       const localRef=componentBinding(m,tag),localTarget=ctx[tag]?.[COMPONENT]??(localRef&&componentDefs.get(localRef.module.file+'#'+localRef.name));
       const dynamicNode=ctx.__iamLocals.get(tag);
       const registry=!localTarget&&dynamicNode?componentRegistry({ts,node:dynamicNode,module:m,locals:ctx.__iamLocals,binding,functionFrom,value:(n,module)=>evalExpression(n,module,ctx),component:(n,module)=>sourceComponent(n,module)?.[COMPONENT],variable:name=>ctx.__iamVariableKeys[name]??(ctx.__iamPropBindings.get(name)?.op==='var'?ctx.__iamPropBindings.get(name).key:null),location:sourceLocation,unknown:UNKNOWN,imported:externalImport}):null;
-      const renderChildren=(inherited=childCtx)=>ts.isJsxElement(node)?node.children.map((child,i)=>renderExpr(child,owner,{...childCtx,__iamContexts:inherited.__iamContexts??childCtx.__iamContexts,__iamTabs:inherited.__iamTabs??childCtx.__iamTabs,__iamOverlays:inherited.__iamOverlays??childCtx.__iamOverlays},instance+'/child-'+i,depth+1)).join(''):props.children?.iamRenderChildren?props.children.iamRenderChildren(inherited):props.children?.iamChildren||'';
-      const children = localTarget||registry ? '' : renderChildren();
+      let childrenRenders=0;
+      const renderChildren=(inherited=childCtx)=>{if(childrenRenders)gap('REPEATED_SOURCE_INSTANCE',m.file,'Forwarded children have distinct preview instances; repeated runtime selectors remain ambiguous');const childInstance=instance+(childrenRenders++?'/forward-'+(childrenRenders-1):'');return ts.isJsxElement(node)?node.children.map((child,i)=>renderExpr(child,owner,{...childCtx,__iamContexts:inherited.__iamContexts??childCtx.__iamContexts,__iamTabs:inherited.__iamTabs??childCtx.__iamTabs,__iamOverlays:inherited.__iamOverlays??childCtx.__iamOverlays},childInstance+'/child-'+i,depth+1)).join(''):props.children?.iamRenderChildren?props.children.iamRenderChildren(inherited):props.children?.iamChildren||'';};
+      let children = localTarget||registry ? '' : renderChildren();
+      const mantine = mantinePrimitive(m.imports.get(tag.split('.')[0]), props, tag.split('.').slice(1).join('.'));
+      if (mantine) {
+        gap('MANTINE_SOURCE_PROFILE', m.file, 'Inert semantic Mantine projection; theme resolution, portals, focus management and library callbacks are not executed.');
+        if (mantine.transparent) return children;
+        Object.assign(props, mantine.props);
+        if (mantine.overlay) {
+          const visible = uiBindings.find(b => b.property === 'opened');
+          if (visible) uiBindings.push({...visible, property: 'visible'});
+          if (typeof props.opened !== 'boolean') gap('MANTINE_OPEN_STATE_UNOBSERVED', m.file, 'Unknown overlay state is initially hidden; no runtime open state is inferred.');
+        }
+      }
+      const flowbite=flowbiteShape(externalImport(m,tag),props,children,['Table','Navbar','Sidebar'].includes(m.imports.get(tag.split('.')[0])?.name)?tag.split('.')[1]:undefined,flowbiteTheme);
+      if(flowbite){
+        gap('UI_LIBRARY_STATIC_PROFILE',m.file,'Flowbite 0.3 inert presentation profile; custom theme and library state remain unobserved.');
+        const source=sourceLocation(m,node,owner.symbol);
+        const draw=(item,part)=>{
+          if(typeof item==='string')return escape(item);
+          if(Object.hasOwn(item,'html'))return item.html;
+          const elementKey=identity('element',{component:owner.key,library:'flowbite',offset:node.pos,part}),nodeId=identity('node',{page:pageKey,elementKey,instance});
+          elements.set(elementKey,{elementKey,componentKey:owner.key,tag:item.tag,source,identityStrategy:'provisional_ast_ordinal',editableProperties:[],binding:'preview_only'});record.set(nodeId,{elementKey,source,synthetic:true});
+          if(item.attrs.class)item.attrs.class.split(/\s+/).filter(Boolean).forEach(c=>allClasses.add(c));
+          if(item.attrs.src)assets.set(item.attrs.src,null);
+          const attrs=Object.entries(item.attrs).filter(([,v])=>v!==false).map(([k,v])=>' '+k+'="'+escape(v===true?'':v)+'"').join('');
+          return '<'+item.tag+' data-iam-node="'+nodeId+'"'+attrs+'>'+(voidTags.has(item.tag)?'':item.children.map((child,i)=>draw(child,part+'/'+i)).join('')+'</'+item.tag+'>');
+        };
+        return draw(flowbite,'root');
+      }
 
       // Project the documented Controller render callback from source, with no
       // form initialization, live field values or business callback execution.
@@ -1879,6 +2046,14 @@ export async function analyze({
 
       if (ctx[tag]?.iamChildren !== undefined) return ctx[tag].iamChildren;
       if (ctx[tag]?.iamRenderChildren) return ctx[tag].iamRenderChildren(ctx);
+      const native = nativePlatform ? nativePrimitive(m, tag, props, { platform, gap: detail => gap("RN_CAPABILITY_UNOBSERVED", m.file, detail) }) : null;
+      if (native?.ignore) return "";
+      if (native?.outlet) {
+        gap("RN_NAVIGATOR_SOURCE_ONLY", m.file, "Projects the current route through the source layout; native headers, tabs, focus and stack history are unobserved");
+        return ctx.__iamOutlet?.iamRenderChildren?.(ctx) ?? "";
+      }
+      if (native?.props) Object.assign(props, native.props);
+      if (native?.text !== undefined) children = escape(native.text);
       const routerPrimitive = externalImport(m, tag);
       if (['react-router','react-router-dom'].includes(routerPrimitive?.specifier)&&routerPrimitive.name==='Navigate')return '';
       if (["react-router", "react-router-dom", "@tanstack/react-router"].includes(routerPrimitive?.specifier) && routerPrimitive.name === "Outlet") return ctx.__iamOutlet?.iamRenderChildren ? ctx.__iamOutlet.iamRenderChildren(ctx) : ctx.__iamOutlet?.iamChildren ?? "";
@@ -1897,7 +2072,9 @@ export async function analyze({
         props["data-iam-adapter"] = tag;
       }
       if (/^[A-Z]/.test(tag) && !intrinsicAlias) {
-        if(tabPart){
+        if (native?.tag) htmlTag = native.tag;
+        else if (mantine) htmlTag = mantine.tag;
+        else if(tabPart){
           htmlTag=tabPart==='Tab'?'button':'div';
           if(tabPart==='List')props.role='tablist';
           if(tabPart==='Tab'){props.role='tab';props.type='button';props['aria-selected']=tabGroup?.initialValue===props.value;}
@@ -1907,14 +2084,24 @@ export async function analyze({
           htmlTag=['Trigger','Close','Item','CheckboxItem','RadioItem','SubmenuTrigger'].includes(overlay.part)&&props.asChild!==true?'button':overlay.part==='Title'?'h2':overlay.part==='Description'?'p':'div';
           if(htmlTag==='button')props.type='button';
           if(['Portal','Popup','Backdrop'].includes(overlay.part)||overlay.family==='Transition'){props.hidden=!overlayGroup?.open;if(overlayGroup?.condition){props['data-iam-condition']=overlayGroup.condition.conditionKey;props['data-iam-alternative']='true';props['data-iam-condition-default']='false';props['data-iam-unobserved']='true';}if(overlayGroup?.variable)uiBindings.push({property:'visible',value:overlayGroup.variable,source:sourceLocation(m,node,owner.symbol)});}
-          if(['Root','SubmenuRoot','Portal','Provider'].includes(overlay.part)||props.asChild===true)props.style={display:'contents'};
-          if(overlay.part==='Popup')props.role=overlay.family==='Menu'?'menu':overlay.family==='Tooltip'?'tooltip':'dialog';
+          if(overlay.rootVisibility){props.hidden=!overlayGroup?.open;if(overlayGroup?.variable)uiBindings.push({property:'visible',value:overlayGroup.variable,source:sourceLocation(m,node,owner.symbol)});}
+          else if(['Root','SubmenuRoot','Portal','Provider'].includes(overlay.part)||props.asChild===true)props.style={display:'contents'};
+          if(overlay.part==='Popup'&&overlay.role!==null)props.role=overlay.role??(overlay.family==='Menu'?'menu':overlay.family==='Tooltip'?'tooltip':'dialog');
+          if(overlay.part==='Content'&&overlay.role)props.role=overlay.role;
         }
         else if (tag === "Link" || ["react-router", "react-router-dom", "@tanstack/react-router"].includes(routerPrimitive?.specifier) && ["Link", "NavLink"].includes(routerPrimitive.name)) {
           htmlTag = "a";
           if (typeof props.to === "string") props.href = props.to;
         }
         else if (tag === "Image") htmlTag = "img";
+        else if(externalImport(m,tag)?.specifier==='recharts'&&externalImport(m,tag)?.name==='ResponsiveContainer'){
+          htmlTag='div';const dimension=v=>typeof v==='number'&&Number.isFinite(v)||typeof v==='string'&&/^[0-9.]+(?:%|px|rem|vh|vw)?$/.test(v)?v:'100%';props.style={...(props.style&&typeof props.style==='object'?props.style:{}),width:dimension(props.width),height:dimension(props.height),minWidth:0};gap('RESPONSIVE_CHART_SOURCE_PREVIEW',m.file,'Static chart viewport follows its declared container; library measurements, effects and animation are not executed.');
+        }
+        else if((['@base-ui/react/avatar','@base-ui/react'].includes(m.imports.get(tag.split('.')[0])?.specifier)&&m.imports.get(tag.split('.')[0]).name==='Avatar'&&['Root','Image','Fallback'].includes(tag.split('.')[1]))||(m.imports.get(tag.split('.')[0])?.specifier==='@radix-ui/react-avatar'&&['Image','AvatarImage','Root','Avatar','Fallback','AvatarFallback'].includes(externalImport(m,tag)?.name))){
+          const part=tag.split('.')[1]??externalImport(m,tag)?.name;
+          htmlTag=['Image','AvatarImage'].includes(part)?'img':'span';
+          if(['Fallback','AvatarFallback'].includes(part)){props.hidden=true;gap('AVATAR_FALLBACK_UNOBSERVED',m.file,'Packaged image is the preview; merchant image loading/error fallback state is not simulated.');}
+        }
         else if(m.imports.get(tag)?.specifier==='react-basics'&&m.imports.get(tag)?.name==='Text'){
           htmlTag=typeof props.as==='string'&&allowedTags.has(props.as)?props.as:'span';
           gap('COMPONENT_STYLE_ADAPTER',m.file,'react-basics Text DOM semantics only; actual styles need runtime evidence');
@@ -2020,7 +2207,7 @@ export async function analyze({
       record.set(nodeId, {
         elementKey,
         source,
-        synthetic: htmlTag !== tag && tag !== "Link" && tag !== "Image"&&!intrinsicAlias&&!knownExternalPrimitive,
+        synthetic: nativePlatform || Boolean(m.mdx) || htmlTag !== tag && tag !== "Link" && tag !== "Image"&&!intrinsicAlias&&!knownExternalPrimitive,
       });
       if(tabPart==='Root'){
         // Tab initialization below shares the same concrete source container.
@@ -2039,11 +2226,11 @@ export async function analyze({
         if(!tabGroup.items.some(item=>item.value===props.value))tabGroup.items.push({value:props.value,nodeId});
         props['data-iam-tab-value']=props.value;props['data-iam-tab-key']=tabGroup.tabKey;
         const replace=value=>value.op==='event'&&value.key==='value'?{op:'const',value:props.value}:Object.fromEntries(Object.entries(value).map(([k,v])=>[k,Array.isArray(v)?v.map(item=>item&&typeof item==='object'?replace(item):item):v&&typeof v==='object'?replace(v):v]));
-        if(tabGroup.controller){const writes=(tabGroup.controller.writes||[{variableKey:tabGroup.controller.variableKey,value:tabGroup.controller.value}]).map(w=>({...w,value:replace(w.value)}));uiHandlers.push({...writes[0],writes,key:'onClick',payload:{},source});}
+        if(tabGroup.controller){const specialized=tabGroup.controller.forValue?.(props.value),writes=(tabGroup.controller.forValue?(specialized?[specialized]:[]):tabGroup.controller.writes||[{variableKey:tabGroup.controller.variableKey,value:tabGroup.controller.value}]).map(w=>({...w,value:replace(w.value)}));if(writes.length)uiHandlers.push({...writes[0],writes,key:'onClick',payload:{},source});}
       }
       if(tabPart==='Panel'&&tabGroup?.variableKey&&typeof props.value==='string')uiBindings.push({property:'visible',value:{op:'eq',left:{op:'var',key:tabGroup.variableKey},right:{op:'const',value:props.value}},source});
-      for (const handler of uiHandlers.filter(h=>!['onValueChange','onOpenChange'].includes(h.key))) {
-        const event = handler.key === "onClick" ? "click" : htmlTag === "select" || handler.payload.checked ? "change" : "input";
+      for (const handler of uiHandlers.filter(h=>!['onValueChange','onOpenChange','onClose'].includes(h.key)&&!(tabPart==='Root'&&h.key==='onChange'))) {
+        const event = ["onClick", "onPress"].includes(handler.key) ? "click" : htmlTag === "select" || handler.payload.checked ? "change" : "input";
         const writes=handler.writes||[{variableKey:handler.variableKey,value:handler.value}];
         ui.transitions.push({ transitionKey: identity("ui-transition", { page: pageKey, node: nodeId, event }), routeKey: pageKey, fromStateKey: "pending", toStateKey: "pending", trigger: { nodeId, event, payload: handler.payload }, guard: { op: "const", value: true }, stateReads: [...new Set(writes.flatMap(w=>readVariables(w.value)))].sort(), stateWrites: writes, simulation: "implemented", evidence: "source_inferred", source: handler.source });
       }
@@ -2056,14 +2243,22 @@ export async function analyze({
         }
         ui.bindings.push({ bindingKey: identity("ui-binding", { node: nodeId, property: binding.property }), routeKey: pageKey, nodeId, elementKey, ...binding });
       }
-      const sensitiveInput = htmlTag === "input" && (["password", "hidden"].includes(String(props.type).toLowerCase()) || sensitiveName(String(props.name || props.id || "")));
+      const sensitiveInput = native?.sensitive || ['input', 'textarea', 'select'].includes(htmlTag) && (htmlTag === 'input' && ["password", "hidden"].includes(String(props.type).toLowerCase()) || sensitiveName(String(props.name || props.id || "")));
       if (sensitiveInput) {
         delete props.value; delete props.defaultValue;
+        if (htmlTag === 'textarea') children = '';
         ui.bindings = ui.bindings.filter(b => b.nodeId !== nodeId);
         ui.transitions = ui.transitions.filter(t => t.trigger.nodeId !== nodeId);
         gap("SENSITIVE_INPUT_REDACTED", m.file, "Input value and state bridge omitted");
       }
+      if (['input', 'textarea', 'select'].includes(htmlTag) && !Object.hasOwn(props, 'value') && Object.hasOwn(props, 'defaultValue')) props.value = props.defaultValue;
+      if (htmlTag === 'input' && !Object.hasOwn(props, 'checked') && typeof props.defaultChecked === 'boolean') props.checked = props.defaultChecked;
+      if (htmlTag === 'textarea' && ['string', 'number'].includes(typeof props.value)) children = escape(props.value);
       const attrs = { "data-iam-node": nodeId,...(['input','textarea','select'].includes(htmlTag)&&Object.hasOwn(props,'value')&&isUnknown(props.value)?{'data-iam-input-unobserved':'true'}:{}) };
+      if(mantine?.overlay){
+        const close=uiHandlers.find(h=>h.key==='onClose');
+        if(close){const closeId=identity('node',{page:pageKey,element:elementKey,instance,mantineClose:true});record.set(closeId,{elementKey,source,synthetic:true});const writes=close.writes||[{variableKey:close.variableKey,value:close.value}];ui.transitions.push({transitionKey:identity('ui-transition',{page:pageKey,node:closeId,event:'click'}),routeKey:pageKey,fromStateKey:'pending',toStateKey:'pending',trigger:{nodeId:closeId,event:'click',payload:{}},guard:{op:'const',value:true},stateReads:[...new Set(writes.flatMap(w=>readVariables(w.value)))].sort(),stateWrites:writes,simulation:'implemented',evidence:'source_inferred',source:close.source});children='<button type="button" aria-label="Close dialog" data-iam-node="'+closeId+'">×</button>'+children;}
+      }
       for (const [key, value] of Object.entries(props)) {
         if (key === "style") {
           const css = staticStyle(value, () => gap("INLINE_STYLE_UNSUPPORTED", m.file,
@@ -2077,12 +2272,17 @@ export async function analyze({
           gap("PRIVATE_URL_REDACTED", m.file, "URL credentials or sensitive query omitted");
           continue;
         }
-        if (["disabled", "hidden", "checked"].includes(key) && value === false) continue;
+        if (["disabled", "hidden", "checked", "required", "readOnly", "multiple", "selected", "open"].includes(key) && value === false) continue;
         const attr =
           {
             className: "class",
             htmlFor: "for",
             tabIndex: "tabindex",
+            readOnly: "readonly",
+            minLength: "minlength",
+            maxLength: "maxlength",
+            autoComplete: "autocomplete",
+            inputMode: "inputmode",
             viewBox: "viewBox",
             strokeWidth: "stroke-width",
             strokeLinecap: "stroke-linecap",
@@ -2091,7 +2291,7 @@ export async function analyze({
             clipRule: "clip-rule",
           }[key] || key;
         if (
-          !/^(?:class|id|name|type|placeholder|value|title|alt|href|src|role|for|disabled|hidden|checked|width|height|viewBox|d|fill|stroke|stroke-width|stroke-linecap|stroke-linejoin|fill-rule|clip-rule|cx|cy|r|x|y|x1|x2|y1|y2|points|aria-[a-z-]+|data-indiana-id|data-indiana-map-(?:area|flow|kind|auth|edge)|data-(?:slot|state|side|variant|collapsible|orientation|active)|data-testid|data-test|data-qa|data-iam-(?:adapter|toggle|tab-value|tab-key|condition|alternative|condition-default|unobserved))$/.test(
+          !/^(?:class|id|name|type|placeholder|value|title|alt|href|src|role|for|disabled|hidden|checked|required|readonly|multiple|selected|open|start|min|max|step|minlength|maxlength|pattern|autocomplete|inputmode|rows|cols|width|height|viewBox|d|fill|stroke|stroke-width|stroke-linecap|stroke-linejoin|fill-rule|clip-rule|cx|cy|r|x|y|x1|x2|y1|y2|points|aria-[a-z-]+|data-indiana-id|data-indiana-map-(?:area|flow|kind|auth|edge)|data-(?:slot|state|side|variant|collapsible|orientation|active)|data-testid|data-test|data-qa|data-iam-(?:native-component|native-platform|native-unobserved|adapter|toggle|tab-value|tab-key|condition|alternative|condition-default|unobserved))$/.test(
             attr,
           )
         )
@@ -2107,6 +2307,7 @@ export async function analyze({
           }
           attrs["data-iam-external"] = "true";
         } else if (attr === "src") {
+          if(!['img','source'].includes(htmlTag)){gap('RESOURCE_HOST_UNSUPPORTED',m.file,tag+': resource attribute omitted from a non-image source adapter');continue;}
           if (String(value).startsWith("/") && !String(value).startsWith("//"))
             assets.set(String(value), null);
           else {
@@ -2120,7 +2321,7 @@ export async function analyze({
             .forEach((c) => allClasses.add(c));
         attrs[attr] = String(value);
       }
-      return (
+      const rendered = (
         "<" +
         htmlTag +
         Object.entries(attrs)
@@ -2131,6 +2332,12 @@ export async function analyze({
           ? (tag.startsWith("Icons.") ? "◇" : children) + "</" + htmlTag + ">"
           : "")
       );
+      if (mantine?.label) {
+        const labelId = identity('node', {page: pageKey, element: elementKey, instance, mantineLabel: true});
+        record.set(labelId, {elementKey, source, synthetic: true});
+        return '<label data-iam-node="' + labelId + '" style="display:flex;flex-direction:column;gap:0.35rem">' + '<span>' + escape(mantine.label) + '</span>' + rendered + '</label>';
+      }
+      return rendered;
     }
     function renderEntry(file, props, instance, symbol) {
       const entryModule = modules.get(file), entryRef = entryModule && componentBinding(entryModule, symbol ?? entryModule.defaultName);
@@ -2156,7 +2363,7 @@ export async function analyze({
           return '<div data-iam-node="'+contentId+'" data-iam-page-content="true">'+content+'</div>';
         }
         const layer=branch.layers[index],child={iamRenderChildren:next=>renderLayer(index-1,next)};
-        const props = ["react-router", "tanstack-router"].includes(routing.framework)
+        const props = ["react-router", "tanstack-router", "expo-router"].includes(routing.framework)
           ? { ...contextProps(ctx), __iamOutlet: child }
           : { ...contextProps(ctx), children: child };
         if (/^(?:src\/)?pages\/_app\.[jt]sx?$/.test(layer.file)) { props.Component = child; props.pageProps = {}; }
@@ -2296,7 +2503,7 @@ export async function analyze({
     });
     // Unknown source alternatives live in ui.conditions. Representable local
     // state candidates remain separate from concrete source documents.
-    for (const branch of branches.filter(b=>b.evidence==='source_inferred').slice(0, 30)) {
+    for (const branch of branches.filter(b=>b.evidence==='source_inferred')) {
       const key = identity("state", {page:pageKey,source:branch.source,label:branch.label});
       if(!states.some(state=>state.stateKey===key)){
         states.push({stateKey:key,pageKey,label:branch.label,evidence:branch.evidence,source:branch.source,documentKey:null});
@@ -2309,7 +2516,7 @@ export async function analyze({
       stateKey,
       kind: "source_projection",
       evidence: unprojected?'uncovered':"source_inferred",
-      viewport: { width: 1280, height: 800 },
+      viewport: nativePlatform ? { width: 390, height: 844 } : { width: 1280, height: 800 },
       html: concreteRoot.outerHTML,
       css: "",
       js: "",
@@ -2430,6 +2637,9 @@ export async function analyze({
   );
   css +=
     "\n.iam-state{display:contents}.iam-state[hidden]{display:none!important}";
+  let projectionCss = cssModules.css();
+  if (documents.some(d=>d.html.includes('class="iam-state'))) projectionCss += "\n.iam-state{display:contents}.iam-state[hidden]{display:none!important}";
+  if ([...modules.values()].some(m=>m.mdx)) projectionCss += '\n.iam-markdown{line-height:1.7}.iam-markdown p,.iam-markdown ul,.iam-markdown ol,.iam-markdown pre,.iam-markdown blockquote,.iam-markdown table{margin-block:1em}.iam-markdown h1,.iam-markdown h2,.iam-markdown h3{margin-block:1.2em .5em;font-weight:700;line-height:1.25}.iam-markdown h1{font-size:2em}.iam-markdown h2{font-size:1.5em}.iam-markdown h3{font-size:1.25em}.iam-markdown ul,.iam-markdown ol{padding-left:1.5em}.iam-markdown ul{list-style:disc}.iam-markdown ol{list-style:decimal}.iam-markdown pre{padding:1em;border-radius:.4em;background:#f1f5f9;color:#0f172a;overflow-x:auto;white-space:pre}.iam-markdown code{font-family:ui-monospace,monospace}.iam-markdown blockquote{padding-left:1em;border-left:3px solid #cbd5e1}.iam-markdown table{border-collapse:collapse}.iam-markdown th,.iam-markdown td{border:1px solid #cbd5e1;padding:.4em .7em}.iam-markdown a{text-decoration:underline}';
   if (!pages.length)
     throw new Error(
       "No supported source routes found. Use Next App Router, Next Pages Router or a statically declared React Router route tree.",
@@ -2458,10 +2668,10 @@ export async function analyze({
     schemaVersion: 2,
     producer: {
       name: "indiana-app-manifest-local",
-      version: "0.24.0",
-      method: "typescript-ast-and-bounded-static-projection;lucide-static-"+LUCIDE_SOURCE_VERSION,
+      version: "0.27.0",
+      method: "typescript-ast-and-bounded-static-projection;lucide-static-"+LUCIDE_SOURCE_VERSION+(nativePlatform ? ";react-native-source-preview-v1" : ""),
     },
-    app: { name, platforms: ["web"] },
+    app: { name, platforms: [platform] },
     routing,
     release: { repository, commit, sourceGraphDigest },
     pages,
@@ -2476,7 +2686,7 @@ export async function analyze({
       runtimeObserved: false,
       generatedPageCount: pages.length,
       sourcePageFileCount: pageFiles.length,
-      unsupportedFrameworks: ["vue", "svelte", "android", "ios"],
+      unsupportedFrameworks: nativePlatform ? ["vue", "svelte", "swiftui", "compose", "flutter", "react-navigation"] : ["vue", "svelte", "android", "ios"],
       gaps,
     },
     integrity: {
@@ -2499,6 +2709,7 @@ export async function analyze({
   const sourceGaps=new Map();
   for(const row of ui.uncovered){const key=JSON.stringify([row.routeKey,row.source,row.event,row.reason]);const prior=sourceGaps.get(key);if(prior)prior.nodeId=null;else sourceGaps.set(key,{...row});}
   ui.uncovered=[...sourceGaps.values()];
+  attachSourceStyles(manifest, projectionCss);
   manifest.routeTree = assembleRouteTree(manifest, ui, renderDefinitions, compositions.navigation);
   presentation.conditions=[...new Map(presentation.conditions.map(c=>[c.conditionKey,c])).values()];
   presentation.regions=presentation.regions.filter(r=>concrete.has(r.nodeId)&&r.options.every(o=>concrete.has(o.nodeId)));