@yashau/thaana 0.0.0-stage → 2026.1023.0

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2026 Ibrahim Yashau
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+This license covers the code in this repository. The fonts in fonts/sources and
+apps/web/static/fonts keep their own licenses; see each family's README.

package/README.md

@@ -1,3 +1,69 @@
-# Temporary Holding Version
+# @yashau/thaana
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Everything to make Thaana (Dhivehi) work on the web, in ~3 KB. No dependencies.
+
+```sh
+npm i @yashau/thaana
+```
+
+React, Svelte or Vue? Use [`@yashau/thaana-react`](https://www.npmjs.com/package/@yashau/thaana-react), [`@yashau/thaana-svelte`](https://www.npmjs.com/package/@yashau/thaana-svelte) or [`@yashau/thaana-vue`](https://www.npmjs.com/package/@yashau/thaana-vue). They re-export everything below.
+
+## Keyboard: type Thaana on any keyboard
+
+Most people have no Dhivehi keyboard installed. This rewrites Latin keystrokes to Thaana with the standard **Divehi Phonetic** layout (Microsoft's kbddiv1, the one Maldivian sites use): `h`→ހ, `a`→ަ, `q`→ް, `w`→އ, `,`→،, `?`→؟.
+
+```js
+import { attachKeyboard } from '@yashau/thaana';
+
+let dv = true; // e.g. bound to a DV/EN toggle
+const detach = attachKeyboard(document.querySelector('#name'), { enabled: () => dv });
+```
+
+Or with no JS of your own:
+
+```html
+<script type="module">
+	import '@yashau/thaana/auto';
+</script>
+<input data-thaana />
+<textarea data-thaana></textarea>
+```
+
+Or with no build step at all:
+
+```html
+<script src="https://dvfonts.yashau.com/thaana.iife.js"></script>
+<!-- window.Thaana -->
+```
+
+- Only single typed characters are rewritten. Paste, IME composition, autocorrect, deletion and real Dhivehi keyboards pass through.
+- Inserts through the browser's editing command, so `input` events fire (controlled inputs keep working) and undo works.
+- Sets `dir="rtl"`, `lang="dv"` and turns off autocorrect/autocapitalize/spellcheck unless you set them, then keeps `dir` in step with the text (RTL if it contains any Thaana, LTR only for pure Latin; `autoDirection: false` to opt out).
+- Bracket pairs are swapped like Microsoft's layout: press the key that looks right in RTL (`)` to open on the right) and the stored text keeps `(` before the enclosed text, which the browser mirrors.
+- Rich-text editors (Lexical, TipTap, ProseMirror): call `thaanaForInputEvent(event)` in the editor's `beforeinput` hook and insert the result through the editor's API.
+
+## Text helpers
+
+| Function                                                                      | What it's for                                                                                                                                 |
+| ----------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| `transliterate('divehi')`                                                     | `"ދިވެހި"`: replays keystrokes in the layout.                                                                                                    |
+| `convertLegacy(text, { layout })`                                             | Converts text typed in old pre-Unicode A_ fonts (it looks like `ihevid`) to Unicode.                                                          |
+| `repairPdfText(text)`                                                         | Fixes Thaana copied out of PDFs: reversed dates/times, stray spaces, jumped list markers.                                                     |
+| `normalizePunctuation(text)`                                                  | `"ބަސް ، ބުދަ ?"` → `"ބަސް، ބުދަ؟"`, tightens brackets.                                                                                               |
+| `isolateNumbers(text)`                                                        | Keeps `-5`, `+960 333-1234`, `9:00`, `1,000`, `50%` readable inside RTL text. Display only; the framework packages wrap it in `<ThaanaText>`. |
+| `isolate(value)`                                                              | Wraps a URL, email or name so it can't scramble the sentence around it.                                                                       |
+| `stripBidiControls(text)`                                                     | Removes bidi controls before saving or comparing.                                                                                             |
+| `hasThaana`, `hasRtl`, `isMixedScript`, `detectDirection`, `resolveDirection` | Script and direction detection.                                                                                                               |
+| `fontStack('Faruma')`                                                         | `'Faruma', system-ui, 'Noto Sans Thaana', 'MV Boli', sans-serif`                                                                              |
+| `loadFonts({ family: 'Faruma' })`                                             | Loads a font from [dvfonts](https://dvfonts.yashau.com) and resolves when it can be drawn.                                                    |
+| `PANGRAMS`, `LETTERS`, `FILI`, …                                              | Sample text and the alphabet.                                                                                                                 |
+
+## CSS defaults
+
+```js
+import '@yashau/thaana/thaana.css';
+```
+
+Applies to `:lang(dv)`: RTL, line height that doesn't clip fili, no synthetic italics/bold, `unicode-bidi: plaintext` for user content, LTR for code/URLs/emails.
+
+Guide: https://dvfonts.yashau.com/docs · Agent guide: https://dvfonts.yashau.com/llms.txt

package/dist/auto.d.ts

@@ -0,0 +1 @@
+export declare function startAutoAttach(): void;

package/dist/auto.js

@@ -0,0 +1,13 @@
+import { n as autoAttach } from "./keyboard-C7ryTCJR.js";
+// src/auto.ts
+/** Attach to [data-thaana] fields once the DOM is ready. Called explicitly by
+*  the CDN/IIFE builds so a bundler can't tree-shake it away. */
+let started = false;
+function startAutoAttach() {
+	if (started || typeof document === "undefined") return;
+	started = true;
+	if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", () => autoAttach(), { once: true });
+	else autoAttach();
+}
+startAutoAttach();
+export { startAutoAttach };

package/dist/cdn/thaana.js

@@ -0,0 +1,7 @@
+const e=Object.freeze({q:`ް`,w:`އ`,e:`ެ`,r:`ރ`,t:`ތ`,y:`ޔ`,u:`ު`,i:`ި`,o:`ޮ`,p:`ޕ`,a:`ަ`,s:`ސ`,d:`ދ`,f:`ފ`,g:`ގ`,h:`ހ`,j:`ޖ`,k:`ކ`,l:`ލ`,z:`ޒ`,x:`×`,c:`ޗ`,v:`ވ`,b:`ބ`,n:`ނ`,m:`މ`,Q:`ޤ`,W:`ޢ`,E:`ޭ`,R:`ޜ`,T:`ޓ`,Y:`ޠ`,U:`ޫ`,I:`ީ`,O:`ޯ`,P:`÷`,A:`ާ`,S:`ށ`,D:`ޑ`,F:`ﷲ`,G:`ޣ`,H:`ޙ`,J:`ޛ`,K:`ޚ`,L:`ޅ`,Z:`ޡ`,X:`ޘ`,C:`ޝ`,V:`ޥ`,B:`ޞ`,N:`ޏ`,M:`ޟ`,",":`،`,";":`؛`,"?":`؟`,"(":`)`,")":`(`,"[":`]`,"]":`[`,"{":`}`,"}":`{`,"<":`>`,">":`<`});function t(t){let n=``;for(let r of t)n+=e[r]??r;return n}function n(e){return e>=1424&&e<=2303||e>=64285&&e<=65023||e>=65136&&e<=65278||e>=67584&&e<=69631||e>=124928&&e<=126975}function r(e){return e>=65&&e<=90||e>=97&&e<=122||e>=192&&e<=687&&e!==215&&e!==247||e>=880&&e<=1023||e>=1024&&e<=1279}const i=/[ހ-޿]/u;function a(e){return i.test(e)}function o(e){for(let t of e)if(n(t.codePointAt(0)))return!0;return!1}function s(e){let t=!1,i=!1;for(let a of e){let e=a.codePointAt(0);if(n(e)?t=!0:r(e)&&(i=!0),t&&i)return!0}return!1}function c(e){for(let t of e){let e=t.codePointAt(0);if(n(e))return`rtl`;if(r(e))return`ltr`}return`neutral`}function l(e,t,n=`ltr`){return t||(o(e)?`rtl`:c(e)===`ltr`?`ltr`:n)}const u=`⁦`,d=`⁧`,f=`⁨`,p=`⁩`;function m(e,t=`ltr`){return(t===`ltr`?`⁦`:t===`rtl`?`⁧`:`⁨`)+e+`⁩`}const h=/(^|[\s\p{P}\p{S}])(\+\d[\d -]*\d|[+\-\u2212]?\d(?:[\d.,:/-]*\d)?%?)(?=$|[\s\p{P}\p{S}])/gu;function g(e,t=o(e)){return t?e.replace(h,(e,t,n)=>`${t}⁦${n}⁩`):e}const _=/[؜‎‏‪-‮⁦-⁩]/gu;function v(e){return e.replace(_,``)}const y=`[\\d\\u0590-\\u08FF\\uFB1D-\\uFDFF\\uFE70-\\uFEFE]`,b=/^[\p{Ps}\p{Pi}]$/u,x=RegExp(`(\\p{P})\\s+(?=${y})`,`gu`),S=RegExp(`(${y})\\s+(\\p{P})`,`gu`);function C(e,t={}){let{arabicPunctuation:n=!0}=t,r=e;return n&&(r=r.replace(/([ހ-޿])(\s*),/gu,`$1$2،`).replace(/([ހ-޿])(\s*);/gu,`$1$2؛`).replace(/([ހ-޿])(\s*)\?/gu,`$1$2؟`)),r.split(`
+`).map(e=>e.replace(x,(e,t)=>b.test(t)?t:e).replace(S,(e,t,n)=>b.test(n)?e:`${t}${n}`)).join(`
+`)}function w(e){return e.split(`
+`).map(e=>{if(!a(e))return e;let t=e.replace(/([/:])\s+(?=\d)/gu,`$1`);t=t.replace(/\d+(?:[/:]\d+)+/gu,e=>{let t=new Set(e.match(/[/:]/gu));if(t.size!==1)return e;let[n]=t;return e.split(n).toReversed().join(n)}),t=C(t,{arabicPunctuation:!1}),t=t.replace(/^(\s*)\.(\d)(\d)(\s+)/u,(e,t,n,r,i)=>`${t}${r}-${n}${i}`);let n=/^(\s*)(\d+)(\s+)([\s\S]*?)(\s*)\.$/u.exec(t);if(n&&a(n[4])){let[,e,r,i,a,o]=n;t=`${e}.${r}${i}${a}${o}`}return t}).join(`
+`)}const T=[`Noto Sans Thaana`,`MV Boli`];function E(e,{latin:t=`system-ui`}={}){return[e,t,...T,`sans-serif`].map(D).join(`, `)}function D(e){return/^[a-z-]+$/.test(e)?e:`'${e}'`}function O(t){if(t.inputType!==`insertText`||t.isComposing)return null;let n=t.data&&t.data.length===1?t.data:void 0;return n?e[n]??null:null}function k(e,t={}){let{enabled:n=()=>!0,setAttributes:r=!0,autoDirection:i=!0}=t;if(r)for(let[t,n]of[[`dir`,`rtl`],[`lang`,`dv`],[`autocomplete`,`off`],[`autocorrect`,`off`],[`autocapitalize`,`none`],[`spellcheck`,`false`]])e.hasAttribute(t)||e.setAttribute(t,n);let a=!1,o=t=>{let r=t;if(a||!n())return;let i=O(r);if(i){r.preventDefault(),a=!0;try{if(typeof document.execCommand==`function`&&document.execCommand(`insertText`,!1,i))return;if(e instanceof HTMLInputElement||e instanceof HTMLTextAreaElement){let t=e.selectionStart??e.value.length;e.setRangeText(i,t,e.selectionEnd??t,`end`),e.dispatchEvent(new Event(`input`,{bubbles:!0}))}}finally{a=!1}}},s=()=>e instanceof HTMLInputElement||e instanceof HTMLTextAreaElement?e.value:e.textContent??``,c=()=>{e.dir=l(s(),null,`rtl`)};return e.addEventListener(`beforeinput`,o),i&&(e.addEventListener(`input`,c),c()),()=>{e.removeEventListener(`beforeinput`,o),e.removeEventListener(`input`,c)}}const A=/* @__PURE__ */ new WeakMap;function j(e=document){let t=()=>{for(let t of e.querySelectorAll(`[data-thaana]`))A.has(t)||t.dataset.thaana===`off`||A.set(t,k(t))};t();let n=new MutationObserver(t);return n.observe(e instanceof Document?e.documentElement:e,{childList:!0,subtree:!0}),()=>n.disconnect()}let M=!1;function N(){M||typeof document>`u`||(M=!0,document.readyState===`loading`?document.addEventListener(`DOMContentLoaded`,()=>j(),{once:!0}):j())}N();const P={typewriter:{a:`އ`,b:`ބ`,c:`ް`,d:`ދ`,e:`ެ`,f:`ފ`,g:`ގ`,h:`ހ`,i:`ި`,j:`ޖ`,k:`ކ`,l:`ލ`,m:`މ`,n:`ނ`,o:`ޮ`,p:`ޕ`,q:`ޤ`,r:`ރ`,s:`ސ`,t:`ތ`,u:`ު`,v:`ވ`,w:`ަ`,x:`ޝ`,y:`ޔ`,z:`ޒ`,A:`ޢ`,B:`ޞ`,C:`ޗ`,D:`ޑ`,E:`ޭ`,F:`ޟ`,G:`ޣ`,H:`ޙ`,I:`ީ`,J:`ޛ`,K:`ޚ`,L:`ޅ`,N:`ޏ`,O:`ޯ`,R:`ޜ`,S:`ށ`,T:`ޓ`,U:`ޫ`,V:`ޥ`,W:`ާ`,X:`ޘ`,Y:`ޠ`,Z:`ޡ`,Q:`ﷲ`,",":`،`,";":`؛`,"?":`؟`},phonetic:{q:`ް`,w:`އ`,e:`ެ`,r:`ރ`,t:`ތ`,y:`ޔ`,u:`ު`,i:`ި`,o:`ޮ`,p:`ޕ`,a:`ަ`,s:`ސ`,d:`ދ`,f:`ފ`,g:`ގ`,h:`ހ`,j:`ޖ`,k:`ކ`,l:`ލ`,z:`ޒ`,c:`ޗ`,v:`ވ`,b:`ބ`,n:`ނ`,m:`މ`,Q:`ޤ`,W:`ޢ`,E:`ޭ`,R:`ޜ`,T:`ޓ`,Y:`ޠ`,U:`ޫ`,I:`ީ`,O:`ޯ`,A:`ާ`,S:`ށ`,D:`ޑ`,F:`ﷲ`,G:`ޣ`,H:`ޙ`,J:`ޛ`,K:`ޚ`,L:`ޅ`,Z:`ޡ`,X:`ޘ`,C:`ޝ`,V:`ޥ`,B:`ޞ`,N:`ޏ`,M:`ޟ`,",":`،`,";":`؛`,"?":`؟`}};function F(e,t={}){let{layout:n=`typewriter`,reverse:r=!0}=t,i=P[n];return e.split(/(\r?\n)/).map(e=>{if(e===`
+`||e===`\r
+`)return e;let t=(r?[...e].toReversed():[...e]).map(e=>i[e]??e).join(``);return r&&(t=t.replace(/\d[\d.,:/-]*\d|\d/g,e=>[...e].toReversed().join(``))),t}).join(``)}const I=`https://dvfonts.yashau.com`;function L(e,{display:t=`swap`,origin:n=I}={}){return`${n}/css2?${(Array.isArray(e)?e:[e]).map(({family:e,weights:t})=>`family=${encodeURIComponent(e).replace(/%20/g,`+`)}${t?.length?`:wght@${t.toSorted((e,t)=>e-t).join(`;`)}`:``}`).join(`&`)}&display=${t}`}function R(e,t){let n=L(e,t),r=document.querySelector(`link[data-dvfonts][href="${CSS.escape(n)}"]`);r||(r=document.createElement(`link`),r.rel=`stylesheet`,r.href=n,r.dataset.dvfonts=``,document.head.append(r));let i=Array.isArray(e)?e:[e];return new Promise((e,t)=>{if(r.sheet)return e();r.addEventListener(`load`,()=>e(),{once:!0}),r.addEventListener(`error`,()=>t(/* @__PURE__ */ Error(`Could not load ${n}`)),{once:!0})}).then(()=>Promise.all(i.flatMap(({family:e,weights:t=[400]})=>t.map(t=>document.fonts.load(`${t} 16px "${e}"`,`ދ`)))).then(()=>void 0))}const z=[`ޗާލު ޒުވާން ކުއްޖާ، ފޮށިން ޕެކެޓެއް ކަނޑައި، ޏަމްޏަމް ގަހުގައި އިން ބުޅަލަށް މަސްދީ، ރީތި ލަވައެއް ކިޔައިދިނެވެ.`,`ކުޑަ ޗުއްޓީއެއްގައި ޏ. އަތޮޅަށް ފުރަން ޓިކެޓާއި ބޮޑު ފޮށި ހިފައިގެން، ޒުވާން ޕައިލެޓް މަޖާ ލަވައެއް ސަކަރާތާއެކު ކިޔަމުން ދިޔައެވެ.`,`ޕާކުގައި ހުރި މޭޒުމަތީގައި، ކުޑަ ކުއްޖާ ފޮނި ޏަމްޏަމް މޭވާއާއި ޗޮކްލެޓް ބަހައްޓައި، ޅަ އެކުވެރިޔާއަށް ތަށިން ސައި ދިނެވެ.`,`ސުކޫލު ކުލާހުގައި ހުރި ބޯޑުގައި، މޮޅު ކުއްޖާ ތާނަ އަކުރު 'ޏަވިޔަނި' ވަރަށް ޗާލުކޮށް ޕެންސިލުން ފޮތުގައި ލިޔެ، ޒުވާން ޓީޗަރަށް ދެއްކިއެވެ.`,`ބާޒާރުން ތާޒާ ޏަމްޏަމް މޭވާއާއި، ޗީޒް، ޓޮމާޓޯ އަދި ފޮނި ޖޭމު ޑަބިޔަލެއް ގަނެގެން، ކުއްޖާ ޕްލާސްޓިކް ކޮތަޅަށް އަޅައިގެން އަވަހަށް ހިނގައިގަތެވެ.`,`ރީތި ޗާލު ހަނދުވަރުގައި، ޏ. އަތޮޅުގެ ގޮނޑުދޮށުގައި ޒުވާނުން ބޮޑުބެރު ޖަހައި، ޕާޓީއެއް ހަދައި، ފާނޫޒު ދިއްލައިގެން މަޖާ ލަވަތައް ކިޔައި ސަކަރާތްޖެހިއެވެ.`,`ޗަސްބިމުގައި ހުރި ޏަމްޏަމް ގަހުގެ ގޮފިތަކަށް ޖެހި، ޅަ ލޯބި ދޫނި، ކުޑަ ޕިކަޕެއްގައި އައި ޒުވާނުން ޖެހި ޓެންޓު މަތިން އުދުހިގެން ދިޔައެވެ.`,`މީރު ޗޮކްލެޓާއި، ބަޓަރު، ފުށް، ޗީޒް އަދި ޏަމްޏަމް އެއްކޮށް، ބޮޑު ތައްޓަކަށް ސަމުސަލުން ހަކުރު އަޅައިގެން، ޒުވާން ކުއްޖާ ޕޭސްޓްރީ ތައްޔާރުކުރިއެވެ.`],B=`ރަމަޟާން މަހުގެ ޚާއްޞަ ޘަޤާފަތާއި ޝަރީޢަތުގެ ޙަޤީޤަތް ޙިފްޡުކޮށް ޛިކުރުކުރުމަކީ ބަޣާވާތެއް ނޫނެވެ.`,V=(e,t)=>Array.from({length:t-e},(t,n)=>String.fromCodePoint(e+n)),H=V(1920,1944),U=V(1944,1958),W=V(1958,1969);N();export{U as ARABIC_LETTERS,B as ARABIC_LETTERS_SAMPLE,I as DVFONTS_ORIGIN,W as FILI,f as FSI,e as KEYMAP,P as LEGACY_LAYOUTS,H as LETTERS,u as LRI,z as PANGRAMS,p as PDI,d as RLI,T as SYSTEM_THAANA_FONTS,k as attachKeyboard,j as autoAttach,F as convertLegacy,c as detectDirection,L as fontCssUrl,E as fontStack,o as hasRtl,a as hasThaana,s as isMixedScript,m as isolate,g as isolateNumbers,R as loadFonts,C as normalizePunctuation,w as repairPdfText,l as resolveDirection,v as stripBidiControls,O as thaanaForInputEvent,t as transliterate};

package/dist/index.d.ts

@@ -0,0 +1,180 @@
+/**
+ * Latin key -> Thaana: Microsoft's "Divehi Phonetic" keyboard layout (kbddiv1),
+ * the layout Maldivian websites use via aharen/thaana-keyboard
+ * (h→ހ, a→ަ, q→ް sukun, w→އ alifu …).
+ *
+ * Bracket pairs are swapped, as in Microsoft's layout and rihaPDF. Browsers
+ * mirror ( ) [ ] { } < > in RTL text, so a Dhivehi typist opens with the key
+ * that looks right on screen (")"), which stores U+0028: the glyph matches the
+ * key pressed and the stored text stays in logical order.
+ */
+export declare const KEYMAP: Readonly<Record<string, string>>;
+/**
+ * Replay keystrokes in the Divehi Phonetic layout: maps character by character.
+ * `transliterate('divehi')` → "ދިވެހި". This is not a romanisation converter;
+ * pass what a user would type on the layout, not arbitrary English spellings.
+ */
+export declare function transliterate(text: string): string;
+interface KeyboardOptions {
+  /** Return false to let keystrokes through untouched (e.g. a DV/EN toggle). Default: always on. */
+  enabled?: () => boolean;
+  /** Set dir="rtl", lang="dv" and disable autocorrect/autocapitalize/spellcheck
+   *  unless the element already sets them. Default: true. */
+  setAttributes?: boolean;
+  /** Keep `dir` in step with the text: RTL when it contains Thaana (or is
+   *  empty / has no letters), LTR only for pure Latin. Default: true. */
+  autoDirection?: boolean;
+}
+type Editable = HTMLInputElement | HTMLTextAreaElement | HTMLElement;
+/**
+ * The Thaana character a `beforeinput` event should insert instead, or null to
+ * let it through. For rich-text editors (Lexical, TipTap/ProseMirror, Slate…)
+ * that own their own insertion: call this in the editor's beforeinput hook,
+ * preventDefault, and insert the result through the editor's API.
+ * Only single typed characters are mapped; IME composition, paste,
+ * autocorrect and deletes return null.
+ */
+export declare function thaanaForInputEvent(event: InputEvent): string | null;
+/**
+ * Make an <input>, <textarea> or contenteditable element type Thaana on any
+ * keyboard. Only single typed characters are rewritten; paste, IME
+ * composition, autocorrect, deletion and text from a real Dhivehi keyboard
+ * pass through. Inserts via the browser's own editing command, so `input`
+ * events fire (React/Vue/Svelte bindings keep working) and undo works.
+ *
+ * @returns a function that detaches the keyboard.
+ */
+export declare function attachKeyboard(el: Editable, options?: KeyboardOptions): () => void;
+/**
+ * Attach the keyboard to every `[data-thaana]` element under `root`, now and as
+ * elements are added later. `data-thaana="off"` opts an element out.
+ * @returns a function that stops watching (already-attached fields stay attached).
+ */
+export declare function autoAttach(root?: ParentNode): () => void;
+type LegacyLayout = "typewriter" | "phonetic";
+/** ASCII -> Unicode maps for pre-Unicode Thaana fonts.
+ *  typewriter: the "A_" fonts (A_Waheed, A_Faseyha, A_Randhoo, A_Haleem …).
+ *  phonetic:   a few older casual fonts (Thaana, Akko, Athu Casual, Avas Thaana …). */
+export declare const LEGACY_LAYOUTS: Readonly<Record<LegacyLayout, Readonly<Record<string, string>>>>;
+interface ConvertLegacyOptions {
+  /** Which legacy font family the text was typed for. Default: 'typewriter' (A_ fonts). */
+  layout?: LegacyLayout;
+  /** Legacy documents store each line in visual (left-to-right) order. Reverse
+   *  lines back to logical order. Default: true. */
+  reverse?: boolean;
+}
+/**
+ * Convert text typed in a pre-Unicode Thaana font (it looks like Latin
+ * gibberish such as "ihevid" once the font is gone) into Unicode Thaana.
+ * Each line is reversed into logical order, characters are mapped, and digit
+ * groups are put back in reading order.
+ */
+export declare function convertLegacy(text: string, options?: ConvertLegacyOptions): string;
+/** True if the string contains any Thaana. */
+export declare function hasThaana(text: string): boolean;
+/** True if the string contains any right-to-left letter (Thaana, Arabic, Hebrew…). */
+export declare function hasRtl(text: string): boolean;
+/** True if the string mixes right-to-left letters with Latin/Greek/Cyrillic
+ *  letters. Digits, spaces and punctuation don't count, so "ދިވެހި 123" is not mixed. */
+export declare function isMixedScript(text: string): boolean;
+/** Direction of the first strong character, the same rule as dir="auto". */
+export declare function detectDirection(text: string): "rtl" | "ltr" | "neutral";
+/**
+ * Direction to render a piece of text with (rihaPDF's rule). An explicit
+ * choice always wins; otherwise any right-to-left letter makes it RTL. This
+ * suits Dhivehi UIs better than dir="auto", which turns "Apple ގެ ފޯނު"
+ * left-to-right because the first letter is Latin. Text with no letters at all
+ * (digits, punctuation) gets `fallback`: pass 'rtl' in Thaana contexts.
+ */
+export declare function resolveDirection(text: string, explicit?: "rtl" | "ltr" | null, fallback?: "rtl" | "ltr"): "rtl" | "ltr";
+/** Unicode bidi isolates. Prefer the HTML <bdi> element when you control markup. */
+export declare const LRI = "⁦";
+export declare const RLI = "⁧";
+export declare const FSI = "⁨";
+export declare const PDI = "⁩";
+/**
+ * Wrap a value in a directional isolate so it can't scramble the sentence
+ * around it: phone numbers, URLs, emails, code or user names inside Thaana
+ * text. For plain strings (titles, notifications, canvas, SVG) where you can't
+ * use <bdi> or dir="ltr".
+ */
+export declare function isolate(value: string, direction?: "ltr" | "rtl" | "auto"): string;
+/**
+ * Wrap numbers in right-to-left text in left-to-right isolates, so "-5",
+ * "+960 333-1234", "9:00", "1,000" and "50%" keep their order inside Thaana.
+ * Brackets around a number stay outside the isolate (putting them inside makes
+ * the closing bracket jump). No-op for text without right-to-left letters.
+ * Strip the controls again with stripBidiControls() before saving.
+ */
+export declare function isolateNumbers(text: string, rtl?: boolean): string;
+/** Remove bidi control characters (before saving, searching or comparing text). */
+export declare function stripBidiControls(text: string): string;
+interface NormalizePunctuationOptions {
+  /** Turn Latin , ; ? that follow Thaana into ، ؛ ؟. Default: true. */
+  arabicPunctuation?: boolean;
+}
+/**
+ * Tidy spacing and punctuation in Thaana text:
+ *   "ބަސް ، ބުދަ ؛ އެއް ؟ ނޫން !"  →  "ބަސް، ބުދަ؛ އެއް؟ ނޫން!"
+ *   "ދުވަސް ( ބުރުނު ) [ 8 ]"      →  "ދުވަސް (ބުރުނު) [8]"
+ * Spaces before punctuation go, spaces just inside opening brackets/quotes go,
+ * and the space before an opening bracket is kept.
+ */
+export declare function normalizePunctuation(text: string, options?: NormalizePunctuationOptions): string;
+/**
+ * Repair Thaana text copied out of a PDF. PDFs store right-to-left text in
+ * visual order, so after copy/paste dates and times come out reversed
+ * ("2026/1/14" for 14/1/2026, "00:9" for 9:00), punctuation picks up stray
+ * spaces, numbered-list markers jump to the end ("1 ބައި." for ".1 ބައި") and
+ * "1.2" section markers arrive as ".12". Only lines containing Thaana are
+ * touched. Do NOT run this on text people typed: it would reverse their dates.
+ */
+export declare function repairPdfText(text: string): string;
+/** Thaana fonts installed on common systems, used as a fallback for glyphs a
+ *  web font lacks: MV Boli ships with Windows, Noto Sans Thaana with Android
+ *  and most Linux desktops. */
+export declare const SYSTEM_THAANA_FONTS: readonly string[];
+/**
+ * A font-family value that keeps both scripts readable: most Dhivehi fonts have
+ * no Latin letters, so Latin falls through to the system UI font, and missing
+ * Thaana falls through to an installed Thaana font.
+ *
+ *   fontStack('Faruma')  →  "'Faruma', system-ui, 'Noto Sans Thaana', 'MV Boli', sans-serif"
+ */
+export declare function fontStack(family: string, { latin }?: {
+  latin?: string;
+}): string;
+/** Load Dhivehi fonts from dvfonts (Google-Fonts-compatible CSS API). */
+export declare const DVFONTS_ORIGIN = "https://dvfonts.yashau.com";
+interface FontRequest {
+  /** Family name, e.g. "Faruma" or "MV Faseyha" (old names like "A_Waheed" work too). */
+  family: string;
+  /** Weights to load. Default: the family's default weight. */
+  weights?: number[];
+}
+/** URL of the CSS for one or more families. */
+export declare function fontCssUrl(fonts: FontRequest | FontRequest[], { display, origin }?: {
+  display?: string;
+  origin?: string;
+}): string;
+/**
+ * Add the stylesheet for the given families to <head> (once per URL) and
+ * resolve when the fonts are ready to draw with. Use the family name in CSS
+ * afterwards: font-family: 'Faruma', system-ui, sans-serif.
+ */
+export declare function loadFonts(fonts: FontRequest | FontRequest[], options?: {
+  display?: string;
+  origin?: string;
+}): Promise<void>;
+/** Sample sentences that each use all 24 native Thaana letters. Shown at
+ *  random on dvfonts. */
+export declare const PANGRAMS: readonly string[];
+/** Uses 12 of the 14 Arabic-derived letters (ޜ and ޥ have no common words). */
+export declare const ARABIC_LETTERS_SAMPLE = "ރަމަޟާން މަހުގެ ޚާއްޞަ ޘަޤާފަތާއި ޝަރީޢަތުގެ ޙަޤީޤަތް ޙިފްޡުކޮށް ޛިކުރުކުރުމަކީ ބަޣާވާތެއް ނޫނެވެ.";
+/** The 24 native letters, in alphabet order. */
+export declare const LETTERS: string[];
+/** The 14 letters added for Arabic loanwords. */
+export declare const ARABIC_LETTERS: string[];
+/** Vowel marks (fili), including sukun. */
+export declare const FILI: string[];
+export type { ConvertLegacyOptions, FontRequest, KeyboardOptions, LegacyLayout, NormalizePunctuationOptions };

package/dist/index.js

@@ -0,0 +1,187 @@
+import { _ as repairPdfText, a as LRI, b as KEYMAP, c as SYSTEM_THAANA_FONTS, d as hasRtl, f as hasThaana, g as normalizePunctuation, h as isolateNumbers, i as FSI, l as detectDirection, m as isolate, n as autoAttach, o as PDI, p as isMixedScript, r as thaanaForInputEvent, s as RLI, t as attachKeyboard, u as fontStack, v as resolveDirection, x as transliterate, y as stripBidiControls } from "./keyboard-C7ryTCJR.js";
+// src/legacy.ts
+/** ASCII -> Unicode maps for pre-Unicode Thaana fonts.
+*  typewriter: the "A_" fonts (A_Waheed, A_Faseyha, A_Randhoo, A_Haleem …).
+*  phonetic:   a few older casual fonts (Thaana, Akko, Athu Casual, Avas Thaana …). */
+const LEGACY_LAYOUTS = {
+	typewriter: {
+		"a": "އ",
+		"b": "ބ",
+		"c": "ް",
+		"d": "ދ",
+		"e": "ެ",
+		"f": "ފ",
+		"g": "ގ",
+		"h": "ހ",
+		"i": "ި",
+		"j": "ޖ",
+		"k": "ކ",
+		"l": "ލ",
+		"m": "މ",
+		"n": "ނ",
+		"o": "ޮ",
+		"p": "ޕ",
+		"q": "ޤ",
+		"r": "ރ",
+		"s": "ސ",
+		"t": "ތ",
+		"u": "ު",
+		"v": "ވ",
+		"w": "ަ",
+		"x": "ޝ",
+		"y": "ޔ",
+		"z": "ޒ",
+		"A": "ޢ",
+		"B": "ޞ",
+		"C": "ޗ",
+		"D": "ޑ",
+		"E": "ޭ",
+		"F": "ޟ",
+		"G": "ޣ",
+		"H": "ޙ",
+		"I": "ީ",
+		"J": "ޛ",
+		"K": "ޚ",
+		"L": "ޅ",
+		"N": "ޏ",
+		"O": "ޯ",
+		"R": "ޜ",
+		"S": "ށ",
+		"T": "ޓ",
+		"U": "ޫ",
+		"V": "ޥ",
+		"W": "ާ",
+		"X": "ޘ",
+		"Y": "ޠ",
+		"Z": "ޡ",
+		"Q": "ﷲ",
+		",": "،",
+		";": "؛",
+		"?": "؟"
+	},
+	phonetic: {
+		"q": "ް",
+		"w": "އ",
+		"e": "ެ",
+		"r": "ރ",
+		"t": "ތ",
+		"y": "ޔ",
+		"u": "ު",
+		"i": "ި",
+		"o": "ޮ",
+		"p": "ޕ",
+		"a": "ަ",
+		"s": "ސ",
+		"d": "ދ",
+		"f": "ފ",
+		"g": "ގ",
+		"h": "ހ",
+		"j": "ޖ",
+		"k": "ކ",
+		"l": "ލ",
+		"z": "ޒ",
+		"c": "ޗ",
+		"v": "ވ",
+		"b": "ބ",
+		"n": "ނ",
+		"m": "މ",
+		"Q": "ޤ",
+		"W": "ޢ",
+		"E": "ޭ",
+		"R": "ޜ",
+		"T": "ޓ",
+		"Y": "ޠ",
+		"U": "ޫ",
+		"I": "ީ",
+		"O": "ޯ",
+		"A": "ާ",
+		"S": "ށ",
+		"D": "ޑ",
+		"F": "ﷲ",
+		"G": "ޣ",
+		"H": "ޙ",
+		"J": "ޛ",
+		"K": "ޚ",
+		"L": "ޅ",
+		"Z": "ޡ",
+		"X": "ޘ",
+		"C": "ޝ",
+		"V": "ޥ",
+		"B": "ޞ",
+		"N": "ޏ",
+		"M": "ޟ",
+		",": "،",
+		";": "؛",
+		"?": "؟"
+	}
+};
+/**
+* Convert text typed in a pre-Unicode Thaana font (it looks like Latin
+* gibberish such as "ihevid" once the font is gone) into Unicode Thaana.
+* Each line is reversed into logical order, characters are mapped, and digit
+* groups are put back in reading order.
+*/
+function convertLegacy(text, options = {}) {
+	const { layout = "typewriter", reverse = true } = options;
+	const map = LEGACY_LAYOUTS[layout];
+	return text.split(/(\r?\n)/).map((line) => {
+		if (line === "\n" || line === "\r\n") return line;
+		let out = (reverse ? [...line].toReversed() : [...line]).map((c) => map[c] ?? c).join("");
+		if (reverse) out = out.replace(/\d[\d.,:/-]*\d|\d/g, (m) => [...m].toReversed().join(""));
+		return out;
+	}).join("");
+}
+// src/fonts.ts
+/** Load Dhivehi fonts from dvfonts (Google-Fonts-compatible CSS API). */
+const DVFONTS_ORIGIN = "https://dvfonts.yashau.com";
+/** URL of the CSS for one or more families. */
+function fontCssUrl(fonts, { display = "swap", origin = DVFONTS_ORIGIN } = {}) {
+	return `${origin}/css2?${(Array.isArray(fonts) ? fonts : [fonts]).map(({ family, weights }) => {
+		return `family=${encodeURIComponent(family).replace(/%20/g, "+")}${weights?.length ? `:wght@${weights.toSorted((a, b) => a - b).join(";")}` : ""}`;
+	}).join("&")}&display=${display}`;
+}
+/**
+* Add the stylesheet for the given families to <head> (once per URL) and
+* resolve when the fonts are ready to draw with. Use the family name in CSS
+* afterwards: font-family: 'Faruma', system-ui, sans-serif.
+*/
+function loadFonts(fonts, options) {
+	const href = fontCssUrl(fonts, options);
+	let link = document.querySelector(`link[data-dvfonts][href="${CSS.escape(href)}"]`);
+	if (!link) {
+		link = document.createElement("link");
+		link.rel = "stylesheet";
+		link.href = href;
+		link.dataset.dvfonts = "";
+		document.head.append(link);
+	}
+	const list = Array.isArray(fonts) ? fonts : [fonts];
+	return new Promise((resolve, reject) => {
+		if (link.sheet) return resolve();
+		link.addEventListener("load", () => resolve(), { once: true });
+		link.addEventListener("error", () => reject(/* @__PURE__ */ new Error(`Could not load ${href}`)), { once: true });
+	}).then(() => Promise.all(list.flatMap(({ family, weights = [400] }) => weights.map((w) => document.fonts.load(`${w} 16px "${family}"`, "ދ")))).then(() => void 0));
+}
+// src/samples.ts
+/** Sample sentences that each use all 24 native Thaana letters. Shown at
+*  random on dvfonts. */
+const PANGRAMS = [
+	"ޗާލު ޒުވާން ކުއްޖާ، ފޮށިން ޕެކެޓެއް ކަނޑައި، ޏަމްޏަމް ގަހުގައި އިން ބުޅަލަށް މަސްދީ، ރީތި ލަވައެއް ކިޔައިދިނެވެ.",
+	"ކުޑަ ޗުއްޓީއެއްގައި ޏ. އަތޮޅަށް ފުރަން ޓިކެޓާއި ބޮޑު ފޮށި ހިފައިގެން، ޒުވާން ޕައިލެޓް މަޖާ ލަވައެއް ސަކަރާތާއެކު ކިޔަމުން ދިޔައެވެ.",
+	"ޕާކުގައި ހުރި މޭޒުމަތީގައި، ކުޑަ ކުއްޖާ ފޮނި ޏަމްޏަމް މޭވާއާއި ޗޮކްލެޓް ބަހައްޓައި، ޅަ އެކުވެރިޔާއަށް ތަށިން ސައި ދިނެވެ.",
+	"ސުކޫލު ކުލާހުގައި ހުރި ބޯޑުގައި، މޮޅު ކުއްޖާ ތާނަ އަކުރު 'ޏަވިޔަނި' ވަރަށް ޗާލުކޮށް ޕެންސިލުން ފޮތުގައި ލިޔެ، ޒުވާން ޓީޗަރަށް ދެއްކިއެވެ.",
+	"ބާޒާރުން ތާޒާ ޏަމްޏަމް މޭވާއާއި، ޗީޒް، ޓޮމާޓޯ އަދި ފޮނި ޖޭމު ޑަބިޔަލެއް ގަނެގެން، ކުއްޖާ ޕްލާސްޓިކް ކޮތަޅަށް އަޅައިގެން އަވަހަށް ހިނގައިގަތެވެ.",
+	"ރީތި ޗާލު ހަނދުވަރުގައި، ޏ. އަތޮޅުގެ ގޮނޑުދޮށުގައި ޒުވާނުން ބޮޑުބެރު ޖަހައި، ޕާޓީއެއް ހަދައި، ފާނޫޒު ދިއްލައިގެން މަޖާ ލަވަތައް ކިޔައި ސަކަރާތްޖެހިއެވެ.",
+	"ޗަސްބިމުގައި ހުރި ޏަމްޏަމް ގަހުގެ ގޮފިތަކަށް ޖެހި، ޅަ ލޯބި ދޫނި، ކުޑަ ޕިކަޕެއްގައި އައި ޒުވާނުން ޖެހި ޓެންޓު މަތިން އުދުހިގެން ދިޔައެވެ.",
+	"މީރު ޗޮކްލެޓާއި، ބަޓަރު، ފުށް، ޗީޒް އަދި ޏަމްޏަމް އެއްކޮށް، ބޮޑު ތައްޓަކަށް ސަމުސަލުން ހަކުރު އަޅައިގެން، ޒުވާން ކުއްޖާ ޕޭސްޓްރީ ތައްޔާރުކުރިއެވެ."
+];
+/** Uses 12 of the 14 Arabic-derived letters (ޜ and ޥ have no common words). */
+const ARABIC_LETTERS_SAMPLE = "ރަމަޟާން މަހުގެ ޚާއްޞަ ޘަޤާފަތާއި ޝަރީޢަތުގެ ޙަޤީޤަތް ޙިފްޡުކޮށް ޛިކުރުކުރުމަކީ ބަޣާވާތެއް ނޫނެވެ.";
+const range = (from, to) => Array.from({ length: to - from }, (_, i) => String.fromCodePoint(from + i));
+/** The 24 native letters, in alphabet order. */
+const LETTERS = range(1920, 1944);
+/** The 14 letters added for Arabic loanwords. */
+const ARABIC_LETTERS = range(1944, 1958);
+/** Vowel marks (fili), including sukun. */
+const FILI = range(1958, 1969);
+export { ARABIC_LETTERS, ARABIC_LETTERS_SAMPLE, DVFONTS_ORIGIN, FILI, FSI, KEYMAP, LEGACY_LAYOUTS, LETTERS, LRI, PANGRAMS, PDI, RLI, SYSTEM_THAANA_FONTS, attachKeyboard, autoAttach, convertLegacy, detectDirection, fontCssUrl, fontStack, hasRtl, hasThaana, isMixedScript, isolate, isolateNumbers, loadFonts, normalizePunctuation, repairPdfText, resolveDirection, stripBidiControls, thaanaForInputEvent, transliterate };

package/dist/keyboard-C7ryTCJR.js

@@ -0,0 +1,338 @@
+// src/keymap.ts
+/**
+* Latin key -> Thaana: Microsoft's "Divehi Phonetic" keyboard layout (kbddiv1),
+* the layout Maldivian websites use via aharen/thaana-keyboard
+* (h→ހ, a→ަ, q→ް sukun, w→އ alifu …).
+*
+* Bracket pairs are swapped, as in Microsoft's layout and rihaPDF. Browsers
+* mirror ( ) [ ] { } < > in RTL text, so a Dhivehi typist opens with the key
+* that looks right on screen (")"), which stores U+0028: the glyph matches the
+* key pressed and the stored text stays in logical order.
+*/
+const KEYMAP = Object.freeze({
+	q: "ް",
+	w: "އ",
+	e: "ެ",
+	r: "ރ",
+	t: "ތ",
+	y: "ޔ",
+	u: "ު",
+	i: "ި",
+	o: "ޮ",
+	p: "ޕ",
+	a: "ަ",
+	s: "ސ",
+	d: "ދ",
+	f: "ފ",
+	g: "ގ",
+	h: "ހ",
+	j: "ޖ",
+	k: "ކ",
+	l: "ލ",
+	z: "ޒ",
+	x: "×",
+	c: "ޗ",
+	v: "ވ",
+	b: "ބ",
+	n: "ނ",
+	m: "މ",
+	Q: "ޤ",
+	W: "ޢ",
+	E: "ޭ",
+	R: "ޜ",
+	T: "ޓ",
+	Y: "ޠ",
+	U: "ޫ",
+	I: "ީ",
+	O: "ޯ",
+	P: "÷",
+	A: "ާ",
+	S: "ށ",
+	D: "ޑ",
+	F: "ﷲ",
+	G: "ޣ",
+	H: "ޙ",
+	J: "ޛ",
+	K: "ޚ",
+	L: "ޅ",
+	Z: "ޡ",
+	X: "ޘ",
+	C: "ޝ",
+	V: "ޥ",
+	B: "ޞ",
+	N: "ޏ",
+	M: "ޟ",
+	",": "،",
+	";": "؛",
+	"?": "؟",
+	"(": ")",
+	")": "(",
+	"[": "]",
+	"]": "[",
+	"{": "}",
+	"}": "{",
+	"<": ">",
+	">": "<"
+});
+/**
+* Replay keystrokes in the Divehi Phonetic layout: maps character by character.
+* `transliterate('divehi')` → "ދިވެހި". This is not a romanisation converter;
+* pass what a user would type on the layout, not arbitrary English spellings.
+*/
+function transliterate(text) {
+	let out = "";
+	for (const ch of text) out += KEYMAP[ch] ?? ch;
+	return out;
+}
+// src/text.ts
+/**
+* Putting Thaana on screen correctly: script detection, direction, bidi
+* isolation, punctuation clean-up and repair of text copied out of PDFs.
+*
+* Much of this is ported from rihaPDF (github.com/yashau/rihaPDF), where each
+* rule was added for a real document; the tests pin the same cases.
+*/
+/** Strong right-to-left code points: Hebrew, Arabic, Syriac, Thaana, NKo, Arabic
+*  presentation forms and the historic RTL scripts. */
+function isRtlCodePoint(cp) {
+	return cp >= 1424 && cp <= 2303 || cp >= 64285 && cp <= 65023 || cp >= 65136 && cp <= 65278 || cp >= 67584 && cp <= 69631 || cp >= 124928 && cp <= 126975;
+}
+/** Strong left-to-right letters (Latin, Greek, Cyrillic). Digits and
+*  punctuation are direction-neutral and deliberately not included. */
+function isLtrLetter(cp) {
+	return cp >= 65 && cp <= 90 || cp >= 97 && cp <= 122 || cp >= 192 && cp <= 687 && cp !== 215 && cp !== 247 || cp >= 880 && cp <= 1023 || cp >= 1024 && cp <= 1279;
+}
+const THAANA_RE = /[ހ-޿]/u;
+/** True if the string contains any Thaana. */
+function hasThaana(text) {
+	return THAANA_RE.test(text);
+}
+/** True if the string contains any right-to-left letter (Thaana, Arabic, Hebrew…). */
+function hasRtl(text) {
+	for (const ch of text) if (isRtlCodePoint(ch.codePointAt(0))) return true;
+	return false;
+}
+/** True if the string mixes right-to-left letters with Latin/Greek/Cyrillic
+*  letters. Digits, spaces and punctuation don't count, so "ދިވެހި 123" is not mixed. */
+function isMixedScript(text) {
+	let rtl = false;
+	let ltr = false;
+	for (const ch of text) {
+		const cp = ch.codePointAt(0);
+		if (isRtlCodePoint(cp)) rtl = true;
+		else if (isLtrLetter(cp)) ltr = true;
+		if (rtl && ltr) return true;
+	}
+	return false;
+}
+/** Direction of the first strong character, the same rule as dir="auto". */
+function detectDirection(text) {
+	for (const ch of text) {
+		const cp = ch.codePointAt(0);
+		if (isRtlCodePoint(cp)) return "rtl";
+		if (isLtrLetter(cp)) return "ltr";
+	}
+	return "neutral";
+}
+/**
+* Direction to render a piece of text with (rihaPDF's rule). An explicit
+* choice always wins; otherwise any right-to-left letter makes it RTL. This
+* suits Dhivehi UIs better than dir="auto", which turns "Apple ގެ ފޯނު"
+* left-to-right because the first letter is Latin. Text with no letters at all
+* (digits, punctuation) gets `fallback`: pass 'rtl' in Thaana contexts.
+*/
+function resolveDirection(text, explicit, fallback = "ltr") {
+	if (explicit) return explicit;
+	if (hasRtl(text)) return "rtl";
+	return detectDirection(text) === "ltr" ? "ltr" : fallback;
+}
+/** Unicode bidi isolates. Prefer the HTML <bdi> element when you control markup. */
+const LRI = "⁦";
+const RLI = "⁧";
+const FSI = "⁨";
+const PDI = "⁩";
+/**
+* Wrap a value in a directional isolate so it can't scramble the sentence
+* around it: phone numbers, URLs, emails, code or user names inside Thaana
+* text. For plain strings (titles, notifications, canvas, SVG) where you can't
+* use <bdi> or dir="ltr".
+*/
+function isolate(value, direction = "ltr") {
+	return (direction === "ltr" ? "⁦" : direction === "rtl" ? "⁧" : "⁨") + value + "⁩";
+}
+const NUMBER_TOKEN_RE = /(^|[\s\p{P}\p{S}])(\+\d[\d -]*\d|[+\-\u2212]?\d(?:[\d.,:/-]*\d)?%?)(?=$|[\s\p{P}\p{S}])/gu;
+/**
+* Wrap numbers in right-to-left text in left-to-right isolates, so "-5",
+* "+960 333-1234", "9:00", "1,000" and "50%" keep their order inside Thaana.
+* Brackets around a number stay outside the isolate (putting them inside makes
+* the closing bracket jump). No-op for text without right-to-left letters.
+* Strip the controls again with stripBidiControls() before saving.
+*/
+function isolateNumbers(text, rtl = hasRtl(text)) {
+	if (!rtl) return text;
+	return text.replace(NUMBER_TOKEN_RE, (_m, prefix, token) => `${prefix}⁦${token}⁩`);
+}
+const BIDI_CONTROLS = /[؜‎‏‪-‮⁦-⁩]/gu;
+/** Remove bidi control characters (before saving, searching or comparing text). */
+function stripBidiControls(text) {
+	return text.replace(BIDI_CONTROLS, "");
+}
+const RTL_OR_DIGIT = "[\\d\\u0590-\\u08FF\\uFB1D-\\uFDFF\\uFE70-\\uFEFE]";
+const OPENER_RE = /^[\p{Ps}\p{Pi}]$/u;
+const OPENER_GAP_RE = new RegExp(`(\\p{P})\\s+(?=${RTL_OR_DIGIT})`, "gu");
+const BEFORE_PUNCT_GAP_RE = new RegExp(`(${RTL_OR_DIGIT})\\s+(\\p{P})`, "gu");
+/**
+* Tidy spacing and punctuation in Thaana text:
+*   "ބަސް ، ބުދަ ؛ އެއް ؟ ނޫން !"  →  "ބަސް، ބުދަ؛ އެއް؟ ނޫން!"
+*   "ދުވަސް ( ބުރުނު ) [ 8 ]"      →  "ދުވަސް (ބުރުނު) [8]"
+* Spaces before punctuation go, spaces just inside opening brackets/quotes go,
+* and the space before an opening bracket is kept.
+*/
+function normalizePunctuation(text, options = {}) {
+	const { arabicPunctuation = true } = options;
+	let out = text;
+	if (arabicPunctuation) out = out.replace(/([ހ-޿])(\s*),/gu, "$1$2،").replace(/([ހ-޿])(\s*);/gu, "$1$2؛").replace(/([ހ-޿])(\s*)\?/gu, "$1$2؟");
+	return out.split("\n").map((line) => line.replace(OPENER_GAP_RE, (match, punct) => OPENER_RE.test(punct) ? punct : match).replace(BEFORE_PUNCT_GAP_RE, (match, lead, punct) => OPENER_RE.test(punct) ? match : `${lead}${punct}`)).join("\n");
+}
+/**
+* Repair Thaana text copied out of a PDF. PDFs store right-to-left text in
+* visual order, so after copy/paste dates and times come out reversed
+* ("2026/1/14" for 14/1/2026, "00:9" for 9:00), punctuation picks up stray
+* spaces, numbered-list markers jump to the end ("1 ބައި." for ".1 ބައި") and
+* "1.2" section markers arrive as ".12". Only lines containing Thaana are
+* touched. Do NOT run this on text people typed: it would reverse their dates.
+*/
+function repairPdfText(text) {
+	return text.split("\n").map((line) => {
+		if (!hasThaana(line)) return line;
+		let out = line.replace(/([/:])\s+(?=\d)/gu, "$1");
+		out = out.replace(/\d+(?:[/:]\d+)+/gu, (group) => {
+			const seps = new Set(group.match(/[/:]/gu));
+			if (seps.size !== 1) return group;
+			const [sep] = seps;
+			return group.split(sep).toReversed().join(sep);
+		});
+		out = normalizePunctuation(out, { arabicPunctuation: false });
+		out = out.replace(/^(\s*)\.(\d)(\d)(\s+)/u, (_m, lead, major, minor, gap) => `${lead}${minor}-${major}${gap}`);
+		const list = /^(\s*)(\d+)(\s+)([\s\S]*?)(\s*)\.$/u.exec(out);
+		if (list && hasThaana(list[4])) {
+			const [, lead, marker, gap, body, tail] = list;
+			out = `${lead}.${marker}${gap}${body}${tail}`;
+		}
+		return out;
+	}).join("\n");
+}
+/** Thaana fonts installed on common systems, used as a fallback for glyphs a
+*  web font lacks: MV Boli ships with Windows, Noto Sans Thaana with Android
+*  and most Linux desktops. */
+const SYSTEM_THAANA_FONTS = ["Noto Sans Thaana", "MV Boli"];
+/**
+* A font-family value that keeps both scripts readable: most Dhivehi fonts have
+* no Latin letters, so Latin falls through to the system UI font, and missing
+* Thaana falls through to an installed Thaana font.
+*
+*   fontStack('Faruma')  →  "'Faruma', system-ui, 'Noto Sans Thaana', 'MV Boli', sans-serif"
+*/
+function fontStack(family, { latin = "system-ui" } = {}) {
+	return [
+		family,
+		latin,
+		...SYSTEM_THAANA_FONTS,
+		"sans-serif"
+	].map(quoteFamily).join(", ");
+}
+/** Generic families (system-ui, sans-serif) stay bare; names get quoted. */
+function quoteFamily(f) {
+	return /^[a-z-]+$/.test(f) ? f : `'${f}'`;
+}
+// src/keyboard.ts
+/**
+* The Thaana character a `beforeinput` event should insert instead, or null to
+* let it through. For rich-text editors (Lexical, TipTap/ProseMirror, Slate…)
+* that own their own insertion: call this in the editor's beforeinput hook,
+* preventDefault, and insert the result through the editor's API.
+* Only single typed characters are mapped; IME composition, paste,
+* autocorrect and deletes return null.
+*/
+function thaanaForInputEvent(event) {
+	if (event.inputType !== "insertText" || event.isComposing) return null;
+	const key = event.data && event.data.length === 1 ? event.data : void 0;
+	if (!key) return null;
+	return KEYMAP[key] ?? null;
+}
+/**
+* Make an <input>, <textarea> or contenteditable element type Thaana on any
+* keyboard. Only single typed characters are rewritten; paste, IME
+* composition, autocorrect, deletion and text from a real Dhivehi keyboard
+* pass through. Inserts via the browser's own editing command, so `input`
+* events fire (React/Vue/Svelte bindings keep working) and undo works.
+*
+* @returns a function that detaches the keyboard.
+*/
+function attachKeyboard(el, options = {}) {
+	const { enabled = () => true, setAttributes = true, autoDirection = true } = options;
+	if (setAttributes) {
+		for (const [attr, value] of [
+			["dir", "rtl"],
+			["lang", "dv"],
+			["autocomplete", "off"],
+			["autocorrect", "off"],
+			["autocapitalize", "none"],
+			["spellcheck", "false"]
+		]) if (!el.hasAttribute(attr)) el.setAttribute(attr, value);
+	}
+	let inserting = false;
+	const onBeforeInput = (e) => {
+		const ev = e;
+		if (inserting || !enabled()) return;
+		const mapped = thaanaForInputEvent(ev);
+		if (!mapped) return;
+		ev.preventDefault();
+		inserting = true;
+		try {
+			if (typeof document.execCommand === "function" && document.execCommand("insertText", false, mapped)) return;
+			if (el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement) {
+				const start = el.selectionStart ?? el.value.length;
+				el.setRangeText(mapped, start, el.selectionEnd ?? start, "end");
+				el.dispatchEvent(new Event("input", { bubbles: true }));
+			}
+		} finally {
+			inserting = false;
+		}
+	};
+	const fieldText = () => el instanceof HTMLInputElement || el instanceof HTMLTextAreaElement ? el.value : el.textContent ?? "";
+	const onInput = () => {
+		el.dir = resolveDirection(fieldText(), null, "rtl");
+	};
+	el.addEventListener("beforeinput", onBeforeInput);
+	if (autoDirection) {
+		el.addEventListener("input", onInput);
+		onInput();
+	}
+	return () => {
+		el.removeEventListener("beforeinput", onBeforeInput);
+		el.removeEventListener("input", onInput);
+	};
+}
+const attached = /* @__PURE__ */ new WeakMap();
+/**
+* Attach the keyboard to every `[data-thaana]` element under `root`, now and as
+* elements are added later. `data-thaana="off"` opts an element out.
+* @returns a function that stops watching (already-attached fields stay attached).
+*/
+function autoAttach(root = document) {
+	const scan = () => {
+		for (const el of root.querySelectorAll("[data-thaana]")) {
+			if (attached.has(el) || el.dataset.thaana === "off") continue;
+			attached.set(el, attachKeyboard(el));
+		}
+	};
+	scan();
+	const observer = new MutationObserver(scan);
+	observer.observe(root instanceof Document ? root.documentElement : root, {
+		childList: true,
+		subtree: true
+	});
+	return () => observer.disconnect();
+}
+export { repairPdfText as _, LRI as a, KEYMAP as b, SYSTEM_THAANA_FONTS as c, hasRtl as d, hasThaana as f, normalizePunctuation as g, isolateNumbers as h, FSI as i, detectDirection as l, isolate as m, autoAttach as n, PDI as o, isMixedScript as p, thaanaForInputEvent as r, RLI as s, attachKeyboard as t, fontStack as u, resolveDirection as v, transliterate as x, stripBidiControls as y };

package/dist/thaana.iife.js

@@ -0,0 +1,7 @@
+var Thaana=(function(e){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});let t=Object.freeze({q:`ް`,w:`އ`,e:`ެ`,r:`ރ`,t:`ތ`,y:`ޔ`,u:`ު`,i:`ި`,o:`ޮ`,p:`ޕ`,a:`ަ`,s:`ސ`,d:`ދ`,f:`ފ`,g:`ގ`,h:`ހ`,j:`ޖ`,k:`ކ`,l:`ލ`,z:`ޒ`,x:`×`,c:`ޗ`,v:`ވ`,b:`ބ`,n:`ނ`,m:`މ`,Q:`ޤ`,W:`ޢ`,E:`ޭ`,R:`ޜ`,T:`ޓ`,Y:`ޠ`,U:`ޫ`,I:`ީ`,O:`ޯ`,P:`÷`,A:`ާ`,S:`ށ`,D:`ޑ`,F:`ﷲ`,G:`ޣ`,H:`ޙ`,J:`ޛ`,K:`ޚ`,L:`ޅ`,Z:`ޡ`,X:`ޘ`,C:`ޝ`,V:`ޥ`,B:`ޞ`,N:`ޏ`,M:`ޟ`,",":`،`,";":`؛`,"?":`؟`,"(":`)`,")":`(`,"[":`]`,"]":`[`,"{":`}`,"}":`{`,"<":`>`,">":`<`});function n(e){let n=``;for(let r of e)n+=t[r]??r;return n}function r(e){return e>=1424&&e<=2303||e>=64285&&e<=65023||e>=65136&&e<=65278||e>=67584&&e<=69631||e>=124928&&e<=126975}function i(e){return e>=65&&e<=90||e>=97&&e<=122||e>=192&&e<=687&&e!==215&&e!==247||e>=880&&e<=1023||e>=1024&&e<=1279}let a=/[ހ-޿]/u;function o(e){return a.test(e)}function s(e){for(let t of e)if(r(t.codePointAt(0)))return!0;return!1}function c(e){let t=!1,n=!1;for(let a of e){let e=a.codePointAt(0);if(r(e)?t=!0:i(e)&&(n=!0),t&&n)return!0}return!1}function l(e){for(let t of e){let e=t.codePointAt(0);if(r(e))return`rtl`;if(i(e))return`ltr`}return`neutral`}function u(e,t,n=`ltr`){return t||(s(e)?`rtl`:l(e)===`ltr`?`ltr`:n)}function d(e,t=`ltr`){return(t===`ltr`?`⁦`:t===`rtl`?`⁧`:`⁨`)+e+`⁩`}let f=/(^|[\s\p{P}\p{S}])(\+\d[\d -]*\d|[+\-\u2212]?\d(?:[\d.,:/-]*\d)?%?)(?=$|[\s\p{P}\p{S}])/gu;function p(e,t=s(e)){return t?e.replace(f,(e,t,n)=>`${t}⁦${n}⁩`):e}let m=/[؜‎‏‪-‮⁦-⁩]/gu;function h(e){return e.replace(m,``)}let g=`[\\d\\u0590-\\u08FF\\uFB1D-\\uFDFF\\uFE70-\\uFEFE]`,_=/^[\p{Ps}\p{Pi}]$/u,v=RegExp(`(\\p{P})\\s+(?=${g})`,`gu`),y=RegExp(`(${g})\\s+(\\p{P})`,`gu`);function b(e,t={}){let{arabicPunctuation:n=!0}=t,r=e;return n&&(r=r.replace(/([ހ-޿])(\s*),/gu,`$1$2،`).replace(/([ހ-޿])(\s*);/gu,`$1$2؛`).replace(/([ހ-޿])(\s*)\?/gu,`$1$2؟`)),r.split(`
+`).map(e=>e.replace(v,(e,t)=>_.test(t)?t:e).replace(y,(e,t,n)=>_.test(n)?e:`${t}${n}`)).join(`
+`)}function x(e){return e.split(`
+`).map(e=>{if(!o(e))return e;let t=e.replace(/([/:])\s+(?=\d)/gu,`$1`);t=t.replace(/\d+(?:[/:]\d+)+/gu,e=>{let t=new Set(e.match(/[/:]/gu));if(t.size!==1)return e;let[n]=t;return e.split(n).toReversed().join(n)}),t=b(t,{arabicPunctuation:!1}),t=t.replace(/^(\s*)\.(\d)(\d)(\s+)/u,(e,t,n,r,i)=>`${t}${r}-${n}${i}`);let n=/^(\s*)(\d+)(\s+)([\s\S]*?)(\s*)\.$/u.exec(t);if(n&&o(n[4])){let[,e,r,i,a,o]=n;t=`${e}.${r}${i}${a}${o}`}return t}).join(`
+`)}let S=[`Noto Sans Thaana`,`MV Boli`];function C(e,{latin:t=`system-ui`}={}){return[e,t,...S,`sans-serif`].map(w).join(`, `)}function w(e){return/^[a-z-]+$/.test(e)?e:`'${e}'`}function T(e){if(e.inputType!==`insertText`||e.isComposing)return null;let n=e.data&&e.data.length===1?e.data:void 0;return n?t[n]??null:null}function E(e,t={}){let{enabled:n=()=>!0,setAttributes:r=!0,autoDirection:i=!0}=t;if(r)for(let[t,n]of[[`dir`,`rtl`],[`lang`,`dv`],[`autocomplete`,`off`],[`autocorrect`,`off`],[`autocapitalize`,`none`],[`spellcheck`,`false`]])e.hasAttribute(t)||e.setAttribute(t,n);let a=!1,o=t=>{let r=t;if(a||!n())return;let i=T(r);if(i){r.preventDefault(),a=!0;try{if(typeof document.execCommand==`function`&&document.execCommand(`insertText`,!1,i))return;if(e instanceof HTMLInputElement||e instanceof HTMLTextAreaElement){let t=e.selectionStart??e.value.length;e.setRangeText(i,t,e.selectionEnd??t,`end`),e.dispatchEvent(new Event(`input`,{bubbles:!0}))}}finally{a=!1}}},s=()=>e instanceof HTMLInputElement||e instanceof HTMLTextAreaElement?e.value:e.textContent??``,c=()=>{e.dir=u(s(),null,`rtl`)};return e.addEventListener(`beforeinput`,o),i&&(e.addEventListener(`input`,c),c()),()=>{e.removeEventListener(`beforeinput`,o),e.removeEventListener(`input`,c)}}let D=/* @__PURE__ */ new WeakMap;function O(e=document){let t=()=>{for(let t of e.querySelectorAll(`[data-thaana]`))D.has(t)||t.dataset.thaana===`off`||D.set(t,E(t))};t();let n=new MutationObserver(t);return n.observe(e instanceof Document?e.documentElement:e,{childList:!0,subtree:!0}),()=>n.disconnect()}let k=!1;function A(){k||typeof document>`u`||(k=!0,document.readyState===`loading`?document.addEventListener(`DOMContentLoaded`,()=>O(),{once:!0}):O())}A();let j={typewriter:{a:`އ`,b:`ބ`,c:`ް`,d:`ދ`,e:`ެ`,f:`ފ`,g:`ގ`,h:`ހ`,i:`ި`,j:`ޖ`,k:`ކ`,l:`ލ`,m:`މ`,n:`ނ`,o:`ޮ`,p:`ޕ`,q:`ޤ`,r:`ރ`,s:`ސ`,t:`ތ`,u:`ު`,v:`ވ`,w:`ަ`,x:`ޝ`,y:`ޔ`,z:`ޒ`,A:`ޢ`,B:`ޞ`,C:`ޗ`,D:`ޑ`,E:`ޭ`,F:`ޟ`,G:`ޣ`,H:`ޙ`,I:`ީ`,J:`ޛ`,K:`ޚ`,L:`ޅ`,N:`ޏ`,O:`ޯ`,R:`ޜ`,S:`ށ`,T:`ޓ`,U:`ޫ`,V:`ޥ`,W:`ާ`,X:`ޘ`,Y:`ޠ`,Z:`ޡ`,Q:`ﷲ`,",":`،`,";":`؛`,"?":`؟`},phonetic:{q:`ް`,w:`އ`,e:`ެ`,r:`ރ`,t:`ތ`,y:`ޔ`,u:`ު`,i:`ި`,o:`ޮ`,p:`ޕ`,a:`ަ`,s:`ސ`,d:`ދ`,f:`ފ`,g:`ގ`,h:`ހ`,j:`ޖ`,k:`ކ`,l:`ލ`,z:`ޒ`,c:`ޗ`,v:`ވ`,b:`ބ`,n:`ނ`,m:`މ`,Q:`ޤ`,W:`ޢ`,E:`ޭ`,R:`ޜ`,T:`ޓ`,Y:`ޠ`,U:`ޫ`,I:`ީ`,O:`ޯ`,A:`ާ`,S:`ށ`,D:`ޑ`,F:`ﷲ`,G:`ޣ`,H:`ޙ`,J:`ޛ`,K:`ޚ`,L:`ޅ`,Z:`ޡ`,X:`ޘ`,C:`ޝ`,V:`ޥ`,B:`ޞ`,N:`ޏ`,M:`ޟ`,",":`،`,";":`؛`,"?":`؟`}};function M(e,t={}){let{layout:n=`typewriter`,reverse:r=!0}=t,i=j[n];return e.split(/(\r?\n)/).map(e=>{if(e===`
+`||e===`\r
+`)return e;let t=(r?[...e].toReversed():[...e]).map(e=>i[e]??e).join(``);return r&&(t=t.replace(/\d[\d.,:/-]*\d|\d/g,e=>[...e].toReversed().join(``))),t}).join(``)}let N=`https://dvfonts.yashau.com`;function P(e,{display:t=`swap`,origin:n=N}={}){return`${n}/css2?${(Array.isArray(e)?e:[e]).map(({family:e,weights:t})=>`family=${encodeURIComponent(e).replace(/%20/g,`+`)}${t?.length?`:wght@${t.toSorted((e,t)=>e-t).join(`;`)}`:``}`).join(`&`)}&display=${t}`}function F(e,t){let n=P(e,t),r=document.querySelector(`link[data-dvfonts][href="${CSS.escape(n)}"]`);r||(r=document.createElement(`link`),r.rel=`stylesheet`,r.href=n,r.dataset.dvfonts=``,document.head.append(r));let i=Array.isArray(e)?e:[e];return new Promise((e,t)=>{if(r.sheet)return e();r.addEventListener(`load`,()=>e(),{once:!0}),r.addEventListener(`error`,()=>t(/* @__PURE__ */ Error(`Could not load ${n}`)),{once:!0})}).then(()=>Promise.all(i.flatMap(({family:e,weights:t=[400]})=>t.map(t=>document.fonts.load(`${t} 16px "${e}"`,`ދ`)))).then(()=>void 0))}let I=[`ޗާލު ޒުވާން ކުއްޖާ، ފޮށިން ޕެކެޓެއް ކަނޑައި، ޏަމްޏަމް ގަހުގައި އިން ބުޅަލަށް މަސްދީ، ރީތި ލަވައެއް ކިޔައިދިނެވެ.`,`ކުޑަ ޗުއްޓީއެއްގައި ޏ. އަތޮޅަށް ފުރަން ޓިކެޓާއި ބޮޑު ފޮށި ހިފައިގެން، ޒުވާން ޕައިލެޓް މަޖާ ލަވައެއް ސަކަރާތާއެކު ކިޔަމުން ދިޔައެވެ.`,`ޕާކުގައި ހުރި މޭޒުމަތީގައި، ކުޑަ ކުއްޖާ ފޮނި ޏަމްޏަމް މޭވާއާއި ޗޮކްލެޓް ބަހައްޓައި، ޅަ އެކުވެރިޔާއަށް ތަށިން ސައި ދިނެވެ.`,`ސުކޫލު ކުލާހުގައި ހުރި ބޯޑުގައި، މޮޅު ކުއްޖާ ތާނަ އަކުރު 'ޏަވިޔަނި' ވަރަށް ޗާލުކޮށް ޕެންސިލުން ފޮތުގައި ލިޔެ، ޒުވާން ޓީޗަރަށް ދެއްކިއެވެ.`,`ބާޒާރުން ތާޒާ ޏަމްޏަމް މޭވާއާއި، ޗީޒް، ޓޮމާޓޯ އަދި ފޮނި ޖޭމު ޑަބިޔަލެއް ގަނެގެން، ކުއްޖާ ޕްލާސްޓިކް ކޮތަޅަށް އަޅައިގެން އަވަހަށް ހިނގައިގަތެވެ.`,`ރީތި ޗާލު ހަނދުވަރުގައި، ޏ. އަތޮޅުގެ ގޮނޑުދޮށުގައި ޒުވާނުން ބޮޑުބެރު ޖަހައި، ޕާޓީއެއް ހަދައި، ފާނޫޒު ދިއްލައިގެން މަޖާ ލަވަތައް ކިޔައި ސަކަރާތްޖެހިއެވެ.`,`ޗަސްބިމުގައި ހުރި ޏަމްޏަމް ގަހުގެ ގޮފިތަކަށް ޖެހި، ޅަ ލޯބި ދޫނި، ކުޑަ ޕިކަޕެއްގައި އައި ޒުވާނުން ޖެހި ޓެންޓު މަތިން އުދުހިގެން ދިޔައެވެ.`,`މީރު ޗޮކްލެޓާއި، ބަޓަރު، ފުށް، ޗީޒް އަދި ޏަމްޏަމް އެއްކޮށް، ބޮޑު ތައްޓަކަށް ސަމުސަލުން ހަކުރު އަޅައިގެން، ޒުވާން ކުއްޖާ ޕޭސްޓްރީ ތައްޔާރުކުރިއެވެ.`],L=(e,t)=>Array.from({length:t-e},(t,n)=>String.fromCodePoint(e+n)),R=L(1920,1944),z=L(1944,1958),B=L(1958,1969);return A(),e.ARABIC_LETTERS=z,e.ARABIC_LETTERS_SAMPLE=`ރަމަޟާން މަހުގެ ޚާއްޞަ ޘަޤާފަތާއި ޝަރީޢަތުގެ ޙަޤީޤަތް ޙިފްޡުކޮށް ޛިކުރުކުރުމަކީ ބަޣާވާތެއް ނޫނެވެ.`,e.DVFONTS_ORIGIN=N,e.FILI=B,e.FSI=`⁨`,e.KEYMAP=t,e.LEGACY_LAYOUTS=j,e.LETTERS=R,e.LRI=`⁦`,e.PANGRAMS=I,e.PDI=`⁩`,e.RLI=`⁧`,e.SYSTEM_THAANA_FONTS=S,e.attachKeyboard=E,e.autoAttach=O,e.convertLegacy=M,e.detectDirection=l,e.fontCssUrl=P,e.fontStack=C,e.hasRtl=s,e.hasThaana=o,e.isMixedScript=c,e.isolate=d,e.isolateNumbers=p,e.loadFonts=F,e.normalizePunctuation=b,e.repairPdfText=x,e.resolveDirection=u,e.stripBidiControls=h,e.thaanaForInputEvent=T,e.transliterate=n,e})({});

package/package.json

@@ -1,6 +1,63 @@
 {
   "name": "@yashau/thaana",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "2026.1023.0",
+  "description": "Everything to make Thaana (Dhivehi) work on the web: phonetic keyboard for any input, legacy A_-font text converter, bidi helpers, font loading and sane CSS defaults.",
+  "keywords": [
+    "bidi",
+    "dhivehi",
+    "divehi",
+    "fonts",
+    "keyboard",
+    "maldives",
+    "rtl",
+    "thaana"
+  ],
+  "homepage": "https://dvfonts.yashau.com/docs",
+  "license": "MIT",
+  "author": "Ibrahim Yashau",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/yashau/dvfonts.git",
+    "directory": "packages/thaana"
+  },
+  "files": [
+    "dist",
+    "thaana.css",
+    "README.md",
+    "LICENSE"
+  ],
+  "type": "module",
+  "sideEffects": [
+    "./dist/auto.js",
+    "./dist/thaana.iife.js",
+    "*.css"
+  ],
+  "unpkg": "./dist/thaana.iife.js",
+  "jsdelivr": "./dist/thaana.iife.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./auto": {
+      "types": "./dist/auto.d.ts",
+      "default": "./dist/auto.js"
+    },
+    "./thaana.css": "./thaana.css",
+    "./cdn": "./dist/cdn/thaana.js",
+    "./iife": "./dist/thaana.iife.js",
+    "./package.json": "./package.json"
+  },
+  "devDependencies": {
+    "jsdom": "^30.1.3",
+    "publint": "^0.3.25",
+    "tsdown": "^0.23.1",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  },
+  "scripts": {
+    "build": "rm -rf dist && tsdown && node scripts/check-build.mjs",
+    "test": "vitest run",
+    "lint": "publint"
+  }
 }

