@pipobscure/ical 0.0.1

package/dist/timezone.d.ts

@@ -0,0 +1,55 @@
+/**
+ * VTIMEZONE, DAYLIGHT, and STANDARD components (RFC 5545 §3.6.5)
+ *
+ * VTIMEZONE contains one or more DAYLIGHT or STANDARD sub-components that
+ * define the UTC offset rules.
+ */
+import { Component } from './component.js';
+import type { ICalDateTime, ICalUtcOffset, ICalRecur } from './types.js';
+export declare class TimezoneRule extends Component {
+    constructor(type: 'STANDARD' | 'DAYLIGHT');
+    get dtstart(): ICalDateTime | null;
+    set dtstart(v: ICalDateTime);
+    get tzoffsetfrom(): ICalUtcOffset | null;
+    set tzoffsetfrom(v: ICalUtcOffset);
+    get tzoffsetto(): ICalUtcOffset | null;
+    set tzoffsetto(v: ICalUtcOffset);
+    get tzname(): string | null;
+    set tzname(v: string);
+    get rrule(): ICalRecur | null;
+    set rrule(v: ICalRecur);
+    toString(): string;
+}
+export declare class Standard extends TimezoneRule {
+    constructor();
+}
+export declare class Daylight extends TimezoneRule {
+    constructor();
+}
+export declare class Timezone extends Component {
+    constructor();
+    /** TZID is required (RFC 5545 §3.6.5). */
+    get tzid(): string | null;
+    set tzid(v: string);
+    get tzurl(): string | null;
+    set tzurl(v: string);
+    get lastModified(): ICalDateTime | null;
+    set lastModified(v: ICalDateTime);
+    get standardRules(): TimezoneRule[];
+    get daylightRules(): TimezoneRule[];
+    addStandard(rule: Standard): this;
+    addDaylight(rule: Daylight): this;
+    toString(): string;
+    static fromRaw(props: ReadonlyArray<{
+        name: string;
+        params: Record<string, string>;
+        value: string;
+    }>, subcomponents: Component[]): Timezone;
+}
+/** Build a TimezoneRule (STANDARD or DAYLIGHT) from raw parsed data. */
+export declare function buildTimezoneRule(type: string, props: ReadonlyArray<{
+    name: string;
+    params: Record<string, string>;
+    value: string;
+}>): TimezoneRule;
+//# sourceMappingURL=timezone.d.ts.map

package/dist/timezone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.d.ts","sourceRoot":"","sources":["../src/timezone.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAIzE,qBAAa,YAAa,SAAQ,SAAS;gBAC7B,IAAI,EAAE,UAAU,GAAG,UAAU;IAIzC,IAAI,OAAO,IAAI,YAAY,GAAG,IAAI,CAKjC;IACD,IAAI,OAAO,CAAC,CAAC,EAAE,YAAY,EAE1B;IAED,IAAI,YAAY,IAAI,aAAa,GAAG,IAAI,CAKvC;IACD,IAAI,YAAY,CAAC,CAAC,EAAE,aAAa,EAEhC;IAED,IAAI,UAAU,IAAI,aAAa,GAAG,IAAI,CAKrC;IACD,IAAI,UAAU,CAAC,CAAC,EAAE,aAAa,EAE9B;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAE1B;IACD,IAAI,MAAM,CAAC,CAAC,EAAE,MAAM,EAEnB;IAED,IAAI,KAAK,IAAI,SAAS,GAAG,IAAI,CAG5B;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,SAAS,EAErB;IAIQ,QAAQ,IAAI,MAAM;CAM5B;AAED,qBAAa,QAAS,SAAQ,YAAY;;CAEzC;AAED,qBAAa,QAAS,SAAQ,YAAY;;CAEzC;AAID,qBAAa,QAAS,SAAQ,SAAS;;IAKrC,0CAA0C;IAC1C,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAExB;IACD,IAAI,IAAI,CAAC,CAAC,EAAE,MAAM,EAEjB;IAED,IAAI,KAAK,IAAI,MAAM,GAAG,IAAI,CAEzB;IACD,IAAI,KAAK,CAAC,CAAC,EAAE,MAAM,EAElB;IAED,IAAI,YAAY,IAAI,YAAY,GAAG,IAAI,CAKtC;IACD,IAAI,YAAY,CAAC,CAAC,EAAE,YAAY,EAE/B;IAED,IAAI,aAAa,IAAI,YAAY,EAAE,CAElC;IAED,IAAI,aAAa,IAAI,YAAY,EAAE,CAElC;IAED,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAKjC,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,IAAI;IAOxB,QAAQ,IAAI,MAAM;IAU3B,MAAM,CAAC,OAAO,CACZ,KAAK,EAAE,aAAa,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EACrF,aAAa,EAAE,SAAS,EAAE,GACzB,QAAQ;CAUZ;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,GACpF,YAAY,CAMd"}

