@utilix-tech/sdk 0.45.0 → 0.46.0

package/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 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.46.0
+- Add `calculateDepreciationSchedule` (depreciation-schedule-calculator): build a year-by-year fixed-asset depreciation schedule from cost, salvage value, and useful life, using straight-line, double-declining-balance, or sum-of-years-digits.
+- Add `analyzeKeywordDensity` (keyword-density-analyzer): count keyword/phrase frequency and density (occurrences per 100 words) across a block of text, with single-word or 2/3-word phrase modes.
+
 ## 0.45.0
 - Add `calculateCdMaturity` (cd-maturity-calculator): compute a certificate of deposit's maturity value and effective annual yield (APY) from a principal, nominal rate, term, and compounding frequency, plus the net payout if withdrawn early.
 - Add `buildClientHints`, `parseClientHintHeaders` (client-hints-header-builder): build an `Accept-CH`/`Critical-CH` response header from a list of client hint names with a plain-English note per hint, or decode raw Client Hints request-header text into structured values.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**630 developer utility functions for Node.js: runs locally, no API key required.**
+**632 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)
@@ -149,7 +149,7 @@ generateEtag("console.log(1)");
 import { convertCase, slugify, countWords, generateWords, generateParagraphs,
          escapeString, htmlToMarkdown, applyOps, detectPassiveVoice, scoreReadability,
          detectFillerWords, calculateStringDistance, analyzeSentenceLengths,
-         searchEmoji, getEmojiByShortcode } from "@utilix-tech/sdk/text";
+         analyzeKeywordDensity, searchEmoji, getEmojiByShortcode } from "@utilix-tech/sdk/text";
 
 convertCase("hello world", "camelCase");   // "helloWorld"
 convertCase("hello world", "PascalCase");  // "HelloWorld"
