@nadicodeai/ui 12.1.61 → 12.1.62

package/dist/eslint/rules/no-comment.js

@@ -11,14 +11,39 @@ const DIRECTIVE =
 
 const SEAM_MARKER = /^\s*NADIA\((?:added|changed|removed)\):/;
 
+function moduleHeader(comments, firstTokenStart) {
+  const [first, ...rest] = comments;
+  if (first === undefined || first.range[1] > firstTokenStart) return [];
+  if (first.type === "Block") return [first];
+  const run = [first];
+  for (const next of rest) {
+    if (
+      next.type !== "Line" ||
+      next.range[1] > firstTokenStart ||
+      next.loc.start.line !== run.at(-1).loc.end.line + 1
+    ) {
+      break;
+    }
+    run.push(next);
+  }
+  return run;
+}
+
 export const noComment = {
   meta: {
     type: "problem",
     docs: {
       description:
-        "Disallow comments in code, but for directives to a tool and the marker the seam guard requires",
+        "Disallow comments in code, but for directives to a tool, the marker the seam guard requires and, when allowed, the one comment that opens a module",
     },
-    schema: [],
+    schema: [
+      {
+        type: "object",
+        properties: { allowModuleHeader: { type: "boolean" } },
+        additionalProperties: false,
+      },
+    ],
+    defaultOptions: [{ allowModuleHeader: false }],
     messages: {
       comment:
         "Code says what it does in its names and its structure, never in a comment. Rename or restructure, or remove the comment.",
@@ -26,17 +51,25 @@ export const noComment = {
   },
 
   create(context) {
+    const [{ allowModuleHeader }] = context.options;
+    const { sourceCode } = context;
     return {
       Program() {
-        for (const comment of context.sourceCode.getAllComments()) {
-          if (
-            comment.type === "Shebang" ||
-            DIRECTIVE.test(comment.value) ||
-            SEAM_MARKER.test(comment.value)
-          ) {
-            continue;
+        const prose = sourceCode
+          .getAllComments()
+          .filter(
+            (comment) =>
+              comment.type !== "Shebang" &&
+              !DIRECTIVE.test(comment.value) &&
+              !SEAM_MARKER.test(comment.value),
+          );
+        const header = allowModuleHeader
+          ? moduleHeader(prose, sourceCode.ast.tokens[0]?.range[0] ?? Infinity)
+          : [];
+        for (const comment of prose) {
+          if (!header.includes(comment)) {
+            context.report({ loc: comment.loc, messageId: "comment" });
           }
-          context.report({ loc: comment.loc, messageId: "comment" });
         }
       },
     };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nadicodeai/ui",
-  "version": "12.1.61",
+  "version": "12.1.62",
   "type": "module",
   "publishConfig": {
     "access": "public"
@@ -81,7 +81,7 @@
     "@assistant-ui/react": "0.15.22",
     "@assistant-ui/react-markdown": "0.14.17",
     "@base-ui/react": "^1.8.0",
-    "@nadicodeai/design-system": "12.1.61",
+    "@nadicodeai/design-system": "12.1.62",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",