@octans/ui 1.0.0 → 1.2.0

package/dist/components/FileInput/ItemList.vue.d.ts

@@ -40,6 +40,9 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             type: StringConstructor;
             default: string;
         };
+        timezone: {
+            type: StringConstructor;
+        };
     }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
         [key: string]: any;
     }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -59,6 +62,9 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             type: StringConstructor;
             default: string;
         };
+        timezone: {
+            type: StringConstructor;
+        };
     }>> & Readonly<{}>, {
         locale: string;
         currency: string;

package/dist/components/FileInput/pageDrop.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Whole-page file dropping, for `<FileInput dropOnPage>`.
+ *
+ * The page is a SINGLE target — there is one window, and a file dropped on it
+ * can only go to one place — so this is a claim, not a subscription. The first
+ * input to ask gets it; a second is refused and warned about, rather than both
+ * quietly receiving the same file or the last one to mount silently winning.
+ *
+ * The listeners live on `window` and are attached only while someone holds the
+ * claim, so a page with no `dropOnPage` input pays nothing.
+ */
+export interface PageDropHandlers {
+    /** Fires when a file drag enters or leaves the page entirely. */
+    onDragChange(dragging: boolean): void;
+    onDrop(files: FileList): void;
+}
+/**
+ * Claims the page for `token`. Returns `false` — and warns — when another
+ * input already holds it, in which case that input keeps the page and this
+ * one behaves as though `dropOnPage` were not set.
+ */
+export declare function claimPageDrop(token: object, next: PageDropHandlers): boolean;
+export declare function releasePageDrop(token: object): void;

package/dist/components/Filters/FilterActions.vue.d.ts

@@ -53,7 +53,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             hide: () => any;
             close: () => any;
         }, import('vue').PublicProps, {
-            placement: import('../Popper').PopperPlacementType;
+            placement: import('../Popover').PopoverPlacementType;
             items: import('../ActionList').ActionListItemType[];
         }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
             P: {};
@@ -67,7 +67,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             onHide?: (() => any) | undefined;
             onClose?: (() => any) | undefined;
         }>, {}, {}, {}, {}, {
-            placement: import('../Popper').PopperPlacementType;
+            placement: import('../Popover').PopoverPlacementType;
             items: import('../ActionList').ActionListItemType[];
         }>;
         __isFragment?: never;
@@ -82,7 +82,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         hide: () => any;
         close: () => any;
     }, string, {
-        placement: import('../Popper').PopperPlacementType;
+        placement: import('../Popover').PopoverPlacementType;
         items: import('../ActionList').ActionListItemType[];
     }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
         $slots: {
@@ -142,6 +142,14 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             type: BooleanConstructor;
             default: boolean;
         };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        pressed: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
     }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
         [key: string]: any;
     }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -197,16 +205,26 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             type: BooleanConstructor;
             default: boolean;
         };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        pressed: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
     }>> & Readonly<{}>, {
         disabled: boolean;
         size: string;
         type: import('../types').ActionTypeType;
         destructive: boolean;
+        loading: boolean;
         tooltipPosition: import('../types').ActionTooltipPositionType;
         external: boolean;
         dropdown: boolean;
         fullWidth: boolean;
         invert: boolean;
+        pressed: boolean;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
     ButtonGroup: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
         segmented: {

package/dist/components/Filters/FilterItem.vue.d.ts

@@ -81,6 +81,14 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             type: BooleanConstructor;
             default: boolean;
         };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        pressed: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
     }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
         [key: string]: any;
     }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -136,16 +144,26 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             type: BooleanConstructor;
             default: boolean;
         };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        pressed: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
     }>> & Readonly<{}>, {
         disabled: boolean;
         size: string;
         type: import('../types').ActionTypeType;
         destructive: boolean;
+        loading: boolean;
         tooltipPosition: import('../types').ActionTooltipPositionType;
         external: boolean;
         dropdown: boolean;
         fullWidth: boolean;
         invert: boolean;
+        pressed: boolean;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
     DatePicker: import('vue').DefineComponent<import('../DatePicker').DatePickerProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
         "update:modelValue": (v: string | null) => any;
@@ -246,6 +264,10 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         helpLink: {
             type: import('vue').PropType<string | false | null>;
         };
+        required: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
         modelValue: {
             type: any;
         };
@@ -416,6 +438,10 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         helpLink: {
             type: import('vue').PropType<string | false | null>;
         };
+        required: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
         modelValue: {
             type: any;
         };
@@ -505,6 +531,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     }>, {
         disabled: boolean;
         loading: boolean;
+        required: boolean;
         modelValue: any;
         placeholder: string;
         readonly: boolean;
@@ -667,7 +694,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
                 remove: () => any;
             }, import('vue').PublicProps, {
-                tooltipPosition: import('../Popper').PopperPlacementType;
+                tooltipPosition: import('../Popover').PopoverPlacementType;
                 required: boolean;
             }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
                 P: {};
