@paroicms/site-generator-plugin 0.31.6 → 0.32.0

package/backend/dist/generator/llm-queries/invoke-update-site-schema.js

@@ -167,7 +167,10 @@ function fixSiteSchema(siteSchema) {
             continue;
         // Add Tiptap plugin to fields with renderAs "html"
         for (const field of nodeType.fields) {
-            if (typeof field !== "string" && field.renderAs === "html" && field.storedAs !== "labeling") {
+            if (typeof field !== "string" &&
+                field.renderAs === "html" &&
+                field.storedAs !== "labeling" &&
+                field.storedAs !== "partField") {
                 field.dataType = "json";
                 field.plugin = "@paroicms/tiptap-editor-plugin";
             }
@@ -181,9 +184,29 @@ function fixSiteSchema(siteSchema) {
             ];
         }
     }
+    validatePartFieldReferences(nodeTypes);
     setMenuPlacementOnTaxonomies(nodeTypes);
     return siteSchema;
 }
+function validatePartFieldReferences(nodeTypes) {
+    if (!nodeTypes)
+        return;
+    const partTypeNames = new Set(nodeTypes.filter((nt) => nt.kind === "part").map((nt) => nt.typeName));
+    for (const nodeType of nodeTypes) {
+        if (!nodeType.fields)
+            continue;
+        nodeType.fields = nodeType.fields.filter((field) => {
+            if (typeof field === "string")
+                return true;
+            if (field.storedAs !== "partField")
+                return true;
+            if (typeof field.partType !== "string" || !partTypeNames.has(field.partType)) {
+                return false;
+            }
+            return true;
+        });
+    }
+}
 function setMenuPlacementOnTaxonomies(nodeTypes) {
     if (!nodeTypes)
         return;

package/backend/dist/generator/site-generator/document-template-creator.js

@@ -163,6 +163,9 @@ function templateOfFields(ctx, fields, { parentKey }) {
     return fieldTemplates.join("\n");
 }
 function templateOfField(ctx, fieldOrQualifiedName, parentKey) {
+    if (typeof fieldOrQualifiedName !== "string" && fieldOrQualifiedName.storedAs === "partField") {
+        return templateOfPartField(ctx, fieldOrQualifiedName, parentKey);
+    }
     const { dataType, renderAs, name } = typeof fieldOrQualifiedName === "string"
         ? getPredefinedDataType(ctx, fieldOrQualifiedName)
         : fieldOrQualifiedName.storedAs === "labeling"
@@ -229,6 +232,21 @@ function templateOfField(ctx, fieldOrQualifiedName, parentKey) {
     }
     return `<div class="Field">{{ ${parentKey}.${name} }}</div>`;
 }
+function templateOfPartField(ctx, field, parentKey) {
+    const partKey = `${parentKey}.${field.name}`;
+    const partType = ctx.siteSchema.nodeTypes?.find((nt) => nt.typeName === field.partType && nt.kind === "part");
+    if (!partType?.fields || partType.fields.length === 0) {
+        return `{%- comment -%} Part field: ${field.name} (no fields) {%- endcomment -%}`;
+    }
+    const innerFields = templateOfFields(ctx, partType.fields, { parentKey: `${partKey}.field` });
+    if (!innerFields)
+        return "";
+    return `{% if ${partKey} %}
+<div class="${camelToKebabCase(field.partType)}">
+${innerFields}
+</div>
+{% endif %}`;
+}
 function templateOfPicture({ imageKey }) {
     return `{% if ${imageKey} %}
   {% set smallIm = image(${imageKey}, resize: "360x48") %}

package/backend/prompts/update-site-schema-2-execute.md

@@ -89,7 +89,23 @@ A labeling field lets the user assign taxonomy terms to a document (or part).
 
 Most of the time, the field name will be the same as the taxonomy type name.
 
-# 4. Examine the current JSON data, which conforms to the `JtSiteSchema` type
+# 4. Part Field (embedding a part inline)
+
+A part field embeds a single part directly within a document or part's field list. The referenced part type must exist in the schema's nodeTypes as a `kind: "part"` node type.
+
+<field_type_example>
+{
+  "name": "seo",
+  "storedAs": "partField",
+  "partType": "myPartTypeName"
+}
+</field_type_example>
+
+When using a partField, the referenced part type (e.g., "myPartTypeName") must be defined as a `kind: "part"` node type in the schema. The part will be embedded inline in the document editor, not in the parts tab.
+
+Use partField when a group of fields should logically belong together as a reusable unit (e.g., SEO metadata, social sharing settings, address blocks).
+
+# 5. Examine the current JSON data, which conforms to the `JtSiteSchema` type
 
 <site_schema_json>
 {{siteSchemaJson}}
@@ -101,20 +117,20 @@ Also, the attached locales:
 {{l10nJson}}
 </l10n_json>
 
-# 5. Now, here is what to do
+# 6. Now, here is what to do
 
 <user_request>
 {{taskDetailsMd}}
 </user_request>
 
-# 6. Guidelines
+# 7. Guidelines
 
 - Don't assume how the CMS works. If you are not sure how to do something, don't do it.
 - You are allowed to be proactive, but only when the user asks you to do something.
 - Remember to adhere strictly to the TypeScript typing when making changes. If the update message requests changes that would violate the typing, then prioritize maintaining the correct structure over making those specific changes.
 - Field choice for listing pages: For new routing documents that have `regularChildren` (like blog index, products index, etc.), prefer `introduction[@paroicms/tiptap-editor-plugin]` instead of `htmlContent[@paroicms/tiptap-editor-plugin]`. These pages display a list of child items, so they only need a short introduction, not full HTML content.
 
-# 7. Output
+# 8. Output
 
 If there is a change in the site schema, then provide the updated site schema in JSON within <updated_site_schema_json> tags. Otherwise, let this tag empty.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paroicms/site-generator-plugin",
-  "version": "0.31.6",
+  "version": "0.32.0",
   "description": "ParoiCMS Site Generator Plugin",
   "keywords": [
     "paroicms",
@@ -30,7 +30,7 @@
   "dependencies": {
     "@anthropic-ai/sdk": "~0.78.0",
     "@mistralai/mistralai": "~1.14.1",
-    "@paroicms/script-lib": "0.3.19",
+    "@paroicms/script-lib": "0.3.20",
     "arktype": "~2.2.0",
     "jsonwebtoken": "~9.0.3",
     "knex": "~3.1.0",
@@ -42,9 +42,9 @@
     "@paroicms/public-server-lib": "0"
   },
   "devDependencies": {
-    "@paroicms/internal-anywhere-lib": "1.39.0",
-    "@paroicms/internal-server-lib": "1.24.4",
-    "@paroicms/public-server-lib": "0.55.0",
+    "@paroicms/internal-anywhere-lib": "1.39.1",
+    "@paroicms/internal-server-lib": "1.24.5",
+    "@paroicms/public-server-lib": "0.56.0",
     "@types/node": "~24.11.0",
     "marked": "~17.0.4",
     "nodemon": "~3.1.14",