pasika 0.3.4 → 0.3.6

package/dist/cli/index.js

@@ -2,12 +2,12 @@
 
 // cli/index.ts
 import { existsSync } from "fs";
-import path39 from "path";
+import path41 from "path";
 import { Command } from "commander";
 
 // enforcement/coverage.ts
 import { readdirSync as readdirSync4, readFileSync as readFileSync7, writeFileSync, statSync as statSync5 } from "fs";
-import path38 from "path";
+import path40 from "path";
 import { z as z3 } from "zod";
 
 // eslint/pasika/rules/filename-case.ts
@@ -598,8 +598,8 @@ var enforceCvaVariantPropsRule = {
         if (node.typeAnnotation?.type !== "TSTypeLiteral") return;
         for (const member of node.typeAnnotation.members ?? []) {
           if (member.type !== "TSPropertySignature") continue;
-          const keyName = member.key?.type === "Identifier" ? member.key.name : void 0;
-          if (!keyName) continue;
+          const keyName2 = member.key?.type === "Identifier" ? member.key.name : void 0;
+          if (!keyName2) continue;
           const typeAnn = member.typeAnnotation?.typeAnnotation;
           if (typeAnn?.type !== "TSUnionType") continue;
           const allStringLiterals = (typeAnn.types ?? []).every(
@@ -607,10 +607,10 @@ var enforceCvaVariantPropsRule = {
           );
           if (allStringLiterals && (typeAnn.types?.length ?? 0) >= 2) {
             for (const variantNames of cvaDefinitions.values()) {
-              if (variantNames.includes(keyName)) {
+              if (variantNames.includes(keyName2)) {
                 context.report({
                   node,
-                  message: `Variant prop "${keyName}" duplicates CVA variant values. Use VariantProps<typeof variants> instead of manually writing union types. See docs/styling-guide/rules/component-variant-rule.md`
+                  message: `Variant prop "${keyName2}" duplicates CVA variant values. Use VariantProps<typeof variants> instead of manually writing union types. See docs/styling-guide/rules/component-variant-rule.md`
                 });
                 return;
               }
@@ -1346,21 +1346,27 @@ var dataTestIdCaseRule = {
       Program(node) {
         for (const component of components) {
           const root = findSimpleRoot(component, text, filename);
-          if (!root) continue;
-          const { value } = getTestId(root);
-          const expected = component.smart ? component.name : toKebabCase(component.name);
-          if (component.smart && value === void 0) {
-            context.report({
-              node,
-              message: `Smart component "${component.name}" with one outer DOM element must set data-testid="${expected}".`
-            });
-            continue;
-          }
-          if (value === void 0 || value === expected) continue;
-          if (component.smart ? !isPascalCase5(value) || value !== expected : !isKebabCase3(value)) {
+          if (root) {
+            const { value } = getTestId(root);
+            const expected = component.smart ? component.name : toKebabCase(component.name);
+            if (component.smart && value === void 0) {
+              context.report({
+                node,
+                message: `Smart component "${component.name}" with one outer DOM element must set data-testid="${expected}".`
+              });
+              continue;
+            }
+            if (value === void 0 || value === expected) continue;
+            if (component.smart ? !isPascalCase5(value) || value !== expected : !isKebabCase3(value)) {
+              context.report({
+                node,
+                message: `data-testid for ${component.smart ? "smart" : "dumb"} component "${component.name}" must be ${component.smart ? "PascalCase" : "kebab-case"}: expected "${expected}".`
+              });
+            }
+          } else if (component.smart) {
             context.report({
               node,
-              message: `data-testid for ${component.smart ? "smart" : "dumb"} component "${component.name}" must be ${component.smart ? "PascalCase" : "kebab-case"}: expected "${expected}".`
+              message: `Smart component "${component.name}" has no single outer element; wrap its content in one outer element with data-testid="${component.name}" instead of rendering multiple roots. See docs/code-organization-guide/rules/smart-vs-dumb-component-rule.md`
             });
           }
         }
@@ -1843,14 +1849,14 @@ var cvaAppearancePropsRule = {
         if (node.typeAnnotation?.type !== "TSTypeLiteral") return;
         for (const member of node.typeAnnotation.members ?? []) {
           if (member.type !== "TSPropertySignature") continue;
-          const keyName = member.key?.type === "Identifier" ? member.key.name : void 0;
-          if (!keyName || !VISUAL_OPTION_NAMES.has(keyName)) continue;
+          const keyName2 = member.key?.type === "Identifier" ? member.key.name : void 0;
+          if (!keyName2 || !VISUAL_OPTION_NAMES.has(keyName2)) continue;
           const typeAnnotation = member.typeAnnotation?.typeAnnotation ?? member.typeAnnotation;
           if (!typeAnnotation) continue;
           if (typeAnnotation.type === "TSUnionType" || typeAnnotation.type === "TSTypeLiteral") {
             context.report({
               node,
-              message: `Visual option prop "${keyName}" must be defined through a cva() call rather than a manual union type. See docs/styling-guide/rules/component-variant-rule.md`
+              message: `Visual option prop "${keyName2}" must be defined through a cva() call rather than a manual union type. See docs/styling-guide/rules/component-variant-rule.md`
             });
           }
         }
@@ -1870,15 +1876,15 @@ function extractCvaInfo(node) {
   if (options?.type !== "ObjectExpression") return { variantNames, compoundVariants };
   for (const prop of options.properties) {
     if (prop.type !== "Property") continue;
-    const keyName = prop.key.type === "Identifier" ? prop.key.name : void 0;
-    if (keyName === "variants" && prop.value.type === "ObjectExpression") {
+    const keyName2 = prop.key.type === "Identifier" ? prop.key.name : void 0;
+    if (keyName2 === "variants" && prop.value.type === "ObjectExpression") {
       for (const vProp of prop.value.properties) {
         if (vProp.type !== "Property") continue;
         const vName = vProp.key.type === "Identifier" ? vProp.key.name : void 0;
         if (vName) variantNames.add(vName);
       }
     }
-    if (keyName === "compoundVariants" && prop.value.type === "ArrayExpression") {
+    if (keyName2 === "compoundVariants" && prop.value.type === "ArrayExpression") {
       for (const entry of prop.value.elements) {
         if (entry?.type !== "ObjectExpression") continue;
         for (const cvProp of entry.properties) {
@@ -2649,8 +2655,279 @@ var localePlacementRule = {
   }
 };
 
-// eslint/pasika/rules/shared-style-dedup.ts
+// eslint/pasika/rules/sole-state-owner.ts
 import path29 from "path";
+import ts6 from "typescript";
+function findStateHooks(node) {
+  const hooks = [];
+  const visit = (child) => {
+    if (ts6.isCallExpression(child) && ts6.isIdentifier(child.expression) && child.expression.text === "useState") {
+      if (ts6.isVariableDeclaration(child.parent)) {
+        const { name } = child.parent;
+        if (ts6.isArrayBindingPattern(name) && name.elements.length >= 2) {
+          const value = name.elements[0];
+          const updater = name.elements[1];
+          if (value && updater && ts6.isBindingElement(value) && ts6.isBindingElement(updater)) {
+            const valueName = value.name;
+            const updaterName = updater.name;
+            if (ts6.isIdentifier(valueName) && ts6.isIdentifier(updaterName)) {
+              hooks.push({ value: valueName.text, updater: updaterName.text });
+            }
+          }
+        }
+      }
+    }
+    ts6.forEachChild(child, visit);
+  };
+  visit(node);
+  return hooks;
+}
+function isHookUsage(node, hook) {
+  if (ts6.isCallExpression(node) && ts6.isIdentifier(node.expression) && node.expression.text === hook.updater) {
+    return "updater";
+  }
+  if (ts6.isIdentifier(node) && node.text === hook.value) {
+    const parent = node.parent;
+    if (ts6.isBindingElement(parent) || ts6.isPropertyAccessExpression(parent) || ts6.isShorthandPropertyAssignment(parent)) {
+      return void 0;
+    }
+    return "value";
+  }
+  return void 0;
+}
+function topLevelJsxChildren(initial) {
+  if (!initial) return void 0;
+  let expression = initial;
+  while (ts6.isParenthesizedExpression(expression)) expression = expression.expression;
+  if (ts6.isJsxFragment(expression)) {
+    const children = expression.children.filter(
+      (c) => !ts6.isJsxText(c) && !ts6.isJsxSpreadAttribute(c)
+    );
+    return { root: expression, children };
+  }
+  if (ts6.isJsxElement(expression)) {
+    const children = expression.children.filter(
+      (c) => !ts6.isJsxText(c) && !ts6.isJsxSpreadAttribute(c)
+    );
+    return { root: expression, children };
+  }
+  return void 0;
+}
+function collectUsesIn(child, hook) {
+  const positions = [];
+  let count = 0;
+  const visit = (node) => {
+    if (isHookUsage(node, hook)) {
+      positions.push(node);
+      count += 1;
+    }
+    if (ts6.isFunctionDeclaration(node) || ts6.isClassDeclaration(node)) return;
+    ts6.forEachChild(node, visit);
+  };
+  visit(child);
+  return { positions, count };
+}
+var soleStateOwnerRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require extracting a JSX part that is the sole owner of a useState hook as a named component."
+    }
+  },
+  create(context) {
+    const filename = path29.resolve(context.filename);
+    if (!filename.endsWith(".tsx") && !filename.endsWith(".jsx")) return {};
+    const text = context.sourceCode.text;
+    const components = parseComponentInfo(text, filename);
+    return {
+      Program(node) {
+        for (const component of components) {
+          const hooks = findStateHooks(component.declaration);
+          for (const hook of hooks) {
+            const result = analyzeSoleOwner(component.declaration, hook);
+            if (!result) continue;
+            const { run, totalTopLevel } = result;
+            if (run === 0 || totalTopLevel === 0) continue;
+            context.report({
+              node,
+              loc: { line: 1, column: 0 },
+              message: `Component "${component.name}" uses state "${hook.value}" in ${String(run)} contiguous top-level JSX part${run === 1 ? "" : "s"}; extract that part into a named component that owns useState instead of reading it in the parent. See docs/code-organization-guide/rules/sole-state-owner-rule.md`
+            });
+          }
+        }
+      }
+    };
+  }
+};
+function analyzeSoleOwner(declaration, hook) {
+  const body = ts6.isFunctionDeclaration(declaration) ? declaration.body : void 0;
+  if (!body || !ts6.isBlock(body)) return void 0;
+  const returns = [];
+  const visit = (node) => {
+    if (node !== body && (ts6.isFunctionLike(node) || ts6.isClassLike(node))) return;
+    if (ts6.isReturnStatement(node)) returns.push(node);
+    ts6.forEachChild(node, visit);
+  };
+  visit(body);
+  if (returns.length !== 1) return void 0;
+  const single = returns[0];
+  if (!single?.expression || !ts6.isExpression(single.expression)) return void 0;
+  const returnExpression = single.expression;
+  const root = topLevelJsxChildren(returnExpression);
+  if (!root || root.children.length === 0) return void 0;
+  const totalTopLevel = root.children.length;
+  const usagePerChild = root.children.map((child) => collectUsesIn(child, hook));
+  const outsideJsx = usesOutsideJsx(declaration, hook, root.children);
+  if (outsideJsx) return void 0;
+  const usedLabels = usagePerChild.map((u) => u.count > 0);
+  const firstUsed = usedLabels.findIndex((v) => v);
+  const lastUsed = usedLabels.lastIndexOf(true);
+  if (firstUsed === -1 || lastUsed === -1) return void 0;
+  const windowHasUnused = usedLabels.slice(firstUsed, lastUsed + 1).some((v) => !v);
+  if (windowHasUnused) return void 0;
+  const run = lastUsed - firstUsed + 1;
+  const hasOutside = firstUsed > 0 || lastUsed < totalTopLevel - 1;
+  if (!hasOutside) return void 0;
+  return { run, totalTopLevel };
+}
+function usesOutsideJsx(declaration, hook, children) {
+  let outside = false;
+  const visit = (node) => {
+    if (outside) return;
+    if (node !== declaration && (ts6.isFunctionDeclaration(node) || ts6.isClassDeclaration(node))) return;
+    if (isHookUsage(node, hook)) {
+      let current = node;
+      let isInJsxChild = false;
+      while (!ts6.isSourceFile(current)) {
+        if (children.includes(current)) {
+          isInJsxChild = true;
+          break;
+        }
+        current = current.parent;
+      }
+      if (!isInJsxChild) outside = true;
+    }
+    ts6.forEachChild(node, visit);
+  };
+  visit(declaration);
+  return outside;
+}
+
+// eslint/pasika/rules/locale-key-shape.ts
+import path30 from "path";
+var MAX_KEY_LENGTH = 30;
+var ROLE_POSTFIXES = /* @__PURE__ */ new Set([
+  "Button",
+  "Link",
+  "Dialog",
+  "AlertDialog",
+  "Tooltip",
+  "Banner",
+  "Alert",
+  "Status",
+  "Tab",
+  "TabPanel",
+  "Menu",
+  "MenuItem",
+  "MenuBar",
+  "Checkbox",
+  "Radio",
+  "RadioGroup",
+  "Switch",
+  "ComboBox",
+  "ListBox",
+  "Option",
+  "Search",
+  "SearchBox",
+  "Navigation",
+  "ProgressBar",
+  "Slider",
+  "SpinButton",
+  "TextBox",
+  "Tree",
+  "TreeItem",
+  "TreeGrid",
+  "Grid",
+  "GridCell",
+  "Feed",
+  "Log",
+  "Timer",
+  "Marquee",
+  "Region",
+  "Main",
+  "Complementary",
+  "ContentInfo",
+  "Form",
+  "Toolbar",
+  "ScrollBar"
+]);
+var CAMEL_CASE = /^[a-z][a-zA-Z0-9]*$/;
+function isLocalesFile2(filename) {
+  const segments = path30.resolve(filename).split(path30.sep);
+  const srcIdx = segments.lastIndexOf("src");
+  return srcIdx !== -1 && segments[srcIdx + 1] === "locales";
+}
+function keyName(key) {
+  if (key.type === "Identifier") return key.name;
+  if (key.type === "Literal" && typeof key.value === "string") return key.value;
+  return void 0;
+}
+function reportFor(context, node, message) {
+  context.report({ node, message });
+}
+function checkKey(context, node, name) {
+  if (!CAMEL_CASE.test(name)) {
+    reportFor(
+      context,
+      node,
+      `Locale key "${name}" must be camelCase English based on the text. See docs/code-organization-guide/rules/locales-rule.md`
+    );
+    return;
+  }
+  if (name.length <= MAX_KEY_LENGTH) return;
+  const hasRolePostfix = [...ROLE_POSTFIXES].some((role) => name.endsWith(role));
+  if (hasRolePostfix) return;
+  reportFor(
+    context,
+    node,
+    `Locale key "${name}" is longer than ${String(MAX_KEY_LENGTH)} characters, so it must describe the message's purpose instead of the text; end it with an element role such as "Button", "Link", or "Dialog" (see WAI-ARIA roles). See docs/code-organization-guide/rules/locales-rule.md`
+  );
+}
+var localeKeyShapeRule = {
+  meta: {
+    schema: [],
+    type: "problem",
+    docs: {
+      description: "Require locale keys to be camelCase, and purpose-based element roles when long."
+    }
+  },
+  create(context) {
+    if (!isLocalesFile2(context.filename)) return {};
+    function visitObject(node) {
+      for (const property of node.properties) {
+        if (property.type !== "Property") continue;
+        const name = keyName(property.key);
+        if (name === void 0) continue;
+        if (property.value.type === "ObjectExpression") {
+          visitObject(property.value);
+        } else if (property.value.type === "Literal" && typeof property.value.value === "string") {
+          checkKey(context, property, name);
+        }
+      }
+    }
+    return {
+      VariableDeclarator(node) {
+        if (node.id.type !== "Identifier" || node.id.name !== "locales") return;
+        if (node.init?.type !== "ObjectExpression") return;
+        visitObject(node.init);
+      }
+    };
+  }
+};
+
+// eslint/pasika/rules/shared-style-dedup.ts
+import path31 from "path";
 import { readFileSync as readFileSync3, statSync as statSync2 } from "fs";
 var CLASS_NAME = /className="(?<classes>[^"]+)"/g;
 var comboCache;
@@ -2691,8 +2968,8 @@ var sharedStyleDedupRule = {
     }
   },
   create(context) {
-    const sourceRoot2 = path29.resolve("src");
-    const file = path29.resolve(context.filename);
+    const sourceRoot2 = path31.resolve("src");
+    const file = path31.resolve(context.filename);
     const segments = segmentsOf(file, sourceRoot2);
     if (segments.length === 0) return {};
     const index = getProjectIndex(sourceRoot2);
@@ -2714,28 +2991,111 @@ var sharedStyleDedupRule = {
   }
 };
 
-// eslint/pasika/rules/no-eslint-disable.ts
-var noEslintDisableRule = {
+// eslint/pasika/rules/repeated-structure.ts
+function nodeKind(node) {
+  return node.type;
+}
+function isJsxNode(node) {
+  const kind = nodeKind(node);
+  return kind === "JSXElement" || kind === "JSXFragment";
+}
+function isJsxExpressionContainer(node) {
+  return node.type === "JSXExpressionContainer";
+}
+function walkJsx(current, visit) {
+  if (isJsxNode(current)) {
+    visit(current);
+    for (const child of current.children ?? []) walkJsx(child, visit);
+  } else if (isJsxExpressionContainer(current)) {
+    if (current.expression) walkJsx(current.expression, visit);
+  } else if (current.type === "ArrowFunctionExpression") {
+    walkJsx(current.body, visit);
+  } else if (current.type === "CallExpression") {
+    for (const argument of current.arguments) walkJsx(argument, visit);
+  } else if (current.type === "ConditionalExpression") {
+    walkJsx(current.consequent, visit);
+    walkJsx(current.alternate, visit);
+  } else if (current.type === "LogicalExpression") {
+    walkJsx(current.left, visit);
+    walkJsx(current.right, visit);
+  }
+}
+function signature(node) {
+  const parts = [];
+  const visit = (current) => {
+    const opening = nodeKind(current) === "JSXFragment" ? "<>" : current.openingElement?.name.name ?? "<>";
+    parts.push(opening);
+    if (nodeKind(current) === "JSXElement") {
+      const attributes = (current.openingElement?.attributes ?? []).filter((attribute) => attribute.type === "JSXAttribute").map((attribute) => {
+        const name = attribute.name?.name ?? "";
+        if (name === "className" && attribute.value?.type === "Literal" && typeof attribute.value.value === "string") {
+          return `class="${attribute.value.value.split(/\s+/).filter(Boolean).sort().join(" ")}"`;
+        }
+        return name;
+      }).sort();
+      parts.push(`[${attributes.join(",")}]`);
+    }
+    for (const child of current.children ?? []) {
+      if (isJsxNode(child)) {
+        visit(child);
+      } else if (isJsxExpressionContainer(child)) {
+        walkJsx(child, visit);
+        parts.push("{}");
+      } else {
+        parts.push("{}");
+      }
+    }
+  };
+  visit(node);
+  return parts.join("/");
+}
+function isSubstantial(node) {
+  let count = 0;
+  walkJsx(node, () => {
+    count += 1;
+  });
+  return count >= 3;
+}
+function blockChildren(node) {
+  return (node.children ?? []).filter(isJsxNode);
+}
+var repeatedStructureRule = {
   meta: {
     schema: [],
     type: "problem",
     docs: {
-      description: "Forbid eslint-disable directives."
+      description: "Require extracting a repeated block of elements as a named component."
     }
   },
   create(context) {
+    if (!context.filename.endsWith(".tsx") && !context.filename.endsWith(".jsx")) return {};
     return {
-      Program() {
-        for (const comment of context.sourceCode.getAllComments()) {
-          if (!comment.value.includes("eslint-disable")) continue;
-          if (!comment.loc) continue;
-          context.report({
-            loc: comment.loc,
-            message: "Do not use eslint-disable directives; fix the reported violation instead."
-          });
-        }
+      JSXElement(node) {
+        checkChildren(node);
+      },
+      JSXFragment(node) {
+        checkChildren(node);
       }
     };
+    function checkChildren(node) {
+      const children = blockChildren(node);
+      const seen = /* @__PURE__ */ new Map();
+      for (const child of children) {
+        const sig = signature(child);
+        const group = seen.get(sig) ?? [];
+        group.push(child);
+        seen.set(sig, group);
+      }
+      for (const [, group] of seen) {
+        if (group.length < 2) continue;
+        const first = group[0];
+        if (!first || !isSubstantial(first)) continue;
+        context.report({
+          node: first,
+          message: `The same arrangement of elements appears ${String(group.length)} times here; extract it as a named component. Different data or labels do not prevent extraction. See docs/code-organization-guide/rules/repeated-structure-rule.md`
+        });
+      }
+    }
   }
 };
 
@@ -2813,7 +3173,7 @@ var zodSchemaValidationRule = {
 };
 
 // eslint/pasika/rules/source-under-src.ts
-import path30 from "path";
+import path32 from "path";
 var NON_SOURCE_ROOT_DIRS = /* @__PURE__ */ new Set([
   ".agents",
   ".cache",
@@ -2854,14 +3214,14 @@ var sourceUnderSrcRule = {
     }
   },
   create(context) {
-    const filename = path30.resolve(context.filename);
+    const filename = path32.resolve(context.filename);
     if (!MODULE_EXTENSION.test(filename)) return {};
-    const relative = path30.relative(process.cwd(), filename).replace(/\\/g, "/");
+    const relative = path32.relative(process.cwd(), filename).replace(/\\/g, "/");
     if (relative === "src" || relative.startsWith("src/")) return {};
     const topLevel = relative.split("/")[0] ?? "";
     if (NON_SOURCE_ROOT_DIRS.has(topLevel)) return {};
     if (!relative.includes("/")) {
-      const basename = path30.basename(filename);
+      const basename = path32.basename(filename);
       if (CONFIG_FILE.test(basename) || DECLARATION_FILE.test(basename) || basename.startsWith(".")) return {};
     }
     return {
@@ -2923,7 +3283,7 @@ var docKindSuffixRule = {
 };
 
 // eslint/pasika/rules/md/title-matches-file-name.ts
-import path31 from "path";
+import path33 from "path";
 function toExpectedFileName(title) {
   return `${title.toLowerCase().replaceAll(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "")}.md`;
 }
@@ -2943,7 +3303,7 @@ var titleMatchesFileNameRule = {
         if (!filename.endsWith(".md")) return;
         const title = getTextContent(node).trim();
         const expectedFileName = toExpectedFileName(title);
-        const actualFileName = path31.basename(filename);
+        const actualFileName = path33.basename(filename);
         if (!title) {
           context.report({
             node,
@@ -3416,7 +3776,7 @@ var referenceBlockHeadingsRule = {
 };
 
 // eslint/pasika/rules/md/support-document-placement.ts
-import path32 from "path";
+import path34 from "path";
 var supportDocumentPlacementRule = {
   meta: {
     type: "problem",
@@ -3430,7 +3790,7 @@ var supportDocumentPlacementRule = {
       root(node) {
         const filename = getFilename(context);
         if (!filename.endsWith(".md")) return;
-        const parentFolder = path32.basename(path32.dirname(filename));
+        const parentFolder = path34.basename(path34.dirname(filename));
         if (filename.endsWith("-rule.md") && parentFolder !== "rules") {
           context.report({
             node,
@@ -3473,11 +3833,11 @@ var noTemplatePromptRule = {
 };
 
 // eslint/pasika/rules/md/guide-folder-entry-point.ts
-import path34 from "path";
+import path36 from "path";
 
 // eslint/pasika/rules/md/project-index.ts
 import { readdirSync as readdirSync2, readFileSync as readFileSync4, statSync as statSync3 } from "fs";
-import path33 from "path";
+import path35 from "path";
 var KIND_BY_SUFFIX = [
   ["-rule.md", "rule"],
   ["-guide.md", "guide"],
@@ -3486,7 +3846,7 @@ var KIND_BY_SUFFIX = [
 ];
 function listMarkdownFiles(dir) {
   return readdirSync2(dir).flatMap((entry) => {
-    const entryPath = path33.join(dir, entry);
+    const entryPath = path35.join(dir, entry);
     if (statSync3(entryPath).isDirectory()) {
       return entry.startsWith("_") ? [] : listMarkdownFiles(entryPath);
     }
@@ -3504,11 +3864,11 @@ function getProjectDocs(docsRoot) {
   if (cached) return cached;
   const files = listMarkdownFiles(docsRoot);
   const docs = files.sort((a, b) => a.localeCompare(b)).map((filePath) => {
-    const fileName = path33.basename(filePath);
+    const fileName = path35.basename(filePath);
     const kind = KIND_BY_SUFFIX.find(([suffix]) => fileName.endsWith(suffix))?.[1];
     return {
       filePath,
-      doc: path33.relative(docsRoot, filePath).split(path33.sep).join("/"),
+      doc: path35.relative(docsRoot, filePath).split(path35.sep).join("/"),
       fileName,
       kind,
       title: extractTitle(filePath)
@@ -3518,12 +3878,12 @@ function getProjectDocs(docsRoot) {
   return docs;
 }
 function findDocsRoot(filePath) {
-  let dir = path33.dirname(filePath);
+  let dir = path35.dirname(filePath);
   for (; ; ) {
-    if (path33.basename(dir) === "docs" && statSync3(dir).isDirectory()) {
+    if (path35.basename(dir) === "docs" && statSync3(dir).isDirectory()) {
       return dir;
     }
-    const parent = path33.dirname(dir);
+    const parent = path35.dirname(dir);
     if (parent === dir) return void 0;
     dir = parent;
   }
@@ -3547,13 +3907,13 @@ var guideFolderEntryPointRule = {
         if (!docsRoot) return;
         const docs = getProjectDocs(docsRoot);
         const guideFolders = new Set(
-          docs.filter((doc) => ["rules", "references"].includes(path34.basename(path34.dirname(doc.filePath)))).map((doc) => path34.dirname(path34.dirname(doc.filePath))).filter((folder) => path34.resolve(folder) !== path34.resolve(docsRoot))
+          docs.filter((doc) => ["rules", "references"].includes(path36.basename(path36.dirname(doc.filePath)))).map((doc) => path36.dirname(path36.dirname(doc.filePath))).filter((folder) => path36.resolve(folder) !== path36.resolve(docsRoot))
         );
-        const currentDir = path34.dirname(filename);
+        const currentDir = path36.dirname(filename);
         if (guideFolders.has(currentDir)) {
-          const expectedEntryPoint = `${path34.basename(currentDir)}.md`;
+          const expectedEntryPoint = `${path36.basename(currentDir)}.md`;
           const hasEntryPoint = docs.some(
-            (doc) => doc.kind === "guide" && path34.dirname(doc.filePath) === currentDir && doc.fileName === expectedEntryPoint
+            (doc) => doc.kind === "guide" && path36.dirname(doc.filePath) === currentDir && doc.fileName === expectedEntryPoint
           );
           if (!hasEntryPoint) {
             context.report({
@@ -3610,6 +3970,39 @@ var rfcOnlyInBulletsRule = {
   }
 };
 
+// eslint/pasika/rules/md/rfc-keyword-in-every-bullet.ts
+function checkBullets(node, context) {
+  if (node.type === "listItem" && !containsRfcKeyword(getTextContent(node))) {
+    context.report({
+      node,
+      message: "bullet point contains no RFC 2119 keyword"
+    });
+  }
+  if ("children" in node) {
+    for (const child of node.children) {
+      checkBullets(child, context);
+    }
+  }
+}
+var rfcKeywordInEveryBulletRule = {
+  meta: {
+    type: "problem",
+    docs: {
+      description: "Every bullet in a rule or policy document must contain an RFC 2119 keyword.",
+      recommended: true
+    }
+  },
+  create(context) {
+    return {
+      root(node) {
+        const filename = getFilename(context);
+        if (!filename.endsWith("-rule.md") && !filename.endsWith("-policy.md")) return;
+        checkBullets(node, context);
+      }
+    };
+  }
+};
+
 // eslint/pasika/rules/md/policy-subject-headings.ts
 var policySubjectHeadingsRule = {
   meta: {
@@ -3745,7 +4138,7 @@ var noNestedHowToRule = {
 
 // eslint/pasika/rules/md/glossary-term-linking.ts
 import { readFileSync as readFileSync5 } from "fs";
-import path35 from "path";
+import path37 from "path";
 function extractGlossaryTerms(filePath) {
   const content = readFileSync5(filePath, "utf8");
   const terms = [];
@@ -3799,9 +4192,9 @@ var glossaryTermLinkingRule = {
         const docsRoot = findDocsRoot(filename);
         if (!docsRoot) return;
         const docs = getProjectDocs(docsRoot);
-        const guideDir = path35.dirname(filename);
+        const guideDir = path37.dirname(filename);
         const guideReferences = docs.filter(
-          (doc) => doc.kind === "reference" && path35.dirname(doc.filePath) === guideDir
+          (doc) => doc.kind === "reference" && path37.dirname(doc.filePath) === guideDir
         );
         if (guideReferences.length === 0) return;
         const glossaryTerms = [];
@@ -3845,6 +4238,7 @@ var mdRules = {
   "no-template-prompt": noTemplatePromptRule,
   "guide-folder-entry-point": guideFolderEntryPointRule,
   "rfc-only-in-bullets": rfcOnlyInBulletsRule,
+  "rfc-keyword-in-every-bullet": rfcKeywordInEveryBulletRule,
   "policy-subject-headings": policySubjectHeadingsRule,
   "guide-link-anchors": guideLinkAnchorsRule,
   "no-nested-how-to": noNestedHowToRule,
@@ -3874,7 +4268,7 @@ function atrules(node) {
 function atrulesNamed(node, name) {
   return atrules(node).filter((candidate) => candidate.type === "Atrule" && candidate.name === name);
 }
-function blockChildren(node) {
+function blockChildren2(node) {
   if (!node) return [];
   if (!("block" in node) || !node.block) return [];
   return node.block.children;
@@ -3921,7 +4315,7 @@ var themeResetRule = {
     return {
       "StyleSheet:exit"(node) {
         const resetFound = atrulesNamed(node, "theme").some(
-          (theme) => blockChildren(theme).some((child) => {
+          (theme) => blockChildren2(theme).some((child) => {
             if (child.type === "Declaration") return child.property.startsWith("--*");
             if (child.type === "Raw") return child.value.includes("--*: initial");
             return false;
@@ -3952,7 +4346,7 @@ var rootVariablesRule = {
       "StyleSheet:exit"(node) {
         const hasRootVars = rules(node).some((rule) => {
           if (!selectorNames(rule).includes("root")) return false;
-          return blockChildren(rule).some((child) => child.type === "Declaration");
+          return blockChildren2(rule).some((child) => child.type === "Declaration");
         });
         if (!hasRootVars) {
           context.report({
@@ -3961,7 +4355,7 @@ var rootVariablesRule = {
           });
         }
         const referencingThemes = atrulesNamed(node, "theme").filter(
-          (theme) => blockChildren(theme).some((child) => {
+          (theme) => blockChildren2(theme).some((child) => {
             if (child.type === "Raw") return child.value.includes("var(");
             if (child.type === "Declaration") return JSON.stringify(child.value).includes("var(");
             return false;
@@ -3995,9 +4389,9 @@ var applyUsageRule = {
       "StyleSheet:exit"(node) {
         const layers = node.children.filter((child) => child.type === "Atrule" && child.name === "layer");
         for (const layer of layers) {
-          for (const child of blockChildren(layer)) {
+          for (const child of blockChildren2(layer)) {
             if (child.type !== "Rule") continue;
-            for (const declaration of blockChildren(child)) {
+            for (const declaration of blockChildren2(child)) {
               if (declaration.type !== "Declaration") continue;
               context.report({
                 node: declaration,
@@ -4027,10 +4421,10 @@ var baseLayerPairRule = {
         if (baseLayers.length === 0) return;
         const applied = [];
         for (const layer of baseLayers) {
-          for (const child of blockChildren(layer)) {
+          for (const child of blockChildren2(layer)) {
             if (child.type !== "Rule") continue;
             if (!selectorNames(child).includes("body")) continue;
-            for (const declaration of blockChildren(child)) {
+            for (const declaration of blockChildren2(child)) {
               if (declaration.type !== "Atrule" || declaration.name !== "apply") continue;
               applied.push(...preludeIdentifiers(declaration));
             }
@@ -4155,7 +4549,7 @@ var customUtilityApplyRule = {
     return {
       "StyleSheet:exit"(node) {
         for (const utility of atrulesNamed(node, "utility")) {
-          for (const child of blockChildren(utility)) {
+          for (const child of blockChildren2(utility)) {
             if (child.type === "Atrule" && child.name === "apply") continue;
             if (child.type === "Declaration") {
               context.report({
@@ -4227,7 +4621,7 @@ var themeVariableNamespaceRule = {
       "StyleSheet:exit"(node) {
         const namespaces = /* @__PURE__ */ new Set();
         for (const theme of atrulesNamed(node, "theme")) {
-          for (const child of blockChildren(theme)) {
+          for (const child of blockChildren2(theme)) {
             if (child.type !== "Declaration") continue;
             const segments = child.property.replace(/^--/, "").split("-");
             if (segments[0]) namespaces.add(segments[0]);
@@ -4297,43 +4691,8 @@ var cssRules = {
   "global-css-location": globalCssLocationRule
 };
 
-// eslint/pasika/rules/json/no-cache-flag.ts
-function memberName(member) {
-  return member.name.type === "String" ? member.name.value : member.name.name;
-}
-var noCacheFlagRule = {
-  meta: {
-    schema: [],
-    type: "problem",
-    docs: {
-      description: "Require lint scripts to not pass ESLint's --cache flag."
-    }
-  },
-  create(context) {
-    return {
-      Document(node) {
-        const root = node.body;
-        if (root.type !== "Object") return;
-        const scripts = root.members.find((member) => memberName(member) === "scripts");
-        if (scripts?.value.type !== "Object") return;
-        for (const member of scripts.value.members) {
-          const name = memberName(member);
-          if (name !== "lint" && name !== "fix") continue;
-          if (member.value.type !== "String") continue;
-          if (member.value.value.includes("--cache")) {
-            context.report({
-              node: member,
-              message: "Lint scripts must not pass ESLint's --cache flag because cross-file rules require every file in the run."
-            });
-          }
-        }
-      }
-    };
-  }
-};
-
 // eslint/pasika/rules/json/no-vulyk-dependency.ts
-function memberName2(member) {
+function memberName(member) {
   return member.name.type === "String" ? member.name.value : member.name.name;
 }
 var noVulykDependencyRule = {
@@ -4350,9 +4709,9 @@ var noVulykDependencyRule = {
         const root = node.body;
         if (root.type !== "Object") return;
         for (const key of ["dependencies", "devDependencies"]) {
-          const section = root.members.find((member) => memberName2(member) === key);
+          const section = root.members.find((member) => memberName(member) === key);
           if (section?.value.type !== "Object") continue;
-          const vulyk = section.value.members.find((member) => memberName2(member) === "vulyk");
+          const vulyk = section.value.members.find((member) => memberName(member) === "vulyk");
           if (vulyk) {
             context.report({
               node: vulyk,
@@ -4367,7 +4726,6 @@ var noVulykDependencyRule = {
 
 // eslint/pasika/rules/json/index.ts
 var jsonRules = {
-  "no-cache-flag": noCacheFlagRule,
   "no-vulyk-dependency": noVulykDependencyRule
 };
 
@@ -4406,8 +4764,10 @@ var pasikaRules = {
   "stay-flat": stayFlatRule,
   "type-extraction": typeExtractionRule,
   "locale-placement": localePlacementRule,
+  "sole-state-owner": soleStateOwnerRule,
+  "locale-key-shape": localeKeyShapeRule,
   "shared-style-dedup": sharedStyleDedupRule,
-  "no-eslint-disable": noEslintDisableRule,
+  "repeated-structure": repeatedStructureRule,
   "zod-schema-validation": zodSchemaValidationRule,
   "source-under-src": sourceUnderSrcRule
 };
@@ -4435,7 +4795,7 @@ function hashRequirement(canonicalText) {
 
 // enforcement/parse-docs.ts
 import { readdirSync as readdirSync3, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
-import path36 from "path";
+import path38 from "path";
 var KIND_BY_SUFFIX2 = [
   ["-rule.md", "rule"],
   ["-guide.md", "guide"],
@@ -4445,7 +4805,7 @@ var KIND_BY_SUFFIX2 = [
 var RFC_2119 = /\b(?<keyword>MUST NOT|MUST|SHOULD NOT|SHOULD|MAY)\b/;
 function listMarkdownFiles2(dir) {
   return readdirSync3(dir).flatMap((entry) => {
-    const entryPath = path36.join(dir, entry);
+    const entryPath = path38.join(dir, entry);
     if (statSync4(entryPath).isDirectory()) {
       return entry.startsWith("_") ? [] : listMarkdownFiles2(entryPath);
     }
@@ -4471,7 +4831,7 @@ function parseDoc(filePath, docsRoot) {
   const sourceLines = body.split("\n");
   const prose = toProse(body, "$<content>");
   const proseWithoutCode = toProse(body, "");
-  const fileName = path36.basename(filePath);
+  const fileName = path38.basename(filePath);
   const kind = KIND_BY_SUFFIX2.find(([suffix]) => fileName.endsWith(suffix))?.[1];
   const requirements = [];
   const steps = [];
@@ -4501,7 +4861,7 @@ function parseDoc(filePath, docsRoot) {
   const overview = prose.slice(1).find((line) => line.trim() !== "" && !line.startsWith("#"));
   return {
     filePath,
-    doc: path36.relative(docsRoot, filePath).split(path36.sep).join("/"),
+    doc: path38.relative(docsRoot, filePath).split(path38.sep).join("/"),
     fileName,
     kind,
     title,
@@ -4521,7 +4881,7 @@ function parseDocs(docsRoot) {
 
 // enforcement/doctor.ts
 import fs4 from "fs";
-import path37 from "path";
+import path39 from "path";
 import { z } from "zod";
 var doctorCheckRefs = [
   "pasika/pasika-installed",
@@ -4565,7 +4925,7 @@ function checkFrameworkPackages(pkg) {
 }
 function checkSourceRoot(cwd) {
   const findings = [];
-  const srcDir = path37.join(cwd, "src");
+  const srcDir = path39.join(cwd, "src");
   if (!fs4.existsSync(srcDir)) {
     findings.push({
       check: "source-under-src",
@@ -4591,14 +4951,14 @@ function checkSourceRoot(cwd) {
 function findGlobalStylesheet(cwd) {
   const candidates = ["src/app/globals.css", "src/styles/globals.css", "src/globals.css"];
   for (const candidate of candidates) {
-    const full = path37.join(cwd, candidate);
+    const full = path39.join(cwd, candidate);
     if (fs4.existsSync(full)) return full;
   }
-  const srcDir = path37.join(cwd, "src");
+  const srcDir = path39.join(cwd, "src");
   if (!fs4.existsSync(srcDir)) return void 0;
   const walk = (dir) => {
     for (const entry of fs4.readdirSync(dir, { withFileTypes: true })) {
-      const full = path37.join(dir, entry.name);
+      const full = path39.join(dir, entry.name);
       if (entry.isDirectory() && entry.name !== "node_modules" && entry.name !== ".next") {
         const found = walk(full);
         if (found) return found;
@@ -4629,7 +4989,7 @@ function checkGlobalStylesheet(cwd) {
 function checkConfigBaseline(cwd) {
   const findings = [];
   const eslintConfigs = ["eslint.config.ts", "eslint.config.mjs", "eslint.config.js"];
-  const eslintConfig = eslintConfigs.find((name) => fs4.existsSync(path37.join(cwd, name)));
+  const eslintConfig = eslintConfigs.find((name) => fs4.existsSync(path39.join(cwd, name)));
   if (!eslintConfig) {
     findings.push({
       check: "config-baseline",
@@ -4637,7 +4997,7 @@ function checkConfigBaseline(cwd) {
       severity: "error"
     });
   } else {
-    const content = fs4.readFileSync(path37.join(cwd, eslintConfig), "utf8");
+    const content = fs4.readFileSync(path39.join(cwd, eslintConfig), "utf8");
     if (!content.includes("zirka")) {
       findings.push({
         check: "config-baseline",
@@ -4646,7 +5006,7 @@ function checkConfigBaseline(cwd) {
       });
     }
   }
-  if (!fs4.existsSync(path37.join(cwd, "tsconfig.json"))) {
+  if (!fs4.existsSync(path39.join(cwd, "tsconfig.json"))) {
     findings.push({
       check: "config-baseline",
       message: "No tsconfig.json found. Create one extending the pasika baseline.",
@@ -4657,31 +5017,29 @@ function checkConfigBaseline(cwd) {
 }
 function checkManagedFiles(cwd) {
   const findings = [];
-  const vulykDir = path37.join(cwd, ".vulyk");
-  if (!fs4.existsSync(vulykDir)) return findings;
-  const manifestPath = path37.join(vulykDir, "manifest.json");
-  if (!fs4.existsSync(manifestPath)) return findings;
+  const configPath = path39.join(cwd, "vulyk.config.ts");
+  if (!fs4.existsSync(configPath)) return findings;
+  const lockPath = path39.join(cwd, "vulyk.lock.json");
+  if (!fs4.existsSync(lockPath)) return findings;
   try {
-    const manifestEntrySchema = z.looseObject({
-      targets: z.array(z.string()).optional()
-    });
-    const manifestSchema = z.record(z.string(), manifestEntrySchema);
-    const result = manifestSchema.safeParse(JSON.parse(fs4.readFileSync(manifestPath, "utf8")));
-    if (!result.success) return findings;
-    for (const [, entry] of Object.entries(result.data)) {
-      const targets = entry.targets ?? [];
-      for (const target of targets) {
-        const targetPath = path37.join(cwd, target);
-        if (fs4.existsSync(targetPath)) {
-          const stat = fs4.statSync(targetPath);
-          const vulykStat = fs4.statSync(manifestPath);
-          if (stat.mtimeMs > vulykStat.mtimeMs + 1e3) {
-            findings.push({
-              check: "managed-file-edit",
-              message: `File "${target}" appears to have been edited after vulyk wrote it. Use vulyk commands to update managed files.`,
-              severity: "warning"
-            });
-          }
+    const configMtime = fs4.statSync(configPath).mtimeMs;
+    const lockMtime = fs4.statSync(lockPath).mtimeMs;
+    const referenceMtime = Math.max(configMtime, lockMtime);
+    const defaultOutputDirs = ["docs/external"];
+    for (const dir of defaultOutputDirs) {
+      const dirPath = path39.join(cwd, dir);
+      if (!fs4.existsSync(dirPath)) continue;
+      const entries = fs4.readdirSync(dirPath, { withFileTypes: true });
+      for (const entry of entries) {
+        if (!entry.isFile()) continue;
+        const filePath = path39.join(dirPath, entry.name);
+        const stat = fs4.statSync(filePath);
+        if (stat.mtimeMs > referenceMtime + 1e3) {
+          findings.push({
+            check: "managed-file-edit",
+            message: `File "${dir}/${entry.name}" appears to have been edited after vulyk wrote it. Use vulyk commands to update managed files.`,
+            severity: "warning"
+          });
         }
       }
     }
@@ -4690,7 +5048,7 @@ function checkManagedFiles(cwd) {
   return findings;
 }
 function runDoctor(cwd) {
-  const pkgPath = path37.join(cwd, "package.json");
+  const pkgPath = path39.join(cwd, "package.json");
   const pkg = readPackageJson(pkgPath);
   return [
     ...checkFrameworkPackages(pkg),
@@ -4738,7 +5096,7 @@ function collectTestTitles(rulesDir) {
   const titles = /* @__PURE__ */ new Set();
   const visit = (dir) => {
     for (const entry of readdirSync4(dir)) {
-      const entryPath = path38.join(dir, entry);
+      const entryPath = path40.join(dir, entry);
       if (statSync5(entryPath).isDirectory()) {
         visit(entryPath);
         continue;
@@ -4748,7 +5106,7 @@ function collectTestTitles(rulesDir) {
       const titlePattern = /\b(?:describe|test|it)\(\s*(?:"(?<double>(?:[^"\\]|\\.)*)"|'(?<single>(?:[^'\\]|\\.)*)')/g;
       for (const match of body.matchAll(titlePattern)) {
         const title = match.groups?.double ?? match.groups?.single ?? "";
-        titles.add(title.replaceAll('\\\\"', '"').replaceAll("\\\\'", "'"));
+        titles.add(title.replaceAll("`", "").replaceAll('\\\\"', '"').replaceAll("\\\\'", "'"));
       }
     }
   };
@@ -4921,12 +5279,12 @@ function json(data) {
 }
 
 // cli/index.ts
-var REGISTRY_RELATIVE_PATH = path39.join("enforcement", "registry.json");
+var REGISTRY_RELATIVE_PATH = path41.join("enforcement", "registry.json");
 function findRegistryRoot(startDir) {
-  let dir = path39.resolve(startDir);
+  let dir = path41.resolve(startDir);
   for (; ; ) {
-    if (existsSync(path39.join(dir, REGISTRY_RELATIVE_PATH))) return dir;
-    const parent = path39.dirname(dir);
+    if (existsSync(path41.join(dir, REGISTRY_RELATIVE_PATH))) return dir;
+    const parent = path41.dirname(dir);
     if (parent === dir) return void 0;
     dir = parent;
   }
@@ -4950,12 +5308,12 @@ program.command("coverage").description("Check that every documented requirement
       error(`No ${REGISTRY_RELATIVE_PATH} found in this directory or any parent.`);
       process.exit(1);
     }
-    const docsRoot = path39.join(root, "docs");
+    const docsRoot = path41.join(root, "docs");
     if (!existsSync(docsRoot)) {
       error(`No documentation folder at ${docsRoot}. Run coverage inside the pasika repository.`);
       process.exit(1);
     }
-    const registryPath = path39.join(root, REGISTRY_RELATIVE_PATH);
+    const registryPath = path41.join(root, REGISTRY_RELATIVE_PATH);
     if (options.classify !== void 0) {
       try {
         const result = classifyRequirement({
@@ -4974,7 +5332,7 @@ program.command("coverage").description("Check that every documented requirement
     const report3 = buildCoverageReport({
       docsRoot,
       registry: readRegistry(registryPath),
-      rulesDir: path39.join(root, "eslint", "pasika", "rules")
+      rulesDir: path41.join(root, "eslint", "pasika", "rules")
     });
     if (options.json) {
       json(report3);