@utilix-tech/sdk 0.81.0 → 0.83.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.83.0
+- Add `extractMarkdownLinkReferences` (markdown-link-reference-extractor): extract reference-style Markdown links (`[text][ref]`, the `[text][]` shortcut, and `![alt][ref]` image references) and match them against their `[ref]: url` definitions, flagging unresolved references and unused definitions.
+- Add `extractPromptTemplateVariables` (prompt-template-variable-extractor): extract `{{variable}}`-style placeholders from a prompt template, report occurrence counts, flag duplicates, and optionally cross-check against a list of provided variable names.
+
+## 0.82.0
+- Add `generateRobotsTxt` (robots-txt-generator): build a robots.txt file from User-agent groups with Allow/Disallow rules and an optional Crawl-delay, plus a list of Sitemap URLs. The generator-side sibling of `validateRobotsTxt`.
+
 ## 0.81.0
 - Add `validateFenceLanguageTags` (markdown-fence-lang-validator): scan a Markdown document's fenced code blocks and flag a missing, unknown, or inconsistently-cased language tag against a curated list of common syntax-highlighter identifiers.
 - Add `countSqlPlaceholders` (sql-placeholder-counter): count positional (`?`, `$1`) and named (`:name`, `@name`) parameter placeholders in a SQL query, flagging mixed styles and numbered-sequence gaps or duplicates.

package/README.md

@@ -1,6 +1,6 @@
 # @utilix-tech/sdk
 
-**715 developer utility functions for Node.js: runs locally, no API key required.**
+**718 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)
@@ -550,7 +550,7 @@ calculateRealRateOfReturn({ nominalRatePercent: 5, inflationRatePercent: 2 });
 ```ts
 import { getStatusCode, isValidIp, isValidIpv4, isValidIpv6,
          searchStatusCodes, buildGeoUrl, countryCodeToFlag,
-         parseHar, validateSitemap, splitSitemap, validateRobotsTxt,
+         parseHar, validateSitemap, splitSitemap, validateRobotsTxt, generateRobotsTxt,
          parseUserAgent, buildCacheControl, buildReferrerPolicy, parseIpv6Address, buildLinkHeader, checkSetCookieHeader, analyzeEmailHeaders,
          buildRangeHeader, parseContentRangeHeader, buildVaryHeader, parseVaryHeader, validateManifest,
          buildPermissionsPolicy, parsePermissionsPolicy, buildClientHints, parseClientHintHeaders,
@@ -594,6 +594,10 @@ splitSitemap("https://example.com/a\nhttps://example.com/b\nhttps://example.com/
 validateRobotsTxt("User-agent: *\nDisallow: /admin\nSitemap: https://example.com/sitemap.xml");
 // { groups: [...], sitemaps: [...], issues: [...], valid: true }
 
+// Generate a robots.txt file from User-agent groups + sitemap URLs (the inverse of validateRobotsTxt)
+generateRobotsTxt({ groups: [{ userAgents: ["*"], disallow: ["/admin"] }], sitemaps: ["https://example.com/sitemap.xml"] });
+// { text: "User-agent: *\nDisallow: /admin\n\nSitemap: https://example.com/sitemap.xml\n" }
+
 // Build and explain a Cache-Control response header from directives
 buildCacheControl({ visibility: "public", maxAge: 3600, mustRevalidate: true });
 // { header: "public, max-age=3600, must-revalidate", directives: [...], warnings: [] }
@@ -873,6 +877,11 @@ extractMarkdownFootnotes("A claim[^1].\n\n[^1]: The source.");
 import { validateAria } from "@utilix-tech/sdk/code";
 validateAria('<div role="checkbox">Opt in</div>');
 // { elementCount: 1, elementsWithRoleOrAria: 1, valid: false, issues: [{ severity: "error", message: 'role="checkbox" is missing required attribute aria-checked', ... }] }
+
+// Extract reference-style Markdown links ([text][ref], [text][], ![alt][ref]) and match them against [ref]: url definitions
+import { extractMarkdownLinkReferences } from "@utilix-tech/sdk/code";
+extractMarkdownLinkReferences("See the [docs][api-ref].\n\n[api-ref]: https://example.com/api \"API Reference\"");
+// { referenceCount: 1, definitionCount: 1, resolved: [{ text: "docs", label: "api-ref", image: false, url: "https://example.com/api", title: "API Reference" }], unresolvedReferences: [], unusedDefinitions: [] }
 ```
 
 ---
