@craftguild/jscalendar 0.5.2 → 0.5.4

package/dist/jscal/duration.d.ts

@@ -1,43 +0,0 @@
-/**
- * Convert seconds to an ISO 8601 duration string.
- * @param totalSeconds Total seconds to encode.
- * @return ISO 8601 duration string.
- */
-export declare function durationFromSeconds(totalSeconds: number): string;
-export declare const Duration: {
-    /**
-     * Convert seconds to a duration string.
-     * @param value Total seconds.
-     * @return ISO 8601 duration string (signed when negative).
-     */
-    seconds(value: number): string;
-    /**
-     * Convert minutes to a duration string.
-     * @param value Total minutes.
-     * @return ISO 8601 duration string (signed when negative).
-     */
-    minutes(value: number): string;
-    /**
-     * Convert hours to a duration string.
-     * @param value Total hours.
-     * @return ISO 8601 duration string (signed when negative).
-     */
-    hours(value: number): string;
-    /**
-     * Convert days to a duration string.
-     * @param value Total days.
-     * @return ISO 8601 duration string (signed when negative).
-     */
-    days(value: number): string;
-    /**
-     * Build a duration string from component parts.
-     * @param parts Day/hour/minute/second parts.
-     * @return ISO 8601 duration string (signed when total is negative).
-     */
-    from(parts: {
-        days?: number;
-        hours?: number;
-        minutes?: number;
-        seconds?: number;
-    }): string;
-};

package/dist/jscal/duration.js

@@ -1,75 +0,0 @@
-import { EMPTY_STRING } from "./constants.js";
-/**
- * Convert seconds to an ISO 8601 duration string.
- * @param totalSeconds Total seconds to encode.
- * @return ISO 8601 duration string.
- */
-export function durationFromSeconds(totalSeconds) {
-    const negative = totalSeconds < 0;
-    const absSeconds = Math.abs(totalSeconds);
-    const clamped = Math.floor(absSeconds);
-    const days = Math.floor(clamped / 86400);
-    let remaining = clamped % 86400;
-    const hours = Math.floor(remaining / 3600);
-    remaining %= 3600;
-    const minutes = Math.floor(remaining / 60);
-    const seconds = remaining % 60;
-    const datePart = days > 0 ? `${days}D` : "";
-    const timeParts = [];
-    if (hours > 0)
-        timeParts.push(`${hours}H`);
-    if (minutes > 0)
-        timeParts.push(`${minutes}M`);
-    if (seconds > 0 || (datePart === EMPTY_STRING && timeParts.length === 0)) {
-        timeParts.push(`${seconds}S`);
-    }
-    const timePart = timeParts.length > 0 ? `T${timeParts.join("")}` : "";
-    const sign = negative && clamped > 0 ? "-" : "";
-    return `${sign}P${datePart}${timePart}`;
-}
-export const Duration = {
-    /**
-     * Convert seconds to a duration string.
-     * @param value Total seconds.
-     * @return ISO 8601 duration string (signed when negative).
-     */
-    seconds(value) {
-        return durationFromSeconds(value);
-    },
-    /**
-     * Convert minutes to a duration string.
-     * @param value Total minutes.
-     * @return ISO 8601 duration string (signed when negative).
-     */
-    minutes(value) {
-        return durationFromSeconds(value * 60);
-    },
-    /**
-     * Convert hours to a duration string.
-     * @param value Total hours.
-     * @return ISO 8601 duration string (signed when negative).
-     */
-    hours(value) {
-        return durationFromSeconds(value * 3600);
-    },
-    /**
-     * Convert days to a duration string.
-     * @param value Total days.
-     * @return ISO 8601 duration string (signed when negative).
-     */
-    days(value) {
-        return durationFromSeconds(value * 86400);
-    },
-    /**
-     * Build a duration string from component parts.
-     * @param parts Day/hour/minute/second parts.
-     * @return ISO 8601 duration string (signed when total is negative).
-     */
-    from(parts) {
-        const seconds = (parts.days ?? 0) * 86400 +
-            (parts.hours ?? 0) * 3600 +
-            (parts.minutes ?? 0) * 60 +
-            (parts.seconds ?? 0);
-        return durationFromSeconds(seconds);
-    },
-};

