@nexdom/uimed-vue 2.0.0-beta.8 → 2.0.0

package/dist/components/grid/row/row.vue.d.ts

@@ -0,0 +1,29 @@
+import { RowProps } from "./types.js";
+//#region src/components/grid/row/row.vue.d.ts
+/**
+ * Row component to be placed within a container.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <u-container>
+ *     <u-row align-x="center" align-y="center">
+ *       <!-- uimed-column -->
+ *     </u-row>
+ *   </u-container>
+ * </template>
+ * ```
+ *
+ * @see {@link https://nexdom-healthtech.github.io/uimed-vue/guide/components/layout | Row Guide}
+ */
+declare const _default: typeof __VLS_export;
+declare const __VLS_export: __VLS_WithSlots<import("vue", { with: { "resolution-mode": "import" } }).DefineComponent<RowProps, {}, {}, {}, {}, import("vue", { with: { "resolution-mode": "import" } }).ComponentOptionsMixin, import("vue", { with: { "resolution-mode": "import" } }).ComponentOptionsMixin, {}, string, import("vue", { with: { "resolution-mode": "import" } }).PublicProps, Readonly<RowProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue", { with: { "resolution-mode": "import" } }).ComponentProvideOptions, false, {}, any>, {
+  default?: (props: {}) => any;
+}>;
+type __VLS_WithSlots<T, S> = T & {
+  new (): {
+    $slots: S;
+  };
+};
+//#endregion
+export { _default as default };

