@utilix-tech/sdk 0.16.0 → 0.18.0

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 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.18.0
+- Added Present Value / Future Value Calculator (`calculateTimeValue`) and Vector Similarity Calculator (`vectorSimilarity`).
+
+## 0.17.0
+- Added User-Agent Parser (`parseUserAgent`) and GitHub URL Parser (`parseGithubUrl`).
+
 ## 0.16.0
 - Added Simple Interest Calculator (`calculateSimpleInterest`) and Base58 / Base62 Encoder (`base58Encode`, `base58Decode`, `base62Encode`, `base62Decode`).
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**548 developer utility functions for Node.js: runs locally, no API key required.**
+**553 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)
@@ -247,7 +247,7 @@ getNextRuns("*/5 * * * *", 5);  // next 5 run timestamps
 ### `/units`: Conversions
 
 ```ts
-import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest } from "@utilix-tech/sdk/units";
+import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -301,6 +301,10 @@ calculateTipSplit(84.5, 18, 2);
 // Simple (non-compounding) interest: principal x rate x time
 calculateSimpleInterest(1000, 5, 2);
 // { interest: 100, totalPayoff: 1100, ... }
+
+// Present / future value (time value of money), either direction
+calculateTimeValue(1000, 5, 10, "future");
+// { presentValue: 1000, futureValue: 1628.89, growthFactor: 1.628895, ... }
 ```
 
 ---
@@ -310,7 +314,8 @@ calculateSimpleInterest(1000, 5, 2);
 ```ts
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
-         parseHar, validateSitemap, validateRobotsTxt } from "@utilix-tech/sdk/network";
+         parseHar, validateSitemap, validateRobotsTxt,
+         parseUserAgent } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -323,6 +328,11 @@ isValidIp("256.0.0.1");       // false
 
 countryCodeToFlag("US");       // "🇺🇸"
 
+// User-Agent parsing
+parseUserAgent("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36");
+// { browser: { name: "Chrome", version: "120.0.0.0" }, engine: { name: "Blink", version: "120.0.0.0" },
+//   os: { name: "Windows", version: "10" }, device: { type: "desktop" }, raw: "..." }
+
 // Parse a DevTools .har network export into entries + summary stats
 const har = await fs.promises.readFile("network.har", "utf-8");
 parseHar(har);
@@ -379,7 +389,7 @@ generateCspHeader({ "default-src": ["'self'"], "script-src": ["'self'", "cdn.exa
 
 ```ts
 import { formatSql, minifySql, testRegex, formatHtml, formatGql,
-         detectDialect, splitStatements, lookupMime } from "@utilix-tech/sdk/code";
+         detectDialect, splitStatements, lookupMime, parseGithubUrl } from "@utilix-tech/sdk/code";
 
 // SQL
 formatSql("SELECT id,name FROM users WHERE active=1 ORDER BY name");
@@ -407,6 +417,10 @@ formatGql("query { user(id: 1) { name email } }");
 // MIME type lookup, either direction
 lookupMime("json");        // { kind: "extension", matches: [{ extension: "json", mimeType: "application/json" }] }
 lookupMime("image/jpeg");  // { kind: "mime", matches: [{ extension: "jpg", ... }, { extension: "jpeg", ... }] }
+
+// GitHub URL parsing
+parseGithubUrl("https://github.com/facebook/react/pull/1234");
+// { owner: "facebook", repo: "react", type: "pull", number: 1234 }
 ```
 
 ---
@@ -536,13 +550,13 @@ readIcoInfo(new Uint8Array(icoBytes));
 | `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, 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, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator |
-| `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing |
+| `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing |
 | `@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 |
+| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing |
 | `@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 |
