@universalcms/connect 0.1.0 → 0.13.0

package/dist/content-storefront-setup.mjs

@@ -0,0 +1,155 @@
+/** Bounded native adapter for the exact reviewed storefront source profile.
+ * Customer code is parsed, never executed. Original modules and every shared
+ * dependency are retained and fingerprinted before the plan can be applied.
+ */
+import path from 'node:path';
+import ts from './vendor/typescript.cjs';
+import { readProjectFile, SetupError } from './core.mjs';
+import { discoverReviewedStorefrontSource, reviewedStorefrontBlockId } from './reviewed-storefront-source.mjs';
+import { CONTENT_BINDINGS_FILE, contentDigest, readFrozenContent, REVIEWED_STOREFRONT_PROFILE, reviewedNativePaths } from './content-registry.mjs';
+const json = value => `${JSON.stringify(value, null, 2)}\n`;
+const fail = message => { throw new SetupError(message); };
+const helperFile = 'src/components/UniversalCmsStorefront.jsx';
+const indexFile = '.universalcms/content/storefront.routes.mjs';
+
+// Part indices describe reviewed composite blocks, not heuristics or text
+// matching. Deleting a block removes every native presentation of that block.
+export function storefrontHelperTemplate() {
+  return `// Generated reviewed native storefront bindings. No credential or draft fallback.
+import React from 'react';
+import { PublishedDocumentProvider, usePublishedDocument, CmsBound, CmsAdditionalContent } from '@universalcms/connect/react-publication';
+import '@universalcms/connect/publication.css';
+import inventories from '../../.universalcms/content/storefront.routes.mjs';
+export function CmsStorefrontRoute({ slug, children }) {
+  const canonical = !slug || slug === 'home' ? 'home' : slug;
+  const route = inventories[canonical];
+  if (!route) return children;
+  return <PublishedDocumentProvider pathname={canonical === 'home' ? '/' : '/' + canonical} route={route}>{children}<CmsAdditionalContent /></PublishedDocumentProvider>;
+}
+export function CmsStorefrontBlock({ name, part, imageIndex, attribute, children }) {
+  const { entry, route, blocks } = usePublishedDocument();
+  const id = route.bindings[name]?.variants[0]?.id;
+  if (!id) return null;
+  const block = blocks.get(id), original = route.baseline.blocks.find(value => value.id === id);
+  if (!block || !original) return null;
+  if (imageIndex !== undefined && block.type === original.type) {
+    const item = block.type === 'image' ? block.data : block.type === 'gallery' ? block.data?.images?.[imageIndex] : undefined;
+    if (!item || !React.isValidElement(children) || children.type !== 'img') return null;
+    return React.cloneElement(children, { src: item.url, alt: item.alt ?? '', 'data-cms-block': id });
+  }
+  if (part !== undefined && block.type === original.type && React.isValidElement(children)) {
+    const text = String(block.text ?? '').split('\\n')[part] ?? '';
+    if (block.text === original.text) return React.cloneElement(children, { 'data-cms-block': id });
+    if (attribute === 'title') return React.cloneElement(children, { title: text, 'aria-label': text, 'data-cms-block': id });
+    return React.cloneElement(children, { 'data-cms-block': id }, text);
+  }
+  return <CmsBound slot={name} selector={[]}>{children}</CmsBound>;
+}
+`;
+}
+
+export function bindReviewedStorefrontModule(source, filename, descriptors) {
+  const file = ts.createSourceFile(filename, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.JSX);
+  const nodes = [];
+  const walk = node => { if (ts.isJsxElement(node) || ts.isJsxSelfClosingElement(node)) nodes.push(node); ts.forEachChild(node, walk); }; walk(file);
+  const classes = node => {
+    const open = ts.isJsxElement(node) ? node.openingElement : node;
+    const attribute = open.attributes.properties.find(value => ts.isJsxAttribute(value) && value.name.getText(file) === 'className');
+    return attribute?.initializer && ts.isStringLiteral(attribute.initializer) ? attribute.initializer.text.split(/\s+/) : [];
+  };
+  const edits = [];
+  for (const descriptor of descriptors) {
+    let matches = nodes.filter(node => descriptor.className ? classes(node).includes(descriptor.className) : descriptor.expression && node.getText(file).includes(descriptor.expression));
+    if (descriptor.expression) matches = matches.filter(node => !nodes.some(other => other !== node && other.getStart(file) >= node.getStart(file) && other.end <= node.end && other.getText(file).includes(descriptor.expression)));
+    if (descriptor.index !== undefined) matches = matches.slice(descriptor.index, descriptor.index + 1);
+    if (matches.length !== 1) fail(`The reviewed storefront binding in ${filename} is ambiguous. Existing source was preserved.`);
+    const node = matches[0], extra = descriptor.part !== undefined ? ` part={${descriptor.part}}` : descriptor.imageIndex !== undefined ? ` imageIndex={${descriptor.imageIndex}}` : '';
+    const child = node.getText(file);
+    const attribute = descriptor.attribute === 'title' ? ' attribute="title"' : '';
+    const opening = ts.isJsxElement(node) ? node.openingElement : node;
+    const key = opening.attributes.properties.find(attribute => ts.isJsxAttribute(attribute) && attribute.name.getText(file) === 'key');
+    edits.push({ start: node.getStart(file), end: node.end, text: `<CmsStorefrontBlock${key ? ` ${key.getText(file)}` : ''} name={${descriptor.name}}${extra}${attribute}>${child}</CmsStorefrontBlock>` });
+  }
+  const ordered = edits.sort((a, b) => a.start - b.start);
+  for (let index = 1; index < ordered.length; index++) if (ordered[index].start < ordered[index - 1].end) fail('Reviewed storefront slots overlap. No integration files were saved.');
+  let output = source;
+  for (const edit of edits.sort((a, b) => b.start - a.start)) output = output.slice(0, edit.start) + edit.text + output.slice(edit.end);
+  const reference = filename === 'src/App.jsx' ? './components/UniversalCmsStorefront' : './UniversalCmsStorefront';
+  output = `import { CmsStorefrontBlock${filename === 'src/App.jsx' ? ', CmsStorefrontRoute' : ''} } from '${reference}';\n` + output;
+  if (ts.createSourceFile(filename, output, ts.ScriptTarget.Latest, true, ts.ScriptKind.JSX).parseDiagnostics.length) fail('The reviewed storefront binding did not parse. Existing source was preserved.');
+  return output;
+}
+
+const slot = (className, name, extra = {}) => ({ className, name: JSON.stringify(name), ...extra });
+const dynamic = (className, name, extra = {}) => ({ className, name, ...extra });
+function transformedModules(sources) {
+  const output = new Map();
+  const bind = (file, descriptors) => output.set(file, bindReviewedStorefrontModule(sources.get(file), file, descriptors));
+  bind('src/components/Hero.jsx', [slot('hero-title','hero-title'),slot('hero-badge','hero-badge'),slot('hero-subtitle','hero-description'), ...[0,1,2].flatMap(index => [slot('stat-value',`hero-feature-${index}`,{index}),slot('stat-label',`hero-feature-copy-${index}`,{index})])]);
+  bind('src/components/CategoryPills.jsx', [slot('section-main-heading','capsule-title'),dynamic('tile-title',"'capsule-' + tile.id"),dynamic('tile-count',"'capsule-copy-' + tile.id",{part:1}),dynamic('tile-tagline',"'capsule-copy-' + tile.id",{part:0}),dynamic('tile-bg-image',"'capsule-image-' + tile.id",{imageIndex:0})]);
+  bind('src/components/ProductGrid.jsx',[slot('collection-kicker','collection-kicker'),slot('collection-heading','collection-title'),slot('collection-subtext','collection-description')]);
+  bind('src/components/ProductCard.jsx', [dynamic('product-title',"'product-' + product.id + '-title'"), dynamic('main-img',"'product-' + product.id + '-images'",{imageIndex:'isHovered && product.images[1] ? 1 : 0'}),dynamic('current-price',"'product-' + product.id + '-attributes'",{part:1}),dynamic('original-price',"'product-' + product.id + '-attributes'",{part:2}),dynamic('color-label-preview',"'product-' + product.id + '-attributes'",{part:'(product.onSale && product.originalPrice ? 3 : 2) + product.colors.findIndex(color => color.name === selectedColor.name)'}),{expression:'{product.badge}',name:"'product-' + product.id + '-attributes'",part:0},{expression:'title={c.name}',name:"'product-' + product.id + '-attributes'",part:'(product.onSale && product.originalPrice ? 3 : 2) + product.colors.indexOf(c)',attribute:'title'},{expression:'{s}',name:"'product-' + product.id + '-attributes'",part:'(product.onSale && product.originalPrice ? 3 : 2) + product.colors.length + product.sizes.indexOf(s)'}]);
+  bind('src/components/ProductModal.jsx', [dynamic('modal-product-title',"'product-' + product.id + '-title'"),dynamic('gallery-main-img',"'product-' + product.id + '-images'",{imageIndex:'activeImageIndex'}),dynamic('modal-description',"'product-' + product.id + '-description'"),dynamic('modal-badge',"'product-' + product.id + '-attributes'",{part:0}),dynamic('modal-current-price',"'product-' + product.id + '-attributes'",{part:1}),dynamic('modal-original-price',"'product-' + product.id + '-attributes'",{part:2}),{expression:'{product.fabric}',name:"'product-' + product.id + '-fabric'"},{expression:'{product.fit}',name:"'product-' + product.id + '-fit'"},{expression:'src={img}',name:"'product-' + product.id + '-images'",imageIndex:'idx'},dynamic('option-value-highlight',"'product-' + product.id + '-attributes'",{part:'(product.onSale && product.originalPrice ? 3 : 2) + product.colors.findIndex(color => color.name === selectedColor.name)'}),{expression:'{c.name}',name:"'product-' + product.id + '-attributes'",part:'(product.onSale && product.originalPrice ? 3 : 2) + product.colors.indexOf(c)'},{expression:'{s}',name:"'product-' + product.id + '-attributes'",part:'(product.onSale && product.originalPrice ? 3 : 2) + product.colors.length + product.sizes.indexOf(s)'}]);
+  bind('src/components/LookbookSection.jsx',[slot('lookbook-main-title','lookbook-title'),slot('lookbook-caption','lookbook-caption'),dynamic('lookbook-featured-image',"'look-' + activeLook.id + '-image'",{imageIndex:0}),dynamic('lookbook-hero-title',"'look-' + activeLook.id + '-title'"),dynamic('lookbook-loc-pill',"'look-' + activeLook.id + '-description'",{part:1}),dynamic('lookbook-hero-subtitle',"'look-' + activeLook.id + '-description'",{part:0}),dynamic('piece-pill-btn',"'look-' + activeLook.id + '-pieces'",{part:'idx'}),dynamic('thumb-title',"'look-' + look.id + '-description'",{part:0}),{expression:'src={look.image}',name:"'look-' + look.id + '-image'",imageIndex:0}]);
+  bind('src/components/TestimonialsSection.jsx',[slot('section-title-large','press-title'),slot('press-logos-strip','press-publications'),dynamic('testimonial-quote',"'review-' + idx + '-quote'"),dynamic('testimonial-author',"'review-' + idx + '-byline'",{part:0}),dynamic('testimonial-role',"'review-' + idx + '-byline'",{part:1}),dynamic('testimonial-item-tag',"'review-' + idx + '-byline'",{part:2})]);
+  bind('src/components/Newsletter.jsx',[slot('newsletter-heading','newsletter-title'),slot('newsletter-description','newsletter-description')]);
+  bind('src/components/InfoPage.jsx',[{expression:'{page.badge}',name:"'badge'"},{expression:'{page.title}',name:"'title'"},{expression:'{page.subtitle}',name:"'subtitle'"},{expression:'{section.title}',name:"'section-' + idx + '-title'"},{expression:'{section.content}',name:"'section-' + idx + '-copy'"}]);
+  bind('src/App.jsx',[{expression:'Atelier Collection',name:"'category-badge'"},{expression:'{CATEGORY_META[cleanSlug]?.title',name:"'category-title'"},{expression:'{CATEGORY_META[cleanSlug]?.excerpt',name:"'category-description'"}]);
+  let app = output.get('src/App.jsx');
+  // Do not carry a managed product modal into a native transactional route
+  // whose subtree intentionally has no CMS document context.
+  app = app.replace('const handleNavigate = (url) => {', 'const handleNavigate = (url) => {\n    setSelectedProductModal(null);');
+  const start = app.indexOf('<div className="atelier-app">'), end = app.lastIndexOf('</div>');
+  if (start < 0 || end < start) fail('The reviewed storefront root changed.');
+  app = app.slice(0,end + 6) + '</CmsStorefrontRoute>' + app.slice(end + 6);
+  app = app.slice(0,start) + '<CmsStorefrontRoute slug={cleanSlug}>' + app.slice(start);
+  output.set('src/App.jsx', app);
+  return output;
+}
+
+export async function planReviewedStorefrontContent(root, configuration, sourceEntries, prior) {
+  if (prior?.profile === REVIEWED_STOREFRONT_PROFILE) {
+    if (json(prior.routes.map(({path,kind,slug,locale}) => ({path,kind,slug,locale}))) !== json(configuration.routes)) fail('The installed reviewed storefront route ownership changed. Preserve it and review the adapter.');
+    const names = new Set(prior.files.map(file => file.path));
+    for (const row of prior.routes) {
+      const frozen = await readFrozenContent(root,row), source = sourceEntries.find(entry => entry.kind === row.kind && entry.slug === row.slug && entry.locale === row.locale);
+      if (!source || json(source.document) !== json(frozen.entry.document)) fail('A reviewed storefront source baseline changed. Preserve the imported block IDs and review it manually.');
+      for (const prefix of ['source','native','inventory','original']) names.add(row[`${prefix}File`]);
+    }
+    names.add(CONTENT_BINDINGS_FILE);
+    return { root, framework:'vite', routes:prior.routes, files:await Promise.all([...names].map(async name => ({path:name,content:await readProjectFile(root,name),state:'unchanged'}))) };
+  }
+  if (prior) return null;
+  const profile = await discoverReviewedStorefrontSource(root,{locale:configuration.routes[0]?.locale ?? 'en',readFile:name => readProjectFile(root,name)});
+  if (!profile) return null;
+  if (configuration.routes.length !== profile.manifest.entries.length || configuration.routes.some(row => !profile.manifest.entries.some(entry => entry.kind === row.kind && entry.slug === row.slug && entry.locale === row.locale && row.path === (entry.slug === 'home' ? '/' : '/' + entry.slug)))) fail('Every reviewed storefront URL must retain its original CMS identity.');
+  if (json(sourceEntries) !== json(profile.manifest.entries)) fail('The reviewed storefront import differs from the exact native source baseline. Existing CMS block IDs were preserved.');
+  const modules = transformedModules(profile.native.sources), files = [], routes = [], inventories = {};
+  const add = async (name, content, expected = null) => {
+    const current = await readProjectFile(root,name);
+    if (current !== expected) fail('A reviewed storefront output already exists or changed. Existing files were preserved.');
+    files.push({path:name,content,state:current === null ? 'create':'update',...(current !== null ? {previous:current}:{})});
+  };
+  const original = profile.native.sources.get('src/App.jsx'), native = modules.get('src/App.jsx');
+  const nativeFile = 'src/App.cms-native.jsx', originalFile = '.universalcms/content/storefront.original.txt';
+  const wrapper = "// Generated by @universalcms/connect. Native route state and CMS ownership are reviewed together.\nexport { default } from './App.cms-native';\n";
+  for (const route of configuration.routes) {
+    const entry = sourceEntries.find(entry => entry.slug === route.slug), keys = profile.native.keys[route.slug];
+    const inventory = {identity:{kind:route.kind,slug:route.slug,locale:route.locale},baseline:entry.document,bindings:Object.fromEntries(keys.map(key => [key,{variants:[{values:[],id:reviewedStorefrontBlockId(`${route.slug}:${key}`)}]}]))};
+    inventory.titleBlockId = reviewedStorefrontBlockId(`${route.slug}:${route.slug === 'home' ? 'hero-title' : ['outerwear','streetwear','tailoring','dresses','accessories'].includes(route.slug) ? 'category-title':'title'}`);
+    inventory.excerptBlockId = reviewedStorefrontBlockId(`${route.slug}:${route.slug === 'home' ? 'hero-description' : ['outerwear','streetwear','tailoring','dresses','accessories'].includes(route.slug) ? 'category-description':'subtitle'}`);
+    const inventoryFile = `.universalcms/content/storefront-${route.slug}.json`, inventoryText = json(inventory);
+    await add(inventoryFile,inventoryText); inventories[route.slug] = inventory;
+    routes.push({...route,sourceFile:'src/App.jsx',nativeFile,originalFile,inventoryFile,sourceHash:contentDigest(wrapper),nativeHash:contentDigest(native),originalHash:contentDigest(original),inventoryHash:contentDigest(inventoryText)});
+  }
+  await add(originalFile,original); await add(nativeFile,native); await add(helperFile,storefrontHelperTemplate()); await add(indexFile, Object.keys(inventories).map((slug,index) => `import route${index} from './storefront-${slug}.json';`).join('\n') + '\nexport default {' + Object.keys(inventories).map((slug,index) => `${JSON.stringify(slug)}:route${index}`).join(',') + '};\n');
+  for (const [name,content] of modules) if(name !== 'src/App.jsx') {
+    await add(`.universalcms/content/original-${path.basename(name)}.txt`,profile.native.sources.get(name));
+    await add(name,content,profile.native.sources.get(name));
+  }
+  await add('src/App.jsx',wrapper,original);
+  for (const [name,content] of profile.native.sources) if (!modules.has(name)) files.push({path:name,content,state:'unchanged'});
+  const registry = {version:1,profile:REVIEWED_STOREFRONT_PROFILE,nativePaths:reviewedNativePaths(REVIEWED_STOREFRONT_PROFILE),routes,files:files.filter(file => !file.path.startsWith('.universalcms/content/storefront-')).map(file => ({path:file.path,sha256:contentDigest(file.content)}))};
+  await add(CONTENT_BINDINGS_FILE,json(registry));
+  return {root,framework:'vite',files,routes};
+}

