@utilix-tech/sdk 0.31.0 → 0.33.0

package/CHANGELOG.md

@@ -2,6 +2,14 @@
 
 Full release notes for all Utilix surfaces (browser tools, REST API, SDKs, MCP server) live at [utilix.tech/changelog](https://utilix.tech/changelog). This file tracks just this package.
 
+## 0.33.0
+- Add `lintConventionalCommit` (conventional-commit-linter): lint a git commit message against the Conventional Commits v1.0.0 spec, checking header format, blank-line separation, footer tokens, and BREAKING CHANGE casing.
+- Add `calculateSavingsGoal` (savings-goal-calculator): solve for months to reach a savings goal at a fixed monthly contribution, or the monthly contribution required to hit a goal by a target month count.
+
+## 0.32.0
+- Add `analyzeSentenceLengths` (sentence-length-distribution): histogram of sentence lengths in words, plus mean, median, standard deviation, and a coefficient-of-variation consistency label, distinct from readability grade scores.
+- Add `formatFewShotExamples` (few-shot-formatter): format input/output example pairs into a numbered, XML-tagged, or delimiter-separated few-shot prompt template.
+
 ## 0.31.0
 - Add `calculateEmi` (emi-calculator): equated monthly installment, total interest, and a year-by-year principal/interest breakdown from principal, annual rate, and tenure in years or months.
 - Add `parseFrontMatter` (markdown-front-matter-parser): split a Markdown document into its YAML front matter fields and body content, parsing scalars, inline arrays, and block lists.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**585 developer utility functions for Node.js: runs locally, no API key required.**
+**590 developer utility functions for Node.js: runs locally, no API key required.**
 
 [![npm version](https://img.shields.io/npm/v/@utilix-tech/sdk?style=flat-square&color=cb3837)](https://www.npmjs.com/package/@utilix-tech/sdk)
 [![npm downloads](https://img.shields.io/npm/dm/@utilix-tech/sdk?style=flat-square)](https://www.npmjs.com/package/@utilix-tech/sdk)
@@ -140,7 +140,7 @@ generateHtpasswdFile([{ username: "alice", password: "secret" }]);
 ```ts
 import { convertCase, slugify, countWords, generateWords, generateParagraphs,
          escapeString, htmlToMarkdown, applyOps, detectPassiveVoice, scoreReadability,
-         detectFillerWords, calculateStringDistance } from "@utilix-tech/sdk/text";
+         detectFillerWords, calculateStringDistance, analyzeSentenceLengths } from "@utilix-tech/sdk/text";
 
 convertCase("hello world", "camelCase");   // "helloWorld"
 convertCase("hello world", "PascalCase");  // "HelloWorld"
@@ -173,6 +173,10 @@ detectFillerWords("At the end of the day, I just really think we should circle b
 // Levenshtein edit distance + similarity ratio; pass mode: "damerau" to count a transposition as 1 edit
 calculateStringDistance("kitten", "sitting");
 // { distance: 3, similarity: 0.5714, maxLength: 7, mode: "levenshtein" }
+
+// Histogram + mean/median/stddev of sentence lengths, distinct from readability grade scores
+analyzeSentenceLengths("The cat sat on the mat. It was a sunny day, and the dog ran across the yard to play.");
+// { sentenceCount: 2, meanLength: 10, stdDev: 4, consistency: "Moderate variation in sentence length", buckets: [...] }
 ```
 
 ---
@@ -654,18 +658,18 @@ readVideoInfo(new Uint8Array(videoBytes));
 | `@utilix-tech/sdk/json` | Format, minify, diff, validate, JSONPath, CSV↔JSON, YAML↔JSON, TS types from data or from a JSON Schema |
 | `@utilix-tech/sdk/encoding` | Base64, URL, HTML entities, Base32/Base58/Base62 encode/decode |
 | `@utilix-tech/sdk/hashing` | MD5, SHA-1/256/512, bcrypt, HMAC, .htpasswd |
-| `@utilix-tech/sdk/text` | Case convert, slugify, word count, lorem ipsum, line ops, HTML→Markdown, Levenshtein/Damerau string distance |
+| `@utilix-tech/sdk/text` | Case convert, slugify, word count, lorem ipsum, line ops, HTML→Markdown, Levenshtein/Damerau string distance, readability scoring, sentence length distribution |
 | `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert, SRT/WebVTT subtitles, Markdown front matter parser |
 | `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, entropy estimator, fake data |
 | `@utilix-tech/sdk/time` | Date diff, timezone convert, cron parse, relative time |
-| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator |
+| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator, savings goal calculator |
 | `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing, IPv6 address compress/expand |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header |
-| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing |
+| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing, regex ReDoS detector, Conventional Commits linter |
 | `@utilix-tech/sdk/color` | Hex/RGB/HSL/HSV/CMYK convert, palette generation, contrast check |
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |
 | `@utilix-tech/sdk/misc` | SVG optimize/sanitize, file size format, Unicode inspector |
-| `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect, vector similarity |
+| `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect, vector similarity, few-shot prompt formatter |
 | `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; PDF page dimension/orientation listing; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading; MP4/WebM video info |
 
 ---

package/dist/{ai_agent-B-c59NXD.d.cts → ai_agent-C1zudGgT.d.cts}

@@ -8,6 +8,7 @@
  *   - secret-detector       : detectSecrets
  *   - prompt-injection      : detectPromptInjection
  *   - json-repair           : repairJson
+ *   - few-shot-formatter    : formatFewShotExamples
  */
 interface ModelPricing {
     model: string;
@@ -333,6 +334,23 @@ interface VectorSimilarityResult {
 declare function vectorSimilarity(a: number[], b: number[]): VectorSimilarityResult | {
     error: string;
 };
+type FewShotFormat = 'numbered' | 'xml' | 'delimiter';
+interface FewShotExample {
+    input: string;
+    output: string;
+}
+interface FewShotFormatResult {
+    formatted: string;
+    exampleCount: number;
+    format: FewShotFormat;
+}
+/**
+ * Format a list of input/output example pairs into a standard few-shot
+ * prompt template, ready to paste into a system or user prompt. Examples
+ * with an empty input or output are dropped. `delimiter` only applies to
+ * the 'delimiter' format and defaults to '---'.
+ */
+declare function formatFewShotExamples(examples: FewShotExample[], format?: FewShotFormat, delimiter?: string): FewShotFormatResult;
 
 type ai_agent_ChunkStrategy = ChunkStrategy;
 type ai_agent_CompressHtmlResult = CompressHtmlResult;
@@ -349,6 +367,9 @@ type ai_agent_EntityType2 = EntityType2;
 type ai_agent_ExtractJsonResult = ExtractJsonResult;
 type ai_agent_ExtractKeywordsResult = ExtractKeywordsResult;
 type ai_agent_ExtractUrlsResult = ExtractUrlsResult;
+type ai_agent_FewShotExample = FewShotExample;
+type ai_agent_FewShotFormat = FewShotFormat;
+type ai_agent_FewShotFormatResult = FewShotFormatResult;
 type ai_agent_InjectionDetectResult = InjectionDetectResult;
 type ai_agent_InjectionFinding = InjectionFinding;
 type ai_agent_JsonBlock = JsonBlock;
@@ -396,6 +417,7 @@ declare const ai_agent_extractKeywords: typeof extractKeywords;
 declare const ai_agent_extractTables: typeof extractTables;
 declare const ai_agent_extractUrls: typeof extractUrls;
 declare const ai_agent_flattenJson: typeof flattenJson;
+declare const ai_agent_formatFewShotExamples: typeof formatFewShotExamples;
 declare const ai_agent_mergeJson: typeof mergeJson;
 declare const ai_agent_redactPii: typeof redactPii;
 declare const ai_agent_repairJson: typeof repairJson;
@@ -408,7 +430,7 @@ declare const ai_agent_unflattenJson: typeof unflattenJson;
 declare const ai_agent_validateJsonSchema: typeof validateJsonSchema;
 declare const ai_agent_vectorSimilarity: typeof vectorSimilarity;
 declare namespace ai_agent {
-  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
+  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
 }
 
-export { diffJson as $, type TokenEstimate as A, type TokenEstimateResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type TrimResult as F, type TrimStrategy as G, type ValidationResult as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type VectorSimilarityResult as L, MODEL_PRICING as M, chunkText as N, compressHtml as O, type PiiDetectResult as P, compressJson as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type UrlMatch as U, type ValidationError as V, compressMarkdown as W, deduplicateLines as X, detectPii as Y, detectPromptInjection as Z, detectSecrets as _, ai_agent as a, estimateCost as a0, estimateTokens as a1, expandQuery as a2, extractEntities as a3, extractJson as a4, extractKeywords as a5, extractTables as a6, extractUrls as a7, flattenJson as a8, mergeJson as a9, redactPii as aa, repairJson as ab, rerankChunks as ac, sanitizeHtml as ad, scoreRelevance as ae, summarizeForLlm as af, trimToTokens as ag, unflattenJson as ah, validateJsonSchema as ai, vectorSimilarity as aj, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type InjectionFinding as n, type JsonRepairResult as o, type MergeResult as p, type MergeStrategy as q, type ModelPricing as r, type PiiFinding as s, type PiiType as t, type RelevanceResult as u, type SecretDetectResult as v, type SecretFinding as w, type SecretType as x, type SummaryResult as y, type TextChunk as z };
+export { detectPii as $, type SummaryResult as A, type TextChunk as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type TokenEstimate as G, type TokenEstimateResult as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type TrimResult as L, MODEL_PRICING as M, type TrimStrategy as N, type ValidationResult as O, type PiiDetectResult as P, type VectorSimilarityResult as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type UrlMatch as U, type ValidationError as V, chunkText as W, compressHtml as X, compressJson as Y, compressMarkdown as Z, deduplicateLines as _, ai_agent as a, detectPromptInjection as a0, detectSecrets as a1, diffJson as a2, estimateCost as a3, estimateTokens as a4, expandQuery as a5, extractEntities as a6, extractJson as a7, extractKeywords as a8, extractTables as a9, extractUrls as aa, flattenJson as ab, formatFewShotExamples as ac, mergeJson as ad, redactPii as ae, repairJson as af, rerankChunks as ag, sanitizeHtml as ah, scoreRelevance as ai, summarizeForLlm as aj, trimToTokens as ak, unflattenJson as al, validateJsonSchema as am, vectorSimilarity as an, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type RelevanceResult as w, type SecretDetectResult as x, type SecretFinding as y, type SecretType as z };

package/dist/{ai_agent-B-c59NXD.d.ts → ai_agent-C1zudGgT.d.ts}

@@ -8,6 +8,7 @@
  *   - secret-detector       : detectSecrets
  *   - prompt-injection      : detectPromptInjection
  *   - json-repair           : repairJson
+ *   - few-shot-formatter    : formatFewShotExamples
  */
 interface ModelPricing {
     model: string;
@@ -333,6 +334,23 @@ interface VectorSimilarityResult {
 declare function vectorSimilarity(a: number[], b: number[]): VectorSimilarityResult | {
     error: string;
 };
+type FewShotFormat = 'numbered' | 'xml' | 'delimiter';
+interface FewShotExample {
+    input: string;
+    output: string;
+}
+interface FewShotFormatResult {
+    formatted: string;
+    exampleCount: number;
+    format: FewShotFormat;
+}
+/**
+ * Format a list of input/output example pairs into a standard few-shot
+ * prompt template, ready to paste into a system or user prompt. Examples
+ * with an empty input or output are dropped. `delimiter` only applies to
+ * the 'delimiter' format and defaults to '---'.
+ */
+declare function formatFewShotExamples(examples: FewShotExample[], format?: FewShotFormat, delimiter?: string): FewShotFormatResult;
 
 type ai_agent_ChunkStrategy = ChunkStrategy;
 type ai_agent_CompressHtmlResult = CompressHtmlResult;
@@ -349,6 +367,9 @@ type ai_agent_EntityType2 = EntityType2;
 type ai_agent_ExtractJsonResult = ExtractJsonResult;
 type ai_agent_ExtractKeywordsResult = ExtractKeywordsResult;
 type ai_agent_ExtractUrlsResult = ExtractUrlsResult;
+type ai_agent_FewShotExample = FewShotExample;
+type ai_agent_FewShotFormat = FewShotFormat;
+type ai_agent_FewShotFormatResult = FewShotFormatResult;
 type ai_agent_InjectionDetectResult = InjectionDetectResult;
 type ai_agent_InjectionFinding = InjectionFinding;
 type ai_agent_JsonBlock = JsonBlock;
@@ -396,6 +417,7 @@ declare const ai_agent_extractKeywords: typeof extractKeywords;
 declare const ai_agent_extractTables: typeof extractTables;
 declare const ai_agent_extractUrls: typeof extractUrls;
 declare const ai_agent_flattenJson: typeof flattenJson;
+declare const ai_agent_formatFewShotExamples: typeof formatFewShotExamples;
 declare const ai_agent_mergeJson: typeof mergeJson;
 declare const ai_agent_redactPii: typeof redactPii;
 declare const ai_agent_repairJson: typeof repairJson;
@@ -408,7 +430,7 @@ declare const ai_agent_unflattenJson: typeof unflattenJson;
 declare const ai_agent_validateJsonSchema: typeof validateJsonSchema;
 declare const ai_agent_vectorSimilarity: typeof vectorSimilarity;
 declare namespace ai_agent {
-  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
+  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
 }
 
-export { diffJson as $, type TokenEstimate as A, type TokenEstimateResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type TrimResult as F, type TrimStrategy as G, type ValidationResult as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type VectorSimilarityResult as L, MODEL_PRICING as M, chunkText as N, compressHtml as O, type PiiDetectResult as P, compressJson as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type UrlMatch as U, type ValidationError as V, compressMarkdown as W, deduplicateLines as X, detectPii as Y, detectPromptInjection as Z, detectSecrets as _, ai_agent as a, estimateCost as a0, estimateTokens as a1, expandQuery as a2, extractEntities as a3, extractJson as a4, extractKeywords as a5, extractTables as a6, extractUrls as a7, flattenJson as a8, mergeJson as a9, redactPii as aa, repairJson as ab, rerankChunks as ac, sanitizeHtml as ad, scoreRelevance as ae, summarizeForLlm as af, trimToTokens as ag, unflattenJson as ah, validateJsonSchema as ai, vectorSimilarity as aj, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type InjectionFinding as n, type JsonRepairResult as o, type MergeResult as p, type MergeStrategy as q, type ModelPricing as r, type PiiFinding as s, type PiiType as t, type RelevanceResult as u, type SecretDetectResult as v, type SecretFinding as w, type SecretType as x, type SummaryResult as y, type TextChunk as z };
+export { detectPii as $, type SummaryResult as A, type TextChunk as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type TokenEstimate as G, type TokenEstimateResult as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type TrimResult as L, MODEL_PRICING as M, type TrimStrategy as N, type ValidationResult as O, type PiiDetectResult as P, type VectorSimilarityResult as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type UrlMatch as U, type ValidationError as V, chunkText as W, compressHtml as X, compressJson as Y, compressMarkdown as Z, deduplicateLines as _, ai_agent as a, detectPromptInjection as a0, detectSecrets as a1, diffJson as a2, estimateCost as a3, estimateTokens as a4, expandQuery as a5, extractEntities as a6, extractJson as a7, extractKeywords as a8, extractTables as a9, extractUrls as aa, flattenJson as ab, formatFewShotExamples as ac, mergeJson as ad, redactPii as ae, repairJson as af, rerankChunks as ag, sanitizeHtml as ah, scoreRelevance as ai, summarizeForLlm as aj, trimToTokens as ak, unflattenJson as al, validateJsonSchema as am, vectorSimilarity as an, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type RelevanceResult as w, type SecretDetectResult as x, type SecretFinding as y, type SecretType as z };

package/dist/{chunk-AFEZ6N4A.js → chunk-H2USEUHD.js}

@@ -10,6 +10,7 @@ __export(text_exports, {
   LINE_OPS: () => LINE_OPS,
   MORSE_CODE: () => MORSE_CODE,
   addBorder: () => addBorder,
+  analyzeSentenceLengths: () => analyzeSentenceLengths,
   analyzeText: () => analyzeText,
   applyOp: () => applyOp,
   applyOps: () => applyOps,
@@ -2598,5 +2599,70 @@ function calculateStringDistance(a, b, options) {
   const similarity = maxLength === 0 ? 1 : Math.round((1 - distance / maxLength) * 1e4) / 1e4;
   return { a, b, distance, similarity, maxLength, mode };
 }
+function splitIntoSentencesForLengthDist(text) {
+  const matches = text.match(/[^.!?]+[.!?]*/g);
+  if (!matches) return [];
+  return matches.map((s) => s.trim()).filter((s) => s.length > 0);
+}
+function countWordsInSentence(sentence) {
+  return (sentence.match(/[a-zA-Z']+/g) ?? []).length;
+}
+function analyzeSentenceLengths(text) {
+  const sentences = splitIntoSentencesForLengthDist(text);
+  const lengths = sentences.map(countWordsInSentence).filter((n) => n > 0);
+  if (lengths.length === 0) {
+    return {
+      sentenceCount: 0,
+      lengths: [],
+      minLength: 0,
+      maxLength: 0,
+      meanLength: 0,
+      medianLength: 0,
+      stdDev: 0,
+      coefficientOfVariation: 0,
+      consistency: "No sentences to analyze",
+      buckets: []
+    };
+  }
+  const sentenceCount2 = lengths.length;
+  const minLength = Math.min(...lengths);
+  const maxLength = Math.max(...lengths);
+  const meanLength = lengths.reduce((a, b) => a + b, 0) / sentenceCount2;
+  const sorted = [...lengths].sort((a, b) => a - b);
+  const mid = Math.floor(sorted.length / 2);
+  const medianLength = sorted.length % 2 === 0 ? (sorted[mid - 1] + sorted[mid]) / 2 : sorted[mid];
+  const variance = lengths.reduce((sum, n) => sum + (n - meanLength) ** 2, 0) / sentenceCount2;
+  const stdDev = Math.sqrt(variance);
+  const coefficientOfVariation = meanLength > 0 ? stdDev / meanLength : 0;
+  let consistency;
+  if (coefficientOfVariation < 0.3) consistency = "Consistent \u2014 sentence lengths vary little";
+  else if (coefficientOfVariation < 0.6) consistency = "Moderate variation in sentence length";
+  else consistency = "Highly variable sentence length";
+  const bucketWidth = 5;
+  const bucketCount = Math.max(1, Math.ceil(maxLength / bucketWidth));
+  const buckets = [];
+  for (let i = 0; i < bucketCount; i++) {
+    const min = i * bucketWidth + 1;
+    const max = (i + 1) * bucketWidth;
+    buckets.push({ label: `${min}-${max}`, min, max, count: 0 });
+  }
+  for (const len of lengths) {
+    const idx = Math.min(Math.floor((len - 1) / bucketWidth), bucketCount - 1);
+    buckets[idx].count++;
+  }
+  const round2 = (n) => Math.round(n * 100) / 100;
+  return {
+    sentenceCount: sentenceCount2,
+    lengths,
+    minLength,
+    maxLength,
+    meanLength: round2(meanLength),
+    medianLength: round2(medianLength),
+    stdDev: round2(stdDev),
+    coefficientOfVariation: round2(coefficientOfVariation),
+    consistency,
+    buckets
+  };
+}
 
-export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeText, applyOp, applyOps, calculateStringDistance, centerText, convertAll, convertCase, countWords, csvToHtml, csvToMarkdown, detectDelimiter, detectFillerWords, detectPassiveVoice, diffLines, diffLinesSimple, diffStats, escapeAll, escapeString, extractHeadings, formatReadingTime, generate, generateDiff, generateHtmlTable, generateMarkdownTable, generateParagraphs, generateSentences, generateWords, getAvailableFonts, getMorseForChar, getMorseTiming, htmlToMarkdown, isValidMorse, markdownToHtml, morseToText, numberToOrdinal, numberToRoman, numberToWords, ordinalWords, parseDiff, parseTableData, readabilityScore, renderMarkdown, romanToNumber, scoreReadability, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, text_exports, unescapeString, wordFrequency };
+export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeSentenceLengths, analyzeText, applyOp, applyOps, calculateStringDistance, centerText, convertAll, convertCase, countWords, csvToHtml, csvToMarkdown, detectDelimiter, detectFillerWords, detectPassiveVoice, diffLines, diffLinesSimple, diffStats, escapeAll, escapeString, extractHeadings, formatReadingTime, generate, generateDiff, generateHtmlTable, generateMarkdownTable, generateParagraphs, generateSentences, generateWords, getAvailableFonts, getMorseForChar, getMorseTiming, htmlToMarkdown, isValidMorse, markdownToHtml, morseToText, numberToOrdinal, numberToRoman, numberToWords, ordinalWords, parseDiff, parseTableData, readabilityScore, renderMarkdown, romanToNumber, scoreReadability, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, text_exports, unescapeString, wordFrequency };

package/dist/{chunk-LXKIPPDG.js → chunk-UUT5HNST.js}

@@ -6,6 +6,7 @@ var code_exports = {};
 __export(code_exports, {
   ALL_FLAGS: () => ALL_FLAGS,
   CHEATSHEET: () => CHEATSHEET,
+  DEFAULT_COMMIT_TYPES: () => DEFAULT_COMMIT_TYPES,
   MIME_TABLE: () => MIME_TABLE,
   OPERATIONS: () => OPERATIONS,
   SQL_DEFAULT_OPTIONS: () => SQL_DEFAULT_OPTIONS,
@@ -30,6 +31,7 @@ __export(code_exports, {
   getJsStats: () => getJsStats,
   getMethodColor: () => getMethodColor,
   isValidTag: () => isValidTag,
+  lintConventionalCommit: () => lintConventionalCommit,
   lookupMime: () => lookupMime,
   minifyCss: () => minifyCss,
   minifyGql: () => minifyGql,
@@ -2740,5 +2742,123 @@ function detectRedos(pattern) {
     findings: unique
   };
 }
+var DEFAULT_COMMIT_TYPES = ["build", "chore", "ci", "docs", "feat", "fix", "perf", "refactor", "revert", "style", "test"];
+var _DEFAULT_MAX_HEADER_LENGTH = 100;
+var _COMMIT_HEADER_RE = /^([A-Za-z][A-Za-z0-9-]*)(\(([^()]*)\))?(!)?: (.+)$/;
+var _COMMIT_FOOTER_LINE_RE = /^([A-Za-z][A-Za-z0-9-]*|BREAKING CHANGE)(: ?| #)(.*)$/;
+var _COMMIT_BREAKING_LOOKALIKE_RE = /^([A-Za-z][A-Za-z -]*?)(: | #)(.*)$/;
+var _COMMIT_BREAKING_TOKEN_RE = /^breaking[- ]change$/i;
+function lintConventionalCommit(message, options = {}) {
+  if (typeof message !== "string" || message.trim() === "") {
+    return { error: "message is required" };
+  }
+  if (message.length > 2e4) {
+    return { error: "message too long (max 20,000 chars)" };
+  }
+  const types = options.types && options.types.length > 0 ? options.types : DEFAULT_COMMIT_TYPES;
+  const maxHeaderLength = options.maxHeaderLength ?? _DEFAULT_MAX_HEADER_LENGTH;
+  const findings = [];
+  const lines = message.replace(/\r\n/g, "\n").split("\n");
+  const header = lines[0];
+  const match = header.match(_COMMIT_HEADER_RE);
+  const parsed = {
+    header,
+    type: null,
+    scope: null,
+    breaking: false,
+    description: null,
+    body: null,
+    footers: []
+  };
+  if (!match) {
+    findings.push({
+      rule: "header-format",
+      severity: "error",
+      message: "Header must match '<type>[(scope)][!]: <description>', e.g. 'feat(auth): add OAuth2 login'. A single space must follow the colon."
+    });
+    return { message, valid: false, parsed, findings };
+  }
+  const [, type, scopeGroup, scope, bang, description] = match;
+  parsed.type = type;
+  if (scopeGroup !== void 0) {
+    const scopeContent = (scope ?? "").trim();
+    if (scopeContent === "") {
+      findings.push({ rule: "scope-empty", severity: "error", message: "Scope parentheses are present but empty; either remove the parentheses or put a scope inside them, e.g. fix(parser):." });
+    } else {
+      parsed.scope = scopeContent;
+    }
+  }
+  const trimmedDescription = description.trim();
+  if (trimmedDescription === "") {
+    findings.push({ rule: "subject-empty", severity: "error", message: "The description after the colon must not be empty." });
+  } else {
+    parsed.description = trimmedDescription;
+    if (trimmedDescription.endsWith(".")) {
+      findings.push({ rule: "subject-full-stop", severity: "warning", message: "The description should not end with a period." });
+    }
+  }
+  if (!types.includes(type.toLowerCase())) {
+    findings.push({
+      rule: "type-unknown",
+      severity: "warning",
+      message: `'${type}' is not one of the recognized types (${types.join(", ")}). This is only a convention, not a spec requirement, so a custom type is fine if your team has agreed on it.`
+    });
+  }
+  if (type !== type.toLowerCase()) {
+    findings.push({ rule: "type-case", severity: "warning", message: "The type is conventionally lower-case. The spec itself is not case-sensitive about this, but nearly every tool and team defaults to lower-case." });
+  }
+  if (header.length > maxHeaderLength) {
+    findings.push({ rule: "header-max-length", severity: "warning", message: `Header is ${header.length} characters, longer than the recommended maximum of ${maxHeaderLength}.` });
+  }
+  let breaking = bang === "!";
+  if (lines.length > 1) {
+    if (lines[1].trim() !== "") {
+      findings.push({ rule: "missing-blank-line-before-body", severity: "error", message: "A blank line must separate the header from the body or footer." });
+    }
+    const rest = lines.slice(1).join("\n");
+    const paragraphs = rest.split(/\n{2,}/).map((p) => p.trim()).filter((p) => p !== "");
+    let footerParagraph = null;
+    if (paragraphs.length > 0) {
+      const last = paragraphs[paragraphs.length - 1];
+      const lastLines = last.split("\n");
+      if (lastLines.every((l) => _COMMIT_FOOTER_LINE_RE.test(l.trim()))) {
+        footerParagraph = last;
+        paragraphs.pop();
+      }
+    }
+    parsed.body = paragraphs.length > 0 ? paragraphs.join("\n\n") : null;
+    if (footerParagraph) {
+      for (const line of footerParagraph.split("\n")) {
+        const fm = line.trim().match(_COMMIT_FOOTER_LINE_RE);
+        if (!fm) continue;
+        const [, token, , value] = fm;
+        parsed.footers.push({ token, value: value.trim() });
+      }
+    }
+    for (const f of parsed.footers) {
+      if (_COMMIT_BREAKING_TOKEN_RE.test(f.token) && f.token !== "BREAKING CHANGE" && f.token !== "BREAKING-CHANGE") {
+        findings.push({ rule: "breaking-change-casing", severity: "error", message: `Found '${f.token}:' as a footer, but the spec requires the breaking-change token to be exactly 'BREAKING CHANGE' or 'BREAKING-CHANGE' (uppercase).` });
+      }
+    }
+    for (const p of paragraphs) {
+      for (const line of p.split("\n")) {
+        const bm = line.trim().match(_COMMIT_BREAKING_LOOKALIKE_RE);
+        if (bm && _COMMIT_BREAKING_TOKEN_RE.test(bm[1]) && bm[1] !== "BREAKING CHANGE") {
+          findings.push({ rule: "breaking-change-casing", severity: "error", message: `Found '${bm[1]}' near the end of the message, but it wasn't recognized as a breaking-change footer. The spec requires the exact uppercase token 'BREAKING CHANGE' (or 'BREAKING-CHANGE'), immediately followed by ': '.` });
+        }
+      }
+    }
+  }
+  const breakingFooter = parsed.footers.find((f) => f.token === "BREAKING CHANGE" || f.token === "BREAKING-CHANGE");
+  if (breakingFooter) {
+    breaking = true;
+    if (breakingFooter.value === "") {
+      findings.push({ rule: "breaking-change-empty", severity: "error", message: "A 'BREAKING CHANGE:' footer must be followed by a description of the breaking change." });
+    }
+  }
+  parsed.breaking = breaking;
+  const valid = !findings.some((f) => f.severity === "error");
+  return { message, valid, parsed, findings };
+}
 
-export { ALL_FLAGS, CHEATSHEET, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testPattern, testRegex, validateEnvKey };
+export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testPattern, testRegex, validateEnvKey };

package/dist/{chunk-265NPGKH.js → chunk-W3J7GZVQ.js}

@@ -22,6 +22,7 @@ __export(ai_agent_exports, {
   extractTables: () => extractTables,
   extractUrls: () => extractUrls,
   flattenJson: () => flattenJson,
+  formatFewShotExamples: () => formatFewShotExamples,
   mergeJson: () => mergeJson,
   redactPii: () => redactPii,
   repairJson: () => repairJson,
@@ -979,5 +980,28 @@ function vectorSimilarity(a, b) {
     magnitudeB: round6(magB)
   };
 }
+function formatFewShotExamples(examples, format = "numbered", delimiter = "---") {
+  const valid = (examples ?? []).filter((e) => e?.input?.trim() && e?.output?.trim());
+  if (valid.length === 0) {
+    return { formatted: "", exampleCount: 0, format };
+  }
+  let formatted;
+  if (format === "xml") {
+    formatted = valid.map((e) => `<example>
+  <input>${e.input.trim()}</input>
+  <output>${e.output.trim()}</output>
+</example>`).join("\n\n");
+  } else if (format === "delimiter") {
+    formatted = valid.map((e) => `Input: ${e.input.trim()}
+Output: ${e.output.trim()}`).join(`
+${delimiter}
+`);
+  } else {
+    formatted = valid.map((e, i) => `Example ${i + 1}:
+Input: ${e.input.trim()}
+Output: ${e.output.trim()}`).join("\n\n");
+  }
+  return { formatted, exampleCount: valid.length, format };
+}
 
-export { MODEL_PRICING, ai_agent_exports, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractTables, extractUrls, flattenJson, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity };
+export { MODEL_PRICING, ai_agent_exports, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractTables, extractUrls, flattenJson, formatFewShotExamples, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity };

package/dist/{chunk-GDIZWDBY.js → chunk-ZPQOE7KD.js}

@@ -27,6 +27,7 @@ __export(units_exports, {
   calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
   calculateRuleOf72: () => calculateRuleOf72,
+  calculateSavingsGoal: () => calculateSavingsGoal,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
   calculateTimeValue: () => calculateTimeValue,
@@ -1732,5 +1733,81 @@ function calculateEmi(principal, annualRatePercent, tenure, tenureUnit = "years"
     yearlyBreakdown
   };
 }
+function calculateSavingsGoal(input) {
+  const { mode, goalAmount, currentSavings, annualInterestRatePercent, monthlyContribution, months } = input;
+  if (mode !== "time-to-goal" && mode !== "contribution-for-target") {
+    return { error: "mode must be 'time-to-goal' or 'contribution-for-target'" };
+  }
+  if (!Number.isFinite(goalAmount) || goalAmount <= 0) return { error: "goalAmount must be a finite number greater than zero" };
+  if (!Number.isFinite(currentSavings) || currentSavings < 0) return { error: "currentSavings must be a finite, non-negative number" };
+  if (!Number.isFinite(annualInterestRatePercent) || annualInterestRatePercent < 0) {
+    return { error: "annualInterestRatePercent must be a finite, non-negative number" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const r = annualInterestRatePercent / 100 / 12;
+  if (mode === "time-to-goal") {
+    if (typeof monthlyContribution !== "number" || !Number.isFinite(monthlyContribution) || monthlyContribution < 0) {
+      return { error: "monthlyContribution must be a finite, non-negative number" };
+    }
+    let exactMonths;
+    if (currentSavings >= goalAmount) {
+      exactMonths = 0;
+    } else if (monthlyContribution === 0) {
+      if (r === 0) return { error: "monthlyContribution must be greater than zero when annualInterestRatePercent is zero, since savings would never grow toward the goal" };
+      if (currentSavings <= 0) return { error: "monthlyContribution must be greater than zero when currentSavings is zero, since there is nothing to compound" };
+      exactMonths = Math.log(goalAmount / currentSavings) / Math.log(1 + r);
+    } else if (r === 0) {
+      exactMonths = (goalAmount - currentSavings) / monthlyContribution;
+    } else {
+      const denom = currentSavings + monthlyContribution / r;
+      const x = (goalAmount + monthlyContribution / r) / denom;
+      exactMonths = Math.log(x) / Math.log(1 + r);
+    }
+    const monthsRounded = Math.max(0, Math.ceil(exactMonths));
+    const finalBalance = r === 0 ? currentSavings + monthlyContribution * monthsRounded : currentSavings * Math.pow(1 + r, monthsRounded) + monthlyContribution * ((Math.pow(1 + r, monthsRounded) - 1) / r);
+    const totalContributed2 = monthlyContribution * monthsRounded;
+    const totalInterestEarned2 = finalBalance - currentSavings - totalContributed2;
+    return {
+      mode,
+      goalAmount: round4(goalAmount),
+      currentSavings: round4(currentSavings),
+      annualInterestRatePercent: round4(annualInterestRatePercent),
+      monthlyContribution: round4(monthlyContribution),
+      months: round4(exactMonths),
+      monthsRounded,
+      years: round4(monthsRounded / 12),
+      totalContributed: round4(totalContributed2),
+      totalInterestEarned: round4(totalInterestEarned2),
+      finalBalance: round4(finalBalance)
+    };
+  }
+  if (typeof months !== "number" || !Number.isFinite(months) || !Number.isInteger(months) || months <= 0) {
+    return { error: "months must be a positive integer" };
+  }
+  const growthOfCurrentSavings = r === 0 ? currentSavings : currentSavings * Math.pow(1 + r, months);
+  let requiredMonthlyContribution;
+  if (growthOfCurrentSavings >= goalAmount) {
+    requiredMonthlyContribution = 0;
+  } else if (r === 0) {
+    requiredMonthlyContribution = (goalAmount - currentSavings) / months;
+  } else {
+    requiredMonthlyContribution = (goalAmount - growthOfCurrentSavings) * r / (Math.pow(1 + r, months) - 1);
+  }
+  const totalContributed = requiredMonthlyContribution * months;
+  const totalInterestEarned = goalAmount - currentSavings - totalContributed;
+  return {
+    mode,
+    goalAmount: round4(goalAmount),
+    currentSavings: round4(currentSavings),
+    annualInterestRatePercent: round4(annualInterestRatePercent),
+    monthlyContribution: round4(requiredMonthlyContribution),
+    months,
+    monthsRounded: months,
+    years: round4(months / 12),
+    totalContributed: round4(totalContributed),
+    totalInterestEarned: round4(totalInterestEarned),
+    finalBalance: round4(goalAmount)
+  };
+}
 
-export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCompoundInterest, calculateDiscount, calculateEmi, calculateLoan, calculateMarginMarkup, calculatePercentageChange, calculateRuleOf72, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, compareSemver, convert, convertAprApy, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, marginToMarkup, markupToMargin, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCompoundInterest, calculateDiscount, calculateEmi, calculateLoan, calculateMarginMarkup, calculatePercentageChange, calculateRuleOf72, calculateSavingsGoal, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, compareSemver, convert, convertAprApy, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, marginToMarkup, markupToMargin, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };