@arbidocs/blocks 0.4.71 → 0.4.73

package/dist/calendar/draft.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Pure helpers over `EventDraft`: start/end edits that keep the duration, the all-day toggle,
+ * a draft from a grid selection, validation. Zone math goes through ./zone (Temporal).
+ */
+import type { DateTimeSpec, EventDraft, SlotSelection } from './types';
+export declare const isAllDayDraft: (d: Pick<EventDraft, "start">) => boolean;
+/** The zone a spec's wall time is in (floating → the default). */
+export declare const specZone: (spec: DateTimeSpec, defaultZone: string) => string;
+/** Date (YYYY-MM-DD) of a spec as written. */
+export declare const specDate: (spec: DateTimeSpec) => string;
+/** Time (HH:MM) of a spec as written ('' for all-day). */
+export declare const specTime: (spec: DateTimeSpec) => string;
+/** Epoch ms of a timed spec. */
+export declare function specEpochMs(spec: DateTimeSpec, defaultZone: string): number;
+/** Start/end instants of a draft (all-day: midnight of the start day / exclusive end day in the default zone). */
+export declare function draftRangeUtc(d: EventDraft, defaultZone: string): {
+    startMs: number;
+    endMs: number;
+};
+/** The inclusive last day shown for an all-day draft (API end date is exclusive). */
+export declare function allDayInclusiveEnd(d: EventDraft): string;
+/**
+ * Change the start (date, time and/or zone) and move the end by the same amount, the way every
+ * calendar app does. The end keeps its own zone.
+ */
+export declare function setDraftStart(d: EventDraft, change: {
+    date?: string;
+    time?: string;
+    timeZone?: string | null;
+}, defaultZone: string): EventDraft;
+/** Change the end (date, time and/or zone) only. All-day `date` is the inclusive last day. */
+export declare function setDraftEnd(d: EventDraft, change: {
+    date?: string;
+    time?: string;
+    timeZone?: string | null;
+}): EventDraft;
+/** Toggle all-day. Turning it off gives a timed event at `defaultStartTime` for `defaultDurationMinutes`. */
+export declare function setDraftAllDay(d: EventDraft, allDay: boolean, defaultZone: string, defaultStartTime?: string, defaultDurationMinutes?: number): EventDraft;
+/** A new draft from a grid selection, in the user's zone. */
+export declare function draftFromSlot(slot: SlotSelection, timeZone: string, calendarId?: string, title?: string): EventDraft;
+export type DraftError = 'titleRequired' | 'invalidRange';
+/** First problem that blocks saving, or null. */
+export declare function validateDraft(d: EventDraft, defaultZone: string): DraftError | null;

package/dist/calendar/format.d.ts

@@ -0,0 +1,14 @@
+/** `New York (GMT-4)`. */
+export declare function formatZoneLabel(zone: string, at?: Date | number): string;
+/** Human time range of an event in `zone`: "Fri, 16 Oct · 10:00 – 11:00", all-day "Fri, 16 Oct – Sun, 18 Oct". */
+export declare function formatEventWhen(e: {
+    all_day: boolean;
+    start_utc: string;
+    end_utc: string;
+    start: {
+        date?: string | null;
+    };
+    end: {
+        date?: string | null;
+    };
+}, zone: string, locale?: string): string;

package/dist/calendar/grid-model.d.ts

@@ -0,0 +1,24 @@
+import type { EventInput, PluginDef } from '@fullcalendar/core';
+import type { CalendarLabels, CalendarViewKind, GridEvent, WorkingHoursSpec } from './types';
+/** FullCalendar plugin resolving named zones with Temporal (built once, on first render). */
+export declare function getTemporalTimeZonePlugin(): PluginDef;
+export declare const FC_VIEW: Record<CalendarViewKind, string>;
+export declare const VIEW_OF_FC: Record<string, CalendarViewKind>;
+export declare const VIEW_ORDER: CalendarViewKind[];
+export declare const NARROW_VIEWS: CalendarViewKind[];
+/** Width (px) under which the grid switches to its phone layout. */
+export declare const CALENDAR_NARROW_WIDTH = 640;
+/** The view a narrow (phone) screen shows for the requested one: wide time grids collapse to a day. */
+export declare function effectiveCalendarView(view: CalendarViewKind, narrow: boolean): CalendarViewKind;
+export declare const viewLabel: (v: CalendarViewKind, l: CalendarLabels) => string;
+/** FullCalendar business hours from working hours (0 = Monday → FC 1). */
+export declare function toBusinessHours(hours: WorkingHoursSpec[] | undefined): false | {
+    daysOfWeek: number[];
+    startTime: string;
+    endTime: string;
+}[];
+/** Days (FC: 0 = Sunday) the work-week view hides. */
+export declare function workWeekHiddenDays(hours: WorkingHoursSpec[] | undefined): number[];
+/** CSS classes describing an event's state (also used by tests and hosts). */
+export declare function eventStateClasses(e: GridEvent): string[];
+export declare function toEventInput(e: GridEvent, zone: string): EventInput;