@f-o-t/datetime 0.1.0 → 0.1.4

package/dist/index.js.map

@@ -0,0 +1,13 @@
+{
+  "version": 3,
+  "sources": ["../src/errors.ts", "../src/schemas.ts", "../src/core/datetime.ts", "../src/core/factory.ts"],
+  "sourcesContent": [
+    "/**\n * Base error class for all DateTime-related errors\n */\nexport class DateTimeError extends Error {\n   constructor(message: string) {\n      super(message);\n      this.name = \"DateTimeError\";\n      // Maintains proper stack trace for where our error was thrown (only available on V8)\n      if (Error.captureStackTrace) {\n         Error.captureStackTrace(this, this.constructor);\n      }\n   }\n}\n\n/**\n * Error thrown when an invalid date is provided\n */\nexport class InvalidDateError extends DateTimeError {\n   constructor(\n      message = \"Invalid date\",\n      public readonly input?: unknown,\n   ) {\n      super(message);\n      this.name = \"InvalidDateError\";\n   }\n}\n\n/**\n * Error thrown when a date string doesn't match the expected format\n */\nexport class InvalidFormatError extends DateTimeError {\n   constructor(\n      message: string,\n      public readonly input?: string,\n      public readonly expectedFormat?: string,\n   ) {\n      super(message);\n      this.name = \"InvalidFormatError\";\n   }\n}\n\n/**\n * Error thrown when an invalid timezone is specified\n */\nexport class InvalidTimezoneError extends DateTimeError {\n   constructor(\n      message: string,\n      public readonly timezone?: string,\n   ) {\n      super(message);\n      this.name = \"InvalidTimezoneError\";\n   }\n}\n\n/**\n * Error thrown when a plugin operation fails\n */\nexport class PluginError extends DateTimeError {\n   constructor(\n      message: string,\n      public readonly pluginName?: string,\n   ) {\n      super(message);\n      this.name = \"PluginError\";\n   }\n}\n\n/**\n * Error thrown when attempting to use functionality that requires a plugin that isn't installed\n */\nexport class MissingPluginError extends PluginError {\n   constructor(\n      public readonly requiredPlugin: string,\n      message?: string,\n   ) {\n      super(\n         message || `Missing required plugin: ${requiredPlugin}`,\n         requiredPlugin,\n      );\n      this.name = \"MissingPluginError\";\n   }\n}\n",
+    "import { z } from \"zod\";\nimport type { DateTime } from \"./types\";\n\n/**\n * Schema for time units\n */\nexport const TimeUnitSchema = z.enum([\n   \"millisecond\",\n   \"second\",\n   \"minute\",\n   \"hour\",\n   \"day\",\n   \"week\",\n   \"month\",\n   \"year\",\n]);\n\n/**\n * Schema for DateTime input types\n * Accepts Date, string, number, or DateTime instance\n */\nexport const DateInputSchema = z.union([\n   z.date(),\n   z.string(),\n   z.number(),\n   z.custom<DateTime>(\n      (val) =>\n         val !== null &&\n         typeof val === \"object\" &&\n         \"toDate\" in val &&\n         typeof val.toDate === \"function\",\n      {\n         message: \"Expected DateTime instance\",\n      },\n   ),\n]);\n\n/**\n * Schema for DateTime configuration\n */\nexport const DateTimeConfigSchema = z.object({\n   timezone: z.string().optional(),\n   locale: z.string().optional(),\n   utc: z.boolean().optional(),\n   strict: z.boolean().optional(),\n});\n\n/**\n * Schema for format options\n */\nexport const FormatOptionsSchema = z.object({\n   locale: z.string().optional(),\n   timezone: z.string().optional(),\n});\n\n/**\n * Schema for parse options\n */\nexport const ParseOptionsSchema = z.object({\n   strict: z.boolean().optional(),\n   format: z.string().optional(),\n   timezone: z.string().optional(),\n});\n\n/**\n * Schema for ISO 8601 date strings (full datetime with timezone)\n * Matches: YYYY-MM-DDTHH:mm:ss.sssZ or YYYY-MM-DDTHH:mm:ss.sss±HH:mm\n */\nexport const ISODateSchema = z\n   .string()\n   .regex(\n      /^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?(Z|[+-]\\d{2}:\\d{2})$/,\n      {\n         message:\n            \"Invalid ISO 8601 datetime format. Expected: YYYY-MM-DDTHH:mm:ss.sssZ\",\n      },\n   );\n\n/**\n * Schema for ISO 8601 date-only strings\n * Matches: YYYY-MM-DD\n */\nexport const ISODateOnlySchema = z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/, {\n   message: \"Invalid ISO 8601 date format. Expected: YYYY-MM-DD\",\n});\n\n/**\n * Schema for ISO 8601 time-only strings\n * Matches: HH:mm:ss or HH:mm:ss.sss\n */\nexport const ISOTimeOnlySchema = z\n   .string()\n   .regex(/^\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,3})?$/, {\n      message:\n         \"Invalid ISO 8601 time format. Expected: HH:mm:ss or HH:mm:ss.sss\",\n   });\n\n/**\n * Schema for plugin definition\n */\nexport const DateTimePluginSchema = z.object({\n   name: z.string().min(1, \"Plugin name cannot be empty\"),\n   install: z.function(),\n});\n",
+    "import { InvalidDateError, PluginError } from \"../errors\";\nimport { DateInputSchema } from \"../schemas\";\nimport type { DateInput, DateTimePlugin, TimeUnit } from \"../types\";\n\n/**\n * Core DateTime class that wraps the native JavaScript Date object\n * Provides immutable operations and extensibility through plugins\n */\nexport class DateTime {\n   /**\n    * Internal date storage\n    * @private\n    */\n   private readonly _date: Date;\n\n   /**\n    * Static registry of installed plugins\n    * @private\n    */\n   private static readonly plugins: Map<string, DateTimePlugin> = new Map();\n\n   /**\n    * Creates a new DateTime instance\n    * @param input - Date input (Date, ISO string, timestamp, DateTime, or undefined for current time)\n    * @throws {InvalidDateError} When input fails Zod validation\n    */\n   constructor(input?: DateInput) {\n      // If no input provided, use current time\n      if (input === undefined) {\n         this._date = new Date();\n         return;\n      }\n\n      // Special handling for NaN - allow it but create invalid date\n      if (typeof input === \"number\" && Number.isNaN(input)) {\n         this._date = new Date(NaN);\n         return;\n      }\n\n      // Special handling for Invalid Date objects - allow them through\n      if (input instanceof Date && Number.isNaN(input.getTime())) {\n         this._date = new Date(input.getTime());\n         return;\n      }\n\n      // Validate input with Zod schema\n      const validation = DateInputSchema.safeParse(input);\n      if (!validation.success) {\n         throw new InvalidDateError(\n            `Invalid date input: ${validation.error.message}`,\n            input,\n         );\n      }\n\n      // Convert input to Date\n      if (input instanceof Date) {\n         // Clone the date to ensure immutability\n         this._date = new Date(input.getTime());\n      } else if (typeof input === \"string\") {\n         // Parse ISO string or other date string\n         // This may result in an Invalid Date, which is allowed\n         this._date = new Date(input);\n      } else if (typeof input === \"number\") {\n         // Use timestamp\n         this._date = new Date(input);\n      } else if (this.isDateTimeInstance(input)) {\n         // Clone from another DateTime instance\n         this._date = new Date(input.valueOf());\n      } else {\n         // Should never reach here due to Zod validation, but TypeScript needs it\n         throw new InvalidDateError(\"Unsupported date input type\", input);\n      }\n   }\n\n   /**\n    * Type guard to check if value is a DateTime instance\n    * @private\n    */\n   private isDateTimeInstance(val: unknown): val is DateTime {\n      return (\n         val !== null &&\n         typeof val === \"object\" &&\n         \"toDate\" in val &&\n         typeof val.toDate === \"function\"\n      );\n   }\n\n   /**\n    * Checks if the date is valid\n    * @returns true if the date is valid, false otherwise\n    */\n   public isValid(): boolean {\n      return !Number.isNaN(this._date.getTime());\n   }\n\n   /**\n    * Returns the native JavaScript Date object (cloned for immutability)\n    * @returns A clone of the internal Date object\n    */\n   public toDate(): Date {\n      return new Date(this._date.getTime());\n   }\n\n   /**\n    * Returns ISO 8601 string representation\n    * @returns ISO 8601 formatted string\n    */\n   public toISO(): string {\n      return this._date.toISOString();\n   }\n\n   /**\n    * Returns the Unix timestamp in milliseconds\n    * @returns Unix timestamp\n    */\n   public valueOf(): number {\n      return this._date.getTime();\n   }\n\n   // ============================================\n   // Arithmetic Methods\n   // ============================================\n\n   /**\n    * Adds milliseconds to the date\n    * @param amount - Number of milliseconds to add (can be negative)\n    * @returns New DateTime instance with added milliseconds\n    */\n   public addMilliseconds(amount: number): DateTime {\n      return new DateTime(this.valueOf() + amount);\n   }\n\n   /**\n    * Adds seconds to the date\n    * @param amount - Number of seconds to add (can be negative)\n    * @returns New DateTime instance with added seconds\n    */\n   public addSeconds(amount: number): DateTime {\n      return this.addMilliseconds(amount * 1000);\n   }\n\n   /**\n    * Adds minutes to the date\n    * @param amount - Number of minutes to add (can be negative)\n    * @returns New DateTime instance with added minutes\n    */\n   public addMinutes(amount: number): DateTime {\n      return this.addMilliseconds(amount * 60 * 1000);\n   }\n\n   /**\n    * Adds hours to the date\n    * @param amount - Number of hours to add (can be negative)\n    * @returns New DateTime instance with added hours\n    */\n   public addHours(amount: number): DateTime {\n      return this.addMilliseconds(amount * 60 * 60 * 1000);\n   }\n\n   /**\n    * Adds days to the date\n    * @param amount - Number of days to add (can be negative)\n    * @returns New DateTime instance with added days\n    */\n   public addDays(amount: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setDate(newDate.getDate() + amount);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Adds weeks to the date\n    * @param amount - Number of weeks to add (can be negative)\n    * @returns New DateTime instance with added weeks\n    */\n   public addWeeks(amount: number): DateTime {\n      return this.addDays(amount * 7);\n   }\n\n   /**\n    * Adds months to the date\n    * @param amount - Number of months to add (can be negative)\n    * @returns New DateTime instance with added months\n    */\n   public addMonths(amount: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setMonth(newDate.getMonth() + amount);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Adds years to the date\n    * @param amount - Number of years to add (can be negative)\n    * @returns New DateTime instance with added years\n    */\n   public addYears(amount: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setFullYear(newDate.getFullYear() + amount);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Subtracts milliseconds from the date\n    * @param amount - Number of milliseconds to subtract (can be negative)\n    * @returns New DateTime instance with subtracted milliseconds\n    */\n   public subtractMilliseconds(amount: number): DateTime {\n      return this.addMilliseconds(-amount);\n   }\n\n   /**\n    * Subtracts seconds from the date\n    * @param amount - Number of seconds to subtract (can be negative)\n    * @returns New DateTime instance with subtracted seconds\n    */\n   public subtractSeconds(amount: number): DateTime {\n      return this.addSeconds(-amount);\n   }\n\n   /**\n    * Subtracts minutes from the date\n    * @param amount - Number of minutes to subtract (can be negative)\n    * @returns New DateTime instance with subtracted minutes\n    */\n   public subtractMinutes(amount: number): DateTime {\n      return this.addMinutes(-amount);\n   }\n\n   /**\n    * Subtracts hours from the date\n    * @param amount - Number of hours to subtract (can be negative)\n    * @returns New DateTime instance with subtracted hours\n    */\n   public subtractHours(amount: number): DateTime {\n      return this.addHours(-amount);\n   }\n\n   /**\n    * Subtracts days from the date\n    * @param amount - Number of days to subtract (can be negative)\n    * @returns New DateTime instance with subtracted days\n    */\n   public subtractDays(amount: number): DateTime {\n      return this.addDays(-amount);\n   }\n\n   /**\n    * Subtracts weeks from the date\n    * @param amount - Number of weeks to subtract (can be negative)\n    * @returns New DateTime instance with subtracted weeks\n    */\n   public subtractWeeks(amount: number): DateTime {\n      return this.addWeeks(-amount);\n   }\n\n   /**\n    * Subtracts months from the date\n    * @param amount - Number of months to subtract (can be negative)\n    * @returns New DateTime instance with subtracted months\n    */\n   public subtractMonths(amount: number): DateTime {\n      return this.addMonths(-amount);\n   }\n\n   /**\n    * Subtracts years from the date\n    * @param amount - Number of years to subtract (can be negative)\n    * @returns New DateTime instance with subtracted years\n    */\n   public subtractYears(amount: number): DateTime {\n      return this.addYears(-amount);\n   }\n\n   // ============================================\n   // Comparison Methods\n   // ============================================\n\n   /**\n    * Checks if this date is before another date\n    * @param other - DateTime instance to compare against\n    * @returns true if this date is before the other date, false otherwise\n    */\n   public isBefore(other: DateTime): boolean {\n      return this.valueOf() < other.valueOf();\n   }\n\n   /**\n    * Checks if this date is after another date\n    * @param other - DateTime instance to compare against\n    * @returns true if this date is after the other date, false otherwise\n    */\n   public isAfter(other: DateTime): boolean {\n      return this.valueOf() > other.valueOf();\n   }\n\n   /**\n    * Checks if this date is the same as another date\n    * @param other - DateTime instance to compare against\n    * @returns true if this date is the same as the other date, false otherwise\n    */\n   public isSame(other: DateTime): boolean {\n      return this.valueOf() === other.valueOf();\n   }\n\n   /**\n    * Checks if this date is the same as or before another date\n    * @param other - DateTime instance to compare against\n    * @returns true if this date is the same as or before the other date, false otherwise\n    */\n   public isSameOrBefore(other: DateTime): boolean {\n      return this.valueOf() <= other.valueOf();\n   }\n\n   /**\n    * Checks if this date is the same as or after another date\n    * @param other - DateTime instance to compare against\n    * @returns true if this date is the same as or after the other date, false otherwise\n    */\n   public isSameOrAfter(other: DateTime): boolean {\n      return this.valueOf() >= other.valueOf();\n   }\n\n   /**\n    * Checks if this date is between two dates\n    * @param start - Start date of the range\n    * @param end - End date of the range\n    * @param inclusive - Whether to include the start and end dates in the comparison (default: false)\n    * @returns true if this date is between start and end, false otherwise\n    */\n   public isBetween(\n      start: DateTime,\n      end: DateTime,\n      inclusive = false,\n   ): boolean {\n      const thisTime = this.valueOf();\n      const startTime = start.valueOf();\n      const endTime = end.valueOf();\n\n      if (inclusive) {\n         return thisTime >= startTime && thisTime <= endTime;\n      }\n      return thisTime > startTime && thisTime < endTime;\n   }\n\n   // ============================================\n   // Getter Methods\n   // ============================================\n\n   /**\n    * Gets the UTC year\n    * @returns The year (e.g., 2024)\n    */\n   public year(): number {\n      return this._date.getUTCFullYear();\n   }\n\n   /**\n    * Gets the UTC month (0-indexed)\n    * @returns The month (0-11, where 0=January)\n    */\n   public month(): number {\n      return this._date.getUTCMonth();\n   }\n\n   /**\n    * Gets the UTC day of the month\n    * @returns The day of month (1-31)\n    */\n   public date(): number {\n      return this._date.getUTCDate();\n   }\n\n   /**\n    * Gets the UTC day of the week (0-indexed)\n    * @returns The day of week (0-6, where 0=Sunday)\n    */\n   public day(): number {\n      return this._date.getUTCDay();\n   }\n\n   /**\n    * Gets the UTC hour\n    * @returns The hour (0-23)\n    */\n   public hour(): number {\n      return this._date.getUTCHours();\n   }\n\n   /**\n    * Gets the UTC minute\n    * @returns The minute (0-59)\n    */\n   public minute(): number {\n      return this._date.getUTCMinutes();\n   }\n\n   /**\n    * Gets the UTC second\n    * @returns The second (0-59)\n    */\n   public second(): number {\n      return this._date.getUTCSeconds();\n   }\n\n   /**\n    * Gets the UTC millisecond\n    * @returns The millisecond (0-999)\n    */\n   public millisecond(): number {\n      return this._date.getUTCMilliseconds();\n   }\n\n   // ============================================\n   // Setter Methods\n   // ============================================\n\n   /**\n    * Sets the UTC year\n    * @param year - The year to set\n    * @returns New DateTime instance with updated year\n    */\n   public setYear(year: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCFullYear(year);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Sets the UTC month (0-indexed)\n    * @param month - The month to set (0-11, where 0=January)\n    * @returns New DateTime instance with updated month\n    */\n   public setMonth(month: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCMonth(month);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Sets the UTC day of the month\n    * @param date - The day to set (1-31)\n    * @returns New DateTime instance with updated date\n    */\n   public setDate(date: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCDate(date);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Sets the UTC hour\n    * @param hour - The hour to set (0-23)\n    * @returns New DateTime instance with updated hour\n    */\n   public setHour(hour: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCHours(hour);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Sets the UTC minute\n    * @param minute - The minute to set (0-59)\n    * @returns New DateTime instance with updated minute\n    */\n   public setMinute(minute: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCMinutes(minute);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Sets the UTC second\n    * @param second - The second to set (0-59)\n    * @returns New DateTime instance with updated second\n    */\n   public setSecond(second: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCSeconds(second);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Sets the UTC millisecond\n    * @param millisecond - The millisecond to set (0-999)\n    * @returns New DateTime instance with updated millisecond\n    */\n   public setMillisecond(millisecond: number): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCMilliseconds(millisecond);\n      return new DateTime(newDate);\n   }\n\n   // ============================================\n   // Start/End Methods\n   // ============================================\n\n   /**\n    * Returns a new DateTime at the start of the day (00:00:00.000)\n    * @returns New DateTime instance at start of day\n    */\n   public startOfDay(): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCHours(0, 0, 0, 0);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the end of the day (23:59:59.999)\n    * @returns New DateTime instance at end of day\n    */\n   public endOfDay(): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCHours(23, 59, 59, 999);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the start of the hour (XX:00:00.000)\n    * @returns New DateTime instance at start of hour\n    */\n   public startOfHour(): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCMinutes(0, 0, 0);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the end of the hour (XX:59:59.999)\n    * @returns New DateTime instance at end of hour\n    */\n   public endOfHour(): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCMinutes(59, 59, 999);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the start of the week (Sunday 00:00:00.000)\n    * @returns New DateTime instance at start of week\n    */\n   public startOfWeek(): DateTime {\n      const newDate = this.toDate();\n      const day = newDate.getUTCDay();\n      newDate.setUTCDate(newDate.getUTCDate() - day);\n      newDate.setUTCHours(0, 0, 0, 0);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the end of the week (Saturday 23:59:59.999)\n    * @returns New DateTime instance at end of week\n    */\n   public endOfWeek(): DateTime {\n      const newDate = this.toDate();\n      const day = newDate.getUTCDay();\n      newDate.setUTCDate(newDate.getUTCDate() + (6 - day));\n      newDate.setUTCHours(23, 59, 59, 999);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the start of the month (day 1, 00:00:00.000)\n    * @returns New DateTime instance at start of month\n    */\n   public startOfMonth(): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCDate(1);\n      newDate.setUTCHours(0, 0, 0, 0);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the end of the month (last day, 23:59:59.999)\n    * @returns New DateTime instance at end of month\n    */\n   public endOfMonth(): DateTime {\n      const newDate = this.toDate();\n      // Set to next month, day 0 (last day of current month)\n      newDate.setUTCMonth(newDate.getUTCMonth() + 1, 0);\n      newDate.setUTCHours(23, 59, 59, 999);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the start of the year (Jan 1, 00:00:00.000)\n    * @returns New DateTime instance at start of year\n    */\n   public startOfYear(): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCMonth(0, 1);\n      newDate.setUTCHours(0, 0, 0, 0);\n      return new DateTime(newDate);\n   }\n\n   /**\n    * Returns a new DateTime at the end of the year (Dec 31, 23:59:59.999)\n    * @returns New DateTime instance at end of year\n    */\n   public endOfYear(): DateTime {\n      const newDate = this.toDate();\n      newDate.setUTCMonth(11, 31);\n      newDate.setUTCHours(23, 59, 59, 999);\n      return new DateTime(newDate);\n   }\n\n   // ============================================\n   // Difference Method\n   // ============================================\n\n   /**\n    * Calculates the difference between this date and another date\n    * @param other - DateTime instance to compare against\n    * @param unit - Unit of measurement (default: 'millisecond')\n    * @returns The difference (can be negative)\n    */\n   public diff(other: DateTime, unit: TimeUnit = \"millisecond\"): number {\n      const diff = this.valueOf() - other.valueOf();\n\n      switch (unit) {\n         case \"millisecond\":\n            return diff;\n         case \"second\":\n            return diff / 1000;\n         case \"minute\":\n            return diff / (1000 * 60);\n         case \"hour\":\n            return diff / (1000 * 60 * 60);\n         case \"day\":\n            return diff / (1000 * 60 * 60 * 24);\n         case \"week\":\n            return diff / (1000 * 60 * 60 * 24 * 7);\n         case \"month\": {\n            // For months, we calculate based on the actual month difference\n            const thisDate = this.toDate();\n            const otherDate = other.toDate();\n            const yearDiff =\n               thisDate.getUTCFullYear() - otherDate.getUTCFullYear();\n            const monthDiff = thisDate.getUTCMonth() - otherDate.getUTCMonth();\n            return yearDiff * 12 + monthDiff;\n         }\n         case \"year\": {\n            // For years, we calculate based on milliseconds\n            // Average year length accounting for leap years\n            return diff / (1000 * 60 * 60 * 24 * 365.25);\n         }\n         default:\n            return diff;\n      }\n   }\n\n   /**\n    * Registers a plugin to extend DateTime functionality\n    * @param plugin - The plugin to register\n    * @param options - Optional plugin configuration\n    * @throws {PluginError} When plugin with same name already exists\n    */\n   public static extend(\n      plugin: DateTimePlugin,\n      options?: Record<string, unknown>,\n   ): void {\n      // Check if plugin already registered\n      if (DateTime.plugins.has(plugin.name)) {\n         throw new PluginError(\n            `Plugin ${plugin.name} is already registered`,\n            plugin.name,\n         );\n      }\n\n      // Register plugin\n      DateTime.plugins.set(plugin.name, plugin);\n\n      // Call plugin install function\n      plugin.install(DateTime as any, options);\n   }\n\n   /**\n    * Checks if a plugin is registered\n    * @param name - Plugin name\n    * @returns true if plugin is registered, false otherwise\n    */\n   public static hasPlugin(name: string): boolean {\n      return DateTime.plugins.has(name);\n   }\n\n   /**\n    * Gets a registered plugin\n    * @param name - Plugin name\n    * @returns The plugin if found, undefined otherwise\n    */\n   public static getPlugin(name: string): DateTimePlugin | undefined {\n      return DateTime.plugins.get(name);\n   }\n}\n",
+    "import type { DateInput } from \"../types.ts\";\nimport { DateTime } from \"./datetime.ts\";\n\n/**\n * Factory function to create a DateTime instance\n * Provides a convenient alternative to using the constructor\n *\n * @param input - Date input (Date, ISO string, timestamp, DateTime, or undefined for current time)\n * @returns A new DateTime instance\n * @throws {InvalidDateError} When input fails validation\n *\n * @example\n * ```ts\n * // Create with current time\n * const now = datetime();\n *\n * // Create from Date object\n * const dt1 = datetime(new Date());\n *\n * // Create from ISO string\n * const dt2 = datetime(\"2024-01-15T10:30:00Z\");\n *\n * // Create from timestamp\n * const dt3 = datetime(1705315800000);\n *\n * // Create from another DateTime\n * const dt4 = datetime(dt1);\n * ```\n */\nexport function datetime(input?: DateInput): DateTime {\n   return new DateTime(input);\n}\n"
+  ],
+  "mappings": "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",
+  "debugId": "D8EEE46614FED6E064756E2164756E21",
+  "names": []
+}

