` , _inline_ overlays inside the input , _off_ hides UI |\n| `ui.statusIcon` | `\"none\" \\| \"icon\" \\| \"pill\"` | none / icon / pill | `\"none\"` | used **only** when `statusMode` is `inline` |\n| `ui.showStatusText` | `boolean` | true / false | `blockโtrue` , `inlineโfalse` | short text in inline ; full text in block |\n| `ui.iconPosition` | `\"right\" \\| \"left\"` | right / left | `\"right\"` | icon position for inline |\n| `ui.status` | `HTMLElement` ( optional ) | โ | auto created / derived | existing host for status when you do not use `wrapper` |\n| `ui.button` / `dropdown` / `flagIcon` / `flagLabel` | `HTMLElement` ( optional ) | โ | auto created if `wrapper` | for re-using external DOM |\n\n---\n\n### Instance methods\n\n```ts\ntype EuroPlateInstance = {\n setCountry(code: \"AUTO\" | string): void; // alias of setMode\n setMode(m: \"AUTO\" | string): void; // set fixed country or AUTO\n setAllowed(codes: string[]): void; // dynamic whitelist\n setVehicleType(t: \"any\" | \"car\" | \"bike\"): void;\n setI18n(code: \"AUTO\" | \"IT\" | \"EN\"): void;\n setDebug(on: boolean): void;\n\n validate(): { ok: boolean; country?: string; value: string };\n destroy(): void;\n getI18n(): \"it\" | \"en\";\n};\n```\n\n---\n\n## ๐ผ๏ธ Usage examples\n\n### A ) Quick start with a shared `common` config + autoload deps ( Inputmask , jQuery , Toastr )\n\n```html\n
\n\n
\n\n\n```\n\n> Notes :\n>\n> - With `autoLoadDeps.jquery: true` and `autoLoadDeps.toastr: true` the client will fetch UMD builds from CDN when missing .\n> - `useToastrLogger: true` sends SDK logs and validation notices to Toastr if it is present ( either auto-loaded or injected ) .\n> - jQuery is **not** required by the core validator ; it is only pulled if your page / widgets rely on it .\n\n---\n\n### B ) You provide `Inputmask` manually ( UMD โ `window.Inputmask` )\n\n```html\n
\n\n\n\n```\n\n---\n\n### C ) Autoload deps from CDN ( default , Inputmask only )\n\n```html\n\n```\n\n---\n\n### D ) Autoload ON with a custom CDN URL\n\n```js\ncreateEuroPlate(EuroMod, {\n wrapper: \"#plateBox\",\n cdn: { inputmask: \"https://unpkg.com/inputmask@5.0.9/dist/inputmask.min.js\" },\n});\n```\n\n---\n\n### E ) Disable autoload ( โno maskโ fallback , no error )\n\n```js\ncreateEuroPlate(EuroMod, {\n wrapper: \"#plateBox\",\n autoLoadDeps: { inputmask: false },\n});\n```\n\n---\n\n### F ) Attach to an existing input ( no auto-build )\n\n```html\n
\n\n```\n\n---\n\n## ๐งฉ WordPress ( WP ) / Elementor\n\n### 1 ) Enqueue CSS + init helper ( type = \"module\" )\n\n```php\nadd_action('wp_enqueue_scripts', function () {\n wp_register_script('epv-init', '', [], null, true);\n\n wp_enqueue_style(\n 'epv-styles',\n 'https://cdn.jsdelivr.net/npm/@codecorn/euro-plate-validator@1.0.14/dist/assets/css/styles.css',\n [],\n '1.0.14'\n );\n\n add_filter('script_loader_tag', function ($tag, $handle) {\n if ($handle === 'epv-init') {\n return '';\n }\n return $tag;\n }, 10, 2);\n\n wp_enqueue_script('epv-init');\n});\n```\n\n---\n\n## โ๏ธ WordPress / Elementor integration\n\nYou can enqueue the CSS and auto-inject a `window.__epvInit` bootstrapper.\n\nThen, create a shortcode to instantiate it dynamically inside Elementor.\n\nFull example available in the [Italian README](./README_IT.md) โ _โWordPress (WP) / Elementorโ_ section.\n\n---\n\n## ๐งช CLI Tool\n\n```bash\nnpx @codecorn/euro-plate-validator \"AB 123 CD\" --countries IT,FR,DE --type car --pretty\n```\n\n**Options:**\n\n- `--countries` / `-c` โ comma-separated list of country codes\n- `--type` / `-t` โ `car`, `motorcycle`, or `any`\n- `--pretty` / `-p` โ human-readable output\n\nExit codes:\n\n- `0` โ valid\n- `1` โ invalid\n- `2` โ bad arguments\n\n---\n\n## ๐ Supported Countries\n\n๐ฎ๐น IT | ๐ฌ๐ง UK | ๐ฉ๐ช DE | ๐ซ๐ท FR | ๐ช๐ธ ES | ๐ต๐น PT | ๐ณ๐ฑ NL | ๐ง๐ช BE | ๐จ๐ญ CH | ๐ฆ๐น AT | ๐ฎ๐ช IE | ๐ฑ๐บ LU ๐ฉ๐ฐ DK | ๐ธ๐ช SE | ๐ณ๐ด NO | ๐ซ๐ฎ FI | ๐ต๐ฑ PL | ๐จ๐ฟ CZ | ๐ธ๐ฐ SK | ๐ญ๐บ HU | ๐ท๐ด RO | ๐ง๐ฌ BG | ๐ธ๐ฎ SI | ๐ญ๐ท HR | ๐ฌ๐ท GR ๐ฑ๐น LT | ๐ฑ๐ป LV | ๐ช๐ช EE | ๐บ๐ฆ UA\n\n---\n\n## ๐งพ Changelog (highlights)\n\n### 1.0.14\n\n- **Inputmask**\n - Safe merge of `definitions` (no hard override of defaults).\n - New **`L`** token (letter) accepts lowercase and forces **UPPERCASE** (`casing: \"upper\"`).\n - Avoid redefining `A`/`9`; use `H` (IT) / `C` (ES) only when needed.\n - `applyMaskNow` applied immediately on country change (no debounce race).\n - Finalized placeholders via `finalizeInputMaskLayouts` + `scripts/test-placeholders.mjs`.\n\n- **Client SDK**\n - Centralized logging (`imLog`, `imPreLog`, `imMounted`, `imError`) using `BADGE/LOG` when `debug: true`.\n - Lowercase input supported across layouts with `L` token.\n - Examples updated with `autoLoadDeps: { inputmask: true, jquery: true, toastr: true }` and `useToastrLogger: true`.\n\n- **Docs**\n - CDN bumped to **1.0.14**.\n - Notes about lowercase acceptance and uppercase coercion.\n - Guidance to **not** override `A`/`9` and define only custom tokens for restricted alphabets.\n\n---\n\n### 1.0.13\n\n- **Status inline configurabile**\n - `statusMode: \"inline\" | \"block\" | \"off\"`\n - `statusIcon: \"none\" | \"icon\" | \"pill\"`\n - `showStatusText: boolean`\n - `iconPosition: \"left\" | \"right\"`\n\n- Riserva spazio automatica via `:has([data-state])`\n- Nessuno stato su campo vuoto / parziale\n- Fix cambio paese (ITโFR) e Inputmask merge (`A/H/9`)\n- Refactor UI status (`setValidityUI` unico writer)\n- Add `clearStatusUI()` per idle neutro\n\n---\n\n### 1.0.12\n\n- NEW โ `autoFocusOnInit` (default: `false`) โ prevents autofocus on init.\n- NEW โ `preserveInputAttrs` โ keeps external input `id`/`name` intact.\n- UX โ renamed CSS classes from `.iti__*` โ `.epv__*`.\n- Dependencies โ auto-loads `Inputmask` UMD via CDN; supports manual injection and CDN override.\n- I18n โ IT / EN / AUTO (auto-detect from browser locale).\n- UX stability โ dynamic placeholder, country-based formatter, debounce system.\n\n---\n\n### 1.0.10โ11\n\n- CSS/Assets consolidation.\n- Added Client SDK + autoload fallback.\n- Updated README, docs, and npm package.\n\n---\n\n## ๐ License\n\nMIT ยฉ [CodeCornโข](https://codecorn.it) โ see [LICENSE](LICENSE)\n\n---\n\n## ๐ค Maintainer\n\n**Federico Girolami** Full-Stack Developer โข System Integrator โข Digital Solution Architect ๐ ๐ [codecorn.it](https://codecorn.it) ๐ง [f.girolami@codecorn.it](mailto:f.girolami@codecorn.it) ๐ [github.com/fgirolami29](https://github.com/fgirolami29)\n\n---\n\n## ๐ค Contributing\n\nPull requests are welcome. For major changes, please open an issue first.\n\n> Powered by **CodeCornโข** ๐\n\n---\n","readmeFilename":"README.md"}