semantic-complexity 0.0.2-1895c257 → 0.0.5-e791286c

package/dist/tensor/types.d.ts

@@ -0,0 +1,186 @@
+/**
+ * v0.0.3: Tensor Types
+ *
+ * Mathematical foundation:
+ *   score^(2) = v^T M v + <v, w>
+ */
+/**
+ * 5-dimensional complexity vector
+ */
+export interface Vector5D {
+    control: number;
+    nesting: number;
+    state: number;
+    async: number;
+    coupling: number;
+}
+/**
+ * Module type for context-aware analysis
+ */
+export type ModuleType = 'api' | 'lib' | 'app' | 'web' | 'data' | 'infra' | 'deploy' | 'unknown';
+/**
+ * Dimension indices
+ */
+export declare const IDX_CONTROL = 0;
+export declare const IDX_NESTING = 1;
+export declare const IDX_STATE = 2;
+export declare const IDX_ASYNC = 3;
+export declare const IDX_COUPLING = 4;
+/**
+ * 5x5 Interaction Matrix
+ */
+export type Matrix5x5 = [
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ],
+    [
+        number,
+        number,
+        number,
+        number,
+        number
+    ]
+];
+/**
+ * Tensor score result
+ *
+ * Dual-metric approach inspired by CDR (Clinical Dementia Rating):
+ * - tensorScore (CDR Global style): Algorithm-based, captures interactions
+ * - rawSum (CDR-SOB style): Simple sum, better for tracking changes
+ */
+export interface TensorScore {
+    /** Linear component: <v, w> */
+    linear: number;
+    /** Quadratic component: v^T M v */
+    quadratic: number;
+    /** Raw score: linear + quadratic */
+    raw: number;
+    /** Regularization term: ε‖v‖² */
+    regularization: number;
+    /** Final regularized score (CDR Global style) */
+    regularized: number;
+    /** Epsilon value used */
+    epsilon: number;
+    /** Module type used */
+    moduleType: ModuleType;
+    /** Complexity vector */
+    vector: Vector5D;
+    /** Simple sum of dimensions: C + N + S + A + Λ (CDR-SOB style) */
+    rawSum: number;
+    /** Threshold for rawSum based on canonical upper bounds */
+    rawSumThreshold: number;
+    /** rawSum / rawSumThreshold ratio (0-1 = safe, >1 = violation) */
+    rawSumRatio: number;
+}
+/**
+ * Convergence status
+ */
+export type ConvergenceStatus = 'safe' | 'review' | 'violation' | 'oscillating';
+/**
+ * Convergence analysis result
+ */
+export interface ConvergenceAnalysis {
+    /** Current score */
+    score: number;
+    /** Threshold value */
+    threshold: number;
+    /** Epsilon value */
+    epsilon: number;
+    /** Convergence score: (score - target) / ε */
+    convergenceScore: number;
+    /** Status based on convergence score */
+    status: ConvergenceStatus;
+    /** Distance to target (threshold - ε) */
+    distanceToTarget: number;
+    /** Distance to threshold */
+    distanceToThreshold: number;
+    /** Lipschitz constant estimate */
+    lipschitzEstimate: number;
+}
+/**
+ * Hodge decomposition result
+ *
+ * H^k(Code) = ⊕_{p+q=k} H^{p,q}(Code)
+ */
+export interface HodgeDecomposition {
+    /** H^{2,0}: Control + Nesting (algorithmic) */
+    algorithmic: number;
+    /** H^{0,2}: State + Coupling (architectural) */
+    architectural: number;
+    /** H^{1,1}: Async (balanced/harmonic) */
+    balanced: number;
+    /** Total complexity */
+    total: number;
+    /** Balance ratio: balanced / total */
+    balanceRatio: number;
+    /** Is in harmonic state (well-balanced) */
+    isHarmonic: boolean;
+}
+/**
+ * Complexity level classification
+ */
+export type ComplexityLevel = 'minimal' | 'low' | 'medium' | 'high' | 'extreme';
+/**
+ * Deviation from canonical form result
+ */
+export interface DeviationResult {
+    /** Euclidean distance to canonical centroid */
+    euclideanDistance: number;
+    /** Mahalanobis-like distance using interaction matrix */
+    mahalanobisDistance: number;
+    /** Maximum deviation in any dimension */
+    maxDimensionDeviation: number;
+    /** Normalized deviation (0-1 scale) */
+    normalizedDeviation: number;
+    /** Whether vector is within canonical bounds */
+    isCanonical: boolean;
+    /** Whether vector is outside ALL canonical regions */
+    isOrphan: boolean;
+    /** Module type used for comparison */
+    moduleType: ModuleType;
+    /** Current vector */
+    vector: Vector5D;
+    /** Dimensions that violate canonical bounds */
+    violationDimensions: string[];
+    /** Status: canonical | deviated | orphan */
+    status: 'canonical' | 'deviated' | 'orphan';
+}
+/**
+ * Refactoring recommendation
+ */
+export interface RefactoringRecommendation {
+    /** Dimension to address */
+    dimension: string;
+    /** Priority (1-5, higher = more urgent) */
+    priority: number;
+    /** Recommended action */
+    action: string;
+    /** Expected impact on score */
+    expectedImpact: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/tensor/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tensor/types.ts"],"names":[],"mappings":"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"}

package/dist/tensor/types.js

@@ -0,0 +1,15 @@
+/**
+ * v0.0.3: Tensor Types
+ *
+ * Mathematical foundation:
+ *   score^(2) = v^T M v + <v, w>
+ */
+/**
+ * Dimension indices
+ */
+export const IDX_CONTROL = 0;
+export const IDX_NESTING = 1;
+export const IDX_STATE = 2;
+export const IDX_ASYNC = 3;
+export const IDX_COUPLING = 4;
+//# sourceMappingURL=types.js.map

package/dist/tensor/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/tensor/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkBH;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC;AAC7B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC;AAC3B,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "semantic-complexity",
-  "version": "0.0.2-1895c257",
+  "version": "0.0.5-e791286c",
   "description": "Multi-dimensional code complexity analyzer",
   "type": "module",
   "main": "./dist/index.js",
@@ -33,6 +33,10 @@
     "./gates": {
       "types": "./dist/gates/index.d.ts",
       "import": "./dist/gates/index.js"
+    },
+    "./tensor": {
+      "types": "./dist/tensor/index.d.ts",
+      "import": "./dist/tensor/index.js"
     }
   },
   "files": [
@@ -61,7 +65,7 @@
   "devDependencies": {
     "@types/node": "^22.10.2",
     "rimraf": "^6.0.1",
-    "vitest": "^2.1.8"
+    "vitest": "^4.0.16"
   },
   "peerDependencies": {
     "typescript": ">=5.0.0"