@tensor_1/react 2.32.0 → 2.33.0

package/README.md

@@ -395,6 +395,23 @@ const spanLayout = layoutMonthSpans(spansInSalienceOrder, grid, { timeZone, week
 - **Fixed geometry.** With `days` / `dayEntries` (or `maxEntriesPerDay` plus `onShowMore`) every cell keeps one
   height: the head, the lane caps, the chip rows and the "+N" line. A chip reads `HH:MM title` (24 h, in the zone)
   unless `renderEntry` replaces it.
+- **Week and Day as a time grid** (`timeGrid`, HAR-1509): day columns on an hour axis.
+
+  ```tsx
+  <SchedulingCalendar view="week" timeGrid timeZone="Europe/Berlin" anchorDate="2026-10-07" showHeader={false}
+    entries={entries} overlays={windows} days={dayCounts} now={serverNow}
+    canMove={userMayMove} step={15}
+    onProposeMove={(id, { start, end, adjusted }) => reschedule(id, start, end)}   // the server decides; the calendar never moves an item
+    onSelectEntry={openItem} onShowMore={openDay} />
+  ```
+
+  - A column is as tall as its day (23, 24 or 25 hours); an item sits at its real time. `view="day"` is one column.
+  - An entry that crosses midnight by up to `topLaneCrossMidnightMinutes` (default 360) is one item in two joined
+    parts; all-day (`allDay`), longer and later-running entries go to the lane above the hours (`placesInTopLane`).
+  - Moves are proposals: drag, or Shift and an arrow key, then Enter (Escape drops it). An entry whose props do not
+    change stays where it was, so a refused move snaps back by construction. `movable: false` pins an entry.
+  - Overlapping items share at most `maxLanes` lanes, fewer in a narrow column; the column "+N" is the consumer's
+    `days[date].overflowCount`. `renderEntry(entry, { availableLines })` says how many text lines fit.
 - **Colour.** Every calendar colour is named once at the top of `scheduling-calendar.css` (`--calendar-*`).
 - **Deprecated, still working in 2.x:** `entry.state` / `SchedulingEntryState`, `overlay.kind` /
   `SchedulingOverlayKind` and the `previous` / `next` labels. An entry with `state` is no longer tinted: the two

package/dist/SchedulingCalendar-C4XVbqZr.d.ts

@@ -0,0 +1,339 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { CalendarWeekday } from './calendar-model.js';
+import { MoveProposal, MonthSpanLayout } from './scheduling-calendar-model.js';
+
+interface TimeGridEntryContext {
+    /** Whole text lines that fit in the item: 0 shows the markers only. */
+    availableLines: number;
+}
+interface SchedulingTimeGridProps {
+    view: 'week' | 'day';
+    days: string[];
+    timeZone: string;
+    entries: SchedulingCalendarEntry[];
+    overlays: SchedulingCalendarOverlay[];
+    dayInfo?: Record<string, SchedulingCalendarDay>;
+    labels: Required<SchedulingCalendarLabels>;
+    gridLabel: string;
+    dateText: (date: string, part: SchedulingDatePart) => string;
+    formatInstant: (instant: string) => string;
+    entryName: (entry: SchedulingCalendarEntry) => string;
+    entryStatus: (entry: SchedulingCalendarEntry) => string;
+    entryMarkers: (entry: SchedulingCalendarEntry) => SchedulingMarker[];
+    overlayName: (overlay: SchedulingCalendarOverlay) => string;
+    renderEntry?: (entry: SchedulingCalendarEntry, context?: TimeGridEntryContext) => ReactNode;
+    renderMarker: (marker: SchedulingMarker, showLabel?: boolean) => ReactNode;
+    onSelectEntry?: (entry: SchedulingCalendarEntry) => void;
+    onSelectOverlay?: (overlay: SchedulingCalendarOverlay) => void;
+    onSelectDate?: (date: string) => void;
+    onShowMore?: (date: string, entries: SchedulingCalendarEntry[]) => void;
+    now?: string;
+    canMove: boolean;
+    step: number;
+    onProposeMove?: (id: string, proposal: MoveProposal) => void | Promise<unknown>;
+    topLaneCrossMidnightMinutes: number;
+    topLaneCap: number;
+    windowLaneCap: number;
+    maxLanes: number;
+    emptyNote?: ReactNode;
+    nothingToShow: boolean;
+}
+/** Week (seven columns) or Day (one column) with an hour axis. */
+declare function SchedulingTimeGrid({ view, days, timeZone, entries: givenEntries, overlays: givenOverlays, dayInfo, labels, gridLabel, dateText, formatInstant, entryName, entryStatus, entryMarkers, overlayName, renderEntry, renderMarker, onSelectEntry, onSelectOverlay, onSelectDate, onShowMore, now, canMove, step: givenStep, onProposeMove, topLaneCrossMidnightMinutes, topLaneCap, windowLaneCap, maxLanes, emptyNote, nothingToShow, }: SchedulingTimeGridProps): react.JSX.Element;
+
+/** `day` is one column of the time grid. `week` is the time grid when `timeGrid` is set, else seven day cells. */
+type SchedulingCalendarView = 'month' | 'week' | 'day' | 'agenda';
+/**
+ * @deprecated Use `band`, `status` and `markers` on the entry: they carry no product
+ * vocabulary and the consumer supplies every word. The values keep working in 2.x.
+ */
+type SchedulingEntryState = 'scheduled' | 'conflicted' | 'in-progress' | 'blackout-violation';
+/** @deprecated Use `pattern` and `kindLabel` on the overlay. The values keep working in 2.x. */
+type SchedulingOverlayKind = 'maintenance' | 'blackout';
+/**
+ * The one dimension that takes a hue. `none` and `low` are untinted, `medium` gets a
+ * heavier edge, and only `high` is filled. The consumer decides what a band means.
+ */
+type SchedulingBand = 'none' | 'low' | 'medium' | 'high';
+/**
+ * The state channel, drawn without hue: `tentative` is dashed, `committed` is the plain
+ * item, `live` carries a leading dot, `done` is dimmed and `dead` is struck through.
+ */
+type SchedulingStatus = 'tentative' | 'committed' | 'live' | 'done' | 'dead';
+type SchedulingMarkerEmphasis = 'refused' | 'warning' | 'neutral';
+/** How a window is hatched. Windows are neutral: the pattern and the visible label tell them apart. */
+type SchedulingOverlayPattern = 'diagonal' | 'cross' | 'dotted' | 'solid';
+/**
+ * Which date text a `formatDate` call is for (TENSOR B1/C9, HAR-1347):
+ * `day` names one day (each day cell's accessible name, the week-range title);
+ * `weekday` is the short column header (the date is any day of that weekday);
+ * `month` is the month-view title (the date is the first of the month);
+ * `column` heads one day column of the time grid (weekday and date, e.g. "Wed 07.10").
+ */
+type SchedulingDatePart = 'day' | 'weekday' | 'month' | 'column';
+/** A shape or icon with text. The text is always in the accessible name; a marker never relies on colour. */
+interface SchedulingMarker {
+    id: string;
+    /** An icon from `@tensor_1/react/icons`. Without one the marker draws a shape for its `emphasis`. */
+    icon?: ReactNode;
+    label: string;
+    emphasis?: SchedulingMarkerEmphasis;
+}
+interface SchedulingCalendarEntry {
+    id: string;
+    title: string;
+    start: string;
+    end: string;
+    /** @deprecated Use `band`, `status` and `markers`. */
+    state?: SchedulingEntryState;
+    meta?: string;
+    band?: SchedulingBand;
+    status?: SchedulingStatus;
+    markers?: SchedulingMarker[];
+    /** The complete accessible name, built by the consumer from its own words. Replaces `labels.entry`. */
+    accessibleName?: string;
+    /** No time of day. In the time grid the entry is drawn in the top lane. */
+    allDay?: boolean;
+    /** `false` keeps this entry where it is when the grid allows moves (`canMove`). */
+    movable?: boolean;
+}
+interface SchedulingCalendarOverlay {
+    id: string;
+    /** The window's name, shown as text. */
+    label: string;
+    start: string;
+    end: string;
+    /** @deprecated Use `pattern` and `kindLabel`. */
+    kind?: SchedulingOverlayKind;
+    /** Defaults to `'solid'`. */
+    pattern?: SchedulingOverlayPattern;
+    /** What kind of window this is, in the consumer's words. Shown before the name. */
+    kindLabel?: string;
+    /** What the window applies to. Shown after the name. */
+    scopeLabel?: string;
+    /** The window applies to everything. A window that is not global never gets the global treatment. */
+    global?: boolean;
+    /** The complete accessible name. Replaces `labels.overlay`. */
+    accessibleName?: string;
+}
+/** What the consumer knows about one day (`YYYY-MM-DD`). The calendar shows these numbers and never derives them. */
+interface SchedulingCalendarDay {
+    /** Every item on the day, shown in the cell even when no chip fits. */
+    count: number;
+    /** The "+N" of the cell. 0 shows none. */
+    overflowCount: number;
+    /** The accessible text of the count, e.g. "7 items, 2 need review". */
+    label?: string;
+    markers?: SchedulingMarker[];
+}
+interface SchedulingLegendItem {
+    id: string;
+    label: string;
+    swatch: {
+        band?: SchedulingBand;
+        status?: SchedulingStatus;
+        pattern?: SchedulingOverlayPattern;
+        icon?: ReactNode;
+    };
+}
+/**
+ * Every word the calendar renders (TENSOR RX-125, UIX-12). `{timeZone}`, `{view}`,
+ * `{title}`, `{state}`, `{start}`, `{end}` are placeholders.
+ */
+interface SchedulingCalendarLabels {
+    region: string;
+    /** @deprecated Use `previousMonth` and `previousWeek`. Still used when those are not set. */
+    previous: string;
+    /** @deprecated Use `nextMonth` and `nextWeek`. Still used when those are not set. */
+    next: string;
+    previousMonth?: string;
+    nextMonth?: string;
+    /** Also names the agenda's step, which moves by a week. */
+    previousWeek?: string;
+    nextWeek?: string;
+    previousDay?: string;
+    nextDay?: string;
+    viewGroup: string;
+    viewMonth: string;
+    viewWeek: string;
+    viewDay?: string;
+    viewAgenda: string;
+    loading: string;
+    retry: string;
+    agenda: string;
+    agendaEmpty: string;
+    grid: string;
+    /** An entry's accessible name unless it sets `accessibleName`. Its marker labels are appended. */
+    entry: string;
+    /** A window's accessible name unless it sets `accessibleName`. `{title}` is its kind, name and scope. */
+    overlay?: string;
+    legend: string;
+    /** The "+N more" toggle on a day with more entries than `maxEntriesPerDay`. `{count}` placeholder. */
+    moreEntries: string;
+    /** Accessible name of that toggle. `{count}` and `{date}` placeholders. */
+    moreEntriesLabel: string;
+    /** The toggle once the day is expanded in place. */
+    fewerEntries: string;
+    /** The "+N" at the end of a week row whose spans did not all get a lane. `{count}` placeholder. */
+    moreSpans?: string;
+    /** Accessible name of that control. `{count}` and `{date}` (the first day with a hidden span). */
+    moreSpansLabel?: string;
+    /** The accessible text of a day's count when `days[date].label` is not given. `{count}` placeholder. */
+    dayCount?: string;
+    states: Record<SchedulingEntryState, string>;
+    /** The words for `status`, used in the default accessible name and the agenda. */
+    statuses?: Partial<Record<SchedulingStatus, string>>;
+    /** The header of the hour axis: it names the display zone. `{timeZone}` placeholder. */
+    timeZone?: string;
+    /** Names the strip of windows above the time grid. */
+    windows?: string;
+    /** "+N windows" when the strip has more windows than lanes. `{count}` placeholder. */
+    moreWindows?: string;
+    /** Accessible name of that control. `{count}` and `{date}` (the first day with a hidden window). */
+    moreWindowsLabel?: string;
+    /** Names the lane above the hours that holds all-day and long entries. */
+    topLane?: string;
+    /** The cue on the second-day part of an entry that crosses midnight. `{time}` is its start. */
+    continuesFrom?: string;
+    /** Read after an item's name when it can be moved. */
+    moveHint?: string;
+    /** Announced for a pending move. `{start}` and `{end}` placeholders. */
+    moveProposed?: string;
+    /** Announced when a pending move is dropped. */
+    moveCancelled?: string;
+    /** Announced when the time asked for does not exist that day. `{time}` is the time used instead. */
+    gapForward?: string;
+}
+declare const DEFAULT_SCHEDULING_CALENDAR_LABELS: SchedulingCalendarLabels;
+interface SchedulingCalendarProps {
+    /**
+     * The entries. Without `dayEntries` the calendar places each on its day in the order
+     * given; with `dayEntries` only the entries that cover more than one day are read from
+     * here (they are drawn as spans).
+     */
+    entries: SchedulingCalendarEntry[];
+    anchorDate: string;
+    timeZone: string;
+    view?: SchedulingCalendarView;
+    onViewChange?: (view: SchedulingCalendarView) => void;
+    onAnchorDateChange?: (date: string) => void;
+    /** Called by a click or Enter on a chip, a span or an agenda row. */
+    onSelectEntry?: (entry: SchedulingCalendarEntry) => void;
+    overlays?: SchedulingCalendarOverlay[];
+    /** Called by a click or Enter on a window span. */
+    onSelectOverlay?: (overlay: SchedulingCalendarOverlay) => void;
+    filter?: (entry: SchedulingCalendarEntry) => boolean;
+    /**
+     * Replaces a chip's content. The default is the start time in `timeZone` (24 h) and the title.
+     * In the time grid the second argument says how many text lines fit in the item (0: show the
+     * markers only); elsewhere it is not passed.
+     */
+    renderEntry?: (entry: SchedulingCalendarEntry, context?: TimeGridEntryContext) => ReactNode;
+    locale?: string;
+    /** First column of the month and week grids: 0 = Sunday … 6 = Saturday. Defaults to 1 (Monday). */
+    weekStartsOn?: CalendarWeekday;
+    /**
+     * Formats every calendar date the component writes (`date` is `YYYY-MM-DD`). Use it to
+     * apply a product date format such as DD.MM.YYYY; defaults to `Intl` in `locale`.
+     */
+    formatDate?: (date: string, part: SchedulingDatePart) => string;
+    /**
+     * Formats a start or end instant (ISO 8601) for the agenda and the accessible names.
+     * The component does not shift it: render it in `timeZone` yourself. Defaults to the
+     * `day` date text followed by the 24-hour time in `timeZone`.
+     */
+    formatInstant?: (instant: string) => string;
+    /**
+     * How many chips a day shows. Without `dayEntries` the rest collapse behind "+N more";
+     * with `dayEntries` it only sizes the cell (the consumer already cut the list, and a longer
+     * list makes the cells taller, never clipped). Unset shows every entry where the cells
+     * grow, and sizes a fixed cell for three chips.
+     */
+    maxEntriesPerDay?: number;
+    /**
+     * Called by a day's "+N more" and by a week row's "+N" with the day (and, without
+     * `dayEntries`, every entry on it). When set, the consumer shows them (a popover, a
+     * drawer, the day view) and the day stays collapsed. Required with `days` or `dayEntries`:
+     * a controlled day never expands in place.
+     */
+    onShowMore?: (date: string, entries: SchedulingCalendarEntry[]) => void;
+    /**
+     * A small badge beside a day's date, e.g. a collision count. Keep it short (a number or a
+     * glyph): it shares a narrow column with the date and is clipped, not wrapped. It sits
+     * outside the date button, so give it its own accessible text (a visually hidden word next
+     * to the number). Return null for no badge.
+     */
+    renderDayBadge?: (date: string, entries: SchedulingCalendarEntry[]) => ReactNode;
+    /**
+     * Consumer-owned numbers per day (`YYYY-MM-DD`). When set, each listed day shows its
+     * `count` and markers even with no chip, and its "+N" is `overflowCount`, never a number
+     * derived from the entries given. Without `dayEntries` the chips are still this day's
+     * `entries`, cut to `maxEntriesPerDay`; the day never expands in place.
+     */
+    days?: Record<string, SchedulingCalendarDay>;
+    /**
+     * The single-day chips of each day, already ranked and cut by the consumer. When set, the
+     * calendar renders exactly these in the order given: it does not place, rank, cut or count.
+     */
+    dayEntries?: Record<string, SchedulingCalendarEntry[]>;
+    /**
+     * The result of `layoutMonthSpans` for this grid. When set, the calendar draws exactly
+     * these spans and never packs lanes itself. Compute it with `schedulingGridDays`.
+     */
+    spanLayout?: MonthSpanLayout;
+    /**
+     * Lanes kept for windows above the chips. Windows never take a chip slot. Default 2 where
+     * the cells have a fixed height; where they grow with their content every window gets a lane.
+     */
+    windowLaneCap?: number;
+    /** Lanes kept for entries that cover more than one day. Default as for `windowLaneCap`. */
+    spanLaneCap?: number;
+    /** When set, the legend is exactly these items (an empty list draws no legend). Unset keeps the built-in state legend. */
+    legend?: SchedulingLegendItem[];
+    /** A line under the legend, e.g. the display zone. */
+    legendCaption?: ReactNode;
+    /** `false` hides the previous/next buttons, the title and the view switch (the page has its own toolbar). */
+    showHeader?: boolean;
+    /** Shown above the grid, e.g. "Showing the first 2,000 items". */
+    notice?: ReactNode;
+    /** Shown inside the grid, below the day cells, when there is nothing to show. */
+    emptyNote?: ReactNode;
+    /** Called by a click or Enter on a day number. */
+    onSelectDate?: (date: string) => void;
+    /**
+     * Draws `view="week"` as a time grid: seven day columns on an hour axis. `view="day"` is
+     * always a time grid. Default `false`: the week stays seven day cells.
+     */
+    timeGrid?: boolean;
+    /** An instant (ISO 8601). The time grid draws one line at it, in the column of its day. The component keeps no clock. */
+    now?: string;
+    /**
+     * Lets the user ask for a move in the time grid (drag, or Shift and an arrow key, then
+     * Enter). Without it, or without `onProposeMove`, items have no move affordance at all.
+     */
+    canMove?: boolean;
+    /** Minutes a move snaps to. Default 15. */
+    step?: number;
+    /**
+     * Called once per finished gesture with the window the user asks for. The calendar never
+     * moves the item: it draws entries where the props say, so an entry whose props do not
+     * change is back where it was. Return a promise to keep the outline until it settles.
+     */
+    onProposeMove?: (id: string, proposal: MoveProposal) => void | Promise<unknown>;
+    /** An entry running more than this many minutes past its first local midnight goes to the top lane. Default 360. */
+    topLaneCrossMidnightMinutes?: number;
+    /** Rows of the top lane of the time grid. Default 3. */
+    topLaneCap?: number;
+    /** Lanes side by side in one day column of the time grid, at most. Fewer are used when the column is narrow. Default 4. */
+    maxLanes?: number;
+    loading?: boolean;
+    error?: string;
+    onRetry?: () => void;
+    className?: string;
+    labels?: Partial<SchedulingCalendarLabels>;
+}
+/** Month/week/agenda calendar for UTC ranges rendered in an explicit IANA time zone. */
+declare function SchedulingCalendar({ entries, anchorDate, timeZone, view: controlledView, onViewChange, onAnchorDateChange, onSelectEntry, overlays, onSelectOverlay, filter, renderEntry, locale, weekStartsOn, formatDate, formatInstant: formatInstantProp, maxEntriesPerDay, onShowMore, renderDayBadge, days: dayInfo, dayEntries, spanLayout, windowLaneCap, spanLaneCap, legend, legendCaption, showHeader, notice, emptyNote, onSelectDate, timeGrid, now, canMove, step, onProposeMove, topLaneCrossMidnightMinutes, topLaneCap, maxLanes, loading, error, onRetry, className, labels: labelOverrides, }: SchedulingCalendarProps): react.JSX.Element;
+
+export { DEFAULT_SCHEDULING_CALENDAR_LABELS as D, type SchedulingBand as S, type TimeGridEntryContext as T, SchedulingCalendar as a, type SchedulingCalendarDay as b, type SchedulingCalendarEntry as c, type SchedulingCalendarLabels as d, type SchedulingCalendarOverlay as e, type SchedulingCalendarProps as f, type SchedulingCalendarView as g, type SchedulingDatePart as h, type SchedulingEntryState as i, type SchedulingLegendItem as j, type SchedulingMarker as k, type SchedulingMarkerEmphasis as l, type SchedulingOverlayKind as m, type SchedulingOverlayPattern as n, type SchedulingStatus as o, SchedulingTimeGrid as p, type SchedulingTimeGridProps as q };

package/dist/components/SchedulingCalendar.d.ts

@@ -1,241 +1,4 @@
-import * as react from 'react';
-import { ReactNode } from 'react';
-import { CalendarWeekday } from '../calendar-model.js';
-import { MonthSpanLayout } from '../scheduling-calendar-model.js';
-
-type SchedulingCalendarView = 'month' | 'week' | 'agenda';
-/**
- * @deprecated Use `band`, `status` and `markers` on the entry: they carry no product
- * vocabulary and the consumer supplies every word. The values keep working in 2.x.
- */
-type SchedulingEntryState = 'scheduled' | 'conflicted' | 'in-progress' | 'blackout-violation';
-/** @deprecated Use `pattern` and `kindLabel` on the overlay. The values keep working in 2.x. */
-type SchedulingOverlayKind = 'maintenance' | 'blackout';
-/**
- * The one dimension that takes a hue. `none` and `low` are untinted, `medium` gets a
- * heavier edge, and only `high` is filled. The consumer decides what a band means.
- */
-type SchedulingBand = 'none' | 'low' | 'medium' | 'high';
-/**
- * The state channel, drawn without hue: `tentative` is dashed, `committed` is the plain
- * item, `live` carries a leading dot, `done` is dimmed and `dead` is struck through.
- */
-type SchedulingStatus = 'tentative' | 'committed' | 'live' | 'done' | 'dead';
-type SchedulingMarkerEmphasis = 'refused' | 'warning' | 'neutral';
-/** How a window is hatched. Windows are neutral: the pattern and the visible label tell them apart. */
-type SchedulingOverlayPattern = 'diagonal' | 'cross' | 'dotted' | 'solid';
-/**
- * Which date text a `formatDate` call is for (TENSOR B1/C9, HAR-1347):
- * `day` names one day (each day cell's accessible name, the week-range title);
- * `weekday` is the short column header (the date is any day of that weekday);
- * `month` is the month-view title (the date is the first of the month).
- */
-type SchedulingDatePart = 'day' | 'weekday' | 'month';
-/** A shape or icon with text. The text is always in the accessible name; a marker never relies on colour. */
-interface SchedulingMarker {
-    id: string;
-    /** An icon from `@tensor_1/react/icons`. Without one the marker draws a shape for its `emphasis`. */
-    icon?: ReactNode;
-    label: string;
-    emphasis?: SchedulingMarkerEmphasis;
-}
-interface SchedulingCalendarEntry {
-    id: string;
-    title: string;
-    start: string;
-    end: string;
-    /** @deprecated Use `band`, `status` and `markers`. */
-    state?: SchedulingEntryState;
-    meta?: string;
-    band?: SchedulingBand;
-    status?: SchedulingStatus;
-    markers?: SchedulingMarker[];
-    /** The complete accessible name, built by the consumer from its own words. Replaces `labels.entry`. */
-    accessibleName?: string;
-}
-interface SchedulingCalendarOverlay {
-    id: string;
-    /** The window's name, shown as text. */
-    label: string;
-    start: string;
-    end: string;
-    /** @deprecated Use `pattern` and `kindLabel`. */
-    kind?: SchedulingOverlayKind;
-    /** Defaults to `'solid'`. */
-    pattern?: SchedulingOverlayPattern;
-    /** What kind of window this is, in the consumer's words. Shown before the name. */
-    kindLabel?: string;
-    /** What the window applies to. Shown after the name. */
-    scopeLabel?: string;
-    /** The window applies to everything. A window that is not global never gets the global treatment. */
-    global?: boolean;
-    /** The complete accessible name. Replaces `labels.overlay`. */
-    accessibleName?: string;
-}
-/** What the consumer knows about one day (`YYYY-MM-DD`). The calendar shows these numbers and never derives them. */
-interface SchedulingCalendarDay {
-    /** Every item on the day, shown in the cell even when no chip fits. */
-    count: number;
-    /** The "+N" of the cell. 0 shows none. */
-    overflowCount: number;
-    /** The accessible text of the count, e.g. "7 items, 2 need review". */
-    label?: string;
-    markers?: SchedulingMarker[];
-}
-interface SchedulingLegendItem {
-    id: string;
-    label: string;
-    swatch: {
-        band?: SchedulingBand;
-        status?: SchedulingStatus;
-        pattern?: SchedulingOverlayPattern;
-        icon?: ReactNode;
-    };
-}
-/**
- * Every word the calendar renders (TENSOR RX-125, UIX-12). `{timeZone}`, `{view}`,
- * `{title}`, `{state}`, `{start}`, `{end}` are placeholders.
- */
-interface SchedulingCalendarLabels {
-    region: string;
-    /** @deprecated Use `previousMonth` and `previousWeek`. Still used when those are not set. */
-    previous: string;
-    /** @deprecated Use `nextMonth` and `nextWeek`. Still used when those are not set. */
-    next: string;
-    previousMonth?: string;
-    nextMonth?: string;
-    /** Also names the agenda's step, which moves by a week. */
-    previousWeek?: string;
-    nextWeek?: string;
-    viewGroup: string;
-    viewMonth: string;
-    viewWeek: string;
-    viewAgenda: string;
-    loading: string;
-    retry: string;
-    agenda: string;
-    agendaEmpty: string;
-    grid: string;
-    /** An entry's accessible name unless it sets `accessibleName`. Its marker labels are appended. */
-    entry: string;
-    /** A window's accessible name unless it sets `accessibleName`. `{title}` is its kind, name and scope. */
-    overlay?: string;
-    legend: string;
-    /** The "+N more" toggle on a day with more entries than `maxEntriesPerDay`. `{count}` placeholder. */
-    moreEntries: string;
-    /** Accessible name of that toggle. `{count}` and `{date}` placeholders. */
-    moreEntriesLabel: string;
-    /** The toggle once the day is expanded in place. */
-    fewerEntries: string;
-    /** The "+N" at the end of a week row whose spans did not all get a lane. `{count}` placeholder. */
-    moreSpans?: string;
-    /** Accessible name of that control. `{count}` and `{date}` (the first day with a hidden span). */
-    moreSpansLabel?: string;
-    /** The accessible text of a day's count when `days[date].label` is not given. `{count}` placeholder. */
-    dayCount?: string;
-    states: Record<SchedulingEntryState, string>;
-    /** The words for `status`, used in the default accessible name and the agenda. */
-    statuses?: Partial<Record<SchedulingStatus, string>>;
-}
-declare const DEFAULT_SCHEDULING_CALENDAR_LABELS: SchedulingCalendarLabels;
-interface SchedulingCalendarProps {
-    /**
-     * The entries. Without `dayEntries` the calendar places each on its day in the order
-     * given; with `dayEntries` only the entries that cover more than one day are read from
-     * here (they are drawn as spans).
-     */
-    entries: SchedulingCalendarEntry[];
-    anchorDate: string;
-    timeZone: string;
-    view?: SchedulingCalendarView;
-    onViewChange?: (view: SchedulingCalendarView) => void;
-    onAnchorDateChange?: (date: string) => void;
-    /** Called by a click or Enter on a chip, a span or an agenda row. */
-    onSelectEntry?: (entry: SchedulingCalendarEntry) => void;
-    overlays?: SchedulingCalendarOverlay[];
-    /** Called by a click or Enter on a window span. */
-    onSelectOverlay?: (overlay: SchedulingCalendarOverlay) => void;
-    filter?: (entry: SchedulingCalendarEntry) => boolean;
-    /** Replaces a chip's content. The default is the start time in `timeZone` (24 h) and the title. */
-    renderEntry?: (entry: SchedulingCalendarEntry) => ReactNode;
-    locale?: string;
-    /** First column of the month and week grids: 0 = Sunday … 6 = Saturday. Defaults to 1 (Monday). */
-    weekStartsOn?: CalendarWeekday;
-    /**
-     * Formats every calendar date the component writes (`date` is `YYYY-MM-DD`). Use it to
-     * apply a product date format such as DD.MM.YYYY; defaults to `Intl` in `locale`.
-     */
-    formatDate?: (date: string, part: SchedulingDatePart) => string;
-    /**
-     * Formats a start or end instant (ISO 8601) for the agenda and the accessible names.
-     * The component does not shift it: render it in `timeZone` yourself. Defaults to the
-     * `day` date text followed by the 24-hour time in `timeZone`.
-     */
-    formatInstant?: (instant: string) => string;
-    /**
-     * How many chips a day shows. Without `dayEntries` the rest collapse behind "+N more";
-     * with `dayEntries` it only sizes the cell (the consumer already cut the list, and a longer
-     * list makes the cells taller, never clipped). Unset shows every entry where the cells
-     * grow, and sizes a fixed cell for three chips.
-     */
-    maxEntriesPerDay?: number;
-    /**
-     * Called by a day's "+N more" and by a week row's "+N" with the day (and, without
-     * `dayEntries`, every entry on it). When set, the consumer shows them (a popover, a
-     * drawer, the day view) and the day stays collapsed. Required with `days` or `dayEntries`:
-     * a controlled day never expands in place.
-     */
-    onShowMore?: (date: string, entries: SchedulingCalendarEntry[]) => void;
-    /**
-     * A small badge beside a day's date, e.g. a collision count. Keep it short (a number or a
-     * glyph): it shares a narrow column with the date and is clipped, not wrapped. It sits
-     * outside the date button, so give it its own accessible text (a visually hidden word next
-     * to the number). Return null for no badge.
-     */
-    renderDayBadge?: (date: string, entries: SchedulingCalendarEntry[]) => ReactNode;
-    /**
-     * Consumer-owned numbers per day (`YYYY-MM-DD`). When set, each listed day shows its
-     * `count` and markers even with no chip, and its "+N" is `overflowCount`, never a number
-     * derived from the entries given. Without `dayEntries` the chips are still this day's
-     * `entries`, cut to `maxEntriesPerDay`; the day never expands in place.
-     */
-    days?: Record<string, SchedulingCalendarDay>;
-    /**
-     * The single-day chips of each day, already ranked and cut by the consumer. When set, the
-     * calendar renders exactly these in the order given: it does not place, rank, cut or count.
-     */
-    dayEntries?: Record<string, SchedulingCalendarEntry[]>;
-    /**
-     * The result of `layoutMonthSpans` for this grid. When set, the calendar draws exactly
-     * these spans and never packs lanes itself. Compute it with `schedulingGridDays`.
-     */
-    spanLayout?: MonthSpanLayout;
-    /**
-     * Lanes kept for windows above the chips. Windows never take a chip slot. Default 2 where
-     * the cells have a fixed height; where they grow with their content every window gets a lane.
-     */
-    windowLaneCap?: number;
-    /** Lanes kept for entries that cover more than one day. Default as for `windowLaneCap`. */
-    spanLaneCap?: number;
-    /** When set, the legend is exactly these items (an empty list draws no legend). Unset keeps the built-in state legend. */
-    legend?: SchedulingLegendItem[];
-    /** A line under the legend, e.g. the display zone. */
-    legendCaption?: ReactNode;
-    /** `false` hides the previous/next buttons, the title and the view switch (the page has its own toolbar). */
-    showHeader?: boolean;
-    /** Shown above the grid, e.g. "Showing the first 2,000 items". */
-    notice?: ReactNode;
-    /** Shown inside the grid, below the day cells, when there is nothing to show. */
-    emptyNote?: ReactNode;
-    /** Called by a click or Enter on a day number. */
-    onSelectDate?: (date: string) => void;
-    loading?: boolean;
-    error?: string;
-    onRetry?: () => void;
-    className?: string;
-    labels?: Partial<SchedulingCalendarLabels>;
-}
-/** Month/week/agenda calendar for UTC ranges rendered in an explicit IANA time zone. */
-declare function SchedulingCalendar({ entries, anchorDate, timeZone, view: controlledView, onViewChange, onAnchorDateChange, onSelectEntry, overlays, onSelectOverlay, filter, renderEntry, locale, weekStartsOn, formatDate, formatInstant: formatInstantProp, maxEntriesPerDay, onShowMore, renderDayBadge, days: dayInfo, dayEntries, spanLayout, windowLaneCap, spanLaneCap, legend, legendCaption, showHeader, notice, emptyNote, onSelectDate, loading, error, onRetry, className, labels: labelOverrides, }: SchedulingCalendarProps): react.JSX.Element;
-
-export { DEFAULT_SCHEDULING_CALENDAR_LABELS, type SchedulingBand, SchedulingCalendar, type SchedulingCalendarDay, type SchedulingCalendarEntry, type SchedulingCalendarLabels, type SchedulingCalendarOverlay, type SchedulingCalendarProps, type SchedulingCalendarView, type SchedulingDatePart, type SchedulingEntryState, type SchedulingLegendItem, type SchedulingMarker, type SchedulingMarkerEmphasis, type SchedulingOverlayKind, type SchedulingOverlayPattern, type SchedulingStatus };
+import 'react';
+import '../calendar-model.js';
+import '../scheduling-calendar-model.js';
+export { D as DEFAULT_SCHEDULING_CALENDAR_LABELS, S as SchedulingBand, a as SchedulingCalendar, b as SchedulingCalendarDay, c as SchedulingCalendarEntry, d as SchedulingCalendarLabels, e as SchedulingCalendarOverlay, f as SchedulingCalendarProps, g as SchedulingCalendarView, h as SchedulingDatePart, i as SchedulingEntryState, j as SchedulingLegendItem, k as SchedulingMarker, l as SchedulingMarkerEmphasis, m as SchedulingOverlayKind, n as SchedulingOverlayPattern, o as SchedulingStatus } from '../SchedulingCalendar-C4XVbqZr.js';