@unif/react-native-ui 0.4.0 → 1.0.0

package/lib/module/core/hooks/useOverlayAnimation.js

@@ -0,0 +1,112 @@
+"use strict";
+
+// 动画方案：使用 Reanimated 4 的 withTiming/withSpring。
+// 对于简单的状态驱动浮层，Reanimated 4 CSS Transitions
+// （transitionProperty / transitionDuration）是一种声明式的替代方案，
+// 但 useOverlayAnimation 使用命令式 withTiming 以实现更精细的生命周期控制
+// （进入/退出时序，退出动画完成后触发 onClosed 回调）。
+import { useCallback, useContext, useRef, useState } from 'react';
+import { useSharedValue, withTiming } from 'react-native-reanimated';
+import { scheduleOnRN } from 'react-native-worklets';
+import { ThemeContext } from "../theme/hooks.js";
+
+/** 浮层支持的动画模式 */
+
+/** useOverlayAnimation 的返回值 */
+
+/**
+ * 管理浮层（Dialog / Sheet / Toast 等）的动画生命周期。
+ *
+ * 解决的核心问题：退出动画播完之前不能卸载组件，否则动画会被中断。
+ * 通过 `mounted` 状态延迟卸载：动画回调里才执行 setMounted(false)。
+ *
+ * 调用方将返回的 SharedValue 绑定到 `useAnimatedStyle`，
+ * 用 `mounted` 控制是否 render，无需自行管理动画时序。
+ *
+ * @param initialVisible 初始显隐状态，仅用于初始化，后续变化需调用 open()/close()
+ * @param mode           动画模式，默认 'fade'
+ */
+export function useOverlayAnimation(initialVisible, mode = 'fade') {
+  const {
+    tokens
+  } = useContext(ThemeContext);
+
+  // mounted 控制组件是否渲染。进入时立即挂载；
+  // 退出时等动画结束再卸载，避免动画被中断。
+  const [mounted, setMounted] = useState(initialVisible);
+
+  // 用 ref 标记"当前是否处于退出动画中"，防止快速开关时旧回调误触卸载
+  const isAnimatingClose = useRef(false);
+
+  // 各动画维度的 SharedValue，初始值取决于 initialVisible
+  const backdropOpacity = useSharedValue(initialVisible ? 1 : 0);
+  const translateY = useSharedValue(initialVisible ? 0 : 300);
+  const scale = useSharedValue(initialVisible ? 1 : 0.95);
+  const contentOpacity = useSharedValue(initialVisible ? 1 : 0);
+
+  // 动画时长乘以 scale 系数（减弱动效模式下 scale=0，动画瞬间完成）
+  const duration = tokens.animation.durationNormal * tokens.animation.scale;
+  const easingOut = tokens.animation.easing.out;
+  const easingIn = tokens.animation.easing.in;
+
+  /** 挂载组件并播放进入动画 */
+  const open = useCallback(() => {
+    isAnimatingClose.current = false;
+    setMounted(true);
+    const cfg = {
+      duration,
+      easing: easingOut
+    };
+    backdropOpacity.value = withTiming(1, cfg);
+    if (mode === 'slideUp') translateY.value = withTiming(0, cfg);
+    if (mode === 'scale') {
+      scale.value = withTiming(1, cfg);
+      contentOpacity.value = withTiming(1, cfg);
+    }
+    if (mode === 'fade') contentOpacity.value = withTiming(1, cfg);
+  }, [mode, duration, easingOut, backdropOpacity, translateY, scale, contentOpacity]);
+
+  /**
+   * 播放退出动画，完成后卸载组件。
+   * withTiming 回调在 UI 线程执行，unmount 标注 'worklet' 使其可在 UI 线程调用，
+   * 再通过 scheduleOnRN 切回 JS 线程执行 setMounted/onClosed。
+   */
+  const close = useCallback(onClosed => {
+    isAnimatingClose.current = true;
+    // 退出使用 easing.in（先慢后快），与进入的 easing.out 形成对称
+    const cfg = {
+      duration,
+      easing: easingIn
+    };
+    const unmount = () => {
+      'worklet';
+
+      // 检查标志防止动画中途被 open() 打断后仍执行卸载
+      if (isAnimatingClose.current) {
+        scheduleOnRN(setMounted, false);
+        if (onClosed) scheduleOnRN(onClosed);
+      }
+    };
+    backdropOpacity.value = withTiming(0, cfg);
+    if (mode === 'slideUp')
+      // slideUp 以面板滑出为主动画，滑出结束时触发卸载
+      translateY.value = withTiming(300, cfg, () => unmount());else if (mode === 'scale') {
+      scale.value = withTiming(0.95, cfg);
+      // scale 模式以内容渐隐为主动画
+      contentOpacity.value = withTiming(0, cfg, () => unmount());
+    } else {
+      // fade 模式以内容渐隐为主动画
+      contentOpacity.value = withTiming(0, cfg, () => unmount());
+    }
+  }, [mode, duration, easingIn, backdropOpacity, translateY, scale, contentOpacity]);
+  return {
+    mounted,
+    backdropOpacity,
+    translateY,
+    scale,
+    contentOpacity,
+    open,
+    close
+  };
+}
+//# sourceMappingURL=useOverlayAnimation.js.map