package/thaana.css

@@ -0,0 +1,45 @@
+/*
+ * @yashau/thaana — sane defaults for Thaana (Dhivehi) text.
+ * Applies only to elements marked lang="dv" (put it on <html> for Dhivehi
+ * sites). https://dvfonts.yashau.com/guide
+ */
+
+/* Right-to-left by default. dir="rtl" in the HTML is still the most robust
+   (it also flips layout before CSS loads); this is the safety net. */
+:where(:lang(dv)) {
+	direction: rtl;
+	/* Fili sit above and below the letters: tight line-heights clip them. */
+	line-height: 1.75;
+	/* Thaana fonts have no italics; synthesized slant and fake bold look broken. */
+	font-synthesis: none;
+	/* No hyphenation dictionaries exist for Dhivehi. */
+	hyphens: manual;
+	/* Thaana is not cursive, but tracking breaks fili alignment in many fonts. */
+	letter-spacing: normal;
+	text-align: start;
+}
+
+/* User-generated content: each paragraph takes its direction from its first
+   letter, so a Latin-first line is LTR and a Thaana-first line is RTL. */
+:where(:lang(dv))
+	:where(p, li, td, th, dd, blockquote, figcaption, h1, h2, h3, h4, h5, h6, input, textarea, [contenteditable]) {
+	unicode-bidi: plaintext;
+}
+
+/* Inputs: keep the caret and placeholder on the right for Thaana. */
+:where(input, textarea):where(:lang(dv), [data-thaana]) {
+	direction: rtl;
+	text-align: start;
+	unicode-bidi: plaintext;
+}
+
+/* Things that are always left-to-right inside Thaana text. */
+:where(:lang(dv)) :where(code, kbd, samp, pre, var, [type='email'], [type='url'], [type='tel'], [type='number']) {
+	direction: ltr;
+	unicode-bidi: isolate;
+}
+
+/* Never italicise Thaana (emphasis = bold or colour instead). */
+:where(:lang(dv)) :where(em, i, cite, dfn, address) {
+	font-style: normal;
+}