arabic-datetime 1.0.0

package/dist/arabic-datetime.js

@@ -0,0 +1,354 @@
+var __typeError = (msg) => {
+  throw TypeError(msg);
+};
+var __accessCheck = (obj, member, msg) => member.has(obj) || __typeError("Cannot " + msg);
+var __privateGet = (obj, member, getter) => (__accessCheck(obj, member, "read from private field"), getter ? getter.call(obj) : member.get(obj));
+var __privateAdd = (obj, member, value) => member.has(obj) ? __typeError("Cannot add the same private member more than once") : member instanceof WeakSet ? member.add(obj) : member.set(obj, value);
+var __privateSet = (obj, member, value, setter) => (__accessCheck(obj, member, "write to private field"), setter ? setter.call(obj, value) : member.set(obj, value), value);
+var _date, _year, _monthIndex, _day, _time, _hour, _minute, _second, _milliseconds;
+const AR_NUMS = {
+  "0": "٠",
+  "1": "١",
+  "2": "٢",
+  "3": "٣",
+  "4": "٤",
+  "5": "٥",
+  "6": "٦",
+  "7": "٧",
+  "8": "٨",
+  "9": "٩"
+};
+const MONTH_GROUP_NAMES = [
+  "syriac",
+  "roman1",
+  "roman2",
+  "roman3",
+  "french"
+];
+const COUNTRY_CODES = [
+  "IQ",
+  "JO",
+  "LB",
+  "PS",
+  "SO",
+  "SY",
+  "BH",
+  "KM",
+  "DJ",
+  "EG",
+  "KW",
+  "LY",
+  "OM",
+  "QA",
+  "SA",
+  "SD",
+  "AE",
+  "YE",
+  "MA",
+  "MR",
+  "DZ",
+  "TN"
+];
+const isCountryCode = (value) => COUNTRY_CODES.includes(value);
+const MONTH_GROUPS = {
+  syriac: {
+    eastNums: true,
+    months: [
+      "كانون الثاني",
+      "شباط",
+      "آذار",
+      "نيسان",
+      "أيار",
+      "حزيران",
+      "تموز",
+      "آب",
+      "أيلول",
+      "تشرين الأول",
+      "تشرين الثاني",
+      "كانون الأول"
+    ],
+    countries: ["IQ", "JO", "LB", "PS", "SY"]
+  },
+  roman1: {
+    eastNums: true,
+    months: [
+      "يناير",
+      "فبراير",
+      "مارس",
+      "أبريل",
+      "مايو",
+      "يونيو",
+      "يوليو",
+      "أغسطس",
+      "سبتمبر",
+      "أكتوبر",
+      "نوفمبر",
+      "ديسمبر"
+    ],
+    countries: ["BH", "KM", "DJ", "EG", "KW", "LY", "OM", "QA", "SA", "SO", "SD", "AE", "YE"]
+  },
+  roman2: {
+    eastNums: false,
+    months: [
+      "يناير",
+      "فبراير",
+      "مارس",
+      "أبريل",
+      "ماي",
+      "يونيو",
+      "يوليوز",
+      "غشت",
+      "شتنبر",
+      "أكتوبر",
+      "نونبر",
+      "دجنبر"
+    ],
+    countries: ["MA"]
+  },
+  roman3: {
+    eastNums: false,
+    months: [
+      "يناير",
+      "فبراير",
+      "مارس",
+      "إبريل",
+      "مايو",
+      "يونيو",
+      "يوليو",
+      "أغشت",
+      "شتمبر",
+      "أكتوبر",
+      "نوفمبر",
+      "ديسمبر"
+    ],
+    countries: ["MR"]
+  },
+  french: {
+    eastNums: false,
+    months: [
+      "جانفي",
+      "فيفري",
+      "مارس",
+      "أفريل",
+      "ماي",
+      "جوان",
+      "جويلية",
+      "أوت",
+      "سبتمبر",
+      "أكتوبر",
+      "نوفمبر",
+      "ديسمبر"
+    ],
+    countries: ["DZ", "TN"]
+  }
+};
+const WESTERN_DIGIT_PATTERN = /[0-9]/g;
+const toArabicDigits = (value) => value.replace(WESTERN_DIGIT_PATTERN, (digit) => AR_NUMS[digit]);
+const isValidDate = (value) => value instanceof Date && !Number.isNaN(value.valueOf());
+class ArabicDate {
+  constructor(dateObject) {
+    __privateAdd(this, _date);
+    __privateAdd(this, _year);
+    __privateAdd(this, _monthIndex);
+    __privateAdd(this, _day);
+    this.setDate(dateObject);
+  }
+  get dateObject() {
+    return new Date(__privateGet(this, _date));
+  }
+  set dateObject(value) {
+    this.setDate(value);
+  }
+  syriacNames(eastNums = false) {
+    this.assertBoolean(eastNums, "syriacNames");
+    return this.composeGroupFormat("syriac", eastNums);
+  }
+  roman1Names(eastNums = false) {
+    this.assertBoolean(eastNums, "roman1Names");
+    return this.composeGroupFormat("roman1", eastNums);
+  }
+  roman2Names(eastNums = false) {
+    this.assertBoolean(eastNums, "roman2Names");
+    return this.composeGroupFormat("roman2", eastNums);
+  }
+  roman3Names(eastNums = false) {
+    this.assertBoolean(eastNums, "roman3Names");
+    return this.composeGroupFormat("roman3", eastNums);
+  }
+  frenchNames(eastNums = false) {
+    this.assertBoolean(eastNums, "frenchNames");
+    return this.composeGroupFormat("french", eastNums);
+  }
+  dualNames(first, second, eastNums = false) {
+    this.assertString(first, "first", "dualNames");
+    this.assertString(second, "second", "dualNames");
+    this.assertBoolean(eastNums, "dualNames");
+    const normalizedFirst = this.normalizeGroupName(first, "first", "dualNames");
+    const normalizedSecond = this.normalizeGroupName(second, "second", "dualNames");
+    if (normalizedFirst === normalizedSecond) {
+      throw new Error(
+        "ArabicDate class error: The first group name and the second group name should not be identical in the parameters passed to the method 'dualNames'."
+      );
+    }
+    const day = this.formatDay(eastNums);
+    const year = this.formatYear(eastNums);
+    const firstMonth = MONTH_GROUPS[normalizedFirst].months[__privateGet(this, _monthIndex)];
+    const secondMonth = MONTH_GROUPS[normalizedSecond].months[__privateGet(this, _monthIndex)];
+    return `${day} ${firstMonth} (${secondMonth}) ${year}`;
+  }
+  byCountryCode(countryCode, eastNums) {
+    this.assertString(countryCode, "country_code", "byCountryCode");
+    if (eastNums !== void 0) {
+      this.assertBoolean(eastNums, "byCountryCode");
+    }
+    const normalizedCode = countryCode.trim().toUpperCase();
+    if (!normalizedCode) {
+      throw new Error(
+        "ArabicDate class error: Unknown country code '' passed to the class method 'byCountryCode'."
+      );
+    }
+    if (!isCountryCode(normalizedCode)) {
+      throw new Error(
+        `ArabicDate class error: Unknown country code '${countryCode}' passed to the class method 'byCountryCode'.`
+      );
+    }
+    for (const groupName of MONTH_GROUP_NAMES) {
+      const group = MONTH_GROUPS[groupName];
+      if (group.countries.includes(normalizedCode)) {
+        const east = eastNums ?? group.eastNums;
+        return this.composeGroupFormat(groupName, east);
+      }
+    }
+    throw new Error(
+      `ArabicDate class error: Unknown country code '${countryCode}' passed to the class method 'byCountryCode'.`
+    );
+  }
+  easternNumericDate(separator = "/") {
+    this.assertString(separator, "separator", "easternNumericDate");
+    const month = (__privateGet(this, _monthIndex) + 1).toString();
+    return [__privateGet(this, _day), month, __privateGet(this, _year)].map(toArabicDigits).join(separator);
+  }
+  setDate(value) {
+    if (!isValidDate(value)) {
+      const message = value instanceof Date ? "ArabicDate class error: The parameter passed as dateObject is an invalid Date. Only valid Date objects are allowed." : "ArabicDate class error: The parameter passed as dateObject is not a Date. Only Date objects are allowed.";
+      throw new TypeError(message);
+    }
+    __privateSet(this, _date, new Date(value));
+    __privateSet(this, _year, __privateGet(this, _date).getFullYear().toString());
+    __privateSet(this, _monthIndex, __privateGet(this, _date).getMonth());
+    __privateSet(this, _day, __privateGet(this, _date).getDate().toString());
+  }
+  composeGroupFormat(groupName, eastNums) {
+    const day = this.formatDay(eastNums);
+    const month = MONTH_GROUPS[groupName].months[__privateGet(this, _monthIndex)];
+    const year = this.formatYear(eastNums);
+    return `${day} ${month} ${year}`;
+  }
+  formatDay(eastNums) {
+    return eastNums ? toArabicDigits(__privateGet(this, _day)) : __privateGet(this, _day);
+  }
+  formatYear(eastNums) {
+    return eastNums ? toArabicDigits(__privateGet(this, _year)) : __privateGet(this, _year);
+  }
+  assertBoolean(value, methodName) {
+    if (typeof value !== "boolean") {
+      throw new TypeError(
+        `ArabicDate class error: east_nums must be a boolean. '${String(value)}' is not a boolean and was passed to the class method '${methodName}'.`
+      );
+    }
+  }
+  assertString(value, parameterName, methodName) {
+    if (typeof value !== "string") {
+      throw new TypeError(
+        `ArabicDate class error: The '${parameterName}' parameter passed to the class method '${methodName}' is not a string.`
+      );
+    }
+  }
+  normalizeGroupName(value, descriptor, methodName) {
+    const normalized = value.trim().toLowerCase();
+    const match = MONTH_GROUP_NAMES.find((group) => group === normalized);
+    if (!match) {
+      throw new Error(
+        `ArabicDate class error: Unknown ${descriptor} group name '${value}' passed to the class method '${methodName}'.`
+      );
+    }
+    return match;
+  }
+}
+_date = new WeakMap();
+_year = new WeakMap();
+_monthIndex = new WeakMap();
+_day = new WeakMap();
+const VALID_FORMATS = /* @__PURE__ */ new Set(["H", "HM", "HMS", "HMSF"]);
+const normalizeFormat = (format) => {
+  const value = format.toUpperCase();
+  if (!VALID_FORMATS.has(value)) {
+    throw new Error(
+      "ArabicTime class error: Invalid format string passed to the class method 'time'. Valid values are 'HMSF', 'HMS', 'HM' and 'H'."
+    );
+  }
+  return value;
+};
+class ArabicTime {
+  constructor(timeObject) {
+    __privateAdd(this, _time);
+    __privateAdd(this, _hour);
+    __privateAdd(this, _minute);
+    __privateAdd(this, _second);
+    __privateAdd(this, _milliseconds);
+    this.setTime(timeObject);
+  }
+  get timeObject() {
+    return new Date(__privateGet(this, _time));
+  }
+  set timeObject(value) {
+    this.setTime(value);
+  }
+  time(format = "HMS", separator = ":") {
+    this.assertString(format, "format", "time");
+    this.assertString(separator, "separator", "time");
+    const normalizedFormat = normalizeFormat(format);
+    const formattedParts = [];
+    if (normalizedFormat.includes("H")) {
+      formattedParts.push(toArabicDigits(__privateGet(this, _hour)));
+    }
+    if (normalizedFormat.includes("M")) {
+      formattedParts.push(toArabicDigits(__privateGet(this, _minute)));
+    }
+    if (normalizedFormat.includes("S")) {
+      formattedParts.push(toArabicDigits(__privateGet(this, _second)));
+    }
+    if (normalizedFormat.includes("F")) {
+      formattedParts.push(toArabicDigits(__privateGet(this, _milliseconds)));
+    }
+    return formattedParts.join(separator);
+  }
+  setTime(value) {
+    if (!isValidDate(value)) {
+      const message = value instanceof Date ? "ArabicTime class error: The parameter passed as timeObject is an invalid Date. Only valid Date objects are allowed." : "ArabicTime class error: The parameter passed as timeObject is not a Date. Only Date objects are allowed.";
+      throw new TypeError(message);
+    }
+    __privateSet(this, _time, new Date(value));
+    __privateSet(this, _hour, __privateGet(this, _time).getHours().toString());
+    __privateSet(this, _minute, __privateGet(this, _time).getMinutes().toString());
+    __privateSet(this, _second, __privateGet(this, _time).getSeconds().toString());
+    __privateSet(this, _milliseconds, __privateGet(this, _time).getMilliseconds().toString().padStart(3, "0"));
+  }
+  assertString(value, parameterName, methodName) {
+    if (typeof value !== "string") {
+      throw new TypeError(
+        `ArabicTime class error: The '${parameterName}' parameter passed to the class method '${methodName}' is not a string.`
+      );
+    }
+  }
+}
+_time = new WeakMap();
+_hour = new WeakMap();
+_minute = new WeakMap();
+_second = new WeakMap();
+_milliseconds = new WeakMap();
+export {
+  ArabicDate,
+  ArabicTime
+};
+//# sourceMappingURL=arabic-datetime.js.map