package/dist/timezone.js

@@ -0,0 +1,141 @@
+/**
+ * VTIMEZONE, DAYLIGHT, and STANDARD components (RFC 5545 §3.6.5)
+ *
+ * VTIMEZONE contains one or more DAYLIGHT or STANDARD sub-components that
+ * define the UTC offset rules.
+ */
+import { Component } from './component.js';
+import { parseProperty } from './property.js';
+// ── STANDARD / DAYLIGHT ──────────────────────────────────────────────────
+export class TimezoneRule extends Component {
+    constructor(type) {
+        super(type);
+    }
+    get dtstart() {
+        const v = this.getValue('DTSTART');
+        return typeof v === 'object' && v !== null && v.type === 'date-time'
+            ? v
+            : null;
+    }
+    set dtstart(v) {
+        this.setProperty('DTSTART', v);
+    }
+    get tzoffsetfrom() {
+        const v = this.getValue('TZOFFSETFROM');
+        return typeof v === 'object' && v !== null && v.type === 'utc-offset'
+            ? v
+            : null;
+    }
+    set tzoffsetfrom(v) {
+        this.setProperty('TZOFFSETFROM', v);
+    }
+    get tzoffsetto() {
+        const v = this.getValue('TZOFFSETTO');
+        return typeof v === 'object' && v !== null && v.type === 'utc-offset'
+            ? v
+            : null;
+    }
+    set tzoffsetto(v) {
+        this.setProperty('TZOFFSETTO', v);
+    }
+    get tzname() {
+        return this.getProperty('TZNAME')?.text ?? null;
+    }
+    set tzname(v) {
+        this.setProperty('TZNAME', v);
+    }
+    get rrule() {
+        const v = this.getValue('RRULE');
+        return typeof v === 'object' && v !== null && v.type === 'recur' ? v : null;
+    }
+    set rrule(v) {
+        this.setProperty('RRULE', v);
+    }
+    // ── Strict validation ────────────────────────────────────────────────
+    toString() {
+        if (!this.dtstart)
+            throw new Error(`${this.type}: DTSTART is required`);
+        if (!this.tzoffsetfrom)
+            throw new Error(`${this.type}: TZOFFSETFROM is required`);
+        if (!this.tzoffsetto)
+            throw new Error(`${this.type}: TZOFFSETTO is required`);
+        return super.toString();
+    }
+}
+export class Standard extends TimezoneRule {
+    constructor() { super('STANDARD'); }
+}
+export class Daylight extends TimezoneRule {
+    constructor() { super('DAYLIGHT'); }
+}
+// ── VTIMEZONE ─────────────────────────────────────────────────────────────
+export class Timezone extends Component {
+    constructor() {
+        super('VTIMEZONE');
+    }
+    /** TZID is required (RFC 5545 §3.6.5). */
+    get tzid() {
+        return this.getProperty('TZID')?.text ?? null;
+    }
+    set tzid(v) {
+        this.setProperty('TZID', v);
+    }
+    get tzurl() {
+        return this.getProperty('TZURL')?.text ?? null;
+    }
+    set tzurl(v) {
+        this.setProperty('TZURL', v);
+    }
+    get lastModified() {
+        const v = this.getValue('LAST-MODIFIED');
+        return typeof v === 'object' && v !== null && v.type === 'date-time'
+            ? v
+            : null;
+    }
+    set lastModified(v) {
+        this.setProperty('LAST-MODIFIED', v);
+    }
+    get standardRules() {
+        return this.getComponents('STANDARD');
+    }
+    get daylightRules() {
+        return this.getComponents('DAYLIGHT');
+    }
+    addStandard(rule) {
+        this.addComponent(rule);
+        return this;
+    }
+    addDaylight(rule) {
+        this.addComponent(rule);
+        return this;
+    }
+    // ── Strict validation ────────────────────────────────────────────────
+    toString() {
+        if (!this.tzid)
+            throw new Error('VTIMEZONE: TZID is required');
+        if (this.components.length === 0) {
+            throw new Error('VTIMEZONE: at least one STANDARD or DAYLIGHT sub-component is required');
+        }
+        return super.toString();
+    }
+    // ── Factory ──────────────────────────────────────────────────────────
+    static fromRaw(props, subcomponents) {
+        const tz = new Timezone();
+        for (const { name, params, value } of props) {
+            tz.addProperty(parseProperty(name, value, params));
+        }
+        for (const sub of subcomponents) {
+            tz.addComponent(sub);
+        }
+        return tz;
+    }
+}
+/** Build a TimezoneRule (STANDARD or DAYLIGHT) from raw parsed data. */
+export function buildTimezoneRule(type, props) {
+    const rule = type.toUpperCase() === 'DAYLIGHT' ? new Daylight() : new Standard();
+    for (const { name, params, value } of props) {
+        rule.addProperty(parseProperty(name, value, params));
+    }
+    return rule;
+}
+//# sourceMappingURL=timezone.js.map

