datevolt 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026
+
+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.

package/README.md

@@ -0,0 +1,339 @@
+# tempox
+
+[![npm version](https://img.shields.io/npm/v/tempox.svg)](https://www.npmjs.com/package/tempox)
+[![license](https://img.shields.io/npm/l/tempox.svg)](LICENSE)
+
+> **A complete, lightweight, zero-dependency JavaScript date library** with a `moment.js`-compatible chainable API.
+
+- ⚡ **~8 KB** gzipped vs moment's ~72 KB
+- 📦 **Zero dependencies** — no node_modules bloat
+- 🔗 **moment.js-style API** — `parse`, `format`, `add/subtract`, `diff`, `fromNow`, `calendar`, `duration`, `locale`
+- 🌍 **Timezone & UTC support** — `utc()`, `utcOffset()`, `isDST()`
+- 🗓 **Built-in locales**: `en`, `hi`, `es`, `fr`, `de`, `ar`, `ja` — extend with `defineLocale()`
+- 📱 **React Native ready** — pure JS Date math, no `Intl` dependency, Metro bundler compatible
+
+---
+
+## Install
+
+```bash
+npm install tempox
+```
+
+## Quick Start
+
+```js
+const tempox = require('tempox');
+
+// Current date/time
+tempox().format('YYYY-MM-DD HH:mm:ss');
+
+// Parse ISO string
+tempox('2024-06-15').format('dddd, MMMM D, YYYY'); // "Saturday, June 15, 2024"
+
+// Add / subtract
+tempox('2024-01-31').add(1, 'month').format('YYYY-MM-DD'); // "2024-02-29"
+
+// Relative time
+tempox('2024-01-01').fromNow();  // "6 months ago"
+tempox().add(2, 'hours').toNow(); // "in 2 hours"
+
+// Diff
+tempox('2024-06-15').diff('2024-01-01', 'days'); // 166
+
+// Compare
+tempox('2024-06-15').isBefore('2024-12-31'); // true
+```
+
+---
+
+## API Reference
+
+### Parsing
+
+```js
+tempox()                                  // now
+tempox('2024-06-15')                      // ISO date string (local midnight)
+tempox('2024-06-15T10:30:00')             // ISO datetime
+tempox('2024-06-15T10:30:00Z')            // UTC
+tempox('2024-06-15T10:30:00+05:30')       // with offset
+tempox('15/06/2024', 'DD/MM/YYYY')        // with format string
+tempox('15/06/2024', ['DD/MM/YYYY', 'YYYY-MM-DD']) // multiple formats
+tempox([2024, 5, 15])                     // array [Y, M(0-based), D]
+tempox([2024, 5, 15, 14, 30, 0, 0])      // array with time
+tempox({ year:2024, month:5, day:15 })    // object
+tempox(1718438400000)                     // unix milliseconds
+tempox.unix(1718438400)                   // unix seconds
+tempox.utc('2024-06-15T10:30:00')         // UTC mode
+
+// Validation
+tempox('2024-06-15').isValid()            // true
+tempox('not-a-date').isValid()            // false
+```
+
+### Get + Set
+
+```js
+var d = tempox('2024-06-15T14:30:45.123');
+
+d.year()         // 2024         d.year(2025)
+d.month()        // 5 (0-based)  d.month(0)
+d.date()         // 15           d.date(1)
+d.day()          // 6 (Saturday) d.day(1)  // set to Monday
+d.hour()         // 14           d.hour(9)
+d.minute()       // 30           d.minute(0)
+d.second()       // 45           d.second(0)
+d.millisecond()  // 123
+
+d.quarter()      // 2  (Apr–Jun)
+d.dayOfYear()    // 167
+d.daysInMonth()  // 30
+d.week()         // ISO week number
+d.isoWeek()
+d.weeksInYear()
+d.isoWeekday()   // 1=Mon ... 7=Sun
+
+// Generic
+d.get('year')        // 2024
+d.set('year', 2025)  // chainable
+```
+
+### Manipulate
+
+```js
+tempox().add(7, 'days')
+tempox().add(1, 'month')
+tempox().add(2, 'years')
+tempox().add(3, 'hours')
+tempox().add(30, 'minutes')
+tempox().add(15, 'seconds')
+tempox().add({ days: 1, hours: 2, minutes: 30 }) // object form
+
+tempox().subtract(1, 'week')
+tempox().subtract(3, 'months')
+
+// Chained
+tempox('2024-01-01').add(1,'year').subtract(3,'months').startOf('month')
+
+// startOf / endOf
+tempox().startOf('year')     // Jan 1, 00:00:00.000
+tempox().startOf('month')    // 1st of month, 00:00:00.000
+tempox().startOf('week')     // locale-aware week start
+tempox().startOf('day')      // 00:00:00.000
+tempox().startOf('hour')
+tempox().startOf('minute')
+tempox().startOf('second')
+tempox().startOf('quarter')
+tempox().startOf('isoWeek')
+
+tempox().endOf('year')       // Dec 31, 23:59:59.999
+tempox().endOf('month')      // last day, 23:59:59.999
+
+tempox().clone()             // immutable copy
+```
+
+### Format
+
+```js
+tempox().format()                          // "1:30 PM" (LT)
+tempox().format('YYYY-MM-DD')             // "2024-06-15"
+tempox().format('YYYY-MM-DD HH:mm:ss')    // "2024-06-15 14:30:45"
+tempox().format('dddd, MMMM D, YYYY')     // "Saturday, June 15, 2024"
+tempox().format('MMM Do, YYYY')           // "Jun 15th, 2024"
+tempox().format('h:mm A')                 // "2:30 PM"
+tempox().format('[Today is] dddd')        // "Today is Saturday"
+tempox().format('L')                      // "06/15/2024"
+tempox().format('LL')                     // "June 15, 2024"
+tempox().format('LLL')                    // "June 15, 2024 2:30 PM"
+tempox().format('LLLL')                   // "Saturday, June 15, 2024 2:30 PM"
+```
+
+| Token | Output | Description |
+|-------|--------|-------------|
+| `YYYY` | 2024 | Full year |
+| `YY` | 24 | 2-digit year |
+| `MMMM` | June | Month name |
+| `MMM` | Jun | Short month |
+| `MM` | 06 | Month 2-digit |
+| `M` | 6 | Month |
+| `DD` | 15 | Day 2-digit |
+| `Do` | 15th | Ordinal day |
+| `D` | 15 | Day |
+| `dddd` | Saturday | Weekday name |
+| `ddd` | Sat | Short weekday |
+| `HH` | 14 | 24-hour |
+| `h` | 2 | 12-hour |
+| `mm` | 30 | Minutes |
+| `ss` | 45 | Seconds |
+| `SSS` | 123 | Milliseconds |
+| `A` | PM | AM/PM |
+| `Z` | +05:30 | Timezone |
+| `X` | 1718438400 | Unix seconds |
+| `x` | 1718438400000 | Unix ms |
+| `Q` | 2 | Quarter |
+
+### Relative Time
+
+```js
+tempox('2024-01-01').fromNow()           // "6 months ago"
+tempox().add(2,'hours').fromNow()        // "in 2 hours"
+tempox().subtract(3,'days').fromNow(true) // "3 days" (without suffix)
+
+tempox('2024-01-01').from('2024-06-15')  // "6 months ago"
+tempox().add(5,'minutes').toNow()        // "in 5 minutes"
+tempox('2024-01-01').to('2024-06-15')    // "in 6 months"
+```
+
+### Calendar
+
+```js
+tempox().calendar()                      // "Today at 2:30 PM"
+tempox().add(1,'day').calendar()         // "Tomorrow at 2:30 PM"
+tempox().subtract(1,'day').calendar()    // "Yesterday at 2:30 PM"
+tempox().add(3,'days').calendar()        // "Tuesday at 2:30 PM"
+tempox().subtract(7,'days').calendar()   // "06/08/2024"
+```
+
+### Diff
+
+```js
+tempox('2024-06-15').diff('2024-01-01', 'days')     // 166
+tempox('2024-06-15').diff('2024-01-01', 'months')   // 5
+tempox('2024-06-15').diff('2020-01-01', 'years')    // 4
+tempox('2024-06-15T12:00').diff('2024-06-15T10:00', 'hours') // 2
+tempox('2024-06-15').diff('2024-01-01', 'days', true) // 166.xxx (float)
+```
+
+### Query / Comparison
+
+```js
+tempox('2024-01-01').isBefore('2024-06-15')              // true
+tempox('2024-06-15').isAfter('2024-01-01')               // true
+tempox('2024-06-15T10:00').isSame('2024-06-15T18:00', 'day') // true
+tempox('2024-01-01').isSameOrBefore('2024-01-01')        // true
+tempox('2024-06-15').isSameOrAfter('2024-06-15')         // true
+tempox('2024-03-15').isBetween('2024-01-01','2024-12-31') // true
+tempox('2024-01-01').isBetween('2024-01-01','2024-12-31',null,'[]') // inclusive
+
+tempox('2024-06-15').isLeapYear()   // true
+tempox().isDST()                    // true/false
+tempox.isMoment(tempox())          // true  (also isTempox)
+tempox.isDate(new Date())          // true
+```
+
+### UTC & Timezone
+
+```js
+// UTC mode
+tempox.utc('2024-06-15T10:30:00').format('HH:mm') // always UTC hours
+tempox.utc().isUTC()   // true
+tempox.utc().local()   // switch to local mode
+
+// UTC offset
+tempox().utcOffset()          // current offset in minutes
+tempox().utcOffset('+05:30')  // set offset
+tempox().utcOffset(330)       // set by minutes
+tempox().utcOffset(0, true)   // keep local time, change offset
+```
+
+### Duration
+
+```js
+var d = tempox.duration(2, 'days');
+d.asDays()     // 2
+d.asHours()    // 48
+d.asMinutes()  // 2880
+
+tempox.duration({ hours: 1, minutes: 30 }).asMinutes() // 90
+tempox.duration('P1Y2M3DT4H5M6S')  // ISO 8601 duration string
+tempox.duration(1,'day').humanize()       // "a day"
+tempox.duration(1,'day').humanize(true)   // "in a day"
+
+d.years() / d.months() / d.days() / d.hours() / d.minutes() / d.seconds()
+d.add(1, 'hour').subtract(30, 'minutes')
+d.clone()
+d.toISOString()   // "P2D"
+
+// Add duration to date
+tempox().add(tempox.duration(2,'hours'))
+
+tempox.isDuration(d)   // true
+```
+
+### Locale (i18n)
+
+```js
+// Set global locale
+tempox.locale('hi');   // Hindi
+tempox().format('MMMM D, YYYY'); // "जून 15, 2024"
+
+// Per-instance locale
+tempox().locale('es').format('MMMM'); // "junio"
+
+// Built-in locales
+tempox.locales(); // ['en','hi','es','fr','de','ar','ja']
+
+// Define custom locale
+tempox.defineLocale('mr', {
+  name: 'mr',
+  months: ['जानेवारी','फेब्रुवारी','मार्च',...],
+  // ...
+});
+
+// Get locale data
+tempox.localeData('en').months
+tempox().localeData()
+```
+
+### Static Methods
+
+```js
+tempox.max(a, b, c)   // returns latest Tempox
+tempox.min(a, b, c)   // returns earliest Tempox
+tempox.invalid()      // returns an invalid Tempox
+tempox.normalizeUnits('y')  // 'year'
+tempox.version        // '1.0.0'
+tempox.fn             // Tempox.prototype (for plugins)
+```
+
+---
+
+## React Native Usage
+
+Works directly with React Native CLI (Hermes and JSC). No special configuration needed:
+
+```bash
+npm install tempox
+```
+
+```js
+// In your component
+import tempox from 'tempox'; // ESM syntax works too with Metro
+// or
+const tempox = require('tempox');
+
+const DateDisplay = () => {
+  const [display, setDisplay] = React.useState(tempox().format('LL'));
+  return <Text>{display}</Text>;
+};
+```
+
+---
+
+## Why tempox over moment?
+
+| Feature | moment | tempox |
+|---------|--------|--------|
+| Size (minified) | ~290 KB | ~25 KB |
+| Size (gzipped) | ~72 KB | ~8 KB |
+| Dependencies | 0 | 0 |
+| Tree-shakeable | ❌ | ✅ |
+| Immutable option | ❌ | ✅ `.clone()` |
+| React Native safe | ⚠️ | ✅ |
+| API compatible | ✅ | ✅ |
+
+---
+
+## License
+
+MIT

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "datevolt",
+  "version": "1.0.0",
+  "description": "A complete, lightweight, zero-dependency date library with a moment.js-compatible API. Built for React Native CLI (Android & iOS), Node.js, and browsers.",
+  "main": "src/index.js",
+  "react-native": "src/index.js",
+  "files": [
+    "src/",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node test/test.js"
+  },
+  "keywords": [
+    "date",
+    "time",
+    "moment",
+    "moment-alternative",
+    "moment-replacement",
+    "react-native",
+    "android",
+    "ios",
+    "hermes",
+    "date-format",
+    "date-parse",
+    "datetime",
+    "timezone",
+    "duration",
+    "locale",
+    "calendar",
+    "lightweight",
+    "zero-dependency",
+    "javascript"
+  ],
+  "author": "shaikh-saqlain",
+  "license": "MIT",
+  "engines": {
+    "node": ">=12"
+  },
+  "react-native-metadata": {
+    "platforms": [
+      "android",
+      "ios"
+    ]
+  },
+  "dependencies": {},
+  "devDependencies": {},
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/shaikh-saqlain/datevolt.git"
+  },
+  "bugs": {
+    "url": "https://github.com/shaikh-saqlain/datevolt/issues"
+  },
+  "homepage": "https://github.com/shaikh-saqlain/datevolt#readme"
+}

package/src/duration.js

@@ -0,0 +1,188 @@
+'use strict';
+
+var localeModule = require('./locale');
+
+var MS = {
+  ms: 1, millisecond: 1, milliseconds: 1,
+  s: 1000, second: 1000, seconds: 1000,
+  m: 60000, minute: 60000, minutes: 60000,
+  h: 3600000, hour: 3600000, hours: 3600000,
+  d: 86400000, day: 86400000, days: 86400000,
+  w: 604800000, week: 604800000, weeks: 604800000,
+  M: 2629800000, month: 2629800000, months: 2629800000, // 30.4375 days
+  y: 31557600000, year: 31557600000, years: 31557600000  // 365.25 days
+};
+
+// ISO 8601 duration string: P1Y2M3DT4H5M6S
+var ISO_DURATION_REGEX = /^(-|\+)?P(?:([-+]?[0-9,.]*)Y)?(?:([-+]?[0-9,.]*)M)?(?:([-+]?[0-9,.]*)W)?(?:([-+]?[0-9,.]*)D)?(?:T(?:([-+]?[0-9,.]*)H)?(?:([-+]?[0-9,.]*)M)?(?:([-+]?[0-9,.]*)S)?)?$/;
+
+function Duration(input, unit) {
+  this.__isDuration = true;
+  this._locale = localeModule.getGlobalLocale();
+
+  if (typeof input === 'string') {
+    var isoMatch = input.match(ISO_DURATION_REGEX);
+    if (isoMatch) {
+      var sign = isoMatch[1] === '-' ? -1 : 1;
+      this._years   = sign * parseFloat(isoMatch[2]||0);
+      this._months  = sign * parseFloat(isoMatch[3]||0);
+      this._weeks   = sign * parseFloat(isoMatch[4]||0);
+      this._days    = sign * parseFloat(isoMatch[5]||0);
+      this._hours   = sign * parseFloat(isoMatch[6]||0);
+      this._minutes = sign * parseFloat(isoMatch[7]||0);
+      this._seconds = sign * parseFloat(isoMatch[8]||0);
+      this._ms = 0;
+      this._milliseconds = 0;
+    } else {
+      this._ms = 0;
+      this._years=this._months=this._weeks=this._days=this._hours=this._minutes=this._seconds=this._milliseconds=0;
+    }
+  } else if (typeof input === 'number') {
+    var resolvedUnit = unit || 'ms';
+    var multiplier = MS[resolvedUnit] || 1;
+    this._ms = input * multiplier;
+    this._years = 0; this._months = 0; this._weeks = 0; this._days = 0;
+    this._hours = 0; this._minutes = 0; this._seconds = 0; this._milliseconds = 0;
+    this._normalizeFromMs();
+  } else if (typeof input === 'object' && input !== null) {
+    this._years       = input.years       || input.year   || input.y  || 0;
+    this._months      = input.months      || input.month  || input.M  || 0;
+    this._weeks       = input.weeks       || input.week   || input.w  || 0;
+    this._days        = input.days        || input.day    || input.d  || 0;
+    this._hours       = input.hours       || input.hour   || input.h  || 0;
+    this._minutes     = input.minutes     || input.minute || input.m  || 0;
+    this._seconds     = input.seconds     || input.second || input.s  || 0;
+    this._milliseconds= input.milliseconds|| input.millisecond||input.ms||0;
+    this._ms = this._toMs();
+  } else {
+    this._ms = 0;
+    this._years=this._months=this._weeks=this._days=this._hours=this._minutes=this._seconds=this._milliseconds=0;
+  }
+}
+
+Duration.prototype._toMs = function() {
+  return this._years * MS.y + this._months * MS.M + this._weeks * MS.w +
+    this._days * MS.d + this._hours * MS.h + this._minutes * MS.m +
+    this._seconds * MS.s + this._milliseconds;
+};
+
+Duration.prototype._normalizeFromMs = function() {
+  var remaining = Math.abs(this._ms);
+  var sign = this._ms < 0 ? -1 : 1;
+  this._years        = sign * Math.floor(remaining / MS.y); remaining %= MS.y;
+  this._months       = sign * Math.floor(remaining / MS.M); remaining %= MS.M;
+  this._days         = sign * Math.floor(remaining / MS.d); remaining %= MS.d;
+  this._hours        = sign * Math.floor(remaining / MS.h); remaining %= MS.h;
+  this._minutes      = sign * Math.floor(remaining / MS.m); remaining %= MS.m;
+  this._seconds      = sign * Math.floor(remaining / MS.s); remaining %= MS.s;
+  this._milliseconds = sign * remaining;
+  this._weeks        = 0;
+};
+
+// ── Getters ───────────────────────────────────────────────────────────────────
+Duration.prototype.years      = function() { return this._years; };
+Duration.prototype.months     = function() { return this._months; };
+Duration.prototype.weeks      = function() { return Math.floor(this._days/7); };
+Duration.prototype.days       = function() { return this._days % 7; };
+Duration.prototype.hours      = function() { return this._hours; };
+Duration.prototype.minutes    = function() { return this._minutes; };
+Duration.prototype.seconds    = function() { return this._seconds; };
+Duration.prototype.milliseconds = function() { return this._milliseconds; };
+
+// ── as() ─────────────────────────────────────────────────────────────────────
+Duration.prototype.as = function(unit) {
+  var totalMs = this._toMs();
+  var multiplier = MS[unit] || 1;
+  return totalMs / multiplier;
+};
+
+Duration.prototype.asMilliseconds = function() { return this._toMs(); };
+Duration.prototype.asSeconds      = function() { return this._toMs()/1000; };
+Duration.prototype.asMinutes      = function() { return this._toMs()/60000; };
+Duration.prototype.asHours        = function() { return this._toMs()/3600000; };
+Duration.prototype.asDays         = function() { return this._toMs()/86400000; };
+Duration.prototype.asWeeks        = function() { return this._toMs()/604800000; };
+Duration.prototype.asMonths       = function() { return this._toMs()/2629800000; };
+Duration.prototype.asYears        = function() { return this._toMs()/31557600000; };
+
+Duration.prototype.get = function(unit) {
+  return this.as(unit);
+};
+
+// ── Add / Subtract ────────────────────────────────────────────────────────────
+Duration.prototype.add = function(input, unit) {
+  var other = input instanceof Duration ? input : new Duration(input, unit);
+  this._years       += other._years;
+  this._months      += other._months;
+  this._weeks       += other._weeks;
+  this._days        += other._days;
+  this._hours       += other._hours;
+  this._minutes     += other._minutes;
+  this._seconds     += other._seconds;
+  this._milliseconds+= other._milliseconds;
+  this._ms = this._toMs();
+  return this;
+};
+
+Duration.prototype.subtract = function(input, unit) {
+  var other = input instanceof Duration ? input : new Duration(input, unit);
+  this._years       -= other._years;
+  this._months      -= other._months;
+  this._weeks       -= other._weeks;
+  this._days        -= other._days;
+  this._hours       -= other._hours;
+  this._minutes     -= other._minutes;
+  this._seconds     -= other._seconds;
+  this._milliseconds-= other._milliseconds;
+  this._ms = this._toMs();
+  return this;
+};
+
+// ── Humanize ─────────────────────────────────────────────────────────────────
+Duration.prototype.humanize = function(withSuffix) {
+  var ms = Math.abs(this._toMs());
+  var loc = localeModule.getLocale(this._locale);
+  var rt = loc.relativeTime;
+  var str;
+
+  var secs = ms/1000, mins = ms/60000, hrs = ms/3600000,
+      days = ms/86400000, weeks = ms/604800000,
+      months = ms/2629800000, years = ms/31557600000;
+
+  if (ms < 45000)         str = rt.s;
+  else if (ms < 90000)    str = rt.m;
+  else if (ms < 2700000)  str = rt.mm.replace('%d', Math.round(mins));
+  else if (ms < 5400000)  str = rt.h;
+  else if (ms < 79200000) str = rt.hh.replace('%d', Math.round(hrs));
+  else if (ms < 129600000)str = rt.d;
+  else if (ms < 2160000000)str = rt.dd.replace('%d', Math.round(days));
+  else if (ms < 3888000000)str = rt.M;
+  else if (ms < 31536000000)str = rt.MM.replace('%d', Math.round(months));
+  else if (ms < 47260800000)str = rt.y;
+  else                    str = rt.yy.replace('%d', Math.round(years));
+
+  if (withSuffix) {
+    if (this._toMs() >= 0) return rt.future.replace('%s', str);
+    return rt.past.replace('%s', str);
+  }
+  return str;
+};
+
+Duration.prototype.locale = function(loc) {
+  this._locale = loc;
+  return this;
+};
+
+// ── ISO string ────────────────────────────────────────────────────────────────
+Duration.prototype.toISOString = function() {
+  var Y = this._years, M = this._months, W = this._weeks;
+  var D = this._days, H = this._hours, m = this._minutes, S = this._seconds;
+  return 'P' + (Y?Y+'Y':'') + (M?M+'M':'') + (W?W+'W':'') + (D?D+'D':'') +
+    ((H||m||S)?('T'+(H?H+'H':'')+(m?m+'M':'')+(S?S+'S':'')):'') || 'P0D';
+};
+
+Duration.prototype.toJSON = Duration.prototype.toISOString;
+Duration.prototype.valueOf = function() { return this._toMs(); };
+Duration.prototype.clone = function() { return new Duration(this._toMs()); };
+
+module.exports = Duration;