+| `@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/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; WAV audio info; ID3 tags; ICO favicon inspection |
 
 ---

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

@@ -314,6 +314,25 @@ interface SummaryResult {
     sentencesTotal: number;
 }
 declare function summarizeForLlm(text: string, maxTokens?: number, strategy?: 'extractive' | 'first' | 'last'): SummaryResult;
+interface VectorSimilarityResult {
+    dimensions: number;
+    dotProduct: number;
+    cosineSimilarity: number;
+    euclideanDistance: number;
+    manhattanDistance: number;
+    magnitudeA: number;
+    magnitudeB: number;
+}
+/**
+ * Compute cosine similarity, dot product, Euclidean distance, and Manhattan
+ * distance between two equal-length numeric vectors. Useful for debugging a
+ * RAG pipeline that already has embedding vectors from an external model.
+ * Cosine similarity is undefined when either vector is all zeros; this
+ * returns 0 in that case.
+ */
+declare function vectorSimilarity(a: number[], b: number[]): VectorSimilarityResult | {
+    error: string;
+};
 
 type ai_agent_ChunkStrategy = ChunkStrategy;
 type ai_agent_CompressHtmlResult = CompressHtmlResult;
@@ -358,6 +377,7 @@ type ai_agent_TrimStrategy = TrimStrategy;
 type ai_agent_UrlMatch = UrlMatch;
 type ai_agent_ValidationError = ValidationError;
 type ai_agent_ValidationResult = ValidationResult;
+type ai_agent_VectorSimilarityResult = VectorSimilarityResult;
 declare const ai_agent_chunkText: typeof chunkText;
 declare const ai_agent_compressHtml: typeof compressHtml;
 declare const ai_agent_compressJson: typeof compressJson;
@@ -386,8 +406,9 @@ declare const ai_agent_summarizeForLlm: typeof summarizeForLlm;
 declare const ai_agent_trimToTokens: typeof trimToTokens;
 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, 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 };
+  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 { estimateCost 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, chunkText as L, MODEL_PRICING as M, compressHtml as N, compressJson as O, type PiiDetectResult as P, compressMarkdown as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type UrlMatch as U, type ValidationError as V, deduplicateLines as W, detectPii as X, detectPromptInjection as Y, detectSecrets as Z, diffJson as _, ai_agent as a, estimateTokens as a0, expandQuery as a1, extractEntities as a2, extractJson as a3, extractKeywords as a4, extractTables as a5, extractUrls as a6, flattenJson as a7, mergeJson as a8, redactPii as a9, repairJson as aa, rerankChunks as ab, sanitizeHtml as ac, scoreRelevance as ad, summarizeForLlm as ae, trimToTokens as af, unflattenJson as ag, validateJsonSchema as ah, 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 { 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 };

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

@@ -314,6 +314,25 @@ interface SummaryResult {
     sentencesTotal: number;
 }
 declare function summarizeForLlm(text: string, maxTokens?: number, strategy?: 'extractive' | 'first' | 'last'): SummaryResult;
+interface VectorSimilarityResult {
+    dimensions: number;
+    dotProduct: number;
+    cosineSimilarity: number;
+    euclideanDistance: number;
+    manhattanDistance: number;
+    magnitudeA: number;
+    magnitudeB: number;
+}
+/**
+ * Compute cosine similarity, dot product, Euclidean distance, and Manhattan
+ * distance between two equal-length numeric vectors. Useful for debugging a
+ * RAG pipeline that already has embedding vectors from an external model.
+ * Cosine similarity is undefined when either vector is all zeros; this
+ * returns 0 in that case.
+ */
+declare function vectorSimilarity(a: number[], b: number[]): VectorSimilarityResult | {
+    error: string;
+};
 
 type ai_agent_ChunkStrategy = ChunkStrategy;
 type ai_agent_CompressHtmlResult = CompressHtmlResult;
@@ -358,6 +377,7 @@ type ai_agent_TrimStrategy = TrimStrategy;
 type ai_agent_UrlMatch = UrlMatch;
 type ai_agent_ValidationError = ValidationError;
 type ai_agent_ValidationResult = ValidationResult;
+type ai_agent_VectorSimilarityResult = VectorSimilarityResult;
 declare const ai_agent_chunkText: typeof chunkText;
 declare const ai_agent_compressHtml: typeof compressHtml;
 declare const ai_agent_compressJson: typeof compressJson;
@@ -386,8 +406,9 @@ declare const ai_agent_summarizeForLlm: typeof summarizeForLlm;
 declare const ai_agent_trimToTokens: typeof trimToTokens;
 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, 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 };
+  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 { estimateCost 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, chunkText as L, MODEL_PRICING as M, compressHtml as N, compressJson as O, type PiiDetectResult as P, compressMarkdown as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type UrlMatch as U, type ValidationError as V, deduplicateLines as W, detectPii as X, detectPromptInjection as Y, detectSecrets as Z, diffJson as _, ai_agent as a, estimateTokens as a0, expandQuery as a1, extractEntities as a2, extractJson as a3, extractKeywords as a4, extractTables as a5, extractUrls as a6, flattenJson as a7, mergeJson as a8, redactPii as a9, repairJson as aa, rerankChunks as ab, sanitizeHtml as ac, scoreRelevance as ad, summarizeForLlm as ae, trimToTokens as af, unflattenJson as ag, validateJsonSchema as ah, 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 { 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 };

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

@@ -31,7 +31,8 @@ __export(ai_agent_exports, {
   summarizeForLlm: () => summarizeForLlm,
   trimToTokens: () => trimToTokens,
   unflattenJson: () => unflattenJson,
-  validateJsonSchema: () => validateJsonSchema
+  validateJsonSchema: () => validateJsonSchema,
+  vectorSimilarity: () => vectorSimilarity
 });
 var MODEL_PRICING = [
   { model: "gpt-4o", label: "GPT-4o", inputPer1M: 5, outputPer1M: 15 },
@@ -949,5 +950,34 @@ function summarizeForLlm(text, maxTokens = 200, strategy = "extractive") {
   const st = tok(summary);
   return { summary, originalTokens: ot, summaryTokens: st, compressionRatio: Math.round(st / Math.max(1, ot) * 100) / 100, sentencesKept: picked.length, sentencesTotal: sents.length };
 }
+function vectorSimilarity(a, b) {
+  if (!Array.isArray(a) || !Array.isArray(b)) return { error: "Both inputs must be arrays of numbers" };
+  if (a.length === 0 || b.length === 0) return { error: "Vectors must not be empty" };
+  if (a.length !== b.length) return { error: `Vectors must have the same length (got ${a.length} and ${b.length})` };
+  if (!a.every((n) => typeof n === "number" && Number.isFinite(n)) || !b.every((n) => typeof n === "number" && Number.isFinite(n))) {
+    return { error: "Vectors must contain only finite numbers" };
+  }
+  const round6 = (n) => Math.round(n * 1e6) / 1e6;
+  let dot = 0, sa = 0, sb = 0, sqDist = 0, absDist = 0;
+  for (let i = 0; i < a.length; i++) {
+    dot += a[i] * b[i];
+    sa += a[i] * a[i];
+    sb += b[i] * b[i];
+    const d = a[i] - b[i];
+    sqDist += d * d;
+    absDist += Math.abs(d);
+  }
+  const magA = Math.sqrt(sa), magB = Math.sqrt(sb);
+  const cosine = magA === 0 || magB === 0 ? 0 : dot / (magA * magB);
+  return {
+    dimensions: a.length,
+    dotProduct: round6(dot),
+    cosineSimilarity: round6(cosine),
+    euclideanDistance: round6(Math.sqrt(sqDist)),
+    manhattanDistance: round6(absDist),
+    magnitudeA: round6(magA),
+    magnitudeB: round6(magB)
+  };
+}
 
-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 };
+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 };

package/dist/{chunk-OB56VNKJ.js → chunk-3QMUUTBH.js}

@@ -26,6 +26,7 @@ __export(network_exports, {
   parseDnsResponse: () => parseDnsResponse,
   parseGeoResponse: () => parseGeoResponse,
   parseHar: () => parseHar,
+  parseUserAgent: () => parseUserAgent,
   searchHeaders: () => searchHeaders,
   searchStatusCodes: () => searchStatusCodes,
   statusCodeToText: () => statusCodeToText,
@@ -1615,5 +1616,110 @@ function validateRobotsTxt(text) {
   const valid = !issues.some((i) => i.severity === "error");
   return { groups, sitemaps, issues, valid };
 }
+var UA_BOT_PATTERNS = [
+  [/googlebot/i, "Googlebot"],
+  [/bingbot/i, "Bingbot"],
+  [/slurp/i, "Slurp"],
+  [/duckduckbot/i, "DuckDuckBot"],
+  [/baiduspider/i, "Baiduspider"],
+  [/yandexbot/i, "YandexBot"],
+  [/facebookexternalhit/i, "Facebot"],
+  [/twitterbot/i, "Twitterbot"],
+  [/applebot/i, "Applebot"],
+  [/discordbot/i, "Discordbot"],
+  [/slackbot/i, "Slackbot"],
+  [/telegrambot/i, "TelegramBot"],
+  [/whatsapp/i, "WhatsApp"],
+  [/ahrefsbot/i, "AhrefsBot"],
+  [/semrushbot/i, "SemrushBot"],
+  [/crawler|spider|\bbot\b/i, "Bot"]
+];
+function _detectUaBrowser(s) {
+  let m;
+  if (m = s.match(/Edg(?:A|iOS)?\/([\d.]+)/)) return { name: "Edge", version: m[1] };
+  if (m = s.match(/Edge\/([\d.]+)/)) return { name: "Edge (Legacy)", version: m[1] };
+  if (m = s.match(/OPR\/([\d.]+)/)) return { name: "Opera", version: m[1] };
+  if (m = s.match(/Opera\/([\d.]+)/)) return { name: "Opera", version: m[1] };
+  if (m = s.match(/SamsungBrowser\/([\d.]+)/)) return { name: "Samsung Internet", version: m[1] };
+  if (m = s.match(/FxiOS\/([\d.]+)/)) return { name: "Firefox", version: m[1] };
+  if (m = s.match(/Firefox\/([\d.]+)/)) return { name: "Firefox", version: m[1] };
+  if (m = s.match(/CriOS\/([\d.]+)/)) return { name: "Chrome", version: m[1] };
+  if (m = s.match(/Chrome\/([\d.]+)/)) return { name: "Chrome", version: m[1] };
+  if (m = s.match(/Version\/([\d.]+).*Safari\//)) return { name: "Safari", version: m[1] };
+  if (/Safari\//.test(s)) return { name: "Safari", version: "" };
+  if (m = s.match(/MSIE ([\d.]+)/)) return { name: "Internet Explorer", version: m[1] };
+  if (m = s.match(/Trident\/.*rv:([\d.]+)/)) return { name: "Internet Explorer", version: m[1] };
+  return { name: "Unknown", version: "" };
+}
+function _detectUaEngine(s, browserName) {
+  let m;
+  if (/Chrome\/|CriOS\/|Edg\/|OPR\/|SamsungBrowser\//.test(s)) {
+    m = s.match(/Chrome\/([\d.]+)/) || s.match(/CriOS\/([\d.]+)/);
+    return { name: "Blink", version: m ? m[1] : "" };
+  }
+  if (/Firefox\/|FxiOS\//.test(s)) {
+    m = s.match(/rv:([\d.]+)/);
+    return { name: "Gecko", version: m ? m[1] : "" };
+  }
+  if (m = s.match(/AppleWebKit\/([\d.]+)/)) return { name: "WebKit", version: m[1] };
+  if (m = s.match(/Trident\/([\d.]+)/)) return { name: "Trident", version: m[1] };
+  if (browserName === "Edge (Legacy)") return { name: "EdgeHTML", version: "" };
+  return { name: "Unknown", version: "" };
+}
+var UA_WINDOWS_VERSIONS = {
+  "10.0": "10",
+  "6.3": "8.1",
+  "6.2": "8",
+  "6.1": "7",
+  "6.0": "Vista",
+  "5.1": "XP"
+};
+function _detectUaOs(s) {
+  if (/Windows NT/.test(s)) return "Windows";
+  if (/CrOS/.test(s)) return "ChromeOS";
+  if (/Android/.test(s)) return "Android";
+  if (/iPhone|iPad|iPod/.test(s)) return "iOS";
+  if (/Mac OS X/.test(s)) return "macOS";
+  if (/Linux/.test(s)) return "Linux";
+  return "Unknown";
+}
+function _detectUaOsVersion(s) {
+  let m;
+  if (m = s.match(/Windows NT ([\d.]+)/)) return UA_WINDOWS_VERSIONS[m[1]] ?? m[1];
+  if (/CrOS/.test(s) && (m = s.match(/CrOS \S+ ([\d.]+)/))) return m[1];
+  if (m = s.match(/Android ([\d.]+)/)) return m[1];
+  if (m = s.match(/(?:iPhone|CPU) OS ([\d_]+)/)) return m[1].replace(/_/g, ".");
+  if (m = s.match(/Mac OS X ([\d_]+)/)) return m[1].replace(/_/g, ".");
+  return "";
+}
+function _detectUaDeviceType(s) {
+  if (/iPad/.test(s)) return "tablet";
+  if (/Android/.test(s) && !/Mobile/.test(s)) return "tablet";
+  if (/Mobile|iPhone|iPod|Android/.test(s)) return "mobile";
+  return "desktop";
+}
+function parseUserAgent(ua) {
+  if (!ua || typeof ua !== "string" || ua.trim() === "") {
+    return { error: "Empty user-agent string" };
+  }
+  const s = ua.trim();
+  for (const [re, name] of UA_BOT_PATTERNS) {
+    if (re.test(s)) {
+      const versionMatch = s.match(new RegExp(`${name.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}\\/([\\d.]+)`, "i"));
+      return {
+        browser: { name, version: versionMatch ? versionMatch[1] : "" },
+        engine: { name: "Unknown", version: "" },
+        os: { name: _detectUaOs(s), version: _detectUaOsVersion(s) },
+        device: { type: "bot" },
+        raw: s
+      };
+    }
+  }
+  const browser = _detectUaBrowser(s);
+  const engine = _detectUaEngine(s, browser.name);
+  const os = { name: _detectUaOs(s), version: _detectUaOsVersion(s) };
+  const device = { type: _detectUaDeviceType(s) };
+  return { browser, engine, os, device, raw: s };
+}
 
-export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };
+export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };

package/dist/{chunk-Y5X34JAC.js → chunk-L53LAVAD.js}

@@ -39,6 +39,7 @@ __export(code_exports, {
   parseDockerImage: () => parseDockerImage,
   parseEnv: () => parseEnv,
   parseGitCommand: () => parseGitCommand,
+  parseGithubUrl: () => parseGithubUrl,
   parseSpec: () => parseSpec,
   removeConsoleCalls: () => removeConsoleCalls,
   removeEmptyAttributes: () => removeEmptyAttributes,
@@ -2412,5 +2413,67 @@ function lookupMime(query) {
   if (matches.length === 0) return { error: `No known MIME type for extension ".${ext}"` };
   return { query: trimmed, kind: "extension", matches };
 }
+function _parseGithubLineRange(hash) {
+  const m = hash.match(/^#?L(\d+)(?:-L?(\d+))?$/i);
+  if (!m) return {};
+  const startLine = parseInt(m[1], 10);
+  const endLine = m[2] ? parseInt(m[2], 10) : void 0;
+  return endLine !== void 0 ? { startLine, endLine } : { startLine };
+}
+function parseGithubUrl(input) {
+  if (!input || typeof input !== "string" || input.trim() === "") {
+    return { error: "Empty URL" };
+  }
+  const trimmed = input.trim();
+  const normalized = /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`;
+  let url;
+  try {
+    url = new URL(normalized);
+  } catch {
+    return { error: "Invalid URL" };
+  }
+  if (!/^(www\.)?github\.com$/i.test(url.hostname)) {
+    return { error: `Not a github.com URL (got host "${url.hostname}")` };
+  }
+  const segments = url.pathname.split("/").filter(Boolean);
+  if (segments.length < 2) {
+    return { error: "URL must include an owner and a repository" };
+  }
+  const [owner, repo, ...rest] = segments;
+  if (rest.length === 0) {
+    return { owner, repo, type: "repo" };
+  }
+  const kind = rest[0];
+  if (kind === "pull" || kind === "issues") {
+    const number = parseInt(rest[1], 10);
+    if (!rest[1] || Number.isNaN(number)) {
+      return { error: `Missing ${kind === "pull" ? "pull request" : "issue"} number` };
+    }
+    return { owner, repo, type: kind === "pull" ? "pull" : "issue", number };
+  }
+  if (kind === "commit") {
+    if (!rest[1]) return { error: "Missing commit SHA" };
+    return { owner, repo, type: "commit", ref: rest[1] };
+  }
+  if (kind === "blob") {
+    const ref = rest[1];
+    const path = rest.slice(2).join("/");
+    if (!ref || !path) return { error: "File URL must include a ref and a file path (/blob/<ref>/<path>)" };
+    return { owner, repo, type: "file", ref, path, ..._parseGithubLineRange(url.hash) };
+  }
+  if (kind === "tree") {
+    const ref = rest[1];
+    if (!ref) return { error: "Missing branch or tag ref (/tree/<ref>)" };
+    const path = rest.slice(2).join("/");
+    return { owner, repo, type: "tree", ref, ...path ? { path } : {} };
+  }
+  if (kind === "releases") {
+    if (rest[1] !== "tag" || !rest[2]) {
+      return { error: "Unsupported releases URL (expected /releases/tag/<name>)" };
+    }
+    return { owner, repo, type: "release", ref: rest[2] };
+  }
+  return { error: `Unsupported GitHub URL path: /${rest.join("/")}` };
+}
 
