@bereasoftware/time-guard 2.5.1 → 2.5.2

package/README.en.md

@@ -894,8 +894,10 @@ console.log(formatUserDate(date, "ja")); // 水曜日、2024年3月13日 14:30
 #### Getting Available Locales Programmatically
 
 ```typescript
+import { getAvailableLocales } from "@bereasoftware/time-guard";
+
 // Get all available locales
-const locales = TimeGuard.getAvailableLocales();
+const locales = getAvailableLocales();
 // Returns: ['en', 'en-au', 'en-gb', 'en-ca', 'es', 'es-mx', 'es-us', ...]
 
 // Filter by prefix
@@ -907,7 +909,7 @@ const asianLocales = locales.filter((l) =>
 
 // Create locale selector UI
 function createLocaleSelector() {
-  const locales = TimeGuard.getAvailableLocales();
+  const locales = getAvailableLocales();
   return locales.map((locale) => ({
     code: locale,
     label: new Intl.DisplayNames("en", { type: "language" }).of(locale),
@@ -1357,7 +1359,8 @@ inNYC.format("YYYY-MM-DD HH:mm:ss Z"); // 2024-03-13 10:30:00 -04:00
 inTokyo.format("YYYY-MM-DD HH:mm:ss Z"); // 2024-03-13 23:30:00 +09:00
 
 // Get all available locales
-TimeGuard.getAvailableLocales(); // Array of 40+ locale codes
+import { getAvailableLocales } from "@bereasoftware/time-guard";
+getAvailableLocales(); // Array of 40+ locale codes
 ```
 
 ### 🎨 Format Patterns

package/README.md

@@ -957,8 +957,10 @@ console.log(formatUserDate(date, 'ja')); // 水曜日、2024年3月13日 14:30
 #### Obtener Locales Disponibles Programáticamente
 
 ```typescript
+import { getAvailableLocales } from "@bereasoftware/time-guard";
+
 // Get all available locales
-const locales = TimeGuard.getAvailableLocales();
+const locales = getAvailableLocales();
 // Returns: ['en', 'en-au', 'en-gb', 'en-ca', 'es', 'es-mx', 'es-us', ...]
 
 // Filter by prefix
@@ -970,7 +972,7 @@ const asianLocales = locales.filter((l) =>
 
 // Create locale selector UI
 function createLocaleSelector() {
-  const locales = TimeGuard.getAvailableLocales();
+  const locales = getAvailableLocales();
   return locales.map((locale) => ({
     code: locale,
     label: new Intl.DisplayNames('en', { type: 'language' }).of(locale),
@@ -1440,7 +1442,8 @@ inNYC.format('YYYY-MM-DD HH:mm:ss Z'); // 2024-03-13 10:30:00 -04:00
 inTokyo.format('YYYY-MM-DD HH:mm:ss Z'); // 2024-03-13 23:30:00 +09:00
 
 // Get all available locales
-TimeGuard.getAvailableLocales(); // Array of 40+ locale codes
+import { getAvailableLocales } from "@bereasoftware/time-guard";
+getAvailableLocales(); // Array of 40+ locale codes
 ```
 
 ### 🎨 Format Patterns

package/dist/calendars/index.es.js

