@rikalabs/repo-lint 0.2.5 → 0.3.1

package/directory/index.d.ts

@@ -0,0 +1 @@
+export { directory, DirNode, DirOptions, LayoutNode } from '../types/index';

package/directory/index.js

@@ -0,0 +1 @@
+module.exports.directory = require('../index.js').directory;

package/file/index.d.ts

@@ -0,0 +1 @@
+export { file, FileNode, FileOptions, CaseStyle } from '../types/index';

package/file/index.js

@@ -0,0 +1 @@
+module.exports.file = require('../index.js').file;

package/index.js

@@ -1,16 +1,45 @@
 module.exports.defineConfig = (config) => config;
-module.exports.dir = (children) => ({ type: "dir", children: children || {} });
-module.exports.file = (pattern) => ({ type: "file", pattern });
-module.exports.opt = (node) => ({ ...node, optional: true });
+
+const directory = (children, options) => ({
+  type: "dir",
+  children: children || {},
+  ...(options?.strict && { strict: true }),
+  ...(options?.maxDepth !== undefined && { maxDepth: options.maxDepth }),
+});
+module.exports.directory = directory;
+module.exports.dir = directory;
+
+const file = (patternOrOptions) => {
+  if (typeof patternOrOptions === "string" || patternOrOptions === undefined) {
+    return { type: "file", pattern: patternOrOptions };
+  }
+  return {
+    type: "file",
+    pattern: patternOrOptions.pattern,
+    ...(patternOrOptions.case && { case: patternOrOptions.case }),
+  };
+};
+module.exports.file = file;
+
+const optional = (node) => ({ ...node, optional: true });
+module.exports.optional = optional;
+module.exports.opt = optional;
+
+const required = (node) => ({ ...node, required: true });
+module.exports.required = required;
+
 module.exports.param = (opts, child) => ({ type: "param", ...opts, child });
+
 module.exports.many = (optsOrChild, child) => {
   if (child) return { type: "many", ...optsOrChild, child };
   return { type: "many", child: optsOrChild };
 };
+
 module.exports.recursive = (optsOrChild, child) => {
   if (child) return { type: "recursive", ...optsOrChild, child };
   return { type: "recursive", maxDepth: 10, child: optsOrChild };
 };
+
 module.exports.either = (...variants) => ({ type: "either", variants });
 
 const presets = require('./presets/index.js');

package/optional/index.d.ts

@@ -0,0 +1 @@
+export { optional, LayoutNode } from '../types/index';

package/optional/index.js

@@ -0,0 +1 @@
+module.exports.optional = require('../index.js').optional;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rikalabs/repo-lint",
-  "version": "0.2.5",
+  "version": "0.3.1",
   "description": "High-performance filesystem layout linter with TypeScript DSL config",
   "license": "MIT",
   "repository": {
@@ -22,6 +22,38 @@
   ],
   "main": "index.js",
   "types": "types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./types/index.d.ts",
+      "require": "./index.js",
+      "import": "./index.js"
+    },
+    "./directory": {
+      "types": "./directory/index.d.ts",
+      "require": "./directory/index.js",
+      "import": "./directory/index.js"
+    },
+    "./optional": {
+      "types": "./optional/index.d.ts",
+      "require": "./optional/index.js",
+      "import": "./optional/index.js"
+    },
+    "./required": {
+      "types": "./required/index.d.ts",
+      "require": "./required/index.js",
+      "import": "./required/index.js"
+    },
+    "./file": {
+      "types": "./file/index.d.ts",
+      "require": "./file/index.js",
+      "import": "./file/index.js"
+    },
+    "./presets": {
+      "types": "./presets/index.d.ts",
+      "require": "./presets/index.js",
+      "import": "./presets/index.js"
+    }
+  },
   "bin": {
     "repo-lint": "./bin/repo-lint"
   },
@@ -30,7 +62,11 @@
     "install.js",
     "bin",
     "types",
