text-sanctifier 1.3.5 → 1.3.7

package/README.md

@@ -119,6 +119,16 @@ Two options handle spaces and zero-width characters gently, and both run before
 - `normalizeSpaces`: replace look-alike spaces with an ordinary space. These are U+00A0, U+2000–U+200A, U+202F and U+205F: the `nonbreaking_space` category except U+3000, the ordinary space of CJK text. With `purgeInvisibleChars` alone, a non-breaking space between two words is deleted and the words run together; with `normalizeSpaces` as well, they stay apart.
 - `purgeZeroWidthSpaces`: remove the zero width space U+200B, the word joiner U+2060 and U+FEFF, and nothing else. Emoji joiners, ZWNJ, variation selectors and bidi marks are kept.
 
+### Presets as standalone imports
+
+Each preset is also its own export: `sanctifyStrict`, `sanctifyLoose`, `sanctifyKeyboardOnly`, `sanctifyKeyboardOnlyEmoji` and `sanctifyPasted`. They are the same functions as `summonSanctifier.strict` and the rest. Import one directly and a bundler leaves out `summonSanctifier` and the other presets (about 1.1 KB gzipped instead of 1.45 KB).
+
+```js
+import { sanctifyPasted } from 'text-sanctifier';
+
+const output = sanctifyPasted(clipboardText);
+```
+
 ### `summonSanctifier.strict`
 
 Aggressively purges: emojis, control characters, extra spacing, and newlines.
@@ -236,22 +246,47 @@ getNewlineStats('a\r\nb\n'); // { crlf: 1, cr: 0, lf: 1, types: ['CRLF', 'LF'],
 
 The categories cover exactly what `nukeControls` and `purgeInvisibleChars` strip. Every code point with the Unicode property Default_Ignorable_Code_Point (characters renderers must draw as nothing) is in a category, and a test checks this against the running Node's Unicode data.
 
