@nxgt/material 3.91.0 → 3.93.0

package/dist/lib/components/ui/layout/record-page/record-details.d.ts

@@ -1,4 +1,4 @@
-import { ReactNode } from 'react';
+import { ComponentProps, ReactNode } from 'react';
 import { CardTitleElement } from '../../primitives/card/card.js';
 /** One « label date » segment of the meta line. */
 export type RecordDetailsStamp = {
@@ -7,8 +7,8 @@ export type RecordDetailsStamp = {
     /** The instant: a `Date`, an ISO string or a timestamp. */
     at: Date | string | number;
 };
-export type RecordDetailsProps = {
-    /** The card's heading. */
+export type RecordDetailsProps = Omit<ComponentProps<'div'>, 'title'> & {
+    /** The card's heading, set in `title-md` emphasized like a section title, whatever its level. */
     title?: ReactNode;
     /** The heading level of `title`, `'h2'` by default (under the page's `h1`). */
     titleAs?: CardTitleElement;
@@ -28,13 +28,13 @@ export type RecordDetailsProps = {
     maxColumns?: number;
     /** The `Description`s. */
     children?: ReactNode;
-    className?: string;
 };
 /**
  * RecordDetails - the record's facts as one card: a title and a status, the
  * `Description`s in a `DescriptionList` (one column in a side panel, up to
  * `maxColumns` once the panel is stacked and wide) and a muted
  * « Added on … · Updated on … » line under them, the dates written without
- * seconds in `timeZone`. Made for `RecordPage`'s `details`.
+ * seconds in `timeZone`. Made for `RecordPage`'s `details`. Any other `div`
+ * prop (`data-*`, `id`, `aria-*`, `className`) goes to the root.
  */
-export declare function RecordDetails({ title, titleAs, status, created, updated, timeZone, maxColumns, children, className, }: RecordDetailsProps): import("react").JSX.Element;
+export declare function RecordDetails({ title, titleAs, status, created, updated, timeZone, maxColumns, children, className, ...props }: RecordDetailsProps): import("react").JSX.Element;

package/dist/lib/components/ui/media/file-list/file-list-describe.d.ts

@@ -0,0 +1,8 @@
+import { NetworkUploadDisplayItem } from '../upload/network-upload-field/network-upload-item.js';
+import { FileDescription } from './types.js';
+/**
+ * The committed rows, named, sized and typed by `describe`; uploads are left
+ * alone. A described `href` that is not safe to link (`javascript:` …) is
+ * `null`, and the row then has no Download link.
+ */
+export declare function describeItems(items: NetworkUploadDisplayItem[], describe?: (value: string) => FileDescription | null | undefined): NetworkUploadDisplayItem[];

package/dist/lib/components/ui/media/file-list/file-list-field-row.d.ts

@@ -1,4 +1,5 @@
 import { NetworkUploadDisplayItem } from '../upload/network-upload-field/network-upload-item.js';
+import { FileListReorder } from './use-file-list-move.js';
 export type FileListFieldRowProps = {
     item: NetworkUploadDisplayItem;
     accept?: string;
@@ -6,5 +7,7 @@ export type FileListFieldRowProps = {
     onReplace: (item: NetworkUploadDisplayItem, file: File) => void;
     onRetry: (item: NetworkUploadDisplayItem) => void;
     onRemove: (item: NetworkUploadDisplayItem) => void;
+    /** Present when the field is reorderable. */
+    reorder?: FileListReorder;
 };
-export declare function FileListFieldRow({ item, accept, disabled, onReplace, onRetry, onRemove, }: FileListFieldRowProps): import("react").JSX.Element;
+export declare function FileListFieldRow({ item, accept, disabled, onReplace, onRetry, onRemove, reorder, }: FileListFieldRowProps): import("react").JSX.Element;

package/dist/lib/components/ui/media/file-list/file-list-field.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { NetworkUploadFieldProps } from '../upload/network-upload-field/network-upload-field.js';
+import { FileDescription } from './types.js';
 type MultipleUploadProps = Extract<NetworkUploadFieldProps, {
     mode: 'multiple';
 }>;
@@ -7,6 +8,18 @@ export type FileListFieldProps = Omit<MultipleUploadProps, 'mode' | 'value'> & {
     value?: string[];
     required?: boolean;
     empty?: ReactNode;
+    /**
+     * Describes a kept value (an id, a key) so its row shows a name, a size
+     * and a type instead of the value: `describe={(id) => files[id]}`. Return
+     * `undefined` for a value you know nothing about. Called on every render,
+     * so keep it pure and cheap.
+     */
+    describe?: (value: string) => FileDescription | null | undefined;
+    /**
+     * Lets the user reorder the kept files with move up / move down buttons
+     * (reachable by keyboard); `onValueChange` receives the new order.
+     */
+    reorderable?: boolean;
 };
 export declare function FileListField(props: FileListFieldProps): import("react").JSX.Element;
 export {};

package/dist/lib/components/ui/media/file-list/index.d.ts

@@ -7,4 +7,4 @@ export * from './file-list-form-field.js';
 export type { FileListS3FieldProps } from './file-list-s3-field.js';
 export { FileListS3Field } from './file-list-s3-field.js';
 export * from './file-list-s3-form-field.js';
-export type { FileListItem } from './types.js';
+export type { FileDescription, FileListItem } from './types.js';

package/dist/lib/components/ui/media/file-list/partials/file-list-items.d.ts

@@ -1,14 +1,18 @@
 import { ReactNode } from 'react';
 import { NetworkUploadDisplayItem } from '../../upload/network-upload-field/network-upload-item.js';
+import { FileListReorder } from '../use-file-list-move.js';
 type Props = {
     items: NetworkUploadDisplayItem[];
     accept?: string;
     disabled?: boolean;
     empty?: ReactNode;
+    reorder?: FileListReorder;
+    /** Receives the list, so the focus can be put back after a move. */
+    listRef?: (node: HTMLUListElement | null) => void;
     onReplace: (item: NetworkUploadDisplayItem, file: File) => void;
     onRetry: (item: NetworkUploadDisplayItem) => void;
     onRemove: (item: NetworkUploadDisplayItem) => void;
 };
 /** The field's rows, or its empty message. */
-export declare function FileListItems({ items, empty, ...row }: Props): import("react").JSX.Element;
+export declare function FileListItems({ items, empty, reorder, listRef, ...row }: Props): import("react").JSX.Element;
 export {};

package/dist/lib/components/ui/media/file-list/partials/file-list-move-buttons.d.ts

@@ -0,0 +1,9 @@
+import { NetworkUploadDisplayItem } from '../../upload/network-upload-field/network-upload-item.js';
+import { FileListReorder } from '../use-file-list-move.js';
+type Props = {
+    item: NetworkUploadDisplayItem;
+    reorder: FileListReorder;
+};
+/** A kept row's move up / move down buttons, disabled where it cannot move. */
+export declare function FileListMoveButtons({ item, reorder }: Props): import("react").JSX.Element;
+export {};

package/dist/lib/components/ui/media/file-list/partials/file-list-row-actions.d.ts

@@ -1,4 +1,5 @@
 import { NetworkUploadDisplayItem } from '../../upload/network-upload-field/network-upload-item.js';
+import { FileListReorder } from '../use-file-list-move.js';
 type Props = {
     item: NetworkUploadDisplayItem;
     accept?: string;
@@ -6,7 +7,8 @@ type Props = {
     onReplace: (item: NetworkUploadDisplayItem, file: File) => void;
     onRetry: (item: NetworkUploadDisplayItem) => void;
     onRemove: (item: NetworkUploadDisplayItem) => void;
+    reorder?: FileListReorder;
 };
 /** A row's trailing buttons: retry, download, replace (with its hidden input) and remove. */
-export declare function FileListRowActions({ item, accept, disabled, onReplace, onRetry, onRemove, }: Props): import("react").JSX.Element;
+export declare function FileListRowActions({ item, accept, disabled, onReplace, onRetry, onRemove, reorder, }: Props): import("react").JSX.Element;
 export {};

package/dist/lib/components/ui/media/file-list/types.d.ts

@@ -15,3 +15,12 @@ export type FileListProps = {
     className?: string;
     'aria-label'?: string;
 };
+/** What a file list field can show of a value it holds: only the value is stored. */
+export type FileDescription = {
+    name?: string;
+    size?: number;
+    /** MIME type; an `image/*` type gets an image icon. */
+    type?: string;
+    /** Download link, when the value is not itself a URL. */
+    href?: string;
+};

package/dist/lib/components/ui/media/file-list/use-file-list-field.d.ts

@@ -1,6 +1,6 @@
 import { FileListFieldProps } from './file-list-field.js';
 /** The ids, the accessible group and the upload state behind a file list field. */
-export declare function useFileListField({ required, value, className: _className, empty: _empty, ...props }: FileListFieldProps): {
+export declare function useFileListField({ required, value, className: _className, empty: _empty, describe, reorderable, ...props }: FileListFieldProps): {
     inputId: string;
     inputRef: import('react').RefObject<HTMLInputElement | null>;
     helperId: string;
@@ -30,4 +30,10 @@ export declare function useFileListField({ required, value, className: _classNam
         handleItemRetry: (item: import('../upload/network-upload-field/network-upload-item.js').NetworkUploadDisplayItem) => void;
         handleItemRemove: (item: import('../upload/network-upload-field/network-upload-item.js').NetworkUploadDisplayItem) => void;
     };
+    displayItems: import('../upload/network-upload-field/network-upload-item.js').NetworkUploadDisplayItem[];
+    move: {
+        setRoot: (node: Element | null) => void;
+        message: string;
+        reorder: import('./use-file-list-move.js').FileListReorder | undefined;
+    };
 };

package/dist/lib/components/ui/media/file-list/use-file-list-move.d.ts

@@ -0,0 +1,24 @@
+import { RowMoveDirection } from '@nxgt/material-core/repeatable-group';
+import { NetworkUploadDisplayItem } from '../upload/network-upload-field/network-upload-item.js';
+export type FileListReorder = {
+    disabled: boolean;
+    canMove: (item: NetworkUploadDisplayItem, direction: RowMoveDirection) => boolean;
+    onMove: (item: NetworkUploadDisplayItem, direction: RowMoveDirection) => void;
+};
+type Options = {
+    reorderable?: boolean;
+    disabled?: boolean;
+    kept: readonly string[] | undefined;
+    onValueChange?: (value: string[]) => void;
+};
+/**
+ * Reordering the kept files: which row can move where (the rules are
+ * `@nxgt/material-core`'s, shared with RepeatableGroup), the focus once the
+ * value changed, and what the polite live region says.
+ */
+export declare function useFileListMove({ reorderable, disabled, kept, onValueChange, }: Options): {
+    setRoot: (node: Element | null) => void;
+    message: string;
+    reorder: FileListReorder | undefined;
+};
+export {};

package/dist/lib/components/ui/media/upload/network-upload-field/network-upload-item.d.ts

@@ -4,6 +4,13 @@ export type NetworkUploadDisplayItem = {
     id: string;
     name: string;
     size?: number;
+    /** MIME type of a committed value, when the host described it. */
+    type?: string;
+    /**
+     * Download link of a committed value: the value itself when `undefined`,
+     * none when `null` (described with a link that is not safe).
+     */
+    href?: string | null;
     status: NetworkUploadItemStatus;
     progress?: number;
     file?: File;

package/dist/lib/components/ui/widgets/editor/extensions/marks/compact-mark-buttons.d.ts

@@ -1,5 +1,9 @@
 import { Editor } from '@tiptap/react';
-/** Bold, italic and strikethrough: the marks of a comment or a chat message. */
+/**
+ * Bold, italic and strikethrough: the marks of a comment or a chat message.
+ * The strikethrough button is left out when the schema has no `strike` mark
+ * (`marks({ strike: false })`, or a starter kit configured with `strike: false`).
+ */
 export declare function CompactMarkButtons({ editor }: {
     editor: Editor;
 }): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/editor/kit/editor-features.d.ts

@@ -74,8 +74,9 @@ export declare const editorFeatures: {
     readonly markdownPaste: () => import('./types.js').EditorFeature & {
         key: string;
     };
-    readonly marks: ({ compact }?: {
+    readonly marks: ({ compact, strike, }?: {
         compact?: boolean;
+        strike?: boolean;
     }) => import('./types.js').EditorFeature & {
         key: string;
     };

package/dist/lib/components/ui/widgets/editor/kit/features/marks.d.ts

@@ -1,9 +1,14 @@
 /**
  * `compact` keeps the content's marks but shows only bold, italic and
  * strikethrough in the toolbar and bubble menu (comments, chat).
+ * `strike` (default `true`, compact and full editors alike) set to `false`
+ * leaves strikethrough out: no mark, no button, and no `~~` written to
+ * Markdown. Pasted or loaded Markdown with `~~x~~` does not throw: it reads as
+ * the plain text `x`, the markers dropped.
  */
-export declare const marks: ({ compact }?: {
+export declare const marks: ({ compact, strike, }?: {
     compact?: boolean;
+    strike?: boolean;
 }) => import('../types.js').EditorFeature & {
     key: string;
 };

package/dist/lib/components/ui/widgets/event-calendar/backdrop.types.d.ts

@@ -0,0 +1,75 @@
+import { Tone } from '../../tones.js';
+import { CalendarEventBadge } from './types.js';
+/**
+ * A stretch of time the calendar shades behind its events, such as a holiday,
+ * a term, a closure or a half day off. It never blocks a slot: events can be
+ * made and dropped over it.
+ *
+ * `start` and `end` are ISO strings. A date-only value (`2026-12-25`) means
+ * whole days, read in the calendar's `timeZone`; `end` is always exclusive, so
+ * `2026-12-25` to `2026-12-26` is the single day of 25 December. A value with
+ * a time is an instant, which gives a half day (`2026-12-24T12:00:00` to
+ * `2026-12-25`).
+ */
+export type EventCalendarSpan = {
+    id: string;
+    start: string;
+    end: string;
+    label: string;
+    /** Default `'neutral'`. */
+    tone?: Tone;
+    /**
+     * The resource column the span belongs to. One with none shades every
+     * column; one with an unknown id shades none.
+     */
+    resourceId?: string;
+};
+/** The part of a span that falls on one day of the zone's calendar. */
+export type BackdropSegment = {
+    span: EventCalendarSpan;
+    /** The `YYYY-MM-DD` day. */
+    day: string;
+    /** Wall-clock minutes from midnight where the span starts on this day (0 for a whole day). */
+    fromMin: number;
+    /** Wall-clock minutes where it ends (1440 for a whole day or one running on). */
+    toMin: number;
+    /** The span covers the whole day, whatever its length (23 or 25 hours on a clock change). */
+    whole: boolean;
+};
+/** A span laid out as a bar over the day columns of the all-day strip. */
+export type BackdropLane = {
+    span: EventCalendarSpan;
+    /** The first column (day) of the bar. */
+    startCol: number;
+    /** The number of columns it covers. */
+    cols: number;
+    /** The lane (row) of the strip. */
+    row: number;
+    continuesBefore: boolean;
+    continuesAfter: boolean;
+};
+/** A label with a tone that marks a day or a week, keyed by date (`2026-12-24`). */
+export type EventCalendarBadges = Record<string, CalendarEventBadge>;
+/** The props that decorate the days: shaded spans and badges. */
+export type EventCalendarDayMarksProps = {
+    /**
+     * Stretches of time shaded behind the events (a holiday, a term, a half day
+     * off). They never block a slot, take no pointer event, and are read in the
+     * name of the day or column they fall on. Not a prop of `mode="template"`.
+     */
+    spans?: EventCalendarSpan[];
+    /**
+     * A badge on a day, keyed by its `YYYY-MM-DD` date (`{ '2026-12-24': { label:
+     * 'Eve', tone: 'info' } }`): in the day's header (week and day views) and
+     * next to its number (month). It is read in the name of the day. Not a prop of `mode="template"`, which has no dates. Where the
+     * room is short (a phone's week column or month cell) it becomes a short tone bar.
+     */
+    dayBadges?: EventCalendarBadges;
+    /**
+     * A badge on a week, keyed by the `YYYY-MM-DD` date of its first day, which
+     * follows `weekStartsOn` (Monday `2026-12-21` when weeks start on Monday). It
+     * is drawn in the time views' gutter corner and on the first cell of the
+     * month's row, and is read in that cell's name. Not a prop of `mode="template"`.
+     */
+    weekBadges?: EventCalendarBadges;
+};

package/dist/lib/components/ui/widgets/event-calendar/chrome.types.d.ts

@@ -0,0 +1,12 @@
+export type EventCalendarChromeState = {
+    focusedEventId: string | null;
+    query: string;
+    /** The way the last move went (-1 back, 1 forward): the view slides from it. */
+    direction: -1 | 0 | 1;
+    /** A view was picked in the switcher: `phoneView` no longer applies. */
+    viewPicked: boolean;
+    /** The keyboard moved the cursor: its day takes the focus once rendered. */
+    dayFocus: boolean;
+    /** The resource the phone's switcher shows; `null` is the first. */
+    resourceId: string | null;
+};

package/dist/lib/components/ui/widgets/event-calendar/event-calendar-context.d.ts

@@ -1,5 +1,6 @@
 import { ReactNode } from 'react';
 import { EventChipVariant } from '../../display/event-chip/event-chip.classes.js';
+import { EventCalendarBadges, EventCalendarSpan } from './backdrop.types.js';
 import { TemplateContext } from './template.types.js';
 import { CalendarEvent, EventCalendarPreviewField, EventCalendarRenderEvent, EventCalendarSlot, EventCalendarView } from './types.js';
 import { EventCalendarModel } from './use-event-calendar.js';
@@ -8,7 +9,13 @@ export type EventCalendarContextValue = EventCalendarModel & {
     sourceEvents?: CalendarEvent[];
     /** Set in `mode="template"`: the lanes, and the lane of each event. */
     template?: TemplateContext;
-    dragLabel: string;
+    /** The spans to shade behind the events (see `EventCalendarProps.spans`). */
+    spans?: EventCalendarSpan[];
+    /** Badges on days and on weeks (see `EventCalendarProps.dayBadges`). */
+    dayBadges?: EventCalendarBadges;
+    weekBadges?: EventCalendarBadges;
+    /** The hint that events can be dragged, read as the board's description; unset when they cannot (`readOnlyEvents`). */
+    dragHint?: string;
     searchable: boolean;
     /** The views the switcher offers. */
     views?: EventCalendarView[];

package/dist/lib/components/ui/widgets/event-calendar/event-calendar-events.utils.d.ts

@@ -1,5 +1,5 @@
 import { closestCenter } from '@dnd-kit/core';
-import { CalendarEvent } from './types.js';
+import { CalendarEvent, CalendarEventBadge } from './types.js';
 export declare const calendarCollisionDetection: typeof closestCenter;
 export declare function snapToStep(date: Date, stepMinutes?: number): Date;
 /** `date` rounded to the nearest `stepMinutes` of the clock's epoch: right in a zone whose offset is a multiple of the step. */
@@ -15,3 +15,5 @@ export declare function moveEventToDay(event: CalendarEvent, day: Date): Calenda
 export declare function moveEventToDateTime(event: CalendarEvent, dateTime: Date, snap?: (date: Date) => Date): CalendarEvent;
 export declare function resizeEventEnd(event: CalendarEvent, end: Date, snap?: (date: Date) => Date): CalendarEvent;
 export declare function isToday(day: Date, now?: Date): boolean;
+/** Every badge of an event, `badge` first. */
+export declare function eventBadges(event: CalendarEvent): CalendarEventBadge[];

package/dist/lib/components/ui/widgets/event-calendar/event-calendar-shell.d.ts

@@ -12,4 +12,4 @@ export type EventCalendarShellProps = EventCalendarProps & {
  * mini-month side panel and a phone layout of its own. Events are props; the
  * chrome (search, focus, the last move's direction) lives in a slice.
  */
-export declare function EventCalendarShell({ template, visible, onEventClick, onSlotClick, eventPreview, previewFields, onEventEdit, onEventDelete, className, renderEvent, toolbar, searchable, views, phoneView, sidebar, eventVariant, scrollToHour, ...options }: EventCalendarShellProps): import("react").JSX.Element;
+export declare function EventCalendarShell({ template, visible, onEventClick, onSlotClick, eventPreview, previewFields, onEventEdit, onEventDelete, className, renderEvent, toolbar, searchable, views, phoneView, sidebar, eventVariant, scrollToHour, spans, dayBadges, weekBadges, ...options }: EventCalendarShellProps): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/event-calendar/event-calendar.backdrop.d.ts

@@ -0,0 +1,38 @@
+import { BackdropLane, BackdropSegment, EventCalendarSpan } from './backdrop.types.js';
+/** Whether a span value is a date (`2026-12-25`): whole days, not an instant. */
+export declare function isDateOnly(value: string): boolean;
+/**
+ * The instants a span covers, `end` exclusive. A date-only value is the first
+ * instant of that day in the zone; a time with no offset (`2026-12-24T12:00`)
+ * is that wall-clock time in the zone; one with an offset or `Z` is the
+ * instant it names. A span
+ * with an invalid value, or that ends at or before its start, gives `null`.
+ */
+export declare function spanRange(span: EventCalendarSpan, timeZone?: string): {
+    start: Date;
+    end: Date;
+} | null;
+/**
+ * Whether a span shades a resource column. Without `resourceId` (no
+ * resources) every span counts; `null` is the unassigned column, which only
+ * the spans with no `resourceId` shade.
+ */
+export declare function spanMatchesResource(span: EventCalendarSpan, resourceId?: string | null): boolean;
+/**
+ * The part of a span on the zone's day `day`, or `null` when it does not touch
+ * it. The day runs from its first instant to the next day's, so on a clock
+ * change it is 23 or 25 hours long and a span over all of it is `whole`.
+ */
+export declare function spanOnDay(span: EventCalendarSpan, day: string, timeZone?: string): BackdropSegment | null;
+/**
+ * The spans on one day, for one resource column when given, in the order of
+ * `spans`. Spans never block anything: this only says what to draw.
+ */
+export declare function spansForDay(spans: EventCalendarSpan[] | undefined, day: string, timeZone?: string, resourceId?: string | null): BackdropSegment[];
+/**
+ * The all-day strip: each span as a bar over the consecutive `days` it covers
+ * wholly, put in the first lane with room (longest and earliest first). A
+ * span that only covers part of a day (a half day) has no bar: it is drawn as
+ * a band in the time grid, and by `spansForDay` in the month.
+ */
+export declare function layoutBackdropLanes(spans: EventCalendarSpan[] | undefined, days: string[], timeZone?: string, resourceId?: string | null): BackdropLane[];

package/dist/lib/components/ui/widgets/event-calendar/event-calendar.badges.d.ts

@@ -0,0 +1,14 @@
+import { Locale } from 'date-fns';
+import { EventCalendarBadges } from './backdrop.types.js';
+import { CalendarEventBadge } from './types.js';
+type WeekStart = 0 | 1 | 2 | 3 | 4 | 5 | 6;
+/** The badge set on a day, keyed by its `YYYY-MM-DD` date. */
+export declare function dayBadgeOf(dayBadges: EventCalendarBadges | undefined, day: Date): CalendarEventBadge | undefined;
+/**
+ * The key of the week a day falls in: the date of its first day, which follows
+ * `weekStartsOn` (the locale's when unset), whatever the view draws of it.
+ */
+export declare function weekBadgeKey(day: Date, locale?: Locale, weekStartsOn?: WeekStart): string;
+/** The badge set on the week a day falls in. */
+export declare function weekBadgeOf(weekBadges: EventCalendarBadges | undefined, day: Date, locale?: Locale, weekStartsOn?: WeekStart): CalendarEventBadge | undefined;
+export {};

package/dist/lib/components/ui/widgets/event-calendar/event-calendar.labels.d.ts

@@ -1,5 +1,6 @@
 import { Locale } from 'date-fns';
-import { CalendarEvent } from './types.js';
+import { BackdropSegment } from './backdrop.types.js';
+import { CalendarEvent, CalendarEventBadge } from './types.js';
 /**
  * The times a chip or an agenda row shows. In a zone they are read from the
  * true instants with the zone's own clock (`wallOf`), never through the
@@ -10,9 +11,21 @@ export declare function eventTimes(drawn: CalendarEvent, source: CalendarEvent,
     time?: string;
     endTime?: string;
 };
+/**
+ * The accessible name of an event's group: its title, then its badge, then
+ * `cancelled` (the translated word) when its status says so.
+ */
+export declare function eventName(event: CalendarEvent, title: string, cancelled: string): string;
 /**
  * The range label of the popover, in the zone: the day is read at noon and
  * the time on a fixed day, so a wall time the browser's own clock skips never
  * shifts what is said.
  */
 export declare function zonedRangeLabel(event: CalendarEvent, locale: Locale, zone: string): string;
+/** A day's name with its spans' labels after it: the cell or the column reads them out, the shading is decoration. */
+export declare function nameWithSpans(date: string, segments: BackdropSegment[]): string;
+/** A day's name with its badges after it, for the cell or column that reads them out. */
+export declare function nameWithBadges(name: string, day: CalendarEventBadge | undefined, week: {
+    badge: CalendarEventBadge | undefined;
+    text: (label: string) => string;
+}): string;

package/dist/lib/components/ui/widgets/event-calendar/event-calendar.lanes.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The lane (row) of each item, already in the order they should win a lane:
+ * the first lane with room over its columns, a new one when none has. An item
+ * covers `cols` columns from `startCol`; `columns` is the width of a lane.
+ */
+export declare function packLanes(items: {
+    startCol: number;
+    cols: number;
+}[], columns: number): number[];

package/dist/lib/components/ui/widgets/event-calendar/event-calendar.read-only.d.ts

@@ -0,0 +1,57 @@
+import { CalendarEvent } from './types.js';
+/**
+ * What a read-only event's draggable wrapper must not say: dnd-kit marks it
+ * "draggable", points to its pick-up instructions and gives it a tab stop of
+ * its own. The chip's own button stays the one focusable, named control.
+ */
+export declare function readOnlyDragProps(readOnly: boolean): {
+    readonly 'aria-roledescription': undefined;
+    readonly 'aria-describedby': undefined;
+    readonly 'aria-disabled': undefined;
+    readonly tabIndex: undefined;
+} | {
+    readonly 'aria-roledescription'?: undefined;
+    'aria-describedby'?: undefined;
+    readonly 'aria-disabled'?: undefined;
+    readonly tabIndex?: undefined;
+};
+/**
+ * The props of an event's draggable wrapper (`Draggable`), the same in the
+ * time grid, the all-day strip and the month's overflow list: its drag
+ * switches (off with `disabled`, `readOnlyEvents` or the event's own
+ * `disabled`), a named group in place of dnd-kit's `button` (which would hold
+ * the chip's own button), and the focus that follows the event.
+ */
+export declare function useEventDragProps(event: CalendarEvent, title: string): {
+    readonly role: "group";
+    readonly 'aria-label': string;
+    readonly onFocus: () => void;
+    readonly onClick: (click: {
+        stopPropagation: () => void;
+    }) => void;
+    readonly 'aria-roledescription': undefined;
+    readonly 'aria-describedby': undefined;
+    readonly 'aria-disabled': undefined;
+    readonly tabIndex: undefined;
+    readonly id: string;
+    readonly data: {
+        readonly type: "event";
+    };
+    readonly disabled: boolean;
+} | {
+    readonly role: "group";
+    readonly 'aria-label': string;
+    readonly onFocus: () => void;
+    readonly onClick: (click: {
+        stopPropagation: () => void;
+    }) => void;
+    readonly 'aria-roledescription'?: undefined;
+    readonly 'aria-describedby'?: undefined;
+    readonly 'aria-disabled'?: undefined;
+    readonly tabIndex?: undefined;
+    readonly id: string;
+    readonly data: {
+        readonly type: "event";
+    };
+    readonly disabled: boolean;
+};

package/dist/lib/components/ui/widgets/event-calendar/event-calendar.resources.d.ts

@@ -24,7 +24,12 @@ export declare function withColumn(event: CalendarEvent, column: string | null):
 export declare function columnKey(column: ResourceColumn): string;
 /** The resource an event belongs to; none when it has none or an unknown one. */
 export declare function ownerOf(event: CalendarEvent, resources?: EventCalendarResource[]): EventCalendarResource | undefined;
-/** The event drawn in its resource's tone when it sets no colour of its own. */
+/** The tone an event is drawn in: its own, else its resource's. */
+export declare function toneOf(event: CalendarEvent, owner?: EventCalendarResource): Tone | undefined;
+/**
+ * The event drawn in its tone when it sets no colour of its own: its `color`
+ * wins, then its `tone`, then its resource's.
+ */
 export declare function withOwnerTone(event: CalendarEvent, owner?: EventCalendarResource): CalendarEvent;
 /**
  * The column an event is dropped into, or the event itself when it is already

package/dist/lib/components/ui/widgets/event-calendar/index.d.ts

@@ -1,6 +1,7 @@
+export type { EventCalendarBadges, EventCalendarDayMarksProps, EventCalendarSpan, } from './backdrop.types.js';
 export type { EventCalendarProps } from './event-calendar.js';
 export { EventCalendar } from './event-calendar.js';
 export { EventCalendarProvider, useEventCalendarContext, } from './event-calendar-context.js';
 export type { EventCalendarLane, EventCalendarTemplateChange, EventCalendarTemplateEvent, EventCalendarTemplateProps, EventCalendarTemplateSlot, EventCalendarWeekday, } from './template.types.js';
-export type { CalendarEvent, CalendarEventBadge, EventCalendarChange, EventCalendarDensity, EventCalendarPreviewField, EventCalendarRenderEvent, EventCalendarResource, EventCalendarSlot, EventCalendarView, } from './types.js';
+export type { CalendarEvent, CalendarEventBadge, CalendarEventStatus, EventCalendarChange, EventCalendarDensity, EventCalendarPreviewField, EventCalendarRenderEvent, EventCalendarResource, EventCalendarSlot, EventCalendarView, } from './types.js';
 export { useEventCalendar } from './use-event-calendar.js';

package/dist/lib/components/ui/widgets/event-calendar/partials/all-day-bars.d.ts

@@ -0,0 +1,14 @@
+import { BackdropLane } from '../backdrop.types.js';
+import { SpanSegment } from '../event-calendar.spans.js';
+/**
+ * What the all-day strip draws: the backdrop spans as bars in the rows on
+ * top, then the multi-day events below them.
+ */
+export declare function AllDayBars({ days, segments, backdrop, }: {
+    days: Date[];
+    segments: SpanSegment[];
+    backdrop: {
+        lanes: BackdropLane[];
+        rows: number;
+    };
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/event-calendar/partials/backdrop-bands.d.ts

@@ -0,0 +1,11 @@
+import { BackdropSegment } from '../backdrop.types.js';
+import { DayAxis } from '../event-calendar.axis.js';
+/**
+ * The spans of one column of hours: a hatched band under the events (z-0)
+ * with its label at the top. Decoration only: `aria-hidden`, no pointer
+ * events, no tab stop; the column's name carries the text.
+ */
+export declare function BackdropBands({ segments, axis, }: {
+    segments: BackdropSegment[];
+    axis: DayAxis;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/event-calendar/partials/backdrop-bar.d.ts

@@ -0,0 +1,11 @@
+import { BackdropLane } from '../backdrop.types.js';
+/**
+ * A whole-day span as a bar of the all-day strip, in the rows above the
+ * events. Decoration: `aria-hidden`, no pointer events (a click reaches the
+ * day under it).
+ */
+export declare function BackdropBar({ lane, showLabel, }: {
+    lane: BackdropLane;
+    /** False where the columns are too narrow for a label (a phone's week). */
+    showLabel?: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/event-calendar/partials/backdrop-cell.d.ts

@@ -0,0 +1,13 @@
+import { BackdropSegment } from '../backdrop.types.js';
+/**
+ * The spans of a month cell: the cell shaded (a half day shades its half),
+ * the label in its top corner from 7rem of cell width, and under that a dot.
+ * Decoration: `aria-hidden`, no pointer events; the cell's name carries the
+ * text. The cell is the `day` container and an `isolate` stacking context, so
+ * the shading sits under its content.
+ */
+export declare function BackdropCell({ segments, below, }: {
+    segments: BackdropSegment[];
+    /** The labels sit at the cell's foot: its day badge takes the top row. */
+    below?: boolean;
+}): import("react").JSX.Element;

package/dist/lib/components/ui/widgets/event-calendar/partials/backdrop-row.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The spans of a day in the agenda and the phone's day list: a hatched row
+ * with the label, ahead of the events. It is text, not a control: no pointer
+ * events (a click reaches the day) and no tab stop.
+ */
+export declare function BackdropRow({ day }: {
+    day: Date;
+}): import("react").JSX.Element | null;