-    "presets"
+    "presets",
+    "directory",
+    "optional",
+    "required",
+    "file"
   ],
   "scripts": {
     "postinstall": "node install.js"

package/required/index.d.ts

@@ -0,0 +1 @@
+export { required, LayoutNode } from '../types/index';

package/required/index.js

@@ -0,0 +1 @@
+module.exports.required = require('../index.js').required;

package/types/index.d.ts

@@ -1,3 +1,15 @@
+export type CaseStyle = "kebab" | "snake" | "camel" | "pascal" | "any";
+
+export interface MirrorConfig {
+  source: string;
+  target: string;
+  pattern: string;
+}
+
+export interface WhenRequirement {
+  requires: string[];
+}
+
 export interface DefineConfigOptions {
   mode?: "strict" | "warn";
   layout: LayoutNode;
@@ -6,6 +18,14 @@ export interface DefineConfigOptions {
   deps?: DepsConfig;
   ignore?: string[];
   useGitignore?: boolean;
+  /** Glob patterns to discover workspace configs (e.g., ["apps/*", "packages/*"]) */
+  workspaces?: string[];
+  /** File dependency rules: source glob -> target glob */
+  dependencies?: Record<string, string>;
+  /** Mirror structure rules */
+  mirror?: MirrorConfig[];
+  /** Conditional requirements: if file exists, require others */
+  when?: Record<string, WhenRequirement>;
 }
 
 export type LayoutNode =
@@ -16,16 +36,33 @@ export type LayoutNode =
   | RecursiveNode
   | EitherNode;
 
+export interface DirOptions {
+  /** Reject files not matching any defined pattern */
+  strict?: boolean;
+  /** Maximum allowed nesting depth */
+  maxDepth?: number;
+}
+
 export interface DirNode {
   type: "dir";
   children: Record<string, LayoutNode>;
   optional?: boolean;
+  required?: boolean;
+  strict?: boolean;
+  maxDepth?: number;
+}
+
+export interface FileOptions {
+  pattern?: string;
+  case?: CaseStyle;
 }
 
 export interface FileNode {
   type: "file";
   pattern?: string;
   optional?: boolean;
+  required?: boolean;
+  case?: CaseStyle;
 }
 
 export interface ParamNode {
@@ -39,6 +76,7 @@ export interface ManyNode {
   type: "many";
   case?: CaseStyle;
   child: LayoutNode;
+  max?: number;
 }
 
 export interface RecursiveNode {
@@ -52,9 +90,8 @@ export interface EitherNode {
   variants: LayoutNode[];
 }
 
-export type CaseStyle = "kebab" | "snake" | "camel" | "pascal" | "any";
-
 export interface RulesConfig {
+  /** Glob patterns for forbidden paths (supports ! negation) */
   forbidPaths?: string[];
   forbidNames?: string[];
   ignorePaths?: string[];
@@ -77,21 +114,44 @@ export interface DepsConfig {
 
 export function defineConfig(options: DefineConfigOptions): DefineConfigOptions;
 
-export function dir(children?: Record<string, LayoutNode>): DirNode;
+/** Create a directory node */
+export function directory(
+  children?: Record<string, LayoutNode>,
+  options?: DirOptions
+): DirNode;
+/** @deprecated Use `directory` instead */
+export function dir(
+  children?: Record<string, LayoutNode>,
+  options?: DirOptions
+): DirNode;
+
+/** Create a file node */
 export function file(pattern?: string): FileNode;
+export function file(options: FileOptions): FileNode;
+
+/** Mark a node as optional (may or may not exist) */
+export function optional<T extends LayoutNode>(node: T): T & { optional: true };
+/** @deprecated Use `optional` instead */
 export function opt<T extends LayoutNode>(node: T): T & { optional: true };
+
+/** Mark a node as required (must exist, error if missing) */
+export function required<T extends LayoutNode>(node: T): T & { required: true };
+
 export function param(
   options: { case: CaseStyle; name?: string },
   child: LayoutNode
 ): ParamNode;
+
 export function many(
-  options: { case?: CaseStyle } | LayoutNode,
+  options: { case?: CaseStyle; max?: number } | LayoutNode,
   child?: LayoutNode
 ): ManyNode;
+
 export function recursive(
   options: { maxDepth?: number } | LayoutNode,
   child?: LayoutNode
 ): RecursiveNode;
+
 export function either(...variants: LayoutNode[]): EitherNode;
 
 export interface NextjsAppRouterOptions {