package/dist/plugins/business-days/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Extended DateTime interface with business days methods
+ */
+declare module "../../core/datetime" {
+    interface DateTime {
+        /**
+         * Checks if this date is a weekday (Monday-Friday)
+         * @returns true if weekday, false otherwise
+         */
+        isWeekday(): boolean;
+        /**
+         * Checks if this date is a weekend (Saturday-Sunday)
+         * @returns true if weekend, false otherwise
+         */
+        isWeekend(): boolean;
+        /**
+         * Adds business days to this date
+         * Skips weekends (Saturday and Sunday)
+         * @param n - Number of business days to add
+         * @returns New DateTime instance with business days added
+         */
+        addBusinessDays(n: number): DateTime;
+        /**
+         * Subtracts business days from this date
+         * Skips weekends (Saturday and Sunday)
+         * @param n - Number of business days to subtract
+         * @returns New DateTime instance with business days subtracted
+         */
+        subtractBusinessDays(n: number): DateTime;
+        /**
+         * Calculates the number of business days between this date and another
+         * Excludes weekends from the calculation
+         * @param other - DateTime instance to compare against
+         * @returns Number of business days (positive if other is after, negative if before)
+         */
+        diffBusinessDays(other: DateTime): number;
+    }
+}
+/**
+ * Business Days plugin for DateTime
+ * Adds methods for working with business days (weekdays only)
+ * Week is defined as Monday-Friday (weekdays), Saturday-Sunday (weekend)
+ */
+export declare const businessDaysPlugin: import("../..").DateTimePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/business-days/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/business-days/index.ts"],"names":[],"mappings":"AAaA;;GAEG;AACH,OAAO,QAAQ,qBAAqB,CAAC;IAClC,UAAU,QAAQ;QACf;;;WAGG;QACH,SAAS,IAAI,OAAO,CAAC;QAErB;;;WAGG;QACH,SAAS,IAAI,OAAO,CAAC;QAErB;;;;;WAKG;QACH,eAAe,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;QAErC;;;;;WAKG;QACH,oBAAoB,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;QAE1C;;;;;WAKG;QACH,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;KAC5C;CACH;AAED;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,gCAgE9B,CAAC"}