package/dist/timezone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timezone.js","sourceRoot":"","sources":["../src/timezone.ts"],"names":[],"mappings":"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"}

package/dist/todo.d.ts

@@ -0,0 +1,67 @@
+/**
+ * VTODO component (RFC 5545 §3.6.2)
+ *
+ * UID and DTSTAMP are required.
+ * DTSTART and DUE/DURATION are optional.
+ * DTEND MUST NOT be present when DURATION is present.
+ */
+import { Component } from './component.js';
+import { Property } from './property.js';
+import { Alarm } from './alarm.js';
+import type { ICalDate, ICalDateTime, ICalDuration, ICalRecur, ICalGeo, ICalValue } from './types.js';
+export declare class Todo extends Component {
+    constructor();
+    get uid(): string | null;
+    set uid(v: string);
+    get dtstamp(): ICalDateTime | null;
+    set dtstamp(v: ICalDateTime | Date);
+    get dtstart(): ICalDateTime | ICalDate | null;
+    set dtstart(v: ICalDateTime | ICalDate | Date);
+    get due(): ICalDateTime | ICalDate | null;
+    set due(v: ICalDateTime | ICalDate | Date);
+    get completed(): ICalDateTime | null;
+    set completed(v: ICalDateTime | Date);
+    get duration(): ICalDuration | null;
+    set duration(v: ICalDuration);
+    get summary(): string | null;
+    set summary(v: string);
+    get description(): string | null;
+    set description(v: string);
+    get location(): string | null;
+    set location(v: string);
+    get status(): 'NEEDS-ACTION' | 'COMPLETED' | 'IN-PROCESS' | 'CANCELLED' | string | null;
+    set status(v: string);
+    get priority(): number | null;
+    set priority(v: number);
+    get percentComplete(): number | null;
+    set percentComplete(v: number);
+    get sequence(): number | null;
+    set sequence(v: number);
+    get klass(): string | null;
+    set klass(v: string);
+    get url(): string | null;
+    set url(v: string);
+    get geo(): ICalGeo | null;
+    set geo(v: ICalGeo);
+    get organizer(): string | null;
+    set organizer(v: string);
+    get created(): ICalDateTime | null;
+    set created(v: ICalDateTime | Date);
+    get lastModified(): ICalDateTime | null;
+    set lastModified(v: ICalDateTime | Date);
+    get attendees(): Property[];
+    addAttendee(calAddress: string, params?: Record<string, string>): this;
+    get categories(): ICalValue[];
+    set categories(v: string[]);
+    get rrules(): ICalRecur[];
+    addRrule(v: ICalRecur): this;
+    get alarms(): Alarm[];
+    addAlarm(alarm: Alarm): this;
+    toString(): string;
+    static fromRaw(props: ReadonlyArray<{
+        name: string;
+        params: Record<string, string>;
+        value: string;
+    }>, subcomponents?: Component[]): Todo;
+}
+//# sourceMappingURL=todo.d.ts.map

