@kikuchan/bigdate 0.0.1-alpha.0

package/README.md

@@ -0,0 +1,219 @@
+# @kikuchan/decimal
+
+Arbitrary precision decimal arithmetic for TypeScript and JavaScript. Avoids binary floating-point rounding errors.
+
+## Installation
+
+```bash
+npm install @kikuchan/decimal
+```
+
+## Quick Start
+
+```ts
+import { Decimal } from '@kikuchan/decimal';
+
+const price = Decimal('12.345');
+const quantity = Decimal(3);
+const total = price.mul(quantity).round(2);
+
+console.log(total.toString()); // "37.04"
+```
+
+## Creating Decimals
+
+The `Decimal()` constructor accepts numbers, strings, bigints, or existing Decimal instances:
+
+```ts
+Decimal(100)           // from number
+Decimal('12.345')      // from string
+Decimal('1.5e2')       // scientific notation
+Decimal(12345n)        // from bigint
+Decimal(existing)      // from another Decimal
+
+// Nullable values pass through unchanged
+Decimal(null)          // returns null
+Decimal(undefined)     // returns undefined
+```
+
+## API Overview
+
+### Arithmetic Operations
+
+All operations are **immutable by default** and return new Decimal instances:
+
+```ts
+const a = Decimal('10.5');
+const b = Decimal('2.3');
+
+a.add(b)        // addition
+a.sub(b)        // subtraction
+a.mul(b)        // multiplication
+a.div(b)        // division (default 18 decimal places)
+a.div(b, 5)     // division with custom precision
+
+a.mod(b)        // modulo (same sign rules as JavaScript %)
+a.modPositive(b)  // always non-negative remainder
+```
+
+### Mutable Operations
+
+Methods ending with `$` modify the value in place and return `this`:
+
+```ts
+const value = Decimal('1.2345');
+value.round$(2);  // value is now 1.23
+
+// Both styles support chaining
+value.add$(1).mul$(2).round$(0);
+Decimal('10').add(5).mul(2).round(0);  // 30
+```
+
+### Rounding & Precision
+
+```ts
+const num = Decimal('12.3456');
+
+num.round(2)     // 12.35 (half away from zero)
+num.floor(2)     // 12.34
+num.ceil(2)      // 12.35
+num.trunc(2)     // 12.34
+
+// Negative precision rounds to powers of 10
+Decimal('1234').round(-2)  // 1200 (nearest hundred)
+
+// Round to specific step sizes
+Decimal('12.7').roundBy('0.5')  // 13.0
+Decimal('47').roundBy(10)       // 50
+```
+
+**Precision control:**
+- Positive values: digits after decimal point
+- Zero: round to whole units
+- Negative values: powers of ten (e.g., `-2` = hundreds)
+
+### Sign & Absolute Value
+
+```ts
+const num = Decimal('-5.5');
+
+num.neg()         // 5.5
+num.abs()         // 5.5
+num.isNegative()  // true
+num.isPositive()  // false
+num.isZero()      // false
+```
+
+### Comparison
+
+```ts
+const a = Decimal('10');
+const b = Decimal('20');
+
+a.cmp(b)      // -1 (less), 0 (equal), or 1 (greater)
+a.eq(b)       // false
+a.lt(b)       // true
+a.le(b)       // true
+a.gt(b)       // false
+a.ge(b)       // false
+
+a.between(5, 15)        // true
+a.between(15, 25)       // false
+a.isCloseTo(10.001, 0.01)  // true
+```
+
+### Advanced Math
+
+```ts
+const num = Decimal('100');
+
+num.sqrt()           // square root
+num.root(3)          // cube root
+num.pow(2)           // exponentiation
+num.pow('0.5')       // fractional exponents (non-negative bases only)
+num.log(10)          // logarithm (base 10)
+num.inverse()        // 1 / num
+
+// All accept optional precision argument
+num.sqrt(10)         // 10 decimal places
+num.log(10, 20)      // 20 decimal places
+```
+
+### Decimal Point Manipulation
+
+```ts
+const num = Decimal('12.345');
+
+num.shift10(2)       // 1234.5 (shift right = multiply by 10²)
+num.shift10(-1)      // 1.2345 (shift left = divide by 10)
+
+// Split into integer and fractional parts
+const [whole, frac] = num.split(2);  // [12.34, 0.005]
+```
+
+### Conversion
+
+```ts
+const num = Decimal('12.345');
+
+num.toString()       // "12.345"
+num.toFixed(2)       // "12.35"
+num.number()         // 12.345 (native number)
+num.integer()        // 12n (bigint, truncated)
+```
+
+### Utilities
+
+```ts
+Decimal('12.3000').rescale()   // "12.3" (remove trailing zeros)
+
+const a = Decimal('5.5');
+a.clamp(0, 10)        // 5.5 (bounded)
+a.clamp(6, 10)        // 6 (clamped to minimum)
+
+// Exported utility functions
+import { min, max, minmax, pow10, isDecimal } from '@kikuchan/decimal';
+
+min(1, 2, 3)              // Decimal(1)
+max('1.5', '2.5', '3.5')  // Decimal(3.5)
+minmax(5, 1, 3)           // [Decimal(1), Decimal(5)]
+pow10(3)                  // Decimal(1000)
+isDecimal(value)          // type guard
+```
+
+## Rounding Modes
+
+All rounding operations support these modes:
+
+- `'round'` — half away from zero (default)
+- `'floor'` — toward negative infinity
+- `'ceil'` — toward positive infinity
+- `'trunc'` — toward zero
+
+```ts
+const num = Decimal('12.75');
+num.round(1, 'round')  // 12.8
+num.round(1, 'floor')  // 12.7
+num.round(1, 'ceil')   // 12.8
+num.round(1, 'trunc')  // 12.7
+```
+
+## Important Notes
+
+- **Immutability**: Operations return new instances unless using `$` methods
+- **Precision**: Division and advanced math default to 18 decimal places
+- **No silent overflow**: All operations maintain arbitrary precision
+- **Null-safe**: `Decimal(null)` and `Decimal(undefined)` pass through unchanged
+
+## Development
+
+```bash
+pnpm test      # Run tests
+pnpm build     # Build package
+pnpm lint      # Lint source
+pnpm format    # Check formatting
+```
+
+## License
+
+See LICENSE file for details.