package/dist/plugins/business-days/index.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  businessDaysPlugin
+} from "../../index-9jdtsp4s.js";
+import"../../index-77f5wgyc.js";
+export {
+  businessDaysPlugin
+};
+
+//# debugId=86EF91BEC3C0519B64756E2164756E21

package/dist/plugins/business-days/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "86EF91BEC3C0519B64756E2164756E21",
+  "names": []
+}

package/dist/plugins/format/index.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Extended DateTime interface with format method
+ */
+declare module "../../core/datetime" {
+    interface DateTime {
+        /**
+         * Formats the date using a format string
+         * @param formatStr - Format string with tokens (default: ISO format)
+         * @returns Formatted date string
+         *
+         * @example
+         * ```ts
+         * dt.format("YYYY-MM-DD") // "2024-01-15"
+         * dt.format("MM/DD/YYYY") // "01/15/2024"
+         * dt.format("MMMM D, YYYY") // "January 15, 2024"
+         * dt.format("h:mm A") // "2:30 PM"
+         * dt.format("[Year:] YYYY") // "Year: 2024"
+         * ```
+         *
+         * Available tokens:
+         * - YYYY: 4-digit year
+         * - YY: 2-digit year
+         * - MMMM: Full month name
+         * - MMM: Abbreviated month name
+         * - MM: 2-digit month
+         * - M: Month number
+         * - DD: 2-digit day of month
+         * - D: Day of month
+         * - dddd: Full day name
+         * - ddd: Abbreviated day name
+         * - dd: Min day name
+         * - d: Day of week (0-6)
+         * - HH: 2-digit hour (24-hour)
+         * - H: Hour (24-hour)
+         * - hh: 2-digit hour (12-hour)
+         * - h: Hour (12-hour)
+         * - mm: 2-digit minute
+         * - m: Minute
+         * - ss: 2-digit second
+         * - s: Second
+         * - SSS: Millisecond
+         * - A: AM/PM (uppercase)
+         * - a: am/pm (lowercase)
+         * - [text]: Escaped text (literal)
+         */
+        format(formatStr?: string): string;
+    }
+}
+/**
+ * Format plugin for DateTime
+ * Adds format() method for custom date formatting
+ */
+export declare const formatPlugin: import("../..").DateTimePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/format/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/format/index.ts"],"names":[],"mappings":"AAUA;;GAEG;AACH,OAAO,QAAQ,qBAAqB,CAAC;IAClC,UAAU,QAAQ;QACf;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;WAuCG;QACH,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;KACrC;CACH;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,gCAcxB,CAAC"}

