@utilix-tech/sdk 0.29.0 → 0.31.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.31.0
+- Add `calculateEmi` (emi-calculator): equated monthly installment, total interest, and a year-by-year principal/interest breakdown from principal, annual rate, and tenure in years or months.
+- Add `parseFrontMatter` (markdown-front-matter-parser): split a Markdown document into its YAML front matter fields and body content, parsing scalars, inline arrays, and block lists.
+
+## 0.30.0
+- Add `jsonSchemaToTypescript` (json-schema-to-typescript): convert a JSON Schema document into TypeScript interfaces/types, reading `required`/`enum`/`oneOf`/`anyOf`/`allOf`/`$ref` directly instead of inferring from an example payload.
+- Add `estimatePasswordEntropy` (password-entropy-estimator): bits of entropy from a password's character pool, a strength label, and crack-time estimates across four guess-rate scenarios.
+
 ## 0.29.0
 - Add `readPdfPageDimensions` (pdf-page-dimensions): each page's MediaBox width/height (points and inches), rotation, and orientation, walking the Root -> Pages -> Kids tree and inheriting from ancestor nodes, plus a common paper size match (Letter, A4, etc.).
 - Add `parseIpv6Address` (ipv6-compressor): expand an IPv6 address to its full 8-group form or compress it to its RFC 5952 canonical shortest form, classify its address type, and handle an embedded IPv4 suffix or zone ID.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**581 developer utility functions for Node.js: runs locally, no API key required.**
+**585 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)
@@ -65,7 +65,7 @@ const { formatJson } = require("@utilix-tech/sdk/json");
 ### `/json`: JSON Tools
 
 ```ts
-import { formatJson, minifyJson, diffJson, jsonToTypescript, validateJson,
+import { formatJson, minifyJson, diffJson, jsonToTypescript, jsonSchemaToTypescript, validateJson,
          evaluateJsonPath, resolveJsonPointer, jsonToCsv, yamlToJson, jsonToYaml, getJsonStats } from "@utilix-tech/sdk/json";
 
 // Format with 2-space indent
@@ -77,6 +77,9 @@ diffJson(jsonA, jsonB);
 // Generate TypeScript interface from JSON
 jsonToTypescript('{"id":1,"name":"Alice"}', { rootName: "User" });
 
+// Generate TypeScript interfaces from a JSON Schema (reads required/enum/$ref directly)
+jsonSchemaToTypescript('{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}', { rootName: "User" });
+
 // Query with JSONPath
 evaluateJsonPath(obj, "$.users[*].name");
 
@@ -174,13 +177,13 @@ calculateStringDistance("kitten", "sitting");
 
 ---
 
-### `/data`: CSV / YAML / TOML / XML / INI / NDJSON / .env diff / subtitles
+### `/data`: CSV / YAML / TOML / XML / INI / NDJSON / .env diff / subtitles / Markdown front matter
 
 ```ts
 import { parseCsv, csvToJson, validateYaml, tomlToJson, jsonToToml,
          formatXml, xmlToJson, jsonToXml, parseIni,
          validateNdjson, formatNdjson, ndjsonToJsonArray, diffEnvExample,
-         parseSubtitles, convertSubtitles, shiftSubtitles } from "@utilix-tech/sdk/data";
+         parseSubtitles, convertSubtitles, shiftSubtitles, parseFrontMatter } from "@utilix-tech/sdk/data";
 
 // CSV
 const rows = parseCsv("name,age\nalice,30\nbob,25");
@@ -214,6 +217,10 @@ convertSubtitles("1\n00:00:01,000 --> 00:00:04,000\nHello there.\n", "vtt");
 // { format: "vtt", sourceFormat: "srt", output: "WEBVTT\n\n00:00:01.000 --> ...", cueCount: 1, ... }
 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
+
+// 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, ... }
 ```
 
 ---
@@ -222,14 +229,17 @@ shiftSubtitles("1\n00:00:01,000 --> 00:00:04,000\nHi\n", -2.5);
 
 ```ts
 import { generateUuid, generateV4, generateV7, generateUlid,
-         generatePassword, checkStrength, generateData } from "@utilix-tech/sdk/generators";
+         generatePassword, checkStrength, estimatePasswordEntropy, generateData } from "@utilix-tech/sdk/generators";
 
 generateUuid();       // "f47ac10b-58cc-4372-a567-0e02b2c3d479"  (v4)
 generateV7();         // time-ordered UUID v7
 generateUlid();       // "01ARZ3NDEKTSV4RRFFQ69G5FAV"
 
 generatePassword({ length: 16, symbols: true, numbers: true });
