feat: initial commit - Phase 1 & 2 core features

2026-04-22 17:07:33 +08:00
commit 1773bda06b
25005 changed files with 6252106 additions and 0 deletions
@@ -0,0 +1,57 @@
+import { EpPropFinalized, ExtractPropType } from "../../utils/vue/props/types.js";
+import "../../utils/index.js";
+import * as vue from "vue";
+import { ExtractPropTypes, ExtractPublicPropTypes, Ref } from "vue";
+
+//#region ../../packages/hooks/use-model-toggle/index.d.ts
+declare const _prop: EpPropFinalized<(new (...args: any[]) => boolean) | (() => boolean | null) | (((new (...args: any[]) => boolean) | (() => boolean | null)) | null)[], never, never, null, false>;
+declare const _event: {
+  readonly type: vue.PropType<(val: boolean) => void>;
+  readonly required: false;
+  readonly validator: ((val: unknown) => boolean) | undefined;
+  __epPropKey: true;
+};
+type UseModelTogglePropsRaw<T extends string> = { [K in T]: typeof _prop } & { [K in `onUpdate:${T}`]: typeof _event };
+type UseModelTogglePropsGeneric<T extends string> = { [K in T]: ExtractPropType<typeof _prop> } & { [K in `onUpdate:${T}`]: ExtractPropType<typeof _event> };
+declare const createModelToggleComposable: <T extends string>(name: T) => {
+  useModelToggle: ({
+    indicator,
+    toggleReason,
+    shouldHideWhenRouteChanges,
+    shouldProceed,
+    onShow,
+    onHide
+  }: ModelToggleParams) => {
+    hide: (event?: Event) => void;
+    show: (event?: Event) => void;
+    toggle: () => void;
+    hasUpdateHandler: vue.ComputedRef<boolean>;
+  };
+  useModelToggleProps: UseModelTogglePropsRaw<T>;
+  useModelToggleEmits: `update:${T}`[];
+};
+declare const useModelToggle: ({
+    indicator,
+    toggleReason,
+    shouldHideWhenRouteChanges,
+    shouldProceed,
+    onShow,
+    onHide
+  }: ModelToggleParams) => {
+    hide: (event?: Event) => void;
+    show: (event?: Event) => void;
+    toggle: () => void;
+    hasUpdateHandler: vue.ComputedRef<boolean>;
+  }, useModelToggleProps: UseModelTogglePropsRaw<"modelValue">, useModelToggleEmits: "update:modelValue"[];
+type UseModelToggleProps = ExtractPropTypes<typeof useModelToggleProps>;
+type UseModelTogglePropsPublic = ExtractPublicPropTypes<typeof useModelToggleProps>;
+type ModelToggleParams = {
+  indicator: Ref<boolean>;
+  toggleReason?: Ref<Event | undefined>;
+  shouldHideWhenRouteChanges?: Ref<boolean>;
+  shouldProceed?: () => boolean;
+  onShow?: (event?: Event) => void;
+  onHide?: (event?: Event) => void;
+};
+//#endregion
+export { ModelToggleParams, UseModelToggleProps, UseModelTogglePropsGeneric, UseModelTogglePropsPublic, UseModelTogglePropsRaw, createModelToggleComposable, useModelToggle, useModelToggleEmits, useModelToggleProps };
@@ -0,0 +1,85 @@
+import { isClient } from "../../utils/browser.mjs";
+import { isBoolean, isFunction } from "../../utils/types.mjs";
+import { buildProp, definePropType } from "../../utils/vue/props/runtime.mjs";
+import { computed, getCurrentInstance, onMounted, watch } from "vue";
+
+//#region ../../packages/hooks/use-model-toggle/index.ts
+const _prop = buildProp({
+	type: definePropType(Boolean),
+	default: null
+});
+const _event = buildProp({ type: definePropType(Function) });
+const createModelToggleComposable = (name) => {
+	const updateEventKey = `update:${name}`;
+	const updateEventKeyRaw = `onUpdate:${name}`;
+	const useModelToggleEmits = [updateEventKey];
+	const useModelToggleProps = {
+		[name]: _prop,
+		[updateEventKeyRaw]: _event
+	};
+	const useModelToggle = ({ indicator, toggleReason, shouldHideWhenRouteChanges, shouldProceed, onShow, onHide }) => {
+		const instance = getCurrentInstance();
+		const { emit } = instance;
+		const props = instance.props;
+		const hasUpdateHandler = computed(() => isFunction(props[updateEventKeyRaw]));
+		const isModelBindingAbsent = computed(() => props[name] === null);
+		const doShow = (event) => {
+			if (indicator.value === true) return;
+			indicator.value = true;
+			if (toggleReason) toggleReason.value = event;
+			if (isFunction(onShow)) onShow(event);
+		};
+		const doHide = (event) => {
+			if (indicator.value === false) return;
+			indicator.value = false;
+			if (toggleReason) toggleReason.value = event;
+			if (isFunction(onHide)) onHide(event);
+		};
+		const show = (event) => {
+			if (props.disabled === true || isFunction(shouldProceed) && !shouldProceed()) return;
+			const shouldEmit = hasUpdateHandler.value && isClient;
+			if (shouldEmit) emit(updateEventKey, true);
+			if (isModelBindingAbsent.value || !shouldEmit) doShow(event);
+		};
+		const hide = (event) => {
+			if (props.disabled === true || !isClient) return;
+			const shouldEmit = hasUpdateHandler.value && isClient;
+			if (shouldEmit) emit(updateEventKey, false);
+			if (isModelBindingAbsent.value || !shouldEmit) doHide(event);
+		};
+		const onChange = (val) => {
+			if (!isBoolean(val)) return;
+			if (props.disabled && val) {
+				if (hasUpdateHandler.value) emit(updateEventKey, false);
+			} else if (indicator.value !== val) if (val) doShow();
+			else doHide();
+		};
+		const toggle = () => {
+			if (indicator.value) hide();
+			else show();
+		};
+		watch(() => props[name], onChange);
+		if (shouldHideWhenRouteChanges && instance.appContext.config.globalProperties.$route !== void 0) watch(() => ({ ...instance.proxy.$route }), () => {
+			if (shouldHideWhenRouteChanges.value && indicator.value) hide();
+		});
+		onMounted(() => {
+			onChange(props[name]);
+		});
+		return {
+			hide,
+			show,
+			toggle,
+			hasUpdateHandler
+		};
+	};
+	return {
+		useModelToggle,
+		useModelToggleProps,
+		useModelToggleEmits
+	};
+};
+const { useModelToggle, useModelToggleProps, useModelToggleEmits } = createModelToggleComposable("modelValue");
+
+//#endregion
+export { createModelToggleComposable, useModelToggle, useModelToggleEmits, useModelToggleProps };
+//# sourceMappingURL=index.mjs.map