@alimaandev/ripple 0.1.0 → 0.2.0

package/dist/chunk-OOERV74D.js

@@ -0,0 +1,66 @@
+#!/usr/bin/env node
+import { z } from 'zod';
+
+// src/config/defaults.ts
+var DEFAULT_CONFIG = {
+  include: ["**/*.{ts,tsx,js,jsx}"],
+  ignore: ["node_modules", "dist", "build", "coverage", ".next", "out", ".git"],
+  aliases: {},
+  tsconfigPath: "tsconfig.json",
+  risk: {
+    weights: {
+      affectedFiles: 0.3,
+      entryPoint: 0.15,
+      sharedUtility: 0.15,
+      publicExports: 0.1,
+      tests: 0.1,
+      routes: 0.1,
+      cycleMembership: 0.1
+    },
+    thresholds: {
+      medium: 30,
+      high: 55,
+      critical: 80
+    }
+  }
+};
+
+// src/config/schema.ts
+var fraction = z.number().min(0).max(1);
+var score = z.number().min(0).max(100);
+var riskWeightsSchema = z.object({
+  affectedFiles: fraction.default(DEFAULT_CONFIG.risk.weights.affectedFiles),
+  entryPoint: fraction.default(DEFAULT_CONFIG.risk.weights.entryPoint),
+  sharedUtility: fraction.default(DEFAULT_CONFIG.risk.weights.sharedUtility),
+  publicExports: fraction.default(DEFAULT_CONFIG.risk.weights.publicExports),
+  tests: fraction.default(DEFAULT_CONFIG.risk.weights.tests),
+  routes: fraction.default(DEFAULT_CONFIG.risk.weights.routes),
+  cycleMembership: fraction.default(DEFAULT_CONFIG.risk.weights.cycleMembership)
+}).strict();
+var riskThresholdsSchema = z.object({
+  medium: score.default(DEFAULT_CONFIG.risk.thresholds.medium),
+  high: score.default(DEFAULT_CONFIG.risk.thresholds.high),
+  critical: score.default(DEFAULT_CONFIG.risk.thresholds.critical)
+}).strict();
+var riskConfigSchema = z.object({
+  weights: riskWeightsSchema.default(DEFAULT_CONFIG.risk.weights),
+  thresholds: riskThresholdsSchema.default(DEFAULT_CONFIG.risk.thresholds)
+}).strict();
+var rippleConfigSchema = z.object({
+  include: z.array(z.string().min(1)).min(1).default(DEFAULT_CONFIG.include),
+  ignore: z.array(z.string()).default(DEFAULT_CONFIG.ignore),
+  aliases: z.record(z.string(), z.string()).default(DEFAULT_CONFIG.aliases),
+  tsconfigPath: z.string().min(1).default(DEFAULT_CONFIG.tsconfigPath),
+  risk: riskConfigSchema.default(DEFAULT_CONFIG.risk)
+}).strict();
+function formatSchemaIssues(error) {
+  return error.issues.map((issue) => {
+    const path = issue.path.join(".");
+    const location = path === "" ? "config" : `config.${path}`;
+    return `${location}: ${issue.message}`;
+  });
+}
+
+export { DEFAULT_CONFIG, formatSchemaIssues, rippleConfigSchema };
+//# sourceMappingURL=chunk-OOERV74D.js.map
+//# sourceMappingURL=chunk-OOERV74D.js.map