package/dist/arabic-datetime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arabic-datetime.js","sources":["../src/constants.ts","../src/arabicNumerals.ts","../src/validators.ts","../src/arabicDate.ts","../src/arabicTime.ts"],"sourcesContent":["/** @internal */\nexport const AR_NUMS = {\n  \"0\": \"٠\",\n  \"1\": \"١\",\n  \"2\": \"٢\",\n  \"3\": \"٣\",\n  \"4\": \"٤\",\n  \"5\": \"٥\",\n  \"6\": \"٦\",\n  \"7\": \"٧\",\n  \"8\": \"٨\",\n  \"9\": \"٩\"\n} as const;\n\n/** @internal */\nexport type ArabicDigit = keyof typeof AR_NUMS;\n\n/** @internal */\nexport const MONTH_GROUP_NAMES = [\n  \"syriac\",\n  \"roman1\",\n  \"roman2\",\n  \"roman3\",\n  \"french\"\n] as const;\n\n/** @internal */\nexport type MonthGroupName = (typeof MONTH_GROUP_NAMES)[number];\n\n/** @internal */\nexport const COUNTRY_CODES = [\n  \"IQ\",\n  \"JO\",\n  \"LB\",\n  \"PS\",\n  \"SO\",\n  \"SY\",\n  \"BH\",\n  \"KM\",\n  \"DJ\",\n  \"EG\",\n  \"KW\",\n  \"LY\",\n  \"OM\",\n  \"QA\",\n  \"SA\",\n  \"SD\",\n  \"AE\",\n  \"YE\",\n  \"MA\",\n  \"MR\",\n  \"DZ\",\n  \"TN\"\n] as const;\n\n/** @internal */\nexport type CountryCode = (typeof COUNTRY_CODES)[number];\n\n/** @internal */\nexport const isCountryCode = (value: string): value is CountryCode =>\n  COUNTRY_CODES.includes(value as CountryCode);\n\n/** @internal */\nexport type MonthGroup = {\n  readonly eastNums: boolean;\n  readonly months: readonly [\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string,\n    string\n  ];\n  readonly countries: readonly CountryCode[];\n};\n\n/** @internal */\nexport const MONTH_GROUPS: Record<MonthGroupName, MonthGroup> = {\n  syriac: {\n    eastNums: true,\n    months: [\n      \"كانون الثاني\",\n      \"شباط\",\n      \"آذار\",\n      \"نيسان\",\n      \"أيار\",\n      \"حزيران\",\n      \"تموز\",\n      \"آب\",\n      \"أيلول\",\n      \"تشرين الأول\",\n      \"تشرين الثاني\",\n      \"كانون الأول\"\n    ] as const,\n    countries: [\"IQ\", \"JO\", \"LB\", \"PS\", \"SY\"] as const\n  },\n  roman1: {\n    eastNums: true,\n    months: [\n      \"يناير\",\n      \"فبراير\",\n      \"مارس\",\n      \"أبريل\",\n      \"مايو\",\n      \"يونيو\",\n      \"يوليو\",\n      \"أغسطس\",\n      \"سبتمبر\",\n      \"أكتوبر\",\n      \"نوفمبر\",\n      \"ديسمبر\"\n    ] as const,\n    countries: [\"BH\", \"KM\", \"DJ\", \"EG\", \"KW\", \"LY\", \"OM\", \"QA\", \"SA\", \"SO\", \"SD\", \"AE\", \"YE\"] as const\n  },\n  roman2: {\n    eastNums: false,\n    months: [\n      \"يناير\",\n      \"فبراير\",\n      \"مارس\",\n      \"أبريل\",\n      \"ماي\",\n      \"يونيو\",\n      \"يوليوز\",\n      \"غشت\",\n      \"شتنبر\",\n      \"أكتوبر\",\n      \"نونبر\",\n      \"دجنبر\"\n    ] as const,\n    countries: [\"MA\"] as const\n  },\n  roman3: {\n    eastNums: false,\n    months: [\n      \"يناير\",\n      \"فبراير\",\n      \"مارس\",\n      \"إبريل\",\n      \"مايو\",\n      \"يونيو\",\n      \"يوليو\",\n      \"أغشت\",\n      \"شتمبر\",\n      \"أكتوبر\",\n      \"نوفمبر\",\n      \"ديسمبر\"\n    ] as const,\n    countries: [\"MR\"] as const\n  },\n  french: {\n    eastNums: false,\n    months: [\n      \"جانفي\",\n      \"فيفري\",\n      \"مارس\",\n      \"أفريل\",\n      \"ماي\",\n      \"جوان\",\n      \"جويلية\",\n      \"أوت\",\n      \"سبتمبر\",\n      \"أكتوبر\",\n      \"نوفمبر\",\n      \"ديسمبر\"\n    ] as const,\n    countries: [\"DZ\", \"TN\"] as const\n  }\n};\n","import { AR_NUMS, type ArabicDigit } from './constants';\n\n\nconst WESTERN_DIGIT_PATTERN = /[0-9]/g;\n\n/** @internal */\nexport const toArabicDigits = (value: string): string =>\n  value.replace(WESTERN_DIGIT_PATTERN, (digit) => AR_NUMS[digit as ArabicDigit]);\n","/** @internal */\nexport const isValidDate = (value: unknown): value is Date =>\n  value instanceof Date && !Number.isNaN(value.valueOf());\n","import { MONTH_GROUPS, MONTH_GROUP_NAMES, isCountryCode, type MonthGroupName } from './constants';\nimport { toArabicDigits } from './arabicNumerals';\nimport { isValidDate } from './validators';\n\nexport class ArabicDate {\n  #date!: Date;\n  #year!: string;\n  #monthIndex!: number;\n  #day!: string;\n\n  constructor(dateObject: Date) {\n    this.setDate(dateObject);\n  }\n\n  get dateObject(): Date {\n    return new Date(this.#date);\n  }\n\n  set dateObject(value: Date) {\n    this.setDate(value);\n  }\n\n  syriacNames(eastNums: boolean = false): string {\n    this.assertBoolean(eastNums, 'syriacNames');\n    return this.composeGroupFormat('syriac', eastNums);\n  }\n\n  roman1Names(eastNums: boolean = false): string {\n    this.assertBoolean(eastNums, 'roman1Names');\n    return this.composeGroupFormat('roman1', eastNums);\n  }\n\n  roman2Names(eastNums: boolean = false): string {\n    this.assertBoolean(eastNums, 'roman2Names');\n    return this.composeGroupFormat('roman2', eastNums);\n  }\n\n  roman3Names(eastNums: boolean = false): string {\n    this.assertBoolean(eastNums, 'roman3Names');\n    return this.composeGroupFormat('roman3', eastNums);\n  }\n\n  frenchNames(eastNums: boolean = false): string {\n    this.assertBoolean(eastNums, 'frenchNames');\n    return this.composeGroupFormat('french', eastNums);\n  }\n\n  dualNames(first: string, second: string, eastNums: boolean = false): string {\n    this.assertString(first, 'first', 'dualNames');\n    this.assertString(second, 'second', 'dualNames');\n    this.assertBoolean(eastNums, 'dualNames');\n\n    const normalizedFirst = this.normalizeGroupName(first, 'first', 'dualNames');\n    const normalizedSecond = this.normalizeGroupName(second, 'second', 'dualNames');\n\n    if (normalizedFirst === normalizedSecond) {\n      throw new Error(\n        \"ArabicDate class error: The first group name and the second group name should not be identical in the parameters passed to the method 'dualNames'.\"\n      );\n    }\n\n    const day = this.formatDay(eastNums);\n    const year = this.formatYear(eastNums);\n    const firstMonth = MONTH_GROUPS[normalizedFirst].months[this.#monthIndex];\n    const secondMonth = MONTH_GROUPS[normalizedSecond].months[this.#monthIndex];\n\n    return `${day} ${firstMonth} (${secondMonth}) ${year}`;\n  }\n\n  byCountryCode(countryCode: string, eastNums?: boolean): string {\n    this.assertString(countryCode, 'country_code', 'byCountryCode');\n\n    if (eastNums !== undefined) {\n      this.assertBoolean(eastNums, 'byCountryCode');\n    }\n\n    const normalizedCode = countryCode.trim().toUpperCase();\n    if (!normalizedCode) {\n      throw new Error(\n        \"ArabicDate class error: Unknown country code '' passed to the class method 'byCountryCode'.\"\n      );\n    }\n\n    if (!isCountryCode(normalizedCode)) {\n      throw new Error(\n        `ArabicDate class error: Unknown country code '${countryCode}' passed to the class method 'byCountryCode'.`\n      );\n    }\n\n    for (const groupName of MONTH_GROUP_NAMES) {\n      const group = MONTH_GROUPS[groupName];\n      if (group.countries.includes(normalizedCode)) {\n        const east = eastNums ?? group.eastNums;\n        return this.composeGroupFormat(groupName, east);\n      }\n    }\n\n    throw new Error(\n      `ArabicDate class error: Unknown country code '${countryCode}' passed to the class method 'byCountryCode'.`\n    );\n  }\n\n  easternNumericDate(separator: string = '/'): string {\n    this.assertString(separator, 'separator', 'easternNumericDate');\n    const month = (this.#monthIndex + 1).toString();\n    return [this.#day, month, this.#year].map(toArabicDigits).join(separator);\n  }\n\n  private setDate(value: unknown): void {\n    if (!isValidDate(value)) {\n      const message = value instanceof Date\n        ? \"ArabicDate class error: The parameter passed as dateObject is an invalid Date. Only valid Date objects are allowed.\"\n        : \"ArabicDate class error: The parameter passed as dateObject is not a Date. Only Date objects are allowed.\";\n      throw new TypeError(message);\n    }\n\n    this.#date = new Date(value);\n    this.#year = this.#date.getFullYear().toString();\n    this.#monthIndex = this.#date.getMonth();\n    this.#day = this.#date.getDate().toString();\n  }\n\n  private composeGroupFormat(groupName: MonthGroupName, eastNums: boolean): string {\n    const day = this.formatDay(eastNums);\n    const month = MONTH_GROUPS[groupName].months[this.#monthIndex];\n    const year = this.formatYear(eastNums);\n    return `${day} ${month} ${year}`;\n  }\n\n  private formatDay(eastNums: boolean): string {\n    return eastNums ? toArabicDigits(this.#day) : this.#day;\n  }\n\n  private formatYear(eastNums: boolean): string {\n    return eastNums ? toArabicDigits(this.#year) : this.#year;\n  }\n\n  private assertBoolean(value: unknown, methodName: string): asserts value is boolean {\n    if (typeof value !== 'boolean') {\n      throw new TypeError(\n        `ArabicDate class error: east_nums must be a boolean. '${String(value)}' is not a boolean and was passed to the class method '${methodName}'.`\n      );\n    }\n  }\n\n  private assertString(value: unknown, parameterName: string, methodName: string): asserts value is string {\n    if (typeof value !== 'string') {\n      throw new TypeError(\n        `ArabicDate class error: The '${parameterName}' parameter passed to the class method '${methodName}' is not a string.`\n      );\n    }\n  }\n\n  private normalizeGroupName(value: string, descriptor: string, methodName: string): MonthGroupName {\n    const normalized = value.trim().toLowerCase();\n    const match = MONTH_GROUP_NAMES.find((group) => group === normalized);\n\n    if (!match) {\n      throw new Error(\n        `ArabicDate class error: Unknown ${descriptor} group name '${value}' passed to the class method '${methodName}'.`\n      );\n    }\n\n    return match;\n  }\n}\n","import { toArabicDigits } from './arabicNumerals';\nimport { isValidDate } from './validators';\n\nconst VALID_FORMATS = new Set(['H', 'HM', 'HMS', 'HMSF']);\n\ntype AcceptedFormat = 'H' | 'HM' | 'HMS' | 'HMSF';\n\nconst normalizeFormat = (format: string): AcceptedFormat => {\n  const value = format.toUpperCase();\n  if (!VALID_FORMATS.has(value)) {\n    throw new Error(\n      \"ArabicTime class error: Invalid format string passed to the class method 'time'. Valid values are 'HMSF', 'HMS', 'HM' and 'H'.\"\n    );\n  }\n  return value as AcceptedFormat;\n};\n\nexport class ArabicTime {\n  #time!: Date;\n  #hour!: string;\n  #minute!: string;\n  #second!: string;\n  #milliseconds!: string;\n\n  constructor(timeObject: Date) {\n    this.setTime(timeObject);\n  }\n\n  get timeObject(): Date {\n    return new Date(this.#time);\n  }\n\n  set timeObject(value: Date) {\n    this.setTime(value);\n  }\n\n  time(format: string = 'HMS', separator: string = ':'): string {\n    this.assertString(format, 'format', 'time');\n    this.assertString(separator, 'separator', 'time');\n\n    const normalizedFormat = normalizeFormat(format);\n    const formattedParts: string[] = [];\n\n    if (normalizedFormat.includes('H')) {\n      formattedParts.push(toArabicDigits(this.#hour));\n    }\n    if (normalizedFormat.includes('M')) {\n      formattedParts.push(toArabicDigits(this.#minute));\n    }\n    if (normalizedFormat.includes('S')) {\n      formattedParts.push(toArabicDigits(this.#second));\n    }\n    if (normalizedFormat.includes('F')) {\n      formattedParts.push(toArabicDigits(this.#milliseconds));\n    }\n\n    return formattedParts.join(separator);\n  }\n\n  private setTime(value: unknown): void {\n    if (!isValidDate(value)) {\n      const message = value instanceof Date\n        ? \"ArabicTime class error: The parameter passed as timeObject is an invalid Date. Only valid Date objects are allowed.\"\n        : \"ArabicTime class error: The parameter passed as timeObject is not a Date. Only Date objects are allowed.\";\n      throw new TypeError(message);\n    }\n\n    this.#time = new Date(value);\n    this.#hour = this.#time.getHours().toString();\n    this.#minute = this.#time.getMinutes().toString();\n    this.#second = this.#time.getSeconds().toString();\n    this.#milliseconds = this.#time.getMilliseconds().toString().padStart(3, '0');\n  }\n\n  private assertString(value: unknown, parameterName: string, methodName: string): asserts value is string {\n    if (typeof value !== 'string') {\n      throw new TypeError(\n        `ArabicTime class error: The '${parameterName}' parameter passed to the class method '${methodName}' is not a string.`\n      );\n    }\n  }\n}\n"],"names":[],"mappings":"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"}