@@ -1,4 +1,4 @@
-/*! time-guard v2.5.1 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
+/*! time-guard v2.5.2 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
 //#region src/calendars/index.ts
 var e = class {
 	id = "islamic";

package/dist/plugins/advanced-format.cjs

@@ -1,2 +1,2 @@
-Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var e=class{name=`advanced-format`;version=`1.0.0`;install(e){let t=e.prototype.format;e.prototype.format=function(e){if(!e||typeof e!=`string`||!/Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/.test(e))return t.call(this,e);let n=this.toTemporal(),r=`toPlainDateTime`in n?n.toPlainDateTime():n,i=e=>{let t=[`th`,`st`,`nd`,`rd`],n=e%100;return e+(t[(n-20)%10]||t[n]||t[0])},a=(e,t)=>String(e).padStart(t,`0`),o=e=>{let t=new Date(e.year,0,4),n=new Date(t);n.setDate(t.getDate()-t.getDay()+(t.getDay()===0?-6:1));let r=new Date(e.year,e.month-1,e.day),i=Math.floor((r.getTime()-n.getTime())/(10080*60*1e3))+1;return Math.max(1,i)},s=e=>{let t=Math.ceil((e.day+new Date(e.year,e.month-1,1).getDay())/7);return Math.max(1,t)},c=e=>{let t=new Date(e.year,e.month-1,e.day),n=t.getTime()<new Date(e.year,0,1).getTime()?-1:+(t.getTime()>=new Date(e.year+1,0,1).getTime());return e.year+n},l=e=>{let t=e.month===1&&e.day<4?-1:+(e.month===12&&e.day>28);return e.year+t},u=e.replace(/Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/g,e=>{let t=``;switch(e){case`Q`:t=String(Math.ceil(r.month/3));break;case`Do`:t=i(r.day);break;case`W`:case`WW`:t=a(o(r),e===`W`?1:2);break;case`w`:case`ww`:t=a(s(r),e===`w`?1:2);break;case`GGGG`:t=String(c(r));break;case`gggg`:t=String(l(r));break;case`k`:case`kk`:t=a(r.hour===0?24:r.hour,e===`k`?1:2);break;case`X`:t=String(Math.floor(this.valueOf()/1e3));break;case`x`:t=String(this.valueOf());break;case`z`:t=`${this.getTimezoneOffset()}`;break;case`zzz`:t=`${this.getTimezoneOffsetLong()}`;break;default:return e}return`[${t}]`});return t.call(this,u)}}getOrdinal(e){let t=[`th`,`st`,`nd`,`rd`],n=e%100;return e+(t[(n-20)%10]||t[n]||t[0])}padNumber(e,t){return String(e).padStart(t,`0`)}getISOWeek(e){let t=new Date(e.year,0,4),n=new Date(t);n.setDate(t.getDate()-t.getDay()+(t.getDay()===0?-6:1));let r=new Date(e.year,e.month-1,e.day),i=Math.floor((r.getTime()-n.getTime())/(10080*60*1e3))+1;return Math.max(1,i)}getWeekOfYear(e){let t=Math.ceil((e.day+new Date(e.year,e.month-1,1).getDay())/7);return Math.max(1,t)}getISOWeekYear(e){let t=new Date(e.year,e.month-1,e.day),n=t.getTime()<new Date(e.year,0,1).getTime()?-1:+(t.getTime()>=new Date(e.year+1,0,1).getTime());return e.year+n}getWeekYear(e){let t=e.month===1&&e.day<4?-1:+(e.month===12&&e.day>28);return e.year+t}getTimezoneOffset(){try{let e=new Date;return new Intl.DateTimeFormat(`en-US`,{timeZone:`UTC`,timeZoneName:`short`}).formatToParts(e).find(e=>e.type===`timeZoneName`)?.value||`UTC`}catch{return`UTC`}}getTimezoneOffsetLong(){try{let e=new Date;return new Intl.DateTimeFormat(`en-US`,{timeZone:`UTC`,timeZoneName:`long`}).formatToParts(e).find(e=>e.type===`timeZoneName`)?.value||`Coordinated Universal Time`}catch{return`Coordinated Universal Time`}}},t=new e;exports.AdvancedFormatPlugin=e,exports.default=t;
+Object.defineProperties(exports,{__esModule:{value:!0},[Symbol.toStringTag]:{value:`Module`}});var e=class{name=`advanced-format`;version=`1.0.0`;install(e){let t=e.prototype.format;e.prototype.format=function(e){if(!e||typeof e!=`string`||!/Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/.test(e))return t.call(this,e);let n=this.toTemporal(),r=`toPlainDateTime`in n?n.toPlainDateTime():n,i=e=>{let t=[`th`,`st`,`nd`,`rd`],n=e%100;return e+(t[(n-20)%10]||t[n]||t[0])},a=(e,t)=>String(e).padStart(t,`0`),o=e=>{let t=new Date(e.year,0,4),n=new Date(t);n.setDate(t.getDate()-t.getDay()+(t.getDay()===0?-6:1));let r=new Date(e.year,e.month-1,e.day),i=Math.floor((r.getTime()-n.getTime())/(10080*60*1e3))+1;return Math.max(1,i)},s=e=>{let t=Math.ceil((e.day+new Date(e.year,e.month-1,1).getDay())/7);return Math.max(1,t)},c=e=>{let t=new Date(e.year,e.month-1,e.day),n=t.getTime()<new Date(e.year,0,1).getTime()?-1:+(t.getTime()>=new Date(e.year+1,0,1).getTime());return e.year+n},l=e=>{let t=e.month===1&&e.day<4?-1:+(e.month===12&&e.day>28);return e.year+t},u=e.replace(/Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/g,e=>{let t=``;switch(e){case`Q`:t=String(Math.ceil(r.month/3));break;case`Do`:t=i(r.day);break;case`W`:case`WW`:t=a(o(r),e===`W`?1:2);break;case`w`:case`ww`:t=a(s(r),e===`w`?1:2);break;case`GGGG`:t=String(c(r));break;case`gggg`:t=String(l(r));break;case`k`:case`kk`:t=a(r.hour===0?24:r.hour,e===`k`?1:2);break;case`X`:t=String(Math.floor(this.valueOf()/1e3));break;case`x`:t=String(this.valueOf());break;case`z`:t=`${this.getTimezoneOffset()}`;break;case`zzz`:t=`${this.getTimezoneOffsetLong()}`;break;default:return e}return`[${t}]`});return t.call(this,u)}}},t=new e;exports.AdvancedFormatPlugin=e,exports.default=t;
 //# sourceMappingURL=advanced-format.cjs.map

package/dist/plugins/advanced-format.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"advanced-format.cjs","names":[],"sources":["../../src/plugins/advanced-format/index.ts"],"sourcesContent":["/**\r\n * TimeGuard Advanced Format Plugin\r\n * Adds advanced format tokens: Q (quarter), Do (ordinal), w (week), etc.\r\n * Follows SOLID principles and extends core formatting capabilities\r\n */\r\n\r\nimport type { ITimeGuardPlugin } from '../../types';\r\nimport type { TimeGuard } from '../../time-guard';\r\nimport type { Temporal } from '@js-temporal/polyfill';\r\n\r\nexport class AdvancedFormatPlugin implements ITimeGuardPlugin {\r\n  name = 'advanced-format';\r\n  version = '1.0.0';\r\n\r\n  /**\r\n   * Install plugin into TimeGuard\r\n   */\r\n  install(TimeGuardClass: typeof TimeGuard): void {\r\n    // Store original format method\r\n    const originalFormat = TimeGuardClass.prototype.format;\r\n\r\n    /**\r\n     * Extended format method with advanced tokens\r\n     */\r\n    (TimeGuardClass.prototype as any).format = function (pattern: string) {\r\n      if (!pattern || typeof pattern !== 'string') {\r\n        return originalFormat.call(this, pattern);\r\n      }\r\n\r\n      // Check if pattern contains advanced tokens\r\n      if (!/Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/.test(pattern)) {\r\n        return originalFormat.call(this, pattern);\r\n      }\r\n\r\n      // Get the underlying Temporal object\r\n      const temporal = this.toTemporal();\r\n      const temporal_dt =\r\n        'toPlainDateTime' in temporal\r\n          ? (temporal as any).toPlainDateTime()\r\n          : (temporal as Temporal.PlainDateTime);\r\n      \r\n      const ordinalFn = (n: number) => {\r\n        const suffixes = ['th', 'st', 'nd', 'rd'];\r\n        const v = n % 100;\r\n        return n + (suffixes[(v - 20) % 10] || suffixes[v] || suffixes[0]);\r\n      };\r\n      const padFn = (n: number, length: number) => String(n).padStart(length, '0');\r\n      const getISOWeek = (temporal: any) => {\r\n        const jan4 = new Date(temporal.year, 0, 4);\r\n        const week1Start = new Date(jan4);\r\n        week1Start.setDate(jan4.getDate() - jan4.getDay() + (jan4.getDay() === 0 ? -6 : 1));\r\n        const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n        const weekNum = Math.floor((currentDate.getTime() - week1Start.getTime()) / (7 * 24 * 60 * 60 * 1000)) + 1;\r\n        return Math.max(1, weekNum);\r\n      };\r\n      const getWeekOfYear = (temporal: any) => {\r\n        const weekNum = Math.ceil(((temporal.day + new Date(temporal.year, temporal.month - 1, 1).getDay()) / 7));\r\n        return Math.max(1, weekNum);\r\n      };\r\n      const getISOWeekYear = (temporal: any) => {\r\n        const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n        const yearAdjust = currentDate.getTime() < new Date(temporal.year, 0, 1).getTime() ? -1 : currentDate.getTime() >= new Date(temporal.year + 1, 0, 1).getTime() ? 1 : 0;\r\n        return temporal.year + yearAdjust;\r\n      };\r\n      const getWeekYear = (temporal: any) => {\r\n        const yearAdjust = temporal.month === 1 && temporal.day < 4 ? -1 : temporal.month === 12 && temporal.day > 28 ? 1 : 0;\r\n        return temporal.year + yearAdjust;\r\n      };\r\n\r\n      // Replace advanced tokens - wrap results in brackets to protect from standard formatter\r\n      let result = pattern.replace(\r\n        /Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/g,\r\n        (match) => {\r\n          let replacement = '';\r\n          switch (match) {\r\n            // Quarter\r\n            case 'Q':\r\n              replacement = String(Math.ceil((temporal_dt.month) / 3));\r\n              break;\r\n\r\n            // Ordinal day\r\n            case 'Do':\r\n              replacement = ordinalFn(temporal_dt.day);\r\n              break;\r\n\r\n            // Week of year (ISO)\r\n            case 'W':\r\n            case 'WW':\r\n              replacement = padFn(getISOWeek(temporal_dt), match === 'W' ? 1 : 2);\r\n              break;\r\n\r\n            // Week of year (locale)\r\n            case 'w':\r\n            case 'ww':\r\n              replacement = padFn(getWeekOfYear(temporal_dt), match === 'w' ? 1 : 2);\r\n              break;\r\n\r\n            // ISO week year\r\n            case 'GGGG':\r\n              replacement = String(getISOWeekYear(temporal_dt));\r\n              break;\r\n\r\n            // Week year\r\n            case 'gggg':\r\n              replacement = String(getWeekYear(temporal_dt));\r\n              break;\r\n\r\n            // Hour (1-24)\r\n            case 'k':\r\n            case 'kk':\r\n              const hour = temporal_dt.hour === 0 ? 24 : temporal_dt.hour;\r\n              replacement = padFn(hour, match === 'k' ? 1 : 2);\r\n              break;\r\n\r\n            // Unix seconds timestamp\r\n            case 'X':\r\n              replacement = String(Math.floor(this.valueOf() / 1000));\r\n              break;\r\n\r\n            // Unix milliseconds timestamp\r\n            case 'x':\r\n              replacement = String(this.valueOf());\r\n              break;\r\n\r\n            // Timezone offset\r\n            case 'z':\r\n              replacement = `${this.getTimezoneOffset()}`;\r\n              break;\r\n\r\n            case 'zzz':\r\n              replacement = `${this.getTimezoneOffsetLong()}`;\r\n              break;\r\n\r\n            default:\r\n              return match;\r\n          }\r\n          // Wrap in brackets to protect from standard formatter\r\n          return `[${replacement}]`;\r\n        },\r\n      );\r\n\r\n      // Apply standard format to the result\r\n      return originalFormat.call(this, result);\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get ordinal suffix (1st, 2nd, 3rd, etc.)\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getOrdinal(n: number): string {\r\n    const suffixes = ['th', 'st', 'nd', 'rd'];\r\n    const v = n % 100;\r\n    return n + (suffixes[(v - 20) % 10] || suffixes[v] || suffixes[0]);\r\n  }\r\n\r\n  /**\r\n   * Pad number with leading zeros\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private padNumber(n: number, length: number): string {\r\n    return String(n).padStart(length, '0');\r\n  }\r\n\r\n  /**\r\n   * Get ISO week number\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getISOWeek(temporal: Temporal.PlainDateTime): number {\r\n    // Simple ISO week calculation\r\n    const jan4 = new Date(temporal.year, 0, 4);\r\n    const week1Start = new Date(jan4);\r\n    week1Start.setDate(jan4.getDate() - jan4.getDay() + (jan4.getDay() === 0 ? -6 : 1));\r\n\r\n    const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n    const weekNum = Math.floor(\r\n      (currentDate.getTime() - week1Start.getTime()) / (7 * 24 * 60 * 60 * 1000),\r\n    ) + 1;\r\n\r\n    return Math.max(1, weekNum);\r\n  }\r\n\r\n  /**\r\n   * Get week of year (locale-based)\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getWeekOfYear(temporal: Temporal.PlainDateTime): number {\r\n    const weekNum = Math.ceil(\r\n      ((temporal.day + new Date(temporal.year, temporal.month - 1, 1).getDay()) / 7),\r\n    );\r\n    return Math.max(1, weekNum);\r\n  }\r\n\r\n  /**\r\n   * Get ISO week year\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getISOWeekYear(temporal: Temporal.PlainDateTime): number {\r\n    const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n    const yearAdjust =\r\n      currentDate.getTime() < new Date(temporal.year, 0, 1).getTime()\r\n        ? -1\r\n        : currentDate.getTime() >= new Date(temporal.year + 1, 0, 1).getTime()\r\n          ? 1\r\n          : 0;\r\n\r\n    return temporal.year + yearAdjust;\r\n  }\r\n\r\n  /**\r\n   * Get week year\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getWeekYear(temporal: Temporal.PlainDateTime): number {\r\n    const yearAdjust =\r\n      temporal.month === 1 && temporal.day < 4\r\n        ? -1\r\n        : temporal.month === 12 && temporal.day > 28\r\n          ? 1\r\n          : 0;\r\n    return temporal.year + yearAdjust;\r\n  }\r\n\r\n  /**\r\n   * Get timezone offset short form\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getTimezoneOffset(): string {\r\n    try {\r\n      const now = new Date();\r\n      const formatter = new Intl.DateTimeFormat('en-US', {\r\n        timeZone: 'UTC',\r\n        timeZoneName: 'short',\r\n      });\r\n      return formatter.formatToParts(now).find(p => p.type === 'timeZoneName')?.value || 'UTC';\r\n    } catch {\r\n      return 'UTC';\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get timezone offset long form\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getTimezoneOffsetLong(): string {\r\n    try {\r\n      const now = new Date();\r\n      const formatter = new Intl.DateTimeFormat('en-US', {\r\n        timeZone: 'UTC',\r\n        timeZoneName: 'long',\r\n      });\r\n      return formatter.formatToParts(now).find(p => p.type === 'timeZoneName')?.value || 'Coordinated Universal Time';\r\n    } catch {\r\n      return 'Coordinated Universal Time';\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Create and export default instance\r\n */\r\nexport default new AdvancedFormatPlugin();\r\n"],"mappings":"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"}
+{"version":3,"file":"advanced-format.cjs","names":[],"sources":["../../src/plugins/advanced-format/index.ts"],"sourcesContent":["/**\r\n * TimeGuard Advanced Format Plugin\r\n * Adds advanced format tokens: Q (quarter), Do (ordinal), w (week), etc.\r\n * Follows SOLID principles and extends core formatting capabilities\r\n */\r\n\r\nimport type { ITimeGuardPlugin } from '../../types';\r\nimport type { TimeGuard } from '../../time-guard';\r\nimport { Temporal } from '@js-temporal/polyfill';\r\n\r\nexport class AdvancedFormatPlugin implements ITimeGuardPlugin {\r\n  name = 'advanced-format';\r\n  version = '1.0.0';\r\n\r\n  /**\r\n   * Install plugin into TimeGuard\r\n   */\r\n  install(TimeGuardClass: typeof TimeGuard): void {\r\n    // Store original format method\r\n    const originalFormat = TimeGuardClass.prototype.format;\r\n\r\n    /**\r\n     * Extended format method with advanced tokens\r\n     */\r\n    (TimeGuardClass.prototype as any).format = function (pattern: string) {\r\n      if (!pattern || typeof pattern !== 'string') {\r\n        return originalFormat.call(this, pattern);\r\n      }\r\n\r\n      // Check if pattern contains advanced tokens\r\n      if (!/Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/.test(pattern)) {\r\n        return originalFormat.call(this, pattern);\r\n      }\r\n\r\n      // Get the underlying Temporal object\r\n      const temporal = this.toTemporal();\r\n      const temporal_dt =\r\n        'toPlainDateTime' in temporal\r\n          ? (temporal as any).toPlainDateTime()\r\n          : (temporal as Temporal.PlainDateTime);\r\n      \r\n      const ordinalFn = (n: number) => {\r\n        const suffixes = ['th', 'st', 'nd', 'rd'];\r\n        const v = n % 100;\r\n        return n + (suffixes[(v - 20) % 10] || suffixes[v] || suffixes[0]);\r\n      };\r\n      const padFn = (n: number, length: number) => String(n).padStart(length, '0');\r\n      const getISOWeek = (temporal: any) => {\r\n        const jan4 = new Date(temporal.year, 0, 4);\r\n        const week1Start = new Date(jan4);\r\n        week1Start.setDate(jan4.getDate() - jan4.getDay() + (jan4.getDay() === 0 ? -6 : 1));\r\n        const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n        const weekNum = Math.floor((currentDate.getTime() - week1Start.getTime()) / (7 * 24 * 60 * 60 * 1000)) + 1;\r\n        return Math.max(1, weekNum);\r\n      };\r\n      const getWeekOfYear = (temporal: any) => {\r\n        const weekNum = Math.ceil(((temporal.day + new Date(temporal.year, temporal.month - 1, 1).getDay()) / 7));\r\n        return Math.max(1, weekNum);\r\n      };\r\n      const getISOWeekYear = (temporal: any) => {\r\n        const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n        const yearAdjust = currentDate.getTime() < new Date(temporal.year, 0, 1).getTime() ? -1 : currentDate.getTime() >= new Date(temporal.year + 1, 0, 1).getTime() ? 1 : 0;\r\n        return temporal.year + yearAdjust;\r\n      };\r\n      const getWeekYear = (temporal: any) => {\r\n        const yearAdjust = temporal.month === 1 && temporal.day < 4 ? -1 : temporal.month === 12 && temporal.day > 28 ? 1 : 0;\r\n        return temporal.year + yearAdjust;\r\n      };\r\n\r\n      // Replace advanced tokens - wrap results in brackets to protect from standard formatter\r\n      let result = pattern.replace(\r\n        /Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/g,\r\n        (match) => {\r\n          let replacement = '';\r\n          switch (match) {\r\n            // Quarter\r\n            case 'Q':\r\n              replacement = String(Math.ceil((temporal_dt.month) / 3));\r\n              break;\r\n\r\n            // Ordinal day\r\n            case 'Do':\r\n              replacement = ordinalFn(temporal_dt.day);\r\n              break;\r\n\r\n            // Week of year (ISO)\r\n            case 'W':\r\n            case 'WW':\r\n              replacement = padFn(getISOWeek(temporal_dt), match === 'W' ? 1 : 2);\r\n              break;\r\n\r\n            // Week of year (locale)\r\n            case 'w':\r\n            case 'ww':\r\n              replacement = padFn(getWeekOfYear(temporal_dt), match === 'w' ? 1 : 2);\r\n              break;\r\n\r\n            // ISO week year\r\n            case 'GGGG':\r\n              replacement = String(getISOWeekYear(temporal_dt));\r\n              break;\r\n\r\n            // Week year\r\n            case 'gggg':\r\n              replacement = String(getWeekYear(temporal_dt));\r\n              break;\r\n\r\n            // Hour (1-24)\r\n            case 'k':\r\n            case 'kk':\r\n              const hour = temporal_dt.hour === 0 ? 24 : temporal_dt.hour;\r\n              replacement = padFn(hour, match === 'k' ? 1 : 2);\r\n              break;\r\n\r\n            // Unix seconds timestamp\r\n            case 'X':\r\n              replacement = String(Math.floor(this.valueOf() / 1000));\r\n              break;\r\n\r\n            // Unix milliseconds timestamp\r\n            case 'x':\r\n              replacement = String(this.valueOf());\r\n              break;\r\n\r\n            // Timezone offset\r\n            case 'z':\r\n              replacement = `${this.getTimezoneOffset()}`;\r\n              break;\r\n\r\n            case 'zzz':\r\n              replacement = `${this.getTimezoneOffsetLong()}`;\r\n              break;\r\n\r\n            default:\r\n              return match;\r\n          }\r\n          // Wrap in brackets to protect from standard formatter\r\n          return `[${replacement}]`;\r\n        },\r\n      );\r\n\r\n      // Apply standard format to the result\r\n      return originalFormat.call(this, result);\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Create and export default instance\r\n */\r\nexport default new AdvancedFormatPlugin();\r\n"],"mappings":"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"}

package/dist/plugins/advanced-format.es.js

@@ -1,4 +1,4 @@
-/*! time-guard v2.5.1 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
+/*! time-guard v2.5.2 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
 //#region src/plugins/advanced-format/index.ts
 var e = class {
 	name = "advanced-format";
@@ -75,58 +75,6 @@ var e = class {
 			return t.call(this, u);
 		};
 	}
-	getOrdinal(e) {
-		let t = [
-			"th",
-			"st",
-			"nd",
-			"rd"
-		], n = e % 100;
-		return e + (t[(n - 20) % 10] || t[n] || t[0]);
-	}
-	padNumber(e, t) {
-		return String(e).padStart(t, "0");
-	}
-	getISOWeek(e) {
-		let t = new Date(e.year, 0, 4), n = new Date(t);
-		n.setDate(t.getDate() - t.getDay() + (t.getDay() === 0 ? -6 : 1));
-		let r = new Date(e.year, e.month - 1, e.day), i = Math.floor((r.getTime() - n.getTime()) / (10080 * 60 * 1e3)) + 1;
-		return Math.max(1, i);
-	}
-	getWeekOfYear(e) {
-		let t = Math.ceil((e.day + new Date(e.year, e.month - 1, 1).getDay()) / 7);
-		return Math.max(1, t);
-	}
-	getISOWeekYear(e) {
-		let t = new Date(e.year, e.month - 1, e.day), n = t.getTime() < new Date(e.year, 0, 1).getTime() ? -1 : +(t.getTime() >= new Date(e.year + 1, 0, 1).getTime());
-		return e.year + n;
-	}
-	getWeekYear(e) {
-		let t = e.month === 1 && e.day < 4 ? -1 : +(e.month === 12 && e.day > 28);
-		return e.year + t;
-	}
-	getTimezoneOffset() {
-		try {
-			let e = /* @__PURE__ */ new Date();
-			return new Intl.DateTimeFormat("en-US", {
-				timeZone: "UTC",
-				timeZoneName: "short"
-			}).formatToParts(e).find((e) => e.type === "timeZoneName")?.value || "UTC";
-		} catch {
-			return "UTC";
-		}
-	}
-	getTimezoneOffsetLong() {
-		try {
-			let e = /* @__PURE__ */ new Date();
-			return new Intl.DateTimeFormat("en-US", {
-				timeZone: "UTC",
-				timeZoneName: "long"
-			}).formatToParts(e).find((e) => e.type === "timeZoneName")?.value || "Coordinated Universal Time";
-		} catch {
-			return "Coordinated Universal Time";
-		}
-	}
 }, t = new e();
 //#endregion
 export { e as AdvancedFormatPlugin, t as default };

