@octans/ui 1.0.0 → 1.3.0

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';

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

@@ -1,11 +1,41 @@
 import { PageProps } from './types';
-declare var __VLS_21: {}, __VLS_60: {}, __VLS_77: {};
+declare var __VLS_1: {}, __VLS_8: {
+    breadcrumbs: import('./types').BreadcrumbType[];
+}, __VLS_18: {}, __VLS_20: {
+    title: string | undefined;
+}, __VLS_22: {}, __VLS_31: {}, __VLS_39: {
+    subtitle: string | undefined;
+}, __VLS_41: {
+    actions: import('../types').ActionType[];
+    groups: import('./types').ActionGroupType[];
+}, __VLS_63: {
+    sections: {
+        title: string;
+        items: import('../types').ActionType[];
+    }[];
+}, __VLS_76: {}, __VLS_93: {};
 type __VLS_Slots = {} & {
-    badge?: (props: typeof __VLS_21) => any;
+    loader?: (props: typeof __VLS_1) => any;
+} & {
+    breadcrumbs?: (props: typeof __VLS_8) => any;
+} & {
+    header?: (props: typeof __VLS_18) => any;
+} & {
+    title?: (props: typeof __VLS_20) => any;
+} & {
+    help?: (props: typeof __VLS_22) => any;
+} & {
+    badge?: (props: typeof __VLS_31) => any;
+} & {
+    subtitle?: (props: typeof __VLS_39) => any;
+} & {
+    secondaryActions?: (props: typeof __VLS_41) => any;
+} & {
+    collapsedActions?: (props: typeof __VLS_63) => any;
 } & {
-    primaryAction?: (props: typeof __VLS_60) => any;
+    primaryAction?: (props: typeof __VLS_76) => any;
 } & {
-    default?: (props: typeof __VLS_77) => any;
+    default?: (props: typeof __VLS_93) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<PageProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     save: () => any;

package/dist/components/{Popper/Popper.vue.d.ts → Popover/Popover.vue.d.ts}

@@ -1,4 +1,4 @@
-import { PopperProps } from './types';
+import { PopoverProps } from './types';
 declare function show(): void;
 declare function hide(): void;
 declare function toggle(): void;
@@ -18,16 +18,16 @@ type __VLS_Slots = {} & {
 } & {
     default?: (props: typeof __VLS_40) => any;
 };
-declare const __VLS_base: import('vue').DefineComponent<PopperProps, {
+declare const __VLS_base: import('vue').DefineComponent<PopoverProps, {
     show: typeof show;
     hide: typeof hide;
     toggle: typeof toggle;
 }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "update:visible": (val: boolean) => any;
-}, string, import('vue').PublicProps, Readonly<PopperProps> & Readonly<{
+}, string, import('vue').PublicProps, Readonly<PopoverProps> & Readonly<{
     "onUpdate:visible"?: ((val: boolean) => any) | undefined;
 }>, {
-    placement: import('./types').PopperPlacementType;
+    placement: import('./types').PopoverPlacementType;
     teleportTo: string;
     disabled: boolean;
     autoTriggerToggle: boolean;

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

@@ -0,0 +1,90 @@
+import { PopoverPlacementType, PopoverProps } from './types';
+export { default as Popover } from './Popover.vue';
+export * from './types';
+/**
+ * @deprecated Renamed to `Popover`.
+ *
+ * The component was never built on popper.js — it wraps reka-ui's Popover
+ * primitives — so the name pointed at a library the library does not use, and
+ * away from the thing every design system calls this. The alias keeps existing
+ * imports working and will be removed in a future major.
+ */
+export declare const Popper: {
+    new (...args: any[]): import('vue').CreateComponentPublicInstanceWithMixins<Readonly<PopoverProps> & Readonly<{
+        "onUpdate:visible"?: ((val: boolean) => any) | undefined;
+    }>, {
+        show: () => void;
+        hide: () => void;
+        toggle: () => void;
+    }, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+        "update:visible": (val: boolean) => any;
+    }, import('vue').PublicProps, {
+        placement: PopoverPlacementType;
+        teleportTo: string;
+        disabled: boolean;
+        autoTriggerToggle: boolean;
+        autoHide: boolean;
+        hover: boolean;
+        zIndex: number;
+    }, false, {}, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, {}, any, import('vue').ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<PopoverProps> & Readonly<{
+        "onUpdate:visible"?: ((val: boolean) => any) | undefined;
+    }>, {
+        show: () => void;
+        hide: () => void;
+        toggle: () => void;
+    }, {}, {}, {}, {
+        placement: PopoverPlacementType;
+        teleportTo: string;
+        disabled: boolean;
+        autoTriggerToggle: boolean;
+        autoHide: boolean;
+        hover: boolean;
+        zIndex: number;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import('vue').ComponentOptionsBase<Readonly<PopoverProps> & Readonly<{
+    "onUpdate:visible"?: ((val: boolean) => any) | undefined;
+}>, {
+    show: () => void;
+    hide: () => void;
+    toggle: () => void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+    "update:visible": (val: boolean) => any;
+}, string, {
+    placement: PopoverPlacementType;
+    teleportTo: string;
+    disabled: boolean;
+    autoTriggerToggle: boolean;
+    autoHide: boolean;
+    hover: boolean;
+    zIndex: number;
+}, {}, string, {}, import('vue').GlobalComponents, import('vue').GlobalDirectives, string, import('vue').ComponentProvideOptions> & import('vue').VNodeProps & import('vue').AllowedComponentProps & import('vue').ComponentCustomProps & (new () => {
+    $slots: {
+        trigger?: (props: {
+            visible: boolean;
+            show: () => void;
+            hide: () => void;
+            toggle: () => void;
+        }) => any;
+    } & {
+        default?: (props: {
+            visible: boolean;
+            show: () => void;
+            hide: () => void;
+            toggle: () => void;
+        }) => any;
+    };
+});
+/** @deprecated Renamed to `PopoverProps`. */
+export type PopperProps = PopoverProps;
+/** @deprecated Renamed to `PopoverPlacementType`. */
+export type PopperPlacementType = PopoverPlacementType;

package/dist/components/{Popper → Popover}/types.d.ts

@@ -1,7 +1,7 @@
-export type PopperPlacementType = 'top' | 'top-start' | 'top-end' | 'right' | 'right-start' | 'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end';
-export interface PopperProps {
+export type PopoverPlacementType = 'top' | 'top-start' | 'top-end' | 'right' | 'right-start' | 'right-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end';
+export interface PopoverProps {
     visible?: boolean;
-    placement?: PopperPlacementType;
+    placement?: PopoverPlacementType;
     teleportTo?: string;
     disabled?: boolean;
     /**

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

@@ -14,6 +14,19 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     error: {
         type: PropType<string | false | null>;
     };
+    /**
+     * Marks the field as required: an asterisk after the label, and
+     * `aria-required` on the control.
+     *
+     * Announced, not enforced — it deliberately does NOT set the native
+     * `required` attribute, so the browser's own validation bubble stays out
+     * of the way of whatever the app does about errors. Use `error` to show a
+     * failure.
+     */
+    required: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /**
      * Help text to show below the control.
      */
@@ -105,6 +118,19 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     error: {
         type: PropType<string | false | null>;
     };
+    /**
+     * Marks the field as required: an asterisk after the label, and
+     * `aria-required` on the control.
+     *
+     * Announced, not enforced — it deliberately does NOT set the native
+     * `required` attribute, so the browser's own validation bubble stays out
+     * of the way of whatever the app does about errors. Use `error` to show a
+     * failure.
+     */
+    required: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /**
      * Help text to show below the control.
      */
@@ -173,6 +199,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     };
 }>> & Readonly<{}>, {
     disabled: boolean;
+    required: boolean;
     modelValue: number;
     readonly: boolean;
     showInput: boolean;

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

@@ -45,6 +45,19 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     helpLink: {
         type: PropType<string | false | null>;
     };
+    /**
+     * Marks the field as required: an asterisk after the label, and
+     * `aria-required` on the control.
+     *
+     * Announced, not enforced — it deliberately does NOT set the native
+     * `required` attribute, so the browser's own validation bubble stays out
+     * of the way of whatever the app does about errors. Use `error` to show a
+     * failure.
+     */
+    required: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /**
      * A array of values when using the `multiple` mode, otherwise a single
      * value of any type.
@@ -324,6 +337,11 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     onDragMove(event: MouseEvent): void;
     onDragEnd(event: MouseEvent): void;
     endDragTracking(): void;
+    /**
+     * Whether the release landed on the search row — the input, its magnifier
+     * or the padding around them, all of which read as "I am going to type".
+     */
+    searchAtPoint(x: number, y: number): boolean;
     /** The option under the pointer, if the release landed on one. */
     optionAtPoint(x: number, y: number): any;
     onBlur(): void;
@@ -376,6 +394,19 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
     helpLink: {
         type: PropType<string | false | null>;
     };
+    /**
+     * Marks the field as required: an asterisk after the label, and
+     * `aria-required` on the control.
+     *
+     * Announced, not enforced — it deliberately does NOT set the native
+     * `required` attribute, so the browser's own validation bubble stays out
+     * of the way of whatever the app does about errors. Use `error` to show a
+     * failure.
+     */
+    required: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
     /**
      * A array of values when using the `multiple` mode, otherwise a single
      * value of any type.
@@ -594,6 +625,7 @@ declare const __VLS_export: import('vue').DefineComponent<import('vue').ExtractP
 }>, {
     disabled: boolean;
     loading: boolean;
+    required: boolean;
     modelValue: any;
     placeholder: string;
     readonly: boolean;
@@ -756,7 +788,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: {};
@@ -768,7 +800,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;
@@ -779,7 +811,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/SkeletonPage/SkeletonPage.vue.d.ts

@@ -0,0 +1,19 @@
+import { SkeletonPageProps } from './types';
+declare var __VLS_15: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_15) => any;
+};
+declare const __VLS_base: import('vue').DefineComponent<SkeletonPageProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<SkeletonPageProps> & Readonly<{}>, {
+    primaryAction: boolean;
+    size: "default" | "fullWidth" | "narrow" | "wide";
+    title: boolean;
+    cards: number;
+}, {}, {}, {}, 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/SkeletonPage/index.d.ts

@@ -0,0 +1,2 @@
+export { default as SkeletonPage } from './SkeletonPage.vue';
+export * from './types';

package/dist/components/SkeletonPage/types.d.ts

@@ -0,0 +1,26 @@
+import { PageProps } from '../Page';
+export interface SkeletonPageProps {
+    /**
+     * The width preset, forwarded to the `Page` underneath.
+     *
+     * Set it to whatever the real page uses. That is the whole reason this
+     * renders a real `Page` rather than a loose stack of shapes — a skeleton at
+     * a different width moves the content sideways the moment it swaps out.
+     */
+    size?: PageProps['size'];
+    /**
+     * Draws a placeholder where the page title will be. On by default; turn it
+     * off for a page whose title you already know and can render for real.
+     */
+    title?: boolean;
+    /**
+     * Draws a button-shaped placeholder in the header, for a page that has a
+     * primary action.
+     */
+    primaryAction?: boolean;
+    /**
+     * How many skeleton cards to stack in the body. Ignored when the default
+     * slot is used.
+     */
+    cards?: number;
+}

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

@@ -1,23 +1,10 @@
 import { TabType, TabsProps } from './types';
-declare var __VLS_1: {
-    tab: TabType;
-};
-type __VLS_Slots = {} & {
-    tab?: (props: typeof __VLS_1) => any;
-};
-declare const __VLS_base: import('vue').DefineComponent<TabsProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
+declare const __VLS_export: import('vue').DefineComponent<TabsProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "update:selected": (value: string, tab: TabType) => any;
 }, string, import('vue').PublicProps, Readonly<TabsProps> & Readonly<{
     "onUpdate:selected"?: ((value: string, tab: TabType) => any) | undefined;
 }>, {
-    theme: "blue" | "purple";
     tabs: TabType[];
 }, {}, {}, {}, 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/Tabs/types.d.ts

@@ -15,5 +15,15 @@ export interface TabsProps {
     /** The `value` of the currently selected tab. */
     selected?: string;
     tabs?: TabType[];
-    theme?: 'blue' | 'purple';
+    /**
+     * How the selected tab is marked.
+     *
+     * - `underline` — a rule under the label
+     * - `bar` — a thicker rounded bar sitting on the divider
+     *
+     * Was `theme`, with the values `blue` and `purple`. Neither ever set a
+     * colour: both draw from the theme's own tokens, and the only difference
+     * was the shape of this indicator.
+     */
+    indicator?: 'underline' | 'bar';
 }

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

@@ -1,11 +1,11 @@
-import { PopperPlacementType } from '../Popper';
+import { PopoverPlacementType } from '../Popover';
 export interface TagProps {
     /**
      * Disables the remove button.
      */
     required?: boolean;
     tooltip?: string | null;
-    tooltipPosition?: PopperPlacementType;
+    tooltipPosition?: PopoverPlacementType;
 }
 declare var __VLS_1: {};
 type __VLS_Slots = {} & {
@@ -16,7 +16,7 @@ declare const __VLS_base: import('vue').DefineComponent<TagProps, {}, {}, {}, {}
 }, string, import('vue').PublicProps, Readonly<TagProps> & Readonly<{
     onRemove?: (() => any) | undefined;
 }>, {
-    tooltipPosition: PopperPlacementType;
+    tooltipPosition: PopoverPlacementType;
     required: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/components/TextField/types.d.ts

@@ -127,4 +127,14 @@ export interface TextFieldProps {
      * fill from the right (e.g. thousands separators).
      */
     maskReversed?: boolean;
+    /**
+     * Marks the field as required: an asterisk after the label, and
+     * `aria-required` on the control.
+     *
+     * Announced, not enforced — it deliberately does NOT set the native
+     * `required` attribute, so the browser's own validation bubble stays out of
+     * the way of whatever the app does about errors. Use `error` to show a
+     * failure.
+     */
+    required?: boolean;
 }

package/dist/components/TimePicker/types.d.ts

@@ -82,6 +82,16 @@ export interface TimePickerProps {
      * when the field loses focus.
      */
     minuteStepStrict?: boolean;
+    /**
+     * Marks the field as required: an asterisk after the label, and
+     * `aria-required` on the control.
+     *
+     * Announced, not enforced — it deliberately does NOT set the native
+     * `required` attribute, so the browser's own validation bubble stays out of
+     * the way of whatever the app does about errors. Use `error` to show a
+     * failure.
+     */
+    required?: boolean;
     /**
      * @deprecated No longer used. The picker is now an inline input and does not
      * open a popper. Kept for backwards compatibility.

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

@@ -1,9 +1,9 @@
 import { ToggleSwitchProps } from './types';
-declare var __VLS_1: {
+declare var __VLS_8: {
     checked: boolean;
 };
 type __VLS_Slots = {} & {
-    handle?: (props: typeof __VLS_1) => any;
+    handle?: (props: typeof __VLS_8) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<ToggleSwitchProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {} & {
     "update:modelValue": (v: boolean) => any;
@@ -12,7 +12,13 @@ declare const __VLS_base: import('vue').DefineComponent<ToggleSwitchProps, {}, {
 }>, {
     disabled: boolean;
     size: "small" | "medium" | "large";
+    label: string | false | null;
+    error: string | false | null;
     color: string;
+    helpText: string | false | null;
+    required: boolean;
+    helpTextHtml: string | false | null;
+    helpLink: string | false | null;
     checked: boolean;
     trueValue: any;
     falseValue: any;