@akanjs/cli 2.3.11-rc.8 → 2.3.11-rc.9

package/incrementalBuilder.proc.js

@@ -15706,6 +15706,7 @@ class AkanQualityScanner {
     const warnings = [
       ...this.#scanGlobalQuality(sourceFiles),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanSingleFileQuality(sourceFile2)),
+      ...sourceFiles.flatMap((sourceFile2) => this.#scanComponentQuality(sourceFile2)),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanConventionQuality(sourceFile2)),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanLayoutQuality(sourceFile2))
     ];
@@ -15834,6 +15835,28 @@ class AkanQualityScanner {
     }
     return warnings;
   }
+  #scanComponentQuality(sourceFile2) {
+    if (!isComponentDeclarationFile(sourceFile2.file))
+      return [];
+    const exportedNames = getExportedDeclarationNames(sourceFile2.sourceFile);
+    const allowedInternalInterfaces = new Set([...exportedNames].map((name) => `${name}Props`));
+    const warnings = [];
+    for (const declaration of getInternalTypeOrFunctionDeclarations(sourceFile2.sourceFile)) {
+      if (exportedNames.has(declaration.name))
+        continue;
+      if (declaration.kind === "interface" && allowedInternalInterfaces.has(declaration.name))
+        continue;
+      warnings.push({
+        rule: "akan.file.component-internal-declaration",
+        scope: "file",
+        severity: "warning",
+        file: sourceFile2.file,
+        line: declaration.line,
+        message: `Component file should not declare non-exported ${declaration.kind} "${declaration.name}". Only a "<Component>Props" interface may stay internal; move other types or helpers to a separate file in ui/, webkit/, or common/ by purpose.`
+      });
+    }
+    return warnings;
+  }
   #scanConventionQuality(sourceFile2) {
     const suffix = CONVENTION_SUFFIXES.find((candidate) => sourceFile2.file.endsWith(candidate));
     if (!suffix)
@@ -15917,7 +15940,7 @@ function formatQualityLocation(file, line) {
 }
 function getExportedFunctionLikes(sourceFile2) {
   const declarations = [];
-  const pageExempt = isPageRouteFile(sourceFile2.file);
+  const nameExempt = isPageRouteFile(sourceFile2.file) || isUiComponentFile(sourceFile2.file);
   for (const statement of sourceFile2.sourceFile.statements) {
     if (ts11.isFunctionDeclaration(statement) && statement.name && isExported(statement)) {
       declarations.push({
@@ -15926,7 +15949,7 @@ function getExportedFunctionLikes(sourceFile2) {
         file: sourceFile2.file,
         line: getLine(sourceFile2.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, statement.body),
-        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
+        duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
       });
     }
     if (ts11.isClassDeclaration(statement) && statement.name && isExported(statement)) {
@@ -15936,7 +15959,7 @@ function getExportedFunctionLikes(sourceFile2) {
         file: sourceFile2.file,
         line: getLine(sourceFile2.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, statement),
-        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, isEnumClassStatement(sourceFile2.sourceFile, statement))
+        duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, isEnumClassStatement(sourceFile2.sourceFile, statement))
       });
     }
     if (ts11.isVariableStatement(statement) && isExported(statement)) {
@@ -15949,7 +15972,7 @@ function getExportedFunctionLikes(sourceFile2) {
           file: sourceFile2.file,
           line: getLine(sourceFile2.sourceFile, declaration),
           bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, declaration.initializer),
-          duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
+          duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
         });
       }
     }
@@ -15960,6 +15983,10 @@ function isPageRouteFile(file) {
   const segments = file.split("/");
   return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "page";
 }