package/dist/jscal/event.d.ts

@@ -1,23 +0,0 @@
-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, 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;
-}

package/dist/jscal/event.js

@@ -1,78 +0,0 @@
-import { resolveTimeZone } from "../timezones.js";
-import { deepClone, nowUtc } from "../utils.js";
-import { validateJsCalendarObject } from "../validate.js";
-import { applyCommonDefaults, applyEventDefaults } from "./defaults.js";
-import { durationFromSeconds } from "./duration.js";
-import { createUid } from "./ids.js";
-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.
-     * @param options Creation options (validation, clock).
-     * @return EventObject instance.
-     */
-    constructor(input, options = {}) {
-        if (!isStringValue(input.start) && !(input.start instanceof Date)) {
-            throw new Error("Event.start is required");
-        }
-        if (isStringValue(input.start) && input.start.length === 0) {
-            throw new Error("Event.start is required");
-        }
-        const now = options.now ?? nowUtc;
-        const { start: rawStart, duration: rawDuration, updated: rawUpdated, created: rawCreated, timeZone: rawTimeZone, ...rest } = input;
-        const start = toLocalDateTime(rawStart);
-        const updated = rawUpdated ? toUtcDateTime(rawUpdated) : now();
-        let timeZone;
-        if (rawTimeZone === null) {
-            timeZone = null;
-        }
-        else if (rawTimeZone) {
-            timeZone = resolveTimeZone(rawTimeZone);
-        }
-        const data = {
-            ...rest,
-            "@type": "Event",
-            start,
-            uid: input.uid ?? createUid(),
-            updated,
-        };
-        if (timeZone !== undefined)
-            data.timeZone = timeZone;
-        if (rawDuration !== undefined) {
-            data.duration = isNumberValue(rawDuration)
-                ? durationFromSeconds(Math.max(0, rawDuration))
-                : rawDuration;
-        }
-        if (rawCreated) {
-            data.created = toUtcDateTime(rawCreated);
-        }
-        else {
-            data.created = updated;
-        }
-        applyCommonDefaults(data);
-        applyEventDefaults(data);
-        if (options.validate !== false) {
-            validateJsCalendarObject(data);
-        }
-        super(data);
-    }
-    /**
-     * Clone the event as a new EventObject instance.
-     * @return Cloned EventObject.
-     */
-    clone() {
-        return this.wrap(deepClone(this.data));
-    }
-}

package/dist/jscal/group.d.ts

@@ -1,31 +0,0 @@
-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, 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);
-    /**
-     * Append a normalized entry to the group.
-     * @param entry Event or task entry to add.
-     * @return New GroupObject instance with the added entry.
-     */
-    addEntry(entry: Event | Task | {
-        data: Event | Task;
-    }): GroupObject;
-    /**
-     * Clone the group as a new GroupObject instance.
-     * @return Cloned GroupObject.
-     */
-    clone(): GroupObject;
-}

package/dist/jscal/group.js