@@ -190,6 +190,10 @@ analyzeSentenceLengths("The cat sat on the mat. It was a sunny day, and the dog
 // Search ~280 common emoji by name, keyword, or GitHub-style shortcode
 searchEmoji("fire");  // [{ emoji: "🔥", name: "fire", shortcode: "fire", codepoint: "U+1F525", ... }]
 getEmojiByShortcode(":joy:");  // { emoji: "😂", name: "face with tears of joy", ... }
+
+// Keyword/phrase frequency and density (occurrences per 100 words); ngramSize 2 or 3 for phrases
+analyzeKeywordDensity("machine learning models power machine learning systems");
+// { totalWords: 7, uniqueKeywords: 5, ngramSize: 1, keywords: [{ keyword: "learning", count: 2, density: 28.6 }, ...] }
 ```
 
 ---
@@ -312,7 +316,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 } 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 } from "@utilix-tech/sdk/units";
 
 // File sizes
 convertBytes(1073741824, "GB");  // 1
@@ -430,6 +434,10 @@ calculatePaybackPeriod({ initialInvestment: 1000, cashFlows: [400, 400, 400], di
 // Certificate of deposit maturity value, APY, and net early-withdrawal payout
 calculateCdMaturity(1000, 12, 12, 12, 3);
 // { maturityValue: 1126.83, totalInterest: 126.83, apy: 12.6825, earlyWithdrawalPayout: 1096.83, ... }
+
+// Year-by-year depreciation schedule: straight-line, double-declining-balance, or sum-of-years-digits
+calculateDepreciationSchedule(10000, 1000, 5, "straight-line");
+// { totalDepreciation: 9000, schedule: [{ year: 1, depreciationExpense: 1800, accumulatedDepreciation: 1800, bookValue: 8200 }, ...] }
 ```
 
 ---

package/dist/{chunk-DFLHX4NW.js → chunk-KMQHBUYO.js}

@@ -25,6 +25,7 @@ __export(units_exports, {
   calculateCdMaturity: () => calculateCdMaturity,
   calculateChange: () => calculateChange,
   calculateCompoundInterest: () => calculateCompoundInterest,
+  calculateDepreciationSchedule: () => calculateDepreciationSchedule,
   calculateDiscount: () => calculateDiscount,
   calculateEmi: () => calculateEmi,
   calculateLoan: () => calculateLoan,
@@ -2022,5 +2023,58 @@ function calculateCdMaturity(principal, annualRatePercent, termMonths, compounds
   }
   return result;
 }
+var DEPRECIATION_METHODS = ["straight-line", "double-declining-balance", "sum-of-years-digits"];
+function calculateDepreciationSchedule(cost, salvageValue, usefulLifeYears, method) {
+  if (!Number.isFinite(cost) || cost <= 0) return { error: "Cost must be a positive number" };
+  if (!Number.isFinite(salvageValue) || salvageValue < 0) {
+    return { error: "Salvage value must be zero or a positive number" };
+  }
+  if (salvageValue >= cost) return { error: "Salvage value must be less than cost" };
+  if (!Number.isInteger(usefulLifeYears) || usefulLifeYears <= 0) {
+    return { error: "Useful life must be a positive whole number of years" };
+  }
+  if (!DEPRECIATION_METHODS.includes(method)) {
+    return { error: `Method must be one of: ${DEPRECIATION_METHODS.join(", ")}` };
+  }
+  const round22 = (n) => Math.round(n * 100) / 100;
+  const depreciableBase = round22(cost - salvageValue);
+  const schedule = [];
+  let accumulated = 0;
+  if (method === "straight-line") {
+    const annual = round22(depreciableBase / usefulLifeYears);
+    for (let year = 1; year <= usefulLifeYears; year++) {
+      const expense = year === usefulLifeYears ? round22(depreciableBase - accumulated) : annual;
+      accumulated = round22(accumulated + expense);
+      schedule.push({ year, depreciationExpense: expense, accumulatedDepreciation: accumulated, bookValue: round22(cost - accumulated) });
+    }
+  } else if (method === "double-declining-balance") {
+    const rate = 2 / usefulLifeYears;
+    let bookValue = cost;
+    for (let year = 1; year <= usefulLifeYears; year++) {
+      let expense = round22(bookValue * rate);
+      if (bookValue - expense < salvageValue) expense = round22(bookValue - salvageValue);
+      if (expense < 0) expense = 0;
+      bookValue = round22(bookValue - expense);
+      accumulated = round22(accumulated + expense);
+      schedule.push({ year, depreciationExpense: expense, accumulatedDepreciation: accumulated, bookValue });
+    }
+  } else {
+    const sumOfYears = usefulLifeYears * (usefulLifeYears + 1) / 2;
+    for (let year = 1; year <= usefulLifeYears; year++) {
+      const fraction = (usefulLifeYears - year + 1) / sumOfYears;
+      const expense = year === usefulLifeYears ? round22(depreciableBase - accumulated) : round22(fraction * depreciableBase);
+      accumulated = round22(accumulated + expense);
+      schedule.push({ year, depreciationExpense: expense, accumulatedDepreciation: accumulated, bookValue: round22(cost - accumulated) });
+    }
+  }
+  return {
+    cost,
+    salvageValue,
+    usefulLifeYears,
+    method,
+    totalDepreciation: accumulated,
+    schedule
+  };
+}
 
-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, USD_DENOMINATIONS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCashBreakdown, calculateCdMaturity, calculateChange, calculateCompoundInterest, calculateDiscount, calculateEmi, calculateLoan, calculateMarginMarkup, 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, USD_DENOMINATIONS, applySuccessiveDiscounts, autoFormat, bumpVersion, calcAspectRatio, calcSubnet, calculateBreakEven, calculateCashBreakdown, calculateCdMaturity, calculateChange, calculateCompoundInterest, calculateDepreciationSchedule, calculateDiscount, calculateEmi, calculateLoan, calculateMarginMarkup, 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 };

package/dist/{chunk-F2CEN226.js → chunk-P7TXG7CI.js}

@@ -11,6 +11,7 @@ __export(text_exports, {
   LINE_OPS: () => LINE_OPS,
   MORSE_CODE: () => MORSE_CODE,
   addBorder: () => addBorder,
+  analyzeKeywordDensity: () => analyzeKeywordDensity,
   analyzeSentenceLengths: () => analyzeSentenceLengths,
   analyzeText: () => analyzeText,
   applyOp: () => applyOp,
@@ -2670,6 +2671,131 @@ function analyzeSentenceLengths(text) {
     buckets
   };
 }
+var KEYWORD_DENSITY_STOPWORDS = /* @__PURE__ */ new Set([
+  "a",
+  "an",
+  "the",
+  "and",
+  "or",
+  "but",
+  "if",
+  "then",
+  "else",
+  "for",
+  "nor",
+  "so",
+  "yet",
+  "of",
+  "in",
+  "on",
+  "at",
+  "to",
+  "from",
+  "by",
+  "with",
+  "about",
+  "against",
+  "between",
+  "into",
+  "through",
+  "during",
+  "before",
+  "after",
+  "above",
+  "below",
+  "up",
+  "down",
+  "out",
+  "off",
+  "over",
+  "under",
+  "again",
+  "further",
+  "once",
+  "is",
+  "are",
+  "was",
+  "were",
+  "be",
+  "been",
+  "being",
+  "am",
+  "do",
+  "does",
+  "did",
+  "doing",
+  "have",
+  "has",
+  "had",
+  "having",
+  "i",
+  "me",
+  "my",
+  "we",
+  "our",
+  "you",
+  "your",
+  "he",
+  "him",
+  "his",
+  "she",
+  "her",
+  "it",
+  "its",
+  "they",
+  "them",
+  "their",
+  "this",
+  "that",
+  "these",
+  "those",
+  "as",
+  "not",
+  "no",
+  "can",
+  "will",
+  "just",
+  "than",
+  "too",
+  "very",
+  "would",
+  "should",
+  "could",
+  "there",
+  "here",
+  "what",
+  "which",
+  "who",
+  "whom"
+]);
+function analyzeKeywordDensity(text, options = {}) {
+  if (!text || !text.trim()) return { error: "Input text is empty" };
+  const topN = options.topN ?? 10;
+  const minWordLength = options.minWordLength ?? 3;
+  const ngramSize = options.ngramSize ?? 1;
+  if (!Number.isInteger(topN) || topN <= 0) return { error: "topN must be a positive whole number" };
+  if (!Number.isInteger(minWordLength) || minWordLength < 1) return { error: "minWordLength must be a positive whole number" };
+  if (!Number.isInteger(ngramSize) || ngramSize < 1 || ngramSize > 3) return { error: "ngramSize must be 1, 2, or 3" };
+  const tokens = text.toLowerCase().match(/[a-z0-9']+/g) ?? [];
+  const totalWords = tokens.length;
+  if (totalWords === 0) return { error: "No words found in input text" };
+  if (totalWords < ngramSize) return { error: "Input text has fewer words than the requested phrase length" };
+  const counts = /* @__PURE__ */ new Map();
+  for (let i = 0; i <= tokens.length - ngramSize; i++) {
+    const phraseWords = tokens.slice(i, i + ngramSize);
+    if (phraseWords.some((w) => w.length < minWordLength)) continue;
+    if (ngramSize === 1 && KEYWORD_DENSITY_STOPWORDS.has(phraseWords[0])) continue;
+    const phrase = phraseWords.join(" ");
+    counts.set(phrase, (counts.get(phrase) ?? 0) + 1);
+  }
+  const keywords = Array.from(counts.entries()).map(([keyword, count]) => ({ keyword, count, density: Math.round(count / totalWords * 1e3) / 10 })).sort((a, b) => b.count - a.count || a.keyword.localeCompare(b.keyword)).slice(0, topN);
+  return {
+    totalWords,
+    uniqueKeywords: counts.size,
+    ngramSize,
+    keywords
+  };
+}
 var EMOJI_TABLE = [
   { emoji: "\u{1F600}", name: "grinning face", shortcode: "grinning", codepoint: "U+1F600", category: "Smileys & Emotion", keywords: ["happy", "smile"] },
   { emoji: "\u{1F603}", name: "grinning face with big eyes", shortcode: "smiley", codepoint: "U+1F603", category: "Smileys & Emotion", keywords: ["happy", "joy"] },
@@ -2970,4 +3096,4 @@ function getEmojiCategories() {
   return Array.from(new Set(EMOJI_TABLE.map((e) => e.category)));
 }
 
-export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, EMOJI_TABLE, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeSentenceLengths, analyzeText, applyOp, applyOps, calculateStringDistance, centerText, convertAll, convertCase, countWords, csvToHtml, csvToMarkdown, detectDelimiter, detectFillerWords, detectPassiveVoice, diffLines, diffLinesSimple, diffStats, escapeAll, escapeString, extractHeadings, formatReadingTime, generate, generateDiff, generateHtmlTable, generateMarkdownTable, generateParagraphs, generateSentences, generateWords, getAvailableFonts, getEmojiByCategory, getEmojiByChar, getEmojiByShortcode, getEmojiCategories, getMorseForChar, getMorseTiming, htmlToMarkdown, isValidMorse, markdownToHtml, morseToText, numberToOrdinal, numberToRoman, numberToWords, ordinalWords, parseDiff, parseTableData, readabilityScore, renderMarkdown, romanToNumber, scoreReadability, searchEmoji, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, text_exports, unescapeString, wordFrequency };
+export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, EMOJI_TABLE, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeKeywordDensity, analyzeSentenceLengths, analyzeText, applyOp, applyOps, calculateStringDistance, centerText, convertAll, convertCase, countWords, csvToHtml, csvToMarkdown, detectDelimiter, detectFillerWords, detectPassiveVoice, diffLines, diffLinesSimple, diffStats, escapeAll, escapeString, extractHeadings, formatReadingTime, generate, generateDiff, generateHtmlTable, generateMarkdownTable, generateParagraphs, generateSentences, generateWords, getAvailableFonts, getEmojiByCategory, getEmojiByChar, getEmojiByShortcode, getEmojiCategories, getMorseForChar, getMorseTiming, htmlToMarkdown, isValidMorse, markdownToHtml, morseToText, numberToOrdinal, numberToRoman, numberToWords, ordinalWords, parseDiff, parseTableData, readabilityScore, renderMarkdown, romanToNumber, scoreReadability, searchEmoji, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, text_exports, unescapeString, wordFrequency };

package/dist/index.cjs

@@ -2063,6 +2063,7 @@ __export(text_exports, {
   LINE_OPS: () => LINE_OPS,
   MORSE_CODE: () => MORSE_CODE,
   addBorder: () => addBorder,
+  analyzeKeywordDensity: () => analyzeKeywordDensity,
   analyzeSentenceLengths: () => analyzeSentenceLengths,
   analyzeText: () => analyzeText,
   applyOp: () => applyOp,
@@ -4722,6 +4723,131 @@ function analyzeSentenceLengths(text) {
     buckets
   };
 }
+var KEYWORD_DENSITY_STOPWORDS = /* @__PURE__ */ new Set([
+  "a",
+  "an",
+  "the",
+  "and",
+  "or",
+  "but",
+  "if",
+  "then",
+  "else",
+  "for",
+  "nor",
+  "so",
+  "yet",
+  "of",
+  "in",
+  "on",
+  "at",
+  "to",
+  "from",
+  "by",
+  "with",
+  "about",
+  "against",
+  "between",
+  "into",
+  "through",
+  "during",
+  "before",
+  "after",
+  "above",
+  "below",
+  "up",
+  "down",
+  "out",
+  "off",
+  "over",
+  "under",
+  "again",
+  "further",
+  "once",
+  "is",
+  "are",
+  "was",
+  "were",
+  "be",
+  "been",
+  "being",
+  "am",
+  "do",
+  "does",
+  "did",
+  "doing",
+  "have",
+  "has",
+  "had",
+  "having",
+  "i",
+  "me",
+  "my",
+  "we",
+  "our",
+  "you",
+  "your",
+  "he",
+  "him",
+  "his",
+  "she",
+  "her",
+  "it",
+  "its",
+  "they",
+  "them",
+  "their",
+  "this",
+  "that",
+  "these",
+  "those",
+  "as",
+  "not",
+  "no",
+  "can",
+  "will",
+  "just",
+  "than",
+  "too",
+  "very",
+  "would",
+  "should",
+  "could",
+  "there",
+  "here",
+  "what",
+  "which",
+  "who",
+  "whom"
+]);
+function analyzeKeywordDensity(text, options = {}) {
+  if (!text || !text.trim()) return { error: "Input text is empty" };
+  const topN = options.topN ?? 10;
+  const minWordLength = options.minWordLength ?? 3;
+  const ngramSize = options.ngramSize ?? 1;
+  if (!Number.isInteger(topN) || topN <= 0) return { error: "topN must be a positive whole number" };
+  if (!Number.isInteger(minWordLength) || minWordLength < 1) return { error: "minWordLength must be a positive whole number" };
+  if (!Number.isInteger(ngramSize) || ngramSize < 1 || ngramSize > 3) return { error: "ngramSize must be 1, 2, or 3" };
+  const tokens = text.toLowerCase().match(/[a-z0-9']+/g) ?? [];
+  const totalWords = tokens.length;
+  if (totalWords === 0) return { error: "No words found in input text" };
+  if (totalWords < ngramSize) return { error: "Input text has fewer words than the requested phrase length" };
+  const counts = /* @__PURE__ */ new Map();
+  for (let i = 0; i <= tokens.length - ngramSize; i++) {
+    const phraseWords = tokens.slice(i, i + ngramSize);
+    if (phraseWords.some((w) => w.length < minWordLength)) continue;
+    if (ngramSize === 1 && KEYWORD_DENSITY_STOPWORDS.has(phraseWords[0])) continue;
+    const phrase = phraseWords.join(" ");
+    counts.set(phrase, (counts.get(phrase) ?? 0) + 1);
+  }
+  const keywords = Array.from(counts.entries()).map(([keyword, count]) => ({ keyword, count, density: Math.round(count / totalWords * 1e3) / 10 })).sort((a, b) => b.count - a.count || a.keyword.localeCompare(b.keyword)).slice(0, topN);
+  return {
+    totalWords,
+    uniqueKeywords: counts.size,
+    ngramSize,
+    keywords
+  };
+}
 var EMOJI_TABLE = [
   { emoji: "\u{1F600}", name: "grinning face", shortcode: "grinning", codepoint: "U+1F600", category: "Smileys & Emotion", keywords: ["happy", "smile"] },
   { emoji: "\u{1F603}", name: "grinning face with big eyes", shortcode: "smiley", codepoint: "U+1F603", category: "Smileys & Emotion", keywords: ["happy", "joy"] },
@@ -8002,6 +8128,7 @@ __export(units_exports, {
   calculateCdMaturity: () => calculateCdMaturity,
   calculateChange: () => calculateChange,
   calculateCompoundInterest: () => calculateCompoundInterest,
+  calculateDepreciationSchedule: () => calculateDepreciationSchedule,
   calculateDiscount: () => calculateDiscount,
   calculateEmi: () => calculateEmi,
   calculateLoan: () => calculateLoan,
@@ -9999,6 +10126,59 @@ function calculateCdMaturity(principal, annualRatePercent, termMonths, compounds
   }
   return result;
 }
+var DEPRECIATION_METHODS = ["straight-line", "double-declining-balance", "sum-of-years-digits"];
+function calculateDepreciationSchedule(cost, salvageValue, usefulLifeYears, method) {
+  if (!Number.isFinite(cost) || cost <= 0) return { error: "Cost must be a positive number" };
+  if (!Number.isFinite(salvageValue) || salvageValue < 0) {
+    return { error: "Salvage value must be zero or a positive number" };
+  }
+  if (salvageValue >= cost) return { error: "Salvage value must be less than cost" };
+  if (!Number.isInteger(usefulLifeYears) || usefulLifeYears <= 0) {
+    return { error: "Useful life must be a positive whole number of years" };
+  }
+  if (!DEPRECIATION_METHODS.includes(method)) {
+    return { error: `Method must be one of: ${DEPRECIATION_METHODS.join(", ")}` };
+  }
+  const round23 = (n) => Math.round(n * 100) / 100;
+  const depreciableBase = round23(cost - salvageValue);
+  const schedule = [];
+  let accumulated = 0;
+  if (method === "straight-line") {
+    const annual = round23(depreciableBase / usefulLifeYears);
+    for (let year = 1; year <= usefulLifeYears; year++) {
+      const expense = year === usefulLifeYears ? round23(depreciableBase - accumulated) : annual;
+      accumulated = round23(accumulated + expense);
+      schedule.push({ year, depreciationExpense: expense, accumulatedDepreciation: accumulated, bookValue: round23(cost - accumulated) });
+    }
+  } else if (method === "double-declining-balance") {
+    const rate = 2 / usefulLifeYears;
+    let bookValue = cost;
+    for (let year = 1; year <= usefulLifeYears; year++) {
+      let expense = round23(bookValue * rate);
+      if (bookValue - expense < salvageValue) expense = round23(bookValue - salvageValue);
+      if (expense < 0) expense = 0;
+      bookValue = round23(bookValue - expense);
+      accumulated = round23(accumulated + expense);
+      schedule.push({ year, depreciationExpense: expense, accumulatedDepreciation: accumulated, bookValue });
+    }
+  } else {
+    const sumOfYears = usefulLifeYears * (usefulLifeYears + 1) / 2;
+    for (let year = 1; year <= usefulLifeYears; year++) {
+      const fraction = (usefulLifeYears - year + 1) / sumOfYears;
+      const expense = year === usefulLifeYears ? round23(depreciableBase - accumulated) : round23(fraction * depreciableBase);
+      accumulated = round23(accumulated + expense);
+      schedule.push({ year, depreciationExpense: expense, accumulatedDepreciation: accumulated, bookValue: round23(cost - accumulated) });
+    }
+  }
+  return {
+    cost,
+    salvageValue,
+    usefulLifeYears,
+    method,
+    totalDepreciation: accumulated,
+    schedule
+  };
+}
 
 // src/tools/network.ts
 var network_exports = {};

package/dist/index.d.cts

@@ -1,11 +1,11 @@
 export { j as json } from './json-Ta9JykSB.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
 export { h as hashing } from './hashing-CJjlvqS_.cjs';
-export { t as text } from './text-kHkT9VtT.cjs';
+export { t as text } from './text-DWUcY8H1.cjs';
 export { d as data } from './data-BKpEOcOX.cjs';
 export { g as generators } from './generators-Du8cBesn.cjs';
 export { t as time } from './time-KqJjdqII.cjs';
-export { u as units } from './units-DWRmbS_a.cjs';
+export { u as units } from './units-DU4Pisfx.cjs';
 export { n as network } from './network-Bzm1tjMA.cjs';
 export { a as api } from './api-DmTNE4c1.cjs';
 export { c as code } from './code-KXoRsHtl.cjs';

package/dist/index.d.ts

@@ -1,11 +1,11 @@
 export { j as json } from './json-Ta9JykSB.js';
 export { e as encoding } from './encoding-Dk3wpmb3.js';
 export { h as hashing } from './hashing-CJjlvqS_.js';
-export { t as text } from './text-kHkT9VtT.js';
+export { t as text } from './text-DWUcY8H1.js';
 export { d as data } from './data-BKpEOcOX.js';
 export { g as generators } from './generators-Du8cBesn.js';
 export { t as time } from './time-KqJjdqII.js';
-export { u as units } from './units-DWRmbS_a.js';
+export { u as units } from './units-DU4Pisfx.js';
 export { n as network } from './network-Bzm1tjMA.js';
 export { a as api } from './api-DmTNE4c1.js';
 export { c as code } from './code-KXoRsHtl.js';

package/dist/index.js

@@ -1,5 +1,5 @@
 export { media_exports as media } from './chunk-L6V4W4SU.js';
-export { units_exports as units } from './chunk-DFLHX4NW.js';
+export { units_exports as units } from './chunk-KMQHBUYO.js';
 export { network_exports as network } from './chunk-7PEKYLRB.js';
 export { api_exports as api } from './chunk-52ZDKSIX.js';
 export { code_exports as code } from './chunk-JL7YTXRB.js';
@@ -10,7 +10,7 @@ export { ai_agent_exports as ai_agent } from './chunk-EKIXOA7B.js';
 export { json_exports as json } from './chunk-WVEKRKGU.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-PET2CGTH.js';
-export { text_exports as text } from './chunk-F2CEN226.js';
+export { text_exports as text } from './chunk-P7TXG7CI.js';
 export { data_exports as data } from './chunk-JR354NH4.js';
 export { generators_exports as generators } from './chunk-3TYWIX3B.js';
 export { time_exports as time } from './chunk-IEPWZERQ.js';

package/dist/{text-kHkT9VtT.d.cts → text-DWUcY8H1.d.cts}

@@ -23,6 +23,7 @@
  *   - readability-score: scoreReadability
  *   - filler-word-detector: detectFillerWords
  *   - sentence-length-distribution: analyzeSentenceLengths
+ *   - keyword-density-analyzer: analyzeKeywordDensity
  *   - emoji-lookup    : searchEmoji, getEmojiByShortcode, getEmojiByChar, getEmojiByCategory, getEmojiCategories, EMOJI_TABLE
  */
 interface WordCountResult {
@@ -357,6 +358,33 @@ interface SentenceLengthDistribution {
  * (e.g. "Dr.") as sentence boundaries.
  */
 declare function analyzeSentenceLengths(text: string): SentenceLengthDistribution;
+interface KeywordDensityEntry {
+    keyword: string;
+    count: number;
+    density: number;
+}
+interface KeywordDensityResult {
+    totalWords: number;
+    uniqueKeywords: number;
+    ngramSize: number;
+    keywords: KeywordDensityEntry[];
+}
+interface KeywordDensityOptions {
+    topN?: number;
+    minWordLength?: number;
+    ngramSize?: number;
+}
+/**
+ * Count keyword/phrase frequency and density (occurrences per 100 words)
+ * across a block of text, the way an SEO keyword-density checker does.
+ * With the default ngramSize of 1, common English stopwords and words
+ * shorter than minWordLength are excluded; for ngramSize 2 or 3 (phrases),
+ * stopwords are kept since useful phrases often contain them, but every
+ * word in the phrase must still meet minWordLength.
+ */
+declare function analyzeKeywordDensity(text: string, options?: KeywordDensityOptions): KeywordDensityResult | {
+    error: string;
+};
 interface EmojiEntry {
     emoji: string;
     name: string;
@@ -401,6 +429,9 @@ type text_EscapeMode = EscapeMode;
 type text_FillerCategory = FillerCategory;
 type text_FillerMatch = FillerMatch;
 type text_FillerWordResult = FillerWordResult;
+type text_KeywordDensityEntry = KeywordDensityEntry;
+type text_KeywordDensityOptions = KeywordDensityOptions;
+type text_KeywordDensityResult = KeywordDensityResult;
 declare const text_LINE_OPS: typeof LINE_OPS;
 type text_LineOp = LineOp;
 type text_LineType = LineType;
@@ -424,6 +455,7 @@ type text_TableOptions = TableOptions;
 type text_TextAnalysis = TextAnalysis;
 type text_WordCountResult = WordCountResult;
 declare const text_addBorder: typeof addBorder;
+declare const text_analyzeKeywordDensity: typeof analyzeKeywordDensity;
 declare const text_analyzeSentenceLengths: typeof analyzeSentenceLengths;
 declare const text_analyzeText: typeof analyzeText;
 declare const text_applyOp: typeof applyOp;
@@ -483,7 +515,7 @@ declare const text_textToMorse: typeof textToMorse;
 declare const text_unescapeString: typeof unescapeString;
 declare const text_wordFrequency: typeof wordFrequency;
 declare namespace text {
-  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_EMOJI_TABLE as EMOJI_TABLE, text_ESCAPE_MODES as ESCAPE_MODES, type text_EmojiEntry as EmojiEntry, type text_EscapeMode as EscapeMode, type text_FillerCategory as FillerCategory, type text_FillerMatch as FillerMatch, type text_FillerWordResult as FillerWordResult, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityResult as ReadabilityResult, type text_ReadabilityScore as ReadabilityScore, type text_SentenceLengthBucket as SentenceLengthBucket, type text_SentenceLengthDistribution as SentenceLengthDistribution, type text_SlugSeparator as SlugSeparator, type text_StringDistanceMode as StringDistanceMode, type text_StringDistanceResult as StringDistanceResult, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeSentenceLengths as analyzeSentenceLengths, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_calculateStringDistance as calculateStringDistance, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectFillerWords as detectFillerWords, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getEmojiByCategory as getEmojiByCategory, text_getEmojiByChar as getEmojiByChar, text_getEmojiByShortcode as getEmojiByShortcode, text_getEmojiCategories as getEmojiCategories, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_scoreReadability as scoreReadability, text_searchEmoji as searchEmoji, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
+  export { type text_AsciiFont as AsciiFont, type text_AsciiOptions as AsciiOptions, text_CASE_FORMATS as CASE_FORMATS, type text_CaseFormat as CaseFormat, type text_ConvertOptions as ConvertOptions, text_DEFAULT_CONVERT_OPTIONS as DEFAULT_CONVERT_OPTIONS, type text_DiffFile as DiffFile, type text_DiffHunk as DiffHunk, type text_DiffLine as DiffLine, type text_DiffResult as DiffResult, type text_DiffType as DiffType, type text_DiffViewerLine as DiffViewerLine, text_EMOJI_TABLE as EMOJI_TABLE, text_ESCAPE_MODES as ESCAPE_MODES, type text_EmojiEntry as EmojiEntry, type text_EscapeMode as EscapeMode, type text_FillerCategory as FillerCategory, type text_FillerMatch as FillerMatch, type text_FillerWordResult as FillerWordResult, type text_KeywordDensityEntry as KeywordDensityEntry, type text_KeywordDensityOptions as KeywordDensityOptions, type text_KeywordDensityResult as KeywordDensityResult, text_LINE_OPS as LINE_OPS, type text_LineOp as LineOp, type text_LineType as LineType, type text_LoremUnit as LoremUnit, text_MORSE_CODE as MORSE_CODE, type text_MarkdownResult as MarkdownResult, type text_MorseOptions as MorseOptions, type text_ParsedDiff as ParsedDiff, type text_ParsedTable as ParsedTable, type text_PassiveVoiceMatch as PassiveVoiceMatch, type text_PassiveVoiceResult as PassiveVoiceResult, type text_PassiveVoiceSentence as PassiveVoiceSentence, type text_ReadabilityResult as ReadabilityResult, type text_ReadabilityScore as ReadabilityScore, type text_SentenceLengthBucket as SentenceLengthBucket, type text_SentenceLengthDistribution as SentenceLengthDistribution, type text_SlugSeparator as SlugSeparator, type text_StringDistanceMode as StringDistanceMode, type text_StringDistanceResult as StringDistanceResult, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeKeywordDensity as analyzeKeywordDensity, text_analyzeSentenceLengths as analyzeSentenceLengths, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, text_calculateStringDistance as calculateStringDistance, text_centerText as centerText, text_convertAll as convertAll, text_convertCase as convertCase, text_countWords as countWords, text_csvToHtml as csvToHtml, text_csvToMarkdown as csvToMarkdown, text_detectDelimiter as detectDelimiter, text_detectFillerWords as detectFillerWords, text_detectPassiveVoice as detectPassiveVoice, text_diffLines as diffLines, text_diffLinesSimple as diffLinesSimple, text_diffStats as diffStats, text_escapeAll as escapeAll, text_escapeString as escapeString, text_extractHeadings as extractHeadings, text_formatReadingTime as formatReadingTime, text_generate as generate, text_generateDiff as generateDiff, text_generateHtmlTable as generateHtmlTable, text_generateMarkdownTable as generateMarkdownTable, text_generateParagraphs as generateParagraphs, text_generateSentences as generateSentences, text_generateWords as generateWords, text_getAvailableFonts as getAvailableFonts, text_getEmojiByCategory as getEmojiByCategory, text_getEmojiByChar as getEmojiByChar, text_getEmojiByShortcode as getEmojiByShortcode, text_getEmojiCategories as getEmojiCategories, text_getMorseForChar as getMorseForChar, text_getMorseTiming as getMorseTiming, text_htmlToMarkdown as htmlToMarkdown, text_isValidMorse as isValidMorse, text_markdownToHtml as markdownToHtml, text_morseToText as morseToText, text_numberToOrdinal as numberToOrdinal, text_numberToRoman as numberToRoman, text_numberToWords as numberToWords, text_ordinalWords as ordinalWords, text_parseDiff as parseDiff, text_parseTableData as parseTableData, text_readabilityScore as readabilityScore, text_renderMarkdown as renderMarkdown, text_romanToNumber as romanToNumber, text_scoreReadability as scoreReadability, text_searchEmoji as searchEmoji, text_sentenceCount as sentenceCount, text_slugify as slugify, text_slugifyAll as slugifyAll, text_syllableCount as syllableCount, text_textToAscii as textToAscii, text_textToMorse as textToMorse, text_unescapeString as unescapeString, text_wordFrequency as wordFrequency };
 }
 
-export { csvToMarkdown as $, type AsciiFont as A, type SlugSeparator as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, EMOJI_TABLE as E, type FillerCategory as F, type StringDistanceMode as G, type StringDistanceResult as H, type TextAnalysis as I, addBorder as J, analyzeSentenceLengths as K, LINE_OPS as L, MORSE_CODE as M, analyzeText as N, applyOp as O, type ParsedDiff as P, applyOps as Q, type ReadabilityResult as R, type SentenceLengthBucket as S, type TableOptions as T, calculateStringDistance as U, centerText as V, type WordCountResult as W, convertAll as X, convertCase as Y, countWords as Z, csvToHtml as _, type AsciiOptions as a, detectDelimiter as a0, detectFillerWords as a1, detectPassiveVoice as a2, diffLines as a3, diffLinesSimple as a4, diffStats as a5, escapeAll as a6, escapeString as a7, extractHeadings as a8, formatReadingTime as a9, romanToNumber as aA, scoreReadability as aB, searchEmoji as aC, sentenceCount as aD, slugify as aE, slugifyAll as aF, syllableCount as aG, textToAscii as aH, textToMorse as aI, unescapeString as aJ, wordFrequency as aK, generate as aa, generateDiff as ab, generateHtmlTable as ac, generateMarkdownTable as ad, generateParagraphs as ae, generateSentences as af, generateWords as ag, getAvailableFonts as ah, getEmojiByCategory as ai, getEmojiByChar as aj, getEmojiByShortcode as ak, getEmojiCategories as al, getMorseForChar as am, getMorseTiming as an, htmlToMarkdown as ao, isValidMorse as ap, markdownToHtml as aq, morseToText as ar, numberToOrdinal as as, numberToRoman as at, numberToWords as au, ordinalWords as av, parseDiff as aw, parseTableData as ax, readabilityScore as ay, renderMarkdown as az, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, ESCAPE_MODES as j, type EmojiEntry as k, type EscapeMode as l, type FillerMatch as m, type FillerWordResult as n, type LineOp as o, type LineType as p, type LoremUnit as q, type MarkdownResult as r, type MorseOptions as s, text as t, type ParsedTable as u, type PassiveVoiceMatch as v, type PassiveVoiceResult as w, type PassiveVoiceSentence as x, type ReadabilityScore as y, type SentenceLengthDistribution as z };
+export { convertAll as $, type AsciiFont as A, type ReadabilityScore as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, EMOJI_TABLE as E, type FillerCategory as F, type SentenceLengthDistribution as G, type SlugSeparator as H, type StringDistanceMode as I, type StringDistanceResult as J, type KeywordDensityEntry as K, LINE_OPS as L, MORSE_CODE as M, type TextAnalysis as N, addBorder as O, type ParsedDiff as P, analyzeKeywordDensity as Q, type ReadabilityResult as R, type SentenceLengthBucket as S, type TableOptions as T, analyzeSentenceLengths as U, analyzeText as V, type WordCountResult as W, applyOp as X, applyOps as Y, calculateStringDistance as Z, centerText as _, type AsciiOptions as a, convertCase as a0, countWords as a1, csvToHtml as a2, csvToMarkdown as a3, detectDelimiter as a4, detectFillerWords as a5, detectPassiveVoice as a6, diffLines as a7, diffLinesSimple as a8, diffStats as a9, parseDiff as aA, parseTableData as aB, readabilityScore as aC, renderMarkdown as aD, romanToNumber as aE, scoreReadability as aF, searchEmoji as aG, sentenceCount as aH, slugify as aI, slugifyAll as aJ, syllableCount as aK, textToAscii as aL, textToMorse as aM, unescapeString as aN, wordFrequency as aO, escapeAll as aa, escapeString as ab, extractHeadings as ac, formatReadingTime as ad, generate as ae, generateDiff as af, generateHtmlTable as ag, generateMarkdownTable as ah, generateParagraphs as ai, generateSentences as aj, generateWords as ak, getAvailableFonts as al, getEmojiByCategory as am, getEmojiByChar as an, getEmojiByShortcode as ao, getEmojiCategories as ap, getMorseForChar as aq, getMorseTiming as ar, htmlToMarkdown as as, isValidMorse as at, markdownToHtml as au, morseToText as av, numberToOrdinal as aw, numberToRoman as ax, numberToWords as ay, ordinalWords as az, type CaseFormat as b, type ConvertOptions as c, type DiffFile as d, type DiffHunk as e, type DiffLine as f, type DiffResult as g, type DiffType as h, type DiffViewerLine as i, ESCAPE_MODES as j, type EmojiEntry as k, type EscapeMode as l, type FillerMatch as m, type FillerWordResult as n, type KeywordDensityOptions as o, type KeywordDensityResult as p, type LineOp as q, type LineType as r, type LoremUnit as s, text as t, type MarkdownResult as u, type MorseOptions as v, type ParsedTable as w, type PassiveVoiceMatch as x, type PassiveVoiceResult as y, type PassiveVoiceSentence as z };