littlewing 0.8.0 → 0.8.2

package/dist/index.d.ts

@@ -323,19 +323,20 @@ declare namespace exports_date_utils {
 * Date utility functions for working with timestamps
 * All functions work with milliseconds since Unix epoch (numbers only)
 *
-* IMPORTANT: All functions use UTC timezone for consistency and predictability
-* across different server environments. This ensures the same inputs always
-* produce the same outputs regardless of the machine's local timezone.
+* IMPORTANT: All functions use local timezone to match the user's context.
+* In a browser, this reflects the user's timezone. On a server, this reflects
+* the server's configured timezone. This ensures date calculations align with
+* the user's calendar expectations.
 */
 /**
 * Get current timestamp (milliseconds since Unix epoch)
 */
 declare const NOW: () => number;
 /**
-* Create timestamp from date components (UTC timezone)
+* Create timestamp from date components (local timezone)
 * Year is required, all other parameters default to minimum values
 * Month is 1-based (1 = January, 12 = December)
-* All parameters are interpreted in UTC timezone for consistency
+* All parameters are interpreted in local timezone
 */
 declare const DATE: (year: number, month?: number, day?: number, hour?: number, minute?: number, second?: number) => number;
 /**
@@ -359,44 +360,44 @@ declare const FROM_MONTHS: (months: number) => number;
 */
 declare const FROM_YEARS: (years: number) => number;
 /**
-* Get the year from a timestamp (UTC)
+* Get the year from a timestamp (local timezone)
 */
 declare const GET_YEAR: (timestamp: number) => number;
 /**
-* Get the month from a timestamp (1-based: 1 = January, 12 = December, UTC)
+* Get the month from a timestamp (1-based: 1 = January, 12 = December, local timezone)
 */
 declare const GET_MONTH: (timestamp: number) => number;
 /**
-* Get the day of month from a timestamp (1-31, UTC)
+* Get the day of month from a timestamp (1-31, local timezone)
 */
 declare const GET_DAY: (timestamp: number) => number;
 /**
-* Get the hour from a timestamp (0-23, UTC)
+* Get the hour from a timestamp (0-23, local timezone)
 */
 declare const GET_HOUR: (timestamp: number) => number;
 /**
-* Get the minute from a timestamp (0-59, UTC)
+* Get the minute from a timestamp (0-59, local timezone)
 */
 declare const GET_MINUTE: (timestamp: number) => number;
 /**
-* Get the second from a timestamp (0-59, UTC)
+* Get the second from a timestamp (0-59, local timezone)
 */
 declare const GET_SECOND: (timestamp: number) => number;
 /**
-* Get the millisecond component from a timestamp (0-999, UTC)
+* Get the millisecond component from a timestamp (0-999, local timezone)
 */
 declare const GET_MILLISECOND: (timestamp: number) => number;
 /**
-* Get the day of week from a timestamp (0 = Sunday, 6 = Saturday, UTC)
+* Get the day of week from a timestamp (0 = Sunday, 6 = Saturday, local timezone)
 */
 declare const GET_WEEKDAY: (timestamp: number) => number;
 /**
-* Get the day of year (1-366) from a timestamp (UTC)
+* Get the day of year (1-366) from a timestamp (local timezone)
 * January 1st = 1, December 31st = 365 or 366 (leap year)
 */
 declare const GET_DAY_OF_YEAR: (timestamp: number) => number;
 /**
-* Get the quarter (1-4) from a timestamp (UTC)
+* Get the quarter (1-4) from a timestamp (local timezone)
 */
 declare const GET_QUARTER: (timestamp: number) => number;
 /**
@@ -412,15 +413,18 @@ declare const DIFFERENCE_IN_MINUTES: (ts1: number, ts2: number) => number;
 */
 declare const DIFFERENCE_IN_HOURS: (ts1: number, ts2: number) => number;
 /**
-* Get the absolute difference between two timestamps in days (whole days)
+* Get the difference in calendar days between two timestamps
+* Counts the number of calendar day boundaries crossed, not 24-hour periods
+* Example: Nov 7 at 11:59 PM to Nov 8 at 12:01 AM = 1 day (different calendar days)
 */
 declare const DIFFERENCE_IN_DAYS: (ts1: number, ts2: number) => number;
 /**
-* Get the absolute difference between two timestamps in weeks (whole weeks)
+* Get the difference in calendar weeks between two timestamps
+* Counts the number of week boundaries crossed (based on calendar days)
 */
 declare const DIFFERENCE_IN_WEEKS: (ts1: number, ts2: number) => number;
 /**
-* Get the number of full calendar months between two timestamps (UTC)
+* Get the number of full calendar months between two timestamps (local timezone)
 * Counts complete months where the same day-of-month has been reached
 *
 * Examples:
@@ -431,7 +435,7 @@ declare const DIFFERENCE_IN_WEEKS: (ts1: number, ts2: number) => number;
 */
 declare const DIFFERENCE_IN_MONTHS: (ts1: number, ts2: number) => number;
 /**
-* Get the number of full calendar years between two timestamps (UTC)
+* Get the number of full calendar years between two timestamps (local timezone)
 * Counts complete years where the same month and day have been reached
 *
 * Examples:
@@ -442,62 +446,62 @@ declare const DIFFERENCE_IN_MONTHS: (ts1: number, ts2: number) => number;
 */
 declare const DIFFERENCE_IN_YEARS: (ts1: number, ts2: number) => number;
 /**
-* Get the start of day (00:00:00.000 UTC) for a given timestamp
+* Get the start of day (00:00:00.000 local time) for a given timestamp
 */
 declare const START_OF_DAY: (timestamp: number) => number;
 /**
-* Get the end of day (23:59:59.999 UTC) for a given timestamp
+* Get the end of day (23:59:59.999 local time) for a given timestamp
 */
 declare const END_OF_DAY: (timestamp: number) => number;
 /**
-* Get the start of week (Sunday at 00:00:00.000 UTC) for a given timestamp
+* Get the start of week (Sunday at 00:00:00.000 local time) for a given timestamp
 */
 declare const START_OF_WEEK: (timestamp: number) => number;
 /**
-* Get the start of month (1st day at 00:00:00.000 UTC) for a given timestamp
+* Get the start of month (1st day at 00:00:00.000 local time) for a given timestamp
 */
 declare const START_OF_MONTH: (timestamp: number) => number;
 /**
-* Get the end of month (last day at 23:59:59.999 UTC) for a given timestamp
+* Get the end of month (last day at 23:59:59.999 local time) for a given timestamp
 */
 declare const END_OF_MONTH: (timestamp: number) => number;
 /**
-* Get the start of year (Jan 1st at 00:00:00.000 UTC) for a given timestamp
+* Get the start of year (Jan 1st at 00:00:00.000 local time) for a given timestamp
 */
 declare const START_OF_YEAR: (timestamp: number) => number;
 /**
-* Get the end of year (Dec 31st at 23:59:59.999 UTC) for a given timestamp
+* Get the end of year (Dec 31st at 23:59:59.999 local time) for a given timestamp
 */
 declare const END_OF_YEAR: (timestamp: number) => number;
 /**
-* Add days to a timestamp (UTC)
+* Add days to a timestamp (local timezone)
 */
 declare const ADD_DAYS: (timestamp: number, days: number) => number;
 /**
-* Add months to a timestamp (handles variable month lengths correctly, UTC)
+* Add months to a timestamp (handles variable month lengths correctly, local timezone)
 */
 declare const ADD_MONTHS: (timestamp: number, months: number) => number;
 /**
-* Add years to a timestamp (UTC)
+* Add years to a timestamp (local timezone)
 */
 declare const ADD_YEARS: (timestamp: number, years: number) => number;
 /**
-* Check if two timestamps are on the same calendar day (UTC)
+* Check if two timestamps are on the same calendar day (local timezone)
 * Returns 1 if true, 0 if false
 */
 declare const IS_SAME_DAY: (ts1: number, ts2: number) => number;
 /**
-* Check if timestamp falls on a weekend (Saturday or Sunday, UTC)
+* Check if timestamp falls on a weekend (Saturday or Sunday, local timezone)
 * Returns 1 if true, 0 if false
 */
 declare const IS_WEEKEND: (timestamp: number) => number;
 /**
-* Check if timestamp is in a leap year (UTC)
+* Check if timestamp is in a leap year (local timezone)
 * Returns 1 if true, 0 if false
 */
 declare const IS_LEAP_YEAR: (timestamp: number) => number;
 /**
-* Get the start of quarter for a given timestamp (UTC)
+* Get the start of quarter for a given timestamp (local timezone)
 */
 declare const START_OF_QUARTER: (timestamp: number) => number;
 /**

package/dist/index.js

@@ -449,45 +449,52 @@ __export(exports_date_utils, {
   ADD_DAYS: () => ADD_DAYS
 });
 var NOW = () => Date.now();
-var DATE = (year, month = 1, day = 1, hour = 0, minute = 0, second = 0) => Date.UTC(year, month - 1, day, hour, minute, second);
+var DATE = (year, month = 1, day = 1, hour = 0, minute = 0, second = 0) => new Date(year, month - 1, day, hour, minute, second).getTime();
 var FROM_DAYS = (d) => d * 24 * 60 * 60 * 1000;
 var FROM_WEEKS = (w) => w * 7 * 24 * 60 * 60 * 1000;
 var FROM_MONTHS = (months) => months * 30 * 24 * 60 * 60 * 1000;
 var FROM_YEARS = (years) => years * 365 * 24 * 60 * 60 * 1000;
-var GET_YEAR = (timestamp) => new Date(timestamp).getUTCFullYear();
-var GET_MONTH = (timestamp) => new Date(timestamp).getUTCMonth() + 1;
-var GET_DAY = (timestamp) => new Date(timestamp).getUTCDate();
-var GET_HOUR = (timestamp) => new Date(timestamp).getUTCHours();
-var GET_MINUTE = (timestamp) => new Date(timestamp).getUTCMinutes();
-var GET_SECOND = (timestamp) => new Date(timestamp).getUTCSeconds();
-var GET_MILLISECOND = (timestamp) => new Date(timestamp).getUTCMilliseconds();
-var GET_WEEKDAY = (timestamp) => new Date(timestamp).getUTCDay();
+var GET_YEAR = (timestamp) => new Date(timestamp).getFullYear();
+var GET_MONTH = (timestamp) => new Date(timestamp).getMonth() + 1;
+var GET_DAY = (timestamp) => new Date(timestamp).getDate();
+var GET_HOUR = (timestamp) => new Date(timestamp).getHours();
+var GET_MINUTE = (timestamp) => new Date(timestamp).getMinutes();
+var GET_SECOND = (timestamp) => new Date(timestamp).getSeconds();
+var GET_MILLISECOND = (timestamp) => new Date(timestamp).getMilliseconds();
+var GET_WEEKDAY = (timestamp) => new Date(timestamp).getDay();
 var GET_DAY_OF_YEAR = (timestamp) => {
   const date = new Date(timestamp);
-  const year = date.getUTCFullYear();
-  const startOfYear = Date.UTC(year, 0, 1);
+  const year = date.getFullYear();
+  const startOfYear = new Date(year, 0, 1).getTime();
   const diff = timestamp - startOfYear;
   const oneDay = 86400000;
   return Math.floor(diff / oneDay) + 1;
 };
 var GET_QUARTER = (timestamp) => {
-  const month = new Date(timestamp).getUTCMonth();
+  const month = new Date(timestamp).getMonth();
   return Math.floor(month / 3) + 1;
 };
-var DIFFERENCE_IN_SECONDS = (ts1, ts2) => Math.floor(Math.abs(ts1 - ts2) / 1000);
-var DIFFERENCE_IN_MINUTES = (ts1, ts2) => Math.floor(Math.abs(ts1 - ts2) / (60 * 1000));
-var DIFFERENCE_IN_HOURS = (ts1, ts2) => Math.floor(Math.abs(ts1 - ts2) / (60 * 60 * 1000));
-var DIFFERENCE_IN_DAYS = (ts1, ts2) => Math.floor(Math.abs(ts1 - ts2) / (24 * 60 * 60 * 1000));
-var DIFFERENCE_IN_WEEKS = (ts1, ts2) => Math.floor(Math.abs(ts1 - ts2) / (7 * 24 * 60 * 60 * 1000));
+var DIFFERENCE_IN_SECONDS = (ts1, ts2) => Math.ceil(Math.abs(ts1 - ts2) / 1000);
+var DIFFERENCE_IN_MINUTES = (ts1, ts2) => Math.ceil(Math.abs(ts1 - ts2) / (60 * 1000));
+var DIFFERENCE_IN_HOURS = (ts1, ts2) => Math.ceil(Math.abs(ts1 - ts2) / (60 * 60 * 1000));
+var DIFFERENCE_IN_DAYS = (ts1, ts2) => {
+  const day1 = START_OF_DAY(ts1);
+  const day2 = START_OF_DAY(ts2);
+  return Math.floor(Math.abs(day1 - day2) / (24 * 60 * 60 * 1000));
+};
+var DIFFERENCE_IN_WEEKS = (ts1, ts2) => {
+  const days = DIFFERENCE_IN_DAYS(ts1, ts2);
+  return Math.floor(days / 7);
+};
 var DIFFERENCE_IN_MONTHS = (ts1, ts2) => {
   const smaller = Math.min(ts1, ts2);
   const larger = Math.max(ts1, ts2);
   const date1 = new Date(smaller);
   const date2 = new Date(larger);
-  const yearDiff = date2.getUTCFullYear() - date1.getUTCFullYear();
-  const monthDiff = date2.getUTCMonth() - date1.getUTCMonth();
+  const yearDiff = date2.getFullYear() - date1.getFullYear();
+  const monthDiff = date2.getMonth() - date1.getMonth();
   let months = yearDiff * 12 + monthDiff;
-  if (date2.getUTCDate() < date1.getUTCDate()) {
+  if (date2.getDate() < date1.getDate()) {
     months--;
   }
   return months;
@@ -497,65 +504,65 @@ var DIFFERENCE_IN_YEARS = (ts1, ts2) => {
 };
 var START_OF_DAY = (timestamp) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 0, 0, 0, 0);
+  return new Date(date.getFullYear(), date.getMonth(), date.getDate(), 0, 0, 0, 0).getTime();
 };
 var END_OF_DAY = (timestamp) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate(), 23, 59, 59, 999);
+  return new Date(date.getFullYear(), date.getMonth(), date.getDate(), 23, 59, 59, 999).getTime();
 };
 var START_OF_WEEK = (timestamp) => {
   const date = new Date(timestamp);
-  const dayOfWeek = date.getUTCDay();
-  const currentDay = date.getUTCDate();
+  const dayOfWeek = date.getDay();
+  const currentDay = date.getDate();
   const startDay = currentDay - dayOfWeek;
-  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), startDay, 0, 0, 0, 0);
+  return new Date(date.getFullYear(), date.getMonth(), startDay, 0, 0, 0, 0).getTime();
 };
 var START_OF_MONTH = (timestamp) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), 1, 0, 0, 0, 0);
+  return new Date(date.getFullYear(), date.getMonth(), 1, 0, 0, 0, 0).getTime();
 };
 var END_OF_MONTH = (timestamp) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + 1, 0, 23, 59, 59, 999);
+  return new Date(date.getFullYear(), date.getMonth() + 1, 0, 23, 59, 59, 999).getTime();
 };
 var START_OF_YEAR = (timestamp) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), 0, 1, 0, 0, 0, 0);
+  return new Date(date.getFullYear(), 0, 1, 0, 0, 0, 0).getTime();
 };
 var END_OF_YEAR = (timestamp) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), 11, 31, 23, 59, 59, 999);
+  return new Date(date.getFullYear(), 11, 31, 23, 59, 59, 999).getTime();
 };
 var ADD_DAYS = (timestamp, days) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth(), date.getUTCDate() + days, date.getUTCHours(), date.getUTCMinutes(), date.getUTCSeconds(), date.getUTCMilliseconds());
+  return new Date(date.getFullYear(), date.getMonth(), date.getDate() + days, date.getHours(), date.getMinutes(), date.getSeconds(), date.getMilliseconds()).getTime();
 };
 var ADD_MONTHS = (timestamp, months) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear(), date.getUTCMonth() + months, date.getUTCDate(), date.getUTCHours(), date.getUTCMinutes(), date.getUTCSeconds(), date.getUTCMilliseconds());
+  return new Date(date.getFullYear(), date.getMonth() + months, date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds(), date.getMilliseconds()).getTime();
 };
 var ADD_YEARS = (timestamp, years) => {
   const date = new Date(timestamp);
-  return Date.UTC(date.getUTCFullYear() + years, date.getUTCMonth(), date.getUTCDate(), date.getUTCHours(), date.getUTCMinutes(), date.getUTCSeconds(), date.getUTCMilliseconds());
+  return new Date(date.getFullYear() + years, date.getMonth(), date.getDate(), date.getHours(), date.getMinutes(), date.getSeconds(), date.getMilliseconds()).getTime();
 };
 var IS_SAME_DAY = (ts1, ts2) => {
   const date1 = new Date(ts1);
   const date2 = new Date(ts2);
-  return date1.getUTCFullYear() === date2.getUTCFullYear() && date1.getUTCMonth() === date2.getUTCMonth() && date1.getUTCDate() === date2.getUTCDate() ? 1 : 0;
+  return date1.getFullYear() === date2.getFullYear() && date1.getMonth() === date2.getMonth() && date1.getDate() === date2.getDate() ? 1 : 0;
 };
 var IS_WEEKEND = (timestamp) => {
-  const day = new Date(timestamp).getUTCDay();
+  const day = new Date(timestamp).getDay();
   return day === 0 || day === 6 ? 1 : 0;
 };
 var IS_LEAP_YEAR = (timestamp) => {
-  const year = new Date(timestamp).getUTCFullYear();
+  const year = new Date(timestamp).getFullYear();
   return year % 4 === 0 && year % 100 !== 0 || year % 400 === 0 ? 1 : 0;
 };
 var START_OF_QUARTER = (timestamp) => {
   const date = new Date(timestamp);
-  const month = date.getUTCMonth();
+  const month = date.getMonth();
   const quarterStartMonth = Math.floor(month / 3) * 3;
-  return Date.UTC(date.getUTCFullYear(), quarterStartMonth, 1, 0, 0, 0, 0);
+  return new Date(date.getFullYear(), quarterStartMonth, 1, 0, 0, 0, 0).getTime();
 };
 // src/defaults.ts
 var defaultContext = {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "littlewing",
-	"version": "0.8.0",
+	"version": "0.8.2",
 	"description": "A minimal, high-performance arithmetic expression language with lexer, parser, and executor. Optimized for browsers with zero dependencies and type-safe execution.",
 	"keywords": [
 		"arithmetic",