@@ -679,7 +706,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             }, Readonly<import('../Tag/Tag.vue').TagProps> & Readonly<{
                 onRemove?: (() => any) | undefined;
             }>, {}, {}, {}, {}, {
-                tooltipPosition: import('../Popper').PopperPlacementType;
+                tooltipPosition: import('../Popover').PopoverPlacementType;
                 required: boolean;
             }>;
             __isFragment?: never;
@@ -690,7 +717,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
             remove: () => any;
         }, string, {
-            tooltipPosition: import('../Popper').PopperPlacementType;
+            tooltipPosition: import('../Popover').PopoverPlacementType;
             required: boolean;
         }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
             $slots: {

package/dist/components/Filters/Filters.vue.d.ts

@@ -286,6 +286,14 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             type: BooleanConstructor;
             default: boolean;
         };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        pressed: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
     }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
         [key: string]: any;
     }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -341,16 +349,26 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             type: BooleanConstructor;
             default: boolean;
         };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        pressed: {
+            type: BooleanConstructor;
+            default: undefined;
+        };
     }>> & Readonly<{}>, {
         disabled: boolean;
         size: string;
         type: import('../types').ActionTypeType;
         destructive: boolean;
+        loading: boolean;
         tooltipPosition: import('../types').ActionTooltipPositionType;
         external: boolean;
         dropdown: boolean;
         fullWidth: boolean;
         invert: boolean;
+        pressed: boolean;
     }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
     FilterActions: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
         filters: {
@@ -404,7 +422,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
                 hide: () => any;
                 close: () => any;
             }, import('vue').PublicProps, {
-                placement: import('../Popper').PopperPlacementType;
+                placement: import('../Popover').PopoverPlacementType;
                 items: ActionListItemType[];
             }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
                 P: {};
@@ -418,7 +436,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
                 onHide?: (() => any) | undefined;
                 onClose?: (() => any) | undefined;
             }>, {}, {}, {}, {}, {
-                placement: import('../Popper').PopperPlacementType;
+                placement: import('../Popover').PopoverPlacementType;
                 items: ActionListItemType[];
             }>;
             __isFragment?: never;
@@ -433,7 +451,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             hide: () => any;
             close: () => any;
         }, string, {
-            placement: import('../Popper').PopperPlacementType;
+            placement: import('../Popover').PopoverPlacementType;
             items: ActionListItemType[];
         }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
             $slots: {
@@ -493,6 +511,14 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
                 type: BooleanConstructor;
                 default: boolean;
             };
+            loading: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+            pressed: {
+                type: BooleanConstructor;
+                default: undefined;
+            };
         }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
             [key: string]: any;
         }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -548,16 +574,26 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
                 type: BooleanConstructor;
                 default: boolean;
             };
+            loading: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+            pressed: {
+                type: BooleanConstructor;
+                default: undefined;
+            };
         }>> & Readonly<{}>, {
             disabled: boolean;
             size: string;
             type: import('../types').ActionTypeType;
             destructive: boolean;
+            loading: boolean;
             tooltipPosition: import('../types').ActionTooltipPositionType;
             external: boolean;
             dropdown: boolean;
             fullWidth: boolean;
             invert: boolean;
+            pressed: boolean;
         }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
         ButtonGroup: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
             segmented: {
@@ -664,6 +700,14 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
                 type: BooleanConstructor;
                 default: boolean;
             };
+            loading: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+            pressed: {
+                type: BooleanConstructor;
+                default: undefined;
+            };
         }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
             [key: string]: any;
         }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -719,16 +763,26 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
                 type: BooleanConstructor;
                 default: boolean;
             };
+            loading: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
+            pressed: {
+                type: BooleanConstructor;
+                default: undefined;
+            };
         }>> & Readonly<{}>, {
             disabled: boolean;
             size: string;
             type: import('../types').ActionTypeType;
             destructive: boolean;
+            loading: boolean;
             tooltipPosition: import('../types').ActionTooltipPositionType;
             external: boolean;
             dropdown: boolean;
             fullWidth: boolean;
             invert: boolean;
+            pressed: boolean;
         }, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;
         DatePicker: import('vue').DefineComponent<import('../DatePicker').DatePickerProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
             "update:modelValue": (v: string | null) => any;