package/lib/module/core/hooks/useOverlayAnimation.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useContext","useRef","useState","useSharedValue","withTiming","scheduleOnRN","ThemeContext","useOverlayAnimation","initialVisible","mode","tokens","mounted","setMounted","isAnimatingClose","backdropOpacity","translateY","scale","contentOpacity","duration","animation","durationNormal","easingOut","easing","out","easingIn","in","open","current","cfg","value","close","onClosed","unmount"],"sourceRoot":"../../../../src","sources":["core/hooks/useOverlayAnimation.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/hooks/useReducedMotion.js

@@ -0,0 +1,7 @@
+"use strict";
+
+// 直接重导出 react-native-reanimated 的 useReducedMotion。
+// 当系统级"减弱动效"无障碍选项开启时返回 true，
+// 动画相关组件应据此将动画时长设为 0 或跳过动画。
+export { useReducedMotion } from 'react-native-reanimated';
+//# sourceMappingURL=useReducedMotion.js.map

package/lib/module/core/hooks/useReducedMotion.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useReducedMotion"],"sourceRoot":"../../../../src","sources":["core/hooks/useReducedMotion.ts"],"mappings":";;AAAA;AACA;AACA;AACA,SAASA,gBAAgB,QAAQ,yBAAyB","ignoreList":[]}

package/lib/module/core/index.js

@@ -0,0 +1,24 @@
+"use strict";
+
+// src/core/index.ts
+// 内部导出——不属于 @unif/react-native-ui 的公共 API。
+// 组件从此文件导入；终端用户从 src/index.ts 导入。
+
+export { invariant, warning } from "./utils/dev.js";
+export { recipe } from "./styles/recipe/index.js";
+export { useStyles } from "./styles/useStyles.js";
+export { createCompound } from "./compound.js";
+export { useControllable } from "./hooks/useControllable.js";
+export { Portal, PortalHost } from "./portal.js";
+export { pushBarStyle, popBarStyle, getCurrentBarStyle } from "./utils/statusBarManager.js";
+export { useOverlayAnimation } from "./hooks/useOverlayAnimation.js";
+export { useBackHandler } from "./hooks/useBackHandler.js";
+export { useReducedMotion } from "./hooks/useReducedMotion.js";
+
+// 主题
+export { lightTokens, darkTokens, defaultStrings } from "./theme/tokens.js";
+export { createTheme } from "./theme/createTheme.js";
+export { ThemeProvider } from "./theme/provider.js";
+export { ThemeContext, useTheme, useThemeMode, useColorModeValue, useStrings, useHapticFeedback } from "./theme/hooks.js";
+export { AnimationClockProvider, useAnimationClock } from "./theme/animationClock.js";
+//# sourceMappingURL=index.js.map