package/dist/chunk-OOERV74D.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/defaults.ts","../src/config/schema.ts"],"names":[],"mappings":"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","file":"chunk-OOERV74D.js","sourcesContent":["import type { RippleConfig } from \"../types/config.js\";\n\n/**\n * Built-in defaults. A user config only overrides fields it sets; anything\n * else keeps these values.\n */\nexport const DEFAULT_CONFIG: RippleConfig = {\n  include: [\"**/*.{ts,tsx,js,jsx}\"],\n  ignore: [\"node_modules\", \"dist\", \"build\", \"coverage\", \".next\", \"out\", \".git\"],\n  aliases: {},\n  tsconfigPath: \"tsconfig.json\",\n  risk: {\n    weights: {\n      affectedFiles: 0.3,\n      entryPoint: 0.15,\n      sharedUtility: 0.15,\n      publicExports: 0.1,\n      tests: 0.1,\n      routes: 0.1,\n      cycleMembership: 0.1,\n    },\n    thresholds: {\n      medium: 30,\n      high: 55,\n      critical: 80,\n    },\n  },\n};\n","import { z } from \"zod\";\nimport type { RippleConfig } from \"../types/config.js\";\nimport { DEFAULT_CONFIG } from \"./defaults.js\";\n\n/**\n * Zod schema for `ripple.config.ts`. Every field has a default, so parsing a\n * partial user config yields a complete validated `RippleConfig`.\n *\n * Note: outer objects default to their *full* default object. `.default({})`\n * would skip inner field defaults, since zod uses the default value as-is\n * without re-parsing it.\n */\n\nconst fraction = z.number().min(0).max(1);\nconst score = z.number().min(0).max(100);\n\nconst riskWeightsSchema = z\n  .object({\n    affectedFiles: fraction.default(DEFAULT_CONFIG.risk.weights.affectedFiles),\n    entryPoint: fraction.default(DEFAULT_CONFIG.risk.weights.entryPoint),\n    sharedUtility: fraction.default(DEFAULT_CONFIG.risk.weights.sharedUtility),\n    publicExports: fraction.default(DEFAULT_CONFIG.risk.weights.publicExports),\n    tests: fraction.default(DEFAULT_CONFIG.risk.weights.tests),\n    routes: fraction.default(DEFAULT_CONFIG.risk.weights.routes),\n    cycleMembership: fraction.default(DEFAULT_CONFIG.risk.weights.cycleMembership),\n  })\n  .strict();\n\nconst riskThresholdsSchema = z\n  .object({\n    medium: score.default(DEFAULT_CONFIG.risk.thresholds.medium),\n    high: score.default(DEFAULT_CONFIG.risk.thresholds.high),\n    critical: score.default(DEFAULT_CONFIG.risk.thresholds.critical),\n  })\n  .strict();\n\nconst riskConfigSchema = z\n  .object({\n    weights: riskWeightsSchema.default(DEFAULT_CONFIG.risk.weights),\n    thresholds: riskThresholdsSchema.default(DEFAULT_CONFIG.risk.thresholds),\n  })\n  .strict();\n\nexport const rippleConfigSchema: z.ZodType<RippleConfig> = z\n  .object({\n    include: z.array(z.string().min(1)).min(1).default(DEFAULT_CONFIG.include),\n    ignore: z.array(z.string()).default(DEFAULT_CONFIG.ignore),\n    aliases: z.record(z.string(), z.string()).default(DEFAULT_CONFIG.aliases),\n    tsconfigPath: z.string().min(1).default(DEFAULT_CONFIG.tsconfigPath),\n    risk: riskConfigSchema.default(DEFAULT_CONFIG.risk),\n  })\n  .strict();\n\n/** Human-readable list of validation problems, for friendly error output. */\nexport function formatSchemaIssues(error: z.ZodError): string[] {\n  return error.issues.map((issue) => {\n    const path = issue.path.join(\".\");\n    const location = path === \"\" ? \"config\" : `config.${path}`;\n    return `${location}: ${issue.message}`;\n  });\n}\n"]}

