ortus 0.1.1

package/LICENSE

@@ -0,0 +1,12 @@
+Copyright (C) 2026 by planetrenox
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
+WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
+MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
+ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
+WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
+ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
+OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.

package/README.md

@@ -0,0 +1,43 @@
+# ortus
+
+**PRT (Planet Renox Time)**: milliseconds since `1998-03-14T03:00:00.000Z`.
+
+```sh
+npm i ortus
+```
+
+```js
+import { PRT } from 'ortus'
+
+PRT.now()                                   // PRT ms, the official unit
+PRT.now('d')                                // days
+PRT.fromDate(new Date('2010-06-01'), 'd')   // 4461
+PRT.toDate(1e9, 's')                        // 2029-11-20T04:46:40.000Z
+PRT.fromUnixMs(Date.now())                  // same as PRT.now()
+PRT.toUnixMs(0)                             // 889844400000
+```
+
+## API
+
+| | |
+|---|---|
+| `PRT.now(unit = 'ms')` | Current PRT |
+| `PRT.fromDate(date, unit = 'ms')` | `Date` → PRT |
+| `PRT.toDate(n, unit = 'ms')` | PRT → `Date` |
+| `PRT.fromUnixMs(ms, unit = 'ms')` | Unix ms → PRT |
+| `PRT.toUnixMs(n, unit = 'ms')` | PRT → Unix ms |
+
+Units: `ms` (official), `s`, `m`, `h`, `d`, `w`.
+
+## Rules
+
+- **Always an integer, rounded down toward −∞.** `1.5s → 1`, `-1.5s → -2`, so every unit is the same length on both sides of the epoch.
+- **Before the epoch is negative.**
+- **Strict input.** `fromDate` takes only valid `Date`s. `fromUnixMs`, `toDate`, and `toUnixMs` take only integers. Anything else throws.
+- **No overflow.** Every value is exact across the full JS `Date` range (±275,000 years). Anything outside it throws.
+- **Leap seconds are ignored**, the same as JS `Date`.
+- **No dependencies.**
+
+## License
+
+0BSD. Use it however you want, no attribution needed.

package/index.d.ts

@@ -0,0 +1,17 @@
+/** PRT units: milliseconds (official), seconds, minutes, hours, days, weeks */
+export type Unit = 'ms' | 's' | 'm' | 'h' | 'd' | 'w'
+
+export declare const PRT: Readonly<{
+  /** Current PRT, rounded down. Defaults to ms. */
+  now(unit?: Unit): number
+  /** PRT at the given Date, rounded down. Defaults to ms. */
+  fromDate(date: Date, unit?: Unit): number
+  /** Date at the given integer PRT value. Defaults to ms. */
+  toDate(value: number, unit?: Unit): Date
+  /** PRT at the given integer Unix ms, rounded down. Defaults to ms. */
+  fromUnixMs(unixMs: number, unit?: Unit): number
+  /** Unix ms at the given integer PRT value. Defaults to ms. */
+  toUnixMs(value: number, unit?: Unit): number
+}>
+
+export default PRT

package/index.js

@@ -0,0 +1,37 @@
+// PRT — Planet Renox Time: ms since 1998-03-14T03:00:00.000Z
+const E = 889844400000
+const MAX = 8.64e15 // JS Date range, ±275k years
+const U = { __proto__: null, ms: 1, s: 1e3, m: 6e4, h: 36e5, d: 864e5, w: 6048e5 }
+const T = Date.prototype.getTime
+
+const unit = u => {
+  if (typeof u != 'string' || !U[u]) throw new RangeError(`PRT: unknown unit ${String(u)}, use ms|s|m|h|d|w`)
+  return U[u]
+}
+
+// Math.floor rounds toward -Infinity, exact since every in-range ms diff is an integer below 2^53
+const fromUnixMs = (t, u = 'ms') => {
+  if (!Number.isInteger(t)) throw new TypeError('PRT.fromUnixMs: expected an integer')
+  if (Math.abs(t) > MAX) throw new RangeError('PRT.fromUnixMs: out of Date range')
+  return Math.floor((t - E) / unit(u))
+}
+
+const fromDate = (date, u = 'ms') => {
+  let t
+  try { t = T.call(date) } catch {} // brand check: real Dates only, works across realms
+  if (!Number.isFinite(t)) throw new TypeError('PRT.fromDate: expected a valid Date')
+  return fromUnixMs(t, u)
+}
+
+const toUnixMs = (n, u = 'ms') => {
+  if (!Number.isSafeInteger(n)) throw new TypeError('PRT: expected an integer PRT value')
+  const t = n * unit(u) + E
+  if (!(Math.abs(t) <= MAX)) throw new RangeError('PRT: out of Date range')
+  return t
+}
+
+const now = (u = 'ms') => fromUnixMs(Date.now(), u)
+const toDate = (n, u = 'ms') => new Date(toUnixMs(n, u))
+
+export const PRT = Object.freeze({ now, fromDate, toDate, fromUnixMs, toUnixMs })
+export default PRT

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "ortus",
+  "version": "0.1.1",
+  "description": "PRT (Planet Renox Time): milliseconds since 1998-03-14T03:00:00Z",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "default": "./index.js"
+    }
+  },
+  "types": "./index.d.ts",
+  "files": [
+    "index.js",
+    "index.d.ts"
+  ],
+  "sideEffects": false,
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [
+    "prt",
+    "planet renox time",
+    "time",
+    "timestamp",
+    "epoch"
+  ],
+  "license": "0BSD",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/planetrenox/ortus.git"
+  }
+}