@alfadocs/ui-kit-debug 1.13.0 → 1.15.0

package/dist/patterns/calendar/calendar-workspace.d.ts

@@ -0,0 +1,82 @@
+import { type CalendarData } from './calendar.data';
+import type { CalendarJourney } from './calendar.journey';
+import { type CalendarPreferenceAdapter } from './calendar.preferences';
+import { type EditorPrefill } from './calendar.model';
+import { type CalendarWorkspaceToolId, type WorkspaceDisplaySettings } from './calendar-workspace.model';
+export { WORKSPACE_TOOL, type CalendarWorkspaceToolId, } from './calendar-workspace.model';
+export interface CalendarWorkspaceProps {
+    /** The domain state and its handlers — the host implements them. */
+    journey: CalendarJourney;
+    /** The practice's read model, stable for a page load. */
+    data: CalendarData;
+    locale?: string;
+    /** Host-level cog overrides. */
+    initialDisplay?: Partial<WorkspaceDisplaySettings>;
+    /** The platform's `practice_appointment_edit` right — false turns the
+     *  page read-only (no drag, no create, details without write actions). */
+    permissions?: {
+        editAppointment?: boolean;
+    };
+    /** Deep link `focusAppointmentId`: open on the appointment's day, ring
+     *  and scroll to its card and dock its details. */
+    focusAppointmentId?: string;
+    /** Deep link `createParameters`: arrive in CREATE mode — the banner
+     *  stands and the next free-slot click opens the editor prefilled. */
+    createParameters?: {
+        prefill: EditorPrefill;
+        patientName?: string;
+    };
+    /** Deep link `freeSlotClicked`: jump to the slot and open the editor
+     *  prefilled with it. */
+    freeSlot?: EditorPrefill;
+    /** Platform advisories the finder raises when the scheduler is empty. */
+    businessHours?: {
+        practice?: boolean;
+        operators?: boolean;
+    };
+    /**
+     * The tools this host can back with real data. Omitting one hides both
+     * its rail tool and the toolbar control that opens it. Defaults to all
+     * five.
+     *
+     * A tool a host cannot supply must not be offered: the free-slot
+     * finder without the practice's business hours, holidays and closures
+     * reports slots as free that are already booked or fall on days the
+     * practice is shut, and staff ring patients with them. `appointments`
+     * is always included — the rail docks it as its resting panel — and a
+     * route into a tool left out (a deep link, a panel hand-off) lands
+     * there instead of on an empty dock.
+     */
+    availableTools?: readonly CalendarWorkspaceToolId[];
+    /**
+     * The practice's FullCalendar Scheduler licence key, passed straight
+     * through to the kit `Calendar`.
+     *
+     * Chairs and operators as columns are Scheduler premium views, so a
+     * host that does not supply a key renders the "Your license key is
+     * invalid" watermark across the resource columns. The kit ships no key
+     * and invents no default: omit this and the grid behaves exactly as it
+     * did before the prop existed, falling through to whatever the
+     * `Calendar` component's own environment default resolves to.
+     */
+    schedulerLicenseKey?: string;
+    /** Where the cog's settings, the view, the weekend choice and the
+     *  chair / operator selections are remembered — the host's per-user
+     *  store. Defaults to the session-scoped in-memory adapter. */
+    preferences?: CalendarPreferenceAdapter;
+    /** The grid's instance id — the agent registry's handle for this
+     *  calendar and the DOM hook anything outside React reaches it by.
+     *  Override it only when two workspaces share one page. */
+    id?: string;
+}
+/**
+ * The cog's settings as the workspace opens with them: the remembered
+ * entry under the workspace's own key, a caller's `initialDisplay`
+ * winning for the keys it names. Exported so a host seeding its journey
+ * (row colours follow `colorAssociation`) starts from the same values
+ * the workspace will show.
+ */
+export declare function initialWorkspaceDisplay(initialDisplay: Partial<WorkspaceDisplaySettings> | undefined, preferences?: CalendarPreferenceAdapter): WorkspaceDisplaySettings;
+/** The workspace root: the read model, then the rail scope, then the page. */
+export declare function CalendarWorkspace({ data, ...props }: CalendarWorkspaceProps): import("react/jsx-runtime").JSX.Element;
+//# sourceMappingURL=calendar-workspace.d.ts.map

