@f-o-t/datetime 0.1.0 → 0.1.4

package/dist/core/datetime.d.ts

@@ -0,0 +1,341 @@
+import type { DateInput, DateTimePlugin, TimeUnit } from "../types";
+/**
+ * Core DateTime class that wraps the native JavaScript Date object
+ * Provides immutable operations and extensibility through plugins
+ */
+export declare class DateTime {
+    /**
+     * Internal date storage
+     * @private
+     */
+    private readonly _date;
+    /**
+     * Static registry of installed plugins
+     * @private
+     */
+    private static readonly plugins;
+    /**
+     * Creates a new DateTime instance
+     * @param input - Date input (Date, ISO string, timestamp, DateTime, or undefined for current time)
+     * @throws {InvalidDateError} When input fails Zod validation
+     */
+    constructor(input?: DateInput);
+    /**
+     * Type guard to check if value is a DateTime instance
+     * @private
+     */
+    private isDateTimeInstance;
+    /**
+     * Checks if the date is valid
+     * @returns true if the date is valid, false otherwise
+     */
+    isValid(): boolean;
+    /**
+     * Returns the native JavaScript Date object (cloned for immutability)
+     * @returns A clone of the internal Date object
+     */
+    toDate(): Date;
+    /**
+     * Returns ISO 8601 string representation
+     * @returns ISO 8601 formatted string
+     */
+    toISO(): string;
+    /**
+     * Returns the Unix timestamp in milliseconds
+     * @returns Unix timestamp
+     */
+    valueOf(): number;
+    /**
+     * Adds milliseconds to the date
+     * @param amount - Number of milliseconds to add (can be negative)
+     * @returns New DateTime instance with added milliseconds
+     */
+    addMilliseconds(amount: number): DateTime;
+    /**
+     * Adds seconds to the date
+     * @param amount - Number of seconds to add (can be negative)
+     * @returns New DateTime instance with added seconds
+     */
+    addSeconds(amount: number): DateTime;
+    /**
+     * Adds minutes to the date
+     * @param amount - Number of minutes to add (can be negative)
+     * @returns New DateTime instance with added minutes
+     */
+    addMinutes(amount: number): DateTime;
+    /**
+     * Adds hours to the date
+     * @param amount - Number of hours to add (can be negative)
+     * @returns New DateTime instance with added hours
+     */
+    addHours(amount: number): DateTime;
+    /**
+     * Adds days to the date
+     * @param amount - Number of days to add (can be negative)
+     * @returns New DateTime instance with added days
+     */
+    addDays(amount: number): DateTime;
+    /**
+     * Adds weeks to the date
+     * @param amount - Number of weeks to add (can be negative)
+     * @returns New DateTime instance with added weeks
+     */
+    addWeeks(amount: number): DateTime;
+    /**
+     * Adds months to the date
+     * @param amount - Number of months to add (can be negative)
+     * @returns New DateTime instance with added months
+     */
+    addMonths(amount: number): DateTime;
+    /**
+     * Adds years to the date
+     * @param amount - Number of years to add (can be negative)
+     * @returns New DateTime instance with added years
+     */
+    addYears(amount: number): DateTime;
+    /**
+     * Subtracts milliseconds from the date
+     * @param amount - Number of milliseconds to subtract (can be negative)
+     * @returns New DateTime instance with subtracted milliseconds
+     */
+    subtractMilliseconds(amount: number): DateTime;
+    /**
+     * Subtracts seconds from the date
+     * @param amount - Number of seconds to subtract (can be negative)
+     * @returns New DateTime instance with subtracted seconds
+     */
+    subtractSeconds(amount: number): DateTime;
+    /**
+     * Subtracts minutes from the date
+     * @param amount - Number of minutes to subtract (can be negative)
+     * @returns New DateTime instance with subtracted minutes
+     */
+    subtractMinutes(amount: number): DateTime;
+    /**
+     * Subtracts hours from the date
+     * @param amount - Number of hours to subtract (can be negative)
+     * @returns New DateTime instance with subtracted hours
+     */
+    subtractHours(amount: number): DateTime;
+    /**
+     * Subtracts days from the date
+     * @param amount - Number of days to subtract (can be negative)
+     * @returns New DateTime instance with subtracted days
+     */
+    subtractDays(amount: number): DateTime;
+    /**
+     * Subtracts weeks from the date
+     * @param amount - Number of weeks to subtract (can be negative)
+     * @returns New DateTime instance with subtracted weeks
+     */
+    subtractWeeks(amount: number): DateTime;
+    /**
+     * Subtracts months from the date
+     * @param amount - Number of months to subtract (can be negative)
+     * @returns New DateTime instance with subtracted months
+     */
+    subtractMonths(amount: number): DateTime;
+    /**
+     * Subtracts years from the date
+     * @param amount - Number of years to subtract (can be negative)
+     * @returns New DateTime instance with subtracted years
+     */
+    subtractYears(amount: number): DateTime;
+    /**
+     * Checks if this date is before another date
+     * @param other - DateTime instance to compare against
+     * @returns true if this date is before the other date, false otherwise
+     */
+    isBefore(other: DateTime): boolean;
+    /**
+     * Checks if this date is after another date
+     * @param other - DateTime instance to compare against
+     * @returns true if this date is after the other date, false otherwise
+     */
+    isAfter(other: DateTime): boolean;
+    /**
+     * Checks if this date is the same as another date
+     * @param other - DateTime instance to compare against
+     * @returns true if this date is the same as the other date, false otherwise
+     */
+    isSame(other: DateTime): boolean;
+    /**
+     * Checks if this date is the same as or before another date
+     * @param other - DateTime instance to compare against
+     * @returns true if this date is the same as or before the other date, false otherwise
+     */
+    isSameOrBefore(other: DateTime): boolean;
+    /**
+     * Checks if this date is the same as or after another date
+     * @param other - DateTime instance to compare against
+     * @returns true if this date is the same as or after the other date, false otherwise
+     */
+    isSameOrAfter(other: DateTime): boolean;
+    /**
+     * Checks if this date is between two dates
+     * @param start - Start date of the range
+     * @param end - End date of the range
+     * @param inclusive - Whether to include the start and end dates in the comparison (default: false)
+     * @returns true if this date is between start and end, false otherwise
+     */
+    isBetween(start: DateTime, end: DateTime, inclusive?: boolean): boolean;
+    /**
+     * Gets the UTC year
+     * @returns The year (e.g., 2024)
+     */
+    year(): number;
+    /**
+     * Gets the UTC month (0-indexed)
+     * @returns The month (0-11, where 0=January)
+     */
+    month(): number;
+    /**
+     * Gets the UTC day of the month
+     * @returns The day of month (1-31)
+     */
+    date(): number;
+    /**
+     * Gets the UTC day of the week (0-indexed)
+     * @returns The day of week (0-6, where 0=Sunday)
+     */
+    day(): number;
+    /**
+     * Gets the UTC hour
+     * @returns The hour (0-23)
+     */
+    hour(): number;
+    /**
+     * Gets the UTC minute
+     * @returns The minute (0-59)
+     */
+    minute(): number;
+    /**
+     * Gets the UTC second
+     * @returns The second (0-59)
+     */
+    second(): number;
+    /**
+     * Gets the UTC millisecond
+     * @returns The millisecond (0-999)
+     */
+    millisecond(): number;
+    /**
+     * Sets the UTC year
+     * @param year - The year to set
+     * @returns New DateTime instance with updated year
+     */
+    setYear(year: number): DateTime;
+    /**
+     * Sets the UTC month (0-indexed)
+     * @param month - The month to set (0-11, where 0=January)
+     * @returns New DateTime instance with updated month
+     */
+    setMonth(month: number): DateTime;
+    /**
+     * Sets the UTC day of the month
+     * @param date - The day to set (1-31)
+     * @returns New DateTime instance with updated date
+     */
+    setDate(date: number): DateTime;
+    /**
+     * Sets the UTC hour
+     * @param hour - The hour to set (0-23)
+     * @returns New DateTime instance with updated hour
+     */
+    setHour(hour: number): DateTime;
+    /**
+     * Sets the UTC minute
+     * @param minute - The minute to set (0-59)
+     * @returns New DateTime instance with updated minute
+     */
+    setMinute(minute: number): DateTime;
+    /**
+     * Sets the UTC second
+     * @param second - The second to set (0-59)
+     * @returns New DateTime instance with updated second
+     */
+    setSecond(second: number): DateTime;
+    /**
+     * Sets the UTC millisecond
+     * @param millisecond - The millisecond to set (0-999)
+     * @returns New DateTime instance with updated millisecond
+     */
+    setMillisecond(millisecond: number): DateTime;
+    /**
+     * Returns a new DateTime at the start of the day (00:00:00.000)
+     * @returns New DateTime instance at start of day
+     */
+    startOfDay(): DateTime;
+    /**
+     * Returns a new DateTime at the end of the day (23:59:59.999)
+     * @returns New DateTime instance at end of day
+     */
+    endOfDay(): DateTime;
+    /**
+     * Returns a new DateTime at the start of the hour (XX:00:00.000)
+     * @returns New DateTime instance at start of hour
+     */
+    startOfHour(): DateTime;
+    /**
+     * Returns a new DateTime at the end of the hour (XX:59:59.999)
+     * @returns New DateTime instance at end of hour
+     */
+    endOfHour(): DateTime;
+    /**
+     * Returns a new DateTime at the start of the week (Sunday 00:00:00.000)
+     * @returns New DateTime instance at start of week
+     */
+    startOfWeek(): DateTime;
+    /**
+     * Returns a new DateTime at the end of the week (Saturday 23:59:59.999)
+     * @returns New DateTime instance at end of week
+     */
+    endOfWeek(): DateTime;
+    /**
+     * Returns a new DateTime at the start of the month (day 1, 00:00:00.000)
+     * @returns New DateTime instance at start of month
+     */
+    startOfMonth(): DateTime;
+    /**
+     * Returns a new DateTime at the end of the month (last day, 23:59:59.999)
+     * @returns New DateTime instance at end of month
+     */
+    endOfMonth(): DateTime;
+    /**
+     * Returns a new DateTime at the start of the year (Jan 1, 00:00:00.000)
+     * @returns New DateTime instance at start of year
+     */
+    startOfYear(): DateTime;
+    /**
+     * Returns a new DateTime at the end of the year (Dec 31, 23:59:59.999)
+     * @returns New DateTime instance at end of year
+     */
+    endOfYear(): DateTime;
+    /**
+     * Calculates the difference between this date and another date
+     * @param other - DateTime instance to compare against
+     * @param unit - Unit of measurement (default: 'millisecond')
+     * @returns The difference (can be negative)
+     */
+    diff(other: DateTime, unit?: TimeUnit): number;
+    /**
+     * Registers a plugin to extend DateTime functionality
+     * @param plugin - The plugin to register
+     * @param options - Optional plugin configuration
+     * @throws {PluginError} When plugin with same name already exists
+     */
+    static extend(plugin: DateTimePlugin, options?: Record<string, unknown>): void;
+    /**
+     * Checks if a plugin is registered
+     * @param name - Plugin name
+     * @returns true if plugin is registered, false otherwise
+     */
+    static hasPlugin(name: string): boolean;
+    /**
+     * Gets a registered plugin
+     * @param name - Plugin name
+     * @returns The plugin if found, undefined otherwise
+     */
+    static getPlugin(name: string): DateTimePlugin | undefined;
+}
+//# sourceMappingURL=datetime.d.ts.map