package/dist/types/arabicDate.d.ts

@@ -0,0 +1,22 @@
+export declare class ArabicDate {
+    #private;
+    constructor(dateObject: Date);
+    get dateObject(): Date;
+    set dateObject(value: Date);
+    syriacNames(eastNums?: boolean): string;
+    roman1Names(eastNums?: boolean): string;
+    roman2Names(eastNums?: boolean): string;
+    roman3Names(eastNums?: boolean): string;
+    frenchNames(eastNums?: boolean): string;
+    dualNames(first: string, second: string, eastNums?: boolean): string;
+    byCountryCode(countryCode: string, eastNums?: boolean): string;
+    easternNumericDate(separator?: string): string;
+    private setDate;
+    private composeGroupFormat;
+    private formatDay;
+    private formatYear;
+    private assertBoolean;
+    private assertString;
+    private normalizeGroupName;
+}
+//# sourceMappingURL=arabicDate.d.ts.map

package/dist/types/arabicDate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arabicDate.d.ts","sourceRoot":"","sources":["../../src/arabicDate.ts"],"names":[],"mappings":"AAIA,qBAAa,UAAU;;gBAMT,UAAU,EAAE,IAAI;IAI5B,IAAI,UAAU,IAAI,IAAI,CAErB;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,IAAI,EAEzB;IAED,WAAW,CAAC,QAAQ,GAAE,OAAe,GAAG,MAAM;IAK9C,WAAW,CAAC,QAAQ,GAAE,OAAe,GAAG,MAAM;IAK9C,WAAW,CAAC,QAAQ,GAAE,OAAe,GAAG,MAAM;IAK9C,WAAW,CAAC,QAAQ,GAAE,OAAe,GAAG,MAAM;IAK9C,WAAW,CAAC,QAAQ,GAAE,OAAe,GAAG,MAAM;IAK9C,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,GAAE,OAAe,GAAG,MAAM;IAsB3E,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,MAAM;IAiC9D,kBAAkB,CAAC,SAAS,GAAE,MAAY,GAAG,MAAM;IAMnD,OAAO,CAAC,OAAO;IAcf,OAAO,CAAC,kBAAkB;IAO1B,OAAO,CAAC,SAAS;IAIjB,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,kBAAkB;CAY3B"}

