@craftguild/jscalendar 0.5.2 → 0.5.4

package/dist/index.d.mts

@@ -0,0 +1,802 @@
+//#region src/timezones.d.ts
+type TimeZoneId$1 = "Africa/Abidjan" | "Africa/Accra" | "Africa/Addis_Ababa" | "Africa/Algiers" | "Africa/Asmara" | "Africa/Bamako" | "Africa/Bangui" | "Africa/Banjul" | "Africa/Bissau" | "Africa/Blantyre" | "Africa/Brazzaville" | "Africa/Bujumbura" | "Africa/Cairo" | "Africa/Casablanca" | "Africa/Ceuta" | "Africa/Conakry" | "Africa/Dakar" | "Africa/Dar_es_Salaam" | "Africa/Djibouti" | "Africa/Douala" | "Africa/El_Aaiun" | "Africa/Freetown" | "Africa/Gaborone" | "Africa/Harare" | "Africa/Johannesburg" | "Africa/Juba" | "Africa/Kampala" | "Africa/Khartoum" | "Africa/Kigali" | "Africa/Kinshasa" | "Africa/Lagos" | "Africa/Libreville" | "Africa/Lome" | "Africa/Luanda" | "Africa/Lubumbashi" | "Africa/Lusaka" | "Africa/Malabo" | "Africa/Maputo" | "Africa/Maseru" | "Africa/Mbabane" | "Africa/Mogadishu" | "Africa/Monrovia" | "Africa/Nairobi" | "Africa/Ndjamena" | "Africa/Niamey" | "Africa/Nouakchott" | "Africa/Ouagadougou" | "Africa/Porto-Novo" | "Africa/Sao_Tome" | "Africa/Tripoli" | "Africa/Tunis" | "Africa/Windhoek" | "America/Adak" | "America/Anchorage" | "America/Anguilla" | "America/Antigua" | "America/Araguaina" | "America/Argentina/Buenos_Aires" | "America/Argentina/Catamarca" | "America/Argentina/Cordoba" | "America/Argentina/Jujuy" | "America/Argentina/La_Rioja" | "America/Argentina/Mendoza" | "America/Argentina/Rio_Gallegos" | "America/Argentina/Salta" | "America/Argentina/San_Juan" | "America/Argentina/San_Luis" | "America/Argentina/Tucuman" | "America/Argentina/Ushuaia" | "America/Aruba" | "America/Asuncion" | "America/Atikokan" | "America/Bahia" | "America/Bahia_Banderas" | "America/Barbados" | "America/Belem" | "America/Belize" | "America/Blanc-Sablon" | "America/Boa_Vista" | "America/Bogota" | "America/Boise" | "America/Cambridge_Bay" | "America/Campo_Grande" | "America/Cancun" | "America/Caracas" | "America/Cayenne" | "America/Cayman" | "America/Chicago" | "America/Chihuahua" | "America/Costa_Rica" | "America/Creston" | "America/Cuiaba" | "America/Curacao" | "America/Danmarkshavn" | "America/Dawson" | "America/Dawson_Creek" | "America/Denver" | "America/Detroit" | "America/Dominica" | "America/Edmonton" | "America/Eirunepe" | "America/El_Salvador" | "America/Fort_Nelson" | "America/Fortaleza" | "America/Glace_Bay" | "America/Godthab" | "America/Goose_Bay" | "America/Grand_Turk" | "America/Grenada" | "America/Guadeloupe" | "America/Guatemala" | "America/Guayaquil" | "America/Guyana" | "America/Halifax" | "America/Havana" | "America/Hermosillo" | "America/Indiana/Indianapolis" | "America/Indiana/Knox" | "America/Indiana/Marengo" | "America/Indiana/Petersburg" | "America/Indiana/Tell_City" | "America/Indiana/Vevay" | "America/Indiana/Vincennes" | "America/Indiana/Winamac" | "America/Inuvik" | "America/Iqaluit" | "America/Jamaica" | "America/Juneau" | "America/Kentucky/Louisville" | "America/Kentucky/Monticello" | "America/Kralendijk" | "America/La_Paz" | "America/Lima" | "America/Los_Angeles" | "America/Lower_Princes" | "America/Maceio" | "America/Managua" | "America/Manaus" | "America/Marigot" | "America/Martinique" | "America/Matamoros" | "America/Mazatlan" | "America/Menominee" | "America/Merida" | "America/Metlakatla" | "America/Mexico_City" | "America/Miquelon" | "America/Moncton" | "America/Monterrey" | "America/Montevideo" | "America/Montserrat" | "America/Nassau" | "America/New_York" | "America/Nipigon" | "America/Nome" | "America/Noronha" | "America/North_Dakota/Beulah" | "America/North_Dakota/Center" | "America/North_Dakota/New_Salem" | "America/Ojinaga" | "America/Panama" | "America/Pangnirtung" | "America/Paramaribo" | "America/Phoenix" | "America/Port-au-Prince" | "America/Port_of_Spain" | "America/Porto_Velho" | "America/Puerto_Rico" | "America/Punta_Arenas" | "America/Rainy_River" | "America/Rankin_Inlet" | "America/Recife" | "America/Regina" | "America/Resolute" | "America/Rio_Branco" | "America/Santarem" | "America/Santiago" | "America/Santo_Domingo" | "America/Sao_Paulo" | "America/Scoresbysund" | "America/Sitka" | "America/St_Barthelemy" | "America/St_Johns" | "America/St_Kitts" | "America/St_Lucia" | "America/St_Thomas" | "America/St_Vincent" | "America/Swift_Current" | "America/Tegucigalpa" | "America/Thule" | "America/Thunder_Bay" | "America/Tijuana" | "America/Toronto" | "America/Tortola" | "America/Vancouver" | "America/Whitehorse" | "America/Winnipeg" | "America/Yakutat" | "America/Yellowknife" | "Antarctica/Casey" | "Antarctica/Davis" | "Antarctica/DumontDUrville" | "Antarctica/Macquarie" | "Antarctica/Mawson" | "Antarctica/McMurdo" | "Antarctica/Palmer" | "Antarctica/Rothera" | "Antarctica/Syowa" | "Antarctica/Troll" | "Antarctica/Vostok" | "Arctic/Longyearbyen" | "Asia/Aden" | "Asia/Almaty" | "Asia/Amman" | "Asia/Anadyr" | "Asia/Aqtau" | "Asia/Aqtobe" | "Asia/Ashgabat" | "Asia/Atyrau" | "Asia/Baghdad" | "Asia/Bahrain" | "Asia/Baku" | "Asia/Bangkok" | "Asia/Barnaul" | "Asia/Beirut" | "Asia/Bishkek" | "Asia/Brunei" | "Asia/Chita" | "Asia/Choibalsan" | "Asia/Colombo" | "Asia/Damascus" | "Asia/Dhaka" | "Asia/Dili" | "Asia/Dubai" | "Asia/Dushanbe" | "Asia/Famagusta" | "Asia/Gaza" | "Asia/Hebron" | "Asia/Ho_Chi_Minh" | "Asia/Hong_Kong" | "Asia/Hovd" | "Asia/Irkutsk" | "Asia/Jakarta" | "Asia/Jayapura" | "Asia/Jerusalem" | "Asia/Kabul" | "Asia/Kamchatka" | "Asia/Karachi" | "Asia/Kathmandu" | "Asia/Khandyga" | "Asia/Kolkata" | "Asia/Krasnoyarsk" | "Asia/Kuala_Lumpur" | "Asia/Kuching" | "Asia/Kuwait" | "Asia/Macau" | "Asia/Magadan" | "Asia/Makassar" | "Asia/Manila" | "Asia/Muscat" | "Asia/Nicosia" | "Asia/Novokuznetsk" | "Asia/Novosibirsk" | "Asia/Omsk" | "Asia/Oral" | "Asia/Phnom_Penh" | "Asia/Pontianak" | "Asia/Pyongyang" | "Asia/Qatar" | "Asia/Qyzylorda" | "Asia/Riyadh" | "Asia/Sakhalin" | "Asia/Samarkand" | "Asia/Seoul" | "Asia/Shanghai" | "Asia/Singapore" | "Asia/Srednekolymsk" | "Asia/Taipei" | "Asia/Tashkent" | "Asia/Tbilisi" | "Asia/Tehran" | "Asia/Thimphu" | "Asia/Tokyo" | "Asia/Tomsk" | "Asia/Ulaanbaatar" | "Asia/Urumqi" | "Asia/Ust-Nera" | "Asia/Vientiane" | "Asia/Vladivostok" | "Asia/Yakutsk" | "Asia/Yangon" | "Asia/Yekaterinburg" | "Asia/Yerevan" | "Atlantic/Azores" | "Atlantic/Bermuda" | "Atlantic/Canary" | "Atlantic/Cape_Verde" | "Atlantic/Faroe" | "Atlantic/Madeira" | "Atlantic/Reykjavik" | "Atlantic/South_Georgia" | "Atlantic/St_Helena" | "Atlantic/Stanley" | "Australia/Adelaide" | "Australia/Brisbane" | "Australia/Broken_Hill" | "Australia/Currie" | "Australia/Darwin" | "Australia/Eucla" | "Australia/Hobart" | "Australia/Lindeman" | "Australia/Lord_Howe" | "Australia/Melbourne" | "Australia/Perth" | "Australia/Sydney" | "Europe/Amsterdam" | "Europe/Andorra" | "Europe/Astrakhan" | "Europe/Athens" | "Europe/Belgrade" | "Europe/Berlin" | "Europe/Bratislava" | "Europe/Brussels" | "Europe/Bucharest" | "Europe/Budapest" | "Europe/Busingen" | "Europe/Chisinau" | "Europe/Copenhagen" | "Europe/Dublin" | "Europe/Gibraltar" | "Europe/Guernsey" | "Europe/Helsinki" | "Europe/Isle_of_Man" | "Europe/Istanbul" | "Europe/Jersey" | "Europe/Kaliningrad" | "Europe/Kiev" | "Europe/Kirov" | "Europe/Lisbon" | "Europe/Ljubljana" | "Europe/London" | "Europe/Luxembourg" | "Europe/Madrid" | "Europe/Malta" | "Europe/Mariehamn" | "Europe/Minsk" | "Europe/Monaco" | "Europe/Moscow" | "Europe/Oslo" | "Europe/Paris" | "Europe/Podgorica" | "Europe/Prague" | "Europe/Riga" | "Europe/Rome" | "Europe/Samara" | "Europe/San_Marino" | "Europe/Sarajevo" | "Europe/Saratov" | "Europe/Simferopol" | "Europe/Skopje" | "Europe/Sofia" | "Europe/Stockholm" | "Europe/Tallinn" | "Europe/Tirane" | "Europe/Ulyanovsk" | "Europe/Uzhgorod" | "Europe/Vaduz" | "Europe/Vatican" | "Europe/Vienna" | "Europe/Vilnius" | "Europe/Volgograd" | "Europe/Warsaw" | "Europe/Zagreb" | "Europe/Zaporozhye" | "Europe/Zurich" | "Indian/Antananarivo" | "Indian/Chagos" | "Indian/Christmas" | "Indian/Cocos" | "Indian/Comoro" | "Indian/Kerguelen" | "Indian/Mahe" | "Indian/Maldives" | "Indian/Mauritius" | "Indian/Mayotte" | "Indian/Reunion" | "Pacific/Apia" | "Pacific/Auckland" | "Pacific/Bougainville" | "Pacific/Chatham" | "Pacific/Chuuk" | "Pacific/Easter" | "Pacific/Efate" | "Pacific/Enderbury" | "Pacific/Fakaofo" | "Pacific/Fiji" | "Pacific/Funafuti" | "Pacific/Galapagos" | "Pacific/Gambier" | "Pacific/Guadalcanal" | "Pacific/Guam" | "Pacific/Honolulu" | "Pacific/Kiritimati" | "Pacific/Kosrae" | "Pacific/Kwajalein" | "Pacific/Majuro" | "Pacific/Marquesas" | "Pacific/Midway" | "Pacific/Nauru" | "Pacific/Niue" | "Pacific/Norfolk" | "Pacific/Noumea" | "Pacific/Pago_Pago" | "Pacific/Palau" | "Pacific/Pitcairn" | "Pacific/Pohnpei" | "Pacific/Port_Moresby" | "Pacific/Rarotonga" | "Pacific/Saipan" | "Pacific/Tahiti" | "Pacific/Tarawa" | "Pacific/Tongatapu" | "Pacific/Wake" | "Pacific/Wallis";
+type TimeZoneInput = TimeZoneId$1 | Lowercase<TimeZoneId$1>;
+/**
+ * Resolve a time zone input to its canonical ID.
+ * @param input Time zone input.
+ * @return Canonical TimeZoneId.
+ */
+declare function resolveTimeZone(input: TimeZoneInput): TimeZoneId$1;
+//#endregion
+//#region src/types.d.ts
+type Id = string;
+type Int = number;
+type UnsignedInt = number;
+type UTCDateTime = string;
+type LocalDateTime = string;
+type Duration = string;
+type SignedDuration = string;
+type BooleanMap = Record<string, true>;
+type JsonPrimitive = string | number | boolean | null;
+type JsonValue = JsonPrimitive | JsonValue[] | {
+  [key: string]: JsonValue;
+};
+type PatchValue = JsonValue | null;
+interface PatchObject {
+  [key: string]: PatchValue;
+}
+type PatchFields<T> = { [K in keyof Omit<T, "@type">]?: T[K] | null };
+type PatchTag<TTag extends string> = {
+  __patchType?: TTag;
+};
+type EventPatch = PatchFields<Event> & PatchTag<"Event">;
+type TaskPatch = PatchFields<Task> & PatchTag<"Task">;
+type GroupPatch = PatchFields<Group> & PatchTag<"Group">;
+type ParticipantPatch = PatchFields<Participant>;
+type LocationPatch = PatchFields<Location>;
+type VirtualLocationPatch = PatchFields<VirtualLocation>;
+type AlertPatch = PatchFields<Alert>;
+type RelationPatch = PatchFields<Relation>;
+type LinkPatch = PatchFields<Link>;
+type TimeZonePatch = PatchFields<TimeZone>;
+type TimeZoneRulePatch = PatchFields<TimeZoneRule>;
+type RecurrenceRulePatch = PatchFields<RecurrenceRule>;
+type NDayPatch = PatchFields<NDay>;
+type PatchLike = PatchObject | EventPatch | TaskPatch | GroupPatch | TimeZoneRulePatch;
+interface Relation {
+  "@type": "Relation";
+  relation?: BooleanMap;
+}
+interface Link {
+  "@type": "Link";
+  href: string;
+  cid?: string;
+  contentType?: string;
+  size?: UnsignedInt;
+  rel?: string;
+  display?: string;
+  title?: string;
+}
+interface Location {
+  "@type": "Location";
+  name?: string;
+  description?: string;
+  locationTypes?: BooleanMap;
+  relativeTo?: string;
+  timeZone?: TimeZoneId;
+  coordinates?: string;
+  links?: Record<Id, Link>;
+}
+interface VirtualLocation {
+  "@type": "VirtualLocation";
+  name?: string;
+  description?: string;
+  uri: string;
+  features?: BooleanMap;
+}
+interface Participant {
+  "@type": "Participant";
+  name?: string;
+  email?: string;
+  description?: string;
+  sendTo?: Record<string, string>;
+  kind?: string;
+  roles: BooleanMap;
+  locationId?: Id;
+  language?: string;
+  participationStatus?: string;
+  participationComment?: string;
+  expectReply?: boolean;
+  scheduleAgent?: string;
+  scheduleForceSend?: boolean;
+  scheduleSequence?: UnsignedInt;
+  scheduleStatus?: string[];
+  scheduleUpdated?: UTCDateTime;
+  sentBy?: string;
+  invitedBy?: Id;
+  delegatedTo?: Record<Id, true>;
+  delegatedFrom?: Record<Id, true>;
+  memberOf?: Record<Id, true>;
+  links?: Record<Id, Link>;
+  progress?: string;
+  progressUpdated?: UTCDateTime;
+  percentComplete?: UnsignedInt;
+}
+interface OffsetTrigger {
+  "@type": "OffsetTrigger";
+  offset: SignedDuration;
+  relativeTo?: "start" | "end" | string;
+}
+interface AbsoluteTrigger {
+  "@type": "AbsoluteTrigger";
+  when: UTCDateTime;
+}
+interface UnknownTrigger {
+  "@type": string;
+  [key: string]: JsonValue;
+}
+type Trigger = OffsetTrigger | AbsoluteTrigger | UnknownTrigger;
+interface Alert {
+  "@type": "Alert";
+  trigger: Trigger;
+  acknowledged?: UTCDateTime;
+  relatedTo?: Record<string, Relation>;
+  action?: string;
+}
+type DayOfWeek = "mo" | "tu" | "we" | "th" | "fr" | "sa" | "su";
+interface NDay {
+  "@type": "NDay";
+  day: DayOfWeek;
+  nthOfPeriod?: Int;
+}
+interface RecurrenceRule {
+  "@type": "RecurrenceRule";
+  frequency: "yearly" | "monthly" | "weekly" | "daily" | "hourly" | "minutely" | "secondly";
+  interval?: UnsignedInt;
+  rscale?: string;
+  skip?: "omit" | "backward" | "forward";
+  firstDayOfWeek?: DayOfWeek;
+  byDay?: NDay[];
+  byMonthDay?: Int[];
+  byMonth?: string[];
+  byYearDay?: Int[];
+  byWeekNo?: Int[];
+  byHour?: UnsignedInt[];
+  byMinute?: UnsignedInt[];
+  bySecond?: UnsignedInt[];
+  bySetPosition?: Int[];
+  count?: UnsignedInt;
+  until?: LocalDateTime;
+}
+interface TimeZoneRule {
+  "@type": "TimeZoneRule";
+  start: LocalDateTime;
+  offsetFrom: string;
+  offsetTo: string;
+  recurrenceRules?: RecurrenceRule[];
+  recurrenceOverrides?: Record<LocalDateTime, TimeZoneRulePatch>;
+  names?: BooleanMap;
+  comments?: string[];
+}
+interface TimeZone {
+  "@type": "TimeZone";
+  tzId: string;
+  updated?: UTCDateTime;
+  url?: string;
+  validUntil?: UTCDateTime;
+  aliases?: BooleanMap;
+  standard?: TimeZoneRule[];
+  daylight?: TimeZoneRule[];
+}
+interface JSCalendarCommon {
+  "@type": string;
+  uid: string;
+  relatedTo?: Record<string, Relation>;
+  prodId?: string;
+  created?: UTCDateTime;
+  updated: UTCDateTime;
+  sequence?: UnsignedInt;
+  method?: string;
+  title?: string;
+  description?: string;
+  descriptionContentType?: string;
+  showWithoutTime?: boolean;
+  locations?: Record<Id, Location>;
+  virtualLocations?: Record<Id, VirtualLocation>;
+  links?: Record<Id, Link>;
+  locale?: string;
+  keywords?: BooleanMap;
+  categories?: BooleanMap;
+  color?: string;
+  recurrenceId?: LocalDateTime;
+  recurrenceIdTimeZone?: TimeZoneId | null;
+  recurrenceRules?: RecurrenceRule[];
+  excludedRecurrenceRules?: RecurrenceRule[];
+  excluded?: boolean;
+  priority?: Int;
+  freeBusyStatus?: string;
+  privacy?: string;
+  replyTo?: Record<string, string>;
+  sentBy?: string;
+  participants?: Record<Id, Participant>;
+  requestStatus?: string;
+  useDefaultAlerts?: boolean;
+  alerts?: Record<Id, Alert>;
+  timeZone?: TimeZoneId | null;
+  timeZones?: Partial<Record<TimeZoneId, TimeZone>>;
+}
+interface Event extends JSCalendarCommon {
+  "@type": "Event";
+  start: LocalDateTime;
+  duration?: Duration;
+  status?: string;
+  localizations?: Record<string, EventPatch>;
+  recurrenceOverrides?: Record<LocalDateTime, EventPatch>;
+}
+interface Task extends JSCalendarCommon {
+  "@type": "Task";
+  due?: LocalDateTime;
+  start?: LocalDateTime;
+  estimatedDuration?: Duration;
+  percentComplete?: UnsignedInt;
+  progress?: string;
+  progressUpdated?: UTCDateTime;
+  localizations?: Record<string, TaskPatch>;
+  recurrenceOverrides?: Record<LocalDateTime, TaskPatch>;
+}
+interface Group extends JSCalendarCommon {
+  "@type": "Group";
+  entries: Array<Event | Task>;
+  source?: string;
+  localizations?: Record<string, GroupPatch>;
+  recurrenceOverrides?: Record<LocalDateTime, GroupPatch>;
+}
+type JSCalendarObject = Event | Task | Group;
+type CalendarType = JSCalendarObject["@type"];
+type CreateInput<TType extends CalendarType> = TType extends "Event" ? Omit<Event, "@type" | "uid" | "updated"> & {
+  type?: "Event" | "event";
+  "@type"?: "Event";
+  uid?: string;
+  updated?: UTCDateTime;
+} : TType extends "Task" ? Omit<Task, "@type" | "uid" | "updated"> & {
+  type?: "Task" | "task";
+  "@type"?: "Task";
+  uid?: string;
+  updated?: UTCDateTime;
+} : Omit<Group, "@type" | "uid" | "updated"> & {
+  type?: "Group" | "group";
+  "@type"?: "Group";
+  uid?: string;
+  updated?: UTCDateTime;
+};
+type AnyCreateInput = CreateInput<"Event"> | CreateInput<"Task"> | CreateInput<"Group">;
+type CalendarLike = JSCalendarObject | PatchObject | JsonValue;
+//#endregion
+//#region src/search.d.ts
+type DateRangeValue = string | Date;
+type DateRange = {
+  start?: DateRangeValue;
+  end?: DateRangeValue;
+};
+type DateRangeOptions = {
+  includeIncomparable?: boolean;
+};
+//#endregion
+//#region src/ical.d.ts
+type ICalOptions = {
+  prodId?: string;
+  method?: string;
+  includeXJSCalendar?: boolean;
+};
+//#endregion
+//#region src/patch.d.ts
+/**
+ * Apply a JSCalendar PatchObject to an input object.
+ * @param input Input object.
+ * @param patch Patch object to apply.
+ * @return Patched clone of the input object.
+ */
+declare function applyPatch<T extends object>(input: T, patch: PatchLike): T;
+//#endregion
+//#region src/jscal/types.d.ts
+type CreateOptions = {
+  now?: () => UTCDateTime;
+  validate?: boolean;
+};
+type UpdateOptions = {
+  touch?: boolean;
+  sequence?: boolean;
+  now?: () => UTCDateTime;
+  validate?: boolean;
+};
+type DateInput = string | Date;
+type DurationInput = string | number;
+type EntryInput = Event | Task | {
+  data: Event | Task;
+};
+type EventInput = Omit<Event, "@type" | "uid" | "updated" | "created" | "start" | "duration" | "timeZone"> & {
+  start: DateInput;
+  duration?: DurationInput;
+  timeZone?: TimeZoneInput | null;
+  uid?: string;
+  updated?: DateInput;
+  created?: DateInput;
+};
+type TaskInput = Omit<Task, "@type" | "uid" | "updated" | "created" | "start" | "due" | "timeZone"> & {
+  uid?: string;
+  updated?: DateInput;
+  created?: DateInput;
+  start?: DateInput;
+  due?: DateInput;
+  timeZone?: TimeZoneInput | null;
+};
+type GroupInput = Omit<Group, "@type" | "uid" | "updated" | "created" | "entries"> & {
+  entries: EntryInput[];
+  uid?: string;
+  updated?: DateInput;
+  created?: DateInput;
+};
+//#endregion
+//#region src/jscal/base.d.ts
+declare abstract class Base<T extends JSCalendarObject, TPatch extends PatchLike, TSelf extends Base<T, TPatch, TSelf>> {
+  data: T;
+  /**
+   * Create a new base instance that wraps a JSCalendar object.
+   * @param data Underlying JSCalendar data.
+   * @return Result.
+   */
+  constructor(data: T);
+  /**
+   * Wrap updated data in a new instance.
+   * @param data Updated JSCalendar data.
+   * @return New instance containing the data.
+   */
+  protected abstract wrap(data: T): TSelf;
+  /**
+   * Return a deep-cloned plain object for safe serialization.
+   * @return Cloned JSCalendar data.
+   */
+  eject(): T;
+  /**
+   * Clone the current instance with a deep-cloned payload.
+   * @return New instance with cloned data.
+   */
+  clone(): TSelf;
+  /**
+   * Read a field value from the underlying data.
+   * @param key Field key.
+   * @return Field value.
+   */
+  get<K extends keyof T>(key: K): T[K];
+  /**
+   * Set a field value and update metadata as needed.
+   * @param key Field key.
+   * @param value Field value.
+   * @return New instance with the updated field.
+   */
+  set<K extends keyof T>(key: K, value: T[K]): TSelf;
+  /**
+   * Apply a PatchObject and touch updated/sequence metadata.
+   * @param patch Patch to apply.
+   * @param options Update options.
+   * @return New instance with applied patch.
+   */
+  patch(patch: TPatch, options?: UpdateOptions): TSelf;
+  /**
+   * Update updated/sequence metadata for modified keys.
+   * @param keys Modified keys.
+   * @param options Update options.
+   * @return Updated instance.
+   */
+  protected touchKeys(data: T, keys: string[], options?: UpdateOptions): T;
+  /**
+   * Update updated/sequence metadata for PatchObject changes.
+   * @param patch Patch applied to the object.
+   * @param options Update options.
+   * @return Updated instance.
+   */
+  protected touchFromPatch(data: T, patch: PatchLike, options?: UpdateOptions): T;
+}
+//#endregion
+//#region src/jscal/event.d.ts
+declare class EventObject extends Base<Event, EventPatch, EventObject> {
+  /**
+   * Wrap updated data in a new EventObject.
+   * @param data Updated event data.
+   * @return New EventObject instance.
+   */
+  protected wrap(data: Event): EventObject;
+  /**
+   * Create an event with normalized dates, duration, and RFC defaults.
+   * @param input Event input values to normalize.
+   * @param options Creation options (validation, clock).
+   * @return EventObject instance.
+   */
+  constructor(input: EventInput, options?: CreateOptions);
+  /**
+   * Clone the event as a new EventObject instance.
+   * @return Cloned EventObject.
+   */
+  clone(): EventObject;
+}
+//#endregion
+//#region src/jscal/task.d.ts
+declare class TaskObject extends Base<Task, TaskPatch, TaskObject> {
+  /**
+   * Wrap updated data in a new TaskObject.
+   * @param data Updated task data.
+   * @return New TaskObject instance.
+   */
+  protected wrap(data: Task): TaskObject;
+  /**
+   * Create a task with normalized date fields and RFC defaults applied.
+   * @param input Task input values to normalize.
+   * @param options Creation options (validation, clock).
+   * @return TaskObject instance.
+   */
+  constructor(input?: TaskInput, options?: CreateOptions);
+  /**
+   * Clone the task as a new TaskObject instance.
+   * @return Cloned TaskObject.
+   */
+  clone(): TaskObject;
+}
+//#endregion
+//#region src/jscal/group.d.ts
+declare class GroupObject extends Base<Group, GroupPatch, GroupObject> {
+  /**
+   * Wrap updated data in a new GroupObject.
+   * @param data Updated group data.
+   * @return New GroupObject instance.
+   */
+  protected wrap(data: Group): GroupObject;
+  /**
+   * Create a group with normalized entries and RFC defaults.
+   * @param input Group input values to normalize.
+   * @param options Creation options (validation, clock).
+   * @return GroupObject instance.
+   */
+  constructor(input: GroupInput, options?: CreateOptions);
+  /**
+   * Clone the group as a new GroupObject instance.
+   * @return Cloned GroupObject.
+   */
+  clone(): GroupObject;
+}
+//#endregion
+//#region src/jscal/ids.d.ts
+/**
+ * Create a UUID-like identifier.
+ * @return UUID string.
+ */
+declare function createUid(): string;
+/**
+ * Create a compact base64url identifier.
+ * @return Base64url ID string.
+ */
+declare function createId(): Id;
+//#endregion
+//#region src/jscal/guards.d.ts
+/**
+ * Type guard for JSCalendar Event objects.
+ * @param obj JSCalendar object to check.
+ * @return True when the object is an Event.
+ */
+declare function isEvent(obj: JSCalendarObject): obj is Event;
+/**
+ * Type guard for JSCalendar Task objects.
+ * @param obj JSCalendar object to check.
+ * @return True when the object is a Task.
+ */
+declare function isTask(obj: JSCalendarObject): obj is Task;
+/**
+ * Type guard for JSCalendar Group objects.
+ * @param obj JSCalendar object to check.
+ * @return True when the object is a Group.
+ */
+declare function isGroup(obj: JSCalendarObject): obj is Group;
+//#endregion
+//#region src/jscal/builders.d.ts
+declare const TYPE_PARTICIPANT = "Participant";
+declare const TYPE_LOCATION = "Location";
+declare const TYPE_VIRTUAL_LOCATION = "VirtualLocation";
+declare const TYPE_ALERT = "Alert";
+declare const TYPE_OFFSET_TRIGGER = "OffsetTrigger";
+declare const TYPE_ABSOLUTE_TRIGGER = "AbsoluteTrigger";
+declare const TYPE_RELATION = "Relation";
+declare const TYPE_LINK = "Link";
+declare const TYPE_TIME_ZONE = "TimeZone";
+declare const TYPE_TIME_ZONE_RULE = "TimeZoneRule";
+declare const TYPE_RECURRENCE_RULE = "RecurrenceRule";
+declare const TYPE_NDAY = "NDay";
+type WithOptionalType<T, TypeName extends string> = Omit<T, "@type"> & {
+  "@type"?: TypeName;
+};
+type ParticipantInput = WithOptionalType<Participant, typeof TYPE_PARTICIPANT>;
+type LocationInput = WithOptionalType<Location, typeof TYPE_LOCATION>;
+type VirtualLocationInput = WithOptionalType<VirtualLocation, typeof TYPE_VIRTUAL_LOCATION>;
+type AlertInput = WithOptionalType<Alert, typeof TYPE_ALERT>;
+type OffsetTriggerInput = WithOptionalType<OffsetTrigger, typeof TYPE_OFFSET_TRIGGER>;
+type AbsoluteTriggerInput = WithOptionalType<AbsoluteTrigger, typeof TYPE_ABSOLUTE_TRIGGER>;
+type RelationInput = WithOptionalType<Relation, typeof TYPE_RELATION>;
+type LinkInput = WithOptionalType<Link, typeof TYPE_LINK>;
+type TimeZoneInput$1 = WithOptionalType<TimeZone, typeof TYPE_TIME_ZONE>;
+type TimeZoneRuleInput = WithOptionalType<TimeZoneRule, typeof TYPE_TIME_ZONE_RULE>;
+type RecurrenceRuleInput = WithOptionalType<RecurrenceRule, typeof TYPE_RECURRENCE_RULE>;
+type NDayInput = WithOptionalType<NDay, typeof TYPE_NDAY>;
+type EventPatchInput = EventPatch;
+type TaskPatchInput = TaskPatch;
+type GroupPatchInput = GroupPatch;
+type IdValueInput<TInput> = {
+  id?: Id;
+  value: TInput;
+};
+/**
+ * Build a Participant object with @type set and validated.
+ * @param input Participant fields without @type.
+ * @return Validated Participant object.
+ */
+declare function buildParticipant(input: ParticipantInput): Participant;
+/**
+ * Build a Location object with @type set and validated.
+ * @param input Location fields without @type.
+ * @return Validated Location object.
+ */
+declare function buildLocation(input: LocationInput): Location;
+/**
+ * Build a VirtualLocation object with @type set and validated.
+ * @param input VirtualLocation fields without @type.
+ * @return Validated VirtualLocation object.
+ */
+declare function buildVirtualLocation(input: VirtualLocationInput): VirtualLocation;
+/**
+ * Build an Alert object with @type set and validated.
+ * @param input Alert fields without @type.
+ * @return Validated Alert object.
+ */
+declare function buildAlert(input: AlertInput): Alert;
+/**
+ * Build an OffsetTrigger object with @type set and validated.
+ * @param input OffsetTrigger fields without @type.
+ * @return Validated OffsetTrigger object.
+ */
+declare function buildOffsetTrigger(input: OffsetTriggerInput): OffsetTrigger;
+/**
+ * Build an AbsoluteTrigger object with @type set and validated.
+ * @param input AbsoluteTrigger fields without @type.
+ * @return Validated AbsoluteTrigger object.
+ */
+declare function buildAbsoluteTrigger(input: AbsoluteTriggerInput): AbsoluteTrigger;
+/**
+ * Build a Relation object with @type set and validated.
+ * @param input Relation fields without @type.
+ * @return Validated Relation object.
+ */
+declare function buildRelation(input: RelationInput): Relation;
+/**
+ * Build a Link object with @type set and validated.
+ * @param input Link fields without @type.
+ * @return Validated Link object.
+ */
+declare function buildLink(input: LinkInput): Link;
+/**
+ * Build a TimeZone object with @type set and validated.
+ * @param input TimeZone fields without @type.
+ * @return Validated TimeZone object.
+ */
+declare function buildTimeZone(input: TimeZoneInput$1): TimeZone;
+/**
+ * Build a TimeZoneRule object with @type set and validated.
+ * @param input TimeZoneRule fields without @type.
+ * @return Validated TimeZoneRule object.
+ */
+declare function buildTimeZoneRule(input: TimeZoneRuleInput): TimeZoneRule;
+/**
+ * Build a RecurrenceRule object with @type set and validated.
+ * @param input RecurrenceRule fields without @type.
+ * @return Validated RecurrenceRule object.
+ */
+declare function buildRecurrenceRule(input: RecurrenceRuleInput): RecurrenceRule;
+/**
+ * Build an NDay object with @type set and validated.
+ * @param input NDay fields without @type.
+ * @return Validated NDay object.
+ */
+declare function buildNDay(input: NDayInput): NDay;
+/**
+ * Build a patch object for Event-like updates with JSON value validation.
+ * @param input Patch fields for an event.
+ * @return Validated PatchObject.
+ */
+declare function buildEventPatch(input: EventPatchInput): EventPatch;
+/**
+ * Build a patch object for Task-like updates with JSON value validation.
+ * @param input Patch fields for a task.
+ * @return Validated PatchObject.
+ */
+declare function buildTaskPatch(input: TaskPatchInput): TaskPatch;
+/**
+ * Build a patch object for Group-like updates with JSON value validation.
+ * @param input Patch fields for a group.
+ * @return Validated PatchObject.
+ */
+declare function buildGroupPatch(input: GroupPatchInput): GroupPatch;
+/**
+ * Build a record of Participant objects keyed by Ids.
+ * @param items Participant inputs with optional explicit ids.
+ * @param existing Existing participant record to merge into.
+ * @return Participant record keyed by Id.
+ */
+declare function buildParticipants(items: Array<IdValueInput<ParticipantInput>>, existing?: Record<Id, Participant>): Record<Id, Participant>;
+/**
+ * Build a record of Location objects keyed by Ids.
+ * @param items Location inputs with optional explicit ids.
+ * @param existing Existing location record to merge into.
+ * @return Location record keyed by Id.
+ */
+declare function buildLocations(items: Array<IdValueInput<LocationInput>>, existing?: Record<Id, Location>): Record<Id, Location>;
+/**
+ * Build a record of VirtualLocation objects keyed by Ids.
+ * @param items VirtualLocation inputs with optional explicit ids.
+ * @param existing Existing virtual location record to merge into.
+ * @return VirtualLocation record keyed by Id.
+ */
+declare function buildVirtualLocations(items: Array<IdValueInput<VirtualLocationInput>>, existing?: Record<Id, VirtualLocation>): Record<Id, VirtualLocation>;
+/**
+ * Build a record of Alert objects keyed by Ids.
+ * @param items Alert inputs with optional explicit ids.
+ * @param existing Existing alert record to merge into.
+ * @return Alert record keyed by Id.
+ */
+declare function buildAlerts(items: Array<IdValueInput<AlertInput>>, existing?: Record<Id, Alert>): Record<Id, Alert>;
+/**
+ * Build a record of Link objects keyed by Ids.
+ * @param items Link inputs with optional explicit ids.
+ * @param existing Existing link record to merge into.
+ * @return Link record keyed by Id.
+ */
+declare function buildLinks(items: Array<IdValueInput<LinkInput>>, existing?: Record<Id, Link>): Record<Id, Link>;
+/**
+ * Build a record of Relation objects keyed by Ids.
+ * @param items Relation inputs with optional explicit ids.
+ * @param existing Existing relation record to merge into.
+ * @return Relation record keyed by Id.
+ */
+declare function buildRelatedTo(items: Array<IdValueInput<RelationInput>>, existing?: Record<Id, Relation>): Record<Id, Relation>;
+/**
+ * Build a record of TimeZone objects keyed by tzId.
+ * @param items TimeZone inputs.
+ * @return TimeZone record keyed by tzId.
+ */
+declare function buildTimeZoneMap(items: TimeZoneInput$1[]): Record<string, TimeZone>;
+//#endregion
+//#region src/jscal.d.ts
+declare const JsCal: {
+  Event: typeof EventObject;
+  Task: typeof TaskObject;
+  Group: typeof GroupObject;
+  createUid: typeof createUid;
+  createId: typeof createId;
+  isEvent: typeof isEvent;
+  isGroup: typeof isGroup;
+  isTask: typeof isTask;
+  duration: {
+    seconds(value: number): string;
+    minutes(value: number): string;
+    hours(value: number): string;
+    days(value: number): string;
+    from(parts: {
+      days?: number;
+      hours?: number;
+      minutes?: number;
+      seconds?: number;
+    }): string;
+  };
+  timeZone: typeof resolveTimeZone;
+  timeZones: TimeZoneId$1[];
+  applyPatch: typeof applyPatch;
+  Participant: typeof buildParticipant;
+  Location: typeof buildLocation;
+  VirtualLocation: typeof buildVirtualLocation;
+  Alert: typeof buildAlert;
+  OffsetTrigger: typeof buildOffsetTrigger;
+  AbsoluteTrigger: typeof buildAbsoluteTrigger;
+  Relation: typeof buildRelation;
+  Link: typeof buildLink;
+  TimeZone: typeof buildTimeZone;
+  TimeZoneRule: typeof buildTimeZoneRule;
+  RecurrenceRule: typeof buildRecurrenceRule;
+  NDay: typeof buildNDay;
+  ByDay: typeof buildNDay;
+  EventPatch: typeof buildEventPatch;
+  TaskPatch: typeof buildTaskPatch;
+  GroupPatch: typeof buildGroupPatch;
+  participants: typeof buildParticipants;
+  locations: typeof buildLocations;
+  virtualLocations: typeof buildVirtualLocations;
+  alerts: typeof buildAlerts;
+  links: typeof buildLinks;
+  relatedTo: typeof buildRelatedTo;
+  timeZonesMap: typeof buildTimeZoneMap;
+  /**
+   * Find a JSCalendar object by UID.
+   * @param items JSCalendar objects or JsCal instances.
+   * @param uid UID to match.
+   * @return Matching object, if found.
+   */
+  findByUid(items: Array<JSCalendarObject | {
+    data: JSCalendarObject;
+  }>, uid: string): JSCalendarObject | undefined;
+  /**
+   * Filter JSCalendar objects by @type.
+   * @param items JSCalendar objects or JsCal instances.
+   * @param type JSCalendar @type to match.
+   * @return Matching objects.
+   */
+  filterByType(items: Array<JSCalendarObject | {
+    data: JSCalendarObject;
+  }>, type: JSCalendarObject["@type"]): JSCalendarObject[];
+  /**
+   * Group JSCalendar objects by @type.
+   * @param items JSCalendar objects or JsCal instances.
+   * @return Record keyed by @type.
+   */
+  groupByType(items: Array<JSCalendarObject | {
+    data: JSCalendarObject;
+  }>): Record<string, JSCalendarObject[]>;
+  /**
+   * Filter JSCalendar objects whose text fields match a query.
+   * @param items JSCalendar objects or JsCal instances.
+   * @param query Text query to match.
+   * @return Matching objects.
+   */
+  filterByText(items: Array<JSCalendarObject | {
+    data: JSCalendarObject;
+  }>, query: string): JSCalendarObject[];
+  /**
+   * Filter JSCalendar objects that overlap a date range.
+   * @param items JSCalendar objects or JsCal instances.
+   * @param range Date range bounds.
+   * @param options Range comparison options.
+   * @return Matching objects.
+   */
+  filterByDateRange(items: Array<JSCalendarObject | {
+    data: JSCalendarObject;
+  }>, range: DateRange, options?: DateRangeOptions): JSCalendarObject[];
+  /**
+   * Expand recurrence rules into concrete occurrences.
+   * @param items JSCalendar objects or JsCal instances.
+   * @param range Date range bounds.
+   * @return Generator of expanded JSCalendar objects.
+   */
+  expandRecurrence(items: Array<JSCalendarObject | {
+    data: JSCalendarObject;
+  }>, range: {
+    from: Date;
+    to: Date;
+  }): Generator<JSCalendarObject>;
+  /**
+   * Expand recurrence rules with pagination support.
+   * @param items JSCalendar objects or JsCal instances.
+   * @param range Date range bounds.
+   * @param options Pagination options.
+   * @return Page of expanded items plus an optional next cursor.
+   */
+  expandRecurrencePaged(items: Array<JSCalendarObject | {
+    data: JSCalendarObject;
+  }>, range: {
+    from: Date;
+    to: Date;
+  }, options: {
+    limit: number;
+    cursor?: string;
+  }): {
+    items: JSCalendarObject[];
+    nextCursor?: string;
+  };
+  /**
+   * Convert JSCalendar objects to iCalendar text.
+   * @param value JSCalendar objects or JsCal instances.
+   * @param options iCalendar export options.
+   * @return iCalendar text.
+   */
+  toICal(value: Array<JSCalendarObject | {
+    data: JSCalendarObject;
+  }>, options?: ICalOptions): string;
+};
+//#endregion
+//#region src/validate/error.d.ts
+/**
+ * Error thrown when validation fails.
+ */
+declare class ValidationError extends Error {
+  path: string;
+  /**
+   * Create a new ValidationError.
+   * @param path Validation path.
+   * @param message Error message.
+   */
+  constructor(path: string, message: string);
+}
+//#endregion
+export { AbsoluteTrigger, Alert, AlertPatch, AnyCreateInput, BooleanMap, CalendarLike, CalendarType, CreateInput, DayOfWeek, Duration, Event, EventPatch, Group, GroupPatch, Id, Int, JSCalendarCommon, JSCalendarObject, JsCal, JsonPrimitive, JsonValue, Link, LinkPatch, LocalDateTime, Location, LocationPatch, NDay, NDayPatch, OffsetTrigger, Participant, ParticipantPatch, PatchLike, PatchObject, PatchValue, RecurrenceRule, RecurrenceRulePatch, Relation, RelationPatch, SignedDuration, Task, TaskPatch, TimeZone, type TimeZoneId$1 as TimeZoneId, type TimeZoneInput, TimeZonePatch, TimeZoneRule, TimeZoneRulePatch, Trigger, UTCDateTime, UnknownTrigger, UnsignedInt, ValidationError, VirtualLocation, VirtualLocationPatch };