package/dist/components/grid/row/row.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,61 @@
+import { useFullHeight } from "../../../composables/dimensions/dimensions.js";
+import { useAlignX, useAlignY } from "../../../composables/alignment/alignment.js";
+import { computed, createBlock, defineComponent, normalizeClass, openBlock, renderSlot, unref, withCtx } from "vue";
+import { VRow } from "vuetify/components";
+var row_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	inheritAttrs: false,
+	__name: "row",
+	props: {
+		alignX: {
+			type: String,
+			required: false
+		},
+		alignY: {
+			type: String,
+			required: false
+		},
+		fullHeight: {
+			type: Boolean,
+			required: false
+		},
+		list: {
+			type: Boolean,
+			required: false
+		},
+		dataTestid: {
+			type: String,
+			required: false
+		}
+	},
+	setup(__props) {
+		const props = __props;
+		const alignXClass = useAlignX(() => props.alignX);
+		const alignYClasses = useAlignY(() => props.alignY);
+		const heightClass = useFullHeight(() => props.fullHeight);
+		const alignContentClass = computed(() => props.fullHeight ? alignYClasses.value.content : void 0);
+		const tag = computed(() => props.list ? "ul" : void 0);
+		const listClasses = computed(() => props.list ? "pa-0 ma-0" : void 0);
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(VRow), {
+				tag: tag.value,
+				class: normalizeClass([
+					unref(alignXClass),
+					unref(alignYClasses).items,
+					unref(heightClass),
+					alignContentClass.value,
+					listClasses.value
+				]),
+				"data-testid": props.dataTestid
+			}, {
+				default: withCtx(() => [renderSlot(_ctx.$slots, "default")]),
+				_: 3
+			}, 8, [
+				"tag",
+				"class",
+				"data-testid"
+			]);
+		};
+	}
+});
+//#endregion
+export { row_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/grid/row/types.d.ts

@@ -0,0 +1,63 @@
+import { AlignX, AlignY } from "../../../composables/alignment/types.js";
+//#region src/components/grid/row/types.d.ts
+/**
+ * Props exposed by the {@link Row} component.
+ */
+export type RowProps = {
+  /**
+   * Horizontal alignment of the row's columns on each line.
+   * Available options are:
+   * - `"start"`: aligns the columns to the start of the line;
+   * - `"center"`: centers the columns horizontally;
+   * - `"end"`: aligns the columns to the end of the line.
+   *
+   * `"start"` and `"end"` follow the text direction. It only has a visible effect when the
+   * columns of a line don't fill it, e.g. with `cols="auto"` or sizes adding up to less than 12.
+   * When the columns wrap into several lines, each line is aligned on its own.
+   *
+   * Columns sit side by side only from the `sm` breakpoint up. Below it, each column takes a
+   * whole line, so the alignment has no visible effect.
+   * @default "start"
+   */
+  alignX?: AlignX;
+  /**
+   * Vertical alignment of the row's columns, relative to the tallest column on the same line.
+   * Available options are:
+   * - `"start"`: aligns the columns to the top;
+   * - `"center"`: centers the columns vertically;
+   * - `"end"`: aligns the columns to the bottom;
+   * - `"stretch"`: stretches every column to the height of the tallest one.
+   *
+   * Use `"stretch"` to keep side by side columns at the same height, e.g. cards made of
+   * `USection`s with `fullHeight`.
+   *
+   * Columns sit side by side only from the `sm` breakpoint up. Below it, each column takes a
+   * whole line, so the alignment has no visible effect, unless the row has `fullHeight`: then
+   * the columns, as a group, are aligned within the row's height.
+   * @default "start"
+   */
+  alignY?: AlignY;
+  /**
+   * Stretches the row to the whole height of its parent: the visible content area of `UMain`
+   * (below its app bar) or a `UContainer` with `fullHeight`.
+   *
+   * Combine it with `alignY` to place the columns within that height, e.g. `alignY="center"`
+   * and `alignX="center"` to center a login form on the screen. A row with `fullHeight` takes
+   * the whole height by itself, so other rows next to it are pushed below the visible area.
+   * @default false
+   */
+  fullHeight?: boolean;
+  /**
+   * Renders the row as a list (`<ul>`), without the list's default indentation
+   * and bullets, so assistive technologies announce its columns as the items
+   * of a list. Use it for a grid of records that is, semantically, a list,
+   * like cards of patients, and set `listItem` on each of its `UColumn`s.
+   * @default false
+   */
+  list?: boolean;
+  /**
+   * Component id to use on automated tests.
+   */
+  dataTestid?: string;
+};
+//#endregion

package/dist/components/icon-button/icon-button.js

@@ -0,0 +1,5 @@
+import icon_button_vue_vue_type_script_setup_true_lang_default from "./icon-button.vue_vue_type_script_setup_true_lang.js";
+//#region src/components/icon-button/icon-button.vue
+var icon_button_default = icon_button_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { icon_button_default as default };

package/dist/components/icon-button/icon-button.vue.d.ts

@@ -0,0 +1,23 @@
+import { IconButtonProps } from "./types.js";
+//#region src/components/icon-button/icon-button.vue.d.ts
+/**
+ * Button that shows only an icon, for actions whose icon is enough to identify them, such as
+ * editing a record of a list. Its `label` is the name assistive technologies read.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <u-icon-button icon="cog" label="Configurações" @click="onClick" />
+ * </template>
+ * ```
+ *
+ * @see {@link https://nexdom-healthtech.github.io/uimed-vue/guide/components/icon-button | IconButton Guide}
+ */
+declare const _default: typeof __VLS_export;
+declare const __VLS_export: import("vue", { with: { "resolution-mode": "import" } }).DefineComponent<IconButtonProps, {}, {}, {}, {}, import("vue", { with: { "resolution-mode": "import" } }).ComponentOptionsMixin, import("vue", { with: { "resolution-mode": "import" } }).ComponentOptionsMixin, {} & {
+  click: (event: MouseEvent) => any;
+}, string, import("vue", { with: { "resolution-mode": "import" } }).PublicProps, Readonly<IconButtonProps> & Readonly<{
+  onClick?: ((event: MouseEvent) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue", { with: { "resolution-mode": "import" } }).ComponentProvideOptions, false, {}, any>;
+//#endregion
+export { _default as default };

package/dist/components/icon-button/icon-button.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,51 @@
+import { icons } from "../../consts/icons.js";
+import useVuetifyColor from "../../composables/colors/use-vuetify-color.js";
+import { createBlock, defineComponent, openBlock, unref } from "vue";
+import { VIconBtn } from "vuetify/components";
+var icon_button_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	inheritAttrs: false,
+	__name: "icon-button",
+	props: {
+		icon: {
+			type: null,
+			required: true
+		},
+		label: {
+			type: String,
+			required: true
+		},
+		color: {
+			type: String,
+			required: false
+		},
+		dataTestid: {
+			type: String,
+			required: false
+		}
+	},
+	emits: ["click"],
+	setup(__props, { emit: __emit }) {
+		const props = __props;
+		const emit = __emit;
+		const color = useVuetifyColor(() => props.color);
+		function onClick(event) {
+			emit("click", event);
+		}
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(VIconBtn), {
+				icon: unref(icons)[props.icon],
+				"aria-label": props.label,
+				color: unref(color),
+				"data-testid": props.dataTestid,
+				onClick
+			}, null, 8, [
+				"icon",
+				"aria-label",
+				"color",
+				"data-testid"
+			]);
+		};
+	}
+});
+//#endregion
+export { icon_button_vue_vue_type_script_setup_true_lang_default as default };

