@utilix-tech/sdk 0.66.0 → 0.68.0

package/CHANGELOG.md

@@ -2,6 +2,13 @@
 
 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.68.0
+- Add `buildRobotsMetaTag`, `parseRobotsMetaTag` (robots-meta-tag-builder): build a `<meta name="robots" content="...">` tag from the same directive vocabulary as X-Robots-Tag, optionally scoped to a crawler via the name attribute, or parse an existing tag into the same shape.
+- Add `extractSvgSpriteSymbols` (svg-sprite-symbol-extractor): parse an SVG sprite sheet's `<symbol>` definitions and list each one's id, viewBox, width, and height, alongside a ready-to-paste `<use href="#id"></use>` usage snippet.
+
+## 0.67.0
+- Add `analyzeRegexGroups` (regex-groups): parse a regex pattern's capture groups (numbered and named) and backreferences, flagging any backreference pointing at a group that doesn't exist or hasn't finished being defined yet at that point in the pattern.
+
 ## 0.66.0
 - Add `buildXRobotsTag`, `parseXRobotsTag` (x-robots-tag-builder): build an X-Robots-Tag response header from flag directives (noindex, nofollow, etc.) plus max-snippet/max-image-preview/max-video-preview/unavailable_after value directives, optionally scoped to a crawler user-agent, or parse an existing header into the same shape.
 - Add `lookupOpcode`, `listOpcodes` (websocket-opcode-reference): look up what a WebSocket frame opcode means per RFC 6455's 4-bit opcode space, or list every opcode.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**682 developer utility functions for Node.js: runs locally, no API key required.**
