@utilix-tech/sdk 0.6.0 → 0.8.0

package/dist/tools/text.cjs

@@ -2332,6 +2332,73 @@ function detectPassiveVoice(text) {
   const passivePercent = totalSentences > 0 ? Math.round(passiveSentences / totalSentences * 1e3) / 10 : 0;
   return { sentences: analyzed, totalSentences, passiveSentences, passivePercent };
 }
+function countSyllables(word) {
+  const w = word.toLowerCase().replace(/[^a-z]/g, "");
+  if (w.length === 0) return 0;
+  if (w.length <= 3) return 1;
+  let count = 0;
+  let prevWasVowel = false;
+  for (const ch of w) {
+    const isVowel = "aeiouy".includes(ch);
+    if (isVowel && !prevWasVowel) count++;
+    prevWasVowel = isVowel;
+  }
+  if (w.endsWith("e") && !w.endsWith("le") && count > 1) count--;
+  if (w.endsWith("le") && w.length > 2 && !"aeiouy".includes(w[w.length - 3])) count++;
+  return Math.max(count, 1);
+}
+function readabilityGradeLabel(fleschReadingEase) {
+  if (fleschReadingEase >= 90) return "Very easy (5th grade)";
+  if (fleschReadingEase >= 80) return "Easy (6th grade)";
+  if (fleschReadingEase >= 70) return "Fairly easy (7th grade)";
+  if (fleschReadingEase >= 60) return "Standard (8th-9th grade)";
+  if (fleschReadingEase >= 50) return "Fairly difficult (10th-12th grade)";
+  if (fleschReadingEase >= 30) return "Difficult (college)";
+  return "Very difficult (college graduate)";
+}
+function round1(n) {
+  return Math.round(n * 10) / 10;
+}
+function scoreReadability(text) {
+  const sentences = splitIntoSentences(text);
+  const words = text.match(/[a-zA-Z']+/g) ?? [];
+  const sentenceCount2 = Math.max(sentences.length, 1);
+  const wordCount = words.length;
+  const syllableCounts = words.map(countSyllables);
+  const syllableCount2 = syllableCounts.reduce((a, b) => a + b, 0);
+  const complexWordCount = syllableCounts.filter((c) => c >= 3).length;
+  if (wordCount === 0) {
+    return {
+      wordCount: 0,
+      sentenceCount: 0,
+      syllableCount: 0,
+      complexWordCount: 0,
+      avgWordsPerSentence: 0,
+      avgSyllablesPerWord: 0,
+      fleschReadingEase: 0,
+      fleschKincaidGrade: 0,
+      gunningFog: 0,
+      readingLevel: "No text to score"
+    };
+  }
+  const avgWordsPerSentence = wordCount / sentenceCount2;
+  const avgSyllablesPerWord = syllableCount2 / wordCount;
+  const fleschReadingEase = round1(206.835 - 1.015 * avgWordsPerSentence - 84.6 * avgSyllablesPerWord);
+  const fleschKincaidGrade = round1(0.39 * avgWordsPerSentence + 11.8 * avgSyllablesPerWord - 15.59);
+  const gunningFog = round1(0.4 * (avgWordsPerSentence + 100 * (complexWordCount / wordCount)));
+  return {
+    wordCount,
+    sentenceCount: sentences.length,
+    syllableCount: syllableCount2,
+    complexWordCount,
+    avgWordsPerSentence: round1(avgWordsPerSentence),
+    avgSyllablesPerWord: round1(avgSyllablesPerWord),
+    fleschReadingEase,
+    fleschKincaidGrade,
+    gunningFog,
+    readingLevel: readabilityGradeLabel(fleschReadingEase)
+  };
+}
 
 exports.CASE_FORMATS = CASE_FORMATS;
 exports.DEFAULT_CONVERT_OPTIONS = DEFAULT_CONVERT_OPTIONS;
@@ -2380,6 +2447,7 @@ exports.parseTableData = parseTableData;
 exports.readabilityScore = readabilityScore;
 exports.renderMarkdown = renderMarkdown;
 exports.romanToNumber = romanToNumber;
+exports.scoreReadability = scoreReadability;
 exports.sentenceCount = sentenceCount;
 exports.slugify = slugify;
 exports.slugifyAll = slugifyAll;

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 ReadabilityScore, S as SlugSeparator, T as TableOptions, u as TextAnalysis, W as WordCountResult, v as addBorder, w as analyzeText, x as applyOp, y as applyOps, z as centerText, B as convertAll, F as convertCase, G as countWords, H as csvToHtml, I as csvToMarkdown, J as detectDelimiter, K as detectPassiveVoice, N as diffLines, O as diffLinesSimple, Q as diffStats, U as escapeAll, V as escapeString, X as extractHeadings, Y as formatReadingTime, Z as generate, _ as generateDiff, $ as generateHtmlTable, a0 as generateMarkdownTable, a1 as generateParagraphs, a2 as generateSentences, a3 as generateWords, a4 as getAvailableFonts, a5 as getMorseForChar, a6 as getMorseTiming, a7 as htmlToMarkdown, a8 as isValidMorse, a9 as markdownToHtml, aa as morseToText, ab as numberToOrdinal, ac as numberToRoman, ad as numberToWords, ae as ordinalWords, af as parseDiff, ag as parseTableData, ah as readabilityScore, ai as renderMarkdown, aj as romanToNumber, ak as sentenceCount, al as slugify, am as slugifyAll, an as syllableCount, ao as textToAscii, ap as textToMorse, aq as unescapeString, ar as wordFrequency } from '../text-CI7JAl7F.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, 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';

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 ReadabilityScore, S as SlugSeparator, T as TableOptions, u as TextAnalysis, W as WordCountResult, v as addBorder, w as analyzeText, x as applyOp, y as applyOps, z as centerText, B as convertAll, F as convertCase, G as countWords, H as csvToHtml, I as csvToMarkdown, J as detectDelimiter, K as detectPassiveVoice, N as diffLines, O as diffLinesSimple, Q as diffStats, U as escapeAll, V as escapeString, X as extractHeadings, Y as formatReadingTime, Z as generate, _ as generateDiff, $ as generateHtmlTable, a0 as generateMarkdownTable, a1 as generateParagraphs, a2 as generateSentences, a3 as generateWords, a4 as getAvailableFonts, a5 as getMorseForChar, a6 as getMorseTiming, a7 as htmlToMarkdown, a8 as isValidMorse, a9 as markdownToHtml, aa as morseToText, ab as numberToOrdinal, ac as numberToRoman, ad as numberToWords, ae as ordinalWords, af as parseDiff, ag as parseTableData, ah as readabilityScore, ai as renderMarkdown, aj as romanToNumber, ak as sentenceCount, al as slugify, am as slugifyAll, an as syllableCount, ao as textToAscii, ap as textToMorse, aq as unescapeString, ar as wordFrequency } from '../text-CI7JAl7F.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, 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';

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, sentenceCount, slugify, slugifyAll, syllableCount, textToAscii, textToMorse, unescapeString, wordFrequency } from '../chunk-YBBYFAOV.js';
+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';
 import '../chunk-MLKGABMK.js';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@utilix-tech/sdk",
