@craftguild/jscalendar 0.4.0 → 0.5.0

package/dist/jscal/base.js

@@ -26,7 +26,7 @@ export class Base {
      * @return New instance with cloned data.
      */
     clone() {
-        return new Base(deepClone(this.data));
+        return this.wrap(deepClone(this.data));
     }
     /**
      * Read a field value from the underlying data.
@@ -40,98 +40,90 @@ export class Base {
      * Set a field value and update metadata as needed.
      * @param key Field key.
      * @param value Field value.
-     * @return Updated instance.
+     * @return New instance with the updated field.
      */
     set(key, value) {
-        this.data[key] = value;
-        return this.touchKeys([String(key)]);
-    }
-    /**
-     * Apply shallow updates and touch updated/sequence metadata.
-     * @param values Partial values to merge.
-     * @param options Update options.
-     * @return Updated instance.
-     */
-    update(values, options = {}) {
-        const next = { ...this.data, ...values };
-        if (options.validate !== false) {
-            validateJsCalendarObject(next);
-        }
-        this.data = next;
-        return this.touchKeys(Object.keys(values), options);
+        const next = deepClone(this.data);
+        next[key] = value;
+        const touched = this.touchKeys(next, [String(key)]);
+        return this.wrap(touched);
     }
     /**
      * Apply a PatchObject and touch updated/sequence metadata.
      * @param patch Patch to apply.
      * @param options Update options.
-     * @return Updated instance.
+     * @return New instance with applied patch.
      */
     patch(patch, options = {}) {
         const next = applyPatch(this.data, patch);
         if (options.validate !== false) {
             validateJsCalendarObject(next);
         }
-        this.data = next;
-        return this.touchFromPatch(patch, options);
+        const touched = this.touchFromPatch(next, patch, options);
+        return this.wrap(touched);
     }
     /**
-     * Add a physical location and return its generated ID.
+     * Add a physical location and return a new instance.
      * @param location Location data (without @type).
      * @param id Optional location ID.
-     * @return Location ID.
+     * @return New instance with the added location.
      */
     addLocation(location, id) {
         const actualId = id ?? createId();
-        if (!this.data.locations)
-            this.data.locations = {};
-        this.data.locations[actualId] = { ...location, "@type": "Location" };
-        this.touchKeys(["locations"]);
-        return actualId;
+        const next = deepClone(this.data);
+        if (!next.locations)
+            next.locations = {};
+        next.locations[actualId] = { ...location, "@type": "Location" };
+        const touched = this.touchKeys(next, ["locations"]);
+        return this.wrap(touched);
     }
     /**
-     * Add a virtual location and return its generated ID.
+     * Add a virtual location and return a new instance.
      * @param location Virtual location data (without @type).
      * @param id Optional virtual location ID.
-     * @return Virtual location ID.
+     * @return New instance with the added virtual location.
      */
     addVirtualLocation(location, id) {
         const actualId = id ?? createId();
-        if (!this.data.virtualLocations)
-            this.data.virtualLocations = {};
+        const next = deepClone(this.data);
+        if (!next.virtualLocations)
+            next.virtualLocations = {};
         const name = location.name ?? "";
-        this.data.virtualLocations[actualId] = { ...location, name, "@type": "VirtualLocation" };
-        this.touchKeys(["virtualLocations"]);
-        return actualId;
+        next.virtualLocations[actualId] = { ...location, name, "@type": "VirtualLocation" };
+        const touched = this.touchKeys(next, ["virtualLocations"]);
+        return this.wrap(touched);
     }
     /**
-     * Add a participant and return its generated ID.
+     * Add a participant and return a new instance.
      * @param participant Participant data (without @type).
      * @param id Optional participant ID.
-     * @return Participant ID.
+     * @return New instance with the added participant.
      */
     addParticipant(participant, id) {
         const actualId = id ?? createId();
-        if (!this.data.participants)
-            this.data.participants = {};
+        const next = deepClone(this.data);
+        if (!next.participants)
+            next.participants = {};
         const filled = applyParticipantDefaults({ ...participant, "@type": "Participant" });
-        this.data.participants[actualId] = filled;
-        this.touchKeys(["participants"], { sequence: false });
-        return actualId;
+        next.participants[actualId] = filled;
+        const touched = this.touchKeys(next, ["participants"], { sequence: false });
+        return this.wrap(touched);
     }
     /**
-     * Add an alert and return its generated ID.
+     * Add an alert and return a new instance.
      * @param alert Alert data (without @type).
      * @param id Optional alert ID.
-     * @return Alert ID.
+     * @return New instance with the added alert.
      */
     addAlert(alert, id) {
         const actualId = id ?? createId();
-        if (!this.data.alerts)
-            this.data.alerts = {};
+        const next = deepClone(this.data);
+        if (!next.alerts)
+            next.alerts = {};
         const filled = applyAlertDefaults({ ...alert, "@type": "Alert" });
-        this.data.alerts[actualId] = filled;
-        this.touchKeys(["alerts"]);
-        return actualId;
+        next.alerts[actualId] = filled;
+        const touched = this.touchKeys(next, ["alerts"]);
+        return this.wrap(touched);
     }
     /**
      * Update updated/sequence metadata for modified keys.
@@ -139,19 +131,19 @@ export class Base {
      * @param options Update options.
      * @return Updated instance.
      */
-    touchKeys(keys, options = {}) {
+    touchKeys(data, keys, options = {}) {
         if (options.touch === false)
-            return this;
+            return data;
         const now = options.now ?? nowUtc;
-        this.data.updated = now();
+        data.updated = now();
         if (options.sequence === false)
-            return this;
+            return data;
         const onlyParticipants = keys.length > 0 && keys.every((key) => key === KEY_PARTICIPANTS);
         if (!onlyParticipants) {
-            const current = isNumberValue(this.data.sequence) ? this.data.sequence : 0;
-            this.data.sequence = current + 1;
+            const current = isNumberValue(data.sequence) ? data.sequence : 0;
+            data.sequence = current + 1;
         }
-        return this;
+        return data;
     }
     /**
      * Update updated/sequence metadata for PatchObject changes.
@@ -159,13 +151,13 @@ export class Base {
      * @param options Update options.
      * @return Updated instance.
      */
-    touchFromPatch(patch, options = {}) {
+    touchFromPatch(data, patch, options = {}) {
         if (options.touch === false)
-            return this;
+            return data;
         const now = options.now ?? nowUtc;
-        this.data.updated = now();
+        data.updated = now();
         if (options.sequence === false)
-            return this;
+            return data;
         const pointers = Object.keys(patch);
         const onlyParticipants = pointers.length > 0 &&
             pointers.every((pointer) => {
@@ -173,9 +165,9 @@ export class Base {
                 return normalized.startsWith("participants");
             });
         if (!onlyParticipants) {
-            const current = isNumberValue(this.data.sequence) ? this.data.sequence : 0;
-            this.data.sequence = current + 1;
+            const current = isNumberValue(data.sequence) ? data.sequence : 0;
+            data.sequence = current + 1;
         }
-        return this;
+        return data;
     }
 }

package/dist/jscal/builders.d.ts

@@ -1,4 +1,4 @@
-import type { Alert, AbsoluteTrigger, Link, Location, NDay, OffsetTrigger, Participant, RecurrenceRule, Relation, TimeZone, TimeZoneRule, VirtualLocation, Id } from "../types.js";
+import type { Alert, AbsoluteTrigger, EventPatch, GroupPatch, Link, Location, NDay, OffsetTrigger, Participant, RecurrenceRule, Relation, TaskPatch, TimeZone, TimeZoneRule, VirtualLocation, Id } from "../types.js";
 declare const TYPE_PARTICIPANT = "Participant";
 declare const TYPE_LOCATION = "Location";
 declare const TYPE_VIRTUAL_LOCATION = "VirtualLocation";
@@ -26,6 +26,13 @@ export type TimeZoneInput = WithOptionalType<TimeZone, typeof TYPE_TIME_ZONE>;
 export type TimeZoneRuleInput = WithOptionalType<TimeZoneRule, typeof TYPE_TIME_ZONE_RULE>;
 export type RecurrenceRuleInput = WithOptionalType<RecurrenceRule, typeof TYPE_RECURRENCE_RULE>;
 export type NDayInput = WithOptionalType<NDay, typeof TYPE_NDAY>;
+export type EventPatchInput = EventPatch;
+export type TaskPatchInput = TaskPatch;
+export type GroupPatchInput = GroupPatch;
+export type IdValueInput<TInput> = {
+    id?: Id;
+    value: TInput;
+};
 /**
  * Build a Participant object with @type set and validated.
  * @param input Participant fields without @type.
@@ -99,49 +106,74 @@ export declare function buildRecurrenceRule(input: RecurrenceRuleInput): Recurre
  */
 export declare function buildNDay(input: NDayInput): NDay;
 /**
- * Build a record keyed by generated Ids.
- * @param items Items to store.
+ * Build a patch object for Event-like updates with JSON value validation.
+ * @param input Patch fields for an event.
+ * @return Validated PatchObject.
+ */
+export 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.
+ */
+export 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.
+ */
+export declare function buildGroupPatch(input: GroupPatchInput): GroupPatch;
+/**
+ * Build a record keyed by Ids, optionally merging into an existing record.
+ * @param items Items to store with optional explicit ids.
  * @param builder Builder function to validate each item.
- * @param idFn Optional ID generator.
- * @return Record keyed by generated Ids.
+ * @param idFn Optional ID generator for items without explicit ids.
+ * @param existing Existing record to merge into.
+ * @return Record keyed by ids with merged values.
  */
-export declare function buildIdMap<TInput, TOutput>(items: TInput[], builder: (input: TInput) => TOutput, idFn?: (input: TInput, index: number) => Id): Record<Id, TOutput>;
+export declare function buildIdMap<TInput, TOutput>(items: Array<IdValueInput<TInput>>, builder: (input: TInput) => TOutput, idFn?: (input: TInput, index: number) => Id, existing?: Record<Id, TOutput>): Record<Id, TOutput>;
 /**
- * Build a record of Participant objects keyed by generated Ids.
- * @param items Participant inputs.
+ * 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.
  */
-export declare function buildParticipants(items: ParticipantInput[]): Record<Id, Participant>;
+export declare function buildParticipants(items: Array<IdValueInput<ParticipantInput>>, existing?: Record<Id, Participant>): Record<Id, Participant>;
 /**
- * Build a record of Location objects keyed by generated Ids.
- * @param items Location inputs.
+ * 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.
  */
-export declare function buildLocations(items: LocationInput[]): Record<Id, Location>;
+export declare function buildLocations(items: Array<IdValueInput<LocationInput>>, existing?: Record<Id, Location>): Record<Id, Location>;
 /**
- * Build a record of VirtualLocation objects keyed by generated Ids.
- * @param items VirtualLocation inputs.
+ * 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.
  */
-export declare function buildVirtualLocations(items: VirtualLocationInput[]): Record<Id, VirtualLocation>;
+export declare function buildVirtualLocations(items: Array<IdValueInput<VirtualLocationInput>>, existing?: Record<Id, VirtualLocation>): Record<Id, VirtualLocation>;
 /**
- * Build a record of Alert objects keyed by generated Ids.
- * @param items Alert inputs.
+ * 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.
  */
-export declare function buildAlerts(items: AlertInput[]): Record<Id, Alert>;
+export declare function buildAlerts(items: Array<IdValueInput<AlertInput>>, existing?: Record<Id, Alert>): Record<Id, Alert>;
 /**
- * Build a record of Link objects keyed by generated Ids.
- * @param items Link inputs.
+ * 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.
  */
-export declare function buildLinks(items: LinkInput[]): Record<Id, Link>;
+export declare function buildLinks(items: Array<IdValueInput<LinkInput>>, existing?: Record<Id, Link>): Record<Id, Link>;
 /**
- * Build a record of Relation objects keyed by generated Ids.
- * @param items Relation inputs.
+ * 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.
  */
-export declare function buildRelatedTo(items: RelationInput[]): Record<Id, Relation>;
+export 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.

package/dist/jscal/builders.js

@@ -2,7 +2,7 @@ import { createId } from "./ids.js";
 import { validateAlert, validateLink, validateLocation, validateParticipant, validateRelation, validateTimeZoneObject, validateTimeZoneRule, validateVirtualLocation } from "../validate/validators-common.js";
 import { validateNDay, validateRecurrenceRule } from "../validate/validators-recurrence.js";
 import { fail } from "../validate/error.js";
-import { assertSignedDuration, assertString, assertUtcDateTime } from "../validate/asserts.js";
+import { assertPatchObject, assertSignedDuration, assertString, assertUtcDateTime } from "../validate/asserts.js";
 const TYPE_PARTICIPANT = "Participant";
 const TYPE_LOCATION = "Location";
 const TYPE_VIRTUAL_LOCATION = "VirtualLocation";
@@ -173,67 +173,104 @@ export function buildNDay(input) {
     return nday;
 }
 /**
- * Build a record keyed by generated Ids.
- * @param items Items to store.
+ * Build a patch object for Event-like updates with JSON value validation.
+ * @param input Patch fields for an event.
+ * @return Validated PatchObject.
+ */
+export function buildEventPatch(input) {
+    const patch = { ...input };
+    assertPatchObject(patch, "eventPatch");
+    return patch;
+}
+/**
+ * Build a patch object for Task-like updates with JSON value validation.
+ * @param input Patch fields for a task.
+ * @return Validated PatchObject.
+ */
+export function buildTaskPatch(input) {
+    const patch = { ...input };
+    assertPatchObject(patch, "taskPatch");
+    return patch;
+}
+/**
+ * Build a patch object for Group-like updates with JSON value validation.
+ * @param input Patch fields for a group.
+ * @return Validated PatchObject.
+ */
+export function buildGroupPatch(input) {
+    const patch = { ...input };
+    assertPatchObject(patch, "groupPatch");
+    return patch;
+}
+/**
+ * Build a record keyed by Ids, optionally merging into an existing record.
+ * @param items Items to store with optional explicit ids.
  * @param builder Builder function to validate each item.
- * @param idFn Optional ID generator.
- * @return Record keyed by generated Ids.
+ * @param idFn Optional ID generator for items without explicit ids.
+ * @param existing Existing record to merge into.
+ * @return Record keyed by ids with merged values.
  */
-export function buildIdMap(items, builder, idFn = () => createId()) {
-    const result = {};
+export function buildIdMap(items, builder, idFn = () => createId(), existing) {
+    const result = existing ? { ...existing } : {};
     items.forEach((item, index) => {
-        const id = idFn(item, index);
-        result[id] = builder(item);
+        const id = item.id ?? idFn(item.value, index);
+        result[id] = builder(item.value);
     });
     return result;
 }
 /**
- * Build a record of Participant objects keyed by generated Ids.
- * @param items Participant inputs.
+ * 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.
  */
-export function buildParticipants(items) {
-    return buildIdMap(items, buildParticipant);
+export function buildParticipants(items, existing) {
+    return buildIdMap(items, buildParticipant, () => createId(), existing);
 }
 /**
- * Build a record of Location objects keyed by generated Ids.
- * @param items Location inputs.
+ * 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.
  */
-export function buildLocations(items) {
-    return buildIdMap(items, buildLocation);
+export function buildLocations(items, existing) {
+    return buildIdMap(items, buildLocation, () => createId(), existing);
 }
 /**
- * Build a record of VirtualLocation objects keyed by generated Ids.
- * @param items VirtualLocation inputs.
+ * 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.
  */
-export function buildVirtualLocations(items) {
-    return buildIdMap(items, buildVirtualLocation);
+export function buildVirtualLocations(items, existing) {
+    return buildIdMap(items, buildVirtualLocation, () => createId(), existing);
 }
 /**
- * Build a record of Alert objects keyed by generated Ids.
- * @param items Alert inputs.
+ * 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.
  */
-export function buildAlerts(items) {
-    return buildIdMap(items, buildAlert);
+export function buildAlerts(items, existing) {
+    return buildIdMap(items, buildAlert, () => createId(), existing);
 }
 /**
- * Build a record of Link objects keyed by generated Ids.
- * @param items Link inputs.
+ * 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.
  */
-export function buildLinks(items) {
-    return buildIdMap(items, buildLink);
+export function buildLinks(items, existing) {
+    return buildIdMap(items, buildLink, () => createId(), existing);
 }
 /**
- * Build a record of Relation objects keyed by generated Ids.
- * @param items Relation inputs.
+ * 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.
  */
-export function buildRelatedTo(items) {
-    return buildIdMap(items, buildRelation);
+export function buildRelatedTo(items, existing) {
+    return buildIdMap(items, buildRelation, () => createId(), existing);
 }
 /**
  * Build a record of TimeZone objects keyed by tzId.

package/dist/jscal/event.d.ts

@@ -1,7 +1,13 @@
-import type { Event } from "../types.js";
+import type { Event, EventPatch } from "../types.js";
 import type { CreateOptions, EventInput } from "./types.js";
 import { Base } from "./base.js";
-export declare class EventObject extends Base<Event> {
+export 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.

package/dist/jscal/event.js

@@ -8,6 +8,15 @@ import { toLocalDateTime, toUtcDateTime } from "./datetime.js";
 import { Base } from "./base.js";
 import { isStringValue, isNumberValue } from "../utils.js";
 export class EventObject extends Base {
+    /**
+     * Wrap updated data in a new EventObject.
+     * @param data Updated event data.
+     * @return New EventObject instance.
+     */
+    wrap(data) {
+        const { "@type": _type, ...rest } = data;
+        return new EventObject(rest, { validate: false });
+    }
     /**
      * Create an event with normalized dates, duration, and RFC defaults.
      * @param input Event input values to normalize.
@@ -64,8 +73,6 @@ export class EventObject extends Base {
      * @return Cloned EventObject.
      */
     clone() {
-        const cloneData = deepClone(this.data);
-        const { "@type": _type, ...rest } = cloneData;
-        return new EventObject(rest);
+        return this.wrap(deepClone(this.data));
     }
 }

package/dist/jscal/group.d.ts

@@ -1,7 +1,13 @@
-import type { Event, Group, Task } from "../types.js";
+import type { Event, Group, GroupPatch, Task } from "../types.js";
 import type { CreateOptions, GroupInput } from "./types.js";
 import { Base } from "./base.js";
-export declare class GroupObject extends Base<Group> {
+export 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.
@@ -12,11 +18,11 @@ export declare class GroupObject extends Base<Group> {
     /**
      * Append a normalized entry to the group.
      * @param entry Event or task entry to add.
-     * @return Updated GroupObject instance.
+     * @return New GroupObject instance with the added entry.
      */
     addEntry(entry: Event | Task | {
         data: Event | Task;
-    }): this;
+    }): GroupObject;
     /**
      * Clone the group as a new GroupObject instance.
      * @return Cloned GroupObject.

package/dist/jscal/group.js

@@ -6,6 +6,15 @@ import { Base } from "./base.js";
 import { normalizeEntry } from "./normalize.js";
 import { toUtcDateTime } from "./datetime.js";
 export class GroupObject extends Base {
+    /**
+     * Wrap updated data in a new GroupObject.
+     * @param data Updated group data.
+     * @return New GroupObject instance.
+     */
+    wrap(data) {
+        const { "@type": _type, ...rest } = data;
+        return new GroupObject(rest, { validate: false });
+    }
     /**
      * Create a group with normalized entries and RFC defaults.
      * @param input Group input values to normalize.
@@ -42,21 +51,19 @@ export class GroupObject extends Base {
     /**
      * Append a normalized entry to the group.
      * @param entry Event or task entry to add.
-     * @return Updated GroupObject instance.
+     * @return New GroupObject instance with the added entry.
      */
     addEntry(entry) {
-        const entries = [...this.data.entries, normalizeEntry(entry)];
-        this.data.entries = entries;
-        this.touchKeys(["entries"]);
-        return this;
+        const next = deepClone(this.data);
+        next.entries = [...next.entries, normalizeEntry(entry)];
+        const touched = this.touchKeys(next, ["entries"]);
+        return this.wrap(touched);
     }
     /**
      * Clone the group as a new GroupObject instance.
      * @return Cloned GroupObject.
      */
     clone() {
-        const cloneData = deepClone(this.data);
-        const { "@type": _type, ...rest } = cloneData;
-        return new GroupObject(rest);
+        return this.wrap(deepClone(this.data));
     }
 }

package/dist/jscal/task.d.ts

@@ -1,7 +1,13 @@
-import type { Task } from "../types.js";
+import type { Task, TaskPatch } from "../types.js";
 import type { CreateOptions, TaskInput } from "./types.js";
 import { Base } from "./base.js";
-export declare class TaskObject extends Base<Task> {
+export 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.

package/dist/jscal/task.js

@@ -6,6 +6,15 @@ import { createUid } from "./ids.js";
 import { toLocalDateTime, toUtcDateTime } from "./datetime.js";
 import { Base } from "./base.js";
 export class TaskObject extends Base {
+    /**
+     * Wrap updated data in a new TaskObject.
+     * @param data Updated task data.
+     * @return New TaskObject instance.
+     */
+    wrap(data) {
+        const { "@type": _type, ...rest } = data;
+        return new TaskObject(rest, { validate: false });
+    }
     /**
      * Create a task with normalized date fields and RFC defaults applied.
      * @param input Task input values to normalize.
@@ -53,8 +62,6 @@ export class TaskObject extends Base {
      * @return Cloned TaskObject.
      */
     clone() {
-        const cloneData = deepClone(this.data);
-        const { "@type": _type, ...rest } = cloneData;
-        return new TaskObject(rest);
+        return this.wrap(deepClone(this.data));
     }
 }