+**686 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)
@@ -676,6 +676,11 @@ parseMultipartFormData('--X\r\nContent-Disposition: form-data; name="a"\r\n\r\nh
 // Extract the boundary parameter from a Content-Type header value
 extractMultipartBoundary("multipart/form-data; boundary=----WebKitFormBoundaryABC123");
 // "----WebKitFormBoundaryABC123"
+
+// Build a <meta name="robots" content="..."> tag, the same directive vocabulary as X-Robots-Tag
+import { buildRobotsMetaTag, parseRobotsMetaTag } from "@utilix-tech/sdk/network";
+buildRobotsMetaTag({ flags: ["noindex", "nofollow"], name: "googlebot" });
+// { content: "noindex, nofollow", name: "googlebot", tag: '<meta name="googlebot" content="noindex, nofollow">', directives: [...], notes: [...], warnings: [] }
 ```
 
 ---
@@ -725,7 +730,7 @@ generateCspHeader({ "default-src": ["'self'"], "script-src": ["'self'", "cdn.exa
 ```ts
 import { formatSql, minifySql, testRegex, formatHtml, formatGql,
          detectDialect, splitStatements, lookupMime, parseGithubUrl,
-         detectRedos, testGitignorePatterns, validateEditorConfig,
+         detectRedos, analyzeRegexGroups, testGitignorePatterns, validateEditorConfig,
          validateTsconfig, validatePackageExports } from "@utilix-tech/sdk/code";
 
 // SQL
@@ -763,6 +768,10 @@ parseGithubUrl("https://github.com/facebook/react/pull/1234");
 detectRedos("(a+)+");
 // { risk: "high", safe: false, findings: [{ type: "nested-quantifier", ... }] }
 
+// Regex capture group & backreference visualizer
+analyzeRegexGroups("(a)(b)\\3");
+// { groups: [{ index: 1, ... }, { index: 2, ... }], issues: [{ severity: "error", message: "Backreference \\3 ... doesn't exist ..." }] }
+
 // Test paths against a .gitignore file's patterns
 testGitignorePatterns("node_modules/\n*.log", ["node_modules/foo.js", "debug.log", "src/index.js"]);
 // [{ path: "node_modules/foo.js", ignored: true, matchedPattern: "node_modules/", matchedLine: 1 }, ...]
@@ -782,6 +791,11 @@ validatePackageExports(JSON.stringify({ exports: { import: "./index.mjs", requir
 // Classify each package.json dependency's version range and flag wildcards, "latest", git/URL/file deps, and conflicting duplicates
 auditDependencyRanges(JSON.stringify({ dependencies: { lodash: "^4.17.21", "left-pad": "*" } }));
 // { totalDependencies: 2, dependencies: [{ name: "lodash", rangeType: "caret", issues: [] }, { name: "left-pad", rangeType: "wildcard", issues: [...] }], duplicates: [], issues: [...] }
+
+// List an SVG sprite sheet's <symbol> definitions with id, viewBox, and a ready-to-paste <use> snippet
+import { extractSvgSpriteSymbols } from "@utilix-tech/sdk/code";
+extractSvgSpriteSymbols('<svg><symbol id="icon-home" viewBox="0 0 24 24"></symbol></svg>');
+// { symbolCount: 1, symbols: [{ id: "icon-home", viewBox: "0 0 24 24", width: null, height: null, usageSnippet: '<svg><use href="#icon-home"></use></svg>' }], skippedCount: 0 }
 ```
 
 ---
@@ -939,9 +953,9 @@ inspectGifFrames(new Uint8Array(gifBytes));
 | `@utilix-tech/sdk/generators` | UUID v4/v7, ULID, passwords, strength check, entropy estimator, fake data, CSP nonce generator |
 | `@utilix-tech/sdk/time` | Date diff, timezone convert, cron parse, relative time |
 | `@utilix-tech/sdk/units` | Bytes, CSS px/rem, number bases, currency format, credit card/IBAN/barcode/ISBN validation, loan calculator, EMI calculator, compound/simple interest calculators, VAT/sales tax calculator, tip/bill split calculator, break-even point calculator, Rule of 72 calculator, savings goal calculator, ROI calculator, cash denomination/till calculator, payback period calculator, CD maturity calculator, debt-to-income ratio calculator, freelancer hourly rate calculator, debt snowball/avalanche payoff planner |
-| `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing, IPv6 address compress/expand, Permissions-Policy header builder, Client Hints header builder/parser, Content-Disposition header builder/parser, X-Content-Type-Options header builder/risk assessor, sitemap.xml validator, sitemap index splitter, Prefer header builder/parser (RFC 7240), Retry-After header builder/parser (RFC 9110), Priority header builder/parser (RFC 9218), WebSocket close code reference/lookup, Strict-Transport-Security (HSTS) header builder/parser |
+| `@utilix-tech/sdk/network` | HTTP status codes, IP validation, country flags, geolocation URLs, HAR file parsing, User-Agent parsing, IPv6 address compress/expand, Permissions-Policy header builder, Client Hints header builder/parser, Content-Disposition header builder/parser, X-Content-Type-Options header builder/risk assessor, sitemap.xml validator, sitemap index splitter, Prefer header builder/parser (RFC 7240), Retry-After header builder/parser (RFC 9110), Priority header builder/parser (RFC 9218), WebSocket close code reference/lookup, Strict-Transport-Security (HSTS) header builder/parser, X-Robots-Tag header builder/parser, WebSocket frame opcode reference/lookup, robots meta tag builder/parser |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header |
-| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing, regex ReDoS detector, Conventional Commits linter, package.json exports field validator, package.json dependency range auditor |
+| `@utilix-tech/sdk/code` | SQL format/minify, HTML format/minify, regex tester, GraphQL format, MIME type lookup, GitHub URL parsing, regex ReDoS detector, Conventional Commits linter, package.json exports field validator, package.json dependency range auditor, regex capture group/backreference visualizer, SVG sprite symbol extractor |
 | `@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 |

package/dist/{chunk-TTQ2FNUG.js → chunk-ACGCCOCK.js}

@@ -28,6 +28,7 @@ __export(network_exports, {
   buildRangeHeader: () => buildRangeHeader,
   buildReferrerPolicy: () => buildReferrerPolicy,
   buildRetryAfterHeader: () => buildRetryAfterHeader,
+  buildRobotsMetaTag: () => buildRobotsMetaTag,
   buildVaryHeader: () => buildVaryHeader,
   buildXContentTypeOptionsHeader: () => buildXContentTypeOptionsHeader,
   buildXRobotsTag: () => buildXRobotsTag,
@@ -65,6 +66,7 @@ __export(network_exports, {
   parsePreferHeader: () => parsePreferHeader,
   parsePriorityHeader: () => parsePriorityHeader,
   parseRetryAfterHeader: () => parseRetryAfterHeader,
+  parseRobotsMetaTag: () => parseRobotsMetaTag,
   parseUserAgent: () => parseUserAgent,
   parseVaryHeader: () => parseVaryHeader,
   parseXContentTypeOptionsHeader: () => parseXContentTypeOptionsHeader,
@@ -3407,5 +3409,76 @@ function lookupOpcode(opcode) {
   }
   return _describeOpcode(opcode);
 }
+function buildRobotsMetaTag(options) {
+  const built = buildXRobotsTag({
+    flags: options?.flags,
+    maxSnippet: options?.maxSnippet,
+    maxImagePreview: options?.maxImagePreview,
+    maxVideoPreview: options?.maxVideoPreview,
+    unavailableAfter: options?.unavailableAfter
+  });
+  if ("error" in built) return built;
+  const name = options?.name?.trim() || "robots";
+  return {
+    content: built.header,
+    name,
+    tag: `<meta name="${name}" content="${built.header}">`,
+    directives: built.directives,
+    notes: built.notes,
+    warnings: built.warnings
+  };
+}
+var _ROBOTS_META_TAG_REGEX = /<meta\b[^>]*>/i;
+var _ROBOTS_META_NAME_ATTR_REGEX = /\bname\s*=\s*["']([^"']*)["']/i;
+var _ROBOTS_META_CONTENT_ATTR_REGEX = /\bcontent\s*=\s*["']([^"']*)["']/i;
+function parseRobotsMetaTag(raw) {
+  if (!raw || raw.trim() === "") return { error: "Input is empty" };
+  const trimmed = raw.trim();
+  let name = "robots";
+  let content = trimmed;
+  const tagMatch = trimmed.match(_ROBOTS_META_TAG_REGEX);
+  if (tagMatch) {
+    const nameMatch = tagMatch[0].match(_ROBOTS_META_NAME_ATTR_REGEX);
+    const contentMatch = tagMatch[0].match(_ROBOTS_META_CONTENT_ATTR_REGEX);
+    if (!contentMatch) return { error: "Meta tag is missing a content attribute" };
+    if (nameMatch) name = nameMatch[1].trim() || "robots";
+    content = contentMatch[1];
+  }
+  const tokens = content.split(",").map((t) => t.trim()).filter((t) => t !== "");
+  if (tokens.length === 0) return { error: "No directives found" };
+  const flags = [];
+  let maxSnippet;
+  let maxImagePreview;
+  let maxVideoPreview;
+  let unavailableAfter;
+  for (const token of tokens) {
+    const eq = token.indexOf(":");
+    const directiveName = (eq === -1 ? token : token.slice(0, eq)).trim().toLowerCase();
+    const value = eq === -1 ? "" : token.slice(eq + 1).trim();
+    if (eq === -1) {
+      if (!_isXRobotsTagFlag(directiveName)) return { error: `Unrecognized directive "${token}"` };
+      flags.push(directiveName);
+      continue;
+    }
+    if (directiveName === "max-snippet") {
+      const n = Number(value);
+      if (value === "" || !Number.isInteger(n) || n < -1) return { error: `max-snippet value "${value}" is not a valid integer >= -1` };
+      maxSnippet = n;
+    } else if (directiveName === "max-image-preview") {
+      if (!["none", "standard", "large"].includes(value)) return { error: `max-image-preview value "${value}" must be one of "none", "standard", "large"` };
+      maxImagePreview = value;
+    } else if (directiveName === "max-video-preview") {
+      const n = Number(value);
+      if (value === "" || !Number.isInteger(n) || n < -1) return { error: `max-video-preview value "${value}" is not a valid integer >= -1` };
+      maxVideoPreview = n;
+    } else if (directiveName === "unavailable_after") {
+      if (value === "" || Number.isNaN(Date.parse(value))) return { error: `unavailable_after value "${value}" is not a valid, parseable date` };
+      unavailableAfter = value;
+    } else {
+      return { error: `Unrecognized directive "${token}"` };
+    }
+  }
+  return buildRobotsMetaTag({ flags, maxSnippet, maxImagePreview, maxVideoPreview, unavailableAfter, name });
+}
 
-export { CLIENT_HINTS, DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, PERMISSIONS_POLICY_FEATURES, REFERRER_POLICY_VALUES, STATUS_CODES, X_CONTENT_TYPE_OPTIONS_HEADER, analyzeEmailHeaders, assessContentTypeRisk, buildAcceptLanguage, buildCacheControl, buildClientHints, buildContentDisposition, buildDnsQueryUrl, buildGeoUrl, buildHsts, buildLinkHeader, buildMapUrl, buildPermissionsPolicy, buildPreferHeader, buildPriorityHeader, buildRangeHeader, buildReferrerPolicy, buildRetryAfterHeader, buildVaryHeader, buildXContentTypeOptionsHeader, buildXRobotsTag, checkSetCookieHeader, countryCodeToFlag, extractMultipartBoundary, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, listCloseCodes, listOpcodes, lookupCloseCode, lookupOpcode, network_exports, parseAcceptLanguage, parseClientHintHeaders, parseContentDisposition, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseHsts, parseIpv6Address, parseMultipartFormData, parsePermissionsPolicy, parsePreferHeader, parsePriorityHeader, parseRetryAfterHeader, parseUserAgent, parseVaryHeader, parseXContentTypeOptionsHeader, parseXRobotsTag, searchHeaders, searchStatusCodes, splitSitemap, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateManifest, validateRobotsTxt, validateSitemap };
+export { CLIENT_HINTS, DNS_RECORD_TYPES, HTTP_HEADERS, LINK_REL_VALUES, PERMISSIONS_POLICY_FEATURES, REFERRER_POLICY_VALUES, STATUS_CODES, X_CONTENT_TYPE_OPTIONS_HEADER, analyzeEmailHeaders, assessContentTypeRisk, buildAcceptLanguage, buildCacheControl, buildClientHints, buildContentDisposition, buildDnsQueryUrl, buildGeoUrl, buildHsts, buildLinkHeader, buildMapUrl, buildPermissionsPolicy, buildPreferHeader, buildPriorityHeader, buildRangeHeader, buildReferrerPolicy, buildRetryAfterHeader, buildRobotsMetaTag, buildVaryHeader, buildXContentTypeOptionsHeader, buildXRobotsTag, checkSetCookieHeader, countryCodeToFlag, extractMultipartBoundary, formatCoordinates, formatTtl, getByCategory, getHeader, getHeadersByCategory, getStatusByCategory, getStatusCode, isClientError, isServerError, isSuccess, isValidIp, isValidIpv4, isValidIpv6, listCloseCodes, listOpcodes, lookupCloseCode, lookupOpcode, network_exports, parseAcceptLanguage, parseClientHintHeaders, parseContentDisposition, parseContentRangeHeader, parseDnsResponse, parseGeoResponse, parseHar, parseHsts, parseIpv6Address, parseMultipartFormData, parsePermissionsPolicy, parsePreferHeader, parsePriorityHeader, parseRetryAfterHeader, parseRobotsMetaTag, parseUserAgent, parseVaryHeader, parseXContentTypeOptionsHeader, parseXRobotsTag, searchHeaders, searchStatusCodes, splitSitemap, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateManifest, validateRobotsTxt, validateSitemap };

package/dist/{chunk-JPFHEZ4P.js → chunk-COL3IM7U.js}

@@ -10,6 +10,7 @@ __export(code_exports, {
   MIME_TABLE: () => MIME_TABLE,
   OPERATIONS: () => OPERATIONS,
   SQL_DEFAULT_OPTIONS: () => SQL_DEFAULT_OPTIONS,
+  analyzeRegexGroups: () => analyzeRegexGroups,
   auditDependencyRanges: () => auditDependencyRanges,
   buildDockerPull: () => buildDockerPull,
   buildDockerRun: () => buildDockerRun,
@@ -23,6 +24,7 @@ __export(code_exports, {
   detectRedos: () => detectRedos,
   envToExport: () => envToExport,
   envToJson: () => envToJson,
+  extractSvgSpriteSymbols: () => extractSvgSpriteSymbols,
   formatCss: () => formatCss,
   formatGql: () => formatGql,
   formatHtml: () => formatHtml,
@@ -3485,5 +3487,143 @@ function auditDependencyRanges(packageJsonText) {
     issues
   };
 }
+function analyzeRegexGroups(pattern) {
+  let valid = true;
+  let compileError;
+  try {
+    new RegExp(pattern);
+  } catch (e) {
+    valid = false;
+    compileError = e instanceof Error ? e.message : String(e);
+  }
+  const groups = [];
+  const openStack = [];
+  const backreferences = [];
+  const issues = [];
+  let groupCount = 0;
+  let inClass = false;
+  for (let i = 0; i < pattern.length; i++) {
+    const ch = pattern[i];
+    if (ch === "\\" && i + 1 < pattern.length) {
+      const next = pattern[i + 1];
+      if (!inClass && /[1-9]/.test(next)) {
+        let j = i + 1;
+        while (j < pattern.length && /[0-9]/.test(pattern[j])) j++;
+        const raw = pattern.slice(i, j);
+        const target = parseInt(pattern.slice(i + 1, j), 10);
+        backreferences.push({ raw, target, start: i, resolved: false, definedBeforeUse: false });
+        i = j - 1;
+        continue;
+      }
+      if (!inClass && next === "k" && pattern[i + 2] === "<") {
+        const close = pattern.indexOf(">", i + 3);
+        if (close !== -1) {
+          const name = pattern.slice(i + 3, close);
+          const raw = pattern.slice(i, close + 1);
+          backreferences.push({ raw, target: name, start: i, resolved: false, definedBeforeUse: false });
+          i = close;
+          continue;
+        }
+      }
+      i++;
+      continue;
+    }
+    if (ch === "[" && !inClass) {
+      inClass = true;
+      continue;
+    }
+    if (ch === "]" && inClass) {
+      inClass = false;
+      continue;
+    }
+    if (inClass) continue;
+    if (ch === "(") {
+      if (pattern[i + 1] === "?") {
+        const c2 = pattern[i + 2];
+        if (c2 === ":" || c2 === "=" || c2 === "!") {
+          openStack.push({ index: -1, name: null, start: i });
+          continue;
+        }
+        if (c2 === "<" && (pattern[i + 3] === "=" || pattern[i + 3] === "!")) {
+          openStack.push({ index: -1, name: null, start: i });
+          continue;
+        }
+        if (c2 === "<") {
+          const close = pattern.indexOf(">", i + 3);
+          const name = close !== -1 ? pattern.slice(i + 3, close) : null;
+          groupCount++;
+          openStack.push({ index: groupCount, name, start: i });
+          if (close !== -1) i = close;
+          continue;
+        }
+        openStack.push({ index: -1, name: null, start: i });
+        continue;
+      }
+      groupCount++;
+      openStack.push({ index: groupCount, name: null, start: i });
+      continue;
+    }
+    if (ch === ")") {
+      const open = openStack.pop();
+      if (open && open.index !== -1) {
+        groups.push({ index: open.index, name: open.name, start: open.start, end: i });
+      }
+      continue;
+    }
+  }
+  for (const open of openStack) {
+    if (open.index !== -1) groups.push({ index: open.index, name: open.name, start: open.start, end: -1 });
+  }
+  groups.sort((a, b) => a.index - b.index);
+  const byIndex = new Map(groups.map((g) => [g.index, g]));
+  const byName = new Map(groups.filter((g) => g.name !== null).map((g) => [g.name, g]));
+  for (const b of backreferences) {
+    const g = typeof b.target === "number" ? byIndex.get(b.target) : byName.get(b.target);
+    if (!g) {
+      b.resolved = false;
+      b.definedBeforeUse = false;
+      const label = typeof b.target === "number" ? `group ${b.target}` : `named group "${b.target}"`;
+      issues.push({ severity: "error", message: `Backreference ${b.raw} at position ${b.start} points to ${label}, which doesn't exist in this pattern.` });
+    } else {
+      b.resolved = true;
+      b.definedBeforeUse = g.end !== -1 && g.end < b.start;
+      if (!b.definedBeforeUse) {
+        const label = `group ${g.index}${g.name ? ` ("${g.name}")` : ""}`;
+        issues.push({ severity: "error", message: `Backreference ${b.raw} at position ${b.start} references ${label}, which hasn't finished being defined yet at that point in the pattern.` });
+      }
+    }
+  }
+  return { pattern, valid, ...compileError ? { compileError } : {}, groups, backreferences, issues };
+}
+var SVG_SYMBOL_TAG_REGEX = /<symbol\b([^>]*)>/gi;
+function extractSvgAttr(attrs, name) {
+  const match = attrs.match(new RegExp(`\\s${name}\\s*=\\s*["']([^"']*)["']`, "i"));
+  return match ? match[1] : null;
+}
+function extractSvgSpriteSymbols(svg) {
+  const trimmed = svg.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const symbols = [];
+  let skippedCount = 0;
+  for (const match of trimmed.matchAll(SVG_SYMBOL_TAG_REGEX)) {
+    const attrs = match[1];
+    const id = extractSvgAttr(attrs, "id");
+    if (!id) {
+      skippedCount++;
+      continue;
+    }
+    symbols.push({
+      id,
+      viewBox: extractSvgAttr(attrs, "viewBox"),
+      width: extractSvgAttr(attrs, "width"),
+      height: extractSvgAttr(attrs, "height"),
+      usageSnippet: `<svg><use href="#${id}"></use></svg>`
+    });
+  }
+  if (symbols.length === 0 && skippedCount === 0) {
+    return { error: "No <symbol> elements found" };
+  }
+  return { symbolCount: symbols.length, symbols, skippedCount };
+}
 
-export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateEditorConfig, validateEnvKey, validatePackageExports, validateTsconfig };
+export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, extractSvgSpriteSymbols, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateEditorConfig, validateEnvKey, validatePackageExports, validateTsconfig };