package/dist/todo.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.d.ts","sourceRoot":"","sources":["../src/todo.ts"],"names":[],"mappings":"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"}

package/dist/todo.js

@@ -0,0 +1,220 @@
+/**
+ * VTODO component (RFC 5545 §3.6.2)
+ *
+ * UID and DTSTAMP are required.
+ * DTSTART and DUE/DURATION are optional.
+ * DTEND MUST NOT be present when DURATION is present.
+ */
+import { Component } from './component.js';
+import { parseProperty } from './property.js';
+export class Todo extends Component {
+    constructor() {
+        super('VTODO');
+    }
+    // ── Required ─────────────────────────────────────────────────────────
+    get uid() {
+        return this.getProperty('UID')?.text ?? null;
+    }
+    set uid(v) {
+        this.setProperty('UID', v);
+    }
+    get dtstamp() {
+        const v = this.getValue('DTSTAMP');
+        return v && typeof v === 'object' && v.type === 'date-time' ? v : null;
+    }
+    set dtstamp(v) {
+        this.setProperty('DTSTAMP', v instanceof Date
+            ? { type: 'date-time', year: v.getUTCFullYear(), month: v.getUTCMonth() + 1, day: v.getUTCDate(), hour: v.getUTCHours(), minute: v.getUTCMinutes(), second: v.getUTCSeconds(), utc: true }
+            : v);
+    }
+    // ── Date/time ─────────────────────────────────────────────────────────
+    get dtstart() {
+        const v = this.getValue('DTSTART');
+        if (!v || typeof v !== 'object')
+            return null;
+        return v.type === 'date-time' || v.type === 'date' ? v : null;
+    }
+    set dtstart(v) {
+        if (v instanceof Date) {
+            this.setProperty('DTSTART', { type: 'date-time', year: v.getUTCFullYear(), month: v.getUTCMonth() + 1, day: v.getUTCDate(), hour: v.getUTCHours(), minute: v.getUTCMinutes(), second: v.getUTCSeconds(), utc: true });
+        }
+        else if (v.type === 'date') {
+            this.setProperty('DTSTART', v, { VALUE: 'DATE' });
+        }
+        else {
+            this.setProperty('DTSTART', v);
+        }
+    }
+    get due() {
+        const v = this.getValue('DUE');
+        if (!v || typeof v !== 'object')
+            return null;
+        return v.type === 'date-time' || v.type === 'date' ? v : null;
+    }
+    set due(v) {
+        if (v instanceof Date) {
+            this.setProperty('DUE', { type: 'date-time', year: v.getUTCFullYear(), month: v.getUTCMonth() + 1, day: v.getUTCDate(), hour: v.getUTCHours(), minute: v.getUTCMinutes(), second: v.getUTCSeconds(), utc: true });
+        }
+        else if (v.type === 'date') {
+            this.setProperty('DUE', v, { VALUE: 'DATE' });
+        }
+        else {
+            this.setProperty('DUE', v);
+        }
+    }
+    get completed() {
+        const v = this.getValue('COMPLETED');
+        return v && typeof v === 'object' && v.type === 'date-time' ? v : null;
+    }
+    set completed(v) {
+        this.setProperty('COMPLETED', v instanceof Date
+            ? { type: 'date-time', year: v.getUTCFullYear(), month: v.getUTCMonth() + 1, day: v.getUTCDate(), hour: v.getUTCHours(), minute: v.getUTCMinutes(), second: v.getUTCSeconds(), utc: true }
+            : v);
+    }
+    get duration() {
+        const v = this.getValue('DURATION');
+        return v && typeof v === 'object' && v.type === 'duration' ? v : null;
+    }
+    set duration(v) {
+        this.setProperty('DURATION', v);
+    }
+    // ── Descriptive ──────────────────────────────────────────────────────
+    get summary() {
+        return this.getProperty('SUMMARY')?.text ?? null;
+    }
+    set summary(v) {
+        this.setProperty('SUMMARY', v);
+    }
+    get description() {
+        return this.getProperty('DESCRIPTION')?.text ?? null;
+    }
+    set description(v) {
+        this.setProperty('DESCRIPTION', v);
+    }
+    get location() {
+        return this.getProperty('LOCATION')?.text ?? null;
+    }
+    set location(v) {
+        this.setProperty('LOCATION', v);
+    }
+    get status() {
+        return this.getProperty('STATUS')?.text ?? null;
+    }
+    set status(v) {
+        this.setProperty('STATUS', v);
+    }
+    get priority() {
+        return this.getProperty('PRIORITY')?.number ?? null;
+    }
+    set priority(v) {
+        this.setProperty('PRIORITY', Math.max(0, Math.min(9, Math.trunc(v))));
+    }
+    get percentComplete() {
+        return this.getProperty('PERCENT-COMPLETE')?.number ?? null;
+    }
+    set percentComplete(v) {
+        this.setProperty('PERCENT-COMPLETE', Math.max(0, Math.min(100, Math.trunc(v))));
+    }
+    get sequence() {
+        return this.getProperty('SEQUENCE')?.number ?? null;
+    }
+    set sequence(v) {
+        this.setProperty('SEQUENCE', Math.max(0, Math.trunc(v)));
+    }
+    get klass() {
+        return this.getProperty('CLASS')?.text ?? null;
+    }
+    set klass(v) {
+        this.setProperty('CLASS', v);
+    }
+    get url() {
+        return this.getProperty('URL')?.text ?? null;
+    }
+    set url(v) {
+        this.setProperty('URL', v);
+    }
+    get geo() {
+        const v = this.getValue('GEO');
+        return v && typeof v === 'object' && v.type === 'geo' ? v : null;
+    }
+    set geo(v) {
+        this.setProperty('GEO', v);
+    }
+    get organizer() {
+        return this.getProperty('ORGANIZER')?.text ?? null;
+    }
+    set organizer(v) {
+        this.setProperty('ORGANIZER', v);
+    }
+    get created() {
+        const v = this.getValue('CREATED');
+        return v && typeof v === 'object' && v.type === 'date-time' ? v : null;
+    }
+    set created(v) {
+        this.setProperty('CREATED', v instanceof Date
+            ? { type: 'date-time', year: v.getUTCFullYear(), month: v.getUTCMonth() + 1, day: v.getUTCDate(), hour: v.getUTCHours(), minute: v.getUTCMinutes(), second: v.getUTCSeconds(), utc: true }
+            : v);
+    }
+    get lastModified() {
+        const v = this.getValue('LAST-MODIFIED');
+        return v && typeof v === 'object' && v.type === 'date-time' ? v : null;
+    }
+    set lastModified(v) {
+        this.setProperty('LAST-MODIFIED', v instanceof Date
+            ? { type: 'date-time', year: v.getUTCFullYear(), month: v.getUTCMonth() + 1, day: v.getUTCDate(), hour: v.getUTCHours(), minute: v.getUTCMinutes(), second: v.getUTCSeconds(), utc: true }
+            : v);
+    }
+    // ── Multi-occurrence ──────────────────────────────────────────────────
+    get attendees() {
+        return this.getProperties('ATTENDEE');
+    }
+    addAttendee(calAddress, params = {}) {
+        this.appendProperty('ATTENDEE', calAddress, params);
+        return this;
+    }
+    get categories() {
+        return this.getValues('CATEGORIES');
+    }
+    set categories(v) {
+        this.setProperty('CATEGORIES', v);
+    }
+    get rrules() {
+        return this.getProperties('RRULE')
+            .map((p) => p.scalar)
+            .filter((v) => typeof v === 'object' && v !== null && v.type === 'recur');
+    }
+    addRrule(v) {
+        this.appendProperty('RRULE', v);
+        return this;
+    }
+    get alarms() {
+        return this.getComponents('VALARM');
+    }
+    addAlarm(alarm) {
+        this.addComponent(alarm);
+        return this;
+    }
+    // ── Validation ────────────────────────────────────────────────────────
+    toString() {
+        if (!this.uid)
+            throw new Error('VTODO: UID is required');
+        if (!this.getProperty('DTSTAMP'))
+            throw new Error('VTODO: DTSTAMP is required');
+        if (this.getProperty('DUE') && this.getProperty('DURATION')) {
+            throw new Error('VTODO: DUE and DURATION MUST NOT both be present');
+        }
+        return super.toString();
+    }
+    // ── Factory ──────────────────────────────────────────────────────────
+    static fromRaw(props, subcomponents = []) {
+        const todo = new Todo();
+        for (const { name, params, value } of props) {
+            todo.addProperty(parseProperty(name, value, params));
+        }
+        for (const sub of subcomponents) {
+            todo.addComponent(sub);
+        }
+        return todo;
+    }
+}
+//# sourceMappingURL=todo.js.map