package/dist/plugins/format/index.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  formatPlugin
+} from "../../index-v3cytzbp.js";
+import"../../index-77f5wgyc.js";
+export {
+  formatPlugin
+};
+
+//# debugId=300687F91E9B2CF264756E2164756E21

package/dist/plugins/format/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "300687F91E9B2CF264756E2164756E21",
+  "names": []
+}

package/dist/plugins/format/tokens.d.ts

@@ -0,0 +1,20 @@
+import type { DateTime } from "../../core/datetime";
+/**
+ * Format token definitions
+ * Maps token strings to functions that extract the value from a DateTime instance
+ */
+export declare const FORMAT_TOKENS: Record<string, (dt: DateTime) => string>;
+/**
+ * Regular expression to match format tokens
+ * Matches escaped text first, then longest tokens to avoid partial matches
+ * Order is critical: longer tokens must come before shorter ones
+ */
+export declare const TOKEN_REGEX: RegExp;
+/**
+ * Parses a format string and replaces tokens with actual values
+ * @param dt - DateTime instance
+ * @param formatStr - Format string with tokens
+ * @returns Formatted date string
+ */
+export declare function parseFormat(dt: DateTime, formatStr: string): string;
+//# sourceMappingURL=tokens.d.ts.map

package/dist/plugins/format/tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.d.ts","sourceRoot":"","sources":["../../../src/plugins/format/tokens.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAoEpD;;;GAGG;AACH,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,QAAQ,KAAK,MAAM,CAqDlE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,QAC+D,CAAC;AAExF;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAWnE"}