package/lib/module/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["invariant","warning","recipe","useStyles","createCompound","useControllable","Portal","PortalHost","pushBarStyle","popBarStyle","getCurrentBarStyle","useOverlayAnimation","useBackHandler","useReducedMotion","lightTokens","darkTokens","defaultStrings","createTheme","ThemeProvider","ThemeContext","useTheme","useThemeMode","useColorModeValue","useStrings","useHapticFeedback","AnimationClockProvider","useAnimationClock"],"sourceRoot":"../../../src","sources":["core/index.ts"],"mappings":";;AAAA;AACA;AACA;;AAEA,SAASA,SAAS,EAAEC,OAAO,QAAQ,gBAAa;AAChD,SAASC,MAAM,QAAQ,0BAAiB;AAOxC,SAASC,SAAS,QAAQ,uBAAoB;AAC9C,SAASC,cAAc,QAAQ,eAAY;AAC3C,SAASC,eAAe,QAAQ,4BAAyB;AACzD,SAASC,MAAM,EAAEC,UAAU,QAAQ,aAAU;AAC7C,SACEC,YAAY,EACZC,WAAW,EACXC,kBAAkB,QACb,6BAA0B;AACjC,SAASC,mBAAmB,QAAQ,gCAA6B;AAEjE,SAASC,cAAc,QAAQ,2BAAwB;AACvD,SAASC,gBAAgB,QAAQ,6BAA0B;;AAE3D;AACA,SAASC,WAAW,EAAEC,UAAU,EAAEC,cAAc,QAAQ,mBAAgB;AACxE,SAASC,WAAW,QAAQ,wBAAqB;AACjD,SAASC,aAAa,QAAQ,qBAAkB;AAChD,SACEC,YAAY,EACZC,QAAQ,EACRC,YAAY,EACZC,iBAAiB,EACjBC,UAAU,EACVC,iBAAiB,QACZ,kBAAe;AAEtB,SACEC,sBAAsB,EACtBC,iBAAiB,QACZ,2BAAwB","ignoreList":[]}

package/lib/module/core/portal.js

