@hyperfrontend/versioning 0.1.0 → 0.3.0

package/commits/classify/classifier.d.ts

@@ -0,0 +1,73 @@
+import type { ConventionalCommit } from '../models/conventional';
+import type { ClassificationContext, ClassificationResult, ClassifiedCommit, CommitWithRaw } from './models';
+/**
+ * Classifies a single commit against a project.
+ *
+ * Implements the hybrid classification strategy:
+ * 1. Check scope match (fast path)
+ * 2. Check file touch (validation/catch-all)
+ * 3. Check dependency touch (indirect)
+ * 4. Fallback to excluded
+ *
+ * @param input - The commit to classify
+ * @param context - Classification context with project info
+ * @returns Classified commit with source attribution
+ *
+ * @example
+ * const classified = classifyCommit(
+ *   { commit: parsedCommit, raw: gitCommit },
+ *   { projectScopes: ['versioning'], fileCommitHashes: new Set(['abc123']) }
+ * )
+ */
+export declare function classifyCommit(input: CommitWithRaw, context: ClassificationContext): ClassifiedCommit;
+/**
+ * Classifies multiple commits against a project.
+ *
+ * @param commits - Array of commits to classify
+ * @param context - Classification context with project info
+ * @returns Classification result with all commits and summary
+ */
+export declare function classifyCommits(commits: readonly CommitWithRaw[], context: ClassificationContext): ClassificationResult;
+/**
+ * Creates a classification context from common inputs.
+ *
+ * @param projectScopes - Scopes that match the project
+ * @param fileCommitHashes - Set of commit hashes that touched project files
+ * @param options - Additional context options
+ * @param options.dependencyCommitMap - Map of dependency names to commit hashes touching them
+ * @param options.infrastructureCommitHashes - Set of commit hashes touching infrastructure paths
+ * @param options.excludeScopes - Scopes to explicitly exclude from classification
+ * @param options.includeScopes - Additional scopes to include as direct matches
+ * @returns A ClassificationContext object
+ */
+export declare function createClassificationContext(projectScopes: readonly string[], fileCommitHashes: ReadonlySet<string>, options?: {
+    readonly dependencyCommitMap?: ReadonlyMap<string, ReadonlySet<string>>;
+    readonly infrastructureCommitHashes?: ReadonlySet<string>;
+    readonly excludeScopes?: readonly string[];
+    readonly includeScopes?: readonly string[];
+}): ClassificationContext;
+/**
+ * Filters an array of classified commits to only included ones.
+ *
+ * @param commits - Array of classified commits
+ * @returns Only commits marked for inclusion
+ */
+export declare function filterIncluded(commits: readonly ClassifiedCommit[]): readonly ClassifiedCommit[];
+/**
+ * Extracts conventional commits from classified commits for changelog generation.
+ *
+ * @param commits - Array of classified commits
+ * @returns Array of conventional commits
+ */
+export declare function extractConventionalCommits(commits: readonly ClassifiedCommit[]): readonly ConventionalCommit[];
+/**
+ * Creates a modified conventional commit with scope handling based on classification.
+ *
+ * For direct commits, the scope is removed (redundant in project changelog).
+ * For indirect commits, the scope is preserved (provides context).
+ *
+ * @param classified - Commit with classification metadata determining scope display
+ * @returns A conventional commit with appropriate scope handling
+ */
+export declare function toChangelogCommit(classified: ClassifiedCommit): ConventionalCommit;
+//# sourceMappingURL=classifier.d.ts.map

package/commits/classify/classifier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../../../../../../../libs/versioning/src/commits/classify/classifier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAA;AAChE,OAAO,KAAK,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,gBAAgB,EAAgB,aAAa,EAAE,MAAM,UAAU,CAAA;AAI1H;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,EAAE,OAAO,EAAE,qBAAqB,GAAG,gBAAgB,CAyDrG;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,EAAE,OAAO,EAAE,qBAAqB,GAAG,oBAAoB,CAgCvH;AA+DD;;;;;;;;;;;GAWG;AACH,wBAAgB,2BAA2B,CACzC,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,gBAAgB,EAAE,WAAW,CAAC,MAAM,CAAC,EACrC,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,mBAAmB,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;IACvE,QAAQ,CAAC,0BAA0B,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;IACzD,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC1C,QAAQ,CAAC,aAAa,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC3C,GACA,qBAAqB,CASvB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,gBAAgB,EAAE,CAEhG;AAED;;;;;GAKG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,SAAS,gBAAgB,EAAE,GAAG,SAAS,kBAAkB,EAAE,CAE9G;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,gBAAgB,GAAG,kBAAkB,CAclF"}