package/dist/patterns/calendar/calendar-workspace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar-workspace.d.ts","sourceRoot":"","sources":["../../../src/patterns/calendar/calendar-workspace.tsx"],"names":[],"mappings":"AAkEA,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAM1D,OAAO,EAEL,KAAK,yBAAyB,EAG/B,MAAM,wBAAwB,CAAC;AAQhC,OAAO,EAGL,KAAK,aAAa,EAYnB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,uBAAuB,EAK5B,KAAK,wBAAwB,EAiB9B,MAAM,4BAA4B,CAAC;AAqBpC,OAAO,EACL,cAAc,EACd,KAAK,uBAAuB,GAC7B,MAAM,4BAA4B,CAAC;AAwvBpC,MAAM,WAAW,sBAAsB;IACrC,oEAAoE;IACpE,OAAO,EAAE,eAAe,CAAC;IACzB,yDAAyD;IACzD,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC,wBAAwB,CAAC,CAAC;IACnD;8EAC0E;IAC1E,WAAW,CAAC,EAAE;QAAE,eAAe,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5C;uDACmD;IACnD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B;0EACsE;IACtE,gBAAgB,CAAC,EAAE;QAAE,OAAO,EAAE,aAAa,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACpE;6BACyB;IACzB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,yEAAyE;IACzE,aAAa,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAC;QAAC,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IAC5D;;;;;;;;;;;;OAYG;IACH,cAAc,CAAC,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACpD;;;;;;;;;;OAUG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;mEAE+D;IAC/D,WAAW,CAAC,EAAE,yBAAyB,CAAC;IACxC;;+DAE2D;IAC3D,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,OAAO,CAAC,wBAAwB,CAAC,GAAG,SAAS,EAC7D,WAAW,GAAE,yBAAmD,GAC/D,wBAAwB,CAK1B;AAED,8EAA8E;AAC9E,wBAAgB,iBAAiB,CAAC,EAAE,IAAI,EAAE,GAAG,KAAK,EAAE,EAAE,sBAAsB,2CAQ3E"}

package/dist/patterns/calendar/calendar-workspace.model.d.ts

