@utilix-tech/sdk 0.2.0 → 0.3.1

package/CHANGELOG.md

@@ -0,0 +1,15 @@
+# Changelog
+
+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.3.1
+- Metadata fixes: corrected repository/bug tracker links, updated tool count in the package description.
+
+## 0.3.0
+- Added the `media` module.
+
+## 0.2.0
+- 400+ functions across 14 modules, including the `ai_agent` module for LLM/RAG pipelines.
+
+## 0.1.0
+- Initial release.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**100+ developer utility functions for Node.js — runs locally, no API key required.**
+**140+ 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)
@@ -26,13 +26,13 @@ yarn add @utilix-tech/sdk
 pnpm add @utilix-tech/sdk
 ```
 
-**Requires Node.js 18 or later.** TypeScript types are bundled — no `@types/` package needed.
+**Requires Node.js 18 or later.** The public npm package includes bundled TypeScript types, so no `@types/` package is needed.
 
 ---
 
 ## Quick Start
 
-Each of the 14 modules is available as a dedicated subpath import. Import only what you use; bundlers automatically tree-shake the rest.
+Each of the 16 modules is available as a dedicated subpath import. Import only what you use; bundlers automatically tree-shake the rest.
 
 ```ts
 // Pick exactly the modules you need
@@ -62,7 +62,7 @@ const { formatJson } = require("@utilix-tech/sdk/json");
 
 ## Modules
 
-### `/json` — JSON Tools
+### `/json`: JSON Tools
 
 ```ts
 import { formatJson, minifyJson, diffJson, jsonToTypescript, validateJson,
@@ -71,7 +71,7 @@ import { formatJson, minifyJson, diffJson, jsonToTypescript, validateJson,
 // Format with 2-space indent
 formatJson('{"name":"alice","age":30}', { indent: 2 });
 
-// Diff two JSON strings — returns line-by-line diff
+// Diff two JSON strings: returns line-by-line diff
 diffJson(jsonA, jsonB);
 
 // Generate TypeScript interface from JSON
@@ -89,7 +89,7 @@ validateJson(data, schema);
 
 ---
 
-### `/encoding` — Encode & Decode
+### `/encoding`: Encode & Decode
 
 ```ts
 import { encodeBase64, decodeBase64, encodeUrl, decodeUrl,
@@ -104,7 +104,7 @@ base32Encode("hello");            // "NBSWY3DPEB3W64TMMQ======"
 
 ---
 
-### `/hashing` — Hash & Password
+### `/hashing`: Hash & Password
 
 ```ts
 import { hashAll, hashOne, hashPassword, verifyPassword, generateHtpasswdFile } from "@utilix-tech/sdk/hashing";
@@ -123,11 +123,11 @@ generateHtpasswdFile([{ username: "alice", password: "secret" }]);
 
 ---
 
-### `/text` — String & Text
+### `/text`: String & Text
 
 ```ts
 import { convertCase, slugify, countWords, generateWords, generateParagraphs,
-         escapeString, htmlToMarkdown, applyOps } from "@utilix-tech/sdk/text";
+         escapeString, htmlToMarkdown, applyOps, detectPassiveVoice } from "@utilix-tech/sdk/text";
 
 convertCase("hello world", "camelCase");   // "helloWorld"
 convertCase("hello world", "PascalCase");  // "HelloWorld"
@@ -145,11 +145,14 @@ generateParagraphs(3);  // lorem ipsum paragraphs
 applyOps(text, ["sort", "deduplicate", "trim"]);
 
 htmlToMarkdown("<h1>Hello</h1><p>World</p>");
