@utilix-tech/sdk 0.51.0 → 0.53.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.53.0
+- Add `calculateCreditUtilization` (credit-utilization-calculator): compute per-account and overall credit utilization (balance / limit) from one or more credit accounts, plus a qualitative tier matching common credit-scoring guidance.
+- Add `analyzeCaptionSpeed` (caption-reading-speed-checker): parse an SRT or WebVTT file and report the words-per-minute reading speed of every cue, flagging ones that exceed common broadcast accessibility guidelines.
+
+## 0.52.0
+- Add `validateEditorConfig` (editorconfig-validator): parse an .editorconfig file into its root flag and glob sections, and flag structural mistakes against the EditorConfig spec.
+- Add `validateTsconfig` (tsconfig-validator): parse a tsconfig.json file as JSONC and flag unknown keys, unknown compilerOptions, and type mismatches against a curated list of known options.
+
 ## 0.51.0
 - Add `calculateGpa` (gpa-calculator): compute a weighted GPA from a list of courses, each with a letter grade and credit hours, using the standard 4.0-capped scale.
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**642 developer utility functions for Node.js: runs locally, no API key required.**
+**646 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)
@@ -204,7 +204,7 @@ analyzeKeywordDensity("machine learning models power machine learning systems");
 import { parseCsv, csvToJson, validateYaml, resolveYamlAnchors, tomlToJson, jsonToToml,
          formatXml, xmlToJson, jsonToXml, parseIni,
          validateNdjson, formatNdjson, ndjsonToJsonArray, diffEnvExample,
-         parseSubtitles, convertSubtitles, shiftSubtitles, parseFrontMatter,
+         parseSubtitles, convertSubtitles, shiftSubtitles, analyzeCaptionSpeed, parseFrontMatter,
          generateMarkdownToc, csvToSqlInsert, findCsvDuplicateRows, calculateMarkdownTaskListProgress } from "@utilix-tech/sdk/data";
 
 // CSV
@@ -242,6 +242,10 @@ convertSubtitles("1\n00:00:01,000 --> 00:00:04,000\nHello there.\n", "vtt");
 shiftSubtitles("1\n00:00:01,000 --> 00:00:04,000\nHi\n", -2.5);
 // shifts every cue 2.5s earlier, clamping anything below zero to 00:00:00
 
+// Caption reading speed: flag cues faster than ~180 WPM / ~20 chars/sec (both adjustable)
+analyzeCaptionSpeed("1\n00:00:01,000 --> 00:00:02,000\nThis line is read far too fast for anyone to follow.\n");
+// { cueCount: 1, averageWpm: 660, flaggedCount: 1, cues: [{ wpm: 660, exceedsWpm: true, ... }], ... }
+
 // Markdown front matter: split a document into its YAML front matter and body
 parseFrontMatter("---\ntitle: Hello World\ntags: [foo, bar]\n---\n# Body");
 // { frontMatter: { title: "Hello World", tags: ["foo", "bar"] }, body: "# Body", hasFrontMatter: true, ... }
@@ -322,7 +326,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, calculateBreakEven, calculateVideoBitrate, calculateRuleOf72, calculateEmi, calculateRoi, compareUnitPrices, calculatePaybackPeriod, calculateCdMaturity, calculateDepreciationSchedule, calculateCashRounding, calculateMovingAverages, calculateGpa } 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, calculateRuleOf72, calculateEmi, calculateRoi, compareUnitPrices, calculatePaybackPeriod, calculateCdMaturity, calculateDepreciationSchedule, calculateCashRounding, calculateMovingAverages, calculateGpa, calculateCreditUtilization } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -456,6 +460,10 @@ calculateMovingAverages([102, 104, 101, 108, 112], 3);
 // Weighted GPA from a list of courses (letter grade + credit hours)
 calculateGpa([{ name: "Calculus", grade: "A", credits: 4 }, { name: "History", grade: "B+", credits: 3 }]);
 // { gpa: 3.7, totalCredits: 7, totalQualityPoints: 25.9, courses: [...] }
