uilint-eslint 0.2.9 → 0.2.11

package/dist/{chunk-IL6RYCMD.js → chunk-6EI7LWV5.js}

@@ -3,8 +3,12 @@ import { ESLintUtils } from "@typescript-eslint/utils";
 var createRule = ESLintUtils.RuleCreator(
   (name) => `https://github.com/peter-suggate/uilint/blob/main/packages/uilint-eslint/docs/rules/${name}.md`
 );
+function defineRuleMeta(meta) {
+  return meta;
+}
 
 export {
-  createRule
+  createRule,
+  defineRuleMeta
 };
-//# sourceMappingURL=chunk-IL6RYCMD.js.map
+//# sourceMappingURL=chunk-6EI7LWV5.js.map

package/dist/chunk-6EI7LWV5.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/create-rule.ts"],"sourcesContent":["/**\n * Rule creation helper using @typescript-eslint/utils\n */\n\nimport { ESLintUtils } from \"@typescript-eslint/utils\";\n\nexport const createRule = ESLintUtils.RuleCreator(\n  (name) =>\n    `https://github.com/peter-suggate/uilint/blob/main/packages/uilint-eslint/docs/rules/${name}.md`\n);\n\n/**\n * Schema for prompting user to configure a rule option in the CLI\n */\nexport interface OptionFieldSchema {\n  /** Field name in the options object */\n  key: string;\n  /** Display label for the prompt */\n  label: string;\n  /** Prompt type */\n  type: \"text\" | \"number\" | \"boolean\" | \"select\" | \"multiselect\";\n  /** Default value */\n  defaultValue: unknown;\n  /** Placeholder text (for text/number inputs) */\n  placeholder?: string;\n  /** Options for select/multiselect */\n  options?: Array<{ value: string | number; label: string }>;\n  /** Description/hint for the field */\n  description?: string;\n}\n\n/**\n * Schema describing how to prompt for rule options during installation\n */\nexport interface RuleOptionSchema {\n  /** Fields that can be configured for this rule */\n  fields: OptionFieldSchema[];\n}\n\n/**\n * Colocated rule metadata - exported alongside each rule\n *\n * This structure keeps all rule metadata in the same file as the rule implementation,\n * making it easy to maintain and extend as new rules are added.\n */\nexport interface RuleMeta {\n  /** Rule identifier (e.g., \"no-arbitrary-tailwind\") - must match filename */\n  id: string;\n\n  /** Display name for CLI (e.g., \"No Arbitrary Tailwind\") */\n  name: string;\n\n  /** Short description for CLI selection prompts (one line) */\n  description: string;\n\n  /** Default severity level */\n  defaultSeverity: \"error\" | \"warn\" | \"off\";\n\n  /** Category for grouping in CLI */\n  category: \"static\" | \"semantic\";\n\n  /** Whether this rule requires a styleguide file */\n  requiresStyleguide?: boolean;\n\n  /** Default options for the rule (passed as second element in ESLint config) */\n  defaultOptions?: unknown[];\n\n  /** Schema for prompting user to configure options during install */\n  optionSchema?: RuleOptionSchema;\n\n  /**\n   * Detailed documentation in markdown format.\n   * Should include:\n   * - What the rule does\n   * - Why it's useful\n   * - Examples of incorrect and correct code\n   * - Configuration options explained\n   */\n  docs: string;\n}\n\n/**\n * Helper to define rule metadata with type safety\n */\nexport function defineRuleMeta(meta: RuleMeta): RuleMeta {\n  return meta;\n}\n"],"mappings":";AAIA,SAAS,mBAAmB;AAErB,IAAM,aAAa,YAAY;AAAA,EACpC,CAAC,SACC,uFAAuF,IAAI;AAC/F;AA2EO,SAAS,eAAe,MAA0B;AACvD,SAAO;AACT;","names":[]}

package/dist/chunk-MFIU3O2I.js

