pseudonym-mcp 0.2.5 → 0.3.0

package/README.md

@@ -13,7 +13,7 @@ Sits between your application and any cloud LLM (Claude, GPT-4, Gemini…). Repl
 
 ## What you get
 
-- **Multi-language PII detection**: Built-in support for English (SSN, credit cards, US phone) and Polish (PESEL, IBAN, Polish phone). Extensible to any language.
+- **Multi-language PII detection**: Built-in support for English (SSN, credit cards, US phone) and Polish (PESEL, IBAN, Polish phone). New **heuristic language detection** (`detectLanguage()`) infers the language from text content — `--lang` remains the authoritative override but is no longer the only input.
 - **Hybrid NER engine**: Regex for structured PII (SSN, credit cards, IBAN, email, phone) + local Ollama LLM for unstructured entities (names, organizations).
 - **Zero-trust architecture**: All detection and substitution happens on your machine. No PII reaches a third-party API.
 - **Session-keyed mapping store**: Tokens like `[PERSON:1]` map back to originals in an isolated, per-request session. Multiple round-trips preserve token coherence.
@@ -364,6 +364,16 @@ Add to `~/.cursor/mcp.json`:
 
 ## Supported PII types
 
+### Global (all languages)
+
+| Tag     | Pattern                              | Validation   |
+| ------- | ------------------------------------ | ------------ |
+| `EMAIL` | RFC 5321-compatible                  | Format match |
+| `IBAN`  | Generic IBAN (`CC` + 2 check + BBAN) | Format match |
+| `IP`    | IPv4 (all octets 0–255)              | Format match |
+| `URL`   | `http://` / `https://` URLs          | Format match |
+| `PHONE` | International `+CC` prefix format    | Format match |
+
 ### English (`--lang en`, default)
 
 | Tag           | Pattern                                             | Validation                                 |
@@ -372,19 +382,46 @@ Add to `~/.cursor/mcp.json`:
 | `CREDIT_CARD` | 13–19 digits (Visa, Mastercard, Amex, Discover)     | Luhn checksum                              |
 | `EMAIL`       | RFC 5321-compatible                                 | Format match                               |
 | `PHONE`       | `+1 (XXX) XXX-XXXX`, `XXX-XXX-XXXX`, `XXX.XXX.XXXX` | Format match                               |
+| `ZIP_CODE`    | `XXXXX` or `XXXXX-XXXX` (paranoid mode only)        | Format match                               |
 | `PERSON`      | Full names                                          | Ollama NER (hybrid / llm engines)          |
 | `ORG`         | Company / organization names                        | Ollama NER (hybrid / llm engines)          |
 
 ### Polish (`--lang pl`)
 