@@ -0,0 +1,127 @@
+"use strict";
+
+import React, { useContext, useEffect, useLayoutEffect, useRef, useState, useCallback } from 'react';
+import { ThemeContext } from "./theme/hooks.js";
+import { ContextBridgeContext } from "./theme/provider.js";
+import { warning } from "./utils/dev.js";
+
+/** Portal 条目：一个 React 节点 + 唯一标识 */
+import { jsx as _jsx, Fragment as _Fragment } from "react/jsx-runtime";
+// ─── 模块级单例 ────────────────────────────────────────────────────────────────
+//
+// PortalHost 在此注册自身的 setState 函数，
+// Portal 从此读取并调用，实现跨层级渲染。
+//
+// 选择模块级单例而非 React Context 的原因：
+// PortalHost 和 Portal 在组件树中通常是兄弟节点（PortalHost 在根部，
+// Portal 在深层子组件中），两者之间没有父子关系，无法通过 Context 传递。
+
+let hostUpdate = null;
+// 统计当前挂载的 PortalHost 数量，超过 1 个时发出警告
+let hostCount = 0;
+
+/** 在 PortalHost 中注册一个新的 Portal 节点，返回其唯一 key */
+function mountPortal(node) {
+  const key = Symbol();
+  hostUpdate?.(prev => [...prev, {
+    key,
+    node
+  }]);
+  return key;
+}
+
+/** 按 key 从 PortalHost 中移除 Portal 节点 */
+function unmountPortal(key) {
+  hostUpdate?.(prev => prev.filter(e => e.key !== key));
+}
+
+/** 按 key 更新 PortalHost 中已存在的 Portal 节点内容 */
+function updatePortal(key, node) {
+  hostUpdate?.(prev => prev.map(e => e.key === key ? {
+    key,
+    node
+  } : e));
+}
+
+/**
+ * Portal 的宿主容器，负责渲染所有通过 `<Portal>` 传送来的节点。
+ *
+ * 应放置在应用根部（通常在 ThemeProvider 内部），且全局只挂载一次。
+ * 挂载多个时会发出 DEV 警告。
+ *
+ * 渲染原理：PortalHost 使用 useLayoutEffect 提前注册 hostUpdate，
+ * 确保 Portal 的 useEffect 触发时 hostUpdate 已就绪，节点能正确插入。
+ */
+export function PortalHost() {
+  const [entries, setEntries] = useState([]);
+
+  // useLayoutEffect 确保注册在 Portal 的 useEffect 之前执行
+  useLayoutEffect(() => {
+    hostCount++;
+    warning(hostCount <= 1, 'Multiple PortalHost instances detected. Ensure PortalHost is only mounted once at the app root.');
+    hostUpdate = setEntries;
+    return () => {
+      hostCount--;
+      // 卸载时仅清空自己注册的 hostUpdate，避免影响后续 PortalHost
+      if (hostUpdate === setEntries) {
+        hostUpdate = null;
+      }
+    };
+  }, []);
+  return /*#__PURE__*/_jsx(_Fragment, {
+    children: entries.map(e => /*#__PURE__*/_jsx(React.Fragment, {
+      children: e.node
+    }, String(e.key)))
+  });
+}
+/**
+ * 将子节点传送到最近的 `<PortalHost>` 渲染，突破组件树层级限制。
+ *
+ * 典型用途：Dialog、Sheet、Toast、Tooltip 等浮层组件，
+ * 需要渲染在 z 轴最顶层（脱离父容器的 overflow/transform 约束）。
+ *
+ * 上下文桥接：Portal 会将当前的 ThemeContext 和 ContextBridgeContext 透传给
+ * 传送过去的节点，确保主题和自定义 Context 在 Portal 内依然可用。
+ *
+ * 生命周期：
+ * - 挂载时：在 PortalHost 中注册节点（mountPortal）
+ * - 每次渲染时：更新节点内容（updatePortal），保持与父组件状态同步
+ * - 卸载时：从 PortalHost 中移除节点（unmountPortal）
+ */
+export function Portal({
+  children
+}) {
+  const themeCtx = useContext(ThemeContext);
+  const ContextBridge = useContext(ContextBridgeContext);
+  const keyRef = useRef(null);
+
+  // 包裹内容：注入 ThemeContext 和自定义 ContextBridge，保证 Portal 内 Context 连续
+  const wrapContent = useCallback(content => {
+    const inner = /*#__PURE__*/_jsx(ThemeContext.Provider, {
+      value: themeCtx,
+      children: content
+    });
+    return ContextBridge ? /*#__PURE__*/_jsx(ContextBridge, {
+      children: inner
+    }) : inner;
+  }, [themeCtx, ContextBridge]);
+  useEffect(() => {
+    const key = mountPortal(wrapContent(children));
+    keyRef.current = key;
+    return () => {
+      unmountPortal(key);
+      keyRef.current = null;
+    };
+    // 仅在挂载/卸载时触发——更新由下方处理
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, []);
+
+  // 每次渲染时更新 portal 内容（包括 children、themeCtx 等依赖变化时）
+  useEffect(() => {
+    if (keyRef.current) {
+      updatePortal(keyRef.current, wrapContent(children));
+    }
+  });
+  return null;
+}
+//# sourceMappingURL=portal.js.map

package/lib/module/core/portal.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","useContext","useEffect","useLayoutEffect","useRef","useState","useCallback","ThemeContext","ContextBridgeContext","warning","jsx","_jsx","Fragment","_Fragment","hostUpdate","hostCount","mountPortal","node","key","Symbol","prev","unmountPortal","filter","e","updatePortal","map","PortalHost","entries","setEntries","children","String","Portal","themeCtx","ContextBridge","keyRef","wrapContent","content","inner","Provider","value","current"],"sourceRoot":"../../../src","sources":["core/portal.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/core/styles/recipe/helpers.js

@@ -0,0 +1,32 @@
+"use strict";
+
+/** 若样式定义是工厂函数则调用它，否则直接返回 */
+export function evalStyle(style, tokens) {
+  return typeof style === 'function' ? style(tokens) : style;
+}
+
+/**
+ * 浅合并两个 SlotMap：对每个 key 执行对象展开，
+ * patch 中的属性会覆盖 target 中同名属性。
+ */
+export function mergeSlots(target, patch) {
+  const result = {
+    ...target
+  };
+  for (const key in patch) {
+    result[key] = {
+      ...result[key],
+      ...patch[key]
+    };
+  }
+  return result;
+}
+
+/**
+ * 构建变体缓存键：将所有变体 key 的当前值（含 defaults 回退）
+ * 拼接为 "|" 分隔的字符串，用于 Map 索引。
+ */
+export function buildCacheKey(variantKeys, props, defaults) {
+  return variantKeys.map(k => String(props[k] ?? defaults[k] ?? '')).join('|');
+}
+//# sourceMappingURL=helpers.js.map

package/lib/module/core/styles/recipe/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["evalStyle","style","tokens","mergeSlots","target","patch","result","key","buildCacheKey","variantKeys","props","defaults","map","k","String","join"],"sourceRoot":"../../../../../src","sources":["core/styles/recipe/helpers.ts"],"mappings":";;AAGA;AACA,OAAO,SAASA,SAASA,CACvBC,KAAsD,EACtDC,MAAc,EACE;EAChB,OAAO,OAAOD,KAAK,KAAK,UAAU,GAAGA,KAAK,CAACC,MAAM,CAAC,GAAGD,KAAK;AAC5D;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,UAAUA,CAAoBC,MAAS,EAAEC,KAAiB,EAAK;EAC7E,MAAMC,MAAM,GAAG;IAAE,GAAGF;EAAO,CAAC;EAC5B,KAAK,MAAMG,GAAG,IAAIF,KAAK,EAAE;IACvBC,MAAM,CAACC,GAAG,CAAY,GAAG;MACvB,GAAID,MAAM,CAACC,GAAG,CAAuB;MACrC,GAAIF,KAAK,CAACE,GAAG;IACf,CAAe;EACjB;EACA,OAAOD,MAAM;AACf;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASE,aAAaA,CAC3BC,WAA8B,EAC9BC,KAA8B,EAC9BC,QAAiC,EACzB;EACR,OAAOF,WAAW,CACfG,GAAG,CAAEC,CAAC,IAAKC,MAAM,CAACJ,KAAK,CAACG,CAAC,CAAC,IAAIF,QAAQ,CAACE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CACjDE,IAAI,CAAC,GAAG,CAAC;AACd","ignoreList":[]}

