@riverbankcms/sdk 0.62.4 → 0.64.0

package/dist/_dts/calendar/src/grid.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Calendar grid helpers — pure date math.
+ *
+ * No items. No timezones beyond the runtime locale. No domain.
+ * Use these to lay out month/week views; group items into the resulting
+ * cells with `groupItemsByDate` from `./group`.
+ */
+export type WeekStart = 'sunday' | 'monday';
+export declare const DAY_NAMES: readonly ["Sun", "Mon", "Tue", "Wed", "Thu", "Fri", "Sat"];
+export declare const MONTH_NAMES: readonly ["January", "February", "March", "April", "May", "June", "July", "August", "September", "October", "November", "December"];
+/**
+ * Convention default: maximum events to show per calendar day before a
+ * "+N more" overflow indicator. Renderers may override.
+ */
+export declare const MAX_EVENTS_PER_DAY = 3;
+/** Format a date as YYYY-MM-DD using the runtime's local timezone. */
+export declare function formatDateKey(date: Date): string;
+/**
+ * True when `date` and `now` are the same local calendar day.
+ * `now` defaults to `new Date()` so casual callers don't need to thread it,
+ * but tests and snapshot-rendering should pass an explicit value.
+ */
+export declare function isToday(date: Date, now?: Date): boolean;
+/** True when two dates fall on the same local calendar day. */
+export declare function isSameLocalDay(left: Date, right: Date): boolean;
+export declare function getStartOfMonth(date: Date): Date;
+export declare function getEndOfMonth(date: Date): Date;
+/**
+ * Add (or subtract) months to a date, clamping the day-of-month to the
+ * target month's last day. Avoids JS Date overflow (Jan 29 + 1 month → Mar 1
+ * in non-leap years).
+ */
+export declare function addMonths(date: Date, months: number): Date;
+/**
+ * Get an inclusive 3-month window around `date`, returned as ISO strings
+ * with UTC midnight bounds. Suitable for prefetching event windows when
+ * the consumer handles timezone conversion downstream.
+ */
+export declare function getThreeMonthRange(date: Date): {
+    from: string;
+    to: string;
+};
+/**
+ * Build the calendar days for a month view. Returns 42 dates (6 rows × 7
+ * days) including padding from prior/next months for a stable grid.
+ */
+export declare function getMonthCalendarDays(year: number, month: number, startOfWeek: WeekStart): Date[];
+/** Build the 7 dates of the week containing `baseDate`. */
+export declare function getWeekCalendarDays(baseDate: Date, startOfWeek: WeekStart): Date[];
+/**
+ * Day-name labels reordered for the chosen week start. Pass a custom
+ * `dayNames` array (length 7, Sunday-first) to localize.
+ */
+export declare function getOrderedDayNames(startOfWeek: WeekStart, dayNames?: readonly string[]): string[];
+/**
+ * Header title for a calendar view.
+ *   - month: "January 2025"
+ *   - week:  "January 5 - 11, 2025" or "December 30 - January 5, 2025"
+ */
+export declare function formatCalendarTitle(viewDate: Date, view: 'month' | 'week', days: Date[], monthNames?: readonly string[]): string;

