/** * globals.d.ts —— UMD 全局变量的 TypeScript 声明(README §3.3-1「禁 import 框架」的类型侧配套)。 * * 背景:框架运行时全部走 index.html 引入的 UMD 全局(Vue / VueRouter / Pinia / ElementPlus / axios), * 业务代码不 import 框架模块。 * 落点说明:本文件放**仓库根**(而非 src/types)——shims/ 目录在 src 之外, * 若声明放 src 内则 shims 文件不生效(全局声明只对 include 范围生效)。 * 本文件做两件事: * ① 声明 5 个 UMD 全局常量(typeof 引自已安装的同版本 dev 依赖,类型与运行时一一对应); * ② 声明 vite define 注入的组合式 API 裸标识符(ref / computed / onMounted …), * 使业务代码里"裸写 ref()"既能通过类型检查、又能在运行时命中 Vue 全局。 * * 版本纪律:dev 依赖版本必须与 index.html 头部"vendor 版本表"保持一致(升级走 README §1.5 五步流程)。 */ import type { AxiosStatic } from 'axios'; import type { Language } from 'element-plus'; import type * as PiniaNS from 'pinia'; import type * as VueNS from 'vue'; import type * as VueRouterNS from 'vue-router'; declare global { // —— UMD 全局常量(index.html 按序注入)—— const Vue: typeof VueNS; /** * vue-demi 桥接全局(vendor/vue-demi@0.14.10 注入):读 globalThis.Vue 后把 Vue API * 镜像到本全局。纯 Vue3 下等价于 re-export Vue;业务代码不直接引用, * 仅供 pinia IIFE 构建内部取用(pinia 官方构建硬依赖 VueDemi 全局)。声明仅为全局清单完整。 */ var VueDemi: typeof VueNS; const VueRouter: typeof VueRouterNS; const Pinia: typeof PiniaNS; /** var 声明(而非 const):允许 globalThis.ElementPlus 属性式访问(http.ts 拦截器内)+ 模板回退解析 */ var ElementPlus: typeof import('element-plus'); /** Element Plus 简体中文 locale(vendor/element-plus@2.14.7/locale/zh-cn.min.js 注入) */ var ElementPlusLocaleZhCn: Language; /** UMD 全局 axios 是**实例**(root.axios = 默认实例,含 post/get/create),类型 = AxiosStatic */ var axios: AxiosStatic; // —— vite define 注入的组合式 API 裸标识符(vite.config.ts VUE_APIS 清单与之一一对应)—— const ref: typeof VueNS.ref; const shallowRef: typeof VueNS.shallowRef; const reactive: typeof VueNS.reactive; const shallowReactive: typeof VueNS.shallowReactive; const readonly: typeof VueNS.readonly; const shallowReadonly: typeof VueNS.shallowReadonly; const computed: typeof VueNS.computed; const watch: typeof VueNS.watch; const watchEffect: typeof VueNS.watchEffect; const watchPostEffect: typeof VueNS.watchPostEffect; const watchSyncEffect: typeof VueNS.watchSyncEffect; const effectScope: typeof VueNS.effectScope; const customRef: typeof VueNS.customRef; const triggerRef: typeof VueNS.triggerRef; const toRef: typeof VueNS.toRef; const toRefs: typeof VueNS.toRefs; const toRaw: typeof VueNS.toRaw; const toValue: typeof VueNS.toValue; const markRaw: typeof VueNS.markRaw; const isRef: typeof VueNS.isRef; const isReactive: typeof VueNS.isReactive; const isReadonly: typeof VueNS.isReadonly; const isVNode: typeof VueNS.isVNode; const unref: typeof VueNS.unref; const onMounted: typeof VueNS.onMounted; const onBeforeMount: typeof VueNS.onBeforeMount; const onUnmounted: typeof VueNS.onUnmounted; const onBeforeUnmount: typeof VueNS.onBeforeUnmount; const onUpdated: typeof VueNS.onUpdated; const onBeforeUpdate: typeof VueNS.onBeforeUpdate; const onActivated: typeof VueNS.onActivated; const onDeactivated: typeof VueNS.onDeactivated; const onErrorCaptured: typeof VueNS.onErrorCaptured; const onRenderTracked: typeof VueNS.onRenderTracked; const onRenderTriggered: typeof VueNS.onRenderTriggered; const onScopeDispose: typeof VueNS.onScopeDispose; const nextTick: typeof VueNS.nextTick; const createApp: typeof VueNS.createApp; const inject: typeof VueNS.inject; const provide: typeof VueNS.provide; const h: typeof VueNS.h; // —— Vue Router(define 注入为 VueRouter.*)—— const createRouter: typeof VueRouterNS.createRouter; const createWebHashHistory: typeof VueRouterNS.createWebHashHistory; const createWebHistory: typeof VueRouterNS.createWebHistory; const useRoute: typeof VueRouterNS.useRoute; const useRouter: typeof VueRouterNS.useRouter; // —— Pinia(define 注入为 Pinia.*)—— const defineStore: typeof PiniaNS.defineStore; const createPinia: typeof PiniaNS.createPinia; const storeToRefs: typeof PiniaNS.storeToRefs; } export {};