@utilix-tech/sdk 0.19.0 → 0.20.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.20.0
+- Add `buildCacheControl` (cache-control-builder): assemble and explain a `Cache-Control` response header from directives, with warnings for combinations that cancel out.
+- Add `detectFillerWords` (filler-word-detector): scan text for filler words, hedge phrases, and clichés with per-phrase counts and a density score.
+
 ## 0.19.0
 - Add `detectRedos` (regex-redos-detector): statically flag catastrophic-backtracking risk (nested quantifiers, overlapping alternation, adjacent overlapping quantifiers).
 

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**553 developer utility functions for Node.js: runs locally, no API key required.**
+**556 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)
@@ -132,7 +132,8 @@ generateHtpasswdFile([{ username: "alice", password: "secret" }]);
 
 ```ts
 import { convertCase, slugify, countWords, generateWords, generateParagraphs,
-         escapeString, htmlToMarkdown, applyOps, detectPassiveVoice, scoreReadability } from "@utilix-tech/sdk/text";
+         escapeString, htmlToMarkdown, applyOps, detectPassiveVoice, scoreReadability,
+         detectFillerWords } from "@utilix-tech/sdk/text";
 
 convertCase("hello world", "camelCase");   // "helloWorld"
 convertCase("hello world", "PascalCase");  // "HelloWorld"
@@ -157,6 +158,10 @@ detectPassiveVoice("The report was reviewed by the committee. They approved it."
 // Flesch Reading Ease, Flesch-Kincaid Grade Level, and Gunning Fog Index
 scoreReadability("The cat sat on the mat. It was a sunny day.");
 // { fleschReadingEase: 109, fleschKincaidGrade: -0.6, gunningFog: 2.2, readingLevel: "Very easy (5th grade)", ... }
+
+// Flag filler words, hedge phrases, and clichés with counts and density
+detectFillerWords("At the end of the day, I just really think we should circle back.");
+// { totalMatches: 4, fillerCount: 2, clicheCount: 2, density: 28.6, matches: [...] }
 ```
 
 ---
@@ -315,7 +320,7 @@ calculateTimeValue(1000, 5, 10, "future");
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
          parseHar, validateSitemap, validateRobotsTxt,
-         parseUserAgent } from "@utilix-tech/sdk/network";
+         parseUserAgent, buildCacheControl } from "@utilix-tech/sdk/network";
 
 getStatusCode(404);
 // { code: 404, text: "Not Found", description: "...", category: "Client Error" }