package/dist/content-vite-setup.mjs

@@ -0,0 +1,107 @@
+/** Native React/Vite binding setup. Source files are parsed, never executed. */
+import path from 'node:path';
+import { lstat } from 'node:fs/promises';
+import { projectRoot, readProjectFile, SetupError } from './core.mjs';
+import { validatePublicationConfig } from './publication.mjs';
+import { transformSourcePublication } from './source-bindings.mjs';
+import { CONTENT_BINDINGS_FILE, contentDigest, readContentRegistry, readFrozenContent } from './content-registry.mjs';
+import { readPlannedSourceFile } from './source-setup.mjs';
+import { publicBindingInventory } from './public-bindings.mjs';
+import { planReviewedStorefrontContent } from './content-storefront-setup.mjs';
+
+export const CONTENT_ROUTES_FILE = '.universalcms/content.routes.json';
+const json = value => `${JSON.stringify(value, null, 2)}\n`;
+const fail = message => { throw new SetupError(message); };
+const identity = row => `${row.kind}:${row.locale}:${row.slug}`;
+const relativeImport = (from, to) => { const value = path.posix.relative(path.posix.dirname(from), to); return value.startsWith('.') ? value : `./${value}`; };
+const modulePath = value => typeof value === 'string' && /^src\/(?:[A-Za-z0-9_-]+\/)*[A-Za-z0-9_-]+\.(?:jsx|tsx)$/.test(value) && !/(?:^|\/)(?:api|admin|account|auth|checkout|private|patient|vault|dashboard)(?:\/|\.)/.test(value);
+
+export function viteContentPageTemplate(row, frozen) {
+  const native = relativeImport(row.sourceFile, row.nativeFile).replace(/\.(?:jsx|tsx)$/, '');
+  const inventory = relativeImport(row.sourceFile, row.inventoryFile);
+  let publicInventory;if(frozen){try{publicInventory=publicBindingInventory(frozen);}catch{fail('Public React content needs explicit review for structured or data-driven source bindings. Existing source was preserved.');}}
+  return `// Generated by @universalcms/connect. Published content only; native state stays mounted.\nimport { createElement } from 'react';\nimport { PublishedDocumentProvider } from '@universalcms/connect/react-publication';\nimport '@universalcms/connect/publication.css';\nimport NativePage from ${JSON.stringify(native)};\n${publicInventory?'const inventory = '+JSON.stringify(publicInventory)+';':'import inventory from '+JSON.stringify(inventory)+';'}\nexport * from ${JSON.stringify(native)};\n\nexport default function UniversalCMSPublishedPage(props${row.sourceFile.endsWith('.tsx') ? ': Record<string, unknown>' : ''}) {\n  return createElement(PublishedDocumentProvider, { pathname: ${JSON.stringify(row.path)}, route: inventory${row.sourceFile.endsWith('.tsx') ? " as import('@universalcms/connect/react-publication').Inventory" : ''}, children: createElement(NativePage, props) });\n}\n`;
+}
+const wrapper = viteContentPageTemplate;
+
+async function filePlan(root, filename, content, previous) {
+  const current = await readProjectFile(root, filename);
+  if (current !== null && (await lstat(path.join(root, filename))).nlink !== 1) fail('Content setup cannot replace linked files.');
+  if (current !== null && current !== content && current !== previous) fail('A content binding file contains custom changes. Preserve them and review the integration manually.');
+  return { path: filename, content, state: current === content ? 'unchanged' : current === null ? 'create' : 'update', ...(current !== null && current !== content ? { previous: current } : {}) };
+}
+
+/** Explicit reviewed route/module mapping, or one unambiguous App homepage. */
+export async function planViteContent(directory, configuration, sourcePlan) {
+  const root = await projectRoot(directory), config = validatePublicationConfig(configuration);
+  if (sourcePlan && sourcePlan.root !== root) fail('The planned source inventory belongs to a different website.');
+  const registry = await readContentRegistry(root);
+  const reviewedSourceText = readPlannedSourceFile(sourcePlan, '.universalcms/source.entries.json') ?? await readProjectFile(root, '.universalcms/source.entries.json');
+  let reviewedEntries;
+  try { reviewedEntries = JSON.parse(reviewedSourceText)?.entries; } catch { /* The ordinary planner supplies its existing diagnostic. */ }
+  if (Array.isArray(reviewedEntries)) {
+    const reviewed = await planReviewedStorefrontContent(root, config, reviewedEntries, registry);
+    if (reviewed) return reviewed;
+  }
+  const mappingText = readPlannedSourceFile(sourcePlan, CONTENT_ROUTES_FILE) ?? await readProjectFile(root, CONTENT_ROUTES_FILE);
+  let mappings;
+  if (mappingText !== null) {
+    try { mappings = JSON.parse(mappingText); } catch { fail('Use a JSON array of path and sourceFile mappings in .universalcms/content.routes.json.'); }
+    if (!Array.isArray(mappings) || mappings.length > 1000 || mappings.some(row => !row || Object.keys(row).sort().join() !== 'path,sourceFile' || typeof row.path !== 'string' || !modulePath(row.sourceFile)) || new Set(mappings.map(row => row.path)).size !== mappings.length || new Set(mappings.map(row => row.sourceFile)).size !== mappings.length) fail('Content routes require unique public paths and ordinary src/*.jsx or src/*.tsx modules. Map one default-exported page component per original URL.');
+  } else if (registry) mappings = registry.routes.map(row => ({ path: row.path, sourceFile: row.sourceFile }));
+  else {
+    const candidates = [];
+    if (config.routes.length === 1 && config.routes[0].path === '/') for (const filename of ['src/App.jsx', 'src/App.tsx']) if (await readProjectFile(root, filename) !== null) candidates.push(filename);
+    if (candidates.length !== 1) fail('CONTENT RENDERING INCOMPLETE: Map each reviewed Vite URL to its public page component in .universalcms/content.routes.json (for example [{"path":"/","sourceFile":"src/App.jsx"}]), then rerun setup. Source import and publication checks alone do not render CMS edits.');
+    mappings = [{ path: '/', sourceFile: candidates[0] }];
+  }
+  if (config.routes.length !== mappings.length || config.routes.some(route => !mappings.some(row => row.path === route.path))) fail('Every reviewed publication URL needs one content route mapping. Preserve custom routers and map their actual page modules explicitly.');
+  if (registry?.routes.some(row => !config.routes.some(route => route.path === row.path && identity(route) === identity(row)))) fail('Previously bound routes were removed or remapped. Preserve their ownership and review the existing content bindings manually.');
+  const sourceText = readPlannedSourceFile(sourcePlan, '.universalcms/source.entries.json') ?? await readProjectFile(root, '.universalcms/source.entries.json');
+  let entries;
+  try { entries = JSON.parse(sourceText).entries; if (!Array.isArray(entries)) throw Error(); } catch { fail('Published-content setup requires the reviewed Vite source manifest.'); }
+  const files = [], rows = [];
+  for (const route of config.routes) {
+    const mapping = mappings.find(row => row.path === route.path);
+    const previous = registry?.routes.find(row => row.path === route.path);
+    const exported = entries.find(entry => identity(entry) === identity(route));
+    if (!exported) fail('A content route has no matching reviewed source document.');
+    if (previous) {
+      if (previous.sourceFile !== mapping.sourceFile || identity(previous) !== identity(route)) fail('An installed content mapping changed. Review it manually before changing native module ownership.');
+      const frozen = await readFrozenContent(root, previous);
+      if (json(frozen.entry.document) !== json(exported.document)) fail('A bound source baseline changed. Keep the frozen import identities and edit public content in the CMS.');
+      if (await readProjectFile(root, previous.sourceFile) !== wrapper(previous, frozen.inventory)) fail('The existing React content wrapper needs review for the public binding format. Existing files were preserved; this setup does not rewrite older or customized adapters.');
+      for (const name of [previous.sourceFile, previous.nativeFile, previous.inventoryFile, previous.originalFile]) files.push(await filePlan(root, name, await readProjectFile(root, name)));
+      rows.push(previous); continue;
+    }
+    const original = await readProjectFile(root, mapping.sourceFile);
+    if (original === null || /@universalcms\/connect\/react-publication|\b(?:useSession|getServerSession|requireAuth|currentUser)\s*\(/.test(original)) fail('The selected public component needs a reviewed content binding. Existing integrations and access controls were preserved.');
+    if (exported.document?.blocks?.length === 0) {
+      fail('Public React source needs explicit review: a fallback page has no complete literal content inventory. Existing source was preserved.');
+    }
+    const isFallback = sourcePlan?.diagnostics?.discovery === 'fallback' || (exported.document?.blocks?.length === 1 && exported.document.blocks[0]?.id === 'block-home-heading');
+    if (isFallback) fail('Public React source needs explicit review: automatic fallback discovery has no verified native content bindings. Provide a reviewed source manifest and renderer mapping before full setup. Existing source was preserved.');
+    const transformed = transformSourcePublication({ source: original, slug: route.slug, locale: route.locale, filename: mapping.sourceFile, allowNamedExports: true, publicSource: true });
+    const extracted = transformed.inventory.baseline.blocks, actual = exported.document?.blocks;
+    // IDs imported by an AI mapping may differ from deterministic extraction.
+    // Reuse them only when the entire ordered block structure matches exactly.
+    const signature = block => JSON.stringify({ type: block.type, text: block.text, data: block.data ?? {} });
+    if (!Array.isArray(actual) || extracted.length !== actual.length || extracted.some((block, index) => signature(block) !== signature(actual[index]))) fail('The reviewed source document does not exactly match this page component. Preserve imported IDs and use an explicit shared renderer mapping; setup cannot guess which native text belongs to a CMS block.');
+    const ids = new Map(extracted.map((block, index) => [block.id, actual[index].id]));
+    for (const binding of Object.values(transformed.inventory.bindings)) for (const variant of binding.variants) variant.id = ids.get(variant.id);
+    if (transformed.inventory.titleBlockId) transformed.inventory.titleBlockId = ids.get(transformed.inventory.titleBlockId);
+    transformed.inventory.baseline = exported.document;
+    transformed.inventory.identity = { kind: route.kind, slug: route.slug, locale: route.locale };
+    const token = contentDigest(route.path).slice(0, 20), extension = path.posix.extname(mapping.sourceFile);
+    const row = { ...route, sourceFile: mapping.sourceFile, nativeFile: mapping.sourceFile.slice(0, -extension.length) + '.cms-native' + extension, inventoryFile: `.universalcms/content/${token}.json`, originalFile: `.universalcms/content/${token}.original.txt` };
+    const inventoryText = json(transformed.inventory), source = wrapper(row, transformed.inventory);
+    Object.assign(row, { sourceHash: contentDigest(source), nativeHash: contentDigest(transformed.source), inventoryHash: contentDigest(inventoryText), originalHash: contentDigest(original) });
+    files.push(await filePlan(root, row.originalFile, original), await filePlan(root, row.nativeFile, transformed.source), await filePlan(root, row.inventoryFile, inventoryText), await filePlan(root, row.sourceFile, source, original));
+    rows.push(row);
+  }
+  files.push(await filePlan(root, CONTENT_BINDINGS_FILE, json({ version: 1, routes: rows }), registry ? await readProjectFile(root, CONTENT_BINDINGS_FILE) : undefined));
+  files.push(await filePlan(root, '.universalcms/source.entries.json', sourceText));
+  if (mappingText !== null) files.push(await filePlan(root, CONTENT_ROUTES_FILE, mappingText));
+  if (files.some(file => Buffer.byteLength(file.content) > 128 * 1024)) fail('A generated content binding exceeds the bounded setup-file budget. Split the mapping into reviewed components instead of saving an unreadable integration.');
+  return { root, framework: 'vite', files, routes: rows };
+}

package/dist/core.mjs

@@ -4,59 +4,16 @@ import { randomUUID } from 'node:crypto';
 import path from 'node:path';
 import { analyzeProjectDirectory } from './vendor/analyze-project.mjs';
 import { verifyPublishedDelivery } from './vendor/check-delivery.mjs';
-import { createTemplates, legacySetupGuide } from './templates.mjs';
+import { createTemplates, legacySetupGuide, previousSetupGuide, priorPublicationSetupGuide, previousPublicationSetupGuide, previousRenderingSetupGuide, previousViteSourceWrapper, previousPublicationViteWrapper, previousDiagnosticViteWrapper } from './templates.mjs';
+import { frameworkOwnershipReview } from './framework-ownership.mjs';
 
-export class SetupError extends Error {}
+import { SetupError, projectRoot, inspect, readProjectFile } from './project-files.mjs';
+export { SetupError, projectRoot, readProjectFile };
 const fail = message => { throw new SetupError(message); };
 const uuid = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-const maxFileBytes = 128 * 1024;
 export const CONFIG_FILE = '.universalcms/config.json';
 const plain = value => value && typeof value === 'object' && !Array.isArray(value);
 
-export async function projectRoot(directory) {
-  const requested = path.resolve(directory);
-  const stat = await lstat(requested);
-  if (!stat.isDirectory() || stat.isSymbolicLink()) fail('Choose an ordinary project directory, not a symbolic link.');
-  return realpath(requested);
-}
-
-/** Every segment is checked before reading or creating; external symlinks are never followed. */
-async function inspect(root, relative, directory = false) {
-  if (typeof relative !== 'string' || !relative || relative.includes('\\') || path.isAbsolute(relative) || relative.split('/').some(part => !part || part === '.' || part === '..')) fail('Unsafe generated path.');
-  let target = root;
-  const segments = relative.split('/');
-  for (let index = 0; index < segments.length; index++) {
-    target = path.join(target, segments[index]);
-    let stat;
-    try { stat = await lstat(target); }
-    catch (error) { if (error.code === 'ENOENT') return null; throw error; }
-    if (stat.isSymbolicLink() || await realpath(target) !== target) fail('A setup path is a symbolic link. Use ordinary project files.');
-    const shouldBeDirectory = index < segments.length - 1 || directory;
-    if (shouldBeDirectory ? !stat.isDirectory() : !stat.isFile()) fail('A setup path has an incompatible file type.');
-    if (index === segments.length - 1) return { target, stat };
-  }
-}
-
-export async function readProjectFile(root, relative) {
-  const found = await inspect(root, relative);
-  if (!found) return null;
-  if (found.stat.size > maxFileBytes) fail('A setup file exceeds the read limit.');
-  const handle = await open(found.target, constants.O_RDONLY | constants.O_NOFOLLOW);
-  try {
-    const stat = await handle.stat();
-    if (!stat.isFile() || stat.ino !== found.stat.ino || stat.dev !== found.stat.dev || stat.size > maxFileBytes) fail('A project file changed during inspection. Retry setup.');
-    const buffer = Buffer.alloc(maxFileBytes + 1);
-    let bytes = 0;
-    while (bytes < buffer.length) {
-      const result = await handle.read(buffer, bytes, buffer.length - bytes, bytes);
-      if (!result.bytesRead) break;
-      bytes += result.bytesRead;
-    }
-    if (bytes > maxFileBytes) fail('A setup file exceeds the read limit.');
-    return new TextDecoder('utf-8', { fatal: true }).decode(buffer.subarray(0, bytes));
-  } finally { await handle.close(); }
-}
-
 function supportedVersion(value, majors, minMinor = 0) {
   if (typeof value !== 'string') return false;
   const match = /^(?:\^|~)?(\d+)\.(\d+)\.(\d+)$/.exec(value);
@@ -81,13 +38,22 @@ export function validateConfig(input) {
 }
 
 async function checkNextRoute(root, appDirectory, mount, existingConfig) {
+  let settingsObservations = [];
   const mountName = mount.slice(1);
   const route = `${appDirectory}/${mountName}`;
   const found = await inspect(root, route, true);
   if (found && !existingConfig) fail('The chosen Next.js mount already exists. Choose a free mount or integrate it manually.');
   // A sibling group/dynamic route can own the same URL. Never guess its semantics.
   const entries = await readdir(path.join(root, appDirectory), { withFileTypes: true });
-  if (entries.some(entry => entry.name.startsWith('(') || entry.name.startsWith('[') || entry.name.startsWith('@'))) fail('Route groups, parallel routes or dynamic root routes need a manual route review before setup.');
+  if (existingConfig && entries.some(entry => entry.name === '[...cmsPath]')) {
+    // The explicit settings installer owns this route. Validate its entire
+    // current plan; a folder name or a user-edited manifest alone is not proof.
+    const { planWebsiteSettings } = await import('./website-setup.mjs');
+    const settings = await planWebsiteSettings(root);
+    if (settings.files.some(file => file.state !== 'unchanged') || !settings.files.some(file => file.path === `${appDirectory}/[...cmsPath]/page.tsx`)) fail('The website settings route needs review before setup.');
+    settingsObservations = settings.files;
+  }
+  if (entries.some(entry => (entry.name.startsWith('(') || entry.name.startsWith('[') || entry.name.startsWith('@')) && !(settingsObservations.length && entry.name === '[...cmsPath]'))) fail('Route groups, parallel routes or dynamic root routes need a manual route review before setup.');
   for (const directory of ['pages', 'src/pages']) {
     if (!await inspect(root, directory, true)) continue;
     const siblings = await readdir(path.join(root, directory), { withFileTypes: true });
@@ -101,6 +67,7 @@ async function checkNextRoute(root, appDirectory, mount, existingConfig) {
       if (children.some(name => !['page.jsx', 'error.jsx'].includes(name))) fail('The generated mount contains additional routes. Review the route tree manually.');
     }
   }
+  return settingsObservations;
 }
 
 export async function analyze(directory) {
@@ -119,6 +86,8 @@ export async function planSetup(directory, options, { reconfigure = false } = {}
   if (manifest.workspaces || analysis.warnings.some(warning => /invalid|workspace|Conflicting/.test(warning))) fail('Choose one valid website project. Conflicting, workspace or unreadable configuration needs manual review.');
   const framework = options.framework ?? (deps.next ? 'next' : deps.vite && deps.react ? 'vite' : null);
   if (!['next', 'vite'].includes(framework)) fail('Supported templates are Next.js App Router and React/Vite. Other frameworks need manual setup.');
+  const ownership = await frameworkOwnershipReview(manifest, framework, name => readProjectFile(root, name));
+  if (ownership) fail(ownership);
   if (!supportedVersion(deps.react, [19], 2)) fail('The renderer requires a declared stable React 19.2 or newer 19.x version. Upgrade deliberately or use manual integration.');
   let appDirectory = null;
   if (framework === 'next') {
@@ -146,7 +115,7 @@ export async function planSetup(directory, options, { reconfigure = false } = {}
     if (prior.framework !== config.framework || prior.mount !== config.mount || prior.appDirectory !== config.appDirectory) fail('Changing the generated route or framework needs a manual integration review. Existing routes were preserved.');
   }
   if (existingConfig && !reconfigure && existingConfig !== `${JSON.stringify(config, null, 2)}\n`) fail('This project already has a different CMS connection. Use interactive setup to update unchanged generated files, or review the integration manually.');
-  if (framework === 'next') await checkNextRoute(root, appDirectory, config.mount, existingConfig);
+  const settingsObservations = framework === 'next' ? await checkNextRoute(root, appDirectory, config.mount, existingConfig) : [];
   const templateOptions = { existingNodeServer: framework === 'vite' && analysis.runtime === 'node' && analysis.rendering === 'server' };
   const files = await createTemplates(config, templateOptions);
   files.unshift({ path: CONFIG_FILE, content: `${JSON.stringify(config, null, 2)}\n` });
@@ -155,11 +124,12 @@ export async function planSetup(directory, options, { reconfigure = false } = {}
   for (const file of files) {
     const current = await readProjectFile(root, file.path);
     const old = previous.get(file.path);
-    const generatedBefore = old !== undefined && (old === current || (file.path === '.universalcms/SETUP.md' && legacySetupGuide(old) === current));
+    const generatedBefore = old !== undefined && (old === current || (file.path === '.universalcms/vite.config.mjs' && (previousViteSourceWrapper(old) === current || previousPublicationViteWrapper(old) === current || previousDiagnosticViteWrapper(old) === current)) || (file.path === '.universalcms/SETUP.md' && (previousRenderingSetupGuide(old) === current || previousPublicationSetupGuide(old) === current || priorPublicationSetupGuide(old) === current || previousSetupGuide(old) === current || legacySetupGuide(old) === current)));
     file.state = current === null ? 'create' : current === file.content ? 'unchanged' : reconfigure && generatedBefore ? 'update' : 'conflict';
     if (file.state === 'update') file.previous = current;
   }
   if (files.some(file => file.state === 'conflict')) fail('A generated file already contains different content. No files were changed. Preserve your edits and finish the integration manually.');
+  for (const observation of settingsObservations) if (!files.some(file => file.path === observation.path)) files.push(observation);
   return { root, config, analysis, files };
 }
 
@@ -169,6 +139,7 @@ export async function validatePlan(plan) {
   if (await projectRoot(plan.root) !== plan.root) fail('The project directory changed after planning. Run setup again from the intended directory.');
   for (const file of plan.files) {
     const current = await readProjectFile(plan.root, file.path);
+    if (file.state === 'unchanged' && current === null) fail('A file was removed after planning. Existing changes were preserved; run setup again.');
     if (file.state === 'update') {
       if (current !== file.previous) fail('A file changed after planning. No existing file was overwritten.');
       const found = await inspect(plan.root, file.path);
@@ -214,7 +185,17 @@ export async function applyPlan(plan) {
 export async function checkConnection(directory, { slug, env = process.env, fetcher } = {}) {
   const root = await projectRoot(directory);
   let config;
-  try { config = validateConfig(JSON.parse(await readProjectFile(root, CONFIG_FILE))); }
+  try {
+    const existing = await readProjectFile(root, CONFIG_FILE);
+    if (existing !== null) config = validateConfig(JSON.parse(existing));
+    else {
+      const { readPublicationConfiguration } = await import('./publication-setup.mjs');
+      const publication = await readPublicationConfiguration(root);
+      const route = publication?.routes.find(item => item.kind === 'page' && item.slug === slug);
+      if (!publication || !route) throw Error();
+      config = { ...publication, locale: route.locale };
+    }
+  }
   catch { fail('Run init first and keep its valid connection configuration.'); }
   return verifyPublishedDelivery({ slug, locale: config.locale, env: {
     // Match the generated runtime's private origin override while retaining its

package/dist/framework-ownership.mjs

@@ -0,0 +1,68 @@
+const own = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+const plain = value => value !== null && typeof value === 'object' && !Array.isArray(value);
+const configs = name => ['js', 'mjs', 'cjs', 'ts'].map(extension => `${name}.config.${extension}`);
+const owners = [
+  { label: 'Next.js', adapter: 'next', dependencies: ['next'], files: configs('next') },
+  { label: 'Nuxt', adapter: 'nuxt', dependencies: ['nuxt'], files: configs('nuxt') },
+  { label: 'Astro', adapter: 'astro', dependencies: ['astro'], files: [...configs('astro'), 'astro.config.mts', 'astro.config.cts'] },
+  { label: 'SvelteKit', adapter: 'svelte', dependencies: ['@sveltejs/kit', 'svelte'], files: configs('svelte') },
+  { label: 'Angular', adapter: 'angular', dependencies: ['@angular/core'], files: ['angular.json'] },
+  { label: 'Vue', adapter: 'vue', dependencies: ['vue', '@vue/cli-service'], files: configs('vue') },
+  { label: 'Remix or React Router framework', dependencies: ['@remix-run/react', '@remix-run/dev', '@react-router/dev'], files: [...configs('remix'), ...configs('react-router')] },
+  { label: 'Gatsby', dependencies: ['gatsby'], files: ['gatsby-config.js', 'gatsby-config.mjs', 'gatsby-config.ts'] },
+];
+
+/** A missing framework command is not evidence that another framework's files
+ * belong to React/Vite. This only narrows adapter eligibility; it does not change
+ * the public project-analysis report or infer a backend from dependencies. */
+export async function frameworkOwnershipReview(manifest, adapter, readFile) {
+  if (!plain(manifest) || ['dependencies', 'devDependencies', 'optionalDependencies'].some(name => manifest[name] !== undefined && !plain(manifest[name]))) return 'The website dependency declarations need manual review.';
+  const declared = name => ['dependencies', 'devDependencies', 'optionalDependencies'].some(field => plain(manifest[field]) && own(manifest[field], name));
+  for (const owner of owners) {
+    if (owner.adapter === adapter || adapter === 'nuxt' && owner.adapter === 'vue') continue;
+    if (owner.dependencies.some(declared)) return `${owner.label} ownership evidence requires a reviewed integration; automatic ${adapter === 'vite' ? 'React/Vite' : adapter === 'astro' ? 'Astro' : 'Next.js'} setup cannot adopt it.`;
+    for (const file of owner.files) {
+      try {
+        if (await readFile(file) !== null) return `${owner.label} configuration requires a reviewed integration; automatic ${adapter === 'vite' ? 'React/Vite' : adapter === 'astro' ? 'Astro' : 'Next.js'} setup cannot adopt it.`;
+      } catch { return 'A framework configuration could not be safely inspected. Preserve it and complete a manual integration review.'; }
+    }
+  }
+  return null;
+}
+
+function ordinaryNextCommand(value, operation) {
+  if (typeof value !== 'string' || value.length > 8192 || /[\r\n\0;&|`$<>\\]/.test(value)) return false;
+  const words = []; let token = '', quote = '', started = false;
+  for (const character of value.trim()) {
+    if (quote) { if (character === quote) quote = ''; else token += character; }
+    else if (character === '"' || character === "'") { quote = character; started = true; }
+    else if (/\s/.test(character)) { if (started) { words.push(token); token = ''; started = false; } }
+    else { token += character; started = true; }
+  }
+  if (quote) return false;
+  if (started) words.push(token);
+  if (words[0] !== 'next' || words[1] !== operation) return false;
+  const flags = new Set(operation === 'dev' ? ['--turbo', '--turbopack', '--webpack', '--experimental-https', '--disable-source-maps'] : []);
+  let directory = false;
+  for (let index = 2; index < words.length; index++) {
+    const word = words[index];
+    if (word === '.') { if (directory) return false; directory = true; continue; }
+    if (flags.has(word)) continue;
+    const equal = word.indexOf('='), name = equal === -1 ? word : word.slice(0, equal);
+    const argument = equal === -1 ? words[++index] : word.slice(equal + 1);
+    if (['-p', '--port'].includes(name)) { if (!/^\d{1,5}$/.test(argument ?? '') || Number(argument) < 1 || Number(argument) > 65535) return false; }
+    else if (['-H', '--hostname'].includes(name)) { if (!/^[a-z\d._:[\]-]+$/i.test(argument ?? '')) return false; }
+    else if (operation === 'start' && name === '--keepAliveTimeout') { if (!/^\d{1,9}$/.test(argument ?? '')) return false; }
+    else return false;
+  }
+  return true;
+}
+
+/** Separate predev/prestart hooks remain owned by the project. Only commands
+ * that actually start Next are checked; custom wrappers are never executed. */
+export function nextStartupReview(manifest) {
+  if (manifest.scripts === undefined) return null;
+  if (!plain(manifest.scripts)) return 'The website scripts need manual review.';
+  for (const name of ['dev', 'start']) if (own(manifest.scripts, name) && !ordinaryNextCommand(manifest.scripts[name], name)) return 'Next.js dev/start scripts use a custom server, project directory or unrecognized wrapper. Preserve that startup and use a reviewed Next.js integration.';
+  return null;
+}

package/dist/framework.mjs

@@ -0,0 +1,54 @@
+import { analyze, projectRoot, readProjectFile, SetupError } from './core.mjs';
+import { inspectAstroProject } from './astro-setup.mjs';
+import { frameworkOwnershipReview, nextStartupReview } from './framework-ownership.mjs';
+import { nativeFramework, nativeFrameworkLabels, inspectNativeProject, isNativeFramework } from './native-adapters.mjs';
+
+const plain = value => value && typeof value === 'object' && !Array.isArray(value);
+const supportedVersion = (value, majors, minimumMinor = 0) => {
+  const match = typeof value === 'string' && /^(?:\^|~)?(\d+)\.(\d+)\.(\d+)$/.exec(value);
+  return !!match && majors.includes(Number(match[1])) && Number(match[2]) >= minimumMinor;
+};
+const labels = new Set(['Next.js', 'React', 'Vue', 'Nuxt', 'Angular', 'Astro', 'SvelteKit', 'Laravel', 'WordPress', 'Static', 'Custom']);
+
+/** Select from local evidence, never from a CMS label or the absence of Next.js. */
+export async function inspectSetupFramework(directory, { analysis: existingAnalysis } = {}) {
+  const root = await projectRoot(directory);
+  const analysis = existingAnalysis ?? await analyze(root);
+  const label = labels.has(analysis.framework) ? analysis.framework : 'Custom';
+  const manual = reason => {
+    const guidance = ['Laravel', 'WordPress'].includes(label)
+      ? 'Use the existing PHP backend and server-side delivery REST API; do not install React adapters.'
+      : ['Vue', 'Nuxt', 'Angular', 'SvelteKit'].includes(label)
+        ? `Use the supported ${label} Node setup from Developer setup. Custom routes, layouts and unsupported versions require review.`
+        : 'Use Developer setup to review the existing runtime, public routes and content bindings with your developer.';
+    throw new SetupError(`Detected ${label}. ${reason} Automatic setup supports reviewed Next.js, React/Vite, Astro, Vue, Nuxt, Angular SSR, SvelteKit and literal HTML profiles with compatible installed versions. WordPress uses its separate native plugin and WP-CLI. ${guidance} No integration files or keys were saved.`);
+  };
+  let manifest;
+  try { manifest = JSON.parse(await readProjectFile(root, 'package.json')); } catch { /* Report only a fixed, public diagnostic. */ }
+  if (!plain(manifest)) manual('A valid website package.json is required for this CLI adapter.');
+  if (manifest.workspaces || analysis.warnings.some(value => /invalid|workspace|conflicting/i.test(value))) manual('Workspace, conflicting or unreadable project evidence requires a manual review.');
+  for (const key of ['dependencies', 'devDependencies', 'scripts']) if (manifest[key] !== undefined && !plain(manifest[key])) manual('The website manifest needs review.');
+  const deps = { ...manifest.devDependencies, ...manifest.dependencies };
+  let framework;
+  const native = nativeFramework(manifest);
+  if (native) {
+    await inspectNativeProject(root, native, manifest);
+    framework = native;
+  } else if (deps.astro && label === 'Astro') {
+    await inspectAstroProject(root, manifest);
+    framework = 'astro';
+  } else if (label === 'Next.js' && deps.next) {
+    if (!supportedVersion(deps.next, [16]) || analysis.runtime !== 'node') manual('Static exports, unsupported Next.js versions and uncertain server runtimes need a framework-specific integration.');
+    const startup = nextStartupReview(manifest);
+    if (startup) manual(startup);
+    framework = 'next';
+  } else if (label === 'React' && analysis.frontend === 'React' && deps.react && deps.vite && !deps.next) {
+    if (!supportedVersion(deps.vite, [6, 7, 8])) manual('This Vite version is not supported.');
+    if (analysis.runtime === 'node' || analysis.rendering === 'server') manual('The existing custom server must retain its routing and renderer; integrate the CMS handlers explicitly.');
+    framework = 'vite';
+  } else manual('This project does not match an automatic page-binding adapter.');
+  const ownership = await frameworkOwnershipReview(manifest, framework, name => readProjectFile(root, name));
+  if (ownership) manual(ownership);
+  if (!isNativeFramework(framework) && !supportedVersion(deps.react, [19], 2)) manual('The shared renderer requires a declared stable React 19.2 or newer 19.x version. Upgrade deliberately or use the existing renderer.');
+  return { root, framework, label: nativeFrameworkLabels[framework] ?? (framework === 'vite' ? 'React/Vite' : framework === 'astro' ? 'Astro' : 'Next.js'), analysis, manifest };
+}