@@ -0,0 +1,201 @@
+// src/utils/export-resolver.ts
+import { ResolverFactory } from "oxc-resolver";
+import { parse } from "@typescript-eslint/typescript-estree";
+import { readFileSync, existsSync } from "fs";
+import { dirname, join } from "path";
+var resolverFactory = null;
+var exportCache = /* @__PURE__ */ new Map();
+var astCache = /* @__PURE__ */ new Map();
+var resolvedPathCache = /* @__PURE__ */ new Map();
+function getResolverFactory() {
+  if (!resolverFactory) {
+    resolverFactory = new ResolverFactory({
+      extensions: [".tsx", ".ts", ".jsx", ".js"],
+      mainFields: ["module", "main"],
+      conditionNames: ["import", "require", "node", "default"],
+      // Enable TypeScript path resolution
+      tsconfig: {
+        configFile: "tsconfig.json",
+        references: "auto"
+      }
+    });
+  }
+  return resolverFactory;
+}
+function resolveImportPath(importSource, fromFile) {
+  const cacheKey = `${fromFile}::${importSource}`;
+  if (resolvedPathCache.has(cacheKey)) {
+    return resolvedPathCache.get(cacheKey) ?? null;
+  }
+  if (importSource.startsWith("react") || importSource.startsWith("next") || !importSource.startsWith(".") && !importSource.startsWith("@/") && !importSource.startsWith("~/")) {
+    if (importSource.includes("@mui/") || importSource.includes("@chakra-ui/") || importSource.includes("antd") || importSource.includes("@radix-ui/")) {
+      resolvedPathCache.set(cacheKey, null);
+      return null;
+    }
+    resolvedPathCache.set(cacheKey, null);
+    return null;
+  }
+  try {
+    const factory = getResolverFactory();
+    const fromDir = dirname(fromFile);
+    const result = factory.sync(fromDir, importSource);
+    if (result.path) {
+      resolvedPathCache.set(cacheKey, result.path);
+      return result.path;
+    }
+  } catch {
+    const resolved = manualResolve(importSource, fromFile);
+    resolvedPathCache.set(cacheKey, resolved);
+    return resolved;
+  }
+  resolvedPathCache.set(cacheKey, null);
+  return null;
+}
+function manualResolve(importSource, fromFile) {
+  const fromDir = dirname(fromFile);
+  const extensions = [".tsx", ".ts", ".jsx", ".js"];
+  if (importSource.startsWith("@/")) {
+    const projectRoot = findProjectRoot(fromFile);
+    if (projectRoot) {
+      const relativePath = importSource.slice(2);
+      for (const ext of extensions) {
+        const candidate = join(projectRoot, relativePath + ext);
+        if (existsSync(candidate)) {
+          return candidate;
+        }
+        const indexCandidate = join(projectRoot, relativePath, `index${ext}`);
+        if (existsSync(indexCandidate)) {
+          return indexCandidate;
+        }
+      }
+    }
+  }
+  if (importSource.startsWith(".")) {
+    for (const ext of extensions) {
+      const candidate = join(fromDir, importSource + ext);
+      if (existsSync(candidate)) {
+        return candidate;
+      }
+      const indexCandidate = join(fromDir, importSource, `index${ext}`);
+      if (existsSync(indexCandidate)) {
+        return indexCandidate;
+      }
+    }
+  }
+  return null;
+}
+function findProjectRoot(fromFile) {
+  let dir = dirname(fromFile);
+  const root = "/";
+  while (dir !== root) {
+    if (existsSync(join(dir, "tsconfig.json"))) {
+      return dir;
+    }
+    if (existsSync(join(dir, "package.json"))) {
+      return dir;
+    }
+    dir = dirname(dir);
+  }
+  return null;
+}
+function parseFile(filePath) {
+  if (astCache.has(filePath)) {
+    return astCache.get(filePath);
+  }
+  try {
+    const content = readFileSync(filePath, "utf-8");
+    const ast = parse(content, {
+      jsx: true,
+      loc: true,
+      range: true
+    });
+    astCache.set(filePath, ast);
+    return ast;
+  } catch {
+    return null;
+  }
+}
+function extractExports(filePath) {
+  if (exportCache.has(filePath)) {
+    return exportCache.get(filePath);
+  }
+  const exports = /* @__PURE__ */ new Map();
+  const ast = parseFile(filePath);
+  if (!ast) {
+    exportCache.set(filePath, exports);
+    return exports;
+  }
+  for (const node of ast.body) {
+    if (node.type === "ExportNamedDeclaration" && node.declaration?.type === "FunctionDeclaration" && node.declaration.id) {
+      exports.set(node.declaration.id.name, {
+        localName: node.declaration.id.name
+      });
+    }
+    if (node.type === "ExportNamedDeclaration" && node.declaration?.type === "VariableDeclaration") {
+      for (const decl of node.declaration.declarations) {
+        if (decl.id.type === "Identifier") {
+          exports.set(decl.id.name, { localName: decl.id.name });
+        }
+      }
+    }
+    if (node.type === "ExportNamedDeclaration" && node.specifiers.length > 0) {
+      const source = node.source?.value;
+      for (const spec of node.specifiers) {
+        if (spec.type === "ExportSpecifier") {
+          const exportedName = spec.exported.type === "Identifier" ? spec.exported.name : spec.exported.value;
+          const localName = spec.local.type === "Identifier" ? spec.local.name : spec.local.value;
+          exports.set(exportedName, {
+            localName,
+            reexportSource: source
+          });
+        }
+      }
+    }
+    if (node.type === "ExportDefaultDeclaration" && node.declaration.type === "FunctionDeclaration" && node.declaration.id) {
+      exports.set("default", { localName: node.declaration.id.name });
+    }
+    if (node.type === "ExportDefaultDeclaration" && node.declaration.type === "Identifier") {
+      exports.set("default", { localName: node.declaration.name });
+    }
+  }
+  exportCache.set(filePath, exports);
+  return exports;
+}
+function resolveExport(exportName, filePath, visited = /* @__PURE__ */ new Set()) {
+  const key = `${filePath}::${exportName}`;
+  if (visited.has(key)) {
+    return null;
+  }
+  visited.add(key);
+  const exports = extractExports(filePath);
+  const exportInfo = exports.get(exportName);
+  if (!exportInfo) {
+    return null;
+  }
+  if (exportInfo.reexportSource) {
+    const resolvedPath = resolveImportPath(exportInfo.reexportSource, filePath);
+    if (resolvedPath) {
+      return resolveExport(exportInfo.localName, resolvedPath, visited);
+    }
+    return null;
+  }
+  return {
+    name: exportName,
+    filePath,
+    localName: exportInfo.localName,
+    isReexport: false
+  };
+}
+function clearResolverCaches() {
+  exportCache.clear();
+  astCache.clear();
+  resolvedPathCache.clear();
+}
+
+export {
+  resolveImportPath,
+  parseFile,
+  resolveExport,
+  clearResolverCaches
+};
+//# sourceMappingURL=chunk-MFIU3O2I.js.map