package/dist/core/datetime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"datetime.d.ts","sourceRoot":"","sources":["../../src/core/datetime.ts"],"names":[],"mappings":"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"}

package/{src/core/factory.ts → dist/core/factory.d.ts}

@@ -1,6 +1,5 @@
 import type { DateInput } from "../types.ts";
 import { DateTime } from "./datetime.ts";
-
 /**
  * Factory function to create a DateTime instance
  * Provides a convenient alternative to using the constructor
@@ -27,6 +26,5 @@ import { DateTime } from "./datetime.ts";
  * const dt4 = datetime(dt1);
  * ```
  */
-export function datetime(input?: DateInput): DateTime {
-   return new DateTime(input);
-}
+export declare function datetime(input?: DateInput): DateTime;
+//# sourceMappingURL=factory.d.ts.map

package/dist/core/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/core/factory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAEzC;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,QAAQ,CAAC,KAAK,CAAC,EAAE,SAAS,GAAG,QAAQ,CAEpD"}

package/dist/errors.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Base error class for all DateTime-related errors
+ */
+export declare class DateTimeError extends Error {
+    constructor(message: string);
+}
+/**
+ * Error thrown when an invalid date is provided
+ */
+export declare class InvalidDateError extends DateTimeError {
+    readonly input?: unknown | undefined;
+    constructor(message?: string, input?: unknown | undefined);
+}
+/**
+ * Error thrown when a date string doesn't match the expected format
+ */
+export declare class InvalidFormatError extends DateTimeError {
+    readonly input?: string | undefined;
+    readonly expectedFormat?: string | undefined;
+    constructor(message: string, input?: string | undefined, expectedFormat?: string | undefined);
+}
+/**
+ * Error thrown when an invalid timezone is specified
+ */
+export declare class InvalidTimezoneError extends DateTimeError {
+    readonly timezone?: string | undefined;
+    constructor(message: string, timezone?: string | undefined);
+}
+/**
+ * Error thrown when a plugin operation fails
+ */
+export declare class PluginError extends DateTimeError {
+    readonly pluginName?: string | undefined;
+    constructor(message: string, pluginName?: string | undefined);
+}
+/**
+ * Error thrown when attempting to use functionality that requires a plugin that isn't installed
+ */
+export declare class MissingPluginError extends PluginError {
+    readonly requiredPlugin: string;
+    constructor(requiredPlugin: string, message?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,aAAc,SAAQ,KAAK;gBACzB,OAAO,EAAE,MAAM;CAQ7B;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,aAAa;aAG7B,KAAK,CAAC,EAAE,OAAO;gBAD/B,OAAO,SAAiB,EACR,KAAK,CAAC,EAAE,OAAO,YAAA;CAKpC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;aAG/B,KAAK,CAAC,EAAE,MAAM;aACd,cAAc,CAAC,EAAE,MAAM;gBAFvC,OAAO,EAAE,MAAM,EACC,KAAK,CAAC,EAAE,MAAM,YAAA,EACd,cAAc,CAAC,EAAE,MAAM,YAAA;CAK5C;AAED;;GAEG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;aAGjC,QAAQ,CAAC,EAAE,MAAM;gBADjC,OAAO,EAAE,MAAM,EACC,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKtC;AAED;;GAEG;AACH,qBAAa,WAAY,SAAQ,aAAa;aAGxB,UAAU,CAAC,EAAE,MAAM;gBADnC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA;CAKxC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;aAE7B,cAAc,EAAE,MAAM;gBAAtB,cAAc,EAAE,MAAM,EACtC,OAAO,CAAC,EAAE,MAAM;CAQrB"}

package/dist/index-77f5wgyc.js

@@ -0,0 +1,41 @@
+// @bun
+// src/plugins/plugin-base.ts
+function createPlugin(name, install) {
+  if (!name || typeof name !== "string") {
+    throw new Error("Plugin name must be a non-empty string");
+  }
+  if (typeof install !== "function") {
+    throw new Error("Plugin install must be a function");
+  }
+  return {
+    name,
+    install
+  };
+}
+function isPlugin(obj) {
+  if (!obj || typeof obj !== "object") {
+    return false;
+  }
+  const plugin = obj;
+  return typeof plugin.name === "string" && plugin.name.length > 0 && typeof plugin.install === "function";
+}
+function isValidPluginName(name) {
+  if (!name || typeof name !== "string") {
+    return false;
+  }
+  const validNamePattern = /^[a-zA-Z0-9-_]+$/;
+  if (!validNamePattern.test(name)) {
+    return false;
+  }
+  if (name.length < 2) {
+    return false;
+  }
+  if (/^[-_]|[-_]$/.test(name)) {
+    return false;
+  }
+  return true;
+}
+
+export { createPlugin, isPlugin, isValidPluginName };
+
+//# debugId=B3B751489D65C8A464756E2164756E21

package/dist/index-77f5wgyc.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/plugins/plugin-base.ts"],
+  "sourcesContent": [
+    "import type { DateTimeClass, DateTimePlugin } from \"../types.ts\";\n\n/**\n * Helper function to create a DateTime plugin\n *\n * @param name - Unique plugin name\n * @param install - Installation function that extends the DateTime class\n * @returns A DateTimePlugin object\n *\n * @example\n * ```ts\n * const myPlugin = createPlugin(\"myPlugin\", (DateTimeClass, options) => {\n *   // Extend DateTime prototype\n *   DateTimeClass.prototype.myMethod = function() {\n *     return this.valueOf();\n *   };\n *\n *   // Add static methods\n *   DateTimeClass.myStaticMethod = function() {\n *     return new DateTimeClass();\n *   };\n * });\n *\n * // Register the plugin\n * DateTime.extend(myPlugin);\n * ```\n */\nexport function createPlugin(\n   name: string,\n   install: (\n      DateTimeClass: DateTimeClass,\n      options?: Record<string, unknown>,\n   ) => void,\n): DateTimePlugin {\n   if (!name || typeof name !== \"string\") {\n      throw new Error(\"Plugin name must be a non-empty string\");\n   }\n\n   if (typeof install !== \"function\") {\n      throw new Error(\"Plugin install must be a function\");\n   }\n\n   return {\n      name,\n      install,\n   };\n}\n\n/**\n * Type guard to check if an object is a valid DateTimePlugin\n *\n * @param obj - Object to check\n * @returns true if object is a valid DateTimePlugin\n */\nexport function isPlugin(obj: unknown): obj is DateTimePlugin {\n   if (!obj || typeof obj !== \"object\") {\n      return false;\n   }\n\n   const plugin = obj as Partial<DateTimePlugin>;\n\n   return (\n      typeof plugin.name === \"string\" &&\n      plugin.name.length > 0 &&\n      typeof plugin.install === \"function\"\n   );\n}\n\n/**\n * Validates that a plugin name follows naming conventions\n *\n * @param name - Plugin name to validate\n * @returns true if name is valid, false otherwise\n *\n * @remarks\n * Valid plugin names:\n * - Must be a non-empty string\n * - Should use kebab-case or camelCase\n * - Should not contain spaces or special characters (except hyphens)\n * - Should be descriptive and unique\n */\nexport function isValidPluginName(name: string): boolean {\n   if (!name || typeof name !== \"string\") {\n      return false;\n   }\n\n   // Check for valid characters (alphanumeric, hyphens, underscores)\n   const validNamePattern = /^[a-zA-Z0-9-_]+$/;\n   if (!validNamePattern.test(name)) {\n      return false;\n   }\n\n   // Check minimum length\n   if (name.length < 2) {\n      return false;\n   }\n\n   // Should not start or end with special characters\n   if (/^[-_]|[-_]$/.test(name)) {\n      return false;\n   }\n\n   return true;\n}\n"
+  ],
+  "mappings": ";;AA2BO,SAAS,YAAY,CACzB,MACA,SAIe;AAAA,EACf,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AAAA,IACpC,MAAM,IAAI,MAAM,wCAAwC;AAAA,EAC3D;AAAA,EAEA,IAAI,OAAO,YAAY,YAAY;AAAA,IAChC,MAAM,IAAI,MAAM,mCAAmC;AAAA,EACtD;AAAA,EAEA,OAAO;AAAA,IACJ;AAAA,IACA;AAAA,EACH;AAAA;AASI,SAAS,QAAQ,CAAC,KAAqC;AAAA,EAC3D,IAAI,CAAC,OAAO,OAAO,QAAQ,UAAU;AAAA,IAClC,OAAO;AAAA,EACV;AAAA,EAEA,MAAM,SAAS;AAAA,EAEf,OACG,OAAO,OAAO,SAAS,YACvB,OAAO,KAAK,SAAS,KACrB,OAAO,OAAO,YAAY;AAAA;AAiBzB,SAAS,iBAAiB,CAAC,MAAuB;AAAA,EACtD,IAAI,CAAC,QAAQ,OAAO,SAAS,UAAU;AAAA,IACpC,OAAO;AAAA,EACV;AAAA,EAGA,MAAM,mBAAmB;AAAA,EACzB,IAAI,CAAC,iBAAiB,KAAK,IAAI,GAAG;AAAA,IAC/B,OAAO;AAAA,EACV;AAAA,EAGA,IAAI,KAAK,SAAS,GAAG;AAAA,IAClB,OAAO;AAAA,EACV;AAAA,EAGA,IAAI,cAAc,KAAK,IAAI,GAAG;AAAA,IAC3B,OAAO;AAAA,EACV;AAAA,EAEA,OAAO;AAAA;",
+  "debugId": "B3B751489D65C8A464756E2164756E21",
+  "names": []
+}

package/dist/index-9jdtsp4s.js

@@ -0,0 +1,55 @@
+// @bun
+import {
+  createPlugin
+} from "./index-77f5wgyc.js";
+
+// src/plugins/business-days/index.ts
+function isWeekdayDay(dayOfWeek) {
+  return dayOfWeek >= 1 && dayOfWeek <= 5;
+}
+var businessDaysPlugin = createPlugin("business-days", (DateTimeClass) => {
+  DateTimeClass.prototype.isWeekday = function() {
+    const dayOfWeek = this.day();
+    return isWeekdayDay(dayOfWeek);
+  };
+  DateTimeClass.prototype.isWeekend = function() {
+    const dayOfWeek = this.day();
+    return dayOfWeek === 0 || dayOfWeek === 6;
+  };
+  DateTimeClass.prototype.addBusinessDays = function(n) {
+    if (n === 0) {
+      return this;
+    }
+    let current = new DateTimeClass(this.valueOf());
+    let daysToAdd = Math.abs(n);
+    const direction = n > 0 ? 1 : -1;
+    while (daysToAdd > 0) {
+      current = current.addDays(direction);
+      if (current.isWeekday()) {
+        daysToAdd--;
+      }
+    }
+    return current;
+  };
+  DateTimeClass.prototype.subtractBusinessDays = function(n) {
+    return this.addBusinessDays(-n);
+  };
+  DateTimeClass.prototype.diffBusinessDays = function(other) {
+    const start = this.valueOf() < other.valueOf() ? this : other;
+    const end = this.valueOf() < other.valueOf() ? other : this;
+    const isReversed = this.valueOf() > other.valueOf();
+    let businessDays = 0;
+    let current = new DateTimeClass(start.valueOf());
+    while (current.startOfDay().valueOf() < end.startOfDay().valueOf()) {
+      if (current.isWeekday()) {
+        businessDays++;
+      }
+      current = current.addDays(1);
+    }
+    return isReversed ? -businessDays : businessDays;
+  };
+});
+
+export { businessDaysPlugin };
+
+//# debugId=E77EEE3251E2711B64756E2164756E21

package/dist/index-9jdtsp4s.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/plugins/business-days/index.ts"],
+  "sourcesContent": [
+    "import type { DateTime } from \"../../core/datetime\";\nimport type { DateTimeClass } from \"../../types\";\nimport { createPlugin } from \"../plugin-base\";\n\n/**\n * Checks if a given day of week is a weekday (Monday-Friday)\n * @param dayOfWeek - Day of week (0=Sunday, 6=Saturday)\n * @returns true if weekday, false otherwise\n */\nfunction isWeekdayDay(dayOfWeek: number): boolean {\n   return dayOfWeek >= 1 && dayOfWeek <= 5;\n}\n\n/**\n * Extended DateTime interface with business days methods\n */\ndeclare module \"../../core/datetime\" {\n   interface DateTime {\n      /**\n       * Checks if this date is a weekday (Monday-Friday)\n       * @returns true if weekday, false otherwise\n       */\n      isWeekday(): boolean;\n\n      /**\n       * Checks if this date is a weekend (Saturday-Sunday)\n       * @returns true if weekend, false otherwise\n       */\n      isWeekend(): boolean;\n\n      /**\n       * Adds business days to this date\n       * Skips weekends (Saturday and Sunday)\n       * @param n - Number of business days to add\n       * @returns New DateTime instance with business days added\n       */\n      addBusinessDays(n: number): DateTime;\n\n      /**\n       * Subtracts business days from this date\n       * Skips weekends (Saturday and Sunday)\n       * @param n - Number of business days to subtract\n       * @returns New DateTime instance with business days subtracted\n       */\n      subtractBusinessDays(n: number): DateTime;\n\n      /**\n       * Calculates the number of business days between this date and another\n       * Excludes weekends from the calculation\n       * @param other - DateTime instance to compare against\n       * @returns Number of business days (positive if other is after, negative if before)\n       */\n      diffBusinessDays(other: DateTime): number;\n   }\n}\n\n/**\n * Business Days plugin for DateTime\n * Adds methods for working with business days (weekdays only)\n * Week is defined as Monday-Friday (weekdays), Saturday-Sunday (weekend)\n */\nexport const businessDaysPlugin = createPlugin(\n   \"business-days\",\n   (DateTimeClass: DateTimeClass) => {\n      // Add instance methods\n      DateTimeClass.prototype.isWeekday = function (): boolean {\n         const dayOfWeek = this.day(); // 0=Sunday, 6=Saturday\n         return isWeekdayDay(dayOfWeek);\n      };\n\n      DateTimeClass.prototype.isWeekend = function (): boolean {\n         const dayOfWeek = this.day();\n         return dayOfWeek === 0 || dayOfWeek === 6;\n      };\n\n      DateTimeClass.prototype.addBusinessDays = function (n: number): DateTime {\n         if (n === 0) {\n            return this;\n         }\n\n         let current = new DateTimeClass(this.valueOf());\n         let daysToAdd = Math.abs(n);\n         const direction = n > 0 ? 1 : -1;\n\n         while (daysToAdd > 0) {\n            // Move one day in the specified direction\n            current = current.addDays(direction);\n\n            // Only count weekdays\n            if ((current as any).isWeekday()) {\n               daysToAdd--;\n            }\n         }\n\n         return current;\n      };\n\n      DateTimeClass.prototype.subtractBusinessDays = function (\n         n: number,\n      ): DateTime {\n         return (this as any).addBusinessDays(-n);\n      };\n\n      DateTimeClass.prototype.diffBusinessDays = function (\n         other: DateTime,\n      ): number {\n         // Get start and end dates (normalized to start of day for consistency)\n         const start = this.valueOf() < other.valueOf() ? this : other;\n         const end = this.valueOf() < other.valueOf() ? other : this;\n         const isReversed = this.valueOf() > other.valueOf();\n\n         let businessDays = 0;\n         let current = new DateTimeClass(start.valueOf());\n\n         // Iterate through each day and count weekdays\n         while (current.startOfDay().valueOf() < end.startOfDay().valueOf()) {\n            if ((current as any).isWeekday()) {\n               businessDays++;\n            }\n            current = current.addDays(1);\n         }\n\n         return isReversed ? -businessDays : businessDays;\n      };\n   },\n);\n"
+  ],
+  "mappings": ";;;;;;AASA,SAAS,YAAY,CAAC,WAA4B;AAAA,EAC/C,OAAO,aAAa,KAAK,aAAa;AAAA;AAmDlC,IAAM,qBAAqB,aAC/B,iBACA,CAAC,kBAAiC;AAAA,EAE/B,cAAc,UAAU,YAAY,QAAS,GAAY;AAAA,IACtD,MAAM,YAAY,KAAK,IAAI;AAAA,IAC3B,OAAO,aAAa,SAAS;AAAA;AAAA,EAGhC,cAAc,UAAU,YAAY,QAAS,GAAY;AAAA,IACtD,MAAM,YAAY,KAAK,IAAI;AAAA,IAC3B,OAAO,cAAc,KAAK,cAAc;AAAA;AAAA,EAG3C,cAAc,UAAU,kBAAkB,QAAS,CAAC,GAAqB;AAAA,IACtE,IAAI,MAAM,GAAG;AAAA,MACV,OAAO;AAAA,IACV;AAAA,IAEA,IAAI,UAAU,IAAI,cAAc,KAAK,QAAQ,CAAC;AAAA,IAC9C,IAAI,YAAY,KAAK,IAAI,CAAC;AAAA,IAC1B,MAAM,YAAY,IAAI,IAAI,IAAI;AAAA,IAE9B,OAAO,YAAY,GAAG;AAAA,MAEnB,UAAU,QAAQ,QAAQ,SAAS;AAAA,MAGnC,IAAK,QAAgB,UAAU,GAAG;AAAA,QAC/B;AAAA,MACH;AAAA,IACH;AAAA,IAEA,OAAO;AAAA;AAAA,EAGV,cAAc,UAAU,uBAAuB,QAAS,CACrD,GACS;AAAA,IACT,OAAQ,KAAa,gBAAgB,CAAC,CAAC;AAAA;AAAA,EAG1C,cAAc,UAAU,mBAAmB,QAAS,CACjD,OACO;AAAA,IAEP,MAAM,QAAQ,KAAK,QAAQ,IAAI,MAAM,QAAQ,IAAI,OAAO;AAAA,IACxD,MAAM,MAAM,KAAK,QAAQ,IAAI,MAAM,QAAQ,IAAI,QAAQ;AAAA,IACvD,MAAM,aAAa,KAAK,QAAQ,IAAI,MAAM,QAAQ;AAAA,IAElD,IAAI,eAAe;AAAA,IACnB,IAAI,UAAU,IAAI,cAAc,MAAM,QAAQ,CAAC;AAAA,IAG/C,OAAO,QAAQ,WAAW,EAAE,QAAQ,IAAI,IAAI,WAAW,EAAE,QAAQ,GAAG;AAAA,MACjE,IAAK,QAAgB,UAAU,GAAG;AAAA,QAC/B;AAAA,MACH;AAAA,MACA,UAAU,QAAQ,QAAQ,CAAC;AAAA,IAC9B;AAAA,IAEA,OAAO,aAAa,CAAC,eAAe;AAAA;AAAA,CAG7C;",
+  "debugId": "E77EEE3251E2711B64756E2164756E21",
+  "names": []
+}

