pasika 0.10.85 → 0.10.86

package/dist/eslint/pasika/index.js

@@ -164,7 +164,7 @@ var apiContractRule = {
 
 // eslint/rules/application-structure.ts
 import fs2 from "fs";
-import path5 from "path";
+import path6 from "path";
 
 // eslint/project/ccf.ts
 import fs from "fs";
@@ -494,264 +494,8 @@ function parseModule(file) {
   return { file: path3.resolve(file), imports, reexports, exports, namedNumericLiterals };
 }
 
-// eslint/rules/project-root.ts
-import path4 from "path";
-function sourceRootOf(context) {
-  return path4.resolve(context.cwd ?? process.cwd(), "src");
-}
-
-// eslint/rules/application-structure.ts
-var MODULE_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"]);
-var ROUTING_FILES = /* @__PURE__ */ new Set([
-  "default",
-  "error",
-  "global-error",
-  "instrumentation",
-  "layout",
-  "loading",
-  "middleware",
-  "not-found",
-  "page",
-  "route",
-  "template",
-  // File conventions Next.js requires to keep their exact names in src/app/
-  "apple-icon",
-  "icon",
-  "manifest",
-  "opengraph-image",
-  "robots",
-  "sitemap",
-  "twitter-image"
-]);
-var EXPECTED_SUPPORT_FOLDER = {
-  hook: "hooks",
-  type: "types",
-  schema: "schemas",
-  constant: "constants",
-  function: "utils"
-};
-function report(context, message) {
-  return {
-    Program(node) {
-      context.report({ node, loc: { line: 1, column: 0 }, message });
-    }
-  };
-}
-function isCodeFile(filename) {
-  return MODULE_EXTENSIONS.has(path5.extname(filename));
-}
-function isRootSupportFolder(folder) {
-  return SUPPORT_FOLDERS.has(folder);
-}
-function exportedKinds(filename) {
-  try {
-    return new Set(parseModule(filename).exports.map((moduleExport) => moduleExport.kind));
-  } catch {
-    return /* @__PURE__ */ new Set();
-  }
-}
-function expectedSupportFolder(kinds) {
-  for (const kind of ["component", "hook", "schema", "function", "constant", "type"]) {
-    if (kinds.has(kind)) return EXPECTED_SUPPORT_FOLDER[kind];
-  }
-  return void 0;
-}
-function mixedSupportKinds(folder, kinds) {
-  if (folder === "types") return kinds.has("type") && (kinds.has("constant") || kinds.has("schema"));
-  if (folder === "schemas") return kinds.has("schema") && (kinds.has("constant") || kinds.has("type"));
-  if (folder === "constants") return kinds.has("constant") && kinds.has("schema");
-  return false;
-}
-function configModuleRoot(filename, sourceRoot) {
-  const segments = segmentsOf(filename, sourceRoot);
-  if (segments[0] !== "config" || segments.length < 3) return void 0;
-  return path5.join(sourceRoot, "config", segments[1] ?? "");
-}
-function componentFolderStart(segments) {
-  if (segments[0] === "features") return 2;
-  if (segments[0] === "compositions" || segments[0] === "shared") return 1;
-  return -1;
-}
-function hasComponentBarrel(folderPath) {
-  return hasExactEntry(folderPath, "index.ts");
-}
-function componentFolderViolation(segments, sourceRoot) {
-  const start = componentFolderStart(segments);
-  if (start < 0) return void 0;
-  for (let depth = segments.length - 2; depth >= start; depth -= 1) {
-    const folder = segments[depth];
-    if (!folder || SUPPORT_FOLDERS.has(folder)) continue;
-    const folderPath = path5.join(sourceRoot, ...segments.slice(0, depth + 1));
-    const label = `src/${segments.slice(0, depth + 1).join("/")}/`;
-    if (!hasComponentOwner(folderPath, folder)) {
-      return `A folder that is not a support folder must be a component folder; add "${folder}.tsx" to ${label} or move its files into a support folder.`;
-    }
-    if (!hasComponentBarrel(folderPath)) {
-      return `A component folder must have an index.ts that named-re-exports its component; add index.ts to ${label}.`;
-    }
-  }
-  return void 0;
-}
-var applicationStructureRule = {
-  meta: {
-    schema: [],
-    type: "problem",
-    docs: {
-      description: "Enforce the repository's application, configuration, and support-folder structure."
-    }
-  },
-  create(context) {
-    const filename = path5.resolve(context.filename);
-    const sourceRoot = sourceRootOf(context);
-    const segments = segmentsOf(filename, sourceRoot);
-    if (segments.length === 0) return {};
-    const [topLevel, secondLevel] = segments;
-    if (topLevel === void 0) return {};
-    if (segments.length > 1 && topLevel !== "app" && topLevel !== "compositions" && topLevel !== "features" && topLevel !== "shared" && topLevel !== "config" && topLevel !== "locales" && !isRootSupportFolder(topLevel)) {
-      return report(
-        context,
-        `Move this source file under an allowed src/ folder; "src/${topLevel}/" is not part of the application structure.`
-      );
-    }
-    if (topLevel === "features" && segments.length >= 2 && secondLevel !== void 0) {
-      if (SUPPORT_FOLDERS.has(secondLevel)) {
-        return report(
-          context,
-          `Move this support folder inside a feature folder; "src/features/${secondLevel}/" does not belong to a feature.`
-        );
-      }
-      if (segments.length === 2) {
-        return report(context, "src/features/ must contain only feature folders, not source files.");
-      }
-    }
-    if (topLevel === "config") {
-      if (segments.length === 2) {
-        return report(
-          context,
-          "A configuration module must be a src/config/<config-name>/ folder with index.ts as its entry point."
-        );
-      }
-      const moduleRoot = configModuleRoot(filename, sourceRoot);
-      if (moduleRoot && !fs2.existsSync(path5.join(moduleRoot, "index.ts"))) {
-        return report(
-          context,
-          `Add src/config/${path5.basename(moduleRoot)}/index.ts as the configuration module entry point.`
-        );
-      }
-      if (moduleRoot && segments.length === 3 && path5.basename(filename) !== "index.ts") {
-        const kinds2 = exportedKinds(filename);
-        const expected2 = expectedSupportFolder(kinds2);
-        if (expected2 !== void 0) {
-          return report(
-            context,
-            `Move this configuration support file into src/config/${path5.basename(moduleRoot)}/${expected2}/.`
-          );
-        }
-      }
-    }
-    if (topLevel === "app" && isCodeFile(filename)) {
-      const basename = path5.basename(filename, path5.extname(filename));
-      const currentFolder2 = path5.basename(path5.dirname(filename));
-      if (SUPPORT_FOLDERS.has(currentFolder2)) {
-        return report(
-          context,
-          "src/app/ may contain routing files and framework assets, but ordinary components and support files must live outside src/app/."
-        );
-      }
-      if (!ROUTING_FILES.has(basename) && path5.extname(filename) !== ".css") {
-        return report(
-          context,
-          "src/app/ may contain routing files and framework assets, but ordinary components and support files must live outside src/app/."
-        );
-      }
-      if (ROUTING_FILES.has(basename) || path5.extname(filename) === ".css") return {};
-    }
-    const currentFolder = path5.basename(path5.dirname(filename));
-    const kinds = exportedKinds(filename);
-    const isConfigModuleRoot = topLevel === "config" && segments.length === 3 && path5.basename(filename) === "index.ts";
-    if (isConfigModuleRoot) return {};
-    if (!SUPPORT_FOLDERS.has(currentFolder)) {
-      const expected2 = expectedSupportFolder(kinds);
-      if (expected2 !== void 0 && segments.length > 2) {
-        return report(
-          context,
-          `Move this file to a ${expected2}/ folder; ${currentFolder}/ is not a recognized support folder.`
-        );
-      }
-      const violation2 = componentFolderViolation(segments, sourceRoot);
-      if (violation2 !== void 0) return report(context, violation2);
-      return {};
-    }
-    if (kinds.has("component")) {
-      return report(
-        context,
-        `A support folder must not contain a component; move ${path5.basename(filename)} beside ${currentFolder}/.`
-      );
-    }
-    if (mixedSupportKinds(currentFolder, kinds)) {
-      return report(
-        context,
-        `A ${currentFolder}/ folder must not mix unrelated support kinds; keep types, schemas, and constants in their matching folders.`
-      );
-    }
-    const expected = expectedSupportFolder(kinds);
-    if (expected !== void 0 && expected !== currentFolder) {
-      return report(
-        context,
-        `Move this file to a ${expected}/ folder; ${currentFolder}/ is reserved for ${expected === "utils" ? "utilities" : expected}.`
-      );
-    }
-    const violation = componentFolderViolation(segments, sourceRoot);
-    if (violation !== void 0) return report(context, violation);
-    return {};
-  }
-};
-
-// eslint/rules/cn-helper.ts
-var HELPER2 = "cn";
-var ENTRY2 = "pasika/cn";
-var DOC2 = "docs/pasika-adoption-guide/rules/cn-helper-rule.md";
-var DECLARED2 = `A file must not declare its own ${HELPER2}; import it from ${ENTRY2}. See ${DOC2}`;
-var IMPORTED2 = `${HELPER2} must be imported from ${ENTRY2}. See ${DOC2}`;
-function isNamed2(node, name) {
-  return node?.type === "Identifier" && node.name === name;
-}
-var cnHelperRule = {
-  meta: {
-    schema: [],
-    type: "problem",
-    docs: {
-      description: `Require ${HELPER2} to be imported from ${ENTRY2} rather than declared in the repository.`
-    }
-  },
-  create(context) {
-    const checkSource = (node) => {
-      if (!node.source || node.source.value === ENTRY2) return;
-      for (const specifier of node.specifiers) {
-        if (!isNamed2(specifier.local, HELPER2)) continue;
-        context.report({ node: specifier, message: IMPORTED2 });
-      }
-    };
-    return {
-      FunctionDeclaration(node) {
-        if (isNamed2(node.id, HELPER2)) context.report({ node, message: DECLARED2 });
-      },
-      VariableDeclarator(node) {
-        if (isNamed2(node.id.type === "Identifier" ? node.id : null, HELPER2)) {
-          context.report({ node, message: DECLARED2 });
-        }
-      },
-      ImportDeclaration: checkSource,
-      ExportNamedDeclaration: checkSource
-    };
-  }
-};
-
-// eslint/rules/component-casing.ts
-import path7 from "path";
-
 // eslint/rules/component-conventions.ts
-import path6 from "path";
+import path4 from "path";
 import ts2 from "typescript";
 var isPascalCase2 = (name) => /^[A-Z][A-Za-z0-9]*$/.test(name);
 var isHookCallName = (name) => /^use[A-Z]/.test(name);
@@ -868,7 +612,7 @@ function componentFromVariable(node) {
   };
 }
 function parseComponentInfo(text, filename, options) {
-  const sourceFile = ts2.createSourceFile(path6.resolve(filename), text, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TSX);
+  const sourceFile = ts2.createSourceFile(path4.resolve(filename), text, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TSX);
   const components = [];
   const namedExports = namedExportedLocalNames(sourceFile);
   for (const statement of sourceFile.statements) {
@@ -892,7 +636,7 @@ function parseComponentInfo(text, filename, options) {
   return components;
 }
 function findJsxReturningDeclarations(text, filename) {
-  const sourceFile = ts2.createSourceFile(path6.resolve(filename), text, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TSX);
+  const sourceFile = ts2.createSourceFile(path4.resolve(filename), text, ts2.ScriptTarget.Latest, true, ts2.ScriptKind.TSX);
   const results = [];
   const record = (identifier, body) => {
     if (isHookCallName(identifier.text) || !containsJsx(body)) return;
@@ -996,7 +740,286 @@ function findRenderedComponentMarkerPaths(component) {
   });
 }
 
+// eslint/rules/project-root.ts
+import path5 from "path";
+function sourceRootOf(context) {
+  return path5.resolve(context.cwd ?? process.cwd(), "src");
+}
+
+// eslint/rules/application-structure.ts
+var MODULE_EXTENSIONS = /* @__PURE__ */ new Set([".ts", ".tsx", ".mts", ".cts", ".js", ".jsx", ".mjs", ".cjs"]);
+var ROUTING_FILES = /* @__PURE__ */ new Set([
+  "default",
+  "error",
+  "global-error",
+  "instrumentation",
+  "layout",
+  "loading",
+  "middleware",
+  "not-found",
+  "page",
+  "route",
+  "template",
+  // File conventions Next.js requires to keep their exact names in src/app/
+  "apple-icon",
+  "icon",
+  "manifest",
+  "opengraph-image",
+  "robots",
+  "sitemap",
+  "twitter-image"
+]);
+var EXPECTED_SUPPORT_FOLDER = {
+  hook: "hooks",
+  type: "types",
+  schema: "schemas",
+  constant: "constants",
+  function: "utils"
+};
+function report(context, message) {
+  return {
+    Program(node) {
+      context.report({ node, loc: { line: 1, column: 0 }, message });
+    }
+  };
+}
+function isCodeFile(filename) {
+  return MODULE_EXTENSIONS.has(path6.extname(filename));
+}
+function isRootSupportFolder(folder) {
+  return SUPPORT_FOLDERS.has(folder);
+}
+function exportedKinds(filename) {
+  try {
+    return new Set(parseModule(filename).exports.map((moduleExport) => moduleExport.kind));
+  } catch {
+    return /* @__PURE__ */ new Set();
+  }
+}
+function expectedSupportFolder(kinds) {
+  for (const kind of ["component", "hook", "schema", "function", "constant", "type"]) {
+    if (kinds.has(kind)) return EXPECTED_SUPPORT_FOLDER[kind];
+  }
+  return void 0;
+}
+function mixedSupportKinds(folder, kinds) {
+  if (folder === "types") return kinds.has("type") && (kinds.has("constant") || kinds.has("schema"));
+  if (folder === "schemas") return kinds.has("schema") && (kinds.has("constant") || kinds.has("type"));
+  if (folder === "constants") return kinds.has("constant") && kinds.has("schema");
+  return false;
+}
+function configModuleRoot(filename, sourceRoot) {
+  const segments = segmentsOf(filename, sourceRoot);
+  if (segments[0] !== "config" || segments.length < 3) return void 0;
+  return path6.join(sourceRoot, "config", segments[1] ?? "");
+}
+function componentFolderStart(segments) {
+  if (segments[0] === "features") return 2;
+  if (segments[0] === "compositions" || segments[0] === "shared") return 1;
+  return -1;
+}
+function hasComponentBarrel(folderPath) {
+  return hasExactEntry(folderPath, "index.ts");
+}
+function componentFolderViolation(segments, sourceRoot) {
+  const start = componentFolderStart(segments);
+  if (start < 0) return void 0;
+  for (let depth = segments.length - 2; depth >= start; depth -= 1) {
+    const folder = segments[depth];
+    if (!folder || SUPPORT_FOLDERS.has(folder)) continue;
+    const folderPath = path6.join(sourceRoot, ...segments.slice(0, depth + 1));
+    const label = `src/${segments.slice(0, depth + 1).join("/")}/`;
+    if (!hasComponentOwner(folderPath, folder)) {
+      return `A folder that is not a support folder must be a component folder; add "${folder}.tsx" to ${label} or move its files into a support folder.`;
+    }
+    if (!hasComponentBarrel(folderPath)) {
+      return `A component folder must have an index.ts that named-re-exports its component; add index.ts to ${label}.`;
+    }
+  }
+  return void 0;
+}
+function componentFacadeTarget(context, filename) {
+  if (path6.extname(filename) !== ".ts" || path6.basename(filename) === "index.ts") return void 0;
+  const statements = context.sourceCode.ast.body;
+  if (statements.length === 0 || statements.some((node) => node.type !== "ExportNamedDeclaration" || !node.source)) {
+    return void 0;
+  }
+  const exports = statements.flatMap((node) => node.type === "ExportNamedDeclaration" ? node.specifiers : []);
+  const sources = statements.map((node) => node.type === "ExportNamedDeclaration" ? node.source?.value : void 0);
+  if (new Set(sources).size !== 1 || typeof sources[0] !== "string" || !sources[0].startsWith("./")) {
+    return void 0;
+  }
+  const componentFile = path6.resolve(path6.dirname(filename), `${sources[0]}.tsx`);
+  if (!fs2.existsSync(componentFile)) return void 0;
+  const components = parseComponentInfo(fs2.readFileSync(componentFile, "utf8"), componentFile);
+  return components.some(
+    ({ name }) => exports.some((specifier) => specifier.local.type === "Identifier" && specifier.local.name === name)
+  ) ? componentFile : void 0;
+}
+var applicationStructureRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Enforce the repository's application, configuration, and support-folder structure."
+    }
+  },
+  create(context) {
+    const filename = path6.resolve(context.filename);
+    const sourceRoot = sourceRootOf(context);
+    const segments = segmentsOf(filename, sourceRoot);
+    if (segments.length === 0) return {};
+    const componentTarget = componentFacadeTarget(context, filename);
+    if (componentTarget) {
+      return report(
+        context,
+        `Avoid a forwarding .ts file for a sibling component: move the implementation from ${path6.basename(componentTarget)} to ${path6.basename(filename, ".ts")}.tsx and remove the .ts facade.`
+      );
+    }
+    const [topLevel, secondLevel] = segments;
+    if (topLevel === void 0) return {};
+    if (segments.length > 1 && topLevel !== "app" && topLevel !== "compositions" && topLevel !== "features" && topLevel !== "shared" && topLevel !== "config" && topLevel !== "locales" && !isRootSupportFolder(topLevel)) {
+      return report(
+        context,
+        `Move this source file under an allowed src/ folder; "src/${topLevel}/" is not part of the application structure.`
+      );
+    }
+    if (topLevel === "features" && segments.length >= 2 && secondLevel !== void 0) {
+      if (SUPPORT_FOLDERS.has(secondLevel)) {
+        return report(
+          context,
+          `Move this support folder inside a feature folder; "src/features/${secondLevel}/" does not belong to a feature.`
+        );
+      }
+      if (segments.length === 2) {
+        return report(context, "src/features/ must contain only feature folders, not source files.");
+      }
+    }
+    if (topLevel === "config") {
+      if (segments.length === 2) {
+        return report(
+          context,
+          "A configuration module must be a src/config/<config-name>/ folder with index.ts as its entry point."
+        );
+      }
+      const moduleRoot = configModuleRoot(filename, sourceRoot);
+      if (moduleRoot && !fs2.existsSync(path6.join(moduleRoot, "index.ts"))) {
+        return report(
+          context,
+          `Add src/config/${path6.basename(moduleRoot)}/index.ts as the configuration module entry point.`
+        );
+      }
+      if (moduleRoot && segments.length === 3 && path6.basename(filename) !== "index.ts") {
+        const kinds2 = exportedKinds(filename);
+        const expected2 = expectedSupportFolder(kinds2);
+        if (expected2 !== void 0) {
+          return report(
+            context,
+            `Move this configuration support file into src/config/${path6.basename(moduleRoot)}/${expected2}/.`
+          );
+        }
+      }
+    }
+    if (topLevel === "app" && isCodeFile(filename)) {
+      const basename = path6.basename(filename, path6.extname(filename));
+      const currentFolder2 = path6.basename(path6.dirname(filename));
+      if (SUPPORT_FOLDERS.has(currentFolder2)) {
+        return report(
+          context,
+          "src/app/ may contain routing files and framework assets, but ordinary components and support files must live outside src/app/."
+        );
+      }
+      if (!ROUTING_FILES.has(basename) && path6.extname(filename) !== ".css") {
+        return report(
+          context,
+          "src/app/ may contain routing files and framework assets, but ordinary components and support files must live outside src/app/."
+        );
+      }
+      if (ROUTING_FILES.has(basename) || path6.extname(filename) === ".css") return {};
+    }
+    const currentFolder = path6.basename(path6.dirname(filename));
+    const kinds = exportedKinds(filename);
+    const isConfigModuleRoot = topLevel === "config" && segments.length === 3 && path6.basename(filename) === "index.ts";
+    if (isConfigModuleRoot) return {};
+    if (!SUPPORT_FOLDERS.has(currentFolder)) {
+      const expected2 = expectedSupportFolder(kinds);
+      if (expected2 !== void 0 && segments.length > 2) {
+        return report(
+          context,
+          `Move this file to a ${expected2}/ folder; ${currentFolder}/ is not a recognized support folder.`
+        );
+      }
+      const violation2 = componentFolderViolation(segments, sourceRoot);
+      if (violation2 !== void 0) return report(context, violation2);
+      return {};
+    }
+    if (kinds.has("component")) {
+      return report(
+        context,
+        `A support folder must not contain a component; move ${path6.basename(filename)} beside ${currentFolder}/.`
+      );
+    }
+    if (mixedSupportKinds(currentFolder, kinds)) {
+      return report(
+        context,
+        `A ${currentFolder}/ folder must not mix unrelated support kinds; keep types, schemas, and constants in their matching folders.`
+      );
+    }
+    const expected = expectedSupportFolder(kinds);
+    if (expected !== void 0 && expected !== currentFolder) {
+      return report(
+        context,
+        `Move this file to a ${expected}/ folder; ${currentFolder}/ is reserved for ${expected === "utils" ? "utilities" : expected}.`
+      );
+    }
+    const violation = componentFolderViolation(segments, sourceRoot);
+    if (violation !== void 0) return report(context, violation);
+    return {};
+  }
+};
+
+// eslint/rules/cn-helper.ts
+var HELPER2 = "cn";
+var ENTRY2 = "pasika/cn";
+var DOC2 = "docs/pasika-adoption-guide/rules/cn-helper-rule.md";
+var DECLARED2 = `A file must not declare its own ${HELPER2}; import it from ${ENTRY2}. See ${DOC2}`;
+var IMPORTED2 = `${HELPER2} must be imported from ${ENTRY2}. See ${DOC2}`;
+function isNamed2(node, name) {
+  return node?.type === "Identifier" && node.name === name;
+}
+var cnHelperRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: `Require ${HELPER2} to be imported from ${ENTRY2} rather than declared in the repository.`
+    }
+  },
+  create(context) {
+    const checkSource = (node) => {
+      if (!node.source || node.source.value === ENTRY2) return;
+      for (const specifier of node.specifiers) {
+        if (!isNamed2(specifier.local, HELPER2)) continue;
+        context.report({ node: specifier, message: IMPORTED2 });
+      }
+    };
+    return {
+      FunctionDeclaration(node) {
+        if (isNamed2(node.id, HELPER2)) context.report({ node, message: DECLARED2 });
+      },
+      VariableDeclarator(node) {
+        if (isNamed2(node.id.type === "Identifier" ? node.id : null, HELPER2)) {
+          context.report({ node, message: DECLARED2 });
+        }
+      },
+      ImportDeclaration: checkSource,
+      ExportNamedDeclaration: checkSource
+    };
+  }
+};
+
 // eslint/rules/component-casing.ts
+import path7 from "path";
 function isPascalCase3(name) {
   return /^[A-Z][A-Za-z0-9]*$/.test(name);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.10.85",
+  "version": "0.10.86",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",