@@ -1044,13 +1053,13 @@ readMidiInfo(new Uint8Array(midiBytes));
 | `@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/VIN/ISIN 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, tax-equivalent yield calculator, mortgage discount points break-even calculator, loan prepayment penalty calculator, data transfer time / required bandwidth estimator, real rate of return (Fisher equation) calculator |
-| `@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, Cookie header byte-size budget calculator |
+| `@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, robots.txt validator, robots.txt generator, 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, Cookie header byte-size budget calculator |
 | `@utilix-tech/sdk/api` | cURL build/parse, JWT decode/sign, JWKS parse, CORS headers, CSP header, TOTP/HOTP code generator, webhook HMAC signature verifier |
-| `@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, ARIA role & attribute validator, database connection string parser, Markdown code fence language tag validator, SQL query parameter placeholder counter |
+| `@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, ARIA role & attribute validator, database connection string parser, Markdown code fence language tag validator, SQL query parameter placeholder counter, Markdown link reference 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 |
-| `@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, vector similarity, few-shot prompt formatter, tool-definition schema linter, retry/backoff schedule calculator |
+| `@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, vector similarity, few-shot prompt formatter, tool-definition schema linter, retry/backoff schedule calculator, prompt template variable extractor |
 | `@utilix-tech/sdk/media` | Image format & dimension reading from raw bytes (PNG, JPEG, GIF, WebP, BMP); PDF metadata reading; PDF page dimension/orientation listing; WAV audio info; ID3 tags; ICO favicon inspection; FLAC metadata reading; MP4/WebM video info; GIF frame/loop inspection |
 
 ---

package/dist/{ai_agent-DeCy0oZK.d.cts → ai_agent-B9wWLBDf.d.cts}

@@ -409,6 +409,30 @@ interface RetryBackoffResult {
 declare function calculateRetryBackoffSchedule(input: RetryBackoffInput): RetryBackoffResult | {
     error: string;
 };
+interface PromptTemplateVariable {
+    name: string;
+    count: number;
+}
+interface PromptTemplateVariableResult {
+    variableCount: number;
+    variables: PromptTemplateVariable[];
+    duplicates: string[];
+    missing: string[];
+    unused: string[];
+}
+/**
+ * Extract every {{variable}}-style placeholder from a prompt template,
+ * reporting each unique variable's occurrence count and flagging ones used
+ * more than once. When providedVars is given, also cross-checks the
+ * template against it: variables the template uses but providedVars is
+ * missing, and names in providedVars the template never references. Only
+ * double-curly {{name}} syntax is recognized (dotted/dashed names like
+ * {{user.name}} are allowed); single-brace, triple-brace, and Jinja-style
+ * {% %} tags are out of scope.
+ */
+declare function extractPromptTemplateVariables(template: string, providedVars?: string[]): PromptTemplateVariableResult | {
+    error: string;
+};
 
 type ai_agent_ChunkStrategy = ChunkStrategy;
 type ai_agent_CompressHtmlResult = CompressHtmlResult;
@@ -440,6 +464,8 @@ type ai_agent_ModelPricing = ModelPricing;
 type ai_agent_PiiDetectResult = PiiDetectResult;
 type ai_agent_PiiFinding = PiiFinding;
 type ai_agent_PiiType = PiiType;
+type ai_agent_PromptTemplateVariable = PromptTemplateVariable;
+type ai_agent_PromptTemplateVariableResult = PromptTemplateVariableResult;
 type ai_agent_RankedChunk = RankedChunk;
 type ai_agent_RelevanceResult = RelevanceResult;
 type ai_agent_RetryBackoffAttempt = RetryBackoffAttempt;
@@ -479,6 +505,7 @@ declare const ai_agent_expandQuery: typeof expandQuery;
 declare const ai_agent_extractEntities: typeof extractEntities;
 declare const ai_agent_extractJson: typeof extractJson;
 declare const ai_agent_extractKeywords: typeof extractKeywords;
+declare const ai_agent_extractPromptTemplateVariables: typeof extractPromptTemplateVariables;
 declare const ai_agent_extractTables: typeof extractTables;
 declare const ai_agent_extractUrls: typeof extractUrls;
 declare const ai_agent_flattenJson: typeof flattenJson;
@@ -496,7 +523,7 @@ declare const ai_agent_unflattenJson: typeof unflattenJson;
 declare const ai_agent_validateJsonSchema: typeof validateJsonSchema;
 declare const ai_agent_vectorSimilarity: typeof vectorSimilarity;
 declare namespace ai_agent {
-  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_RetryBackoffAttempt as RetryBackoffAttempt, type ai_agent_RetryBackoffInput as RetryBackoffInput, type ai_agent_RetryBackoffResult as RetryBackoffResult, type ai_agent_RetryJitterMode as RetryJitterMode, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_ToolSchemaIssue as ToolSchemaIssue, type ai_agent_ToolSchemaLintResult as ToolSchemaLintResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_calculateRetryBackoffSchedule as calculateRetryBackoffSchedule, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_lintToolSchema as lintToolSchema, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
+  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_PromptTemplateVariable as PromptTemplateVariable, type ai_agent_PromptTemplateVariableResult as PromptTemplateVariableResult, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_RetryBackoffAttempt as RetryBackoffAttempt, type ai_agent_RetryBackoffInput as RetryBackoffInput, type ai_agent_RetryBackoffResult as RetryBackoffResult, type ai_agent_RetryJitterMode as RetryJitterMode, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_ToolSchemaIssue as ToolSchemaIssue, type ai_agent_ToolSchemaLintResult as ToolSchemaLintResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_calculateRetryBackoffSchedule as calculateRetryBackoffSchedule, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractPromptTemplateVariables as extractPromptTemplateVariables, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_lintToolSchema as lintToolSchema, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
 }
 
-export { type VectorSimilarityResult as $, type RetryJitterMode as A, type SecretDetectResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type SecretFinding as G, type SecretType as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type SummaryResult as L, MODEL_PRICING as M, type TextChunk as N, type TokenEstimate as O, type PiiDetectResult as P, type TokenEstimateResult as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type ToolSchemaIssue as U, type ToolSchemaLintResult as V, type TrimResult as W, type TrimStrategy as X, type UrlMatch as Y, type ValidationError as Z, type ValidationResult as _, ai_agent as a, calculateRetryBackoffSchedule as a0, chunkText as a1, compressHtml as a2, compressJson as a3, compressMarkdown as a4, deduplicateLines as a5, detectPii as a6, detectPromptInjection as a7, detectSecrets as a8, diffJson as a9, estimateCost as aa, estimateTokens as ab, expandQuery as ac, extractEntities as ad, extractJson as ae, extractKeywords as af, extractTables as ag, extractUrls as ah, flattenJson as ai, formatFewShotExamples as aj, lintToolSchema as ak, mergeJson as al, redactPii as am, repairJson as an, rerankChunks as ao, sanitizeHtml as ap, scoreRelevance as aq, summarizeForLlm as ar, trimToTokens as as, unflattenJson as at, validateJsonSchema as au, vectorSimilarity as av, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type RelevanceResult as w, type RetryBackoffAttempt as x, type RetryBackoffInput as y, type RetryBackoffResult as z };
+export { type ValidationError as $, type RetryBackoffInput as A, type RetryBackoffResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type RetryJitterMode as G, type SecretDetectResult as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type SecretFinding as L, MODEL_PRICING as M, type SecretType as N, type SummaryResult as O, type PiiDetectResult as P, type TextChunk as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type TokenEstimate as U, type TokenEstimateResult as V, type ToolSchemaIssue as W, type ToolSchemaLintResult as X, type TrimResult as Y, type TrimStrategy as Z, type UrlMatch as _, ai_agent as a, type ValidationResult as a0, type VectorSimilarityResult as a1, calculateRetryBackoffSchedule as a2, chunkText as a3, compressHtml as a4, compressJson as a5, compressMarkdown as a6, deduplicateLines as a7, detectPii as a8, detectPromptInjection as a9, detectSecrets as aa, diffJson as ab, estimateCost as ac, estimateTokens as ad, expandQuery as ae, extractEntities as af, extractJson as ag, extractKeywords as ah, extractPromptTemplateVariables as ai, extractTables as aj, extractUrls as ak, flattenJson as al, formatFewShotExamples as am, lintToolSchema as an, mergeJson as ao, redactPii as ap, repairJson as aq, rerankChunks as ar, sanitizeHtml as as, scoreRelevance as at, summarizeForLlm as au, trimToTokens as av, unflattenJson as aw, validateJsonSchema as ax, vectorSimilarity as ay, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type PromptTemplateVariable as w, type PromptTemplateVariableResult as x, type RelevanceResult as y, type RetryBackoffAttempt as z };

package/dist/{ai_agent-DeCy0oZK.d.ts → ai_agent-B9wWLBDf.d.ts}

@@ -409,6 +409,30 @@ interface RetryBackoffResult {
 declare function calculateRetryBackoffSchedule(input: RetryBackoffInput): RetryBackoffResult | {
     error: string;
 };
+interface PromptTemplateVariable {
+    name: string;
+    count: number;
+}
+interface PromptTemplateVariableResult {
+    variableCount: number;
+    variables: PromptTemplateVariable[];
+    duplicates: string[];
+    missing: string[];
+    unused: string[];
+}
+/**
+ * Extract every {{variable}}-style placeholder from a prompt template,
+ * reporting each unique variable's occurrence count and flagging ones used
+ * more than once. When providedVars is given, also cross-checks the
+ * template against it: variables the template uses but providedVars is
+ * missing, and names in providedVars the template never references. Only
+ * double-curly {{name}} syntax is recognized (dotted/dashed names like
+ * {{user.name}} are allowed); single-brace, triple-brace, and Jinja-style
+ * {% %} tags are out of scope.
+ */
+declare function extractPromptTemplateVariables(template: string, providedVars?: string[]): PromptTemplateVariableResult | {
+    error: string;
+};
 
 type ai_agent_ChunkStrategy = ChunkStrategy;
 type ai_agent_CompressHtmlResult = CompressHtmlResult;
@@ -440,6 +464,8 @@ type ai_agent_ModelPricing = ModelPricing;
 type ai_agent_PiiDetectResult = PiiDetectResult;
 type ai_agent_PiiFinding = PiiFinding;
 type ai_agent_PiiType = PiiType;
+type ai_agent_PromptTemplateVariable = PromptTemplateVariable;
+type ai_agent_PromptTemplateVariableResult = PromptTemplateVariableResult;
 type ai_agent_RankedChunk = RankedChunk;
 type ai_agent_RelevanceResult = RelevanceResult;
 type ai_agent_RetryBackoffAttempt = RetryBackoffAttempt;
@@ -479,6 +505,7 @@ declare const ai_agent_expandQuery: typeof expandQuery;
 declare const ai_agent_extractEntities: typeof extractEntities;
 declare const ai_agent_extractJson: typeof extractJson;
 declare const ai_agent_extractKeywords: typeof extractKeywords;
+declare const ai_agent_extractPromptTemplateVariables: typeof extractPromptTemplateVariables;
 declare const ai_agent_extractTables: typeof extractTables;
 declare const ai_agent_extractUrls: typeof extractUrls;
 declare const ai_agent_flattenJson: typeof flattenJson;
@@ -496,7 +523,7 @@ declare const ai_agent_unflattenJson: typeof unflattenJson;
 declare const ai_agent_validateJsonSchema: typeof validateJsonSchema;
 declare const ai_agent_vectorSimilarity: typeof vectorSimilarity;
 declare namespace ai_agent {
-  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_RetryBackoffAttempt as RetryBackoffAttempt, type ai_agent_RetryBackoffInput as RetryBackoffInput, type ai_agent_RetryBackoffResult as RetryBackoffResult, type ai_agent_RetryJitterMode as RetryJitterMode, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_ToolSchemaIssue as ToolSchemaIssue, type ai_agent_ToolSchemaLintResult as ToolSchemaLintResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_calculateRetryBackoffSchedule as calculateRetryBackoffSchedule, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_lintToolSchema as lintToolSchema, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
+  export { type ai_agent_ChunkStrategy as ChunkStrategy, type ai_agent_CompressHtmlResult as CompressHtmlResult, type ai_agent_CompressJsonResult as CompressJsonResult, type ai_agent_CompressMarkdownResult as CompressMarkdownResult, type ai_agent_CostEstimate as CostEstimate, type ai_agent_DedupeResult as DedupeResult, type ai_agent_DedupeStrategy as DedupeStrategy, type ai_agent_DiffEntry2 as DiffEntry2, type ai_agent_DiffOp2 as DiffOp2, type ai_agent_DiffResult2 as DiffResult2, type ai_agent_Entity2 as Entity2, type ai_agent_EntityType2 as EntityType2, type ai_agent_ExtractJsonResult as ExtractJsonResult, type ai_agent_ExtractKeywordsResult as ExtractKeywordsResult, type ai_agent_ExtractUrlsResult as ExtractUrlsResult, type ai_agent_FewShotExample as FewShotExample, type ai_agent_FewShotFormat as FewShotFormat, type ai_agent_FewShotFormatResult as FewShotFormatResult, type ai_agent_InjectionDetectResult as InjectionDetectResult, type ai_agent_InjectionFinding as InjectionFinding, type ai_agent_JsonBlock as JsonBlock, type ai_agent_JsonRepairResult as JsonRepairResult, type ai_agent_Keyword as Keyword, ai_agent_MODEL_PRICING as MODEL_PRICING, type ai_agent_MergeResult as MergeResult, type ai_agent_MergeStrategy as MergeStrategy, type ai_agent_ModelPricing as ModelPricing, type ai_agent_PiiDetectResult as PiiDetectResult, type ai_agent_PiiFinding as PiiFinding, type ai_agent_PiiType as PiiType, type ai_agent_PromptTemplateVariable as PromptTemplateVariable, type ai_agent_PromptTemplateVariableResult as PromptTemplateVariableResult, type ai_agent_RankedChunk as RankedChunk, type ai_agent_RelevanceResult as RelevanceResult, type ai_agent_RetryBackoffAttempt as RetryBackoffAttempt, type ai_agent_RetryBackoffInput as RetryBackoffInput, type ai_agent_RetryBackoffResult as RetryBackoffResult, type ai_agent_RetryJitterMode as RetryJitterMode, type ai_agent_SanitizeResult as SanitizeResult, type ai_agent_SecretDetectResult as SecretDetectResult, type ai_agent_SecretFinding as SecretFinding, type ai_agent_SecretType as SecretType, type ai_agent_SummaryResult as SummaryResult, type ai_agent_TableResult2 as TableResult2, type ai_agent_TextChunk as TextChunk, type ai_agent_TokenEstimate as TokenEstimate, type ai_agent_TokenEstimateResult as TokenEstimateResult, type ai_agent_ToolSchemaIssue as ToolSchemaIssue, type ai_agent_ToolSchemaLintResult as ToolSchemaLintResult, type ai_agent_TrimResult as TrimResult, type ai_agent_TrimStrategy as TrimStrategy, type ai_agent_UrlMatch as UrlMatch, type ai_agent_ValidationError as ValidationError, type ai_agent_ValidationResult as ValidationResult, type ai_agent_VectorSimilarityResult as VectorSimilarityResult, ai_agent_calculateRetryBackoffSchedule as calculateRetryBackoffSchedule, ai_agent_chunkText as chunkText, ai_agent_compressHtml as compressHtml, ai_agent_compressJson as compressJson, ai_agent_compressMarkdown as compressMarkdown, ai_agent_deduplicateLines as deduplicateLines, ai_agent_detectPii as detectPii, ai_agent_detectPromptInjection as detectPromptInjection, ai_agent_detectSecrets as detectSecrets, ai_agent_diffJson as diffJson, ai_agent_estimateCost as estimateCost, ai_agent_estimateTokens as estimateTokens, ai_agent_expandQuery as expandQuery, ai_agent_extractEntities as extractEntities, ai_agent_extractJson as extractJson, ai_agent_extractKeywords as extractKeywords, ai_agent_extractPromptTemplateVariables as extractPromptTemplateVariables, ai_agent_extractTables as extractTables, ai_agent_extractUrls as extractUrls, ai_agent_flattenJson as flattenJson, ai_agent_formatFewShotExamples as formatFewShotExamples, ai_agent_lintToolSchema as lintToolSchema, ai_agent_mergeJson as mergeJson, ai_agent_redactPii as redactPii, ai_agent_repairJson as repairJson, ai_agent_rerankChunks as rerankChunks, ai_agent_sanitizeHtml as sanitizeHtml, ai_agent_scoreRelevance as scoreRelevance, ai_agent_summarizeForLlm as summarizeForLlm, ai_agent_trimToTokens as trimToTokens, ai_agent_unflattenJson as unflattenJson, ai_agent_validateJsonSchema as validateJsonSchema, ai_agent_vectorSimilarity as vectorSimilarity };
 }
 
-export { type VectorSimilarityResult as $, type RetryJitterMode as A, type SecretDetectResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type SecretFinding as G, type SecretType as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type SummaryResult as L, MODEL_PRICING as M, type TextChunk as N, type TokenEstimate as O, type PiiDetectResult as P, type TokenEstimateResult as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type ToolSchemaIssue as U, type ToolSchemaLintResult as V, type TrimResult as W, type TrimStrategy as X, type UrlMatch as Y, type ValidationError as Z, type ValidationResult as _, ai_agent as a, calculateRetryBackoffSchedule as a0, chunkText as a1, compressHtml as a2, compressJson as a3, compressMarkdown as a4, deduplicateLines as a5, detectPii as a6, detectPromptInjection as a7, detectSecrets as a8, diffJson as a9, estimateCost as aa, estimateTokens as ab, expandQuery as ac, extractEntities as ad, extractJson as ae, extractKeywords as af, extractTables as ag, extractUrls as ah, flattenJson as ai, formatFewShotExamples as aj, lintToolSchema as ak, mergeJson as al, redactPii as am, repairJson as an, rerankChunks as ao, sanitizeHtml as ap, scoreRelevance as aq, summarizeForLlm as ar, trimToTokens as as, unflattenJson as at, validateJsonSchema as au, vectorSimilarity as av, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type RelevanceResult as w, type RetryBackoffAttempt as x, type RetryBackoffInput as y, type RetryBackoffResult as z };
+export { type ValidationError as $, type RetryBackoffInput as A, type RetryBackoffResult as B, type ChunkStrategy as C, type DedupeResult as D, type Entity2 as E, type FewShotExample as F, type RetryJitterMode as G, type SecretDetectResult as H, type InjectionDetectResult as I, type JsonBlock as J, type Keyword as K, type SecretFinding as L, MODEL_PRICING as M, type SecretType as N, type SummaryResult as O, type PiiDetectResult as P, type TextChunk as Q, type RankedChunk as R, type SanitizeResult as S, type TableResult2 as T, type TokenEstimate as U, type TokenEstimateResult as V, type ToolSchemaIssue as W, type ToolSchemaLintResult as X, type TrimResult as Y, type TrimStrategy as Z, type UrlMatch as _, ai_agent as a, type ValidationResult as a0, type VectorSimilarityResult as a1, calculateRetryBackoffSchedule as a2, chunkText as a3, compressHtml as a4, compressJson as a5, compressMarkdown as a6, deduplicateLines as a7, detectPii as a8, detectPromptInjection as a9, detectSecrets as aa, diffJson as ab, estimateCost as ac, estimateTokens as ad, expandQuery as ae, extractEntities as af, extractJson as ag, extractKeywords as ah, extractPromptTemplateVariables as ai, extractTables as aj, extractUrls as ak, flattenJson as al, formatFewShotExamples as am, lintToolSchema as an, mergeJson as ao, redactPii as ap, repairJson as aq, rerankChunks as ar, sanitizeHtml as as, scoreRelevance as at, summarizeForLlm as au, trimToTokens as av, unflattenJson as aw, validateJsonSchema as ax, vectorSimilarity as ay, type CompressHtmlResult as b, type CompressJsonResult as c, type CompressMarkdownResult as d, type CostEstimate as e, type DedupeStrategy as f, type DiffEntry2 as g, type DiffOp2 as h, type DiffResult2 as i, type EntityType2 as j, type ExtractJsonResult as k, type ExtractKeywordsResult as l, type ExtractUrlsResult as m, type FewShotFormat as n, type FewShotFormatResult as o, type InjectionFinding as p, type JsonRepairResult as q, type MergeResult as r, type MergeStrategy as s, type ModelPricing as t, type PiiFinding as u, type PiiType as v, type PromptTemplateVariable as w, type PromptTemplateVariableResult as x, type RelevanceResult as y, type RetryBackoffAttempt as z };

package/dist/{chunk-HJLGUNSO.js → chunk-5VVC7BHS.js}

@@ -20,6 +20,7 @@ __export(ai_agent_exports, {
   extractEntities: () => extractEntities,
   extractJson: () => extractJson,
   extractKeywords: () => extractKeywords,
+  extractPromptTemplateVariables: () => extractPromptTemplateVariables,
   extractTables: () => extractTables,
   extractUrls: () => extractUrls,
   flattenJson: () => flattenJson,
@@ -1173,5 +1174,44 @@ function calculateRetryBackoffSchedule(input) {
     totalWorstCaseMs: round0(totalWorstCaseMs)
   };
 }
+var PROMPT_TEMPLATE_VARIABLE_REGEX = /\{\{\s*([a-zA-Z0-9_.-]+)\s*\}\}/g;
+function extractPromptTemplateVariables(template, providedVars) {
+  const trimmed = template.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const order = [];
+  const counts = /* @__PURE__ */ new Map();
+  for (const m of template.matchAll(PROMPT_TEMPLATE_VARIABLE_REGEX)) {
+    const name = m[1];
+    if (!counts.has(name)) {
+      counts.set(name, 0);
+      order.push(name);
+    }
+    counts.set(name, (counts.get(name) ?? 0) + 1);
+  }
+  if (order.length === 0) return { error: "No {{variable}} placeholders found" };
+  const variables = order.map((name) => ({ name, count: counts.get(name) ?? 0 }));
+  const duplicates = order.filter((name) => (counts.get(name) ?? 0) > 1);
+  let missing = [];
+  const unused = [];
+  if (providedVars !== void 0) {
+    const providedSet = new Set(providedVars.map((v) => v.trim()).filter(Boolean));
+    const usedSet = new Set(order);
+    missing = order.filter((name) => !providedSet.has(name));
+    const seenProvided = /* @__PURE__ */ new Set();
+    for (const raw of providedVars) {
+      const v = raw.trim();
+      if (!v || usedSet.has(v) || seenProvided.has(v)) continue;
+      seenProvided.add(v);
+      unused.push(v);
+    }
+  }
+  return {
+    variableCount: order.length,
+    variables,
+    duplicates,
+    missing,
+    unused
+  };
+}
 
-export { MODEL_PRICING, ai_agent_exports, calculateRetryBackoffSchedule, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractTables, extractUrls, flattenJson, formatFewShotExamples, lintToolSchema, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity };
+export { MODEL_PRICING, ai_agent_exports, calculateRetryBackoffSchedule, chunkText, compressHtml, compressJson, compressMarkdown, deduplicateLines, detectPii, detectPromptInjection, detectSecrets, diffJson, estimateCost, estimateTokens, expandQuery, extractEntities, extractJson, extractKeywords, extractPromptTemplateVariables, extractTables, extractUrls, flattenJson, formatFewShotExamples, lintToolSchema, mergeJson, redactPii, repairJson, rerankChunks, sanitizeHtml, scoreRelevance, summarizeForLlm, trimToTokens, unflattenJson, validateJsonSchema, vectorSimilarity };

package/dist/{chunk-FPFA4ZHC.js → chunk-KXUHXQFO.js}

@@ -27,6 +27,7 @@ __export(code_exports, {
   envToExport: () => envToExport,
   envToJson: () => envToJson,
   extractMarkdownFootnotes: () => extractMarkdownFootnotes,
+  extractMarkdownLinkReferences: () => extractMarkdownLinkReferences,
   extractSvgSpriteSymbols: () => extractSvgSpriteSymbols,
   formatCss: () => formatCss,
   formatGql: () => formatGql,
@@ -4268,5 +4269,63 @@ function countSqlPlaceholders(sql) {
     numberedDuplicates
   };
 }
+var LINK_REF_DEFINITION_REGEX = /^ {0,3}\[([^\]]+)\]:\s*(\S+)(?:\s+(?:"([^"]*)"|'([^']*)'|\(([^)]*)\)))?\s*$/;
+var LINK_REF_USAGE_REGEX = /(!?)\[([^[\]\n]*)\]\[([^[\]\n]*)\]/g;
+function normalizeLinkLabel(label) {
+  return label.trim().replace(/\s+/g, " ").toLowerCase();
+}
+function extractMarkdownLinkReferences(markdown) {
+  const trimmed = markdown.trim();
+  if (!trimmed) return { error: "Empty input" };
+  const lines = markdown.replace(/\r\n/g, "\n").split("\n");
+  const definitions = [];
+  const definitionsByLabel = /* @__PURE__ */ new Map();
+  for (const line of lines) {
+    const match = line.match(LINK_REF_DEFINITION_REGEX);
+    if (!match) continue;
+    const label = match[1];
+    const normalized = normalizeLinkLabel(label);
+    if (definitionsByLabel.has(normalized)) continue;
+    const def = {
+      label,
+      url: match[2],
+      title: match[3] ?? match[4] ?? match[5] ?? void 0
+    };
+    definitionsByLabel.set(normalized, def);
+    definitions.push(def);
+  }
+  const usages = [];
+  for (const m of markdown.matchAll(LINK_REF_USAGE_REGEX)) {
+    const image = m[1] === "!";
+    const text = m[2];
+    const rawRef = m[3];
+    const label = rawRef.trim() === "" ? text : rawRef;
+    usages.push({ text, label, image });
+  }
+  if (definitions.length === 0 && usages.length === 0) {
+    return { error: "No reference-style links or definitions found" };
+  }
+  const usedLabels = /* @__PURE__ */ new Set();
+  const resolved = [];
+  const unresolvedReferences = [];
+  for (const usage of usages) {
+    const normalized = normalizeLinkLabel(usage.label);
+    const def = definitionsByLabel.get(normalized);
+    if (def) {
+      usedLabels.add(normalized);
+      resolved.push({ ...usage, url: def.url, title: def.title });
+    } else {
+      unresolvedReferences.push(usage);
+    }
+  }
+  const unusedDefinitions = definitions.filter((d) => !usedLabels.has(normalizeLinkLabel(d.label)));
+  return {
+    referenceCount: usages.length,
+    definitionCount: definitions.length,
+    resolved,
+    unresolvedReferences,
+    unusedDefinitions
+  };
+}
 
-export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, KNOWN_LANGUAGE_TAGS, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, countSqlPlaceholders, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, extractMarkdownFootnotes, extractSvgSpriteSymbols, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseCommitTrailers, parseConnectionString, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateAria, validateEditorConfig, validateEnvKey, validateFenceLanguageTags, validatePackageExports, validateTsconfig };
+export { ALL_FLAGS, CHEATSHEET, DEFAULT_COMMIT_TYPES, KNOWN_LANGUAGE_TAGS, MIME_TABLE, OPERATIONS, SQL_DEFAULT_OPTIONS, analyzeRegexGroups, auditDependencyRanges, buildDockerPull, buildDockerRun, buildGitCommand, code_exports, collapseHtmlWhitespace, collapseJsWhitespace, countProperties, countRules, countSqlPlaceholders, detectDialect, detectOperationType, detectRedos, envToExport, envToJson, extractMarkdownFootnotes, extractMarkdownLinkReferences, extractSvgSpriteSymbols, formatCss, formatGql, formatHtml, formatSql, getEndpointsByTag, getHtmlStats, getJsStats, getMethodColor, isValidTag, lintConventionalCommit, lookupMime, minifyCss, minifyGql, minifyHtml, minifyJs, minifySql, normalizeRef, parseCommitTrailers, parseConnectionString, parseDockerImage, parseEnv, parseGitCommand, parseGithubUrl, parseSpec, removeConsoleCalls, removeEmptyAttributes, removeHtmlComments, removeJsComments, removeRedundantAttributes, searchCheatsheet, searchEndpoints, splitStatements, testGitignorePatterns, testPattern, testRegex, validateAria, validateEditorConfig, validateEnvKey, validateFenceLanguageTags, validatePackageExports, validateTsconfig };

package/dist/{chunk-KWS4ZCYG.js → chunk-SW3J5CAI.js}

@@ -38,6 +38,7 @@ __export(network_exports, {
   extractMultipartBoundary: () => extractMultipartBoundary,
   formatCoordinates: () => formatCoordinates,
   formatTtl: () => formatTtl,
+  generateRobotsTxt: () => generateRobotsTxt,
   getByCategory: () => getByCategory,
   getHeader: () => getHeader,
   getHeadersByCategory: () => getHeadersByCategory,
@@ -1711,6 +1712,40 @@ function validateRobotsTxt(text) {
   const valid = !issues.some((i) => i.severity === "error");
   return { groups, sitemaps, issues, valid };
 }
+function generateRobotsTxt(options) {
+  if (!options || !Array.isArray(options.groups) || options.groups.length === 0) {
+    return { error: "At least one group with a user-agent is required" };
+  }
+  const lines = [];
+  for (const group of options.groups) {
+    const userAgents = (group.userAgents ?? []).map((a) => a.trim()).filter(Boolean);
+    if (userAgents.length === 0) return { error: "Each group needs at least one non-empty user-agent" };
+    for (const ua of userAgents) lines.push(`User-agent: ${ua}`);
+    const disallow = group.disallow ?? [];
+    const allow = group.allow ?? [];
+    if (disallow.length === 0 && allow.length === 0) {
+      lines.push("Disallow:");
+    } else {
+      for (const value of disallow) lines.push(`Disallow: ${value}`);
+      for (const value of allow) lines.push(`Allow: ${value}`);
+    }
+    if (group.crawlDelay !== void 0) {
+      if (!Number.isFinite(group.crawlDelay) || group.crawlDelay < 0) {
+        return { error: "crawlDelay must be a non-negative number" };
+      }
+      lines.push(`Crawl-delay: ${group.crawlDelay}`);
+    }
+    lines.push("");
+  }
+  for (const sitemap of options.sitemaps ?? []) {
+    if (!/^https?:\/\//i.test(sitemap)) {
+      return { error: `Sitemap URL "${sitemap}" must be absolute (start with http:// or https://)` };
+    }
+    lines.push(`Sitemap: ${sitemap}`);
+  }
+  while (lines.length > 0 && lines[lines.length - 1] === "") lines.pop();
+  return { text: lines.join("\n") + "\n" };
+}
 var UA_BOT_PATTERNS = [
   [/googlebot/i, "Googlebot"],
   [/bingbot/i, "Bingbot"],
@@ -3630,4 +3665,4 @@ function scoreSecurityHeaders(rawHeaders) {
   return { checks, score, grade, passCount, warningCount, missingCount, totalChecks };
 }
 
-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, calculateCookieSizeBudget, 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, scoreSecurityHeaders, 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, calculateCookieSizeBudget, checkSetCookieHeader, countryCodeToFlag, extractMultipartBoundary, formatCoordinates, formatTtl, generateRobotsTxt, 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, scoreSecurityHeaders, searchHeaders, searchStatusCodes, splitSitemap, statusCodeToText, typeNumberToLabel, validateDomain, validateHeaderName, validateHeaderValue, validateManifest, validateRobotsTxt, validateSitemap };