@@ -0,0 +1,380 @@
+/**
+ * Calendar demo, Increment 1 — the pure model the rail-hosted surface
+ * adds on top of `calendar.model.ts`: the four-way range view with its
+ * keyboard shortcuts, the extended display settings (default duration,
+ * name display, map link), the practice-hours time axis, the platform's
+ * filter semantics (nothing ticked = everyone) and the split-button
+ * badge count. No React, no i18n lookups. Every read of practice data
+ * goes through the explicit `data: CalendarData` parameter.
+ */
+import type { AppointmentItem } from '../../components/appointment-card';
+import type { CalendarResource } from '../../components/calendar';
+import type { CalendarData } from './calendar.data';
+import type { CalendarPatient, CalendarWaitingEntry } from './calendar.types';
+import { type CalendarRow, type DisplaySettings, type EditorDraft, type EditorPrefill, type WaitingQuickView } from './calendar.model';
+export declare const WORKSPACE_TOOL: {
+    readonly appointments: "appointments";
+    readonly editor: "appointment-editor";
+    readonly waitingList: "waiting-list";
+    readonly bookings: "online-bookings";
+    readonly findSlots: "find-slots";
+};
+/** One of the workspace rail's five tools. */
+export type CalendarWorkspaceToolId = (typeof WORKSPACE_TOOL)[keyof typeof WORKSPACE_TOOL];
+/** Strip order — the order the rail registers the tools in, and the
+ *  order a host's `availableTools` is normalised back to. */
+export declare const ALL_WORKSPACE_TOOLS: readonly CalendarWorkspaceToolId[];
+/**
+ * Which tools this host can back with real data, as a membership set.
+ *
+ * Appointments is forced in whatever the caller asked for: the rail
+ * docks it as its resting panel, so leaving it out would leave an empty
+ * dock rather than a smaller rail. An id the kit does not know is
+ * ignored rather than thrown on — a host on a newer contract than the
+ * kit it mounts must not crash the agenda.
+ */
+export declare function resolveAvailableTools(requested: readonly string[]): ReadonlySet<CalendarWorkspaceToolId>;
+/** The platform's four ranges; "Working week" became the Show-weekends
+ *  item, so it is no longer a view of its own. */
+export type WorkspaceViewId = 'day' | 'threeDays' | 'week' | 'month';
+export declare const WORKSPACE_VIEWS: readonly WorkspaceViewId[];
+/** CalendarView stem per range — composed with the column axis. */
+export declare const WORKSPACE_VIEW_STEM: Record<WorkspaceViewId, 'Day' | 'ThreeDays' | 'Week' | 'Month'>;
+/** Google-Calendar-style single-key shortcuts (X = 3 days, as GCal). */
+export declare const VIEW_SHORTCUT_KEYS: Record<WorkspaceViewId, string>;
+export declare const readWorkspaceViewId: (raw: unknown) => WorkspaceViewId | undefined;
+/** The range a bare key press selects, case-insensitive; undefined when
+ *  the key is not a shortcut. */
+export declare function viewForShortcutKey(key: string): WorkspaceViewId | undefined;
+export declare function shortcutAllowedOn(target: EventTarget | null): boolean;
+/** The keydown shape the shortcut resolver reads — a subset of
+ *  KeyboardEvent so tests can pass plain objects. */
+export interface ShortcutKeydown {
+    key: string;
+    altKey: boolean;
+    ctrlKey: boolean;
+    metaKey: boolean;
+    shiftKey: boolean;
+    repeat: boolean;
+    defaultPrevented: boolean;
+    target: EventTarget | null;
+}
+/** The range a page-level keydown switches to, or undefined when the
+ *  press must be left alone (modifier, auto-repeat, typing, an open
+ *  menu or dialog, already handled). */
+export declare function shortcutViewForKeydown(event: ShortcutKeydown): WorkspaceViewId | undefined;
+/** Weekend visibility is a per-user choice now (platform hidden days):
+ *  off hides Saturday and Sunday in every range view. */
+export declare function weekendHiddenDays(showWeekends: boolean): number[];
+export type OperatorNameDisplay = 'full' | 'initials';
+export type ChairNameDisplay = 'full' | 'short';
+export interface WorkspaceDisplaySettings extends DisplaySettings {
+    /** The per-user default appointment length (platform 30). */
+    defaultDurationMin: number;
+    /** Column header treatment for people: dot + name, or initials disc. */
+    operatorNameDisplay: OperatorNameDisplay;
+    /** Column header treatment for chairs: full name or the short code. */
+    chairNameDisplay: ChairNameDisplay;
+    /** Show the Google Maps link in the appointment details. */
+    mapsLink: boolean;
+}
+export declare const DEFAULT_DURATION_RANGE: {
+    readonly min: 5;
+    readonly max: 240;
+    readonly step: 5;
+};
+export declare const DEFAULT_WORKSPACE_DISPLAY: WorkspaceDisplaySettings;
+/** Remembered Increment 1 display settings, validated per field over the
+ *  Increment 1 defaults (a Final State shape keeps every knob it knows). */
+export declare function readWorkspaceDisplaySettings(raw: unknown): WorkspaceDisplaySettings | undefined;
+/** Earliest opening and latest closing across the practice's week —
+ *  the platform's `openingTime` / `closingTime` for the time axis. */
+export declare function practiceDayWindow(data: CalendarData): {
+    min: string;
+    max: string;
+};
+/** The axis for a cog window: `working` is the practice's own hours;
+ *  extended and full stay the Final State overrides. */
+export declare function workspaceDayWindow(window: DisplaySettings['window'], data: CalendarData): {
+    min: string;
+    max: string;
+};
+/** The ids a selection shows: the ticked ones, or all when none is. */
+export declare function effectiveIds(selected: readonly string[], all: readonly string[]): string[];
+/** Tick or untick `ids` in a selection (a row or a whole group). */
+export declare function toggleSelectedIds(prev: readonly string[], ids: readonly string[], checked: boolean | 'indeterminate'): string[];
+/** What the Reset chip counts: every ticked chair and operator. */
+export declare function activeFilterCount(selectedChairIds: readonly string[], selectedOperatorIds: readonly string[]): number;
+/**
+ * Disabled operators holding at least one appointment that STARTS inside
+ * the visible range — the platform's carve-out
+ * (`NewCalendar/Library.js`: `isActive(op) || hasAppointments(op)`).
+ * Their column stands whatever the "Show disabled operators" switch
+ * says, so hiding the operator can never hide an appointment.
+ */
+export declare function bookedDisabledOperatorIds(rows: readonly CalendarRow[], inactiveIds: readonly string[], range: {
+    start: number;
+    end: number;
+} | null): string[];
+/**
+ * The operators the grid may give a column to when NOTHING is ticked:
+ * every active one, the disabled ones while the switch reveals them, and
+ * any disabled operator the carve-out keeps. An explicit selection still
+ * wins over all three (platform: `kept.filter(selected)`).
+ */
+export declare function columnableOperatorIds(args: {
+    operators: readonly CalendarResource[];
+    inactiveIds: readonly string[];
+    showDisabled: boolean;
+    keepIds: readonly string[];
+}): string[];
+/** The operators the filter list offers — disabled ones only once the
+ *  session switch reveals them (the carve-out is a column, not a row). */
+export declare function listedOperators(operators: readonly CalendarResource[], inactiveIds: readonly string[], showDisabled: boolean): CalendarResource[];
+/** Chair column label per the cog: the full name, or the fixture's short
+ *  code (the platform's "first two letters" setting). */
+export declare function chairResourceTitle(chair: CalendarResource, mode: ChairNameDisplay): string;
+/** Operator column label: the plain name, or the name plus the muted
+ *  Disabled marker when the practice has disabled them. The kit Calendar
+ *  renders a resource header from its `title`, so the marker rides
+ *  there — and reaches the Avatar's accessible name under initials. */
+export declare function operatorResourceTitle(operator: CalendarResource, isDisabled: boolean, disabledLabel: string): string;
+/** Whole minutes between two instants — the resize toast's figure. */
+export declare function minutesBetween(start: Date | string, end: Date | string): number;
+/** Re-ends one appointment. The resize path writes through this twice —
+ *  once for the drag, once for the Undo that restores the old end — so
+ *  the two can never drift apart. */
+export declare function rowsWithEnd(rows: readonly CalendarRow[], eventId: string, end: Date): CalendarRow[];
+/** The platform's recurring-mode chooser (move, delete, save on edit). */
+export type RecurringScope = 'this' | 'following' | 'all';
+export declare const RECURRING_SCOPES: readonly RecurringScope[];
+/** Literal map (not a template) so key extractors see every key. */
+export declare const RECURRING_SCOPE_LABEL_KEY: Record<RecurringScope, string>;
+/** How the create form asks for the required documents' signature. */
+export type RequiredDocsSignMode = 'sms' | 'email' | 'none';
+/** What the editor reports beside the draft — the platform-only choices
+ *  the shared `EditorDraft` never needed. */
+export interface EditorDraftExtras {
+    recurringSaveMode?: RecurringScope;
+    requiredDocsSignMode?: RequiredDocsSignMode;
+    branchId?: string;
+}
+/** Delete confirmation choices — the recurring scope and, for a
+ *  price-list recurrence parent, the care-plan cleanup. */
+export interface DeleteOptions {
+    scope: RecurringScope;
+    removeFromCarePlan?: boolean;
+}
+/** The occurrences a scope names, in series order — the event itself
+ *  for `this`, it and its later occurrences for `following`, the whole
+ *  series for `all`. A row outside a series only ever names itself. */
+export declare function seriesScopeEventIds(rows: readonly CalendarRow[], eventId: string, scope: RecurringScope): string[];
+/** Every timed appointment overlapping `[start, end)` — cancelled and
+ *  absent ones, tasks, washes and the row itself never count (platform
+ *  busy check). */
+export declare function slotConflicts(rows: readonly CalendarRow[], slot: {
+    start: Date;
+    end: Date;
+    chairId?: string;
+    operatorId?: string;
+    excludeEventId?: string;
+}): {
+    chairBusy: boolean;
+    operatorBusy: boolean;
+};
+/** Devices the chosen cares need, deduplicated, in care order. */
+export declare function devicesForCares(cares: readonly {
+    careId?: string;
+}[] | undefined, devicesByCare: Readonly<Record<string, readonly string[]>>): string[];
+/** Which sign channels a patient can take a request on. */
+export declare function signChannelsFor(patient: CalendarPatient | undefined): {
+    sms: boolean;
+    email: boolean;
+};
+/** The platform's default: SMS when the patient can take one, else
+ *  email, else nothing. */
+export declare function defaultSignMode(patient: CalendarPatient | undefined): RequiredDocsSignMode;
+/** Google Maps search for the patient's address — the popover's map link. */
+export declare function patientMapsUrl(patient: CalendarPatient): string;
+/** A CREATE mode armed by a deep link (`createParameters`) or the
+ *  Backlog's Schedule: the next empty-slot click opens the editor with
+ *  this context already filled in (platform `_switchMode('create')`). */
+export interface CreateModeRequest {
+    tick: number;
+    prefill: EditorPrefill;
+    /** Named in the banner when the context carries a patient. */
+    patientName?: string;
+}
+/** Legible ink for a mode banner tinted with an appointment colour. The
+ *  Google palette ships no text colour, so the pair is settled by the
+ *  kit's own contrast maths rather than by eye. */
+export declare function bannerTextColor(backgroundHex?: string): string | undefined;
+/** A Move… or Copy… armed from the details dialog: the next empty-slot
+ *  click places the source appointment there. */
+export interface PlacementRequest {
+    kind: 'move' | 'copy';
+    eventId: string;
+    /** Copy only — carry the linked treatments along (platform's two copies). */
+    withTreatments?: boolean;
+    /** Armed from a waiting-list Reschedule — the entry leaves the queue
+     *  once the move lands (platform parity). */
+    waitingEntryId?: string;
+}
+/** The platform's "Copia & incolla": the same appointment on a new slot
+ *  with a fresh id — never a series member, treatments only on request.
+ *  An all-day source stays all-day on the target date. */
+export declare function copyRowAt(source: CalendarRow, target: {
+    start: Date;
+    resourceId?: string;
+    axisKind: DisplaySettings['resourceKind'];
+}, id: string, withTreatments: boolean): CalendarRow;
+/** Apply an edit saved with "this and following" / "all" to the other
+ *  occurrences: each keeps its own day shifted by the same delta as the
+ *  edited one, and takes the edited duration, allocation, colour, status,
+ *  type and description. */
+export declare function applySeriesEdit(rows: readonly CalendarRow[], primaryPrev: CalendarRow, draft: EditorDraft, siblingIds: readonly string[], data: CalendarData): CalendarRow[];
+/** What the post-save toast needs to decide whether the saved
+ *  appointment is on screen: its day and its allocation. */
+export interface SaveNotice {
+    tick: number;
+    date: Date;
+    chairId?: string;
+    operatorId?: string;
+}
+/** Why a saved appointment is not on the grid right now — empty when it
+ *  is visible. The "Go to" action undoes exactly these. */
+export declare function hiddenReasons(notice: Pick<SaveNotice, 'date' | 'chairId' | 'operatorId'>, view: {
+    visibleRange: {
+        start: number;
+        end: number;
+    } | null;
+    hiddenDays: readonly number[];
+    selectedChairIds: readonly string[];
+    selectedOperatorIds: readonly string[];
+}): Array<'range' | 'weekend' | 'chair' | 'operator'>;
+/**
+ * The platform DASHBOARD widget's window (`upcomingAppointmentsAction`):
+ * NOW → `forwardDays` later at 23:59:59.999, cancelled excluded, date
+ * ascending, no row limit. `backDays` is 0 at rest — the kit timeline's
+ * presets and its edge loaders widen the derived window in place of a
+ * fetch, so the panel can look further than the platform's seven days.
+ */
+export interface UpcomingWindow {
+    /** Days of history the panel has been widened to; 0 starts at NOW. */
+    backDays: number;
+    /** Days ahead — the platform's seven at rest. */
+    forwardDays: number;
+}
+/** Platform default: now to the end of the seventh day. */
+export declare const UPCOMING_FORWARD_DAYS = 7;
+/** How far one widening step reaches at either edge. */
+export declare const UPCOMING_STEP_DAYS = 7;
+/** Where the widening stops — the demo's own ceiling, not the platform's. */
+export declare const UPCOMING_MAX_DAYS = 180;
+export declare const DEFAULT_UPCOMING_WINDOW: UpcomingWindow;
+/** Epoch bounds of a window, inclusive of its closing second. */
+export declare function upcomingWindowBounds(nowIso: string, window: UpcomingWindow): {
+    startMs: number;
+    endMs: number;
+};
+/** One widening step at either edge, capped at the ceiling. */
+export declare function widenUpcomingWindow(window: UpcomingWindow, edge: 'earlier' | 'later'): UpcomingWindow;
+/** Widen just far enough to reach `targetIso` — the timeline's presets and
+ *  its jump-to-date land on days the default seven never covered. */
+export declare function upcomingWindowCovering(window: UpcomingWindow, nowIso: string, targetIso: string): UpcomingWindow;
+/**
+ * The rows the widget lists: appointments starting inside the window,
+ * cancelled excluded, date ascending. Background washes and the composing
+ * draft never qualify; tasks are already out of the Increment 1 feed.
+ */
+export declare function upcomingAppointmentRows(rows: CalendarRow[], bounds: {
+    startMs: number;
+    endMs: number;
+}): CalendarRow[];
+/** One agenda row as the kit timeline's item — identity, allocation and
+ *  care lines; the row id stays the event id so a click maps straight
+ *  back onto the grid. */
+export declare function upcomingAppointmentItem(row: CalendarRow, privacy: boolean, data: CalendarData): AppointmentItem;
+/** How far back the platform's booking query looks, on `createdAt`. */
+export declare const ONLINE_BOOKINGS_WINDOW_DAYS = 30;
+/**
+ * Bookings still to check: created online (or through the API) within
+ * the last 30 days, not cancelled, and still missing a patient OR an
+ * operator. Mirrors the repository query behind the platform's alert
+ * strip; Increment 1 renders the same count on a toolbar button.
+ */
+export declare function onlineBookingsToCheck(rows: readonly CalendarRow[], data: CalendarData): CalendarRow[];
+/**
+ * One row of the platform's "Prenotazioni online" page, which Increment 1
+ * hosts in the rail instead of sending the user to a separate page.
+ * Columns mirror it: when it was booked, what was asked for, whether it
+ * was paid online, and what is still missing before it is a real
+ * appointment.
+ */
+export interface BookingRowView {
+    row: CalendarRow;
+    eventId: string;
+    /** The appointment's own start. */
+    start: Date;
+    /** Platform `createdAt` — "del <date>" under the appointment date. */
+    bookedAt: Date | null;
+    /** The booking reason, or the platform's "Non specificato". */
+    reason: string | null;
+    chairTitle: string | null;
+    /** Stripe amount when the patient paid at booking. */
+    paidOnline: number | null;
+    needsPatient: boolean;
+    needsOperator: boolean;
+    /** Booked after the user last opened the page — the "(Nuovo)" marker. */
+    isNew: boolean;
+}
+/** Bookings made after this instant carry the platform's "(Nuovo)" tag. */
+export declare const DEFAULT_BOOKINGS_LAST_SEEN_ISO = "2026-06-23T00:00:00";
+export declare function bookingRowView(row: CalendarRow, data: CalendarData, lastSeenMs?: number): BookingRowView;
+/** The nine advanced inputs, all optional. Empty = the input is unset;
+ *  `operatorId` also accepts `NONE`, the platform's "no operator". */
+export interface WaitingListFilters {
+    patientId: string;
+    patientAssigned: '' | 'yes' | 'no';
+    operatorId: string;
+    appointmentScheduled: '' | 'yes' | 'no';
+    appointmentFrom?: Date;
+    appointmentTo?: Date;
+    waitingFrom?: Date;
+    waitingTo?: Date;
+    description: string;
+}
+export declare const EMPTY_WAITING_FILTERS: WaitingListFilters;
+/** How many of the nine inputs carry a value — the toggle's badge. */
+export declare function waitingFiltersActiveCount(filters: WaitingListFilters): number;
+/**
+ * One waiting row resolved the way the platform's serializer resolves
+ * it: the entry's OWN patient, the linked appointment with its patient,
+ * care line and colour, and the operator default. `noConnection` is the
+ * platform's "Nessun collegamento" test — none of the four is present.
+ */
+export interface WaitingListRowView {
+    entry: CalendarWaitingEntry;
+    /** Platform `patientId` / `patientName` / `patientPhoneNumber`. */
+    patient?: CalendarPatient;
+    /** The linked appointment, live from the grid's rows. */
+    appointment?: CalendarRow;
+    /** Platform `appointmentPatientId` — the linked appointment's patient. */
+    appointmentPatient?: CalendarPatient;
+    /** Platform `operatorName`. */
+    operatorTitle?: string;
+    /** Platform `appointmentName` — the linked appointment's care line. */
+    appointmentName?: string;
+    noConnection: boolean;
+}
+export declare function waitingListRowView(entry: CalendarWaitingEntry, rows: readonly CalendarRow[], data: CalendarData): WaitingListRowView;
+/**
+ * The platform's advanced predicates, in its own order. A patient
+ * matches the entry's OWN patient or the linked appointment's; the
+ * operator and the description only ever read the ENTRY's own fields.
+ */
+export declare function waitingEntryMatchesFilters(view: WaitingListRowView, filters: WaitingListFilters, data: CalendarData): boolean;
+/** The quick view first, then the advanced predicates — the platform's
+ *  own order (`_filterForAdvancedSearch` re-runs the view). */
+export declare function filterWaitingEntries(entries: readonly CalendarWaitingEntry[], rows: readonly CalendarRow[], quickView: WaitingQuickView, filters: WaitingListFilters, data: CalendarData): WaitingListRowView[];
+//# sourceMappingURL=calendar-workspace.model.d.ts.map