package/dist/chunk-MFIU3O2I.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/utils/export-resolver.ts"],"sourcesContent":["/**\n * Export Resolver\n *\n * Resolves import paths and finds export definitions, following re-exports\n * to their original source files.\n */\n\nimport { ResolverFactory } from \"oxc-resolver\";\nimport { parse } from \"@typescript-eslint/typescript-estree\";\nimport { readFileSync, existsSync } from \"fs\";\nimport { dirname, join, extname } from \"path\";\nimport type { TSESTree } from \"@typescript-eslint/utils\";\n\n// Module-level resolver instance (reused across calls)\nlet resolverInstance: ReturnType<typeof ResolverFactory.prototype.sync> | null =\n  null;\nlet resolverFactory: ResolverFactory | null = null;\n\n/**\n * Information about a resolved export\n */\nexport interface ResolvedExport {\n  /** The name of the export (e.g., \"Button\") */\n  name: string;\n  /** Absolute path to the file containing the actual definition */\n  filePath: string;\n  /** The local name in the source file (may differ from export name) */\n  localName: string;\n  /** Whether this is a re-export (export { X } from './other') */\n  isReexport: boolean;\n}\n\n/**\n * Cache for file exports to avoid re-parsing\n */\nconst exportCache = new Map<\n  string,\n  Map<string, { localName: string; reexportSource?: string }>\n>();\n\n/**\n * Cache for parsed ASTs\n */\nconst astCache = new Map<string, TSESTree.Program>();\n\n/**\n * Cache for resolved paths\n */\nconst resolvedPathCache = new Map<string, string | null>();\n\n/**\n * Get or create the resolver factory\n */\nfunction getResolverFactory(): ResolverFactory {\n  if (!resolverFactory) {\n    resolverFactory = new ResolverFactory({\n      extensions: [\".tsx\", \".ts\", \".jsx\", \".js\"],\n      mainFields: [\"module\", \"main\"],\n      conditionNames: [\"import\", \"require\", \"node\", \"default\"],\n      // Enable TypeScript path resolution\n      tsconfig: {\n        configFile: \"tsconfig.json\",\n        references: \"auto\",\n      },\n    });\n  }\n  return resolverFactory;\n}\n\n/**\n * Resolve an import path to an absolute file path\n */\nexport function resolveImportPath(\n  importSource: string,\n  fromFile: string\n): string | null {\n  const cacheKey = `${fromFile}::${importSource}`;\n\n  if (resolvedPathCache.has(cacheKey)) {\n    return resolvedPathCache.get(cacheKey) ?? null;\n  }\n\n  // Skip node_modules\n  if (\n    importSource.startsWith(\"react\") ||\n    importSource.startsWith(\"next\") ||\n    (!importSource.startsWith(\".\") &&\n      !importSource.startsWith(\"@/\") &&\n      !importSource.startsWith(\"~/\"))\n  ) {\n    // Check if it's a known external package\n    if (\n      importSource.includes(\"@mui/\") ||\n      importSource.includes(\"@chakra-ui/\") ||\n      importSource.includes(\"antd\") ||\n      importSource.includes(\"@radix-ui/\")\n    ) {\n      // Return a marker for external packages - we don't resolve them but track them\n      resolvedPathCache.set(cacheKey, null);\n      return null;\n    }\n    resolvedPathCache.set(cacheKey, null);\n    return null;\n  }\n\n  try {\n    const factory = getResolverFactory();\n    const fromDir = dirname(fromFile);\n    const result = factory.sync(fromDir, importSource);\n\n    if (result.path) {\n      resolvedPathCache.set(cacheKey, result.path);\n      return result.path;\n    }\n  } catch {\n    // Fallback: try manual resolution for common patterns\n    const resolved = manualResolve(importSource, fromFile);\n    resolvedPathCache.set(cacheKey, resolved);\n    return resolved;\n  }\n\n  resolvedPathCache.set(cacheKey, null);\n  return null;\n}\n\n/**\n * Manual fallback resolution for common patterns\n */\nfunction manualResolve(importSource: string, fromFile: string): string | null {\n  const fromDir = dirname(fromFile);\n  const extensions = [\".tsx\", \".ts\", \".jsx\", \".js\"];\n\n  // Handle @/ alias - find tsconfig and resolve\n  if (importSource.startsWith(\"@/\")) {\n    const projectRoot = findProjectRoot(fromFile);\n    if (projectRoot) {\n      const relativePath = importSource.slice(2); // Remove @/\n      for (const ext of extensions) {\n        const candidate = join(projectRoot, relativePath + ext);\n        if (existsSync(candidate)) {\n          return candidate;\n        }\n        // Try index file\n        const indexCandidate = join(projectRoot, relativePath, `index${ext}`);\n        if (existsSync(indexCandidate)) {\n          return indexCandidate;\n        }\n      }\n    }\n  }\n\n  // Handle relative imports\n  if (importSource.startsWith(\".\")) {\n    for (const ext of extensions) {\n      const candidate = join(fromDir, importSource + ext);\n      if (existsSync(candidate)) {\n        return candidate;\n      }\n      // Try index file\n      const indexCandidate = join(fromDir, importSource, `index${ext}`);\n      if (existsSync(indexCandidate)) {\n        return indexCandidate;\n      }\n    }\n  }\n\n  return null;\n}\n\n/**\n * Find the project root by looking for tsconfig.json or package.json\n */\nfunction findProjectRoot(fromFile: string): string | null {\n  let dir = dirname(fromFile);\n  const root = \"/\";\n\n  while (dir !== root) {\n    if (existsSync(join(dir, \"tsconfig.json\"))) {\n      return dir;\n    }\n    if (existsSync(join(dir, \"package.json\"))) {\n      return dir;\n    }\n    dir = dirname(dir);\n  }\n\n  return null;\n}\n\n/**\n * Parse a file and cache the AST\n */\nexport function parseFile(filePath: string): TSESTree.Program | null {\n  if (astCache.has(filePath)) {\n    return astCache.get(filePath)!;\n  }\n\n  try {\n    const content = readFileSync(filePath, \"utf-8\");\n    const ast = parse(content, {\n      jsx: true,\n      loc: true,\n      range: true,\n    });\n    astCache.set(filePath, ast);\n    return ast;\n  } catch {\n    return null;\n  }\n}\n\n/**\n * Extract export information from a file\n */\nfunction extractExports(\n  filePath: string\n): Map<string, { localName: string; reexportSource?: string }> {\n  if (exportCache.has(filePath)) {\n    return exportCache.get(filePath)!;\n  }\n\n  const exports = new Map<\n    string,\n    { localName: string; reexportSource?: string }\n  >();\n  const ast = parseFile(filePath);\n\n  if (!ast) {\n    exportCache.set(filePath, exports);\n    return exports;\n  }\n\n  for (const node of ast.body) {\n    // Handle: export function Button() {}\n    if (\n      node.type === \"ExportNamedDeclaration\" &&\n      node.declaration?.type === \"FunctionDeclaration\" &&\n      node.declaration.id\n    ) {\n      exports.set(node.declaration.id.name, {\n        localName: node.declaration.id.name,\n      });\n    }\n\n    // Handle: export const Button = () => {}\n    if (\n      node.type === \"ExportNamedDeclaration\" &&\n      node.declaration?.type === \"VariableDeclaration\"\n    ) {\n      for (const decl of node.declaration.declarations) {\n        if (decl.id.type === \"Identifier\") {\n          exports.set(decl.id.name, { localName: decl.id.name });\n        }\n      }\n    }\n\n    // Handle: export { Button } or export { Button as Btn }\n    if (node.type === \"ExportNamedDeclaration\" && node.specifiers.length > 0) {\n      const source = node.source?.value as string | undefined;\n      for (const spec of node.specifiers) {\n        if (spec.type === \"ExportSpecifier\") {\n          const exportedName =\n            spec.exported.type === \"Identifier\"\n              ? spec.exported.name\n              : spec.exported.value;\n          const localName =\n            spec.local.type === \"Identifier\"\n              ? spec.local.name\n              : spec.local.value;\n\n          exports.set(exportedName, {\n            localName,\n            reexportSource: source,\n          });\n        }\n      }\n    }\n\n    // Handle: export default function Button() {}\n    if (\n      node.type === \"ExportDefaultDeclaration\" &&\n      node.declaration.type === \"FunctionDeclaration\" &&\n      node.declaration.id\n    ) {\n      exports.set(\"default\", { localName: node.declaration.id.name });\n    }\n\n    // Handle: export default Button\n    if (\n      node.type === \"ExportDefaultDeclaration\" &&\n      node.declaration.type === \"Identifier\"\n    ) {\n      exports.set(\"default\", { localName: node.declaration.name });\n    }\n  }\n\n  exportCache.set(filePath, exports);\n  return exports;\n}\n\n/**\n * Resolve an export to its original definition, following re-exports\n */\nexport function resolveExport(\n  exportName: string,\n  filePath: string,\n  visited = new Set<string>()\n): ResolvedExport | null {\n  // Cycle detection\n  const key = `${filePath}::${exportName}`;\n  if (visited.has(key)) {\n    return null;\n  }\n  visited.add(key);\n\n  const exports = extractExports(filePath);\n  const exportInfo = exports.get(exportName);\n\n  if (!exportInfo) {\n    return null;\n  }\n\n  // If it's a re-export, follow the chain\n  if (exportInfo.reexportSource) {\n    const resolvedPath = resolveImportPath(exportInfo.reexportSource, filePath);\n    if (resolvedPath) {\n      return resolveExport(exportInfo.localName, resolvedPath, visited);\n    }\n    return null;\n  }\n\n  // This is the actual definition\n  return {\n    name: exportName,\n    filePath,\n    localName: exportInfo.localName,\n    isReexport: false,\n  };\n}\n\n/**\n * Clear all caches (useful for testing or watch mode)\n */\nexport function clearResolverCaches(): void {\n  exportCache.clear();\n  astCache.clear();\n  resolvedPathCache.clear();\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -9,6 +9,72 @@ import { ESLintUtils } from '@typescript-eslint/utils';
 declare const createRule: <Options extends readonly unknown[], MessageIds extends string>({ meta, name, ...rule }: Readonly<ESLintUtils.RuleWithMetaAndName<Options, MessageIds, unknown>>) => ESLintUtils.RuleModule<MessageIds, Options, unknown, ESLintUtils.RuleListener> & {
     name: string;
 };