+
+// Per-account and overall credit utilization, plus a qualitative tier
+calculateCreditUtilization([{ label: "Visa", balance: 500, limit: 5000 }, { label: "Amex", balance: 1200, limit: 3000 }]);
+// { overallUtilizationPercent: 21.25, overallTier: "good", totalBalance: 1700, totalLimit: 8000, accounts: [...] }
 ```
 
 ---
@@ -623,7 +631,8 @@ generateCspHeader({ "default-src": ["'self'"], "script-src": ["'self'", "cdn.exa
 ```ts
 import { formatSql, minifySql, testRegex, formatHtml, formatGql,
          detectDialect, splitStatements, lookupMime, parseGithubUrl,
-         detectRedos, testGitignorePatterns } from "@utilix-tech/sdk/code";
+         detectRedos, testGitignorePatterns, validateEditorConfig,
+         validateTsconfig } from "@utilix-tech/sdk/code";
 
 // SQL
 formatSql("SELECT id,name FROM users WHERE active=1 ORDER BY name");
@@ -663,6 +672,14 @@ detectRedos("(a+)+");
 // Test paths against a .gitignore file's patterns
 testGitignorePatterns("node_modules/\n*.log", ["node_modules/foo.js", "debug.log", "src/index.js"]);
 // [{ path: "node_modules/foo.js", ignored: true, matchedPattern: "node_modules/", matchedLine: 1 }, ...]