-  "version": "0.6.0",
-  "description": "140+ developer utility tools for Node.js: JSON, encoding, hashing, color, CSS, network and more. Runs locally, no API key required.",
+  "version": "0.8.0",
+  "description": "153+ 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",
   "homepage": "https://www.utilix.tech/docs#node-sdk",
@@ -28,7 +28,12 @@
     "regex",
     "uuid",
     "api-client",
-    "utilix"
+    "utilix",
+    "ai-agent",
+    "llm-tools",
+    "rag",
+    "yaml",
+    "base64"
   ],
   "engines": {
     "node": ">=18"

package/dist/media-CHaBS1dI.d.cts

@@ -1,82 +0,0 @@
-type ImageFormat = 'png' | 'jpeg' | 'gif' | 'webp' | 'bmp';
-interface ImageInfo {
-    format: ImageFormat;
-    width: number;
-    height: number;
-    bitDepth?: number;
-    colorType?: string;
-    hasAlpha?: boolean;
-}
-interface ImageInfoError {
-    error: string;
-}
-/**
- * Read image format, dimensions, and basic color info straight from file
- * bytes — no decoding, no image library, no canvas. Supports PNG, JPEG,
- * GIF, WebP, and BMP.
- */
-declare function readImageInfo(bytes: Uint8Array): ImageInfo | ImageInfoError;
-interface ExifData {
-    make?: string;
-    model?: string;
-    software?: string;
-    orientation?: number;
-    orientationLabel?: string;
-    dateTime?: string;
-    dateTimeOriginal?: string;
-    exposureTime?: string;
-    fNumber?: number;
-    isoSpeed?: number;
-    focalLength?: number;
-    gpsLatitude?: number;
-    gpsLongitude?: number;
-    tagCount: number;
-}
-interface ExifError {
-    error: string;
-}
-/**
- * Read common EXIF tags (make, model, orientation, timestamps, exposure
- * settings, GPS coordinates) directly from a JPEG's APP1 segment. Only
- * JPEG is supported: PNG, WebP, and other formats don't carry EXIF the
- * same way and are rejected with an error.
- */
-declare function readExifData(bytes: Uint8Array): ExifData | ExifError;
-interface PdfMetadata {
-    version: string | null;
-    pageCount: number | null;
-    title: string | null;
-    author: string | null;
-    subject: string | null;
-    keywords: string | null;
-    creator: string | null;
-    producer: string | null;
-    creationDate: string | null;
-    modDate: string | null;
-    encrypted: boolean;
-}
-interface PdfMetadataError {
-    error: string;
-}
-/**
- * Read PDF metadata (title, author, dates, page count, encryption flag)
- * straight from the file's trailer/Info dictionary and page tree — no
- * pdf.js or other PDF rendering library required.
- */
-declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
-
-type media_ExifData = ExifData;
-type media_ExifError = ExifError;
-type media_ImageFormat = ImageFormat;
-type media_ImageInfo = ImageInfo;
-type media_ImageInfoError = ImageInfoError;
-type media_PdfMetadata = PdfMetadata;
-type media_PdfMetadataError = PdfMetadataError;
-declare const media_readExifData: typeof readExifData;
-declare const media_readImageInfo: typeof readImageInfo;
-declare const media_readPdfMetadata: typeof readPdfMetadata;
-declare namespace media {
-  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, media_readExifData as readExifData, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata };
-}
-
-export { type ExifData as E, type ImageFormat as I, type PdfMetadata as P, type ExifError as a, type ImageInfo as b, type ImageInfoError as c, type PdfMetadataError as d, readImageInfo as e, readPdfMetadata as f, media as m, readExifData as r };

