@arbidocs/blocks 0.4.70 → 0.4.72

package/dist/calendar/labels.d.ts

@@ -0,0 +1,4 @@
+import type { CalendarLabels } from './types';
+/** Every fixed string of the calendar block. Pass `labels` to any component to override. */
+export declare const CALENDAR_DEFAULT_LABELS: CalendarLabels;
+export declare const mergeLabels: (labels?: Partial<CalendarLabels>) => CalendarLabels;

package/dist/calendar/recurrence-labels.d.ts

@@ -0,0 +1,22 @@
+import type { RRuleWeekday } from './recurrence';
+export interface RecurrenceEditorLabels {
+    doesNotRepeat: string;
+    daily: string;
+    weekly: string;
+    monthly: string;
+    yearly: string;
+    custom: string;
+    every: string;
+    units: Record<'daily' | 'weekly' | 'monthly' | 'yearly', string>;
+    onDayOfMonth: string;
+    onThe: string;
+    ends: string;
+    never: string;
+    onDate: string;
+    after: string;
+    occurrences: string;
+    rrule: string;
+    rrulePlaceholder: string;
+    weekdayShort: Record<RRuleWeekday, string>;
+}
+export declare const DEFAULT_RECURRENCE_EDITOR_LABELS: RecurrenceEditorLabels;

package/dist/calendar/recurrence.d.ts

@@ -0,0 +1,66 @@
+export declare const RRULE_WEEKDAYS: readonly ["MO", "TU", "WE", "TH", "FR", "SA", "SU"];
+export type RRuleWeekday = (typeof RRULE_WEEKDAYS)[number];
+export type RecurrenceFrequency = 'none' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'custom';
+/** 1..4 = first..fourth, -1 = last. */
+export type SetPos = 1 | 2 | 3 | 4 | -1;
+export interface RecurrenceForm {
+    freq: RecurrenceFrequency;
+    interval: number;
+    /** Weekly: the chosen days. */
+    weekdays: RRuleWeekday[];
+    /** Monthly / yearly: on a day of the month, or on the nth weekday. */
+    monthlyMode: 'day' | 'weekday';
+    monthDay: number;
+    setPos: SetPos;
+    setPosDay: RRuleWeekday;
+    /** Yearly: 1..12. */
+    month: number;
+    end: 'never' | 'until' | 'count';
+    /** YYYY-MM-DD, inclusive, in the event's zone. */
+    until: string | null;
+    count: number;
+    /** The raw rule for `custom` (and the original text of any parsed rule). */
+    raw: string;
+}
+/** The weekday code of a `YYYY-MM-DD` date. */
+export declare function weekdayOf(date: string): RRuleWeekday;
+/** Which occurrence of its weekday a date is in its month: 1..4, or -1 when it is the last one. */
+export declare function setPosOf(date: string, preferLast?: boolean): SetPos;
+/** A sensible form for an event starting on `startDate` (YYYY-MM-DD). */
+export declare function defaultRecurrenceForm(startDate: string, freq?: RecurrenceFrequency): RecurrenceForm;
+export interface BuildRRuleContext {
+    /** All-day events take a DATE UNTIL; timed events a UTC DATE-TIME. */
+    allDay?: boolean;
+    /** Zone the until date is read in (end of that day). */
+    timeZone?: string | null;
+}
+/** Build the RRULE value (no `RRULE:` prefix), or null for "does not repeat". */
+export declare function buildRRule(form: RecurrenceForm, ctx?: BuildRRuleContext): string | null;
+/**
+ * Parse an RRULE into the form. `startDate` seeds the fields the rule does not pin. A rule outside
+ * the form's vocabulary comes back as `freq: 'custom'` with its text in `raw`.
+ */
+export declare function parseRRule(rrule: string | null | undefined, startDate: string, ctx?: BuildRRuleContext): RecurrenceForm;
+export interface RecurrenceDescribeLabels {
+    every: string;
+    day: string;
+    days: string;
+    week: string;
+    weeks: string;
+    month: string;
+    months: string;
+    year: string;
+    years: string;
+    on: string;
+    onDay: string;
+    until: string;
+    times: string;
+    ordinals: Record<SetPos, string>;
+    weekdayNames: Record<RRuleWeekday, string>;
+    monthNames: string[];
+    doesNotRepeat: string;
+    custom: string;
+}
+export declare const DEFAULT_RECURRENCE_DESCRIBE_LABELS: RecurrenceDescribeLabels;
+/** One-line human summary: "Every 2 weeks on Monday, Wednesday, 10 times". */
+export declare function describeRecurrence(form: RecurrenceForm, labels?: RecurrenceDescribeLabels): string;

package/dist/calendar/reminders.d.ts

@@ -0,0 +1,26 @@
+/** Reminder offsets: minutes ↔ (value, unit) and human text. */
+export type ReminderUnit = 'minutes' | 'hours' | 'days' | 'weeks';
+/** The largest unit that divides `minutes` exactly: 90 → 90 minutes, 120 → 2 hours, 1440 → 1 day. */
+export declare function splitReminderMinutes(minutes: number): {
+    value: number;
+    unit: ReminderUnit;
+};
+export declare function reminderToMinutes(value: number, unit: ReminderUnit): number;
+export interface ReminderFormatLabels {
+    atStart: string;
+    before: string;
+    after: string;
+    minute: string;
+    minutes: string;
+    hour: string;
+    hours: string;
+    day: string;
+    days: string;
+    week: string;
+    weeks: string;
+}
+export declare const DEFAULT_REMINDER_FORMAT_LABELS: ReminderFormatLabels;
+/** `15 minutes before`, `1 hour before`, `2 days before`, `At time of event`. */
+export declare function formatReminder(minutesBefore: number, labels?: ReminderFormatLabels): string;
+/** Common presets offered in the "add reminder" menu. */
+export declare const REMINDER_PRESETS: number[];

package/dist/calendar/scheduling.d.ts

@@ -0,0 +1,27 @@
+export interface DayWindow {
+    startMs: number;
+    endMs: number;
+}
+/** The shown window of `date` in `zone`, from `startHour` to `endHour` (wall-clock, DST-correct). */
+export declare function dayWindow(date: string, zone: string, startHour?: number, endHour?: number): DayWindow;
+export interface PlacedInterval {
+    leftPct: number;
+    widthPct: number;
+    startMs: number;
+    endMs: number;
+}
+/** Clip intervals to the window and place them as percentages; intervals outside it are dropped. */
+export declare function placeIntervals(intervals: {
+    startUtc: string;
+    endUtc: string;
+}[], win: DayWindow): PlacedInterval[];
+/** The parts of the window NOT covered by `working` (shaded as outside working hours). */
+export declare function outsideIntervals(working: {
+    startUtc: string;
+    endUtc: string;
+}[], win: DayWindow): PlacedInterval[];
+/** Hour tick marks (label hour + left %) for the header. */
+export declare function hourTicks(date: string, zone: string, startHour: number, endHour: number): {
+    hour: number;
+    leftPct: number;
+}[];