@h-rig/validator-kit 0.0.6-alpha.9 → 0.0.6-alpha.91

package/dist/src/checks.d.ts

@@ -0,0 +1,9 @@
+import { Checker } from "./result";
+/** Check a file exists. */
+export declare function requireFileCheck(checker: Checker, path: string, checkName: string): void;
+/** Check a directory exists. */
+export declare function requireDirCheck(checker: Checker, path: string, checkName: string): void;
+/** Validate standard package structure: package.json + tsconfig.json + src/. */
+export declare function requirePackageStructure(checker: Checker, serviceDir: string, prefix: string): void;
+/** Check test files exist in a project directory. */
+export declare function checkTestsExist(checker: Checker, projectDir: string, checkName: string): void;

package/dist/src/content.d.ts

@@ -0,0 +1,7 @@
+import { Checker } from "./result";
+/** Check markdown file has section headings matching each term. */
+export declare function requireMarkdownSections(checker: Checker, filePath: string, sections: string[]): void;
+/** Check document contains terms (case-insensitive). Pattern can include | for alternation. */
+export declare function requireTerms(checker: Checker, filePath: string, terms: Record<string, string>): void;
+/** Parse JSON and check key paths exist (dot-separated, e.g. ".summary.total"). */
+export declare function requireJsonKeys(checker: Checker, filePath: string, keys: string[]): void;

package/dist/src/fs.d.ts

@@ -0,0 +1,19 @@
+/** Return the first existing path from candidates, or null. */
+export declare function findFirstFile(candidates: string[]): string | null;
+/** Read a file as UTF-8 or return null if missing. */
+export declare function readFileSafe(path: string): string | null;
+export declare function requireFile(path: string, id: string, description: string): string;
+/** Check if file content matches a pattern. */
+export declare function fileContains(path: string, pattern: RegExp): boolean;
+/** Walk a directory tree, calling fn for each file. Skips node_modules/.git. */
+export declare function walkDir(dir: string, fn: (filePath: string) => void): void;
+/** List subdirectories of a directory. */
+export declare function listSubdirs(dir: string): string[];
+/** Count .ts files in a directory (excluding tests). */
+export declare function countTsFiles(dir: string): number;
+/** Count test files (.test.ts / .spec.ts) in a directory. */
+export declare function countTestFiles(dir: string): number;
+/** Find first directory matching candidates. */
+export declare function findFirstDir(candidates: string[]): string | null;
+/** Find files by name pattern (glob-free, recursive). */
+export declare function findFilesByName(dir: string, namePattern: RegExp): string[];

package/dist/src/grep.d.ts

@@ -0,0 +1,6 @@
+/** Find files whose content matches pattern. Optionally filter by extension. */
+export declare function grepFiles(dir: string, pattern: RegExp, extensions?: string[]): string[];
+/** Count files matching pattern. */
+export declare function grepCount(dir: string, pattern: RegExp, extensions?: string[]): number;
+/** Get matching lines from files in a directory. */
+export declare function grepLines(dir: string, pattern: RegExp, extensions?: string[], maxLines?: number): string[];

package/dist/src/index.d.ts

@@ -0,0 +1,6 @@
+export type { ValidatorOutput } from "./result";
+export { pass, fail, error, Checker } from "./result";
+export { findFirstFile, readFileSafe, requireFile, fileContains, walkDir, listSubdirs, countTsFiles, countTestFiles, findFirstDir, findFilesByName, } from "./fs";
+export { grepFiles, grepCount, grepLines } from "./grep";
+export { requireMarkdownSections, requireTerms, requireJsonKeys, } from "./content";
+export { requireFileCheck, requireDirCheck, requirePackageStructure, checkTestsExist, } from "./checks";

package/dist/src/result.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Validator output contract and result helpers.
+ *
+ * Provides the `ValidatorOutput` shape, single-shot exit helpers (`pass`,
+ * `fail`, `error`), and the multi-check `Checker` accumulator.
+ *
+ * Moved from packages/runtime/src/control-plane/validators/shared.ts
+ * in Phase 3 Task 3.3 of the Rig extraction.
+ */
+export type ValidatorOutput = {
+    id: string;
+    passed: boolean;
+    summary: string;
+    details?: string;
+};
+export declare function pass(id: string, summary: string): never;
+export declare function fail(id: string, summary: string, details?: string): never;
+export declare function error(id: string, message: string): never;
+export declare class Checker {
+    private results;
+    pass(name: string): void;
+    fail(name: string, reason: string): void;
+    /** Fail and immediately emit — for fatal precondition failures. */
+    fatal(id: string, reason: string): never;
+    /** Print JSON result and exit. */
+    emit(id: string): never;
+}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@h-rig/validator-kit",
-  "version": "0.0.6-alpha.9",
+  "version": "0.0.6-alpha.91",
   "type": "module",
-  "description": "Rig package",
+  "description": "Validator schema helpers for Rig plugin contributions; not a validation runtime.",
   "license": "UNLICENSED",
   "files": [
     "dist",
@@ -10,6 +10,7 @@
   ],
   "exports": {
     ".": {
+      "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
     }
   },
@@ -18,8 +19,9 @@
   },
   "main": "./dist/src/index.js",
   "module": "./dist/src/index.js",
+  "types": "./dist/src/index.d.ts",
   "dependencies": {
-    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.9",
+    "@rig/contracts": "npm:@h-rig/contracts@0.0.6-alpha.91",
     "effect": "4.0.0-beta.78"
   }
 }