pasika 0.10.33 → 0.10.35

package/dist/eslint/pasika/index.d.ts

@@ -214,7 +214,7 @@ declare const pasikaPlugin: {
         "component-placement": eslint.Rule.RuleModule;
         "component-casing": eslint.Rule.RuleModule;
         "application-structure": eslint.Rule.RuleModule;
-        "data-testid-case": eslint.Rule.RuleModule;
+        "data-component-case": eslint.Rule.RuleModule;
         "jsx-hygiene": eslint.Rule.RuleModule;
         "interactive-component": eslint.Rule.RuleModule;
         "ui-state": eslint.Rule.RuleModule;

package/dist/eslint/pasika/index.js

@@ -219,85 +219,40 @@ function findJsxReturningDeclarations(text, filename) {
   }
   return results;
 }
-function jsxTagName(element) {
-  const tagName2 = ts.isJsxElement(element) ? element.openingElement.tagName : element.tagName;
-  return ts.isIdentifier(tagName2) ? tagName2.text : void 0;
-}
-function rootFromExpression(expression) {
-  let unwrapped = expression;
-  while (ts.isParenthesizedExpression(unwrapped)) unwrapped = unwrapped.expression;
-  if (ts.isJsxSelfClosingElement(unwrapped)) {
-    const tagName2 = jsxTagName(unwrapped);
-    if (!tagName2?.startsWith(tagName2[0]?.toLowerCase() ?? "")) return void 0;
-    return { tagName: tagName2, attributes: [...unwrapped.attributes.properties] };
-  }
-  if (ts.isJsxElement(unwrapped)) {
-    const tagName2 = jsxTagName(unwrapped);
-    if (!tagName2?.startsWith(tagName2[0]?.toLowerCase() ?? "")) return void 0;
-    return { tagName: tagName2, attributes: [...unwrapped.openingElement.attributes.properties] };
-  }
-  return void 0;
-}
-function findSimpleRoot(component, _text, _filename) {
-  const declaration = component.declaration;
-  let body;
-  if (ts.isFunctionDeclaration(declaration)) body = declaration.body;
-  else if (declaration.initializer && ts.isArrowFunction(declaration.initializer)) body = declaration.initializer.body;
-  else if (declaration.initializer && ts.isFunctionExpression(declaration.initializer)) {
-    body = declaration.initializer.body;
-  }
-  if (!body) return void 0;
-  if (!ts.isBlock(body)) return rootFromExpression(body);
-  const returns = [];
-  const visit = (node) => {
-    if (node !== body && (ts.isFunctionLike(node) || ts.isClassLike(node))) return;
-    if (ts.isReturnStatement(node)) returns.push(node);
-    ts.forEachChild(node, visit);
-  };
-  visit(body);
-  const rendered = returns.filter((statement) => statement.expression?.kind !== ts.SyntaxKind.NullKeyword);
-  const roots = rendered.map(
-    (statement) => statement.expression && ts.isExpression(statement.expression) ? rootFromExpression(statement.expression) : void 0
-  ).filter((root) => root !== void 0);
-  if (roots.length !== rendered.length || roots.length === 0) return void 0;
-  const firstTag = roots[0]?.tagName;
-  if (roots.some((root) => root.tagName !== firstTag)) return void 0;
-  return roots[0];
-}
-function literalTestIds(attributes) {
+function componentMarkers(attributes) {
   return attributes.flatMap((candidate) => {
-    if (!ts.isJsxAttribute(candidate) || !ts.isIdentifier(candidate.name) || candidate.name.text !== "data-testid") {
+    if (!ts.isJsxAttribute(candidate) || !ts.isIdentifier(candidate.name) || candidate.name.text !== "data-component") {
       return [];
     }
-    return candidate.initializer && ts.isStringLiteral(candidate.initializer) ? [candidate.initializer.text] : [];
+    return candidate.initializer && ts.isStringLiteral(candidate.initializer) ? [candidate.initializer.text] : ["<dynamic>"];
   });
 }
-function combineTestIdPaths(left, right) {
+function combineComponentMarkerPaths(left, right) {
   return left.flatMap((leftPath) => right.map((rightPath) => [...leftPath, ...rightPath]));
 }
-function renderedTestIdPathsFromExpression(expression) {
+function renderedComponentMarkerPathsFromExpression(expression) {
   let unwrapped = expression;
   while (ts.isParenthesizedExpression(unwrapped)) unwrapped = unwrapped.expression;
   if (ts.isConditionalExpression(unwrapped)) {
     return [
-      ...renderedTestIdPathsFromExpression(unwrapped.whenTrue),
-      ...renderedTestIdPathsFromExpression(unwrapped.whenFalse)
+      ...renderedComponentMarkerPathsFromExpression(unwrapped.whenTrue),
+      ...renderedComponentMarkerPathsFromExpression(unwrapped.whenFalse)
     ];
   }
   if (ts.isJsxSelfClosingElement(unwrapped)) {
-    return [literalTestIds(unwrapped.attributes.properties)];
+    return [componentMarkers(unwrapped.attributes.properties)];
   }
   if (ts.isJsxElement(unwrapped)) {
-    let paths = [literalTestIds(unwrapped.openingElement.attributes.properties)];
+    let paths = [componentMarkers(unwrapped.openingElement.attributes.properties)];
     for (const child of unwrapped.children) {
       if (ts.isJsxElement(child) || ts.isJsxSelfClosingElement(child) || ts.isJsxFragment(child)) {
-        paths = combineTestIdPaths(paths, renderedTestIdPathsFromExpression(child));
+        paths = combineComponentMarkerPaths(paths, renderedComponentMarkerPathsFromExpression(child));
         continue;
       }
       if (ts.isJsxExpression(child) && child.expression) {
         const childExpression = child.expression;
         if (ts.isConditionalExpression(childExpression) || ts.isJsxElement(childExpression) || ts.isJsxSelfClosingElement(childExpression) || ts.isJsxFragment(childExpression) || ts.isParenthesizedExpression(childExpression)) {
-          paths = combineTestIdPaths(paths, renderedTestIdPathsFromExpression(childExpression));
+          paths = combineComponentMarkerPaths(paths, renderedComponentMarkerPathsFromExpression(childExpression));
         }
       }
     }
@@ -307,13 +262,13 @@ function renderedTestIdPathsFromExpression(expression) {
     let paths = [[]];
     for (const child of unwrapped.children) {
       if (ts.isJsxElement(child) || ts.isJsxSelfClosingElement(child) || ts.isJsxFragment(child)) {
-        paths = combineTestIdPaths(paths, renderedTestIdPathsFromExpression(child));
+        paths = combineComponentMarkerPaths(paths, renderedComponentMarkerPathsFromExpression(child));
         continue;
       }
       if (ts.isJsxExpression(child) && child.expression) {
         const childExpression = child.expression;
         if (ts.isConditionalExpression(childExpression) || ts.isJsxElement(childExpression) || ts.isJsxSelfClosingElement(childExpression) || ts.isJsxFragment(childExpression) || ts.isParenthesizedExpression(childExpression)) {
-          paths = combineTestIdPaths(paths, renderedTestIdPathsFromExpression(childExpression));
+          paths = combineComponentMarkerPaths(paths, renderedComponentMarkerPathsFromExpression(childExpression));
         }
       }
     }
@@ -321,7 +276,7 @@ function renderedTestIdPathsFromExpression(expression) {
   }
   return [[]];
 }
-function findRenderedTestIdPaths(component) {
+function findRenderedComponentMarkerPaths(component) {
   const declaration = component.declaration;
   let body;
   if (ts.isFunctionDeclaration(declaration)) body = declaration.body;
@@ -330,7 +285,7 @@ function findRenderedTestIdPaths(component) {
     body = declaration.initializer.body;
   }
   if (!body) return [];
-  if (!ts.isBlock(body)) return renderedTestIdPathsFromExpression(body);
+  if (!ts.isBlock(body)) return renderedComponentMarkerPathsFromExpression(body);
   const returns = [];
   const visit = (node) => {
     if (node !== body && (ts.isFunctionLike(node) || ts.isClassLike(node))) return;
@@ -341,18 +296,9 @@ function findRenderedTestIdPaths(component) {
   return returns.flatMap((statement) => {
     const expression = statement.expression;
     if (!expression || expression.kind === ts.SyntaxKind.NullKeyword) return [];
-    return renderedTestIdPathsFromExpression(expression);
+    return renderedComponentMarkerPathsFromExpression(expression);
   });
 }
-function getTestId(root) {
-  const attribute = root.attributes.find(
-    (candidate) => ts.isJsxAttribute(candidate) && ts.isIdentifier(candidate.name) && candidate.name.text === "data-testid"
-  );
-  if (!attribute) return {};
-  const value = attribute.initializer;
-  if (!value || !ts.isStringLiteral(value)) return { attribute };
-  return { value: value.text, attribute };
-}
 
 // eslint/rules/filename-case.ts
 var NEXT_ROUTING_FILES = /* @__PURE__ */ new Set([
@@ -2393,7 +2339,7 @@ var namedExportsRule = {
   }
 };
 
-// eslint/rules/data-testid-case.ts
+// eslint/rules/data-component-case.ts
 import path15 from "path";
 var NEXT_ROUTING_FILES2 = /* @__PURE__ */ new Set([
   "default",
@@ -2416,13 +2362,12 @@ var NEXT_ROUTING_FILES2 = /* @__PURE__ */ new Set([
   "sitemap",
   "twitter-image"
 ]);
-var isKebabCase3 = (value) => /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/.test(value);
-var dataTestIdCaseRule = {
+var dataComponentCaseRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Enforce data-testid casing for smart and dumb components with a single intrinsic root."
+      description: "Enforce stable data-component markers for React component surfaces."
     }
   },
   create(context) {
@@ -2430,41 +2375,29 @@ var dataTestIdCaseRule = {
     if (!filename.endsWith(".tsx")) return {};
     const base = path15.basename(filename, path15.extname(filename));
     if (NEXT_ROUTING_FILES2.has(base)) return {};
-    const text = context.sourceCode.text;
-    const components = parseComponentInfo(text, filename);
+    const components = parseComponentInfo(context.sourceCode.text, filename);
     return {
       Program(node) {
         for (const component of components) {
+          const expected = component.smart ? component.name : toKebabCase(component.name);
+          const renderedPaths = findRenderedComponentMarkerPaths(component);
+          const hasNoMarker = renderedPaths.every((values) => values.length === 0);
+          const hasStableMarker = renderedPaths.length > 0 && renderedPaths.every((values) => values.length === 1 && values[0] === expected);
           if (component.smart) {
-            const expected2 = component.name;
-            const renderedPaths = findRenderedTestIdPaths(component);
-            const hasStableAnchor = renderedPaths.length > 0 && renderedPaths.every((values) => values.filter((value2) => value2 === expected2).length === 1);
-            if (hasStableAnchor) continue;
-            const hasSingleWrongCasedAnchor = renderedPaths.length > 0 && renderedPaths.every((values) => values.length === 1 && values[0] !== expected2) && new Set(renderedPaths.map((values) => values[0])).size === 1;
-            if (hasSingleWrongCasedAnchor) {
-              context.report({
-                node,
-                message: `data-testid for smart component "${component.name}" must be PascalCase: expected "${expected2}".`
-              });
-              continue;
-            }
+            if (hasStableMarker) continue;
+            const hasSingleWrongMarker2 = renderedPaths.length > 0 && renderedPaths.every((values) => values.length === 1 && values[0] !== expected) && new Set(renderedPaths.map((values) => values[0])).size === 1;
             context.report({
               node,
-              message: `Smart component "${component.name}" must expose exactly one stable data-testid="${expected2}" anchor for itself in every rendered result. Place it on the existing DOM surface or on a child component that forwards data-testid instead of adding an artificial wrapper. See docs/next-codebase-guide/rules/smart-vs-dumb-component-rule.md`
+              message: hasSingleWrongMarker2 ? `data-component for smart component "${component.name}" must match the component name: expected "${expected}".` : `Smart component "${component.name}" must expose exactly one stable data-component="${expected}" marker in every rendered result. Place it on the existing meaningful DOM surface or forward it to the child component that renders that surface. See docs/next-codebase-guide/rules/smart-vs-dumb-component-rule.md`
             });
             continue;
           }
-          const root = findSimpleRoot(component, text, filename);
-          if (!root) continue;
-          const { value } = getTestId(root);
-          const expected = toKebabCase(component.name);
-          if (value === void 0 || value === expected) continue;
-          if (!isKebabCase3(value)) {
-            context.report({
-              node,
-              message: `data-testid for dumb component "${component.name}" must be kebab-case: expected "${expected}".`
-            });
-          }
+          if (hasNoMarker || hasStableMarker) continue;
+          const hasSingleWrongMarker = renderedPaths.length > 0 && renderedPaths.every((values) => values.length === 1 && values[0] !== expected) && new Set(renderedPaths.map((values) => values[0])).size === 1;
+          context.report({
+            node,
+            message: hasSingleWrongMarker ? `data-component for dumb component "${component.name}" must be kebab-case: expected "${expected}".` : `Dumb component "${component.name}" may omit data-component, but when present it must expose exactly one stable data-component="${expected}" marker on its meaningful surface.`
+          });
         }
       }
     };
@@ -7986,7 +7919,7 @@ var pasikaNextjsAppRules = {
   "component-placement": componentPlacementRule,
   "component-casing": componentCasingRule,
   "application-structure": applicationStructureRule,
-  "data-testid-case": dataTestIdCaseRule,
+  "data-component-case": dataComponentCaseRule,
   "jsx-hygiene": jsxHygieneRule,
   "interactive-component": interactiveComponentRule,
   "ui-state": uiStateRule,

package/dist/helpers/http-method.d.ts

@@ -0,0 +1,14 @@
+/** Standard HTTP request methods for runtime use. */
+declare enum HttpMethod {
+    Get = "GET",
+    Head = "HEAD",
+    Post = "POST",
+    Put = "PUT",
+    Delete = "DELETE",
+    Connect = "CONNECT",
+    Options = "OPTIONS",
+    Trace = "TRACE",
+    Patch = "PATCH"
+}
+
+export { HttpMethod };

package/dist/helpers/http-method.js

@@ -0,0 +1,16 @@
+// helpers/http-method.ts
+var HttpMethod = /* @__PURE__ */ ((HttpMethod2) => {
+  HttpMethod2["Get"] = "GET";
+  HttpMethod2["Head"] = "HEAD";
+  HttpMethod2["Post"] = "POST";
+  HttpMethod2["Put"] = "PUT";
+  HttpMethod2["Delete"] = "DELETE";
+  HttpMethod2["Connect"] = "CONNECT";
+  HttpMethod2["Options"] = "OPTIONS";
+  HttpMethod2["Trace"] = "TRACE";
+  HttpMethod2["Patch"] = "PATCH";
+  return HttpMethod2;
+})(HttpMethod || {});
+export {
+  HttpMethod
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.10.33",
+  "version": "0.10.35",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",
@@ -21,6 +21,10 @@
       "types": "./dist/helpers/http-error.d.ts",
       "import": "./dist/helpers/http-error.js"
     },
+    "./http-method": {
+      "types": "./dist/helpers/http-method.d.ts",
+      "import": "./dist/helpers/http-method.js"
+    },
     "./response-envelope": {
       "types": "./dist/helpers/response-envelope.d.ts",
       "import": "./dist/helpers/response-envelope.js"