Size: {{ bytes | filesize }}
\n `\n})\nexport class DemoComponent {\n bytes = 1_048_576; // 1 MB\n}\n```\n\n---\n\n## Usage\n\n```html\n\n{{ 1048576 | filesize }} \n\n\n{{ 123456789 | filesize:'en' }} \n\n\n{{ 123456789 | filesize:'en':1 }} \n{{ 123456789 | filesize:'ar':3 }} \n```\n\n> **Note:** Units are standardized Latin (`B, KB, MB, GB, TB`). Numerals respect the selected locale.\n\n---\n\n## API\n\n### `filesize` pipe\nFormats a numeric byte value into a human-readable string.\n\n**Signature**\n```ts\ntransform(\n value: number,\n locale: string = 'en',\n digits: number = 2\n): string\n```\n\n**Params**\n- `value`: Byte count (number). If `NaN`, returns empty string.\n- `locale`: BCP-47 locale (e.g., `'en'`, `'ar'`).\n- `digits`: `0..3` recommended — used as `maximumFractionDigits`.\n\n**Returns**\n- Formatted string like `\"1.2 MB\"`, with numerals localized via `Intl.NumberFormat`.\n\n---\n\n## Internationalization (Arabic)\n\nWhen `LOCALE_ID` starts with `'ar'` *and* you’ve called `registerLocaleData(ar)`, numerals render using Arabic digits:\n\n```html\n{{ 1048576 | filesize:'ar' }} \n```\n\n- Units remain Latin by design (`KB`, `MB`, …) for cross-language consistency.\n- If you need Arabic unit words (مثل: \"بايت، كيلوبايت، ميغابايت\") يمكنك التفاف النتائج مخصصًا في تطبيقك (انظر [Examples](#examples)).\n\n---\n\n## SSR & performance notes\n- The pipe is **pure** and performs a single computation per value.\n- **SSR-safe**: no timers or browser-only APIs beyond `Intl.NumberFormat`.\n- For large lists, prefer `OnPush` components and avoid re-creating numbers every CD cycle.\n\n---\n\n## Compatibility\n- **Angular:** v20+\n- **TypeScript:** 5.x+\n- **Runtime:** Modern browsers / Node with `Intl.NumberFormat`\n- **Dependencies:** none (uses `tslib` via Angular workspace)\n\n---\n\n## Troubleshooting\n**“I get an empty string”** \nEnsure the input is a valid **number** (not `null`/`undefined`/string). Coerce if needed: `+size`.\n\n**“Why are units Latin?”** \nThis library localizes **digits**; units are standardized (`KB`, `MB`, …). See the example below to map units to Arabic words if desired.\n\n**“Rounding looks off”** \nAdjust `digits` param: `| filesize:'en':0` for integers, `:1` or `:2` for finer precision.\n\n---\n\n## Examples\n\n### Force Arabic digits while keeping English app locale\n```html\n{{ 5_242_880 | filesize:'ar' }} \n```\n\n### Map units to Arabic words (app-level wrapper)\n```ts\n// example.util.ts\nconst UNIT_MAP_AR: Record