package/lib/module/core/styles/recipe/index.js

@@ -0,0 +1,112 @@
+"use strict";
+
+import { lightTokens } from "../../theme/tokens.js";
+import { evalStyle, mergeSlots, buildCacheKey } from "./helpers.js";
+
+/**
+ * 创建一个样式配方（Recipe）实例。
+ *
+ * Recipe 封装了"多变体样式合并"逻辑，流程如下：
+ * 1. 从 base 计算基础样式
+ * 2. 按各变体 key 的当前值叠加对应变体样式
+ * 3. 检查 compoundVariants，满足所有条件的额外叠加
+ * 4. 将结果冻结并写入 WeakMap 缓存（tokens 变化时缓存自动失效）
+ *
+ * @param config RecipeConfig 配置
+ * @returns 冻结的 Recipe 实例
+ */
+export function recipe(config) {
+  // 用 lightTokens 预计算 base 的插槽 key 列表（工厂函数需要一次示例调用）
+  const baseSlots = typeof config.base === 'function' ? config.base(lightTokens) : config.base;
+  const slotKeys = Object.freeze(Object.keys(baseSlots));
+  const variantKeys = Object.freeze(Object.keys(config.variants ?? {}));
+  const defaults = Object.freeze(config.defaults ?? {});
+
+  // 两级缓存：WeakMap<tokens, Map<cacheKey, frozenResult>>
+  // tokens 对象被 GC 时自动释放，避免内存泄漏
+  const cache = new WeakMap();
+  function resolveWith(props, tokens) {
+    const cacheKey = buildCacheKey(variantKeys, props, defaults);
+    let tokenCache = cache.get(tokens);
+    if (!tokenCache) {
+      tokenCache = new Map();
+      cache.set(tokens, tokenCache);
+    }
+    const cached = tokenCache.get(cacheKey);
+    if (cached) return cached;
+
+    // 第一步：base 样式
+    let result = evalStyle(config.base, tokens);
+
+    // 第二步：逐个变体叠加
+    for (const k of variantKeys) {
+      const effectiveValue = String(props[k] ?? defaults[k] ?? '');
+      if (!effectiveValue) continue;
+      const variantMap = config.variants?.[k];
+      if (!variantMap) continue;
+      const variantStyle = variantMap[effectiveValue];
+      if (variantStyle == null) continue;
+      result = mergeSlots(result, evalStyle(variantStyle, tokens));
+    }
+
+    // 第三步：compoundVariants（所有条件同时满足时才应用）
+    for (const cv of config.compoundVariants ?? []) {
+      const {
+        style,
+        ...conditions
+      } = cv;
+      const matches = Object.entries(conditions).every(([k, v]) => {
+        const effective = props[k] ?? defaults[k];
+        return Array.isArray(v) ? v.includes(effective) : effective === v;
+      });
+      if (matches) {
+        result = mergeSlots(result, evalStyle(style, tokens));
+      }
+    }
+
+    // 深度冻结结果：防止外部意外修改，同时便于 ESLint 的 no-mutating-styles 检查
+    const frozen = Object.freeze(Object.fromEntries(Object.entries(result).map(([k, v]) => [k, Object.freeze(v)])));
+    tokenCache.set(cacheKey, frozen);
+    return frozen;
+  }
+
+  /**
+   * 继承当前 recipe 并扩展配置，常用于主题定制或组件变体扩展。
+   * 新 recipe 的变体键为原有键 + 新增键的并集，base 和 variants 按插槽深度合并。
+   */
+  function extendRecipe(extConfig) {
+    const newVariantKeys = Object.keys(extConfig.variants ?? {}).filter(k => !variantKeys.includes(k));
+    const mergedVariantKeys = [...variantKeys, ...newVariantKeys];
+    const mergedConfig = {
+      defaults: {
+        ...defaults,
+        ...(extConfig.defaults ?? {})
+      },
+      base: extConfig.base != null ? typeof config.base === 'function' ? t => mergeSlots(config.base(t), evalStyle(extConfig.base, t)) : t => mergeSlots(config.base, evalStyle(extConfig.base, t)) : config.base,
+      variants: {
+        ...config.variants,
+        ...Object.fromEntries(Object.entries(extConfig.variants ?? {}).map(([k, v]) => [k, {
+          ...(config.variants?.[k] ?? {}),
+          ...v
+        }]))
+      },
+      compoundVariants: [...(config.compoundVariants ?? []), ...(extConfig.compoundVariants ?? [])],
+      interactions: {
+        ...(config.interactions ?? {}),
+        ...(extConfig.interactions ?? {})
+      }
+    };
+    const ext = recipe(mergedConfig);
+    // 手动修正 variantKeys 为合并后的列表（recipe() 内部只能看到 mergedConfig 的 variants）
+    ext.variantKeys = Object.freeze(mergedVariantKeys);
+    return ext;
+  }
+  return Object.freeze({
+    slotKeys,
+    variantKeys,
+    defaults,
+    resolve: resolveWith,
+    extend: extendRecipe
+  });
+}
+//# sourceMappingURL=index.js.map

