pasika 0.6.0 → 0.6.1

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

@@ -98,6 +98,7 @@ declare const documentationRules: {
     "no-nested-how-to": _eslint_markdown.MarkdownRuleDefinition;
     "glossary-term-linking": _eslint_markdown.MarkdownRuleDefinition;
     "guide-mentions-documents": _eslint_markdown.MarkdownRuleDefinition;
+    "guide-section-shape": _eslint_markdown.MarkdownRuleDefinition;
 };
 
 declare const tailwindRules: {
@@ -186,6 +187,7 @@ declare const pasikaPlugin: {
         "no-nested-how-to": _eslint_markdown.MarkdownRuleDefinition;
         "glossary-term-linking": _eslint_markdown.MarkdownRuleDefinition;
         "guide-mentions-documents": _eslint_markdown.MarkdownRuleDefinition;
+        "guide-section-shape": _eslint_markdown.MarkdownRuleDefinition;
         "filename-case": eslint.Rule.RuleModule;
         "import-boundaries": eslint.Rule.RuleModule;
         "named-exports": eslint.Rule.RuleModule;

package/dist/eslint/pasika/index.js

@@ -174,7 +174,9 @@ function findSimpleRoot(component, _text, _filename) {
   };
   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);
+  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;
@@ -2302,7 +2304,17 @@ var NEXT_ROUTING_FILES3 = /* @__PURE__ */ new Set([
   "sitemap",
   "twitter-image"
 ]);
-var INTERACTIVE_ATTRIBUTES = /* @__PURE__ */ new Set(["onClick", "onChange", "onSubmit", "href", "onKeyDown", "onKeyUp", "onFocus", "onBlur", "htmlFor"]);
+var INTERACTIVE_ATTRIBUTES = /* @__PURE__ */ new Set([
+  "onClick",
+  "onChange",
+  "onSubmit",
+  "href",
+  "onKeyDown",
+  "onKeyUp",
+  "onFocus",
+  "onBlur",
+  "htmlFor"
+]);
 function tagName(node) {
   const name = node.openingElement?.name;
   if (name?.type !== "JSXIdentifier") return void 0;
@@ -2375,7 +2387,9 @@ function isDecorative(node) {
   return !meaningfulText && !isContentElement(name);
 }
 function isContentElement(name) {
-  return /^(?:h[1-6]|p|li|dt|dd|blockquote|pre|code|figcaption|caption|th|td|form|fieldset|select|textarea)$/.test(name);
+  return /^(?:h[1-6]|p|li|dt|dd|blockquote|pre|code|figcaption|caption|th|td|form|fieldset|select|textarea)$/.test(
+    name
+  );
 }
 function isSoleContentOfWrapper(node) {
   const parent = node.parent;
@@ -4153,7 +4167,7 @@ var overviewRule = {
   meta: {
     type: "problem",
     docs: {
-      description: "Overview must exist, contain at most two sentences, and not link to other documents.",
+      description: "Required documentation overviews must exist, contain at most two sentences, and not link to other documents.",
       recommended: true
     }
   },
@@ -4196,6 +4210,41 @@ var overviewRule = {
         if (!found) {
           context.report({ node, message: "no overview follows the title" });
         }
+        const validateHeadedOverview = (heading, index, label) => {
+          const overview = node.children[index + 1];
+          if (overview?.type !== "paragraph") {
+            context.report({
+              node: heading,
+              message: `no overview follows ${label}`
+            });
+            return;
+          }
+          if (containsLink(overview)) {
+            context.report({
+              node: overview,
+              message: `overview of ${label} links another document`
+            });
+          }
+          const sectionSentenceCount = countSentences(getTextContent(overview).trim());
+          if (sectionSentenceCount > 2) {
+            context.report({
+              node: overview,
+              message: `overview of ${label} uses ${String(sectionSentenceCount)} sentences, at most two are allowed`
+            });
+          }
+        };
+        const isGuide = filename.endsWith("-guide.md");
+        const isReference = filename.endsWith("-reference.md");
+        if (!isGuide && !isReference) return;
+        for (const [index, child] of node.children.entries()) {
+          if (child.type !== "heading" || child.depth === 1) continue;
+          const title = getTextContent(child).trim();
+          if (isGuide && child.depth === 2 && /^How To \S/.test(title)) {
+            validateHeadedOverview(child, index, `guide section "${title}"`);
+          } else if (isReference) {
+            validateHeadedOverview(child, index, `reference block "${title}"`);
+          }
+        }
       }
     };
   }
@@ -5049,6 +5098,56 @@ var guideMentionsDocumentsRule = {
   }
 };
 
+// eslint/rules/documentation/guide-section-shape.ts
+var guideSectionShapeRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Guide sections use How To headings, an overview, and numbered steps.",
+      recommended: true
+    }
+  },
+  create(context) {
+    return {
+      root(node) {
+        if (!getFilename(context).endsWith("-guide.md")) return;
+        const sections = [];
+        for (const [index, child] of node.children.entries()) {
+          if (child.type !== "heading" || child.depth === 1) continue;
+          sections.push({ heading: child, index, title: getTextContent(child).trim() });
+        }
+        if (sections.length === 0) {
+          context.report({ node, message: "guide must contain at least one How To section" });
+          return;
+        }
+        for (const [sectionIndex, section] of sections.entries()) {
+          if (section.heading.depth !== 2) {
+            context.report({
+              node: section.heading,
+              message: `guide section heading "${section.title}" must be level two`
+            });
+          }
+          if (!/^How To \S/.test(section.title)) {
+            context.report({
+              node: section.heading,
+              message: `guide section heading "${section.title}" must start with "How To "`
+            });
+          }
+          const nextSection = sections[sectionIndex + 1];
+          const content = node.children.slice(section.index + 1, nextSection?.index ?? node.children.length);
+          const hasOverviewThenNumberedList = content.length === 2 && content[0]?.type === "paragraph" && content[1]?.type === "list" && content[1].ordered === true;
+          if (!hasOverviewThenNumberedList) {
+            context.report({
+              node: section.heading,
+              message: `guide section "${section.title}" must consist of its overview followed by one numbered list`
+            });
+          }
+        }
+      }
+    };
+  }
+};
+
 // eslint/rules/documentation/index.ts
 var documentationRules = {
   "doc-kind-suffix": docKindSuffixRule,
@@ -5073,7 +5172,8 @@ var documentationRules = {
   "guide-link-anchors": guideLinkAnchorsRule,
   "no-nested-how-to": noNestedHowToRule,
   "glossary-term-linking": glossaryTermLinkingRule,
-  "guide-mentions-documents": guideMentionsDocumentsRule
+  "guide-mentions-documents": guideMentionsDocumentsRule,
+  "guide-section-shape": guideSectionShapeRule
 };
 
 // eslint/rules/tailwind/helpers.ts
@@ -6374,9 +6474,7 @@ var tailwindStructureRules = {
   },
   language: "css/css",
   languageOptions: { tolerant: true },
-  rules: Object.fromEntries(
-    tailwindRuleIds.filter((id) => id !== "pasika/css-entry-point").map((id) => [id, "error"])
-  )
+  rules: Object.fromEntries(tailwindRuleIds.filter((id) => id !== "pasika/css-entry-point").map((id) => [id, "error"]))
 };
 var tailwindImportGraph = {
   files: ["src/**/*.css"],
@@ -6424,11 +6522,7 @@ var documentationConfig = {
   language: "markdown/gfm",
   rules: Object.fromEntries(documentationRuleIds.map((id) => [id, "error"]))
 };
-var pasikaApp = [
-  pasikaAppPackageJsonConfig,
-  zirkaConfig,
-  documentationConfig
-];
+var pasikaApp = [pasikaAppPackageJsonConfig, zirkaConfig, documentationConfig];
 var pasikaNextjsAppWithDiagnostic = (preset) => {
   let checked = false;
   return new Proxy(preset, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pasika",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Reusable agent setup package",
   "repository": {
     "type": "git",
@@ -62,7 +62,7 @@
     "tsx": "4.23.12",
     "typescript": "6.0.3",
     "vitest": "5.0.0",
-    "zirka": "0.0.48",
+    "zirka": "0.0.65",
     "zod": "4.4.3"
   },
   "peerDependencies": {