package/dist/_dts/calendar/src/group.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Group items by their local date (YYYY-MM-DD in the item's own timezone).
+ *
+ * Generic over `T`. Items with un-parseable startsAt or invalid timezone are
+ * silently dropped — call sites that need diagnostics should validate upstream.
+ *
+ * The output map preserves insertion order of dates (ES2015 spec) and the
+ * relative order of items within each date matches input order.
+ */
+export type GroupItemsByDateAccessors<T> = Readonly<{
+    getStartsAt: (item: T) => string;
+    getTimeZone: (item: T) => string;
+}>;
+export declare function groupItemsByDate<T>(items: readonly T[], accessors: GroupItemsByDateAccessors<T>): ReadonlyMap<string, readonly T[]>;

package/dist/_dts/calendar/src/index.d.ts

@@ -0,0 +1,6 @@
+export type { WeekStart } from './grid';
+export { getMonthCalendarDays, getWeekCalendarDays, getOrderedDayNames, formatCalendarTitle, formatDateKey, isToday, isSameLocalDay, addMonths, getStartOfMonth, getEndOfMonth, getThreeMonthRange, DAY_NAMES, MONTH_NAMES, MAX_EVENTS_PER_DAY, } from './grid';
+export type { TimetableInput, TimetableModel, TimetableDay, TimetableCell, TimetableBounds, TimetableDiagnostic, InvalidItemReason, TimetableView, } from './timetable';
+export { buildTimetableModel } from './timetable';
+export type { GroupItemsByDateAccessors } from './group';
+export { groupItemsByDate } from './group';

package/dist/_dts/calendar/src/lane-packing.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Interval lane-packing — internal.
+ *
+ * Pure interval math: takes a list of `{ start, end, orderKey }` and assigns
+ * each to a lane such that overlapping intervals never share a lane. Builds
+ * "transitive overlap clusters" so that an isolated afternoon item isn't
+ * forced to half-width because the morning was busy.
+ *
+ * Sort tiebreak is fully deterministic: `(start, end, orderKey)`. Callers
+ * must supply orderKey — the algorithm never re-derives it.
+ */
+export type LanePackingInput = Readonly<{
+    start: number;
+    end: number;
+    orderKey: string;
+}>;
+export type LanePackingResult = Readonly<{
+    laneIndex: number;
+    laneCount: number;
+}>;
+/**
+ * Assign lanes to a list of intervals.
+ *
+ * Returns one result per input in the same order as the input. Internally
+ * sorts a copy by `(start, end, orderKey)` to ensure determinism, then
+ * permutes results back to input order.
+ */
+export declare function assignLanes(intervals: readonly LanePackingInput[]): LanePackingResult[];

package/dist/_dts/calendar/src/timetable.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Timetable model — the package's core surface.
+ *
+ * Generic over `T`. Takes a list of timed items + a viewport; returns a
+ * day-by-day layout with overlap-packed lanes and percent-based positions
+ * plus a diagnostics list for items dropped during processing.
+ *
+ * The function is pure: given identical input (including `now`), it returns
+ * the same output. The model has no opinion on what an item is — pass
+ * accessors.
+ */
+import { type WeekStart } from './grid';
+export type TimetableBounds = Readonly<{
+    /** Hour ticks below this are clipped. Default 5. */
+    minStartHour?: number;
+    /** Hour ticks above this are clipped. Default 23. */
+    maxEndHour?: number;
+    /** Used when the items list is empty. Default 6. */
+    defaultStartHour?: number;
+    /** Used when the items list is empty. Default 21. */
+    defaultEndHour?: number;
+    /** Visual minimum so very short items stay visible/clickable. Default 2.5. */
+    minHeightPercent?: number;
+}>;
+export type TimetableInput<T> = Readonly<{
+    items: readonly T[];
+    viewDate: Date;
+    view?: TimetableView;
+    startOfWeek: WeekStart;
+    getId: (item: T) => string;
+    getStartsAt: (item: T) => string;
+    getEndsAt: (item: T) => string;
+    getTimeZone: (item: T) => string;
+    getColor?: (item: T) => string | null;
+    /** Sort tiebreak when two items have identical start+end. Defaults to getId. */
+    getOrderKey?: (item: T) => string;
+    bounds?: TimetableBounds;
+    /**
+     * "Now" reference for the `isToday` flag on each day. Defaults to
+     * `new Date()`; pass an explicit value to keep the model fully deterministic
+     * for snapshot tests.
+     */
+    now?: Date;
+}>;
+export type InvalidItemReason = 'invalid-start' | 'invalid-end' | 'invalid-timezone' | 'non-positive-duration' | 'out-of-visible-hours';
+export type TimetableDiagnostic<T> = Readonly<{
+    item: T;
+    reason: InvalidItemReason;
+}>;
+export type TimetableCell<T> = Readonly<{
+    item: T;
+    /** Local date key this rendered segment belongs to. */
+    dateKey: string;
+    /** Raw item bounds in minutes since local midnight, before clipping. */
+    startsAtMinutes: number;
+    endsAtMinutes: number;
+    /** Bounds clipped to [bounds.minStartHour..bounds.maxEndHour]; used for layout. */
+    visibleStartsAtMinutes: number;
+    visibleEndsAtMinutes: number;
+    /** Computed from visible bounds. Guaranteed: 0 <= topPercent and topPercent + heightPercent <= 100. */
+    topPercent: number;
+    heightPercent: number;
+    /** True when the item extends outside the visible window in either direction. */
+    isClippedStart: boolean;
+    isClippedEnd: boolean;
+    laneIndex: number;
+    laneCount: number;
+    color: string | null;
+}>;
+export type TimetableDay<T> = Readonly<{
+    date: Date;
+    dateKey: string;
+    isToday: boolean;
+    cells: readonly TimetableCell<T>[];
+}>;
+export type TimetableModel<T> = Readonly<{
+    days: readonly TimetableDay<T>[];
+    hourTicks: readonly number[];
+    startHour: number;
+    endHour: number;
+    rangeMinutes: number;
+    hasItems: boolean;
+    /**
+     * Items dropped during parsing or clipping, with a closed reason tag.
+     * The model never throws; callers iterate this for logging or UI hints.
+     */
+    diagnostics: readonly TimetableDiagnostic<T>[];
+}>;
+export type TimetableView = 'day' | 'week';
+export declare function buildTimetableModel<T>(input: TimetableInput<T>): TimetableModel<T>;

package/dist/_dts/calendar/src/timezone.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Timezone boundary helpers — internal.
+ *
+ * Both functions read an ISO instant in a given IANA timezone and project it
+ * onto the wall clock of that zone. They use Intl.DateTimeFormat with
+ * hourCycle: 'h23' to avoid 12/24-hour ambiguity. Used internally by the
+ * timetable model and `groupItemsByDate`; not exported from the package's
+ * public surface.
+ */
+/**
+ * Local minute-of-day [0, 24*60) for an ISO instant in the given zone.
+ * Returns NaN if the inputs cannot be parsed (caller should drop the item).
+ */
+export declare function getLocalMinuteOfDay(isoTimestamp: string, timeZone: string): number;
+/**
+ * Local YYYY-MM-DD for an ISO instant in the given zone.
+ * Returns null if the inputs cannot be parsed.
+ */
+export declare function getLocalDateKey(isoTimestamp: string, timeZone: string): string | null;

package/dist/_dts/content-editor/src/index.d.ts

@@ -14,15 +14,12 @@ export type { EntryEditorDriver } from './controller/driver';
 export { EditableBlockProvider, useBlockData } from './components/EditableBlockProvider';
 export { ContentFieldsForm, type ContentFieldsFormProps } from './components/ContentFieldsForm';
 export { useUISelector } from './ui/useUISelector';
-export { useEditorUiStore, useEditorUiStoreInstance, useOptionalEditorUiStoreInstance, createEditorUiStore } from './ui/editorUiStore';
+export { EditorUiStoreProvider, useEditorUiStore, useEditorUiStoreInstance, useOptionalEditorUiStoreInstance, createEditorUiStore } from './ui/editorUiStore';
 export type { ActivePreviewField, EditorUiStoreInstance, EditorUiState, PreviewSidebarTab, ViewportMode, ViewportWidth, ViewportState, ZoomLevel, } from './ui/editorUiStore';
 export { PreviewTextEditor } from './primitives/PreviewTextEditor';
 export { PreviewRichTextEditor } from './primitives/PreviewRichTextEditor';
 export { useStoreBinding, parseEditorPath } from './primitives/shared';
 export type { PathInfo } from './primitives/shared';
-export * as AiPatchSchema from './ai/patch/schema';
-export * from './ai/patch/allowed';
-export * from './ai/patch/diff';
 export * from './ai/overlayHelpers';
 export { diffPaths, isUnpublishedChangesDebugEnabled } from './debug/unpublishedChangesDebug';
 export { canRedoHistory, canUndoHistory, createHistoryState, asEditorBlockId, pushHistoryEntry, redoHistory, replaceHistoryPresent, undoHistory, type HistoryState, type EditorBlockId, } from './ui/editorHistory';

package/dist/_dts/core/src/booking-date-time.d.ts

@@ -134,6 +134,7 @@ export declare function parseLocalScheduleTime(value: string): LocalScheduleTime
 export declare function getLocalScheduleDate(date: Date, timeZone: BookingTimeZone | string | null | undefined): LocalScheduleDate;
 export declare function getLocalScheduleTime(date: Date, timeZone: BookingTimeZone | string | null | undefined): LocalScheduleTime;
 export declare function formatLocalScheduleDate(date: LocalScheduleDate): string;
+export declare function formatLocalScheduleTime(time: LocalScheduleTime): string;
 export declare function getDaysInLocalMonth(year: number, month: number): number;
 export declare function addLocalScheduleDays(date: LocalScheduleDate, days: number): LocalScheduleDate;
 export declare function addLocalScheduleMonths(date: LocalScheduleDate, months: number): LocalScheduleDate;

package/dist/_dts/core/src/branded.d.ts

@@ -72,6 +72,15 @@ export type WaitlistEntryId = Brand<string, 'WaitlistEntryId'>;
 export type WaitlistHoldId = Brand<string, 'WaitlistHoldId'>;
 export type ShipmentId = Brand<string, 'ShipmentId'>;
 export type ActivityLogEntryId = Brand<string, 'ActivityLogEntryId'>;
+export type DemoBlueprintId = Brand<string, 'DemoBlueprintId'>;
+export type DemoBlueprintVersionId = Brand<string, 'DemoBlueprintVersionId'>;
+export type DemoInstanceId = Brand<string, 'DemoInstanceId'>;
+export type DemoClaimId = Brand<string, 'DemoClaimId'>;
+export type DemoLifecycleAuditEventId = Brand<string, 'DemoLifecycleAuditEventId'>;
+export type DemoRuntimeId = Brand<string, 'DemoRuntimeId'>;
+export type DemoCapability = Brand<string, 'DemoCapability'>;
+export type DemoPaymentFlowId = Brand<string, 'DemoPaymentFlowId'>;
+export type DemoClaimTtlHours = Brand<number, 'DemoClaimTtlHours'>;
 export type GiftingOfferId = Brand<string, 'GiftingOfferId'>;
 export type GiftingInstrumentId = Brand<string, 'GiftingInstrumentId'>;
 export type BookingRequirementId = Brand<string, 'BookingRequirementId'>;
@@ -175,6 +184,15 @@ export declare const asWaitlistEntryId: (id: string) => WaitlistEntryId;
 export declare const asWaitlistHoldId: (id: string) => WaitlistHoldId;
 export declare const asShipmentId: (id: string) => ShipmentId;
 export declare const asActivityLogEntryId: (id: string) => ActivityLogEntryId;
+export declare const asDemoBlueprintId: (id: string) => DemoBlueprintId;
+export declare const asDemoBlueprintVersionId: (id: string) => DemoBlueprintVersionId;
+export declare const asDemoInstanceId: (id: string) => DemoInstanceId;
+export declare const asDemoClaimId: (id: string) => DemoClaimId;
+export declare const asDemoLifecycleAuditEventId: (id: string) => DemoLifecycleAuditEventId;
+export declare const asDemoRuntimeId: (id: string) => DemoRuntimeId;
+export declare const asDemoCapability: (value: string) => DemoCapability;
+export declare const asDemoPaymentFlowId: (id: string) => DemoPaymentFlowId;
+export declare const unsafeAsDemoClaimTtlHours: (value: number) => DemoClaimTtlHours;
 export declare const asGiftingOfferId: (id: string) => GiftingOfferId;
 export declare const asGiftingInstrumentId: (id: string) => GiftingInstrumentId;
 export declare const asBookingRequirementId: (id: string) => BookingRequirementId;