package/dist/components/icon-button/types.d.ts

@@ -0,0 +1,32 @@
+import { Icon } from "../../consts/types.js";
+import { ColorVariant } from "../../composables/colors/types.js";
+//#region src/components/icon-button/types.d.ts
+/**
+ * Props exposed by the {@link IconButton} component.
+ */
+export type IconButtonProps = {
+  /**
+   * Icon drawn on the button. One of the names listed on the "Ícones" guide page. Assistive
+   * technologies ignore it and read `label` instead.
+   *
+   * @see {@link https://nexdom-healthtech.github.io/uimed-vue/guide/icons | Icons Guide}
+   */
+  icon: Icon;
+  /**
+   * Accessible name of the button, read by assistive technologies instead of the icon. Describe
+   * the action the button performs (e.g. "Editar paciente"), not the icon's drawing (e.g.
+   * "Lápis").
+   */
+  label: string;
+  /**
+   * Applies a color to the button.
+   * One of `primary`, `secondary`, `positive`, `informative`, `caution`, or `danger`.
+   * @default "primary"
+   */
+  color?: ColorVariant;
+  /**
+   * Component id to use on automated tests.
+   */
+  dataTestid?: string;
+};
+//#endregion

package/dist/components/img/img.js

@@ -0,0 +1,5 @@
+import img_vue_vue_type_script_setup_true_lang_default from "./img.vue_vue_type_script_setup_true_lang.js";
+//#region src/components/img/img.vue
+var img_default = img_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { img_default as default };

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

@@ -0,0 +1,23 @@
+import { ImgProps } from "./types.js";
+//#region src/components/img/img.vue.d.ts
+/**
+ * Decorative image, ignored by assistive technologies, loaded when it's about
+ * to become visible. Set its dimensions to reserve its space before it loads.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *   <u-row>
+ *     <u-column cols="12">
+ *       <u-img src="/logo.svg" :width="380" :height="88" eager />
+ *     </u-column>
+ *   </u-row>
+ * </template>
+ * ```
+ *
+ * @see {@link https://nexdom-healthtech.github.io/uimed-vue/guide/components/img | Img Guide}
+ */
+declare const _default: typeof __VLS_export;
+declare const __VLS_export: import("vue", { with: { "resolution-mode": "import" } }).DefineComponent<ImgProps, {}, {}, {}, {}, import("vue", { with: { "resolution-mode": "import" } }).ComponentOptionsMixin, import("vue", { with: { "resolution-mode": "import" } }).ComponentOptionsMixin, {}, string, import("vue", { with: { "resolution-mode": "import" } }).PublicProps, Readonly<ImgProps> & Readonly<{}>, {}, {}, {}, {}, string, import("vue", { with: { "resolution-mode": "import" } }).ComponentProvideOptions, false, {}, any>;
+//#endregion
+export { _default as default };

package/dist/components/img/img.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,61 @@
+import { createBlock, defineComponent, openBlock, unref } from "vue";
+import { VImg } from "vuetify/components";
+var img_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	inheritAttrs: false,
+	__name: "img",
+	props: {
+		src: {
+			type: String,
+			required: true
+		},
+		width: {
+			type: [Number, String],
+			required: false
+		},
+		height: {
+			type: [Number, String],
+			required: false
+		},
+		aspectRatio: {
+			type: Number,
+			required: false
+		},
+		cover: {
+			type: Boolean,
+			required: false
+		},
+		eager: {
+			type: Boolean,
+			required: false
+		},
+		dataTestid: {
+			type: String,
+			required: false
+		}
+	},
+	setup(__props) {
+		const props = __props;
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(unref(VImg), {
+				src: props.src,
+				alt: "",
+				width: props.width,
+				height: props.height,
+				"aspect-ratio": props.aspectRatio,
+				cover: props.cover,
+				eager: props.eager,
+				"data-testid": props.dataTestid
+			}, null, 8, [
+				"src",
+				"width",
+				"height",
+				"aspect-ratio",
+				"cover",
+				"eager",
+				"data-testid"
+			]);
+		};
+	}
+});
+//#endregion
+export { img_vue_vue_type_script_setup_true_lang_default as default };

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

