@movk/nuxt 1.1.2 → 1.3.0

package/dist/runtime/types/zod.d.ts

@@ -1,18 +1,18 @@
-import type { AutoFormFieldContext, AutoFormFieldSlots, AutoFormNestedCollapsible } from '#movk/types/auto-form'
-import type { ClassNameValue } from 'tailwind-merge'
+import type { AutoFormFieldContext, AutoFormFieldSlots, AutoFormNestedCollapsible } from './auto-form/fields'
+import type { ClassNameValue } from './shared'
 import type { ReactiveValue } from '@movk/core'
 
 type ZodValue<T, CTX = AutoFormFieldContext> = ReactiveValue<T, CTX>
 
 export interface ZodAutoFormFieldMeta {
   /**
-   * The element or component this component should render as.
+   * 当前字段渲染使用的元素或组件。
    * @defaultValue 'div'
    */
   as?: ZodValue<any>
-  /** The name of the FormField. Also used to match form errors. */
+  /** 表单字段名，同时用于匹配表单错误。 */
   name?: ZodValue<string>
-  /** A regular expression to match form error names. */
+  /** 用于匹配表单错误名称的正则表达式。 */
   errorPattern?: ZodValue<RegExp>
   label?: ZodValue<string>
   description?: ZodValue<string>
@@ -20,44 +20,46 @@ export interface ZodAutoFormFieldMeta {
   error?: ZodValue<boolean | string>
   hint?: ZodValue<string>
   /**
+   * 字段尺寸。
    * @defaultValue 'md'
    */
   size?: ZodValue<'md' | 'xs' | 'sm' | 'lg' | 'xl'>
   /**
+   * 是否必填。
    * @defaultValue true
    */
   required?: ZodValue<boolean>
-  /** If true, validation on input will be active immediately instead of waiting for a blur event. */
+  /** 是否在输入时立即触发校验（而不是等待 blur 事件）。 */
   eagerValidation?: ZodValue<boolean>
   /**
-   * Delay in milliseconds before validating the form on input events.
+   * 输入事件触发后，延迟多少毫秒执行表单校验。
    * @defaultValue `300`
    */
   validateOnInputDelay?: ZodValue<number>
+  /**
+   * 字段布局方向。
+   * @defaultValue 'vertical'
+   */
+  orientation?: ZodValue<'horizontal' | 'vertical'>
   class?: ZodValue<any>
-  ui?: ZodValue<{ root?: ClassNameValue, wrapper?: ClassNameValue, labelWrapper?: ClassNameValue, label?: strClassNameValueing, container?: ClassNameValue, description?: ClassNameValue, error?: ClassNameValue, hint?: ClassNameValue, help?: ClassNameValue }>
+  ui?: ZodValue<{ root?: ClassNameValue, wrapper?: ClassNameValue, labelWrapper?: ClassNameValue, label?: ClassNameValue, container?: ClassNameValue, description?: ClassNameValue, error?: ClassNameValue, hint?: ClassNameValue, help?: ClassNameValue }>
   /**
    * @see https://ui4.nuxt.com/docs/components/form-field#slots
    */
   fieldSlots?: ZodValue<Partial<AutoFormFieldSlots>>
-
   /** 显示条件 */
   if?: ZodValue<boolean>
   /** 是否隐藏 */
   hidden?: ZodValue<boolean>
-  /**
-   * object field
-   */
+  /** 对象字段折叠配置。 */
   collapsible?: ZodValue<AutoFormNestedCollapsible>
 
-  /** 索引签名，允许动态属性访问 */
-  [key: string]: unknown
 }
 
-declare module 'zod/v4' {
-
-  interface GlobalMeta extends ZodAutoFormFieldMeta { }
+type ShallowGlobalMeta<T> = { [K in keyof T]?: unknown }
 
+declare module 'zod' {
+  interface GlobalMeta extends ShallowGlobalMeta<ZodAutoFormFieldMeta> { }
 }
 
 export { }

package/dist/runtime/utils/extend-theme.d.ts

@@ -0,0 +1,19 @@
+import type { ComputedRef } from 'vue';
+import type { ClassNameValue } from '../types';
+type SlotsLike = {
+    slots: Record<string, unknown>;
+};
+type MergeParams = {
+    ui?: Record<string, ClassNameValue>;
+    variants?: Record<string, unknown>;
+};
+type BaseKeys<P extends SlotsLike> = string & keyof P['slots'];
+type ExtraKeys<P extends SlotsLike, M extends SlotsLike> = string & Exclude<keyof M['slots'], keyof P['slots']>;
+type AllKeys<P extends SlotsLike, M extends SlotsLike> = string & (keyof P['slots'] | keyof M['slots']);
+interface ExtendedTv<P extends SlotsLike, M extends SlotsLike> {
+    extendUi: ComputedRef<Record<AllKeys<P, M>, string>>;
+    baseUi: ComputedRef<Record<BaseKeys<P>, string>>;
+    extraUi: ComputedRef<Record<ExtraKeys<P, M>, string>>;
+}
+export declare function useExtendedTv<P extends SlotsLike, M extends SlotsLike>(parentTheme: P, movkTheme: M, getOverride?: () => unknown, getParams?: () => MergeParams): ExtendedTv<P, M>;
+export {};

package/dist/runtime/utils/extend-theme.js

@@ -0,0 +1,44 @@
+import { computed } from "vue";
+import { tv } from "./tv.js";
+export function useExtendedTv(parentTheme, movkTheme, getOverride = () => ({}), getParams = () => ({})) {
+  const parentSlotKeys = new Set(Object.keys(parentTheme.slots));
+  const emptySlots = Object.fromEntries(
+    Object.keys(parentTheme.slots).map((key) => [key, ""])
+  );
+  const extendUi = computed(() => {
+    const ov = getOverride() ?? {};
+    const { ui: uiOverride, variants } = getParams();
+    const tvFn = tv({
+      slots: { ...emptySlots, ...ov.slots },
+      ...ov.variants ? { variants: ov.variants } : {},
+      ...ov.compoundVariants ? { compoundVariants: ov.compoundVariants } : {},
+      ...ov.defaultVariants ? { defaultVariants: ov.defaultVariants } : {},
+      extend: tv(movkTheme)
+    });
+    const cls = tvFn(variants);
+    const slotKeys = new Set(Object.keys(cls));
+    const result = Object.fromEntries(
+      Object.entries(uiOverride ?? {}).filter(
+        ([key]) => !slotKeys.has(key)
+      )
+    );
+    for (const key of slotKeys) {
+      const slotFn = cls[key];
+      if (!slotFn) continue;
+      const merged = slotFn({ class: uiOverride?.[key] || void 0 });
+      if (merged) result[key] = merged;
+    }
+    return result;
+  });
+  const baseUi = computed(
+    () => Object.fromEntries(
+      Object.entries(extendUi.value).filter(([k]) => parentSlotKeys.has(k))
+    )
+  );
+  const extraUi = computed(
+    () => Object.fromEntries(
+      Object.entries(extendUi.value).filter(([k]) => !parentSlotKeys.has(k))
+    )
+  );
+  return { extendUi, baseUi, extraUi };
+}

package/dist/runtime/utils/form-control.d.ts

@@ -0,0 +1,33 @@
+export declare function omitProps<T extends object, K extends keyof T>(props: T, keys: readonly K[]): Omit<T, K>;
+export declare function useForwardedProps<T extends object, K extends keyof T>(props: T, keys: readonly K[]): import("vue").ComputedRef<Omit<T, K>>;
+type SizeProps = {
+    size?: unknown;
+};
+export declare function useFormFieldBridge<S = unknown, T extends SizeProps = SizeProps>(props?: T): {
+    size: import("vue").ComputedRef<S | undefined>;
+    emitFormInput: () => void;
+    emitFormBlur: () => void;
+    emitFormChange: () => void;
+    emitFormFocus: () => void;
+};
+type FieldControlProps = {
+    size?: unknown;
+    color?: unknown;
+    disabled?: boolean;
+};
+export declare function useFieldControl<T extends FieldControlProps>(props: T): {
+    size: import("vue").ComputedRef<NonNullable<T["size"]> | undefined>;
+    disabled: import("vue").ComputedRef<boolean>;
+    color: import("vue").ComputedRef<"error" | NonNullable<T["color"]> | undefined>;
+    fieldGroupSize: import("vue").ComputedRef<"xs" | "sm" | "md" | "lg" | "xl" | NonNullable<import("@nuxt/ui").GetObjectField<T, "size">> | undefined>;
+    fieldGroupOrientation: import("vue").ComputedRef<"horizontal" | "vertical" | undefined>;
+    id: import("vue").ComputedRef<string | undefined>;
+    name: import("vue").ComputedRef<string | undefined>;
+    highlight: import("vue").ComputedRef<boolean | undefined>;
+    emitFormBlur: () => void;
+    emitFormInput: import("@vueuse/core").UseDebounceFnReturn<() => void>;
+    emitFormChange: () => void;
+    emitFormFocus: () => void;
+    ariaAttrs: import("vue").ComputedRef<Record<string, any> | undefined>;
+};
+export {};

package/dist/runtime/utils/form-control.js

@@ -0,0 +1,54 @@
+import { computed, inject } from "vue";
+import {
+  formBusInjectionKey,
+  formFieldInjectionKey,
+  useFormField
+} from "@nuxt/ui/composables/useFormField";
+import { fieldGroupInjectionKey, useFieldGroup } from "@nuxt/ui/composables/useFieldGroup";
+export function omitProps(props, keys) {
+  const omitted = new Set(keys);
+  return Object.fromEntries(
+    Object.entries(props).filter(([key, value]) => !omitted.has(key) && value !== void 0)
+  );
+}
+export function useForwardedProps(props, keys) {
+  return computed(() => omitProps(props, keys));
+}
+export function useFormFieldBridge(props) {
+  const formBus = inject(formBusInjectionKey, void 0);
+  const formField = inject(formFieldInjectionKey, void 0);
+  const fieldGroup = inject(fieldGroupInjectionKey, void 0);
+  function emitFormEvent(type) {
+    const field = formField?.value;
+    if (!formBus || !field?.name) return;
+    formBus.emit({
+      type,
+      name: field.name,
+      ...type === "input" ? { eager: field.eagerValidation } : {}
+    });
+  }
+  return {
+    size: computed(
+      () => props?.size ?? fieldGroup?.value.size ?? formField?.value.size
+    ),
+    emitFormInput: () => emitFormEvent("input"),
+    emitFormBlur: () => emitFormEvent("blur"),
+    emitFormChange: () => emitFormEvent("change"),
+    emitFormFocus: () => emitFormEvent("focus")
+  };
+}
+export function useFieldControl(props) {
+  const formField = useFormField(props);
+  const fieldGroup = useFieldGroup(props);
+  const size = computed(() => fieldGroup.size.value || formField.size.value);
+  const disabled = computed(() => formField.disabled.value ?? props.disabled ?? false);
+  const color = computed(() => formField.color.value ?? props.color);
+  return {
+    ...formField,
+    size,
+    disabled,
+    color,
+    fieldGroupSize: fieldGroup.size,
+    fieldGroupOrientation: fieldGroup.orientation
+  };
+}

package/dist/runtime/utils/meta.d.ts

@@ -0,0 +1,4 @@
+export declare function getPackageJsonMetadata(dir: string): Promise<{
+    name?: string;
+    description?: string;
+}>;

package/dist/runtime/utils/meta.js

@@ -0,0 +1,14 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+export async function getPackageJsonMetadata(dir) {
+  try {
+    const packageJson = await readFile(resolve(dir, "package.json"), "utf-8");
+    const parsed = JSON.parse(packageJson);
+    return {
+      name: parsed.name,
+      description: parsed.description
+    };
+  } catch {
+    return {};
+  }
+}

package/dist/runtime/utils/theme-defaults.d.ts

@@ -0,0 +1,27 @@
+import type { Direction } from '@nuxt/ui';
+import type { ModuleOptions } from '../../module';
+/**
+ * movk 主题默认 app.config（Nuxt 模式 addTheme 与 Vue 模式 unplugin 共用）。
+ * 放在 runtime 内，避免 runtime 反向依赖构建期 `src/utils`（dist 运行时无法解析）。
+ */
+export declare function getDefaultConfig(theme?: ModuleOptions['theme']): {
+    dir: Direction;
+    radius: number;
+    blackAsPrimary: boolean;
+    font: string;
+    icons: string;
+    prefix: string | undefined;
+    tv: {
+        twMergeConfig: {
+            prefix: string | undefined;
+        };
+    };
+    picker: {
+        fonts: {
+            name: string;
+            href?: string;
+        }[];
+        radiuses: number[];
+        neutralColors: string[];
+    };
+};

package/dist/runtime/utils/theme-defaults.js

@@ -0,0 +1,28 @@
+export function getDefaultConfig(theme) {
+  const pickerFonts = theme?.fonts ?? [
+    { name: "Alibaba PuHuiTi", href: "https://cdn.mhaibaraai.cn/fonts/alibaba-puhuiti.css" },
+    { name: "Public Sans" },
+    { name: "DM Sans" },
+    { name: "Geist" },
+    { name: "Inter" },
+    { name: "Poppins" },
+    { name: "Outfit" },
+    { name: "Raleway" }
+  ];
+  const pickerRadiuses = theme?.radiuses ?? [0, 0.125, 0.25, 0.375, 0.5];
+  const pickerNeutralColors = theme?.neutralColors ?? ["slate", "gray", "zinc", "neutral", "stone", "taupe", "mauve", "mist", "olive"];
+  return {
+    dir: "ltr",
+    radius: 0.25,
+    blackAsPrimary: false,
+    font: "Alibaba PuHuiTi",
+    icons: "lucide",
+    prefix: theme?.prefix,
+    tv: {
+      twMergeConfig: {
+        prefix: theme?.prefix
+      }
+    },
+    picker: { fonts: pickerFonts, radiuses: pickerRadiuses, neutralColors: pickerNeutralColors }
+  };
+}

package/dist/runtime/utils/tv.d.ts

@@ -0,0 +1 @@
+export declare const tv: import("tailwind-variants").TV;

package/dist/runtime/utils/tv.js

@@ -0,0 +1,4 @@
+import { createTV } from "tailwind-variants";
+import appConfig from "#build/app.config";
+const appConfigTv = appConfig;
+export const tv = /* @__PURE__ */ createTV(appConfigTv.movk?.tv);

package/dist/runtime/vue/composables/useSiteConfig.d.ts

@@ -0,0 +1,13 @@
+interface SiteConfigStub {
+    url: string;
+    name: string;
+    description: string;
+    defaultLocale: string;
+}
+/**
+ * Vue 模式下 `nuxt-site-config` 的 useSiteConfig 桩。
+ * name 经 unplugin 的 options.site 注入 app.config（movkSite），默认非空以避免
+ * useTheme/theme 插件的 localStorage key 前缀退化。
+ */
+export declare function useSiteConfig(): SiteConfigStub;
+export {};

package/dist/runtime/vue/composables/useSiteConfig.js

@@ -0,0 +1,11 @@
+import appConfig from "#build/app.config";
+export function useSiteConfig() {
+  const injected = appConfig.movkSite ?? {};
+  return {
+    url: "",
+    name: "movk",
+    description: "",
+    defaultLocale: "en",
+    ...injected
+  };
+}

package/dist/runtime/vue/plugins/theme.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Vue 模式主题插件：仅做 color-mode 初始化（从 localStorage 恢复主色/中性色/图标集）。
+ * 剥离了 Nuxt 模式 theme 插件中的 server 端 useHead FOUC 脚本与 site-config 依赖。
+ */
+declare const _default: any;
+export default _default;

package/dist/runtime/vue/plugins/theme.js

@@ -0,0 +1,14 @@
+import { defineNuxtPlugin, useAppConfig, useSiteConfig } from "#imports";
+import { kebabCase } from "@movk/core";
+import { themeIcons } from "../../domains/theme/theme-icons.js";
+export default defineNuxtPlugin(() => {
+  const appConfig = useAppConfig();
+  const site = useSiteConfig();
+  const name = kebabCase(site.name);
+  const primary = localStorage.getItem(`${name}-ui-primary`);
+  if (primary) appConfig.ui.colors.primary = primary;
+  const neutral = localStorage.getItem(`${name}-ui-neutral`);
+  if (neutral) appConfig.ui.colors.neutral = neutral;
+  const icons = localStorage.getItem(`${name}-ui-icons`);
+  if (icons) appConfig.ui.icons = themeIcons[icons];
+});

package/dist/runtime/vue/stubs/base.d.ts

@@ -0,0 +1,2 @@
+export * from '@nuxt/ui/runtime/vue/stubs/base.js';
+export * from './movk-extra';

package/dist/runtime/vue/stubs/base.js

@@ -0,0 +1,2 @@
+export * from "@nuxt/ui/runtime/vue/stubs/base.js";
+export * from "./movk-extra.js";

package/dist/runtime/vue/stubs/inertia.d.ts

@@ -0,0 +1,2 @@
+export * from '@nuxt/ui/runtime/vue/stubs/inertia.js';
+export * from './movk-extra';

package/dist/runtime/vue/stubs/inertia.js

@@ -0,0 +1,2 @@
+export * from "@nuxt/ui/runtime/vue/stubs/inertia.js";
+export * from "./movk-extra.js";

package/dist/runtime/vue/stubs/movk-extra.d.ts

@@ -0,0 +1,2 @@
+export { useSiteConfig } from '../composables/useSiteConfig';
+export { useOverlay } from '@nuxt/ui/composables';

package/dist/runtime/vue/stubs/movk-extra.js

@@ -0,0 +1,2 @@
+export { useSiteConfig } from "../composables/useSiteConfig.js";
+export { useOverlay } from "@nuxt/ui/composables";

package/dist/runtime/vue/stubs/none.d.ts

@@ -0,0 +1,2 @@
+export * from '@nuxt/ui/runtime/vue/stubs/none.js';
+export * from './movk-extra';

package/dist/runtime/vue/stubs/none.js

@@ -0,0 +1,2 @@
+export * from "@nuxt/ui/runtime/vue/stubs/none.js";
+export * from "./movk-extra.js";

package/dist/runtime/vue/stubs/vue-router.d.ts

@@ -0,0 +1,2 @@
+export * from '@nuxt/ui/runtime/vue/stubs/vue-router.js';
+export * from './movk-extra';

package/dist/runtime/vue/stubs/vue-router.js

@@ -0,0 +1,2 @@
+export * from "@nuxt/ui/runtime/vue/stubs/vue-router.js";
+export * from "./movk-extra.js";