+/**
+ * Schema for prompting user to configure a rule option in the CLI
+ */
+interface OptionFieldSchema {
+    /** Field name in the options object */
+    key: string;
+    /** Display label for the prompt */
+    label: string;
+    /** Prompt type */
+    type: "text" | "number" | "boolean" | "select" | "multiselect";
+    /** Default value */
+    defaultValue: unknown;
+    /** Placeholder text (for text/number inputs) */
+    placeholder?: string;
+    /** Options for select/multiselect */
+    options?: Array<{
+        value: string | number;
+        label: string;
+    }>;
+    /** Description/hint for the field */
+    description?: string;
+}
+/**
+ * Schema describing how to prompt for rule options during installation
+ */
+interface RuleOptionSchema {
+    /** Fields that can be configured for this rule */
+    fields: OptionFieldSchema[];
+}
+/**
+ * Colocated rule metadata - exported alongside each rule
+ *
+ * This structure keeps all rule metadata in the same file as the rule implementation,
+ * making it easy to maintain and extend as new rules are added.
+ */
+interface RuleMeta {
+    /** Rule identifier (e.g., "no-arbitrary-tailwind") - must match filename */
+    id: string;
+    /** Display name for CLI (e.g., "No Arbitrary Tailwind") */
+    name: string;
+    /** Short description for CLI selection prompts (one line) */
+    description: string;
+    /** Default severity level */
+    defaultSeverity: "error" | "warn" | "off";
+    /** Category for grouping in CLI */
+    category: "static" | "semantic";
+    /** Whether this rule requires a styleguide file */
+    requiresStyleguide?: boolean;
+    /** Default options for the rule (passed as second element in ESLint config) */
+    defaultOptions?: unknown[];
+    /** Schema for prompting user to configure options during install */
+    optionSchema?: RuleOptionSchema;
+    /**
+     * Detailed documentation in markdown format.
+     * Should include:
+     * - What the rule does
+     * - Why it's useful
+     * - Examples of incorrect and correct code
+     * - Configuration options explained
+     */
+    docs: string;
+}
+/**
+ * Helper to define rule metadata with type safety
+ */
+declare function defineRuleMeta(meta: RuleMeta): RuleMeta;
 
 /**
  * Styleguide loader for the LLM semantic rule
@@ -139,74 +205,36 @@ declare function clearCache(): void;
  * Rule Registry
  *
  * Central registry of all UILint ESLint rules with metadata for CLI tooling.
- * This allows the installer to auto-discover available rules and present them
- * to the user with descriptions.
+ * Metadata is now colocated with each rule file - this module re-exports
+ * the collected metadata for use by installers and other tools.
  */