@@ -0,0 +1,43 @@
+//#region src/components/img/types.d.ts
+/**
+ * Props exposed by the {@link Img} component.
+ */
+export type ImgProps = {
+  /**
+   * Path or URL of the image.
+   */
+  src: string;
+  /**
+   * Width of the image. A number sets it in pixels, and a string sets it in
+   * any CSS unit (e.g. `"100%"`). Shrinks to fit the available width when
+   * it's larger (e.g. inside a narrow `UColumn`).
+   */
+  width?: number | string;
+  /**
+   * Height of the image. A number sets it in pixels, and a string sets it in
+   * any CSS unit (e.g. `"10rem"`).
+   */
+  height?: number | string;
+  /**
+   * Proportion between width and height (e.g. `16 / 9`), used to reserve the
+   * image's space before it loads. Ignored when `height` is set.
+   */
+  aspectRatio?: number;
+  /**
+   * Fills the image's area, cropping the image when its proportion differs
+   * from the area's. By default, the whole image is shown inside the area.
+   * @default false
+   */
+  cover?: boolean;
+  /**
+   * Loads the image right away, instead of when it's about to become
+   * visible. Use it for images visible when the page opens, such as a logo.
+   * @default false
+   */
+  eager?: boolean;
+  /**
+   * Component id to use on automated tests.
+   */
+  dataTestid?: string;
+};
+//#endregion

package/dist/components/inputs/autocomplete-field/autocomplete-field.js

@@ -0,0 +1,5 @@
+import autocomplete_field_vue_vue_type_script_setup_true_lang_default from "./autocomplete-field.vue_vue_type_script_setup_true_lang.js";
+//#region src/components/inputs/autocomplete-field/autocomplete-field.vue
+var autocomplete_field_default = autocomplete_field_vue_vue_type_script_setup_true_lang_default;
+//#endregion
+export { autocomplete_field_default as default };

package/dist/components/inputs/autocomplete-field/autocomplete-field.vue.d.ts

@@ -0,0 +1,33 @@
+import { AutocompleteFieldProps } from "./types.js";
+//#region src/components/inputs/autocomplete-field/autocomplete-field.vue.d.ts
+/**
+ * Select field component to be used throughout the application.
+ *
+ * @example
+ * ```vue
+ * <template>
+ *  <u-autocomplete-field label="Country" :items="['Brazil', 'Argentina']" />
+ * </template>
+ * ```
+ *
+ * @see {@link https://nexdom-healthtech.github.io/uimed-vue/guide/components/autocomplete-field | AutocompleteField Guide}
+ */
+declare const _default: typeof __VLS_export;
+declare const __VLS_export: <T = string, Multiple extends boolean = false>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_exposed?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
+  props: import("vue").PublicProps & __VLS_PrettifyLocal<(AutocompleteFieldProps<T, Multiple> & {
+    modelValue?: Multiple extends true ? T[] : T;
+  }) & {
+    "onUpdate:modelValue"?: ((value: Multiple extends true ? T[] : T | undefined) => any) | undefined;
+  }> & (typeof globalThis extends {
+    __VLS_PROPS_FALLBACK: infer P;
+  } ? P : {});
+  expose: (exposed: {}) => void;
+  attrs: any;
+  slots: {};
+  emit: (event: "update:modelValue", value: Multiple extends true ? T[] : T | undefined) => void;
+}>) => import("vue").VNode & {
+  __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
+};
+type __VLS_PrettifyLocal<T> = (T extends any ? { [K in keyof T]: T[K]; } : { [K in keyof T as K]: T[K]; }) & {};
+//#endregion
+export { _default as default };

package/dist/components/inputs/autocomplete-field/autocomplete-field.vue_vue_type_script_setup_true_lang.js