package/dist/{code-B8yHwP3m.d.cts → code-COUhffgE.d.cts}

@@ -718,6 +718,41 @@ interface SqlPlaceholderResult {
  * bodies (`$$...$$`) are not specially recognized.
  */
 declare function countSqlPlaceholders(sql: string): SqlPlaceholderResult;
+interface LinkReferenceUsage {
+    text: string;
+    label: string;
+    image: boolean;
+}
+interface LinkReferenceDefinition {
+    label: string;
+    url: string;
+    title?: string;
+}
+interface ResolvedLinkReference extends LinkReferenceUsage {
+    url: string;
+    title?: string;
+}
+interface MarkdownLinkReferenceResult {
+    referenceCount: number;
+    definitionCount: number;
+    resolved: ResolvedLinkReference[];
+    unresolvedReferences: LinkReferenceUsage[];
+    unusedDefinitions: LinkReferenceDefinition[];
+}
+/**
+ * Extract every reference-style Markdown link (`[text][ref]`, including the
+ * shortcut form `[text][]` and image references `![alt][ref]`) alongside
+ * its `[ref]: url "title"` definition, then flag usages with no matching
+ * definition and definitions that no usage ever references. Labels are
+ * matched case-insensitively with internal whitespace collapsed, per
+ * CommonMark's link-label normalization; when the same label is defined
+ * more than once, the first definition wins. Inline links (`[text](url)`)
+ * and bare shortcut references (`[ref]` with no second bracket pair) are
+ * out of scope.
+ */
+declare function extractMarkdownLinkReferences(markdown: string): MarkdownLinkReferenceResult | {
+    error: string;
+};
 
 declare const code_ALL_FLAGS: typeof ALL_FLAGS;
 type code_ApiEndpoint = ApiEndpoint;
@@ -770,10 +805,13 @@ type code_HtmlMinifyResult = HtmlMinifyResult;
 type code_JsMinifyOptions = JsMinifyOptions;
 type code_JsMinifyResult = JsMinifyResult;
 declare const code_KNOWN_LANGUAGE_TAGS: typeof KNOWN_LANGUAGE_TAGS;
+type code_LinkReferenceDefinition = LinkReferenceDefinition;
+type code_LinkReferenceUsage = LinkReferenceUsage;
 declare const code_MIME_TABLE: typeof MIME_TABLE;
 type code_MarkdownFootnoteDefinition = MarkdownFootnoteDefinition;
 type code_MarkdownFootnoteReference = MarkdownFootnoteReference;
 type code_MarkdownFootnoteResult = MarkdownFootnoteResult;
+type code_MarkdownLinkReferenceResult = MarkdownLinkReferenceResult;
 type code_MatchResult = MatchResult;
 type code_MimeEntry = MimeEntry;
 type code_MimeLookupResult = MimeLookupResult;
@@ -792,6 +830,7 @@ type code_RegexGroupIssue = RegexGroupIssue;
 type code_RegexMatch = RegexMatch;
 type code_RegexResult = RegexResult;
 type code_RegexSuccess = RegexSuccess;
+type code_ResolvedLinkReference = ResolvedLinkReference;
 declare const code_SQL_DEFAULT_OPTIONS: typeof SQL_DEFAULT_OPTIONS;
 type code_Segment = Segment;
 type code_SpecVersion = SpecVersion;
@@ -820,6 +859,7 @@ declare const code_detectRedos: typeof detectRedos;
 declare const code_envToExport: typeof envToExport;
 declare const code_envToJson: typeof envToJson;
 declare const code_extractMarkdownFootnotes: typeof extractMarkdownFootnotes;
+declare const code_extractMarkdownLinkReferences: typeof extractMarkdownLinkReferences;
 declare const code_extractSvgSpriteSymbols: typeof extractSvgSpriteSymbols;
 declare const code_formatCss: typeof formatCss;
 declare const code_formatGql: typeof formatGql;
@@ -863,7 +903,7 @@ declare const code_validateFenceLanguageTags: typeof validateFenceLanguageTags;
 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, type code_AriaIssue as AriaIssue, type code_AriaValidationResult as AriaValidationResult, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_CommitTrailer as CommitTrailer, type code_CommitTrailerResult as CommitTrailerResult, type code_ConnectionStringHost as ConnectionStringHost, type code_ConnectionStringResult as ConnectionStringResult, 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_FenceTagIssue as FenceTagIssue, type code_FenceTagIssueType as FenceTagIssueType, type code_FenceValidationResult as FenceValidationResult, 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_KNOWN_LANGUAGE_TAGS as KNOWN_LANGUAGE_TAGS, code_MIME_TABLE as MIME_TABLE, type code_MarkdownFootnoteDefinition as MarkdownFootnoteDefinition, type code_MarkdownFootnoteReference as MarkdownFootnoteReference, type code_MarkdownFootnoteResult as MarkdownFootnoteResult, 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_PlaceholderStyle as PlaceholderStyle, 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_SqlPlaceholder as SqlPlaceholder, type code_SqlPlaceholderResult as SqlPlaceholderResult, 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_countSqlPlaceholders as countSqlPlaceholders, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_detectRedos as detectRedos, code_envToExport as envToExport, code_envToJson as envToJson, code_extractMarkdownFootnotes as extractMarkdownFootnotes, 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_parseCommitTrailers as parseCommitTrailers, code_parseConnectionString as parseConnectionString, 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_validateAria as validateAria, code_validateEditorConfig as validateEditorConfig, code_validateEnvKey as validateEnvKey, code_validateFenceLanguageTags as validateFenceLanguageTags, 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, type code_AriaIssue as AriaIssue, type code_AriaValidationResult as AriaValidationResult, code_CHEATSHEET as CHEATSHEET, type code_CheatsheetEntry as CheatsheetEntry, type code_CommitTrailer as CommitTrailer, type code_CommitTrailerResult as CommitTrailerResult, type code_ConnectionStringHost as ConnectionStringHost, type code_ConnectionStringResult as ConnectionStringResult, 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_FenceTagIssue as FenceTagIssue, type code_FenceTagIssueType as FenceTagIssueType, type code_FenceValidationResult as FenceValidationResult, 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_KNOWN_LANGUAGE_TAGS as KNOWN_LANGUAGE_TAGS, type code_LinkReferenceDefinition as LinkReferenceDefinition, type code_LinkReferenceUsage as LinkReferenceUsage, code_MIME_TABLE as MIME_TABLE, type code_MarkdownFootnoteDefinition as MarkdownFootnoteDefinition, type code_MarkdownFootnoteReference as MarkdownFootnoteReference, type code_MarkdownFootnoteResult as MarkdownFootnoteResult, type code_MarkdownLinkReferenceResult as MarkdownLinkReferenceResult, 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_PlaceholderStyle as PlaceholderStyle, 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, type code_ResolvedLinkReference as ResolvedLinkReference, 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_SqlPlaceholder as SqlPlaceholder, type code_SqlPlaceholderResult as SqlPlaceholderResult, 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_countSqlPlaceholders as countSqlPlaceholders, code_detectDialect as detectDialect, code_detectOperationType as detectOperationType, code_detectRedos as detectRedos, code_envToExport as envToExport, code_envToJson as envToJson, code_extractMarkdownFootnotes as extractMarkdownFootnotes, code_extractMarkdownLinkReferences as extractMarkdownLinkReferences, 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_parseCommitTrailers as parseCommitTrailers, code_parseConnectionString as parseConnectionString, 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_validateAria as validateAria, code_validateEditorConfig as validateEditorConfig, code_validateEnvKey as validateEnvKey, code_validateFenceLanguageTags as validateFenceLanguageTags, code_validatePackageExports as validatePackageExports, code_validateTsconfig as validateTsconfig };
 }
 