@@ -829,6 +883,10 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             helpLink: {
                 type: PropType<string | false | null>;
             };
+            required: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
             modelValue: {
                 type: any;
             };
@@ -999,6 +1057,10 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             helpLink: {
                 type: PropType<string | false | null>;
             };
+            required: {
+                type: BooleanConstructor;
+                default: boolean;
+            };
             modelValue: {
                 type: any;
             };
@@ -1088,6 +1150,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         }>, {
             disabled: boolean;
             loading: boolean;
+            required: boolean;
             modelValue: any;
             placeholder: string;
             readonly: boolean;
@@ -1250,7 +1313,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
                 }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
                     remove: () => any;
                 }, import('vue').PublicProps, {
-                    tooltipPosition: import('../Popper').PopperPlacementType;
+                    tooltipPosition: import('../Popover').PopoverPlacementType;
                     required: boolean;
                 }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
                     P: {};
@@ -1262,7 +1325,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
                 }, Readonly<import('../Tag/Tag.vue').TagProps> & Readonly<{
                     onRemove?: (() => any) | undefined;
                 }>, {}, {}, {}, {}, {
-                    tooltipPosition: import('../Popper').PopperPlacementType;
+                    tooltipPosition: import('../Popover').PopoverPlacementType;
                     required: boolean;
                 }>;
                 __isFragment?: never;
@@ -1273,7 +1336,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
             }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
                 remove: () => any;
             }, string, {
-                tooltipPosition: import('../Popper').PopperPlacementType;
+                tooltipPosition: import('../Popover').PopoverPlacementType;
                 required: boolean;
             }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
                 $slots: {
@@ -1443,7 +1506,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
             remove: () => any;
         }, import('vue').PublicProps, {
-            tooltipPosition: import('../Popper').PopperPlacementType;
+            tooltipPosition: import('../Popover').PopoverPlacementType;
             required: boolean;
         }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
             P: {};
@@ -1455,7 +1518,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         }, Readonly<import('../Tag/Tag.vue').TagProps> & Readonly<{
             onRemove?: (() => any) | undefined;
         }>, {}, {}, {}, {}, {
-            tooltipPosition: import('../Popper').PopperPlacementType;
+            tooltipPosition: import('../Popover').PopoverPlacementType;
             required: boolean;
         }>;
         __isFragment?: never;
@@ -1466,7 +1529,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     }>, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
         remove: () => any;
     }, string, {
-        tooltipPosition: import('../Popper').PopperPlacementType;
+        tooltipPosition: import('../Popover').PopoverPlacementType;
         required: boolean;
     }, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
         $slots: {

package/dist/components/Formatter/Formatter.vue.d.ts

@@ -17,6 +17,15 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         type: StringConstructor;
         default: string;
     };
+    /**
+     * IANA time zone to render a date in, e.g. `America/Los_Angeles`.
+     *
+     * Usually you want `setTimezone` instead — one call at app start and
+     * every date in the app follows. This is the per-instance override.
+     */
+    timezone: {
+        type: StringConstructor;
+    };
 }>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
     [key: string]: any;
 }>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
@@ -36,6 +45,15 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         type: StringConstructor;
         default: string;
     };
