{"_id":"@credentum/paper-size-convert","name":"@credentum/paper-size-convert","dist-tags":{"latest":"0.0.1"},"versions":{"0.0.1":{"name":"@credentum/paper-size-convert","version":"0.0.1","description":"Get paper dimensions (mm, inches, pixels) for ISO 216, US, ANSI, and JIS paper sizes with DPI conversion.","main":"index.js","types":"index.d.ts","scripts":{"build":"tsc","test":"node --test index.test.ts","typecheck":"tsc --noEmit --strict"},"keywords":["paper-size","paper-dimensions","a4-size","letter-size","iso-216","ansi-paper","jis-paper","dpi-conversion","pdf-paper","print-size"],"author":{"name":"Credentum"},"license":"MIT","dependencies":{},"devDependencies":{},"_id":"@credentum/paper-size-convert@0.0.1","gitHead":"3a6ee0afdcf9339d47955b03278da4635f9ded7a","_nodeVersion":"22.22.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-kbNP7h5h0xVHTYKHv8u4jfY3PrpFQaSBa3InTxoHUbc/rCo7P1mt/b0dbts48Pmq4OySyfIhDfXigK74Y0USsQ==","shasum":"cd5891d57ac0f522cacb0f175824f85de02eb102","tarball":"https://registry.npmjs.org/@credentum/paper-size-convert/-/paper-size-convert-0.0.1.tgz","fileCount":4,"unpackedSize":7641,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIAF2L6ZXL/yYZMPJQYyX+YIqQXlLSTZlhmK0KcW8F1R4AiEAxyO5PHyV4QQKk7gQ7vJhODXmECT1reJ2JO1kgHlNrt8="}]},"_npmUser":{"name":"credentum","email":"credento@credentum.ai"},"directories":{},"maintainers":[{"name":"credentum","email":"credento@credentum.ai"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/paper-size-convert_0.0.1_1769986271325_0.785091344815454"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-01T22:51:11.241Z","0.0.1":"2026-02-01T22:51:11.456Z","modified":"2026-02-01T22:51:11.739Z"},"maintainers":[{"name":"credentum","email":"credento@credentum.ai"}],"description":"Get paper dimensions (mm, inches, pixels) for ISO 216, US, ANSI, and JIS paper sizes with DPI conversion.","keywords":["paper-size","paper-dimensions","a4-size","letter-size","iso-216","ansi-paper","jis-paper","dpi-conversion","pdf-paper","print-size"],"author":{"name":"Credentum"},"license":"MIT","readme":"# @credentum/paper-size-convert\n\nGet paper dimensions in mm, inches, or pixels at any DPI. Covers ISO 216 (A/B/C series), US (Letter/Legal/Tabloid), ANSI (A–E), and JIS B series.\n\n## Installation\n\n```bash\nnpm install @credentum/paper-size-convert\n```\n\n## Usage\n\n```ts\nimport { getPaperSize } from '@credentum/paper-size-convert';\n\ngetPaperSize('A4');              // { width: 210, height: 297, unit: 'mm' }\ngetPaperSize('Letter', 'in');    // { width: 8.5, height: 11, unit: 'in' }\ngetPaperSize('A4', 'px', 300);   // { width: 2480, height: 3508, unit: 'px' }\n```\n\n## Why Use This?\n\nEvery PDF generator, canvas renderer, and print stylesheet needs paper dimensions. The existing npm packages (`paper-size`, `@5no/paper-sizes`) are abandoned with single-digit weekly downloads. This package gives you all major paper standards with optional DPI-to-pixel conversion in one zero-dependency call.\n\n## API\n\n### `getPaperSize(name, unit?, dpi?)`\n\n| Parameter | Type | Default | Description |\n|-----------|------|---------|-------------|\n| `name` | `string` | — | Paper size name (case-insensitive): `A0`–`A10`, `B0`–`B10`, `C0`–`C10`, `Letter`, `Legal`, `Tabloid`, `Ledger`, `ANSI-A`–`ANSI-E`, `JIS-B0`–`JIS-B10` |\n| `unit` | `'mm' \\| 'in' \\| 'px'` | `'mm'` | Output unit |\n| `dpi` | `number` | `72` | Dots per inch (only used when `unit` is `'px'`) |\n\n**Returns:** `{ width: number, height: number, unit: string }`\n\n**Throws:** `Error` if the paper name is not recognized, or if `dpi` is not a positive number.\n\n### `listPaperSizes()`\n\nReturns an array of all supported paper size names.\n\n## Supported Sizes\n\n- **ISO 216 A series**: A0, A1, A2, A3, A4, A5, A6, A7, A8, A9, A10\n- **ISO 216 B series**: B0, B1, B2, B3, B4, B5, B6, B7, B8, B9, B10\n- **ISO 216 C series** (envelopes): C0, C1, C2, C3, C4, C5, C6, C7, C8, C9, C10\n- **US sizes**: Letter, Legal, Tabloid, Ledger\n- **ANSI sizes**: ANSI-A, ANSI-B, ANSI-C, ANSI-D, ANSI-E\n- **JIS B series**: JIS-B0 through JIS-B10\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-de283d931df69cfc5f1e9965204b6683"}