@mieweb/ui 0.10.0-dev.2 → 0.10.0-dev.20

package/dist/components/ViewSet/index.d.cts

@@ -0,0 +1,300 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * The contract every component in the `Modules/Views` family reads through.
+ *
+ * A page describes its collection once — which field is the id, the title, the
+ * status, the start date — and every view understands it. That is the whole
+ * reason the family exists: without it each view needs its own adapter and you
+ * end up re-implementing the same board per entity.
+ *
+ * Views are headless. Nothing here fetches, subscribes, or navigates.
+ * See CONTRIBUTING → "Modules: headless data components".
+ */
+
+/**
+ * Which layout is on screen. `overview` and `table` are rendered by the host
+ * through `ViewSet` slots rather than by a component in this family — a tabular
+ * collection is `DataVisNitroGrid`, and an overview is domain content.
+ */
+type ViewId = 'overview' | 'list' | 'board' | 'calendar' | 'gantt' | 'roadmap' | 'table';
+/**
+ * A semantic colour name, resolved to `--mieweb-*` tokens by each view.
+ *
+ * Accessors return one of these rather than a class string so a caller cannot
+ * hardcode a palette that breaks under another brand or in dark mode.
+ */
+type Accent = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+/** A named stage: a board column, and the segments of a stage bar. */
+interface Stage {
+    id: string;
+    label: string;
+    accent?: Accent;
+}
+/**
+ * How a view reads one item. Only `getId` and `getTitle` are always required;
+ * each view documents which of the rest it needs (a board needs `getStatus`, a
+ * Gantt needs `getStart`) and renders an explanatory empty state without them.
+ */
+interface ViewAccessors<T> {
+    getId: (item: T) => string;
+    getTitle: (item: T) => string;
+    /** Secondary line under the title. */
+    getSubtitle?: (item: T) => string | undefined;
+    /** Board column and list group; matched against `Stage['id']`. */
+    getStatus?: (item: T) => string;
+    /** Gantt bar start, calendar placement. */
+    getStart?: (item: T) => Date | string | null | undefined;
+    /** Gantt bar end, calendar span. Falls back to the start when absent. */
+    getEnd?: (item: T) => Date | string | null | undefined;
+    /** Swimlane in a roadmap, row group in a Gantt. */
+    getGroup?: (item: T) => string | undefined;
+    getAccent?: (item: T) => Accent;
+}
+/** Strings a view renders. Every one is overridable; the defaults are English. */
+interface ViewLabels {
+    /** Accessible name of the view switcher group. */
+    viewSwitcher: string;
+    loading: string;
+    empty: string;
+    error: string;
+    /** Action on the error state. */
+    retry: string;
+    /** Heading for the group a record with no status or group falls into. */
+    ungrouped: string;
+}
+/**
+ * Props every view accepts. Views are controlled: selection, the active view and
+ * filter state live in the page, and every change is handed back.
+ */
+interface ViewBaseProps<T> {
+    items: T[];
+    accessors: ViewAccessors<T>;
+    loading?: boolean;
+    error?: Error | null;
+    selectedId?: string | null;
+    /** Called when the user activates an item. */
+    onOpen?: (id: string, item: T) => void;
+    /** Return a URL to render each item as a real anchor — middle-clickable and crawlable. */
+    getHref?: (id: string, item: T) => string;
+    /** Render one item. Receives the active view so one function can serve several. */
+    renderItem?: (item: T, context: {
+        view: ViewId;
+    }) => React.ReactNode;
+    /** Replaces the built-in empty state. */
+    emptyState?: React.ReactNode;
+    labels?: Partial<ViewLabels>;
+    /** Pins "today" so stories, tests and visual snapshots stay deterministic. */
+    now?: Date;
+    className?: string;
+}
+
+interface ViewOption {
+    id: ViewId;
+    /** Overrides the built-in English label. */
+    label?: string;
+    /** Overrides the built-in icon. */
+    icon?: React.ComponentType<{
+        className?: string;
+        'aria-hidden'?: boolean;
+    }>;
+    disabled?: boolean;
+}
+
+type ListViewSlot = 'group' | 'groupHeader' | 'item' | 'selectedItem' | 'state';
+interface ListViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof itemVariants> {
+    /**
+     * Group rows by `accessors.getStatus`, using these stages for order and
+     * labels. Items whose status matches no stage are appended under their own
+     * heading rather than dropped.
+     */
+    stages?: readonly Stage[];
+    /** Group by `accessors.getGroup` instead of by stage. */
+    groupBy?: 'status' | 'group' | 'none';
+    /** Groups that start collapsed. Uncontrolled; the user can reopen them. */
+    defaultCollapsedGroups?: readonly string[];
+    /** Retries the failed load. Renders the retry action only when provided. */
+    onRetry?: () => void;
+    classNames?: Partial<Record<ListViewSlot, string>>;
+    /** Heading level for group headers, under the page's own heading. */
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+declare const itemVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+    interactive?: boolean | null | undefined;
+    selected?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type BoardViewSlot = 'column' | 'columnHeader' | 'card' | 'selectedCard' | 'state';
+interface BoardLabels extends ViewLabels {
+    /** Accessible name of the scrollable board region. */
+    board: string;
+    /** Announced when a card starts moving. `{item}` and `{stage}` are substituted. */
+    moved: string;
+    /** Announced when `onMove` rejects. */
+    moveFailed: string;
+    /** Hint on a focusable card describing the keyboard move. */
+    moveHint: string;
+}
+interface BoardViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof cardVariants> {
+    /** Columns, in order. A board without stages has nothing to draw. */
+    stages: readonly Stage[];
+    /**
+     * Commits a move. The board shows the card in its new column while this is
+     * pending and puts it back if the promise rejects, so the caller never has to
+     * re-render it home.
+     */
+    onMove?: (id: string, toStage: string, item: T) => void | Promise<void>;
+    labels?: Partial<BoardLabels>;
+    classNames?: Partial<Record<BoardViewSlot, string>>;
+    /** Heading level for column headers, under the page's own heading. */
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+declare const cardVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+    interactive?: boolean | null | undefined;
+    selected?: boolean | null | undefined;
+    pending?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type CalendarViewSlot = 'toolbar' | 'weekday' | 'day' | 'outsideDay' | 'today' | 'entry' | 'selectedEntry' | 'state';
+interface CalendarLabels extends ViewLabels {
+    previousMonth: string;
+    nextMonth: string;
+    today: string;
+    /** Overflow affordance. `{count}` is substituted. */
+    more: string;
+}
+interface CalendarViewProps<T> extends ViewBaseProps<T> {
+    /** Controlled month. Any date inside the month works. */
+    month?: Date;
+    /** Starting month when uncontrolled. Defaults to the month containing `now`. */
+    defaultMonth?: Date;
+    onMonthChange?: (month: Date) => void;
+    /**
+     * IANA zone the grid is drawn in, e.g. `America/New_York`. Defaults to the
+     * runtime's. A day boundary is a business fact, so state it explicitly when
+     * the collection belongs to somewhere other than the viewer.
+     */
+    timeZone?: string;
+    /** 1 = Monday … 7 = Sunday. Defaults to Monday. */
+    weekStartsOn?: number;
+    /** Locale for month, weekday and day-number formatting. */
+    locale?: string;
+    /** Entries to show per day before collapsing into "{count} more". */
+    maxPerDay?: number;
+    labels?: Partial<CalendarLabels>;
+    classNames?: Partial<Record<CalendarViewSlot, string>>;
+    /** Hide the month toolbar when the host renders its own. */
+    hideToolbar?: boolean;
+}
+
+/**
+ * Column width in time. `month` and `quarter` are what a roadmap is — the
+ * family has no separate RoadmapView, because it would be this component with
+ * wider columns.
+ */
+type GanttCadence = 'day' | 'week' | 'month' | 'quarter';
+type GanttViewSlot = 'header' | 'groupLabel' | 'row' | 'bar' | 'selectedBar' | 'state';
+interface GanttLabels extends ViewLabels {
+    /** Accessible name of the scrollable chart region. */
+    chart: string;
+    /** Footnote for records a time axis cannot place. `{count}` is substituted. */
+    undated: string;
+}
+interface GanttViewProps<T> extends ViewBaseProps<T> {
+    /** Column width in time. Defaults to `week`. */
+    cadence?: GanttCadence;
+    /** First column. Defaults to the earliest start in `items`. */
+    rangeStart?: Date;
+    /** Last column. Defaults to the latest end in `items`. */
+    rangeEnd?: Date;
+    /** Group rows into swimlanes by `accessors.getGroup`. */
+    groupByLane?: boolean;
+    timeZone?: string;
+    locale?: string;
+    labels?: Partial<GanttLabels>;
+    classNames?: Partial<Record<GanttViewSlot, string>>;
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+
+/**
+ * Every string any layout in the set can render.
+ *
+ * Each view extends `ViewLabels` with its own — the calendar's month arrows and
+ * "+n more", the board's move announcements, the Gantt's undated footnote. They
+ * are all shared props, so the per-view escape hatches below exclude `labels`;
+ * without widening here a non-English host could translate the common strings
+ * and nothing else, which would break the contract that every user-facing
+ * string is overridable. A view ignores the keys it does not know.
+ */
+type ViewSetLabels = Partial<CalendarLabels & BoardLabels & GanttLabels>;
+/**
+ * Props `ViewSet` passes to every layout itself, beyond `ViewBaseProps`. Named
+ * here so the per-view escape hatches below can exclude them by key rather than
+ * by a hand-kept list that would drift the moment a shared prop is added.
+ */
+type ViewSetOwned = 'stages' | 'onMove' | 'timeZone' | 'locale';
+type ViewOverrides<P, T> = Omit<Partial<P>, keyof ViewBaseProps<T> | ViewSetOwned>;
+interface ViewSetProps<T> extends ViewBaseProps<T> {
+    /** Every string any offered layout can render, not just the shared ones. */
+    labels?: ViewSetLabels;
+    /** Views to offer, in order. The first is the default when uncontrolled. */
+    views: readonly (ViewId | ViewOption)[];
+    view?: ViewId;
+    defaultView?: ViewId;
+    onViewChange?: (view: ViewId) => void;
+    /**
+     * Remembers the chosen view under this key. Ignored when `view` is
+     * controlled — a page with its own URL state should own it there instead.
+     */
+    storageKey?: string;
+    /** Stages for the board and for list grouping. */
+    stages?: readonly Stage[];
+    onMove?: BoardViewProps<T>['onMove'];
+    /**
+     * IANA zone the date views read day boundaries in. Shared, because a page
+     * showing one collection as a calendar and as a Gantt must place it on the
+     * same days in both.
+     */
+    timeZone?: string;
+    /** Locale for date formatting in the calendar and Gantt. */
+    locale?: string;
+    /** Rendered above the switcher row. */
+    toolbar?: React.ReactNode;
+    /** Rendered under the switcher row, above the view. */
+    filters?: React.ReactNode;
+    /** The `overview` view. Domain content — the library has no opinion on it. */
+    overview?: React.ReactNode;
+    /** The `table` view. A tabular collection is a grid, not a view component. */
+    table?: React.ReactNode;
+    /** Rendered beside the view, for a list-plus-detail layout. */
+    detail?: React.ReactNode;
+    /**
+     * Per-view escape hatches for props this shell does not surface. Shared props
+     * are excluded: one collection rendered several ways means switching view can
+     * never change the records, the selection or the load state.
+     *
+     * `ViewSetOwned` covers the props the shell passes itself but that are not on
+     * `ViewBaseProps`. They are spread after the shared ones, so leaving them open
+     * would let one layout carry different stages, a different mutation callback
+     * or a different time zone from its neighbours — the same collection quietly
+     * disagreeing with itself as you switch tabs.
+     */
+    listProps?: ViewOverrides<ListViewProps<T>, T>;
+    boardProps?: ViewOverrides<BoardViewProps<T>, T>;
+    calendarProps?: ViewOverrides<CalendarViewProps<T>, T>;
+    ganttProps?: ViewOverrides<GanttViewProps<T>, T>;
+    classNames?: Partial<Record<'toolbar' | 'switcher' | 'body' | 'detail', string>>;
+}
+/**
+ * The page-level composition: switcher, the enabled views, and the slots a page
+ * needs around them. It owns which view is showing and nothing else — items,
+ * selection and every mutation stay with the caller.
+ */
+declare function ViewSet<T>({ views, view, defaultView, onViewChange, storageKey, stages, onMove, toolbar, filters, overview, table, detail, listProps, boardProps, calendarProps, ganttProps, className, classNames, ...shared }: ViewSetProps<T>): react_jsx_runtime.JSX.Element;
+
+export { ViewSet, type ViewSetLabels, type ViewSetProps };

package/dist/components/ViewSet/index.d.ts

@@ -0,0 +1,300 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import * as React from 'react';
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * The contract every component in the `Modules/Views` family reads through.
+ *
+ * A page describes its collection once — which field is the id, the title, the
+ * status, the start date — and every view understands it. That is the whole
+ * reason the family exists: without it each view needs its own adapter and you
+ * end up re-implementing the same board per entity.
+ *
+ * Views are headless. Nothing here fetches, subscribes, or navigates.
+ * See CONTRIBUTING → "Modules: headless data components".
+ */
+
+/**
+ * Which layout is on screen. `overview` and `table` are rendered by the host
+ * through `ViewSet` slots rather than by a component in this family — a tabular
+ * collection is `DataVisNitroGrid`, and an overview is domain content.
+ */
+type ViewId = 'overview' | 'list' | 'board' | 'calendar' | 'gantt' | 'roadmap' | 'table';
+/**
+ * A semantic colour name, resolved to `--mieweb-*` tokens by each view.
+ *
+ * Accessors return one of these rather than a class string so a caller cannot
+ * hardcode a palette that breaks under another brand or in dark mode.
+ */
+type Accent = 'primary' | 'success' | 'warning' | 'destructive' | 'info' | 'neutral';
+/** A named stage: a board column, and the segments of a stage bar. */
+interface Stage {
+    id: string;
+    label: string;
+    accent?: Accent;
+}
+/**
+ * How a view reads one item. Only `getId` and `getTitle` are always required;
+ * each view documents which of the rest it needs (a board needs `getStatus`, a
+ * Gantt needs `getStart`) and renders an explanatory empty state without them.
+ */
+interface ViewAccessors<T> {
+    getId: (item: T) => string;
+    getTitle: (item: T) => string;
+    /** Secondary line under the title. */
+    getSubtitle?: (item: T) => string | undefined;
+    /** Board column and list group; matched against `Stage['id']`. */
+    getStatus?: (item: T) => string;
+    /** Gantt bar start, calendar placement. */
+    getStart?: (item: T) => Date | string | null | undefined;
+    /** Gantt bar end, calendar span. Falls back to the start when absent. */
+    getEnd?: (item: T) => Date | string | null | undefined;
+    /** Swimlane in a roadmap, row group in a Gantt. */
+    getGroup?: (item: T) => string | undefined;
+    getAccent?: (item: T) => Accent;
+}
+/** Strings a view renders. Every one is overridable; the defaults are English. */
+interface ViewLabels {
+    /** Accessible name of the view switcher group. */
+    viewSwitcher: string;
+    loading: string;
+    empty: string;
+    error: string;
+    /** Action on the error state. */
+    retry: string;
+    /** Heading for the group a record with no status or group falls into. */
+    ungrouped: string;
+}
+/**
+ * Props every view accepts. Views are controlled: selection, the active view and
+ * filter state live in the page, and every change is handed back.
+ */
+interface ViewBaseProps<T> {
+    items: T[];
+    accessors: ViewAccessors<T>;
+    loading?: boolean;
+    error?: Error | null;
+    selectedId?: string | null;
+    /** Called when the user activates an item. */
+    onOpen?: (id: string, item: T) => void;
+    /** Return a URL to render each item as a real anchor — middle-clickable and crawlable. */
+    getHref?: (id: string, item: T) => string;
+    /** Render one item. Receives the active view so one function can serve several. */
+    renderItem?: (item: T, context: {
+        view: ViewId;
+    }) => React.ReactNode;
+    /** Replaces the built-in empty state. */
+    emptyState?: React.ReactNode;
+    labels?: Partial<ViewLabels>;
+    /** Pins "today" so stories, tests and visual snapshots stay deterministic. */
+    now?: Date;
+    className?: string;
+}
+
+interface ViewOption {
+    id: ViewId;
+    /** Overrides the built-in English label. */
+    label?: string;
+    /** Overrides the built-in icon. */
+    icon?: React.ComponentType<{
+        className?: string;
+        'aria-hidden'?: boolean;
+    }>;
+    disabled?: boolean;
+}
+
+type ListViewSlot = 'group' | 'groupHeader' | 'item' | 'selectedItem' | 'state';
+interface ListViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof itemVariants> {
+    /**
+     * Group rows by `accessors.getStatus`, using these stages for order and
+     * labels. Items whose status matches no stage are appended under their own
+     * heading rather than dropped.
+     */
+    stages?: readonly Stage[];
+    /** Group by `accessors.getGroup` instead of by stage. */
+    groupBy?: 'status' | 'group' | 'none';
+    /** Groups that start collapsed. Uncontrolled; the user can reopen them. */
+    defaultCollapsedGroups?: readonly string[];
+    /** Retries the failed load. Renders the retry action only when provided. */
+    onRetry?: () => void;
+    classNames?: Partial<Record<ListViewSlot, string>>;
+    /** Heading level for group headers, under the page's own heading. */
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+declare const itemVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+    interactive?: boolean | null | undefined;
+    selected?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type BoardViewSlot = 'column' | 'columnHeader' | 'card' | 'selectedCard' | 'state';
+interface BoardLabels extends ViewLabels {
+    /** Accessible name of the scrollable board region. */
+    board: string;
+    /** Announced when a card starts moving. `{item}` and `{stage}` are substituted. */
+    moved: string;
+    /** Announced when `onMove` rejects. */
+    moveFailed: string;
+    /** Hint on a focusable card describing the keyboard move. */
+    moveHint: string;
+}
+interface BoardViewProps<T> extends ViewBaseProps<T>, VariantProps<typeof cardVariants> {
+    /** Columns, in order. A board without stages has nothing to draw. */
+    stages: readonly Stage[];
+    /**
+     * Commits a move. The board shows the card in its new column while this is
+     * pending and puts it back if the promise rejects, so the caller never has to
+     * re-render it home.
+     */
+    onMove?: (id: string, toStage: string, item: T) => void | Promise<void>;
+    labels?: Partial<BoardLabels>;
+    classNames?: Partial<Record<BoardViewSlot, string>>;
+    /** Heading level for column headers, under the page's own heading. */
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+declare const cardVariants: (props?: ({
+    density?: "comfortable" | "compact" | null | undefined;
+    interactive?: boolean | null | undefined;
+    selected?: boolean | null | undefined;
+    pending?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+
+type CalendarViewSlot = 'toolbar' | 'weekday' | 'day' | 'outsideDay' | 'today' | 'entry' | 'selectedEntry' | 'state';
+interface CalendarLabels extends ViewLabels {
+    previousMonth: string;
+    nextMonth: string;
+    today: string;
+    /** Overflow affordance. `{count}` is substituted. */
+    more: string;
+}
+interface CalendarViewProps<T> extends ViewBaseProps<T> {
+    /** Controlled month. Any date inside the month works. */
+    month?: Date;
+    /** Starting month when uncontrolled. Defaults to the month containing `now`. */
+    defaultMonth?: Date;
+    onMonthChange?: (month: Date) => void;
+    /**
+     * IANA zone the grid is drawn in, e.g. `America/New_York`. Defaults to the
+     * runtime's. A day boundary is a business fact, so state it explicitly when
+     * the collection belongs to somewhere other than the viewer.
+     */
+    timeZone?: string;
+    /** 1 = Monday … 7 = Sunday. Defaults to Monday. */
+    weekStartsOn?: number;
+    /** Locale for month, weekday and day-number formatting. */
+    locale?: string;
+    /** Entries to show per day before collapsing into "{count} more". */
+    maxPerDay?: number;
+    labels?: Partial<CalendarLabels>;
+    classNames?: Partial<Record<CalendarViewSlot, string>>;
+    /** Hide the month toolbar when the host renders its own. */
+    hideToolbar?: boolean;
+}
+
+/**
+ * Column width in time. `month` and `quarter` are what a roadmap is — the
+ * family has no separate RoadmapView, because it would be this component with
+ * wider columns.
+ */
+type GanttCadence = 'day' | 'week' | 'month' | 'quarter';
+type GanttViewSlot = 'header' | 'groupLabel' | 'row' | 'bar' | 'selectedBar' | 'state';
+interface GanttLabels extends ViewLabels {
+    /** Accessible name of the scrollable chart region. */
+    chart: string;
+    /** Footnote for records a time axis cannot place. `{count}` is substituted. */
+    undated: string;
+}
+interface GanttViewProps<T> extends ViewBaseProps<T> {
+    /** Column width in time. Defaults to `week`. */
+    cadence?: GanttCadence;
+    /** First column. Defaults to the earliest start in `items`. */
+    rangeStart?: Date;
+    /** Last column. Defaults to the latest end in `items`. */
+    rangeEnd?: Date;
+    /** Group rows into swimlanes by `accessors.getGroup`. */
+    groupByLane?: boolean;
+    timeZone?: string;
+    locale?: string;
+    labels?: Partial<GanttLabels>;
+    classNames?: Partial<Record<GanttViewSlot, string>>;
+    headingLevel?: 'h2' | 'h3' | 'h4';
+}
+
+/**
+ * Every string any layout in the set can render.
+ *
+ * Each view extends `ViewLabels` with its own — the calendar's month arrows and
+ * "+n more", the board's move announcements, the Gantt's undated footnote. They
+ * are all shared props, so the per-view escape hatches below exclude `labels`;
+ * without widening here a non-English host could translate the common strings
+ * and nothing else, which would break the contract that every user-facing
+ * string is overridable. A view ignores the keys it does not know.
+ */
+type ViewSetLabels = Partial<CalendarLabels & BoardLabels & GanttLabels>;
+/**
+ * Props `ViewSet` passes to every layout itself, beyond `ViewBaseProps`. Named
+ * here so the per-view escape hatches below can exclude them by key rather than
+ * by a hand-kept list that would drift the moment a shared prop is added.
+ */
+type ViewSetOwned = 'stages' | 'onMove' | 'timeZone' | 'locale';
+type ViewOverrides<P, T> = Omit<Partial<P>, keyof ViewBaseProps<T> | ViewSetOwned>;
+interface ViewSetProps<T> extends ViewBaseProps<T> {
+    /** Every string any offered layout can render, not just the shared ones. */
+    labels?: ViewSetLabels;
+    /** Views to offer, in order. The first is the default when uncontrolled. */
+    views: readonly (ViewId | ViewOption)[];
+    view?: ViewId;
+    defaultView?: ViewId;
+    onViewChange?: (view: ViewId) => void;
+    /**
+     * Remembers the chosen view under this key. Ignored when `view` is
+     * controlled — a page with its own URL state should own it there instead.
+     */
+    storageKey?: string;
+    /** Stages for the board and for list grouping. */
+    stages?: readonly Stage[];
+    onMove?: BoardViewProps<T>['onMove'];
+    /**
+     * IANA zone the date views read day boundaries in. Shared, because a page
+     * showing one collection as a calendar and as a Gantt must place it on the
+     * same days in both.
+     */
+    timeZone?: string;
+    /** Locale for date formatting in the calendar and Gantt. */
+    locale?: string;
+    /** Rendered above the switcher row. */
+    toolbar?: React.ReactNode;
+    /** Rendered under the switcher row, above the view. */
+    filters?: React.ReactNode;
+    /** The `overview` view. Domain content — the library has no opinion on it. */
+    overview?: React.ReactNode;
+    /** The `table` view. A tabular collection is a grid, not a view component. */
+    table?: React.ReactNode;
+    /** Rendered beside the view, for a list-plus-detail layout. */
+    detail?: React.ReactNode;
+    /**
+     * Per-view escape hatches for props this shell does not surface. Shared props
+     * are excluded: one collection rendered several ways means switching view can
+     * never change the records, the selection or the load state.
+     *
+     * `ViewSetOwned` covers the props the shell passes itself but that are not on
+     * `ViewBaseProps`. They are spread after the shared ones, so leaving them open
+     * would let one layout carry different stages, a different mutation callback
+     * or a different time zone from its neighbours — the same collection quietly
+     * disagreeing with itself as you switch tabs.
+     */
+    listProps?: ViewOverrides<ListViewProps<T>, T>;
+    boardProps?: ViewOverrides<BoardViewProps<T>, T>;
+    calendarProps?: ViewOverrides<CalendarViewProps<T>, T>;
+    ganttProps?: ViewOverrides<GanttViewProps<T>, T>;
+    classNames?: Partial<Record<'toolbar' | 'switcher' | 'body' | 'detail', string>>;
+}
+/**
+ * The page-level composition: switcher, the enabled views, and the slots a page
+ * needs around them. It owns which view is showing and nothing else — items,
+ * selection and every mutation stay with the caller.
+ */
+declare function ViewSet<T>({ views, view, defaultView, onViewChange, storageKey, stages, onMove, toolbar, filters, overview, table, detail, listProps, boardProps, calendarProps, ganttProps, className, classNames, ...shared }: ViewSetProps<T>): react_jsx_runtime.JSX.Element;
+
+export { ViewSet, type ViewSetLabels, type ViewSetProps };

package/dist/components/ViewSet/index.js

@@ -0,0 +1,15 @@
+export { ViewSet } from '../../chunk-IYWG72DM.js';
+import '../../chunk-IT775BYG.js';
+import '../../chunk-4HC2IBOX.js';
+import '../../chunk-Y4QNLW7W.js';
+import '../../chunk-XBTKZCZF.js';
+import '../../chunk-XVW5DPPP.js';
+import '../../chunk-3YBS4WUQ.js';
+import '../../chunk-UA7E7PDS.js';
+import '../../chunk-BKSPDTX4.js';
+import '../../chunk-7YO7DNUV.js';
+import '../../chunk-GVM6DTR5.js';
+import '../../chunk-TQONQSJO.js';
+import '../../chunk-PX6F3LHL.js';
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/components/ViewSet/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}

package/dist/components/ViewSwitcher/index.cjs

@@ -0,0 +1,20 @@
+'use strict';
+
+var chunkXDIMTPZU_cjs = require('../../chunk-XDIMTPZU.cjs');
+require('../../chunk-4NCDU5IG.cjs');
+require('../../chunk-L7L5S2HO.cjs');
+require('../../chunk-S5RVSXDV.cjs');
+require('../../chunk-EUAMEVVI.cjs');
+
+
+
+Object.defineProperty(exports, "ViewSwitcher", {
+  enumerable: true,
+  get: function () { return chunkXDIMTPZU_cjs.ViewSwitcher; }
+});
+Object.defineProperty(exports, "viewSwitcherVariants", {
+  enumerable: true,
+  get: function () { return chunkXDIMTPZU_cjs.viewSwitcherVariants; }
+});
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/components/ViewSwitcher/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.cjs"}