package/{src/plugins/index.ts → dist/plugins/index.d.ts}

@@ -6,10 +6,9 @@
  *
  * @module plugins
  */
-
 export { businessDaysPlugin } from "./business-days/index.ts";
 export { formatPlugin } from "./format/index.ts";
 export { createPlugin, isPlugin, isValidPluginName } from "./plugin-base.ts";
 export { relativeTimePlugin } from "./relative-time/index.ts";
-// Core plugins
 export { timezonePlugin } from "./timezone/index.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugins/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC7E,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/plugins/plugin-base.d.ts

@@ -0,0 +1,49 @@
+import type { DateTimeClass, DateTimePlugin } from "../types.ts";
+/**
+ * Helper function to create a DateTime plugin
+ *
+ * @param name - Unique plugin name
+ * @param install - Installation function that extends the DateTime class
+ * @returns A DateTimePlugin object
+ *
+ * @example
+ * ```ts
+ * const myPlugin = createPlugin("myPlugin", (DateTimeClass, options) => {
+ *   // Extend DateTime prototype
+ *   DateTimeClass.prototype.myMethod = function() {
+ *     return this.valueOf();
+ *   };
+ *
+ *   // Add static methods
+ *   DateTimeClass.myStaticMethod = function() {
+ *     return new DateTimeClass();
+ *   };
+ * });
+ *
+ * // Register the plugin
+ * DateTime.extend(myPlugin);
+ * ```
+ */
+export declare function createPlugin(name: string, install: (DateTimeClass: DateTimeClass, options?: Record<string, unknown>) => void): DateTimePlugin;
+/**
+ * Type guard to check if an object is a valid DateTimePlugin
+ *
+ * @param obj - Object to check
+ * @returns true if object is a valid DateTimePlugin
+ */
+export declare function isPlugin(obj: unknown): obj is DateTimePlugin;
+/**
+ * Validates that a plugin name follows naming conventions
+ *
+ * @param name - Plugin name to validate
+ * @returns true if name is valid, false otherwise
+ *
+ * @remarks
+ * Valid plugin names:
+ * - Must be a non-empty string
+ * - Should use kebab-case or camelCase
+ * - Should not contain spaces or special characters (except hyphens)
+ * - Should be descriptive and unique
+ */
+export declare function isValidPluginName(name: string): boolean;
+//# sourceMappingURL=plugin-base.d.ts.map