package/dist/{code-CKI2Z_NM.d.cts → code-DB-5ZfG4.d.cts}

@@ -26,6 +26,8 @@
  *   - tsconfig-validator (validateTsconfig)
  *   - package-json-exports-validator (validatePackageExports)
  *   - package-json-dependency-auditor (auditDependencyRanges)
+ *   - regex-groups     (analyzeRegexGroups)
+ *   - svg-sprite-symbol-extractor (extractSvgSpriteSymbols)
  */
 type RegexFlag = 'g' | 'i' | 'm' | 's' | 'u';
 declare const ALL_FLAGS: RegexFlag[];
@@ -511,6 +513,64 @@ interface DependencyAuditResult {
 declare function auditDependencyRanges(packageJsonText: string): DependencyAuditResult | {
     error: string;
 };
+interface RegexGroupInfo {
+    index: number;
+    name: string | null;
+    start: number;
+    end: number;
+}
+interface RegexBackreferenceInfo {
+    raw: string;
+    target: number | string;
+    start: number;
+    resolved: boolean;
+    definedBeforeUse: boolean;
+}
+interface RegexGroupIssue {
+    severity: 'error' | 'warning';
+    message: string;
+}
+interface RegexGroupAnalysis {
+    pattern: string;
+    valid: boolean;
+    compileError?: string;
+    groups: RegexGroupInfo[];
+    backreferences: RegexBackreferenceInfo[];
+    issues: RegexGroupIssue[];
+}
+/**
+ * Parse a regex pattern's capture groups (numbered and named) and
+ * backreferences, and flag any backreference that points at a group which
+ * doesn't exist or hasn't finished being defined yet at that point in the
+ * pattern (a forward reference or a self-reference). Pass the pattern body
+ * only, no delimiters or flags. This is a structural, non-AI check, distinct
+ * from the ReDoS Detector (backtracking risk) and Regex Explainer (AI)
+ * (plain-English breakdown).
+ */
+declare function analyzeRegexGroups(pattern: string): RegexGroupAnalysis;
+interface SvgSpriteSymbol {
+    id: string;
+    viewBox: string | null;
+    width: string | null;
+    height: string | null;
+    usageSnippet: string;
+}
+interface SvgSpriteResult {
+    symbolCount: number;
+    symbols: SvgSpriteSymbol[];
+    skippedCount: number;
+}
+/**
+ * Parse an SVG sprite sheet's <symbol> definitions and list each one's id,
+ * viewBox, width, and height, alongside a ready-to-paste
+ * `<use href="#id"></use>` usage snippet. A symbol with no id is skipped
+ * (counted in skippedCount) since it can't be referenced by a `<use>`
+ * element at all. Pure regex-based parsing over the raw markup, no DOM/XML
+ * parser dependency, matching the SVG Viewer tool's parsing style.
+ */
+declare function extractSvgSpriteSymbols(svg: string): SvgSpriteResult | {
+    error: string;
+};
 
 declare const code_ALL_FLAGS: typeof ALL_FLAGS;
 type code_ApiEndpoint = ApiEndpoint;
@@ -562,8 +622,12 @@ type code_ParsedSpec = ParsedSpec;
 type code_RedosFinding = RedosFinding;
 type code_RedosResult = RedosResult;
 type code_RedosSeverity = RedosSeverity;
+type code_RegexBackreferenceInfo = RegexBackreferenceInfo;
 type code_RegexError = RegexError;
 type code_RegexFlag = RegexFlag;
+type code_RegexGroupAnalysis = RegexGroupAnalysis;
+type code_RegexGroupInfo = RegexGroupInfo;
+type code_RegexGroupIssue = RegexGroupIssue;
 type code_RegexMatch = RegexMatch;
 type code_RegexResult = RegexResult;
 type code_RegexSuccess = RegexSuccess;
@@ -572,9 +636,12 @@ type code_Segment = Segment;
 type code_SpecVersion = SpecVersion;
 type code_SqlDialect = SqlDialect;
 type code_SqlFormatOptions = SqlFormatOptions;
+type code_SvgSpriteResult = SvgSpriteResult;
+type code_SvgSpriteSymbol = SvgSpriteSymbol;
 type code_TestPatternResult = TestPatternResult;
 type code_TsconfigIssue = TsconfigIssue;
 type code_TsconfigValidationResult = TsconfigValidationResult;
+declare const code_analyzeRegexGroups: typeof analyzeRegexGroups;
 declare const code_auditDependencyRanges: typeof auditDependencyRanges;
 declare const code_buildDockerPull: typeof buildDockerPull;
 declare const code_buildDockerRun: typeof buildDockerRun;
@@ -588,6 +655,7 @@ declare const code_detectOperationType: typeof detectOperationType;
 declare const code_detectRedos: typeof detectRedos;
 declare const code_envToExport: typeof envToExport;
 declare const code_envToJson: typeof envToJson;
+declare const code_extractSvgSpriteSymbols: typeof extractSvgSpriteSymbols;
 declare const code_formatCss: typeof formatCss;
 declare const code_formatGql: typeof formatGql;
 declare const code_formatHtml: typeof formatHtml;
@@ -626,7 +694,7 @@ declare const code_validateEnvKey: typeof validateEnvKey;
 declare const code_validatePackageExports: typeof validatePackageExports;
 declare const code_validateTsconfig: typeof validateTsconfig;
 declare namespace code {
-  export { code_ALL_FLAGS as ALL_FLAGS, type code_ApiEndpoint as ApiEndpoint, type code_ApiInfo as ApiInfo, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_ConventionalCommitFinding as ConventionalCommitFinding, type code_ConventionalCommitFooter as ConventionalCommitFooter, type code_ConventionalCommitOptions as ConventionalCommitOptions, type code_ConventionalCommitParsed as ConventionalCommitParsed, type code_ConventionalCommitResult as ConventionalCommitResult, type code_ConventionalCommitSeverity as ConventionalCommitSeverity, type code_CssResult as CssResult, code_DEFAULT_COMMIT_TYPES as DEFAULT_COMMIT_TYPES, type code_DependencyAuditDuplicate as DependencyAuditDuplicate, type code_DependencyAuditEntry as DependencyAuditEntry, type code_DependencyAuditIssue as DependencyAuditIssue, type code_DependencyAuditResult as DependencyAuditResult, type code_DependencyRangeType as DependencyRangeType, type code_DependencySection as DependencySection, type code_DockerImageRef as DockerImageRef, type code_EditorConfigIssue as EditorConfigIssue, type code_EditorConfigProperty as EditorConfigProperty, type code_EditorConfigSection as EditorConfigSection, type code_EditorConfigValidationResult as EditorConfigValidationResult, type code_EnvEntry as EnvEntry, type code_EnvParseResult as EnvParseResult, type code_ExportsIssue as ExportsIssue, type code_ExportsShape as ExportsShape, type code_ExportsValidationResult as ExportsValidationResult, type code_GitCommandConfig as GitCommandConfig, type code_GitCommandResult as GitCommandResult, type code_GitOperation as GitOperation, type code_GithubUrlInfo as GithubUrlInfo, type code_GithubUrlType as GithubUrlType, type code_GitignoreTestResult as GitignoreTestResult, type code_GqlFormatResult as GqlFormatResult, type code_HtmlFormatResult as HtmlFormatResult, type code_HtmlMinifyOptions as HtmlMinifyOptions, type code_HtmlMinifyResult as HtmlMinifyResult, type code_JsMinifyOptions as JsMinifyOptions, type code_JsMinifyResult as JsMinifyResult, code_MIME_TABLE as MIME_TABLE, type code_MatchResult as MatchResult, type code_MimeEntry as MimeEntry, type code_MimeLookupResult as MimeLookupResult, code_OPERATIONS as OPERATIONS, type code_ParsedSpec as ParsedSpec, type code_RedosFinding as RedosFinding, type code_RedosResult as RedosResult, type code_RedosSeverity as RedosSeverity, type code_RegexError as RegexError, type code_RegexFlag as RegexFlag, type code_RegexMatch as RegexMatch, type code_RegexResult as RegexResult, type code_RegexSuccess as RegexSuccess, code_SQL_DEFAULT_OPTIONS as SQL_DEFAULT_OPTIONS, type code_Segment as Segment, type code_SpecVersion as SpecVersion, type code_SqlDialect as SqlDialect, type code_SqlFormatOptions as SqlFormatOptions, type code_TestPatternResult as TestPatternResult, type code_TsconfigIssue as TsconfigIssue, type code_TsconfigValidationResult as TsconfigValidationResult, code_auditDependencyRanges as auditDependencyRanges, code_buildDockerPull as buildDockerPull, code_buildDockerRun as buildDockerRun, code_buildGitCommand as buildGitCommand, code_collapseHtmlWhitespace as collapseHtmlWhitespace, code_collapseJsWhitespace as collapseJsWhitespace, code_countProperties as countProperties, code_countRules as countRules, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_detectRedos as detectRedos, code_envToExport as envToExport, code_envToJson as envToJson, code_formatCss as formatCss, code_formatGql as formatGql, code_formatHtml as formatHtml, code_formatSql as formatSql, code_getEndpointsByTag as getEndpointsByTag, code_getHtmlStats as getHtmlStats, code_getJsStats as getJsStats, code_getMethodColor as getMethodColor, code_isValidTag as isValidTag, code_lintConventionalCommit as lintConventionalCommit, code_lookupMime as lookupMime, code_minifyCss as minifyCss, code_minifyGql as minifyGql, code_minifyHtml as minifyHtml, code_minifyJs as minifyJs, code_minifySql as minifySql, code_normalizeRef as normalizeRef, code_parseDockerImage as parseDockerImage, code_parseEnv as parseEnv, code_parseGitCommand as parseGitCommand, code_parseGithubUrl as parseGithubUrl, code_parseSpec as parseSpec, code_removeConsoleCalls as removeConsoleCalls, code_removeEmptyAttributes as removeEmptyAttributes, code_removeHtmlComments as removeHtmlComments, code_removeJsComments as removeJsComments, code_removeRedundantAttributes as removeRedundantAttributes, code_searchCheatsheet as searchCheatsheet, code_searchEndpoints as searchEndpoints, code_splitStatements as splitStatements, code_testGitignorePatterns as testGitignorePatterns, code_testPattern as testPattern, code_testRegex as testRegex, code_validateEditorConfig as validateEditorConfig, code_validateEnvKey as validateEnvKey, code_validatePackageExports as validatePackageExports, code_validateTsconfig as validateTsconfig };
+  export { code_ALL_FLAGS as ALL_FLAGS, type code_ApiEndpoint as ApiEndpoint, type code_ApiInfo as ApiInfo, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_ConventionalCommitFinding as ConventionalCommitFinding, type code_ConventionalCommitFooter as ConventionalCommitFooter, type code_ConventionalCommitOptions as ConventionalCommitOptions, type code_ConventionalCommitParsed as ConventionalCommitParsed, type code_ConventionalCommitResult as ConventionalCommitResult, type code_ConventionalCommitSeverity as ConventionalCommitSeverity, type code_CssResult as CssResult, code_DEFAULT_COMMIT_TYPES as DEFAULT_COMMIT_TYPES, type code_DependencyAuditDuplicate as DependencyAuditDuplicate, type code_DependencyAuditEntry as DependencyAuditEntry, type code_DependencyAuditIssue as DependencyAuditIssue, type code_DependencyAuditResult as DependencyAuditResult, type code_DependencyRangeType as DependencyRangeType, type code_DependencySection as DependencySection, type code_DockerImageRef as DockerImageRef, type code_EditorConfigIssue as EditorConfigIssue, type code_EditorConfigProperty as EditorConfigProperty, type code_EditorConfigSection as EditorConfigSection, type code_EditorConfigValidationResult as EditorConfigValidationResult, type code_EnvEntry as EnvEntry, type code_EnvParseResult as EnvParseResult, type code_ExportsIssue as ExportsIssue, type code_ExportsShape as ExportsShape, type code_ExportsValidationResult as ExportsValidationResult, type code_GitCommandConfig as GitCommandConfig, type code_GitCommandResult as GitCommandResult, type code_GitOperation as GitOperation, type code_GithubUrlInfo as GithubUrlInfo, type code_GithubUrlType as GithubUrlType, type code_GitignoreTestResult as GitignoreTestResult, type code_GqlFormatResult as GqlFormatResult, type code_HtmlFormatResult as HtmlFormatResult, type code_HtmlMinifyOptions as HtmlMinifyOptions, type code_HtmlMinifyResult as HtmlMinifyResult, type code_JsMinifyOptions as JsMinifyOptions, type code_JsMinifyResult as JsMinifyResult, code_MIME_TABLE as MIME_TABLE, type code_MatchResult as MatchResult, type code_MimeEntry as MimeEntry, type code_MimeLookupResult as MimeLookupResult, code_OPERATIONS as OPERATIONS, type code_ParsedSpec as ParsedSpec, type code_RedosFinding as RedosFinding, type code_RedosResult as RedosResult, type code_RedosSeverity as RedosSeverity, type code_RegexBackreferenceInfo as RegexBackreferenceInfo, type code_RegexError as RegexError, type code_RegexFlag as RegexFlag, type code_RegexGroupAnalysis as RegexGroupAnalysis, type code_RegexGroupInfo as RegexGroupInfo, type code_RegexGroupIssue as RegexGroupIssue, type code_RegexMatch as RegexMatch, type code_RegexResult as RegexResult, type code_RegexSuccess as RegexSuccess, code_SQL_DEFAULT_OPTIONS as SQL_DEFAULT_OPTIONS, type code_Segment as Segment, type code_SpecVersion as SpecVersion, type code_SqlDialect as SqlDialect, type code_SqlFormatOptions as SqlFormatOptions, type code_SvgSpriteResult as SvgSpriteResult, type code_SvgSpriteSymbol as SvgSpriteSymbol, type code_TestPatternResult as TestPatternResult, type code_TsconfigIssue as TsconfigIssue, type code_TsconfigValidationResult as TsconfigValidationResult, code_analyzeRegexGroups as analyzeRegexGroups, code_auditDependencyRanges as auditDependencyRanges, code_buildDockerPull as buildDockerPull, code_buildDockerRun as buildDockerRun, code_buildGitCommand as buildGitCommand, code_collapseHtmlWhitespace as collapseHtmlWhitespace, code_collapseJsWhitespace as collapseJsWhitespace, code_countProperties as countProperties, code_countRules as countRules, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_detectRedos as detectRedos, code_envToExport as envToExport, code_envToJson as envToJson, code_extractSvgSpriteSymbols as extractSvgSpriteSymbols, code_formatCss as formatCss, code_formatGql as formatGql, code_formatHtml as formatHtml, code_formatSql as formatSql, code_getEndpointsByTag as getEndpointsByTag, code_getHtmlStats as getHtmlStats, code_getJsStats as getJsStats, code_getMethodColor as getMethodColor, code_isValidTag as isValidTag, code_lintConventionalCommit as lintConventionalCommit, code_lookupMime as lookupMime, code_minifyCss as minifyCss, code_minifyGql as minifyGql, code_minifyHtml as minifyHtml, code_minifyJs as minifyJs, code_minifySql as minifySql, code_normalizeRef as normalizeRef, code_parseDockerImage as parseDockerImage, code_parseEnv as parseEnv, code_parseGitCommand as parseGitCommand, code_parseGithubUrl as parseGithubUrl, code_parseSpec as parseSpec, code_removeConsoleCalls as removeConsoleCalls, code_removeEmptyAttributes as removeEmptyAttributes, code_removeHtmlComments as removeHtmlComments, code_removeJsComments as removeJsComments, code_removeRedundantAttributes as removeRedundantAttributes, code_searchCheatsheet as searchCheatsheet, code_searchEndpoints as searchEndpoints, code_splitStatements as splitStatements, code_testGitignorePatterns as testGitignorePatterns, code_testPattern as testPattern, code_testRegex as testRegex, code_validateEditorConfig as validateEditorConfig, code_validateEnvKey as validateEnvKey, code_validatePackageExports as validatePackageExports, code_validateTsconfig as validateTsconfig };
 }
 
-export { type RegexMatch as $, ALL_FLAGS as A, type GitCommandResult as B, CHEATSHEET as C, DEFAULT_COMMIT_TYPES as D, type EditorConfigIssue as E, type GitOperation as F, type GitCommandConfig as G, type GithubUrlInfo as H, type GithubUrlType as I, type GitignoreTestResult as J, type GqlFormatResult as K, type HtmlFormatResult as L, type HtmlMinifyOptions as M, type HtmlMinifyResult as N, type JsMinifyOptions as O, type JsMinifyResult as P, MIME_TABLE as Q, type MatchResult as R, type MimeEntry as S, type MimeLookupResult as T, OPERATIONS as U, type ParsedSpec as V, type RedosFinding as W, type RedosResult as X, type RedosSeverity as Y, type RegexError as Z, type RegexFlag as _, type ApiEndpoint as a, type RegexResult as a0, type RegexSuccess as a1, SQL_DEFAULT_OPTIONS as a2, type Segment as a3, type SpecVersion as a4, type SqlDialect as a5, type SqlFormatOptions as a6, type TestPatternResult as a7, type TsconfigIssue as a8, type TsconfigValidationResult as a9, minifyHtml as aA, minifyJs as aB, minifySql as aC, normalizeRef as aD, parseDockerImage as aE, parseEnv as aF, parseGitCommand as aG, parseGithubUrl as aH, parseSpec as aI, removeConsoleCalls as aJ, removeEmptyAttributes as aK, removeHtmlComments as aL, removeJsComments as aM, removeRedundantAttributes as aN, searchCheatsheet as aO, searchEndpoints as aP, splitStatements as aQ, testGitignorePatterns as aR, testPattern as aS, testRegex as aT, validateEditorConfig as aU, validateEnvKey as aV, validatePackageExports as aW, validateTsconfig as aX, auditDependencyRanges as aa, buildDockerPull as ab, buildDockerRun as ac, buildGitCommand as ad, collapseHtmlWhitespace as ae, collapseJsWhitespace as af, countProperties as ag, countRules as ah, detectDialect as ai, detectOperationType as aj, detectRedos as ak, envToExport as al, envToJson as am, formatCss as an, formatGql as ao, formatHtml as ap, formatSql as aq, getEndpointsByTag as ar, getHtmlStats as as, getJsStats as at, getMethodColor as au, isValidTag as av, lintConventionalCommit as aw, lookupMime as ax, minifyCss as ay, minifyGql as az, type ApiInfo as b, code as c, type CheatsheetEntry as d, type ConventionalCommitFinding as e, type ConventionalCommitFooter as f, type ConventionalCommitOptions as g, type ConventionalCommitParsed as h, type ConventionalCommitResult as i, type ConventionalCommitSeverity as j, type CssResult as k, type DependencyAuditDuplicate as l, type DependencyAuditEntry as m, type DependencyAuditIssue as n, type DependencyAuditResult as o, type DependencyRangeType as p, type DependencySection as q, type DockerImageRef as r, type EditorConfigProperty as s, type EditorConfigSection as t, type EditorConfigValidationResult as u, type EnvEntry as v, type EnvParseResult as w, type ExportsIssue as x, type ExportsShape as y, type ExportsValidationResult as z };
+export { type RegexFlag as $, ALL_FLAGS as A, type GitCommandResult as B, CHEATSHEET as C, DEFAULT_COMMIT_TYPES as D, type EditorConfigIssue as E, type GitOperation as F, type GitCommandConfig as G, type GithubUrlInfo as H, type GithubUrlType as I, type GitignoreTestResult as J, type GqlFormatResult as K, type HtmlFormatResult as L, type HtmlMinifyOptions as M, type HtmlMinifyResult as N, type JsMinifyOptions as O, type JsMinifyResult as P, MIME_TABLE as Q, type MatchResult as R, type MimeEntry as S, type MimeLookupResult as T, OPERATIONS as U, type ParsedSpec as V, type RedosFinding as W, type RedosResult as X, type RedosSeverity as Y, type RegexBackreferenceInfo as Z, type RegexError as _, type ApiEndpoint as a, testRegex as a$, type RegexGroupAnalysis as a0, type RegexGroupInfo as a1, type RegexGroupIssue as a2, type RegexMatch as a3, type RegexResult as a4, type RegexSuccess as a5, SQL_DEFAULT_OPTIONS as a6, type Segment as a7, type SpecVersion as a8, type SqlDialect as a9, getHtmlStats as aA, getJsStats as aB, getMethodColor as aC, isValidTag as aD, lintConventionalCommit as aE, lookupMime as aF, minifyCss as aG, minifyGql as aH, minifyHtml as aI, minifyJs as aJ, minifySql as aK, normalizeRef as aL, parseDockerImage as aM, parseEnv as aN, parseGitCommand as aO, parseGithubUrl as aP, parseSpec as aQ, removeConsoleCalls as aR, removeEmptyAttributes as aS, removeHtmlComments as aT, removeJsComments as aU, removeRedundantAttributes as aV, searchCheatsheet as aW, searchEndpoints as aX, splitStatements as aY, testGitignorePatterns as aZ, testPattern as a_, type SqlFormatOptions as aa, type SvgSpriteResult as ab, type SvgSpriteSymbol as ac, type TestPatternResult as ad, type TsconfigIssue as ae, type TsconfigValidationResult as af, analyzeRegexGroups as ag, auditDependencyRanges as ah, buildDockerPull as ai, buildDockerRun as aj, buildGitCommand as ak, collapseHtmlWhitespace as al, collapseJsWhitespace as am, countProperties as an, countRules as ao, detectDialect as ap, detectOperationType as aq, detectRedos as ar, envToExport as as, envToJson as at, extractSvgSpriteSymbols as au, formatCss as av, formatGql as aw, formatHtml as ax, formatSql as ay, getEndpointsByTag as az, type ApiInfo as b, validateEditorConfig as b0, validateEnvKey as b1, validatePackageExports as b2, validateTsconfig as b3, code as c, type CheatsheetEntry as d, type ConventionalCommitFinding as e, type ConventionalCommitFooter as f, type ConventionalCommitOptions as g, type ConventionalCommitParsed as h, type ConventionalCommitResult as i, type ConventionalCommitSeverity as j, type CssResult as k, type DependencyAuditDuplicate as l, type DependencyAuditEntry as m, type DependencyAuditIssue as n, type DependencyAuditResult as o, type DependencyRangeType as p, type DependencySection as q, type DockerImageRef as r, type EditorConfigProperty as s, type EditorConfigSection as t, type EditorConfigValidationResult as u, type EnvEntry as v, type EnvParseResult as w, type ExportsIssue as x, type ExportsShape as y, type ExportsValidationResult as z };

package/dist/{code-CKI2Z_NM.d.ts → code-DB-5ZfG4.d.ts}

@@ -26,6 +26,8 @@
  *   - tsconfig-validator (validateTsconfig)
  *   - package-json-exports-validator (validatePackageExports)
  *   - package-json-dependency-auditor (auditDependencyRanges)
+ *   - regex-groups     (analyzeRegexGroups)
+ *   - svg-sprite-symbol-extractor (extractSvgSpriteSymbols)
  */
 type RegexFlag = 'g' | 'i' | 'm' | 's' | 'u';
 declare const ALL_FLAGS: RegexFlag[];
@@ -511,6 +513,64 @@ interface DependencyAuditResult {
 declare function auditDependencyRanges(packageJsonText: string): DependencyAuditResult | {
     error: string;
 };
+interface RegexGroupInfo {
+    index: number;
+    name: string | null;
+    start: number;
+    end: number;
+}
+interface RegexBackreferenceInfo {
+    raw: string;
+    target: number | string;
+    start: number;
+    resolved: boolean;
+    definedBeforeUse: boolean;
+}
+interface RegexGroupIssue {
+    severity: 'error' | 'warning';
+    message: string;
+}
+interface RegexGroupAnalysis {
+    pattern: string;
+    valid: boolean;
+    compileError?: string;
+    groups: RegexGroupInfo[];
+    backreferences: RegexBackreferenceInfo[];
+    issues: RegexGroupIssue[];
+}
+/**
+ * Parse a regex pattern's capture groups (numbered and named) and
+ * backreferences, and flag any backreference that points at a group which
+ * doesn't exist or hasn't finished being defined yet at that point in the
+ * pattern (a forward reference or a self-reference). Pass the pattern body
+ * only, no delimiters or flags. This is a structural, non-AI check, distinct
+ * from the ReDoS Detector (backtracking risk) and Regex Explainer (AI)
+ * (plain-English breakdown).
+ */
+declare function analyzeRegexGroups(pattern: string): RegexGroupAnalysis;
+interface SvgSpriteSymbol {
+    id: string;
+    viewBox: string | null;
+    width: string | null;
+    height: string | null;
+    usageSnippet: string;
+}
+interface SvgSpriteResult {
+    symbolCount: number;
+    symbols: SvgSpriteSymbol[];
+    skippedCount: number;
+}
+/**
+ * Parse an SVG sprite sheet's <symbol> definitions and list each one's id,
+ * viewBox, width, and height, alongside a ready-to-paste
+ * `<use href="#id"></use>` usage snippet. A symbol with no id is skipped
+ * (counted in skippedCount) since it can't be referenced by a `<use>`
+ * element at all. Pure regex-based parsing over the raw markup, no DOM/XML
+ * parser dependency, matching the SVG Viewer tool's parsing style.
+ */
+declare function extractSvgSpriteSymbols(svg: string): SvgSpriteResult | {
+    error: string;
+};
 
 declare const code_ALL_FLAGS: typeof ALL_FLAGS;
 type code_ApiEndpoint = ApiEndpoint;
@@ -562,8 +622,12 @@ type code_ParsedSpec = ParsedSpec;
 type code_RedosFinding = RedosFinding;
 type code_RedosResult = RedosResult;
 type code_RedosSeverity = RedosSeverity;
+type code_RegexBackreferenceInfo = RegexBackreferenceInfo;
 type code_RegexError = RegexError;
 type code_RegexFlag = RegexFlag;
+type code_RegexGroupAnalysis = RegexGroupAnalysis;
+type code_RegexGroupInfo = RegexGroupInfo;
+type code_RegexGroupIssue = RegexGroupIssue;
 type code_RegexMatch = RegexMatch;
 type code_RegexResult = RegexResult;
 type code_RegexSuccess = RegexSuccess;
@@ -572,9 +636,12 @@ type code_Segment = Segment;
 type code_SpecVersion = SpecVersion;
 type code_SqlDialect = SqlDialect;
 type code_SqlFormatOptions = SqlFormatOptions;
+type code_SvgSpriteResult = SvgSpriteResult;
+type code_SvgSpriteSymbol = SvgSpriteSymbol;
 type code_TestPatternResult = TestPatternResult;
 type code_TsconfigIssue = TsconfigIssue;
 type code_TsconfigValidationResult = TsconfigValidationResult;
+declare const code_analyzeRegexGroups: typeof analyzeRegexGroups;
 declare const code_auditDependencyRanges: typeof auditDependencyRanges;
 declare const code_buildDockerPull: typeof buildDockerPull;
 declare const code_buildDockerRun: typeof buildDockerRun;
@@ -588,6 +655,7 @@ declare const code_detectOperationType: typeof detectOperationType;
 declare const code_detectRedos: typeof detectRedos;
 declare const code_envToExport: typeof envToExport;
 declare const code_envToJson: typeof envToJson;
+declare const code_extractSvgSpriteSymbols: typeof extractSvgSpriteSymbols;
 declare const code_formatCss: typeof formatCss;
 declare const code_formatGql: typeof formatGql;
 declare const code_formatHtml: typeof formatHtml;
@@ -626,7 +694,7 @@ declare const code_validateEnvKey: typeof validateEnvKey;
 declare const code_validatePackageExports: typeof validatePackageExports;
 declare const code_validateTsconfig: typeof validateTsconfig;
 declare namespace code {
-  export { code_ALL_FLAGS as ALL_FLAGS, type code_ApiEndpoint as ApiEndpoint, type code_ApiInfo as ApiInfo, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_ConventionalCommitFinding as ConventionalCommitFinding, type code_ConventionalCommitFooter as ConventionalCommitFooter, type code_ConventionalCommitOptions as ConventionalCommitOptions, type code_ConventionalCommitParsed as ConventionalCommitParsed, type code_ConventionalCommitResult as ConventionalCommitResult, type code_ConventionalCommitSeverity as ConventionalCommitSeverity, type code_CssResult as CssResult, code_DEFAULT_COMMIT_TYPES as DEFAULT_COMMIT_TYPES, type code_DependencyAuditDuplicate as DependencyAuditDuplicate, type code_DependencyAuditEntry as DependencyAuditEntry, type code_DependencyAuditIssue as DependencyAuditIssue, type code_DependencyAuditResult as DependencyAuditResult, type code_DependencyRangeType as DependencyRangeType, type code_DependencySection as DependencySection, type code_DockerImageRef as DockerImageRef, type code_EditorConfigIssue as EditorConfigIssue, type code_EditorConfigProperty as EditorConfigProperty, type code_EditorConfigSection as EditorConfigSection, type code_EditorConfigValidationResult as EditorConfigValidationResult, type code_EnvEntry as EnvEntry, type code_EnvParseResult as EnvParseResult, type code_ExportsIssue as ExportsIssue, type code_ExportsShape as ExportsShape, type code_ExportsValidationResult as ExportsValidationResult, type code_GitCommandConfig as GitCommandConfig, type code_GitCommandResult as GitCommandResult, type code_GitOperation as GitOperation, type code_GithubUrlInfo as GithubUrlInfo, type code_GithubUrlType as GithubUrlType, type code_GitignoreTestResult as GitignoreTestResult, type code_GqlFormatResult as GqlFormatResult, type code_HtmlFormatResult as HtmlFormatResult, type code_HtmlMinifyOptions as HtmlMinifyOptions, type code_HtmlMinifyResult as HtmlMinifyResult, type code_JsMinifyOptions as JsMinifyOptions, type code_JsMinifyResult as JsMinifyResult, code_MIME_TABLE as MIME_TABLE, type code_MatchResult as MatchResult, type code_MimeEntry as MimeEntry, type code_MimeLookupResult as MimeLookupResult, code_OPERATIONS as OPERATIONS, type code_ParsedSpec as ParsedSpec, type code_RedosFinding as RedosFinding, type code_RedosResult as RedosResult, type code_RedosSeverity as RedosSeverity, type code_RegexError as RegexError, type code_RegexFlag as RegexFlag, type code_RegexMatch as RegexMatch, type code_RegexResult as RegexResult, type code_RegexSuccess as RegexSuccess, code_SQL_DEFAULT_OPTIONS as SQL_DEFAULT_OPTIONS, type code_Segment as Segment, type code_SpecVersion as SpecVersion, type code_SqlDialect as SqlDialect, type code_SqlFormatOptions as SqlFormatOptions, type code_TestPatternResult as TestPatternResult, type code_TsconfigIssue as TsconfigIssue, type code_TsconfigValidationResult as TsconfigValidationResult, code_auditDependencyRanges as auditDependencyRanges, code_buildDockerPull as buildDockerPull, code_buildDockerRun as buildDockerRun, code_buildGitCommand as buildGitCommand, code_collapseHtmlWhitespace as collapseHtmlWhitespace, code_collapseJsWhitespace as collapseJsWhitespace, code_countProperties as countProperties, code_countRules as countRules, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_detectRedos as detectRedos, code_envToExport as envToExport, code_envToJson as envToJson, code_formatCss as formatCss, code_formatGql as formatGql, code_formatHtml as formatHtml, code_formatSql as formatSql, code_getEndpointsByTag as getEndpointsByTag, code_getHtmlStats as getHtmlStats, code_getJsStats as getJsStats, code_getMethodColor as getMethodColor, code_isValidTag as isValidTag, code_lintConventionalCommit as lintConventionalCommit, code_lookupMime as lookupMime, code_minifyCss as minifyCss, code_minifyGql as minifyGql, code_minifyHtml as minifyHtml, code_minifyJs as minifyJs, code_minifySql as minifySql, code_normalizeRef as normalizeRef, code_parseDockerImage as parseDockerImage, code_parseEnv as parseEnv, code_parseGitCommand as parseGitCommand, code_parseGithubUrl as parseGithubUrl, code_parseSpec as parseSpec, code_removeConsoleCalls as removeConsoleCalls, code_removeEmptyAttributes as removeEmptyAttributes, code_removeHtmlComments as removeHtmlComments, code_removeJsComments as removeJsComments, code_removeRedundantAttributes as removeRedundantAttributes, code_searchCheatsheet as searchCheatsheet, code_searchEndpoints as searchEndpoints, code_splitStatements as splitStatements, code_testGitignorePatterns as testGitignorePatterns, code_testPattern as testPattern, code_testRegex as testRegex, code_validateEditorConfig as validateEditorConfig, code_validateEnvKey as validateEnvKey, code_validatePackageExports as validatePackageExports, code_validateTsconfig as validateTsconfig };
+  export { code_ALL_FLAGS as ALL_FLAGS, type code_ApiEndpoint as ApiEndpoint, type code_ApiInfo as ApiInfo, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_ConventionalCommitFinding as ConventionalCommitFinding, type code_ConventionalCommitFooter as ConventionalCommitFooter, type code_ConventionalCommitOptions as ConventionalCommitOptions, type code_ConventionalCommitParsed as ConventionalCommitParsed, type code_ConventionalCommitResult as ConventionalCommitResult, type code_ConventionalCommitSeverity as ConventionalCommitSeverity, type code_CssResult as CssResult, code_DEFAULT_COMMIT_TYPES as DEFAULT_COMMIT_TYPES, type code_DependencyAuditDuplicate as DependencyAuditDuplicate, type code_DependencyAuditEntry as DependencyAuditEntry, type code_DependencyAuditIssue as DependencyAuditIssue, type code_DependencyAuditResult as DependencyAuditResult, type code_DependencyRangeType as DependencyRangeType, type code_DependencySection as DependencySection, type code_DockerImageRef as DockerImageRef, type code_EditorConfigIssue as EditorConfigIssue, type code_EditorConfigProperty as EditorConfigProperty, type code_EditorConfigSection as EditorConfigSection, type code_EditorConfigValidationResult as EditorConfigValidationResult, type code_EnvEntry as EnvEntry, type code_EnvParseResult as EnvParseResult, type code_ExportsIssue as ExportsIssue, type code_ExportsShape as ExportsShape, type code_ExportsValidationResult as ExportsValidationResult, type code_GitCommandConfig as GitCommandConfig, type code_GitCommandResult as GitCommandResult, type code_GitOperation as GitOperation, type code_GithubUrlInfo as GithubUrlInfo, type code_GithubUrlType as GithubUrlType, type code_GitignoreTestResult as GitignoreTestResult, type code_GqlFormatResult as GqlFormatResult, type code_HtmlFormatResult as HtmlFormatResult, type code_HtmlMinifyOptions as HtmlMinifyOptions, type code_HtmlMinifyResult as HtmlMinifyResult, type code_JsMinifyOptions as JsMinifyOptions, type code_JsMinifyResult as JsMinifyResult, code_MIME_TABLE as MIME_TABLE, type code_MatchResult as MatchResult, type code_MimeEntry as MimeEntry, type code_MimeLookupResult as MimeLookupResult, code_OPERATIONS as OPERATIONS, type code_ParsedSpec as ParsedSpec, type code_RedosFinding as RedosFinding, type code_RedosResult as RedosResult, type code_RedosSeverity as RedosSeverity, type code_RegexBackreferenceInfo as RegexBackreferenceInfo, type code_RegexError as RegexError, type code_RegexFlag as RegexFlag, type code_RegexGroupAnalysis as RegexGroupAnalysis, type code_RegexGroupInfo as RegexGroupInfo, type code_RegexGroupIssue as RegexGroupIssue, type code_RegexMatch as RegexMatch, type code_RegexResult as RegexResult, type code_RegexSuccess as RegexSuccess, code_SQL_DEFAULT_OPTIONS as SQL_DEFAULT_OPTIONS, type code_Segment as Segment, type code_SpecVersion as SpecVersion, type code_SqlDialect as SqlDialect, type code_SqlFormatOptions as SqlFormatOptions, type code_SvgSpriteResult as SvgSpriteResult, type code_SvgSpriteSymbol as SvgSpriteSymbol, type code_TestPatternResult as TestPatternResult, type code_TsconfigIssue as TsconfigIssue, type code_TsconfigValidationResult as TsconfigValidationResult, code_analyzeRegexGroups as analyzeRegexGroups, code_auditDependencyRanges as auditDependencyRanges, code_buildDockerPull as buildDockerPull, code_buildDockerRun as buildDockerRun, code_buildGitCommand as buildGitCommand, code_collapseHtmlWhitespace as collapseHtmlWhitespace, code_collapseJsWhitespace as collapseJsWhitespace, code_countProperties as countProperties, code_countRules as countRules, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_detectRedos as detectRedos, code_envToExport as envToExport, code_envToJson as envToJson, code_extractSvgSpriteSymbols as extractSvgSpriteSymbols, code_formatCss as formatCss, code_formatGql as formatGql, code_formatHtml as formatHtml, code_formatSql as formatSql, code_getEndpointsByTag as getEndpointsByTag, code_getHtmlStats as getHtmlStats, code_getJsStats as getJsStats, code_getMethodColor as getMethodColor, code_isValidTag as isValidTag, code_lintConventionalCommit as lintConventionalCommit, code_lookupMime as lookupMime, code_minifyCss as minifyCss, code_minifyGql as minifyGql, code_minifyHtml as minifyHtml, code_minifyJs as minifyJs, code_minifySql as minifySql, code_normalizeRef as normalizeRef, code_parseDockerImage as parseDockerImage, code_parseEnv as parseEnv, code_parseGitCommand as parseGitCommand, code_parseGithubUrl as parseGithubUrl, code_parseSpec as parseSpec, code_removeConsoleCalls as removeConsoleCalls, code_removeEmptyAttributes as removeEmptyAttributes, code_removeHtmlComments as removeHtmlComments, code_removeJsComments as removeJsComments, code_removeRedundantAttributes as removeRedundantAttributes, code_searchCheatsheet as searchCheatsheet, code_searchEndpoints as searchEndpoints, code_splitStatements as splitStatements, code_testGitignorePatterns as testGitignorePatterns, code_testPattern as testPattern, code_testRegex as testRegex, code_validateEditorConfig as validateEditorConfig, code_validateEnvKey as validateEnvKey, code_validatePackageExports as validatePackageExports, code_validateTsconfig as validateTsconfig };
 }
 
-export { type RegexMatch as $, ALL_FLAGS as A, type GitCommandResult as B, CHEATSHEET as C, DEFAULT_COMMIT_TYPES as D, type EditorConfigIssue as E, type GitOperation as F, type GitCommandConfig as G, type GithubUrlInfo as H, type GithubUrlType as I, type GitignoreTestResult as J, type GqlFormatResult as K, type HtmlFormatResult as L, type HtmlMinifyOptions as M, type HtmlMinifyResult as N, type JsMinifyOptions as O, type JsMinifyResult as P, MIME_TABLE as Q, type MatchResult as R, type MimeEntry as S, type MimeLookupResult as T, OPERATIONS as U, type ParsedSpec as V, type RedosFinding as W, type RedosResult as X, type RedosSeverity as Y, type RegexError as Z, type RegexFlag as _, type ApiEndpoint as a, type RegexResult as a0, type RegexSuccess as a1, SQL_DEFAULT_OPTIONS as a2, type Segment as a3, type SpecVersion as a4, type SqlDialect as a5, type SqlFormatOptions as a6, type TestPatternResult as a7, type TsconfigIssue as a8, type TsconfigValidationResult as a9, minifyHtml as aA, minifyJs as aB, minifySql as aC, normalizeRef as aD, parseDockerImage as aE, parseEnv as aF, parseGitCommand as aG, parseGithubUrl as aH, parseSpec as aI, removeConsoleCalls as aJ, removeEmptyAttributes as aK, removeHtmlComments as aL, removeJsComments as aM, removeRedundantAttributes as aN, searchCheatsheet as aO, searchEndpoints as aP, splitStatements as aQ, testGitignorePatterns as aR, testPattern as aS, testRegex as aT, validateEditorConfig as aU, validateEnvKey as aV, validatePackageExports as aW, validateTsconfig as aX, auditDependencyRanges as aa, buildDockerPull as ab, buildDockerRun as ac, buildGitCommand as ad, collapseHtmlWhitespace as ae, collapseJsWhitespace as af, countProperties as ag, countRules as ah, detectDialect as ai, detectOperationType as aj, detectRedos as ak, envToExport as al, envToJson as am, formatCss as an, formatGql as ao, formatHtml as ap, formatSql as aq, getEndpointsByTag as ar, getHtmlStats as as, getJsStats as at, getMethodColor as au, isValidTag as av, lintConventionalCommit as aw, lookupMime as ax, minifyCss as ay, minifyGql as az, type ApiInfo as b, code as c, type CheatsheetEntry as d, type ConventionalCommitFinding as e, type ConventionalCommitFooter as f, type ConventionalCommitOptions as g, type ConventionalCommitParsed as h, type ConventionalCommitResult as i, type ConventionalCommitSeverity as j, type CssResult as k, type DependencyAuditDuplicate as l, type DependencyAuditEntry as m, type DependencyAuditIssue as n, type DependencyAuditResult as o, type DependencyRangeType as p, type DependencySection as q, type DockerImageRef as r, type EditorConfigProperty as s, type EditorConfigSection as t, type EditorConfigValidationResult as u, type EnvEntry as v, type EnvParseResult as w, type ExportsIssue as x, type ExportsShape as y, type ExportsValidationResult as z };
+export { type RegexFlag as $, ALL_FLAGS as A, type GitCommandResult as B, CHEATSHEET as C, DEFAULT_COMMIT_TYPES as D, type EditorConfigIssue as E, type GitOperation as F, type GitCommandConfig as G, type GithubUrlInfo as H, type GithubUrlType as I, type GitignoreTestResult as J, type GqlFormatResult as K, type HtmlFormatResult as L, type HtmlMinifyOptions as M, type HtmlMinifyResult as N, type JsMinifyOptions as O, type JsMinifyResult as P, MIME_TABLE as Q, type MatchResult as R, type MimeEntry as S, type MimeLookupResult as T, OPERATIONS as U, type ParsedSpec as V, type RedosFinding as W, type RedosResult as X, type RedosSeverity as Y, type RegexBackreferenceInfo as Z, type RegexError as _, type ApiEndpoint as a, testRegex as a$, type RegexGroupAnalysis as a0, type RegexGroupInfo as a1, type RegexGroupIssue as a2, type RegexMatch as a3, type RegexResult as a4, type RegexSuccess as a5, SQL_DEFAULT_OPTIONS as a6, type Segment as a7, type SpecVersion as a8, type SqlDialect as a9, getHtmlStats as aA, getJsStats as aB, getMethodColor as aC, isValidTag as aD, lintConventionalCommit as aE, lookupMime as aF, minifyCss as aG, minifyGql as aH, minifyHtml as aI, minifyJs as aJ, minifySql as aK, normalizeRef as aL, parseDockerImage as aM, parseEnv as aN, parseGitCommand as aO, parseGithubUrl as aP, parseSpec as aQ, removeConsoleCalls as aR, removeEmptyAttributes as aS, removeHtmlComments as aT, removeJsComments as aU, removeRedundantAttributes as aV, searchCheatsheet as aW, searchEndpoints as aX, splitStatements as aY, testGitignorePatterns as aZ, testPattern as a_, type SqlFormatOptions as aa, type SvgSpriteResult as ab, type SvgSpriteSymbol as ac, type TestPatternResult as ad, type TsconfigIssue as ae, type TsconfigValidationResult as af, analyzeRegexGroups as ag, auditDependencyRanges as ah, buildDockerPull as ai, buildDockerRun as aj, buildGitCommand as ak, collapseHtmlWhitespace as al, collapseJsWhitespace as am, countProperties as an, countRules as ao, detectDialect as ap, detectOperationType as aq, detectRedos as ar, envToExport as as, envToJson as at, extractSvgSpriteSymbols as au, formatCss as av, formatGql as aw, formatHtml as ax, formatSql as ay, getEndpointsByTag as az, type ApiInfo as b, validateEditorConfig as b0, validateEnvKey as b1, validatePackageExports as b2, validateTsconfig as b3, code as c, type CheatsheetEntry as d, type ConventionalCommitFinding as e, type ConventionalCommitFooter as f, type ConventionalCommitOptions as g, type ConventionalCommitParsed as h, type ConventionalCommitResult as i, type ConventionalCommitSeverity as j, type CssResult as k, type DependencyAuditDuplicate as l, type DependencyAuditEntry as m, type DependencyAuditIssue as n, type DependencyAuditResult as o, type DependencyRangeType as p, type DependencySection as q, type DockerImageRef as r, type EditorConfigProperty as s, type EditorConfigSection as t, type EditorConfigValidationResult as u, type EnvEntry as v, type EnvParseResult as w, type ExportsIssue as x, type ExportsShape as y, type ExportsValidationResult as z };