![\"tsroj](\"./assets/logo.png\"){kind=logo}
\n\n/common.json` with i18next-style variant groups (`names`, `short`, `min`).\n\n## Formatting (`strftime`)\n\n```typescript\nconst kd = new KurdishDate(2726, 4, 5);\n\n// Sorani month names (month 4 = پووشپەڕ)\nkd.strftime(\"%B\", { locale: \"ckb\" }); // پووشپەڕ\n\n// Month / weekday variants (index or exact name)\nkd.strftime(\"%B %b\", { locale: \"ckb\", monthVariant: 1 });\nkd.strftime(\"%A %a %E\", { locale: \"kmr\", weekdayVariant: 1 });\n\n// Locale digits\nkd.strftime(\"%Y\", { locale: \"ckb\", useLocaleDigits: true }); // ٢٧٢٦\n\n// Manual overrides (highest priority)\nkd.strftime(\"%B %A\", {\n locale: \"ckb\",\n month: \"CustomMonth\",\n weekday: \"CustomDay\",\n});\n```\n\n### Sorani ezafe (ی) — `ckb` only\n\nEnabled by default; disable per option:\n\n| Option | When | Example |\n|--------|------|---------|\n| `ezafeAfterDay` | Day + month name in pattern | `5ی پووشپەڕ` |\n| `ezafeOnMonth` | Day + month name + year in pattern | `5ی پووشپەڕی 2726` |\n\n```typescript\nkd.strftime(\"%d %B %Y\", { locale: \"ckb\" });\n// 5ی پووشپەڕی 2726\n\nkd.strftime(\"%d %B %Y\", {\n locale: \"ckb\",\n ezafeAfterDay: false,\n ezafeOnMonth: false,\n});\n// 5 پووشپەڕ 2726\n```\n\n### Leading zero — `ckb`, `fa`, `ar`\n\n`leadingZero` defaults to **`false`** for these locales (`%d`, `%m`, and time tokens omit padding). Set `leadingZero: true` to pad.\n\n```typescript\nkd.strftime(\"%d/%m\", { locale: \"ckb\" }); // 5/4\nkd.strftime(\"%d/%m\", { locale: \"en\" }); // 05/04\n```\n\n### strftime tokens\n\n`%A` `%a` `%E` (weekday min) `%B` `%b` `%Y` `%y` `%m` `%-m` `%d` `%-d` `%w` `%-w` `%H` `%I` `%M` `%S` `%p`\n\n### `FormatCalendarOptions`\n\n| Option | Description |\n|--------|-------------|\n| `locale` | Locale code |\n| `calendar` | `kurdish` · `gregorian` · `persian` · `islamic` |\n| `monthVariant` | Month variant index or exact name |\n| `weekdayVariant` | Weekday variant index or exact name |\n| `useLocaleDigits` | Use locale digit glyphs |\n| `leadingZero` | Pad numeric tokens (default off for ckb/fa/ar) |\n| `ezafeAfterDay` | Sorani ی after day (default on for ckb) |\n| `ezafeOnMonth` | Sorani ی on month when year present (default on for ckb) |\n| `month`, `weekday`, … | Manual label overrides |\n| `overrides` | Nested override object |\n\n## Interactive demo\n\n```bash\nnpm run build # build library (updates dist types for demo)\ncd demo && npm install && npm run dev\n```\n\nOpen **http://localhost:5173/tsroj/** — live clock, four calendar systems, searchable timezone picker, locale variants, Sorani grammar toggles, and copyable examples.\n\nDeployed at **https://0xdolan.github.io/tsroj/**.\n\n\n \n ![\"tsroj](\"assets/demo-screenshot.png\")
\n \n
\n\nTo embed on your own site (after deploy), use:
<iframe src=\"https://0xdolan.github.io/tsroj/\" title=\"tsroj demo\" width=\"100%\" height=\"820\" loading=\"lazy\"></iframe>
\n\n## Development\n\n```bash\nnpm run test # Vitest\nnpm run lint # TypeScript + Biome\nnpm run build # tsup → dist/\n```\n\nBranch flow: `feature/*` → `develop` → `main`.\n\n## Security\n\nStatic locale JSON only — no `eval()`, no prototype pollution vectors. See [SECURITY.md](SECURITY.md).\n\n## License\n\n[GPL-3.0](LICENSE)\n","readmeFilename":"README.md"}