package/dist/todo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"todo.js","sourceRoot":"","sources":["../src/todo.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAY,aAAa,EAAE,MAAM,eAAe,CAAC;AAIxD,MAAM,OAAO,IAAK,SAAQ,SAAS;IACjC;QACE,KAAK,CAAC,OAAO,CAAC,CAAC;IACjB,CAAC;IAED,wEAAwE;IAExE,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IAC/C,CAAC;IACD,IAAI,GAAG,CAAC,CAAS;QACf,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,OAAO;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAE,CAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,CAAC,CAAsB;QAChC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,YAAY,IAAI;YAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAyB;YACjN,CAAC,CAAC,CAAC,CAAC,CAAC;IACT,CAAC;IAED,yEAAyE;IAEzE,IAAI,OAAO;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,CAAC;IACD,IAAI,OAAO,CAAC,CAAiC;QAC3C,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAyB,CAAC,CAAC;QAC/O,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QACpD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QACjC,CAAC;IACH,CAAC;IAED,IAAI,GAAG;QACL,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC,CAAE,CAA6B,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7F,CAAC;IACD,IAAI,GAAG,CAAC,CAAiC;QACvC,IAAI,CAAC,YAAY,IAAI,EAAE,CAAC;YACtB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAyB,CAAC,CAAC;QAC3O,CAAC;aAAM,IAAI,CAAC,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC7B,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,IAAI,SAAS;QACX,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACrC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAE,CAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,CAAC;IACD,IAAI,SAAS,CAAC,CAAsB;QAClC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,YAAY,IAAI;YAC7C,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAyB;YACjN,CAAC,CAAC,CAAC,CAAC,CAAC;IACT,CAAC;IAED,IAAI,QAAQ;QACV,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;QACpC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAE,CAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,CAAC;IACD,IAAI,QAAQ,CAAC,CAAe;QAC1B,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,wEAAwE;IAExE,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,CAAC,CAAS;QACnB,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;IACjC,CAAC;IAED,IAAI,WAAW;QACb,OAAO,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IACvD,CAAC;IACD,IAAI,WAAW,CAAC,CAAS;QACvB,IAAI,CAAC,WAAW,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IACpD,CAAC;IACD,IAAI,QAAQ,CAAC,CAAS;QACpB,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IAClD,CAAC;IACD,IAAI,MAAM,CAAC,CAAS;QAClB,IAAI,CAAC,WAAW,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAChC,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;IACtD,CAAC;IACD,IAAI,QAAQ,CAAC,CAAS;QACpB,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACxE,CAAC;IAED,IAAI,eAAe;QACjB,OAAO,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;IAC9D,CAAC;IACD,IAAI,eAAe,CAAC,CAAS;QAC3B,IAAI,CAAC,WAAW,CAAC,kBAAkB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAClF,CAAC;IAED,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,MAAM,IAAI,IAAI,CAAC;IACtD,CAAC;IACD,IAAI,QAAQ,CAAC,CAAS;QACpB,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC3D,CAAC;IAED,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,CAAS;QACjB,IAAI,CAAC,WAAW,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IAC/C,CAAC;IACD,IAAI,GAAG,CAAC,CAAS;QACf,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,GAAG;QACL,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/B,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAE,CAAa,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,CAAC;IACD,IAAI,GAAG,CAAC,CAAU;QAChB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;IAC7B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,EAAE,IAAI,IAAI,IAAI,CAAC;IACrD,CAAC;IACD,IAAI,SAAS,CAAC,CAAS;QACrB,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC;IACnC,CAAC;IAED,IAAI,OAAO;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACnC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAE,CAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,CAAC;IACD,IAAI,OAAO,CAAC,CAAsB;QAChC,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC,YAAY,IAAI;YAC3C,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAyB;YACjN,CAAC,CAAC,CAAC,CAAC,CAAC;IACT,CAAC;IAED,IAAI,YAAY;QACd,MAAM,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAC;QACzC,OAAO,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAE,CAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAC3F,CAAC;IACD,IAAI,YAAY,CAAC,CAAsB;QACrC,IAAI,CAAC,WAAW,CAAC,eAAe,EAAE,CAAC,YAAY,IAAI;YACjD,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAyB;YACjN,CAAC,CAAC,CAAC,CAAC,CAAC;IACT,CAAC;IAED,yEAAyE;IAEzE,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,aAAa,CAAC,UAAU,CAAC,CAAC;IACxC,CAAC;IAED,WAAW,CAAC,UAAkB,EAAE,SAAiC,EAAE;QACjE,IAAI,CAAC,cAAc,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACtC,CAAC;IAED,IAAI,UAAU,CAAC,CAAW;QACxB,IAAI,CAAC,WAAW,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;IACpC,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC;aAC/B,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC;aACpB,MAAM,CAAC,CAAC,CAAC,EAAkB,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC;IAC9F,CAAC;IAED,QAAQ,CAAC,CAAY;QACnB,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAY,CAAC;IACjD,CAAC;IAED,QAAQ,CAAC,KAAY;QACnB,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,yEAAyE;IAEhE,QAAQ;QACf,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,SAAS,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;QAChF,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5D,MAAM,IAAI,KAAK,CAAC,kDAAkD,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC1B,CAAC;IAED,wEAAwE;IAExE,MAAM,CAAC,OAAO,CACZ,KAAqF,EACrF,gBAA6B,EAAE;QAE/B,MAAM,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACxB,KAAK,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,KAAK,EAAE,CAAC;YAC5C,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,aAAa,EAAE,CAAC;YAChC,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/tokenize.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Low-level iCalendar tokenizer.
+ *
+ * Handles:
+ * - CRLF, LF, and bare CR line endings (tolerant)
+ * - Line unfolding (RFC 5545 §3.1: lines starting with SPACE or HTAB are continuations)
+ * - Content line parsing: name, parameters, value
+ * - Quoted parameter values
+ * - Multi-value parameters (comma-separated)
+ */
+import type { ContentLine } from './types.js';
+/**
+ * Parse a single content line into its name, parameters, and value.
+ * Returns null for empty or unparseable lines (tolerant).
+ */
+export declare function parseContentLine(line: string): ContentLine | null;
+/**
+ * Tokenize an iCalendar string into an array of content lines.
+ * Tolerant: skips blank lines and unparseable content.
+ */
+export declare function tokenize(src: string): ContentLine[];
+//# sourceMappingURL=tokenize.d.ts.map

package/dist/tokenize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.d.ts","sourceRoot":"","sources":["../src/tokenize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAU9C;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CA0DjE;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CASnD"}

package/dist/tokenize.js

@@ -0,0 +1,95 @@
+/**
+ * Low-level iCalendar tokenizer.
+ *
+ * Handles:
+ * - CRLF, LF, and bare CR line endings (tolerant)
+ * - Line unfolding (RFC 5545 §3.1: lines starting with SPACE or HTAB are continuations)
+ * - Content line parsing: name, parameters, value
+ * - Quoted parameter values
+ * - Multi-value parameters (comma-separated)
+ */
+/** Normalize line endings and unfold continuation lines. */
+function unfold(str) {
+    return str
+        .replace(/\r\n/g, '\n')
+        .replace(/\r/g, '\n')
+        .replace(/\n[ \t]/g, ''); // RFC 5545 §3.1 unfolding
+}
+/**
+ * Parse a single content line into its name, parameters, and value.
+ * Returns null for empty or unparseable lines (tolerant).
+ */
+export function parseContentLine(line) {
+    const len = line.length;
+    if (len === 0)
+        return null;
+    let i = 0;
+    // ── name ──────────────────────────────────────────────────────────────────
+    // RFC 5545: name = iana-token / x-name
+    // iana-token = 1*(ALPHA / DIGIT / "-")
+    const nameStart = i;
+    while (i < len && line[i] !== ':' && line[i] !== ';')
+        i++;
+    const name = line.slice(nameStart, i).trim().toUpperCase();
+    if (!name)
+        return null;
+    // ── parameters ────────────────────────────────────────────────────────────
+    const params = {};
+    while (i < len && line[i] === ';') {
+        i++; // consume ';'
+        // param-name
+        const pnStart = i;
+        while (i < len && line[i] !== '=' && line[i] !== ';' && line[i] !== ':')
+            i++;
+        const paramName = line.slice(pnStart, i).trim().toUpperCase();
+        const values = [];
+        if (i < len && line[i] === '=') {
+            i++; // consume '='
+            // One or more comma-separated param-values
+            do {
+                if (i < len && line[i] === '"') {
+                    // Quoted string (DQUOTE *QSAFE-CHAR DQUOTE)
+                    i++; // consume opening '"'
+                    const vStart = i;
+                    while (i < len && line[i] !== '"')
+                        i++;
+                    values.push(line.slice(vStart, i));
+                    if (i < len)
+                        i++; // consume closing '"'
+                }
+                else {
+                    // Unquoted param-value: everything up to ',' ';' ':'
+                    const vStart = i;
+                    while (i < len && line[i] !== ',' && line[i] !== ';' && line[i] !== ':')
+                        i++;
+                    values.push(line.slice(vStart, i).trim());
+                }
+            } while (i < len && line[i] === ',' && ++i); // consume ',' between values
+        }
+        if (paramName) {
+            params[paramName] = values.length === 1 ? (values[0] ?? '') : values;
+        }
+    }
+    // ── value ─────────────────────────────────────────────────────────────────
+    if (i < len && line[i] === ':')
+        i++; // consume ':'
+    const value = line.slice(i);
+    return { name, params, value };
+}
+/**
+ * Tokenize an iCalendar string into an array of content lines.
+ * Tolerant: skips blank lines and unparseable content.
+ */
+export function tokenize(src) {
+    const lines = unfold(src).split('\n');
+    const result = [];
+    for (const line of lines) {
+        if (!line.trim())
+            continue;
+        const parsed = parseContentLine(line);
+        if (parsed)
+            result.push(parsed);
+    }
+    return result;
+}
+//# sourceMappingURL=tokenize.js.map

package/dist/tokenize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenize.js","sourceRoot":"","sources":["../src/tokenize.ts"],"names":[],"mappings":"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"}