@utilix-tech/sdk 0.24.0 → 0.26.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.26.0
+- Add `computeJwkThumbprint` (jwk-thumbprint): RFC 7638 canonical thumbprint of a single JWK, hashed with SHA-256/384/512.
+- Add `calculateVideoBitrate` (video-bitrate-calculator): resulting file size from a video/audio bitrate and duration, or the required bitrate to hit a target file size.
+
+## 0.25.0
+- Add `calculateBreakEven` (break-even-calculator): break-even unit count and revenue from fixed costs, variable cost per unit, and price per unit, plus profit and margin of safety at an optional sales volume.
+- Add `calculateStringDistance` (string-distance): Levenshtein edit distance and normalized similarity between two strings, with an optional Damerau (transposition) mode.
+
 ## 0.24.0
 - Add `calculateDiscount` / `applySuccessiveDiscounts` (discount-calculator): solve a sale price, amount saved, or discount percent from any one of them, and stack discounts in sequence where 20% then 10% is an effective 28% off.
 - Add `parseSubtitles`, `convertSubtitles`, `shiftSubtitles`, and their timestamp/format helpers (subtitle-converter): convert between SubRip and WebVTT and shift every cue by a fixed offset.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**573 developer utility functions for Node.js: runs locally, no API key required.**
+**576 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)
@@ -137,7 +137,7 @@ generateHtpasswdFile([{ username: "alice", password: "secret" }]);
 ```ts
 import { convertCase, slugify, countWords, generateWords, generateParagraphs,
          escapeString, htmlToMarkdown, applyOps, detectPassiveVoice, scoreReadability,
-         detectFillerWords } from "@utilix-tech/sdk/text";
+         detectFillerWords, calculateStringDistance } from "@utilix-tech/sdk/text";
 
 convertCase("hello world", "camelCase");   // "helloWorld"
 convertCase("hello world", "PascalCase");  // "HelloWorld"
@@ -166,6 +166,10 @@ scoreReadability("The cat sat on the mat. It was a sunny day.");
 // Flag filler words, hedge phrases, and clichés with counts and density
 detectFillerWords("At the end of the day, I just really think we should circle back.");
 // { totalMatches: 4, fillerCount: 2, clicheCount: 2, density: 28.6, matches: [...] }
+
+// 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" }
 ```
 
 ---
@@ -268,7 +272,7 @@ formatIso8601Duration(90061);        // { iso: "P1DT1H1M1S", ... }
 ### `/units`: Conversions
 
 ```ts
-import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue, calculatePercentageChange, convertAprApy, calculateMarginMarkup, calculateDiscount, applySuccessiveDiscounts } from "@utilix-tech/sdk/units";
+import { convertBytes, pxToAll, convert, formatValue, validateCardNumber, validateIban, calculateLoan, validateBarcode, calculateTax, calculateCompoundInterest, validateIsbn, calculateTipSplit, calculateSimpleInterest, calculateTimeValue, calculatePercentageChange, convertAprApy, calculateMarginMarkup, calculateDiscount, applySuccessiveDiscounts, calculateBreakEven, calculateVideoBitrate } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -346,6 +350,14 @@ calculateDiscount({ originalPrice: 80, discountPercent: 25 });
 // Stacked discounts: 20% then a further 10% is 28% off, not 30%
 applySuccessiveDiscounts(100, [20, 10]);
 // { finalPrice: 72, totalSaved: 28, effectiveDiscountPercent: 28, sumOfDiscountPercents: 30, ... }
+
+// Break-even point: fixed costs, variable cost/unit, price/unit
+calculateBreakEven({ fixedCosts: 10000, variableCostPerUnit: 20, pricePerUnit: 50 });
+// { breakEvenUnitsRounded: 334, breakEvenRevenue: 16666.6667, contributionMarginPerUnit: 30, ... }
+
+// Video file size from a bitrate + duration, or the bitrate to hit a target size
+calculateVideoBitrate({ mode: "size-from-bitrate", durationSeconds: 600, videoBitrateKbps: 5000, audioBitrateKbps: 192 });
+// { totalBitrateKbps: 5192, fileSizeBytes: 389400000, fileSizeMB: 389.4, fileSizeMiB: 371.36, ... }
 ```
 
 ---
@@ -397,7 +409,7 @@ buildCacheControl({ visibility: "public", maxAge: 3600, mustRevalidate: true });
 ### `/api`: cURL, JWT, CORS, HTTP
 
 ```ts
-import { buildCurl, parseCurlCommand, decodeJwt, signJwt, parseJwks,
+import { buildCurl, parseCurlCommand, decodeJwt, signJwt, parseJwks, computeJwkThumbprint,
          generateCors, generateCspHeader } from "@utilix-tech/sdk/api";
 
 buildCurl({
@@ -421,6 +433,10 @@ decodeJwt("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...");
 parseJwks('{"keys":[{"kty":"RSA","use":"sig","kid":"1","n":"...","e":"AQAB"}]}');
 // { ok: true, keys: [{ kty: "RSA", kid: "1", keySize: 2048, ... }], count: 1, duplicateKids: [] }
 
+// JWK thumbprint (RFC 7638): canonical fingerprint of a single JWK
+computeJwkThumbprint('{"kty":"oct","k":"c2VjcmV0"}');
+// { ok: true, kty: "oct", hashAlg: "SHA-256", thumbprint: "DWBh0SEIAPYh1x5uvot4z3AhaikHkxNJa3Ada2fT-Cg", ... }
+
 // Generate CORS headers
 generateCors({ origins: ["https://myapp.com"], methods: ["GET", "POST"] });
 
@@ -595,11 +611,11 @@ readIcoInfo(new Uint8Array(icoBytes));
 | `@utilix-tech/sdk/json` | Format, minify, diff, validate, JSONPath, CSV↔JSON, YAML↔JSON, TS types |
 | `@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 |
