@primeuicom/mcp 0.1.27 → 0.1.29

package/dist/service.js

@@ -485,42 +485,13 @@ import { unlink } from "fs/promises";
 import path5 from "path";
 import { Readable, Transform } from "stream";
 import { pipeline } from "stream/promises";
-import { z as z3 } from "zod";
-
-// src/lib/fs.ts
-import { mkdir, rm, writeFile } from "fs/promises";
-import path4 from "path";
-import extractZipArchive from "extract-zip";
-async function ensureDir(dirPath) {
-  await mkdir(dirPath, { recursive: true });
-}
-async function resetDir(dirPath) {
-  await rm(dirPath, { recursive: true, force: true });
-  await mkdir(dirPath, { recursive: true });
-}
-async function writeUtf8(filePath, content) {
-  await ensureDir(path4.dirname(filePath));
-  await writeFile(filePath, content, "utf-8");
-}
-async function extractZip(zipPath, targetDir) {
-  await ensureDir(targetDir);
-  try {
-    await extractZipArchive(zipPath, { dir: targetDir });
-  } catch (error) {
-    const details = error instanceof Error ? error.message : String(error);
-    throw new Error(`Failed to extract zip at "${zipPath}". ${details}`);
-  }
-}
 
-// src/sources/api-provider.ts
-var DEFAULT_API_BASE_URL = "https://app.primeui.com/";
-var ZIP_CONTENT_TYPES = [
-  "application/zip",
-  "application/octet-stream",
-  "application/x-zip-compressed"
-];
-var exportStatusSchema = z3.enum(["in_progress", "completed", "failed"]);
-var projectPageObjectSchema = z3.object({
+// src/lib/api-v1-contract.ts
+import { z as z3 } from "zod";
+var primeUiExportStatusSchema = z3.enum(
+  ["in_progress", "completed", "failed"]
+);
+var primeUiProjectPageObjectSchema = z3.object({
   id: z3.string(),
   title: z3.string(),
   slug: z3.string(),
@@ -529,24 +500,33 @@ var projectPageObjectSchema = z3.object({
   pagePath: z3.string(),
   componentsPath: z3.string()
 });
-var projectPageSchema = projectPageObjectSchema;
-var exportSummarySchema = z3.object({
+var primeUiProjectPageSchema = primeUiProjectPageObjectSchema;
+var primeUiProjectExportableSchema = z3.object({
+  key: z3.string(),
+  description: z3.string(),
+  isReadyToExport: z3.boolean()
+});
+var primeUiExportSummarySchema = z3.object({
   total: z3.number(),
   successful: z3.number(),
   failed: z3.number()
 });
-var exportedComponentSchema = z3.object({
-  componentKey: z3.string(),
-  enabled: z3.boolean(),
-  files: z3.array(z3.string()),
-  message: z3.string()
+var primeUiExportableManifestSchema = z3.object({
+  success: z3.boolean(),
+  message: z3.string(),
+  files: z3.array(z3.string())
+});
+var primeUiExportedExportableSchema = z3.object({
+  key: z3.string(),
+  isReadyToExport: z3.boolean(),
+  manifest: primeUiExportableManifestSchema
 });
-var exportPageManifestSchema = z3.object({
+var primeUiExportPageManifestSchema = z3.object({
   success: z3.boolean(),
   message: z3.string(),
   files: z3.array(z3.string())
 });
-var exportPageSchema = z3.object({
+var primeUiExportPageSchema = z3.object({
   id: z3.string(),
   title: z3.string().optional(),
   slug: z3.string(),
@@ -554,51 +534,107 @@ var exportPageSchema = z3.object({
   isReadyToExport: z3.literal(true),
   pagePath: z3.string(),
   componentsPath: z3.string(),
-  manifest: exportPageManifestSchema
-});
-var projectInfoSchema = z3.object({
-  projectId: z3.string(),
-  projectName: z3.string(),
-  metadata: z3.record(z3.unknown()),
-  pages: z3.array(projectPageSchema)
+  manifest: primeUiExportPageManifestSchema
 });
-var projectPageComponentSchema = z3.object({
+var primeUiProjectInfoSchema = z3.object(
+  {
+    projectId: z3.string(),
+    projectName: z3.string(),
+    metadata: z3.record(z3.unknown()),
+    exportables: z3.array(primeUiProjectExportableSchema),
+    pages: z3.array(primeUiProjectPageSchema)
+  }
+);
+var primeUiProjectPageComponentSchema = z3.object({
   blockId: z3.string(),
   componentId: z3.string(),
   componentGroup: z3.string(),
   slot: z3.string().nullable(),
   props: z3.record(z3.unknown()).nullable()
 });
-var projectPageDetailsSchema = z3.object({
-  page: projectPageObjectSchema.extend({
+var primeUiProjectPageDetailsSchema = z3.object({
+  page: primeUiProjectPageObjectSchema.extend({
     pageInstruction: z3.string().nullable()
   }),
   variant: z3.object({
     id: z3.string(),
     name: z3.string()
   }).nullable(),
-  components: z3.array(projectPageComponentSchema).nullable()
+  components: z3.array(primeUiProjectPageComponentSchema).nullable()
 });
-var exportsResponseSchema = z3.object({
+var primeUiExportsResponseSchema = z3.object({
   exports: z3.array(
     z3.object({
       id: z3.string(),
-      status: exportStatusSchema,
+      status: primeUiExportStatusSchema,
       createdAt: z3.string().datetime({ offset: true })
     })
   )
 });
-var createExportResponseSchema = z3.object({
+var primeUiCreateExportResponseSchema = z3.object({
   export: z3.object({
     id: z3.string(),
-    status: exportStatusSchema,
+    status: primeUiExportStatusSchema,
     createdAt: z3.string().datetime({ offset: true }),
     expiresAt: z3.string().datetime({ offset: true }).nullable(),
-    summary: exportSummarySchema,
-    components: z3.array(exportedComponentSchema)
+    summary: primeUiExportSummarySchema,
+    exportables: z3.array(primeUiExportedExportableSchema)
   }),
-  pages: z3.array(exportPageSchema)
+  pages: z3.array(primeUiExportPageSchema)
 });
+var primeUiExportManifestSchema = primeUiCreateExportResponseSchema;
+function parsePrimeUiExportManifest(value) {
+  if (!value || typeof value !== "object") {
+    throw new Error("Export manifest is invalid.");
+  }
+  const maybe = value;
+  if (!maybe.export || typeof maybe.export !== "object") {
+    throw new Error("Export manifest export payload is invalid.");
+  }
+  const parsed = primeUiExportManifestSchema.safeParse(value);
+  if (!parsed.success) {
+    const hasPageIssue = parsed.error.issues.some(
+      (issue) => issue.path[0] === "pages"
+    );
+    throw new Error(
+      hasPageIssue ? "Export manifest pages payload is invalid." : "Export manifest does not match expected schema."
+    );
+  }
+  return parsed.data;
+}
+
+// src/lib/fs.ts
+import { mkdir, rm, writeFile } from "fs/promises";
+import path4 from "path";
+import extractZipArchive from "extract-zip";
+async function ensureDir(dirPath) {
+  await mkdir(dirPath, { recursive: true });
+}
+async function resetDir(dirPath) {
+  await rm(dirPath, { recursive: true, force: true });
+  await mkdir(dirPath, { recursive: true });
+}
+async function writeUtf8(filePath, content) {
+  await ensureDir(path4.dirname(filePath));
+  await writeFile(filePath, content, "utf-8");
+}
+async function extractZip(zipPath, targetDir) {
+  await ensureDir(targetDir);
+  try {
+    await extractZipArchive(zipPath, { dir: targetDir });
+  } catch (error) {
+    const details = error instanceof Error ? error.message : String(error);
+    throw new Error(`Failed to extract zip at "${zipPath}". ${details}`);
+  }
+}
+
+// src/sources/api-provider.ts
+var DEFAULT_API_BASE_URL = "https://app.primeui.com/";
+var ZIP_CONTENT_TYPES = [
+  "application/zip",
+  "application/octet-stream",
+  "application/x-zip-compressed"
+];
 var PrimeUiApiContractError = class extends Error {
   constructor(endpoint, details) {
     super(`PrimeUI API contract mismatch for "${endpoint}": ${details}`);
@@ -683,26 +719,30 @@ var ApiProjectDataProvider = class {
     this.apiRoot = normalizePrimeUiApiRoot(options.baseUrl);
   }
   async getProjectInfo() {
-    return this.requestJson("project", projectInfoSchema);
+    return this.requestJson("project", primeUiProjectInfoSchema);
   }
   async getProjectPageBySlug(slug) {
     const encodedSlug = encodeURIComponent(slug);
     return this.requestJson(
       `project/page?slug=${encodedSlug}`,
-      projectPageDetailsSchema
+      primeUiProjectPageDetailsSchema
     );
   }
   async listExports() {
     const response = await this.requestJson(
       "project/exports",
-      exportsResponseSchema
+      primeUiExportsResponseSchema
     );
     return response.exports;
   }
   async createExport() {
-    return this.requestJson("project/exports", createExportResponseSchema, {
-      method: "POST"
-    });
+    return this.requestJson(
+      "project/exports",
+      primeUiCreateExportResponseSchema,
+      {
+        method: "POST"
+      }
+    );
   }
   /**
    * Consumer-side runtime contract for GET /api/v1/project/exports/:exportId/download.
@@ -1702,104 +1742,6 @@ async function buildImportGraph(input) {
   };
 }
 
-// src/lib/page-paths.ts
-var WEBSITE_APP_ROOT = "src/app/(website)";
-var PAGE_COMPONENTS_ROOT = "src/components/pages";
-var normalizeSlug = (slug) => {
-  const trimmed = slug.trim();
-  if (!trimmed || trimmed === "/") {
-    return "/";
-  }
-  const withLeadingSlash = trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
-  const withoutTrailingSlash = withLeadingSlash.replace(/\/+$/, "");
-  return withoutTrailingSlash || "/";
-};
-var slugToFolderPath = (normalizedSlug) => {
-  if (normalizedSlug === "/") {
-    return "";
-  }
-  return normalizedSlug.slice(1);
-};
-var toPathSegment = (value) => {
-  const normalized = value.trim().toLowerCase().replace(/[^a-z0-9/-]+/g, "-");
-  const compact = normalized.replace(/-+/g, "-").replace(/^-|-$/g, "");
-  return compact || "page";
-};
-var buildWebsitePagePath = (normalizedSlug) => {
-  if (normalizedSlug === "/") {
-    return `${WEBSITE_APP_ROOT}/page.tsx`;
-  }
-  return `${WEBSITE_APP_ROOT}${normalizedSlug}/page.tsx`;
-};
-var buildComponentsPath = (folderPath) => `${PAGE_COMPONENTS_ROOT}/${folderPath}`;
-var resolveBlogSectionRoot = (slugFolderPath) => {
-  if (!slugFolderPath) {
-    return "blog";
-  }
-  const segments = slugFolderPath.split("/").filter(Boolean);
-  if (segments.length <= 1) {
-    return "blog";
-  }
-  return segments.slice(0, -1).join("/");
-};
-function resolvePrimeUiPageExportPaths({
-  pageType,
-  slug
-}) {
-  const normalizedSlug = normalizeSlug(slug);
-  const slugFolderPath = slugToFolderPath(normalizedSlug);
-  switch (pageType) {
-    case "landing": {
-      const componentsFolder = slugFolderPath || "home";
-      return {
-        pagePath: buildWebsitePagePath(normalizedSlug),
-        componentsPath: buildComponentsPath(componentsFolder)
-      };
-    }
-    case "pricing":
-    case "contact-us": {
-      const componentsFolder = slugFolderPath || pageType;
-      return {
-        pagePath: buildWebsitePagePath(normalizedSlug),
-        componentsPath: buildComponentsPath(componentsFolder)
-      };
-    }
-    case "docs": {
-      const docsFolder = slugFolderPath || "docs";
-      return {
-        pagePath: `${WEBSITE_APP_ROOT}/${docsFolder}/[[...slug]]/page.tsx`,
-        componentsPath: buildComponentsPath("docs")
-      };
-    }
-    case "blogIndex": {
-      const blogFolder = slugFolderPath || "blog";
-      return {
-        pagePath: `${WEBSITE_APP_ROOT}/${blogFolder}/page.tsx`,
-        componentsPath: buildComponentsPath("blog")
-      };
-    }
-    case "blogPost": {
-      const blogSectionRoot = resolveBlogSectionRoot(slugFolderPath);
-      return {
-        pagePath: `${WEBSITE_APP_ROOT}/${blogSectionRoot}/[slug]/page.tsx`,
-        componentsPath: buildComponentsPath("blog")
-      };
-    }
-    case "legal":
-      return {
-        pagePath: buildWebsitePagePath(normalizedSlug),
-        componentsPath: buildComponentsPath("legal")
-      };
-    default: {
-      const fallbackFolder = slugFolderPath || toPathSegment(pageType);
-      return {
-        pagePath: buildWebsitePagePath(normalizedSlug),
-        componentsPath: buildComponentsPath(fallbackFolder)
-      };
-    }
-  }
-}
-
 // src/lib/text-diff.ts
 var DEFAULT_MAX_DIFF_CHARS = 16e3;
 var MAX_LCS_CELLS = 2e6;
@@ -1894,15 +1836,7 @@ var DEPENDENCY_SECTIONS = [
   "devDependencies",
   "peerDependencies"
 ];
-var REWRITABLE_IMPORT_EXTENSIONS = /* @__PURE__ */ new Set([
-  ".ts",
-  ".tsx",
-  ".js",
-  ".jsx",
-  ".mjs",
-  ".cjs"
-]);
-function normalizeSlug2(slug) {
+function normalizeSlug(slug) {
   const trimmed = slug.trim();
   if (!trimmed || trimmed === "/") {
     return "/";
@@ -1916,9 +1850,6 @@ function toPosixPath(value) {
 function toProjectRelative(rootPath, absolutePath) {
   return toPosixPath(path9.relative(rootPath, absolutePath));
 }
-function escapeRegExp(value) {
-  return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-}
 function isBinaryBuffer(buffer) {
   const limit = Math.min(buffer.length, 8e3);
   for (let index = 0; index < limit; index += 1) {
@@ -1928,66 +1859,6 @@ function isBinaryBuffer(buffer) {
   }
   return false;
 }
-function stripSrcPrefix(relativePath) {
-  return relativePath.replace(/^src\//, "");
-}
-function buildImportRewritePlan(sourceComponentsPath, targetComponentsPath) {
-  const normalizedSource = toPosixPath(sourceComponentsPath);
-  const normalizedTarget = toPosixPath(targetComponentsPath);
-  if (normalizedSource === normalizedTarget) {
-    return null;
-  }
-  const sourceAtAliasPrefix = `@/${stripSrcPrefix(normalizedSource)}`;
-  const targetAtAliasPrefix = `@/${stripSrcPrefix(normalizedTarget)}`;
-  const sourceRootAliasPrefix = `@root/${normalizedSource}`;
-  const targetRootAliasPrefix = `@root/${normalizedTarget}`;
-  return {
-    sourceAtAliasPrefix,
-    targetAtAliasPrefix,
-    sourceRootAliasPrefix,
-    targetRootAliasPrefix
-  };
-}
-function replaceAliasPrefixInImportStrings(content, sourcePrefix, targetPrefix) {
-  const pattern = new RegExp(
-    `(["'\`])${escapeRegExp(sourcePrefix)}(?=\\/|\\1)`,
-    "g"
-  );
-  return content.replace(pattern, `$1${targetPrefix}`);
-}
-function rewriteImportsForRemappedSlug(content, plan) {
-  const afterAtAlias = replaceAliasPrefixInImportStrings(
-    content,
-    plan.sourceAtAliasPrefix,
-    plan.targetAtAliasPrefix
-  );
-  return replaceAliasPrefixInImportStrings(
-    afterAtAlias,
-    plan.sourceRootAliasPrefix,
-    plan.targetRootAliasPrefix
-  );
-}
-function buildPlannedSourceBuffer(sourceBuffer, sourceFilePath, importRewritePlan) {
-  if (!importRewritePlan) {
-    return sourceBuffer;
-  }
-  const extension = path9.extname(sourceFilePath).toLowerCase();
-  if (!REWRITABLE_IMPORT_EXTENSIONS.has(extension)) {
-    return sourceBuffer;
-  }
-  if (isBinaryBuffer(sourceBuffer)) {
-    return sourceBuffer;
-  }
-  const sourceText = sourceBuffer.toString("utf-8");
-  const rewritten = rewriteImportsForRemappedSlug(
-    sourceText,
-    importRewritePlan
-  );
-  if (rewritten === sourceText) {
-    return sourceBuffer;
-  }
-  return Buffer.from(rewritten, "utf-8");
-}
 async function readJsonFile(filePath) {
   const content = await readFile3(filePath, "utf-8");
   return JSON.parse(content);
@@ -2000,68 +1871,15 @@ async function fileExists2(filePath) {
     return false;
   }
 }
-function isExportPageManifestRecord(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.success === "boolean" && typeof maybe.message === "string" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string");
-}
-function isExportStatus(value) {
-  return value === "in_progress" || value === "completed" || value === "failed";
-}
-function isExportSummaryRecord(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.total === "number" && typeof maybe.successful === "number" && typeof maybe.failed === "number";
-}
-function isExportedComponentRecord(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.componentKey === "string" && typeof maybe.enabled === "boolean" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string") && typeof maybe.message === "string";
-}
-function isExportPageRecord(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  const title = maybe.title;
-  return typeof maybe.id === "string" && (typeof title === "string" || typeof title === "undefined") && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && maybe.isReadyToExport === true && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string" && isExportPageManifestRecord(maybe.manifest);
-}
 function parseManifest(value) {
-  if (!value || typeof value !== "object") {
-    throw new Error("Invalid export manifest format.");
-  }
-  const maybe = value;
-  const exportPayload = maybe.export;
-  if (!exportPayload || typeof exportPayload !== "object") {
-    throw new Error("Export manifest export payload is invalid.");
-  }
-  const exportObject = exportPayload;
-  const status = exportObject.status;
-  const summary = exportObject.summary;
-  const components = exportObject.components;
-  if (typeof exportObject.id !== "string" || !isExportStatus(status) || typeof exportObject.createdAt !== "string" || !("expiresAt" in exportObject) || !(typeof exportObject.expiresAt === "string" || exportObject.expiresAt === null) || !isExportSummaryRecord(summary) || !Array.isArray(components) || !components.every(isExportedComponentRecord) || !Array.isArray(maybe.pages)) {
-    throw new Error("Export manifest does not match expected schema.");
-  }
-  if (!maybe.pages.every(isExportPageRecord)) {
-    throw new Error("Export manifest pages payload is invalid.");
+  try {
+    return parsePrimeUiExportManifest(value);
+  } catch (error) {
+    if (error instanceof Error && error.message === "Export manifest is invalid.") {
+      throw new Error("Invalid export manifest format.");
+    }
+    throw error;
   }
-  return {
-    export: {
-      id: exportObject.id,
-      status,
-      createdAt: exportObject.createdAt,
-      expiresAt: exportObject.expiresAt,
-      summary,
-      components
-    },
-    pages: maybe.pages
-  };
 }
 async function resolveManifestCandidateFiles(input) {
   const result = /* @__PURE__ */ new Set();
@@ -2109,6 +1927,9 @@ async function resolveSingleExportDirectory(exportsRoot) {
     exportPath: path9.join(exportsRoot, exportId)
   };
 }
+function createCopyId() {
+  return `${Date.now()}-${Math.random().toString(36).slice(2, 8)}`;
+}
 function ensureSafeTargetPath(projectRoot, targetPath) {
   const relative = path9.relative(projectRoot, targetPath);
   if (relative.startsWith("..") || path9.isAbsolute(relative)) {
@@ -2184,11 +2005,7 @@ function resolveTargetFilePath(input) {
   return path9.join(projectRoot, relativeToExport);
 }
 async function copyPageFromExport(input) {
-  const normalizedOriginSlug = normalizeSlug2(input.originPageSlug);
-  const normalizedActualSlug = normalizeSlug2(
-    input.actualPageSlug ?? input.originPageSlug
-  );
-  const isSlugRemapped = normalizedActualSlug !== normalizedOriginSlug;
+  const normalizedOriginSlug = normalizeSlug(input.originPageSlug);
   const { exportId, exportPath } = await resolveSingleExportDirectory(
     input.exportsRoot
   );
@@ -2208,7 +2025,7 @@ async function copyPageFromExport(input) {
     );
   }
   const page = manifest.pages.find(
-    (item) => normalizeSlug2(item.slug) === normalizedOriginSlug
+    (item) => normalizeSlug(item.slug) === normalizedOriginSlug
   );
   if (!page) {
     throw new Error(
@@ -2229,19 +2046,11 @@ async function copyPageFromExport(input) {
       `Source components folder not found: ${sourceComponentsPath}`
     );
   }
-  const targetPaths = normalizedActualSlug === normalizedOriginSlug ? {
-    pagePath: page.pagePath,
-    componentsPath: page.componentsPath
-  } : resolvePrimeUiPageExportPaths({
-    pageType: page.pageType,
-    slug: normalizedActualSlug
-  });
-  const targetPagePath = path9.join(input.projectRoot, targetPaths.pagePath);
+  const targetPagePath = path9.join(input.projectRoot, page.pagePath);
   const targetComponentsPath = path9.join(
     input.projectRoot,
-    targetPaths.componentsPath
+    page.componentsPath
   );
-  const importRewritePlan = isSlugRemapped ? buildImportRewritePlan(page.componentsPath, targetPaths.componentsPath) : null;
   ensureSafeTargetPath(input.projectRoot, targetPagePath);
   ensureSafeTargetPath(input.projectRoot, targetComponentsPath);
   const candidateFiles = await resolveManifestCandidateFiles({
@@ -2257,6 +2066,7 @@ async function copyPageFromExport(input) {
   const newFiles = [];
   const identicalFiles = [];
   const conflictFiles = [];
+  const conflictReportEntries = [];
   for (const sourceFilePath of candidateFiles) {
     const targetFilePath = resolveTargetFilePath({
       sourceFilePath,
@@ -2269,11 +2079,7 @@ async function copyPageFromExport(input) {
     });
     ensureSafeTargetPath(input.projectRoot, targetFilePath);
     const sourceBuffer = await readFile3(sourceFilePath);
-    const plannedSourceBuffer = buildPlannedSourceBuffer(
-      sourceBuffer,
-      sourceFilePath,
-      importRewritePlan
-    );
+    const plannedSourceBuffer = sourceBuffer;
     let targetBuffer = null;
     try {
       targetBuffer = await readFile3(targetFilePath);
@@ -2285,17 +2091,11 @@ async function copyPageFromExport(input) {
     if (!targetBuffer) {
       await ensureDir(path9.dirname(targetFilePath));
       await writeFile2(targetFilePath, plannedSourceBuffer);
-      newFiles.push({
-        sourcePath: sourceRelative,
-        targetPath: targetRelative
-      });
+      newFiles.push(targetRelative);
       continue;
     }
     if (plannedSourceBuffer.equals(targetBuffer)) {
-      identicalFiles.push({
-        sourcePath: sourceRelative,
-        targetPath: targetRelative
-      });
+      identicalFiles.push(targetRelative);
       continue;
     }
     const isBinary = isBinaryBuffer(plannedSourceBuffer) || isBinaryBuffer(targetBuffer);
@@ -2305,7 +2105,7 @@ async function copyPageFromExport(input) {
       oldLabel: `user/${targetRelative}`,
       newLabel: `export/${sourceRelative}`
     });
-    conflictFiles.push({
+    conflictReportEntries.push({
       sourcePath: sourceRelative,
       targetPath: targetRelative,
       diff,
@@ -2366,24 +2166,74 @@ async function copyPageFromExport(input) {
       "utf-8"
     );
   }
+  const sortedAddedDependencies = addedDependencies.sort(
+    (a, b) => a.packageName.localeCompare(b.packageName)
+  );
+  const sortedDependenciesVersionConflicts = dependenciesVersionConflicts.sort(
+    (a, b) => a.packageName.localeCompare(b.packageName)
+  );
+  const sortedConflictReportEntries = conflictReportEntries.sort(
+    (a, b) => a.targetPath.localeCompare(b.targetPath)
+  );
+  for (const entry of sortedConflictReportEntries) {
+    conflictFiles.push({
+      targetPath: entry.targetPath,
+      isBinary: entry.isBinary
+    });
+  }
+  const copyId = createCopyId();
+  const reportPath = path9.join(
+    input.exportsRoot,
+    `${exportId}.copy-report-${copyId}.json`
+  );
+  const report = {
+    reportPath,
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    exportId,
+    originPageSlug: normalizedOriginSlug,
+    sourcePagePath: page.pagePath,
+    sourceComponentsPath: page.componentsPath,
+    conflicts: sortedConflictReportEntries
+  };
+  await writeFile2(reportPath, `${JSON.stringify(report, null, 2)}
+`, "utf-8");
+  const hasFileConflicts = conflictFiles.length > 0;
+  const hasDependencyVersionConflicts = sortedDependenciesVersionConflicts.length > 0;
+  const needsReview = hasFileConflicts || hasDependencyVersionConflicts;
+  const status = needsReview ? "needs_review" : "completed";
+  const messageParts = [];
+  if (hasFileConflicts) {
+    messageParts.push(
+      `Conflicts detected. Manual resolution is required before any follow-up integration steps. Review ${reportPath} for full diffs and resolve conflicts based on the target project behavior, the imported page functionality, and the possibility that MCP may run against third-party projects not generated by PrimeUI.`
+    );
+  } else if (hasDependencyVersionConflicts) {
+    messageParts.push(
+      `Dependency version conflicts detected. Manual resolution is required before any follow-up integration steps. Review ${reportPath} for full local report details, inspect dependenciesVersionConflicts in this response, and resolve versions based on the target project behavior and the imported page functionality.`
+    );
+  } else {
+    messageParts.push(
+      `Copy completed with no file conflicts or dependency version conflicts. Review ${reportPath} for full local details if needed.`
+    );
+  }
+  if (sortedAddedDependencies.length > 0) {
+    messageParts.push(
+      "Missing dependencies were added to package.json but are NOT installed yet. Run dependency installation manually with the package manager used by the target project."
+    );
+  }
   return {
+    status,
+    message: messageParts.join(" "),
+    reportPath,
     exportId,
     exportPath,
     originPageSlug: normalizedOriginSlug,
-    actualPageSlug: normalizedActualSlug,
     sourcePagePath: page.pagePath,
-    targetPagePath: targetPaths.pagePath,
     sourceComponentsPath: page.componentsPath,
-    targetComponentsPath: targetPaths.componentsPath,
     newFiles,
     identicalFiles,
     conflictFiles,
-    addedDependencies: addedDependencies.sort(
-      (a, b) => a.packageName.localeCompare(b.packageName)
-    ),
-    dependenciesVersionConflicts: dependenciesVersionConflicts.sort(
-      (a, b) => a.packageName.localeCompare(b.packageName)
-    ),
+    addedDependencies: sortedAddedDependencies,
+    dependenciesVersionConflicts: sortedDependenciesVersionConflicts,
     summary: {
       totalCandidateFiles: candidateFiles.length,
       copiedFiles: newFiles.length,
@@ -2486,72 +2336,9 @@ function buildInspectPageReport(input) {
 }
 
 // src/services/project-sync-service.ts
-function isExportStatus2(value) {
-  return value === "in_progress" || value === "completed" || value === "failed";
-}
-function isExportSummary(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.total === "number" && typeof maybe.successful === "number" && typeof maybe.failed === "number";
-}
-function isExportedComponent(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.componentKey === "string" && typeof maybe.enabled === "boolean" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string") && typeof maybe.message === "string";
-}
-function isExportPageManifest(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  return typeof maybe.success === "boolean" && typeof maybe.message === "string" && Array.isArray(maybe.files) && maybe.files.every((item) => typeof item === "string");
-}
-function isExportPage(value) {
-  if (!value || typeof value !== "object") {
-    return false;
-  }
-  const maybe = value;
-  const title = maybe.title;
-  return typeof maybe.id === "string" && (typeof title === "string" || typeof title === "undefined") && typeof maybe.slug === "string" && typeof maybe.pageType === "string" && maybe.isReadyToExport === true && typeof maybe.pagePath === "string" && typeof maybe.componentsPath === "string" && isExportPageManifest(maybe.manifest);
-}
 function buildManifestPath(exportsRoot, exportId) {
   return path10.join(exportsRoot, `${exportId}.manifest.json`);
 }
-function parseExportManifest(value) {
-  if (!value || typeof value !== "object") {
-    throw new Error("Export manifest is invalid.");
-  }
-  const maybe = value;
-  const exportPayload = maybe.export;
-  if (!exportPayload || typeof exportPayload !== "object") {
-    throw new Error("Export manifest export payload is invalid.");
-  }
-  const exportObject = exportPayload;
-  const status = exportObject.status;
-  const summary = exportObject.summary;
-  const components = exportObject.components;
-  if (typeof exportObject.id !== "string" || !isExportStatus2(status) || typeof exportObject.createdAt !== "string" || !("expiresAt" in exportObject) || !(typeof exportObject.expiresAt === "string" || exportObject.expiresAt === null) || !isExportSummary(summary) || !Array.isArray(components) || !components.every(isExportedComponent) || !Array.isArray(maybe.pages)) {
-    throw new Error("Export manifest does not match expected schema.");
-  }
-  if (!maybe.pages.every(isExportPage)) {
-    throw new Error("Export manifest pages payload is invalid.");
-  }
-  return {
-    export: {
-      id: exportObject.id,
-      status,
-      createdAt: exportObject.createdAt,
-      expiresAt: exportObject.expiresAt,
-      summary,
-      components
-    },
-    pages: maybe.pages
-  };
-}
 var ProjectSyncService = class {
   provider;
   projectRoot;
@@ -2595,7 +2382,7 @@ var ProjectSyncService = class {
     const manifestPath = buildManifestPath(this.exportsRoot, id);
     let manifest;
     try {
-      manifest = parseExportManifest(
+      manifest = parsePrimeUiExportManifest(
         JSON.parse(await readFile4(manifestPath, "utf-8"))
       );
     } catch (error) {
@@ -2613,12 +2400,10 @@ var ProjectSyncService = class {
     await this.provider.downloadExportArchive(id, targetZipPath);
     await resetDir(targetProjectPath);
     await extractZip(targetZipPath, targetProjectPath);
-    const pages = manifest.pages;
     return {
       exportId: id,
       projectPath: targetProjectPath,
-      manifestPath,
-      pages
+      manifestPath
     };
   }
   async inspectPage(slug, _context) {
@@ -2631,13 +2416,12 @@ var ProjectSyncService = class {
       reportRows: reportPayload.reportRows
     };
   }
-  async copyPage(originPageSlug, actualPageSlug, _context) {
+  async copyPage(originPageSlug, _context) {
     await this.ensureTempLayout();
     return copyPageFromExport({
       projectRoot: this.targetProjectRoot,
       exportsRoot: this.exportsRoot,
-      originPageSlug,
-      actualPageSlug
+      originPageSlug
     });
   }
   async clearTemp(_context) {
@@ -2727,10 +2511,10 @@ var LazyProjectSyncSource = class {
       (service) => service.inspectPage(slug, context)
     );
   }
-  async copyPage(originPageSlug, actualPageSlug, context) {
+  async copyPage(originPageSlug, context) {
     return this.withMutationService(
       context,
-      (service) => service.copyPage(originPageSlug, actualPageSlug, context)
+      (service) => service.copyPage(originPageSlug, context)
     );
   }
   async clearTemp(context) {
@@ -2771,35 +2555,48 @@ var pageSchema = z4.object({
 }).describe(
   "PrimeUI page descriptor used by project and export tools. Paths are always relative to export project root."
 );
-var exportStatusSchema2 = z4.enum(["in_progress", "completed", "failed"]).describe(
+var exportStatusSchema = z4.enum(["in_progress", "completed", "failed"]).describe(
   "Export lifecycle state. Use 'completed' before calling download_export."
 );
 var exportItemSchema = z4.object({
   id: z4.string().describe(
     "Export identifier. Pass this value to download_export input.id."
   ),
-  status: exportStatusSchema2,
+  status: exportStatusSchema,
   createdAt: z4.string().describe("Export creation timestamp in ISO-8601 UTC format.")
 }).describe("Single export record from PrimeUI export history.");
-var exportSummarySchema2 = z4.object({
+var exportSummarySchema = z4.object({
   total: z4.number().describe("Total pages processed in this export run."),
   successful: z4.number().describe("Number of pages exported successfully."),
   failed: z4.number().describe("Number of pages that failed export.")
 });
-var exportComponentSchema = z4.object({
-  componentKey: z4.string().describe("Global component key from export manifest."),
-  enabled: z4.boolean().describe("True when this global component was exported."),
-  files: z4.array(z4.string()).describe("Files associated with this global component."),
-  message: z4.string().describe("Export status message for this global component.")
+var exportManifestSchema = z4.object({
+  success: z4.boolean().describe("True when export processing succeeded for this item."),
+  message: z4.string().describe("Export status message for this item."),
+  files: z4.array(z4.string()).describe("Authoritative exported file list for this item.")
 });
-var exportPageManifestSchema2 = z4.object({
-  success: z4.boolean().describe("True when page export succeeded in this export run."),
-  message: z4.string().describe("Export status message for this page."),
+var exportableSchema = z4.object({
+  key: z4.string().describe("Shared exportable key from export manifest."),
+  isReadyToExport: z4.boolean().describe("True when this shared exportable was eligible for export."),
+  manifest: exportManifestSchema.describe(
+    "Export manifest for this shared exportable, aligned with page manifest shape."
+  )
+});
+var projectExportableSchema = z4.object({
+  key: z4.string().describe("Stable shared exportable key from PrimeUI project info."),
+  description: z4.string().describe(
+    "Agent-oriented summary of what this shared exportable provides."
+  ),
+  isReadyToExport: z4.boolean().describe(
+    "Best-effort readiness snapshot for whether this shared exportable can be included in export now."
+  )
+});
+var exportPageManifestSchema = exportManifestSchema.extend({
   files: z4.array(z4.string()).describe(
     "Authoritative list of page-related files from PrimeUI export manifest, including shared project files required by this page."
   )
 });
-var exportPageSchema2 = z4.object({
+var exportPageSchema = z4.object({
   id: z4.string().describe("Stable PrimeUI page identifier for this export entry."),
   title: z4.string().optional().describe(
     "Optional page title from export manifest. Can be undefined for some legacy records."
@@ -2809,17 +2606,7 @@ var exportPageSchema2 = z4.object({
   isReadyToExport: z4.literal(true).describe("Always true for pages included in export payload."),
   pagePath: z4.string().describe("Page source file path relative to export root."),
   componentsPath: z4.string().describe("Page components directory path relative to export root."),
-  manifest: exportPageManifestSchema2
-});
-var fileTransferSchema = z4.object({
-  sourcePath: z4.string().describe("Relative source file path inside downloaded export root."),
-  targetPath: z4.string().describe("Relative target file path inside user project root.")
-});
-var conflictFileSchema = fileTransferSchema.extend({
-  diff: z4.string().describe(
-    "Unified diff between user file and export file. For binary files the diff contains a plain message."
-  ),
-  isBinary: z4.boolean().describe("True if conflict comparison was treated as binary data.")
+  manifest: exportPageManifestSchema
 });
 var dependencySectionSchema = z4.enum([
   "dependencies",
@@ -2841,6 +2628,10 @@ var dependencyVersionConflictSchema = z4.object({
   exportVersion: z4.string().describe("Version found in exported project's package.json."),
   userVersion: z4.string().describe("Version currently present in user's package.json.")
 });
+var conflictFileSchema = z4.object({
+  targetPath: z4.string().describe("Relative conflict target path inside user project root."),
+  isBinary: z4.boolean().describe("True if conflict comparison was treated as binary data.")
+});
 var pageDetailsSchema = pageSchema.extend({
   pageInstruction: z4.string().nullable().describe(
     "Current instruction text for the active page variant. Null when no active variant is set."
@@ -2889,7 +2680,7 @@ WORKFLOW ORDER (always follow this sequence):
 2. get_project_info -> discover PrimeUI pages
 3. Reconcile PrimeUI pages with local project pages/routes/paths, then confirm target pages with user
 4. inspect_page -> inspect selected page components and produce a structured comparison table
-5. create_export -> generate export snapshot and local manifest with page file lists + global components
+5. create_export -> generate export snapshot and local manifest with page file lists + shared exportables
 6. download_export -> download to temp directory
 7. copy_page -> copy one page safely (repeat for each selected page)
 8. Reconcile integration points and resolve reported conflicts, if any
@@ -2917,7 +2708,7 @@ CRITICAL RULES FOR PAGE IMPORT:
 - Before creating export, ask user which pages to add/update (specific pages or all missing pages) and keep that choice in thread context.
 - create_export response includes:
   - page-level manifest files per page ('pages[].manifest.files'),
-  - global components list ('export.components').
+  - shared exportables list ('export.exportables').
   Mention both to user after create_export, because this is the source of truth for copy decisions.
 - The downloaded export in .primeui/temp/ contains a full standalone Next.js project.
   Do NOT copy it wholesale.
@@ -2935,7 +2726,7 @@ CRITICAL RULES FOR PAGE IMPORT:
 `.trim();
 var toolGetProjectInfo = {
   title: "PrimeUI Project Info",
-  description: `ENTRY POINT for all PrimeUI import operations. Always start here. Returns project metadata and the full list of available pages.
+  description: `ENTRY POINT for all PrimeUI import operations. Always start here. Returns project metadata plus a lightweight inventory of pages and shared exportables you can reason about before export.
 
 WHEN TO USE: Call this FIRST when user wants to import, add, sync, pull, or transfer a page from PrimeUI. Intent examples (semantic intent, not exact phrase matching): ${TRIGGER_PHRASES}.
 
@@ -2964,6 +2755,9 @@ ${WORKFLOW_SUMMARY}`,
     metadata: z4.record(z4.unknown()).describe(
       "Additional project metadata from PrimeUI. May include project-description and other context fields."
     ),
+    exportables: z4.array(projectExportableSchema).describe(
+      "Lightweight inventory of shared exportables (for example logo, cookie banner, announcement banner, theme, image assets). Use description + isReadyToExport to plan imports before create_export."
+    ),
     pages: z4.array(pageSchema).describe(
       "All pages visible for this project context. Filter by user request and isReadyToExport before creating export."
     )
@@ -3050,7 +2844,7 @@ ${WORKFLOW_SUMMARY}`,
 };
 var toolCreateExport = {
   title: "PrimeUI Create Export",
-  description: `Create a new export snapshot from the current PrimeUI project state and wait for completion. Returns strict export manifest payload from API, including page-level file manifests and global components.
+  description: `Create a new export snapshot from the current PrimeUI project state and wait for completion. Returns strict export manifest payload from API, including page-level file manifests and shared exportables.
 
 WHEN TO USE: Call this AFTER the user has confirmed which pages they want to import via get_project_info. This tool is REQUIRED before download_export, unless the user explicitly and directly asked to download a specific previous export.
 
@@ -3058,7 +2852,7 @@ AFTER CALLING:
 - Verify that all user-selected pages are present in the export result AND have isReadyToExport: true.
 - If path mismatch pages were flagged during project-info reconciliation, ensure they are included for deeper comparison after download.
 - If any required page is missing or not ready, report and pause for user decision before proceeding.
-- Mention that global components are available in export.components and can be transferred separately if needed.
+- Mention that shared exportables are available in export.exportables and can be transferred separately if needed.
 - Local sidecar manifest is saved to .primeui/temp/exports/[exportId].manifest.json from this API payload.
 - Use the returned export ID to call download_export.
 
@@ -3069,19 +2863,19 @@ ${WORKFLOW_SUMMARY}`,
       id: z4.string().describe(
         "Freshly created export identifier. Use this as download_export input.id."
       ),
-      status: exportStatusSchema2,
+      status: exportStatusSchema,
       createdAt: z4.string().describe("Export creation timestamp in ISO-8601 UTC format."),
       expiresAt: z4.string().nullable().describe(
         "Export expiration timestamp in ISO-8601 UTC format, or null when export has no explicit expiration."
       ),
-      summary: exportSummarySchema2.describe(
+      summary: exportSummarySchema.describe(
         "Export run summary with total/successful/failed counters."
       ),
-      components: z4.array(exportComponentSchema).describe(
-        "Global component export manifest. These components are independent from page-level manifests."
+      exportables: z4.array(exportableSchema).describe(
+        "Shared exportable manifest. These entries are independent from page-level manifests."
       )
     }).describe("Created export summary."),
-    pages: z4.array(exportPageSchema2).describe(
+    pages: z4.array(exportPageSchema).describe(
       "Strict page payload associated with this export, including per-page manifest files list."
     )
   }),
@@ -3107,9 +2901,8 @@ NOTE:
 AFTER DOWNLOAD:
 - Use manifestPath from this response as the contract for page slug/path mapping and manifest file lists in copy operations.
 - For each selected page, call copy_page with:
-  - originPageSlug (required),
-  - actualPageSlug (optional, if route remap is needed).
-- If there are unresolved conflicts in copy report, stop and ask the user.
+  - originPageSlug (required).
+- Treat conflicts as normal and expected. If copy_page returns needs_review, stop follow-up integration and resolve manually first.
 - Do not force cleanup at flow end; keep downloaded export files available for validation and follow-up checks.
 
   ${WORKFLOW_SUMMARY}`,
@@ -3128,9 +2921,6 @@ AFTER DOWNLOAD:
     ),
     manifestPath: z4.string().describe(
       "Absolute path to sidecar export manifest file (.primeui/temp/exports/[exportId].manifest.json) saved by create_export and required by copy_page."
-    ),
-    pages: z4.array(exportPageSchema2).describe(
-      "Page descriptors loaded from local sidecar export manifest for import decisions."
     )
   }),
   annotations: {
@@ -3147,46 +2937,46 @@ var toolCopyPage = {
 WHEN TO USE:
 - Call this AFTER download_export.
 - Call once per selected page.
-- Use actualPageSlug only when user wants to remap route during import.
 
 BEHAVIOR:
 - Reads export sidecar manifest to resolve originPageSlug -> pagePath/componentsPath.
 - Copies and validates files strictly from pages[].manifest.files for the selected page.
 - Never overwrites existing conflicting files.
+- Writes full conflict diffs to a local report file in .primeui/temp/exports/[exportId].copy-report-[copyId].json.
 - Reports:
-  a) copied new files,
-  b) identical existing files,
-  c) conflicting files with diff,
+  a) copied new files (relative target paths),
+  b) identical existing files (relative target paths),
+  c) conflicting files as lightweight metadata (relative target paths + binary flag, no inline diff),
   d) missing dependencies added to package.json,
   e) dependency version conflicts (report-only, no auto upgrade).
 - Adds only missing dependencies to package.json (dependencies/devDependencies/peerDependencies).
 - Never updates existing dependency versions and never runs install commands.
+- If status is needs_review, page import is NOT complete and manual review is required before continuing. This can be caused by file conflicts or dependency version conflicts.
 
 ${WORKFLOW_SUMMARY}`,
   inputSchema: {
     projectRoot: projectRootInputSchema,
     originPageSlug: z4.string().describe(
       "Source page slug from PrimeUI project pages list, for example '/', '/pricing', '/docs'."
-    ),
-    actualPageSlug: z4.string().optional().describe(
-      "Optional destination slug in user's project. If omitted, originPageSlug is used."
     )
   },
   outputSchema: z4.object({
+    status: z4.enum(["completed", "needs_review"]).describe(
+      "Decision state for next step. needs_review means manual review is required before follow-up integration because of file conflicts or dependency version conflicts."
+    ),
+    message: z4.string().describe(
+      "Decision-oriented summary that includes resolved reportPath and manual follow-up instructions when needed."
+    ),
+    reportPath: z4.string().describe(
+      "Absolute path to saved local report with full conflict diffs and details."
+    ),
     exportId: z4.string().describe("Resolved local export identifier used for copy operation."),
     exportPath: z4.string().describe("Absolute path to local extracted export project root."),
     originPageSlug: z4.string().describe("Normalized source page slug requested for copy."),
-    actualPageSlug: z4.string().describe("Normalized destination slug used for target route paths."),
     sourcePagePath: z4.string().describe("Source page path relative to export root."),
-    targetPagePath: z4.string().describe("Destination page path relative to user project root."),
     sourceComponentsPath: z4.string().describe("Source components directory relative to export root."),
-    targetComponentsPath: z4.string().describe(
-      "Destination components directory relative to user project root."
-    ),
-    newFiles: z4.array(fileTransferSchema).describe("New files copied into user project without conflicts."),
-    identicalFiles: z4.array(fileTransferSchema).describe(
-      "Existing files in user project that are byte-identical to export files."
-    ),
+    newFiles: z4.array(z4.string()).describe("Relative target paths for new files copied into user project."),
+    identicalFiles: z4.array(z4.string()).describe("Relative target paths for existing byte-identical files."),
     conflictFiles: z4.array(conflictFileSchema).describe(
       "Files that already exist and differ from export version. Never overwritten."
     ),
@@ -3399,13 +3189,11 @@ function createPrimeUiMcpServer(source) {
     toolCopyPage,
     async ({
       originPageSlug,
-      actualPageSlug,
       projectRoot
     }) => {
       try {
         const result = await source.copyPage(
           originPageSlug,
-          actualPageSlug,
           { projectRoot }
         );
         return okResult("copy_page", result);