package/dist/plugins/plugin-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin-base.d.ts","sourceRoot":"","sources":["../../src/plugins/plugin-base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAEjE;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CACzB,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,CACN,aAAa,EAAE,aAAa,EAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC/B,IAAI,GACT,cAAc,CAahB;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,cAAc,CAY5D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAsBvD"}

package/dist/plugins/relative-time/index.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Extended DateTime interface with relative time methods
+ */
+declare module "../../core/datetime" {
+    interface DateTime {
+        /**
+         * Returns a human-readable string representing the time from now
+         * @returns Relative time string (e.g., "2 hours ago", "in 3 days")
+         *
+         * @example
+         * ```ts
+         * dt.fromNow() // "2 hours ago"
+         * dt.fromNow() // "in 3 days"
+         * ```
+         */
+        fromNow(): string;
+        /**
+         * Returns a human-readable string representing the time to now
+         * Opposite of fromNow()
+         * @returns Relative time string
+         *
+         * @example
+         * ```ts
+         * dt.toNow() // "in 2 hours"
+         * dt.toNow() // "3 days ago"
+         * ```
+         */
+        toNow(): string;
+        /**
+         * Returns a human-readable string representing the time from another DateTime
+         * @param other - DateTime instance to compare against
+         * @returns Relative time string
+         *
+         * @example
+         * ```ts
+         * dt1.from(dt2) // "2 hours ago"
+         * dt1.from(dt2) // "in 3 days"
+         * ```
+         */
+        from(other: DateTime): string;
+        /**
+         * Returns a human-readable string representing the time to another DateTime
+         * Opposite of from()
+         * @param other - DateTime instance to compare against
+         * @returns Relative time string
+         *
+         * @example
+         * ```ts
+         * dt1.to(dt2) // "in 2 hours"
+         * dt1.to(dt2) // "3 days ago"
+         * ```
+         */
+        to(other: DateTime): string;
+    }
+}
+/**
+ * Relative Time plugin for DateTime
+ * Adds methods for human-readable relative time formatting
+ */
+export declare const relativeTimePlugin: import("../..").DateTimePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/relative-time/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/relative-time/index.ts"],"names":[],"mappings":"AAiEA;;GAEG;AACH,OAAO,QAAQ,qBAAqB,CAAC;IAClC,UAAU,QAAQ;QACf;;;;;;;;;WASG;QACH,OAAO,IAAI,MAAM,CAAC;QAElB;;;;;;;;;;WAUG;QACH,KAAK,IAAI,MAAM,CAAC;QAEhB;;;;;;;;;;WAUG;QACH,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;QAE9B;;;;;;;;;;;WAWG;QACH,EAAE,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAAC;KAC9B;CACH;AAED;;;GAGG;AACH,eAAO,MAAM,kBAAkB,gCAwC9B,CAAC"}