-| Tag      | Pattern                                                          | Validation                                      |
-| -------- | ---------------------------------------------------------------- | ----------------------------------------------- |
-| `PESEL`  | 11-digit national ID                                             | Full checksum (weights `[1,3,7,9,1,3,7,9,1,3]`) |
-| `IBAN`   | `PL` + 26 digits, compact or spaced                              | Format match                                    |
-| `EMAIL`  | RFC 5321-compatible                                              | Format match                                    |
-| `PHONE`  | `+48` / `0048` prefix, 9-digit mobile, landline `(XX) XXX-XX-XX` | Format match                                    |
-| `PERSON` | Full names                                                       | Ollama NER (hybrid / llm engines)               |
-| `ORG`    | Company / organization names                                     | Ollama NER (hybrid / llm engines)               |
+| Tag           | Pattern                                                          | Validation                                      |
+| ------------- | ---------------------------------------------------------------- | ----------------------------------------------- |
+| `PESEL`       | 11-digit national ID                                             | Full checksum (weights `[1,3,7,9,1,3,7,9,1,3]`) |
+| `IBAN`        | `PL` + 26 digits, compact or spaced                              | Format match                                    |
+| `EMAIL`       | RFC 5321-compatible                                              | Format match                                    |
+| `PHONE`       | `+48` / `0048` prefix, 9-digit mobile, landline `(XX) XXX-XX-XX` | Format match                                    |
+| `NIP`         | 10-digit tax ID (strict / paranoid modes)                        | Checksum (weights `[6,5,7,2,3,4,5,6,7]`)        |
+| `POSTAL_CODE` | `XX-XXX` (paranoid mode only)                                    | Format match                                    |
+| `PERSON`      | Full names                                                       | Ollama NER (hybrid / llm engines)               |
+| `ORG`         | Company / organization names                                     | Ollama NER (hybrid / llm engines)               |
+
+## Language Detection
+
+pseudonym-mcp includes a lightweight heuristic language detector based on [`franc`](https://github.com/wooorm/franc).
+It infers the language from text content and returns a structured result:
+
+```typescript
+detectLanguage('Umowa zostaje zawarta na czas nieokreślony')
+// → { detected: 'pl', source: 'text', raw: 'pol', confidence: 0.94 }
+
+detectLanguage('Hello')
+// → { detected: 'unknown', source: 'fallback', raw: null, confidence: null }
+```
+
+| Field        | Description                                                                            |
+| ------------ | -------------------------------------------------------------------------------------- |
+| `detected`   | `'pl'`, `'en'`, or `'unknown'`                                                         |
+| `source`     | `'text'` — franc ran and mapped successfully; `'fallback'` — too short or undetermined |
+| `raw`        | Raw ISO 639-3 code from franc (e.g. `'pol'`), or `null`                                |
+| `confidence` | Score 0–1 from franc, or `null` when franc was not called                              |
+
+Texts shorter than 20 characters or with low confidence return `detected: 'unknown'`.
+The detector does not affect the current pseudonymization pipeline — `--lang` config remains authoritative.
+It is a building block for future multi-language and auto-select modes.
 
 ## Engine modes
 
@@ -411,19 +448,20 @@ git clone https://github.com/woladi/pseudonym-mcp
 cd pseudonym-mcp
 npm install
 npm run build    # tsc compile
-npm test         # vitest (77 tests, no Ollama required)
+npm test         # vitest (134 tests, no Ollama required)
 ```
 
 The test suite runs fully offline — Ollama calls are injected via constructor and mocked in all tests. No live LLM required.
 
 ### Adding a new language pack
 
-1. Create `src/languages/<lang>/rules.ts`
-2. Export an object that implements `LanguageRules` from `src/languages/types.ts`
-3. Register it in the `LANGUAGE_MAP` in `src/core/engine.ts`
-4. Pass `--lang <lang>` at startup
+1. Add locale-specific patterns in `src/patterns/locale/<lang>/` — each file exports a `PatternRule` with `id`, `entityType`, `pattern`, `locales`, `engines`, and optional `validate`
+2. Register them in `src/patterns/index.ts` (add to `allPatterns` array)
+3. Create a thin adapter `src/languages/<lang>/rules.ts` that composes from the new patterns using `toPatternDef`
+4. Register the adapter in `LANGUAGE_MAP` in `src/core/engine.ts`
+5. Add the ISO 639-3 → short code mapping in `src/language/language-map.ts`
 
-Each language pack defines an array of `PatternDef` entries with a `tag`, `regex`, and optional `validate` callback. See `src/languages/en/rules.ts` and `src/languages/pl/rules.ts` for examples.
+See `src/patterns/locale/pl/` and `src/languages/pl/rules.ts` for a complete example.
 
 ## Contributing
 

package/dist/language/detect-language.d.ts

@@ -0,0 +1,15 @@
+import type { DetectedLanguageResult } from './types.js';
+/**
+ * Heuristically detect the language of the given text using franc.
+ *
+ * Returns 'unknown' when:
+ *   - text is shorter than MIN_TEXT_LENGTH characters
+ *   - franc returns 'und' (undetermined)
+ *   - the detected language is not in LANGUAGE_CODE_MAP
+ *   - confidence is below MIN_CONFIDENCE
+ *
+ * This is a helper heuristic — it does not affect the pseudonymization pipeline.
+ * The --lang config flag remains the authoritative language selector.
+ */
+export declare function detectLanguage(text: string): DetectedLanguageResult;
+//# sourceMappingURL=detect-language.d.ts.map

package/dist/language/detect-language.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-language.d.ts","sourceRoot":"","sources":["../../src/language/detect-language.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAA;AAYxD;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CA8BnE"}

package/dist/language/detect-language.js

@@ -0,0 +1,45 @@
+import { francAll } from 'franc';
+import { LANGUAGE_CODE_MAP } from './language-map.js';
+const MIN_TEXT_LENGTH = 20;
+const MIN_CONFIDENCE = 0.5;
+const FALLBACK = {
+    detected: 'unknown',
+    source: 'fallback',
+    raw: null,
+    confidence: null,
+};
+/**
+ * Heuristically detect the language of the given text using franc.
+ *
+ * Returns 'unknown' when:
+ *   - text is shorter than MIN_TEXT_LENGTH characters
+ *   - franc returns 'und' (undetermined)
+ *   - the detected language is not in LANGUAGE_CODE_MAP
+ *   - confidence is below MIN_CONFIDENCE
+ *
+ * This is a helper heuristic — it does not affect the pseudonymization pipeline.
+ * The --lang config flag remains the authoritative language selector.
+ */
+export function detectLanguage(text) {
+    const trimmed = text.trim();
+    if (trimmed.length < MIN_TEXT_LENGTH) {
+        return FALLBACK;
+    }
+    const scores = francAll(trimmed);
+    if (!scores.length) {
+        return FALLBACK;
+    }
+    const [rawCode, score] = scores[0];
+    if (rawCode === 'und') {
+        return FALLBACK;
+    }
+    const mapped = LANGUAGE_CODE_MAP[rawCode];
+    if (!mapped) {
+        return { detected: 'unknown', source: 'text', raw: rawCode, confidence: score };
+    }
+    if (score < MIN_CONFIDENCE) {
+        return { detected: 'unknown', source: 'fallback', raw: rawCode, confidence: score };
+    }
+    return { detected: mapped, source: 'text', raw: rawCode, confidence: score };
+}
+//# sourceMappingURL=detect-language.js.map

package/dist/language/detect-language.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-language.js","sourceRoot":"","sources":["../../src/language/detect-language.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAChC,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAA;AAGrD,MAAM,eAAe,GAAG,EAAE,CAAA;AAC1B,MAAM,cAAc,GAAG,GAAG,CAAA;AAE1B,MAAM,QAAQ,GAA2B;IACvC,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,UAAU;IAClB,GAAG,EAAE,IAAI;IACT,UAAU,EAAE,IAAI;CACjB,CAAA;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAA;IAE3B,IAAI,OAAO,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACrC,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;IAEhC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACnB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAqB,CAAA;IAEtD,IAAI,OAAO,KAAK,KAAK,EAAE,CAAC;QACtB,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IACjF,CAAC;IAED,IAAI,KAAK,GAAG,cAAc,EAAE,CAAC;QAC3B,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;IACrF,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAA;AAC9E,CAAC"}

package/dist/language/language-map.d.ts

@@ -0,0 +1,7 @@
+import type { SupportedLang } from './types.js';
+/**
+ * Maps ISO 639-3 codes (returned by franc) to supported short language codes.
+ * Only languages with a corresponding pattern set in src/patterns/ are listed here.
+ */
+export declare const LANGUAGE_CODE_MAP: Record<string, SupportedLang>;
+//# sourceMappingURL=language-map.d.ts.map

package/dist/language/language-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-map.d.ts","sourceRoot":"","sources":["../../src/language/language-map.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAE/C;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAG3D,CAAA"}

package/dist/language/language-map.js

@@ -0,0 +1,9 @@
+/**
+ * Maps ISO 639-3 codes (returned by franc) to supported short language codes.
+ * Only languages with a corresponding pattern set in src/patterns/ are listed here.
+ */
+export const LANGUAGE_CODE_MAP = {
+    pol: 'pl',
+    eng: 'en',
+};
+//# sourceMappingURL=language-map.js.map

package/dist/language/language-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"language-map.js","sourceRoot":"","sources":["../../src/language/language-map.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAkC;IAC9D,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;CACV,CAAA"}

package/dist/language/types.d.ts

@@ -0,0 +1,14 @@
+export type SupportedLang = 'pl' | 'en';
+export type DetectedLang = SupportedLang | 'unknown';
+export type DetectionSource = 'text' | 'fallback';
+export interface DetectedLanguageResult {
+    /** Detected language mapped to a supported code, or 'unknown' */
+    detected: DetectedLang;
+    /** 'text' = franc ran and returned a mappable language; 'fallback' = text too short or und */
+    source: DetectionSource;
+    /** Raw ISO 639-3 code from franc (e.g. 'pol'), or null when franc was not called */
+    raw: string | null;
+    /** Confidence score 0–1 from franc, or null when franc was not called */
+    confidence: number | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/language/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/language/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,GAAG,IAAI,GAAG,IAAI,CAAA;AACvC,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,SAAS,CAAA;AACpD,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,UAAU,CAAA;AAEjD,MAAM,WAAW,sBAAsB;IACrC,iEAAiE;IACjE,QAAQ,EAAE,YAAY,CAAA;IACtB,8FAA8F;IAC9F,MAAM,EAAE,eAAe,CAAA;IACvB,oFAAoF;IACpF,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;IAClB,yEAAyE;IACzE,UAAU,EAAE,MAAM,GAAG,IAAI,CAAA;CAC1B"}

package/dist/language/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/language/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/language/types.ts"],"names":[],"mappings":""}

package/dist/languages/en/rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/languages/en/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAwChD,eAAO,MAAM,YAAY,EAAE,aA0B1B,CAAA"}
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/languages/en/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAOhD,eAAO,MAAM,YAAY,EAAE,aAE1B,CAAA"}

package/dist/languages/en/rules.js

@@ -1,69 +1,9 @@
-/**
- * Luhn algorithm for credit card number validation.
- * Strips spaces and dashes, verifies the checksum digit.
- */
-function luhnCheck(number) {
-    const digits = number.replace(/[\s-]/g, '');
-    if (!/^\d{13,19}$/.test(digits))
-        return false;
-    let sum = 0;
-    let double = false;
-    for (let i = digits.length - 1; i >= 0; i--) {
-        let digit = Number(digits[i]);
-        if (double) {
-            digit *= 2;
-            if (digit > 9)
-                digit -= 9;
-        }
-        sum += digit;
-        double = !double;
-    }
-    return sum % 10 === 0;
-}
-/**
- * Basic SSN area-number validation.
- * Rejects known invalid patterns: area 000, 666, 900-999.
- */
-function ssnValidate(ssn) {
-    const clean = ssn.replace(/[\s-]/g, '');
-    if (!/^\d{9}$/.test(clean))
-        return false;
-    const area = parseInt(clean.substring(0, 3), 10);
-    const group = parseInt(clean.substring(3, 5), 10);
-    const serial = parseInt(clean.substring(5, 9), 10);
-    if (area === 0 || area === 666 || area >= 900)
-        return false;
-    if (group === 0)
-        return false;
-    if (serial === 0)
-        return false;
-    return true;
-}
+import { toPatternDef } from '../../patterns/types.js';
+import { ssnRule } from '../../patterns/locale/en/ssn.js';
+import { creditCardRule } from '../../patterns/locale/en/credit-card.js';
+import { emailRule } from '../../patterns/global/email.js';
+import { usPhoneRule } from '../../patterns/locale/en/phone.js';
 export const EnglishRules = {
-    patterns: [
-        {
-            tag: 'SSN',
-            // US Social Security Number: XXX-XX-XXXX (with required dashes to avoid false positives)
-            regex: /\b\d{3}-\d{2}-\d{4}\b/g,
-            validate: ssnValidate,
-        },
-        {
-            tag: 'CREDIT_CARD',
-            // 13–19 digits, optionally separated by spaces or dashes in groups of 4
-            // Covers Visa (4xxx), Mastercard (5[1-5]xx, 2[2-7]xx), Amex (3[47]x), Discover (6xxx)
-            regex: /\b(?:\d[ -]*?){13,19}\b/g,
-            validate: luhnCheck,
-        },
-        {
-            tag: 'EMAIL',
-            regex: /\b[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}\b/g,
-        },
-        {
-            tag: 'PHONE',
-            // US/international phone formats:
-            // +1 (XXX) XXX-XXXX, +1-XXX-XXX-XXXX, (XXX) XXX-XXXX, XXX-XXX-XXXX, XXX.XXX.XXXX
-            regex: /(?:\+1[\s.-]?)?\(?\d{3}\)?[\s.-]\d{3}[\s.-]\d{4}\b/g,
-        },
-    ],
+    patterns: [ssnRule, creditCardRule, emailRule, usPhoneRule].map(toPatternDef),
 };
 //# sourceMappingURL=rules.js.map

package/dist/languages/en/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/languages/en/rules.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IAC3C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IAE7C,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,IAAI,CAAC,CAAA;YACV,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAA;QAC3B,CAAC;QACD,GAAG,IAAI,KAAK,CAAA;QACZ,MAAM,GAAG,CAAC,MAAM,CAAA;IAClB,CAAC;IACD,OAAO,GAAG,GAAG,EAAE,KAAK,CAAC,CAAA;AACvB,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAA;IACvC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAClD,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,IAAI,GAAG;QAAE,OAAO,KAAK,CAAA;IAC3D,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7B,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC9B,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,KAAK;YACV,yFAAyF;YACzF,KAAK,EAAE,wBAAwB;YAC/B,QAAQ,EAAE,WAAW;SACtB;QACD;YACE,GAAG,EAAE,aAAa;YAClB,wEAAwE;YACxE,sFAAsF;YACtF,KAAK,EAAE,0BAA0B;YACjC,QAAQ,EAAE,SAAS;SACpB;QACD;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,uDAAuD;SAC/D;QACD;YACE,GAAG,EAAE,OAAO;YACZ,kCAAkC;YAClC,iFAAiF;YACjF,KAAK,EAAE,qDAAqD;SAC7D;KACF;CACF,CAAA"}
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/languages/en/rules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,OAAO,EAAE,MAAM,iCAAiC,CAAA;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAE/D,MAAM,CAAC,MAAM,YAAY,GAAkB;IACzC,QAAQ,EAAE,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;CAC9E,CAAA"}

package/dist/languages/pl/rules.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/languages/pl/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAgBhD,eAAO,MAAM,WAAW,EAAE,aA6BzB,CAAA"}
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../../src/languages/pl/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAOhD,eAAO,MAAM,WAAW,EAAE,aAEzB,CAAA"}

package/dist/languages/pl/rules.js

@@ -1,44 +1,9 @@
-/**
- * Validates a Polish PESEL number using the official checksum algorithm.
- * Weights: [1, 3, 7, 9, 1, 3, 7, 9, 1, 3]
- * Check digit = (10 - (weighted_sum % 10)) % 10
- */
-function peselChecksum(pesel) {
-    if (!/^\d{11}$/.test(pesel))
-        return false;
-    const weights = [1, 3, 7, 9, 1, 3, 7, 9, 1, 3];
-    const digits = pesel.split('').map(Number);
-    const sum = weights.reduce((acc, w, i) => acc + w * digits[i], 0);
-    const check = (10 - (sum % 10)) % 10;
-    return check === digits[10];
-}
+import { toPatternDef } from '../../patterns/types.js';
+import { peselRule } from '../../patterns/locale/pl/pesel.js';
+import { plIbanRule } from '../../patterns/locale/pl/iban.js';
+import { plPhoneRule } from '../../patterns/locale/pl/phone.js';
+import { emailRule } from '../../patterns/global/email.js';
 export const PolishRules = {
-    patterns: [
-        {
-            tag: 'PESEL',
-            // Matches exactly 11 consecutive digits NOT adjacent to another digit
-            regex: /(?<!\d)\d{11}(?!\d)/g,
-            validate: peselChecksum,
-        },
-        {
-            tag: 'IBAN',
-            // Matches PL + 26 digits (2 check + 24 BBAN), optionally space-separated every 4 chars
-            // e.g. PL27114020040000300201355387 or PL 27 1140 2004 0000 3002 0135 5387
-            // Structure: PL + \d{2} (check) + (\d{4}){6} (24 BBAN) = 26 total digits
-            regex: /\bPL\s*\d{2}\s*(?:\d{4}\s*){6}\b/gi,
-        },
-        {
-            tag: 'EMAIL',
-            regex: /\b[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}\b/g,
-        },
-        {
-            tag: 'PHONE',
-            // Three alternatives:
-            // 1. International prefix: +48 or 0048, then 9 digits (with optional spaces/dashes)
-            // 2. 9-digit mobile starting with 4–8 (Polish numbering plan)
-            // 3. Landline with area code in parens: (XX) XXX-XX-XX
-            regex: /(?:\+48|0048)[\s\-]?\d{3}[\s\-]?\d{3}[\s\-]?\d{3}|\b[4-8]\d{2}[\s\-]?\d{3}[\s\-]?\d{3}\b|\(\d{2}\)[\s\-]?\d{3}[\s\-]?\d{2}[\s\-]?\d{2}/g,
-        },
-    ],
+    patterns: [peselRule, plIbanRule, emailRule, plPhoneRule].map(toPatternDef),
 };
 //# sourceMappingURL=rules.js.map

package/dist/languages/pl/rules.js.map

@@ -1 +1 @@
-{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/languages/pl/rules.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACzC,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACjE,MAAM,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAA;IACpC,OAAO,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,QAAQ,EAAE;QACR;YACE,GAAG,EAAE,OAAO;YACZ,sEAAsE;YACtE,KAAK,EAAE,sBAAsB;YAC7B,QAAQ,EAAE,aAAa;SACxB;QACD;YACE,GAAG,EAAE,MAAM;YACX,uFAAuF;YACvF,2EAA2E;YAC3E,yEAAyE;YACzE,KAAK,EAAE,oCAAoC;SAC5C;QACD;YACE,GAAG,EAAE,OAAO;YACZ,KAAK,EAAE,uDAAuD;SAC/D;QACD;YACE,GAAG,EAAE,OAAO;YACZ,sBAAsB;YACtB,oFAAoF;YACpF,8DAA8D;YAC9D,uDAAuD;YACvD,KAAK,EACH,yIAAyI;SAC5I;KACF;CACF,CAAA"}
+{"version":3,"file":"rules.js","sourceRoot":"","sources":["../../../src/languages/pl/rules.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAA;AACtD,OAAO,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAA;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAA;AAC7D,OAAO,EAAE,WAAW,EAAE,MAAM,mCAAmC,CAAA;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,gCAAgC,CAAA;AAE1D,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC,GAAG,CAAC,YAAY,CAAC;CAC5E,CAAA"}

package/dist/patterns/engines/balanced.d.ts

@@ -0,0 +1,4 @@
+import type { PatternRule } from '../types.js';
+/** Patterns active in balanced mode — low false-positive rules with good coverage */
+export declare const balancedPatterns: PatternRule[];
+//# sourceMappingURL=balanced.d.ts.map

package/dist/patterns/engines/balanced.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"balanced.d.ts","sourceRoot":"","sources":["../../../src/patterns/engines/balanced.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,qFAAqF;AACrF,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAEzC,CAAA"}

package/dist/patterns/engines/balanced.js

@@ -0,0 +1,4 @@
+import { allPatterns } from '../index.js';
+/** Patterns active in balanced mode — low false-positive rules with good coverage */
+export const balancedPatterns = allPatterns.filter((p) => p.engines.includes('balanced'));
+//# sourceMappingURL=balanced.js.map

package/dist/patterns/engines/balanced.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"balanced.js","sourceRoot":"","sources":["../../../src/patterns/engines/balanced.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGzC,qFAAqF;AACrF,MAAM,CAAC,MAAM,gBAAgB,GAAkB,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACtE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAC/B,CAAA"}

package/dist/patterns/engines/paranoid.d.ts

@@ -0,0 +1,4 @@
+import type { PatternRule } from '../types.js';
+/** All patterns — maximum coverage, higher false-positive risk */
+export declare const paranoidPatterns: PatternRule[];
+//# sourceMappingURL=paranoid.d.ts.map

package/dist/patterns/engines/paranoid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paranoid.d.ts","sourceRoot":"","sources":["../../../src/patterns/engines/paranoid.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,EAAE,WAAW,EAEzC,CAAA"}

package/dist/patterns/engines/paranoid.js

@@ -0,0 +1,4 @@
+import { allPatterns } from '../index.js';
+/** All patterns — maximum coverage, higher false-positive risk */
+export const paranoidPatterns = allPatterns.filter((p) => p.engines.includes('paranoid'));
+//# sourceMappingURL=paranoid.js.map

package/dist/patterns/engines/paranoid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paranoid.js","sourceRoot":"","sources":["../../../src/patterns/engines/paranoid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGzC,kEAAkE;AAClE,MAAM,CAAC,MAAM,gBAAgB,GAAkB,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CACtE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAC/B,CAAA"}

package/dist/patterns/engines/strict.d.ts

@@ -0,0 +1,4 @@
+import type { PatternRule } from '../types.js';
+/** Patterns active in strict mode — balanced rules plus checksum-validated identifiers */
+export declare const strictPatterns: PatternRule[];
+//# sourceMappingURL=strict.d.ts.map

package/dist/patterns/engines/strict.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict.d.ts","sourceRoot":"","sources":["../../../src/patterns/engines/strict.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,0FAA0F;AAC1F,eAAO,MAAM,cAAc,EAAE,WAAW,EAA4D,CAAA"}

package/dist/patterns/engines/strict.js

@@ -0,0 +1,4 @@
+import { allPatterns } from '../index.js';
+/** Patterns active in strict mode — balanced rules plus checksum-validated identifiers */
+export const strictPatterns = allPatterns.filter((p) => p.engines.includes('strict'));
+//# sourceMappingURL=strict.js.map

package/dist/patterns/engines/strict.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"strict.js","sourceRoot":"","sources":["../../../src/patterns/engines/strict.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAGzC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,cAAc,GAAkB,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAA"}

package/dist/patterns/global/email.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../types.js';
+export declare const emailRule: PatternRule;
+//# sourceMappingURL=email.d.ts.map

package/dist/patterns/global/email.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.d.ts","sourceRoot":"","sources":["../../../src/patterns/global/email.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,SAAS,EAAE,WAOvB,CAAA"}

package/dist/patterns/global/email.js

@@ -0,0 +1,9 @@
+export const emailRule = {
+    id: 'global.email',
+    entityType: 'EMAIL',
+    pattern: /\b[a-zA-Z0-9._%+\-]+@[a-zA-Z0-9.\-]+\.[a-zA-Z]{2,}\b/g,
+    locales: null,
+    engines: ['balanced', 'strict', 'paranoid'],
+    description: 'Standard email address (RFC 5321-compatible)',
+};
+//# sourceMappingURL=email.js.map

package/dist/patterns/global/email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email.js","sourceRoot":"","sources":["../../../src/patterns/global/email.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,SAAS,GAAgB;IACpC,EAAE,EAAE,cAAc;IAClB,UAAU,EAAE,OAAO;IACnB,OAAO,EAAE,uDAAuD;IAChE,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC3C,WAAW,EAAE,8CAA8C;CAC5D,CAAA"}

package/dist/patterns/global/iban.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../types.js';
+export declare const globalIbanRule: PatternRule;
+//# sourceMappingURL=iban.d.ts.map

package/dist/patterns/global/iban.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iban.d.ts","sourceRoot":"","sources":["../../../src/patterns/global/iban.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,cAAc,EAAE,WAS5B,CAAA"}

package/dist/patterns/global/iban.js

@@ -0,0 +1,11 @@
+export const globalIbanRule = {
+    id: 'global.iban',
+    entityType: 'IBAN',
+    // Generic IBAN: 2-letter country code + 2 check digits + up to 30 alphanumeric chars
+    // Covers all IBAN countries (max length 34 chars)
+    pattern: /\b[A-Z]{2}\d{2}[A-Z0-9]{1,30}\b/g,
+    locales: null,
+    engines: ['strict', 'paranoid'],
+    description: 'Generic IBAN (any country, compact format)',
+};
+//# sourceMappingURL=iban.js.map

package/dist/patterns/global/iban.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iban.js","sourceRoot":"","sources":["../../../src/patterns/global/iban.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,EAAE,EAAE,aAAa;IACjB,UAAU,EAAE,MAAM;IAClB,qFAAqF;IACrF,kDAAkD;IAClD,OAAO,EAAE,kCAAkC;IAC3C,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC/B,WAAW,EAAE,4CAA4C;CAC1D,CAAA"}

package/dist/patterns/global/ip.d.ts

@@ -0,0 +1,4 @@
+import type { PatternRule } from '../types.js';
+export declare const ipv4Rule: PatternRule;
+export declare const ipv6Rule: PatternRule;
+//# sourceMappingURL=ip.d.ts.map

package/dist/patterns/global/ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.d.ts","sourceRoot":"","sources":["../../../src/patterns/global/ip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,QAAQ,EAAE,WAStB,CAAA;AAED,eAAO,MAAM,QAAQ,EAAE,WAStB,CAAA"}

package/dist/patterns/global/ip.js

@@ -0,0 +1,20 @@
+export const ipv4Rule = {
+    id: 'global.ipv4',
+    entityType: 'IP',
+    // IPv4: four octets 0–255 separated by dots, not adjacent to other digits/dots
+    pattern: /\b(?:(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\.){3}(?:25[0-5]|2[0-4]\d|1\d{2}|[1-9]\d|\d)\b/g,
+    locales: null,
+    engines: ['strict', 'paranoid'],
+    description: 'IPv4 address (0.0.0.0 – 255.255.255.255)',
+};
+export const ipv6Rule = {
+    id: 'global.ipv6',
+    entityType: 'IP',
+    // Full or compressed IPv6: groups of 1–4 hex digits separated by colons
+    // Handles :: abbreviation and mixed IPv4-in-IPv6 forms at a basic level
+    pattern: /\b(?:[0-9a-fA-F]{1,4}:){2,7}[0-9a-fA-F]{1,4}\b/g,
+    locales: null,
+    engines: ['paranoid'],
+    description: 'IPv6 address (basic hex-colon format)',
+};
+//# sourceMappingURL=ip.js.map

package/dist/patterns/global/ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ip.js","sourceRoot":"","sources":["../../../src/patterns/global/ip.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,EAAE,EAAE,aAAa;IACjB,UAAU,EAAE,IAAI;IAChB,+EAA+E;IAC/E,OAAO,EACL,4FAA4F;IAC9F,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC/B,WAAW,EAAE,0CAA0C;CACxD,CAAA;AAED,MAAM,CAAC,MAAM,QAAQ,GAAgB;IACnC,EAAE,EAAE,aAAa;IACjB,UAAU,EAAE,IAAI;IAChB,wEAAwE;IACxE,wEAAwE;IACxE,OAAO,EAAE,iDAAiD;IAC1D,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,WAAW,EAAE,uCAAuC;CACrD,CAAA"}

package/dist/patterns/global/phone.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../types.js';
+export declare const globalPhoneRule: PatternRule;
+//# sourceMappingURL=phone.d.ts.map

package/dist/patterns/global/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../../src/patterns/global/phone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,eAAe,EAAE,WAS7B,CAAA"}

package/dist/patterns/global/phone.js

@@ -0,0 +1,11 @@
+export const globalPhoneRule = {
+    id: 'global.phone',
+    entityType: 'PHONE',
+    // Generic international format: +CC followed by digits/spaces/dashes
+    // e.g. +1-800-555-1234, +44 20 7946 0958, +33 1 23 45 67 89
+    pattern: /\+\d{1,3}[\s.\-]?\(?\d{1,4}\)?(?:[\s.\-]?\d{1,4}){2,4}\b/g,
+    locales: null,
+    engines: ['strict', 'paranoid'],
+    description: 'Generic international phone number with country code prefix',
+};
+//# sourceMappingURL=phone.js.map

package/dist/patterns/global/phone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.js","sourceRoot":"","sources":["../../../src/patterns/global/phone.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,eAAe,GAAgB;IAC1C,EAAE,EAAE,cAAc;IAClB,UAAU,EAAE,OAAO;IACnB,qEAAqE;IACrE,4DAA4D;IAC5D,OAAO,EAAE,2DAA2D;IACpE,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC/B,WAAW,EAAE,6DAA6D;CAC3E,CAAA"}

package/dist/patterns/global/url.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../types.js';
+export declare const urlRule: PatternRule;
+//# sourceMappingURL=url.d.ts.map

package/dist/patterns/global/url.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.d.ts","sourceRoot":"","sources":["../../../src/patterns/global/url.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE9C,eAAO,MAAM,OAAO,EAAE,WAQrB,CAAA"}

package/dist/patterns/global/url.js

@@ -0,0 +1,10 @@
+export const urlRule = {
+    id: 'global.url',
+    entityType: 'URL',
+    // http/https URLs — stops at whitespace and common delimiter characters
+    pattern: /https?:\/\/[^\s<>"{}\\|^[\]]+/g,
+    locales: null,
+    engines: ['paranoid'],
+    description: 'HTTP/HTTPS URL',
+};
+//# sourceMappingURL=url.js.map

package/dist/patterns/global/url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url.js","sourceRoot":"","sources":["../../../src/patterns/global/url.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,EAAE,EAAE,YAAY;IAChB,UAAU,EAAE,KAAK;IACjB,wEAAwE;IACxE,OAAO,EAAE,gCAAgC;IACzC,OAAO,EAAE,IAAI;IACb,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,WAAW,EAAE,gBAAgB;CAC9B,CAAA"}

package/dist/patterns/index.d.ts

@@ -0,0 +1,18 @@
+import type { PatternRule } from './types.js';
+export * from './types.js';
+export * from './global/email.js';
+export * from './global/phone.js';
+export * from './global/iban.js';
+export * from './global/ip.js';
+export * from './global/url.js';
+export * from './locale/pl/pesel.js';
+export * from './locale/pl/iban.js';
+export * from './locale/pl/phone.js';
+export * from './locale/pl/nip.js';
+export * from './locale/pl/postal-code.js';
+export * from './locale/en/ssn.js';
+export * from './locale/en/credit-card.js';
+export * from './locale/en/phone.js';
+export * from './locale/en/zip-code.js';
+export declare const allPatterns: PatternRule[];
+//# sourceMappingURL=index.d.ts.map

package/dist/patterns/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE7C,cAAc,YAAY,CAAA;AAE1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AAEvC,eAAO,MAAM,WAAW,EAAE,WAAW,EAmBpC,CAAA"}

package/dist/patterns/index.js

@@ -0,0 +1,50 @@
+import { emailRule } from './global/email.js';
+import { globalPhoneRule } from './global/phone.js';
+import { globalIbanRule } from './global/iban.js';
+import { ipv4Rule, ipv6Rule } from './global/ip.js';
+import { urlRule } from './global/url.js';
+import { peselRule } from './locale/pl/pesel.js';
+import { plIbanRule } from './locale/pl/iban.js';
+import { plPhoneRule } from './locale/pl/phone.js';
+import { nipRule } from './locale/pl/nip.js';
+import { plPostalCodeRule } from './locale/pl/postal-code.js';
+import { ssnRule } from './locale/en/ssn.js';
+import { creditCardRule } from './locale/en/credit-card.js';
+import { usPhoneRule } from './locale/en/phone.js';
+import { usZipCodeRule } from './locale/en/zip-code.js';
+export * from './types.js';
+export * from './global/email.js';
+export * from './global/phone.js';
+export * from './global/iban.js';
+export * from './global/ip.js';
+export * from './global/url.js';
+export * from './locale/pl/pesel.js';
+export * from './locale/pl/iban.js';
+export * from './locale/pl/phone.js';
+export * from './locale/pl/nip.js';
+export * from './locale/pl/postal-code.js';
+export * from './locale/en/ssn.js';
+export * from './locale/en/credit-card.js';
+export * from './locale/en/phone.js';
+export * from './locale/en/zip-code.js';
+export const allPatterns = [
+    // Global
+    emailRule,
+    globalPhoneRule,
+    globalIbanRule,
+    ipv4Rule,
+    ipv6Rule,
+    urlRule,
+    // Polish locale
+    peselRule,
+    plIbanRule,
+    plPhoneRule,
+    nipRule,
+    plPostalCodeRule,
+    // English locale
+    ssnRule,
+    creditCardRule,
+    usPhoneRule,
+    usZipCodeRule,
+];
+//# sourceMappingURL=index.js.map

package/dist/patterns/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/patterns/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACnD,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAA;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAA;AAC7D,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAA;AAC5C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAA;AAC3D,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAA;AAClD,OAAO,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAA;AAGvD,cAAc,YAAY,CAAA;AAE1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,kBAAkB,CAAA;AAChC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,sBAAsB,CAAA;AACpC,cAAc,qBAAqB,CAAA;AACnC,cAAc,sBAAsB,CAAA;AACpC,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,oBAAoB,CAAA;AAClC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AAEvC,MAAM,CAAC,MAAM,WAAW,GAAkB;IACxC,SAAS;IACT,SAAS;IACT,eAAe;IACf,cAAc;IACd,QAAQ;IACR,QAAQ;IACR,OAAO;IACP,gBAAgB;IAChB,SAAS;IACT,UAAU;IACV,WAAW;IACX,OAAO;IACP,gBAAgB;IAChB,iBAAiB;IACjB,OAAO;IACP,cAAc;IACd,WAAW;IACX,aAAa;CACd,CAAA"}

package/dist/patterns/locale/en/credit-card.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const creditCardRule: PatternRule;
+//# sourceMappingURL=credit-card.d.ts.map

package/dist/patterns/locale/en/credit-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-card.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/en/credit-card.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAwBjD,eAAO,MAAM,cAAc,EAAE,WAW5B,CAAA"}

package/dist/patterns/locale/en/credit-card.js

@@ -0,0 +1,34 @@
+/**
+ * Luhn algorithm for credit card number validation.
+ * Strips spaces and dashes, verifies the checksum digit.
+ */
+function luhnCheck(number) {
+    const digits = number.replace(/[\s\-]/g, '');
+    if (!/^\d{13,19}$/.test(digits))
+        return false;
+    let sum = 0;
+    let double = false;
+    for (let i = digits.length - 1; i >= 0; i--) {
+        let digit = Number(digits[i]);
+        if (double) {
+            digit *= 2;
+            if (digit > 9)
+                digit -= 9;
+        }
+        sum += digit;
+        double = !double;
+    }
+    return sum % 10 === 0;
+}
+export const creditCardRule = {
+    id: 'en.credit-card',
+    entityType: 'CREDIT_CARD',
+    // 13–19 digits, optionally separated by spaces or dashes in groups of 4
+    // Covers Visa (4xxx), Mastercard (5[1-5]xx / 2[2-7]xx), Amex (3[47]x), Discover (6xxx)
+    pattern: /\b(?:\d[ \-]*?){13,19}\b/g,
+    locales: ['en'],
+    engines: ['balanced', 'strict', 'paranoid'],
+    description: 'Credit card number (13–19 digits, Luhn checksum) — Visa, Mastercard, Amex, Discover',
+    validate: luhnCheck,
+};
+//# sourceMappingURL=credit-card.js.map

package/dist/patterns/locale/en/credit-card.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credit-card.js","sourceRoot":"","sources":["../../../../src/patterns/locale/en/credit-card.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,SAAS,SAAS,CAAC,MAAc;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IAC5C,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IAE7C,IAAI,GAAG,GAAG,CAAC,CAAA;IACX,IAAI,MAAM,GAAG,KAAK,CAAA;IAClB,KAAK,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAA;QAC7B,IAAI,MAAM,EAAE,CAAC;YACX,KAAK,IAAI,CAAC,CAAA;YACV,IAAI,KAAK,GAAG,CAAC;gBAAE,KAAK,IAAI,CAAC,CAAA;QAC3B,CAAC;QACD,GAAG,IAAI,KAAK,CAAA;QACZ,MAAM,GAAG,CAAC,MAAM,CAAA;IAClB,CAAC;IACD,OAAO,GAAG,GAAG,EAAE,KAAK,CAAC,CAAA;AACvB,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAgB;IACzC,EAAE,EAAE,gBAAgB;IACpB,UAAU,EAAE,aAAa;IACzB,wEAAwE;IACxE,uFAAuF;IACvF,OAAO,EAAE,2BAA2B;IACpC,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC3C,WAAW,EACT,qFAAqF;IACvF,QAAQ,EAAE,SAAS;CACpB,CAAA"}

package/dist/patterns/locale/en/phone.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const usPhoneRule: PatternRule;
+//# sourceMappingURL=phone.d.ts.map

package/dist/patterns/locale/en/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/en/phone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,eAAO,MAAM,WAAW,EAAE,WASzB,CAAA"}

package/dist/patterns/locale/en/phone.js

@@ -0,0 +1,11 @@
+export const usPhoneRule = {
+    id: 'en.phone',
+    entityType: 'PHONE',
+    // US/North America phone formats:
+    // +1 (XXX) XXX-XXXX, +1-XXX-XXX-XXXX, (XXX) XXX-XXXX, XXX-XXX-XXXX, XXX.XXX.XXXX
+    pattern: /(?:\+1[\s.\-]?)?\(?\d{3}\)?[\s.\-]\d{3}[\s.\-]\d{4}\b/g,
+    locales: ['en'],
+    engines: ['balanced', 'strict', 'paranoid'],
+    description: 'US/North America phone number in common formats',
+};
+//# sourceMappingURL=phone.js.map

package/dist/patterns/locale/en/phone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.js","sourceRoot":"","sources":["../../../../src/patterns/locale/en/phone.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,EAAE,EAAE,UAAU;IACd,UAAU,EAAE,OAAO;IACnB,kCAAkC;IAClC,iFAAiF;IACjF,OAAO,EAAE,wDAAwD;IACjE,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC3C,WAAW,EAAE,iDAAiD;CAC/D,CAAA"}

package/dist/patterns/locale/en/ssn.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const ssnRule: PatternRule;
+//# sourceMappingURL=ssn.d.ts.map

package/dist/patterns/locale/en/ssn.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssn.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/en/ssn.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAkBjD,eAAO,MAAM,OAAO,EAAE,WASrB,CAAA"}

package/dist/patterns/locale/en/ssn.js

@@ -0,0 +1,30 @@
+/**
+ * Basic SSN area-number validation.
+ * Rejects known invalid patterns: area 000, 666, 900-999.
+ */
+function ssnValidate(ssn) {
+    const clean = ssn.replace(/[\s\-]/g, '');
+    if (!/^\d{9}$/.test(clean))
+        return false;
+    const area = parseInt(clean.substring(0, 3), 10);
+    const group = parseInt(clean.substring(3, 5), 10);
+    const serial = parseInt(clean.substring(5, 9), 10);
+    if (area === 0 || area === 666 || area >= 900)
+        return false;
+    if (group === 0)
+        return false;
+    if (serial === 0)
+        return false;
+    return true;
+}
+export const ssnRule = {
+    id: 'en.ssn',
+    entityType: 'SSN',
+    // US Social Security Number: XXX-XX-XXXX (required dashes to avoid false positives)
+    pattern: /\b\d{3}-\d{2}-\d{4}\b/g,
+    locales: ['en'],
+    engines: ['balanced', 'strict', 'paranoid'],
+    description: 'US Social Security Number (XXX-XX-XXXX) with area-number validation',
+    validate: ssnValidate,
+};
+//# sourceMappingURL=ssn.js.map

package/dist/patterns/locale/en/ssn.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssn.js","sourceRoot":"","sources":["../../../../src/patterns/locale/en/ssn.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACxC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACxC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAChD,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAA;IAClD,IAAI,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,GAAG,IAAI,IAAI,IAAI,GAAG;QAAE,OAAO,KAAK,CAAA;IAC3D,IAAI,KAAK,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC7B,IAAI,MAAM,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IAC9B,OAAO,IAAI,CAAA;AACb,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,EAAE,EAAE,QAAQ;IACZ,UAAU,EAAE,KAAK;IACjB,oFAAoF;IACpF,OAAO,EAAE,wBAAwB;IACjC,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC3C,WAAW,EAAE,qEAAqE;IAClF,QAAQ,EAAE,WAAW;CACtB,CAAA"}

package/dist/patterns/locale/en/zip-code.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const usZipCodeRule: PatternRule;
+//# sourceMappingURL=zip-code.d.ts.map

package/dist/patterns/locale/en/zip-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-code.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/en/zip-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,eAAO,MAAM,aAAa,EAAE,WAQ3B,CAAA"}

package/dist/patterns/locale/en/zip-code.js

@@ -0,0 +1,10 @@
+export const usZipCodeRule = {
+    id: 'en.zip-code',
+    entityType: 'ZIP_CODE',
+    // US ZIP code: 5 digits, or ZIP+4 (XXXXX-XXXX)
+    pattern: /\b\d{5}(?:-\d{4})?\b/g,
+    locales: ['en'],
+    engines: ['paranoid'],
+    description: 'US ZIP code (XXXXX or XXXXX-XXXX)',
+};
+//# sourceMappingURL=zip-code.js.map

package/dist/patterns/locale/en/zip-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"zip-code.js","sourceRoot":"","sources":["../../../../src/patterns/locale/en/zip-code.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,aAAa,GAAgB;IACxC,EAAE,EAAE,aAAa;IACjB,UAAU,EAAE,UAAU;IACtB,+CAA+C;IAC/C,OAAO,EAAE,uBAAuB;IAChC,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,WAAW,EAAE,mCAAmC;CACjD,CAAA"}

package/dist/patterns/locale/pl/iban.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const plIbanRule: PatternRule;
+//# sourceMappingURL=iban.d.ts.map

package/dist/patterns/locale/pl/iban.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"iban.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/iban.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,eAAO,MAAM,UAAU,EAAE,WASxB,CAAA"}

package/dist/patterns/locale/pl/iban.js

@@ -0,0 +1,11 @@
+export const plIbanRule = {
+    id: 'pl.iban',
+    entityType: 'IBAN',
+    // PL + 2 check digits + 24 BBAN digits, optionally space-separated every 4 chars
+    // e.g. PL27114020040000300201355387 or PL 27 1140 2004 0000 3002 0135 5387
+    pattern: /\bPL\s*\d{2}\s*(?:\d{4}\s*){6}\b/gi,
+    locales: ['pl'],
+    engines: ['balanced', 'strict', 'paranoid'],
+    description: 'Polish IBAN (PL prefix + 26 digits, compact or spaced)',
+};
+//# sourceMappingURL=iban.js.map

package/dist/patterns/locale/pl/iban.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iban.js","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/iban.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,UAAU,GAAgB;IACrC,EAAE,EAAE,SAAS;IACb,UAAU,EAAE,MAAM;IAClB,iFAAiF;IACjF,2EAA2E;IAC3E,OAAO,EAAE,oCAAoC;IAC7C,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC3C,WAAW,EAAE,wDAAwD;CACtE,CAAA"}

package/dist/patterns/locale/pl/nip.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const nipRule: PatternRule;
+//# sourceMappingURL=nip.d.ts.map

package/dist/patterns/locale/pl/nip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/nip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAiBjD,eAAO,MAAM,OAAO,EAAE,WASrB,CAAA"}

package/dist/patterns/locale/pl/nip.js

@@ -0,0 +1,26 @@
+/**
+ * Validates a Polish NIP (Numer Identyfikacji Podatkowej — Tax ID).
+ * 10 digits, weights: [6, 5, 7, 2, 3, 4, 5, 6, 7]
+ * Check digit = weighted_sum % 11; valid if result equals last digit (and != 10)
+ */
+function nipChecksum(raw) {
+    const digits = raw.replace(/[\s\-]/g, '');
+    if (!/^\d{10}$/.test(digits))
+        return false;
+    const weights = [6, 5, 7, 2, 3, 4, 5, 6, 7];
+    const d = digits.split('').map(Number);
+    const sum = weights.reduce((acc, w, i) => acc + w * d[i], 0);
+    const check = sum % 11;
+    return check !== 10 && check === d[9];
+}
+export const nipRule = {
+    id: 'pl.nip',
+    entityType: 'NIP',
+    // 10 digits, optionally separated by spaces or dashes in groups: XXX-XXX-XX-XX or XXX-XX-XX-XXX
+    pattern: /\b\d{3}[\s\-]?\d{3}[\s\-]?\d{2}[\s\-]?\d{2}\b/g,
+    locales: ['pl'],
+    engines: ['strict', 'paranoid'],
+    description: 'Polish tax identification number (NIP) — 10 digits with checksum',
+    validate: nipChecksum,
+};
+//# sourceMappingURL=nip.js.map

package/dist/patterns/locale/pl/nip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nip.js","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/nip.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,SAAS,WAAW,CAAC,GAAW;IAC9B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAA;IACzC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC;QAAE,OAAO,KAAK,CAAA;IAC1C,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC3C,MAAM,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IACtC,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IAC5D,MAAM,KAAK,GAAG,GAAG,GAAG,EAAE,CAAA;IACtB,OAAO,KAAK,KAAK,EAAE,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAA;AACvC,CAAC;AAED,MAAM,CAAC,MAAM,OAAO,GAAgB;IAClC,EAAE,EAAE,QAAQ;IACZ,UAAU,EAAE,KAAK;IACjB,gGAAgG;IAChG,OAAO,EAAE,gDAAgD;IACzD,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC;IAC/B,WAAW,EAAE,kEAAkE;IAC/E,QAAQ,EAAE,WAAW;CACtB,CAAA"}

package/dist/patterns/locale/pl/pesel.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const peselRule: PatternRule;
+//# sourceMappingURL=pesel.d.ts.map

package/dist/patterns/locale/pl/pesel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pesel.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/pesel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAgBjD,eAAO,MAAM,SAAS,EAAE,WASvB,CAAA"}

package/dist/patterns/locale/pl/pesel.js

@@ -0,0 +1,25 @@
+/**
+ * Validates a Polish PESEL number using the official checksum algorithm.
+ * Weights: [1, 3, 7, 9, 1, 3, 7, 9, 1, 3]
+ * Check digit = (10 - (weighted_sum % 10)) % 10
+ */
+function peselChecksum(pesel) {
+    if (!/^\d{11}$/.test(pesel))
+        return false;
+    const weights = [1, 3, 7, 9, 1, 3, 7, 9, 1, 3];
+    const digits = pesel.split('').map(Number);
+    const sum = weights.reduce((acc, w, i) => acc + w * digits[i], 0);
+    const check = (10 - (sum % 10)) % 10;
+    return check === digits[10];
+}
+export const peselRule = {
+    id: 'pl.pesel',
+    entityType: 'PESEL',
+    // Exactly 11 consecutive digits NOT adjacent to another digit
+    pattern: /(?<!\d)\d{11}(?!\d)/g,
+    locales: ['pl'],
+    engines: ['balanced', 'strict', 'paranoid'],
+    description: 'Polish national identification number (PESEL) — 11 digits with checksum',
+    validate: peselChecksum,
+};
+//# sourceMappingURL=pesel.js.map

package/dist/patterns/locale/pl/pesel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pesel.js","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/pesel.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,SAAS,aAAa,CAAC,KAAa;IAClC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAA;IACzC,MAAM,OAAO,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAC9C,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC1C,MAAM,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAA;IACjE,MAAM,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,GAAG,EAAE,CAAA;IACpC,OAAO,KAAK,KAAK,MAAM,CAAC,EAAE,CAAC,CAAA;AAC7B,CAAC;AAED,MAAM,CAAC,MAAM,SAAS,GAAgB;IACpC,EAAE,EAAE,UAAU;IACd,UAAU,EAAE,OAAO;IACnB,8DAA8D;IAC9D,OAAO,EAAE,sBAAsB;IAC/B,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC3C,WAAW,EAAE,yEAAyE;IACtF,QAAQ,EAAE,aAAa;CACxB,CAAA"}

package/dist/patterns/locale/pl/phone.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const plPhoneRule: PatternRule;
+//# sourceMappingURL=phone.d.ts.map

package/dist/patterns/locale/pl/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/phone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,eAAO,MAAM,WAAW,EAAE,WAYzB,CAAA"}

package/dist/patterns/locale/pl/phone.js

@@ -0,0 +1,13 @@
+export const plPhoneRule = {
+    id: 'pl.phone',
+    entityType: 'PHONE',
+    // Three alternatives:
+    // 1. International prefix: +48 or 0048, then 9 digits (with optional spaces/dashes)
+    // 2. 9-digit mobile starting with 4–8 (Polish numbering plan)
+    // 3. Landline with area code in parens: (XX) XXX-XX-XX
+    pattern: /(?:\+48|0048)[\s\-]?\d{3}[\s\-]?\d{3}[\s\-]?\d{3}|\b[4-8]\d{2}[\s\-]?\d{3}[\s\-]?\d{3}\b|\(\d{2}\)[\s\-]?\d{3}[\s\-]?\d{2}[\s\-]?\d{2}/g,
+    locales: ['pl'],
+    engines: ['balanced', 'strict', 'paranoid'],
+    description: 'Polish phone number (+48 / 0048 prefix, 9-digit mobile, landline)',
+};
+//# sourceMappingURL=phone.js.map

package/dist/patterns/locale/pl/phone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.js","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/phone.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,EAAE,EAAE,UAAU;IACd,UAAU,EAAE,OAAO;IACnB,sBAAsB;IACtB,oFAAoF;IACpF,8DAA8D;IAC9D,uDAAuD;IACvD,OAAO,EACL,yIAAyI;IAC3I,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC;IAC3C,WAAW,EAAE,mEAAmE;CACjF,CAAA"}

package/dist/patterns/locale/pl/postal-code.d.ts

@@ -0,0 +1,3 @@
+import type { PatternRule } from '../../types.js';
+export declare const plPostalCodeRule: PatternRule;
+//# sourceMappingURL=postal-code.d.ts.map

package/dist/patterns/locale/pl/postal-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"postal-code.d.ts","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/postal-code.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,eAAO,MAAM,gBAAgB,EAAE,WAQ9B,CAAA"}

package/dist/patterns/locale/pl/postal-code.js

@@ -0,0 +1,10 @@
+export const plPostalCodeRule = {
+    id: 'pl.postal-code',
+    entityType: 'POSTAL_CODE',
+    // Polish postal code: XX-XXX (e.g. 00-001, 80-952)
+    pattern: /\b\d{2}-\d{3}\b/g,
+    locales: ['pl'],
+    engines: ['paranoid'],
+    description: 'Polish postal code (XX-XXX format)',
+};
+//# sourceMappingURL=postal-code.js.map

package/dist/patterns/locale/pl/postal-code.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postal-code.js","sourceRoot":"","sources":["../../../../src/patterns/locale/pl/postal-code.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,gBAAgB,GAAgB;IAC3C,EAAE,EAAE,gBAAgB;IACpB,UAAU,EAAE,aAAa;IACzB,mDAAmD;IACnD,OAAO,EAAE,kBAAkB;IAC3B,OAAO,EAAE,CAAC,IAAI,CAAC;IACf,OAAO,EAAE,CAAC,UAAU,CAAC;IACrB,WAAW,EAAE,oCAAoC;CAClD,CAAA"}

package/dist/patterns/types.d.ts

@@ -0,0 +1,21 @@
+import type { PatternDef } from '../languages/types.js';
+export type EngineLevel = 'balanced' | 'strict' | 'paranoid';
+export type SupportedLocale = 'pl' | 'en';
+export interface PatternRule {
+    /** Unique identifier, e.g. 'global.email' or 'pl.pesel' */
+    id: string;
+    /** Token tag used in replacement, e.g. 'EMAIL', 'PESEL' */
+    entityType: string;
+    /** Regex with 'g' flag */
+    pattern: RegExp;
+    /** null = applies to all locales (global); otherwise locale-specific */
+    locales: SupportedLocale[] | null;
+    /** Which engine levels activate this rule */
+    engines: EngineLevel[];
+    description: string;
+    /** Optional post-match validator. Receives the match with whitespace stripped. */
+    validate?: (match: string) => boolean;
+}
+/** Adapter: converts a PatternRule to the PatternDef format used by Engine */
+export declare function toPatternDef(rule: PatternRule): PatternDef;
+//# sourceMappingURL=types.d.ts.map

package/dist/patterns/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/patterns/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AAEvD,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,UAAU,CAAA;AAC5D,MAAM,MAAM,eAAe,GAAG,IAAI,GAAG,IAAI,CAAA;AAEzC,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,EAAE,EAAE,MAAM,CAAA;IACV,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAA;IAClB,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,wEAAwE;IACxE,OAAO,EAAE,eAAe,EAAE,GAAG,IAAI,CAAA;IACjC,6CAA6C;IAC7C,OAAO,EAAE,WAAW,EAAE,CAAA;IACtB,WAAW,EAAE,MAAM,CAAA;IACnB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,OAAO,CAAA;CACtC;AAED,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,IAAI,EAAE,WAAW,GAAG,UAAU,CAM1D"}

package/dist/patterns/types.js

@@ -0,0 +1,9 @@
+/** Adapter: converts a PatternRule to the PatternDef format used by Engine */
+export function toPatternDef(rule) {
+    return {
+        tag: rule.entityType,
+        regex: rule.pattern,
+        validate: rule.validate,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/patterns/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/patterns/types.ts"],"names":[],"mappings":"AAqBA,8EAA8E;AAC9E,MAAM,UAAU,YAAY,CAAC,IAAiB;IAC5C,OAAO;QACL,GAAG,EAAE,IAAI,CAAC,UAAU;QACpB,KAAK,EAAE,IAAI,CAAC,OAAO;QACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;KACxB,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pseudonym-mcp",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "mcpName": "io.github.woladi/pseudonym-mcp",
   "description": "MCP server for privacy-preserving pseudonymization of sensitive data before cloud LLM processing",
   "type": "module",
@@ -84,6 +84,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "commander": "^14.0.0",
+    "franc": "^6.2.0",
     "zod": "^3.25.0"
   },
   "devDependencies": {