-export { ALL_FLAGS, CHEATSHEET, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, envToExport, envToJson, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseDockerImage, parseEnv, parseGitCommand, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testPattern, testRegex, validateEnvKey };
+export { ALL_FLAGS, CHEATSHEET, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, 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 };

package/dist/{chunk-M4MMO6C6.js → chunk-U34B5XPK.js}

@@ -22,6 +22,7 @@ __export(units_exports, {
   calculateLoan: () => calculateLoan,
   calculateSimpleInterest: () => calculateSimpleInterest,
   calculateTax: () => calculateTax,
+  calculateTimeValue: () => calculateTimeValue,
   calculateTipSplit: () => calculateTipSplit,
   compareSemver: () => compareSemver,
   convert: () => convert,
@@ -1297,5 +1298,44 @@ function calculateSimpleInterest(principal, annualRatePercent, years) {
     totalPayoff: round22(principal + interest)
   };
 }
+function calculateTimeValue(amount, annualRatePercent, years, direction, compoundsPerYear = 1) {
+  if (!Number.isFinite(amount) || amount < 0) return { error: "Amount must be zero or a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (!Number.isFinite(years) || years <= 0) return { error: "Years must be a positive number" };
+  if (!Number.isInteger(compoundsPerYear) || compoundsPerYear <= 0) {
+    return { error: "Compounding frequency must be a positive whole number of periods per year" };
+  }
+  if (direction !== "future" && direction !== "present") {
+    return { error: 'Direction must be "future" or "present"' };
+  }
+  const round22 = (n) => Math.round(n * 100) / 100;
+  const round6 = (n) => Math.round(n * 1e6) / 1e6;
+  const ratePerPeriod = annualRatePercent / 100 / compoundsPerYear;
+  const totalPeriods = years * compoundsPerYear;
+  const growthFactor = Math.pow(1 + ratePerPeriod, totalPeriods);
+  let presentValue;
+  let futureValue;
+  if (direction === "future") {
+    presentValue = amount;
+    futureValue = amount * growthFactor;
+  } else {
+    futureValue = amount;
+    presentValue = amount / growthFactor;
+  }
+  return {
+    direction,
+    annualRatePercent,
+    years,
+    compoundsPerYear,
+    totalPeriods,
+    ratePerPeriodPercent: round6(ratePerPeriod * 100),
+    growthFactor: round6(growthFactor),
+    presentValue: round22(presentValue),
+    futureValue: round22(futureValue),
+    interest: round22(futureValue - presentValue)
+  };
+}
 
-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, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateCompoundInterest, calculateLoan, calculateSimpleInterest, calculateTax, calculateTipSplit, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, 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, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateCompoundInterest, calculateLoan, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, compareSemver, convert, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, 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 };

package/dist/{code-C4skwg3l.d.cts → code-Cn9uOIAh.d.cts}

@@ -18,6 +18,7 @@
  *   - env-parser       (parseEnv, envToJson, envToExport, validateEnvKey)
  *   - css-minifier     (minifyCss, formatCss, countRules, countProperties)
  *   - mime-lookup      (lookupMime, MIME_TABLE)
+ *   - github-url-parser (parseGithubUrl)
  */
 type RegexFlag = 'g' | 'i' | 'm' | 's' | 'u';
 declare const ALL_FLAGS: RegexFlag[];
@@ -285,6 +286,27 @@ declare const MIME_TABLE: MimeEntry[];
 declare function lookupMime(query: string): MimeLookupResult | {
     error: string;
 };
+type GithubUrlType = 'repo' | 'pull' | 'issue' | 'commit' | 'file' | 'tree' | 'release';
+interface GithubUrlInfo {
+    owner: string;
+    repo: string;
+    type: GithubUrlType;
+    number?: number;
+    ref?: string;
+    path?: string;
+    startLine?: number;
+    endLine?: number;
+}
+/**
+ * Parses a github.com URL (repo, pull request, issue, commit, or a
+ * file/tree with an optional line range) into structured components via
+ * the path segments GitHub's own routing uses. Only covers github.com URLs
+ * over HTTP(S): SSH remotes (git@github.com:owner/repo.git) and other Git
+ * hosts are out of scope.
+ */
+declare function parseGithubUrl(input: string): GithubUrlInfo | {
+    error: string;
+};
 
 declare const code_ALL_FLAGS: typeof ALL_FLAGS;
 type code_ApiEndpoint = ApiEndpoint;
@@ -298,6 +320,8 @@ type code_EnvParseResult = EnvParseResult;
 type code_GitCommandConfig = GitCommandConfig;
 type code_GitCommandResult = GitCommandResult;
 type code_GitOperation = GitOperation;
+type code_GithubUrlInfo = GithubUrlInfo;
+type code_GithubUrlType = GithubUrlType;
 type code_GqlFormatResult = GqlFormatResult;
 type code_HtmlFormatResult = HtmlFormatResult;
 type code_HtmlMinifyOptions = HtmlMinifyOptions;
@@ -351,6 +375,7 @@ declare const code_normalizeRef: typeof normalizeRef;
 declare const code_parseDockerImage: typeof parseDockerImage;
 declare const code_parseEnv: typeof parseEnv;
 declare const code_parseGitCommand: typeof parseGitCommand;
+declare const code_parseGithubUrl: typeof parseGithubUrl;
 declare const code_parseSpec: typeof parseSpec;
 declare const code_removeConsoleCalls: typeof removeConsoleCalls;
 declare const code_removeEmptyAttributes: typeof removeEmptyAttributes;
@@ -364,7 +389,7 @@ declare const code_testPattern: typeof testPattern;
 declare const code_testRegex: typeof testRegex;
 declare const code_validateEnvKey: typeof validateEnvKey;
 declare namespace code {
-  export { code_ALL_FLAGS as ALL_FLAGS, type code_ApiEndpoint as ApiEndpoint, type code_ApiInfo as ApiInfo, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_CssResult as CssResult, type code_DockerImageRef as DockerImageRef, type code_EnvEntry as EnvEntry, type code_EnvParseResult as EnvParseResult, type code_GitCommandConfig as GitCommandConfig, type code_GitCommandResult as GitCommandResult, type code_GitOperation as GitOperation, type code_GqlFormatResult as GqlFormatResult, type code_HtmlFormatResult as HtmlFormatResult, type code_HtmlMinifyOptions as HtmlMinifyOptions, type code_HtmlMinifyResult as HtmlMinifyResult, type code_JsMinifyOptions as JsMinifyOptions, type code_JsMinifyResult as JsMinifyResult, code_MIME_TABLE as MIME_TABLE, type code_MatchResult as MatchResult, type code_MimeEntry as MimeEntry, type code_MimeLookupResult as MimeLookupResult, code_OPERATIONS as OPERATIONS, type code_ParsedSpec as ParsedSpec, type code_RegexError as RegexError, type code_RegexFlag as RegexFlag, type code_RegexMatch as RegexMatch, type code_RegexResult as RegexResult, type code_RegexSuccess as RegexSuccess, code_SQL_DEFAULT_OPTIONS as SQL_DEFAULT_OPTIONS, type code_Segment as Segment, type code_SpecVersion as SpecVersion, type code_SqlDialect as SqlDialect, type code_SqlFormatOptions as SqlFormatOptions, type code_TestPatternResult as TestPatternResult, code_buildDockerPull as buildDockerPull, code_buildDockerRun as buildDockerRun, code_buildGitCommand as buildGitCommand, code_collapseHtmlWhitespace as collapseHtmlWhitespace, code_collapseJsWhitespace as collapseJsWhitespace, code_countProperties as countProperties, code_countRules as countRules, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_envToExport as envToExport, code_envToJson as envToJson, code_formatCss as formatCss, code_formatGql as formatGql, code_formatHtml as formatHtml, code_formatSql as formatSql, code_getEndpointsByTag as getEndpointsByTag, code_getHtmlStats as getHtmlStats, code_getJsStats as getJsStats, code_getMethodColor as getMethodColor, code_isValidTag as isValidTag, code_lookupMime as lookupMime, code_minifyCss as minifyCss, code_minifyGql as minifyGql, code_minifyHtml as minifyHtml, code_minifyJs as minifyJs, code_minifySql as minifySql, code_normalizeRef as normalizeRef, code_parseDockerImage as parseDockerImage, code_parseEnv as parseEnv, code_parseGitCommand as parseGitCommand, code_parseSpec as parseSpec, code_removeConsoleCalls as removeConsoleCalls, code_removeEmptyAttributes as removeEmptyAttributes, code_removeHtmlComments as removeHtmlComments, code_removeJsComments as removeJsComments, code_removeRedundantAttributes as removeRedundantAttributes, code_searchCheatsheet as searchCheatsheet, code_searchEndpoints as searchEndpoints, code_splitStatements as splitStatements, code_testPattern as testPattern, code_testRegex as testRegex, code_validateEnvKey as validateEnvKey };
+  export { code_ALL_FLAGS as ALL_FLAGS, type code_ApiEndpoint as ApiEndpoint, type code_ApiInfo as ApiInfo, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_CssResult as CssResult, type code_DockerImageRef as DockerImageRef, type code_EnvEntry as EnvEntry, type code_EnvParseResult as EnvParseResult, type code_GitCommandConfig as GitCommandConfig, type code_GitCommandResult as GitCommandResult, type code_GitOperation as GitOperation, type code_GithubUrlInfo as GithubUrlInfo, type code_GithubUrlType as GithubUrlType, type code_GqlFormatResult as GqlFormatResult, type code_HtmlFormatResult as HtmlFormatResult, type code_HtmlMinifyOptions as HtmlMinifyOptions, type code_HtmlMinifyResult as HtmlMinifyResult, type code_JsMinifyOptions as JsMinifyOptions, type code_JsMinifyResult as JsMinifyResult, code_MIME_TABLE as MIME_TABLE, type code_MatchResult as MatchResult, type code_MimeEntry as MimeEntry, type code_MimeLookupResult as MimeLookupResult, code_OPERATIONS as OPERATIONS, type code_ParsedSpec as ParsedSpec, type code_RegexError as RegexError, type code_RegexFlag as RegexFlag, type code_RegexMatch as RegexMatch, type code_RegexResult as RegexResult, type code_RegexSuccess as RegexSuccess, code_SQL_DEFAULT_OPTIONS as SQL_DEFAULT_OPTIONS, type code_Segment as Segment, type code_SpecVersion as SpecVersion, type code_SqlDialect as SqlDialect, type code_SqlFormatOptions as SqlFormatOptions, type code_TestPatternResult as TestPatternResult, code_buildDockerPull as buildDockerPull, code_buildDockerRun as buildDockerRun, code_buildGitCommand as buildGitCommand, code_collapseHtmlWhitespace as collapseHtmlWhitespace, code_collapseJsWhitespace as collapseJsWhitespace, code_countProperties as countProperties, code_countRules as countRules, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_envToExport as envToExport, code_envToJson as envToJson, code_formatCss as formatCss, code_formatGql as formatGql, code_formatHtml as formatHtml, code_formatSql as formatSql, code_getEndpointsByTag as getEndpointsByTag, code_getHtmlStats as getHtmlStats, code_getJsStats as getJsStats, code_getMethodColor as getMethodColor, code_isValidTag as isValidTag, code_lookupMime as lookupMime, code_minifyCss as minifyCss, code_minifyGql as minifyGql, code_minifyHtml as minifyHtml, code_minifyJs as minifyJs, code_minifySql as minifySql, code_normalizeRef as normalizeRef, code_parseDockerImage as parseDockerImage, code_parseEnv as parseEnv, code_parseGitCommand as parseGitCommand, code_parseGithubUrl as parseGithubUrl, code_parseSpec as parseSpec, code_removeConsoleCalls as removeConsoleCalls, code_removeEmptyAttributes as removeEmptyAttributes, code_removeHtmlComments as removeHtmlComments, code_removeJsComments as removeJsComments, code_removeRedundantAttributes as removeRedundantAttributes, code_searchCheatsheet as searchCheatsheet, code_searchEndpoints as searchEndpoints, code_splitStatements as splitStatements, code_testPattern as testPattern, code_testRegex as testRegex, code_validateEnvKey as validateEnvKey };
 }
 
-export { getJsStats as $, ALL_FLAGS as A, collapseHtmlWhitespace as B, CHEATSHEET as C, type DockerImageRef as D, type EnvEntry as E, collapseJsWhitespace as F, type GitCommandConfig as G, type HtmlFormatResult as H, countProperties as I, type JsMinifyOptions as J, countRules as K, detectDialect as L, MIME_TABLE as M, detectOperationType as N, OPERATIONS as O, type ParsedSpec as P, envToExport as Q, type RegexError as R, SQL_DEFAULT_OPTIONS as S, type TestPatternResult as T, envToJson as U, formatCss as V, formatGql as W, formatHtml as X, formatSql as Y, getEndpointsByTag as Z, getHtmlStats as _, type ApiEndpoint as a, getMethodColor as a0, isValidTag as a1, lookupMime as a2, minifyCss as a3, minifyGql as a4, minifyHtml as a5, minifyJs as a6, minifySql as a7, normalizeRef as a8, parseDockerImage as a9, parseEnv as aa, parseGitCommand as ab, parseSpec as ac, removeConsoleCalls as ad, removeEmptyAttributes as ae, removeHtmlComments as af, removeJsComments as ag, removeRedundantAttributes as ah, searchCheatsheet as ai, searchEndpoints as aj, splitStatements as ak, testPattern as al, testRegex as am, validateEnvKey as an, type ApiInfo as b, code as c, type CheatsheetEntry as d, type CssResult as e, type EnvParseResult as f, type GitCommandResult as g, type GitOperation as h, type GqlFormatResult as i, type HtmlMinifyOptions as j, type HtmlMinifyResult as k, type JsMinifyResult as l, type MatchResult as m, type MimeEntry as n, type MimeLookupResult as o, type RegexFlag as p, type RegexMatch as q, type RegexResult as r, type RegexSuccess as s, type Segment as t, type SpecVersion as u, type SqlDialect as v, type SqlFormatOptions as w, buildDockerPull as x, buildDockerRun as y, buildGitCommand as z };
+export { getEndpointsByTag as $, ALL_FLAGS as A, buildDockerRun as B, CHEATSHEET as C, type DockerImageRef as D, type EnvEntry as E, buildGitCommand as F, type GitCommandConfig as G, type HtmlFormatResult as H, collapseHtmlWhitespace as I, type JsMinifyOptions as J, collapseJsWhitespace as K, countProperties as L, MIME_TABLE as M, countRules as N, OPERATIONS as O, type ParsedSpec as P, detectDialect as Q, type RegexError as R, SQL_DEFAULT_OPTIONS as S, type TestPatternResult as T, detectOperationType as U, envToExport as V, envToJson as W, formatCss as X, formatGql as Y, formatHtml as Z, formatSql as _, type ApiEndpoint as a, getHtmlStats as a0, getJsStats as a1, getMethodColor as a2, isValidTag as a3, lookupMime as a4, minifyCss as a5, minifyGql as a6, minifyHtml as a7, minifyJs as a8, minifySql as a9, normalizeRef as aa, parseDockerImage as ab, parseEnv as ac, parseGitCommand as ad, parseGithubUrl as ae, parseSpec as af, removeConsoleCalls as ag, removeEmptyAttributes as ah, removeHtmlComments as ai, removeJsComments as aj, removeRedundantAttributes as ak, searchCheatsheet as al, searchEndpoints as am, splitStatements as an, testPattern as ao, testRegex as ap, validateEnvKey as aq, type ApiInfo as b, code as c, type CheatsheetEntry as d, type CssResult as e, type EnvParseResult as f, type GitCommandResult as g, type GitOperation as h, type GithubUrlInfo as i, type GithubUrlType as j, type GqlFormatResult as k, type HtmlMinifyOptions as l, type HtmlMinifyResult as m, type JsMinifyResult as n, type MatchResult as o, type MimeEntry as p, type MimeLookupResult as q, type RegexFlag as r, type RegexMatch as s, type RegexResult as t, type RegexSuccess as u, type Segment as v, type SpecVersion as w, type SqlDialect as x, type SqlFormatOptions as y, buildDockerPull as z };