+function isUiComponentFile(file) {
+  const segments = file.split("/");
+  return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "ui";
+}
 function isConventionDuplicateNameExempt(file, isEnumClass) {
   if (!isInLibModule(file))
     return false;
@@ -15985,6 +16012,72 @@ function isEnumClassStatement(sourceFile2, statement) {
 function getExportedClassNames(sourceFile2) {
   return sourceFile2.statements.filter((statement) => ts11.isClassDeclaration(statement) && !!statement.name).filter((statement) => isExported(statement)).map((statement) => statement.name.text);
 }
+function isComponentDeclarationFile(file) {
+  if (!file.endsWith(".tsx"))
+    return false;
+  const segments = file.split("/");
+  const [root, , area] = segments;
+  if (root !== "apps" && root !== "libs")
+    return false;
+  if (area === "lib" || area === "ui")
+    return true;
+  return root === "apps" && area === "page";
+}
+function getExportedDeclarationNames(sourceFile2) {
+  const names = new Set;
+  for (const statement of sourceFile2.statements) {
+    if (ts11.isExportDeclaration(statement) && statement.exportClause && ts11.isNamedExports(statement.exportClause)) {
+      for (const element of statement.exportClause.elements) {
+        names.add(element.name.text);
+        if (element.propertyName)
+          names.add(element.propertyName.text);
+      }
+      continue;
+    }
+    if (!isExported(statement))
+      continue;
+    for (const name of getStatementDeclarationNames(statement))
+      names.add(name);
+  }
+  return names;
+}
+function getStatementDeclarationNames(statement) {
+  if (ts11.isFunctionDeclaration(statement) && statement.name)
+    return [statement.name.text];
+  if (ts11.isClassDeclaration(statement) && statement.name)
+    return [statement.name.text];
+  if (ts11.isInterfaceDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isTypeAliasDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isEnumDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isVariableStatement(statement)) {
+    return statement.declarationList.declarations.filter((declaration) => ts11.isIdentifier(declaration.name)).map((declaration) => declaration.name.text);
+  }
+  return [];
+}
+function getInternalTypeOrFunctionDeclarations(sourceFile2) {
+  const declarations = [];
+  for (const statement of sourceFile2.statements) {
+    if (isExported(statement))
+      continue;
+    if (ts11.isInterfaceDeclaration(statement)) {
+      declarations.push({ name: statement.name.text, kind: "interface", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isTypeAliasDeclaration(statement)) {
+      declarations.push({ name: statement.name.text, kind: "type", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isFunctionDeclaration(statement) && statement.name) {
+      declarations.push({ name: statement.name.text, kind: "function", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isVariableStatement(statement)) {
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts11.isIdentifier(declaration.name) || !isFunctionLikeInitializer(declaration.initializer))
+          continue;
+        declarations.push({ name: declaration.name.text, kind: "function", line: getLine(sourceFile2, declaration) });
+      }
+    }
+  }
+  return declarations;
+}
 function getPlaceholderExportWarnings(sourceFile2) {
   if (!sourceFile2.file.endsWith("/index.ts") && !sourceFile2.file.endsWith("/index.tsx"))
     return [];

package/index.js

@@ -15704,6 +15704,7 @@ class AkanQualityScanner {
     const warnings = [
       ...this.#scanGlobalQuality(sourceFiles),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanSingleFileQuality(sourceFile2)),
+      ...sourceFiles.flatMap((sourceFile2) => this.#scanComponentQuality(sourceFile2)),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanConventionQuality(sourceFile2)),
       ...sourceFiles.flatMap((sourceFile2) => this.#scanLayoutQuality(sourceFile2))
     ];
@@ -15832,6 +15833,28 @@ class AkanQualityScanner {
     }
     return warnings;
   }
+  #scanComponentQuality(sourceFile2) {
+    if (!isComponentDeclarationFile(sourceFile2.file))
+      return [];
+    const exportedNames = getExportedDeclarationNames(sourceFile2.sourceFile);
+    const allowedInternalInterfaces = new Set([...exportedNames].map((name) => `${name}Props`));
+    const warnings = [];
+    for (const declaration of getInternalTypeOrFunctionDeclarations(sourceFile2.sourceFile)) {
+      if (exportedNames.has(declaration.name))
+        continue;
+      if (declaration.kind === "interface" && allowedInternalInterfaces.has(declaration.name))
+        continue;
+      warnings.push({
+        rule: "akan.file.component-internal-declaration",
+        scope: "file",
+        severity: "warning",
+        file: sourceFile2.file,
+        line: declaration.line,
+        message: `Component file should not declare non-exported ${declaration.kind} "${declaration.name}". Only a "<Component>Props" interface may stay internal; move other types or helpers to a separate file in ui/, webkit/, or common/ by purpose.`
+      });
+    }
+    return warnings;
+  }
   #scanConventionQuality(sourceFile2) {
     const suffix = CONVENTION_SUFFIXES.find((candidate) => sourceFile2.file.endsWith(candidate));
     if (!suffix)
@@ -15915,7 +15938,7 @@ function formatQualityLocation(file, line) {
 }
 function getExportedFunctionLikes(sourceFile2) {
   const declarations = [];
-  const pageExempt = isPageRouteFile(sourceFile2.file);
+  const nameExempt = isPageRouteFile(sourceFile2.file) || isUiComponentFile(sourceFile2.file);
   for (const statement of sourceFile2.sourceFile.statements) {
     if (ts11.isFunctionDeclaration(statement) && statement.name && isExported(statement)) {
       declarations.push({
@@ -15924,7 +15947,7 @@ function getExportedFunctionLikes(sourceFile2) {
         file: sourceFile2.file,
         line: getLine(sourceFile2.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, statement.body),
-        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
+        duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
       });
     }
     if (ts11.isClassDeclaration(statement) && statement.name && isExported(statement)) {
@@ -15934,7 +15957,7 @@ function getExportedFunctionLikes(sourceFile2) {
         file: sourceFile2.file,
         line: getLine(sourceFile2.sourceFile, statement),
         bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, statement),
-        duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, isEnumClassStatement(sourceFile2.sourceFile, statement))
+        duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, isEnumClassStatement(sourceFile2.sourceFile, statement))
       });
     }
     if (ts11.isVariableStatement(statement) && isExported(statement)) {
@@ -15947,7 +15970,7 @@ function getExportedFunctionLikes(sourceFile2) {
           file: sourceFile2.file,
           line: getLine(sourceFile2.sourceFile, declaration),
           bodyFingerprint: getBodyFingerprint(sourceFile2.sourceFile, declaration.initializer),
-          duplicateNameExempt: pageExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
+          duplicateNameExempt: nameExempt || isConventionDuplicateNameExempt(sourceFile2.file, false)
         });
       }
     }
@@ -15958,6 +15981,10 @@ function isPageRouteFile(file) {
   const segments = file.split("/");
   return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "page";
 }
+function isUiComponentFile(file) {
+  const segments = file.split("/");
+  return (segments[0] === "apps" || segments[0] === "libs") && segments[2] === "ui";
+}
 function isConventionDuplicateNameExempt(file, isEnumClass) {
   if (!isInLibModule(file))
     return false;
@@ -15983,6 +16010,72 @@ function isEnumClassStatement(sourceFile2, statement) {
 function getExportedClassNames(sourceFile2) {
   return sourceFile2.statements.filter((statement) => ts11.isClassDeclaration(statement) && !!statement.name).filter((statement) => isExported(statement)).map((statement) => statement.name.text);
 }
+function isComponentDeclarationFile(file) {
+  if (!file.endsWith(".tsx"))
+    return false;
+  const segments = file.split("/");
+  const [root, , area] = segments;
+  if (root !== "apps" && root !== "libs")
+    return false;
+  if (area === "lib" || area === "ui")
+    return true;
+  return root === "apps" && area === "page";
+}
+function getExportedDeclarationNames(sourceFile2) {
+  const names = new Set;
+  for (const statement of sourceFile2.statements) {
+    if (ts11.isExportDeclaration(statement) && statement.exportClause && ts11.isNamedExports(statement.exportClause)) {
+      for (const element of statement.exportClause.elements) {
+        names.add(element.name.text);
+        if (element.propertyName)
+          names.add(element.propertyName.text);
+      }
+      continue;
+    }
+    if (!isExported(statement))
+      continue;
+    for (const name of getStatementDeclarationNames(statement))
+      names.add(name);
+  }
+  return names;
+}
+function getStatementDeclarationNames(statement) {
+  if (ts11.isFunctionDeclaration(statement) && statement.name)
+    return [statement.name.text];
+  if (ts11.isClassDeclaration(statement) && statement.name)
+    return [statement.name.text];
+  if (ts11.isInterfaceDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isTypeAliasDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isEnumDeclaration(statement))
+    return [statement.name.text];
+  if (ts11.isVariableStatement(statement)) {
+    return statement.declarationList.declarations.filter((declaration) => ts11.isIdentifier(declaration.name)).map((declaration) => declaration.name.text);
+  }
+  return [];
+}
+function getInternalTypeOrFunctionDeclarations(sourceFile2) {
+  const declarations = [];
+  for (const statement of sourceFile2.statements) {
+    if (isExported(statement))
+      continue;
+    if (ts11.isInterfaceDeclaration(statement)) {
+      declarations.push({ name: statement.name.text, kind: "interface", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isTypeAliasDeclaration(statement)) {
+      declarations.push({ name: statement.name.text, kind: "type", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isFunctionDeclaration(statement) && statement.name) {
+      declarations.push({ name: statement.name.text, kind: "function", line: getLine(sourceFile2, statement) });
+    } else if (ts11.isVariableStatement(statement)) {
+      for (const declaration of statement.declarationList.declarations) {
+        if (!ts11.isIdentifier(declaration.name) || !isFunctionLikeInitializer(declaration.initializer))
+          continue;
+        declarations.push({ name: declaration.name.text, kind: "function", line: getLine(sourceFile2, declaration) });
+      }
+    }
+  }
+  return declarations;
+}
 function getPlaceholderExportWarnings(sourceFile2) {
   if (!sourceFile2.file.endsWith("/index.ts") && !sourceFile2.file.endsWith("/index.tsx"))
     return [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@akanjs/cli",
-  "version": "2.3.11-rc.8",
+  "version": "2.3.11-rc.9",
   "sourceType": "module",
   "type": "module",
   "publishConfig": {
@@ -34,7 +34,7 @@
     "@langchain/openai": "^1.4.6",
     "@tailwindcss/node": "^4.3.0",
     "@trapezedev/project": "^7.1.4",
-    "akanjs": "2.3.11-rc.8",
+    "akanjs": "2.3.11-rc.9",
     "chalk": "^5.6.2",
     "commander": "^14.0.3",
     "daisyui": "5.5.23",

package/templates/workspaceRoot/biome.json.template

@@ -132,6 +132,20 @@
     }
   },
   "overrides": [
+    {
+      "includes": [
+        "apps/**/*.ts",
+        "apps/**/*.tsx",
+        "libs/**/*.ts",
+        "libs/**/*.tsx",
+        "!**/*.test.ts",
+        "!**/*.test.tsx",
+        "!**/*.spec.ts",
+        "!**/*.spec.tsx",
+        "!**/common/**"
+      ],
+      "plugins": ["./node_modules/@akanjs/devkit/lint/no-throw-raw-error.grit"]
+    },
     {
       "includes": ["**/page/**/*.ts", "**/page/**/*.tsx", "**/*.Unit.tsx", "**/*.View.tsx"],
       "plugins": [