package/dist/patterns/calendar/calendar-workspace.model.d.ts.map

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

package/dist/patterns/calendar/calendar.data.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Calendar pattern — the READ MODEL the host supplies, stable for a page
+ * load: the practice's resources, catalogue, agenda extras and lookups.
+ * It mirrors what the demo once read straight from its fixture module —
+ * one property per constant, one method per fixture-backed helper — so
+ * the demos hand in their fixtures and the platform island hands in what
+ * `/internalApi/...` returned, and the model, panels and surface compute
+ * from either without knowing which.
+ *
+ * Provided once with `<CalendarDataProvider value={data}>`; components
+ * read it with `useCalendarData()`, pure model functions take it as an
+ * explicit `data` parameter — never a module-level global.
+ *
+ * Every REQUIRED member is one the shipped runtime actually reads. The
+ * handful marked optional are read only by the story-only Final State
+ * demo (`src/patterns/demos/calendar/`), which keeps supplying them; a
+ * platform host mounting `CalendarWorkspace` can leave them out.
+ */
+import { type ReactNode } from 'react';
+import type { CalendarResource } from '../../components/calendar';
+import type { AppointmentItem } from '../../components/appointment-card';
+import type { NotesPanelNote } from '../../components/notes-panel';
+import type { TasksPanelItem } from '../../components/tasks-panel';
+import type { CalendarAppointmentMeta, CalendarBaseEvent, CalendarBookingContact, CalendarBranch, CalendarBusinessHours, CalendarCare, CalendarCareEntry, CalendarCareLink, CalendarCarePlan, CalendarClosure, CalendarHistoryEntry, CalendarHoliday, CalendarOperatorGroup, CalendarPatient, CalendarPracticeFeatures, CalendarPriceList, CalendarTaskDetail, CalendarWaitingEntry } from './calendar.types';
+export interface CalendarData {
+    chairs: readonly CalendarResource[];
+    operators: readonly CalendarResource[];
+    /** Operator groups (platform `OperatorGroup`) for the grouped filter. */
+    operatorGroups: readonly CalendarOperatorGroup[];
+    /** Operators the practice has disabled (platform `isActive === false`). */
+    inactiveOperatorIds: readonly string[];
+    /** Operator id → local ISO dates the operator is away. */
+    operatorAbsences: Record<string, readonly string[]>;
+    /** Operator id → absence display title (a sibling map, optional per operator). */
+    operatorAbsenceTitles: Record<string, string>;
+    holidays: readonly CalendarHoliday[];
+    /** Practice-closed local ISO dates. */
+    closedDates: readonly string[];
+    /** JS `getDay()` numbers the practice does not work. Optional: the
+     *  shipped workspace derives its hidden days from `businessHours` and
+     *  the weekend toggle; only the Final State demo reads this. */
+    nonWorkingDays?: readonly number[];
+    businessHours: CalendarBusinessHours;
+    /** The clock every relative label and ledger stamp is pinned to. */
+    nowIso: string;
+    /** The date the calendar opens on. */
+    initialDateIso: string;
+    cares: readonly CalendarCare[];
+    priceLists: readonly CalendarPriceList[];
+    /** Optional: no shipped code reads the flat list — the panels go
+     *  through `carePlanById` / `openCarePlansForPatient`. */
+    carePlans?: readonly CalendarCarePlan[];
+    patients: readonly CalendarPatient[];
+    /** The appointments and tasks as the host loaded them, no resource axis. */
+    baseEvents: readonly CalendarBaseEvent[];
+    /** Event id → appointment extras (patient, operator, chair, care, billing). */
+    metaById: Record<string, CalendarAppointmentMeta>;
+    /** Event id → the note the patient left on the online booking form. */
+    bookingNotes: Record<string, string>;
+    /** Event id → what the person typed on the booking website. */
+    bookingContacts: Record<string, CalendarBookingContact>;
+    /** Task-event id → its chair / operator axis (tasks carry no meta).
+     *  Optional: the shipped workspace drops tasks at the feed boundary;
+     *  only the Final State demo, which shows them, reads this. */
+    taskAxis?: Record<string, {
+        chairId: string;
+        operatorId: string;
+    }>;
+    /** Event id → platform-shaped task detail. */
+    taskDetails: Record<string, CalendarTaskDetail>;
+    /** The waiting list as loaded — the journey seeds its state from it. */
+    waitingList: readonly CalendarWaitingEntry[];
+    /** Event id → the modification ledger as loaded. Optional: the
+     *  workspace reads the ledger off `CalendarJourney.history`, which the
+     *  host seeds however it likes. */
+    appointmentHistory?: Record<string, CalendarHistoryEntry[]>;
+    practiceFeatures: CalendarPracticeFeatures;
+    branches: readonly CalendarBranch[];
+    /** Care id → the medical devices it needs. */
+    careDevices: Readonly<Record<string, readonly string[]>>;
+    /** Patient id → required documents still unsigned. */
+    unsignedRequiredDocs: Readonly<Record<string, number>>;
+    /** Patients with an advanced e-signature (AES) setup. */
+    patientsWithAes: ReadonlySet<string>;
+    /** Appointment id → the deposit paid online when booking. */
+    paidOnline: Readonly<Record<string, number>>;
+    /** Appointment id → the phone typed on the booking site. */
+    bookingPhones: Readonly<Record<string, string>>;
+    patientById(id: string): CalendarPatient | undefined;
+    patientNotes(patientId: string): NotesPanelNote[];
+    patientAppointments(patientId: string): AppointmentItem[];
+    patientTasks(patientId: string): TasksPanelItem[];
+    careById(id: string): CalendarCare | undefined;
+    carePlanById(id: string): CalendarCarePlan | undefined;
+    /** Optional: no shipped code calls it — the editor links through
+     *  `openCarePlansForPatient`, the details panel through
+     *  `carePlanById`. */
+    carePlansForPatient?(patientId: string): CalendarCarePlan[];
+    /** Plans the editor may link to: not discarded or closed, with undone lines. */
+    openCarePlansForPatient(patientId: string): CalendarCarePlan[];
+    /** The care entries a link resolves to — plan lines in plan order, or
+     *  the price-list picks. Unknown ids are dropped. */
+    careEntriesFromLink(link: CalendarCareLink): CalendarCareEntry[];
+    /** Closed dates plus holidays, unless the practice stays open on them. */
+    practiceClosedOn(dateIso: string): boolean;
+    /** Why a date (or, given an operator, that column) cannot take a
+     *  booking — closed > holiday > absence; null when it can. */
+    closureOn(dateIso: string, operatorId?: string): CalendarClosure | null;
+    /** Local dates in [from, to] with practice hours that are neither
+     *  closed nor a holiday. */
+    openDatesBetween(from: Date, to: Date): string[];
+    /** Waiting-since instant for an entry (platform `createdAt`). */
+    waitingSinceIso(entry: CalendarWaitingEntry): string;
+}
+/** Wrap whatever renders the calendar's panels and surface — one provider
+ *  per subtree is fine (a rail renders its panels outside the page tree). */
+export declare function CalendarDataProvider({ value, children, }: {
+    value: CalendarData;
+    children?: ReactNode;
+}): import("react").FunctionComponentElement<import("react").ProviderProps<CalendarData | null>>;
+export declare function useCalendarData(): CalendarData;
+//# sourceMappingURL=calendar.data.d.ts.map