-/**
- * Schema for prompting user to configure a rule option
- */
-interface OptionFieldSchema {
-    /** Field name in the options object */
-    key: string;
-    /** Display label for the prompt */
-    label: string;
-    /** Prompt type */
-    type: "text" | "number" | "boolean" | "select" | "multiselect";
-    /** Default value */
-    defaultValue: unknown;
-    /** Placeholder text (for text/number inputs) */
-    placeholder?: string;
-    /** Options for select/multiselect */
-    options?: Array<{
-        value: string | number;
-        label: string;
-    }>;
-    /** Description/hint for the field */
-    description?: string;
-}
-/**
- * Schema describing how to prompt for rule options during installation
- */
-interface RuleOptionSchema {
-    /** Fields that can be configured for this rule */
-    fields: OptionFieldSchema[];
-}
-interface RuleMetadata {
-    /** Rule identifier (e.g., "no-arbitrary-tailwind") */
-    id: string;
-    /** Display name for CLI */
-    name: string;
-    /** Short description for CLI selection prompts */
-    description: string;
-    /** Default severity level */
-    defaultSeverity: "error" | "warn" | "off";
-    /** Default options for the rule */
-    defaultOptions?: unknown[];
-    /** Schema for prompting user to configure options during install */
-    optionSchema?: RuleOptionSchema;
-    /** Whether this rule requires a styleguide file */
-    requiresStyleguide?: boolean;
-    /** Category for grouping */
-    category: "static" | "semantic";
-}
+
 /**
  * Registry of all available UILint ESLint rules
  *
  * When adding a new rule:
- * 1. Add the rule implementation to src/rules/
- * 2. Add an entry here with metadata
- * 3. Export the rule from src/index.ts
- * 4. The CLI installer will automatically discover and offer it
+ * 1. Create the rule file in src/rules/
+ * 2. Export a `meta` object using `defineRuleMeta()`
+ * 3. Import and add the meta to this array
+ * 4. Run `pnpm generate:index` to regenerate exports
  */
