@pipobscure/ical 0.0.1

package/dist/journal.js

@@ -0,0 +1,148 @@
+/**
+ * VJOURNAL component (RFC 5545 §3.6.3)
+ *
+ * UID and DTSTAMP are required.
+ */
+import { Component } from './component.js';
+import { parseProperty } from './property.js';
+export class Journal extends Component {
+    constructor() {
+        super('VJOURNAL');
+    }
+    // ── 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);
+        }
+    }
+    // ── Descriptive ──────────────────────────────────────────────────────
+    get summary() {
+        return this.getProperty('SUMMARY')?.text ?? null;
+    }
+    set summary(v) {
+        this.setProperty('SUMMARY', v);
+    }
+    get descriptions() {
+        return this.getProperties('DESCRIPTION');
+    }
+    addDescription(v) {
+        this.appendProperty('DESCRIPTION', v);
+        return this;
+    }
+    get status() {
+        return this.getProperty('STATUS')?.text ?? null;
+    }
+    set status(v) {
+        this.setProperty('STATUS', 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 organizer() {
+        return this.getProperty('ORGANIZER')?.text ?? null;
+    }
+    set organizer(v) {
+        this.setProperty('ORGANIZER', v);
+    }
+    get sequence() {
+        return this.getProperty('SEQUENCE')?.number ?? null;
+    }
+    set sequence(v) {
+        this.setProperty('SEQUENCE', Math.max(0, Math.trunc(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;
+    }
+    // ── Validation ────────────────────────────────────────────────────────
+    toString() {
+        if (!this.uid)
+            throw new Error('VJOURNAL: UID is required');
+        if (!this.getProperty('DTSTAMP'))
+            throw new Error('VJOURNAL: DTSTAMP is required');
+        return super.toString();
+    }
+    // ── Factory ──────────────────────────────────────────────────────────
+    static fromRaw(props) {
+        const journal = new Journal();
+        for (const { name, params, value } of props) {
+            journal.addProperty(parseProperty(name, value, params));
+        }
+        return journal;
+    }
+}
+//# sourceMappingURL=journal.js.map

package/dist/journal.js.map

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

package/dist/parse.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Tolerant iCalendar parser.
+ *
+ * Principles:
+ *  - Accepts CRLF, LF, or bare CR line endings.
+ *  - Handles folded lines.
+ *  - Unknown components are stored as generic Component instances.
+ *  - Unknown properties are stored with TEXT value.
+ *  - Missing required wrappers are recovered from where possible.
+ *  - Malformed property lines are skipped with a warning (no crash).
+ */
+import { Calendar } from './calendar.js';
+/**
+ * Parse an iCalendar string and return a Calendar object.
+ *
+ * Tolerant: if the input has no VCALENDAR wrapper (e.g. just a bare VEVENT)
+ * the content is wrapped in a synthetic Calendar.
+ *
+ * @throws Only on completely unparseable input that yields zero tokens.
+ */
+export declare function parse(src: string): Calendar;
+/**
+ * Parse an iCalendar string and return all top-level Calendar objects.
+ * Some feeds embed multiple VCALENDAR blocks in a single file.
+ */
+export declare function parseAll(src: string): Calendar[];
+//# sourceMappingURL=parse.d.ts.map

package/dist/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../src/parse.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AA+GzC;;;;;;;GAOG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAe3C;AAED;;;GAGG;AACH,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,EAAE,CAUhD"}

package/dist/parse.js

@@ -0,0 +1,140 @@
+/**
+ * Tolerant iCalendar parser.
+ *
+ * Principles:
+ *  - Accepts CRLF, LF, or bare CR line endings.
+ *  - Handles folded lines.
+ *  - Unknown components are stored as generic Component instances.
+ *  - Unknown properties are stored with TEXT value.
+ *  - Missing required wrappers are recovered from where possible.
+ *  - Malformed property lines are skipped with a warning (no crash).
+ */
+import { tokenize } from './tokenize.js';
+import { parseProperty } from './property.js';
+import { Component } from './component.js';
+import { Calendar } from './calendar.js';
+import { Event } from './event.js';
+import { Todo } from './todo.js';
+import { Journal } from './journal.js';
+import { FreeBusy } from './freebusy.js';
+import { Timezone, buildTimezoneRule } from './timezone.js';
+import { Alarm } from './alarm.js';
+/** Build a raw component tree from the flat token stream. */
+function buildTree(src) {
+    const tokens = tokenize(src);
+    const root = { type: 'ROOT', props: [], children: [] };
+    const stack = [root];
+    for (const token of tokens) {
+        const current = stack[stack.length - 1];
+        if (token.name === 'BEGIN') {
+            const node = {
+                type: token.value.toUpperCase().trim(),
+                props: [],
+                children: [],
+            };
+            current.children.push(node);
+            stack.push(node);
+        }
+        else if (token.name === 'END') {
+            if (stack.length > 1)
+                stack.pop();
+            // Tolerant: if stack is empty we ignore the END
+        }
+        else {
+            // Normalize params: ensure all values are strings (flatten single-element arrays)
+            const params = {};
+            for (const [k, v] of Object.entries(token.params)) {
+                params[k] = Array.isArray(v) ? v.join(',') : String(v);
+            }
+            current.props.push({ name: token.name, params, value: token.value });
+        }
+    }
+    return root.children;
+}
+// ── Component builders ────────────────────────────────────────────────────
+function buildComponent(node) {
+    switch (node.type) {
+        case 'VCALENDAR': return buildCalendar(node);
+        case 'VEVENT': return buildEvent(node);
+        case 'VTODO': return buildTodo(node);
+        case 'VJOURNAL': return buildJournal(node);
+        case 'VFREEBUSY': return buildFreebusy(node);
+        case 'VTIMEZONE': return buildTimezone(node);
+        case 'VALARM': return buildAlarm(node);
+        case 'STANDARD':
+        case 'DAYLIGHT': return buildTimezoneRule(node.type, node.props);
+        default: return buildGeneric(node);
+    }
+}
+function buildCalendar(node) {
+    const children = node.children.map(buildComponent);
+    return Calendar.fromRaw(node.props, children);
+}
+function buildEvent(node) {
+    const children = node.children.map(buildComponent);
+    return Event.fromRaw(node.props, children);
+}
+function buildTodo(node) {
+    const children = node.children.map(buildComponent);
+    return Todo.fromRaw(node.props, children);
+}
+function buildJournal(node) {
+    return Journal.fromRaw(node.props);
+}
+function buildFreebusy(node) {
+    return FreeBusy.fromRaw(node.props);
+}
+function buildTimezone(node) {
+    const children = node.children.map(buildComponent);
+    return Timezone.fromRaw(node.props, children);
+}
+function buildAlarm(node) {
+    return Alarm.fromRaw(node.props);
+}
+function buildGeneric(node) {
+    const comp = new Component(node.type);
+    for (const { name, params, value } of node.props) {
+        comp.addProperty(parseProperty(name, value, params));
+    }
+    for (const child of node.children) {
+        comp.addComponent(buildComponent(child));
+    }
+    return comp;
+}
+// ── Public API ────────────────────────────────────────────────────────────
+/**
+ * Parse an iCalendar string and return a Calendar object.
+ *
+ * Tolerant: if the input has no VCALENDAR wrapper (e.g. just a bare VEVENT)
+ * the content is wrapped in a synthetic Calendar.
+ *
+ * @throws Only on completely unparseable input that yields zero tokens.
+ */
+export function parse(src) {
+    const roots = buildTree(src);
+    // Find the first VCALENDAR
+    const calNode = roots.find((n) => n.type === 'VCALENDAR');
+    if (calNode) {
+        return buildCalendar(calNode);
+    }
+    // Tolerant: no VCALENDAR wrapper — synthesize one
+    const cal = new Calendar();
+    for (const node of roots) {
+        cal.addComponent(buildComponent(node));
+    }
+    return cal;
+}
+/**
+ * Parse an iCalendar string and return all top-level Calendar objects.
+ * Some feeds embed multiple VCALENDAR blocks in a single file.
+ */
+export function parseAll(src) {
+    const roots = buildTree(src);
+    const calendars = roots.filter((n) => n.type === 'VCALENDAR');
+    if (calendars.length > 0) {
+        return calendars.map(buildCalendar);
+    }
+    // No VCALENDAR blocks — wrap everything in one
+    return [parse(src)];
+}
+//# sourceMappingURL=parse.js.map

package/dist/parse.js.map

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

package/dist/property-registry.d.ts

@@ -0,0 +1,31 @@
+/**
+ * RFC 5545 property registry.
+ *
+ * Maps property names to their default value type, allowed alternative types,
+ * whether they accept a list of values, and which components they belong to.
+ */
+export type ValueTypeName = 'TEXT' | 'INTEGER' | 'FLOAT' | 'BOOLEAN' | 'URI' | 'CAL-ADDRESS' | 'BINARY' | 'UTC-OFFSET' | 'DATE' | 'DATE-TIME' | 'TIME' | 'DURATION' | 'PERIOD' | 'RECUR' | 'GEO';
+export interface PropertyDef {
+    /** Default value type when no VALUE= parameter is present */
+    readonly defaultType: ValueTypeName;
+    /** Additional allowed value types selectable via VALUE= parameter */
+    readonly allowedTypes?: readonly ValueTypeName[];
+    /**
+     * true  → value is a comma-separated list of the same type
+     * false → single value
+     */
+    readonly multi?: boolean;
+}
+/**
+ * RFC 5545 §3.8 — Component Properties
+ * Includes deprecated but commonly encountered properties (EXRULE).
+ */
+export declare const PROPERTY_REGISTRY: Readonly<Record<string, PropertyDef>>;
+/** Look up a property definition; returns undefined for X- and unknown properties. */
+export declare function getPropertyDef(name: string): PropertyDef | undefined;
+/**
+ * Determine the effective value type for a content line.
+ * Respects VALUE= parameter override.
+ */
+export declare function resolveValueType(name: string, params: Readonly<Record<string, string | readonly string[]>>): ValueTypeName;
+//# sourceMappingURL=property-registry.d.ts.map

package/dist/property-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property-registry.d.ts","sourceRoot":"","sources":["../src/property-registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,SAAS,GACT,OAAO,GACP,SAAS,GACT,KAAK,GACL,aAAa,GACb,QAAQ,GACR,YAAY,GACZ,MAAM,GACN,WAAW,GACX,MAAM,GACN,UAAU,GACV,QAAQ,GACR,OAAO,GACP,KAAK,CAAC;AAEV,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,WAAW,EAAE,aAAa,CAAC;IACpC,qEAAqE;IACrE,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACjD;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,CAiEnE,CAAC;AAEF,sFAAsF;AACtF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEpE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,GAC3D,aAAa,CAIf"}

package/dist/property-registry.js

@@ -0,0 +1,83 @@
+/**
+ * RFC 5545 property registry.
+ *
+ * Maps property names to their default value type, allowed alternative types,
+ * whether they accept a list of values, and which components they belong to.
+ */
+/**
+ * RFC 5545 §3.8 — Component Properties
+ * Includes deprecated but commonly encountered properties (EXRULE).
+ */
+export const PROPERTY_REGISTRY = {
+    // ── Calendar Properties (§3.7) ─────────────────────────────────────────
+    CALSCALE: { defaultType: 'TEXT' },
+    METHOD: { defaultType: 'TEXT' },
+    PRODID: { defaultType: 'TEXT' },
+    VERSION: { defaultType: 'TEXT' },
+    // ── Descriptive Component Properties (§3.8.1) ──────────────────────────
+    ATTACH: { defaultType: 'URI', allowedTypes: ['BINARY'] },
+    CATEGORIES: { defaultType: 'TEXT', multi: true },
+    CLASS: { defaultType: 'TEXT' },
+    COMMENT: { defaultType: 'TEXT' },
+    DESCRIPTION: { defaultType: 'TEXT' },
+    GEO: { defaultType: 'GEO' },
+    LOCATION: { defaultType: 'TEXT' },
+    'PERCENT-COMPLETE': { defaultType: 'INTEGER' },
+    PRIORITY: { defaultType: 'INTEGER' },
+    RESOURCES: { defaultType: 'TEXT', multi: true },
+    STATUS: { defaultType: 'TEXT' },
+    SUMMARY: { defaultType: 'TEXT' },
+    // ── Date and Time Component Properties (§3.8.2) ───────────────────────
+    COMPLETED: { defaultType: 'DATE-TIME' },
+    DTEND: { defaultType: 'DATE-TIME', allowedTypes: ['DATE'] },
+    DUE: { defaultType: 'DATE-TIME', allowedTypes: ['DATE'] },
+    DTSTART: { defaultType: 'DATE-TIME', allowedTypes: ['DATE'] },
+    DURATION: { defaultType: 'DURATION' },
+    FREEBUSY: { defaultType: 'PERIOD', multi: true },
+    TRANSP: { defaultType: 'TEXT' },
+    // ── Time Zone Component Properties (§3.8.3) ───────────────────────────
+    TZID: { defaultType: 'TEXT' },
+    TZNAME: { defaultType: 'TEXT' },
+    TZOFFSETFROM: { defaultType: 'UTC-OFFSET' },
+    TZOFFSETTO: { defaultType: 'UTC-OFFSET' },
+    TZURL: { defaultType: 'URI' },
+    // ── Relationship Component Properties (§3.8.4) ────────────────────────
+    ATTENDEE: { defaultType: 'CAL-ADDRESS' },
+    CONTACT: { defaultType: 'TEXT' },
+    ORGANIZER: { defaultType: 'CAL-ADDRESS' },
+    'RECURRENCE-ID': { defaultType: 'DATE-TIME', allowedTypes: ['DATE'] },
+    'RELATED-TO': { defaultType: 'TEXT' },
+    URL: { defaultType: 'URI' },
+    UID: { defaultType: 'TEXT' },
+    // ── Recurrence Component Properties (§3.8.5) ──────────────────────────
+    EXDATE: { defaultType: 'DATE-TIME', allowedTypes: ['DATE'], multi: true },
+    RDATE: { defaultType: 'DATE-TIME', allowedTypes: ['DATE', 'PERIOD'], multi: true },
+    RRULE: { defaultType: 'RECUR' },
+    EXRULE: { defaultType: 'RECUR' }, // deprecated, still common
+    // ── Alarm Component Properties (§3.8.6) ───────────────────────────────
+    ACTION: { defaultType: 'TEXT' },
+    REPEAT: { defaultType: 'INTEGER' },
+    TRIGGER: { defaultType: 'DURATION', allowedTypes: ['DATE-TIME'] },
+    // ── Change Management Component Properties (§3.8.7) ──────────────────
+    CREATED: { defaultType: 'DATE-TIME' },
+    DTSTAMP: { defaultType: 'DATE-TIME' },
+    'LAST-MODIFIED': { defaultType: 'DATE-TIME' },
+    SEQUENCE: { defaultType: 'INTEGER' },
+    // ── Miscellaneous Component Properties (§3.8.8) ───────────────────────
+    'REQUEST-STATUS': { defaultType: 'TEXT' },
+};
+/** Look up a property definition; returns undefined for X- and unknown properties. */
+export function getPropertyDef(name) {
+    return PROPERTY_REGISTRY[name];
+}
+/**
+ * Determine the effective value type for a content line.
+ * Respects VALUE= parameter override.
+ */
+export function resolveValueType(name, params) {
+    const override = typeof params['VALUE'] === 'string' ? params['VALUE'].toUpperCase() : undefined;
+    if (override)
+        return override;
+    return PROPERTY_REGISTRY[name]?.defaultType ?? 'TEXT';
+}
+//# sourceMappingURL=property-registry.js.map

package/dist/property-registry.js.map

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

package/dist/property.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Property — a named, parametered, typed iCalendar property.
+ *
+ * Strict on construction (required for serialization).
+ * Tolerant when created from raw parsed data.
+ */
+import type { ICalValue, ParsedProperty } from './types.js';
+export declare class Property implements ParsedProperty {
+    readonly name: string;
+    readonly params: Readonly<Record<string, string | readonly string[]>>;
+    readonly value: ICalValue | readonly ICalValue[];
+    readonly rawValue: string;
+    constructor(name: string, value: ICalValue | readonly ICalValue[], params?: Readonly<Record<string, string | readonly string[]>>, rawValue?: string);
+    /** Get the first (or only) value as a plain value (null when the list is empty). */
+    get scalar(): ICalValue | null;
+    /** Get the value as an array (always). */
+    get list(): ICalValue[];
+    /** Convenience: get value as string (or null). */
+    get text(): string | null;
+    /** Convenience: get value as number (or null). */
+    get number(): number | null;
+    /** Convenience: get value as boolean. */
+    get boolean(): boolean | null;
+    /**
+     * Serialize this property to a single (unfolded) content line string.
+     * Throws if the value type cannot be serialized.
+     */
+    toContentLine(): string;
+    private serializeValue;
+}
+/**
+ * Parse a raw content-line value string into a typed Property.
+ * Tolerant: unknown value types fall back to TEXT.
+ */
+export declare function parseProperty(name: string, rawValue: string, params: Readonly<Record<string, string | readonly string[]>>): Property;
+//# sourceMappingURL=property.d.ts.map

package/dist/property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../src/property.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAK5D,qBAAa,QAAS,YAAW,cAAc;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,CAAC;IACtE,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;gBAGxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,GAAG,SAAS,SAAS,EAAE,EACvC,MAAM,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAM,EACjE,QAAQ,SAAK;IAQf,oFAAoF;IACpF,IAAI,MAAM,IAAI,SAAS,GAAG,IAAI,CAI7B;IAED,0CAA0C;IAC1C,IAAI,IAAI,IAAI,SAAS,EAAE,CAItB;IAED,kDAAkD;IAClD,IAAI,IAAI,IAAI,MAAM,GAAG,IAAI,CAGxB;IAED,kDAAkD;IAClD,IAAI,MAAM,IAAI,MAAM,GAAG,IAAI,CAG1B;IAED,yCAAyC;IACzC,IAAI,OAAO,IAAI,OAAO,GAAG,IAAI,CAG5B;IAED;;;OAGG;IACH,aAAa,IAAI,MAAM;IAMvB,OAAO,CAAC,cAAc;CAsBvB;AAiBD;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAC,CAAC,GAC3D,QAAQ,CAwBV"}

package/dist/property.js

@@ -0,0 +1,135 @@
+/**
+ * Property — a named, parametered, typed iCalendar property.
+ *
+ * Strict on construction (required for serialization).
+ * Tolerant when created from raw parsed data.
+ */
+import { CODECS, GEO } from './value-types.js';
+import { getPropertyDef, resolveValueType } from './property-registry.js';
+export class Property {
+    name;
+    params;
+    value;
+    rawValue;
+    constructor(name, value, params = {}, rawValue = '') {
+        this.name = name.toUpperCase();
+        this.value = value;
+        this.params = params;
+        this.rawValue = rawValue;
+    }
+    /** Get the first (or only) value as a plain value (null when the list is empty). */
+    get scalar() {
+        const v = this.value;
+        if (Array.isArray(v))
+            return v[0] ?? null;
+        return v;
+    }
+    /** Get the value as an array (always). */
+    get list() {
+        const v = this.value;
+        if (Array.isArray(v))
+            return [...v];
+        return [v];
+    }
+    /** Convenience: get value as string (or null). */
+    get text() {
+        const v = this.scalar;
+        return typeof v === 'string' ? v : null;
+    }
+    /** Convenience: get value as number (or null). */
+    get number() {
+        const v = this.scalar;
+        return typeof v === 'number' ? v : null;
+    }
+    /** Convenience: get value as boolean. */
+    get boolean() {
+        const v = this.scalar;
+        return typeof v === 'boolean' ? v : null;
+    }
+    /**
+     * Serialize this property to a single (unfolded) content line string.
+     * Throws if the value type cannot be serialized.
+     */
+    toContentLine() {
+        const paramStr = serializeParams(this.params);
+        const valueStr = this.serializeValue();
+        return `${this.name}${paramStr}:${valueStr}`;
+    }
+    serializeValue() {
+        const def = getPropertyDef(this.name);
+        const typeName = resolveValueType(this.name, this.params);
+        if (typeName === 'GEO') {
+            const v = this.scalar;
+            return GEO.serialize(v);
+        }
+        const codec = CODECS[typeName];
+        const serialize = (v) => {
+            if (codec)
+                return codec.serialize(v);
+            // Unknown / X- property: convert to string
+            return String(v ?? '');
+        };
+        if (def?.multi && Array.isArray(this.value)) {
+            return this.value.map(serialize).join(',');
+        }
+        return serialize(Array.isArray(this.value) ? (this.value[0] ?? '') : this.value);
+    }
+}
+function serializeParams(params) {
+    let result = '';
+    for (const [key, val] of Object.entries(params)) {
+        const valStr = Array.isArray(val) ? val.join(',') : val;
+        // Quote if contains special characters
+        const needsQuote = /[;:,]/.test(valStr);
+        result += `;${key}=${needsQuote ? `"${valStr}"` : valStr}`;
+    }
+    return result;
+}
+// ── Factory ───────────────────────────────────────────────────────────────
+/**
+ * Parse a raw content-line value string into a typed Property.
+ * Tolerant: unknown value types fall back to TEXT.
+ */
+export function parseProperty(name, rawValue, params) {
+    const typeName = resolveValueType(name, params);
+    const def = getPropertyDef(name);
+    try {
+        if (typeName === 'GEO') {
+            return new Property(name, GEO.parse(rawValue), params, rawValue);
+        }
+        const codec = CODECS[typeName] ?? CODECS['TEXT'];
+        if (def?.multi) {
+            // Split on unescaped commas
+            const parts = splitMultiValue(rawValue);
+            const values = parts.map((p) => codec.parse(p, params));
+            return new Property(name, values, params, rawValue);
+        }
+        const value = codec.parse(rawValue, params);
+        return new Property(name, value, params, rawValue);
+    }
+    catch {
+        // Tolerant fallback: store as raw string
+        return new Property(name, rawValue, params, rawValue);
+    }
+}
+/** Split a comma-separated multi-value string, respecting backslash escapes. */
+function splitMultiValue(raw) {
+    const parts = [];
+    let current = '';
+    for (let i = 0; i < raw.length; i++) {
+        if (raw[i] === '\\' && i + 1 < raw.length) {
+            current += raw[i] + raw[i + 1];
+            i++;
+        }
+        else if (raw[i] === ',') {
+            parts.push(current);
+            current = '';
+        }
+        else {
+            current += raw[i];
+        }
+    }
+    parts.push(current);
+    return parts;
+}
+//# sourceMappingURL=property.js.map

package/dist/property.js.map

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