+| `@utilix-tech/sdk/text` | Case convert, slugify, word count, lorem ipsum, line ops, HTML→Markdown, Levenshtein/Damerau string distance |
 | `@utilix-tech/sdk/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert, SRT/WebVTT subtitles |
 | `@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/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, break-even point calculator |
 | `@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, GitHub URL parsing |

package/dist/{api-Xl7OzIgq.d.cts → api-DmTNE4c1.d.cts}

@@ -5,6 +5,7 @@
  *  - curl-to-code    : parseCurlCommand, convertToCode
  *  - jwt-decoder     : decodeJwt, formatJwtJson
  *  - jwk-viewer      : parseJwks
+ *  - jwk-thumbprint  : computeJwkThumbprint
  *  - jwt-signer      : base64urlEncode, base64urlDecode, signJwt
  *  - cors-builder    : validateCorsConfig, generateCors
  *  - csp-builder     : generateCspHeader, generateFullHeader, parseCspHeader, validateCspConfig
@@ -106,6 +107,27 @@ type JwksParseResult = JwksResult | JwksError;
  * use the keys cryptographically: this is inspection only.
  */
 declare function parseJwks(input: string): JwksParseResult;
+type JwkThumbprintHash = 'SHA-256' | 'SHA-384' | 'SHA-512';
+interface JwkThumbprintResult {
+    ok: true;
+    kty: string;
+    hashAlg: JwkThumbprintHash;
+    members: string[];
+    canonicalJson: string;
+    thumbprint: string;
+}
+interface JwkThumbprintErrorResult {
+    ok: false;
+    error: string;
+}
+type JwkThumbprintOutcome = JwkThumbprintResult | JwkThumbprintErrorResult;
+/**
+ * Compute the RFC 7638 thumbprint of a single JWK: build the canonical JSON
+ * of its required members (lexicographic key order, no whitespace) and hash
+ * it. This is a fingerprint for identifying/matching a key, not a signature
+ * or verification, and it only accepts a bare JWK, not a JWKS set.
+ */
+declare function computeJwkThumbprint(input: string, hashAlg?: JwkThumbprintHash): JwkThumbprintOutcome;
 type JwtAlgorithm = 'HS256' | 'HS384' | 'HS512';
 interface JwtSignOptions {
     algorithm?: JwtAlgorithm;
@@ -284,6 +306,10 @@ declare const api_HTTP_METHODS: typeof HTTP_METHODS;
 type api_Header = Header;
 type api_HttpMethod = HttpMethod;
 type api_JwkSummary = JwkSummary;
+type api_JwkThumbprintErrorResult = JwkThumbprintErrorResult;
+type api_JwkThumbprintHash = JwkThumbprintHash;
+type api_JwkThumbprintOutcome = JwkThumbprintOutcome;
+type api_JwkThumbprintResult = JwkThumbprintResult;
 type api_JwksError = JwksError;
 type api_JwksParseResult = JwksParseResult;
 type api_JwksResult = JwksResult;
@@ -307,6 +333,7 @@ declare const api_base64urlEncode: typeof base64urlEncode;
 declare const api_buildCurl: typeof buildCurl;
 declare const api_buildCurlMultiline: typeof buildCurlMultiline;
 declare const api_buildUrl: typeof buildUrl;
+declare const api_computeJwkThumbprint: typeof computeJwkThumbprint;
 declare const api_convertToCode: typeof convertToCode;
 declare const api_decodeJwt: typeof decodeJwt;
 declare const api_decodeUrlComponent: typeof decodeUrlComponent;
@@ -335,7 +362,7 @@ declare const api_validateCorsConfig: typeof validateCorsConfig;
 declare const api_validateCspConfig: typeof validateCspConfig;
 declare const api_validateOgTags: typeof validateOgTags;
 declare namespace api {
-  export { api_COMMON_HEADERS as COMMON_HEADERS, api_COMMON_PRESETS as COMMON_PRESETS, api_CORS_COMMON_HEADERS as CORS_COMMON_HEADERS, type api_CorsConfig as CorsConfig, type api_CorsOutput as CorsOutput, type api_CspConfig as CspConfig, type api_CspDirective as CspDirective, type api_CspSource as CspSource, type api_CurlCommand as CurlCommand, type api_CurlConfig as CurlConfig, api_DEFAULT_CORS_CONFIG as DEFAULT_CORS_CONFIG, api_DIRECTIVE_DESCRIPTIONS as DIRECTIVE_DESCRIPTIONS, type api_DirectiveConfig as DirectiveConfig, type api_FormatResult as FormatResult, api_HTTP_METHODS as HTTP_METHODS, type api_Header as Header, type api_HttpMethod as HttpMethod, type api_JwkSummary as JwkSummary, type api_JwksError as JwksError, type api_JwksParseResult as JwksParseResult, type api_JwksResult as JwksResult, type api_JwtAlgorithm as JwtAlgorithm, type api_JwtDecodeError as JwtDecodeError, type api_JwtDecodeResult as JwtDecodeResult, type api_JwtExpiry as JwtExpiry, type api_JwtPart as JwtPart, type api_JwtResult as JwtResult, type api_JwtSignOptions as JwtSignOptions, type api_MetaTags as MetaTags, type api_OgTags as OgTags, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TwitterTags as TwitterTags, api_addParam as addParam, api_base64urlDecode as base64urlDecode, api_base64urlEncode as base64urlEncode, api_buildCurl as buildCurl, api_buildCurlMultiline as buildCurlMultiline, api_buildUrl as buildUrl, api_convertToCode as convertToCode, api_decodeJwt as decodeJwt, api_decodeUrlComponent as decodeUrlComponent, api_detectFormat as detectFormat, api_encodeUrlComponent as encodeUrlComponent, api_extractJsonPaths as extractJsonPaths, api_formatJwtJson as formatJwtJson, api_formatResponse as formatResponse, api_generateCors as generateCors, api_generateCspHeader as generateCspHeader, api_generateFullHeader as generateFullHeader, api_generateMetaHtml as generateMetaHtml, api_getParam as getParam, api_getStats as getStats, api_isValidUrl as isValidUrl, api_normalizeUrl as normalizeUrl, api_parseCspHeader as parseCspHeader, api_parseCurl as parseCurl, api_parseCurlCommand as parseCurlCommand, api_parseJwks as parseJwks, api_parseMetaTags as parseMetaTags, api_parseUrl as parseUrl, api_removeParam as removeParam, api_signJwt as signJwt, api_validateCorsConfig as validateCorsConfig, api_validateCspConfig as validateCspConfig, api_validateOgTags as validateOgTags };
+  export { api_COMMON_HEADERS as COMMON_HEADERS, api_COMMON_PRESETS as COMMON_PRESETS, api_CORS_COMMON_HEADERS as CORS_COMMON_HEADERS, type api_CorsConfig as CorsConfig, type api_CorsOutput as CorsOutput, type api_CspConfig as CspConfig, type api_CspDirective as CspDirective, type api_CspSource as CspSource, type api_CurlCommand as CurlCommand, type api_CurlConfig as CurlConfig, api_DEFAULT_CORS_CONFIG as DEFAULT_CORS_CONFIG, api_DIRECTIVE_DESCRIPTIONS as DIRECTIVE_DESCRIPTIONS, type api_DirectiveConfig as DirectiveConfig, type api_FormatResult as FormatResult, api_HTTP_METHODS as HTTP_METHODS, type api_Header as Header, type api_HttpMethod as HttpMethod, type api_JwkSummary as JwkSummary, type api_JwkThumbprintErrorResult as JwkThumbprintErrorResult, type api_JwkThumbprintHash as JwkThumbprintHash, type api_JwkThumbprintOutcome as JwkThumbprintOutcome, type api_JwkThumbprintResult as JwkThumbprintResult, type api_JwksError as JwksError, type api_JwksParseResult as JwksParseResult, type api_JwksResult as JwksResult, type api_JwtAlgorithm as JwtAlgorithm, type api_JwtDecodeError as JwtDecodeError, type api_JwtDecodeResult as JwtDecodeResult, type api_JwtExpiry as JwtExpiry, type api_JwtPart as JwtPart, type api_JwtResult as JwtResult, type api_JwtSignOptions as JwtSignOptions, type api_MetaTags as MetaTags, type api_OgTags as OgTags, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TwitterTags as TwitterTags, api_addParam as addParam, api_base64urlDecode as base64urlDecode, api_base64urlEncode as base64urlEncode, api_buildCurl as buildCurl, api_buildCurlMultiline as buildCurlMultiline, api_buildUrl as buildUrl, api_computeJwkThumbprint as computeJwkThumbprint, api_convertToCode as convertToCode, api_decodeJwt as decodeJwt, api_decodeUrlComponent as decodeUrlComponent, api_detectFormat as detectFormat, api_encodeUrlComponent as encodeUrlComponent, api_extractJsonPaths as extractJsonPaths, api_formatJwtJson as formatJwtJson, api_formatResponse as formatResponse, api_generateCors as generateCors, api_generateCspHeader as generateCspHeader, api_generateFullHeader as generateFullHeader, api_generateMetaHtml as generateMetaHtml, api_getParam as getParam, api_getStats as getStats, api_isValidUrl as isValidUrl, api_normalizeUrl as normalizeUrl, api_parseCspHeader as parseCspHeader, api_parseCurl as parseCurl, api_parseCurlCommand as parseCurlCommand, api_parseJwks as parseJwks, api_parseMetaTags as parseMetaTags, api_parseUrl as parseUrl, api_removeParam as removeParam, api_signJwt as signJwt, api_validateCorsConfig as validateCorsConfig, api_validateCspConfig as validateCspConfig, api_validateOgTags as validateOgTags };
 }
 
-export { generateMetaHtml as $, base64urlDecode as A, base64urlEncode as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, buildCurl as E, type FormatResult as F, buildCurlMultiline as G, HTTP_METHODS as H, buildUrl as I, type JwkSummary as J, convertToCode as K, decodeJwt as L, type MetaTags as M, decodeUrlComponent as N, type OgTags as O, type ParsedUrl as P, detectFormat as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, encodeUrlComponent as U, extractJsonPaths as V, formatJwtJson as W, formatResponse as X, generateCors as Y, generateCspHeader as Z, generateFullHeader as _, api as a, getParam as a0, getStats as a1, isValidUrl as a2, normalizeUrl as a3, parseCspHeader as a4, parseCurl as a5, parseCurlCommand as a6, parseJwks as a7, parseMetaTags as a8, parseUrl as a9, removeParam as aa, signJwt as ab, validateCorsConfig as ac, validateCspConfig as ad, validateOgTags as ae, COMMON_PRESETS as b, CORS_COMMON_HEADERS as c, type CorsConfig as d, type CorsOutput as e, type CspConfig as f, type CspDirective as g, type CspSource as h, type CurlCommand as i, type CurlConfig as j, DIRECTIVE_DESCRIPTIONS as k, type DirectiveConfig as l, type Header as m, type HttpMethod as n, type JwksError as o, type JwksParseResult as p, type JwksResult as q, type JwtAlgorithm as r, type JwtDecodeError as s, type JwtDecodeResult as t, type JwtExpiry as u, type JwtPart as v, type JwtResult as w, type JwtSignOptions as x, type TwitterTags as y, addParam as z };
+export { formatJwtJson as $, type JwtResult as A, type JwtSignOptions as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, type TwitterTags as E, type FormatResult as F, addParam as G, HTTP_METHODS as H, base64urlDecode as I, type JwkSummary as J, base64urlEncode as K, buildCurl as L, type MetaTags as M, buildCurlMultiline as N, type OgTags as O, type ParsedUrl as P, buildUrl as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, computeJwkThumbprint as U, convertToCode as V, decodeJwt as W, decodeUrlComponent as X, detectFormat as Y, encodeUrlComponent as Z, extractJsonPaths as _, api as a, formatResponse as a0, generateCors as a1, generateCspHeader as a2, generateFullHeader as a3, generateMetaHtml as a4, getParam as a5, getStats as a6, isValidUrl as a7, normalizeUrl as a8, parseCspHeader as a9, parseCurl as aa, parseCurlCommand as ab, parseJwks as ac, parseMetaTags as ad, parseUrl as ae, removeParam as af, signJwt as ag, validateCorsConfig as ah, validateCspConfig as ai, validateOgTags as aj, COMMON_PRESETS as b, CORS_COMMON_HEADERS as c, type CorsConfig as d, type CorsOutput as e, type CspConfig as f, type CspDirective as g, type CspSource as h, type CurlCommand as i, type CurlConfig as j, DIRECTIVE_DESCRIPTIONS as k, type DirectiveConfig as l, type Header as m, type HttpMethod as n, type JwkThumbprintErrorResult as o, type JwkThumbprintHash as p, type JwkThumbprintOutcome as q, type JwkThumbprintResult as r, type JwksError as s, type JwksParseResult as t, type JwksResult as u, type JwtAlgorithm as v, type JwtDecodeError as w, type JwtDecodeResult as x, type JwtExpiry as y, type JwtPart as z };

package/dist/{api-Xl7OzIgq.d.ts → api-DmTNE4c1.d.ts}

@@ -5,6 +5,7 @@
  *  - curl-to-code    : parseCurlCommand, convertToCode
  *  - jwt-decoder     : decodeJwt, formatJwtJson
  *  - jwk-viewer      : parseJwks
+ *  - jwk-thumbprint  : computeJwkThumbprint
  *  - jwt-signer      : base64urlEncode, base64urlDecode, signJwt
  *  - cors-builder    : validateCorsConfig, generateCors
  *  - csp-builder     : generateCspHeader, generateFullHeader, parseCspHeader, validateCspConfig
@@ -106,6 +107,27 @@ type JwksParseResult = JwksResult | JwksError;
  * use the keys cryptographically: this is inspection only.
  */
 declare function parseJwks(input: string): JwksParseResult;
+type JwkThumbprintHash = 'SHA-256' | 'SHA-384' | 'SHA-512';
+interface JwkThumbprintResult {
+    ok: true;
+    kty: string;
+    hashAlg: JwkThumbprintHash;
+    members: string[];
+    canonicalJson: string;
+    thumbprint: string;
+}
+interface JwkThumbprintErrorResult {
+    ok: false;
+    error: string;
+}
+type JwkThumbprintOutcome = JwkThumbprintResult | JwkThumbprintErrorResult;
+/**
+ * Compute the RFC 7638 thumbprint of a single JWK: build the canonical JSON
+ * of its required members (lexicographic key order, no whitespace) and hash
+ * it. This is a fingerprint for identifying/matching a key, not a signature
+ * or verification, and it only accepts a bare JWK, not a JWKS set.
+ */
+declare function computeJwkThumbprint(input: string, hashAlg?: JwkThumbprintHash): JwkThumbprintOutcome;
 type JwtAlgorithm = 'HS256' | 'HS384' | 'HS512';
 interface JwtSignOptions {
     algorithm?: JwtAlgorithm;
@@ -284,6 +306,10 @@ declare const api_HTTP_METHODS: typeof HTTP_METHODS;
 type api_Header = Header;
 type api_HttpMethod = HttpMethod;
 type api_JwkSummary = JwkSummary;
+type api_JwkThumbprintErrorResult = JwkThumbprintErrorResult;
+type api_JwkThumbprintHash = JwkThumbprintHash;
+type api_JwkThumbprintOutcome = JwkThumbprintOutcome;
+type api_JwkThumbprintResult = JwkThumbprintResult;
 type api_JwksError = JwksError;
 type api_JwksParseResult = JwksParseResult;
 type api_JwksResult = JwksResult;
@@ -307,6 +333,7 @@ declare const api_base64urlEncode: typeof base64urlEncode;
 declare const api_buildCurl: typeof buildCurl;
 declare const api_buildCurlMultiline: typeof buildCurlMultiline;
 declare const api_buildUrl: typeof buildUrl;
+declare const api_computeJwkThumbprint: typeof computeJwkThumbprint;
 declare const api_convertToCode: typeof convertToCode;
 declare const api_decodeJwt: typeof decodeJwt;
 declare const api_decodeUrlComponent: typeof decodeUrlComponent;
@@ -335,7 +362,7 @@ declare const api_validateCorsConfig: typeof validateCorsConfig;
 declare const api_validateCspConfig: typeof validateCspConfig;
 declare const api_validateOgTags: typeof validateOgTags;
 declare namespace api {
-  export { api_COMMON_HEADERS as COMMON_HEADERS, api_COMMON_PRESETS as COMMON_PRESETS, api_CORS_COMMON_HEADERS as CORS_COMMON_HEADERS, type api_CorsConfig as CorsConfig, type api_CorsOutput as CorsOutput, type api_CspConfig as CspConfig, type api_CspDirective as CspDirective, type api_CspSource as CspSource, type api_CurlCommand as CurlCommand, type api_CurlConfig as CurlConfig, api_DEFAULT_CORS_CONFIG as DEFAULT_CORS_CONFIG, api_DIRECTIVE_DESCRIPTIONS as DIRECTIVE_DESCRIPTIONS, type api_DirectiveConfig as DirectiveConfig, type api_FormatResult as FormatResult, api_HTTP_METHODS as HTTP_METHODS, type api_Header as Header, type api_HttpMethod as HttpMethod, type api_JwkSummary as JwkSummary, type api_JwksError as JwksError, type api_JwksParseResult as JwksParseResult, type api_JwksResult as JwksResult, type api_JwtAlgorithm as JwtAlgorithm, type api_JwtDecodeError as JwtDecodeError, type api_JwtDecodeResult as JwtDecodeResult, type api_JwtExpiry as JwtExpiry, type api_JwtPart as JwtPart, type api_JwtResult as JwtResult, type api_JwtSignOptions as JwtSignOptions, type api_MetaTags as MetaTags, type api_OgTags as OgTags, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TwitterTags as TwitterTags, api_addParam as addParam, api_base64urlDecode as base64urlDecode, api_base64urlEncode as base64urlEncode, api_buildCurl as buildCurl, api_buildCurlMultiline as buildCurlMultiline, api_buildUrl as buildUrl, api_convertToCode as convertToCode, api_decodeJwt as decodeJwt, api_decodeUrlComponent as decodeUrlComponent, api_detectFormat as detectFormat, api_encodeUrlComponent as encodeUrlComponent, api_extractJsonPaths as extractJsonPaths, api_formatJwtJson as formatJwtJson, api_formatResponse as formatResponse, api_generateCors as generateCors, api_generateCspHeader as generateCspHeader, api_generateFullHeader as generateFullHeader, api_generateMetaHtml as generateMetaHtml, api_getParam as getParam, api_getStats as getStats, api_isValidUrl as isValidUrl, api_normalizeUrl as normalizeUrl, api_parseCspHeader as parseCspHeader, api_parseCurl as parseCurl, api_parseCurlCommand as parseCurlCommand, api_parseJwks as parseJwks, api_parseMetaTags as parseMetaTags, api_parseUrl as parseUrl, api_removeParam as removeParam, api_signJwt as signJwt, api_validateCorsConfig as validateCorsConfig, api_validateCspConfig as validateCspConfig, api_validateOgTags as validateOgTags };
+  export { api_COMMON_HEADERS as COMMON_HEADERS, api_COMMON_PRESETS as COMMON_PRESETS, api_CORS_COMMON_HEADERS as CORS_COMMON_HEADERS, type api_CorsConfig as CorsConfig, type api_CorsOutput as CorsOutput, type api_CspConfig as CspConfig, type api_CspDirective as CspDirective, type api_CspSource as CspSource, type api_CurlCommand as CurlCommand, type api_CurlConfig as CurlConfig, api_DEFAULT_CORS_CONFIG as DEFAULT_CORS_CONFIG, api_DIRECTIVE_DESCRIPTIONS as DIRECTIVE_DESCRIPTIONS, type api_DirectiveConfig as DirectiveConfig, type api_FormatResult as FormatResult, api_HTTP_METHODS as HTTP_METHODS, type api_Header as Header, type api_HttpMethod as HttpMethod, type api_JwkSummary as JwkSummary, type api_JwkThumbprintErrorResult as JwkThumbprintErrorResult, type api_JwkThumbprintHash as JwkThumbprintHash, type api_JwkThumbprintOutcome as JwkThumbprintOutcome, type api_JwkThumbprintResult as JwkThumbprintResult, type api_JwksError as JwksError, type api_JwksParseResult as JwksParseResult, type api_JwksResult as JwksResult, type api_JwtAlgorithm as JwtAlgorithm, type api_JwtDecodeError as JwtDecodeError, type api_JwtDecodeResult as JwtDecodeResult, type api_JwtExpiry as JwtExpiry, type api_JwtPart as JwtPart, type api_JwtResult as JwtResult, type api_JwtSignOptions as JwtSignOptions, type api_MetaTags as MetaTags, type api_OgTags as OgTags, type api_ParsedUrl as ParsedUrl, type api_ResponseFormat as ResponseFormat, api_SUPPORTED_LANGUAGES as SUPPORTED_LANGUAGES, type api_TargetLanguage as TargetLanguage, type api_TwitterTags as TwitterTags, api_addParam as addParam, api_base64urlDecode as base64urlDecode, api_base64urlEncode as base64urlEncode, api_buildCurl as buildCurl, api_buildCurlMultiline as buildCurlMultiline, api_buildUrl as buildUrl, api_computeJwkThumbprint as computeJwkThumbprint, api_convertToCode as convertToCode, api_decodeJwt as decodeJwt, api_decodeUrlComponent as decodeUrlComponent, api_detectFormat as detectFormat, api_encodeUrlComponent as encodeUrlComponent, api_extractJsonPaths as extractJsonPaths, api_formatJwtJson as formatJwtJson, api_formatResponse as formatResponse, api_generateCors as generateCors, api_generateCspHeader as generateCspHeader, api_generateFullHeader as generateFullHeader, api_generateMetaHtml as generateMetaHtml, api_getParam as getParam, api_getStats as getStats, api_isValidUrl as isValidUrl, api_normalizeUrl as normalizeUrl, api_parseCspHeader as parseCspHeader, api_parseCurl as parseCurl, api_parseCurlCommand as parseCurlCommand, api_parseJwks as parseJwks, api_parseMetaTags as parseMetaTags, api_parseUrl as parseUrl, api_removeParam as removeParam, api_signJwt as signJwt, api_validateCorsConfig as validateCorsConfig, api_validateCspConfig as validateCspConfig, api_validateOgTags as validateOgTags };
 }
 
-export { generateMetaHtml as $, base64urlDecode as A, base64urlEncode as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, buildCurl as E, type FormatResult as F, buildCurlMultiline as G, HTTP_METHODS as H, buildUrl as I, type JwkSummary as J, convertToCode as K, decodeJwt as L, type MetaTags as M, decodeUrlComponent as N, type OgTags as O, type ParsedUrl as P, detectFormat as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, encodeUrlComponent as U, extractJsonPaths as V, formatJwtJson as W, formatResponse as X, generateCors as Y, generateCspHeader as Z, generateFullHeader as _, api as a, getParam as a0, getStats as a1, isValidUrl as a2, normalizeUrl as a3, parseCspHeader as a4, parseCurl as a5, parseCurlCommand as a6, parseJwks as a7, parseMetaTags as a8, parseUrl as a9, removeParam as aa, signJwt as ab, validateCorsConfig as ac, validateCspConfig as ad, validateOgTags as ae, COMMON_PRESETS as b, CORS_COMMON_HEADERS as c, type CorsConfig as d, type CorsOutput as e, type CspConfig as f, type CspDirective as g, type CspSource as h, type CurlCommand as i, type CurlConfig as j, DIRECTIVE_DESCRIPTIONS as k, type DirectiveConfig as l, type Header as m, type HttpMethod as n, type JwksError as o, type JwksParseResult as p, type JwksResult as q, type JwtAlgorithm as r, type JwtDecodeError as s, type JwtDecodeResult as t, type JwtExpiry as u, type JwtPart as v, type JwtResult as w, type JwtSignOptions as x, type TwitterTags as y, addParam as z };
+export { formatJwtJson as $, type JwtResult as A, type JwtSignOptions as B, COMMON_HEADERS as C, DEFAULT_CORS_CONFIG as D, type TwitterTags as E, type FormatResult as F, addParam as G, HTTP_METHODS as H, base64urlDecode as I, type JwkSummary as J, base64urlEncode as K, buildCurl as L, type MetaTags as M, buildCurlMultiline as N, type OgTags as O, type ParsedUrl as P, buildUrl as Q, type ResponseFormat as R, SUPPORTED_LANGUAGES as S, type TargetLanguage as T, computeJwkThumbprint as U, convertToCode as V, decodeJwt as W, decodeUrlComponent as X, detectFormat as Y, encodeUrlComponent as Z, extractJsonPaths as _, api as a, formatResponse as a0, generateCors as a1, generateCspHeader as a2, generateFullHeader as a3, generateMetaHtml as a4, getParam as a5, getStats as a6, isValidUrl as a7, normalizeUrl as a8, parseCspHeader as a9, parseCurl as aa, parseCurlCommand as ab, parseJwks as ac, parseMetaTags as ad, parseUrl as ae, removeParam as af, signJwt as ag, validateCorsConfig as ah, validateCspConfig as ai, validateOgTags as aj, COMMON_PRESETS as b, CORS_COMMON_HEADERS as c, type CorsConfig as d, type CorsOutput as e, type CspConfig as f, type CspDirective as g, type CspSource as h, type CurlCommand as i, type CurlConfig as j, DIRECTIVE_DESCRIPTIONS as k, type DirectiveConfig as l, type Header as m, type HttpMethod as n, type JwkThumbprintErrorResult as o, type JwkThumbprintHash as p, type JwkThumbprintOutcome as q, type JwkThumbprintResult as r, type JwksError as s, type JwksParseResult as t, type JwksResult as u, type JwtAlgorithm as v, type JwtDecodeError as w, type JwtDecodeResult as x, type JwtExpiry as y, type JwtPart as z };

package/dist/{chunk-Q3B3YWOA.js → chunk-52ZDKSIX.js}

@@ -1,5 +1,5 @@
 import { __export } from './chunk-MLKGABMK.js';
-import { createHmac } from 'crypto';
+import { createHash, createHmac } from 'crypto';
 
 // src/tools/api.ts
 var api_exports = {};
@@ -17,6 +17,7 @@ __export(api_exports, {
   buildCurl: () => buildCurl,
   buildCurlMultiline: () => buildCurlMultiline,
   buildUrl: () => buildUrl,
+  computeJwkThumbprint: () => computeJwkThumbprint,
   convertToCode: () => convertToCode,
   decodeJwt: () => decodeJwt,
   decodeUrlComponent: () => decodeUrlComponent,
@@ -535,6 +536,48 @@ function parseJwks(input) {
   const duplicateKids = [...kidCounts.entries()].filter(([, c]) => c > 1).map(([kid]) => kid);
   return { ok: true, keys, count: keys.length, duplicateKids };
 }
+var JWK_THUMBPRINT_MEMBERS = {
+  oct: ["k", "kty"],
+  RSA: ["e", "kty", "n"],
+  EC: ["crv", "kty", "x", "y"],
+  OKP: ["crv", "kty", "x"]
+};
+var JWK_THUMBPRINT_NODE_HASH = {
+  "SHA-256": "sha256",
+  "SHA-384": "sha384",
+  "SHA-512": "sha512"
+};
+function computeJwkThumbprint(input, hashAlg = "SHA-256") {
+  const trimmed = input.trim();
+  if (!trimmed) return { ok: false, error: "No input provided" };
+  const nodeHash = JWK_THUMBPRINT_NODE_HASH[hashAlg];
+  if (!nodeHash) return { ok: false, error: 'hashAlg must be one of "SHA-256", "SHA-384", "SHA-512"' };
+  let jwk;
+  try {
+    jwk = JSON.parse(trimmed);
+  } catch (e) {
+    return { ok: false, error: `Invalid JSON: ${e instanceof Error ? e.message : String(e)}` };
+  }
+  if (jwk === null || typeof jwk !== "object" || Array.isArray(jwk)) {
+    return { ok: false, error: "Input must be a single JWK object, not a JWKS set or array" };
+  }
+  const obj = jwk;
+  const kty = obj.kty;
+  if (typeof kty !== "string") return { ok: false, error: 'JWK must have a "kty" (key type) member' };
+  const members = JWK_THUMBPRINT_MEMBERS[kty];
+  if (!members) return { ok: false, error: `Unsupported key type "${kty}": supported types are RSA, EC, oct, OKP` };
+  const canonical = {};
+  for (const m of members) {
+    const v = obj[m];
+    if (typeof v !== "string" || v.length === 0) {
+      return { ok: false, error: `JWK is missing required member "${m}" for key type "${kty}"` };
+    }
+    canonical[m] = v;
+  }
+  const canonicalJson = "{" + members.map((m) => `${JSON.stringify(m)}:${JSON.stringify(canonical[m])}`).join(",") + "}";
+  const thumbprint = createHash(nodeHash).update(canonicalJson, "utf8").digest("base64url");
+  return { ok: true, kty, hashAlg, members, canonicalJson, thumbprint };
+}
 var ALG_TO_NODE_HASH = {
   HS256: "sha256",
   HS384: "sha384",
@@ -1266,4 +1309,4 @@ function generateMetaHtml(tags) {
   return lines.join("\n");
 }
 
-export { COMMON_HEADERS, COMMON_PRESETS, CORS_COMMON_HEADERS, DEFAULT_CORS_CONFIG, DIRECTIVE_DESCRIPTIONS, HTTP_METHODS, SUPPORTED_LANGUAGES, addParam, api_exports, base64urlDecode, base64urlEncode, buildCurl, buildCurlMultiline, buildUrl, convertToCode, decodeJwt, decodeUrlComponent, detectFormat, encodeUrlComponent, extractJsonPaths, formatJwtJson, formatResponse, generateCors, generateCspHeader, generateFullHeader, generateMetaHtml, getParam, getStats, isValidUrl, normalizeUrl, parseCspHeader, parseCurl, parseCurlCommand, parseJwks, parseMetaTags, parseUrl, removeParam, signJwt, validateCorsConfig, validateCspConfig, validateOgTags };
+export { COMMON_HEADERS, COMMON_PRESETS, CORS_COMMON_HEADERS, DEFAULT_CORS_CONFIG, DIRECTIVE_DESCRIPTIONS, HTTP_METHODS, SUPPORTED_LANGUAGES, addParam, api_exports, base64urlDecode, base64urlEncode, buildCurl, buildCurlMultiline, buildUrl, computeJwkThumbprint, convertToCode, decodeJwt, decodeUrlComponent, detectFormat, encodeUrlComponent, extractJsonPaths, formatJwtJson, formatResponse, generateCors, generateCspHeader, generateFullHeader, generateMetaHtml, getParam, getStats, isValidUrl, normalizeUrl, parseCspHeader, parseCurl, parseCurlCommand, parseJwks, parseMetaTags, parseUrl, removeParam, signJwt, validateCorsConfig, validateCspConfig, validateOgTags };

package/dist/{chunk-2I4O5YCT.js → chunk-AFEZ6N4A.js}

@@ -13,6 +13,7 @@ __export(text_exports, {
   analyzeText: () => analyzeText,
   applyOp: () => applyOp,
   applyOps: () => applyOps,
+  calculateStringDistance: () => calculateStringDistance,
   centerText: () => centerText,
   convertAll: () => convertAll,
   convertCase: () => convertCase,
@@ -2556,5 +2557,46 @@ function detectFillerWords(text) {
   const density = totalWords > 0 ? Math.round(totalMatches / totalWords * 1e3) / 10 : 0;
   return { totalWords, totalMatches, fillerCount, hedgeCount, clicheCount, density, matches };
 }
+var MAX_STRING_DISTANCE_LENGTH = 5e3;
+function calculateStringDistance(a, b, options) {
+  if (typeof a !== "string" || typeof b !== "string") {
+    return { error: "Both a and b must be strings" };
+  }
+  if (a.length > MAX_STRING_DISTANCE_LENGTH || b.length > MAX_STRING_DISTANCE_LENGTH) {
+    return { error: `Strings must be at most ${MAX_STRING_DISTANCE_LENGTH} characters` };
+  }
+  const mode = options?.mode ?? "levenshtein";
+  const caseSensitive = options?.caseSensitive ?? true;
+  const s1 = caseSensitive ? a : a.toLowerCase();
+  const s2 = caseSensitive ? b : b.toLowerCase();
+  const m = s1.length;
+  const n = s2.length;
+  const maxLength = Math.max(m, n);
+  if (m === 0 || n === 0) {
+    return { a, b, distance: maxLength, similarity: maxLength === 0 ? 1 : 0, maxLength, mode };
+  }
+  const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+  for (let i = 0; i <= m; i++) dp[i][0] = i;
+  for (let j = 0; j <= n; j++) dp[0][j] = j;
+  for (let i = 1; i <= m; i++) {
+    for (let j = 1; j <= n; j++) {
+      const cost = s1[i - 1] === s2[j - 1] ? 0 : 1;
+      dp[i][j] = Math.min(
+        dp[i - 1][j] + 1,
+        // deletion
+        dp[i][j - 1] + 1,
+        // insertion
+        dp[i - 1][j - 1] + cost
+        // substitution
+      );
+      if (mode === "damerau" && i > 1 && j > 1 && s1[i - 1] === s2[j - 2] && s1[i - 2] === s2[j - 1]) {
+        dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + 1);
+      }
+    }
+  }
+  const distance = dp[m][n];
+  const similarity = maxLength === 0 ? 1 : Math.round((1 - distance / maxLength) * 1e4) / 1e4;
+  return { a, b, distance, similarity, maxLength, mode };
+}
 
-export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeText, applyOp, applyOps, 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, 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-HZIS2DMJ.js → chunk-HP6C4VBX.js}

@@ -19,6 +19,7 @@ __export(units_exports, {
   bumpVersion: () => bumpVersion,
   calcAspectRatio: () => calcAspectRatio,
   calcSubnet: () => calcSubnet,
+  calculateBreakEven: () => calculateBreakEven,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateDiscount: () => calculateDiscount,
   calculateLoan: () => calculateLoan,
@@ -28,6 +29,7 @@ __export(units_exports, {
   calculateTax: () => calculateTax,
   calculateTimeValue: () => calculateTimeValue,
   calculateTipSplit: () => calculateTipSplit,
+  calculateVideoBitrate: () => calculateVideoBitrate,
   compareSemver: () => compareSemver,
   convert: () => convert,
   convertAprApy: () => convertAprApy,
@@ -1548,5 +1550,97 @@ function applySuccessiveDiscounts(originalPrice, discountPercents) {
     steps
   };
 }
+function calculateBreakEven(input) {
+  const { fixedCosts, variableCostPerUnit, pricePerUnit, salesVolume } = input;
+  if (!Number.isFinite(fixedCosts)) return { error: "fixedCosts must be a finite number" };
+  if (!Number.isFinite(variableCostPerUnit)) return { error: "variableCostPerUnit must be a finite number" };
+  if (!Number.isFinite(pricePerUnit)) return { error: "pricePerUnit must be a finite number" };
+  if (fixedCosts < 0) return { error: "fixedCosts cannot be negative" };
+  if (variableCostPerUnit < 0) return { error: "variableCostPerUnit cannot be negative" };
+  if (pricePerUnit <= 0) return { error: "pricePerUnit must be greater than zero" };
+  if (pricePerUnit <= variableCostPerUnit) {
+    return { error: "pricePerUnit must be greater than variableCostPerUnit, otherwise every unit sold loses money and break-even is never reached" };
+  }
+  const round4 = (n) => Math.round(n * 1e4) / 1e4;
+  const contributionMarginPerUnit = pricePerUnit - variableCostPerUnit;
+  const contributionMarginRatio = contributionMarginPerUnit / pricePerUnit * 100;
+  const breakEvenUnits = fixedCosts / contributionMarginPerUnit;
+  const breakEvenUnitsRounded = Math.ceil(breakEvenUnits);
+  const breakEvenRevenue = breakEvenUnits * pricePerUnit;
+  const result = {
+    fixedCosts: round4(fixedCosts),
+    variableCostPerUnit: round4(variableCostPerUnit),
+    pricePerUnit: round4(pricePerUnit),
+    contributionMarginPerUnit: round4(contributionMarginPerUnit),
+    contributionMarginRatio: round4(contributionMarginRatio),
+    breakEvenUnits: round4(breakEvenUnits),
+    breakEvenUnitsRounded,
+    breakEvenRevenue: round4(breakEvenRevenue)
+  };
+  if (typeof salesVolume === "number" && Number.isFinite(salesVolume)) {
+    if (salesVolume < 0) return { error: "salesVolume cannot be negative" };
+    const revenueAtSalesVolume = salesVolume * pricePerUnit;
+    const profitAtSalesVolume = salesVolume * contributionMarginPerUnit - fixedCosts;
+    const marginOfSafetyUnits = salesVolume - breakEvenUnits;
+    result.salesVolume = round4(salesVolume);
+    result.revenueAtSalesVolume = round4(revenueAtSalesVolume);
+    result.profitAtSalesVolume = round4(profitAtSalesVolume);
+    result.marginOfSafetyUnits = round4(marginOfSafetyUnits);
+    result.marginOfSafetyPercent = salesVolume > 0 ? round4(marginOfSafetyUnits / salesVolume * 100) : 0;
+  }
+  return result;
+}
+function calculateVideoBitrate(input) {
+  const { mode, durationSeconds, videoBitrateKbps, targetSizeMB } = input;
+  const audioBitrateKbps = input.audioBitrateKbps ?? 0;
+  if (!Number.isFinite(durationSeconds) || durationSeconds <= 0) {
+    return { error: "durationSeconds must be a positive number" };
+  }
+  if (!Number.isFinite(audioBitrateKbps) || audioBitrateKbps < 0) {
+    return { error: "audioBitrateKbps must be zero or a positive number" };
+  }
+  const round22 = (n) => Math.round(n * 100) / 100;
+  if (mode === "size-from-bitrate") {
+    if (typeof videoBitrateKbps !== "number" || !Number.isFinite(videoBitrateKbps) || videoBitrateKbps <= 0) {
+      return { error: 'videoBitrateKbps must be a positive number for mode "size-from-bitrate"' };
+    }
+    const totalBitrateKbps = videoBitrateKbps + audioBitrateKbps;
+    const fileSizeBytes = totalBitrateKbps * 1e3 * durationSeconds / 8;
+    return {
+      mode,
+      durationSeconds,
+      videoBitrateKbps: round22(videoBitrateKbps),
+      audioBitrateKbps: round22(audioBitrateKbps),
+      totalBitrateKbps: round22(totalBitrateKbps),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round22(fileSizeBytes / 1e6),
+      fileSizeMiB: round22(fileSizeBytes / 1048576)
+    };
+  }
+  if (mode === "bitrate-from-size") {
+    if (typeof targetSizeMB !== "number" || !Number.isFinite(targetSizeMB) || targetSizeMB <= 0) {
+      return { error: 'targetSizeMB must be a positive number for mode "bitrate-from-size"' };
+    }
+    const fileSizeBytes = targetSizeMB * 1e6;
+    const totalBitrateKbps = fileSizeBytes * 8 / (1e3 * durationSeconds);
+    const videoKbps = totalBitrateKbps - audioBitrateKbps;
+    if (videoKbps <= 0) {
+      return {
+        error: "audioBitrateKbps exceeds the total bitrate available at this target size and duration; lower the audio bitrate or raise the target size"
+      };
+    }
+    return {
+      mode,
+      durationSeconds,
+      videoBitrateKbps: round22(videoKbps),
+      audioBitrateKbps: round22(audioBitrateKbps),
+      totalBitrateKbps: round22(totalBitrateKbps),
+      fileSizeBytes: Math.round(fileSizeBytes),
+      fileSizeMB: round22(targetSizeMB),
+      fileSizeMiB: round22(fileSizeBytes / 1048576)
+    };
+  }
+  return { error: 'mode must be "size-from-bitrate" or "bitrate-from-size"' };
+}
 
-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, calculateCompoundInterest, calculateDiscount, calculateLoan, calculateMarginMarkup, calculatePercentageChange, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, 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, calculateLoan, calculateMarginMarkup, calculatePercentageChange, 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 };