@yh-ui/components 0.1.16 → 0.1.21

package/dist/smart-address/src/smart-address.vue

@@ -0,0 +1,966 @@
+<script setup>
+import { ref, computed, reactive } from "vue";
+import { useNamespace } from "@yh-ui/hooks";
+import { useComponentTheme } from "@yh-ui/theme";
+import { useLocale } from "@yh-ui/hooks";
+import { smartAddressProps, smartAddressEmits } from "./smart-address";
+import { parseAddress } from "./use-address-parser";
+import { YhSelect, YhOption } from "../../select";
+import { YhCascader } from "../../cascader";
+defineOptions({ name: "YhSmartAddress" });
+const props = defineProps(smartAddressProps);
+const emit = defineEmits(smartAddressEmits);
+const ns = useNamespace("smart-address");
+const { themeStyle } = useComponentTheme(
+  "smart-address",
+  computed(() => props.themeOverrides)
+);
+const { t, tRaw } = useLocale();
+const rawText = ref("");
+const parseStatus = ref("idle");
+const parseTip = ref("");
+function getValueByLabel(options, label) {
+  if (!label) return null;
+  const match = options.find((opt) => opt[props.labelField] === label);
+  return match ? match[props.valueField] : null;
+}
+function handleParse() {
+  if (!rawText.value.trim()) return;
+  const getKw = (p) => {
+    const res = tRaw(p);
+    return Array.isArray(res) ? res : void 0;
+  };
+  const parseOptions = {
+    provinceKeywords: getKw("smartaddress.provinceKeywords"),
+    cityKeywords: getKw("smartaddress.cityKeywords"),
+    districtKeywords: getKw("smartaddress.districtKeywords"),
+    streetKeywords: getKw("smartaddress.streetKeywords")
+  };
+  const result = props.parser ? props.parser(rawText.value) : parseAddress(rawText.value, parseOptions);
+  const hasRegion = result.province || result.city || result.district || result.detail;
+  if (!hasRegion && !result.phone && !result.name) {
+    parseStatus.value = "error";
+    parseTip.value = t("smartaddress.parseFailed");
+    return;
+  }
+  const provinceVal = getValueByLabel(props.regionOptions, result.province) || result.province;
+  let cityVal = result.city;
+  const provinceMatch = props.regionOptions.find((opt) => opt[props.labelField] === result.province);
+  const provinceChildren = provinceMatch?.[props.childrenField] || [];
+  if (provinceChildren.length) {
+    cityVal = getValueByLabel(provinceChildren, result.city) || result.city;
+  }
+  let districtVal = result.district;
+  const cityMatch = provinceChildren.find((opt) => opt[props.labelField] === result.city);
+  const cityChildren = cityMatch?.[props.childrenField] || [];
+  if (cityChildren.length) {
+    districtVal = getValueByLabel(cityChildren, result.district) || result.district;
+  }
+  const newVal = {
+    name: result.name || innerVal.name,
+    phone: result.phone || innerVal.phone,
+    province: provinceVal || innerVal.province,
+    city: cityVal || innerVal.city,
+    district: districtVal || innerVal.district,
+    street: result.street || innerVal.street,
+    detail: result.detail || innerVal.detail
+  };
+  Object.assign(innerVal, newVal);
+  parseStatus.value = "success";
+  parseTip.value = t("smartaddress.parseSuccess");
+  rawText.value = "";
+  emit("update:modelValue", { ...innerVal });
+  emit("parsed", result);
+  emit("change", { ...innerVal });
+  setTimeout(() => {
+    parseStatus.value = "idle";
+    parseTip.value = "";
+  }, 3e3);
+}
+const innerVal = reactive({ ...props.modelValue });
+function updateField(field, value) {
+  innerVal[field] = value;
+  emit("update:modelValue", { ...innerVal });
+  emit("change", { ...innerVal });
+}
+const provinceOptions = computed(() => {
+  return props.regionOptions.map((p) => ({
+    label: p[props.labelField] || "",
+    value: p[props.valueField] || ""
+  }));
+});
+const cityOptions = computed(() => {
+  if (!innerVal.province) return [];
+  const p = props.regionOptions.find((opt) => opt[props.valueField] === innerVal.province);
+  const children = p?.[props.childrenField] || [];
+  if (children.length) {
+    return children.map((c) => ({
+      label: c[props.labelField] || "",
+      value: c[props.valueField] || ""
+    }));
+  }
+  return [];
+});
+const districtOptions = computed(() => {
+  if (!innerVal.province || !innerVal.city) return [];
+  const p = props.regionOptions.find((opt) => opt[props.valueField] === innerVal.province);
+  const provinceChildren = p?.[props.childrenField] || [];
+  if (provinceChildren.length) {
+    const c = provinceChildren.find((child) => child[props.valueField] === innerVal.city);
+    const cityChildren = c?.[props.childrenField] || [];
+    if (cityChildren.length) {
+      return cityChildren.map((d) => ({
+        label: d[props.labelField] || "",
+        value: d[props.valueField] || ""
+      }));
+    }
+  }
+  return [];
+});
+const cascaderOptions = computed(() => {
+  const transform = (opts) => {
+    return opts.map((opt) => ({
+      label: opt[props.labelField] || "",
+      value: opt[props.valueField] || "",
+      children: opt[props.childrenField] ? transform(opt[props.childrenField]) : void 0
+    }));
+  };
+  return transform(props.regionOptions);
+});
+const regionCascaderValue = computed({
+  get() {
+    const vals = [];
+    if (innerVal.province) vals.push(innerVal.province);
+    if (innerVal.city) vals.push(innerVal.city);
+    if (innerVal.district) vals.push(innerVal.district);
+    return vals;
+  },
+  set(val) {
+    const arr = val;
+    if (Array.isArray(arr)) {
+      updateField("province", arr[0] || "");
+      updateField("city", arr[1] || "");
+      updateField("district", arr[2] || "");
+    } else {
+      updateField("province", "");
+      updateField("city", "");
+      updateField("district", "");
+    }
+  }
+});
+const placeholder = computed(() => props.parsePlaceholder || t("smartaddress.placeholder"));
+const btnText = computed(() => props.parseButtonText || t("smartaddress.parse"));
+</script>
+
+<template>
+  <div :class="[ns.b(), ns.is('disabled', disabled)]" :style="themeStyle">
+    <!-- 智能识别区 -->
+    <div v-if="showParser" :class="ns.e('parser')">
+      <textarea
+        v-model="rawText"
+        :class="ns.e('parser-input')"
+        :placeholder="placeholder"
+        :disabled="disabled"
+        rows="3"
+        :aria-label="t('smartaddress.parse')"
+      ></textarea>
+      <div :class="ns.e('parser-actions')">
+        <span
+          v-if="parseTip"
+          :class="[ns.e('parser-tip'), ns.is('success', parseStatus === 'success'), ns.is('error', parseStatus === 'error')]"
+        >
+          {{ parseTip }}
+        </span>
+        <button
+          :class="ns.e('parse-btn')"
+          :disabled="disabled || !rawText.trim()"
+          @click="handleParse"
+        >
+          <slot name="parse-icon">✦</slot>
+          {{ btnText }}
+        </button>
+      </div>
+    </div>
+
+    <!-- 结构化字段 -->
+    <div :class="[ns.e('fields'), ns.is('top', labelPlacement === 'top')]">
+      <!-- 姓名 -->
+      <div v-if="showName" :class="ns.e('field')">
+        <label :class="[ns.e('label'), ns.is('required', required)]">
+          {{ t("smartaddress.name") }}
+        </label>
+        <input
+          :class="ns.e('input')"
+          :value="innerVal.name"
+          :disabled="disabled"
+          :placeholder="`${t('smartaddress.name')}...`"
+          @input="e => updateField('name', e.target.value)"
+        />
+      </div>
+
+      <!-- 手机号 -->
+      <div v-if="showPhone" :class="ns.e('field')">
+        <label :class="[ns.e('label'), ns.is('required', required)]">
+          {{ t("smartaddress.phone") }}
+        </label>
+        <input
+          :class="ns.e('input')"
+          :value="innerVal.phone"
+          :disabled="disabled"
+          type="tel"
+          inputmode="numeric"
+          maxlength="11"
+          :placeholder="`${t('smartaddress.phone')}...`"
+          @input="e => updateField('phone', e.target.value)"
+        />
+      </div>
+
+      <!-- 省/市/区 三个下拉（当前简化为 input，可由外部插槽替换为 Cascader） -->
+      <div :class="[ns.e('field'), ns.e('region')]">
+        <label :class="[ns.e('label'), ns.is('required', required)]">
+          {{ t("smartaddress.province") }}
+        </label>
+        <slot name="region" :value="innerVal" :update="updateField">
+          <!-- 输入框模式 -->
+          <div v-if="regionType === 'input'" :class="ns.e('region-inputs')">
+            <input
+              :class="ns.e('input')"
+              :value="innerVal.province"
+              :disabled="disabled"
+              :placeholder="t('smartaddress.province')"
+              @input="e => updateField('province', e.target.value)"
+            />
+            <input
+              :class="ns.e('input')"
+              :value="innerVal.city"
+              :disabled="disabled"
+              :placeholder="t('smartaddress.city')"
+              @input="e => updateField('city', e.target.value)"
+            />
+            <input
+              :class="ns.e('input')"
+              :value="innerVal.district"
+              :disabled="disabled"
+              :placeholder="t('smartaddress.district')"
+              @input="e => updateField('district', e.target.value)"
+            />
+          </div>
+
+          <!-- 下拉框模式 -->
+          <div v-else-if="regionType === 'select'" :class="ns.e('region-inputs')">
+            <YhSelect
+              :model-value="innerVal.province"
+              :disabled="disabled"
+              :placeholder="t('smartaddress.province')"
+              style="flex: 1; min-width: 0"
+              @update:model-value="val => {
+  updateField('province', val);
+  updateField('city', '');
+  updateField('district', '');
+}"
+            >
+              <YhOption
+                v-for="opt in provinceOptions"
+                :key="opt.value"
+                :label="opt.label"
+                :value="opt.value"
+              />
+            </YhSelect>
+            <YhSelect
+              :model-value="innerVal.city"
+              :disabled="disabled"
+              :placeholder="t('smartaddress.city')"
+              style="flex: 1; min-width: 0"
+              @update:model-value="val => {
+  updateField('city', val);
+  updateField('district', '');
+}"
+            >
+              <YhOption
+                v-for="opt in cityOptions"
+                :key="opt.value"
+                :label="opt.label"
+                :value="opt.value"
+              />
+            </YhSelect>
+            <YhSelect
+              :model-value="innerVal.district"
+              :disabled="disabled"
+              :placeholder="t('smartaddress.district')"
+              style="flex: 1; min-width: 0"
+              @update:model-value="val => updateField('district', val)"
+            >
+              <YhOption
+                v-for="opt in districtOptions"
+                :key="opt.value"
+                :label="opt.label"
+                :value="opt.value"
+              />
+            </YhSelect>
+          </div>
+
+          <!-- 级联模式 -->
+          <div v-else-if="regionType === 'cascader'" :class="ns.e('region-inputs')">
+            <YhCascader
+              v-model="regionCascaderValue"
+              :options="cascaderOptions"
+              :disabled="disabled"
+              :placeholder="t('smartaddress.province')"
+              style="width: 100%"
+            />
+          </div>
+        </slot>
+      </div>
+
+      <!-- 街道（可选） -->
+      <div v-if="showStreet" :class="ns.e('field')">
+        <label :class="ns.e('label')">
+          {{ t("smartaddress.street") }}
+        </label>
+        <input
+          :class="ns.e('input')"
+          :value="innerVal.street"
+          :disabled="disabled"
+          :placeholder="`${t('smartaddress.street')}...`"
+          @input="e => updateField('street', e.target.value)"
+        />
+      </div>
+
+      <!-- 详细地址 -->
+      <div :class="ns.e('field')">
+        <label :class="[ns.e('label'), ns.is('required', required)]">
+          {{ t("smartaddress.detail") }}
+        </label>
+        <input
+          :class="ns.e('input')"
+          :value="innerVal.detail"
+          :disabled="disabled"
+          :placeholder="`${t('smartaddress.detail')}...`"
+          @input="e => updateField('detail', e.target.value)"
+        />
+      </div>
+
+      <!-- 自定义扩展字段区 -->
+      <slot name="extra" :value="innerVal" :update="updateField" />
+    </div>
+  </div>
+</template>
+
+<style>
+@charset "UTF-8";
+/**
+ * YH-UI CSS Variables
+ * 全局 CSS 变量定义 - 业内最佳主题系统
+ */
+:root {
+  /* ==================== 密度/紧凑度系统 ==================== */
+  --yh-density-factor: 1;
+  --yh-component-size-default: 32px;
+  --yh-component-size-small: 24px;
+  --yh-component-size-large: 40px;
+  --yh-padding-default: 12px 16px;
+  --yh-padding-small: 8px 12px;
+  --yh-padding-large: 16px 20px;
+  --yh-spacing-unit: 8px;
+  /* ==================== 基础颜色 ==================== */
+  --yh-color-white: #ffffff;
+  --yh-color-black: #000000;
+  /* ==================== 颜色系统 ==================== */
+  /* 主色 */
+  --yh-color-primary: #409eff;
+  --yh-color-primary-light-1: #53a8ff;
+  --yh-color-primary-light-2: #66b1ff;
+  --yh-color-primary-light-3: #79bbff;
+  --yh-color-primary-light-4: #8cc5ff;
+  --yh-color-primary-light-5: #a0cfff;
+  --yh-color-primary-light-6: #b3d8ff;
+  --yh-color-primary-light-7: #c6e2ff;
+  --yh-color-primary-light-8: #d9ecff;
+  --yh-color-primary-light-9: #ecf5ff;
+  --yh-color-primary-dark-2: #337ecc;
+  /* 成功色 */
+  --yh-color-success: #67c23a;
+  --yh-color-success-light-3: #95d475;
+  --yh-color-success-light-5: #b3e19d;
+  --yh-color-success-light-7: #d1edc4;
+  --yh-color-success-light-9: #f0f9eb;
+  --yh-color-success-dark-2: #529b2e;
+  /* 警告色 */
+  --yh-color-warning: #e6a23c;
+  --yh-color-warning-light-3: #eebe77;
+  --yh-color-warning-light-5: #f3d19e;
+  --yh-color-warning-light-7: #f8e3c5;
+  --yh-color-warning-light-9: #fdf6ec;
+  --yh-color-warning-dark-2: #b88230;
+  /* 危险色 */
+  --yh-color-danger: #f56c6c;
+  --yh-color-danger-light-3: #f89898;
+  --yh-color-danger-light-5: #fab6b6;
+  --yh-color-danger-light-7: #fcd3d3;
+  --yh-color-danger-light-9: #fef0f0;
+  --yh-color-danger-dark-2: #c45656;
+  /* 信息色 */
+  --yh-color-info: #909399;
+  --yh-color-info-light-3: #b1b3b8;
+  --yh-color-info-light-5: #c8c9cc;
+  --yh-color-info-light-7: #dedfe0;
+  --yh-color-info-light-9: #f4f4f5;
+  --yh-color-info-dark-2: #73767a;
+  /* 文字颜色 */
+  --yh-text-color-primary: #303133;
+  --yh-text-color-regular: #606266;
+  --yh-text-color-secondary: #909399;
+  --yh-text-color-placeholder: #a8abb2;
+  --yh-text-color-disabled: #c0c4cc;
+  /* 边框颜色 */
+  --yh-border-color: #dcdfe6;
+  --yh-border-color-hover: var(--yh-color-primary);
+  --yh-border-color-light: #e4e7ed;
+  --yh-border-color-lighter: #ebeef5;
+  --yh-border-color-extra-light: #f2f6fc;
+  --yh-border-color-dark: #d4d7de;
+  --yh-border-color-darker: #cdd0d6;
+  /* 填充颜色 */
+  --yh-fill-color: #f0f2f5;
+  --yh-fill-color-light: #f5f7fa;
+  --yh-fill-color-lighter: #fafafa;
+  --yh-fill-color-extra-light: #fafcff;
+  --yh-fill-color-dark: #ebedf0;
+  --yh-fill-color-darker: #e6e8eb;
+  --yh-fill-color-blank: #ffffff;
+  /* 背景颜色 */
+  --yh-bg-color: #ffffff;
+  --yh-bg-color-page: #f2f3f5;
+  --yh-bg-color-overlay: #ffffff;
+  /* ==================== 间距系统 ==================== */
+  --yh-spacing-none: 0;
+  --yh-spacing-xs: 4px;
+  --yh-spacing-sm: 8px;
+  --yh-spacing-md: 16px;
+  --yh-spacing-lg: 24px;
+  --yh-spacing-xl: 32px;
+  --yh-spacing-xxl: 48px;
+  /* ==================== 圆角系统 ==================== */
+  --yh-radius-none: 0;
+  --yh-radius-sm: 2px;
+  --yh-radius-base: 4px;
+  --yh-radius-md: 8px;
+  --yh-radius-lg: 12px;
+  --yh-radius-xl: 16px;
+  --yh-radius-round: 20px;
+  --yh-radius-circle: 50%;
+  /* ==================== 字体系统 ==================== */
+  --yh-font-family:
+    -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, 'Noto Sans',
+    sans-serif, 'Apple Color Emoji', 'Segoe UI Emoji', 'Segoe UI Symbol', 'Noto Color Emoji';
+  /* 字号 */
+  --yh-font-size-xs: 12px;
+  --yh-font-size-sm: 13px;
+  --yh-font-size-base: 14px;
+  --yh-font-size-md: 16px;
+  --yh-font-size-lg: 18px;
+  --yh-font-size-xl: 20px;
+  --yh-font-size-xxl: 24px;
+  /* 行高 */
+  --yh-line-height-none: 1;
+  --yh-line-height-tight: 1.25;
+  --yh-line-height-snug: 1.375;
+  --yh-line-height-normal: 1.5;
+  --yh-line-height-relaxed: 1.625;
+  --yh-line-height-loose: 2;
+  /* 字重 */
+  --yh-font-weight-light: 300;
+  --yh-font-weight-normal: 400;
+  --yh-font-weight-medium: 500;
+  --yh-font-weight-semibold: 600;
+  --yh-font-weight-bold: 700;
+  /* ==================== 阴影系统 ==================== */
+  --yh-shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
+  --yh-shadow-base: 0 1px 3px 0 rgba(0, 0, 0, 0.1), 0 1px 2px -1px rgba(0, 0, 0, 0.1);
+  --yh-shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1);
+  --yh-shadow-lg: 0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1);
+  --yh-shadow-xl: 0 20px 25px -5px rgba(0, 0, 0, 0.1), 0 8px 10px -6px rgba(0, 0, 0, 0.1);
+  /* ==================== 过渡动效 ==================== */
+  --yh-duration-fast: 150ms;
+  --yh-duration-base: 200ms;
+  --yh-duration-slow: 300ms;
+  --yh-timing-ease: ease;
+  --yh-timing-ease-in: cubic-bezier(0.4, 0, 1, 1);
+  --yh-timing-ease-out: cubic-bezier(0, 0, 0.2, 1);
+  --yh-timing-ease-in-out: cubic-bezier(0.4, 0, 0.2, 1);
+  --yh-timing-linear: linear;
+  --yh-transition-base: all var(--yh-duration-base) var(--yh-timing-ease-in-out);
+  --yh-transition-fast: all var(--yh-duration-fast) var(--yh-timing-ease-in-out);
+  --yh-transition-slow: all var(--yh-duration-slow) var(--yh-timing-ease-in-out);
+  /* ==================== 层级系统 ==================== */
+  --yh-z-index-normal: 1;
+  --yh-z-index-top: 1000;
+  --yh-z-index-popper: 2000;
+  --yh-z-index-overlay: 2001;
+  --yh-z-index-modal: 2002;
+  --yh-z-index-popover: 2003;
+  --yh-z-index-tooltip: 2004;
+  --yh-z-index-loading: 2005;
+  /* ==================== 组件尺寸 ==================== */
+  /* Large */
+  --yh-component-size-large: 40px;
+  --yh-component-size-large-font: 14px;
+  --yh-component-size-large-padding: 20px;
+  /* Default */
+  --yh-component-size-default: 32px;
+  --yh-component-size-default-font: 14px;
+  --yh-component-size-default-padding: 16px;
+  /* Small */
+  --yh-component-size-small: 24px;
+  --yh-component-size-small-font: 12px;
+  --yh-component-size-small-padding: 12px;
+  /* ==================== 组件语义化变量 ==================== */
+  --yh-border-radius-base: var(--yh-radius-base);
+  --yh-border-radius-small: var(--yh-radius-sm);
+  --yh-border-radius-round: var(--yh-radius-round);
+  /* Message 消息提示 */
+  --yh-message-bg-color: var(--yh-bg-color-overlay);
+  --yh-message-border-color: var(--yh-border-color-lighter);
+  --yh-message-shadow: var(--yh-shadow-lg);
+  --yh-message-text-color: var(--yh-text-color-primary);
+  --yh-message-close-color: var(--yh-text-color-secondary);
+  --yh-message-close-hover-color: var(--yh-text-color-primary);
+  /* Notification 通知 */
+  --yh-notification-bg-color: var(--yh-bg-color-overlay);
+  --yh-notification-border-color: var(--yh-border-color-lighter);
+  --yh-notification-shadow: var(--yh-shadow-lg);
+  --yh-notification-title-color: var(--yh-text-color-primary);
+  --yh-notification-content-color: var(--yh-text-color-regular);
+  /* Badge 徽标 */
+  --yh-badge-bg-color: var(--yh-color-danger);
+  --yh-badge-text-color: #ffffff;
+  --yh-badge-border-color: var(--yh-bg-color);
+  /* Card 卡片 */
+  --yh-card-bg-color: var(--yh-bg-color-overlay);
+  --yh-card-border-color: var(--yh-border-color-lighter);
+  --yh-card-shadow: var(--yh-shadow-base);
+  --yh-card-header-padding: 18px 20px;
+  --yh-card-body-padding: 20px;
+  /* Input 输入框 */
+  --yh-input-bg-color: var(--yh-fill-color-blank);
+  --yh-input-text-color: var(--yh-text-color-regular);
+  --yh-input-border-color: var(--yh-border-color);
+  --yh-input-hover-border-color: var(--yh-color-primary);
+  --yh-input-focus-border-color: var(--yh-color-primary);
+  --yh-input-placeholder-color: var(--yh-text-color-placeholder);
+  --yh-input-icon-color: var(--yh-text-color-placeholder);
+  --yh-input-disabled-bg-color: var(--yh-fill-color-light);
+  --yh-input-disabled-text-color: var(--yh-text-color-disabled);
+  --yh-input-disabled-border-color: var(--yh-border-color-light);
+  /* Image 图片 */
+  --yh-image-placeholder-bg-color: var(--yh-fill-color-light);
+  --yh-image-placeholder-text-color: var(--yh-text-color-placeholder);
+  --yh-image-error-bg-color: var(--yh-fill-color-extra-light);
+  --yh-image-error-text-color: var(--yh-text-color-placeholder);
+  /* Image Viewer 预览器 */
+  --yh-image-viewer-mask-bg-color: rgba(0, 0, 0, 0.5);
+  --yh-image-viewer-btn-bg-color: var(--yh-text-color-regular);
+  --yh-image-viewer-btn-color: #ffffff;
+  --yh-image-viewer-btn-hover-bg-color: var(--yh-color-primary);
+  /* Calendar 日历 */
+  --yh-calendar-bg: linear-gradient(135deg, #ffffff 0%, #f8fafc 100%);
+  --yh-calendar-border-color: rgba(0, 0, 0, 0.06);
+  --yh-calendar-border-radius: var(--yh-radius-xl);
+  --yh-calendar-header-bg: rgba(255, 255, 255, 0.95);
+  --yh-calendar-header-border: rgba(0, 0, 0, 0.04);
+  --yh-calendar-header-padding: 18px 22px;
+  --yh-calendar-body-padding: 14px 18px 18px;
+  /* Calendar 尺寸 */
+  --yh-calendar-cell-height: 85px;
+  --yh-calendar-cell-height-small: 52px;
+  --yh-calendar-cell-height-large: 110px;
+  --yh-calendar-cell-radius: 10px;
+  --yh-calendar-cell-radius-small: 6px;
+  --yh-calendar-cell-radius-large: 12px;
+  /* Calendar 颜色 */
+  --yh-calendar-primary: var(--yh-color-primary);
+  --yh-calendar-primary-light: rgba(59, 130, 246, 0.1);
+  --yh-calendar-selected-bg: linear-gradient(135deg, #eff6ff 0%, #dbeafe 100%);
+  --yh-calendar-selected-border: rgba(59, 130, 246, 0.4);
+  --yh-calendar-today-dot: var(--yh-color-primary);
+  --yh-calendar-weekend-color: #f97316;
+  --yh-calendar-disabled-color: var(--yh-text-color-disabled);
+  --yh-calendar-other-month-opacity: 0.35;
+  /* Calendar 假日 */
+  --yh-calendar-holiday-color: var(--yh-color-success);
+  --yh-calendar-holiday-bg: rgba(16, 185, 129, 0.12);
+  --yh-calendar-holiday-border: rgba(16, 185, 129, 0.25);
+  --yh-calendar-workday-color: var(--yh-color-warning);
+  --yh-calendar-workday-bg: rgba(245, 158, 11, 0.12);
+  --yh-calendar-workday-border: rgba(245, 158, 11, 0.25);
+  /* Calendar 范围选择 */
+  --yh-calendar-range-bg: rgba(59, 130, 246, 0.08);
+  --yh-calendar-range-border: rgba(59, 130, 246, 0.2);
+  /* Calendar 字体 */
+  --yh-calendar-weekday-font-size: var(--yh-font-size-sm);
+  --yh-calendar-weekday-color: var(--yh-text-color-secondary);
+  --yh-calendar-day-font-size: 15px;
+  --yh-calendar-day-color: var(--yh-text-color-primary);
+  --yh-calendar-badge-font-size: 9px;
+  /* Table 表格 */
+  --yh-table-border-color: var(--yh-border-color-lighter);
+  --yh-table-header-bg: var(--yh-fill-color-light);
+  --yh-table-header-text-color: var(--yh-text-color-primary);
+  --yh-table-header-font-weight: var(--yh-font-weight-semibold);
+  --yh-table-row-bg: var(--yh-bg-color);
+  --yh-table-row-hover-bg: var(--yh-fill-color-light);
+  --yh-table-row-stripe-bg: var(--yh-fill-color-lighter);
+  --yh-table-row-current-bg: var(--yh-color-primary-light-9);
+  --yh-table-row-selected-bg: var(--yh-color-primary-light-8);
+  --yh-table-row-success-bg: var(--yh-color-success-light-9);
+  --yh-table-row-warning-bg: var(--yh-color-warning-light-9);
+  --yh-table-text-color: var(--yh-text-color-regular);
+  --yh-table-empty-text-color: var(--yh-text-color-secondary);
+  --yh-table-font-size: var(--yh-font-size-base);
+  --yh-table-cell-padding: 12px 0;
+  --yh-table-cell-spacing: 12px;
+  --yh-table-fixed-left-shadow: inset 10px 0 8px -8px rgba(0, 0, 0, 0.15);
+  --yh-table-fixed-right-shadow: inset -10px 0 8px -8px rgba(0, 0, 0, 0.15);
+  /* ==================== 边框基础 ==================== */
+  --yh-border-width: 1px;
+  --yh-border-style: solid;
+  --yh-border: var(--yh-border-width) var(--yh-border-style) var(--yh-border-color);
+  /* ==================== 断点系统 ==================== */
+  --yh-breakpoint-xs: 0;
+  --yh-breakpoint-sm: 576px;
+  --yh-breakpoint-md: 768px;
+  --yh-breakpoint-lg: 992px;
+  --yh-breakpoint-xl: 1200px;
+  --yh-breakpoint-xxl: 1400px;
+  /* ==================== 字体系统扩展 ==================== */
+  --yh-font-family-monospace:
+    'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, Courier, monospace;
+  --yh-font-family-serif: Georgia, Cambria, 'Times New Roman', Times, serif;
+  /* ==================== 无障碍/聚焦系统 ==================== */
+  --yh-focus-ring-color: var(--yh-color-primary);
+  --yh-focus-ring-width: 2px;
+  --yh-focus-ring-offset: 2px;
+  --yh-focus-ring-opacity: 0.2;
+  --yh-focus-ring:
+    0 0 0 var(--yh-focus-ring-offset) var(--yh-bg-color),
+    0 0 0 calc(var(--yh-focus-ring-offset) + var(--yh-focus-ring-width)) var(--yh-focus-ring-color);
+  /* 高对比度模式支持 */
+  --yh-high-contrast-outline: 2px solid transparent;
+  --yh-high-contrast-outline-offset: 2px;
+  /* ==================== 滚动条样式 ==================== */
+  --yh-scrollbar-width: 6px;
+  --yh-scrollbar-thumb-color: var(--yh-text-color-disabled);
+  --yh-scrollbar-thumb-hover-color: var(--yh-text-color-secondary);
+  --yh-scrollbar-track-color: transparent;
+  --yh-scrollbar-thumb-radius: 3px;
+  /* ==================== 遮罩层 ==================== */
+  --yh-mask-color: rgba(0, 0, 0, 0.5);
+  --yh-mask-color-light: rgba(0, 0, 0, 0.3);
+  --yh-mask-color-extra-light: rgba(0, 0, 0, 0.1);
+}
+
+/* ==================== 暗黑模式 ==================== */
+html.dark {
+  --yh-color-primary: #409eff;
+  --yh-color-primary-light-3: #3375b9;
+  --yh-color-primary-light-5: #2a598a;
+  --yh-color-primary-light-7: #213d5b;
+  --yh-color-primary-light-9: #18222c;
+  --yh-color-primary-dark-2: #66b1ff;
+  --yh-color-success: #67c23a;
+  --yh-color-success-light-3: #4e8e2f;
+  --yh-color-success-light-5: #3e6b27;
+  --yh-color-success-light-7: #2d481f;
+  --yh-color-success-light-9: #1d2518;
+  --yh-color-warning: #e6a23c;
+  --yh-color-warning-light-3: #a77730;
+  --yh-color-warning-light-5: #7d5b28;
+  --yh-color-warning-light-7: #533f20;
+  --yh-color-warning-light-9: #292218;
+  --yh-color-danger: #f56c6c;
+  --yh-color-danger-light-3: #b25252;
+  --yh-color-danger-light-5: #854040;
+  --yh-color-danger-light-7: #582e2e;
+  --yh-color-danger-light-9: #2b1d1d;
+  --yh-color-info: #909399;
+  --yh-color-info-light-3: #6b6d71;
+  --yh-color-info-light-5: #525457;
+  --yh-color-info-light-7: #393b3e;
+  --yh-color-info-light-9: #202124;
+  --yh-text-color-primary: #e5eaf3;
+  --yh-text-color-regular: #cfd3dc;
+  --yh-text-color-secondary: #a3a6ad;
+  --yh-text-color-placeholder: #8d9095;
+  --yh-text-color-disabled: #6c6e72;
+  --yh-border-color: #4c4d4f;
+  --yh-border-color-light: #414243;
+  --yh-border-color-lighter: #363637;
+  --yh-border-color-extra-light: #2b2b2c;
+  --yh-border-color-dark: #58585b;
+  --yh-border-color-darker: #636466;
+  --yh-fill-color: #303030;
+  --yh-fill-color-light: #262727;
+  --yh-fill-color-lighter: #1d1d1d;
+  --yh-fill-color-extra-light: #191919;
+  --yh-fill-color-dark: #39393a;
+  --yh-fill-color-darker: #424243;
+  --yh-fill-color-blank: transparent;
+  --yh-bg-color: #141414;
+  --yh-bg-color-page: #0a0a0a;
+  --yh-bg-color-overlay: #1d1e1f;
+  /* 组件暗色模式覆盖 */
+  --yh-message-bg-color: var(--yh-bg-color-overlay);
+  --yh-message-border-color: var(--yh-border-color-lighter);
+  --yh-notification-bg-color: var(--yh-bg-color-overlay);
+  --yh-notification-border-color: var(--yh-border-color-lighter);
+  --yh-badge-border-color: var(--yh-bg-color);
+  --yh-card-bg-color: var(--yh-bg-color-overlay);
+  --yh-card-border-color: var(--yh-border-color-lighter);
+  /* Calendar 暗黑模式 */
+  --yh-calendar-bg: linear-gradient(135deg, #1a1a2e 0%, #16213e 100%);
+  --yh-calendar-border-color: rgba(255, 255, 255, 0.08);
+  --yh-calendar-header-bg: rgba(30, 30, 30, 0.95);
+  --yh-calendar-header-border: rgba(255, 255, 255, 0.06);
+  --yh-calendar-day-color: var(--yh-text-color-primary);
+  --yh-calendar-weekday-color: var(--yh-text-color-secondary);
+  --yh-calendar-selected-bg: linear-gradient(
+    135deg,
+    rgba(59, 130, 246, 0.2) 0%,
+    rgba(59, 130, 246, 0.1) 100%
+  );
+  /* Table 暗黑模式 */
+  --yh-table-border-color: var(--yh-border-color-lighter);
+  --yh-table-header-bg: var(--yh-fill-color-dark);
+  --yh-table-header-text-color: var(--yh-text-color-primary);
+  --yh-table-row-bg: var(--yh-bg-color);
+  --yh-table-row-hover-bg: var(--yh-fill-color);
+  --yh-table-row-stripe-bg: var(--yh-fill-color-light);
+  --yh-table-row-current-bg: var(--yh-color-primary-light-9);
+  --yh-table-row-selected-bg: var(--yh-color-primary-light-9);
+  --yh-table-row-success-bg: var(--yh-color-success-light-9);
+  --yh-table-row-warning-bg: var(--yh-color-warning-light-9);
+  --yh-table-fixed-left-shadow: inset 10px 0 8px -8px rgba(0, 0, 0, 0.3);
+  --yh-table-fixed-right-shadow: inset -10px 0 8px -8px rgba(0, 0, 0, 0.3);
+  /* 遮罩层暗黑模式 */
+  --yh-mask-color: rgba(0, 0, 0, 0.7);
+  --yh-mask-color-light: rgba(0, 0, 0, 0.5);
+  --yh-mask-color-extra-light: rgba(0, 0, 0, 0.3);
+  /* 滚动条暗黑模式 */
+  --yh-scrollbar-thumb-color: var(--yh-fill-color-darker);
+  --yh-scrollbar-thumb-hover-color: var(--yh-text-color-placeholder);
+}
+
+/* ==================== 减少动画偏好支持 ==================== */
+@media (prefers-reduced-motion: reduce) {
+  :root,
+  html.dark {
+    --yh-duration-fast: 0ms;
+    --yh-duration-base: 0ms;
+    --yh-duration-slow: 0ms;
+    --yh-transition-base: none;
+    --yh-transition-fast: none;
+    --yh-transition-slow: none;
+  }
+  *,
+  *::before,
+  *::after {
+    animation-duration: 0.01ms !important;
+    animation-iteration-count: 1 !important;
+    transition-duration: 0.01ms !important;
+    scroll-behavior: auto !important;
+  }
+}
+/* ==================== 高对比度模式支持 ==================== */
+@media (prefers-contrast: high) {
+  :root {
+    --yh-border-color: #000000;
+    --yh-border-color-light: #333333;
+    --yh-text-color-primary: #000000;
+    --yh-text-color-regular: #1a1a1a;
+    --yh-focus-ring-width: 3px;
+    --yh-focus-ring-color: #000000;
+  }
+  html.dark {
+    --yh-border-color: #ffffff;
+    --yh-border-color-light: #cccccc;
+    --yh-text-color-primary: #ffffff;
+    --yh-text-color-regular: #e5e5e5;
+    --yh-focus-ring-color: #ffffff;
+  }
+}
+/* ==================== 强制颜色模式支持 (Windows 高对比度) ==================== */
+@media (forced-colors: active) {
+  :root {
+    --yh-color-primary: LinkText;
+    --yh-border-color: ButtonBorder;
+    --yh-bg-color: Canvas;
+    --yh-text-color-primary: CanvasText;
+    --yh-focus-ring-color: Highlight;
+  }
+}
+.yh-smart-address {
+  --yh-smart-address-parser-bg: var(--yh-color-primary-light-9);
+  --yh-smart-address-parser-border: var(--yh-color-primary-light-5);
+  --yh-smart-address-parser-radius: var(--yh-radius-base);
+  --yh-smart-address-input-bg: var(--yh-fill-color-blank);
+  --yh-smart-address-input-border: var(--yh-border-color);
+  --yh-smart-address-input-focus-border: var(--yh-color-primary);
+  --yh-smart-address-label-color: var(--yh-text-color-secondary);
+  --yh-smart-address-label-width: 80px;
+  --yh-smart-address-parse-btn-bg: var(--yh-color-primary);
+  --yh-smart-address-tip-success: var(--yh-color-success);
+  --yh-smart-address-tip-error: var(--yh-color-danger);
+}
+.yh-smart-address.is-disabled {
+  opacity: 0.6;
+  pointer-events: none;
+}
+
+.yh-smart-address__parser {
+  background: var(--yh-smart-address-parser-bg);
+  border: 1px solid var(--yh-smart-address-parser-border);
+  border-radius: var(--yh-smart-address-parser-radius);
+  padding: 12px;
+  margin-bottom: 14px;
+}
+
+.yh-smart-address__parser-input {
+  width: 100%;
+  border: 1px solid var(--yh-smart-address-input-border);
+  border-radius: var(--yh-radius-small);
+  padding: 8px 10px;
+  font-size: var(--yh-font-size-sm);
+  color: var(--yh-text-color-regular);
+  background: var(--yh-smart-address-input-bg);
+  resize: none;
+  line-height: 1.6;
+  box-sizing: border-box;
+  transition: border-color var(--yh-transition-base);
+}
+.yh-smart-address__parser-input:focus {
+  outline: none;
+  border-color: var(--yh-smart-address-input-focus-border);
+}
+.yh-smart-address__parser-input::placeholder {
+  color: var(--yh-text-color-placeholder);
+}
+
+.yh-smart-address__parser-actions {
+  display: flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 10px;
+  margin-top: 8px;
+}
+
+.yh-smart-address__parser-tip {
+  font-size: var(--yh-font-size-sm);
+}
+.yh-smart-address__parser-tip.is-success {
+  color: var(--yh-smart-address-tip-success);
+}
+
+.yh-smart-address__parser-tip.is-error {
+  color: var(--yh-smart-address-tip-error);
+}
+
+.yh-smart-address__parse-btn {
+  display: inline-flex;
+  align-items: center;
+  gap: 4px;
+  padding: 6px 16px;
+  border: none;
+  border-radius: var(--yh-radius-base);
+  background: var(--yh-smart-address-parse-btn-bg);
+  color: #fff;
+  font-size: var(--yh-font-size-sm);
+  font-weight: 600;
+  cursor: pointer;
+  transition: background var(--yh-transition-base);
+}
+.yh-smart-address__parse-btn:hover:not(:disabled) {
+  background: var(--yh-color-primary-dark-2);
+}
+.yh-smart-address__parse-btn:disabled {
+  background: var(--yh-fill-color);
+  color: var(--yh-text-color-disabled);
+  cursor: not-allowed;
+}
+
+.yh-smart-address__fields {
+  display: flex;
+  flex-direction: column;
+  gap: 12px;
+}
+.yh-smart-address__fields.is-top .yh-smart-address__field {
+  flex-direction: column;
+  align-items: stretch;
+  gap: 4px;
+}
+.yh-smart-address__fields.is-top .yh-smart-address__label {
+  width: 100%;
+  line-height: 1.4;
+  margin-bottom: 2px;
+}
+.yh-smart-address__fields.is-top .yh-smart-address__input,
+.yh-smart-address__fields.is-top .yh-smart-address__region-inputs {
+  flex: none;
+}
+
+.yh-smart-address__field {
+  display: flex;
+  align-items: flex-start;
+  gap: 8px;
+}
+
+.yh-smart-address__label {
+  flex-shrink: 0;
+  width: var(--yh-smart-address-label-width);
+  font-size: var(--yh-font-size-sm);
+  color: var(--yh-smart-address-label-color);
+  line-height: 32px;
+}
+.yh-smart-address__label.is-required::before {
+  content: "* ";
+  color: var(--yh-color-danger);
+}
+
+.yh-smart-address__input {
+  flex: 1;
+  min-width: 0;
+  width: 100%;
+  height: 32px;
+  padding: 0 11px;
+  border: 1px solid var(--yh-smart-address-input-border);
+  border-radius: var(--yh-radius-small);
+  background: var(--yh-smart-address-input-bg);
+  font-size: var(--yh-font-size-sm);
+  color: var(--yh-text-color-regular);
+  box-sizing: border-box;
+  transition: border-color var(--yh-transition-base);
+}
+.yh-smart-address__input:focus {
+  outline: none;
+  border-color: var(--yh-smart-address-input-focus-border);
+}
+.yh-smart-address__input::placeholder {
+  color: var(--yh-text-color-placeholder);
+}
+
+.yh-smart-address__region {
+  align-items: flex-start;
+}
+
+.yh-smart-address__region-inputs {
+  flex: 1;
+  display: flex;
+  gap: 8px;
+  min-width: 0;
+}
+.yh-smart-address__region-inputs .yh-smart-address__input,
+.yh-smart-address__region-inputs .yh-select {
+  flex: 1 !important;
+  width: 0 !important;
+  min-width: 0 !important;
+}
+</style>