@vizejs/ui 0.386.0 → 0.388.0

package/dist/share-button-DfvUDFC-.mjs

@@ -0,0 +1,243 @@
+import { t as _plugin_vue_export_helper_default } from "./_plugin-vue_export-helper-BOaGB7Aw.mjs";
+import { computed, createBlock, createElementVNode, defineComponent, guardReactiveProps, normalizeProps, openBlock, renderSlot, resolveDynamicComponent, shallowRef, toDisplayString, toRaw, useTemplateRef, withCtx } from "vue";
+//#region src/families/actions/share-button/share-button.vue?vue&type=script&setup=true&lang.ts
+const _hoisted_1 = {
+	"data-vize-ui": "share-button-label",
+	part: "label"
+};
+const SHARE_BUTTON_ACTION_UNAVAILABLE = "VIZE_UI_SHARE_BUTTON_ACTION_UNAVAILABLE";
+//#endregion
+//#region src/families/actions/share-button/share-button.vue
+var share_button_default = /*#__PURE__*/ _plugin_vue_export_helper_default(/* @__PURE__ */ defineComponent({
+	__name: "share-button",
+	props: {
+		as: {
+			type: null,
+			required: false,
+			default: "button"
+		},
+		native: {
+			type: Boolean,
+			required: false,
+			default: () => void 0
+		},
+		type: {
+			type: String,
+			required: false,
+			default: "button"
+		},
+		disabled: {
+			type: Boolean,
+			required: false,
+			default: false
+		},
+		title: {
+			type: String,
+			required: false,
+			default: () => void 0
+		},
+		text: {
+			type: String,
+			required: false,
+			default: () => void 0
+		},
+		url: {
+			type: String,
+			required: false,
+			default: () => void 0
+		},
+		files: {
+			type: Array,
+			required: false,
+			default: () => void 0
+		},
+		idleLabel: {
+			type: String,
+			required: false,
+			default: "Share"
+		},
+		sharingLabel: {
+			type: String,
+			required: false,
+			default: "Sharing"
+		},
+		sharedLabel: {
+			type: String,
+			required: false,
+			default: "Shared"
+		},
+		errorLabel: {
+			type: String,
+			required: false,
+			default: "Share failed"
+		},
+		ariaLabel: {
+			type: String,
+			required: false,
+			default: () => void 0
+		},
+		ariaLabelledby: {
+			type: String,
+			required: false,
+			default: () => void 0
+		},
+		ariaDescribedby: {
+			type: String,
+			required: false,
+			default: () => void 0
+		},
+		action: {
+			type: Function,
+			required: false,
+			default: void 0
+		}
+	},
+	emits: ["share", "error"],
+	setup(__props, { expose: __expose, emit: __emit }) {
+		const emit = __emit;
+		const element = useTemplateRef("element");
+		const stateValue = shallowRef("idle");
+		const isNativeButton = computed(() => __props.native ?? __props.as === "button");
+		const buttonType = computed(() => __props.type);
+		const disabledValue = computed(() => __props.disabled);
+		const sharingValue = computed(() => stateValue.value === "sharing");
+		const unavailable = computed(() => disabledValue.value || sharingValue.value);
+		const actionValue = computed(() => toRaw(__props.action ?? shareWithNavigator));
+		const payloadValue = computed(() => normalizeSharePayload({
+			files: __props.files,
+			text: __props.text,
+			title: __props.title,
+			url: __props.url
+		}));
+		const label = computed(() => stateValue.value === "sharing" ? __props.sharingLabel : stateValue.value === "shared" ? __props.sharedLabel : stateValue.value === "error" ? __props.errorLabel : __props.idleLabel);
+		const tabIndex = computed(() => {
+			if (isNativeButton.value) return void 0;
+			return disabledValue.value ? -1 : 0;
+		});
+		const ariaLabelValue = computed(() => hasText(__props.ariaLabel) ? __props.ariaLabel : void 0);
+		const ariaLabelledbyValue = computed(() => hasText(__props.ariaLabelledby) ? __props.ariaLabelledby : void 0);
+		const slotState = computed(() => ({
+			disabled: disabledValue.value,
+			label: label.value,
+			payload: payloadValue.value,
+			sharing: sharingValue.value,
+			state: stateValue.value,
+			unavailable: unavailable.value
+		}));
+		function onClick(event) {
+			if (unavailable.value) {
+				event.preventDefault();
+				event.stopImmediatePropagation();
+				return;
+			}
+			runShareAction(actionValue.value, payloadValue.value, event);
+		}
+		async function runShareAction(submittedAction, submittedPayload, event) {
+			stateValue.value = "sharing";
+			try {
+				await submittedAction(submittedPayload, event);
+				stateValue.value = "shared";
+				emit("share", submittedPayload, event);
+			} catch (error) {
+				stateValue.value = "error";
+				emit("error", error, submittedPayload, event);
+			}
+		}
+		function onKeyboard(event, phase) {
+			if (isNativeButton.value) return;
+			const keyboardAction = getShareButtonKeyboardAction(event.key, phase);
+			if (keyboardAction === "ignore") return;
+			event.preventDefault();
+			if (unavailable.value) {
+				event.stopImmediatePropagation();
+				return;
+			}
+			if (keyboardAction === "activate" && event.currentTarget instanceof HTMLElement) event.currentTarget.click();
+		}
+		function onKeydown(event) {
+			onKeyboard(event, "keydown");
+		}
+		function onKeyup(event) {
+			onKeyboard(event, "keyup");
+		}
+		function getShareButtonKeyboardAction(key, phase) {
+			if (key === "Enter") return phase === "keydown" ? "activate" : "ignore";
+			if (key === " ") return phase === "keydown" ? "prevent" : "activate";
+			return "ignore";
+		}
+		function focus(options) {
+			focusTarget(element.value, options);
+		}
+		function focusTarget(targetElement, options) {
+			if (typeof targetElement === "object" && targetElement !== null && "focus" in targetElement && typeof targetElement.focus === "function") targetElement.focus(options);
+		}
+		function normalizeSharePayload(source) {
+			const payload = {};
+			if (source.title !== void 0) payload.title = source.title;
+			if (source.text !== void 0) payload.text = source.text;
+			if (source.url !== void 0) payload.url = source.url;
+			if (source.files !== void 0) payload.files = [...source.files];
+			return payload;
+		}
+		async function shareWithNavigator(payload) {
+			const platformNavigator = globalThis.navigator;
+			const share = platformNavigator?.share;
+			if (typeof share !== "function") throw new Error(SHARE_BUTTON_ACTION_UNAVAILABLE);
+			await share.call(platformNavigator, payload);
+		}
+		function hasText(nextValue) {
+			return nextValue != null && nextValue.trim().length > 0;
+		}
+		__expose({
+			disabled: disabledValue,
+			element,
+			focus,
+			label,
+			payload: payloadValue,
+			sharing: sharingValue,
+			state: stateValue,
+			unavailable
+		});
+		return (_ctx, _cache) => {
+			return openBlock(), createBlock(resolveDynamicComponent(__props.as), {
+				ref_key: "element",
+				ref: element,
+				type: isNativeButton.value ? buttonType.value : void 0,
+				disabled: isNativeButton.value ? disabledValue.value : void 0,
+				role: isNativeButton.value ? void 0 : "button",
+				tabindex: tabIndex.value,
+				"aria-label": ariaLabelledbyValue.value === void 0 ? ariaLabelValue.value : void 0,
+				"aria-labelledby": ariaLabelledbyValue.value,
+				"aria-describedby": __props.ariaDescribedby,
+				"aria-disabled": unavailable.value && (!isNativeButton.value || sharingValue.value) ? "true" : void 0,
+				"aria-busy": sharingValue.value ? "true" : void 0,
+				"data-vize-ui": "share-button",
+				part: "root",
+				"data-state": stateValue.value,
+				"data-disabled": disabledValue.value ? "true" : void 0,
+				"data-sharing": sharingValue.value ? "true" : void 0,
+				onClick,
+				onKeydown,
+				onKeyup
+			}, {
+				default: withCtx(() => [renderSlot(_ctx.$slots, "default", normalizeProps(guardReactiveProps(slotState.value)), () => [createElementVNode("span", _hoisted_1, toDisplayString(label.value), 1)], true)]),
+				_: 3
+			}, 40, [
+				"type",
+				"disabled",
+				"role",
+				"tabindex",
+				"aria-label",
+				"aria-labelledby",
+				"aria-describedby",
+				"aria-disabled",
+				"aria-busy",
+				"data-state",
+				"data-disabled",
+				"data-sharing"
+			]);
+		};
+	}
+}), [["__scopeId", "data-v-cc52ed1d"]]);
+//#endregion
+export { share_button_default as t };

package/dist/share-button.d.mts

@@ -0,0 +1,2 @@
+import { Aa as ShareButtonSlotState, Ca as ShareButtonDataName, Da as ShareButtonPart, Ea as ShareButtonExpose, Ma as ShareButtonState, Na as ShareButtonType, Oa as ShareButtonPayload, Sa as ShareButtonDataAttribute, Ta as ShareButtonEmits, ba as ShareButtonAction, ja as ShareButtonSlots, ka as ShareButtonProps, wa as ShareButtonElement, xa as ShareButtonCssCustomProperty, ya as _default } from "./announcer-DGr2Iz0i.mjs";
+export { _default as ShareButton, type ShareButtonAction, type ShareButtonCssCustomProperty, type ShareButtonDataAttribute, type ShareButtonDataName, type ShareButtonElement, type ShareButtonEmits, type ShareButtonExpose, type ShareButtonPart, type ShareButtonPayload, type ShareButtonProps, type ShareButtonSlotState, type ShareButtonSlots, type ShareButtonState, type ShareButtonType };

package/dist/share-button.mjs

@@ -0,0 +1,2 @@
+import { t as share_button_default } from "./share-button-DfvUDFC-.mjs";
+export { share_button_default as ShareButton };