@harness-engineering/core 0.10.1 → 0.12.0

package/dist/matchers-D20x48U9.d.mts

@@ -0,0 +1,353 @@
+import { z } from 'zod';
+
+declare const ArchMetricCategorySchema: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+type ArchMetricCategory = z.infer<typeof ArchMetricCategorySchema>;
+declare const ViolationSchema: z.ZodObject<{
+    id: z.ZodString;
+    file: z.ZodString;
+    category: z.ZodOptional<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>>;
+    detail: z.ZodString;
+    severity: z.ZodEnum<["error", "warning"]>;
+}, "strip", z.ZodTypeAny, {
+    file: string;
+    id: string;
+    severity: "error" | "warning";
+    detail: string;
+    category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+}, {
+    file: string;
+    id: string;
+    severity: "error" | "warning";
+    detail: string;
+    category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+}>;
+type Violation = z.infer<typeof ViolationSchema>;
+declare const MetricResultSchema: z.ZodObject<{
+    category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+    scope: z.ZodString;
+    value: z.ZodNumber;
+    violations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        file: z.ZodString;
+        category: z.ZodOptional<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>>;
+        detail: z.ZodString;
+        severity: z.ZodEnum<["error", "warning"]>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        id: string;
+        severity: "error" | "warning";
+        detail: string;
+        category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+    }, {
+        file: string;
+        id: string;
+        severity: "error" | "warning";
+        detail: string;
+        category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+    }>, "many">;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    scope: string;
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    violations: {
+        file: string;
+        id: string;
+        severity: "error" | "warning";
+        detail: string;
+        category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+    }[];
+    metadata?: Record<string, unknown> | undefined;
+}, {
+    value: number;
+    scope: string;
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    violations: {
+        file: string;
+        id: string;
+        severity: "error" | "warning";
+        detail: string;
+        category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+    }[];
+    metadata?: Record<string, unknown> | undefined;
+}>;
+type MetricResult = z.infer<typeof MetricResultSchema>;
+declare const CategoryBaselineSchema: z.ZodObject<{
+    value: z.ZodNumber;
+    violationIds: z.ZodArray<z.ZodString, "many">;
+}, "strip", z.ZodTypeAny, {
+    value: number;
+    violationIds: string[];
+}, {
+    value: number;
+    violationIds: string[];
+}>;
+type CategoryBaseline = z.infer<typeof CategoryBaselineSchema>;
+declare const ArchBaselineSchema: z.ZodObject<{
+    version: z.ZodLiteral<1>;
+    updatedAt: z.ZodString;
+    updatedFrom: z.ZodString;
+    metrics: z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodObject<{
+        value: z.ZodNumber;
+        violationIds: z.ZodArray<z.ZodString, "many">;
+    }, "strip", z.ZodTypeAny, {
+        value: number;
+        violationIds: string[];
+    }, {
+        value: number;
+        violationIds: string[];
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    version: 1;
+    updatedAt: string;
+    updatedFrom: string;
+    metrics: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+        value: number;
+        violationIds: string[];
+    }>>;
+}, {
+    version: 1;
+    updatedAt: string;
+    updatedFrom: string;
+    metrics: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", {
+        value: number;
+        violationIds: string[];
+    }>>;
+}>;
+type ArchBaseline = z.infer<typeof ArchBaselineSchema>;
+declare const CategoryRegressionSchema: z.ZodObject<{
+    category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+    baselineValue: z.ZodNumber;
+    currentValue: z.ZodNumber;
+    delta: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    baselineValue: number;
+    currentValue: number;
+    delta: number;
+}, {
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    baselineValue: number;
+    currentValue: number;
+    delta: number;
+}>;
+type CategoryRegression = z.infer<typeof CategoryRegressionSchema>;
+declare const ArchDiffResultSchema: z.ZodObject<{
+    passed: z.ZodBoolean;
+    newViolations: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        file: z.ZodString;
+        category: z.ZodOptional<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>>;
+        detail: z.ZodString;
+        severity: z.ZodEnum<["error", "warning"]>;
+    }, "strip", z.ZodTypeAny, {
+        file: string;
+        id: string;
+        severity: "error" | "warning";
+        detail: string;
+        category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+    }, {
+        file: string;
+        id: string;
+        severity: "error" | "warning";
+        detail: string;
+        category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+    }>, "many">;
+    resolvedViolations: z.ZodArray<z.ZodString, "many">;
+    preExisting: z.ZodArray<z.ZodString, "many">;
+    regressions: z.ZodArray<z.ZodObject<{
+        category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+        baselineValue: z.ZodNumber;
+        currentValue: z.ZodNumber;
+        delta: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        baselineValue: number;
+        currentValue: number;
+        delta: number;
+    }, {
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        baselineValue: number;
+        currentValue: number;
+        delta: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    passed: boolean;
+    newViolations: {
+        file: string;
+        id: string;
+        severity: "error" | "warning";
+        detail: string;
+        category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+    }[];
+    resolvedViolations: string[];
+    preExisting: string[];
+    regressions: {
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        baselineValue: number;
+        currentValue: number;
+        delta: number;
+    }[];
+}, {
+    passed: boolean;
+    newViolations: {
+        file: string;
+        id: string;
+        severity: "error" | "warning";
+        detail: string;
+        category?: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth" | undefined;
+    }[];
+    resolvedViolations: string[];
+    preExisting: string[];
+    regressions: {
+        category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+        baselineValue: number;
+        currentValue: number;
+        delta: number;
+    }[];
+}>;
+type ArchDiffResult = z.infer<typeof ArchDiffResultSchema>;
+declare const ThresholdConfigSchema: z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodUnion<[z.ZodNumber, z.ZodRecord<z.ZodString, z.ZodNumber>]>>;
+type ThresholdConfig = z.infer<typeof ThresholdConfigSchema>;
+declare const ArchConfigSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    baselinePath: z.ZodDefault<z.ZodString>;
+    thresholds: z.ZodDefault<z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodUnion<[z.ZodNumber, z.ZodRecord<z.ZodString, z.ZodNumber>]>>>;
+    modules: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodRecord<z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>, z.ZodUnion<[z.ZodNumber, z.ZodRecord<z.ZodString, z.ZodNumber>]>>>>;
+}, "strip", z.ZodTypeAny, {
+    thresholds: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>;
+    modules: Record<string, Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>>;
+    enabled: boolean;
+    baselinePath: string;
+}, {
+    thresholds?: Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>> | undefined;
+    modules?: Record<string, Partial<Record<"complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth", number | Record<string, number>>>> | undefined;
+    enabled?: boolean | undefined;
+    baselinePath?: string | undefined;
+}>;
+type ArchConfig = z.infer<typeof ArchConfigSchema>;
+declare const ConstraintRuleSchema: z.ZodObject<{
+    id: z.ZodString;
+    category: z.ZodEnum<["circular-deps", "layer-violations", "complexity", "coupling", "forbidden-imports", "module-size", "dependency-depth"]>;
+    description: z.ZodString;
+    scope: z.ZodString;
+    targets: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    scope: string;
+    id: string;
+    description: string;
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    targets?: string[] | undefined;
+}, {
+    scope: string;
+    id: string;
+    description: string;
+    category: "complexity" | "coupling" | "circular-deps" | "layer-violations" | "forbidden-imports" | "module-size" | "dependency-depth";
+    targets?: string[] | undefined;
+}>;
+type ConstraintRule = z.infer<typeof ConstraintRuleSchema>;
+/**
+ * Collector interface for architecture metric collection.
+ * Each collector is responsible for a single metric category.
+ * Cannot be expressed as a Zod schema because it has methods.
+ */
+interface Collector {
+    category: ArchMetricCategory;
+    collect(config: ArchConfig, rootDir: string): Promise<MetricResult[]>;
+    getRules(config: ArchConfig, rootDir: string): ConstraintRule[];
+}
+
+interface MatcherContext {
+    isNot: boolean;
+    equals: (a: unknown, b: unknown) => boolean;
+}
+interface ArchHandle {
+    readonly kind: 'arch-handle';
+    readonly scope: string;
+    readonly rootDir: string;
+    readonly config?: Partial<ArchConfig> | undefined;
+}
+interface ArchitectureOptions {
+    rootDir?: string;
+    config?: Partial<ArchConfig> | undefined;
+}
+/**
+ * Factory for project-wide architecture handle.
+ * Returns a handle (not a promise) that matchers consume.
+ */
+declare function architecture(options?: ArchitectureOptions): ArchHandle;
+/**
+ * Factory for module-scoped architecture handle.
+ * Named `archModule` to avoid conflict with the `module` reserved word
+ * in certain strict-mode contexts.
+ */
+declare function archModule(modulePath: string, options?: ArchitectureOptions): ArchHandle;
+declare function toHaveNoCircularDeps(this: MatcherContext, received: ArchHandle & {
+    _mockResults?: MetricResult[];
+}): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function toHaveNoLayerViolations(this: MatcherContext, received: ArchHandle & {
+    _mockResults?: MetricResult[];
+}): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function toMatchBaseline(this: MatcherContext, received: ArchHandle & {
+    _mockDiff?: ArchDiffResult;
+}, options?: {
+    tolerance?: number;
+}): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function toHaveMaxComplexity(this: MatcherContext, received: ArchHandle & {
+    _mockResults?: MetricResult[];
+}, maxComplexity: number): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function toHaveMaxCoupling(this: MatcherContext, received: ArchHandle & {
+    _mockResults?: MetricResult[];
+}, limits: {
+    fanIn?: number;
+    fanOut?: number;
+}): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function toHaveMaxFileCount(this: MatcherContext, received: ArchHandle & {
+    _mockResults?: MetricResult[];
+}, maxFiles: number): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function toNotDependOn(this: MatcherContext, received: ArchHandle & {
+    _mockResults?: MetricResult[];
+}, forbiddenModule: string): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+declare function toHaveMaxDepDepth(this: MatcherContext, received: ArchHandle & {
+    _mockResults?: MetricResult[];
+}, maxDepth: number): Promise<{
+    pass: boolean;
+    message: () => string;
+}>;
+/**
+ * Vitest custom matchers for architecture assertions.
+ * Usage: expect.extend(archMatchers) in vitest.setup.ts
+ */
+declare const archMatchers: {
+    toHaveNoCircularDeps: typeof toHaveNoCircularDeps;
+    toHaveNoLayerViolations: typeof toHaveNoLayerViolations;
+    toMatchBaseline: typeof toMatchBaseline;
+    toHaveMaxComplexity: typeof toHaveMaxComplexity;
+    toHaveMaxCoupling: typeof toHaveMaxCoupling;
+    toHaveMaxFileCount: typeof toHaveMaxFileCount;
+    toNotDependOn: typeof toNotDependOn;
+    toHaveMaxDepDepth: typeof toHaveMaxDepDepth;
+};
+
+export { type ArchConfig as A, type Collector as C, type MetricResult as M, type ThresholdConfig as T, type Violation as V, type ConstraintRule as a, type ArchMetricCategory as b, type ArchBaseline as c, type ArchDiffResult as d, ArchBaselineSchema as e, ArchConfigSchema as f, ArchDiffResultSchema as g, type ArchHandle as h, ArchMetricCategorySchema as i, type ArchitectureOptions as j, type CategoryBaseline as k, CategoryBaselineSchema as l, type CategoryRegression as m, CategoryRegressionSchema as n, ConstraintRuleSchema as o, MetricResultSchema as p, ThresholdConfigSchema as q, ViolationSchema as r, archMatchers as s, archModule as t, architecture as u };