package/dist/types/arabicTime.d.ts

@@ -0,0 +1,10 @@
+export declare class ArabicTime {
+    #private;
+    constructor(timeObject: Date);
+    get timeObject(): Date;
+    set timeObject(value: Date);
+    time(format?: string, separator?: string): string;
+    private setTime;
+    private assertString;
+}
+//# sourceMappingURL=arabicTime.d.ts.map

package/dist/types/arabicTime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arabicTime.d.ts","sourceRoot":"","sources":["../../src/arabicTime.ts"],"names":[],"mappings":"AAiBA,qBAAa,UAAU;;gBAOT,UAAU,EAAE,IAAI;IAI5B,IAAI,UAAU,IAAI,IAAI,CAErB;IAED,IAAI,UAAU,CAAC,KAAK,EAAE,IAAI,EAEzB;IAED,IAAI,CAAC,MAAM,GAAE,MAAc,EAAE,SAAS,GAAE,MAAY,GAAG,MAAM;IAuB7D,OAAO,CAAC,OAAO;IAef,OAAO,CAAC,YAAY;CAOrB"}

package/dist/types/index.d.ts

@@ -0,0 +1,3 @@
+export { ArabicDate } from './arabicDate';
+export { ArabicTime } from './arabicTime';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "arabic-datetime",
+  "version": "1.0.0",
+  "description": "Arabic datetime formatter",
+  "type": "module",
+  "main": "./dist/arabic-datetime.cjs",
+  "module": "./dist/arabic-datetime.js",
+  "types": "./dist/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/arabic-datetime.js",
+      "require": "./dist/arabic-datetime.cjs"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE.txt"
+  ],
+  "scripts": {
+    "dev": "vite dev",
+    "build": "vite build && npm run build:types",
+    "build:types": "tsc --emitDeclarationOnly --outDir dist/types && node scripts/prune-types.mjs",
+    "preview": "vite preview",
+    "lint": "eslint . --ext .ts",
+    "test": "vitest run",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "arabic",
+    "datetime",
+    "formatting"
+  ],
+  "author": "Khaldevmedia",
+  "license": "GPL",
+  "devDependencies": {
+    "@types/node": "^25.4.0",
+    "@typescript-eslint/eslint-plugin": "^8.57.0",
+    "@typescript-eslint/parser": "^8.57.0",
+    "eslint": "^10.0.3",
+    "typescript": "^5.9.3",
+    "vite": "^6.0.5",
+    "vitest": "^4.0.18"
+  }
+}