package/dist/index-a78jd9k6.js

@@ -0,0 +1,64 @@
+// @bun
+import {
+  createPlugin
+} from "./index-77f5wgyc.js";
+
+// src/plugins/timezone/index.ts
+function isValidTimezone(timezone) {
+  if (!timezone || typeof timezone !== "string") {
+    return false;
+  }
+  try {
+    new Intl.DateTimeFormat("en-US", { timeZone: timezone });
+    return true;
+  } catch {
+    return false;
+  }
+}
+function getLocalTimezone() {
+  return Intl.DateTimeFormat().resolvedOptions().timeZone;
+}
+var timezonePlugin = createPlugin("timezone", (DateTimeClass) => {
+  DateTimeClass.prototype.tz = function(timezone) {
+    if (!isValidTimezone(timezone)) {
+      throw new Error(`Invalid timezone: ${timezone}`);
+    }
+    const newInstance = new DateTimeClass(this.valueOf());
+    newInstance._timezone = timezone;
+    return newInstance;
+  };
+  DateTimeClass.prototype.toTimezone = function(timezone) {
+    if (!isValidTimezone(timezone)) {
+      throw new Error(`Invalid timezone: ${timezone}`);
+    }
+    const newInstance = new DateTimeClass(this.valueOf());
+    newInstance._timezone = timezone;
+    return newInstance;
+  };
+  DateTimeClass.prototype.utc = function() {
+    const newInstance = new DateTimeClass(this.valueOf());
+    newInstance._timezone = "UTC";
+    return newInstance;
+  };
+  DateTimeClass.prototype.local = function() {
+    const localTz = getLocalTimezone();
+    const newInstance = new DateTimeClass(this.valueOf());
+    newInstance._timezone = localTz;
+    return newInstance;
+  };
+  DateTimeClass.prototype.getTimezone = function() {
+    return this._timezone || "UTC";
+  };
+  DateTimeClass.tz = (input, timezone) => {
+    if (!isValidTimezone(timezone)) {
+      throw new Error(`Invalid timezone: ${timezone}`);
+    }
+    const instance = new DateTimeClass(input);
+    instance._timezone = timezone;
+    return instance;
+  };
+});
+
+export { timezonePlugin };
+
+//# debugId=ED6E64E60878500964756E2164756E21