+
+// Flag passive-voice sentences, e.g. "was written", "were approved by the team"
+detectPassiveVoice("The report was reviewed by the committee. They approved it.");
 ```
 
 ---
 
-### `/data` — CSV / YAML / TOML / XML / INI
+### `/data`: CSV / YAML / TOML / XML / INI
 
 ```ts
 import { parseCsv, csvToJson, validateYaml, tomlToJson, jsonToToml,
@@ -176,7 +179,7 @@ parseIni("[db]\nhost=localhost\nport=5432");
 
 ---
 
-### `/generators` — UUID, Passwords, Fake Data
+### `/generators`: UUID, Passwords, Fake Data
 
 ```ts
 import { generateUuid, generateV4, generateV7, generateUlid,
@@ -199,7 +202,7 @@ generateData([
 
 ---
 
-### `/time` — Dates, Timezones, Cron
+### `/time`: Dates, Timezones, Cron
 
 ```ts
 import { diffDates, parseCron, convertTime, formatRelative,
@@ -222,7 +225,7 @@ getNextRuns("*/5 * * * *", 5);  // next 5 run timestamps
 
 ---
 
-### `/units` — Conversions
+### `/units`: Conversions
 
 ```ts
 import { convertBytes, pxToAll, convert, formatValue } from "@utilix-tech/sdk/units";
@@ -247,7 +250,7 @@ formatValue(1234567.89, { locale: "en-US", currency: "USD" });
 
 ---
 
-### `/network` — URLs, IPs, HTTP
+### `/network`: URLs, IPs, HTTP
 
 ```ts
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
@@ -267,7 +270,7 @@ countryCodeToFlag("US");       // "🇺🇸"
 
 ---
 
-### `/api` — cURL, JWT, CORS, HTTP
+### `/api`: cURL, JWT, CORS, HTTP
 
 ```ts
 import { buildCurl, parseCurlCommand, decodeJwt, signJwt,
@@ -286,7 +289,7 @@ buildCurl({
 // Parse a curl command back into its parts
 parseCurlCommand('curl -X GET https://api.example.com -H "Authorization: Bearer token"');
 
-// JWT — decode without verification
+// JWT: decode without verification
 decodeJwt("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...");
 // { header: {...}, payload: {...}, isExpired: false, expiresIn: "2h" }
 
@@ -299,7 +302,7 @@ generateCspHeader({ "default-src": ["'self'"], "script-src": ["'self'", "cdn.exa
 
 ---
 
-### `/code` — SQL, HTML, RegEx, GQL
+### `/code`: SQL, HTML, RegEx, GQL
 
 ```ts
 import { formatSql, minifySql, testRegex, formatHtml, formatGql,
@@ -331,7 +334,7 @@ formatGql("query { user(id: 1) { name email } }");
 
 ---
 
-### `/color` — Color Conversion & Palettes
+### `/color`: Color Conversion & Palettes
 
 ```ts
 import { parseColor, convertColor, generatePalette, checkContrast } from "@utilix-tech/sdk/color";
@@ -351,7 +354,7 @@ checkContrast("#ffffff", "#000000");
 
 ---
 
-### `/css` — CSS Generators
+### `/css`: CSS Generators
 
 ```ts
 import { generateGradient, generateBoxShadow, generateBorderRadius,
@@ -373,7 +376,7 @@ generateBorderRadius({ tl: 8, tr: 8, br: 0, bl: 0 });
 
 ---
 
-### `/misc` — SVG, QR, Unicode
+### `/misc`: SVG, QR, Unicode
 
 ```ts
 import { optimizeSvg, sanitizeSvg, analyzeString, toUnicodeEscape,
@@ -397,6 +400,22 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 
 ---
 
+### `/media`: Image Header Parsing
+
+```ts
+import { readImageInfo } from "@utilix-tech/sdk/media";
+
+// Reads format, dimensions, bit depth, and alpha channel straight from
+// file bytes: no decoding, no canvas, no image library.
+const bytes = await fs.promises.readFile("photo.png");
+readImageInfo(new Uint8Array(bytes));
+// { format: "png", width: 1920, height: 1080, bitDepth: 8, colorType: "rgba", hasAlpha: true }
+```
+
+Supports PNG, JPEG, GIF, WebP, and BMP.
+
+---
+
 ## All Modules at a Glance
 
 | Import | What it does |
@@ -415,12 +434,14 @@ analyzeString("café");          // { length: 4, codePoints: [...], ... }
 | `@utilix-tech/sdk/color` | Hex/RGB/HSL/HSV/CMYK convert, palette generation, contrast check |
 | `@utilix-tech/sdk/css` | CSS gradient, box-shadow, border-radius, keyframe animation generators |
 | `@utilix-tech/sdk/misc` | SVG optimize/sanitize, file size format, Unicode inspector |
+| `@utilix-tech/sdk/ai_agent` | Token estimate/trim, chunk text, extract URLs/JSON/keywords, sanitize HTML, flatten/merge JSON, dedupe lines, validate schema, PII/secret/injection detect |
+| `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes: PNG, JPEG, GIF, WebP, BMP |
 
 ---
 
 ## Python SDK
 
-`@utilix-tech/sdk` has a Python companion — [`utilix-sdk`](https://pypi.org/project/utilix-sdk/) on PyPI — with the same 100+ tools and identical return shapes.
+`@utilix-tech/sdk` has a Python companion, [`utilix-sdk`](https://pypi.org/project/utilix-sdk/) on PyPI, with the same 140+ tools and identical return shapes.
 
 ```bash
 pip install utilix-sdk
@@ -430,14 +451,30 @@ Both SDKs return plain JSON-serializable objects so you can share test fixtures
 
 ---
 
-## Surface A vs Surface B
+## REST API
+
+**This package is Surface A**: everything runs in-process in your Node.js runtime. No outbound requests, no API key, no rate limits.
 
-**This package is Surface A** — everything runs in-process in your Node.js runtime. No outbound requests, no API key, no rate limits.
+The same 140+ tools are also available as a hosted **REST API** at `https://api.utilix.tech/v1` for environments where you can't ship a Node.js runtime, or for cross-language teams.
 
-A **Surface B REST API** (`api.utilix.tech`) is coming soon for use cases where you can't ship a Node.js or Python runtime. Same tools, callable from any language over HTTP.
+```bash
+curl -X POST https://api.utilix.tech/v1/tools/hash \
+  -H "Authorization: Bearer utx_live_..." \
+  -H "Content-Type: application/json" \
+  -d '{"input": "hello world", "algorithm": "sha256"}'
+```
+
+- **Free**: 1,000 requests/day: no credit card required
+- **Pro**: 10,000 requests/day: $9/month
+- Try it live at **[utilix.tech/api](https://utilix.tech/api)**: no signup needed for the first 10 endpoints
+- Get your API key at **[utilix.tech/dashboard](https://utilix.tech/dashboard)**
 
 ---
 
+## Publishing (maintainers)
+
+CI publishes automatically via npm Trusted Publishing (OIDC) on every push to `main` that bumps `version`. Requires npm **>=11.5.1**: older versions (e.g. the npm bundled with Node 20) sign provenance but skip the OIDC auth exchange, so `npm publish` fails with a 404 as if unauthenticated.
+
 ## License
 
-MIT — see [LICENSE](./LICENSE) for details.
+MIT: see [LICENSE](./LICENSE) for details.

package/SECURITY.md

@@ -0,0 +1,16 @@
+# Security Policy
+
+## Reporting a Vulnerability
+
+If you discover a security vulnerability in this package, please report it privately rather than opening a public issue.
+
+Email **hello@utilix.tech** with the subject line "Security report" and include:
+- A description of the vulnerability and its potential impact
+- Steps to reproduce, if possible
+- Any suggested fix
+
+We aim to acknowledge reports within 3 business days. Please give us a reasonable window to release a fix before disclosing publicly.
+
+## Supported Versions
+
+Only the latest published version of `@utilix-tech/sdk` receives security fixes. We recommend always running the latest release.

package/dist/{chunk-OKSWDVOM.js → chunk-GX7H6TAX.js}

@@ -570,7 +570,7 @@ function getConversionWarnings(from, to) {
     warnings.push("Transparency will be lost if the WebP image has an alpha channel");
   }
   if (to === "image/jpeg") {
-    warnings.push("JPEG uses lossy compression \u2014 some quality may be reduced");
+    warnings.push("JPEG uses lossy compression: some quality may be reduced");
   }
   return warnings;
 }

package/dist/{chunk-W4UBLYFU.js → chunk-HFRTZE7T.js}

@@ -451,13 +451,13 @@ function decodeJwt(token) {
   try {
     header = decodeSegment(rawHeader);
   } catch {
-    return { ok: false, error: "Failed to decode header \u2014 not valid base64url JSON" };
+    return { ok: false, error: "Failed to decode header: not valid base64url JSON" };
   }
   let payload;
   try {
     payload = decodeSegment(rawPayload);
   } catch {
-    return { ok: false, error: "Failed to decode payload \u2014 not valid base64url JSON" };
+    return { ok: false, error: "Failed to decode payload: not valid base64url JSON" };
   }
   const algorithm = typeof header.alg === "string" ? header.alg : "unknown";
   const now = Math.floor(Date.now() / 1e3);

package/dist/{chunk-ROTPLW7T.js → chunk-IPR7FSX4.js}

@@ -45,7 +45,7 @@ function decodeBase64(input, variant = "standard") {
     const output = bytes.toString("utf8");
     return { ok: true, output, outputBytes: bytes.length };
   } catch {
-    return { ok: false, error: "Invalid Base64 \u2014 check the input and variant setting" };
+    return { ok: false, error: "Invalid Base64: check the input and variant setting" };
   }
 }
 function encodeUrl(input, mode = "component") {
@@ -64,7 +64,7 @@ function decodeUrl(input, mode = "component") {
     const output = mode === "component" ? decodeURIComponent(trimmed) : decodeURI(trimmed);
     return { ok: true, output, changed: output !== trimmed };
   } catch {
-    return { ok: false, error: "Invalid percent-encoding \u2014 check the input" };
+    return { ok: false, error: "Invalid percent-encoding: check the input" };
   }
 }
 function diffSegments(original, encoded) {

package/dist/chunk-N7C52YGL.js

@@ -0,0 +1,134 @@
+import { __export } from './chunk-MLKGABMK.js';
+
+// src/tools/media.ts
+var media_exports = {};
+__export(media_exports, {
+  readImageInfo: () => readImageInfo
+});
+function readU32BE(bytes, offset) {
+  return (bytes[offset] << 24 | bytes[offset + 1] << 16 | bytes[offset + 2] << 8 | bytes[offset + 3]) >>> 0;
+}
+function readI32LE(bytes, offset) {
+  return bytes[offset] | bytes[offset + 1] << 8 | bytes[offset + 2] << 16 | bytes[offset + 3] << 24;
+}
+var PNG_COLOR_TYPES = {
+  0: "grayscale",
+  2: "rgb",
+  3: "palette",
+  4: "grayscale+alpha",
+  6: "rgba"
+};
+function readPng(bytes) {
+  if (bytes.length < 33) return { error: "Truncated PNG file" };
+  const width = readU32BE(bytes, 16);
+  const height = readU32BE(bytes, 20);
+  const bitDepth = bytes[24];
+  const colorTypeNum = bytes[25];
+  const colorType = PNG_COLOR_TYPES[colorTypeNum] ?? "unknown";
+  const hasAlpha = colorTypeNum === 4 || colorTypeNum === 6;
+  return { format: "png", width, height, bitDepth, colorType, hasAlpha };
+}
+function readGif(bytes) {
+  if (bytes.length < 10) return { error: "Truncated GIF file" };
+  const width = bytes[6] | bytes[7] << 8;
+  const height = bytes[8] | bytes[9] << 8;
+  return { format: "gif", width, height };
+}
+function readBmp(bytes) {
+  if (bytes.length < 30) return { error: "Truncated BMP file" };
+  const width = readI32LE(bytes, 18);
+  const heightRaw = readI32LE(bytes, 22);
+  const bitDepth = bytes[28] | bytes[29] << 8;
+  return { format: "bmp", width: Math.abs(width), height: Math.abs(heightRaw), bitDepth };
+}
+function readWebp(bytes) {
+  if (bytes.length < 16) return { error: "Truncated WebP file" };
+  const fourCC = String.fromCharCode(bytes[12], bytes[13], bytes[14], bytes[15]);
+  if (fourCC === "VP8 ") {
+    if (bytes.length < 30) return { error: "Truncated WebP file" };
+    const width = (bytes[26] | bytes[27] << 8) & 16383;
+    const height = (bytes[28] | bytes[29] << 8) & 16383;
+    return { format: "webp", width, height };
+  }
+  if (fourCC === "VP8L") {
+    if (bytes.length < 25) return { error: "Truncated WebP file" };
+    const bits = bytes[21] | bytes[22] << 8 | bytes[23] << 16 | bytes[24] << 24;
+    const width = (bits & 16383) + 1;
+    const height = (bits >>> 14 & 16383) + 1;
+    const hasAlpha = !!(bits >>> 28 & 1);
+    return { format: "webp", width, height, hasAlpha };
+  }
+  if (fourCC === "VP8X") {
+    if (bytes.length < 30) return { error: "Truncated WebP file" };
+    const flags = bytes[20];
+    const hasAlpha = !!(flags & 16);
+    const width = (bytes[24] | bytes[25] << 8 | bytes[26] << 16) + 1;
+    const height = (bytes[27] | bytes[28] << 8 | bytes[29] << 16) + 1;
+    return { format: "webp", width, height, hasAlpha };
+  }
+  return { error: "Unrecognized WebP chunk format" };
+}
+var JPEG_SOF_MARKERS = /* @__PURE__ */ new Set([
+  192,
+  193,
+  194,
+  195,
+  197,
+  198,
+  199,
+  201,
+  202,
+  203,
+  205,
+  206,
+  207
+]);
+function readJpeg(bytes) {
+  let offset = 2;
+  while (offset < bytes.length - 1) {
+    if (bytes[offset] !== 255) {
+      offset++;
+      continue;
+    }
+    const marker = bytes[offset + 1];
+    if (marker === 216 || marker === 1 || marker >= 208 && marker <= 215) {
+      offset += 2;
+      continue;
+    }
+    if (marker === 217) break;
+    if (offset + 3 >= bytes.length) break;
+    const segmentLength = bytes[offset + 2] << 8 | bytes[offset + 3];
+    if (JPEG_SOF_MARKERS.has(marker)) {
+      if (offset + 9 >= bytes.length) return { error: "Truncated JPEG SOF segment" };
+      const bitDepth = bytes[offset + 4];
+      const height = bytes[offset + 5] << 8 | bytes[offset + 6];
+      const width = bytes[offset + 7] << 8 | bytes[offset + 8];
+      const components = bytes[offset + 9];
+      const colorType = components === 1 ? "grayscale" : components === 3 ? "rgb" : components === 4 ? "cmyk" : "unknown";
+      return { format: "jpeg", width, height, bitDepth, colorType };
+    }
+    offset += 2 + segmentLength;
+  }
+  return { error: "No SOF marker found in JPEG (file may be corrupt)" };
+}
+function readImageInfo(bytes) {
+  if (bytes.length < 10) return { error: "File too small to determine format" };
+  if (bytes[0] === 137 && bytes[1] === 80 && bytes[2] === 78 && bytes[3] === 71 && bytes[4] === 13 && bytes[5] === 10 && bytes[6] === 26 && bytes[7] === 10) {
+    return readPng(bytes);
+  }
+  if (bytes[0] === 71 && bytes[1] === 73 && bytes[2] === 70) {
+    return readGif(bytes);
+  }
+  if (bytes[0] === 66 && bytes[1] === 77) {
+    return readBmp(bytes);
+  }
+  if (bytes[0] === 82 && bytes[1] === 73 && bytes[2] === 70 && bytes[3] === 70 && bytes[8] === 87 && bytes[9] === 69 && bytes[10] === 66 && bytes[11] === 80) {
+    return readWebp(bytes);
+  }
+  if (bytes[0] === 255 && bytes[1] === 216) {
+    return readJpeg(bytes);
+  }
+  return { error: "Unrecognized image format. Supported formats: PNG, JPEG, GIF, WebP, BMP" };
+}
+
+export { media_exports, readImageInfo };

package/dist/{chunk-XST6X3HT.js → chunk-QJE743LY.js}

@@ -82,16 +82,16 @@ function formatValue(value, unit, decimals = 4) {
   return `${value.toFixed(decimals)}${unit}`;
 }
 var COMMON_SIZES = [
-  { px: 8, label: "8px \u2014 Extra small spacing / icon size" },
-  { px: 12, label: "12px \u2014 Small text / caption" },
-  { px: 14, label: "14px \u2014 Body small / secondary text" },
-  { px: 16, label: "16px \u2014 Base font size / body text" },
-  { px: 18, label: "18px \u2014 Body large / lead text" },
-  { px: 20, label: "20px \u2014 Subheading / large body" },
-  { px: 24, label: "24px \u2014 H4 / section title" },
-  { px: 32, label: "32px \u2014 H3 / card heading" },
-  { px: 48, label: "48px \u2014 H2 / page section heading" },
-  { px: 64, label: "64px \u2014 H1 / hero heading" }
+  { px: 8, label: "8px: Extra small spacing / icon size" },
+  { px: 12, label: "12px: Small text / caption" },
+  { px: 14, label: "14px: Body small / secondary text" },
+  { px: 16, label: "16px: Base font size / body text" },
+  { px: 18, label: "18px: Body large / lead text" },
+  { px: 20, label: "20px: Subheading / large body" },
+  { px: 24, label: "24px: H4 / section title" },
+  { px: 32, label: "32px: H3 / card heading" },
+  { px: 48, label: "48px: H2 / page section heading" },
+  { px: 64, label: "64px: H1 / hero heading" }
 ];
 function pxToViewport(px, viewportWidth = 1440, viewportHeight = 900) {
   const vw = parseFloat((px / viewportWidth * 100).toFixed(4));

package/dist/{chunk-NSOARQCM.js → chunk-V5S6OJ4A.js}

@@ -134,24 +134,24 @@ var CHEATSHEET = [
   { pattern: "{n}", description: "Matches exactly n repetitions", example: "\\d{3} matches exactly 3 digits", category: "Quantifiers" },
   { pattern: "{n,}", description: "Matches n or more repetitions", example: "\\d{2,} matches 2 or more digits", category: "Quantifiers" },
   { pattern: "{n,m}", description: "Matches between n and m repetitions", example: "\\d{2,4} matches 2 to 4 digits", category: "Quantifiers" },
-  { pattern: "*?", description: "Lazy match \u2014 matches as few characters as possible", example: "<.*?> matches the shortest possible HTML tag", category: "Quantifiers" },
+  { pattern: "*?", description: "Lazy match: matches as few characters as possible", example: "<.*?> matches the shortest possible HTML tag", category: "Quantifiers" },
   { pattern: "+?", description: "Lazy version of +", example: "a+? matches as few 'a's as possible", category: "Quantifiers" },
-  { pattern: "(abc)", description: "Capturing group \u2014 captures the matched substring", example: "(\\d+) captures digit sequences", category: "Groups" },
-  { pattern: "(?:abc)", description: "Non-capturing group \u2014 groups without capturing", example: "(?:foo|bar)baz matches 'foobaz' or 'barbaz'", category: "Groups" },
+  { pattern: "(abc)", description: "Capturing group: captures the matched substring", example: "(\\d+) captures digit sequences", category: "Groups" },
+  { pattern: "(?:abc)", description: "Non-capturing group: groups without capturing", example: "(?:foo|bar)baz matches 'foobaz' or 'barbaz'", category: "Groups" },
   { pattern: "(?<name>abc)", description: "Named capturing group", example: "(?<year>\\d{4}) captures year by name", category: "Groups" },
-  { pattern: "a|b", description: "Alternation \u2014 matches either a or b", example: "cat|dog matches 'cat' or 'dog'", category: "Groups" },
+  { pattern: "a|b", description: "Alternation: matches either a or b", example: "cat|dog matches 'cat' or 'dog'", category: "Groups" },
   { pattern: "\\1", description: "Backreference to the first capturing group", example: "(\\w+) \\1 matches repeated words like 'the the'", category: "Groups" },
   { pattern: "\\k<name>", description: "Backreference to a named capturing group", example: "(?<word>\\w+) \\k<word> matches repeated named group", category: "Groups" },
-  { pattern: "(?=abc)", description: "Positive lookahead \u2014 asserts what follows matches", example: "\\d+(?= dollars) matches digits followed by ' dollars'", category: "Lookahead/Lookbehind" },
-  { pattern: "(?!abc)", description: "Negative lookahead \u2014 asserts what follows does not match", example: "\\d+(?! dollars) matches digits not followed by ' dollars'", category: "Lookahead/Lookbehind" },
-  { pattern: "(?<=abc)", description: "Positive lookbehind \u2014 asserts what precedes matches", example: "(?<=\\$)\\d+ matches digits preceded by '$'", category: "Lookahead/Lookbehind" },
-  { pattern: "(?<!abc)", description: "Negative lookbehind \u2014 asserts what precedes does not match", example: "(?<!\\$)\\d+ matches digits not preceded by '$'", category: "Lookahead/Lookbehind" },
-  { pattern: "g", description: "Global flag \u2014 finds all matches rather than stopping at the first", example: "/\\d+/g finds all numbers in a string", category: "Flags" },
-  { pattern: "i", description: "Case-insensitive flag \u2014 ignores letter case", example: "/hello/i matches 'Hello', 'HELLO', 'hello'", category: "Flags" },
-  { pattern: "m", description: "Multiline flag \u2014 ^ and $ match start/end of each line", example: "/^\\w+/m matches the first word of each line", category: "Flags" },
-  { pattern: "s", description: "Dotall flag \u2014 makes . match newline characters too", example: "/a.b/s matches 'a\\nb'", category: "Flags" },
-  { pattern: "u", description: "Unicode flag \u2014 enables full Unicode matching", example: "/\\u{1F600}/u matches a Unicode emoji", category: "Flags" },
-  { pattern: "y", description: "Sticky flag \u2014 matches only from the lastIndex position", example: "/\\d+/y matches digits starting at the current position", category: "Flags" },
+  { pattern: "(?=abc)", description: "Positive lookahead: asserts what follows matches", example: "\\d+(?= dollars) matches digits followed by ' dollars'", category: "Lookahead/Lookbehind" },
+  { pattern: "(?!abc)", description: "Negative lookahead: asserts what follows does not match", example: "\\d+(?! dollars) matches digits not followed by ' dollars'", category: "Lookahead/Lookbehind" },
+  { pattern: "(?<=abc)", description: "Positive lookbehind: asserts what precedes matches", example: "(?<=\\$)\\d+ matches digits preceded by '$'", category: "Lookahead/Lookbehind" },
+  { pattern: "(?<!abc)", description: "Negative lookbehind: asserts what precedes does not match", example: "(?<!\\$)\\d+ matches digits not preceded by '$'", category: "Lookahead/Lookbehind" },
+  { pattern: "g", description: "Global flag: finds all matches rather than stopping at the first", example: "/\\d+/g finds all numbers in a string", category: "Flags" },
+  { pattern: "i", description: "Case-insensitive flag: ignores letter case", example: "/hello/i matches 'Hello', 'HELLO', 'hello'", category: "Flags" },
+  { pattern: "m", description: "Multiline flag: ^ and $ match start/end of each line", example: "/^\\w+/m matches the first word of each line", category: "Flags" },
+  { pattern: "s", description: "Dotall flag: makes . match newline characters too", example: "/a.b/s matches 'a\\nb'", category: "Flags" },
+  { pattern: "u", description: "Unicode flag: enables full Unicode matching", example: "/\\u{1F600}/u matches a Unicode emoji", category: "Flags" },
+  { pattern: "y", description: "Sticky flag: matches only from the lastIndex position", example: "/\\d+/y matches digits starting at the current position", category: "Flags" },
   { pattern: "[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}", description: "Matches a basic email address", example: "user@example.com", category: "Common Patterns" },
   { pattern: "https?://[\\w\\-]+(\\.[\\w\\-]+)+([\\w.,@?^=%&:/~+#\\-]*[\\w@?^=%&/~+#\\-])?", description: "Matches an HTTP or HTTPS URL", example: "https://www.example.com/path?query=value", category: "Common Patterns" },
   { pattern: "^(?:\\+1)?[-.\\s]?\\(?\\d{3}\\)?[-.\\s]?\\d{3}[-.\\s]?\\d{4}$", description: "Matches a North American phone number in various formats", example: "(555) 123-4567 or 555-123-4567", category: "Common Patterns" },