package/dist/patterns/calendar/calendar.data.d.ts.map

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

package/dist/patterns/calendar/calendar.host.d.ts

@@ -0,0 +1,10 @@
+export type SheetId = 'appointment-editor' | 'appointment-details' | 'find-slots' | 'backlog' | 'patient-care-plan';
+export interface SheetHostContext {
+    open(id: SheetId): void;
+    close(): void;
+}
+/** Wrap whatever renders the panels and the surface — one provider per
+ *  subtree is fine (a rail renders its panels outside the page tree). */
+export declare const SheetHostProvider: import("react").Provider<SheetHostContext | null>;
+export declare function useSheetHost(): SheetHostContext;
+//# sourceMappingURL=calendar.host.d.ts.map

package/dist/patterns/calendar/calendar.host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"calendar.host.d.ts","sourceRoot":"","sources":["../../../src/patterns/calendar/calendar.host.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,OAAO,GACf,oBAAoB,GACpB,qBAAqB,GACrB,YAAY,GACZ,SAAS,GACT,mBAAmB,CAAC;AAExB,MAAM,WAAW,gBAAgB;IAC/B,IAAI,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,CAAC;IACxB,KAAK,IAAI,IAAI,CAAC;CACf;AAID;yEACyE;AACzE,eAAO,MAAM,iBAAiB,mDAAiC,CAAC;AAEhE,wBAAgB,YAAY,IAAI,gBAAgB,CAM/C"}