@@ -1,69 +0,0 @@
-import { deepClone, nowUtc } from "../utils.js";
-import { validateJsCalendarObject } from "../validate.js";
-import { applyCommonDefaults } from "./defaults.js";
-import { createUid } from "./ids.js";
-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.
-     * @param options Creation options (validation, clock).
-     * @return GroupObject instance.
-     */
-    constructor(input, options = {}) {
-        if (!Array.isArray(input.entries)) {
-            throw new Error("Group.entries is required");
-        }
-        const now = options.now ?? nowUtc;
-        const { updated: rawUpdated, created: rawCreated, ...rest } = input;
-        const entries = input.entries.map((entry) => normalizeEntry(entry));
-        const updated = rawUpdated ? toUtcDateTime(rawUpdated) : now();
-        const data = {
-            ...rest,
-            "@type": "Group",
-            entries,
-            uid: input.uid ?? createUid(),
-            updated,
-        };
-        if (rawCreated) {
-            data.created = toUtcDateTime(rawCreated);
-        }
-        else {
-            data.created = updated;
-        }
-        applyCommonDefaults(data);
-        if (options.validate !== false) {
-            validateJsCalendarObject(data);
-        }
-        super(data);
-    }
-    /**
-     * Append a normalized entry to the group.
-     * @param entry Event or task entry to add.
-     * @return New GroupObject instance with the added entry.
-     */
-    addEntry(entry) {
-        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() {
-        return this.wrap(deepClone(this.data));
-    }
-}

package/dist/jscal/guards.d.ts

@@ -1,19 +0,0 @@
-import type { Event, Group, JSCalendarObject, Task } from "../types.js";
-/**
- * Type guard for JSCalendar Event objects.
- * @param obj JSCalendar object to check.
- * @return True when the object is an Event.
- */
-export 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.
- */
-export 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.
- */
-export declare function isGroup(obj: JSCalendarObject): obj is Group;

package/dist/jscal/guards.js

@@ -1,25 +0,0 @@
-import { TYPE_EVENT, TYPE_GROUP, TYPE_TASK } from "./constants.js";
-/**
- * Type guard for JSCalendar Event objects.
- * @param obj JSCalendar object to check.
- * @return True when the object is an Event.
- */
-export function isEvent(obj) {
-    return obj["@type"] === TYPE_EVENT;
-}
-/**
- * Type guard for JSCalendar Task objects.
- * @param obj JSCalendar object to check.
- * @return True when the object is a Task.
- */
-export function isTask(obj) {
-    return obj["@type"] === TYPE_TASK;
-}
-/**
- * Type guard for JSCalendar Group objects.
- * @param obj JSCalendar object to check.
- * @return True when the object is a Group.
- */
-export function isGroup(obj) {
-    return obj["@type"] === TYPE_GROUP;
-}

package/dist/jscal/ids.d.ts

@@ -1,11 +0,0 @@
-import type { Id } from "../types.js";
-/**
- * Create a UUID-like identifier.
- * @return UUID string.
- */
-export declare function createUid(): string;
-/**
- * Create a compact base64url identifier.
- * @return Base64url ID string.
- */
-export declare function createId(): Id;

package/dist/jscal/ids.js

