@synopackageland/ui 0.20.3 → 0.20.5

package/dist/components/primitives/pagination/Pagination.vue.d.ts

@@ -29,7 +29,8 @@ type __VLS_Props = {
     showTotal?: boolean;
     /** Page-size choices; `false` hides the selector. Bind `v-model:page-size` to follow it. */
     itemsPerPage?: false | PaginationPageSizeOption[];
-    mode?: 'normal' | 'less';
+    /** `phone` is the `‹ Page 1 of N ›` pager with its page sheet; an app 640px or narrower uses it whatever the mode. */
+    mode?: 'normal' | 'less' | 'phone';
     hasFirstBtn?: boolean;
     hasLastBtn?: boolean;
     /** Unknown total: no page numbers and no totals, only previous/next. */
@@ -54,13 +55,25 @@ declare var __VLS_1: {
     pageCount: number;
     start: number;
     end: number;
-}, __VLS_59: {}, __VLS_81: {};
+}, __VLS_33: {}, __VLS_48: {}, __VLS_58: {
+    total: number;
+    page: number;
+    pageCount: number;
+    start: number;
+    end: number;
+}, __VLS_116: {}, __VLS_138: {};
 type __VLS_Slots = {} & {
     total?: (props: typeof __VLS_1) => any;
 } & {
-    right?: (props: typeof __VLS_59) => any;
+    right?: (props: typeof __VLS_33) => any;
+} & {
+    'right-wrapper'?: (props: typeof __VLS_48) => any;
+} & {
+    total?: (props: typeof __VLS_58) => any;
+} & {
+    right?: (props: typeof __VLS_116) => any;
 } & {
-    'right-wrapper'?: (props: typeof __VLS_81) => any;
+    'right-wrapper'?: (props: typeof __VLS_138) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     focusPrevious: () => void;
@@ -80,23 +93,23 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
 }>, {
     modelValue: number;
     end: string | number;
-    mode: "normal" | "less";
+    mode: "normal" | "less" | "phone";
     labels: Partial<PaginationLabels>;
     start: string | number;
+    hasNext: boolean;
     refresh: boolean;
-    total: string | number;
+    endless: boolean;
     pageSize: number;
-    hasNext: boolean;
+    itemsPerPage: false | PaginationPageSizeOption[];
+    total: string | number;
     hasPrev: boolean;
     selectedCount: string | number;
     filteredCount: string | number;
     switchPage: boolean;
     pageShiftUnit: number;
     showTotal: boolean;
-    itemsPerPage: false | PaginationPageSizeOption[];
     hasFirstBtn: boolean;
     hasLastBtn: boolean;
-    endless: boolean;
     autoLess: boolean;
     lessWidth: number;
     maxPageButtons: number;

package/dist/components/primitives/pagination/PaginationSheet.vue.d.ts

@@ -0,0 +1,27 @@
+type __VLS_Props = {
+    open: boolean;
+    page: number;
+    pageCount: number;
+    /** Unknown total: no page field, only the sizes. */
+    endless: boolean;
+    pageSize: number;
+    sizes: {
+        label: string;
+        value: string;
+    }[];
+    title: string;
+    hint: string;
+    go: string;
+    itemsPerPage: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:open": (open: boolean) => any;
+    page: (page: number) => any;
+    pageSize: (value: string) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((open: boolean) => any) | undefined;
+    onPage?: ((page: number) => any) | undefined;
+    onPageSize?: ((value: string) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/primitives/pagination/labels.d.ts

@@ -12,6 +12,12 @@ export type PaginationLabels = {
     /** Accessible name of an inactive page button. */
     goToPage: (page: number) => string;
     itemsPerPage: string;
+    /** The phone pager's middle label, `Page 1 of 24`; it opens the page sheet. */
+    pageOf: (page: number, pageCount: number) => string;
+    /** Title of the phone page sheet and its page field. */
+    goToPageTitle: string;
+    /** The page sheet's confirm button. */
+    go: string;
     /** Templates for `totalTextMode`; `{total}`, `{start}`, `{end}`, `{filteredCount}` and `{selectedCount}` are replaced. */
     totalText: Record<PaginationTotalTextMode, string>;
 };

package/dist/components/primitives/popover/Popover.vue.d.ts

@@ -1,25 +1,33 @@
+import { OverlayMotion } from './overlay';
 type __VLS_Props = {
     /** Controlled open state (`v-model:open`), so the caller can close it after a pick or open it from elsewhere. */
     open?: boolean;
     side?: 'top' | 'right' | 'bottom' | 'left';
     align?: 'start' | 'center' | 'end';
     width?: string;
+    /** `none` drops the open and close motion (a grid editor's list); inherits `provideOverlayMotion`. */
+    motion?: OverlayMotion;
 };
-declare var __VLS_16: {}, __VLS_30: {};
+declare var __VLS_16: {}, __VLS_34: {};
 type __VLS_Slots = {} & {
     trigger?: (props: typeof __VLS_16) => any;
 } & {
-    default?: (props: typeof __VLS_30) => any;
+    default?: (props: typeof __VLS_34) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    openAutoFocus: (event: Event) => any;
+    closeAutoFocus: (event: Event) => any;
     "update:open": (value: boolean) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onOpenAutoFocus?: ((event: Event) => any) | undefined;
+    onCloseAutoFocus?: ((event: Event) => any) | undefined;
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
 }>, {
+    open: boolean;
     width: string;
     side: "top" | "right" | "bottom" | "left";
     align: "start" | "center" | "end";
-    open: boolean;
+    motion: OverlayMotion;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/primitives/popover/floating.d.ts

@@ -0,0 +1,27 @@
+import { MaybeRefOrGetter } from 'vue';
+/** Room kept between a popup and the edge of its boundary. */
+export declare const FLOATING_GAP = 8;
+/** The largest a popup may be: the room floating-ui found next to its anchor. */
+export declare const FLOATING_SIZE_CLASS = "max-w-[var(--reka-popper-available-width)] max-h-[var(--reka-popper-available-height)]";
+export interface FloatingPadding {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}
+/** 8px from each edge plus the safe area, and the soft keyboard at the bottom, as seen from `anchor`. */
+export declare function floatingPadding(anchor: Element | null | undefined): FloatingPadding;
+/**
+ * The collision props for a popup anchored at `anchor`, while `open`. The
+ * padding is read when it opens and again when the visual viewport changes
+ * (the keyboard opens or closes, the phone turns).
+ */
+export declare function useFloating(anchor: MaybeRefOrGetter<HTMLElement | null | undefined>, open: () => boolean): import('vue').ComputedRef<{
+    avoidCollisions: boolean;
+    collisionBoundary: HTMLElement | HTMLElement[];
+    collisionPadding: FloatingPadding;
+    sticky: "partial";
+    hideWhenDetached: boolean;
+}>;
+/** True on a touch-first device (no fine pointer), where a tap stands in for hover. */
+export declare function coarsePointer(): boolean;

package/dist/components/primitives/popover/overlay.d.ts

@@ -0,0 +1,36 @@
+import { MaybeRefOrGetter } from 'vue';
+/** `none`: the surface appears and leaves on the same frame (a grid editor's select, date or person list). */
+export type OverlayMotion = 'auto' | 'none';
+/** Popups opened inside this component (a grid cell editor) take `motion` unless they set their own. */
+export declare function provideOverlayMotion(motion: MaybeRefOrGetter<OverlayMotion>): void;
+/** The motion a popup uses: its own prop, else the nearest scope, else `auto`. */
+export declare function useOverlayMotion(own: () => OverlayMotion | undefined): () => OverlayMotion;
+/**
+ * True while an input method owns Escape: during composition, or the first
+ * Escape right after it ends (Safari sends compositionend first). One guard
+ * per window, kept for the window's life.
+ */
+export declare function imeOwnsEscape(event: KeyboardEvent): boolean;
+/** For a Reka `escapeKeyDown`: an Escape that cancels a composition never closes the surface. */
+export declare function keepEscapeForIme(event: KeyboardEvent): void;
+/**
+ * Joins an open popup to the interaction core's layer stack, so Escape closes
+ * only the topmost surface (a popup opened from a record panel or a grid
+ * editor closes before them) and a press inside the popup is never outside
+ * them. Returns the attributes for the popup's content element.
+ */
+export declare function useOverlayLayer(open: () => boolean, close: () => void): {
+    'data-ui-layer': string;
+    "data-ui-ignore-outside": string;
+};
+/**
+ * For a Reka `pointerDownOutside` / `interactOutside`: a press or focus inside
+ * a portal marked `data-ui-ignore-outside` (a grid editor, a popup another
+ * surface opened) belongs to that surface and never dismisses this one.
+ */
+export declare function keepForIgnoredPortal(event: Event): void;
+/**
+ * For a Reka `openAutoFocus`: with a coarse pointer the surface takes no
+ * initial focus (interaction-spec §14), so a soft keyboard does not cover it.
+ */
+export declare function skipAutoFocusOnTouch(event: Event): void;

package/dist/components/primitives/segment-control/SegmentControl.vue.d.ts

@@ -1,4 +1,4 @@
-import { SegmentVariant } from './context';
+import { SegmentSize, SegmentVariant } from './context';
 type __VLS_Props = {
     /** Selected item value. */
     modelValue?: string;
@@ -10,6 +10,8 @@ type __VLS_Props = {
     disabled?: boolean;
     /** Toolbar view switcher; use RadioGroup for form choices. `sheet` draws joined tabs on a rule. */
     variant?: SegmentVariant;
+    /** `sm` draws a 32px track of 24px tabs (12px labels), the selected one raised on the surface, for a panel's surface switch. Only for `variant="segment"`. */
+    size?: SegmentSize;
 };
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -22,6 +24,7 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {},
     onChange?: ((value: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string) => any) | undefined;
 }>, {
+    size: SegmentSize;
     variant: SegmentVariant;
     disabled: boolean;
     modelValue: string;

package/dist/components/primitives/segment-control/context.d.ts

@@ -8,10 +8,13 @@ export type SegmentItemHandle = {
 export type SegmentMove = 'previous' | 'next' | 'first' | 'last';
 /** `segment`: a segmented control; `sheet`: joined sheet tabs on a rule, the selected one open to the content below. */
 export type SegmentVariant = 'segment' | 'sheet';
+/** `md`: the toolbar switch; `sm`: a 32px track of 24px tabs that switches the surfaces of a panel (an aside's tabs). */
+export type SegmentSize = 'md' | 'sm';
 export type SegmentControlContext = {
     selected: Ref<string>;
     groupDisabled: Ref<boolean>;
     variant: Ref<SegmentVariant>;
+    size: Ref<SegmentSize>;
     select: (value: string) => void;
     register: (handle: SegmentItemHandle) => void;
     unregister: (handle: SegmentItemHandle) => void;

package/dist/components/primitives/select/Select.vue.d.ts

@@ -1,4 +1,5 @@
 import { SelectOptions, SelectSearch } from './internal/types';
+import { OverlayMotion } from '../popover/overlay';
 export type SelectOption = {
     label: string;
     value: string;
@@ -15,6 +16,8 @@ type __VLS_Props = {
     searchPlaceholder?: string;
     notFoundText?: string;
     loadingText?: string;
+    /** `none` drops the list's open and close motion (a grid editor); inherits `provideOverlayMotion`. */
+    motion?: OverlayMotion;
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     "update:modelValue": (value: string) => any;
@@ -26,6 +29,7 @@ declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {
     options: SelectOptions;
     minSearchChar: number;
     caseSensitive: boolean;
+    motion: OverlayMotion;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/primitives/select/internal/ComboboxField.vue.d.ts

@@ -2,21 +2,21 @@ import { SelectFieldProps, SelectOption } from './types';
 declare const __VLS_export: import('vue').DefineComponent<SelectFieldProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     select: (option: SelectOption) => any;
     blur: (event: FocusEvent) => any;
+    focus: (event: FocusEvent) => any;
     invalid: (text: string) => any;
     "update:modelValue": (value: string | string[]) => any;
-    focus: (event: FocusEvent) => any;
-    "update:loading": (loading: boolean) => any;
     create: (value: string) => any;
+    "update:loading": (loading: boolean) => any;
     "open-dropdown": () => any;
     "close-dropdown": () => any;
 }, string, import('vue').PublicProps, Readonly<SelectFieldProps> & Readonly<{
     onSelect?: ((option: SelectOption) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
     onInvalid?: ((text: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string | string[]) => any) | undefined;
-    onFocus?: ((event: FocusEvent) => any) | undefined;
-    "onUpdate:loading"?: ((loading: boolean) => any) | undefined;
     onCreate?: ((value: string) => any) | undefined;
+    "onUpdate:loading"?: ((loading: boolean) => any) | undefined;
     "onOpen-dropdown"?: (() => any) | undefined;
     "onClose-dropdown"?: (() => any) | undefined;
 }>, {
@@ -28,9 +28,10 @@ declare const __VLS_export: import('vue').DefineComponent<SelectFieldProps, {},
     ariaLabelledby: string;
     defaultValue: string | string[];
     options: import('./types').SelectOptions;
+    multiple: boolean;
     minSearchChar: number;
     caseSensitive: boolean;
-    multiple: boolean;
+    motion: "auto" | "none";
     allowCreate: import('./types').SelectAllowCreate;
     editable: boolean;
     clearable: boolean;

package/dist/components/primitives/select/internal/SelectSheet.vue.d.ts

@@ -0,0 +1,42 @@
+import { SelectGroup } from './options';
+type __VLS_Props = {
+    open: boolean;
+    title?: string;
+    groups: SelectGroup[];
+    /** The chosen value, or values with `multiple`. */
+    value?: string | string[];
+    multiple?: boolean;
+    /** Shows the search field. */
+    search?: boolean;
+    query?: string;
+    searchPlaceholder?: string;
+    loading?: boolean;
+    loadingText?: string;
+    notFoundText?: string;
+    /** A last row that adds what was typed, e.g. `Add "Lisbon"`. */
+    createText?: string;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    "update:open": (value: boolean) => any;
+    "update:query": (value: string) => any;
+    pick: (value: string) => any;
+    create: () => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+    "onUpdate:query"?: ((value: string) => any) | undefined;
+    onPick?: ((value: string) => any) | undefined;
+    onCreate?: (() => any) | undefined;
+}>, {
+    search: boolean;
+    title: string;
+    loading: boolean;
+    value: string | string[];
+    multiple: boolean;
+    query: string;
+    searchPlaceholder: string;
+    loadingText: string;
+    notFoundText: string;
+    createText: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/primitives/select/internal/types.d.ts

@@ -41,4 +41,6 @@ export type SelectFieldProps = {
     openLabel?: string;
     clearLabel?: string;
     removeTagLabel?: (label: string) => string;
+    /** `none` drops the list's open and close motion (a grid editor); inherits `provideOverlayMotion`. */
+    motion?: 'auto' | 'none';
 };

package/dist/components/primitives/sheet/BottomSheet.vue.d.ts

@@ -0,0 +1,69 @@
+/** `auto` fits the content up to 92%; `large` is 92% (a strip of the page stays, a tap there closes); `full` fills the screen. Any other value is a CSS height, capped at 92%. */
+export type BottomSheetHeight = 'auto' | 'large' | 'full' | (string & {});
+type __VLS_Props = {
+    open?: boolean;
+    defaultOpen?: boolean;
+    title?: string;
+    description?: string;
+    height?: BottomSheetHeight;
+    /** Resting points as fractions of the screen (or px), e.g. `[0.5, 0.92]`. */
+    snapPoints?: (number | string)[];
+    closeLabel?: string;
+    showClose?: boolean;
+    /** `false` keeps the sheet open on a press outside it. */
+    closeOnOutside?: boolean;
+    /** `false` leaves the page usable behind the sheet: no scrim, scroll lock or focus trap. */
+    modal?: boolean;
+    /** The mask behind: `dim` (default), `light` or `none`. */
+    scrim?: 'dim' | 'light' | 'none';
+    /** Drops the body's padding and scrolling, for content that scrolls itself. */
+    flush?: boolean;
+    /** Asks "Discard changes?" before a swipe, Back, Escape, an outside press or the close button closes it (set while a form is dirty). */
+    confirmClose?: boolean;
+    /** Whether Back closes the sheet. Default: on a phone. */
+    backDismiss?: boolean;
+};
+declare var __VLS_16: {}, __VLS_71: {}, __VLS_90: {}, __VLS_98: {};
+type __VLS_Slots = {} & {
+    trigger?: (props: typeof __VLS_16) => any;
+} & {
+    header?: (props: typeof __VLS_71) => any;
+} & {
+    default?: (props: typeof __VLS_90) => any;
+} & {
+    footer?: (props: typeof __VLS_98) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    escapeKeyDown: (event: KeyboardEvent) => any;
+    pointerDownOutside: (event: Event) => any;
+    interactOutside: (event: Event) => any;
+    openAutoFocus: (event: Event) => any;
+    closeAutoFocus: (event: Event) => any;
+    "update:open": (value: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onEscapeKeyDown?: ((event: KeyboardEvent) => any) | undefined;
+    onPointerDownOutside?: ((event: Event) => any) | undefined;
+    onInteractOutside?: ((event: Event) => any) | undefined;
+    onOpenAutoFocus?: ((event: Event) => any) | undefined;
+    onCloseAutoFocus?: ((event: Event) => any) | undefined;
+    "onUpdate:open"?: ((value: boolean) => any) | undefined;
+}>, {
+    height: BottomSheetHeight;
+    open: boolean;
+    flush: boolean;
+    defaultOpen: boolean;
+    modal: boolean;
+    showClose: boolean;
+    closeOnOutside: boolean;
+    scrim: "dim" | "light" | "none";
+    confirmClose: boolean;
+    backDismiss: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/primitives/sheet/Sheet.vue.d.ts

@@ -2,7 +2,9 @@ type SheetSide = 'left' | 'right' | 'top' | 'bottom';
 type __VLS_Props = {
     open?: boolean;
     defaultOpen?: boolean;
+    /** `bottom` is the BottomSheet: a grabber, swipe down to close, keyboard aware. */
     side?: SheetSide;
+    /** The width of a side sheet, or the height of a top or bottom one. Without it a bottom sheet fits its content. */
     size?: string;
     title?: string;
     description?: string;
@@ -16,13 +18,19 @@ type __VLS_Props = {
     /** Whether a press outside closes the sheet. Defaults to `modal`: a non-modal sheet stays while the page behind is used. */
     closeOnOutside?: boolean;
 };
-declare var __VLS_14: {}, __VLS_62: {}, __VLS_70: {};
+declare var __VLS_15: {}, __VLS_17: {}, __VLS_20: {}, __VLS_35: {}, __VLS_83: {}, __VLS_91: {};
 type __VLS_Slots = {} & {
-    trigger?: (props: typeof __VLS_14) => any;
+    trigger?: (props: typeof __VLS_15) => any;
 } & {
-    default?: (props: typeof __VLS_62) => any;
+    default?: (props: typeof __VLS_17) => any;
 } & {
-    footer?: (props: typeof __VLS_70) => any;
+    footer?: (props: typeof __VLS_20) => any;
+} & {
+    trigger?: (props: typeof __VLS_35) => any;
+} & {
+    default?: (props: typeof __VLS_83) => any;
+} & {
+    footer?: (props: typeof __VLS_91) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     escapeKeyDown: (event: KeyboardEvent) => any;
@@ -40,9 +48,9 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {},
     "onUpdate:open"?: ((value: boolean) => any) | undefined;
 }>, {
     size: string;
+    open: boolean;
     side: SheetSide;
     defaultOpen: boolean;
-    open: boolean;
     modal: boolean;
     closeOnOutside: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;

package/dist/components/primitives/sheet/phone.d.ts

@@ -0,0 +1,7 @@
+import { ComputedRef } from 'vue';
+/**
+ * True when the surface opens on a phone: the app's container is 640px or
+ * narrower (AppRoot/AppLayout presentation `mobile`). Outside an app root the
+ * viewport width decides instead. Call it in a component's setup.
+ */
+export declare function usePhonePresentation(): ComputedRef<boolean>;

package/dist/components/primitives/skeleton/SectionSkeleton.vue.d.ts

@@ -1,14 +1,35 @@
 type __VLS_Props = {
-    variant?: 'lines' | 'figures' | 'rows';
+    variant?: 'lines' | 'figures' | 'rows' | 'grid' | 'cards' | 'fields';
     /** The number of lines (`lines`). */
     lines?: number;
-    /** The number of figures or rows (`figures`, `rows`). */
+    /** The number of figures, rows, cards or fields. */
     count?: number;
+    /** A row's height (`rows`, `grid`); a grid defaults to `--ui-grid-row-height`. */
+    rowHeight?: string;
+    /** `grid`: the number of equal columns, or each column's CSS width (`auto` takes the rest). */
+    columns?: number | readonly string[];
+    /** `grid`: false leaves out the header row. */
+    header?: boolean;
+    /** `cards`: a card's height, as the real card computes it. */
+    cardHeight?: string;
+    /** `cards`: the CardGrid's `minItemWidth`, `gap` and `fit`. */
+    cardMinWidth?: string;
+    gap?: string;
+    fit?: 'stretch' | 'fill';
+    /** Milliseconds before the shapes show; the reserved box shows at once. */
+    delay?: number;
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    variant: "lines" | "figures" | "rows";
-    lines: number;
+    header: boolean;
+    variant: "lines" | "figures" | "rows" | "grid" | "cards" | "fields";
+    delay: number;
     count: number;
+    gap: string;
+    fit: "stretch" | "fill";
+    lines: number;
+    columns: number | readonly string[];
+    cardHeight: string;
+    cardMinWidth: string;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/primitives/skeleton/Skeleton.vue.d.ts

@@ -2,11 +2,14 @@ type __VLS_Props = {
     width?: string;
     height?: string;
     radius?: string;
+    /** False for a still shape, as a grid placeholder is. */
+    pulse?: boolean;
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
     height: string;
     width: string;
     radius: string;
+    pulse: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 export default _default;

package/dist/components/primitives/superbox-select/SuperboxSelect.vue.d.ts

@@ -6,21 +6,21 @@ type __VLS_Props = Omit<SelectFieldProps, 'multiple' | 'modelValue' | 'defaultVa
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     select: (option: SelectOption) => any;
     blur: (event: FocusEvent) => any;
+    focus: (event: FocusEvent) => any;
     invalid: (text: string) => any;
     "update:modelValue": (value: string[]) => any;
-    focus: (event: FocusEvent) => any;
-    "update:loading": (loading: boolean) => any;
     create: (value: string) => any;
+    "update:loading": (loading: boolean) => any;
     "open-dropdown": () => any;
     "close-dropdown": () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onSelect?: ((option: SelectOption) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
     onInvalid?: ((text: string) => any) | undefined;
     "onUpdate:modelValue"?: ((value: string[]) => any) | undefined;
-    onFocus?: ((event: FocusEvent) => any) | undefined;
-    "onUpdate:loading"?: ((loading: boolean) => any) | undefined;
     onCreate?: ((value: string) => any) | undefined;
+    "onUpdate:loading"?: ((loading: boolean) => any) | undefined;
     "onOpen-dropdown"?: (() => any) | undefined;
     "onClose-dropdown"?: (() => any) | undefined;
 }>, {

package/dist/components/primitives/tag/Tag.vue.d.ts

@@ -37,11 +37,11 @@ type __VLS_Slots = {} & {
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     measure: typeof measure;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    remove: () => any;
     click: (event: MouseEvent | KeyboardEvent) => any;
+    remove: () => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
-    onRemove?: (() => any) | undefined;
     onClick?: ((event: MouseEvent | KeyboardEvent) => any) | undefined;
+    onRemove?: (() => any) | undefined;
 }>, {
     label: string;
     disabled: boolean;

package/dist/components/primitives/toast/ToastProvider.vue.d.ts

@@ -4,7 +4,6 @@ type __VLS_Props = {
     announcementLabel?: string;
     viewportLabel?: string;
     closeLabel?: string;
-    duration?: number;
     swipeDirection?: 'right' | 'left' | 'up' | 'down';
 };
 declare var __VLS_8: {};
@@ -12,7 +11,6 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_8) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, ToastController, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
-    duration: number;
     swipeDirection: "right" | "left" | "up" | "down";
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/components/primitives/toast/toast.d.ts

@@ -1,10 +1,22 @@
 import { InjectionKey } from 'vue';
-export type ToastTone = 'info' | 'success' | 'warning' | 'danger';
+import { FeedbackTone } from '../../../feedback/timing';
+export type ToastTone = FeedbackTone;
 export type ToastOptions = {
     title: string;
     description?: string;
     tone?: ToastTone;
+    /**
+     * Work in progress ("Deleting"): a spinner, no timer, and nothing shown
+     * unless it is still pending after 300 ms. Turn it into the result with
+     * `update` on the same id.
+     */
+    pending?: boolean;
+    /**
+     * Milliseconds it stays. By default success 3 s, info and warning 5 s, at
+     * least 5 s with an action, and danger until closed.
+     */
     duration?: number;
+    /** One action (Undo, Retry). A click runs `onAction` and closes the toast, unless `onAction` updated it. */
     actionLabel?: string;
     onAction?: () => void;
 };
@@ -14,12 +26,20 @@ export type ToastMessage = ToastOptions & {
 };
 export type ToastController = {
     show: (options: ToastOptions | string) => number;
+    /**
+     * Replaces what toast `id` says, in place: a pending toast becomes its
+     * result, an error becomes pending again on Retry. False when that toast
+     * has already closed.
+     */
+    update: (id: number, options: ToastOptions | string) => boolean;
     dismiss: (id: number) => void;
     clear: () => void;
     info: (title: string, description?: string) => number;
     success: (title: string, description?: string) => number;
     warning: (title: string, description?: string) => number;
     danger: (title: string, description?: string) => number;
+    /** A pending toast; see ToastOptions.pending. */
+    pending: (title: string, description?: string) => number;
 };
 export declare const toastControllerKey: InjectionKey<ToastController>;
 export declare function useToast(): ToastController;