+
+// Validate an .editorconfig file
+validateEditorConfig("root = true\n\n[*]\nindent_style = space\nindent_size = 2\n");
+// { root: true, sections: [{ glob: "*", properties: [...] }], issues: [], valid: true }
+
+// Validate a tsconfig.json file (JSONC comments and trailing commas are stripped first)
+validateTsconfig(JSON.stringify({ compilerOptions: { target: "ES2020", strict: true } }));
+// { parsed: true, topLevelKeys: ["compilerOptions"], compilerOptionKeys: ["target", "strict"], issues: [], valid: true }
 ```
 
 ---

package/dist/{chunk-BDQXYFTO.js → chunk-3KIUADK4.js}

@@ -5,6 +5,7 @@ import { parse, stringify } from 'smol-toml';
 // src/tools/data.ts
 var data_exports = {};
 __export(data_exports, {
+  analyzeCaptionSpeed: () => analyzeCaptionSpeed,
   calculateMarkdownTaskListProgress: () => calculateMarkdownTaskListProgress,
   convertSubtitles: () => convertSubtitles,
   csvToJson: () => csvToJson,
@@ -1340,6 +1341,53 @@ function shiftSubtitles(input, offsetSeconds, target) {
     warnings
   };
 }
+function analyzeCaptionSpeed(input, wpmThreshold = 180, cpsThreshold = 20) {
+  if (!Number.isFinite(wpmThreshold) || wpmThreshold <= 0) {
+    return { error: "wpmThreshold must be a finite number greater than zero" };
+  }
+  if (!Number.isFinite(cpsThreshold) || cpsThreshold <= 0) {
+    return { error: "cpsThreshold must be a finite number greater than zero" };
+  }
+  const parsed = parseSubtitles(input);
+  if ("error" in parsed) return parsed;
+  const round1 = (n) => Math.round(n * 10) / 10;
+  const cues = [];
+  for (const cue of parsed.cues) {
+    const text = cue.text.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ").trim();
+    const durationSeconds = cue.end - cue.start;
+    if (text.length === 0 || durationSeconds <= 0) continue;
+    const wordCount = text.split(" ").filter(Boolean).length;
+    const charCount = text.length;
+    const wpm = wordCount / durationSeconds * 60;
+    const charsPerSecond = charCount / durationSeconds;
+    cues.push({
+      index: cues.length + 1,
+      start: round1(cue.start),
+      end: round1(cue.end),
+      text,
+      durationSeconds: round1(durationSeconds),
+      wordCount,
+      charCount,
+      wpm: round1(wpm),
+      charsPerSecond: round1(charsPerSecond),
+      exceedsWpm: wpm > wpmThreshold,
+      exceedsCps: charsPerSecond > cpsThreshold
+    });
+  }
+  if (cues.length === 0) {
+    return { error: "No cues with both text and a positive duration were found" };
+  }
+  const wpmValues = cues.map((c) => c.wpm);
+  return {
+    cueCount: cues.length,
+    cues,
+    averageWpm: round1(wpmValues.reduce((a, b) => a + b, 0) / wpmValues.length),
+    maxWpm: round1(Math.max(...wpmValues)),
+    flaggedCount: cues.filter((c) => c.exceedsWpm || c.exceedsCps).length,
+    wpmThreshold,
+    cpsThreshold
+  };
+}
 function parseFrontMatterScalar(value) {
   if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
     return value.slice(1, -1);
@@ -1673,4 +1721,4 @@ function calculateMarkdownTaskListProgress(markdown) {
   return { totalItems, completedItems, percentComplete, sections, items };
 }
 
-export { calculateMarkdownTaskListProgress, convertSubtitles, csvToJson, csvToSqlInsert, data_exports, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, findCsvDuplicateRows, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, generateMarkdownToc, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseFrontMatter, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, resolveYamlAnchors, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson };
+export { analyzeCaptionSpeed, calculateMarkdownTaskListProgress, convertSubtitles, csvToJson, csvToSqlInsert, data_exports, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, findCsvDuplicateRows, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, generateMarkdownToc, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseFrontMatter, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, resolveYamlAnchors, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson };

package/dist/{chunk-JL7YTXRB.js → chunk-K4ZERKBD.js}

@@ -55,7 +55,9 @@ __export(code_exports, {
   testGitignorePatterns: () => testGitignorePatterns,
   testPattern: () => testPattern,
   testRegex: () => testRegex,
-  validateEnvKey: () => validateEnvKey
+  validateEditorConfig: () => validateEditorConfig,
+  validateEnvKey: () => validateEnvKey,
+  validateTsconfig: () => validateTsconfig
 });
 var ALL_FLAGS = ["g", "i", "m", "s", "u"];
 function testRegex(pattern, flags, input) {
@@ -2940,5 +2942,339 @@ function testGitignorePatterns(gitignoreContent, paths) {
     return { path, ignored, matchedPattern, matchedLine };
   });
 }
+var EDITORCONFIG_ENUM_PROPERTIES = {
+  indent_style: ["tab", "space"],
+  end_of_line: ["lf", "cr", "crlf"],
+  charset: ["latin1", "utf-8", "utf-8-bom", "utf-16be", "utf-16le"],
+  trim_trailing_whitespace: ["true", "false"],
+  insert_final_newline: ["true", "false"]
+};
+var EDITORCONFIG_KNOWN_PROPERTIES = /* @__PURE__ */ new Set([
+  "indent_style",
+  "indent_size",
+  "tab_width",
+  "end_of_line",
+  "charset",
+  "trim_trailing_whitespace",
+  "insert_final_newline",
+  "max_line_length",
+  "root"
+]);
+var POSITIVE_INT_RE = /^[1-9][0-9]*$/;
+function validateEditorConfig(text) {
+  if (!text || !text.trim()) return { error: "Input is empty" };
+  const lines = text.split("\n");
+  const issues = [];
+  const sections = [];
+  let root = false;
+  let rootSeen = false;
+  let currentSection = null;
+  for (let i = 0; i < lines.length; i++) {
+    const lineNum = i + 1;
+    const trimmed = lines[i].trim();
+    if (!trimmed || trimmed.startsWith("#") || trimmed.startsWith(";")) continue;
+    const sectionMatch = trimmed.match(/^\[(.*)\]$/);
+    if (sectionMatch) {
+      const glob = sectionMatch[1];
+      if (!glob) {
+        issues.push({ severity: "warning", line: lineNum, message: 'Section header is empty ("[]" matches no files)' });
+      }
+      if (sections.some((s) => s.glob === glob)) {
+        issues.push({ severity: "warning", line: lineNum, message: `Duplicate section "[${glob}]" (an earlier section already uses this exact glob)` });
+      }
+      currentSection = { glob, line: lineNum, properties: [] };
+      sections.push(currentSection);
+      continue;
+    }
+    const eqIdx = trimmed.indexOf("=");
+    if (eqIdx === -1) {
+      issues.push({ severity: "error", line: lineNum, message: `Malformed line (missing '='): "${trimmed}"` });
+      continue;
+    }
+    const rawKey = trimmed.slice(0, eqIdx).trim();
+    const key = rawKey.toLowerCase();
+    const rawValue = trimmed.slice(eqIdx + 1).trim();
+    const normalizedValue = rawValue.toLowerCase();
+    if (!rawKey) {
+      issues.push({ severity: "error", line: lineNum, message: "Property is missing a name" });
+      continue;
+    }
+    if (key === "root") {
+      if (sections.length > 0) {
+        issues.push({ severity: "error", line: lineNum, message: `"root" must appear before any section, in the file's preamble` });
+      } else if (rootSeen) {
+        issues.push({ severity: "warning", line: lineNum, message: 'Duplicate "root" declaration' });
+      } else if (normalizedValue !== "true" && normalizedValue !== "false") {
+        issues.push({ severity: "error", line: lineNum, message: `"root" must be "true" or "false", got "${rawValue}"` });
+      } else {
+        root = normalizedValue === "true";
+      }
+      rootSeen = true;
+      continue;
+    }
+    if (!currentSection) {
+      issues.push({ severity: "error", line: lineNum, message: `Property "${rawKey}" found before any section header` });
+      continue;
+    }
+    if (currentSection.properties.some((p) => p.key === key)) {
+      issues.push({ severity: "warning", line: lineNum, message: `Duplicate property "${key}" in section "[${currentSection.glob}]"` });
+    }
+    currentSection.properties.push({ key, value: rawValue, line: lineNum });
+    if (!EDITORCONFIG_KNOWN_PROPERTIES.has(key)) {
+      issues.push({ severity: "warning", line: lineNum, message: `Unknown property "${key}"` });
+      continue;
+    }
+    if (key in EDITORCONFIG_ENUM_PROPERTIES) {
+      if (!EDITORCONFIG_ENUM_PROPERTIES[key].includes(normalizedValue)) {
+        issues.push({ severity: "error", line: lineNum, message: `"${key}" must be one of ${EDITORCONFIG_ENUM_PROPERTIES[key].join(", ")}, got "${rawValue}"` });
+      }
+    } else if (key === "indent_size") {
+      if (normalizedValue !== "tab" && !POSITIVE_INT_RE.test(rawValue)) {
+        issues.push({ severity: "error", line: lineNum, message: `"indent_size" must be a positive integer or "tab", got "${rawValue}"` });
+      }
+    } else if (key === "tab_width") {
+      if (!POSITIVE_INT_RE.test(rawValue)) {
+        issues.push({ severity: "error", line: lineNum, message: `"tab_width" must be a positive integer, got "${rawValue}"` });
+      }
+    } else if (key === "max_line_length") {
+      if (normalizedValue !== "off" && !POSITIVE_INT_RE.test(rawValue)) {
+        issues.push({ severity: "error", line: lineNum, message: `"max_line_length" must be a positive integer or "off", got "${rawValue}"` });
+      }
+    }
+  }
+  if (sections.length === 0 && !rootSeen) {
+    issues.push({ severity: "warning", line: 1, message: "File has no section headers and no root declaration" });
+  }
+  const valid = !issues.some((i) => i.severity === "error");
+  return { root, sections, issues, valid };
+}
+function stripJsonComments(input) {
+  let out = "";
+  let i = 0;
+  const n = input.length;
+  let inString = false;
+  while (i < n) {
+    const c = input[i];
+    const next = input[i + 1];
+    if (inString) {
+      out += c;
+      if (c === "\\") {
+        out += next ?? "";
+        i += 2;
+        continue;
+      }
+      if (c === '"') inString = false;
+      i++;
+      continue;
+    }
+    if (c === '"') {
+      inString = true;
+      out += c;
+      i++;
+      continue;
+    }
+    if (c === "/" && next === "/") {
+      while (i < n && input[i] !== "\n") i++;
+      continue;
+    }
+    if (c === "/" && next === "*") {
+      i += 2;
+      while (i < n && !(input[i] === "*" && input[i + 1] === "/")) {
+        out += input[i] === "\n" ? "\n" : "";
+        i++;
+      }
+      i += 2;
+      continue;
+    }
+    out += c;
+    i++;
+  }
+  return out;
+}
+function stripTrailingCommas(input) {
+  return input.replace(/,(\s*[}\]])/g, "$1");
+}
+var TSCONFIG_TOP_LEVEL_KEYS = /* @__PURE__ */ new Set([
+  "compilerOptions",
+  "files",
+  "include",
+  "exclude",
+  "extends",
+  "references",
+  "compileOnSave",
+  "typeAcquisition",
+  "watchOptions",
+  "buildOptions",
+  "$schema"
+]);
+var TSCONFIG_ENUM_OPTIONS = {
+  target: ["es3", "es5", "es6", "es2015", "es2016", "es2017", "es2018", "es2019", "es2020", "es2021", "es2022", "es2023", "esnext"],
+  module: ["none", "commonjs", "amd", "umd", "system", "es6", "es2015", "es2020", "es2022", "esnext", "node16", "nodenext", "node18", "preserve"],
+  moduleResolution: ["classic", "node", "node10", "node16", "nodenext", "bundler"],
+  moduleDetection: ["legacy", "auto", "force"],
+  jsx: ["preserve", "react", "react-jsx", "react-jsxdev", "react-native"],
+  newLine: ["crlf", "lf"],
+  importsNotUsedAsValues: ["remove", "preserve", "error"]
+};
+var TSCONFIG_BOOLEAN_OPTIONS = /* @__PURE__ */ new Set([
+  "allowJs",
+  "checkJs",
+  "strict",
+  "noImplicitAny",
+  "strictNullChecks",
+  "strictFunctionTypes",
+  "strictBindCallApply",
+  "strictPropertyInitialization",
+  "noImplicitThis",
+  "useUnknownInCatchVariables",
+  "alwaysStrict",
+  "noUnusedLocals",
+  "noUnusedParameters",
+  "exactOptionalPropertyTypes",
+  "noImplicitReturns",
+  "noFallthroughCasesInSwitch",
+  "noUncheckedIndexedAccess",
+  "noImplicitOverride",
+  "noPropertyAccessFromIndexSignature",
+  "esModuleInterop",
+  "allowSyntheticDefaultImports",
+  "forceConsistentCasingInFileNames",
+  "isolatedModules",
+  "verbatimModuleSyntax",
+  "declaration",
+  "declarationMap",
+  "emitDeclarationOnly",
+  "sourceMap",
+  "inlineSourceMap",
+  "inlineSources",
+  "noEmit",
+  "noEmitOnError",
+  "preserveConstEnums",
+  "removeComments",
+  "skipLibCheck",
+  "composite",
+  "incremental",
+  "experimentalDecorators",
+  "emitDecoratorMetadata",
+  "resolveJsonModule",
+  "allowUmdGlobalAccess",
+  "downlevelIteration",
+  "importHelpers",
+  "preserveSymlinks",
+  "allowUnreachableCode",
+  "allowUnusedLabels",
+  "disableSizeLimit",
+  "noResolve",
+  "skipDefaultLibCheck",
+  "suppressImplicitAnyIndexErrors"
+]);
+var TSCONFIG_STRING_OPTIONS = /* @__PURE__ */ new Set([
+  "outDir",
+  "rootDir",
+  "baseUrl",
+  "outFile",
+  "declarationDir",
+  "tsBuildInfoFile",
+  "jsxFactory",
+  "jsxFragmentFactory",
+  "jsxImportSource"
+]);
+var TSCONFIG_ARRAY_OPTIONS = /* @__PURE__ */ new Set(["lib", "types", "typeRoots", "rootDirs"]);
+function validateTsconfig(text) {
+  if (!text || !text.trim()) return { error: "Input is empty" };
+  const stripped = stripTrailingCommas(stripJsonComments(text));
+  let parsed;
+  try {
+    parsed = JSON.parse(stripped);
+  } catch (e) {
+    return { error: `Invalid JSON: ${e.message}` };
+  }
+  if (typeof parsed !== "object" || parsed === null || Array.isArray(parsed)) {
+    return { error: "Root of tsconfig.json must be an object" };
+  }
+  const obj = parsed;
+  const issues = [];
+  const topLevelKeys = Object.keys(obj);
+  for (const key of topLevelKeys) {
+    if (!TSCONFIG_TOP_LEVEL_KEYS.has(key)) {
+      issues.push({ severity: "warning", path: key, message: `Unknown top-level key "${key}"` });
+    }
+  }
+  for (const key of ["files", "include", "exclude"]) {
+    if (key in obj) {
+      const v = obj[key];
+      if (!Array.isArray(v) || !v.every((x) => typeof x === "string")) {
+        issues.push({ severity: "error", path: key, message: `"${key}" must be an array of strings` });
+      }
+    }
+  }
+  if ("extends" in obj) {
+    const v = obj.extends;
+    const validExtends = typeof v === "string" || Array.isArray(v) && v.every((x) => typeof x === "string");
+    if (!validExtends) {
+      issues.push({ severity: "error", path: "extends", message: '"extends" must be a string or an array of strings' });
+    }
+  }
+  if ("references" in obj) {
+    const v = obj.references;
+    const validRefs = Array.isArray(v) && v.every((r) => typeof r === "object" && r !== null && typeof r.path === "string");
+    if (!validRefs) {
+      issues.push({ severity: "error", path: "references", message: '"references" must be an array of objects with a "path" string' });
+    }
+  }
+  let compilerOptionKeys = [];
+  if ("compilerOptions" in obj) {
+    const co = obj.compilerOptions;
+    if (typeof co !== "object" || co === null || Array.isArray(co)) {
+      issues.push({ severity: "error", path: "compilerOptions", message: '"compilerOptions" must be an object' });
+    } else {
+      const coObj = co;
+      compilerOptionKeys = Object.keys(coObj);
+      for (const key of compilerOptionKeys) {
+        const value = coObj[key];
+        const path = `compilerOptions.${key}`;
+        if (key === "paths") {
+          if (typeof value !== "object" || value === null || Array.isArray(value)) {
+            issues.push({ severity: "error", path, message: '"paths" must be an object mapping patterns to arrays of strings' });
+          } else {
+            for (const [k, v] of Object.entries(value)) {
+              if (!Array.isArray(v) || !v.every((x) => typeof x === "string")) {
+                issues.push({ severity: "error", path: `${path}.${k}`, message: `"paths.${k}" must be an array of strings` });
+              }
+            }
+          }
+          continue;
+        }
+        if (key in TSCONFIG_ENUM_OPTIONS) {
+          if (typeof value !== "string" || !TSCONFIG_ENUM_OPTIONS[key].includes(value.toLowerCase())) {
+            issues.push({ severity: "error", path, message: `"${key}" must be one of ${TSCONFIG_ENUM_OPTIONS[key].join(", ")}, got ${JSON.stringify(value)}` });
+          }
+          continue;
+        }
+        if (TSCONFIG_BOOLEAN_OPTIONS.has(key)) {
+          if (typeof value !== "boolean") {
+            issues.push({ severity: "error", path, message: `"${key}" must be a boolean, got ${JSON.stringify(value)}` });
+          }
+          continue;
+        }
+        if (TSCONFIG_STRING_OPTIONS.has(key)) {
+          if (typeof value !== "string") {
+            issues.push({ severity: "error", path, message: `"${key}" must be a string, got ${JSON.stringify(value)}` });
+          }
+          continue;
+        }
+        if (TSCONFIG_ARRAY_OPTIONS.has(key)) {
+          if (!Array.isArray(value) || !value.every((x) => typeof x === "string")) {
+            issues.push({ severity: "error", path, message: `"${key}" must be an array of strings, got ${JSON.stringify(value)}` });
+          }
+          continue;
+        }
+        issues.push({ severity: "warning", path, message: `Unknown compilerOption "${key}"` });
+      }
+    }
+  }
+  const valid = !issues.some((i) => i.severity === "error");
+  return { parsed: true, topLevelKeys, compilerOptionKeys, issues, valid };
+}
 