-checkStrength("P@ssw0rd!");  // { score: 4, label: "Strong", entropy: 52.4 }
+checkStrength("P@ssw0rd!");  // { score: 4, label: "Strong", color: "#16a34a" }
+
+// Actual bits of entropy from the character pool, plus crack-time estimates
+estimatePasswordEntropy("Tr0ub4dor&3xyzKL9!");  // { entropyBits: 118.26, strength: "strong", crackTimes: [...] }
 
 // Generate fake data rows
 generateData([
@@ -272,7 +282,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 } 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 } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -362,6 +372,10 @@ calculateVideoBitrate({ mode: "size-from-bitrate", durationSeconds: 600, videoBi
 // Rule of 72: years to double from a rate, or the rate needed to double in N years
 calculateRuleOf72(8, "rate-to-years");
 // { ruleOf72Estimate: 9, exactValue: 9.0065, errorPercent: -0.0718, ... }
+
+// EMI: equated monthly installment with a year-by-year principal/interest breakdown
+calculateEmi(500000, 8.5, 5, "years");
+// { emi: 10258.27, totalInterest: 115495.89, tenureMonths: 60, yearlyBreakdown: [...] }
 ```
 
 ---
@@ -637,14 +651,14 @@ readVideoInfo(new Uint8Array(videoBytes));
 
 | Import | What it does |
 |---|---|
-| `@utilix-tech/sdk/json` | Format, minify, diff, validate, JSONPath, CSV↔JSON, YAML↔JSON, TS types |
+| `@utilix-tech/sdk/json` | Format, minify, diff, validate, JSONPath, CSV↔JSON, YAML↔JSON, TS types from data or from a JSON Schema |
 | `@utilix-tech/sdk/encoding` | Base64, URL, HTML entities, Base32/Base58/Base62 encode/decode |
 | `@utilix-tech/sdk/hashing` | MD5, SHA-1/256/512, bcrypt, HMAC, .htpasswd |
 | `@utilix-tech/sdk/text` | Case convert, slugify, word count, lorem ipsum, line ops, HTML→Markdown, Levenshtein/Damerau string distance |
-| `@utilix-tech/sdk/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/data` | CSV, YAML, TOML, XML, INI, NDJSON parse and convert, SRT/WebVTT subtitles, Markdown front matter parser |
+| `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, entropy estimator, fake data |
 | `@utilix-tech/sdk/time` | Date diff, timezone convert, cron parse, relative time |
-| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator |
+| `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator |
 | `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing, IPv6 address compress/expand |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header |
 | `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing |

package/dist/{chunk-2CJSLYWI.js → chunk-3TYWIX3B.js}

@@ -12,6 +12,7 @@ __export(generators_exports, {
   SYMBOL_CHARS: () => SYMBOL_CHARS,
   ULID_REGEX: () => ULID_REGEX,
   checkStrength: () => checkStrength,
+  estimatePasswordEntropy: () => estimatePasswordEntropy,
   generateBulk: () => generateBulk,
   generateBulkPasswords: () => generateBulkPasswords,
   generateBulkUlids: () => generateBulkUlids,
@@ -228,6 +229,111 @@ function checkStrength(password) {
     color: levels[score].color
   };
 }
+var _SYMBOL_POOL_CHARS = " !\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~";
+var _SYMBOL_POOL_SET = new Set(_SYMBOL_POOL_CHARS.split(""));
+function _hasSymbolChar(password) {
+  for (const ch of password) {
+    if (_SYMBOL_POOL_SET.has(ch)) return true;
+  }
+  return false;
+}
+function _hasSequentialRun(password, minRun) {
+  let ascRun = 1;
+  let descRun = 1;
+  for (let i = 1; i < password.length; i++) {
+    const prev = password.charCodeAt(i - 1);
+    const curr = password.charCodeAt(i);
+    if (curr === prev + 1) {
+      ascRun++;
+      descRun = 1;
+    } else if (curr === prev - 1) {
+      descRun++;
+      ascRun = 1;
+    } else {
+      ascRun = 1;
+      descRun = 1;
+    }
+    if (ascRun >= minRun || descRun >= minRun) return true;
+  }
+  return false;
+}
+function _formatCrackDuration(seconds) {
+  if (!isFinite(seconds)) return "effectively never";
+  if (seconds < 1) return "instantly";
+  const units = [
+    ["century", 315576e4],
+    ["year", 31557600],
+    ["month", 2629800],
+    ["day", 86400],
+    ["hour", 3600],
+    ["minute", 60],
+    ["second", 1]
+  ];
+  for (const [name, unitSeconds] of units) {
+    if (seconds >= unitSeconds) {
+      const value = seconds / unitSeconds;
+      if (name === "century" && value > 1e3) return "longer than the age of the universe";
+      const rounded = value >= 100 ? Math.round(value) : Math.round(value * 10) / 10;
+      const plural = name === "century" ? "centuries" : `${name}s`;
+      return `${rounded} ${rounded === 1 ? name : plural}`;
+    }
+  }
+  return "instantly";
+}
+function estimatePasswordEntropy(password) {
+  if (!password) return { error: "Password is required" };
+  const hasLowercase = /[a-z]/.test(password);
+  const hasUppercase = /[A-Z]/.test(password);
+  const hasDigits = /[0-9]/.test(password);
+  const hasSymbols = _hasSymbolChar(password);
+  const hasOther = /[^\x20-\x7e]/.test(password);
+  let poolSize = 0;
+  if (hasLowercase) poolSize += 26;
+  if (hasUppercase) poolSize += 26;
+  if (hasDigits) poolSize += 10;
+  if (hasSymbols) poolSize += _SYMBOL_POOL_CHARS.length;
+  if (hasOther) poolSize += 100;
+  const entropyBits = Math.round(password.length * Math.log2(poolSize) * 100) / 100;
+  let strength;
+  if (entropyBits < 28) strength = "very-weak";
+  else if (entropyBits < 36) strength = "weak";
+  else if (entropyBits < 60) strength = "fair";
+  else if (entropyBits < 128) strength = "strong";
+  else strength = "very-strong";
+  const averageGuesses = Math.pow(2, entropyBits) / 2;
+  const scenarios = [
+    { scenario: "Online, throttled (100 guesses/hour)", guessesPerSecond: 100 / 3600 },
+    { scenario: "Online, unthrottled (10 guesses/sec)", guessesPerSecond: 10 },
+    { scenario: "Offline, slow hash e.g. bcrypt (10k guesses/sec)", guessesPerSecond: 1e4 },
+    { scenario: "Offline, fast hash / GPU cluster (10B guesses/sec)", guessesPerSecond: 1e10 }
+  ];
+  const crackTimes = scenarios.map((s) => ({
+    scenario: s.scenario,
+    guessesPerSecond: s.guessesPerSecond,
+    humanReadable: _formatCrackDuration(averageGuesses / s.guessesPerSecond)
+  }));
+  const warnings = [];
+  if (password.length < 8) {
+    warnings.push("Shorter than 8 characters \u2014 most sites and cracking tools treat this as trivially weak regardless of entropy.");
+  }
+  if (/(.)\1{2,}/.test(password)) {
+    warnings.push('Contains a repeated character run (e.g. "aaa"), which is easier to guess than the entropy figure implies.');
+  }
+  if (_hasSequentialRun(password, 3)) {
+    warnings.push('Contains a sequential run (e.g. "abc" or "321"), which is easier to guess than the entropy figure implies.');
+  }
+  if (poolSize <= 26) {
+    warnings.push("Uses only one character class \u2014 mixing in uppercase, digits, or symbols raises the character pool and entropy.");
+  }
+  return {
+    length: password.length,
+    charset: { hasLowercase, hasUppercase, hasDigits, hasSymbols, hasOther, poolSize },
+    entropyBits,
+    strength,
+    crackTimes,
+    warnings
+  };
+}
 var DATA_TYPES = [
   { value: "name", label: "Full Name", example: "John Smith" },
   { value: "email", label: "Email Address", example: "john.smith@gmail.com" },
@@ -517,4 +623,4 @@ async function generateQrDataUrl(text, options) {
   });
 }
 
-export { AMBIGUOUS_CHARS, DATA_TYPES, DEFAULT_OPTIONS, DEFAULT_QR_OPTIONS, SYMBOL_CHARS, ULID_REGEX, checkStrength, generateBulk, generateBulkPasswords, generateBulkUlids, generateData, generatePassword, generateQrDataUrl, generateQrSvg, generateSingle, generateUlid, generateUuid, generateV4, generateV7, generators_exports, isValidUlid, isValidUuid, parseUlid, parseUuidVersion };
+export { AMBIGUOUS_CHARS, DATA_TYPES, DEFAULT_OPTIONS, DEFAULT_QR_OPTIONS, SYMBOL_CHARS, ULID_REGEX, checkStrength, estimatePasswordEntropy, generateBulk, generateBulkPasswords, generateBulkUlids, generateData, generatePassword, generateQrDataUrl, generateQrSvg, generateSingle, generateUlid, generateUuid, generateV4, generateV7, generators_exports, isValidUlid, isValidUuid, parseUlid, parseUuidVersion };

package/dist/{chunk-66QHV5KW.js → chunk-6FIB72KX.js}

@@ -32,6 +32,7 @@ __export(data_exports, {
   ndjsonToJsonArray: () => ndjsonToJsonArray,
   parseCsv: () => parseCsv,
   parseEnv: () => parseEnv,
+  parseFrontMatter: () => parseFrontMatter,
   parseIni: () => parseIni,
   parseSubtitleTimestamp: () => parseSubtitleTimestamp,
   parseSubtitles: () => parseSubtitles,
@@ -1334,5 +1335,69 @@ function shiftSubtitles(input, offsetSeconds, target) {
     warnings
   };
 }
+function parseFrontMatterScalar(value) {
+  if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+    return value.slice(1, -1);
+  }
+  if (value === "true") return true;
+  if (value === "false") return false;
+  if (value === "null" || value === "~") return null;
+  if (value !== "" && !Number.isNaN(Number(value))) return Number(value);
+  return value;
+}
+function parseFrontMatter(input) {
+  if (typeof input !== "string" || input.length === 0) return { error: "input is required" };
+  const normalized = input.replace(/\r\n/g, "\n");
+  if (!normalized.startsWith("---\n") && normalized !== "---") {
+    return { frontMatter: {}, body: input, hasFrontMatter: false, raw: "" };
+  }
+  const closingIdx = normalized.indexOf("\n---", 4);
+  if (closingIdx === -1) {
+    return { error: 'Front matter opening delimiter found but no closing "---" delimiter' };
+  }
+  const raw = normalized.slice(4, closingIdx);
+  let afterClose = normalized.slice(closingIdx + 4);
+  if (afterClose.startsWith("\n")) afterClose = afterClose.slice(1);
+  const frontMatter = {};
+  const rawLines = raw.split("\n");
+  let i = 0;
+  while (i < rawLines.length) {
+    const line = rawLines[i];
+    if (line.trim() === "" || line.trim().startsWith("#")) {
+      i++;
+      continue;
+    }
+    const colonIdx = line.indexOf(":");
+    if (colonIdx === -1) return { error: `Invalid front matter line ${i + 1}: expected "key: value"` };
+    const key = line.slice(0, colonIdx).trim();
+    if (!key) return { error: `Invalid front matter line ${i + 1}: empty key` };
+    const rest = line.slice(colonIdx + 1).trim();
+    if (rest === "") {
+      const listItems = [];
+      let j = i + 1;
+      while (j < rawLines.length && /^\s*-\s+/.test(rawLines[j])) {
+        listItems.push(rawLines[j].replace(/^\s*-\s+/, "").trim());
+        j++;
+      }
+      if (listItems.length > 0) {
+        frontMatter[key] = listItems.map(parseFrontMatterScalar);
+        i = j;
+        continue;
+      }
+      frontMatter[key] = null;
+      i++;
+      continue;
+    }
+    if (rest.startsWith("[") && rest.endsWith("]")) {
+      const inner = rest.slice(1, -1).trim();
+      frontMatter[key] = inner === "" ? [] : inner.split(",").map((s) => parseFrontMatterScalar(s.trim()));
+      i++;
+      continue;
+    }
+    frontMatter[key] = parseFrontMatterScalar(rest);
+    i++;
+  }
+  return { frontMatter, body: afterClose, hasFrontMatter: true, raw };
+}
 
-export { convertSubtitles, csvToJson, data_exports, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson };
+export { convertSubtitles, csvToJson, data_exports, detectDelimiter, detectSubtitleFormat, diffEnvExample, envToExport, envToJson, formatNdjson, formatSubtitleTimestamp, formatToml, formatXml, getSection, getSectionNames, getTomlStats, getXmlStats, getYamlStats, iniToJson, jsonArrayToNdjson, jsonToIni, jsonToToml, jsonToXml, minifyNdjson, minifyToml, minifyXml, ndjsonToJsonArray, parseCsv, parseEnv, parseFrontMatter, parseIni, parseSubtitleTimestamp, parseSubtitles, parseXmlToObject, serializeSubtitles, shiftSubtitles, stringifyIni, toCsvString, tomlToJson, validateEnvKey, validateIni, validateNdjson, validateToml, validateXml, validateYaml, xmlToJson };

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

@@ -22,6 +22,7 @@ __export(units_exports, {
   calculateBreakEven: () => calculateBreakEven,
   calculateCompoundInterest: () => calculateCompoundInterest,
   calculateDiscount: () => calculateDiscount,
+  calculateEmi: () => calculateEmi,
   calculateLoan: () => calculateLoan,
   calculateMarginMarkup: () => calculateMarginMarkup,
   calculatePercentageChange: () => calculatePercentageChange,
@@ -1676,5 +1677,60 @@ function calculateRuleOf72(value, direction) {
     errorPercent: round4(errorPercent)
   };
 }
+function calculateEmi(principal, annualRatePercent, tenure, tenureUnit = "years") {
+  if (!Number.isFinite(principal) || principal <= 0) return { error: "Principal must be a positive number" };
+  if (!Number.isFinite(annualRatePercent) || annualRatePercent < 0) {
+    return { error: "Annual interest rate must be zero or a positive number" };
+  }
+  if (tenureUnit !== "years" && tenureUnit !== "months") {
+    return { error: 'tenureUnit must be "years" or "months"' };
+  }
+  if (!Number.isFinite(tenure) || tenure <= 0) return { error: "Tenure must be a positive number" };
+  const tenureMonths = Math.round(tenureUnit === "years" ? tenure * 12 : tenure);
+  if (tenureMonths <= 0) return { error: "Tenure must resolve to at least 1 month" };
+  const monthlyRate = annualRatePercent / 100 / 12;
+  let emi;
+  if (monthlyRate === 0) {
+    emi = principal / tenureMonths;
+  } else {
+    const factor = Math.pow(1 + monthlyRate, tenureMonths);
+    emi = principal * monthlyRate * factor / (factor - 1);
+  }
+  const yearlyBreakdown = [];
+  let balance = round2(principal);
+  let totalPayment = 0;
+  let yearPrincipal = 0;
+  let yearInterest = 0;
+  let year = 1;
+  for (let month = 1; month <= tenureMonths; month++) {
+    const interest = monthlyRate === 0 ? 0 : round2(balance * monthlyRate);
+    let principalPortion = round2(emi) - interest;
+    if (month === tenureMonths || principalPortion > balance) principalPortion = balance;
+    const payment = round2(principalPortion + interest);
+    balance = Math.max(round2(balance - principalPortion), 0);
+    totalPayment += payment;
+    yearPrincipal += principalPortion;
+    yearInterest += interest;
+    const isYearEnd = month % 12 === 0 || month === tenureMonths;
+    if (isYearEnd) {
+      yearlyBreakdown.push({
+        year,
+        principalPaid: round2(yearPrincipal),
+        interestPaid: round2(yearInterest),
+        balance
+      });
+      year += 1;
+      yearPrincipal = 0;
+      yearInterest = 0;
+    }
+  }
+  return {
+    emi: round2(emi),
+    totalInterest: round2(totalPayment - principal),
+    totalPayment: round2(totalPayment),
+    tenureMonths,
+    yearlyBreakdown
+  };
+}
 
-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, calculateRuleOf72, calculateSimpleInterest, calculateTax, calculateTimeValue, calculateTipSplit, calculateVideoBitrate, compareSemver, convert, convertAprApy, convertBytes, convertIp, coverBox, decimalToIp, decimalToIpCidr, describePermissions, fitIntoBox, formatNumber, formatValue, formatVwValue, formatWithSeparator, gcd, ipFromBinary, ipFromDecimal, ipFromHex, ipToBinary, ipToDecimal, ipToDecimalCidr, ipToHex, ipToOctal, isValid, isValidCidr, isValidIp, isValidIpv4, marginToMarkup, markupToMargin, octalToPermissions, parseFileSize, parseInput, parseNumberString, parseSemver, permissionsToChmod, permissionsToOctal, permissionsToSymbolic, ptToPx, pxToAll, pxToViewport, remToPx, satisfiesRange, scaleByHeight, scaleByWidth, sortVersions, splitSubnet, symbolicToPermissions, units_exports, validateBarcode, validateCardNumber, validateIban, validateIsbn, viewportToPx };
+export { BASE_LABELS, BASE_PREFIXES, BYTE_UNITS, COMMON_CURRENCIES, COMMON_LOCALES, COMMON_PERMISSIONS, COMMON_RATIOS, COMMON_SIZES, COMMON_TAX_RATES, COMMON_TIP_PERCENTAGES, COMMON_VIEWPORTS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCompoundInterest, calculateDiscount, calculateEmi, calculateLoan, calculateMarginMarkup, calculatePercentageChange, calculateRuleOf72, 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 };

package/dist/{chunk-WO3LJMVV.js → chunk-WVEKRKGU.js}

@@ -15,6 +15,7 @@ __export(json_exports, {
   inferGoType: () => inferGoType,
   inferPythonType: () => inferPythonType,
   inferType: () => inferType,
+  jsonSchemaToTypescript: () => jsonSchemaToTypescript,
   jsonToCsv: () => jsonToCsv,
   jsonToGo: () => jsonToGo,
   jsonToPython: () => jsonToPython,
@@ -1302,5 +1303,104 @@ function resolveJsonPointer(json, pointer) {
   }
   return { pointer, found: true, value: current, tokens };
 }
+function _schemaRefName(ref) {
+  const parts = ref.split("/");
+  return _capitalize(parts[parts.length - 1] || "Ref");
+}
+function _schemaLiteralType(value) {
+  if (typeof value === "string") return JSON.stringify(value);
+  if (typeof value === "number" || typeof value === "boolean") return String(value);
+  if (value === null) return "null";
+  return JSON.stringify(value);
+}
+function _safePropertyKey(key) {
+  return /^[A-Za-z_$][A-Za-z0-9_$]*$/.test(key) ? key : JSON.stringify(key);
+}
+function _schemaToTsType(schema, name, interfaces) {
+  if (schema.$ref) return _schemaRefName(schema.$ref);
+  if (schema.const !== void 0) return _schemaLiteralType(schema.const);
+  if (schema.enum) return schema.enum.map(_schemaLiteralType).join(" | ");
+  if (schema.oneOf) return schema.oneOf.map((s, i) => _schemaToTsType(s, `${name}Variant${i}`, interfaces)).join(" | ");
+  if (schema.anyOf) return schema.anyOf.map((s, i) => _schemaToTsType(s, `${name}Variant${i}`, interfaces)).join(" | ");
+  if (schema.allOf) return schema.allOf.map((s, i) => _schemaToTsType(s, `${name}Part${i}`, interfaces)).join(" & ");
+  const types = Array.isArray(schema.type) ? schema.type : schema.type ? [schema.type] : [];
+  const nullable = types.includes("null");
+  const nonNullTypes = types.filter((t) => t !== "null");
+  const primaryType = nonNullTypes[0] ?? (schema.properties || schema.additionalProperties !== void 0 ? "object" : void 0);
+  let result;
+  switch (primaryType) {
+    case "string":
+      result = "string";
+      break;
+    case "number":
+    case "integer":
+      result = "number";
+      break;
+    case "boolean":
+      result = "boolean";
+      break;
+    case "array": {
+      const itemsSchema = Array.isArray(schema.items) ? schema.items[0] : schema.items;
+      const itemType = itemsSchema ? _schemaToTsType(itemsSchema, `${name}Item`, interfaces) : "unknown";
+      result = `${itemType}[]`;
+      break;
+    }
+    case "object": {
+      _buildSchemaInterface(schema, name, interfaces);
+      result = name;
+      break;
+    }
+    default:
+      result = "unknown";
+  }
+  return nullable ? `${result} | null` : result;
+}
+function _buildSchemaInterface(schema, name, interfaces) {
+  if (interfaces.has(name)) return;
+  const required = new Set(schema.required ?? []);
+  const lines = [`interface ${name} {`];
+  for (const [key, propSchema] of Object.entries(schema.properties ?? {})) {
+    if (propSchema.description) lines.push(`  /** ${propSchema.description} */`);
+    const optional = required.has(key) ? "" : "?";
+    const propType = _schemaToTsType(propSchema, _capitalize(key), interfaces);
+    lines.push(`  ${_safePropertyKey(key)}${optional}: ${propType};`);
+  }
+  if (schema.additionalProperties === true) {
+    lines.push("  [key: string]: unknown;");
+  } else if (schema.additionalProperties && typeof schema.additionalProperties === "object") {
+    const addType = _schemaToTsType(schema.additionalProperties, `${name}Value`, interfaces);
+    lines.push(`  [key: string]: ${addType};`);
+  }
+  lines.push("}");
+  interfaces.set(name, lines.join("\n"));
+}
+function jsonSchemaToTypescript(schemaJson, options) {
+  let schema;
+  try {
+    schema = JSON.parse(schemaJson);
+  } catch {
+    return { error: "Invalid JSON input" };
+  }
+  if (typeof schema !== "object" || schema === null || Array.isArray(schema)) {
+    return { error: "Schema must be a JSON object" };
+  }
+  const rootName = options?.rootName ?? "Root";
+  const typedSchema = schema;
+  const interfaces = /* @__PURE__ */ new Map();
+  const defs = { ...typedSchema.$defs ?? {}, ...typedSchema.definitions ?? {} };
+  for (const [defName, defSchema] of Object.entries(defs)) {
+    const defTypeName = _capitalize(defName);
+    const defType = _schemaToTsType(defSchema, defTypeName, interfaces);
+    if (!interfaces.has(defTypeName)) {
+      interfaces.set(defTypeName, `type ${defTypeName} = ${defType};`);
+    }
+  }
+  const rootType = _schemaToTsType(typedSchema, rootName, interfaces);
+  const parts = [...interfaces.values()];
+  if (!interfaces.has(rootName)) {
+    parts.push(`type ${rootName} = ${rootType};`);
+  }
+  return parts.join("\n\n");
+}
 
-export { csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, json_exports, minifyJson, parseJson, parseStructs, resolveJsonPointer, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson };
+export { csvToJson, detectFormat, diffJson, evaluateJsonPath, formatDiffLine, formatJson, generateExample, getJsonStats, inferGoType, inferPythonType, inferType, jsonSchemaToTypescript, jsonToCsv, jsonToGo, jsonToPython, jsonToTypescript, jsonToYaml, jsonToZod, json_exports, minifyJson, parseJson, parseStructs, resolveJsonPointer, toPascalCase, toSnakeCase, validateJson, validateJsonPath, validateJsonString, yamlToJson };

package/dist/{data-XRb0D7Zn.d.cts → data-C4lCByXw.d.cts}

@@ -13,6 +13,7 @@
  *  - env-diff-checker: diffEnvExample
  *  - ndjson-formatter: validateNdjson, minifyNdjson, formatNdjson, ndjsonToJsonArray, jsonArrayToNdjson
  *  - subtitle-converter: parseSubtitleTimestamp, formatSubtitleTimestamp, detectSubtitleFormat, parseSubtitles, serializeSubtitles, convertSubtitles, shiftSubtitles
+ *  - markdown-front-matter-parser: parseFrontMatter
  */
 interface ValidationResult {
     valid: boolean;
@@ -272,6 +273,24 @@ declare function convertSubtitles(input: string, target: SubtitleFormat, sourceF
 declare function shiftSubtitles(input: string, offsetSeconds: number, target?: SubtitleFormat): ConvertedSubtitles | {
     error: string;
 };
+interface FrontMatterResult {
+    frontMatter: Record<string, unknown>;
+    body: string;
+    hasFrontMatter: boolean;
+    raw: string;
+}
+interface FrontMatterError {
+    error: string;
+}
+/**
+ * Split a Markdown document into its YAML front matter (delimited by --- lines
+ * at the top) and body content. Parses simple scalar values (strings, quoted
+ * strings, booleans, numbers, null), inline arrays (`tags: [a, b]`), and YAML
+ * block lists (`tags:\n  - a\n  - b`). Not a full YAML parser: nested mappings
+ * and multi-line block scalars are not supported. A document with no opening
+ * "---" delimiter is returned as-is with `hasFrontMatter: false`.
+ */
+declare function parseFrontMatter(input: string): FrontMatterResult | FrontMatterError;
 
 type data_ConvertedSubtitles = ConvertedSubtitles;
 type data_CsvParseResult = CsvParseResult;
@@ -279,6 +298,8 @@ type data_EnvDiffError = EnvDiffError;
 type data_EnvDiffResult = EnvDiffResult;
 type data_EnvEntry = EnvEntry;
 type data_EnvParseResult = EnvParseResult;
+type data_FrontMatterError = FrontMatterError;
+type data_FrontMatterResult = FrontMatterResult;
 type data_IniSection = IniSection;
 type data_NdjsonLineResult = NdjsonLineResult;
 type data_NdjsonValidateResult = NdjsonValidateResult;
@@ -318,6 +339,7 @@ declare const data_minifyXml: typeof minifyXml;
 declare const data_ndjsonToJsonArray: typeof ndjsonToJsonArray;
 declare const data_parseCsv: typeof parseCsv;
 declare const data_parseEnv: typeof parseEnv;
+declare const data_parseFrontMatter: typeof parseFrontMatter;
 declare const data_parseIni: typeof parseIni;
 declare const data_parseSubtitleTimestamp: typeof parseSubtitleTimestamp;
 declare const data_parseSubtitles: typeof parseSubtitles;
@@ -335,7 +357,7 @@ declare const data_validateXml: typeof validateXml;
 declare const data_validateYaml: typeof validateYaml;
 declare const data_xmlToJson: typeof xmlToJson;
 declare namespace data {
-  export { type data_ConvertedSubtitles as ConvertedSubtitles, type data_CsvParseResult as CsvParseResult, type data_EnvDiffError as EnvDiffError, type data_EnvDiffResult as EnvDiffResult, type data_EnvEntry as EnvEntry, type data_EnvParseResult as EnvParseResult, type data_IniSection as IniSection, type data_NdjsonLineResult as NdjsonLineResult, type data_NdjsonValidateResult as NdjsonValidateResult, type data_ParseOptions as ParseOptions, type data_ParsedIni as ParsedIni, type data_ParsedSubtitles as ParsedSubtitles, type data_SubtitleCue as SubtitleCue, type data_SubtitleFormat as SubtitleFormat, type data_TomlFormatResult as TomlFormatResult, type data_ValidationResult as ValidationResult, type data_XmlFormatResult as XmlFormatResult, type data_XmlToJsonOptions as XmlToJsonOptions, data_convertSubtitles as convertSubtitles, data_csvToJson as csvToJson, data_detectDelimiter as detectDelimiter, data_detectSubtitleFormat as detectSubtitleFormat, data_diffEnvExample as diffEnvExample, data_envToExport as envToExport, data_envToJson as envToJson, data_formatNdjson as formatNdjson, data_formatSubtitleTimestamp as formatSubtitleTimestamp, data_formatToml as formatToml, data_formatXml as formatXml, data_getSection as getSection, data_getSectionNames as getSectionNames, data_getTomlStats as getTomlStats, data_getXmlStats as getXmlStats, data_getYamlStats as getYamlStats, data_iniToJson as iniToJson, data_jsonArrayToNdjson as jsonArrayToNdjson, data_jsonToIni as jsonToIni, data_jsonToToml as jsonToToml, data_jsonToXml as jsonToXml, data_minifyNdjson as minifyNdjson, data_minifyToml as minifyToml, data_minifyXml as minifyXml, data_ndjsonToJsonArray as ndjsonToJsonArray, data_parseCsv as parseCsv, data_parseEnv as parseEnv, data_parseIni as parseIni, data_parseSubtitleTimestamp as parseSubtitleTimestamp, data_parseSubtitles as parseSubtitles, data_parseXmlToObject as parseXmlToObject, data_serializeSubtitles as serializeSubtitles, data_shiftSubtitles as shiftSubtitles, data_stringifyIni as stringifyIni, data_toCsvString as toCsvString, data_tomlToJson as tomlToJson, data_validateEnvKey as validateEnvKey, data_validateIni as validateIni, data_validateNdjson as validateNdjson, data_validateToml as validateToml, data_validateXml as validateXml, data_validateYaml as validateYaml, data_xmlToJson as xmlToJson };
+  export { type data_ConvertedSubtitles as ConvertedSubtitles, type data_CsvParseResult as CsvParseResult, type data_EnvDiffError as EnvDiffError, type data_EnvDiffResult as EnvDiffResult, type data_EnvEntry as EnvEntry, type data_EnvParseResult as EnvParseResult, type data_FrontMatterError as FrontMatterError, type data_FrontMatterResult as FrontMatterResult, type data_IniSection as IniSection, type data_NdjsonLineResult as NdjsonLineResult, type data_NdjsonValidateResult as NdjsonValidateResult, type data_ParseOptions as ParseOptions, type data_ParsedIni as ParsedIni, type data_ParsedSubtitles as ParsedSubtitles, type data_SubtitleCue as SubtitleCue, type data_SubtitleFormat as SubtitleFormat, type data_TomlFormatResult as TomlFormatResult, type data_ValidationResult as ValidationResult, type data_XmlFormatResult as XmlFormatResult, type data_XmlToJsonOptions as XmlToJsonOptions, data_convertSubtitles as convertSubtitles, data_csvToJson as csvToJson, data_detectDelimiter as detectDelimiter, data_detectSubtitleFormat as detectSubtitleFormat, data_diffEnvExample as diffEnvExample, data_envToExport as envToExport, data_envToJson as envToJson, data_formatNdjson as formatNdjson, data_formatSubtitleTimestamp as formatSubtitleTimestamp, data_formatToml as formatToml, data_formatXml as formatXml, data_getSection as getSection, data_getSectionNames as getSectionNames, data_getTomlStats as getTomlStats, data_getXmlStats as getXmlStats, data_getYamlStats as getYamlStats, data_iniToJson as iniToJson, data_jsonArrayToNdjson as jsonArrayToNdjson, data_jsonToIni as jsonToIni, data_jsonToToml as jsonToToml, data_jsonToXml as jsonToXml, data_minifyNdjson as minifyNdjson, data_minifyToml as minifyToml, data_minifyXml as minifyXml, data_ndjsonToJsonArray as ndjsonToJsonArray, data_parseCsv as parseCsv, data_parseEnv as parseEnv, data_parseFrontMatter as parseFrontMatter, data_parseIni as parseIni, data_parseSubtitleTimestamp as parseSubtitleTimestamp, data_parseSubtitles as parseSubtitles, data_parseXmlToObject as parseXmlToObject, data_serializeSubtitles as serializeSubtitles, data_shiftSubtitles as shiftSubtitles, data_stringifyIni as stringifyIni, data_toCsvString as toCsvString, data_tomlToJson as tomlToJson, data_validateEnvKey as validateEnvKey, data_validateIni as validateIni, data_validateNdjson as validateNdjson, data_validateToml as validateToml, data_validateXml as validateXml, data_validateYaml as validateYaml, data_xmlToJson as xmlToJson };
 }
 
-export { toCsvString as $, iniToJson as A, jsonArrayToNdjson as B, type ConvertedSubtitles as C, jsonToIni as D, type EnvDiffError as E, jsonToToml as F, jsonToXml as G, minifyNdjson as H, type IniSection as I, minifyToml as J, minifyXml as K, ndjsonToJsonArray as L, parseCsv as M, type NdjsonLineResult as N, parseEnv as O, type ParseOptions as P, parseIni as Q, parseSubtitleTimestamp as R, type SubtitleCue as S, type TomlFormatResult as T, parseSubtitles as U, type ValidationResult as V, parseXmlToObject as W, type XmlFormatResult as X, serializeSubtitles as Y, shiftSubtitles as Z, stringifyIni as _, type CsvParseResult as a, tomlToJson as a0, validateEnvKey as a1, validateIni as a2, validateNdjson as a3, validateToml as a4, validateXml as a5, validateYaml as a6, xmlToJson as a7, type EnvDiffResult as b, type EnvEntry as c, data as d, type EnvParseResult as e, type NdjsonValidateResult as f, type ParsedIni as g, type ParsedSubtitles as h, type SubtitleFormat as i, type XmlToJsonOptions as j, convertSubtitles as k, csvToJson as l, detectDelimiter as m, detectSubtitleFormat as n, diffEnvExample as o, envToExport as p, envToJson as q, formatNdjson as r, formatSubtitleTimestamp as s, formatToml as t, formatXml as u, getSection as v, getSectionNames as w, getTomlStats as x, getXmlStats as y, getYamlStats as z };
+export { serializeSubtitles as $, getYamlStats as A, iniToJson as B, type ConvertedSubtitles as C, jsonArrayToNdjson as D, type EnvDiffError as E, type FrontMatterError as F, jsonToIni as G, jsonToToml as H, type IniSection as I, jsonToXml as J, minifyNdjson as K, minifyToml as L, minifyXml as M, type NdjsonLineResult as N, ndjsonToJsonArray as O, type ParseOptions as P, parseCsv as Q, parseEnv as R, type SubtitleCue as S, type TomlFormatResult as T, parseFrontMatter as U, type ValidationResult as V, parseIni as W, type XmlFormatResult as X, parseSubtitleTimestamp as Y, parseSubtitles as Z, parseXmlToObject as _, type CsvParseResult as a, shiftSubtitles as a0, stringifyIni as a1, toCsvString as a2, tomlToJson as a3, validateEnvKey as a4, validateIni as a5, validateNdjson as a6, validateToml as a7, validateXml as a8, validateYaml as a9, xmlToJson as aa, type EnvDiffResult as b, type EnvEntry as c, data as d, type EnvParseResult as e, type FrontMatterResult as f, type NdjsonValidateResult as g, type ParsedIni as h, type ParsedSubtitles as i, type SubtitleFormat as j, type XmlToJsonOptions as k, convertSubtitles as l, csvToJson as m, detectDelimiter as n, detectSubtitleFormat as o, diffEnvExample as p, envToExport as q, envToJson as r, formatNdjson as s, formatSubtitleTimestamp as t, formatToml as u, formatXml as v, getSection as w, getSectionNames as x, getTomlStats as y, getXmlStats as z };