feat(cdi-preview): improve user notifications and validation messages for better clarity and guidance

Author: ErykKul

previewers/betatest/CdiPreview.html

@@ -63,7 +63,7 @@
     <!-- Header -->
     <div class="preview-header">
         <h3>CDI Data Viewer & Editor</h3>
-        <p>Displaying DDI-CDI (Cross Domain Integration) metadata. Edit mode allows you to modify properties and validate against SHACL shapes.</p>
+        <p>Displaying DDI-CDI (Cross Domain Integration) metadata. Edit mode allows you to modify properties. Use the Validate button to check conformance against SHACL shapes.</p>
         <div id="normalization-notice" style="display: none; margin-top: 10px; padding: 8px; background: #d1ecf1; border-left: 3px solid #17a2b8; border-radius: 3px;">
             <span class="glyphicon glyphicon-info-sign" style="margin-right: 5px;"></span>
             <strong>Note:</strong> This JSON-LD was automatically normalized to <code>@graph</code> format for editing. The structure has been preserved.

previewers/betatest/js/cdi-preview/cdi-graph-helpers.js

@@ -123,7 +123,7 @@ function addRootNode() {
   if (availableTypes.length === 0) {
     // No SHACL shapes loaded, allow custom type
     const customType = prompt(
-      "Enter node type (e.g., DataSet, Study, Variable):"
+      "No SHACL shapes loaded. Enter a custom node type (e.g., Dataset, Study, Variable):"
     );
     if (!customType) return;
 
@@ -160,7 +160,7 @@ function addRootNode() {
                                 </div>
                                 <div class="form-group">
                                     <label for="customNodeType"><strong>Or enter custom type:</strong></label>
-                                    <input type="text" id="customNodeType" class="form-control" placeholder="e.g., DataSet, Study, Variable">
+                                    <input type="text" id="customNodeType" class="form-control" placeholder="e.g., Dataset, Study, Variable">
                                 </div>
                             </div>
                             <div class="modal-footer">

previewers/betatest/js/cdi-preview/cdi-shacl-loader.js

@@ -66,7 +66,7 @@ async function loadShapes(shapeSource, customUrl = null) {
 
         // Show user notification
         alert(
-          `Note: Could not load shapes from ${shapeUrl}.\nUsing local built-in shapes instead.\n\nError: ${error.message}`
+          `Could not load shapes from:\n${shapeUrl}\n\nFalling back to local built-in DDI-CDI shapes.\n\nError: ${error.message}`
         );
 
         return true;

previewers/betatest/js/cdi-preview/data-extraction.js

@@ -170,9 +170,9 @@ async function saveToDataverse() {
   } catch (error) {
     console.error("Save error:", error);
     alert(
-      "✗ Failed to save to Dataverse:\n" +
+      "Failed to save to Dataverse:\n\n" +
         error.message +
-        "\n\nPlease check:\n- Your API token is valid\n- You have write access to this dataset\n- The dataset is accessible"
+        "\n\nPlease check:\n• Your API token is valid\n• You have write access to this dataset\n• The Dataverse server is accessible"
     );
   } finally {
     // Reset button

previewers/betatest/js/cdi-preview/event-handlers.js

@@ -109,7 +109,7 @@ function setupEventHandlers() {
     // Check if validation passed
     setTimeout(() => {
       if (validationReport && !validationReport.conforms) {
-        if (!confirm("Data has validation errors. Save anyway?")) {
+        if (!confirm("Your data has validation errors. Do you want to save anyway?")) {
           return;
         }
       }
@@ -302,7 +302,7 @@ function setupEventHandlers() {
           '<span class="validation-badge invalid">Custom shape load failed</span>'
         );
         alert(
-          `Failed to load custom SHACL shape from:\n${customUrl}\n\nError: ${error.message}`
+          `Failed to load custom SHACL shapes from:\n${customUrl}\n\nError: ${error.message}\n\nPlease check:\n• The URL is accessible\n• The file is valid Turtle (.ttl) format\n• CORS is enabled on the server`
         );
       }
     }

previewers/betatest/js/cdi-preview/validation.js

@@ -170,7 +170,7 @@ async function validateData() {
     if (error.message.includes("SPARQLConstraintComponent")) {
       errorMsg =
         "The selected SHACL shapes contain SPARQL constraints, which are not supported in the browser. " +
-        "Please use the 'DDI-CDI 1.0 (Official)' shapes instead, which use Core SHACL constraints only.";
+        "Please use Core SHACL-compatible shapes (e.g., 'DDI-CDI 1.0 (Official)' or 'CDIF Discovery Core').";
     }
 
     $("#validation-status").html(