-export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateEnvKey };
+export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateEditorConfig, validateEnvKey, validateTsconfig };

package/dist/{chunk-ZZJPD366.js → chunk-NKN656TQ.js}

@@ -27,6 +27,7 @@ __export(units_exports, {
   calculateCdMaturity: () => calculateCdMaturity,
   calculateChange: () => calculateChange,
   calculateCompoundInterest: () => calculateCompoundInterest,
+  calculateCreditUtilization: () => calculateCreditUtilization,
   calculateDepreciationSchedule: () => calculateDepreciationSchedule,
   calculateDiscount: () => calculateDiscount,
   calculateEmi: () => calculateEmi,
@@ -2190,5 +2191,47 @@ function calculateGpa(courses) {
     gpa: round22(totalQualityPoints / totalCredits)
   };
 }
+function _classifyUtilization(percent) {
+  if (percent < 10) return "excellent";
+  if (percent < 30) return "good";
+  if (percent < 50) return "fair";
+  return "poor";
+}
+function calculateCreditUtilization(accounts) {
+  if (!Array.isArray(accounts) || accounts.length === 0) {
+    return { error: "accounts must be a non-empty array" };
+  }
+  const round22 = (n) => Math.round(n * 100) / 100;
+  let totalBalance = 0;
+  let totalLimit = 0;
+  const results = [];
+  for (let i = 0; i < accounts.length; i++) {
+    const account = accounts[i];
+    if (typeof account.balance !== "number" || !Number.isFinite(account.balance) || account.balance < 0) {
+      return { error: `account ${i + 1}: balance must be a finite, non-negative number` };
+    }
+    if (typeof account.limit !== "number" || !Number.isFinite(account.limit) || account.limit <= 0) {
+      return { error: `account ${i + 1}: limit must be a finite number greater than zero` };
+    }
+    const utilizationPercent = round22(account.balance / account.limit * 100);
+    totalBalance += account.balance;
+    totalLimit += account.limit;
+    results.push({
+      label: account.label?.trim() || `Account ${i + 1}`,
+      balance: account.balance,
+      limit: account.limit,
+      utilizationPercent,
+      tier: _classifyUtilization(utilizationPercent)
+    });
+  }
+  const overallUtilizationPercent = round22(totalBalance / totalLimit * 100);
+  return {
+    accounts: results,
+    totalBalance: round22(totalBalance),
+    totalLimit: round22(totalLimit),
+    overallUtilizationPercent,
+    overallTier: _classifyUtilization(overallUtilizationPercent)
+  };
+}
 
-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, GPA_GRADE_POINTS, USD_DENOMINATIONS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCashBreakdown, calculateCashRounding, calculateCdMaturity, calculateChange, calculateCompoundInterest, calculateDepreciationSchedule, calculateDiscount, calculateEmi, calculateGpa, calculateLoan, calculateMarginMarkup, calculateMovingAverages, calculatePaybackPeriod, calculatePercentageChange, calculateRoi, calculateRuleOf72, calculateSavingsGoal, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, compareSemver, compareUnitPrices, 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, GPA_GRADE_POINTS, USD_DENOMINATIONS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCashBreakdown, calculateCashRounding, calculateCdMaturity, calculateChange, calculateCompoundInterest, calculateCreditUtilization, calculateDepreciationSchedule, calculateDiscount, calculateEmi, calculateGpa, calculateLoan, calculateMarginMarkup, calculateMovingAverages, calculatePaybackPeriod, calculatePercentageChange, calculateRoi, calculateRuleOf72, calculateSavingsGoal, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, compareSemver, compareUnitPrices, 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 };