+    /**
+     * IANA time zone to render a date in, e.g. `America/Los_Angeles`.
+     *
+     * Usually you want `setTimezone` instead — one call at app start and
+     * every date in the app follows. This is the per-instance override.
+     */
+    timezone: {
+        type: StringConstructor;
+    };
 }>> & Readonly<{}>, {
     locale: string;
     currency: string;

package/dist/components/KeyboardKey/KeyboardKey.vue.d.ts

@@ -0,0 +1,38 @@
+/**
+ * A single key on a keyboard, for documenting a shortcut in running text:
+ *
+ * ```vue
+ * Press <KeyboardKey>⌘</KeyboardKey><KeyboardKey>K</KeyboardKey> to search.
+ * ```
+ *
+ * It renders a real `<kbd>`, which is what says "keyboard input" to anything
+ * reading the page rather than looking at it — the styling is the smaller
+ * half of the job.
+ */
+export interface KeyboardKeyProps {
+    /**
+     * The key to draw. The default slot works too and wins if both are given.
+     */
+    label?: string;
+    /**
+     * A smaller key, for a shortcut sitting inside a menu row or a table cell
+     * rather than in prose.
+     */
+    size?: 'small' | 'medium';
+}
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<KeyboardKeyProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<KeyboardKeyProps> & Readonly<{}>, {
+    size: "small" | "medium";
+    label: string;
+}, {}, {}, {}, 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/KeyboardKey/index.d.ts

@@ -0,0 +1,2 @@
+export { default as KeyboardKey } from './KeyboardKey.vue';
+export type { KeyboardKeyProps } from './KeyboardKey.vue';

package/dist/components/Labelled/Labelled.vue.d.ts

@@ -46,7 +46,15 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         required: false;
     };
     /**
-     * @deprecated Makes the label title bold.
+     * Marks the field as required, drawing an asterisk after the label.
+     *
+     * This is the VISUAL half only. The control that owns the field is
+     * responsible for the other half — `aria-required` on the input itself —
+     * which every form component in the library does when it forwards this.
+     *
+     * It used to bold the entire field instead, which was marked deprecated
+     * and did not survive: the bold inherited down into help text and the
+     * control, and said nothing about the field being required.
      */
     required: {
         type: BooleanConstructor;
@@ -99,7 +107,15 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
         required: false;
     };
     /**
-     * @deprecated Makes the label title bold.
+     * Marks the field as required, drawing an asterisk after the label.
+     *
+     * This is the VISUAL half only. The control that owns the field is
+     * responsible for the other half — `aria-required` on the input itself —
+     * which every form component in the library does when it forwards this.
+     *
+     * It used to bold the entire field instead, which was marked deprecated
+     * and did not survive: the bold inherited down into help text and the
+     * control, and said nothing about the field being required.
      */
     required: {
         type: BooleanConstructor;

package/dist/components/Modal/ModalSection.vue.d.ts

@@ -0,0 +1,71 @@
+/**
+ * A band of content inside a `Modal`, divided from the next by a rule — the
+ * same relationship `CardSection` has with `Card`, and deliberately the same
+ * shape, so knowing one is knowing the other.
+ *
+ * Modal's body is a plain slot, so sections are simply the children you put
+ * in it:
+ *
+ * ```vue
+ * <Modal :visible="visible" title="Settings">
+ *   <ModalSection title="Account">…</ModalSection>
+ *   <ModalSection title="Notifications">…</ModalSection>
+ * </Modal>
+ * ```
+ *
+ * The body's own padding steps aside when sections are present — see
+ * `data-modal-section` in Modal.vue — so a sectioned modal is not padded
+ * twice.
+ */
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractPropTypes<{
+    /**
+     * The title heading of the section.
+     */
+    title: {
+        type: StringConstructor;
+    };
+    /**
+     * Renders the section with a subtle background colour, for a band that
+     * should read as secondary to the ones around it.
+     */
+    subdued: {
+        type: BooleanConstructor;
+    };
+    /**
+     * Sections are padded by default. Turn it off for content that has to run
+     * to the section's edges — a table, a full-bleed image.
+     */
+    padded: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>, () => import('vue').VNode<import('vue').RendererNode, import('vue').RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<import('vue').ExtractPropTypes<{
+    /**
+     * The title heading of the section.
+     */
+    title: {
+        type: StringConstructor;
+    };
+    /**
+     * Renders the section with a subtle background colour, for a band that
+     * should read as secondary to the ones around it.
+     */
+    subdued: {
+        type: BooleanConstructor;
+    };
+    /**
+     * Sections are padded by default. Turn it off for content that has to run
+     * to the section's edges — a table, a full-bleed image.
+     */
+    padded: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+}>> & Readonly<{}>, {
+    subdued: boolean;
+    padded: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, true, {}, any>;

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

@@ -1,10 +1,11 @@
 import { default as Modal } from './Modal.vue';
 import { default as ModalHost } from './ModalHost.vue';
+import { default as ModalSection } from './ModalSection.vue';
 import type * as Api from './api/types';
 export declare const genericModal: <Result = unknown>(opts: Api.GenericModalOptions) => Promise<Result | undefined>;
 export declare const alertModal: <Result = unknown>(opts: Api.AlertModalOptions) => Promise<Result | undefined>;
 export declare const confirmModal: <Result = boolean>(opts: Api.ConfirmModalOptions) => Promise<Result | undefined>;
 export declare const promptModal: <Result = string>(opts: Api.PromptModalOptions) => Promise<Result | undefined>;
-export { Modal, ModalHost };
+export { Modal, ModalHost, ModalSection };
 export type { ModalProps } from './types';
 export type { ModalOptions, ModalActionType, AlertModalOptions, ConfirmModalOptions, GenericModalOptions, PromptModalOptions } from './api/types';