package/dist/index-a78jd9k6.js.map

@@ -0,0 +1,10 @@
+{
+  "version": 3,
+  "sources": ["../src/plugins/timezone/index.ts"],
+  "sourcesContent": [
+    "import type { DateTime } from \"../../core/datetime\";\nimport type { DateTimeClass } from \"../../types\";\nimport { createPlugin } from \"../plugin-base\";\n\n/**\n * Validates a timezone string using Intl.DateTimeFormat\n * @param timezone - IANA timezone string to validate\n * @returns true if valid, false otherwise\n */\nfunction isValidTimezone(timezone: string): boolean {\n   if (!timezone || typeof timezone !== \"string\") {\n      return false;\n   }\n\n   try {\n      // Use Intl.DateTimeFormat to validate timezone\n      new Intl.DateTimeFormat(\"en-US\", { timeZone: timezone });\n      return true;\n   } catch {\n      return false;\n   }\n}\n\n/**\n * Gets the system's local timezone\n * @returns IANA timezone string for local timezone\n */\nfunction getLocalTimezone(): string {\n   return Intl.DateTimeFormat().resolvedOptions().timeZone;\n}\n\n/**\n * Extended DateTime interface with timezone methods\n */\ndeclare module \"../../core/datetime\" {\n   interface DateTime {\n      /**\n       * Sets the timezone for this DateTime instance\n       * @param timezone - IANA timezone string (e.g., \"America/New_York\")\n       * @returns New DateTime instance with timezone set\n       */\n      tz(timezone: string): DateTime;\n\n      /**\n       * Converts this DateTime to a different timezone\n       * @param timezone - IANA timezone string\n       * @returns New DateTime instance in the specified timezone\n       */\n      toTimezone(timezone: string): DateTime;\n\n      /**\n       * Converts this DateTime to UTC timezone\n       * @returns New DateTime instance in UTC\n       */\n      utc(): DateTime;\n\n      /**\n       * Converts this DateTime to local system timezone\n       * @returns New DateTime instance in local timezone\n       */\n      local(): DateTime;\n\n      /**\n       * Gets the current timezone of this DateTime instance\n       * @returns IANA timezone string\n       */\n      getTimezone(): string;\n\n      /**\n       * Internal timezone storage\n       * @private\n       */\n      _timezone?: string;\n   }\n}\n\n/**\n * Extended DateTimeClass interface with static timezone method\n */\ndeclare module \"../../types\" {\n   interface DateTimeClass {\n      /**\n       * Creates a DateTime instance in a specific timezone\n       * @param input - Date input\n       * @param timezone - IANA timezone string\n       * @returns DateTime instance in the specified timezone\n       */\n      tz(input: any, timezone: string): DateTime;\n   }\n}\n\n/**\n * Timezone plugin for DateTime\n * Adds timezone support using IANA timezone strings\n */\nexport const timezonePlugin = createPlugin(\n   \"timezone\",\n   (DateTimeClass: DateTimeClass) => {\n      // Add instance methods\n      DateTimeClass.prototype.tz = function (timezone: string): DateTime {\n         if (!isValidTimezone(timezone)) {\n            throw new Error(`Invalid timezone: ${timezone}`);\n         }\n\n         // Create new instance with same timestamp but different timezone\n         const newInstance = new DateTimeClass(this.valueOf());\n         (newInstance as any)._timezone = timezone;\n         return newInstance;\n      };\n\n      DateTimeClass.prototype.toTimezone = function (\n         timezone: string,\n      ): DateTime {\n         if (!isValidTimezone(timezone)) {\n            throw new Error(`Invalid timezone: ${timezone}`);\n         }\n\n         // Convert to the new timezone (same as tz for now, as we preserve moment in time)\n         const newInstance = new DateTimeClass(this.valueOf());\n         (newInstance as any)._timezone = timezone;\n         return newInstance;\n      };\n\n      DateTimeClass.prototype.utc = function (): DateTime {\n         const newInstance = new DateTimeClass(this.valueOf());\n         (newInstance as any)._timezone = \"UTC\";\n         return newInstance;\n      };\n\n      DateTimeClass.prototype.local = function (): DateTime {\n         const localTz = getLocalTimezone();\n         const newInstance = new DateTimeClass(this.valueOf());\n         (newInstance as any)._timezone = localTz;\n         return newInstance;\n      };\n\n      DateTimeClass.prototype.getTimezone = function (): string {\n         return (this as any)._timezone || \"UTC\";\n      };\n\n      // Add static method\n      (DateTimeClass as any).tz = (input: any, timezone: string): DateTime => {\n         if (!isValidTimezone(timezone)) {\n            throw new Error(`Invalid timezone: ${timezone}`);\n         }\n\n         const instance = new DateTimeClass(input);\n         (instance as any)._timezone = timezone;\n         return instance;\n      };\n   },\n);\n"
+  ],
+  "mappings": ";;;;;;AASA,SAAS,eAAe,CAAC,UAA2B;AAAA,EACjD,IAAI,CAAC,YAAY,OAAO,aAAa,UAAU;AAAA,IAC5C,OAAO;AAAA,EACV;AAAA,EAEA,IAAI;AAAA,IAED,IAAI,KAAK,eAAe,SAAS,EAAE,UAAU,SAAS,CAAC;AAAA,IACvD,OAAO;AAAA,IACR,MAAM;AAAA,IACL,OAAO;AAAA;AAAA;AAQb,SAAS,gBAAgB,GAAW;AAAA,EACjC,OAAO,KAAK,eAAe,EAAE,gBAAgB,EAAE;AAAA;AAmE3C,IAAM,iBAAiB,aAC3B,YACA,CAAC,kBAAiC;AAAA,EAE/B,cAAc,UAAU,KAAK,QAAS,CAAC,UAA4B;AAAA,IAChE,IAAI,CAAC,gBAAgB,QAAQ,GAAG;AAAA,MAC7B,MAAM,IAAI,MAAM,qBAAqB,UAAU;AAAA,IAClD;AAAA,IAGA,MAAM,cAAc,IAAI,cAAc,KAAK,QAAQ,CAAC;AAAA,IACnD,YAAoB,YAAY;AAAA,IACjC,OAAO;AAAA;AAAA,EAGV,cAAc,UAAU,aAAa,QAAS,CAC3C,UACS;AAAA,IACT,IAAI,CAAC,gBAAgB,QAAQ,GAAG;AAAA,MAC7B,MAAM,IAAI,MAAM,qBAAqB,UAAU;AAAA,IAClD;AAAA,IAGA,MAAM,cAAc,IAAI,cAAc,KAAK,QAAQ,CAAC;AAAA,IACnD,YAAoB,YAAY;AAAA,IACjC,OAAO;AAAA;AAAA,EAGV,cAAc,UAAU,MAAM,QAAS,GAAa;AAAA,IACjD,MAAM,cAAc,IAAI,cAAc,KAAK,QAAQ,CAAC;AAAA,IACnD,YAAoB,YAAY;AAAA,IACjC,OAAO;AAAA;AAAA,EAGV,cAAc,UAAU,QAAQ,QAAS,GAAa;AAAA,IACnD,MAAM,UAAU,iBAAiB;AAAA,IACjC,MAAM,cAAc,IAAI,cAAc,KAAK,QAAQ,CAAC;AAAA,IACnD,YAAoB,YAAY;AAAA,IACjC,OAAO;AAAA;AAAA,EAGV,cAAc,UAAU,cAAc,QAAS,GAAW;AAAA,IACvD,OAAQ,KAAa,aAAa;AAAA;AAAA,EAIpC,cAAsB,KAAK,CAAC,OAAY,aAA+B;AAAA,IACrE,IAAI,CAAC,gBAAgB,QAAQ,GAAG;AAAA,MAC7B,MAAM,IAAI,MAAM,qBAAqB,UAAU;AAAA,IAClD;AAAA,IAEA,MAAM,WAAW,IAAI,cAAc,KAAK;AAAA,IACvC,SAAiB,YAAY;AAAA,IAC9B,OAAO;AAAA;AAAA,CAGhB;",
+  "debugId": "ED6E64E60878500964756E2164756E21",
+  "names": []
+}