package/dist/plugins/relative-time/index.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  relativeTimePlugin
+} from "../../index-rtm7bpky.js";
+import"../../index-77f5wgyc.js";
+export {
+  relativeTimePlugin
+};
+
+//# debugId=A5E876E3BCC5A11864756E2164756E21

package/dist/plugins/relative-time/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "A5E876E3BCC5A11864756E2164756E21",
+  "names": []
+}

package/dist/plugins/timezone/index.d.ts

@@ -0,0 +1,59 @@
+/**
+ * Extended DateTime interface with timezone methods
+ */
+declare module "../../core/datetime" {
+    interface DateTime {
+        /**
+         * Sets the timezone for this DateTime instance
+         * @param timezone - IANA timezone string (e.g., "America/New_York")
+         * @returns New DateTime instance with timezone set
+         */
+        tz(timezone: string): DateTime;
+        /**
+         * Converts this DateTime to a different timezone
+         * @param timezone - IANA timezone string
+         * @returns New DateTime instance in the specified timezone
+         */
+        toTimezone(timezone: string): DateTime;
+        /**
+         * Converts this DateTime to UTC timezone
+         * @returns New DateTime instance in UTC
+         */
+        utc(): DateTime;
+        /**
+         * Converts this DateTime to local system timezone
+         * @returns New DateTime instance in local timezone
+         */
+        local(): DateTime;
+        /**
+         * Gets the current timezone of this DateTime instance
+         * @returns IANA timezone string
+         */
+        getTimezone(): string;
+        /**
+         * Internal timezone storage
+         * @private
+         */
+        _timezone?: string;
+    }
+}
+/**
+ * Extended DateTimeClass interface with static timezone method
+ */
+declare module "../../types" {
+    interface DateTimeClass {
+        /**
+         * Creates a DateTime instance in a specific timezone
+         * @param input - Date input
+         * @param timezone - IANA timezone string
+         * @returns DateTime instance in the specified timezone
+         */
+        tz(input: any, timezone: string): DateTime;
+    }
+}
+/**
+ * Timezone plugin for DateTime
+ * Adds timezone support using IANA timezone strings
+ */
+export declare const timezonePlugin: import("../..").DateTimePlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/plugins/timezone/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/plugins/timezone/index.ts"],"names":[],"mappings":"AA+BA;;GAEG;AACH,OAAO,QAAQ,qBAAqB,CAAC;IAClC,UAAU,QAAQ;QACf;;;;WAIG;QACH,EAAE,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;QAE/B;;;;WAIG;QACH,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;QAEvC;;;WAGG;QACH,GAAG,IAAI,QAAQ,CAAC;QAEhB;;;WAGG;QACH,KAAK,IAAI,QAAQ,CAAC;QAElB;;;WAGG;QACH,WAAW,IAAI,MAAM,CAAC;QAEtB;;;WAGG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACrB;CACH;AAED;;GAEG;AACH,OAAO,QAAQ,aAAa,CAAC;IAC1B,UAAU,aAAa;QACpB;;;;;WAKG;QACH,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,QAAQ,CAAC;KAC7C;CACH;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,gCAwD1B,CAAC"}