package/dist/plugins/advanced-format.es.js.map

@@ -1 +1 @@
-{"version":3,"file":"advanced-format.es.js","names":[],"sources":["../../src/plugins/advanced-format/index.ts"],"sourcesContent":["/**\r\n * TimeGuard Advanced Format Plugin\r\n * Adds advanced format tokens: Q (quarter), Do (ordinal), w (week), etc.\r\n * Follows SOLID principles and extends core formatting capabilities\r\n */\r\n\r\nimport type { ITimeGuardPlugin } from '../../types';\r\nimport type { TimeGuard } from '../../time-guard';\r\nimport type { Temporal } from '@js-temporal/polyfill';\r\n\r\nexport class AdvancedFormatPlugin implements ITimeGuardPlugin {\r\n  name = 'advanced-format';\r\n  version = '1.0.0';\r\n\r\n  /**\r\n   * Install plugin into TimeGuard\r\n   */\r\n  install(TimeGuardClass: typeof TimeGuard): void {\r\n    // Store original format method\r\n    const originalFormat = TimeGuardClass.prototype.format;\r\n\r\n    /**\r\n     * Extended format method with advanced tokens\r\n     */\r\n    (TimeGuardClass.prototype as any).format = function (pattern: string) {\r\n      if (!pattern || typeof pattern !== 'string') {\r\n        return originalFormat.call(this, pattern);\r\n      }\r\n\r\n      // Check if pattern contains advanced tokens\r\n      if (!/Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/.test(pattern)) {\r\n        return originalFormat.call(this, pattern);\r\n      }\r\n\r\n      // Get the underlying Temporal object\r\n      const temporal = this.toTemporal();\r\n      const temporal_dt =\r\n        'toPlainDateTime' in temporal\r\n          ? (temporal as any).toPlainDateTime()\r\n          : (temporal as Temporal.PlainDateTime);\r\n      \r\n      const ordinalFn = (n: number) => {\r\n        const suffixes = ['th', 'st', 'nd', 'rd'];\r\n        const v = n % 100;\r\n        return n + (suffixes[(v - 20) % 10] || suffixes[v] || suffixes[0]);\r\n      };\r\n      const padFn = (n: number, length: number) => String(n).padStart(length, '0');\r\n      const getISOWeek = (temporal: any) => {\r\n        const jan4 = new Date(temporal.year, 0, 4);\r\n        const week1Start = new Date(jan4);\r\n        week1Start.setDate(jan4.getDate() - jan4.getDay() + (jan4.getDay() === 0 ? -6 : 1));\r\n        const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n        const weekNum = Math.floor((currentDate.getTime() - week1Start.getTime()) / (7 * 24 * 60 * 60 * 1000)) + 1;\r\n        return Math.max(1, weekNum);\r\n      };\r\n      const getWeekOfYear = (temporal: any) => {\r\n        const weekNum = Math.ceil(((temporal.day + new Date(temporal.year, temporal.month - 1, 1).getDay()) / 7));\r\n        return Math.max(1, weekNum);\r\n      };\r\n      const getISOWeekYear = (temporal: any) => {\r\n        const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n        const yearAdjust = currentDate.getTime() < new Date(temporal.year, 0, 1).getTime() ? -1 : currentDate.getTime() >= new Date(temporal.year + 1, 0, 1).getTime() ? 1 : 0;\r\n        return temporal.year + yearAdjust;\r\n      };\r\n      const getWeekYear = (temporal: any) => {\r\n        const yearAdjust = temporal.month === 1 && temporal.day < 4 ? -1 : temporal.month === 12 && temporal.day > 28 ? 1 : 0;\r\n        return temporal.year + yearAdjust;\r\n      };\r\n\r\n      // Replace advanced tokens - wrap results in brackets to protect from standard formatter\r\n      let result = pattern.replace(\r\n        /Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/g,\r\n        (match) => {\r\n          let replacement = '';\r\n          switch (match) {\r\n            // Quarter\r\n            case 'Q':\r\n              replacement = String(Math.ceil((temporal_dt.month) / 3));\r\n              break;\r\n\r\n            // Ordinal day\r\n            case 'Do':\r\n              replacement = ordinalFn(temporal_dt.day);\r\n              break;\r\n\r\n            // Week of year (ISO)\r\n            case 'W':\r\n            case 'WW':\r\n              replacement = padFn(getISOWeek(temporal_dt), match === 'W' ? 1 : 2);\r\n              break;\r\n\r\n            // Week of year (locale)\r\n            case 'w':\r\n            case 'ww':\r\n              replacement = padFn(getWeekOfYear(temporal_dt), match === 'w' ? 1 : 2);\r\n              break;\r\n\r\n            // ISO week year\r\n            case 'GGGG':\r\n              replacement = String(getISOWeekYear(temporal_dt));\r\n              break;\r\n\r\n            // Week year\r\n            case 'gggg':\r\n              replacement = String(getWeekYear(temporal_dt));\r\n              break;\r\n\r\n            // Hour (1-24)\r\n            case 'k':\r\n            case 'kk':\r\n              const hour = temporal_dt.hour === 0 ? 24 : temporal_dt.hour;\r\n              replacement = padFn(hour, match === 'k' ? 1 : 2);\r\n              break;\r\n\r\n            // Unix seconds timestamp\r\n            case 'X':\r\n              replacement = String(Math.floor(this.valueOf() / 1000));\r\n              break;\r\n\r\n            // Unix milliseconds timestamp\r\n            case 'x':\r\n              replacement = String(this.valueOf());\r\n              break;\r\n\r\n            // Timezone offset\r\n            case 'z':\r\n              replacement = `${this.getTimezoneOffset()}`;\r\n              break;\r\n\r\n            case 'zzz':\r\n              replacement = `${this.getTimezoneOffsetLong()}`;\r\n              break;\r\n\r\n            default:\r\n              return match;\r\n          }\r\n          // Wrap in brackets to protect from standard formatter\r\n          return `[${replacement}]`;\r\n        },\r\n      );\r\n\r\n      // Apply standard format to the result\r\n      return originalFormat.call(this, result);\r\n    };\r\n  }\r\n\r\n  /**\r\n   * Get ordinal suffix (1st, 2nd, 3rd, etc.)\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getOrdinal(n: number): string {\r\n    const suffixes = ['th', 'st', 'nd', 'rd'];\r\n    const v = n % 100;\r\n    return n + (suffixes[(v - 20) % 10] || suffixes[v] || suffixes[0]);\r\n  }\r\n\r\n  /**\r\n   * Pad number with leading zeros\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private padNumber(n: number, length: number): string {\r\n    return String(n).padStart(length, '0');\r\n  }\r\n\r\n  /**\r\n   * Get ISO week number\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getISOWeek(temporal: Temporal.PlainDateTime): number {\r\n    // Simple ISO week calculation\r\n    const jan4 = new Date(temporal.year, 0, 4);\r\n    const week1Start = new Date(jan4);\r\n    week1Start.setDate(jan4.getDate() - jan4.getDay() + (jan4.getDay() === 0 ? -6 : 1));\r\n\r\n    const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n    const weekNum = Math.floor(\r\n      (currentDate.getTime() - week1Start.getTime()) / (7 * 24 * 60 * 60 * 1000),\r\n    ) + 1;\r\n\r\n    return Math.max(1, weekNum);\r\n  }\r\n\r\n  /**\r\n   * Get week of year (locale-based)\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getWeekOfYear(temporal: Temporal.PlainDateTime): number {\r\n    const weekNum = Math.ceil(\r\n      ((temporal.day + new Date(temporal.year, temporal.month - 1, 1).getDay()) / 7),\r\n    );\r\n    return Math.max(1, weekNum);\r\n  }\r\n\r\n  /**\r\n   * Get ISO week year\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getISOWeekYear(temporal: Temporal.PlainDateTime): number {\r\n    const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n    const yearAdjust =\r\n      currentDate.getTime() < new Date(temporal.year, 0, 1).getTime()\r\n        ? -1\r\n        : currentDate.getTime() >= new Date(temporal.year + 1, 0, 1).getTime()\r\n          ? 1\r\n          : 0;\r\n\r\n    return temporal.year + yearAdjust;\r\n  }\r\n\r\n  /**\r\n   * Get week year\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getWeekYear(temporal: Temporal.PlainDateTime): number {\r\n    const yearAdjust =\r\n      temporal.month === 1 && temporal.day < 4\r\n        ? -1\r\n        : temporal.month === 12 && temporal.day > 28\r\n          ? 1\r\n          : 0;\r\n    return temporal.year + yearAdjust;\r\n  }\r\n\r\n  /**\r\n   * Get timezone offset short form\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getTimezoneOffset(): string {\r\n    try {\r\n      const now = new Date();\r\n      const formatter = new Intl.DateTimeFormat('en-US', {\r\n        timeZone: 'UTC',\r\n        timeZoneName: 'short',\r\n      });\r\n      return formatter.formatToParts(now).find(p => p.type === 'timeZoneName')?.value || 'UTC';\r\n    } catch {\r\n      return 'UTC';\r\n    }\r\n  }\r\n\r\n  /**\r\n   * Get timezone offset long form\r\n   */\r\n  // @ts-expect-error - Method called dynamically within replace callback\r\n  private getTimezoneOffsetLong(): string {\r\n    try {\r\n      const now = new Date();\r\n      const formatter = new Intl.DateTimeFormat('en-US', {\r\n        timeZone: 'UTC',\r\n        timeZoneName: 'long',\r\n      });\r\n      return formatter.formatToParts(now).find(p => p.type === 'timeZoneName')?.value || 'Coordinated Universal Time';\r\n    } catch {\r\n      return 'Coordinated Universal Time';\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Create and export default instance\r\n */\r\nexport default new AdvancedFormatPlugin();\r\n"],"mappings":";;AAUA,IAAa,IAAb,MAA8D;CAC5D,OAAO;CACP,UAAU;CAKV,QAAQ,GAAwC;EAE9C,IAAM,IAAiB,EAAe,UAAU;AAK/C,IAAe,UAAkB,SAAS,SAAU,GAAiB;AAMpE,OALI,CAAC,KAAW,OAAO,KAAY,YAK/B,CAAC,qCAAqC,KAAK,EAAQ,CACrD,QAAO,EAAe,KAAK,MAAM,EAAQ;GAI3C,IAAM,IAAW,KAAK,YAAY,EAC5B,IACJ,qBAAqB,IAChB,EAAiB,iBAAiB,GAClC,GAED,KAAa,MAAc;IAC/B,IAAM,IAAW;KAAC;KAAM;KAAM;KAAM;KAAK,EACnC,IAAI,IAAI;AACd,WAAO,KAAK,GAAU,IAAI,MAAM,OAAO,EAAS,MAAM,EAAS;MAE3D,KAAS,GAAW,MAAmB,OAAO,EAAE,CAAC,SAAS,GAAQ,IAAI,EACtE,KAAc,MAAkB;IACpC,IAAM,IAAO,IAAI,KAAK,EAAS,MAAM,GAAG,EAAE,EACpC,IAAa,IAAI,KAAK,EAAK;AACjC,MAAW,QAAQ,EAAK,SAAS,GAAG,EAAK,QAAQ,IAAI,EAAK,QAAQ,KAAK,IAAI,KAAK,GAAG;IACnF,IAAM,IAAc,IAAI,KAAK,EAAS,MAAM,EAAS,QAAQ,GAAG,EAAS,IAAI,EACvE,IAAU,KAAK,OAAO,EAAY,SAAS,GAAG,EAAW,SAAS,KAAK,QAAc,KAAK,KAAM,GAAG;AACzG,WAAO,KAAK,IAAI,GAAG,EAAQ;MAEvB,KAAiB,MAAkB;IACvC,IAAM,IAAU,KAAK,MAAO,EAAS,MAAM,IAAI,KAAK,EAAS,MAAM,EAAS,QAAQ,GAAG,EAAE,CAAC,QAAQ,IAAI,EAAG;AACzG,WAAO,KAAK,IAAI,GAAG,EAAQ;MAEvB,KAAkB,MAAkB;IACxC,IAAM,IAAc,IAAI,KAAK,EAAS,MAAM,EAAS,QAAQ,GAAG,EAAS,IAAI,EACvE,IAAa,EAAY,SAAS,GAAG,IAAI,KAAK,EAAS,MAAM,GAAG,EAAE,CAAC,SAAS,GAAG,KAAK,IAAY,SAAS,IAAI,IAAI,KAAK,EAAS,OAAO,GAAG,GAAG,EAAE,CAAC,SAAS;AAC9J,WAAO,EAAS,OAAO;MAEnB,KAAe,MAAkB;IACrC,IAAM,IAAa,EAAS,UAAU,KAAK,EAAS,MAAM,IAAI,KAAK,IAAS,UAAU,MAAM,EAAS,MAAM;AAC3G,WAAO,EAAS,OAAO;MAIrB,IAAS,EAAQ,QACnB,wCACC,MAAU;IACT,IAAI,IAAc;AAClB,YAAQ,GAAR;KAEE,KAAK;AACH,UAAc,OAAO,KAAK,KAAM,EAAY,QAAS,EAAE,CAAC;AACxD;KAGF,KAAK;AACH,UAAc,EAAU,EAAY,IAAI;AACxC;KAGF,KAAK;KACL,KAAK;AACH,UAAc,EAAM,EAAW,EAAY,EAAE,MAAU,MAAM,IAAI,EAAE;AACnE;KAGF,KAAK;KACL,KAAK;AACH,UAAc,EAAM,EAAc,EAAY,EAAE,MAAU,MAAM,IAAI,EAAE;AACtE;KAGF,KAAK;AACH,UAAc,OAAO,EAAe,EAAY,CAAC;AACjD;KAGF,KAAK;AACH,UAAc,OAAO,EAAY,EAAY,CAAC;AAC9C;KAGF,KAAK;KACL,KAAK;AAEH,UAAc,EADD,EAAY,SAAS,IAAI,KAAK,EAAY,MAC7B,MAAU,MAAM,IAAI,EAAE;AAChD;KAGF,KAAK;AACH,UAAc,OAAO,KAAK,MAAM,KAAK,SAAS,GAAG,IAAK,CAAC;AACvD;KAGF,KAAK;AACH,UAAc,OAAO,KAAK,SAAS,CAAC;AACpC;KAGF,KAAK;AACH,UAAc,GAAG,KAAK,mBAAmB;AACzC;KAEF,KAAK;AACH,UAAc,GAAG,KAAK,uBAAuB;AAC7C;KAEF,QACE,QAAO;;AAGX,WAAO,IAAI,EAAY;KAE1B;AAGD,UAAO,EAAe,KAAK,MAAM,EAAO;;;CAQ5C,WAAmB,GAAmB;EACpC,IAAM,IAAW;GAAC;GAAM;GAAM;GAAM;GAAK,EACnC,IAAI,IAAI;AACd,SAAO,KAAK,GAAU,IAAI,MAAM,OAAO,EAAS,MAAM,EAAS;;CAOjE,UAAkB,GAAW,GAAwB;AACnD,SAAO,OAAO,EAAE,CAAC,SAAS,GAAQ,IAAI;;CAOxC,WAAmB,GAA0C;EAE3D,IAAM,IAAO,IAAI,KAAK,EAAS,MAAM,GAAG,EAAE,EACpC,IAAa,IAAI,KAAK,EAAK;AACjC,IAAW,QAAQ,EAAK,SAAS,GAAG,EAAK,QAAQ,IAAI,EAAK,QAAQ,KAAK,IAAI,KAAK,GAAG;EAEnF,IAAM,IAAc,IAAI,KAAK,EAAS,MAAM,EAAS,QAAQ,GAAG,EAAS,IAAI,EACvE,IAAU,KAAK,OAClB,EAAY,SAAS,GAAG,EAAW,SAAS,KAAK,QAAc,KAAK,KACtE,GAAG;AAEJ,SAAO,KAAK,IAAI,GAAG,EAAQ;;CAO7B,cAAsB,GAA0C;EAC9D,IAAM,IAAU,KAAK,MACjB,EAAS,MAAM,IAAI,KAAK,EAAS,MAAM,EAAS,QAAQ,GAAG,EAAE,CAAC,QAAQ,IAAI,EAC7E;AACD,SAAO,KAAK,IAAI,GAAG,EAAQ;;CAO7B,eAAuB,GAA0C;EAC/D,IAAM,IAAc,IAAI,KAAK,EAAS,MAAM,EAAS,QAAQ,GAAG,EAAS,IAAI,EACvE,IACJ,EAAY,SAAS,GAAG,IAAI,KAAK,EAAS,MAAM,GAAG,EAAE,CAAC,SAAS,GAC3D,KACA,IAAY,SAAS,IAAI,IAAI,KAAK,EAAS,OAAO,GAAG,GAAG,EAAE,CAAC,SAAS;AAI1E,SAAO,EAAS,OAAO;;CAOzB,YAAoB,GAA0C;EAC5D,IAAM,IACJ,EAAS,UAAU,KAAK,EAAS,MAAM,IACnC,KACA,IAAS,UAAU,MAAM,EAAS,MAAM;AAG9C,SAAO,EAAS,OAAO;;CAOzB,oBAAoC;AAClC,MAAI;GACF,IAAM,oBAAM,IAAI,MAAM;AAKtB,UAJkB,IAAI,KAAK,eAAe,SAAS;IACjD,UAAU;IACV,cAAc;IACf,CAAC,CACe,cAAc,EAAI,CAAC,MAAK,MAAK,EAAE,SAAS,eAAe,EAAE,SAAS;UAC7E;AACN,UAAO;;;CAQX,wBAAwC;AACtC,MAAI;GACF,IAAM,oBAAM,IAAI,MAAM;AAKtB,UAJkB,IAAI,KAAK,eAAe,SAAS;IACjD,UAAU;IACV,cAAc;IACf,CAAC,CACe,cAAc,EAAI,CAAC,MAAK,MAAK,EAAE,SAAS,eAAe,EAAE,SAAS;UAC7E;AACN,UAAO;;;GAQb,IAAe,IAAI,GAAsB"}
+{"version":3,"file":"advanced-format.es.js","names":[],"sources":["../../src/plugins/advanced-format/index.ts"],"sourcesContent":["/**\r\n * TimeGuard Advanced Format Plugin\r\n * Adds advanced format tokens: Q (quarter), Do (ordinal), w (week), etc.\r\n * Follows SOLID principles and extends core formatting capabilities\r\n */\r\n\r\nimport type { ITimeGuardPlugin } from '../../types';\r\nimport type { TimeGuard } from '../../time-guard';\r\nimport { Temporal } from '@js-temporal/polyfill';\r\n\r\nexport class AdvancedFormatPlugin implements ITimeGuardPlugin {\r\n  name = 'advanced-format';\r\n  version = '1.0.0';\r\n\r\n  /**\r\n   * Install plugin into TimeGuard\r\n   */\r\n  install(TimeGuardClass: typeof TimeGuard): void {\r\n    // Store original format method\r\n    const originalFormat = TimeGuardClass.prototype.format;\r\n\r\n    /**\r\n     * Extended format method with advanced tokens\r\n     */\r\n    (TimeGuardClass.prototype as any).format = function (pattern: string) {\r\n      if (!pattern || typeof pattern !== 'string') {\r\n        return originalFormat.call(this, pattern);\r\n      }\r\n\r\n      // Check if pattern contains advanced tokens\r\n      if (!/Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/.test(pattern)) {\r\n        return originalFormat.call(this, pattern);\r\n      }\r\n\r\n      // Get the underlying Temporal object\r\n      const temporal = this.toTemporal();\r\n      const temporal_dt =\r\n        'toPlainDateTime' in temporal\r\n          ? (temporal as any).toPlainDateTime()\r\n          : (temporal as Temporal.PlainDateTime);\r\n      \r\n      const ordinalFn = (n: number) => {\r\n        const suffixes = ['th', 'st', 'nd', 'rd'];\r\n        const v = n % 100;\r\n        return n + (suffixes[(v - 20) % 10] || suffixes[v] || suffixes[0]);\r\n      };\r\n      const padFn = (n: number, length: number) => String(n).padStart(length, '0');\r\n      const getISOWeek = (temporal: any) => {\r\n        const jan4 = new Date(temporal.year, 0, 4);\r\n        const week1Start = new Date(jan4);\r\n        week1Start.setDate(jan4.getDate() - jan4.getDay() + (jan4.getDay() === 0 ? -6 : 1));\r\n        const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n        const weekNum = Math.floor((currentDate.getTime() - week1Start.getTime()) / (7 * 24 * 60 * 60 * 1000)) + 1;\r\n        return Math.max(1, weekNum);\r\n      };\r\n      const getWeekOfYear = (temporal: any) => {\r\n        const weekNum = Math.ceil(((temporal.day + new Date(temporal.year, temporal.month - 1, 1).getDay()) / 7));\r\n        return Math.max(1, weekNum);\r\n      };\r\n      const getISOWeekYear = (temporal: any) => {\r\n        const currentDate = new Date(temporal.year, temporal.month - 1, temporal.day);\r\n        const yearAdjust = currentDate.getTime() < new Date(temporal.year, 0, 1).getTime() ? -1 : currentDate.getTime() >= new Date(temporal.year + 1, 0, 1).getTime() ? 1 : 0;\r\n        return temporal.year + yearAdjust;\r\n      };\r\n      const getWeekYear = (temporal: any) => {\r\n        const yearAdjust = temporal.month === 1 && temporal.day < 4 ? -1 : temporal.month === 12 && temporal.day > 28 ? 1 : 0;\r\n        return temporal.year + yearAdjust;\r\n      };\r\n\r\n      // Replace advanced tokens - wrap results in brackets to protect from standard formatter\r\n      let result = pattern.replace(\r\n        /Q|Do|w|W|gggg|GGGG|k{1,2}|X|x|zzz?/g,\r\n        (match) => {\r\n          let replacement = '';\r\n          switch (match) {\r\n            // Quarter\r\n            case 'Q':\r\n              replacement = String(Math.ceil((temporal_dt.month) / 3));\r\n              break;\r\n\r\n            // Ordinal day\r\n            case 'Do':\r\n              replacement = ordinalFn(temporal_dt.day);\r\n              break;\r\n\r\n            // Week of year (ISO)\r\n            case 'W':\r\n            case 'WW':\r\n              replacement = padFn(getISOWeek(temporal_dt), match === 'W' ? 1 : 2);\r\n              break;\r\n\r\n            // Week of year (locale)\r\n            case 'w':\r\n            case 'ww':\r\n              replacement = padFn(getWeekOfYear(temporal_dt), match === 'w' ? 1 : 2);\r\n              break;\r\n\r\n            // ISO week year\r\n            case 'GGGG':\r\n              replacement = String(getISOWeekYear(temporal_dt));\r\n              break;\r\n\r\n            // Week year\r\n            case 'gggg':\r\n              replacement = String(getWeekYear(temporal_dt));\r\n              break;\r\n\r\n            // Hour (1-24)\r\n            case 'k':\r\n            case 'kk':\r\n              const hour = temporal_dt.hour === 0 ? 24 : temporal_dt.hour;\r\n              replacement = padFn(hour, match === 'k' ? 1 : 2);\r\n              break;\r\n\r\n            // Unix seconds timestamp\r\n            case 'X':\r\n              replacement = String(Math.floor(this.valueOf() / 1000));\r\n              break;\r\n\r\n            // Unix milliseconds timestamp\r\n            case 'x':\r\n              replacement = String(this.valueOf());\r\n              break;\r\n\r\n            // Timezone offset\r\n            case 'z':\r\n              replacement = `${this.getTimezoneOffset()}`;\r\n              break;\r\n\r\n            case 'zzz':\r\n              replacement = `${this.getTimezoneOffsetLong()}`;\r\n              break;\r\n\r\n            default:\r\n              return match;\r\n          }\r\n          // Wrap in brackets to protect from standard formatter\r\n          return `[${replacement}]`;\r\n        },\r\n      );\r\n\r\n      // Apply standard format to the result\r\n      return originalFormat.call(this, result);\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Create and export default instance\r\n */\r\nexport default new AdvancedFormatPlugin();\r\n"],"mappings":"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"}

package/dist/plugins/duration.es.js

@@ -1,4 +1,4 @@
-/*! time-guard v2.5.1 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
+/*! time-guard v2.5.2 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
 //#region src/plugins/duration/index.ts
 var e = class e {
 	years = 0;

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

@@ -1,4 +1,4 @@
-/*! time-guard v2.5.1 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
+/*! time-guard v2.5.2 | (c) 2026 Berea-Soft | MIT License | https://github.com/Berea-Soft/time-guard */
 //#region src/plugins/relative-time/index.ts
 var e = [
 	{