@@ -345,6 +350,10 @@ validateSitemap('<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"><ur
 // Validate a robots.txt file: User-agent groups, rules, and syntax mistakes
 validateRobotsTxt("User-agent: *\nDisallow: /admin\nSitemap: https://example.com/sitemap.xml");
 // { groups: [...], sitemaps: [...], issues: [...], valid: true }
+
+// Build and explain a Cache-Control response header from directives
+buildCacheControl({ visibility: "public", maxAge: 3600, mustRevalidate: true });
+// { header: "public, max-age=3600, must-revalidate", directives: [...], warnings: [] }
 ```
 
 ---

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

@@ -20,6 +20,7 @@ __export(text_exports, {
   csvToHtml: () => csvToHtml,
   csvToMarkdown: () => csvToMarkdown,
   detectDelimiter: () => detectDelimiter,
+  detectFillerWords: () => detectFillerWords,
   detectPassiveVoice: () => detectPassiveVoice,
   diffLines: () => diffLines,
   diffLinesSimple: () => diffLinesSimple,
@@ -2457,5 +2458,103 @@ function scoreReadability(text) {
     readingLevel: readabilityGradeLabel(fleschReadingEase)
   };
 }
+var FILLER_WORDS = [
+  "very",
+  "really",
+  "just",
+  "actually",
+  "basically",
+  "literally",
+  "simply",
+  "totally",
+  "definitely",
+  "certainly",
+  "essentially",
+  "absolutely",
+  "completely",
+  "extremely",
+  "truly",
+  "honestly",
+  "seriously",
+  "obviously",
+  "clearly",
+  "quite",
+  "rather",
+  "somewhat",
+  "fairly",
+  "virtually"
+];
+var HEDGE_PHRASES = [
+  "maybe",
+  "perhaps",
+  "probably",
+  "possibly",
+  "arguably",
+  "kind of",
+  "sort of",
+  "a bit",
+  "a little",
+  "more or less",
+  "in my opinion",
+  "i think",
+  "i believe",
+  "to some extent"
+];
+var CLICHE_PHRASES = [
+  "at the end of the day",
+  "think outside the box",
+  "low-hanging fruit",
+  "move the needle",
+  "circle back",
+  "touch base",
+  "on the same page",
+  "hit the ground running",
+  "paradigm shift",
+  "win-win",
+  "game changer",
+  "best of both worlds",
+  "only time will tell",
+  "back to the drawing board",
+  "the tip of the iceberg",
+  "a perfect storm",
+  "needle in a haystack",
+  "raise the bar",
+  "push the envelope",
+  "the elephant in the room",
+  "boil the ocean",
+  "when it rains it pours"
+];
+var FILLER_DICTIONARY = [
+  ...FILLER_WORDS.map((phrase) => ({ phrase, category: "filler" })),
+  ...HEDGE_PHRASES.map((phrase) => ({ phrase, category: "hedge" })),
+  ...CLICHE_PHRASES.map((phrase) => ({ phrase, category: "cliche" }))
+];
+function _fillerRegex(phrase) {
+  const tokens = phrase.split(/\s+/).map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+  return new RegExp("\\b" + tokens.join("\\s+") + "\\b", "gi");
+}
+function detectFillerWords(text) {
+  const totalWords = (text.match(/[A-Za-z0-9']+/g) ?? []).length;
+  const matches = [];
+  for (const entry of FILLER_DICTIONARY) {
+    const re = _fillerRegex(entry.phrase);
+    const indices = [];
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      indices.push(m.index);
+      if (m.index === re.lastIndex) re.lastIndex++;
+    }
+    if (indices.length > 0) {
+      matches.push({ phrase: entry.phrase, category: entry.category, count: indices.length, indices });
+    }
+  }
+  matches.sort((a, b) => b.count - a.count || a.category.localeCompare(b.category) || a.phrase.localeCompare(b.phrase));
+  const fillerCount = matches.filter((x) => x.category === "filler").reduce((s, x) => s + x.count, 0);
+  const hedgeCount = matches.filter((x) => x.category === "hedge").reduce((s, x) => s + x.count, 0);
+  const clicheCount = matches.filter((x) => x.category === "cliche").reduce((s, x) => s + x.count, 0);
+  const totalMatches = fillerCount + hedgeCount + clicheCount;
+  const density = totalWords > 0 ? Math.round(totalMatches / totalWords * 1e3) / 10 : 0;
+  return { totalWords, totalMatches, fillerCount, hedgeCount, clicheCount, density, matches };
+}
 
-export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeText, applyOp, applyOps, centerText, convertAll, convertCase, countWords, csvToHtml, csvToMarkdown, detectDelimiter, detectPassiveVoice, diffLines, diffLinesSimple, diffStats, escapeAll, escapeString, extractHeadings, formatReadingTime, generate, generateDiff, generateHtmlTable, generateMarkdownTable, generateParagraphs, generateSentences, generateWords, getAvailableFonts, getMorseForChar, getMorseTiming, htmlToMarkdown, isValidMorse, markdownToHtml, morseToText, numberToOrdinal, numberToRoman, numberToWords, ordinalWords, parseDiff, parseTableData, readabilityScore, renderMarkdown, romanToNumber, scoreReadability, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, text_exports, unescapeString, wordFrequency };
+export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeText, applyOp, applyOps, centerText, convertAll, convertCase, countWords, csvToHtml, csvToMarkdown, detectDelimiter, detectFillerWords, detectPassiveVoice, diffLines, diffLinesSimple, diffStats, escapeAll, escapeString, extractHeadings, formatReadingTime, generate, generateDiff, generateHtmlTable, generateMarkdownTable, generateParagraphs, generateSentences, generateWords, getAvailableFonts, getMorseForChar, getMorseTiming, htmlToMarkdown, isValidMorse, markdownToHtml, morseToText, numberToOrdinal, numberToRoman, numberToWords, ordinalWords, parseDiff, parseTableData, readabilityScore, renderMarkdown, romanToNumber, scoreReadability, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, text_exports, unescapeString, wordFrequency };

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

@@ -6,6 +6,7 @@ __export(network_exports, {
   DNS_RECORD_TYPES: () => DNS_RECORD_TYPES,
   HTTP_HEADERS: () => HTTP_HEADERS,
   STATUS_CODES: () => STATUS_CODES,
+  buildCacheControl: () => buildCacheControl,
   buildDnsQueryUrl: () => buildDnsQueryUrl,
   buildGeoUrl: () => buildGeoUrl,
   buildMapUrl: () => buildMapUrl,
@@ -1721,5 +1722,97 @@ function parseUserAgent(ua) {
   const device = { type: _detectUaDeviceType(s) };
   return { browser, engine, os, device, raw: s };
 }
+var _CACHE_NUM_FIELDS = ["maxAge", "sMaxAge", "staleWhileRevalidate", "staleIfError"];
+function _humanizeSeconds(s) {
+  if (s === 0) return "0 seconds";
+  const units = [
+    [86400, "day"],
+    [3600, "hour"],
+    [60, "minute"],
+    [1, "second"]
+  ];
+  const parts = [];
+  let rem = s;
+  for (const [size, label] of units) {
+    if (rem >= size) {
+      const n = Math.floor(rem / size);
+      rem -= n * size;
+      parts.push(`${n} ${label}${n === 1 ? "" : "s"}`);
+    }
+  }
+  return parts.slice(0, 2).join(" ");
+}
+function buildCacheControl(options = {}) {
+  const nums = {
+    maxAge: null,
+    sMaxAge: null,
+    staleWhileRevalidate: null,
+    staleIfError: null
+  };
+  for (const field of _CACHE_NUM_FIELDS) {
+    const v = options[field];
+    if (v === void 0 || v === null) continue;
+    if (typeof v !== "number" || !Number.isFinite(v) || !Number.isInteger(v) || v < 0) {
+      return { error: `${field} must be a non-negative integer number of seconds` };
+    }
+    nums[field] = v;
+  }
+  const directives = [];
+  const warnings = [];
+  if (options.visibility === "public") {
+    directives.push({ name: "public", value: null, explanation: "Any cache, including shared caches and CDNs, may store this response." });
+  }
+  if (options.visibility === "private") {
+    directives.push({ name: "private", value: null, explanation: "Only the user's browser may cache this response; shared caches and CDNs must not." });
+  }
+  if (options.noCache) {
+    directives.push({ name: "no-cache", value: null, explanation: "A cache may store the response but must revalidate it with the origin before every reuse." });
+  }
+  if (options.noStore) {
+    directives.push({ name: "no-store", value: null, explanation: "No cache may store any part of this request or response." });
+  }
+  if (nums.maxAge !== null) {
+    directives.push({ name: "max-age", value: String(nums.maxAge), explanation: `Considered fresh for ${_humanizeSeconds(nums.maxAge)} (${nums.maxAge}s), after which it becomes stale.` });
+  }
+  if (nums.sMaxAge !== null) {
+    directives.push({ name: "s-maxage", value: String(nums.sMaxAge), explanation: `For shared caches (CDNs, proxies) it is fresh for ${_humanizeSeconds(nums.sMaxAge)} (${nums.sMaxAge}s), overriding max-age there.` });
+  }
+  if (options.mustRevalidate) {
+    directives.push({ name: "must-revalidate", value: null, explanation: "Once stale, a cache must revalidate with the origin and never serve the stale copy." });
+  }
+  if (options.proxyRevalidate) {
+    directives.push({ name: "proxy-revalidate", value: null, explanation: "Like must-revalidate, but the requirement applies only to shared caches." });
+  }
+  if (options.immutable) {
+    directives.push({ name: "immutable", value: null, explanation: "The body will not change while fresh, so browsers should not revalidate it on reload." });
+  }
+  if (options.noTransform) {
+    directives.push({ name: "no-transform", value: null, explanation: "Intermediaries must not modify the response body (for example, recompressing images)." });
+  }
+  if (nums.staleWhileRevalidate !== null) {
+    directives.push({ name: "stale-while-revalidate", value: String(nums.staleWhileRevalidate), explanation: `A cache may serve the stale response for up to ${_humanizeSeconds(nums.staleWhileRevalidate)} (${nums.staleWhileRevalidate}s) while it revalidates in the background.` });
+  }
+  if (nums.staleIfError !== null) {
+    directives.push({ name: "stale-if-error", value: String(nums.staleIfError), explanation: `A cache may serve the stale response for up to ${_humanizeSeconds(nums.staleIfError)} (${nums.staleIfError}s) if the origin returns an error.` });
+  }
+  if (options.mustUnderstand) {
+    directives.push({ name: "must-understand", value: null, explanation: "A cache should store the response only if it understands the caching requirements of the response's status code." });
+  }
+  if (options.noStore && directives.length > 1) {
+    warnings.push("no-store means nothing is cached, so the other directives have no effect.");
+  }
+  if (options.noCache && nums.maxAge !== null) {
+    warnings.push("no-cache forces revalidation on every use, so max-age has little practical effect alongside it.");
+  }
+  if (options.immutable && nums.maxAge === null) {
+    warnings.push("immutable only applies while the response is fresh \u2014 add a max-age so it has a freshness lifetime.");
+  }
+  if (directives.length === 0) {
+    warnings.push("No directives set \u2014 an empty Cache-Control header has no effect.");
+  }
+  const header = directives.map((d) => d.value === null ? d.name : `${d.name}=${d.value}`).join(", ");
+  const snippet = `Cache-Control: ${header}`;
+  return { header, headerName: "Cache-Control", snippet, directives, warnings };
+}
 
-export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };
+export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, network_exports, parseDnsResponse, parseGeoResponse, parseHar, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap };

package/dist/index.cjs

@@ -1874,6 +1874,7 @@ __export(text_exports, {
   csvToHtml: () => csvToHtml,
   csvToMarkdown: () => csvToMarkdown,
   detectDelimiter: () => detectDelimiter,
+  detectFillerWords: () => detectFillerWords,
   detectPassiveVoice: () => detectPassiveVoice,
   diffLines: () => diffLines,
   diffLinesSimple: () => diffLinesSimple,
@@ -4311,6 +4312,104 @@ function scoreReadability(text) {
     readingLevel: readabilityGradeLabel(fleschReadingEase)
   };
 }
+var FILLER_WORDS = [
+  "very",
+  "really",
+  "just",
+  "actually",
+  "basically",
+  "literally",
+  "simply",
+  "totally",
+  "definitely",
+  "certainly",
+  "essentially",
+  "absolutely",
+  "completely",
+  "extremely",
+  "truly",
+  "honestly",
+  "seriously",
+  "obviously",
+  "clearly",
+  "quite",
+  "rather",
+  "somewhat",
+  "fairly",
+  "virtually"
+];
+var HEDGE_PHRASES = [
+  "maybe",
+  "perhaps",
+  "probably",
+  "possibly",
+  "arguably",
+  "kind of",
+  "sort of",
+  "a bit",
+  "a little",
+  "more or less",
+  "in my opinion",
+  "i think",
+  "i believe",
+  "to some extent"
+];
+var CLICHE_PHRASES = [
+  "at the end of the day",
+  "think outside the box",
+  "low-hanging fruit",
+  "move the needle",
+  "circle back",
+  "touch base",
+  "on the same page",
+  "hit the ground running",
+  "paradigm shift",
+  "win-win",
+  "game changer",
+  "best of both worlds",
+  "only time will tell",
+  "back to the drawing board",
+  "the tip of the iceberg",
+  "a perfect storm",
+  "needle in a haystack",
+  "raise the bar",
+  "push the envelope",
+  "the elephant in the room",
+  "boil the ocean",
+  "when it rains it pours"
+];
+var FILLER_DICTIONARY = [
+  ...FILLER_WORDS.map((phrase) => ({ phrase, category: "filler" })),
+  ...HEDGE_PHRASES.map((phrase) => ({ phrase, category: "hedge" })),
+  ...CLICHE_PHRASES.map((phrase) => ({ phrase, category: "cliche" }))
+];
+function _fillerRegex(phrase) {
+  const tokens = phrase.split(/\s+/).map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+  return new RegExp("\\b" + tokens.join("\\s+") + "\\b", "gi");
+}
+function detectFillerWords(text) {
+  const totalWords = (text.match(/[A-Za-z0-9']+/g) ?? []).length;
+  const matches = [];
+  for (const entry of FILLER_DICTIONARY) {
+    const re = _fillerRegex(entry.phrase);
+    const indices = [];
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      indices.push(m.index);
+      if (m.index === re.lastIndex) re.lastIndex++;
+    }
+    if (indices.length > 0) {
+      matches.push({ phrase: entry.phrase, category: entry.category, count: indices.length, indices });
+    }
+  }
+  matches.sort((a, b) => b.count - a.count || a.category.localeCompare(b.category) || a.phrase.localeCompare(b.phrase));
+  const fillerCount = matches.filter((x) => x.category === "filler").reduce((s, x) => s + x.count, 0);
+  const hedgeCount = matches.filter((x) => x.category === "hedge").reduce((s, x) => s + x.count, 0);
+  const clicheCount = matches.filter((x) => x.category === "cliche").reduce((s, x) => s + x.count, 0);
+  const totalMatches = fillerCount + hedgeCount + clicheCount;
+  const density = totalWords > 0 ? Math.round(totalMatches / totalWords * 1e3) / 10 : 0;
+  return { totalWords, totalMatches, fillerCount, hedgeCount, clicheCount, density, matches };
+}
 
 // src/tools/data.ts
 var data_exports = {};
@@ -8009,6 +8108,7 @@ __export(network_exports, {
   DNS_RECORD_TYPES: () => DNS_RECORD_TYPES,
   HTTP_HEADERS: () => HTTP_HEADERS,
   STATUS_CODES: () => STATUS_CODES,
+  buildCacheControl: () => buildCacheControl,
   buildDnsQueryUrl: () => buildDnsQueryUrl,
   buildGeoUrl: () => buildGeoUrl,
   buildMapUrl: () => buildMapUrl,
@@ -9724,6 +9824,98 @@ function parseUserAgent(ua) {
   const device = { type: _detectUaDeviceType(s) };
   return { browser, engine, os, device, raw: s };
 }
+var _CACHE_NUM_FIELDS = ["maxAge", "sMaxAge", "staleWhileRevalidate", "staleIfError"];
+function _humanizeSeconds(s) {
+  if (s === 0) return "0 seconds";
+  const units = [
+    [86400, "day"],
+    [3600, "hour"],
+    [60, "minute"],
+    [1, "second"]
+  ];
+  const parts = [];
+  let rem = s;
+  for (const [size, label] of units) {
+    if (rem >= size) {
+      const n = Math.floor(rem / size);
+      rem -= n * size;
+      parts.push(`${n} ${label}${n === 1 ? "" : "s"}`);
+    }
+  }
+  return parts.slice(0, 2).join(" ");
+}
+function buildCacheControl(options = {}) {
+  const nums = {
+    maxAge: null,
+    sMaxAge: null,
+    staleWhileRevalidate: null,
+    staleIfError: null
+  };
+  for (const field of _CACHE_NUM_FIELDS) {
+    const v = options[field];
+    if (v === void 0 || v === null) continue;
+    if (typeof v !== "number" || !Number.isFinite(v) || !Number.isInteger(v) || v < 0) {
+      return { error: `${field} must be a non-negative integer number of seconds` };
+    }
+    nums[field] = v;
+  }
+  const directives = [];
+  const warnings = [];
+  if (options.visibility === "public") {
+    directives.push({ name: "public", value: null, explanation: "Any cache, including shared caches and CDNs, may store this response." });
+  }
+  if (options.visibility === "private") {
+    directives.push({ name: "private", value: null, explanation: "Only the user's browser may cache this response; shared caches and CDNs must not." });
+  }
+  if (options.noCache) {
+    directives.push({ name: "no-cache", value: null, explanation: "A cache may store the response but must revalidate it with the origin before every reuse." });
+  }
+  if (options.noStore) {
+    directives.push({ name: "no-store", value: null, explanation: "No cache may store any part of this request or response." });
+  }
+  if (nums.maxAge !== null) {
+    directives.push({ name: "max-age", value: String(nums.maxAge), explanation: `Considered fresh for ${_humanizeSeconds(nums.maxAge)} (${nums.maxAge}s), after which it becomes stale.` });
+  }
+  if (nums.sMaxAge !== null) {
+    directives.push({ name: "s-maxage", value: String(nums.sMaxAge), explanation: `For shared caches (CDNs, proxies) it is fresh for ${_humanizeSeconds(nums.sMaxAge)} (${nums.sMaxAge}s), overriding max-age there.` });
+  }
+  if (options.mustRevalidate) {
+    directives.push({ name: "must-revalidate", value: null, explanation: "Once stale, a cache must revalidate with the origin and never serve the stale copy." });
+  }
+  if (options.proxyRevalidate) {
+    directives.push({ name: "proxy-revalidate", value: null, explanation: "Like must-revalidate, but the requirement applies only to shared caches." });
+  }
+  if (options.immutable) {
+    directives.push({ name: "immutable", value: null, explanation: "The body will not change while fresh, so browsers should not revalidate it on reload." });
+  }
+  if (options.noTransform) {
+    directives.push({ name: "no-transform", value: null, explanation: "Intermediaries must not modify the response body (for example, recompressing images)." });
+  }
+  if (nums.staleWhileRevalidate !== null) {
+    directives.push({ name: "stale-while-revalidate", value: String(nums.staleWhileRevalidate), explanation: `A cache may serve the stale response for up to ${_humanizeSeconds(nums.staleWhileRevalidate)} (${nums.staleWhileRevalidate}s) while it revalidates in the background.` });
+  }
+  if (nums.staleIfError !== null) {
+    directives.push({ name: "stale-if-error", value: String(nums.staleIfError), explanation: `A cache may serve the stale response for up to ${_humanizeSeconds(nums.staleIfError)} (${nums.staleIfError}s) if the origin returns an error.` });
+  }
+  if (options.mustUnderstand) {
+    directives.push({ name: "must-understand", value: null, explanation: "A cache should store the response only if it understands the caching requirements of the response's status code." });
+  }
+  if (options.noStore && directives.length > 1) {
+    warnings.push("no-store means nothing is cached, so the other directives have no effect.");
+  }
+  if (options.noCache && nums.maxAge !== null) {
+    warnings.push("no-cache forces revalidation on every use, so max-age has little practical effect alongside it.");
+  }
+  if (options.immutable && nums.maxAge === null) {
+    warnings.push("immutable only applies while the response is fresh \u2014 add a max-age so it has a freshness lifetime.");
+  }
+  if (directives.length === 0) {
+    warnings.push("No directives set \u2014 an empty Cache-Control header has no effect.");
+  }
+  const header = directives.map((d) => d.value === null ? d.name : `${d.name}=${d.value}`).join(", ");
+  const snippet = `Cache-Control: ${header}`;
+  return { header, headerName: "Cache-Control", snippet, directives, warnings };
+}
 
 // src/tools/api.ts
 var api_exports = {};

package/dist/index.d.cts

@@ -1,12 +1,12 @@
 export { j as json } from './json-BjSoIS1h.cjs';
 export { e as encoding } from './encoding-Dk3wpmb3.cjs';
 export { h as hashing } from './hashing-CnetQFD_.cjs';
-export { t as text } from './text-Bbx-tZ43.cjs';
+export { t as text } from './text-DS70aMY5.cjs';
 export { d as data } from './data-D8XTI7Du.cjs';
 export { g as generators } from './generators-BGtRGpJZ.cjs';
 export { t as time } from './time-DbT8fjaF.cjs';
 export { u as units } from './units-BFTQwpBu.cjs';
-export { n as network } from './network-DZugNyAQ.cjs';
+export { n as network } from './network-BJOjJnmY.cjs';
 export { a as api } from './api-Xl7OzIgq.cjs';
 export { c as code } from './code-DaRvff2v.cjs';
 export { c as color } from './color-tPwZCr9H.cjs';

package/dist/index.d.ts

@@ -1,12 +1,12 @@
 export { j as json } from './json-BjSoIS1h.js';
 export { e as encoding } from './encoding-Dk3wpmb3.js';
 export { h as hashing } from './hashing-CnetQFD_.js';
-export { t as text } from './text-Bbx-tZ43.js';
+export { t as text } from './text-DS70aMY5.js';
 export { d as data } from './data-D8XTI7Du.js';
 export { g as generators } from './generators-BGtRGpJZ.js';
 export { t as time } from './time-DbT8fjaF.js';
 export { u as units } from './units-BFTQwpBu.js';
-export { n as network } from './network-DZugNyAQ.js';
+export { n as network } from './network-BJOjJnmY.js';
 export { a as api } from './api-Xl7OzIgq.js';
 export { c as code } from './code-DaRvff2v.js';
 export { c as color } from './color-tPwZCr9H.js';

package/dist/index.js

@@ -1,6 +1,6 @@
 export { media_exports as media } from './chunk-XMKJYVKB.js';
 export { units_exports as units } from './chunk-U34B5XPK.js';
-export { network_exports as network } from './chunk-3QMUUTBH.js';
+export { network_exports as network } from './chunk-Y5OOP6WN.js';
 export { api_exports as api } from './chunk-Q3B3YWOA.js';
 export { code_exports as code } from './chunk-LXKIPPDG.js';
 export { color_exports as color } from './chunk-BPVAB4P2.js';
@@ -10,7 +10,7 @@ export { ai_agent_exports as ai_agent } from './chunk-265NPGKH.js';
 export { json_exports as json } from './chunk-TSAGO3XP.js';
 export { encoding_exports as encoding } from './chunk-DOWQZUTP.js';
 export { hashing_exports as hashing } from './chunk-GEFVMGZR.js';
-export { text_exports as text } from './chunk-F57WMKZO.js';
+export { text_exports as text } from './chunk-2I4O5YCT.js';
 export { data_exports as data } from './chunk-TINQFTLO.js';
 export { generators_exports as generators } from './chunk-2CJSLYWI.js';
 export { time_exports as time } from './chunk-ZPQZEIXP.js';

package/dist/{network-DZugNyAQ.d.cts → network-BJOjJnmY.d.cts}

@@ -11,6 +11,7 @@
  *   - sitemap-validator: validateSitemap
  *   - robots-txt-validator: validateRobotsTxt
  *   - user-agent-parser: parseUserAgent
+ *   - cache-control-builder: buildCacheControl
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -252,7 +253,48 @@ interface UserAgentInfo {
 declare function parseUserAgent(ua: string): UserAgentInfo | {
     error: string;
 };
+interface CacheControlOptions {
+    /** `public` (any cache) or `private` (browser only). */
+    visibility?: 'public' | 'private' | null;
+    noCache?: boolean;
+    noStore?: boolean;
+    noTransform?: boolean;
+    mustRevalidate?: boolean;
+    proxyRevalidate?: boolean;
+    immutable?: boolean;
+    mustUnderstand?: boolean;
+    /** Freshness lifetime in seconds. */
+    maxAge?: number | null;
+    /** Freshness lifetime for shared caches, in seconds. */
+    sMaxAge?: number | null;
+    staleWhileRevalidate?: number | null;
+    staleIfError?: number | null;
+}
+interface CacheControlDirective {
+    name: string;
+    value: string | null;
+    explanation: string;
+}
+interface CacheControlResult {
+    header: string;
+    headerName: 'Cache-Control';
+    snippet: string;
+    directives: CacheControlDirective[];
+    warnings: string[];
+}
+/**
+ * Build a `Cache-Control` response-header value from a set of directives,
+ * with a plain-English explanation of each and warnings for combinations
+ * that cancel each other out. Pure string assembly: it never fetches or
+ * validates against a live origin.
+ */
+declare function buildCacheControl(options?: CacheControlOptions): CacheControlResult | {
+    error: string;
+};
 
+type network_CacheControlDirective = CacheControlDirective;
+type network_CacheControlOptions = CacheControlOptions;
+type network_CacheControlResult = CacheControlResult;
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
 type network_DnsRecordType = DnsRecordType;
@@ -278,6 +320,7 @@ type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
 type network_UaDeviceType = UaDeviceType;
 type network_UserAgentInfo = UserAgentInfo;
+declare const network_buildCacheControl: typeof buildCacheControl;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
 declare const network_buildGeoUrl: typeof buildGeoUrl;
 declare const network_buildMapUrl: typeof buildMapUrl;
@@ -309,7 +352,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { validateHeaderValue as $, getHeader as A, getHeadersByCategory as B, getStatusByCategory as C, DNS_RECORD_TYPES as D, getStatusCode as E, isClientError as F, type GeoResult as G, HTTP_HEADERS as H, isServerError as I, isSuccess as J, isValidIp as K, isValidIpv4 as L, isValidIpv6 as M, parseDnsResponse as N, parseGeoResponse as O, type ParsedDnsResult as P, parseHar as Q, type RobotsGroup as R, STATUS_CODES as S, parseUserAgent as T, type UaDeviceType as U, searchHeaders as V, searchStatusCodes as W, statusCodeToText as X, typeNumberToLabel as Y, validateDomain as Z, validateHeaderName as _, type DnsRecord as a, validateRobotsTxt as a0, validateSitemap as a1, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, type UserAgentInfo as s, buildDnsQueryUrl as t, buildGeoUrl as u, buildMapUrl as v, countryCodeToFlag as w, formatCoordinates as x, formatTtl as y, getByCategory as z };
+export { statusCodeToText as $, formatCoordinates as A, formatTtl as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, getByCategory as E, getHeader as F, type GeoResult as G, HTTP_HEADERS as H, getHeadersByCategory as I, getStatusByCategory as J, getStatusCode as K, isClientError as L, isServerError as M, isSuccess as N, isValidIp as O, type ParsedDnsResult as P, isValidIpv4 as Q, type RobotsGroup as R, STATUS_CODES as S, isValidIpv6 as T, type UaDeviceType as U, parseDnsResponse as V, parseGeoResponse as W, parseHar as X, parseUserAgent as Y, searchHeaders as Z, searchStatusCodes as _, type CacheControlOptions as a, typeNumberToLabel as a0, validateDomain as a1, validateHeaderName as a2, validateHeaderValue as a3, validateRobotsTxt as a4, validateSitemap as a5, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type ParsedGeoResult as k, type RobotsIssue as l, type RobotsRule as m, network as n, type RobotsValidationResult as o, type SitemapIndexEntry as p, type SitemapIssue as q, type SitemapUrlEntry as r, type SitemapValidationResult as s, type StatusCode as t, type UserAgentInfo as u, buildCacheControl as v, buildDnsQueryUrl as w, buildGeoUrl as x, buildMapUrl as y, countryCodeToFlag as z };

package/dist/{network-DZugNyAQ.d.ts → network-BJOjJnmY.d.ts}

@@ -11,6 +11,7 @@
  *   - sitemap-validator: validateSitemap
  *   - robots-txt-validator: validateRobotsTxt
  *   - user-agent-parser: parseUserAgent
+ *   - cache-control-builder: buildCacheControl
  */
 declare const DNS_RECORD_TYPES: readonly ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SOA", "PTR", "SRV", "CAA"];
 type DnsRecordType = typeof DNS_RECORD_TYPES[number];
@@ -252,7 +253,48 @@ interface UserAgentInfo {
 declare function parseUserAgent(ua: string): UserAgentInfo | {
     error: string;
 };
+interface CacheControlOptions {
+    /** `public` (any cache) or `private` (browser only). */
+    visibility?: 'public' | 'private' | null;
+    noCache?: boolean;
+    noStore?: boolean;
+    noTransform?: boolean;
+    mustRevalidate?: boolean;
+    proxyRevalidate?: boolean;
+    immutable?: boolean;
+    mustUnderstand?: boolean;
+    /** Freshness lifetime in seconds. */
+    maxAge?: number | null;
+    /** Freshness lifetime for shared caches, in seconds. */
+    sMaxAge?: number | null;
+    staleWhileRevalidate?: number | null;
+    staleIfError?: number | null;
+}
+interface CacheControlDirective {
+    name: string;
+    value: string | null;
+    explanation: string;
+}
+interface CacheControlResult {
+    header: string;
+    headerName: 'Cache-Control';
+    snippet: string;
+    directives: CacheControlDirective[];
+    warnings: string[];
+}
+/**
+ * Build a `Cache-Control` response-header value from a set of directives,
+ * with a plain-English explanation of each and warnings for combinations
+ * that cancel each other out. Pure string assembly: it never fetches or
+ * validates against a live origin.
+ */
+declare function buildCacheControl(options?: CacheControlOptions): CacheControlResult | {
+    error: string;
+};
 
+type network_CacheControlDirective = CacheControlDirective;
+type network_CacheControlOptions = CacheControlOptions;
+type network_CacheControlResult = CacheControlResult;
 declare const network_DNS_RECORD_TYPES: typeof DNS_RECORD_TYPES;
 type network_DnsRecord = DnsRecord;
 type network_DnsRecordType = DnsRecordType;
@@ -278,6 +320,7 @@ type network_SitemapValidationResult = SitemapValidationResult;
 type network_StatusCode = StatusCode;
 type network_UaDeviceType = UaDeviceType;
 type network_UserAgentInfo = UserAgentInfo;
+declare const network_buildCacheControl: typeof buildCacheControl;
 declare const network_buildDnsQueryUrl: typeof buildDnsQueryUrl;
 declare const network_buildGeoUrl: typeof buildGeoUrl;
 declare const network_buildMapUrl: typeof buildMapUrl;
@@ -309,7 +352,7 @@ declare const network_validateHeaderValue: typeof validateHeaderValue;
 declare const network_validateRobotsTxt: typeof validateRobotsTxt;
 declare const network_validateSitemap: typeof validateSitemap;
 declare namespace network {
-  export { network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
+  export { type network_CacheControlDirective as CacheControlDirective, type network_CacheControlOptions as CacheControlOptions, type network_CacheControlResult as CacheControlResult, network_DNS_RECORD_TYPES as DNS_RECORD_TYPES, type network_DnsRecord as DnsRecord, type network_DnsRecordType as DnsRecordType, type network_DnsResponse as DnsResponse, type network_GeoResult as GeoResult, network_HTTP_HEADERS as HTTP_HEADERS, type network_HarEntry as HarEntry, type network_HarParseResult as HarParseResult, type network_HarSummary as HarSummary, type network_HeaderCategory as HeaderCategory, type network_HttpHeader as HttpHeader, type network_ParsedDnsResult as ParsedDnsResult, type network_ParsedGeoResult as ParsedGeoResult, type network_RobotsGroup as RobotsGroup, type network_RobotsIssue as RobotsIssue, type network_RobotsRule as RobotsRule, type network_RobotsValidationResult as RobotsValidationResult, network_STATUS_CODES as STATUS_CODES, type network_SitemapIndexEntry as SitemapIndexEntry, type network_SitemapIssue as SitemapIssue, type network_SitemapUrlEntry as SitemapUrlEntry, type network_SitemapValidationResult as SitemapValidationResult, type network_StatusCode as StatusCode, type network_UaDeviceType as UaDeviceType, type network_UserAgentInfo as UserAgentInfo, network_buildCacheControl as buildCacheControl, network_buildDnsQueryUrl as buildDnsQueryUrl, network_buildGeoUrl as buildGeoUrl, network_buildMapUrl as buildMapUrl, network_countryCodeToFlag as countryCodeToFlag, network_formatCoordinates as formatCoordinates, network_formatTtl as formatTtl, network_getByCategory as getByCategory, network_getHeader as getHeader, network_getHeadersByCategory as getHeadersByCategory, network_getStatusByCategory as getStatusByCategory, network_getStatusCode as getStatusCode, network_isClientError as isClientError, network_isServerError as isServerError, network_isSuccess as isSuccess, network_isValidIp as isValidIp, network_isValidIpv4 as isValidIpv4, network_isValidIpv6 as isValidIpv6, network_parseDnsResponse as parseDnsResponse, network_parseGeoResponse as parseGeoResponse, network_parseHar as parseHar, network_parseUserAgent as parseUserAgent, network_searchHeaders as searchHeaders, network_searchStatusCodes as searchStatusCodes, network_statusCodeToText as statusCodeToText, network_typeNumberToLabel as typeNumberToLabel, network_validateDomain as validateDomain, network_validateHeaderName as validateHeaderName, network_validateHeaderValue as validateHeaderValue, network_validateRobotsTxt as validateRobotsTxt, network_validateSitemap as validateSitemap };
 }
 
-export { validateHeaderValue as $, getHeader as A, getHeadersByCategory as B, getStatusByCategory as C, DNS_RECORD_TYPES as D, getStatusCode as E, isClientError as F, type GeoResult as G, HTTP_HEADERS as H, isServerError as I, isSuccess as J, isValidIp as K, isValidIpv4 as L, isValidIpv6 as M, parseDnsResponse as N, parseGeoResponse as O, type ParsedDnsResult as P, parseHar as Q, type RobotsGroup as R, STATUS_CODES as S, parseUserAgent as T, type UaDeviceType as U, searchHeaders as V, searchStatusCodes as W, statusCodeToText as X, typeNumberToLabel as Y, validateDomain as Z, validateHeaderName as _, type DnsRecord as a, validateRobotsTxt as a0, validateSitemap as a1, type DnsRecordType as b, type DnsResponse as c, type HarEntry as d, type HarParseResult as e, type HarSummary as f, type HeaderCategory as g, type HttpHeader as h, type ParsedGeoResult as i, type RobotsIssue as j, type RobotsRule as k, type RobotsValidationResult as l, type SitemapIndexEntry as m, network as n, type SitemapIssue as o, type SitemapUrlEntry as p, type SitemapValidationResult as q, type StatusCode as r, type UserAgentInfo as s, buildDnsQueryUrl as t, buildGeoUrl as u, buildMapUrl as v, countryCodeToFlag as w, formatCoordinates as x, formatTtl as y, getByCategory as z };
+export { statusCodeToText as $, formatCoordinates as A, formatTtl as B, type CacheControlDirective as C, DNS_RECORD_TYPES as D, getByCategory as E, getHeader as F, type GeoResult as G, HTTP_HEADERS as H, getHeadersByCategory as I, getStatusByCategory as J, getStatusCode as K, isClientError as L, isServerError as M, isSuccess as N, isValidIp as O, type ParsedDnsResult as P, isValidIpv4 as Q, type RobotsGroup as R, STATUS_CODES as S, isValidIpv6 as T, type UaDeviceType as U, parseDnsResponse as V, parseGeoResponse as W, parseHar as X, parseUserAgent as Y, searchHeaders as Z, searchStatusCodes as _, type CacheControlOptions as a, typeNumberToLabel as a0, validateDomain as a1, validateHeaderName as a2, validateHeaderValue as a3, validateRobotsTxt as a4, validateSitemap as a5, type CacheControlResult as b, type DnsRecord as c, type DnsRecordType as d, type DnsResponse as e, type HarEntry as f, type HarParseResult as g, type HarSummary as h, type HeaderCategory as i, type HttpHeader as j, type ParsedGeoResult as k, type RobotsIssue as l, type RobotsRule as m, network as n, type RobotsValidationResult as o, type SitemapIndexEntry as p, type SitemapIssue as q, type SitemapUrlEntry as r, type SitemapValidationResult as s, type StatusCode as t, type UserAgentInfo as u, buildCacheControl as v, buildDnsQueryUrl as w, buildGeoUrl as x, buildMapUrl as y, countryCodeToFlag as z };

package/dist/{text-Bbx-tZ43.d.cts → text-DS70aMY5.d.cts}

@@ -18,6 +18,9 @@
  *   - html-table      : detectDelimiter, parseTableData, generateHtmlTable, generateMarkdownTable, csvToHtml, csvToMarkdown
  *   - ascii-art       : textToAscii, getAvailableFonts, addBorder, centerText
  *   - morse-code      : textToMorse, morseToText, isValidMorse, getMorseForChar, getMorseTiming
+ *   - passive-voice-detector: detectPassiveVoice
+ *   - readability-score: scoreReadability
+ *   - filler-word-detector: detectFillerWords
  */
 interface WordCountResult {
     words: number;
@@ -275,6 +278,30 @@ interface ReadabilityResult {
  * dictionary lookup, so scores are an estimate rather than exact.
  */
 declare function scoreReadability(text: string): ReadabilityResult;
+type FillerCategory = 'filler' | 'hedge' | 'cliche';
+interface FillerMatch {
+    phrase: string;
+    category: FillerCategory;
+    count: number;
+    indices: number[];
+}
+interface FillerWordResult {
+    totalWords: number;
+    totalMatches: number;
+    fillerCount: number;
+    hedgeCount: number;
+    clicheCount: number;
+    /** Matches per 100 words, to one decimal place. */
+    density: number;
+    matches: FillerMatch[];
+}
+/**
+ * Scan text for filler words, hedge phrases, and clichés, returning each
+ * matched phrase with its category, occurrence count, and character offsets.
+ * This is a dictionary-based heuristic: a flagged word (e.g. "just") is a
+ * candidate to reconsider, not always wrong in context.
+ */
+declare function detectFillerWords(text: string): FillerWordResult;
 
 type text_AsciiFont = AsciiFont;
 type text_AsciiOptions = AsciiOptions;
@@ -290,6 +317,9 @@ type text_DiffType = DiffType;
 type text_DiffViewerLine = DiffViewerLine;
 declare const text_ESCAPE_MODES: typeof ESCAPE_MODES;
 type text_EscapeMode = EscapeMode;
+type text_FillerCategory = FillerCategory;
+type text_FillerMatch = FillerMatch;
+type text_FillerWordResult = FillerWordResult;
 declare const text_LINE_OPS: typeof LINE_OPS;
 type text_LineOp = LineOp;
 type text_LineType = LineType;
@@ -319,6 +349,7 @@ declare const text_countWords: typeof countWords;
 declare const text_csvToHtml: typeof csvToHtml;
 declare const text_csvToMarkdown: typeof csvToMarkdown;
 declare const text_detectDelimiter: typeof detectDelimiter;
+declare const text_detectFillerWords: typeof detectFillerWords;
 declare const text_detectPassiveVoice: typeof detectPassiveVoice;
 declare const text_diffLines: typeof diffLines;
 declare const text_diffLinesSimple: typeof diffLinesSimple;
@@ -360,7 +391,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_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, 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_SlugSeparator as SlugSeparator, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, 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_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_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_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_ESCAPE_MODES as ESCAPE_MODES, 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_SlugSeparator as SlugSeparator, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, 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_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_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 { generateDiff as $, type AsciiFont as A, centerText as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, convertAll as F, convertCase as G, countWords as H, csvToHtml as I, csvToMarkdown as J, detectDelimiter as K, LINE_OPS as L, MORSE_CODE as M, detectPassiveVoice as N, diffLines as O, type ParsedDiff as P, diffLinesSimple as Q, type ReadabilityResult as R, type SlugSeparator as S, type TableOptions as T, diffStats as U, escapeAll as V, type WordCountResult as W, escapeString as X, extractHeadings as Y, formatReadingTime as Z, generate as _, type AsciiOptions as a, generateHtmlTable as a0, generateMarkdownTable as a1, generateParagraphs as a2, generateSentences as a3, generateWords as a4, getAvailableFonts as a5, getMorseForChar as a6, getMorseTiming as a7, htmlToMarkdown as a8, isValidMorse as a9, markdownToHtml as aa, morseToText as ab, numberToOrdinal as ac, numberToRoman as ad, numberToWords as ae, ordinalWords as af, parseDiff as ag, parseTableData as ah, readabilityScore as ai, renderMarkdown as aj, romanToNumber as ak, scoreReadability as al, sentenceCount as am, slugify as an, slugifyAll as ao, syllableCount as ap, textToAscii as aq, textToMorse as ar, unescapeString as as, wordFrequency as at, 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, type EscapeMode as j, type LineOp as k, type LineType as l, type LoremUnit as m, type MarkdownResult as n, type MorseOptions as o, type ParsedTable as p, type PassiveVoiceMatch as q, type PassiveVoiceResult as r, type PassiveVoiceSentence as s, text as t, type ReadabilityScore as u, type TextAnalysis as v, addBorder as w, analyzeText as x, applyOp as y, applyOps as z };
+export { escapeString as $, type AsciiFont as A, applyOp as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, type FillerCategory as F, applyOps as G, centerText as H, convertAll as I, convertCase as J, countWords as K, LINE_OPS as L, MORSE_CODE as M, csvToHtml as N, csvToMarkdown as O, type ParsedDiff as P, detectDelimiter as Q, type ReadabilityResult as R, type SlugSeparator as S, type TableOptions as T, detectFillerWords as U, detectPassiveVoice as V, type WordCountResult as W, diffLines as X, diffLinesSimple as Y, diffStats as Z, escapeAll as _, type AsciiOptions as a, extractHeadings as a0, formatReadingTime as a1, generate as a2, generateDiff as a3, generateHtmlTable as a4, generateMarkdownTable as a5, generateParagraphs as a6, generateSentences as a7, generateWords as a8, getAvailableFonts as a9, getMorseForChar as aa, getMorseTiming as ab, htmlToMarkdown as ac, isValidMorse as ad, markdownToHtml as ae, morseToText as af, numberToOrdinal as ag, numberToRoman as ah, numberToWords as ai, ordinalWords as aj, parseDiff as ak, parseTableData as al, readabilityScore as am, renderMarkdown as an, romanToNumber as ao, scoreReadability as ap, sentenceCount as aq, slugify as ar, slugifyAll as as, syllableCount as at, textToAscii as au, textToMorse as av, unescapeString as aw, wordFrequency as ax, 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, type EscapeMode as j, type FillerMatch as k, type FillerWordResult as l, type LineOp as m, type LineType as n, type LoremUnit as o, type MarkdownResult as p, type MorseOptions as q, type ParsedTable as r, type PassiveVoiceMatch as s, text as t, type PassiveVoiceResult as u, type PassiveVoiceSentence as v, type ReadabilityScore as w, type TextAnalysis as x, addBorder as y, analyzeText as z };

package/dist/{text-Bbx-tZ43.d.ts → text-DS70aMY5.d.ts}

@@ -18,6 +18,9 @@
  *   - html-table      : detectDelimiter, parseTableData, generateHtmlTable, generateMarkdownTable, csvToHtml, csvToMarkdown
  *   - ascii-art       : textToAscii, getAvailableFonts, addBorder, centerText
  *   - morse-code      : textToMorse, morseToText, isValidMorse, getMorseForChar, getMorseTiming
+ *   - passive-voice-detector: detectPassiveVoice
+ *   - readability-score: scoreReadability
+ *   - filler-word-detector: detectFillerWords
  */
 interface WordCountResult {
     words: number;
@@ -275,6 +278,30 @@ interface ReadabilityResult {
  * dictionary lookup, so scores are an estimate rather than exact.
  */
 declare function scoreReadability(text: string): ReadabilityResult;
+type FillerCategory = 'filler' | 'hedge' | 'cliche';
+interface FillerMatch {
+    phrase: string;
+    category: FillerCategory;
+    count: number;
+    indices: number[];
+}
+interface FillerWordResult {
+    totalWords: number;
+    totalMatches: number;
+    fillerCount: number;
+    hedgeCount: number;
+    clicheCount: number;
+    /** Matches per 100 words, to one decimal place. */
+    density: number;
+    matches: FillerMatch[];
+}
+/**
+ * Scan text for filler words, hedge phrases, and clichés, returning each
+ * matched phrase with its category, occurrence count, and character offsets.
+ * This is a dictionary-based heuristic: a flagged word (e.g. "just") is a
+ * candidate to reconsider, not always wrong in context.
+ */
+declare function detectFillerWords(text: string): FillerWordResult;
 
 type text_AsciiFont = AsciiFont;
 type text_AsciiOptions = AsciiOptions;
@@ -290,6 +317,9 @@ type text_DiffType = DiffType;
 type text_DiffViewerLine = DiffViewerLine;
 declare const text_ESCAPE_MODES: typeof ESCAPE_MODES;
 type text_EscapeMode = EscapeMode;
+type text_FillerCategory = FillerCategory;
+type text_FillerMatch = FillerMatch;
+type text_FillerWordResult = FillerWordResult;
 declare const text_LINE_OPS: typeof LINE_OPS;
 type text_LineOp = LineOp;
 type text_LineType = LineType;
@@ -319,6 +349,7 @@ declare const text_countWords: typeof countWords;
 declare const text_csvToHtml: typeof csvToHtml;
 declare const text_csvToMarkdown: typeof csvToMarkdown;
 declare const text_detectDelimiter: typeof detectDelimiter;
+declare const text_detectFillerWords: typeof detectFillerWords;
 declare const text_detectPassiveVoice: typeof detectPassiveVoice;
 declare const text_diffLines: typeof diffLines;
 declare const text_diffLinesSimple: typeof diffLinesSimple;
@@ -360,7 +391,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_ESCAPE_MODES as ESCAPE_MODES, type text_EscapeMode as EscapeMode, 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_SlugSeparator as SlugSeparator, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, 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_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_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_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_ESCAPE_MODES as ESCAPE_MODES, 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_SlugSeparator as SlugSeparator, type text_TableOptions as TableOptions, type text_TextAnalysis as TextAnalysis, type text_WordCountResult as WordCountResult, text_addBorder as addBorder, text_analyzeText as analyzeText, text_applyOp as applyOp, text_applyOps as applyOps, 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_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_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 { generateDiff as $, type AsciiFont as A, centerText as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, convertAll as F, convertCase as G, countWords as H, csvToHtml as I, csvToMarkdown as J, detectDelimiter as K, LINE_OPS as L, MORSE_CODE as M, detectPassiveVoice as N, diffLines as O, type ParsedDiff as P, diffLinesSimple as Q, type ReadabilityResult as R, type SlugSeparator as S, type TableOptions as T, diffStats as U, escapeAll as V, type WordCountResult as W, escapeString as X, extractHeadings as Y, formatReadingTime as Z, generate as _, type AsciiOptions as a, generateHtmlTable as a0, generateMarkdownTable as a1, generateParagraphs as a2, generateSentences as a3, generateWords as a4, getAvailableFonts as a5, getMorseForChar as a6, getMorseTiming as a7, htmlToMarkdown as a8, isValidMorse as a9, markdownToHtml as aa, morseToText as ab, numberToOrdinal as ac, numberToRoman as ad, numberToWords as ae, ordinalWords as af, parseDiff as ag, parseTableData as ah, readabilityScore as ai, renderMarkdown as aj, romanToNumber as ak, scoreReadability as al, sentenceCount as am, slugify as an, slugifyAll as ao, syllableCount as ap, textToAscii as aq, textToMorse as ar, unescapeString as as, wordFrequency as at, 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, type EscapeMode as j, type LineOp as k, type LineType as l, type LoremUnit as m, type MarkdownResult as n, type MorseOptions as o, type ParsedTable as p, type PassiveVoiceMatch as q, type PassiveVoiceResult as r, type PassiveVoiceSentence as s, text as t, type ReadabilityScore as u, type TextAnalysis as v, addBorder as w, analyzeText as x, applyOp as y, applyOps as z };
+export { escapeString as $, type AsciiFont as A, applyOp as B, CASE_FORMATS as C, DEFAULT_CONVERT_OPTIONS as D, ESCAPE_MODES as E, type FillerCategory as F, applyOps as G, centerText as H, convertAll as I, convertCase as J, countWords as K, LINE_OPS as L, MORSE_CODE as M, csvToHtml as N, csvToMarkdown as O, type ParsedDiff as P, detectDelimiter as Q, type ReadabilityResult as R, type SlugSeparator as S, type TableOptions as T, detectFillerWords as U, detectPassiveVoice as V, type WordCountResult as W, diffLines as X, diffLinesSimple as Y, diffStats as Z, escapeAll as _, type AsciiOptions as a, extractHeadings as a0, formatReadingTime as a1, generate as a2, generateDiff as a3, generateHtmlTable as a4, generateMarkdownTable as a5, generateParagraphs as a6, generateSentences as a7, generateWords as a8, getAvailableFonts as a9, getMorseForChar as aa, getMorseTiming as ab, htmlToMarkdown as ac, isValidMorse as ad, markdownToHtml as ae, morseToText as af, numberToOrdinal as ag, numberToRoman as ah, numberToWords as ai, ordinalWords as aj, parseDiff as ak, parseTableData as al, readabilityScore as am, renderMarkdown as an, romanToNumber as ao, scoreReadability as ap, sentenceCount as aq, slugify as ar, slugifyAll as as, syllableCount as at, textToAscii as au, textToMorse as av, unescapeString as aw, wordFrequency as ax, 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, type EscapeMode as j, type FillerMatch as k, type FillerWordResult as l, type LineOp as m, type LineType as n, type LoremUnit as o, type MarkdownResult as p, type MorseOptions as q, type ParsedTable as r, type PassiveVoiceMatch as s, text as t, type PassiveVoiceResult as u, type PassiveVoiceSentence as v, type ReadabilityScore as w, type TextAnalysis as x, addBorder as y, analyzeText as z };

package/dist/tools/network.cjs

@@ -1685,10 +1685,103 @@ function parseUserAgent(ua) {
   const device = { type: _detectUaDeviceType(s) };
   return { browser, engine, os, device, raw: s };
 }
+var _CACHE_NUM_FIELDS = ["maxAge", "sMaxAge", "staleWhileRevalidate", "staleIfError"];
+function _humanizeSeconds(s) {
+  if (s === 0) return "0 seconds";
+  const units = [
+    [86400, "day"],
+    [3600, "hour"],
+    [60, "minute"],
+    [1, "second"]
+  ];
+  const parts = [];
+  let rem = s;
+  for (const [size, label] of units) {
+    if (rem >= size) {
+      const n = Math.floor(rem / size);
+      rem -= n * size;
+      parts.push(`${n} ${label}${n === 1 ? "" : "s"}`);
+    }
+  }
+  return parts.slice(0, 2).join(" ");
+}
+function buildCacheControl(options = {}) {
+  const nums = {
+    maxAge: null,
+    sMaxAge: null,
+    staleWhileRevalidate: null,
+    staleIfError: null
+  };
+  for (const field of _CACHE_NUM_FIELDS) {
+    const v = options[field];
+    if (v === void 0 || v === null) continue;
+    if (typeof v !== "number" || !Number.isFinite(v) || !Number.isInteger(v) || v < 0) {
+      return { error: `${field} must be a non-negative integer number of seconds` };
+    }
+    nums[field] = v;
+  }
+  const directives = [];
+  const warnings = [];
+  if (options.visibility === "public") {
+    directives.push({ name: "public", value: null, explanation: "Any cache, including shared caches and CDNs, may store this response." });
+  }
+  if (options.visibility === "private") {
+    directives.push({ name: "private", value: null, explanation: "Only the user's browser may cache this response; shared caches and CDNs must not." });
+  }
+  if (options.noCache) {
+    directives.push({ name: "no-cache", value: null, explanation: "A cache may store the response but must revalidate it with the origin before every reuse." });
+  }
+  if (options.noStore) {
+    directives.push({ name: "no-store", value: null, explanation: "No cache may store any part of this request or response." });
+  }
+  if (nums.maxAge !== null) {
+    directives.push({ name: "max-age", value: String(nums.maxAge), explanation: `Considered fresh for ${_humanizeSeconds(nums.maxAge)} (${nums.maxAge}s), after which it becomes stale.` });
+  }
+  if (nums.sMaxAge !== null) {
+    directives.push({ name: "s-maxage", value: String(nums.sMaxAge), explanation: `For shared caches (CDNs, proxies) it is fresh for ${_humanizeSeconds(nums.sMaxAge)} (${nums.sMaxAge}s), overriding max-age there.` });
+  }
+  if (options.mustRevalidate) {
+    directives.push({ name: "must-revalidate", value: null, explanation: "Once stale, a cache must revalidate with the origin and never serve the stale copy." });
+  }
+  if (options.proxyRevalidate) {
+    directives.push({ name: "proxy-revalidate", value: null, explanation: "Like must-revalidate, but the requirement applies only to shared caches." });
+  }
+  if (options.immutable) {
+    directives.push({ name: "immutable", value: null, explanation: "The body will not change while fresh, so browsers should not revalidate it on reload." });
+  }
+  if (options.noTransform) {
+    directives.push({ name: "no-transform", value: null, explanation: "Intermediaries must not modify the response body (for example, recompressing images)." });
+  }
+  if (nums.staleWhileRevalidate !== null) {
+    directives.push({ name: "stale-while-revalidate", value: String(nums.staleWhileRevalidate), explanation: `A cache may serve the stale response for up to ${_humanizeSeconds(nums.staleWhileRevalidate)} (${nums.staleWhileRevalidate}s) while it revalidates in the background.` });
+  }
+  if (nums.staleIfError !== null) {
+    directives.push({ name: "stale-if-error", value: String(nums.staleIfError), explanation: `A cache may serve the stale response for up to ${_humanizeSeconds(nums.staleIfError)} (${nums.staleIfError}s) if the origin returns an error.` });
+  }
+  if (options.mustUnderstand) {
+    directives.push({ name: "must-understand", value: null, explanation: "A cache should store the response only if it understands the caching requirements of the response's status code." });
+  }
+  if (options.noStore && directives.length > 1) {
+    warnings.push("no-store means nothing is cached, so the other directives have no effect.");
+  }
+  if (options.noCache && nums.maxAge !== null) {
+    warnings.push("no-cache forces revalidation on every use, so max-age has little practical effect alongside it.");
+  }
+  if (options.immutable && nums.maxAge === null) {
+    warnings.push("immutable only applies while the response is fresh \u2014 add a max-age so it has a freshness lifetime.");
+  }
+  if (directives.length === 0) {
+    warnings.push("No directives set \u2014 an empty Cache-Control header has no effect.");
+  }
+  const header = directives.map((d) => d.value === null ? d.name : `${d.name}=${d.value}`).join(", ");
+  const snippet = `Cache-Control: ${header}`;
+  return { header, headerName: "Cache-Control", snippet, directives, warnings };
+}
 
 exports.DNS_RECORD_TYPES = DNS_RECORD_TYPES;
 exports.HTTP_HEADERS = HTTP_HEADERS;
 exports.STATUS_CODES = STATUS_CODES;
+exports.buildCacheControl = buildCacheControl;
 exports.buildDnsQueryUrl = buildDnsQueryUrl;
 exports.buildGeoUrl = buildGeoUrl;
 exports.buildMapUrl = buildMapUrl;

package/dist/tools/network.d.cts

@@ -1 +1 @@
-export { D as DNS_RECORD_TYPES, a as DnsRecord, b as DnsRecordType, c as DnsResponse, G as GeoResult, H as HTTP_HEADERS, d as HarEntry, e as HarParseResult, f as HarSummary, g as HeaderCategory, h as HttpHeader, P as ParsedDnsResult, i as ParsedGeoResult, R as RobotsGroup, j as RobotsIssue, k as RobotsRule, l as RobotsValidationResult, S as STATUS_CODES, m as SitemapIndexEntry, o as SitemapIssue, p as SitemapUrlEntry, q as SitemapValidationResult, r as StatusCode, U as UaDeviceType, s as UserAgentInfo, t as buildDnsQueryUrl, u as buildGeoUrl, v as buildMapUrl, w as countryCodeToFlag, x as formatCoordinates, y as formatTtl, z as getByCategory, A as getHeader, B as getHeadersByCategory, C as getStatusByCategory, E as getStatusCode, F as isClientError, I as isServerError, J as isSuccess, K as isValidIp, L as isValidIpv4, M as isValidIpv6, N as parseDnsResponse, O as parseGeoResponse, Q as parseHar, T as parseUserAgent, V as searchHeaders, W as searchStatusCodes, X as statusCodeToText, Y as typeNumberToLabel, Z as validateDomain, _ as validateHeaderName, $ as validateHeaderValue, a0 as validateRobotsTxt, a1 as validateSitemap } from '../network-DZugNyAQ.cjs';
+export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, P as ParsedDnsResult, k as ParsedGeoResult, R as RobotsGroup, l as RobotsIssue, m as RobotsRule, o as RobotsValidationResult, S as STATUS_CODES, p as SitemapIndexEntry, q as SitemapIssue, r as SitemapUrlEntry, s as SitemapValidationResult, t as StatusCode, U as UaDeviceType, u as UserAgentInfo, v as buildCacheControl, w as buildDnsQueryUrl, x as buildGeoUrl, y as buildMapUrl, z as countryCodeToFlag, A as formatCoordinates, B as formatTtl, E as getByCategory, F as getHeader, I as getHeadersByCategory, J as getStatusByCategory, K as getStatusCode, L as isClientError, M as isServerError, N as isSuccess, O as isValidIp, Q as isValidIpv4, T as isValidIpv6, V as parseDnsResponse, W as parseGeoResponse, X as parseHar, Y as parseUserAgent, Z as searchHeaders, _ as searchStatusCodes, $ as statusCodeToText, a0 as typeNumberToLabel, a1 as validateDomain, a2 as validateHeaderName, a3 as validateHeaderValue, a4 as validateRobotsTxt, a5 as validateSitemap } from '../network-BJOjJnmY.cjs';

package/dist/tools/network.d.ts

@@ -1 +1 @@
-export { D as DNS_RECORD_TYPES, a as DnsRecord, b as DnsRecordType, c as DnsResponse, G as GeoResult, H as HTTP_HEADERS, d as HarEntry, e as HarParseResult, f as HarSummary, g as HeaderCategory, h as HttpHeader, P as ParsedDnsResult, i as ParsedGeoResult, R as RobotsGroup, j as RobotsIssue, k as RobotsRule, l as RobotsValidationResult, S as STATUS_CODES, m as SitemapIndexEntry, o as SitemapIssue, p as SitemapUrlEntry, q as SitemapValidationResult, r as StatusCode, U as UaDeviceType, s as UserAgentInfo, t as buildDnsQueryUrl, u as buildGeoUrl, v as buildMapUrl, w as countryCodeToFlag, x as formatCoordinates, y as formatTtl, z as getByCategory, A as getHeader, B as getHeadersByCategory, C as getStatusByCategory, E as getStatusCode, F as isClientError, I as isServerError, J as isSuccess, K as isValidIp, L as isValidIpv4, M as isValidIpv6, N as parseDnsResponse, O as parseGeoResponse, Q as parseHar, T as parseUserAgent, V as searchHeaders, W as searchStatusCodes, X as statusCodeToText, Y as typeNumberToLabel, Z as validateDomain, _ as validateHeaderName, $ as validateHeaderValue, a0 as validateRobotsTxt, a1 as validateSitemap } from '../network-DZugNyAQ.js';
+export { C as CacheControlDirective, a as CacheControlOptions, b as CacheControlResult, D as DNS_RECORD_TYPES, c as DnsRecord, d as DnsRecordType, e as DnsResponse, G as GeoResult, H as HTTP_HEADERS, f as HarEntry, g as HarParseResult, h as HarSummary, i as HeaderCategory, j as HttpHeader, P as ParsedDnsResult, k as ParsedGeoResult, R as RobotsGroup, l as RobotsIssue, m as RobotsRule, o as RobotsValidationResult, S as STATUS_CODES, p as SitemapIndexEntry, q as SitemapIssue, r as SitemapUrlEntry, s as SitemapValidationResult, t as StatusCode, U as UaDeviceType, u as UserAgentInfo, v as buildCacheControl, w as buildDnsQueryUrl, x as buildGeoUrl, y as buildMapUrl, z as countryCodeToFlag, A as formatCoordinates, B as formatTtl, E as getByCategory, F as getHeader, I as getHeadersByCategory, J as getStatusByCategory, K as getStatusCode, L as isClientError, M as isServerError, N as isSuccess, O as isValidIp, Q as isValidIpv4, T as isValidIpv6, V as parseDnsResponse, W as parseGeoResponse, X as parseHar, Y as parseUserAgent, Z as searchHeaders, _ as searchStatusCodes, $ as statusCodeToText, a0 as typeNumberToLabel, a1 as validateDomain, a2 as validateHeaderName, a3 as validateHeaderValue, a4 as validateRobotsTxt, a5 as validateSitemap } from '../network-BJOjJnmY.js';

package/dist/tools/network.js

@@ -1,2 +1,2 @@
-export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseDnsResponse, parseGeoResponse, parseHar, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap } from '../chunk-3QMUUTBH.js';
+export { DNS_RECORD_TYPES, HTTP_HEADERS, STATUS_CODES, buildCacheControl, buildDnsQueryUrl, buildGeoUrl, buildMapUrl, countryCodeToFlag, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, parseDnsResponse, parseGeoResponse, parseHar, parseUserAgent, searchHeaders, searchStatusCodes, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateRobotsTxt, validateSitemap } from '../chunk-Y5OOP6WN.js';
 import '../chunk-MLKGABMK.js';

package/dist/tools/text.cjs

@@ -2399,6 +2399,104 @@ function scoreReadability(text) {
     readingLevel: readabilityGradeLabel(fleschReadingEase)
   };
 }
+var FILLER_WORDS = [
+  "very",
+  "really",
+  "just",
+  "actually",
+  "basically",
+  "literally",
+  "simply",
+  "totally",
+  "definitely",
+  "certainly",
+  "essentially",
+  "absolutely",
+  "completely",
+  "extremely",
+  "truly",
+  "honestly",
+  "seriously",
+  "obviously",
+  "clearly",
+  "quite",
+  "rather",
+  "somewhat",
+  "fairly",
+  "virtually"
+];
+var HEDGE_PHRASES = [
+  "maybe",
+  "perhaps",
+  "probably",
+  "possibly",
+  "arguably",
+  "kind of",
+  "sort of",
+  "a bit",
+  "a little",
+  "more or less",
+  "in my opinion",
+  "i think",
+  "i believe",
+  "to some extent"
+];
+var CLICHE_PHRASES = [
+  "at the end of the day",
+  "think outside the box",
+  "low-hanging fruit",
+  "move the needle",
+  "circle back",
+  "touch base",
+  "on the same page",
+  "hit the ground running",
+  "paradigm shift",
+  "win-win",
+  "game changer",
+  "best of both worlds",
+  "only time will tell",
+  "back to the drawing board",
+  "the tip of the iceberg",
+  "a perfect storm",
+  "needle in a haystack",
+  "raise the bar",
+  "push the envelope",
+  "the elephant in the room",
+  "boil the ocean",
+  "when it rains it pours"
+];
+var FILLER_DICTIONARY = [
+  ...FILLER_WORDS.map((phrase) => ({ phrase, category: "filler" })),
+  ...HEDGE_PHRASES.map((phrase) => ({ phrase, category: "hedge" })),
+  ...CLICHE_PHRASES.map((phrase) => ({ phrase, category: "cliche" }))
+];
+function _fillerRegex(phrase) {
+  const tokens = phrase.split(/\s+/).map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"));
+  return new RegExp("\\b" + tokens.join("\\s+") + "\\b", "gi");
+}
+function detectFillerWords(text) {
+  const totalWords = (text.match(/[A-Za-z0-9']+/g) ?? []).length;
+  const matches = [];
+  for (const entry of FILLER_DICTIONARY) {
+    const re = _fillerRegex(entry.phrase);
+    const indices = [];
+    let m;
+    while ((m = re.exec(text)) !== null) {
+      indices.push(m.index);
+      if (m.index === re.lastIndex) re.lastIndex++;
+    }
+    if (indices.length > 0) {
+      matches.push({ phrase: entry.phrase, category: entry.category, count: indices.length, indices });
+    }
+  }
+  matches.sort((a, b) => b.count - a.count || a.category.localeCompare(b.category) || a.phrase.localeCompare(b.phrase));
+  const fillerCount = matches.filter((x) => x.category === "filler").reduce((s, x) => s + x.count, 0);
+  const hedgeCount = matches.filter((x) => x.category === "hedge").reduce((s, x) => s + x.count, 0);
+  const clicheCount = matches.filter((x) => x.category === "cliche").reduce((s, x) => s + x.count, 0);
+  const totalMatches = fillerCount + hedgeCount + clicheCount;
+  const density = totalWords > 0 ? Math.round(totalMatches / totalWords * 1e3) / 10 : 0;
+  return { totalWords, totalMatches, fillerCount, hedgeCount, clicheCount, density, matches };
+}
 
 exports.CASE_FORMATS = CASE_FORMATS;
 exports.DEFAULT_CONVERT_OPTIONS = DEFAULT_CONVERT_OPTIONS;
@@ -2416,6 +2514,7 @@ exports.countWords = countWords;
 exports.csvToHtml = csvToHtml;
 exports.csvToMarkdown = csvToMarkdown;
 exports.detectDelimiter = detectDelimiter;
+exports.detectFillerWords = detectFillerWords;
 exports.detectPassiveVoice = detectPassiveVoice;
 exports.diffLines = diffLines;
 exports.diffLinesSimple = diffLinesSimple;

package/dist/tools/text.d.cts

@@ -1 +1 @@
-export { A as AsciiFont, a as AsciiOptions, C as CASE_FORMATS, b as CaseFormat, c as ConvertOptions, D as DEFAULT_CONVERT_OPTIONS, d as DiffFile, e as DiffHunk, f as DiffLine, g as DiffResult, h as DiffType, i as DiffViewerLine, E as ESCAPE_MODES, j as EscapeMode, L as LINE_OPS, k as LineOp, l as LineType, m as LoremUnit, M as MORSE_CODE, n as MarkdownResult, o as MorseOptions, P as ParsedDiff, p as ParsedTable, q as PassiveVoiceMatch, r as PassiveVoiceResult, s as PassiveVoiceSentence, R as ReadabilityResult, u as ReadabilityScore, S as SlugSeparator, T as TableOptions, v as TextAnalysis, W as WordCountResult, w as addBorder, x as analyzeText, y as applyOp, z as applyOps, B as centerText, F as convertAll, G as convertCase, H as countWords, I as csvToHtml, J as csvToMarkdown, K as detectDelimiter, N as detectPassiveVoice, O as diffLines, Q as diffLinesSimple, U as diffStats, V as escapeAll, X as escapeString, Y as extractHeadings, Z as formatReadingTime, _ as generate, $ as generateDiff, a0 as generateHtmlTable, a1 as generateMarkdownTable, a2 as generateParagraphs, a3 as generateSentences, a4 as generateWords, a5 as getAvailableFonts, a6 as getMorseForChar, a7 as getMorseTiming, a8 as htmlToMarkdown, a9 as isValidMorse, aa as markdownToHtml, ab as morseToText, ac as numberToOrdinal, ad as numberToRoman, ae as numberToWords, af as ordinalWords, ag as parseDiff, ah as parseTableData, ai as readabilityScore, aj as renderMarkdown, ak as romanToNumber, al as scoreReadability, am as sentenceCount, an as slugify, ao as slugifyAll, ap as syllableCount, aq as textToAscii, ar as textToMorse, as as unescapeString, at as wordFrequency } from '../text-Bbx-tZ43.cjs';
+export { A as AsciiFont, a as AsciiOptions, C as CASE_FORMATS, b as CaseFormat, c as ConvertOptions, D as DEFAULT_CONVERT_OPTIONS, d as DiffFile, e as DiffHunk, f as DiffLine, g as DiffResult, h as DiffType, i as DiffViewerLine, E as ESCAPE_MODES, j as EscapeMode, F as FillerCategory, k as FillerMatch, l as FillerWordResult, L as LINE_OPS, m as LineOp, n as LineType, o as LoremUnit, M as MORSE_CODE, p as MarkdownResult, q as MorseOptions, P as ParsedDiff, r as ParsedTable, s as PassiveVoiceMatch, u as PassiveVoiceResult, v as PassiveVoiceSentence, R as ReadabilityResult, w as ReadabilityScore, S as SlugSeparator, T as TableOptions, x as TextAnalysis, W as WordCountResult, y as addBorder, z as analyzeText, B as applyOp, G as applyOps, H as centerText, I as convertAll, J as convertCase, K as countWords, N as csvToHtml, O as csvToMarkdown, Q as detectDelimiter, U as detectFillerWords, V as detectPassiveVoice, X as diffLines, Y as diffLinesSimple, Z as diffStats, _ as escapeAll, $ as escapeString, a0 as extractHeadings, a1 as formatReadingTime, a2 as generate, a3 as generateDiff, a4 as generateHtmlTable, a5 as generateMarkdownTable, a6 as generateParagraphs, a7 as generateSentences, a8 as generateWords, a9 as getAvailableFonts, aa as getMorseForChar, ab as getMorseTiming, ac as htmlToMarkdown, ad as isValidMorse, ae as markdownToHtml, af as morseToText, ag as numberToOrdinal, ah as numberToRoman, ai as numberToWords, aj as ordinalWords, ak as parseDiff, al as parseTableData, am as readabilityScore, an as renderMarkdown, ao as romanToNumber, ap as scoreReadability, aq as sentenceCount, ar as slugify, as as slugifyAll, at as syllableCount, au as textToAscii, av as textToMorse, aw as unescapeString, ax as wordFrequency } from '../text-DS70aMY5.cjs';

package/dist/tools/text.d.ts

@@ -1 +1 @@
-export { A as AsciiFont, a as AsciiOptions, C as CASE_FORMATS, b as CaseFormat, c as ConvertOptions, D as DEFAULT_CONVERT_OPTIONS, d as DiffFile, e as DiffHunk, f as DiffLine, g as DiffResult, h as DiffType, i as DiffViewerLine, E as ESCAPE_MODES, j as EscapeMode, L as LINE_OPS, k as LineOp, l as LineType, m as LoremUnit, M as MORSE_CODE, n as MarkdownResult, o as MorseOptions, P as ParsedDiff, p as ParsedTable, q as PassiveVoiceMatch, r as PassiveVoiceResult, s as PassiveVoiceSentence, R as ReadabilityResult, u as ReadabilityScore, S as SlugSeparator, T as TableOptions, v as TextAnalysis, W as WordCountResult, w as addBorder, x as analyzeText, y as applyOp, z as applyOps, B as centerText, F as convertAll, G as convertCase, H as countWords, I as csvToHtml, J as csvToMarkdown, K as detectDelimiter, N as detectPassiveVoice, O as diffLines, Q as diffLinesSimple, U as diffStats, V as escapeAll, X as escapeString, Y as extractHeadings, Z as formatReadingTime, _ as generate, $ as generateDiff, a0 as generateHtmlTable, a1 as generateMarkdownTable, a2 as generateParagraphs, a3 as generateSentences, a4 as generateWords, a5 as getAvailableFonts, a6 as getMorseForChar, a7 as getMorseTiming, a8 as htmlToMarkdown, a9 as isValidMorse, aa as markdownToHtml, ab as morseToText, ac as numberToOrdinal, ad as numberToRoman, ae as numberToWords, af as ordinalWords, ag as parseDiff, ah as parseTableData, ai as readabilityScore, aj as renderMarkdown, ak as romanToNumber, al as scoreReadability, am as sentenceCount, an as slugify, ao as slugifyAll, ap as syllableCount, aq as textToAscii, ar as textToMorse, as as unescapeString, at as wordFrequency } from '../text-Bbx-tZ43.js';
+export { A as AsciiFont, a as AsciiOptions, C as CASE_FORMATS, b as CaseFormat, c as ConvertOptions, D as DEFAULT_CONVERT_OPTIONS, d as DiffFile, e as DiffHunk, f as DiffLine, g as DiffResult, h as DiffType, i as DiffViewerLine, E as ESCAPE_MODES, j as EscapeMode, F as FillerCategory, k as FillerMatch, l as FillerWordResult, L as LINE_OPS, m as LineOp, n as LineType, o as LoremUnit, M as MORSE_CODE, p as MarkdownResult, q as MorseOptions, P as ParsedDiff, r as ParsedTable, s as PassiveVoiceMatch, u as PassiveVoiceResult, v as PassiveVoiceSentence, R as ReadabilityResult, w as ReadabilityScore, S as SlugSeparator, T as TableOptions, x as TextAnalysis, W as WordCountResult, y as addBorder, z as analyzeText, B as applyOp, G as applyOps, H as centerText, I as convertAll, J as convertCase, K as countWords, N as csvToHtml, O as csvToMarkdown, Q as detectDelimiter, U as detectFillerWords, V as detectPassiveVoice, X as diffLines, Y as diffLinesSimple, Z as diffStats, _ as escapeAll, $ as escapeString, a0 as extractHeadings, a1 as formatReadingTime, a2 as generate, a3 as generateDiff, a4 as generateHtmlTable, a5 as generateMarkdownTable, a6 as generateParagraphs, a7 as generateSentences, a8 as generateWords, a9 as getAvailableFonts, aa as getMorseForChar, ab as getMorseTiming, ac as htmlToMarkdown, ad as isValidMorse, ae as markdownToHtml, af as morseToText, ag as numberToOrdinal, ah as numberToRoman, ai as numberToWords, aj as ordinalWords, ak as parseDiff, al as parseTableData, am as readabilityScore, an as renderMarkdown, ao as romanToNumber, ap as scoreReadability, aq as sentenceCount, ar as slugify, as as slugifyAll, at as syllableCount, au as textToAscii, av as textToMorse, aw as unescapeString, ax as wordFrequency } from '../text-DS70aMY5.js';

package/dist/tools/text.js

@@ -1,2 +1,2 @@
-export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeText, applyOp, applyOps, centerText, convertAll, convertCase, countWords, csvToHtml, csvToMarkdown, detectDelimiter, detectPassiveVoice, diffLines, diffLinesSimple, diffStats, escapeAll, escapeString, extractHeadings, formatReadingTime, generate, generateDiff, generateHtmlTable, generateMarkdownTable, generateParagraphs, generateSentences, generateWords, getAvailableFonts, getMorseForChar, getMorseTiming, htmlToMarkdown, isValidMorse, markdownToHtml, morseToText, numberToOrdinal, numberToRoman, numberToWords, ordinalWords, parseDiff, parseTableData, readabilityScore, renderMarkdown, romanToNumber, scoreReadability, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, unescapeString, wordFrequency } from '../chunk-F57WMKZO.js';
+export { CASE_FORMATS, DEFAULT_CONVERT_OPTIONS, ESCAPE_MODES, LINE_OPS, MORSE_CODE, addBorder, analyzeText, applyOp, applyOps, centerText, convertAll, convertCase, countWords, csvToHtml, csvToMarkdown, detectDelimiter, detectFillerWords, detectPassiveVoice, diffLines, diffLinesSimple, diffStats, escapeAll, escapeString, extractHeadings, formatReadingTime, generate, generateDiff, generateHtmlTable, generateMarkdownTable, generateParagraphs, generateSentences, generateWords, getAvailableFonts, getMorseForChar, getMorseTiming, htmlToMarkdown, isValidMorse, markdownToHtml, morseToText, numberToOrdinal, numberToRoman, numberToWords, ordinalWords, parseDiff, parseTableData, readabilityScore, renderMarkdown, romanToNumber, scoreReadability, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, unescapeString, wordFrequency } from '../chunk-2I4O5YCT.js';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "154+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
   "author": "Utilix <hello@utilix.tech>",
   "license": "MIT",