-declare const ruleRegistry: RuleMetadata[];
+declare const ruleRegistry: RuleMeta[];
 /**
  * Get rule metadata by ID
  */
-declare function getRuleMetadata(id: string): RuleMetadata | undefined;
+declare function getRuleMetadata(id: string): RuleMeta | undefined;
 /**
  * Get all rules in a category
  */
-declare function getRulesByCategory(category: "static" | "semantic"): RuleMetadata[];
+declare function getRulesByCategory(category: "static" | "semantic"): RuleMeta[];
+/**
+ * Get documentation for a rule (useful for CLI help commands)
+ */
+declare function getRuleDocs(id: string): string | undefined;
+/**
+ * Get all rule IDs
+ */
+declare function getAllRuleIds(): string[];
 
 /**
  * All available rules
@@ -256,6 +284,51 @@ declare const rules: {
     }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
         name: string;
     };
+    "enforce-absolute-imports": _typescript_eslint_utils_ts_eslint.RuleModule<"preferAbsoluteImport", [{
+        maxRelativeDepth?: number;
+        aliasPrefix?: string;
+        ignorePaths?: string[];
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    "no-any-in-props": _typescript_eslint_utils_ts_eslint.RuleModule<"anyInProps" | "anyInPropsProperty", [{
+        checkFCGenerics?: boolean;
+        allowInGenericDefaults?: boolean;
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    "zustand-use-selectors": _typescript_eslint_utils_ts_eslint.RuleModule<"missingSelector" | "useSelectorFunction", [{
+        storePattern?: string;
+        allowShallow?: boolean;
+        requireNamedSelectors?: boolean;
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    "no-prop-drilling-depth": _typescript_eslint_utils_ts_eslint.RuleModule<"propDrilling", [{
+        maxDepth?: number;
+        ignoredProps?: string[];
+        ignoreComponents?: string[];
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    "no-secrets-in-code": _typescript_eslint_utils_ts_eslint.RuleModule<"secretDetected" | "suspiciousVariable", [{
+        additionalPatterns?: Array<{
+            name: string;
+            pattern: string;
+        }>;
+        checkVariableNames?: boolean;
+        minSecretLength?: number;
+        allowInTestFiles?: boolean;
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
+    "require-input-validation": _typescript_eslint_utils_ts_eslint.RuleModule<"missingValidation" | "unvalidatedBodyAccess", [{
+        httpMethods?: string[];
+        routePatterns?: string[];
+        allowManualValidation?: boolean;
+    }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+        name: string;
+    };
 };
 /**
  * Plugin metadata
@@ -317,6 +390,51 @@ declare const plugin: {
         }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
             name: string;
         };
+        "enforce-absolute-imports": _typescript_eslint_utils_ts_eslint.RuleModule<"preferAbsoluteImport", [{
+            maxRelativeDepth?: number;
+            aliasPrefix?: string;
+            ignorePaths?: string[];
+        }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
+        "no-any-in-props": _typescript_eslint_utils_ts_eslint.RuleModule<"anyInProps" | "anyInPropsProperty", [{
+            checkFCGenerics?: boolean;
+            allowInGenericDefaults?: boolean;
+        }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
+        "zustand-use-selectors": _typescript_eslint_utils_ts_eslint.RuleModule<"missingSelector" | "useSelectorFunction", [{
+            storePattern?: string;
+            allowShallow?: boolean;
+            requireNamedSelectors?: boolean;
+        }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
+        "no-prop-drilling-depth": _typescript_eslint_utils_ts_eslint.RuleModule<"propDrilling", [{
+            maxDepth?: number;
+            ignoredProps?: string[];
+            ignoreComponents?: string[];
+        }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
+        "no-secrets-in-code": _typescript_eslint_utils_ts_eslint.RuleModule<"secretDetected" | "suspiciousVariable", [{
+            additionalPatterns?: Array<{
+                name: string;
+                pattern: string;
+            }>;
+            checkVariableNames?: boolean;
+            minSecretLength?: number;
+            allowInTestFiles?: boolean;
+        }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
+        "require-input-validation": _typescript_eslint_utils_ts_eslint.RuleModule<"missingValidation" | "unvalidatedBodyAccess", [{
+            httpMethods?: string[];
+            routePatterns?: string[];
+            allowManualValidation?: boolean;
+        }], unknown, _typescript_eslint_utils_ts_eslint.RuleListener> & {
+            name: string;
+        };
     };
 };
 /**
@@ -337,4 +455,4 @@ interface UILintESLint {
  */
 declare const uilintEslint: UILintESLint;
 
-export { type CacheEntry, type CacheStore, type CachedIssue, type LibraryName, type OptionFieldSchema, type RuleMetadata, type RuleOptionSchema, type UILintESLint, clearCache$1 as clearCache, clearCacheEntry, clearCache as clearImportGraphCache, configs, createRule, uilintEslint as default, findStyleguidePath, getCacheEntry, getComponentLibrary, getRuleMetadata, getRulesByCategory, getStyleguide, hashContent, hashContentSync, loadCache, loadStyleguide, meta, plugin, ruleRegistry, rules, saveCache, setCacheEntry };
+export { type CacheEntry, type CacheStore, type CachedIssue, type LibraryName, type OptionFieldSchema, type RuleMeta, type RuleMeta as RuleMetadata, type RuleOptionSchema, type UILintESLint, clearCache$1 as clearCache, clearCacheEntry, clearCache as clearImportGraphCache, configs, createRule, uilintEslint as default, defineRuleMeta, findStyleguidePath, getAllRuleIds, getCacheEntry, getComponentLibrary, getRuleDocs, getRuleMetadata, getRulesByCategory, getStyleguide, hashContent, hashContentSync, loadCache, loadStyleguide, meta, plugin, ruleRegistry, rules, saveCache, setCacheEntry };