-### `text-sanctifier/hidden`: `findHiddenRuns(text)` and `decodeTagText(text)`
+### `text-sanctifier/hidden`: `findHiddenRuns(text, options?)` and `decodeTagText(text)`
 
 The run finder behind [`check --ai-config`](#ai-configuration-files), for tools that read text on its way to a model. It has no Node APIs, so it works in a browser too, but it is a separate entry point and not part of the `text-sanctifier/browser` bundle.
 
 ```js
 import { findHiddenRuns, decodeTagText } from 'text-sanctifier/hidden';
 
-const { runs, benign } = findHiddenRuns(text);
-// runs:   [{ kind: 'tag', offset, end, count, decoded: 'Ignore the user' }, ...]
+const { runs, benign, counts, total, truncated } = findHiddenRuns(text, { maxRuns: 100, maxDecodedLength: 1000 });
+// runs:   [{ kind: 'tag', offset, end, line, column, count, decoded: 'Ignore the user', decodedTruncated: false }, ...]
 // benign: [[offset, end], ...]  England/Scotland/Wales flags, a lone U+FE0E/U+FE0F after a character
+// counts: { tag, variation_selector, invisible_operator, reserved_tag_plane }, every run listed or not; total is their sum
 ```
 
-- `kind` is `tag` (U+E0000–U+E007F), `variation_selector` (U+FE00–U+FE0F, U+E0100–U+E01EF, U+180B–U+180D, U+180F) or `invisible_operator` (U+2061–U+2064). Consecutive characters of one kind form one run.
-- `offset` and `end` are UTF-16 indexes, `[offset, end)`; `count` is in code points. Only tag runs have `decoded`.
+- `kind` is `tag` (U+E0000–U+E007F), `variation_selector` (U+FE00–U+FE0F, U+E0100–U+E01EF, U+180B–U+180D, U+180F) `invisible_operator` (U+2061–U+2064) or `reserved_tag_plane` (U+E0080–U+E00FF, U+E01F0–U+E0FFF: unassigned, default ignorable, so they render as nothing and can carry data). Consecutive characters of one kind form one run.
+- `offset` and `end` are UTF-16 indexes, `[offset, end)`; `count` is in code points. `line` and `column` are counted exactly as in `inspectTextDetailed` (1-based, columns in UTF-16 units, CRLF is one line break). Only tag runs have `decoded` and `decodedTruncated`.
+- `maxRuns` caps the `runs` list and, separately, the `benign` list; `counts`, `total` and `benignTotal` count everything, and `truncated` is true when either list was cut. `maxDecodedLength` caps each `decoded` string in UTF-16 units and never cuts a `<U+XXXX>` marker. Both default to no cap, and an invalid value (negative, fractional, a string) also means no cap, so set them explicitly for untrusted input. With both set, memory stays flat on any input: on 16 M characters (32 MB) of hidden text the heap grows by under 1 MB, against hundreds of MB with no caps.
 - `decodeTagText` turns U+E0020–U+E007E into the ASCII they shadow and writes any other character as `<U+XXXX>`.
 - Zero-width, bidi and other invisible characters are not runs; use `inspectTextDetailed` for those.
+- `codePointCounts` has the same keys as `counts` and counts the code points in those runs, so long runs weigh more than short ones; `supplementarySelectorCount` counts U+E0100–U+E01EF on their own, apart from the emoji selectors U+FE00–U+FE0F. Both leave out benign spans and stay exact under `maxRuns`.
+- `VERSION` is exported here and from the package root: the installed version, as in `package.json`.
+
+### `text-sanctifier/context`: `inspectTextInContext(text, options?)`
+
+`inspectTextDetailed` with context. Some invisible characters are part of ordinary text: the joiners in a family emoji, the selector in ✌ followed by VS16, an ideographic variation selector after a CJK character. This entry point reports the same findings and `counts`, marks each listed finding `benign: true` or `false`, and adds `benignCounts`, exact whether or not a finding is listed. The categories are the same.
+
+```js
+import { inspectTextInContext } from 'text-sanctifier/context';
+
+const report = inspectTextInContext(text, { maxFindings: 20 });
+const suspicious = report.counts.zero_width - report.benignCounts.zero_width; // U+200B, U+2060, stray U+200D
+```
+
+Benign, and nothing else:
+
+- U+200D between two emoji (`Extended_Pictographic`), allowing a skin-tone modifier or VS16 after the first
+- U+FE0E or U+FE0F directly after an emoji, or in a keycap (0-9, # or *, the selector, U+20E3)
+- one of U+E0100–U+E01EF directly after an ideograph
+- U+180B–U+180D or U+180F directly after a Mongolian letter
+- the tags of the England, Scotland and Wales flags
+
+U+200B, U+2060, U+FEFF, bidi controls and all other tags are never benign. Joiners in scripts that need them (ZWNJ in Persian, ZWJ in Indic scripts) are not benign yet. It needs Unicode property escapes (Node 10+, current browsers), is not in the browser file, and is about 1.7 KB gzipped on its own.
 
 ---
 
@@ -301,7 +336,7 @@ skills/review/SKILL.md:2:3  U+FE00  run of 3 variation selectors
 - Consecutive tag characters, variation selectors or invisible operators are reported once, as a run, at the first character. Tag runs are decoded: U+E0020–U+E007E become the ASCII they shadow, and other tags are shown as `<U+XXXX>`.
 - Every other invisible or control character is reported as in a plain `check`.
 - Two legitimate sequences are left out: the flags of England, Scotland and Wales (U+1F3F4, tag letters, U+E007F), and a single U+FE0E or U+FE0F after another character (text or emoji presentation). A plain `check` still reports both.
-- `--json` adds `hiddenRuns` (`{ kind, offset, line, column, codePoint, count, decoded?, decodedTruncated? }`, at most `--max-findings` per file) and `hiddenRunCount` to each file, and `hiddenRunCount` to the summary. `kind` is `tag`, `variation_selector` or `invisible_operator`; `decoded` is cut at 1000 characters. `total` and `counts` leave out the legitimate sequences.
+- `--json` adds `hiddenRuns` (`{ kind, offset, line, column, codePoint, count, decoded?, decodedTruncated? }`, at most `--max-findings` per file) and `hiddenRunCount` to each file, and `hiddenRunCount` to the summary. `kind` is `tag`, `variation_selector`, `invisible_operator` or `reserved_tag_plane`; `decoded` is cut at 1000 characters. `total` and `counts` leave out the legitimate sequences.
 
 ### SARIF output
 
@@ -321,7 +356,7 @@ The repository publishes a [pre-commit](https://pre-commit.com) hook manifest, s
 # .pre-commit-config.yaml
 repos:
   - repo: https://github.com/iWhatty/text-sanctifier
-    rev: v1.3.5  # a release tag
+    rev: v1.3.7  # a release tag
     hooks:
       - id: text-sanctifier            # every staged text file
       - id: text-sanctifier-ai-config  # agent instruction files, with --ai-config

package/bin/text-sanctifier.js

@@ -443,7 +443,7 @@ const plural = (n, word) => `${n} ${word}${n === 1 ? '' : 's'}`;
 // --- check --ai-config ---
 
 const MAX_DECODED = 1000;
-const RUN_NOUNS = { tag: 'tag character', variation_selector: 'variation selector', invisible_operator: 'invisible operator' };
+const RUN_NOUNS = { tag: 'tag character', variation_selector: 'variation selector', invisible_operator: 'invisible operator', reserved_tag_plane: 'reserved plane-14 code point' };
 
 /**
  * inspect() for agent instruction files: drops findings that belong to legitimate

package/dist/text-sanctifier.min.js

@@ -1,6 +1,6 @@
-var d=/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F\u061C\u200E\u200F\u202A-\u202E\u2066-\u2069]+/g,C=/[\u00A0\u00AD\u034F\u061C\u115F\u1160\u17B4\u17B5\u180B-\u180F\u2000-\u200F\u202A-\u202F\u205F-\u206F\u3000\u3164\uFE00-\uFE0F\uFEFF\uFFA0\uFFF0-\uFFF8\u{1BCA0}-\u{1BCA3}\u{1D173}-\u{1D17A}\u{E0000}-\u{E0FFF}]+/gu;function I(e){return e<8192?R(e):N(e)}function R(e){return e<174?e<32?e<11?e<1?"nul":e<9?"c0_control":null:e<13?"c0_control":e<14?null:"c0_control":e<160?e<127?null:e<128?"c0_control":"c1_control":e<161?"nonbreaking_space":e<173?null:"invisible_format":e<4449?e<1564?e<847?null:e<848?"invisible_format":null:e<1565?"bidi_control":e<4447?null:"hangul_filler":e<6155?e<6068?null:e<6070?"invisible_format":null:e<6159?e<6158?"variation_selector":"invisible_format":e<6160?"variation_selector":null}function N(e){return e<8304?e<8240?e<8208?e<8203?"nonbreaking_space":e<8206?"zero_width":"bidi_control":e<8234?null:e<8239?"bidi_control":"nonbreaking_space":e<8289?e<8287?null:e<8288?"nonbreaking_space":"zero_width":e<8294?"invisible_format":e<8298?"bidi_control":"invisible_format":e<65040?e<12644?e<12288?null:e<12289?"nonbreaking_space":null:e<12645?"hangul_filler":e<65024?null:"variation_selector":e<65440?e<65279?null:e<65280?"bom":null:e<65520?e<65441?"hangul_filler":null:e<65529?"invisible_format":null}function b(e){return e<917504?e<113828?e<113824?null:"invisible_format":e<119155?null:e<119163?"invisible_format":null:e<917760?e<917632?"tag":"invisible_format":e<918e3?"variation_selector":e<921600?"invisible_format":null}function h(e={}){let r=!!e.normalizeSpaces,n=!!e.purgeZeroWidthSpaces,o=!!e.purgeInvisibleChars,u=!!e.purgeEmojis,i=!!e.nukeControls,l=!!e.keyboardOnlyFilter,c=!!e.normalizeNewlines,f=!!e.trimSpacesAroundNewlines,a=!!e.collapseNewLines,g=!!e.preserveParagraphs,s=!!e.collapseSpaces,E=!!e.finalTrim,F=Number.isFinite(e.maxLength)&&e.maxLength>=0?e.maxLength:1/0,x=e.onMaxLength==="truncate"||e.onMaxLength==="noop"||e.onMaxLength==="throw"?e.onMaxLength:"throw";return t=>_(t,o,u,i,l,c,f,a,g,s,E,F,x,r,n)}h.strict=e=>_(e,!0,!0,!0,!1,!0,!0,!0,!1,!0,!0);h.loose=e=>_(e,!1,!1,!1,!1,!0,!0,!0,!0,!0,!0);h.keyboardOnlyEmoji=e=>_(e,!1,!1,!1,!0,!0,!0,!1,!1,!1,!0);h.keyboardOnly=e=>_(e,!0,!0,!0,!0,!0,!0,!0,!1,!0,!0);h.pasted=e=>_(e,!1,!1,!1,!1,!0,!1,!1,!1,!1,!1,1/0,"throw",!0,!0);function _(e,r=!1,n=!1,o=!1,u=!1,i=!1,l=!1,c=!1,f=!1,a=!1,g=!1,s=1/0,E="throw",F=!1,x=!1){if(typeof e!="string")throw new TypeError("sanctifyText expects a string input.");if(E!=="truncate"&&E!=="noop"&&E!=="throw"&&(E="throw"),e.length>s)switch(E){case"truncate":e=e.slice(0,s);break;case"noop":return e;case"throw":default:throw new RangeError(`sanctifyText input length ${e.length} exceeds maxLength ${s}.`)}let t=e;return F&&(t=t.replace(T," ")),x&&(t=t.replace(L,"")),r&&(t=v(t)),n&&(t=z(t)),o&&(t=q(t)),u&&(t=B(t,n)),i&&(t=H(t)),l&&(t=O(t)),c&&(t=Z(t,f)),a&&(t=V(t)),g?t.trim():t}var T=/[\u00A0\u2000-\u200A\u202F\u205F]/g,L=/[\u200B\u2060\uFEFF]/g;function v(e){return e.replace(C,"")}function D(e){if(p.lastIndex=0,!p.test(e))return"";p.lastIndex=0;let r="";for(let n of e.matchAll(p))r+=n[0];return r}var S=/[^\x20-\x7E\r\n]+/gu;function B(e,r=!1){let n=A(e);return r?n.replace(S,""):n.replace(S,o=>D(o))}var G=/[\u2018\u2019\u201A\u201B\u2032\u2035]/g,X=/[\u201C\u201D\u201E\u201F\u2033\u2036\u00AB\u00BB]/g,k=/[\u2012\u2013\u2014\u2015\u2212]/g,U=/\u2026/g,M=/[\u2022\u00B7]/g,P=/[\uFF01-\uFF5E]/g;function A(e){return e.replace(G,"'").replace(X,'"').replace(k,"-").replace(U,"...").replace(M,"*").replace(P,r=>String.fromCharCode(r.charCodeAt(0)-65248))}var p;try{p=new RegExp("(?:\\p{Extended_Pictographic}(?:\\uFE0F|\\uFE0E)?(?:\\u200D(?:\\p{Extended_Pictographic}|\\w)+)*)","gu")}catch{p=/[\u{2700}-\u{27BF}\u{1F300}-\u{1FAFF}\u{1F3FB}-\u{1F3FF}\u200D\uFE0F\u{1F1E6}-\u{1F1FF}]/gu}function z(e){return e.replace(p,"")}var j=/\r\n|\r|\n/g;function H(e,r=`
-`){return e.replace(j,r)}var K=/[ \t]*(\n+)[ \t]*/g;function O(e){return e.replace(K,"$1")}var W=/\n{2,}/g,J=/\n{3,}/g;function Z(e,r){return r?e.replace(J,`
+var y=/[\u0000-\u0008\u000B\u000C\u000E-\u001F\u007F-\u009F\u061C\u200E\u200F\u202A-\u202E\u2066-\u2069]+/g,d=/[\u00A0\u00AD\u034F\u061C\u115F\u1160\u17B4\u17B5\u180B-\u180F\u2000-\u200F\u202A-\u202F\u205F-\u206F\u3000\u3164\uFE00-\uFE0F\uFEFF\uFFA0\uFFF0-\uFFF8\u{1BCA0}-\u{1BCA3}\u{1D173}-\u{1D17A}\u{E0000}-\u{E0FFF}]+/gu;function A(e){return e<8192?D(e):v(e)}function D(e){return e<174?e<32?e<11?e<1?"nul":e<9?"c0_control":null:e<13?"c0_control":e<14?null:"c0_control":e<160?e<127?null:e<128?"c0_control":"c1_control":e<161?"nonbreaking_space":e<173?null:"invisible_format":e<4449?e<1564?e<847?null:e<848?"invisible_format":null:e<1565?"bidi_control":e<4447?null:"hangul_filler":e<6155?e<6068?null:e<6070?"invisible_format":null:e<6159?e<6158?"variation_selector":"invisible_format":e<6160?"variation_selector":null}function v(e){return e<8304?e<8240?e<8208?e<8203?"nonbreaking_space":e<8206?"zero_width":"bidi_control":e<8234?null:e<8239?"bidi_control":"nonbreaking_space":e<8289?e<8287?null:e<8288?"nonbreaking_space":"zero_width":e<8294?"invisible_format":e<8298?"bidi_control":"invisible_format":e<65040?e<12644?e<12288?null:e<12289?"nonbreaking_space":null:e<12645?"hangul_filler":e<65024?null:"variation_selector":e<65440?e<65279?null:e<65280?"bom":null:e<65520?e<65441?"hangul_filler":null:e<65529?"invisible_format":null}function I(e){return e<917504?e<113828?e<113824?null:"invisible_format":e<119155?null:e<119163?"invisible_format":null:e<917760?e<917632?"tag":"invisible_format":e<918e3?"variation_selector":e<921600?"invisible_format":null}var g=/[^\x20-\x7E\r\n]+/gu,B=/[\u2018\u2019\u201A\u201B\u2032\u2035]/g,G=/[\u201C\u201D\u201E\u201F\u2033\u2036\u00AB\u00BB]/g,X=/[\u2012\u2013\u2014\u2015\u2212]/g,k=/\u2026/g,O=/[\u2022\u00B7]/g,P=/[\uFF01-\uFF5E]/g;function S(e){return e.replace(B,"'").replace(G,'"').replace(X,"-").replace(k,"...").replace(O,"*").replace(P,r=>String.fromCharCode(r.charCodeAt(0)-65248))}function M(){try{return new RegExp("(?:\\p{Extended_Pictographic}(?:\\uFE0F|\\uFE0E)?(?:\\u200D(?:\\p{Extended_Pictographic}|\\w)+)*)","gu")}catch{return/[\u{2700}-\u{27BF}\u{1F300}-\u{1FAFF}\u{1F3FB}-\u{1F3FF}\u200D\uFE0F\u{1F1E6}-\u{1F1FF}]/gu}}var x=M();function m(e,r){return e.lastIndex=0,e.test(r)}function U(e){let r=S(e);if(!m(g,r))return!1;for(let n of r)if(!(n===`
+`||n==="\r"||n>=" "&&n<="~")&&!m(x,n))return!0;return!1}function j(e){if(typeof e!="string")throw new TypeError("inspectText expects a string input.");let r=[],n={hasControlChars:!1,hasInvisibleChars:!1,hasMixedNewlines:!1,newlineStyle:null,hasEmojis:!1,hasNonKeyboardChars:!1,summary:r},u=(s,c,f)=>{s&&(n[c]=!0,r.push(f))};u(m(y,e),"hasControlChars","Control characters detected."),u(m(d,e),"hasInvisibleChars","Invisible Unicode characters detected."),u(m(x,e),"hasEmojis","Emojis detected.");let{mixed:o,types:i}=b(e);return n.hasMixedNewlines=o,n.newlineStyle=o?"Mixed":i[0]||null,n.newlineStyle&&r.push(o?"Mixed newline styles detected.":`Consistent newline style: ${n.newlineStyle}`),u(U(e),"hasNonKeyboardChars","Non-keyboard characters detected."),n}var z=100;function C(e,r={}){if(typeof e!="string")throw new TypeError("inspectTextDetailed expects a string input.");let n=r&&r.maxFindings,u=n===1/0||Number.isInteger(n)&&n>=0?n:z,o={bidi_control:0,zero_width:0,nonbreaking_space:0,bom:0,nul:0,c0_control:0,c1_control:0,invisible_format:0,hangul_filler:0,variation_selector:0,tag:0},i=[],s=0,c=1,f=0;for(let a=0,h=e.length;a<h;a++){let l=e.charCodeAt(a);if(l>=32&&l<127)continue;if(l===10){c++,f=a+1;continue}if(l===13){e.charCodeAt(a+1)!==10&&(c++,f=a+1);continue}let E=a,F=l,p;if(l>=55296&&l<=56319){let t=e.charCodeAt(a+1);if(!(t>=56320&&t<=57343))continue;F=65536+(l-55296<<10)+(t-56320),p=I(F),a++}else p=A(l);if(p!==null&&(o[p]++,s++,i.length<u)){let t={offset:E,line:c,column:E-f+1,codePoint:F,category:p};p==="bom"&&(t.atStart=E===0),i.push(t)}}return{findings:i,counts:o,total:s,truncated:s>i.length}}function b(e){if(typeof e!="string")throw new TypeError("getNewlineStats expects a string input.");let r=0,n=0,u=0;for(let s=0,c=e.length;s<c;s++){let f=e.charCodeAt(s);f===13?e.charCodeAt(s+1)===10?(r++,s++):n++:f===10&&u++}let o={crlf:r,cr:n,lf:u},i=[];return o.crlf>0&&i.push("CRLF"),o.cr>0&&i.push("CR"),o.lf>0&&i.push("LF"),{...o,types:i,mixed:i.length>1}}function K(e){return{purgeInvisibleChars:e.hasInvisibleChars,purgeEmojis:e.hasEmojis,nukeControls:e.hasControlChars,keyboardOnlyFilter:e.hasNonKeyboardChars,normalizeNewlines:e.hasMixedNewlines||e.newlineStyle==="CRLF"||e.newlineStyle==="CR"}}function H(e={}){let r=!!e.normalizeSpaces,n=!!e.purgeZeroWidthSpaces,u=!!e.purgeInvisibleChars,o=!!e.purgeEmojis,i=!!e.nukeControls,s=!!e.keyboardOnlyFilter,c=!!e.normalizeNewlines,f=!!e.trimSpacesAroundNewlines,a=!!e.collapseNewLines,h=!!e.preserveParagraphs,l=!!e.collapseSpaces,E=!!e.finalTrim,F=Number.isFinite(e.maxLength)&&e.maxLength>=0?e.maxLength:1/0,p=e.onMaxLength==="truncate"||e.onMaxLength==="noop"||e.onMaxLength==="throw"?e.onMaxLength:"throw";return t=>_(t,u,o,i,s,c,f,a,h,l,E,F,p,r,n)}function R(e){return _(e,!0,!0,!0,!1,!0,!0,!0,!1,!0,!0)}function w(e){return _(e,!1,!1,!1,!1,!0,!0,!0,!0,!0,!0)}function N(e){return _(e,!1,!1,!1,!0,!0,!0,!1,!1,!1,!0)}function T(e){return _(e,!0,!0,!0,!0,!0,!0,!0,!1,!0,!0)}function L(e){return _(e,!1,!1,!1,!1,!0,!1,!1,!1,!1,!1,1/0,"throw",!0,!0)}var W=Object.assign(H,{strict:R,loose:w,keyboardOnlyEmoji:N,keyboardOnly:T,pasted:L});function _(e,r=!1,n=!1,u=!1,o=!1,i=!1,s=!1,c=!1,f=!1,a=!1,h=!1,l=1/0,E="throw",F=!1,p=!1){if(typeof e!="string")throw new TypeError("sanctifyText expects a string input.");if(E!=="truncate"&&E!=="noop"&&E!=="throw"&&(E="throw"),e.length>l)switch(E){case"truncate":e=e.slice(0,l);break;case"noop":return e;case"throw":default:throw new RangeError(`sanctifyText input length ${e.length} exceeds maxLength ${l}.`)}let t=e;return F&&(t=t.replace(J," ")),p&&(t=t.replace(V,"")),r&&(t=Z(t)),n&&(t=q(t)),u&&(t=le(t)),o&&(t=Y(t,n)),i&&(t=ee(t)),s&&(t=ne(t)),c&&(t=oe(t,f)),a&&(t=se(t)),h?t.trim():t}var J=/[\u00A0\u2000-\u200A\u202F\u205F]/g,V=/[\u200B\u2060\uFEFF]/g;function Z(e){return e.replace(d,"")}function $(e){if(x.lastIndex=0,!x.test(e))return"";x.lastIndex=0;let r="";for(let n of e.matchAll(x))r+=n[0];return r}function Y(e,r=!1){let n=S(e);return r?n.replace(g,""):n.replace(g,u=>$(u))}function q(e){return e.replace(x,"")}var Q=/\r\n|\r|\n/g;function ee(e,r=`
+`){return e.replace(Q,r)}var re=/[ \t]*(\n+)[ \t]*/g;function ne(e){return e.replace(re,"$1")}var te=/\n{2,}/g,ie=/\n{3,}/g;function oe(e,r){return r?e.replace(ie,`
 
-`):e.replace(W,`
-`)}var $=/ {2,}/g;function V(e){return e.replace($," ")}function q(e){return e.replace(d,"")}function m(e,r){return e.lastIndex=0,e.test(r)}function Q(e){let r=A(e);if(!m(S,r))return!1;for(let n of r)if(!(n===`
-`||n==="\r"||n>=" "&&n<="~")&&!m(p,n))return!0;return!1}function Y(e){if(typeof e!="string")throw new TypeError("inspectText expects a string input.");let r=[],n={hasControlChars:!1,hasInvisibleChars:!1,hasMixedNewlines:!1,newlineStyle:null,hasEmojis:!1,hasNonKeyboardChars:!1,summary:r},o=(l,c,f)=>{l&&(n[c]=!0,r.push(f))};o(m(d,e),"hasControlChars","Control characters detected."),o(m(C,e),"hasInvisibleChars","Invisible Unicode characters detected."),o(m(p,e),"hasEmojis","Emojis detected.");let{mixed:u,types:i}=w(e);return n.hasMixedNewlines=u,n.newlineStyle=u?"Mixed":i[0]||null,n.newlineStyle&&r.push(u?"Mixed newline styles detected.":`Consistent newline style: ${n.newlineStyle}`),o(Q(e),"hasNonKeyboardChars","Non-keyboard characters detected."),n}var ee=100;function y(e,r={}){if(typeof e!="string")throw new TypeError("inspectTextDetailed expects a string input.");let n=r&&r.maxFindings,o=n===1/0||Number.isInteger(n)&&n>=0?n:ee,u={bidi_control:0,zero_width:0,nonbreaking_space:0,bom:0,nul:0,c0_control:0,c1_control:0,invisible_format:0,hangul_filler:0,variation_selector:0,tag:0},i=[],l=0,c=1,f=0;for(let a=0,g=e.length;a<g;a++){let s=e.charCodeAt(a);if(s>=32&&s<127)continue;if(s===10){c++,f=a+1;continue}if(s===13){e.charCodeAt(a+1)!==10&&(c++,f=a+1);continue}let E=a,F=s,x;if(s>=55296&&s<=56319){let t=e.charCodeAt(a+1);if(!(t>=56320&&t<=57343))continue;F=65536+(s-55296<<10)+(t-56320),x=b(F),a++}else x=I(s);if(x!==null&&(u[x]++,l++,i.length<o)){let t={offset:E,line:c,column:E-f+1,codePoint:F,category:x};x==="bom"&&(t.atStart=E===0),i.push(t)}}return{findings:i,counts:u,total:l,truncated:l>i.length}}function w(e){if(typeof e!="string")throw new TypeError("getNewlineStats expects a string input.");let r=0,n=0,o=0;for(let l=0,c=e.length;l<c;l++){let f=e.charCodeAt(l);f===13?e.charCodeAt(l+1)===10?(r++,l++):n++:f===10&&o++}let u={crlf:r,cr:n,lf:o},i=[];return u.crlf>0&&i.push("CRLF"),u.cr>0&&i.push("CR"),u.lf>0&&i.push("LF"),{...u,types:i,mixed:i.length>1}}function re(e){return{purgeInvisibleChars:e.hasInvisibleChars,purgeEmojis:e.hasEmojis,nukeControls:e.hasControlChars,keyboardOnlyFilter:e.hasNonKeyboardChars,normalizeNewlines:e.hasMixedNewlines||e.newlineStyle==="CRLF"||e.newlineStyle==="CR"}}function ne(e,r={}){if(typeof e!="string")throw new TypeError("revealInvisible expects a string input.");let n=r&&typeof r.format=="function"?r.format:i=>"<U+"+i.toString(16).toUpperCase().padStart(4,"0")+">",o="",u=0;for(let i of y(e,{maxFindings:1/0}).findings)o+=e.slice(u,i.offset)+n(i.codePoint,i.category),u=i.offset+(i.codePoint>65535?2:1);return o+e.slice(u)}export{w as getNewlineStats,re as getRecommendedSanctifierOptions,Y as inspectText,y as inspectTextDetailed,ne as revealInvisible,h as summonSanctifier};
+`):e.replace(te,`
+`)}var ue=/ {2,}/g;function se(e){return e.replace(ue," ")}function le(e){return e.replace(y,"")}function ae(e,r={}){if(typeof e!="string")throw new TypeError("revealInvisible expects a string input.");let n=r&&typeof r.format=="function"?r.format:i=>"<U+"+i.toString(16).toUpperCase().padStart(4,"0")+">",u="",o=0;for(let i of C(e,{maxFindings:1/0}).findings)u+=e.slice(o,i.offset)+n(i.codePoint,i.category),o=i.offset+(i.codePoint>65535?2:1);return u+e.slice(o)}var fe="1.3.7";export{fe as VERSION,b as getNewlineStats,K as getRecommendedSanctifierOptions,j as inspectText,C as inspectTextDetailed,ae as revealInvisible,T as sanctifyKeyboardOnly,N as sanctifyKeyboardOnlyEmoji,w as sanctifyLoose,L as sanctifyPasted,R as sanctifyStrict,W as summonSanctifier};

package/dist/types/context.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Locates invisible and control characters as inspectTextDetailed does, and marks
+ * the ones that belong to legitimate sequences as benign:
+ * - U+200D between two emoji (Extended_Pictographic), allowing a skin-tone modifier or
+ *   VS16 after the first: an emoji ZWJ sequence
+ * - U+FE0E or U+FE0F directly after an emoji, or between 0-9, # or * and U+20E3 (keycap)
+ * - one of U+E0100–U+E01EF directly after an ideograph: an ideographic variation sequence
+ * - U+180B–U+180D or U+180F directly after a Mongolian letter
+ * - the tags of the England, Scotland and Wales flags after U+1F3F4
+ * Nothing else is benign: not U+200B, U+2060, U+FEFF, bidi controls or other tags.
+ *
+ * `counts`, `total` and `truncated` are exactly those of inspectTextDetailed;
+ * `benignCounts` counts every benign character, listed or not. Two passes over the
+ * string, no copy; memory is flat with `maxFindings` set.
+ *
+ * @param {string} text
+ * @param {InspectDetailedOptions} [options]
+ * @returns {ContextReport}
+ */
+export function inspectTextInContext(text: string, options?: InspectDetailedOptions): ContextReport;
+export type TrashFinding = import("./inspectText.js").TrashFinding;
+export type TrashCounts = import("./inspectText.js").TrashCounts;
+export type InspectDetailedOptions = import("./inspectText.js").InspectDetailedOptions;
+/**
+ * A finding with `benign`: true when the character is part of a legitimate sequence.
+ */
+export type ContextFinding = TrashFinding & {
+    benign: boolean;
+};
+export type ContextReport = {
+    /**
+     * - As in inspectTextDetailed, each with `benign`.
+     */
+    findings: ContextFinding[];
+    /**
+     * - As in inspectTextDetailed: every occurrence, benign or not.
+     */
+    counts: TrashCounts;
+    /**
+     * - Sum of `counts`.
+     */
+    total: number;
+    /**
+     * - True when `total` exceeds `findings.length`.
+     */
+    truncated: boolean;
+    /**
+     * - Benign occurrences per category, listed or not.
+     * `counts[c] - benignCounts[c]` is the number of suspicious characters in category `c`.
+     */
+    benignCounts: TrashCounts;
+    /**
+     * - Sum of `benignCounts`.
+     */
+    benignTotal: number;
+};

package/dist/types/hiddenText.d.ts

@@ -7,17 +7,26 @@
  */
 export function decodeTagText(text: string): string;
 /**
- * Finds runs of tag characters, variation selectors and invisible operators.
+ * Finds runs of tag characters, variation selectors, invisible operators and reserved
+ * tag-plane code points (U+E0080–U+E00FF, U+E01F0–U+E0FFF).
  * Consecutive characters of the same kind form one run. Two kinds of sequence are
  * legitimate and listed under `benign` instead of `runs`:
  *  - the subdivision flags of England, Scotland and Wales: U+1F3F4 followed by the
  *    tags for "gbeng", "gbsct" or "gbwls" and U+E007F
  *  - a single U+FE0E or U+FE0F (text or emoji presentation) after another character
+ *
+ * `line` and `column` are counted as in inspectTextDetailed. Every run and benign
+ * span is counted; only the first `maxRuns` of each are listed. With the caps set,
+ * memory stays flat however large the input is. One pass over the string, no copy.
+ * Set both caps for untrusted input: without them, results grow with the input.
+ *
  * @param {string} text
+ * @param {HiddenScanOptions} [options]
  * @returns {HiddenTextScan}
  */
-export function findHiddenRuns(text: string): HiddenTextScan;
-export type HiddenRunKind = "tag" | "variation_selector" | "invisible_operator";
+export function findHiddenRuns(text: string, options?: HiddenScanOptions): HiddenTextScan;
+export { VERSION } from "./version.generated.js";
+export type HiddenRunKind = "tag" | "variation_selector" | "invisible_operator" | "reserved_tag_plane";
 export type HiddenRun = {
     kind: HiddenRunKind;
     /**
@@ -33,18 +42,74 @@ export type HiddenRun = {
      */
     count: number;
     /**
-     * - tag runs only: the ASCII the tags spell (see decodeTagText)
+     * - 1-based line of the first character (as in inspectTextDetailed)
+     */
+    line: number;
+    /**
+     * - 1-based column of the first character, in UTF-16 units
+     */
+    column: number;
+    /**
+     * - tag runs only: the ASCII the tags spell (see decodeTagText),
+     * at most `maxDecodedLength` UTF-16 units
      */
     decoded?: string;
+    /**
+     * - tag runs only: true when `decoded` stops short of the run
+     */
+    decodedTruncated?: boolean;
+};
+export type HiddenRunCounts = {
+    tag: number;
+    variation_selector: number;
+    invisible_operator: number;
+    reserved_tag_plane: number;
 };
 export type HiddenTextScan = {
     /**
-     * - runs that may hide text, in order
+     * - runs that may hide text, in order, at most `maxRuns` long
      */
     runs: HiddenRun[];
     /**
      * - [offset, end) spans of legitimate
-     * sequences (subdivision flags, a single emoji or text presentation selector)
+     * sequences (subdivision flags, a single emoji or text presentation selector), at most `maxRuns` long
      */
     benign: Array<[number, number]>;
+    /**
+     * - every run per kind, listed or not
+     */
+    counts: HiddenRunCounts;
+    /**
+     * - code points in those runs per kind, listed or not
+     */
+    codePointCounts: HiddenRunCounts;
+    /**
+     * - code points U+E0100–U+E01EF in those runs, which
+     * (unlike the emoji selectors U+FE00–U+FE0F) can carry data; included in codePointCounts.variation_selector
+     */
+    supplementarySelectorCount: number;
+    /**
+     * - sum of `counts`
+     */
+    total: number;
+    /**
+     * - every benign span, listed or not
+     */
+    benignTotal: number;
+    /**
+     * - true when runs or benign spans were left out of the lists
+     */
+    truncated: boolean;
+};
+export type HiddenScanOptions = {
+    /**
+     * - cap on listed runs, and separately on listed benign spans
+     * (non-negative integer or Infinity). Counts stay exact.
+     */
+    maxRuns?: number;
+    /**
+     * - cap on each run's `decoded` text, in UTF-16 units.
+     * For both, any other value (negative, fractional, NaN, a string) means the default, no cap.
+     */
+    maxDecodedLength?: number;
 };

package/dist/types/index.d.ts

@@ -12,5 +12,11 @@ import { inspectTextDetailed } from './inspectText.js';
 import { getNewlineStats } from './inspectText.js';
 import { getRecommendedSanctifierOptions } from './inspectText.js';
 import { summonSanctifier } from './sanctifyText.js';
+import { sanctifyStrict } from './sanctifyText.js';
+import { sanctifyLoose } from './sanctifyText.js';
+import { sanctifyKeyboardOnlyEmoji } from './sanctifyText.js';
+import { sanctifyKeyboardOnly } from './sanctifyText.js';
+import { sanctifyPasted } from './sanctifyText.js';
 import { revealInvisible } from './reveal.js';
-export { inspectText, inspectTextDetailed, getNewlineStats, getRecommendedSanctifierOptions, summonSanctifier, revealInvisible };
+import { VERSION } from './version.generated.js';
+export { inspectText, inspectTextDetailed, getNewlineStats, getRecommendedSanctifierOptions, summonSanctifier, sanctifyStrict, sanctifyLoose, sanctifyKeyboardOnlyEmoji, sanctifyKeyboardOnly, sanctifyPasted, revealInvisible, VERSION };

package/dist/types/sanctifyText.d.ts

@@ -1,103 +1,51 @@
 /**
- * @typedef {Object} SanctifyOptions
- * @property {boolean} [purgeInvisibleChars]
- * @property {boolean} [purgeEmojis]
- * @property {boolean} [nukeControls]
- * @property {boolean} [keyboardOnlyFilter]
- * @property {boolean} [normalizeNewlines]
- * @property {boolean} [trimSpacesAroundNewlines]
- * @property {boolean} [collapseNewLines]
- * @property {boolean} [preserveParagraphs]
- * @property {boolean} [collapseSpaces]
- * @property {boolean} [finalTrim]
- * @property {number} [maxLength]
- * @property {'throw'|'truncate'|'noop'} [onMaxLength]
- * @property {boolean} [normalizeSpaces] - Replace look-alike spaces with an ordinary space (runs first).
- * @property {boolean} [purgeZeroWidthSpaces] - Remove U+200B, U+2060 and U+FEFF only, keeping joiners and selectors.
+ * Strict sanitizer:
+ * - Purge emojis
+ * - Collapse all newlines
+ * - Collapse spaces
+ * - Nuke control characters
+ * @param {string} text
+ * @returns {string}
  */
+export function sanctifyStrict(text: string): string;
 /**
- * Summons a customized sanctifier function with pre-bound booleans.
- *
- * Accepts full flag names and returns a text-cleaning function.
- *
- * @param {Object} [defaultOptions={}]
- * @param {boolean} [defaultOptions.purgeInvisibleChars]
- * @param {boolean} [defaultOptions.purgeEmojis]
- * @param {boolean} [defaultOptions.nukeControls]
- * @param {boolean} [defaultOptions.keyboardOnlyFilter]
- * @param {boolean} [defaultOptions.normalizeNewlines]
- * @param {boolean} [defaultOptions.trimSpacesAroundNewlines]
- * @param {boolean} [defaultOptions.collapseNewLines]
- * @param {boolean} [defaultOptions.preserveParagraphs]
- * @param {boolean} [defaultOptions.collapseSpaces]
- * @param {boolean} [defaultOptions.finalTrim]
- * @param {number} [defaultOptions.maxLength=Infinity] - Hard input length cap (UTF-16 code units).
- * @param {'throw' | 'truncate' | 'noop'} [defaultOptions.onMaxLength='throw'] - Behavior when input exceeds maxLength.
- * @param {boolean} [defaultOptions.normalizeSpaces]
- * @param {boolean} [defaultOptions.purgeZeroWidthSpaces]
- * @returns {(text: string) => string}
+ * Loose sanitizer:
+ * - Collapse spaces
+ * - Preserve paragraphs
+ * - Normalize newlines
+ * @param {string} text
+ * @returns {string}
  */
-export function summonSanctifier(defaultOptions?: {
-    purgeInvisibleChars?: boolean;
-    purgeEmojis?: boolean;
-    nukeControls?: boolean;
-    keyboardOnlyFilter?: boolean;
-    normalizeNewlines?: boolean;
-    trimSpacesAroundNewlines?: boolean;
-    collapseNewLines?: boolean;
-    preserveParagraphs?: boolean;
-    collapseSpaces?: boolean;
-    finalTrim?: boolean;
-    maxLength?: number;
-    onMaxLength?: "throw" | "truncate" | "noop";
-    normalizeSpaces?: boolean;
-    purgeZeroWidthSpaces?: boolean;
-}): (text: string) => string;
-export namespace summonSanctifier {
-    /**
-     * Strict sanitizer:
-     * - Purge emojis
-     * - Collapse all newlines
-     * - Collapse spaces
-     * - Nuke control characters
-     */
-    /** @param {string} text @returns {string} */
-    function strict(text: string): string;
-    /**
-     * Loose sanitizer:
-     * - Collapse spaces
-     * - Preserve paragraphs
-     * - Normalize newlines
-     */
-    /** @param {string} text @returns {string} */
-    function loose(text: string): string;
-    /**
-     * Keyboard-only (with emojis):
-     * - Keeps emojis and printable ASCII
-     * - Strips non-standard characters
-     * - Normalizes typographic trash
-     */
-    /** @param {string} text @returns {string} */
-    function keyboardOnlyEmoji(text: string): string;
-    /**
-     * Keyboard-only (strict):
-     * - Removes emojis
-     * - Collapses all whitespace
-     * - Restricts to printable ASCII only
-     */
-    /** @param {string} text @returns {string} */
-    function keyboardOnly(text: string): string;
-    /**
-     * Pasted text and model output:
-     * - Look-alike spaces (NBSP, narrow NBSP, typographic spaces) become ordinary spaces,
-     *   so words never run together
-     * - Zero-width spaces, word joiners and BOMs are removed
-     * - Newlines are normalized to `\n`
-     * Keeps emoji joiners, variation selectors, bidi marks, indentation and line breaks.
-     */
-    /** @param {string} text @returns {string} */
-    function pasted(text: string): string;
-}
+export function sanctifyLoose(text: string): string;
+/**
+ * Keyboard-only (with emojis):
+ * - Keeps emojis and printable ASCII
+ * - Strips non-standard characters
+ * - Normalizes typographic trash
+ * @param {string} text
+ * @returns {string}
+ */
+export function sanctifyKeyboardOnlyEmoji(text: string): string;
+/**
+ * Keyboard-only (strict):
+ * - Removes emojis
+ * - Collapses all whitespace
+ * - Restricts to printable ASCII only
+ * @param {string} text
+ * @returns {string}
+ */
+export function sanctifyKeyboardOnly(text: string): string;
+/**
+ * Pasted text and model output:
+ * - Look-alike spaces (NBSP, narrow NBSP, typographic spaces) become ordinary spaces,
+ *   so words never run together
+ * - Zero-width spaces, word joiners and BOMs are removed
+ * - Newlines are normalized to `\n`
+ * Keeps emoji joiners, variation selectors, bidi marks, indentation and line breaks.
+ * @param {string} text
+ * @returns {string}
+ */
+export function sanctifyPasted(text: string): string;
 /**
  * Text Sanctifier
  *
@@ -131,11 +79,45 @@ export namespace summonSanctifier {
  */
 export function sanctifyText(text: string, purgeInvisibleChars?: boolean, purgeEmojis?: boolean, nukeControls?: boolean, keyboardOnlyFilter?: boolean, normalizeNewlines?: boolean, trimSpacesAroundNewlines?: boolean, collapseNewLines?: boolean, preserveParagraphs?: boolean, collapseSpaces?: boolean, finalTrim?: boolean, maxLength?: number, onMaxLength?: "throw" | "truncate" | "noop", normalizeSpaces?: boolean, purgeZeroWidthSpaces?: boolean): string;
 /**
- * Normalizes typographic Unicode punctuation into ASCII equivalents.
- * @param {string} text
- * @returns {string}
+ * Summons a customized sanctifier function with pre-bound booleans.
+ *
+ * Accepts full flag names and returns a text-cleaning function.
+ *
+ * @param {Object} [defaultOptions={}]
+ * @param {boolean} [defaultOptions.purgeInvisibleChars]
+ * @param {boolean} [defaultOptions.purgeEmojis]
+ * @param {boolean} [defaultOptions.nukeControls]
+ * @param {boolean} [defaultOptions.keyboardOnlyFilter]
+ * @param {boolean} [defaultOptions.normalizeNewlines]
+ * @param {boolean} [defaultOptions.trimSpacesAroundNewlines]
+ * @param {boolean} [defaultOptions.collapseNewLines]
+ * @param {boolean} [defaultOptions.preserveParagraphs]
+ * @param {boolean} [defaultOptions.collapseSpaces]
+ * @param {boolean} [defaultOptions.finalTrim]
+ * @param {number} [defaultOptions.maxLength=Infinity] - Hard input length cap (UTF-16 code units).
+ * @param {'throw' | 'truncate' | 'noop'} [defaultOptions.onMaxLength='throw'] - Behavior when input exceeds maxLength.
+ * @param {boolean} [defaultOptions.normalizeSpaces]
+ * @param {boolean} [defaultOptions.purgeZeroWidthSpaces]
+ * @returns {(text: string) => string}
+ *
+ * The presets are attached as properties (`summonSanctifier.strict`, `.loose`,
+ * `.keyboardOnlyEmoji`, `.keyboardOnly`, `.pasted`) and are also standalone exports.
+ * Built in a call marked pure, so a bundle that imports only a preset leaves it out.
+ * @type {typeof createSanctifier & {
+ *   strict: typeof sanctifyStrict,
+ *   loose: typeof sanctifyLoose,
+ *   keyboardOnlyEmoji: typeof sanctifyKeyboardOnlyEmoji,
+ *   keyboardOnly: typeof sanctifyKeyboardOnly,
+ *   pasted: typeof sanctifyPasted,
+ * }}
  */
-export function normalizeTypographicJank(text: string): string;
+export const summonSanctifier: typeof createSanctifier & {
+    strict: typeof sanctifyStrict;
+    loose: typeof sanctifyLoose;
+    keyboardOnlyEmoji: typeof sanctifyKeyboardOnlyEmoji;
+    keyboardOnly: typeof sanctifyKeyboardOnly;
+    pasted: typeof sanctifyPasted;
+};
 /**
  * Look-alike spaces: the `nonbreaking_space` category except U+3000, the ordinary
  * space of CJK text. A test checks this against the category table.
@@ -143,15 +125,6 @@ export function normalizeTypographicJank(text: string): string;
 export const SPACE_LOOKALIKES_REGEX: RegExp;
 /** Zero-width space, word joiner and BOM: invisible and never needed in plain text. */
 export const ZERO_WIDTH_SPACES_REGEX: RegExp;
-/**
- * Matches any character that is NOT:
- * - Printable ASCII (U+0020–U+007E)
- * - Newline characters: \n (LF), \r (CR)
- * This allows for \n, \r, and \r\n line endings.
- */
-export const ASCII_KEYBOARD_SAFE_REGEX: RegExp;
-/** @type {RegExp} */
-export let EMOJI_REGEX: RegExp;
 export type SanctifyOptions = {
     purgeInvisibleChars?: boolean;
     purgeEmojis?: boolean;
@@ -176,4 +149,62 @@ export type SanctifyOptions = {
 };
 import { CONTROL_CHARS_REGEX } from './categories.generated.js';
 import { INVISIBLE_TRASH_REGEX } from './categories.generated.js';
-export { CONTROL_CHARS_REGEX, INVISIBLE_TRASH_REGEX };
+import { ASCII_KEYBOARD_SAFE_REGEX } from './textPatterns.js';
+import { EMOJI_REGEX } from './textPatterns.js';
+import { normalizeTypographicJank } from './textPatterns.js';
+/**
+ * @typedef {Object} SanctifyOptions
+ * @property {boolean} [purgeInvisibleChars]
+ * @property {boolean} [purgeEmojis]
+ * @property {boolean} [nukeControls]
+ * @property {boolean} [keyboardOnlyFilter]
+ * @property {boolean} [normalizeNewlines]
+ * @property {boolean} [trimSpacesAroundNewlines]
+ * @property {boolean} [collapseNewLines]
+ * @property {boolean} [preserveParagraphs]
+ * @property {boolean} [collapseSpaces]
+ * @property {boolean} [finalTrim]
+ * @property {number} [maxLength]
+ * @property {'throw'|'truncate'|'noop'} [onMaxLength]
+ * @property {boolean} [normalizeSpaces] - Replace look-alike spaces with an ordinary space (runs first).
+ * @property {boolean} [purgeZeroWidthSpaces] - Remove U+200B, U+2060 and U+FEFF only, keeping joiners and selectors.
+ */
+/**
+ * Summons a customized sanctifier function with pre-bound booleans.
+ *
+ * Accepts full flag names and returns a text-cleaning function.
+ *
+ * @param {Object} [defaultOptions={}]
+ * @param {boolean} [defaultOptions.purgeInvisibleChars]
+ * @param {boolean} [defaultOptions.purgeEmojis]
+ * @param {boolean} [defaultOptions.nukeControls]
+ * @param {boolean} [defaultOptions.keyboardOnlyFilter]
+ * @param {boolean} [defaultOptions.normalizeNewlines]
+ * @param {boolean} [defaultOptions.trimSpacesAroundNewlines]
+ * @param {boolean} [defaultOptions.collapseNewLines]
+ * @param {boolean} [defaultOptions.preserveParagraphs]
+ * @param {boolean} [defaultOptions.collapseSpaces]
+ * @param {boolean} [defaultOptions.finalTrim]
+ * @param {number} [defaultOptions.maxLength=Infinity] - Hard input length cap (UTF-16 code units).
+ * @param {'throw' | 'truncate' | 'noop'} [defaultOptions.onMaxLength='throw'] - Behavior when input exceeds maxLength.
+ * @param {boolean} [defaultOptions.normalizeSpaces]
+ * @param {boolean} [defaultOptions.purgeZeroWidthSpaces]
+ * @returns {(text: string) => string}
+ */
+declare function createSanctifier(defaultOptions?: {
+    purgeInvisibleChars?: boolean;
+    purgeEmojis?: boolean;
+    nukeControls?: boolean;
+    keyboardOnlyFilter?: boolean;
+    normalizeNewlines?: boolean;
+    trimSpacesAroundNewlines?: boolean;
+    collapseNewLines?: boolean;
+    preserveParagraphs?: boolean;
+    collapseSpaces?: boolean;
+    finalTrim?: boolean;
+    maxLength?: number;
+    onMaxLength?: "throw" | "truncate" | "noop";
+    normalizeSpaces?: boolean;
+    purgeZeroWidthSpaces?: boolean;
+}): (text: string) => string;
+export { CONTROL_CHARS_REGEX, INVISIBLE_TRASH_REGEX, ASCII_KEYBOARD_SAFE_REGEX, EMOJI_REGEX, normalizeTypographicJank };

package/dist/types/textPatterns.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Normalizes typographic Unicode punctuation into ASCII equivalents.
+ * @param {string} text
+ * @returns {string}
+ */
+export function normalizeTypographicJank(text: string): string;
+/**
+ * Matches any character that is NOT:
+ * - Printable ASCII (U+0020–U+007E)
+ * - Newline characters: \n (LF), \r (CR)
+ * This allows for \n, \r, and \r\n line endings.
+ */
+export const ASCII_KEYBOARD_SAFE_REGEX: RegExp;
+/** @type {RegExp} */
+export const EMOJI_REGEX: RegExp;

package/dist/types/version.generated.d.ts

@@ -0,0 +1,2 @@
+/** The installed version of text-sanctifier, as in its package.json. */
+export const VERSION: "1.3.7";