package/index.cjs

@@ -0,0 +1 @@
+let e=require(`@kikuchan/decimal`);const t=86400n,n=3600n,r=60n,i=(0,e.Decimal)(-8640000000000000n),a=(0,e.Decimal)(8640000000000000n);function o(t,n){if(typeof t==`bigint`)return t;if(typeof t==`number`){if(!Number.isFinite(t)||!Number.isInteger(t))throw Error(`${n} must be an integer`);return BigInt(t)}let r=(0,e.Decimal)(t),i=r.integer();if(!r.eq(i))throw Error(`${n} must be an integer`);return i}function s(e,t){let n=e/t;return e%t===0n||e<0n==t<0n?n:n-1n}function c(e,t){let n=t-1n,r=s(n,12n),i=n-r*12n+1n;return{year:e+r,month:i}}function l(e,t,n){return h(m(e,t,n))}function u(e,t,n=0n){if(!t)return e;if(Array.isArray(t))return t.map(e=>BigInt(e)).filter(t=>t<=e).toSorted((e,t)=>e<t?-1:e>t?1:0).at(-1)??e;let r=BigInt(t);return(e-n)/r*r+n}function d(e,t,n=0n){if(!t)return e;if(Array.isArray(t))return t.map(e=>BigInt(e)).filter(t=>e<t).toSorted((e,t)=>e<t?-1:e>t?1:0).at(0);let r=BigInt(t);return((e-n)/r+1n)*r+n}function f(e,t,n){if(!t)return e;if(!n?.era)return u(e,t,0n);if(e>0n){let n=u(e,t,0n);return n===0n?1n:n}let r=d(-e+1n-1n,t,0n);return r===void 0?e:-(r-1n)}function p(e,t,n){if(!t)return e;if(!n?.era||e>0n)return d(e,t,0n);let r=u(-e+1n-1n,t,0n);return Array.isArray(t)&&!t.map(e=>BigInt(e)).some(e=>e===r)||r<=0n?1n:-(r-1n)}function m(e,t,n){let{year:r,month:i}=c(e,t),a=n-1n,o=r,l=i;o-=l<=2n?1n:0n;let u=s(o,400n),d=o-u*400n,f=s(153n*(l+(l>2n?-3n:9n))+2n,5n),p=d*365n+s(d,4n)-s(d,100n)+f;return u*146097n+p-719468n+a}function h(e){let t=e+719468n,n=s(t,146097n),r=t-n*146097n,i=s(r-s(r,1460n)+s(r,36524n)-s(r,146096n),365n),a=i+n*400n,o=r-(365n*i+s(i,4n)-s(i,100n)),c=s(5n*o+2n,153n),l=o-s(153n*c+2n,5n)+1n,u=c+(c<10n?3n:-9n);a+=u<=2n?1n:0n;let d=Number(((e+4n)%7n+7n)%7n);return{year:a,month:u,day:l,weekday:d}}function g(e){let t=g.cache??new Map;g.cache=t;let n=t.get(e);return n||(n=new Intl.DateTimeFormat(`en-US`,{timeZone:e,year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hourCycle:`h23`}),t.set(e,n)),n}g.cache=void 0;function _(o,s){if(s.toLowerCase()===`utc`)return 0;let c=o.mul(1e3).clamp(i,a),l=new Date(c.number());if(s.toLowerCase()===`local`)return l.getTimezoneOffset();let u=new Map(g(s).formatToParts(l).map(e=>[e.type,e.value])),d=BigInt(u.get(`year`)??`0`),f=BigInt(u.get(`month`)??`0`),p=BigInt(u.get(`day`)??`0`),h=BigInt(u.get(`hour`)??`0`),_=BigInt(u.get(`minute`)??`0`),v=BigInt(u.get(`second`)??`0`),y=(0,e.Decimal)(m(d,f,p)).mul(t).add(h*n+_*r+v).add((0,e.Decimal)(l.getUTCMilliseconds()).div(1e3));return c.div(1e3).sub(y).div(60).trunc(0,!0).number()}function v(i,a){let o=_(i,a),c=o===0?i:i.sub((0,e.Decimal)(o).mul(r)),l=s(c.floor(0).integer(),t),u=c.sub((0,e.Decimal)(l*t)),d=u.floor(0).integer(),f=u.sub((0,e.Decimal)(d)),p=d/n,m=d%n/r,g=d%r,{year:v,month:y,day:b,weekday:x}=h(l);return{year:v,month:y,day:b,hour:p,minutes:m,seconds:(0,e.Decimal)(g).add(f),weekday:x}}function y(i,a){let o=(0,e.Decimal)(m(i.year,i.month,i.day)).mul(t).add((0,e.Decimal)(i.hour*n+i.minutes*r).add(i.seconds));if(a.toLowerCase()===`utc`)return o;let s=o;for(let t=0;t<4;t++){let t=_(s,a),n=o.add((0,e.Decimal)(t).mul(r));if(n.eq(s))return n;s=n}return s}function b(t){let n=o(t.year,`year`),r=o(t.month,`month`),i=o(t.day,`day`);return{year:n,month:r,day:i,hour:t.hour==null?0n:o(t.hour,`hour`),minutes:t.minutes==null?0n:o(t.minutes,`minutes`),seconds:t.seconds==null?(0,e.Decimal)(0):(0,e.Decimal)(t.seconds),weekday:h(m(n,r,i)).weekday}}function x(e){return e||`utc`}var S=class t{#e;#t;constructor(...t){if(t.length===0){this.#e=(0,e.Decimal)(Date.now()).div(1e3),this.#t=`utc`;return}let n=(t.length===7||t.length===2)&&typeof t[t.length-1]==`string`?x(t[t.length-1]):`utc`;if(t.length>=3&&typeof t[0]!=`object`){let[e,r,i,a,o,s]=t;this.#e=y(b({year:e,month:r,day:i,hour:a,minutes:o,seconds:s}),n),this.#t=n;return}if(this.#t=n,t[0]instanceof Date){this.#e=(0,e.Decimal)(t[0].getTime()).div(1e3);return}this.#e=(0,e.Decimal)(t[0])}static fromEpoch(e,n=`utc`){return new t(e,n)}static fromDate(e,n=`utc`){return new t(e,n)}static fromCalendar(e,n=`utc`){return new t(y(b(e),n),n)}clone(){return new t(this.#e,this.#t)}zone(e){return e===void 0?this.#t:new t(this.#e,e)}zone$(e){return this.#t=e,this}utc(){return this.zone(`utc`)}utc$(){return this.zone$(`utc`)}local(){return this.zone(`local`)}local$(){return this.zone$(`local`)}epoch(e){return e===void 0?this.#e.clone():new t(e,this.#t)}epoch$(t){return this.#e=(0,e.Decimal)(t),this}object(){return v(this.#e,this.#t)}#n(e,n){let r=this.object(),i=y({year:e.year??r.year,month:e.month??r.month,day:e.day??r.day,hour:e.hour??r.hour,minutes:e.minutes??r.minutes,seconds:e.seconds??r.seconds,weekday:r.weekday},this.#t);return n?(this.#e=i,this):new t(i,this.#t)}#r(n){let r=this.object();return new t(y({...n(r),hour:0n,minutes:0n,seconds:(0,e.Decimal)(0),weekday:r.weekday},this.#t),this.#t)}year(e){return e===void 0?this.object().year:this.#n({year:o(e,`year`)},!1)}year$(e){return this.#n({year:o(e,`year`)},!0)}month(e){return e===void 0?this.object().month:this.#n({month:o(e,`month`)},!1)}month$(e){return this.#n({month:o(e,`month`)},!0)}day(e){return e===void 0?this.object().day:this.#n({day:o(e,`day`)},!1)}day$(e){return this.#n({day:o(e,`day`)},!0)}hour(e){return e===void 0?this.object().hour:this.#n({hour:o(e,`hour`)},!1)}hour$(e){return this.#n({hour:o(e,`hour`)},!0)}minutes(e){return e===void 0?this.object().minutes:this.#n({minutes:o(e,`minutes`)},!1)}minutes$(e){return this.#n({minutes:o(e,`minutes`)},!0)}seconds(t){return t===void 0?this.object().seconds.clone():this.#n({seconds:(0,e.Decimal)(t)},!1)}seconds$(t){return this.#n({seconds:(0,e.Decimal)(t)},!0)}weekday(){return this.object().weekday}alignToDay(e){return this.#r(t=>l(t.year,t.month,u(t.day,e,1n)))}nextDay(e){return this.#r(t=>{let n=d(t.day,e,1n);if(n===void 0){let{year:e,month:n}=c(t.year,t.month+1n);return{year:e,month:n,day:1n}}return l(t.year,t.month,n)})}alignToMonth(e){return this.#r(t=>{let{year:n,month:r}=c(t.year,u(t.month,e,1n));return{year:n,month:r,day:1n}})}nextMonth(e){return this.#r(t=>{let{year:n,month:r}=c(t.year,d(t.month,e,1n));return{year:n,month:r,day:1n}})}alignToYear(e,t){return this.#r(n=>({year:f(n.year,e,t),month:1n,day:1n}))}nextYear(e,t){return this.#r(n=>({year:p(n.year,e,t),month:1n,day:1n}))}alignToSecond(n){let r=this.alignToDay(1n);return new t(this.#e.sub(r.epoch()).floorBy((0,e.Decimal)(n)).add(r.epoch()),this.#t)}format(e){let t=this.object(),n=t.year.toString(),r=t.month.toString(),i=t.day.toString(),a=t.hour.toString(),o=t.minutes.toString(),s=t.seconds,c=s.toString(),l=c.indexOf(`.`),u=l>=0?c.slice(l+1):``,d=t.year<=0?`BC `:``,f=t.year>0?` AD`:``,p=t.year<=0?(1n-t.year).toString():t.year.toString(),m={gggg:`${d}${p.padStart(4,`0`)}`,GGGG:`${d}${p.padStart(4,`0`)}${f}`,g:`${d}${p}`,G:`${d}${p}${f}`,yyyy:n.padStart(4,`0`),YYYY:n.padStart(4,`0`),y:n,MM:r.padStart(2,`0`),DD:i.padStart(2,`0`),hh:a.padStart(2,`0`),mm:o.padStart(2,`0`),ss:s.floor().toString().padStart(2,`0`),SSSSSS:u.padEnd(6,`0`).slice(0,6),SSS:u.padEnd(3,`0`).slice(0,3),SS:u.padEnd(2,`0`).slice(0,2),S:u.padEnd(1,`0`).slice(0,1)},h=e;for(let[e,t]of Object.entries(m))h=h.replace(e,t);return h}};exports.BigDate=S;

package/index.d.cts

@@ -0,0 +1,75 @@
+import { Decimal, DecimalLike } from "@kikuchan/decimal";
+
+//#region src/index.d.ts
+type Zone = string;
+type CalendarInput = {
+  year: bigint | number | DecimalLike;
+  month: bigint | number | DecimalLike;
+  day: bigint | number | DecimalLike;
+  hour?: bigint | number | DecimalLike;
+  minutes?: bigint | number | DecimalLike;
+  seconds?: DecimalLike;
+};
+type CalendarComponents = {
+  year: bigint;
+  month: bigint;
+  day: bigint;
+  hour: bigint;
+  minutes: bigint;
+  seconds: Decimal;
+  weekday: number;
+};
+type Step = bigint | number | (bigint | number)[] | undefined;
+type YearStepOptions = {
+  era?: boolean;
+};
+declare class BigDate {
+  #private;
+  constructor();
+  constructor(dateLike: DecimalLike | Date, zone?: Zone);
+  constructor(year: bigint | number, month: bigint | number, day: bigint | number, hour?: bigint | number, minutes?: bigint | number, seconds?: DecimalLike, zone?: Zone);
+  static fromEpoch(epochSeconds: DecimalLike, zone?: Zone): BigDate;
+  static fromDate(date: Date, zone?: Zone): BigDate;
+  static fromCalendar(input: CalendarInput, zone?: Zone): BigDate;
+  clone(): BigDate;
+  zone(): Zone;
+  zone(value: Zone): BigDate;
+  zone$(value: Zone): this;
+  utc(): BigDate;
+  utc$(): this;
+  local(): BigDate;
+  local$(): this;
+  epoch(): Decimal;
+  epoch(value: DecimalLike): BigDate;
+  epoch$(value: DecimalLike): this;
+  object(): CalendarComponents;
+  year(): bigint;
+  year(value: bigint | number | DecimalLike): BigDate;
+  year$(value: bigint | number | DecimalLike): BigDate;
+  month(): bigint;
+  month(value: bigint | number | DecimalLike): BigDate;
+  month$(value: bigint | number | DecimalLike): BigDate;
+  day(): bigint;
+  day(value: bigint | number | DecimalLike): BigDate;
+  day$(value: bigint | number | DecimalLike): BigDate;
+  hour(): bigint;
+  hour(value: bigint | number | DecimalLike): BigDate;
+  hour$(value: bigint | number | DecimalLike): BigDate;
+  minutes(): bigint;
+  minutes(value: bigint | number | DecimalLike): BigDate;
+  minutes$(value: bigint | number | DecimalLike): BigDate;
+  seconds(): Decimal;
+  seconds(value: DecimalLike): BigDate;
+  seconds$(value: DecimalLike): BigDate;
+  weekday(): number;
+  alignToDay(step?: Step): BigDate;
+  nextDay(step?: Step): BigDate;
+  alignToMonth(step?: Step): BigDate;
+  nextMonth(step?: Step): BigDate;
+  alignToYear(step?: Step, options?: YearStepOptions): BigDate;
+  nextYear(step?: Step, options?: YearStepOptions): BigDate;
+  alignToSecond(step: DecimalLike): BigDate;
+  format(fmt: string): string;
+}
+//#endregion
+export { BigDate };

package/index.d.ts

@@ -0,0 +1,75 @@
+import { Decimal, DecimalLike } from "@kikuchan/decimal";
+
+//#region src/index.d.ts
+type Zone = string;
+type CalendarInput = {
+  year: bigint | number | DecimalLike;
+  month: bigint | number | DecimalLike;
+  day: bigint | number | DecimalLike;
+  hour?: bigint | number | DecimalLike;
+  minutes?: bigint | number | DecimalLike;
+  seconds?: DecimalLike;
+};
+type CalendarComponents = {
+  year: bigint;
+  month: bigint;
+  day: bigint;
+  hour: bigint;
+  minutes: bigint;
+  seconds: Decimal;
+  weekday: number;
+};
+type Step = bigint | number | (bigint | number)[] | undefined;
+type YearStepOptions = {
+  era?: boolean;
+};
+declare class BigDate {
+  #private;
+  constructor();
+  constructor(dateLike: DecimalLike | Date, zone?: Zone);
+  constructor(year: bigint | number, month: bigint | number, day: bigint | number, hour?: bigint | number, minutes?: bigint | number, seconds?: DecimalLike, zone?: Zone);
+  static fromEpoch(epochSeconds: DecimalLike, zone?: Zone): BigDate;
+  static fromDate(date: Date, zone?: Zone): BigDate;
+  static fromCalendar(input: CalendarInput, zone?: Zone): BigDate;
+  clone(): BigDate;
+  zone(): Zone;
+  zone(value: Zone): BigDate;
+  zone$(value: Zone): this;
+  utc(): BigDate;
+  utc$(): this;
+  local(): BigDate;
+  local$(): this;
+  epoch(): Decimal;
+  epoch(value: DecimalLike): BigDate;
+  epoch$(value: DecimalLike): this;
+  object(): CalendarComponents;
+  year(): bigint;
+  year(value: bigint | number | DecimalLike): BigDate;
+  year$(value: bigint | number | DecimalLike): BigDate;
+  month(): bigint;
+  month(value: bigint | number | DecimalLike): BigDate;
+  month$(value: bigint | number | DecimalLike): BigDate;
+  day(): bigint;
+  day(value: bigint | number | DecimalLike): BigDate;
+  day$(value: bigint | number | DecimalLike): BigDate;
+  hour(): bigint;
+  hour(value: bigint | number | DecimalLike): BigDate;
+  hour$(value: bigint | number | DecimalLike): BigDate;
+  minutes(): bigint;
+  minutes(value: bigint | number | DecimalLike): BigDate;
+  minutes$(value: bigint | number | DecimalLike): BigDate;
+  seconds(): Decimal;
+  seconds(value: DecimalLike): BigDate;
+  seconds$(value: DecimalLike): BigDate;
+  weekday(): number;
+  alignToDay(step?: Step): BigDate;
+  nextDay(step?: Step): BigDate;
+  alignToMonth(step?: Step): BigDate;
+  nextMonth(step?: Step): BigDate;
+  alignToYear(step?: Step, options?: YearStepOptions): BigDate;
+  nextYear(step?: Step, options?: YearStepOptions): BigDate;
+  alignToSecond(step: DecimalLike): BigDate;
+  format(fmt: string): string;
+}
+//#endregion
+export { BigDate };

package/index.js

@@ -0,0 +1 @@
+import{Decimal as e}from"@kikuchan/decimal";const t=86400n,n=3600n,r=60n,i=e(-8640000000000000n),a=e(8640000000000000n);function o(t,n){if(typeof t==`bigint`)return t;if(typeof t==`number`){if(!Number.isFinite(t)||!Number.isInteger(t))throw Error(`${n} must be an integer`);return BigInt(t)}let r=e(t),i=r.integer();if(!r.eq(i))throw Error(`${n} must be an integer`);return i}function s(e,t){let n=e/t;return e%t===0n||e<0n==t<0n?n:n-1n}function c(e,t){let n=t-1n,r=s(n,12n),i=n-r*12n+1n;return{year:e+r,month:i}}function l(e,t,n){return h(m(e,t,n))}function u(e,t,n=0n){if(!t)return e;if(Array.isArray(t))return t.map(e=>BigInt(e)).filter(t=>t<=e).toSorted((e,t)=>e<t?-1:e>t?1:0).at(-1)??e;let r=BigInt(t);return(e-n)/r*r+n}function d(e,t,n=0n){if(!t)return e;if(Array.isArray(t))return t.map(e=>BigInt(e)).filter(t=>e<t).toSorted((e,t)=>e<t?-1:e>t?1:0).at(0);let r=BigInt(t);return((e-n)/r+1n)*r+n}function f(e,t,n){if(!t)return e;if(!n?.era)return u(e,t,0n);if(e>0n){let n=u(e,t,0n);return n===0n?1n:n}let r=d(-e+1n-1n,t,0n);return r===void 0?e:-(r-1n)}function p(e,t,n){if(!t)return e;if(!n?.era||e>0n)return d(e,t,0n);let r=u(-e+1n-1n,t,0n);return Array.isArray(t)&&!t.map(e=>BigInt(e)).some(e=>e===r)||r<=0n?1n:-(r-1n)}function m(e,t,n){let{year:r,month:i}=c(e,t),a=n-1n,o=r,l=i;o-=l<=2n?1n:0n;let u=s(o,400n),d=o-u*400n,f=s(153n*(l+(l>2n?-3n:9n))+2n,5n),p=d*365n+s(d,4n)-s(d,100n)+f;return u*146097n+p-719468n+a}function h(e){let t=e+719468n,n=s(t,146097n),r=t-n*146097n,i=s(r-s(r,1460n)+s(r,36524n)-s(r,146096n),365n),a=i+n*400n,o=r-(365n*i+s(i,4n)-s(i,100n)),c=s(5n*o+2n,153n),l=o-s(153n*c+2n,5n)+1n,u=c+(c<10n?3n:-9n);a+=u<=2n?1n:0n;let d=Number(((e+4n)%7n+7n)%7n);return{year:a,month:u,day:l,weekday:d}}function g(e){let t=g.cache??new Map;g.cache=t;let n=t.get(e);return n||(n=new Intl.DateTimeFormat(`en-US`,{timeZone:e,year:`numeric`,month:`2-digit`,day:`2-digit`,hour:`2-digit`,minute:`2-digit`,second:`2-digit`,hourCycle:`h23`}),t.set(e,n)),n}g.cache=void 0;function _(o,s){if(s.toLowerCase()===`utc`)return 0;let c=o.mul(1e3).clamp(i,a),l=new Date(c.number());if(s.toLowerCase()===`local`)return l.getTimezoneOffset();let u=new Map(g(s).formatToParts(l).map(e=>[e.type,e.value])),d=BigInt(u.get(`year`)??`0`),f=BigInt(u.get(`month`)??`0`),p=BigInt(u.get(`day`)??`0`),h=BigInt(u.get(`hour`)??`0`),_=BigInt(u.get(`minute`)??`0`),v=BigInt(u.get(`second`)??`0`),y=e(m(d,f,p)).mul(t).add(h*n+_*r+v).add(e(l.getUTCMilliseconds()).div(1e3));return c.div(1e3).sub(y).div(60).trunc(0,!0).number()}function v(i,a){let o=_(i,a),c=o===0?i:i.sub(e(o).mul(r)),l=s(c.floor(0).integer(),t),u=c.sub(e(l*t)),d=u.floor(0).integer(),f=u.sub(e(d)),p=d/n,m=d%n/r,g=d%r,{year:v,month:y,day:b,weekday:x}=h(l);return{year:v,month:y,day:b,hour:p,minutes:m,seconds:e(g).add(f),weekday:x}}function y(i,a){let o=e(m(i.year,i.month,i.day)).mul(t).add(e(i.hour*n+i.minutes*r).add(i.seconds));if(a.toLowerCase()===`utc`)return o;let s=o;for(let t=0;t<4;t++){let t=_(s,a),n=o.add(e(t).mul(r));if(n.eq(s))return n;s=n}return s}function b(t){let n=o(t.year,`year`),r=o(t.month,`month`),i=o(t.day,`day`);return{year:n,month:r,day:i,hour:t.hour==null?0n:o(t.hour,`hour`),minutes:t.minutes==null?0n:o(t.minutes,`minutes`),seconds:t.seconds==null?e(0):e(t.seconds),weekday:h(m(n,r,i)).weekday}}function x(e){return e||`utc`}var S=class t{#e;#t;constructor(...t){if(t.length===0){this.#e=e(Date.now()).div(1e3),this.#t=`utc`;return}let n=(t.length===7||t.length===2)&&typeof t[t.length-1]==`string`?x(t[t.length-1]):`utc`;if(t.length>=3&&typeof t[0]!=`object`){let[e,r,i,a,o,s]=t;this.#e=y(b({year:e,month:r,day:i,hour:a,minutes:o,seconds:s}),n),this.#t=n;return}if(this.#t=n,t[0]instanceof Date){this.#e=e(t[0].getTime()).div(1e3);return}this.#e=e(t[0])}static fromEpoch(e,n=`utc`){return new t(e,n)}static fromDate(e,n=`utc`){return new t(e,n)}static fromCalendar(e,n=`utc`){return new t(y(b(e),n),n)}clone(){return new t(this.#e,this.#t)}zone(e){return e===void 0?this.#t:new t(this.#e,e)}zone$(e){return this.#t=e,this}utc(){return this.zone(`utc`)}utc$(){return this.zone$(`utc`)}local(){return this.zone(`local`)}local$(){return this.zone$(`local`)}epoch(e){return e===void 0?this.#e.clone():new t(e,this.#t)}epoch$(t){return this.#e=e(t),this}object(){return v(this.#e,this.#t)}#n(e,n){let r=this.object(),i=y({year:e.year??r.year,month:e.month??r.month,day:e.day??r.day,hour:e.hour??r.hour,minutes:e.minutes??r.minutes,seconds:e.seconds??r.seconds,weekday:r.weekday},this.#t);return n?(this.#e=i,this):new t(i,this.#t)}#r(n){let r=this.object();return new t(y({...n(r),hour:0n,minutes:0n,seconds:e(0),weekday:r.weekday},this.#t),this.#t)}year(e){return e===void 0?this.object().year:this.#n({year:o(e,`year`)},!1)}year$(e){return this.#n({year:o(e,`year`)},!0)}month(e){return e===void 0?this.object().month:this.#n({month:o(e,`month`)},!1)}month$(e){return this.#n({month:o(e,`month`)},!0)}day(e){return e===void 0?this.object().day:this.#n({day:o(e,`day`)},!1)}day$(e){return this.#n({day:o(e,`day`)},!0)}hour(e){return e===void 0?this.object().hour:this.#n({hour:o(e,`hour`)},!1)}hour$(e){return this.#n({hour:o(e,`hour`)},!0)}minutes(e){return e===void 0?this.object().minutes:this.#n({minutes:o(e,`minutes`)},!1)}minutes$(e){return this.#n({minutes:o(e,`minutes`)},!0)}seconds(t){return t===void 0?this.object().seconds.clone():this.#n({seconds:e(t)},!1)}seconds$(t){return this.#n({seconds:e(t)},!0)}weekday(){return this.object().weekday}alignToDay(e){return this.#r(t=>l(t.year,t.month,u(t.day,e,1n)))}nextDay(e){return this.#r(t=>{let n=d(t.day,e,1n);if(n===void 0){let{year:e,month:n}=c(t.year,t.month+1n);return{year:e,month:n,day:1n}}return l(t.year,t.month,n)})}alignToMonth(e){return this.#r(t=>{let{year:n,month:r}=c(t.year,u(t.month,e,1n));return{year:n,month:r,day:1n}})}nextMonth(e){return this.#r(t=>{let{year:n,month:r}=c(t.year,d(t.month,e,1n));return{year:n,month:r,day:1n}})}alignToYear(e,t){return this.#r(n=>({year:f(n.year,e,t),month:1n,day:1n}))}nextYear(e,t){return this.#r(n=>({year:p(n.year,e,t),month:1n,day:1n}))}alignToSecond(n){let r=this.alignToDay(1n);return new t(this.#e.sub(r.epoch()).floorBy(e(n)).add(r.epoch()),this.#t)}format(e){let t=this.object(),n=t.year.toString(),r=t.month.toString(),i=t.day.toString(),a=t.hour.toString(),o=t.minutes.toString(),s=t.seconds,c=s.toString(),l=c.indexOf(`.`),u=l>=0?c.slice(l+1):``,d=t.year<=0?`BC `:``,f=t.year>0?` AD`:``,p=t.year<=0?(1n-t.year).toString():t.year.toString(),m={gggg:`${d}${p.padStart(4,`0`)}`,GGGG:`${d}${p.padStart(4,`0`)}${f}`,g:`${d}${p}`,G:`${d}${p}${f}`,yyyy:n.padStart(4,`0`),YYYY:n.padStart(4,`0`),y:n,MM:r.padStart(2,`0`),DD:i.padStart(2,`0`),hh:a.padStart(2,`0`),mm:o.padStart(2,`0`),ss:s.floor().toString().padStart(2,`0`),SSSSSS:u.padEnd(6,`0`).slice(0,6),SSS:u.padEnd(3,`0`).slice(0,3),SS:u.padEnd(2,`0`).slice(0,2),S:u.padEnd(1,`0`).slice(0,1)},h=e;for(let[e,t]of Object.entries(m))h=h.replace(e,t);return h}};export{S as BigDate};

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@kikuchan/bigdate",
+  "description": "Arbitrary precision date and time library using decimal numbers.",
+  "keywords": [
+    "decimal",
+    "arbitrary",
+    "date",
+    "bigint"
+  ],
+  "version": "0.0.1-alpha.0",
+  "type": "module",
+  "main": "./index.js",
+  "author": "kikuchan <kikuchan98@gmail.com>",
+  "homepage": "https://github.com/kikuchan/utils-on-npm#readme",
+  "license": "MIT",
+  "peerDependencies": {
+    "@kikuchan/decimal": "^0.1.0-alpha.5"
+  },
+  "types": "./index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./index.d.ts",
+      "import": "./index.js",
+      "require": "./index.cjs"
+    }
+  },
+  "repository": {
+    "url": "https://github.com/kikuchan/utils-on-npm"
+  }
+}