package/lib/module/core/styles/recipe/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["lightTokens","evalStyle","mergeSlots","buildCacheKey","recipe","config","baseSlots","base","slotKeys","Object","freeze","keys","variantKeys","variants","defaults","cache","WeakMap","resolveWith","props","tokens","cacheKey","tokenCache","get","Map","set","cached","result","k","effectiveValue","String","variantMap","variantStyle","cv","compoundVariants","style","conditions","matches","entries","every","v","effective","Array","isArray","includes","frozen","fromEntries","map","extendRecipe","extConfig","newVariantKeys","filter","mergedVariantKeys","mergedConfig","t","interactions","ext","resolve","extend"],"sourceRoot":"../../../../../src","sources":["core/styles/recipe/index.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/core/styles/recipe/types.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export {};
+//# sourceMappingURL=types.js.map

package/lib/module/core/styles/recipe/types.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../../../src","sources":["core/styles/recipe/types.ts"],"mappings":"","ignoreList":[]}

package/lib/module/core/styles/useStyles.js

@@ -0,0 +1,46 @@
+"use strict";
+
+import { useContext } from 'react';
+import { ThemeContext } from "../theme/hooks.js";
+
+/**
+ * 从 Recipe 解析当前主题下的样式，并可选地与用户自定义样式合并。
+ *
+ * 用法示例：
+ * ```tsx
+ * const s = useStyles(buttonRecipe, { visual, size }, styles);
+ * // s.root / s.label / s.icon 即为最终合并后的样式对象
+ * ```
+ *
+ * 合并规则：`recipe.resolve(props, tokens)` 的基础样式 + 用户 `styles[slot]`，
+ * 用户样式的同名属性会覆盖基础样式。
+ *
+ * @param r       Recipe 实例（由 `recipe()` 创建）
+ * @param props   传递给 Recipe 的变体 props（如 `{ visual: 'outline', size: 'sm' }`）
+ * @param styles  用户自定义的插槽样式覆盖（可选）
+ * @returns       按插槽名索引的最终样式对象
+ */
+export function useStyles(r, props = {}, styles) {
+  const {
+    tokens
+  } = useContext(ThemeContext);
+  // recipe.resolve 内部有 WeakMap 缓存，tokens 和 props 不变时直接返回缓存结果
+  const resolved = r.resolve(props, tokens);
+
+  // 无自定义样式时直接返回缓存的 resolved，避免额外对象分配
+  if (!styles) return resolved;
+
+  // 按插槽逐一合并，用户样式覆盖 recipe 基础样式
+  const merged = {};
+  for (const key of r.slotKeys) {
+    const k = key;
+    const base = resolved[k];
+    const override = styles[k];
+    merged[k] = override ? {
+      ...base,
+      ...override
+    } : base;
+  }
+  return merged;
+}
+//# sourceMappingURL=useStyles.js.map

package/lib/module/core/styles/useStyles.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useContext","ThemeContext","useStyles","r","props","styles","tokens","resolved","resolve","merged","key","slotKeys","k","base","override"],"sourceRoot":"../../../../src","sources":["core/styles/useStyles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,OAAO;AAElC,SAASC,YAAY,QAAQ,mBAAgB;;AAE7C;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,SAASA,CACvBC,CAAY,EACZC,KAA8B,GAAG,CAAC,CAAC,EACnCC,MAAmB,EAChB;EACH,MAAM;IAAEC;EAAO,CAAC,GAAGN,UAAU,CAACC,YAAY,CAAC;EAC3C;EACA,MAAMM,QAAQ,GAAGJ,CAAC,CAACK,OAAO,CAACJ,KAAK,EAAEE,MAAM,CAAC;;EAEzC;EACA,IAAI,CAACD,MAAM,EAAE,OAAOE,QAAQ;;EAE5B;EACA,MAAME,MAAM,GAAG,CAAC,CAAM;EACtB,KAAK,MAAMC,GAAG,IAAIP,CAAC,CAACQ,QAAQ,EAAE;IAC5B,MAAMC,CAAC,GAAGF,GAAa;IACvB,MAAMG,IAAI,GAAIN,QAAQ,CAASK,CAAC,CAAC;IACjC,MAAME,QAAQ,GAAIT,MAAM,CAASO,CAAC,CAAC;IAClCH,MAAM,CAASG,CAAC,CAAC,GAAGE,QAAQ,GAAG;MAAE,GAAGD,IAAI;MAAE,GAAGC;IAAS,CAAC,GAAGD,IAAI;EACjE;EACA,OAAOJ,MAAM;AACf","ignoreList":[]}

package/lib/module/core/theme/animationClock.js

@@ -0,0 +1,41 @@
+"use strict";
+
+import React, { createContext, useContext, useMemo } from 'react';
+import { jsx as _jsx } from "react/jsx-runtime";
+/**
+ * 动画时钟 Context：提供 ThemeProvider 的挂载时间戳。
+ *
+ * 默认值为 0，表示 Context 尚未被提供（应始终包裹在 AnimationClockProvider 内使用）。
+ */
+export const AnimationClockContext = /*#__PURE__*/createContext({
+  mountedAt: 0
+});
+
+/**
+ * 动画时钟 Provider：记录首次挂载的时间戳并注入到子树。
+ *
+ * 由 ThemeProvider 在内部自动包裹，无需应用层手动使用。
+ * `mountedAt` 通过 useMemo([], []) 固定为首次渲染时刻，
+ * ThemeProvider 重渲染时不会更新，确保 Skeleton 等组件的动画延迟计算稳定。
+ */
+export function AnimationClockProvider({
+  children
+}) {
+  // 空依赖数组确保 mountedAt 仅在组件首次挂载时计算一次
+  const value = useMemo(() => ({
+    mountedAt: Date.now()
+  }), []);
+  return /*#__PURE__*/_jsx(AnimationClockContext.Provider, {
+    value: value,
+    children: children
+  });
+}
+
+/**
+ * 获取当前的动画时钟数据（mountedAt 时间戳）。
+ * 供 Skeleton 等需要同步动画相位的组件使用。
+ */
+export function useAnimationClock() {
+  return useContext(AnimationClockContext);
+}
+//# sourceMappingURL=animationClock.js.map

package/lib/module/core/theme/animationClock.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["React","createContext","useContext","useMemo","jsx","_jsx","AnimationClockContext","mountedAt","AnimationClockProvider","children","value","Date","now","Provider","useAnimationClock"],"sourceRoot":"../../../../src","sources":["core/theme/animationClock.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAIC,aAAa,EAAEC,UAAU,EAAEC,OAAO,QAAQ,OAAO;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAUlE;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,qBAAqB,gBAAGL,aAAa,CAA6B;EAC7EM,SAAS,EAAE;AACb,CAAC,CAAC;;AAEF;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,sBAAsBA,CAAC;EACrCC;AAGF,CAAC,EAAE;EACD;EACA,MAAMC,KAAK,GAAGP,OAAO,CAAC,OAAO;IAAEI,SAAS,EAAEI,IAAI,CAACC,GAAG,CAAC;EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;EAE5D,oBACEP,IAAA,CAACC,qBAAqB,CAACO,QAAQ;IAACH,KAAK,EAAEA,KAAM;IAAAD,QAAA,EAC1CA;EAAQ,CACqB,CAAC;AAErC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASK,iBAAiBA,CAAA,EAA+B;EAC9D,OAAOZ,UAAU,CAACI,qBAAqB,CAAC;AAC1C","ignoreList":[]}

package/lib/module/core/theme/createTheme.js

@@ -0,0 +1,83 @@
+"use strict";
+
+import { lightTokens, darkTokens } from "./tokens.js";
+/**
+ * 根据基础圆角值派生全套圆角 token。
+ * 所有圆角均以同一个 `base` 值为基准按比例缩放，
+ * 保证设计系统内圆角风格的一致性。
+ *
+ * @param base 基础圆角（px），默认为 6
+ */
+function deriveRadius(base) {
+  return {
+    radiusSm: Math.round(base * 0.5),
+    // 最小圆角
+    radius: base,
+    // 默认圆角
+    radiusMd: Math.round(base * 1.33),
+    // 中等圆角
+    radiusLg: Math.round(base * 1.67),
+    // 大圆角
+    radiusXl: Math.round(base * 2),
+    // 超大圆角
+    radiusFull: 999 // 完全圆（胶囊形）
+  };
+}
+
+/**
+ * 将覆盖值合并到 base tokens，并在必要时重新派生圆角 token 组。
+ * 结果对象被冻结（Object.freeze），防止在 Provider 外被意外修改。
+ *
+ * @param base      基础 token（lightTokens 或 darkTokens）
+ * @param overrides 需要覆盖的 token 子集
+ */
+function buildTokens(base, overrides) {
+  const merged = {
+    ...base,
+    ...overrides
+  };
+  // 若 radius 被覆盖，重新派生所有圆角 token（保持一致性）
+  if (overrides.radius !== undefined) {
+    Object.assign(merged, deriveRadius(overrides.radius));
+  }
+  return Object.freeze(merged);
+}
+
+/**
+ * 根据品牌覆盖值创建 Theme（亮色 + 暗色 token 对）。
+ *
+ * 必须在模块顶层调用（不可在组件内部调用），
+ * 因为 Object.freeze 的结果应在组件渲染前确定，
+ * 避免每次渲染重新创建对象导致 ThemeProvider 不必要的重渲染。
+ *
+ * 使用示例：
+ * ```ts
+ * const myTheme = createTheme({ primary: '#6366f1', radius: 8 });
+ * // 传入 ThemeProvider：<ThemeProvider theme={myTheme}>
+ * ```
+ *
+ * @param input 品牌定制输入，支持主色、暗色主色覆盖、基础圆角
+ * @returns     包含 light 和 dark 两套冻结 token 的 Theme 对象
+ */
+export function createTheme(input) {
+  const lightOverrides = {};
+  const darkOverrides = {};
+  if (input.primary !== undefined) {
+    // 亮色主色覆盖；暗色主色若未单独指定则沿用亮色主色
+    lightOverrides.primary = input.primary;
+    darkOverrides.primary = input.dark?.primary ?? input.primary;
+  } else if (input.dark?.primary !== undefined) {
+    // 仅覆盖暗色主色（亮色保持默认）
+    darkOverrides.primary = input.dark.primary;
+  }
+  if (input.radius !== undefined) {
+    // 圆角同时应用于亮色和暗色（圆角与颜色模式无关）
+    lightOverrides.radius = input.radius;
+    darkOverrides.radius = input.radius;
+  }
+  return {
+    light: buildTokens(lightTokens, lightOverrides),
+    dark: buildTokens(darkTokens, darkOverrides)
+  };
+}
+//# sourceMappingURL=createTheme.js.map