package/dist/media-CHaBS1dI.d.ts

@@ -1,82 +0,0 @@
-type ImageFormat = 'png' | 'jpeg' | 'gif' | 'webp' | 'bmp';
-interface ImageInfo {
-    format: ImageFormat;
-    width: number;
-    height: number;
-    bitDepth?: number;
-    colorType?: string;
-    hasAlpha?: boolean;
-}
-interface ImageInfoError {
-    error: string;
-}
-/**
- * Read image format, dimensions, and basic color info straight from file
- * bytes — no decoding, no image library, no canvas. Supports PNG, JPEG,
- * GIF, WebP, and BMP.
- */
-declare function readImageInfo(bytes: Uint8Array): ImageInfo | ImageInfoError;
-interface ExifData {
-    make?: string;
-    model?: string;
-    software?: string;
-    orientation?: number;
-    orientationLabel?: string;
-    dateTime?: string;
-    dateTimeOriginal?: string;
-    exposureTime?: string;
-    fNumber?: number;
-    isoSpeed?: number;
-    focalLength?: number;
-    gpsLatitude?: number;
-    gpsLongitude?: number;
-    tagCount: number;
-}
-interface ExifError {
-    error: string;
-}
-/**
- * Read common EXIF tags (make, model, orientation, timestamps, exposure
- * settings, GPS coordinates) directly from a JPEG's APP1 segment. Only
- * JPEG is supported: PNG, WebP, and other formats don't carry EXIF the
- * same way and are rejected with an error.
- */
-declare function readExifData(bytes: Uint8Array): ExifData | ExifError;
-interface PdfMetadata {
-    version: string | null;
-    pageCount: number | null;
-    title: string | null;
-    author: string | null;
-    subject: string | null;
-    keywords: string | null;
-    creator: string | null;
-    producer: string | null;
-    creationDate: string | null;
-    modDate: string | null;
-    encrypted: boolean;
-}
-interface PdfMetadataError {
-    error: string;
-}
-/**
- * Read PDF metadata (title, author, dates, page count, encryption flag)
- * straight from the file's trailer/Info dictionary and page tree — no
- * pdf.js or other PDF rendering library required.
- */
-declare function readPdfMetadata(bytes: Uint8Array): PdfMetadata | PdfMetadataError;
-
-type media_ExifData = ExifData;
-type media_ExifError = ExifError;
-type media_ImageFormat = ImageFormat;
-type media_ImageInfo = ImageInfo;
-type media_ImageInfoError = ImageInfoError;
-type media_PdfMetadata = PdfMetadata;
-type media_PdfMetadataError = PdfMetadataError;
-declare const media_readExifData: typeof readExifData;
-declare const media_readImageInfo: typeof readImageInfo;
-declare const media_readPdfMetadata: typeof readPdfMetadata;
-declare namespace media {
-  export { type media_ExifData as ExifData, type media_ExifError as ExifError, type media_ImageFormat as ImageFormat, type media_ImageInfo as ImageInfo, type media_ImageInfoError as ImageInfoError, type media_PdfMetadata as PdfMetadata, type media_PdfMetadataError as PdfMetadataError, media_readExifData as readExifData, media_readImageInfo as readImageInfo, media_readPdfMetadata as readPdfMetadata };
-}
-
-export { type ExifData as E, type ImageFormat as I, type PdfMetadata as P, type ExifError as a, type ImageInfo as b, type ImageInfoError as c, type PdfMetadataError as d, readImageInfo as e, readPdfMetadata as f, media as m, readExifData as r };