@objectstack/lint 15.0.0 → 15.1.0

package/dist/index.cjs

@@ -1119,6 +1119,7 @@ function validateRecordTitle(stack) {
 // src/validate-semantic-roles.ts
 var FIELD_GROUP_UNDECLARED = "field-group-undeclared";
 var FIELD_GROUP_EMPTY = "field-group-empty";
+var FIELD_GROUP_SHADOWED = "field-group-shadowed";
 var SEMANTIC_ROLE_FIELD_UNKNOWN = "semantic-role-field-unknown";
 function asArray10(v) {
   if (Array.isArray(v)) return v;
@@ -1192,6 +1193,31 @@ function validateSemanticRoles(stack) {
         hint: `Fix the field name (highlightFields drives default columns, cards, previews and the detail highlight strip, in order).`
       });
     }
+    const declaredStrings = highlights.filter(
+      (h) => typeof h === "string" && h.length > 0
+    );
+    if (declaredStrings.length > 0 && declaredGroups.size > 0) {
+      const declaredTitle = [obj.nameField, obj.primaryField, obj.displayNameField].find((v) => typeof v === "string" && v.length > 0 && fieldNames.has(v));
+      const titleField = declaredTitle ?? ["name", "full_name", "title", "subject", "display_name"].find((c) => fieldNames.has(c));
+      const stripSet = new Set(
+        declaredStrings.filter((h) => h !== titleField).slice(0, 4)
+      );
+      const hiddenFromBody = new Set(stripSet);
+      if (titleField) hiddenFromBody.add(titleField);
+      for (const key of declaredGroups) {
+        const members = Object.entries(fields).filter(([, f]) => f?.group === key && f?.hidden !== true).map(([fname]) => fname);
+        if (members.length === 0) continue;
+        if (!members.every((m) => hiddenFromBody.has(m))) continue;
+        findings.push({
+          severity: "warning",
+          rule: FIELD_GROUP_SHADOWED,
+          where,
+          path: `${path}.fieldGroups`,
+          message: `${objName}: every field in group "${key}" (${members.join(", ")}) is hoisted into the detail highlight strip (or is the record title) \u2014 the group renders on forms but never on detail pages`,
+          hint: `Keep at least one non-highlighted field in "${key}", or remove the group if the strip already covers it. (Detail pages show the first 4 highlightFields as the top strip and hide them from the body.)`
+        });
+      }
+    }
   }
   return findings;
 }