-export { type MarkdownFootnoteDefinition as $, ALL_FLAGS as A, type EditorConfigValidationResult as B, CHEATSHEET as C, DEFAULT_COMMIT_TYPES as D, type EditorConfigIssue as E, type EnvEntry as F, type EnvParseResult as G, type ExportsIssue as H, type ExportsShape as I, type ExportsValidationResult as J, type FenceTagIssue as K, type FenceTagIssueType as L, type FenceValidationResult as M, type GitCommandConfig as N, type GitCommandResult as O, type GitOperation as P, type GithubUrlInfo as Q, type GithubUrlType as R, type GitignoreTestResult as S, type GqlFormatResult as T, type HtmlFormatResult as U, type HtmlMinifyOptions as V, type HtmlMinifyResult as W, type JsMinifyOptions as X, type JsMinifyResult as Y, KNOWN_LANGUAGE_TAGS as Z, MIME_TABLE as _, type ApiEndpoint as a, minifyJs as a$, type MarkdownFootnoteReference as a0, type MarkdownFootnoteResult as a1, type MatchResult as a2, type MimeEntry as a3, type MimeLookupResult as a4, OPERATIONS as a5, type ParsedSpec as a6, type PlaceholderStyle as a7, type RedosFinding as a8, type RedosResult as a9, buildGitCommand as aA, collapseHtmlWhitespace as aB, collapseJsWhitespace as aC, countProperties as aD, countRules as aE, countSqlPlaceholders as aF, detectDialect as aG, detectOperationType as aH, detectRedos as aI, envToExport as aJ, envToJson as aK, extractMarkdownFootnotes as aL, extractSvgSpriteSymbols 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, minifyHtml as a_, type RedosSeverity as aa, type RegexBackreferenceInfo as ab, type RegexError as ac, type RegexFlag as ad, type RegexGroupAnalysis as ae, type RegexGroupInfo as af, type RegexGroupIssue as ag, type RegexMatch as ah, type RegexResult as ai, type RegexSuccess as aj, SQL_DEFAULT_OPTIONS as ak, type Segment as al, type SpecVersion as am, type SqlDialect as an, type SqlFormatOptions as ao, type SqlPlaceholder as ap, type SqlPlaceholderResult as aq, type SvgSpriteResult as ar, type SvgSpriteSymbol as as, type TestPatternResult as at, type TsconfigIssue as au, type TsconfigValidationResult as av, analyzeRegexGroups as aw, auditDependencyRanges as ax, buildDockerPull as ay, buildDockerRun as az, type ApiInfo as b, minifySql as b0, normalizeRef as b1, parseCommitTrailers as b2, parseConnectionString as b3, parseDockerImage as b4, parseEnv as b5, parseGitCommand as b6, parseGithubUrl as b7, parseSpec as b8, removeConsoleCalls as b9, removeEmptyAttributes as ba, removeHtmlComments as bb, removeJsComments as bc, removeRedundantAttributes as bd, searchCheatsheet as be, searchEndpoints as bf, splitStatements as bg, testGitignorePatterns as bh, testPattern as bi, testRegex as bj, validateAria as bk, validateEditorConfig as bl, validateEnvKey as bm, validateFenceLanguageTags as bn, validatePackageExports as bo, validateTsconfig as bp, code as c, type AriaIssue as d, type AriaValidationResult as e, type CheatsheetEntry as f, type CommitTrailer as g, type CommitTrailerResult as h, type ConnectionStringHost as i, type ConnectionStringResult as j, type ConventionalCommitFinding as k, type ConventionalCommitFooter as l, type ConventionalCommitOptions as m, type ConventionalCommitParsed as n, type ConventionalCommitResult as o, type ConventionalCommitSeverity as p, type CssResult as q, type DependencyAuditDuplicate as r, type DependencyAuditEntry as s, type DependencyAuditIssue as t, type DependencyAuditResult as u, type DependencyRangeType as v, type DependencySection as w, type DockerImageRef as x, type EditorConfigProperty as y, type EditorConfigSection as z };
+export { type LinkReferenceUsage as $, ALL_FLAGS as A, type EditorConfigValidationResult as B, CHEATSHEET as C, DEFAULT_COMMIT_TYPES as D, type EditorConfigIssue as E, type EnvEntry as F, type EnvParseResult as G, type ExportsIssue as H, type ExportsShape as I, type ExportsValidationResult as J, type FenceTagIssue as K, type FenceTagIssueType as L, type FenceValidationResult as M, type GitCommandConfig as N, type GitCommandResult as O, type GitOperation as P, type GithubUrlInfo as Q, type GithubUrlType as R, type GitignoreTestResult as S, type GqlFormatResult as T, type HtmlFormatResult as U, type HtmlMinifyOptions as V, type HtmlMinifyResult as W, type JsMinifyOptions as X, type JsMinifyResult as Y, KNOWN_LANGUAGE_TAGS as Z, type LinkReferenceDefinition as _, type ApiEndpoint as a, lintConventionalCommit as a$, MIME_TABLE as a0, type MarkdownFootnoteDefinition as a1, type MarkdownFootnoteReference as a2, type MarkdownFootnoteResult as a3, type MarkdownLinkReferenceResult as a4, type MatchResult as a5, type MimeEntry as a6, type MimeLookupResult as a7, OPERATIONS as a8, type ParsedSpec as a9, analyzeRegexGroups as aA, auditDependencyRanges as aB, buildDockerPull as aC, buildDockerRun as aD, buildGitCommand as aE, collapseHtmlWhitespace as aF, collapseJsWhitespace as aG, countProperties as aH, countRules as aI, countSqlPlaceholders as aJ, detectDialect as aK, detectOperationType as aL, detectRedos as aM, envToExport as aN, envToJson as aO, extractMarkdownFootnotes as aP, extractMarkdownLinkReferences as aQ, extractSvgSpriteSymbols as aR, formatCss as aS, formatGql as aT, formatHtml as aU, formatSql as aV, getEndpointsByTag as aW, getHtmlStats as aX, getJsStats as aY, getMethodColor as aZ, isValidTag as a_, type PlaceholderStyle as aa, type RedosFinding as ab, type RedosResult as ac, type RedosSeverity as ad, type RegexBackreferenceInfo as ae, type RegexError as af, type RegexFlag as ag, type RegexGroupAnalysis as ah, type RegexGroupInfo as ai, type RegexGroupIssue as aj, type RegexMatch as ak, type RegexResult as al, type RegexSuccess as am, type ResolvedLinkReference as an, SQL_DEFAULT_OPTIONS as ao, type Segment as ap, type SpecVersion as aq, type SqlDialect as ar, type SqlFormatOptions as as, type SqlPlaceholder as at, type SqlPlaceholderResult as au, type SvgSpriteResult as av, type SvgSpriteSymbol as aw, type TestPatternResult as ax, type TsconfigIssue as ay, type TsconfigValidationResult as az, type ApiInfo as b, lookupMime as b0, minifyCss as b1, minifyGql as b2, minifyHtml as b3, minifyJs as b4, minifySql as b5, normalizeRef as b6, parseCommitTrailers as b7, parseConnectionString as b8, parseDockerImage as b9, parseEnv as ba, parseGitCommand as bb, parseGithubUrl as bc, parseSpec as bd, removeConsoleCalls as be, removeEmptyAttributes as bf, removeHtmlComments as bg, removeJsComments as bh, removeRedundantAttributes as bi, searchCheatsheet as bj, searchEndpoints as bk, splitStatements as bl, testGitignorePatterns as bm, testPattern as bn, testRegex as bo, validateAria as bp, validateEditorConfig as bq, validateEnvKey as br, validateFenceLanguageTags as bs, validatePackageExports as bt, validateTsconfig as bu, code as c, type AriaIssue as d, type AriaValidationResult as e, type CheatsheetEntry as f, type CommitTrailer as g, type CommitTrailerResult as h, type ConnectionStringHost as i, type ConnectionStringResult as j, type ConventionalCommitFinding as k, type ConventionalCommitFooter as l, type ConventionalCommitOptions as m, type ConventionalCommitParsed as n, type ConventionalCommitResult as o, type ConventionalCommitSeverity as p, type CssResult as q, type DependencyAuditDuplicate as r, type DependencyAuditEntry as s, type DependencyAuditIssue as t, type DependencyAuditResult as u, type DependencyRangeType as v, type DependencySection as w, type DockerImageRef as x, type EditorConfigProperty as y, type EditorConfigSection as z };