@@ -1,77 +0,0 @@
-import { TYPEOF_FUNCTION } from "./constants.js";
-/**
- * Get a Crypto instance if available.
- * @return Crypto instance when available, otherwise undefined.
- */
-function getCrypto() {
-    const cryptoObj = globalThis.crypto;
-    if (cryptoObj && typeof cryptoObj.getRandomValues === TYPEOF_FUNCTION) {
-        return cryptoObj;
-    }
-    return undefined;
-}
-/**
- * Generate random bytes using Crypto or Math.random.
- * @param length Number of bytes to generate.
- * @return Random byte array.
- */
-function getRandomBytes(length) {
-    const bytes = new Uint8Array(length);
-    const cryptoObj = getCrypto();
-    if (cryptoObj) {
-        cryptoObj.getRandomValues(bytes);
-        return bytes;
-    }
-    for (let i = 0; i < length; i += 1) {
-        bytes[i] = Math.floor(Math.random() * 256);
-    }
-    return bytes;
-}
-/**
- * Encode bytes as base64url.
- * @param bytes Byte array to encode.
- * @return Base64url string without padding.
- */
-function base64UrlEncode(bytes) {
-    const alphabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
-    let output = "";
-    for (let i = 0; i < bytes.length; i += 3) {
-        const b0 = bytes[i] ?? 0;
-        const b1 = bytes[i + 1] ?? 0;
-        const b2 = bytes[i + 2] ?? 0;
-        const triplet = ((b0 ?? 0) << 16) | ((b1 ?? 0) << 8) | (b2 ?? 0);
-        output += alphabet[(triplet >> 18) & 0x3f] ?? "";
-        output += alphabet[(triplet >> 12) & 0x3f] ?? "";
-        output += i + 1 < bytes.length ? alphabet[(triplet >> 6) & 0x3f] ?? "" : "=";
-        output += i + 2 < bytes.length ? alphabet[triplet & 0x3f] ?? "" : "=";
-    }
-    return output.replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-}
-/**
- * Create a UUID-like identifier.
- * @return UUID string.
- */
-export function createUid() {
-    const cryptoObj = getCrypto();
-    if (cryptoObj?.randomUUID) {
-        return cryptoObj.randomUUID();
-    }
-    const bytes = getRandomBytes(16);
-    if (bytes.length > 6) {
-        const b6 = bytes[6] ?? 0;
-        bytes[6] = (b6 & 0x0f) | 0x40;
-    }
-    if (bytes.length > 8) {
-        const b8 = bytes[8] ?? 0;
-        bytes[8] = (b8 & 0x3f) | 0x80;
-    }
-    const hex = Array.from(bytes).map((b) => b.toString(16).padStart(2, "0")).join("");
-    return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
-}
-/**
- * Create a compact base64url identifier.
- * @return Base64url ID string.
- */
-export function createId() {
-    return base64UrlEncode(getRandomBytes(16));
-}

package/dist/jscal/normalize.d.ts

@@ -1,32 +0,0 @@
-import type { Event, JSCalendarObject, Task } from "../types.js";
-import type { EntryInput } from "./types.js";
-/**
- * Type guard for wrapper instances that expose a data field.
- * @param value Value to check.
- * @return True when value looks like a JsCal instance.
- */
-export declare function isJsCalInstance(value: object): value is {
-    data: JSCalendarObject;
-};
-/**
- * Normalize a list of mixed JSCalendar objects and JsCal instances.
- * @param items Items to normalize.
- * @return Plain JSCalendar objects.
- */
-export declare function normalizeItems(items: Array<JSCalendarObject | {
-    data: JSCalendarObject;
-}>): JSCalendarObject[];
-/**
- * Normalize a group entry into a plain Event or Task.
- * @param entry Group entry input.
- * @return Plain Event or Task object.
- */
-export declare function normalizeEntry(entry: EntryInput): Event | Task;
-/**
- * Normalize a list to plain JSCalendar objects.
- * @param value List of JSCalendar objects or JsCal instances.
- * @return Plain JSCalendar objects.
- */
-export declare function normalizeToObjects(value: Array<JSCalendarObject | {
-    data: JSCalendarObject;
-}>): JSCalendarObject[];

package/dist/jscal/normalize.js

@@ -1,45 +0,0 @@
-import { isObjectValue } from "../utils.js";
-/**
- * Type guard for wrapper instances that expose a data field.
- * @param value Value to check.
- * @return True when value looks like a JsCal instance.
- */
-export function isJsCalInstance(value) {
-    return "data" in value;
-}
-/**
- * Normalize a list of mixed JSCalendar objects and JsCal instances.
- * @param items Items to normalize.
- * @return Plain JSCalendar objects.
- */
-export function normalizeItems(items) {
-    const mapped = [];
-    for (const entry of items) {
-        if (isObjectValue(entry) && isJsCalInstance(entry)) {
-            mapped.push(entry.data);
-        }
-        else {
-            mapped.push(entry);
-        }
-    }
-    return mapped;
-}
-/**
- * Normalize a group entry into a plain Event or Task.
- * @param entry Group entry input.
- * @return Plain Event or Task object.
- */
-export function normalizeEntry(entry) {
-    if (isObjectValue(entry) && isJsCalInstance(entry)) {
-        return entry.data;
-    }
-    return entry;
-}
-/**
- * Normalize a list to plain JSCalendar objects.
- * @param value List of JSCalendar objects or JsCal instances.
- * @return Plain JSCalendar objects.
- */
-export function normalizeToObjects(value) {
-    return normalizeItems(value);
-}

