@actuate-media/cms-core 0.26.0 → 0.27.1

package/dist/sections/validate.js

@@ -0,0 +1,92 @@
+/**
+ * Section content validation — shared by the admin editor's `validatePage`,
+ * the REST `/page-sections/validate` endpoint, and the MCP
+ * `validate_section_content` tool.
+ *
+ * Deterministic (no LLM, no I/O). Validates a SINGLE section's content
+ * against its registry field schema. Page-level rules (title/path, "at
+ * least one visible section", SEO warnings) live in the admin's
+ * `validatePage` because they operate on the whole `EditorPage`.
+ *
+ * Messages are intentionally label-prefix-free (e.g. `"Heading" is
+ * required.`) so callers can prepend their own context (`${sectionName}:
+ * ...`) without double-labelling.
+ */
+import { getSectionType } from './registry.js';
+const URL_OK = /^(https?:\/\/|\/|#|mailto:|tel:)/i;
+function isBlank(v) {
+    return v === undefined || v === null || (typeof v === 'string' && v.trim() === '');
+}
+/** Label/URL field pairs: the URL must be valid when its label is filled in. */
+const BUTTON_PAIRS = [
+    ['primaryButtonLabel', 'primaryButtonUrl'],
+    ['secondaryButtonLabel', 'secondaryButtonUrl'],
+    ['buttonLabel', 'buttonUrl'],
+];
+/**
+ * Validate one section's content + settings against its type schema.
+ *
+ * An unknown `sectionType` is a hard error (the agent asked for a type with
+ * no renderer). Required fields, button URL validity, and image alt text
+ * are enforced; everything else is advisory.
+ */
+export function validateSectionContent(sectionType, content, _settings) {
+    const errors = [];
+    const warnings = [];
+    const def = getSectionType(sectionType);
+    if (!def) {
+        errors.push({
+            sectionType,
+            message: `Unknown section type "${sectionType}". It has no registered renderer.`,
+        });
+        return { valid: false, errors, warnings };
+    }
+    const data = content ?? {};
+    for (const field of def.fields) {
+        if (field.required && isBlank(data[field.key])) {
+            errors.push({ sectionType, field: field.key, message: `"${field.label}" is required.` });
+        }
+    }
+    for (const [labelKey, urlKey] of BUTTON_PAIRS) {
+        const hasLabel = !isBlank(data[labelKey]);
+        const url = data[urlKey];
+        if (hasLabel && !isBlank(url) && typeof url === 'string' && !URL_OK.test(url.trim())) {
+            errors.push({ sectionType, field: urlKey, message: `"${url}" is not a valid URL.` });
+        }
+        // A configured URL with no label is a soft issue — the button won't render.
+        if (!hasLabel && !isBlank(data[urlKey])) {
+            warnings.push({
+                sectionType,
+                field: labelKey,
+                message: `A URL is set for "${urlKey}" but its button label is empty, so the button will not render.`,
+            });
+        }
+    }
+    // Image alt text required when an image is set (accessibility).
+    if (!isBlank(data.imageUrl) && isBlank(data.imageAlt)) {
+        errors.push({
+            sectionType,
+            field: 'imageAlt',
+            message: 'image needs alt text for accessibility.',
+        });
+    }
+    // Gallery images should each carry alt text (accessibility) — advisory so
+    // it never blocks publish, but surfaced so it can be fixed.
+    if (Array.isArray(data.images)) {
+        const missingAlt = data.images.some((img) => {
+            if (!img || typeof img !== 'object')
+                return false;
+            const row = img;
+            return !isBlank(row.url) && isBlank(row.alt);
+        });
+        if (missingAlt) {
+            warnings.push({
+                sectionType,
+                field: 'images',
+                message: 'One or more gallery images are missing alt text for accessibility.',
+            });
+        }
+    }
+    return { valid: errors.length === 0, errors, warnings };
+}
+//# sourceMappingURL=validate.js.map

package/dist/sections/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/sections/validate.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@actuate-media/cms-core",
-  "version": "0.26.0",
+  "version": "0.27.1",
   "repository": {
     "type": "git",
     "url": "https://github.com/actuate-media/actuatecms.git",
@@ -59,6 +59,11 @@
       "import": "./dist/page-builder/index.js",
       "default": "./dist/page-builder/index.js"
     },
+    "./page-sections": {
+      "types": "./dist/sections/index.d.ts",
+      "import": "./dist/sections/index.js",
+      "default": "./dist/sections/index.js"
+    },
     "./realtime": {
       "types": "./dist/realtime/index.d.ts",
       "import": "./dist/realtime/index.js",