@@ -0,0 +1,161 @@
+import { useTextFieldVariant } from "../../../composables/inputs/fields.js";
+import field_loader_default from "../field-loader.js";
+import { autocompleteFieldMenuProps, useAutocompleteRules } from "../../../composables/inputs/autocomplete-field.js";
+import { computed, createBlock, createSlots, createVNode, defineComponent, guardReactiveProps, mergeModels, normalizeProps, openBlock, ref, resolveDynamicComponent, unref, useModel, withCtx } from "vue";
+import { VAutocomplete, VCheckboxBtn, VCombobox, VListItem } from "vuetify/components";
+import { VHighlight } from "vuetify/labs/VHighlight";
+var autocomplete_field_vue_vue_type_script_setup_true_lang_default = /*@__PURE__*/ defineComponent({
+	inheritAttrs: false,
+	__name: "autocomplete-field",
+	props: /*@__PURE__*/ mergeModels({
+		variant: {
+			type: String,
+			required: false,
+			default: "primary"
+		},
+		disabled: {
+			type: Boolean,
+			required: false
+		},
+		loading: {
+			type: Boolean,
+			required: false
+		},
+		clearable: {
+			type: Boolean,
+			required: false
+		},
+		readonly: {
+			type: Boolean,
+			required: false
+		},
+		required: {
+			type: Boolean,
+			required: false
+		},
+		label: {
+			type: String,
+			required: false
+		},
+		placeholder: {
+			type: String,
+			required: false
+		},
+		hint: {
+			type: String,
+			required: false
+		},
+		dataTestid: {
+			type: String,
+			required: false
+		},
+		strict: {
+			type: Boolean,
+			required: false
+		},
+		multiple: {
+			type: null,
+			required: false
+		},
+		items: {
+			type: Array,
+			required: false,
+			default: () => []
+		}
+	}, {
+		"modelValue": { type: null },
+		"modelModifiers": {}
+	}),
+	emits: ["update:modelValue"],
+	setup(__props) {
+		const modelValue = useModel(__props, "modelValue");
+		const props = __props;
+		const vuetifyVariant = useTextFieldVariant(() => props.variant);
+		const isMultiple = computed(() => props.multiple ?? false);
+		const rules = useAutocompleteRules(() => ({
+			required: props.required,
+			multiple: isMultiple.value
+		}));
+		const vuetifyComponent = computed(() => props.strict ? VAutocomplete : VCombobox);
+		const search = ref("");
+		const maskClass = computed(() => props.strict ? "v-autocomplete__mask" : "v-combobox__mask");
+		const normalizedItems = computed(() => {
+			return props.items.map((item) => {
+				if (typeof item === "string") return {
+					label: item,
+					value: item
+				};
+				return item;
+			});
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(resolveDynamicComponent(vuetifyComponent.value), {
+				modelValue: modelValue.value,
+				"onUpdate:modelValue": _cache[0] || (_cache[0] = ($event) => modelValue.value = $event),
+				search: search.value,
+				"onUpdate:search": _cache[1] || (_cache[1] = ($event) => search.value = $event),
+				variant: unref(vuetifyVariant),
+				items: normalizedItems.value,
+				"data-testid": props.dataTestid,
+				disabled: props.disabled,
+				loading: props.loading,
+				"aria-busy": props.loading || void 0,
+				readonly: props.readonly,
+				label: props.label,
+				placeholder: props.placeholder,
+				hint: props.hint,
+				clearable: props.clearable,
+				multiple: isMultiple.value,
+				"item-title": "label",
+				rules: unref(rules),
+				"menu-props": unref(autocompleteFieldMenuProps),
+				chips: ""
+			}, createSlots({
+				loader: withCtx((loader) => [createVNode(field_loader_default, normalizeProps(guardReactiveProps(loader)), null, 16)]),
+				_: 2
+			}, [isMultiple.value ? {
+				name: "item",
+				fn: withCtx(({ props: itemProps }) => [createVNode(unref(VListItem), normalizeProps(guardReactiveProps(itemProps)), {
+					prepend: withCtx(({ isSelected }) => [createVNode(unref(VCheckboxBtn), {
+						"model-value": isSelected,
+						ripple: false,
+						inert: "",
+						"aria-hidden": "true"
+					}, null, 8, ["model-value"])]),
+					title: withCtx(() => [createVNode(unref(VHighlight), {
+						text: itemProps.title,
+						query: search.value,
+						"match-all": "",
+						"ignore-case": "",
+						"mark-class": maskClass.value
+					}, null, 8, [
+						"text",
+						"query",
+						"mark-class"
+					])]),
+					_: 2
+				}, 1040)]),
+				key: "0"
+			} : void 0]), 1064, [
+				"modelValue",
+				"search",
+				"variant",
+				"items",
+				"data-testid",
+				"disabled",
+				"loading",
+				"aria-busy",
+				"readonly",
+				"label",
+				"placeholder",
+				"hint",
+				"clearable",
+				"multiple",
+				"rules",
+				"menu-props"
+			]);
+		};
+	}
+});
+//#endregion
+export { autocomplete_field_vue_vue_type_script_setup_true_lang_default as default };