package/dist/jscal/task.d.ts

@@ -1,23 +0,0 @@
-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, 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;
-}

package/dist/jscal/task.js

@@ -1,67 +0,0 @@
-import { resolveTimeZone } from "../timezones.js";
-import { deepClone, nowUtc } from "../utils.js";
-import { validateJsCalendarObject } from "../validate.js";
-import { applyCommonDefaults, applyTaskDefaults } from "./defaults.js";
-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.
-     * @param options Creation options (validation, clock).
-     * @return TaskObject instance.
-     */
-    constructor(input = {}, options = {}) {
-        const now = options.now ?? nowUtc;
-        const { start: rawStart, due: rawDue, updated: rawUpdated, created: rawCreated, timeZone: rawTimeZone, ...rest } = input;
-        const updated = rawUpdated ? toUtcDateTime(rawUpdated) : now();
-        let timeZone;
-        if (rawTimeZone === null) {
-            timeZone = null;
-        }
-        else if (rawTimeZone) {
-            timeZone = resolveTimeZone(rawTimeZone);
-        }
-        const data = {
-            ...rest,
-            "@type": "Task",
-            uid: input.uid ?? createUid(),
-            updated,
-        };
-        if (rawStart)
-            data.start = toLocalDateTime(rawStart);
-        if (rawDue)
-            data.due = toLocalDateTime(rawDue);
-        if (timeZone !== undefined)
-            data.timeZone = timeZone;
-        if (rawCreated) {
-            data.created = toUtcDateTime(rawCreated);
-        }
-        else {
-            data.created = updated;
-        }
-        applyCommonDefaults(data);
-        applyTaskDefaults(data);
-        if (options.validate !== false) {
-            validateJsCalendarObject(data);
-        }
-        super(data);
-    }
-    /**
-     * Clone the task as a new TaskObject instance.
-     * @return Cloned TaskObject.
-     */
-    clone() {
-        return this.wrap(deepClone(this.data));
-    }
-}

package/dist/jscal/types.d.ts

@@ -1,38 +0,0 @@
-import type { Event, Group, Task, TimeZoneInput, UTCDateTime } from "../types.js";
-export type CreateOptions = {
-    now?: () => UTCDateTime;
-    validate?: boolean;
-};
-export type UpdateOptions = {
-    touch?: boolean;
-    sequence?: boolean;
-    now?: () => UTCDateTime;
-    validate?: boolean;
-};
-export type DateInput = string | Date;
-export type DurationInput = string | number;
-export type EntryInput = Event | Task | {
-    data: Event | Task;
-};
-export type EventInput = Omit<Event, "@type" | "uid" | "updated" | "created" | "start" | "duration" | "timeZone"> & {
-    start: DateInput;
-    duration?: DurationInput;
-    timeZone?: TimeZoneInput | null;
-    uid?: string;
-    updated?: DateInput;
-    created?: DateInput;
-};
-export type TaskInput = Omit<Task, "@type" | "uid" | "updated" | "created" | "start" | "due" | "timeZone"> & {
-    uid?: string;
-    updated?: DateInput;
-    created?: DateInput;
-    start?: DateInput;
-    due?: DateInput;
-    timeZone?: TimeZoneInput | null;
-};
-export type GroupInput = Omit<Group, "@type" | "uid" | "updated" | "created" | "entries"> & {
-    entries: EntryInput[];
-    uid?: string;
-    updated?: DateInput;
-    created?: DateInput;
-};

package/dist/jscal/types.js

@@ -1 +0,0 @@
-export {};