@nxgt/material-vue 0.42.0 → 0.43.0

package/dist/lib/components/ui/selection/autocomplete/partials/autocomplete-box.vue.d.ts

@@ -8,6 +8,12 @@ type __VLS_Props = {
     describedBy?: string;
     placeholder?: string;
     query: string;
+    /** The list is open: `aria-expanded`, and `data-list-open` so Escape in a dialog closes it first (`keepListEscape`). */
+    open?: boolean;
+    /** The id of the list the input controls, when it is in the page. */
+    controls?: string;
+    /** The id of the option Enter would pick. */
+    activeId?: string;
     selected: {
         value: string;
         label: string;
@@ -25,13 +31,11 @@ declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {
     input: (event: Event) => any;
     dismiss: (value: string) => any;
     click: () => any;
-    focus: () => any;
     keydown: (event: KeyboardEvent) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onInput?: ((event: Event) => any) | undefined;
     onDismiss?: ((value: string) => any) | undefined;
     onClick?: (() => any) | undefined;
-    onFocus?: (() => any) | undefined;
     onKeydown?: ((event: KeyboardEvent) => any) | undefined;
 }>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;

package/dist/lib/components/ui/selection/autocomplete/partials/autocomplete-list.vue.d.ts

@@ -1,6 +1,8 @@
 import { AutocompleteItem } from '../autocomplete-items';
 type __VLS_Props = {
     name?: string;
+    /** The listbox's id; each option's is `<listId>-<index>`. */
+    listId: string;
     query: string;
     filtered: AutocompleteItem<unknown>[];
     selected: string[];
@@ -14,6 +16,9 @@ type __VLS_Props = {
     /** The minimum query length `onSearch` waits for, as a sentence. */
     hint: string | null;
     addLabel: string;
+    multiple?: boolean;
+    /** The index of the option Enter picks (`aria-activedescendant`), or -1. */
+    active: number;
 };
 type __VLS_Slots = {
     option?: (props: {
@@ -26,9 +31,11 @@ type __VLS_Slots = {
 declare const __VLS_base: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     pick: (value: string) => any;
     add: () => any;
+    highlight: (index: number) => any;
 }, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{
     onPick?: ((value: string) => any) | undefined;
     onAdd?: (() => any) | undefined;
+    onHighlight?: ((index: number) => any) | undefined;
 }>, {}, {}, {}, {}, 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/lib/components/ui/selection/autocomplete/use-autocomplete-active.d.ts

@@ -0,0 +1,17 @@
+import { Ref } from 'vue';
+type Item = {
+    value: string;
+    disabled?: boolean;
+};
+/**
+ * The highlighted option (`aria-activedescendant`, and what Enter picks).
+ * -1 while the list is closed, or once the arrow keys passed through "none".
+ * Until the arrow keys move it, it is the first enabled option, or none when
+ * the free-solo "Add" button stands for Enter. A new query, or the list
+ * closing, hands it back to that default.
+ */
+export declare function useAutocompleteActive(filtered: Readonly<Ref<Item[]>>, canAdd: Readonly<Ref<boolean>>, query: Readonly<Ref<string>>, open: Readonly<Ref<boolean>>): {
+    active: import('vue').ComputedRef<number>;
+    setActive(index: number): void;
+};
+export {};

package/dist/lib/components/ui/selection/autocomplete/use-autocomplete-keydown.d.ts

@@ -0,0 +1,21 @@
+import { Ref } from 'vue';
+type Keys = {
+    query: Readonly<Ref<string>>;
+    selectedValues: Readonly<Ref<string[]>>;
+    filtered: Readonly<Ref<{
+        value: string;
+        disabled?: boolean;
+    }[]>>;
+    canAdd: Readonly<Ref<boolean>>;
+    open: Ref<boolean>;
+    active: Readonly<Ref<number>>;
+    setActive: (index: number) => void;
+    pick: (value: string) => void;
+    remove: (value: string) => void;
+    addFreeSolo: () => void;
+};
+/** The input's `keydown` handler, over the field's state. */
+export declare function useAutocompleteKeydown(props: {
+    disabled?: boolean;
+}, k: Keys): (event: KeyboardEvent) => void;
+export {};

package/dist/lib/components/ui/selection/autocomplete/use-autocomplete-open.d.ts

@@ -1,7 +1,8 @@
 import { Ref } from 'vue';
 /**
- * Whether the list is open, and the handlers that open it: focus, a click
- * on the box, typing. A click outside closes it; a disabled field never opens.
+ * Whether the list is open, and the handlers that open it: click
+ * on the box, typing (not focus: a dialog that focuses its first field
+ * opens with the list shut, as in React). A click outside closes it; a disabled field never opens.
  */
 export declare function useAutocompleteOpen(props: {
     disabled?: boolean;
@@ -9,7 +10,6 @@ export declare function useAutocompleteOpen(props: {
     focus: () => void;
 } | null>>): {
     open: Ref<boolean, boolean>;
-    onFocus(): void;
     focusInput(): void;
     onInput(event: Event): void;
 };

package/dist/lib/components/ui/selection/autocomplete/use-autocomplete.d.ts

@@ -25,14 +25,15 @@ export declare function useAutocomplete<T extends AutocompleteOption>(props: Opt
     remove: (value: string) => void;
     addFreeSolo: () => void;
     onKeydown: (event: KeyboardEvent) => void;
+    setActive: (index: number) => void;
     canAddFreeSolo: import('vue').ComputedRef<boolean>;
     addLabel: import('vue').ComputedRef<string>;
     query: Ref<string, string>;
+    active: import('vue').ComputedRef<number>;
     selectedValues: import('vue').ComputedRef<string[]>;
     selectedItems: import('vue').ComputedRef<import('./autocomplete-items').AutocompleteItem<T>[]>;
     filtered: import('vue').ComputedRef<import('./autocomplete-items').AutocompleteItem<T>[]>;
     open: Ref<boolean, boolean>;
-    onFocus(): void;
     focusInput(): void;
     onInput(event: Event): void;
 };

package/dist/lib/components/ui/selection/autocomplete/use-drawer-room.d.ts

@@ -0,0 +1,11 @@
+import { Ref } from 'vue';
+/**
+ * In a Drawer, the height the open floating list may take under its own top
+ * (#582), `null` elsewhere; and `keepDrawer`, which keeps a drag that starts
+ * on the list from reaching the Drawer's swipe. Measured again after every
+ * update, when the Drawer resizes or scrolls and when the window resizes.
+ */
+export declare function useDrawerRoom(list: Readonly<Ref<HTMLElement | null>>): {
+    room: Ref<number | null, number | null>;
+    keepDrawer(event: Event): void;
+};

package/dist/lib/components/ui/selection/autocomplete/use-query-change.d.ts

@@ -0,0 +1,8 @@
+import { Ref } from 'vue';
+/**
+ * Reports the query: typing once it pauses (`debounceMs`), an emptied query
+ * (a pick, a clear) at once. What the page derives from the query then
+ * changes with the pick, not `debounceMs` later, under the click on the next
+ * field (#557).
+ */
+export declare function useQueryChange(query: Readonly<Ref<string>>, debounceMs: () => number, report: (query: string) => void): void;

package/dist/lib/components/ui/widgets/charts/chart-container.vue.d.ts

@@ -5,11 +5,11 @@ export type ChartContainerProps = {
     loading?: boolean;
     empty?: boolean;
 };
-declare var __VLS_6: {}, __VLS_8: {};
+declare var __VLS_6: {}, __VLS_13: {};
 type __VLS_Slots = {} & {
     emptyState?: (props: typeof __VLS_6) => any;
 } & {
-    default?: (props: typeof __VLS_8) => any;
+    default?: (props: typeof __VLS_13) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<ChartContainerProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<ChartContainerProps> & Readonly<{}>, {
     height: string | number;

package/dist/lib/components/ui/widgets/kanban/partials/kanban-empty.vue.d.ts

@@ -1,5 +1,6 @@
 type __VLS_Props = {
     title: string;
+    search?: boolean;
 };
 declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/lib/composables/use-background-activity.d.ts

@@ -0,0 +1,8 @@
+import { Ref } from 'vue';
+/**
+ * Whether an `animated` background should be paused: the page is hidden, the
+ * element is off screen or the user prefers reduced motion. It starts `false`
+ * (what the server renders), observes only once mounted and only while
+ * `enabled`, and removes every listener on unmount.
+ */
+export declare function useBackgroundActivity(el: Ref<Element | null>, enabled: () => boolean): Ref<boolean>;

package/dist/lib/i18n/resources/en/en.d.ts

@@ -39,9 +39,30 @@ export declare const en: {
                 description: string;
             };
         };
+        "error-state": {
+            generic: {
+                title: string;
+                description: string;
+            };
+            offline: {
+                title: string;
+                description: string;
+            };
+            maintenance: {
+                title: string;
+                description: string;
+            };
+            retry: string;
+            details: string;
+            "details-name": string;
+            "details-message": string;
+            "details-cause": string;
+        };
         command: {
             title: string;
             description: string;
+            empty: string;
+            list: string;
         };
         "confirm-dialog": {
             confirm: string;
@@ -354,6 +375,8 @@ export declare const en: {
                 "delete-selected-rows": string;
                 "toggle-columns": string;
                 "no-data": string;
+                "no-results": string;
+                "no-results-description": string;
                 "select-all": string;
                 "select-row": string;
                 "toggle-row": string;
@@ -617,6 +640,7 @@ export declare const en: {
             empty: string;
             loading: string;
             error: string;
+            retry: string;
             password: string;
             "password-placeholder": string;
             "password-label": string;

package/dist/lib/i18n/resources/en/material.json.d.ts

@@ -29,9 +29,30 @@ declare const _default: {
 			"description": "The service is down for a short update."
 		}
 	},
+	"error-state": {
+		"generic": {
+			"title": "Something Went Wrong",
+			"description": "An unexpected error occurred. Please try again later."
+		},
+		"offline": {
+			"title": "You are offline",
+			"description": "Check your connection and try again."
+		},
+		"maintenance": {
+			"title": "We'll be right back",
+			"description": "The service is down for a short update."
+		},
+		"retry": "Retry",
+		"details": "Technical details",
+		"details-name": "Name",
+		"details-message": "Message",
+		"details-cause": "Cause"
+	},
 	"command": {
 		"title": "Command Palette",
-		"description": "Search for a command to run..."
+		"description": "Search for a command to run...",
+		"empty": "No results",
+		"list": "Suggestions"
 	},
 	"confirm-dialog": {
 		"confirm": "Confirm",
@@ -344,6 +365,8 @@ declare const _default: {
 			"delete-selected-rows": "Delete {count} rows",
 			"toggle-columns": "Toggle columns",
 			"no-data": "No data available",
+			"no-results": "No results",
+			"no-results-description": "Try a different search or clear the filters.",
 			"select-all": "Select all",
 			"select-row": "Select row",
 			"toggle-row": "Toggle row details",
@@ -607,6 +630,7 @@ declare const _default: {
 		"empty": "No document selected",
 		"loading": "Loading document…",
 		"error": "Failed to load document",
+		"retry": "Retry",
 		"password": "Password protected",
 		"password-placeholder": "Enter password",
 		"password-label": "Password",

package/dist/lib/i18n/resources/fr/fr.d.ts

@@ -39,9 +39,30 @@ export declare const fr: {
                 description: string;
             };
         };
+        "error-state": {
+            generic: {
+                title: string;
+                description: string;
+            };
+            offline: {
+                title: string;
+                description: string;
+            };
+            maintenance: {
+                title: string;
+                description: string;
+            };
+            retry: string;
+            details: string;
+            "details-name": string;
+            "details-message": string;
+            "details-cause": string;
+        };
         command: {
             title: string;
             description: string;
+            empty: string;
+            list: string;
         };
         "confirm-dialog": {
             confirm: string;
@@ -354,6 +375,8 @@ export declare const fr: {
                 "delete-selected-rows": string;
                 "toggle-columns": string;
                 "no-data": string;
+                "no-results": string;
+                "no-results-description": string;
                 "select-all": string;
                 "select-row": string;
                 "toggle-row": string;
@@ -617,6 +640,7 @@ export declare const fr: {
             empty: string;
             loading: string;
             error: string;
+            retry: string;
             password: string;
             "password-placeholder": string;
             "password-label": string;

package/dist/lib/i18n/resources/fr/material.json.d.ts

@@ -29,9 +29,30 @@ declare const _default: {
 			"description": "Le service est en courte mise à jour."
 		}
 	},
+	"error-state": {
+		"generic": {
+			"title": "Une erreur est survenue",
+			"description": "Une erreur inattendue s'est produite. Veuillez réessayer plus tard."
+		},
+		"offline": {
+			"title": "Vous êtes hors ligne",
+			"description": "Vérifiez votre connexion et réessayez."
+		},
+		"maintenance": {
+			"title": "On revient tout de suite",
+			"description": "Le service est en courte mise à jour."
+		},
+		"retry": "Réessayer",
+		"details": "Détails techniques",
+		"details-name": "Nom",
+		"details-message": "Message",
+		"details-cause": "Cause"
+	},
 	"command": {
 		"title": "Palette de commandes",
-		"description": "Recherchez une commande à exécuter..."
+		"description": "Recherchez une commande à exécuter...",
+		"empty": "Aucun résultat",
+		"list": "Commandes suggérées"
 	},
 	"confirm-dialog": {
 		"confirm": "Confirmer",
@@ -344,6 +365,8 @@ declare const _default: {
 			"delete-selected-rows": "Supprimer {count} lignes",
 			"toggle-columns": "Basculer les colonnes",
 			"no-data": "Données non disponibles",
+			"no-results": "Aucun résultat",
+			"no-results-description": "Essayez une autre recherche ou retirez les filtres.",
 			"select-all": "Tout sélectionner",
 			"select-row": "Sélectionner la ligne",
 			"toggle-row": "Afficher ou masquer les détails de la ligne",
@@ -607,6 +630,7 @@ declare const _default: {
 		"empty": "Aucun document sélectionné",
 		"loading": "Chargement du document…",
 		"error": "Impossible de charger le document",
+		"retry": "Réessayer",
 		"password": "Protégé par mot de passe",
 		"password-placeholder": "Saisir le mot de passe",
 		"password-label": "Mot de passe",

package/dist/lib/i18n/resources/resources.d.ts

@@ -37,9 +37,30 @@ export declare const resources: {
                     description: string;
                 };
             };
+            "error-state": {
+                generic: {
+                    title: string;
+                    description: string;
+                };
+                offline: {
+                    title: string;
+                    description: string;
+                };
+                maintenance: {
+                    title: string;
+                    description: string;
+                };
+                retry: string;
+                details: string;
+                "details-name": string;
+                "details-message": string;
+                "details-cause": string;
+            };
             command: {
                 title: string;
                 description: string;
+                empty: string;
+                list: string;
             };
             "confirm-dialog": {
                 confirm: string;
@@ -352,6 +373,8 @@ export declare const resources: {
                     "delete-selected-rows": string;
                     "toggle-columns": string;
                     "no-data": string;
+                    "no-results": string;
+                    "no-results-description": string;
                     "select-all": string;
                     "select-row": string;
                     "toggle-row": string;
@@ -615,6 +638,7 @@ export declare const resources: {
                 empty: string;
                 loading: string;
                 error: string;
+                retry: string;
                 password: string;
                 "password-placeholder": string;
                 "password-label": string;
@@ -1343,9 +1367,30 @@ export declare const resources: {
                     description: string;
                 };
             };
+            "error-state": {
+                generic: {
+                    title: string;
+                    description: string;
+                };
+                offline: {
+                    title: string;
+                    description: string;
+                };
+                maintenance: {
+                    title: string;
+                    description: string;
+                };
+                retry: string;
+                details: string;
+                "details-name": string;
+                "details-message": string;
+                "details-cause": string;
+            };
             command: {
                 title: string;
                 description: string;
+                empty: string;
+                list: string;
             };
             "confirm-dialog": {
                 confirm: string;
@@ -1658,6 +1703,8 @@ export declare const resources: {
                     "delete-selected-rows": string;
                     "toggle-columns": string;
                     "no-data": string;
+                    "no-results": string;
+                    "no-results-description": string;
                     "select-all": string;
                     "select-row": string;
                     "toggle-row": string;
@@ -1921,6 +1968,7 @@ export declare const resources: {
                 empty: string;
                 loading: string;
                 error: string;
+                retry: string;
                 password: string;
                 "password-placeholder": string;
                 "password-label": string;