package/dist/plugins/timezone/index.js

@@ -0,0 +1,10 @@
+// @bun
+import {
+  timezonePlugin
+} from "../../index-a78jd9k6.js";
+import"../../index-77f5wgyc.js";
+export {
+  timezonePlugin
+};
+
+//# debugId=129C83C5C72816E464756E2164756E21

package/dist/plugins/timezone/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "129C83C5C72816E464756E2164756E21",
+  "names": []
+}

package/dist/schemas.d.ts

@@ -0,0 +1,66 @@
+import { z } from "zod";
+/**
+ * Schema for time units
+ */
+export declare const TimeUnitSchema: z.ZodEnum<{
+    millisecond: "millisecond";
+    second: "second";
+    minute: "minute";
+    hour: "hour";
+    day: "day";
+    week: "week";
+    month: "month";
+    year: "year";
+}>;
+/**
+ * Schema for DateTime input types
+ * Accepts Date, string, number, or DateTime instance
+ */
+export declare const DateInputSchema: z.ZodUnion<readonly [z.ZodDate, z.ZodString, z.ZodNumber, z.ZodCustom<import(".").DateTime, import(".").DateTime>]>;
+/**
+ * Schema for DateTime configuration
+ */
+export declare const DateTimeConfigSchema: z.ZodObject<{
+    timezone: z.ZodOptional<z.ZodString>;
+    locale: z.ZodOptional<z.ZodString>;
+    utc: z.ZodOptional<z.ZodBoolean>;
+    strict: z.ZodOptional<z.ZodBoolean>;
+}, z.core.$strip>;
+/**
+ * Schema for format options
+ */
+export declare const FormatOptionsSchema: z.ZodObject<{
+    locale: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for parse options
+ */
+export declare const ParseOptionsSchema: z.ZodObject<{
+    strict: z.ZodOptional<z.ZodBoolean>;
+    format: z.ZodOptional<z.ZodString>;
+    timezone: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Schema for ISO 8601 date strings (full datetime with timezone)
+ * Matches: YYYY-MM-DDTHH:mm:ss.sssZ or YYYY-MM-DDTHH:mm:ss.sss±HH:mm
+ */
+export declare const ISODateSchema: z.ZodString;
+/**
+ * Schema for ISO 8601 date-only strings
+ * Matches: YYYY-MM-DD
+ */
+export declare const ISODateOnlySchema: z.ZodString;
+/**
+ * Schema for ISO 8601 time-only strings
+ * Matches: HH:mm:ss or HH:mm:ss.sss
+ */
+export declare const ISOTimeOnlySchema: z.ZodString;
+/**
+ * Schema for plugin definition
+ */
+export declare const DateTimePluginSchema: z.ZodObject<{
+    name: z.ZodString;
+    install: z.ZodFunction<z.core.$ZodFunctionArgs, z.core.$ZodFunctionOut>;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;EASzB,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,eAAe,qHAc1B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;;;iBAK/B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,kBAAkB;;;;iBAI7B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,aAAa,aAQtB,CAAC;AAEL;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAE5B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,aAKzB,CAAC;AAEN;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC"}