package/dist/index.d.ts

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+
+/**
+ * User-facing configuration for Ripple, validated by `src/config/schema.ts`.
+ *
+ * Every field has a default; a user config only overrides what it sets.
+ */
+interface RiskWeights {
+    /** Weight of the (log-scaled) number of affected files. */
+    affectedFiles: number;
+    /** Weight of whether an entry point is affected. */
+    entryPoint: number;
+    /** Weight of how many shared utilities are affected. */
+    sharedUtility: number;
+    /** Weight of the target file's public export surface. */
+    publicExports: number;
+    /** Weight of affected test files. */
+    tests: number;
+    /** Weight of affected API routes. */
+    routes: number;
+    /** Weight of the target file being part of a circular dependency. */
+    cycleMembership: number;
+}
+/**
+ * Score thresholds that map a 0-100 risk score to a level.
+ * A score >= `critical` is CRITICAL, >= `high` is HIGH, >= `medium` is MEDIUM,
+ * anything below is LOW.
+ */
+interface RiskThresholds {
+    medium: number;
+    high: number;
+    critical: number;
+}
+interface RiskConfig {
+    weights: RiskWeights;
+    thresholds: RiskThresholds;
+}
+/**
+ * The validated `ripple.config.ts` shape.
+ */
+interface RippleConfig {
+    /** Glob patterns (relative to the project root) of source files to analyze. */
+    include: string[];
+    /** Glob patterns / directory names to exclude from analysis. */
+    ignore: string[];
+    /** Path aliases, e.g. `{ "@": "./src" }`. Merged with tsconfig `paths`. */
+    aliases: Record<string, string>;
+    /** Path to tsconfig.json, relative to the project root. Default: `tsconfig.json`. */
+    tsconfigPath: string;
+    /** Risk engine tuning. */
+    risk: RiskConfig;
+}
+/**
+ * Normalized alias map used by the resolver: pattern → absolute target.
+ * Both sides support a single `*` wildcard (`"@/*"` → `"C:/proj/src/*"`).
+ */
+type AliasMap = Record<string, string>;
+
+/**
+ * tsconfig.json facts Ripple consumes. Loaded via `src/utils/tsconfig.ts`.
+ */
+interface TsconfigInfo {
+    /** Absolute path of the tsconfig file. */
+    path: string;
+    /** Directory containing the tsconfig (the resolution base for aliases). */
+    dir: string;
+    /** Absolute `baseUrl`, if configured. */
+    baseUrl?: string;
+    /** `paths` mappings: pattern → replacement patterns. */
+    paths: Record<string, string[]>;
+    include: string[];
+    exclude: string[];
+}
+/**
+ * Everything the analysis pipeline needs to know about the project it runs
+ * in. Built once by `src/config/loader.ts` and passed down explicitly.
+ */
+interface ProjectContext {
+    /** Absolute project root (config file location or cwd). */
+    rootDir: string;
+    /** Validated user config. */
+    config: RippleConfig;
+    /** tsconfig facts, when a tsconfig was found. */
+    tsconfig?: TsconfigInfo;
+    /** Normalized alias map (user aliases + tsconfig paths). */
+    aliases: AliasMap;
+}
+
+/**
+ * Risk engine types: a deterministic weighted heuristic that maps graph
+ * signals to a 0-100 score and a level.
+ */
+type RiskLevel = "LOW" | "MEDIUM" | "HIGH" | "CRITICAL";
+/** One contributing factor of the score, for transparency in `--verbose`. */
+interface RiskFactor {
+    /** Stable machine-readable factor name. */
+    name: string;
+    /** Human-readable label. */
+    label: string;
+    /** Configured weight (0-1). */
+    weight: number;
+    /** Normalized signal value (0-1). */
+    value: number;
+    /** `weight * value * 100`, the points this factor contributes. */
+    contribution: number;
+}
+interface RiskResult {
+    /** Final score, 0-100. */
+    score: number;
+    level: RiskLevel;
+    /** Every factor and its contribution. */
+    factors: RiskFactor[];
+}
+
+declare const rippleConfigSchema: z.ZodType<RippleConfig>;
+/** Human-readable list of validation problems, for friendly error output. */
+declare function formatSchemaIssues(error: z.ZodError): string[];
+
+export { type AliasMap, type ProjectContext, type RippleConfig, type RiskFactor, type RiskLevel, type RiskResult, type TsconfigInfo, formatSchemaIssues, rippleConfigSchema };

package/dist/index.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+export { formatSchemaIssues, rippleConfigSchema } from './chunk-OOERV74D.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@alimaandev/ripple",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Dependency impact analysis for TypeScript projects. Answers the question: what will break if I change this file?",
   "keywords": [
     "cli",
@@ -21,6 +21,18 @@
     "url": "https://github.com/alimaandev/ripple/issues"
   },
   "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "bin": {
     "ripple": "./dist/bin.js"
   },
@@ -45,9 +57,11 @@
     "prepublishOnly": "pnpm run typecheck && pnpm run lint && pnpm run test && pnpm run build"
   },
   "dependencies": {
+    "boxen": "^8.0.1",
     "chalk": "^6.0.0",
     "commander": "^15.0.0",
     "fast-glob": "^3.3.3",
+    "figures": "^6.1.0",
     "jiti": "^2.7.0",
     "ora": "^9.4.1",
     "treeify": "^1.1.0",