@primeuicom/mcp 1.2.3 → 1.2.5

package/dist/service.js

@@ -622,6 +622,14 @@ var primeUiComponentExportPageSchema = z3.object({
   isReadyToExport: z3.boolean(),
   manifest: primeUiExportPageManifestSchema
 });
+var primeUiComponentExportSelectedBlockSchema = z3.object({
+  blockId: z3.string(),
+  componentId: z3.string(),
+  contentKey: z3.string(),
+  occurrenceIndex: z3.number().int().positive(),
+  props: z3.record(z3.unknown()).nullable(),
+  slot: z3.string().nullable()
+});
 var primeUiProjectInfoSchema = z3.object(
   {
     projectId: z3.string(),
@@ -739,6 +747,9 @@ var primeUiComponentCandidatesResponseSchema = z3.object({
   candidates: z3.array(primeUiComponentCandidateSchema)
 });
 var primeUiComponentPropsValidateInputSchema = z3.object({
+  blockId: z3.string().refine((value) => value.trim().length > 0, {
+    message: "blockId must be a non-empty string"
+  }),
   pageSlug: primeUiPageSlugInputSchema,
   componentId: z3.string(),
   props: z3.record(z3.unknown())
@@ -755,6 +766,13 @@ var primeUiComponentPropsRenderCheckSchema = z3.object({
 var primeUiComponentPropsValidateResponseSchema = z3.object({
   valid: z3.boolean(),
   normalizedProps: z3.record(z3.unknown()).nullable(),
+  propsValidationId: z3.string().nullable(),
+  block: z3.object({
+    blockId: z3.string(),
+    componentId: z3.string(),
+    contentKey: z3.string(),
+    props: z3.record(z3.unknown())
+  }).nullable(),
   errors: z3.array(primeUiComponentPropsValidationErrorSchema),
   hints: z3.array(z3.string()),
   renderCheck: primeUiComponentPropsRenderCheckSchema
@@ -987,6 +1005,7 @@ var primeUiExportManifestSchema = primeUiCreateExportResponseSchema;
 var primeUiComponentExportResponseSchema = z3.object({
   exportId: z3.string(),
   export: primeUiPostExportPayloadExportSchema,
+  block: primeUiComponentExportSelectedBlockSchema.optional(),
   component: primeUiComponentExportComponentSchema,
   page: primeUiComponentExportPageSchema,
   pages: z3.array(primeUiComponentExportPageSchema)
@@ -1083,6 +1102,16 @@ var normalizePrimeUiApiRoot = (rawBaseUrl) => {
 var buildPrimeUiApiUrl = (apiRoot, endpoint) => new URL(endpoint, apiRoot).toString();
 var isJsonContentType = (contentType) => contentType.includes("application/json") || contentType.includes("+json");
 var isZipContentType = (contentType) => ZIP_CONTENT_TYPES.some((allowedType) => contentType.includes(allowedType));
+function normalizePropsValidationId(propsValidationId) {
+  if (typeof propsValidationId === "undefined") {
+    return void 0;
+  }
+  const trimmed = propsValidationId.trim();
+  if (!trimmed) {
+    throw new Error("propsValidationId must be a non-empty string.");
+  }
+  return trimmed;
+}
 var looksLikeZipArchive = (buffer) => {
   if (buffer.length < 4) {
     return false;
@@ -1295,11 +1324,14 @@ var ApiProjectDataProvider = class {
       }
     );
   }
-  async createComponentExport(componentId) {
+  async createComponentExport(componentId, options = {}) {
+    const propsValidationId = normalizePropsValidationId(
+      options.propsValidationId
+    );
     return this.requestJson(
       `component-registry/components/${encodeURIComponent(componentId)}/exports`,
       primeUiComponentExportResponseSchema,
-      {
+      propsValidationId ? this.buildJsonRequestInit({ propsValidationId }) : {
         method: "POST"
       }
     );
@@ -3920,6 +3952,11 @@ function isVirtualRouteFile(relativePath) {
   const segments = relativePath.split("/");
   return segments[0] === "src" && segments[1] === "app" && segments.includes(VIRTUAL_ROUTE_SEGMENT);
 }
+function isVirtualComponentExportPageFile(relativePath) {
+  const segments = relativePath.split("/");
+  const virtualRouteIndex = segments.indexOf(VIRTUAL_ROUTE_SEGMENT);
+  return isVirtualRouteFile(relativePath) && virtualRouteIndex >= 0 && segments.length === virtualRouteIndex + 3 && segments[virtualRouteIndex + 2] === "page.tsx";
+}
 function getVirtualComponentRelativePath(relativePath, componentId) {
   const prefix = `${COMPONENT_PAGES_PREFIX}${VIRTUAL_ROUTE_SEGMENT}/${componentId}/`;
   if (!relativePath.startsWith(prefix)) {
@@ -3985,6 +4022,44 @@ function toImportPath(relativePath) {
   const withoutIndex = withoutExtension.replace(/\/index$/u, "");
   return `@/${withoutIndex.replace(/^src\//u, "")}`;
 }
+function toPascalComponentName(componentId) {
+  return componentId.split(/[^a-zA-Z0-9]+/u).filter(Boolean).map((part) => `${part.charAt(0).toUpperCase()}${part.slice(1)}`).join("");
+}
+function toVariableName(componentName) {
+  if (!componentName) {
+    return "componentProps";
+  }
+  return `${componentName.charAt(0).toLowerCase()}${componentName.slice(1)}Props`;
+}
+function toSafeCamelIdentifier(input, fallback) {
+  const parts = input.trim().split(/[^a-zA-Z0-9]+/u).filter(Boolean);
+  if (parts.length === 0) {
+    return fallback;
+  }
+  const pascalName = parts.map((part) => {
+    const normalizedPart = part.toLowerCase();
+    return `${normalizedPart.charAt(0).toUpperCase()}${normalizedPart.slice(1)}`;
+  }).join("");
+  if (!pascalName) {
+    return fallback;
+  }
+  if (/^[0-9]/u.test(pascalName)) {
+    return `block${pascalName}`;
+  }
+  return `${pascalName.charAt(0).toLowerCase()}${pascalName.slice(1)}`;
+}
+function isDefaultComponentExportBlock(selectedBlock) {
+  return selectedBlock.blockId === `component-export:${selectedBlock.componentId}:block`;
+}
+function toPropsVariableName(input) {
+  if (isDefaultComponentExportBlock(input.selectedBlock)) {
+    return toVariableName(input.componentName);
+  }
+  return `${toSafeCamelIdentifier(
+    input.selectedBlock.blockId,
+    input.componentName ? toVariableName(input.componentName).replace(/Props$/u, "") : "component"
+  )}Props`;
+}
 function escapeRegExp(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
 }
@@ -4224,6 +4299,113 @@ function buildMessage(input) {
   );
   return parts.join(" ");
 }
+function getDefaultSelectedBlock(manifest) {
+  const componentId = manifest.component.componentId;
+  return {
+    blockId: `component-export:${componentId}:block`,
+    componentId,
+    contentKey: componentId,
+    occurrenceIndex: 1,
+    props: null,
+    slot: null
+  };
+}
+function getSelectedBlock(manifest) {
+  return manifest.block ?? getDefaultSelectedBlock(manifest);
+}
+function getVirtualRouteFile(manifestFiles) {
+  return manifestFiles.find(isVirtualComponentExportPageFile) ?? manifestFiles.find(isVirtualRouteFile) ?? null;
+}
+function readBalancedObjectLiteral(input, startIndex) {
+  if (input[startIndex] !== "{") {
+    return null;
+  }
+  let depth = 0;
+  let quote = null;
+  let escaped = false;
+  for (let index = startIndex; index < input.length; index += 1) {
+    const char = input[index];
+    if (escaped) {
+      escaped = false;
+      continue;
+    }
+    if (quote) {
+      if (char === "\\") {
+        escaped = true;
+        continue;
+      }
+      if (char === quote) {
+        quote = null;
+      }
+      continue;
+    }
+    if (char === '"' || char === "'" || char === "`") {
+      quote = char;
+      continue;
+    }
+    if (char === "{") {
+      depth += 1;
+      continue;
+    }
+    if (char !== "}") {
+      continue;
+    }
+    depth -= 1;
+    if (depth === 0) {
+      return input.slice(startIndex, index + 1);
+    }
+  }
+  return null;
+}
+function extractContentDataPropsCode(input) {
+  const contentDataIndex = input.source.indexOf("const contentData");
+  if (contentDataIndex < 0) {
+    return null;
+  }
+  const keyPattern = new RegExp(
+    `["']${escapeRegExp(input.contentKey)}["']\\s*:`,
+    "u"
+  );
+  const keyMatch = keyPattern.exec(input.source.slice(contentDataIndex));
+  if (!keyMatch) {
+    return null;
+  }
+  const valueStartSearchIndex = contentDataIndex + keyMatch.index + keyMatch[0].length;
+  const objectStartIndex = input.source.indexOf("{", valueStartSearchIndex);
+  if (objectStartIndex < 0) {
+    return null;
+  }
+  return readBalancedObjectLiteral(input.source, objectStartIndex);
+}
+async function buildRegistryComponentInsertion(input) {
+  const componentName = toPascalComponentName(input.selectedBlock.componentId);
+  const propsVariableName = toPropsVariableName({
+    componentName,
+    selectedBlock: input.selectedBlock
+  });
+  const virtualRouteFile = getVirtualRouteFile(input.manifestFiles);
+  const referenceFiles = virtualRouteFile ? [virtualRouteFile] : [];
+  let materializedPropsCode = input.selectedBlock.props ? JSON.stringify(input.selectedBlock.props, null, 2) : "{}";
+  if (virtualRouteFile) {
+    try {
+      const virtualRouteSource = await readFile7(
+        path13.join(input.exportPath, virtualRouteFile),
+        "utf-8"
+      );
+      materializedPropsCode = extractContentDataPropsCode({
+        source: virtualRouteSource,
+        contentKey: input.selectedBlock.contentKey
+      }) ?? materializedPropsCode;
+    } catch {
+    }
+  }
+  return {
+    imports: [`import ${componentName} from "${input.componentImportPath}";`],
+    propsCode: `const ${propsVariableName} = ${materializedPropsCode};`,
+    jsx: `<${componentName} {...${propsVariableName}} />`,
+    referenceFiles
+  };
+}
 async function copyRegistryComponentFromExport(input) {
   const normalizedComponentId = normalizeComponentId(input.componentId);
   const { exportId, exportPath } = await resolveSingleExportDirectory(
@@ -4316,6 +4498,13 @@ async function copyRegistryComponentFromExport(input) {
     componentId: normalizedComponentId,
     copyableFiles: copyableSourceFiles
   });
+  const selectedBlock = getSelectedBlock(manifest);
+  const insertion = await buildRegistryComponentInsertion({
+    componentImportPath,
+    exportPath,
+    manifestFiles,
+    selectedBlock
+  });
   const candidateFiles = await resolveManifestCandidateFiles({
     exportPath,
     manifestOwnerLabel: `registry component "${normalizedComponentId}"`,
@@ -4407,8 +4596,10 @@ async function copyRegistryComponentFromExport(input) {
     exportId,
     componentId: normalizedComponentId,
     componentImportPath,
+    insertion,
     manifestFiles,
     copyableFiles,
+    selectedBlock,
     skippedFiles,
     conflicts: sortedConflictEntries,
     missingManifestFiles: missingManifestFileList
@@ -4445,8 +4636,10 @@ async function copyRegistryComponentFromExport(input) {
     manifestPath,
     component: manifest.component,
     componentImportPath,
+    insertion,
     manifestFiles,
     copyableFiles,
+    selectedBlock,
     newFiles: sortedNewFiles,
     identicalFiles: sortedIdenticalFiles,
     conflictFiles: sortedConflictFiles,
@@ -4674,9 +4867,11 @@ var ProjectSyncService = class {
       }
     };
   }
-  async createComponentExport(componentId, _context) {
+  async createComponentExport(componentId, options = {}, _context) {
     await this.ensureTempLayout();
-    const result = await this.provider.createComponentExport(componentId);
+    const result = await this.provider.createComponentExport(componentId, {
+      propsValidationId: options.propsValidationId
+    });
     const manifestPath = buildManifestPath(this.exportsRoot, result.export.id);
     await writeUtf8(manifestPath, `${JSON.stringify(result, null, 2)}
 `);
@@ -5131,10 +5326,10 @@ var LazyProjectSyncSource = class {
       (service) => service.createExport(context)
     );
   }
-  async createComponentExport(componentId, context) {
+  async createComponentExport(componentId, options, context) {
     return this.withService(
       context,
-      (service) => service.createComponentExport(componentId, context)
+      (service) => service.createComponentExport(componentId, options, context)
     );
   }
   async downloadExportById(id, context) {
@@ -5354,6 +5549,16 @@ var copyComponentGuidanceSchema = z4.object({
   requiredActions: z4.array(z4.string()).describe("Concrete next actions for finishing component transfer."),
   notes: z4.array(z4.string()).describe("Important semantics and caveats for this transfer result.")
 });
+var registryComponentInsertionSchema = z4.object({
+  imports: z4.array(z4.string()).describe("Import statements needed for inserting the copied component."),
+  propsCode: z4.string().describe(
+    "Materialized props source derived from the downloaded virtual component export."
+  ),
+  jsx: z4.string().describe("JSX snippet for rendering the materialized component instance."),
+  referenceFiles: z4.array(z4.string()).describe(
+    "Downloaded export files used as the source of truth for materialized insertion."
+  )
+});
 var pageDetailsSchema = pageSchema.extend({
   pageInstruction: z4.string().nullable().describe(
     "Current instruction text for the active page variant. Null when no active variant is set."
@@ -5642,6 +5847,7 @@ WHEN TO USE: Use this only for the component-registry import track when the user
 AFTER CALLING:
 - Verify component.componentId matches the requested componentId.
 - Verify component.isReadyToExport is true and page.manifest.files is present.
+- Pass propsValidationId from component_props_validate when exporting a validated instance. Omit it only for the intentional default-props component export path.
 - Local component sidecar manifest is saved to .primeui/temp/exports/[exportId].manifest.json.
 - Use the returned export ID to call download_component_export.
 - Use copy_registry_component after download_component_export for this component-track manifest. Do not use page copy tools for component-track manifests.
@@ -5650,7 +5856,10 @@ AFTER CALLING:
 ${WORKFLOW_SUMMARY}`,
   inputSchema: {
     projectRoot: projectRootInputSchema,
-    componentId: z4.string().min(1).describe("PrimeUI component registry identifier to export.")
+    componentId: z4.string().min(1).describe("PrimeUI component registry identifier to export."),
+    propsValidationId: z4.string().trim().min(1).optional().describe(
+      "Optional props validation handoff id returned by component_props_validate. Omit to export registry defaultProps."
+    )
   },
   outputSchema: z4.object({
     exportId: z4.string().describe(
@@ -5669,6 +5878,9 @@ ${WORKFLOW_SUMMARY}`,
       exportables: z4.array(exportableSchema).describe("Shared exportables included in this export payload.")
     }).describe("Created component export summary."),
     component: componentExportComponentSchema,
+    block: copyComponentSelectedBlockSchema.optional().describe(
+      "Selected virtual component-export block metadata when the export used a propsValidationId handoff."
+    ),
     page: componentExportPageSchema.describe(
       "Virtual page manifest for this component export."
     ),
@@ -5982,6 +6194,7 @@ BEHAVIOR:
 - Copies only the selected registry component import graph, narrowly referenced public assets, and safe support files from the component sidecar manifest/export.
 - Remaps component-local files into src/components/shared/** and returns componentImportPath for manual insertion.
 - Skips virtual route files that include __primeui-component-export, because those are reference/insertion hints and must not be installed as normal app routes.
+- Returns selectedBlock and insertion artifacts derived from the downloaded virtual component export. Treat insertion.propsCode and insertion.jsx as the materialized instance source of truth.
 - Skips app/search/layout/header/footer/env/project-shell files instead of copying whole exportable buckets.
 - Never copies package.json directly. package.json is used only to add missing dependency entries and report dependency version conflicts.
 - Keeps safe support files on their natural target paths, such as src/components/ui/**, src/lib/**, src/types/**, and src/contexts/**.
@@ -6018,6 +6231,12 @@ ${WORKFLOW_SUMMARY}`,
     componentImportPath: z4.string().describe(
       "Canonical import path for the copied registry component entrypoint, for example @/components/shared/hero--pricing."
     ),
+    selectedBlock: copyComponentSelectedBlockSchema.describe(
+      "Selected virtual component-export block metadata. First-instance contentKey semantics match page export."
+    ),
+    insertion: registryComponentInsertionSchema.describe(
+      "Materialized insertion artifact for adding this component instance to a real local page."
+    ),
     manifestFiles: z4.array(z4.string()).describe(
       "Normalized component sidecar manifest files considered by the copy service."
     ),
@@ -6259,6 +6478,9 @@ var componentPropsValidateInputSchema = z4.object({
     "Stable PrimeUI page slug used for validation diagnostics, for example '/pricing'. Use the same pageSlug as candidate retrieval."
   ),
   componentId: z4.string().describe("PrimeUI component registry identifier selected by the agent."),
+  blockId: z4.string().trim().min(1).describe(
+    "Stable local block identifier for this planned component instance. Required for propsValidationId handoff records."
+  ),
   props: z4.record(z4.unknown()).describe(
     "Agent-authored props payload to validate against PrimeUI's registry schema."
   )
@@ -6321,6 +6543,17 @@ var componentPropsValidateOutputSchema = z4.object({
   normalizedProps: z4.record(z4.unknown()).nullable().describe(
     "Props normalized by PrimeUI when valid; null when validation failed."
   ),
+  propsValidationId: z4.string().nullable().describe(
+    "Durable validation handoff id for create_component_export; null when props are invalid."
+  ),
+  block: z4.object({
+    blockId: z4.string(),
+    componentId: z4.string(),
+    contentKey: z4.string(),
+    props: z4.record(z4.unknown())
+  }).nullable().describe(
+    "Selected validated block identity and normalized props; null when props are invalid."
+  ),
   errors: z4.array(componentPropsValidationErrorSchema).describe("Structured validation errors for invalid props."),
   hints: z4.array(z4.string()).describe("Agent-facing guidance for correcting invalid props."),
   renderCheck: componentPropsRenderCheckSchema.describe(
@@ -6793,15 +7026,15 @@ WHEN TO USE:
 - Treat valid: false as actionable feedback, not a transport failure. Fix the props from errors and hints, then call this tool again.
 
 AFTER CALLING:
-- If valid is true, use normalizedProps for local page edits.
+- If valid is true, pass propsValidationId to create_component_export so copy_registry_component can return materialized insertion artifacts.
 - If valid is false, correct props using errors[].path, errors[].message, and hints before editing local files.
 - Do not mutate Prime page state from this tool result. This is validation guidance only.`,
   inputSchema: componentPropsValidateInputSchema,
   outputSchema: componentPropsValidateOutputSchema,
   annotations: {
-    readOnlyHint: true,
+    readOnlyHint: false,
     destructiveHint: false,
-    idempotentHint: true,
+    idempotentHint: false,
     openWorldHint: true
   }
 };
@@ -7274,11 +7507,17 @@ function createPrimeUiMcpServer(source) {
   server.registerTool(
     "create_component_export",
     toolCreateComponentExport,
-    async ({ componentId, projectRoot }) => {
+    async ({
+      componentId,
+      projectRoot,
+      propsValidationId
+    }) => {
       try {
-        const result = await source.createComponentExport(componentId, {
-          projectRoot
-        });
+        const result = await source.createComponentExport(
+          componentId,
+          { propsValidationId },
+          { projectRoot }
+        );
         return okResult("create_component_export", result);
       } catch (error) {
         return errorResult(error);