@movk/nuxt 0.1.1 → 1.1.0

package/dist/runtime/components/input/WithCopy.d.vue.ts

@@ -1,9 +1,14 @@
 import type { InputProps, InputValue } from '@nuxt/ui';
 import type { WithCopyProps } from '../../types/components.js';
-declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<(WithCopyProps<import("@nuxt/ui/.").AcceptableValue> & {
+declare const __VLS_export: <T extends InputValue>(__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<(WithCopyProps<import("@nuxt/ui/.").AcceptableValue> & {
         modelValue?: InputProps["modelValue"];
-    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "copy", value: string) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue | undefined) => void)>>> & import("vue").PublicProps & (typeof globalThis extends {
+    }) & {
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        onCopy?: ((value: string) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: import("@nuxt/ui/.").AcceptableValue | undefined) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
@@ -15,6 +20,8 @@ declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awai
 };
 declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
     [K in keyof T as K]: T[K];
-} & {};
+}) & {};

package/dist/runtime/components/input/WithCopy.vue.d.ts

@@ -1,9 +1,14 @@
 import type { InputProps, InputValue } from '@nuxt/ui';
 import type { WithCopyProps } from '../../types/components.js';
-declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<(WithCopyProps<import("@nuxt/ui/.").AcceptableValue> & {
+declare const __VLS_export: <T extends InputValue>(__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<(WithCopyProps<import("@nuxt/ui/.").AcceptableValue> & {
         modelValue?: InputProps["modelValue"];
-    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "copy", value: string) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue | undefined) => void)>>> & import("vue").PublicProps & (typeof globalThis extends {
+    }) & {
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        onCopy?: ((value: string) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: import("@nuxt/ui/.").AcceptableValue | undefined) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
@@ -15,6 +20,8 @@ declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awai
 };
 declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
     [K in keyof T as K]: T[K];
-} & {};
+}) & {};

package/dist/runtime/components/input/WithPasswordToggle.d.vue.ts

@@ -1,9 +1,13 @@
 import type { InputProps, InputValue } from '@nuxt/ui';
 import type { WithPasswordToggleProps } from '../../types/components.js';
-declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<(WithPasswordToggleProps<import("@nuxt/ui/.").AcceptableValue> & {
+declare const __VLS_export: <T extends InputValue>(__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<(WithPasswordToggleProps<import("@nuxt/ui/.").AcceptableValue> & {
         modelValue?: InputProps["modelValue"];
-    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue | undefined) => void)>>> & import("vue").PublicProps & (typeof globalThis extends {
+    }) & {
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: import("@nuxt/ui/.").AcceptableValue | undefined) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
@@ -15,6 +19,8 @@ declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awai
 };
 declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
     [K in keyof T as K]: T[K];
-} & {};
+}) & {};

package/dist/runtime/components/input/WithPasswordToggle.vue.d.ts

@@ -1,9 +1,13 @@
 import type { InputProps, InputValue } from '@nuxt/ui';
 import type { WithPasswordToggleProps } from '../../types/components.js';
-declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awaited<typeof __VLS_setup>>["props"], __VLS_ctx?: __VLS_PrettifyLocal<Pick<NonNullable<Awaited<typeof __VLS_setup>>, "attrs" | "emit" | "slots">>, __VLS_expose?: NonNullable<Awaited<typeof __VLS_setup>>["expose"], __VLS_setup?: Promise<{
-    props: __VLS_PrettifyLocal<(WithPasswordToggleProps<import("@nuxt/ui/.").AcceptableValue> & {
+declare const __VLS_export: <T extends InputValue>(__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<(WithPasswordToggleProps<import("@nuxt/ui/.").AcceptableValue> & {
         modelValue?: InputProps["modelValue"];
-    }) & __VLS_EmitsToProps<__VLS_NormalizeEmits<((evt: "blur", event: FocusEvent) => void) & ((evt: "change", event: Event) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue) => void) & ((evt: "update:modelValue", value: import("@nuxt/ui/.").AcceptableValue | undefined) => void)>>> & import("vue").PublicProps & (typeof globalThis extends {
+    }) & {
+        onBlur?: ((event: FocusEvent) => any) | undefined;
+        onChange?: ((event: Event) => any) | undefined;
+        "onUpdate:modelValue"?: ((value: import("@nuxt/ui/.").AcceptableValue | undefined) => any) | undefined;
+    }> & (typeof globalThis extends {
         __VLS_PROPS_FALLBACK: infer P;
     } ? P : {});
     expose: (exposed: {}) => void;
@@ -15,6 +19,8 @@ declare const __VLS_export: <T extends InputValue>(__VLS_props: NonNullable<Awai
 };
 declare const _default: typeof __VLS_export;
 export default _default;
-type __VLS_PrettifyLocal<T> = {
+type __VLS_PrettifyLocal<T> = (T extends any ? {
+    [K in keyof T]: T[K];
+} : {
     [K in keyof T as K]: T[K];
-} & {};
+}) & {};

package/dist/runtime/components/theme-picker/ThemePicker.d.vue.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/theme-picker/ThemePicker.vue

@@ -0,0 +1,235 @@
+<script setup>
+import { useAppConfig, useColorMode } from "#imports";
+import { useClipboard } from "@vueuse/core";
+import { ref } from "vue";
+import { useTheme } from "../../composables/useTheme";
+import ThemePickerButton from "./ThemePickerButton.vue";
+const appConfig = useAppConfig();
+const colorMode = useColorMode();
+const open = ref(false);
+const { copy: copyCSS, copied: copiedCSS } = useClipboard();
+const { copy: copyAppConfig, copied: copiedAppConfig } = useClipboard();
+const {
+  neutralColors,
+  neutral,
+  primaryColors,
+  primary,
+  setBlackAsPrimary,
+  radiuses,
+  radius,
+  fonts,
+  font,
+  modes,
+  mode,
+  hasCSSChanges,
+  hasAppConfigChanges,
+  exportCSS,
+  exportAppConfig,
+  resetTheme
+} = useTheme();
+</script>
+
+<template>
+  <UPopover
+    v-model:open="open"
+    :ui="{ content: 'w-72 px-6 py-4 flex flex-col gap-4 overflow-y-auto max-h-[calc(100vh-5rem)]' }"
+  >
+    <template #default>
+      <UButton
+        icon="i-lucide-swatch-book"
+        color="neutral"
+        :variant="open ? 'soft' : 'ghost'"
+        square
+        aria-label="Color picker"
+        :ui="{ leadingIcon: 'text-primary' }"
+      />
+    </template>
+
+    <template #content>
+      <fieldset>
+        <legend class="text-[11px] leading-none font-semibold mb-2 select-none flex items-center gap-1">
+          Primary
+
+          <UButton
+            to="https://ui.nuxt.com/docs/getting-started/theme/css-variables#colors"
+            size="xs"
+            color="neutral"
+            variant="link"
+            target="_blank"
+            icon="i-lucide-circle-help"
+            class="p-0 -my-0.5"
+            :ui="{ leadingIcon: 'size-3' }"
+          />
+        </legend>
+
+        <div class="grid grid-cols-3 gap-1 -mx-2">
+          <ThemePickerButton label="Black" :selected="appConfig.theme.blackAsPrimary" @click="setBlackAsPrimary(true)">
+            <template #leading>
+              <span class="inline-block w-2 h-2 rounded-full bg-black dark:bg-white" />
+            </template>
+          </ThemePickerButton>
+
+          <ThemePickerButton
+            v-for="color in primaryColors"
+            :key="color"
+            :label="color"
+            :chip="color"
+            :selected="!appConfig.theme.blackAsPrimary && primary === color"
+            @click="primary = color"
+          />
+        </div>
+      </fieldset>
+
+      <fieldset>
+        <legend class="text-[11px] leading-none font-semibold mb-2 select-none flex items-center gap-1">
+          Neutral
+
+          <UButton
+            to="https://ui.nuxt.com/docs/getting-started/theme/css-variables#text"
+            size="xs"
+            color="neutral"
+            variant="link"
+            target="_blank"
+            icon="i-lucide-circle-help"
+            class="p-0 -my-0.5"
+            :ui="{ leadingIcon: 'size-3' }"
+          />
+        </legend>
+
+        <div class="grid grid-cols-3 gap-1 -mx-2">
+          <ThemePickerButton
+            v-for="color in neutralColors"
+            :key="color"
+            :label="color"
+            :chip="color === 'neutral' ? 'old-neutral' : color"
+            :selected="neutral === color"
+            @click="neutral = color"
+          />
+        </div>
+      </fieldset>
+
+      <fieldset>
+        <legend class="text-[11px] leading-none font-semibold mb-2 select-none flex items-center gap-1">
+          Radius
+
+          <UButton
+            to="https://ui.nuxt.com/docs/getting-started/theme/css-variables#radius"
+            size="xs"
+            color="neutral"
+            variant="link"
+            target="_blank"
+            icon="i-lucide-circle-help"
+            class="p-0 -my-0.5"
+            :ui="{ leadingIcon: 'size-3' }"
+          />
+        </legend>
+
+        <div class="grid grid-cols-5 gap-1 -mx-2">
+          <ThemePickerButton
+            v-for="r in radiuses"
+            :key="r"
+            :label="String(r)"
+            class="justify-center px-0"
+            :selected="radius === r"
+            @click="radius = r"
+          />
+        </div>
+      </fieldset>
+
+      <fieldset>
+        <legend class="text-[11px] leading-none font-semibold mb-2 select-none flex items-center gap-1">
+          Font
+
+          <UButton
+            to="https://ui.nuxt.com/docs/getting-started/integrations/fonts"
+            size="xs"
+            color="neutral"
+            variant="link"
+            target="_blank"
+            icon="i-lucide-circle-help"
+            class="p-0 -my-0.5"
+            :ui="{ leadingIcon: 'size-3' }"
+          />
+        </legend>
+
+        <div class="-mx-2">
+          <USelect
+            v-model="font"
+            size="sm"
+            color="neutral"
+            icon="i-lucide-type"
+            :items="fonts"
+            class="w-full ring-default rounded-sm hover:bg-elevated/50 text-[11px] data-[state=open]:bg-elevated/50"
+            :ui="{ trailingIcon: 'group-data-[state=open]:rotate-180 transition-transform duration-200' }"
+          />
+        </div>
+      </fieldset>
+
+      <fieldset>
+        <legend class="text-[11px] leading-none font-semibold mb-2 select-none flex items-center gap-1">
+          Color Mode
+
+          <UButton
+            to="https://ui.nuxt.com/docs/getting-started/integrations/color-mode"
+            size="xs"
+            color="neutral"
+            variant="link"
+            target="_blank"
+            icon="i-lucide-circle-help"
+            class="p-0 -my-0.5"
+            :ui="{ leadingIcon: 'size-3' }"
+          />
+        </legend>
+
+        <div class="grid grid-cols-3 gap-1 -mx-2">
+          <ThemePickerButton
+            v-for="m in modes"
+            :key="m.label"
+            v-bind="m"
+            :selected="colorMode.preference === m.label"
+            @click="mode = m.label"
+          />
+        </div>
+      </fieldset>
+
+      <fieldset v-if="hasCSSChanges || hasAppConfigChanges">
+        <legend class="text-[11px] leading-none font-semibold mb-2 select-none">
+          Export
+        </legend>
+
+        <div class="flex items-center justify-between gap-1 -mx-2">
+          <UButton
+            v-if="hasCSSChanges"
+            color="neutral"
+            variant="soft"
+            size="sm"
+            label="main.css"
+            class="flex-1 text-[11px]"
+            :icon="copiedCSS ? appConfig.ui.icons.copyCheck : appConfig.ui.icons.copy"
+            @click="copyCSS(exportCSS())"
+          />
+          <UButton
+            v-if="hasAppConfigChanges"
+            color="neutral"
+            variant="soft"
+            size="sm"
+            label="app.config.ts"
+            :icon="copiedAppConfig ? appConfig.ui.icons.copyCheck : appConfig.ui.icons.copy"
+            class="flex-1 text-[11px]"
+            @click="copyAppConfig(exportAppConfig())"
+          />
+          <UTooltip text="Reset theme">
+            <UButton
+              color="neutral"
+              variant="outline"
+              size="sm"
+              icon="i-lucide-rotate-ccw"
+              class="ms-auto ring-default hover:bg-elevated/50"
+              @click="resetTheme"
+            />
+          </UTooltip>
+        </div>
+      </fieldset>
+    </template>
+  </UPopover>
+</template>

package/dist/runtime/components/theme-picker/ThemePicker.vue.d.ts

@@ -0,0 +1,3 @@
+declare const __VLS_export: import("vue").DefineComponent<{}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/runtime/components/theme-picker/ThemePickerButton.d.vue.ts

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    label: string;
+    icon?: string;
+    chip?: string;
+    selected?: boolean;
+};
+type __VLS_Slots = {
+    leading: () => any;
+};
+declare const __VLS_base: 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 __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/components/theme-picker/ThemePickerButton.vue

@@ -0,0 +1,34 @@
+<script setup>
+defineProps({
+  label: { type: String, required: true },
+  icon: { type: String, required: false },
+  chip: { type: String, required: false },
+  selected: { type: Boolean, required: false }
+});
+const slots = defineSlots();
+</script>
+
+<template>
+  <UButton
+    size="sm"
+    color="neutral"
+    variant="outline"
+    :icon="icon"
+    :label="label"
+    class="capitalize ring-default rounded-sm text-[11px]"
+    :class="selected ? 'bg-elevated' : 'hover:bg-elevated/50'"
+  >
+    <template v-if="chip || !!slots.leading" #leading>
+      <slot name="leading">
+        <span
+          class="inline-block size-2 rounded-full bg-(--color-light) dark:bg-(--color-dark)"
+
+          :style="{
+  '--color-light': `var(--color-${chip}-500)`,
+  '--color-dark': `var(--color-${chip}-400)`
+}"
+        />
+      </slot>
+    </template>
+  </UButton>
+</template>

package/dist/runtime/components/theme-picker/ThemePickerButton.vue.d.ts

@@ -0,0 +1,18 @@
+type __VLS_Props = {
+    label: string;
+    icon?: string;
+    chip?: string;
+    selected?: boolean;
+};
+type __VLS_Slots = {
+    leading: () => any;
+};
+declare const __VLS_base: 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 __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/runtime/composables/useApiAuth.d.ts

@@ -0,0 +1,47 @@
+import type { UseApiAuthReturn } from '../types/api.js';
+/**
+ * API 认证 Composable
+ *
+ * 提供完整的登录、登出、刷新用户信息等功能，
+ * 与 nuxt-auth-utils 无缝集成。
+ *
+ * @returns UseApiAuthReturn 认证相关方法和状态
+ *
+ * @example
+ * ```ts
+ * const { login, clear, loggedIn, user } = useApiAuth()
+ *
+ * // 基础登录
+ * await login({
+ *   loginPath: '/auth/login',
+ *   credentials: { username: 'admin', password: '123456' }
+ * })
+ *
+ * // 登录后获取用户信息
+ * await login({
+ *   loginPath: '/auth/login',
+ *   credentials: { username: 'admin', password: '123456' },
+ *   userInfoPath: '/auth/me'
+ * })
+ *
+ * // 自定义 token 提取和 session 构建
+ * await login({
+ *   loginPath: '/auth/login',
+ *   credentials: { username: 'admin', password: '123456' },
+ *   tokenExtractor: (res) => res.data?.accessToken,
+ *   sessionBuilder: (user, token) => ({
+ *     user: { id: user.id, name: user.name },
+ *     secure: { token, permissions: user.permissions }
+ *   })
+ * })
+ *
+ * // 登出
+ * await clear()
+ *
+ * // 响应式状态
+ * if (loggedIn.value) {
+ *   console.log('当前用户:', user.value)
+ * }
+ * ```
+ */
+export declare function useApiAuth(): UseApiAuthReturn;

package/dist/runtime/composables/useApiAuth.js

@@ -0,0 +1,66 @@
+import { getPath } from "@movk/core";
+import { useNuxtApp, useRuntimeConfig, useUserSession } from "#imports";
+export function useApiAuth() {
+  const { $api } = useNuxtApp();
+  const userSession = useUserSession();
+  const moduleConfig = useRuntimeConfig().public.movkApi;
+  const buildAuthHeader = (token, authConfig = {}) => {
+    const tokenType = authConfig.tokenType === "Custom" ? authConfig.customTokenType || "" : authConfig.tokenType || "Bearer";
+    return tokenType ? `${tokenType} ${token}` : token;
+  };
+  const getHeaderName = (authConfig = {}) => {
+    return authConfig.headerName || "Authorization";
+  };
+  const defaultTokenExtractor = (response) => {
+    return getPath(response, "data.token") ?? getPath(response, "data.accessToken") ?? getPath(response, "token");
+  };
+  const defaultSessionBuilder = (user, token) => ({
+    user,
+    token,
+    loggedInAt: (/* @__PURE__ */ new Date()).toISOString()
+  });
+  async function login(options) {
+    const {
+      loginPath,
+      credentials,
+      userInfoPath,
+      tokenExtractor = defaultTokenExtractor,
+      sessionBuilder = defaultSessionBuilder,
+      endpoint
+    } = options;
+    const api = endpoint ? $api.use(endpoint) : $api;
+    const loginResponse = await api.$fetch(loginPath, {
+      method: "POST",
+      body: credentials
+    });
+    const token = tokenExtractor(loginResponse);
+    if (!token) {
+      throw new Error("Login failed: token not found in response");
+    }
+    let userInfo;
+    if (userInfoPath) {
+      const endpointConfig = api.getConfig();
+      const authConfig = endpointConfig.auth || moduleConfig.auth || {};
+      const headerName = getHeaderName(authConfig);
+      const headerValue = buildAuthHeader(token, authConfig);
+      const userResponse = await api.$fetch(userInfoPath, {
+        headers: { [headerName]: headerValue },
+        context: { toast: false }
+      });
+      userInfo = getPath(userResponse, "data") ?? userResponse;
+    } else {
+      userInfo = getPath(loginResponse, "data") ?? loginResponse;
+    }
+    const sessionData = sessionBuilder(userInfo, token);
+    await $fetch("/api/_movk/session", {
+      method: "POST",
+      body: sessionData
+    });
+    await userSession.fetch();
+    return { user: userInfo, token };
+  }
+  return {
+    login,
+    ...userSession
+  };
+}

package/dist/runtime/composables/useApiFetch.d.ts

@@ -0,0 +1,42 @@
+import type { UseApiFetchOptions, UseApiFetchReturn } from '../types/api.js';
+/**
+ * API Fetch 组合式函数
+ *
+ * 基于 Nuxt useFetch 封装，提供：
+ * - 自动认证（从 session 获取 token）
+ * - 业务状态码检查
+ * - Toast 提示（通过内置 hooks 统一处理）
+ * - 自动数据解包
+ * - 支持用户自定义 hooks（与内置 hooks 合并执行）
+ *
+ * @typeParam ResT - API 响应 data 字段的原始类型
+ * @typeParam DataT - transform 转换后的最终类型（默认等于 ResT）
+ *
+ * @example
+ * ```ts
+ * // 基础用法（自动解包 data 字段）
+ * const { data, pending, error } = await useApiFetch<User[]>('/users')
+ *
+ * // POST 请求
+ * const { data } = await useApiFetch('/users', {
+ *   method: 'POST',
+ *   body: { name: 'test' }
+ * })
+ *
+ * // 自定义 transform（双泛型，接收解包后的数据）
+ * const { data } = await useApiFetch<{ content: User[] }, User[]>('/users', {
+ *   transform: ({ content }) => content ?? []
+ * })
+ *
+ * // 使用其他端点
+ * const { data } = await useApiFetch('/users', { endpoint: 'v2' })
+ *
+ * // 自定义 hooks（与内置 hooks 合并执行）
+ * const { data } = await useApiFetch('/users', {
+ *   onResponse({ response }) {
+ *     console.log('用户自定义处理:', response._data)
+ *   }
+ * })
+ * ```
+ */
+export declare function useApiFetch<ResT = unknown, DataT = ResT>(url: string | (() => string), options?: UseApiFetchOptions<ResT, DataT>): UseApiFetchReturn<DataT>;

package/dist/runtime/composables/useApiFetch.js

@@ -0,0 +1,41 @@
+import { useNuxtApp, useFetch } from "#imports";
+import { createTransform, mergeFetchHooks } from "../utils/api-utils.js";
+export function useApiFetch(url, options = {}) {
+  const { $api } = useNuxtApp();
+  const {
+    endpoint,
+    toast,
+    skipBusinessCheck = false,
+    transform: userTransform,
+    onRequest: userOnRequest,
+    onRequestError: userOnRequestError,
+    onResponse: userOnResponse,
+    onResponseError: userOnResponseError,
+    ...fetchOptions
+  } = options;
+  const apiInstance = endpoint ? $api.use(endpoint) : $api;
+  const endpointConfig = apiInstance.getConfig();
+  const builtinHooks = endpointConfig.builtinHooks || {};
+  const transformFn = createTransform({
+    skipBusinessCheck,
+    userTransform,
+    successConfig: endpointConfig.response
+  });
+  const mergedHooks = mergeFetchHooks(builtinHooks, {
+    onRequest: userOnRequest,
+    onRequestError: userOnRequestError,
+    onResponse: userOnResponse,
+    onResponseError: userOnResponseError
+  });
+  const context = { toast, skipBusinessCheck };
+  return useFetch(url, {
+    ...fetchOptions,
+    $fetch: apiInstance.$fetch,
+    transform: transformFn,
+    onRequest: mergedHooks.onRequest,
+    onRequestError: mergedHooks.onRequestError,
+    onResponse: mergedHooks.onResponse,
+    onResponseError: mergedHooks.onResponseError,
+    context
+  });
+}