@unif/react-native-design 0.19.0 → 0.21.0

package/lib/module/components/ui/TextField/styles.js

@@ -16,6 +16,17 @@ export const makeStyles = c => StyleSheet.create({
     paddingVertical: space[4],
     alignItems: 'flex-start'
   },
+  /** Search 的可见底色/边框绝不承载命中区域。 */
+  searchInteractiveRow: {
+    borderWidth: 0
+  },
+  searchVisibleSurface: {
+    position: 'absolute',
+    left: 0,
+    right: 0,
+    borderRadius: radius.md,
+    borderWidth: 1
+  },
   wrapIdle: {
     backgroundColor: c.surfaceContainerHigh,
     borderColor: 'transparent'
@@ -47,6 +58,23 @@ export const makeStyles = c => StyleSheet.create({
   inputMultiline: {
     textAlignVertical: 'top'
   },
+  slotDisplay: {
+    alignItems: 'center',
+    justifyContent: 'center',
+    minWidth: 18,
+    minHeight: 18
+  },
+  slotText: {
+    color: c.foregroundMuted,
+    fontSize: t.sm
+  },
+  // 固定命中框不走 r()/fontScale:它是手指可达性约束,不是视觉 token。
+  actionFrame: {
+    width: 44,
+    height: 44,
+    alignItems: 'center',
+    justifyContent: 'center'
+  },
   errorMsg: {
     fontSize: t.micro,
     color: c.error,
@@ -56,6 +84,9 @@ export const makeStyles = c => StyleSheet.create({
   },
   containerDisabled: {
     opacity: 0.5
+  },
+  rootCentered: {
+    justifyContent: 'center'
   }
 });
 //# sourceMappingURL=styles.js.map

package/lib/module/components/ui/TextField/styles.js.map

@@ -1 +1 @@
-{"version":3,"names":["StyleSheet","fw","radius","space","type","t","makeStyles","c","create","wrap","flexDirection","alignItems","gap","paddingHorizontal","borderRadius","md","borderWidth","wrapMultiline","paddingVertical","wrapIdle","backgroundColor","surfaceContainerHigh","borderColor","wrapActive","surface","wrapFocus","primary","wrapFilled","outline","wrapError","error","input","flex","minWidth","fontSize","body","color","foreground","padding","margin","outlineWidth","inputMultiline","textAlignVertical","errorMsg","micro","marginTop","fontWeight","regular","containerDisabled","opacity"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/styles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,EAAE,EAAEC,MAAM,EAAEC,KAAK,EAAEC,IAAI,IAAIC,CAAC,QAAQ,yBAAgB;AAG7D;AACA,OAAO,MAAMC,UAAU,GAAIC,CAAc,IACvCP,UAAU,CAACQ,MAAM,CAAC;EAChBC,IAAI,EAAE;IACJC,aAAa,EAAE,KAAK;IACpBC,UAAU,EAAE,QAAQ;IACpBC,GAAG,EAAET,KAAK,CAAC,CAAC,CAAC;IACbU,iBAAiB,EAAEV,KAAK,CAAC,CAAC,CAAC;IAC3BW,YAAY,EAAEZ,MAAM,CAACa,EAAE;IACvBC,WAAW,EAAE;EACf,CAAC;EACDC,aAAa,EAAE;IACbC,eAAe,EAAEf,KAAK,CAAC,CAAC,CAAC;IACzBQ,UAAU,EAAE;EACd,CAAC;EACDQ,QAAQ,EAAE;IACRC,eAAe,EAAEb,CAAC,CAACc,oBAAoB;IACvCC,WAAW,EAAE;EACf,CAAC;EACD;EACAC,UAAU,EAAE;IACVH,eAAe,EAAEb,CAAC,CAACiB;EACrB,CAAC;EACDC,SAAS,EAAE;IACTH,WAAW,EAAEf,CAAC,CAACmB;EACjB,CAAC;EACDC,UAAU,EAAE;IACVL,WAAW,EAAEf,CAAC,CAACqB;EACjB,CAAC;EACDC,SAAS,EAAE;IACTP,WAAW,EAAEf,CAAC,CAACuB;EACjB,CAAC;EACDC,KAAK,EAAE;IACLC,IAAI,EAAE,CAAC;IACPC,QAAQ,EAAE,CAAC;IACXC,QAAQ,EAAE7B,CAAC,CAAC8B,IAAI;IAChBC,KAAK,EAAE7B,CAAC,CAAC8B,UAAU;IACnBC,OAAO,EAAE,CAAC;IACVC,MAAM,EAAE,CAAC;IACT;IACAC,YAAY,EAAE;EAChB,CAAC;EACD;EACAC,cAAc,EAAE;IACdC,iBAAiB,EAAE;EACrB,CAAC;EACDC,QAAQ,EAAE;IACRT,QAAQ,EAAE7B,CAAC,CAACuC,KAAK;IACjBR,KAAK,EAAE7B,CAAC,CAACuB,KAAK;IACde,SAAS,EAAE1C,KAAK,CAAC,CAAC,CAAC;IACnBU,iBAAiB,EAAEV,KAAK,CAAC,CAAC,CAAC;IAC3B2C,UAAU,EAAE7C,EAAE,CAAC8C;EACjB,CAAC;EACDC,iBAAiB,EAAE;IACjBC,OAAO,EAAE;EACX;AACF,CAAC,CAAC","ignoreList":[]}
+{"version":3,"names":["StyleSheet","fw","radius","space","type","t","makeStyles","c","create","wrap","flexDirection","alignItems","gap","paddingHorizontal","borderRadius","md","borderWidth","wrapMultiline","paddingVertical","searchInteractiveRow","searchVisibleSurface","position","left","right","wrapIdle","backgroundColor","surfaceContainerHigh","borderColor","wrapActive","surface","wrapFocus","primary","wrapFilled","outline","wrapError","error","input","flex","minWidth","fontSize","body","color","foreground","padding","margin","outlineWidth","inputMultiline","textAlignVertical","slotDisplay","justifyContent","minHeight","slotText","foregroundMuted","sm","actionFrame","width","height","errorMsg","micro","marginTop","fontWeight","regular","containerDisabled","opacity","rootCentered"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/styles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,EAAE,EAAEC,MAAM,EAAEC,KAAK,EAAEC,IAAI,IAAIC,CAAC,QAAQ,yBAAgB;AAG7D;AACA,OAAO,MAAMC,UAAU,GAAIC,CAAc,IACvCP,UAAU,CAACQ,MAAM,CAAC;EAChBC,IAAI,EAAE;IACJC,aAAa,EAAE,KAAK;IACpBC,UAAU,EAAE,QAAQ;IACpBC,GAAG,EAAET,KAAK,CAAC,CAAC,CAAC;IACbU,iBAAiB,EAAEV,KAAK,CAAC,CAAC,CAAC;IAC3BW,YAAY,EAAEZ,MAAM,CAACa,EAAE;IACvBC,WAAW,EAAE;EACf,CAAC;EACDC,aAAa,EAAE;IACbC,eAAe,EAAEf,KAAK,CAAC,CAAC,CAAC;IACzBQ,UAAU,EAAE;EACd,CAAC;EACD;EACAQ,oBAAoB,EAAE;IACpBH,WAAW,EAAE;EACf,CAAC;EACDI,oBAAoB,EAAE;IACpBC,QAAQ,EAAE,UAAU;IACpBC,IAAI,EAAE,CAAC;IACPC,KAAK,EAAE,CAAC;IACRT,YAAY,EAAEZ,MAAM,CAACa,EAAE;IACvBC,WAAW,EAAE;EACf,CAAC;EACDQ,QAAQ,EAAE;IACRC,eAAe,EAAElB,CAAC,CAACmB,oBAAoB;IACvCC,WAAW,EAAE;EACf,CAAC;EACD;EACAC,UAAU,EAAE;IACVH,eAAe,EAAElB,CAAC,CAACsB;EACrB,CAAC;EACDC,SAAS,EAAE;IACTH,WAAW,EAAEpB,CAAC,CAACwB;EACjB,CAAC;EACDC,UAAU,EAAE;IACVL,WAAW,EAAEpB,CAAC,CAAC0B;EACjB,CAAC;EACDC,SAAS,EAAE;IACTP,WAAW,EAAEpB,CAAC,CAAC4B;EACjB,CAAC;EACDC,KAAK,EAAE;IACLC,IAAI,EAAE,CAAC;IACPC,QAAQ,EAAE,CAAC;IACXC,QAAQ,EAAElC,CAAC,CAACmC,IAAI;IAChBC,KAAK,EAAElC,CAAC,CAACmC,UAAU;IACnBC,OAAO,EAAE,CAAC;IACVC,MAAM,EAAE,CAAC;IACT;IACAC,YAAY,EAAE;EAChB,CAAC;EACD;EACAC,cAAc,EAAE;IACdC,iBAAiB,EAAE;EACrB,CAAC;EACDC,WAAW,EAAE;IACXrC,UAAU,EAAE,QAAQ;IACpBsC,cAAc,EAAE,QAAQ;IACxBX,QAAQ,EAAE,EAAE;IACZY,SAAS,EAAE;EACb,CAAC;EACDC,QAAQ,EAAE;IACRV,KAAK,EAAElC,CAAC,CAAC6C,eAAe;IACxBb,QAAQ,EAAElC,CAAC,CAACgD;EACd,CAAC;EACD;EACAC,WAAW,EAAE;IACXC,KAAK,EAAE,EAAE;IACTC,MAAM,EAAE,EAAE;IACV7C,UAAU,EAAE,QAAQ;IACpBsC,cAAc,EAAE;EAClB,CAAC;EACDQ,QAAQ,EAAE;IACRlB,QAAQ,EAAElC,CAAC,CAACqD,KAAK;IACjBjB,KAAK,EAAElC,CAAC,CAAC4B,KAAK;IACdwB,SAAS,EAAExD,KAAK,CAAC,CAAC,CAAC;IACnBU,iBAAiB,EAAEV,KAAK,CAAC,CAAC,CAAC;IAC3ByD,UAAU,EAAE3D,EAAE,CAAC4D;EACjB,CAAC;EACDC,iBAAiB,EAAE;IACjBC,OAAO,EAAE;EACX,CAAC;EACDC,YAAY,EAAE;IACZf,cAAc,EAAE;EAClB;AACF,CAAC,CAAC","ignoreList":[]}

package/lib/module/components/ui/TextField/useErrorAnnouncement.js

@@ -0,0 +1,27 @@
+"use strict";
+
+import { useEffect, useRef } from 'react';
+import { AccessibilityInfo, Platform } from 'react-native';
+
+/** iOS 不会像 Android live region 一样自动播报动态错误,仅播报真实的后续变更。 */
+export function useErrorAnnouncement(error) {
+  const previousError = useRef('');
+  const didCommit = useRef(false);
+  useEffect(() => {
+    const nextError = error ?? '';
+    const previous = previousError.current;
+    previousError.current = nextError;
+    if (!didCommit.current) {
+      didCommit.current = true;
+      return undefined;
+    }
+    if (Platform.OS !== 'ios' || nextError === '' || nextError === previous) {
+      return undefined;
+    }
+    const timer = setTimeout(() => {
+      AccessibilityInfo.announceForAccessibility(nextError);
+    }, 0);
+    return () => clearTimeout(timer);
+  }, [error]);
+}
+//# sourceMappingURL=useErrorAnnouncement.js.map

package/lib/module/components/ui/TextField/useErrorAnnouncement.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","useRef","AccessibilityInfo","Platform","useErrorAnnouncement","error","previousError","didCommit","nextError","previous","current","undefined","OS","timer","setTimeout","announceForAccessibility","clearTimeout"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/useErrorAnnouncement.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,MAAM,QAAQ,OAAO;AACzC,SAASC,iBAAiB,EAAEC,QAAQ,QAAQ,cAAc;;AAE1D;AACA,OAAO,SAASC,oBAAoBA,CAACC,KAAyB,EAAQ;EACpE,MAAMC,aAAa,GAAGL,MAAM,CAAC,EAAE,CAAC;EAChC,MAAMM,SAAS,GAAGN,MAAM,CAAC,KAAK,CAAC;EAE/BD,SAAS,CAAC,MAAM;IACd,MAAMQ,SAAS,GAAGH,KAAK,IAAI,EAAE;IAC7B,MAAMI,QAAQ,GAAGH,aAAa,CAACI,OAAO;IACtCJ,aAAa,CAACI,OAAO,GAAGF,SAAS;IAEjC,IAAI,CAACD,SAAS,CAACG,OAAO,EAAE;MACtBH,SAAS,CAACG,OAAO,GAAG,IAAI;MACxB,OAAOC,SAAS;IAClB;IACA,IAAIR,QAAQ,CAACS,EAAE,KAAK,KAAK,IAAIJ,SAAS,KAAK,EAAE,IAAIA,SAAS,KAAKC,QAAQ,EAAE;MACvE,OAAOE,SAAS;IAClB;IAEA,MAAME,KAAK,GAAGC,UAAU,CAAC,MAAM;MAC7BZ,iBAAiB,CAACa,wBAAwB,CAACP,SAAS,CAAC;IACvD,CAAC,EAAE,CAAC,CAAC;IACL,OAAO,MAAMQ,YAAY,CAACH,KAAK,CAAC;EAClC,CAAC,EAAE,CAACR,KAAK,CAAC,CAAC;AACb","ignoreList":[]}

package/lib/module/components/ui/TextField/useTextFieldValue.js

@@ -0,0 +1,66 @@
+"use strict";
+
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { createLogger } from "../../../utils/logger/index.js";
+import { applyTextChange, createValueState, reconcileValueState, resolveCanUpdate } from "./valueState.js";
+const log = createLogger('TextField');
+const DIAGNOSTIC_MESSAGE = {
+  'controlled-to-uncontrolled': '受控输入的 value 变成了 undefined。mode 已在首次 render 锁定为受控,本次沿用上一个合法值 —— 请始终传字符串(清空用 "")。',
+  'uncontrolled-to-controlled': '非受控输入后来收到了 value。mode 已在首次 render 锁定为非受控,该 value 被忽略 —— 请从一开始就同时传 value 与 onChangeText。',
+  'invalid-controlled-value': '受控输入的 value 必须是字符串。已保持最后一个合法值,不会切换到非受控 mode。'
+};
+/**
+ * 把纯值状态机接到 React 上。
+ *
+ * state 放在 ref 而不是 useState:mode 与受控值必须在**本次 render 内**就正确,
+ * 不能等下一次提交 —— 否则受控组件会先渲染一帧旧值。非受控写入用一个递增 tick
+ * 触发重渲染,值本身仍以 ref 为准。
+ *
+ * 诊断只在 effect 里打:render 期打日志在 StrictMode 双调用下会重复,
+ * 且违反 render 必须纯净的约束。
+ */
+export function useTextFieldValue({
+  value,
+  defaultValue,
+  onChangeText
+}, scope) {
+  const stateRef = useRef(null);
+  if (stateRef.current === null) {
+    stateRef.current = createValueState(value, defaultValue);
+  }
+  const [, bumpTick] = useState(0);
+  const transition = reconcileValueState(stateRef.current, value);
+  stateRef.current = transition.state;
+  const mode = transition.state.mode;
+  const canUpdate = resolveCanUpdate(mode, onChangeText);
+  const diagnostic = transition.diagnostic;
+  useEffect(() => {
+    if (diagnostic) log.warn(`${scope}: ${DIAGNOSTIC_MESSAGE[diagnostic]}`);
+  }, [diagnostic, scope]);
+  useEffect(() => {
+    if (!canUpdate) {
+      log.warn(`${scope}: 受控输入缺少 onChangeText,输入将无法生效。请补上回调,或改用非受控(不传 value)。`);
+    }
+  }, [canUpdate, scope]);
+  const handleChangeText = useCallback(next => {
+    const current = stateRef.current;
+    if (!current) return;
+    if (current.mode === 'uncontrolled') {
+      stateRef.current = applyTextChange(current, next);
+      bumpTick(tick => tick + 1);
+      onChangeText?.(next);
+      return;
+    }
+    // 受控:内部永不写值,只把输入交给调用方。没有回调时直接 no-op ——
+    // 若照旧透传给原生,UI 会显示一个 state 里并不存在的值。
+    if (!canUpdate) return;
+    onChangeText?.(next);
+  }, [canUpdate, onChangeText]);
+  return {
+    mode,
+    value: transition.value,
+    canUpdate,
+    onChangeText: handleChangeText
+  };
+}
+//# sourceMappingURL=useTextFieldValue.js.map

package/lib/module/components/ui/TextField/useTextFieldValue.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["useCallback","useEffect","useRef","useState","createLogger","applyTextChange","createValueState","reconcileValueState","resolveCanUpdate","log","DIAGNOSTIC_MESSAGE","useTextFieldValue","value","defaultValue","onChangeText","scope","stateRef","current","bumpTick","transition","state","mode","canUpdate","diagnostic","warn","handleChangeText","next","tick"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/useTextFieldValue.ts"],"mappings":";;AAAA,SAASA,WAAW,EAAEC,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAChE,SAASC,YAAY,QAAQ,gCAAuB;AACpD,SACEC,eAAe,EACfC,gBAAgB,EAChBC,mBAAmB,EACnBC,gBAAgB,QACX,iBAAc;AAOrB,MAAMC,GAAG,GAAGL,YAAY,CAAC,WAAW,CAAC;AAErC,MAAMM,kBAAmD,GAAG;EAC1D,4BAA4B,EAC1B,iFAAiF;EACnF,4BAA4B,EAC1B,yFAAyF;EAC3F,0BAA0B,EACxB;AACJ,CAAC;AAQD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,iBAAiBA,CAC/B;EAAEC,KAAK;EAAEC,YAAY;EAAEC;AAAqC,CAAC,EAC7DC,KAAa,EACa;EAC1B,MAAMC,QAAQ,GAAGd,MAAM,CAAoB,IAAI,CAAC;EAChD,IAAIc,QAAQ,CAACC,OAAO,KAAK,IAAI,EAAE;IAC7BD,QAAQ,CAACC,OAAO,GAAGX,gBAAgB,CAACM,KAAK,EAAEC,YAAY,CAAC;EAC1D;EACA,MAAM,GAAGK,QAAQ,CAAC,GAAGf,QAAQ,CAAC,CAAC,CAAC;EAEhC,MAAMgB,UAAU,GAAGZ,mBAAmB,CAACS,QAAQ,CAACC,OAAO,EAAEL,KAAK,CAAC;EAC/DI,QAAQ,CAACC,OAAO,GAAGE,UAAU,CAACC,KAAK;EACnC,MAAMC,IAAI,GAAGF,UAAU,CAACC,KAAK,CAACC,IAAI;EAClC,MAAMC,SAAS,GAAGd,gBAAgB,CAACa,IAAI,EAAEP,YAAY,CAAC;EAEtD,MAAMS,UAAU,GAAGJ,UAAU,CAACI,UAAU;EACxCtB,SAAS,CAAC,MAAM;IACd,IAAIsB,UAAU,EAAEd,GAAG,CAACe,IAAI,CAAC,GAAGT,KAAK,KAAKL,kBAAkB,CAACa,UAAU,CAAC,EAAE,CAAC;EACzE,CAAC,EAAE,CAACA,UAAU,EAAER,KAAK,CAAC,CAAC;EAEvBd,SAAS,CAAC,MAAM;IACd,IAAI,CAACqB,SAAS,EAAE;MACdb,GAAG,CAACe,IAAI,CACN,GAAGT,KAAK,uDACV,CAAC;IACH;EACF,CAAC,EAAE,CAACO,SAAS,EAAEP,KAAK,CAAC,CAAC;EAEtB,MAAMU,gBAAgB,GAAGzB,WAAW,CACjC0B,IAAY,IAAK;IAChB,MAAMT,OAAO,GAAGD,QAAQ,CAACC,OAAO;IAChC,IAAI,CAACA,OAAO,EAAE;IACd,IAAIA,OAAO,CAACI,IAAI,KAAK,cAAc,EAAE;MACnCL,QAAQ,CAACC,OAAO,GAAGZ,eAAe,CAACY,OAAO,EAAES,IAAI,CAAC;MACjDR,QAAQ,CAAES,IAAI,IAAKA,IAAI,GAAG,CAAC,CAAC;MAC5Bb,YAAY,GAAGY,IAAI,CAAC;MACpB;IACF;IACA;IACA;IACA,IAAI,CAACJ,SAAS,EAAE;IAChBR,YAAY,GAAGY,IAAI,CAAC;EACtB,CAAC,EACD,CAACJ,SAAS,EAAER,YAAY,CAC1B,CAAC;EAED,OAAO;IACLO,IAAI;IACJT,KAAK,EAAEO,UAAU,CAACP,KAAK;IACvBU,SAAS;IACTR,YAAY,EAAEW;EAChB,CAAC;AACH","ignoreList":[]}

package/lib/module/components/ui/TextField/valueState.js

@@ -0,0 +1,93 @@
+"use strict";
+
+/**
+ * TextField 家族的**纯值状态机** —— 无 React 依赖,可直接单测。
+ *
+ * 核心规则:**mode 在首次 render 锁定,之后永不切换**。
+ *
+ * 为什么 —— 受控 / 非受控中途互换是 React 里最难查的一类 bug:光标跳位、输入被回滚、
+ * 表单提交拿到过期值。与其在每次 render 猜测调用方意图,不如锁定一次并在偏离时报诊断。
+ *
+ * mode 判据是 `value !== undefined`,**不是** `'value' in props` 也不是
+ * `typeof value === 'string'`:前者会把 `<Input value={maybeUndefined} />` 这种
+ * 常见写法误判为受控(值一旦为 undefined 就锁死输入),后者对显式 `undefined` 与
+ * 缺省无法区分。显式 `undefined` 一律按非受控处理。
+ */
+
+export function createValueState(value, defaultValue) {
+  if (value !== undefined) {
+    const safeValue = typeof value === 'string' ? value : '';
+    return {
+      mode: 'controlled',
+      value: safeValue,
+      lastValidControlledValue: safeValue
+    };
+  }
+  return {
+    mode: 'uncontrolled',
+    value: typeof defaultValue === 'string' ? defaultValue : ''
+  };
+}
+
+/**
+ * 用本轮 render 的 `value` 与已锁定的 state 对账。返回新 state(不原地修改)、
+ * 本轮应当显示的值,以及偏离锁定 mode 时的诊断。
+ */
+export function reconcileValueState(state, incomingValue) {
+  if (state.mode === 'controlled') {
+    if (incomingValue === undefined) {
+      // 受控组件的 value 变成 undefined:保持受控,显示最后一个合法值。
+      // 若直接透传 undefined 给 TextInput,RN 会把它当成非受控并保留用户输入 —— 静默换 mode。
+      return {
+        state,
+        value: state.lastValidControlledValue,
+        diagnostic: 'controlled-to-uncontrolled'
+      };
+    }
+    if (typeof incomingValue !== 'string') {
+      return {
+        state,
+        value: state.lastValidControlledValue,
+        diagnostic: 'invalid-controlled-value'
+      };
+    }
+    return {
+      state: {
+        mode: 'controlled',
+        value: incomingValue,
+        lastValidControlledValue: incomingValue
+      },
+      value: incomingValue
+    };
+  }
+  if (incomingValue !== undefined) {
+    // 非受控组件后来又传了 value:忽略它,继续用内部值,只报诊断。
+    return {
+      state,
+      value: state.value,
+      diagnostic: 'uncontrolled-to-controlled'
+    };
+  }
+  return {
+    state,
+    value: state.value
+  };
+}
+
+/** 用户输入。只有非受控才写内部值;受控的值永远来自调用方。 */
+export function applyTextChange(state, text) {
+  if (state.mode === 'controlled') return state;
+  return {
+    mode: 'uncontrolled',
+    value: text
+  };
+}
+
+/**
+ * 非受控恒可更新(内部持值);受控只有拿到 `onChangeText` 才可更新 ——
+ * 类型层已要求受控必须带回调,这里兜住未走类型的 JS 调用方。
+ */
+export function resolveCanUpdate(mode, onChangeText) {
+  return mode === 'uncontrolled' || typeof onChangeText === 'function';
+}
+//# sourceMappingURL=valueState.js.map

package/lib/module/components/ui/TextField/valueState.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createValueState","value","defaultValue","undefined","safeValue","mode","lastValidControlledValue","reconcileValueState","state","incomingValue","diagnostic","applyTextChange","text","resolveCanUpdate","onChangeText"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/valueState.ts"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAkCA,OAAO,SAASA,gBAAgBA,CAC9BC,KAAc,EACdC,YAAqB,EACT;EACZ,IAAID,KAAK,KAAKE,SAAS,EAAE;IACvB,MAAMC,SAAS,GAAG,OAAOH,KAAK,KAAK,QAAQ,GAAGA,KAAK,GAAG,EAAE;IACxD,OAAO;MACLI,IAAI,EAAE,YAAY;MAClBJ,KAAK,EAAEG,SAAS;MAChBE,wBAAwB,EAAEF;IAC5B,CAAC;EACH;EACA,OAAO;IACLC,IAAI,EAAE,cAAc;IACpBJ,KAAK,EAAE,OAAOC,YAAY,KAAK,QAAQ,GAAGA,YAAY,GAAG;EAC3D,CAAC;AACH;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASK,mBAAmBA,CACjCC,KAAiB,EACjBC,aAAsB,EACL;EACjB,IAAID,KAAK,CAACH,IAAI,KAAK,YAAY,EAAE;IAC/B,IAAII,aAAa,KAAKN,SAAS,EAAE;MAC/B;MACA;MACA,OAAO;QACLK,KAAK;QACLP,KAAK,EAAEO,KAAK,CAACF,wBAAwB;QACrCI,UAAU,EAAE;MACd,CAAC;IACH;IACA,IAAI,OAAOD,aAAa,KAAK,QAAQ,EAAE;MACrC,OAAO;QACLD,KAAK;QACLP,KAAK,EAAEO,KAAK,CAACF,wBAAwB;QACrCI,UAAU,EAAE;MACd,CAAC;IACH;IACA,OAAO;MACLF,KAAK,EAAE;QACLH,IAAI,EAAE,YAAY;QAClBJ,KAAK,EAAEQ,aAAa;QACpBH,wBAAwB,EAAEG;MAC5B,CAAC;MACDR,KAAK,EAAEQ;IACT,CAAC;EACH;EACA,IAAIA,aAAa,KAAKN,SAAS,EAAE;IAC/B;IACA,OAAO;MACLK,KAAK;MACLP,KAAK,EAAEO,KAAK,CAACP,KAAK;MAClBS,UAAU,EAAE;IACd,CAAC;EACH;EACA,OAAO;IAAEF,KAAK;IAAEP,KAAK,EAAEO,KAAK,CAACP;EAAM,CAAC;AACtC;;AAEA;AACA,OAAO,SAASU,eAAeA,CAACH,KAAiB,EAAEI,IAAY,EAAc;EAC3E,IAAIJ,KAAK,CAACH,IAAI,KAAK,YAAY,EAAE,OAAOG,KAAK;EAC7C,OAAO;IAAEH,IAAI,EAAE,cAAc;IAAEJ,KAAK,EAAEW;EAAK,CAAC;AAC9C;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASC,gBAAgBA,CAC9BR,IAAwB,EACxBS,YAAmD,EAC1C;EACT,OAAOT,IAAI,KAAK,cAAc,IAAI,OAAOS,YAAY,KAAK,UAAU;AACtE","ignoreList":[]}

package/lib/module/components/ui/Textarea/Textarea.js

@@ -2,6 +2,7 @@
 
 import { forwardRef } from 'react';
 import { TextFieldBase } from "../TextField/TextFieldBase.js";
+import { sanitizeTextFieldWrapperProps } from "../TextField/normalize.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 /**
  * 多行文本输入框 —— 视觉与 Input 一致(idle/focus/filled/error/disabled)。
@@ -13,13 +14,16 @@ import { jsx as _jsx } from "react/jsx-runtime";
  *
  * 实现层走 `<TextFieldBase multiline>`,本组件是薄 wrap。
  *
- * Ref:forwardRef<TextInput>,业务可调 `ref.current?.focus()`。
+ * Ref:forwardRef<TextFieldHandle>,业务只可调 `focus()` / `blur()`。
  */
 export const Textarea = /*#__PURE__*/forwardRef(function Textarea(props, ref) {
+  const {
+    props: safeProps
+  } = sanitizeTextFieldWrapperProps(props);
   return /*#__PURE__*/_jsx(TextFieldBase, {
     ref: ref,
-    multiline: true,
-    ...props
+    ...safeProps,
+    multiline: true
   });
 });
 Textarea.displayName = 'Textarea';

package/lib/module/components/ui/Textarea/Textarea.js.map

@@ -1 +1 @@
-{"version":3,"names":["forwardRef","TextFieldBase","jsx","_jsx","Textarea","props","ref","multiline","displayName"],"sourceRoot":"../../../../../src","sources":["components/ui/Textarea/Textarea.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,OAAO;AAClC,SAASC,aAAa,QAA2B,+BAA4B;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAG9E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,QAAQ,gBAAGJ,UAAU,CAChC,SAASI,QAAQA,CAACC,KAAK,EAAEC,GAAG,EAAE;EAC5B,oBAAOH,IAAA,CAACF,aAAa;IAACK,GAAG,EAAEA,GAAI;IAACC,SAAS;IAAA,GAAKF;EAAK,CAAG,CAAC;AACzD,CACF,CAAC;AAEDD,QAAQ,CAACI,WAAW,GAAG,UAAU","ignoreList":[]}
+{"version":3,"names":["forwardRef","TextFieldBase","sanitizeTextFieldWrapperProps","jsx","_jsx","Textarea","props","ref","safeProps","multiline","displayName"],"sourceRoot":"../../../../../src","sources":["components/ui/Textarea/Textarea.tsx"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,OAAO;AAClC,SAASC,aAAa,QAAQ,+BAA4B;AAC1D,SAASC,6BAA6B,QAAQ,2BAAwB;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAIvE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,QAAQ,gBAAGL,UAAU,CAChC,SAASK,QAAQA,CAACC,KAAK,EAAEC,GAAG,EAAE;EAC5B,MAAM;IAAED,KAAK,EAAEE;EAAU,CAAC,GAAGN,6BAA6B,CACxDI,KACF,CAAC;EACD,oBACEF,IAAA,CAACH,aAAa;IAACM,GAAG,EAAEA,GAAI;IAAA,GAAMC,SAAS;IAAoBC,SAAS;EAAA,CAAE,CAAC;AAE3E,CACF,CAAC;AAEDJ,QAAQ,CAACK,WAAW,GAAG,UAAU","ignoreList":[]}

package/lib/module/components/ui/Thumbnail/Thumbnail.js

@@ -1,60 +1,79 @@
 "use strict";
 
-import React from 'react';
-import { Image, View } from 'react-native';
-import { useThemedStyles } from "../../../theme/index.js";
+import React, { useEffect, createElement as _createElement } from 'react';
+import { StyleSheet, View } from 'react-native';
+import { useColors, useThemedStyles } from "../../../theme/index.js";
+import { resolveImageSource } from "../../../utils/imageSource.js";
 import { createLogger } from "../../../utils/logger/index.js";
-import { makeStyles, RING_EXTRA_RADIUS, sizingFor } from "./styles.js";
-import { jsx as _jsx } from "react/jsx-runtime";
+import { ImageAttempt } from "../shared/ImageAttempt.js";
+import { A11Y_HIDDEN_PROPS } from "../shared/a11y.js";
+import { sanitizeThumbnailImageStyle } from "./normalize.js";
+import { makeStyles, sizingFor } from "./styles.js";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 const log = createLogger('Thumbnail');
+const hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
 
-/** 缩略图基础组件 —— 列表 / 卡片 / chat 行内通用 16:9.5 小图。
- *
- *  尺寸阶梯:sm / md(默认 113×67)/ lg,与 NewsList / NewsArea 历史一致。
- *  bg 占位 = c.surfaceContainer(图加载中 / 失败时不至于空白)。
- *  `selected` 时外层套 View 画 2pt 品牌色 ring;不选中保持纯 Image 结构。
- *
- *  用法:
- *  - 远程 URL:`<Thumbnail uri={item.coverUrl} />`
- *  - 本地资源:`<Thumbnail source={require('./fallback.png')} />`
- *  - 自定义尺寸:`<Thumbnail uri={...} size="lg" />`
- *  - 选中态:`<Thumbnail uri={...} selected />` */
-export function Thumbnail({
-  uri,
-  source,
-  size = 'md',
-  selected,
-  style,
-  resizeMode = 'cover',
-  accessibilityLabel,
-  testID
-}) {
+/**
+ * 稳定两层缩略图：outer 只管 caller layout，inner visual frame 固定尺寸并始终
+ * 保留 ring。无效 / 加载失败 source 只显示 frame placeholder，不改变布局结构。
+ */
+export function Thumbnail(props) {
+  const {
+    uri,
+    source,
+    size = 'md',
+    selected,
+    containerStyle,
+    imageStyle,
+    resizeMode = 'cover',
+    accessibilityLabel,
+    testID
+  } = props;
+  const colors = useColors();
   const styles = useThemedStyles(makeStyles);
-  if (!uri && !source) {
-    // [L-18] uri/source 均未传:一次性告警,返回 null 而非空白区域。
-    // types 注释已说明二选一语义;此 warn 用于开发期快速定位漏传。
-    log.warn('Thumbnail: uri 和 source 均未提供,组件将渲染为 null');
-    return null;
-  }
   const dim = sizingFor(size);
-  const image = /*#__PURE__*/_jsx(Image, {
-    source: uri ? {
-      uri
-    } : source,
-    style: [styles.base, dim, style],
-    resizeMode: resizeMode,
-    accessibilityLabel: accessibilityLabel,
-    accessible: !!accessibilityLabel,
-    testID: selected ? undefined : testID
-  });
-  if (!selected) return image;
-  // ring 容器:borderRadius 比 image 大 (border + padding) 才能贴合包裹外圈
+  const hasUri = hasOwn(props, 'uri');
+  const hasSource = hasOwn(props, 'source');
+  const sourceCandidate = hasUri !== hasSource ? hasUri && typeof uri === 'string' ? {
+    uri: uri.trim()
+  } : source : undefined;
+  const resolvedSource = resolveImageSource(sourceCandidate);
+  const sanitizedImageStyle = sanitizeThumbnailImageStyle(imageStyle);
+  const diagnostics = [...(resolvedSource === undefined ? ['source'] : []), ...sanitizedImageStyle.diagnostics.map(field => field === 'style' ? 'imageStyle' : `imageStyle.${field}`)];
+  const diagnosticKey = diagnostics.join(',');
+  useEffect(() => {
+    if (__DEV__ && diagnosticKey.length > 0) {
+      log.warn(`Thumbnail: 非法运行时输入(${diagnosticKey})已回退。`);
+    }
+  }, [diagnosticKey]);
+  const normalizedLabel = typeof accessibilityLabel === 'string' ? accessibilityLabel.trim() : undefined;
+  const imageAccessibilityProps = normalizedLabel && normalizedLabel.length > 0 ? {
+    accessible: true,
+    accessibilityLabel: normalizedLabel,
+    accessibilityRole: 'image'
+  } : A11Y_HIDDEN_PROPS;
+  const ringStyle = {
+    borderRadius: dim.borderRadius,
+    borderColor: selected ? colors.primary : 'transparent'
+  };
   return /*#__PURE__*/_jsx(View, {
-    style: [styles.ring, {
-      borderRadius: dim.borderRadius + RING_EXTRA_RADIUS
-    }],
+    style: containerStyle,
     testID: testID,
-    children: image
+    children: /*#__PURE__*/_jsxs(View, {
+      style: [styles.visualFrame, dim],
+      children: [resolvedSource === undefined ? null : /*#__PURE__*/_createElement(ImageAttempt, {
+        ...imageAccessibilityProps,
+        key: resolvedSource.key,
+        source: resolvedSource.source,
+        fallback: null,
+        style: [sanitizedImageStyle.style, StyleSheet.absoluteFill],
+        resizeMode: resizeMode
+      }), /*#__PURE__*/_jsx(View, {
+        ...A11Y_HIDDEN_PROPS,
+        pointerEvents: "none",
+        style: [StyleSheet.absoluteFill, styles.ring, ringStyle]
+      })]
+    })
   });
 }
 //# sourceMappingURL=Thumbnail.js.map

package/lib/module/components/ui/Thumbnail/Thumbnail.js.map

@@ -1 +1 @@
-{"version":3,"names":["React","Image","View","useThemedStyles","createLogger","makeStyles","RING_EXTRA_RADIUS","sizingFor","jsx","_jsx","log","Thumbnail","uri","source","size","selected","style","resizeMode","accessibilityLabel","testID","styles","warn","dim","image","base","accessible","undefined","ring","borderRadius","children"],"sourceRoot":"../../../../../src","sources":["components/ui/Thumbnail/Thumbnail.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,SAASC,KAAK,EAAEC,IAAI,QAAQ,cAAc;AAC1C,SAASC,eAAe,QAAQ,yBAAgB;AAChD,SAASC,YAAY,QAAQ,gCAAuB;AACpD,SAASC,UAAU,EAAEC,iBAAiB,EAAEC,SAAS,QAAQ,aAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAGpE,MAAMC,GAAG,GAAGN,YAAY,CAAC,WAAW,CAAC;;AAErC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASO,SAASA,CAAC;EACxBC,GAAG;EACHC,MAAM;EACNC,IAAI,GAAG,IAAI;EACXC,QAAQ;EACRC,KAAK;EACLC,UAAU,GAAG,OAAO;EACpBC,kBAAkB;EAClBC;AACc,CAAC,EAA4B;EAC3C,MAAMC,MAAM,GAAGjB,eAAe,CAACE,UAAU,CAAC;EAC1C,IAAI,CAACO,GAAG,IAAI,CAACC,MAAM,EAAE;IACnB;IACA;IACAH,GAAG,CAACW,IAAI,CAAC,0CAA0C,CAAC;IACpD,OAAO,IAAI;EACb;EACA,MAAMC,GAAG,GAAGf,SAAS,CAACO,IAAI,CAAC;EAC3B,MAAMS,KAAK,gBACTd,IAAA,CAACR,KAAK;IACJY,MAAM,EAAED,GAAG,GAAG;MAAEA;IAAI,CAAC,GAAIC,MAAsC;IAC/DG,KAAK,EAAE,CAACI,MAAM,CAACI,IAAI,EAAEF,GAAG,EAAEN,KAAK,CAAE;IACjCC,UAAU,EAAEA,UAAW;IACvBC,kBAAkB,EAAEA,kBAAmB;IACvCO,UAAU,EAAE,CAAC,CAACP,kBAAmB;IACjCC,MAAM,EAAEJ,QAAQ,GAAGW,SAAS,GAAGP;EAAO,CACvC,CACF;EACD,IAAI,CAACJ,QAAQ,EAAE,OAAOQ,KAAK;EAC3B;EACA,oBACEd,IAAA,CAACP,IAAI;IACHc,KAAK,EAAE,CACLI,MAAM,CAACO,IAAI,EACX;MAAEC,YAAY,EAAEN,GAAG,CAACM,YAAY,GAAGtB;IAAkB,CAAC,CACtD;IACFa,MAAM,EAAEA,MAAO;IAAAU,QAAA,EAEdN;EAAK,CACF,CAAC;AAEX","ignoreList":[]}
+{"version":3,"names":["React","useEffect","createElement","_createElement","StyleSheet","View","useColors","useThemedStyles","resolveImageSource","createLogger","ImageAttempt","A11Y_HIDDEN_PROPS","sanitizeThumbnailImageStyle","makeStyles","sizingFor","jsx","_jsx","jsxs","_jsxs","log","hasOwn","value","key","Object","prototype","hasOwnProperty","call","Thumbnail","props","uri","source","size","selected","containerStyle","imageStyle","resizeMode","accessibilityLabel","testID","colors","styles","dim","hasUri","hasSource","sourceCandidate","trim","undefined","resolvedSource","sanitizedImageStyle","diagnostics","map","field","diagnosticKey","join","__DEV__","length","warn","normalizedLabel","imageAccessibilityProps","accessible","accessibilityRole","ringStyle","borderRadius","borderColor","primary","style","children","visualFrame","fallback","absoluteFill","pointerEvents","ring"],"sourceRoot":"../../../../../src","sources":["components/ui/Thumbnail/Thumbnail.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/components/ui/Thumbnail/normalize.js

@@ -0,0 +1,58 @@
+"use strict";
+
+import { StyleSheet } from 'react-native';
+const RESERVED_IMAGE_STYLE_KEYS = ['position', 'top', 'right', 'bottom', 'left', 'width', 'height', 'minWidth', 'minHeight', 'maxWidth', 'maxHeight'];
+function invalidStyle() {
+  return {
+    style: {},
+    diagnostics: ['style']
+  };
+}
+function isEmptyStyleInput(value) {
+  if (value === undefined || value === null || value === false) return true;
+  if (!Array.isArray(value)) return false;
+  return value.every(isEmptyStyleInput);
+}
+
+/**
+ * 先 flatten 再复制允许字段，兼容 registered / array style，同时不修改 caller。
+ * 任意异常或非对象产物都失败关闭，避免宽类型 JS 值穿透到原生 Image。
+ */
+export function sanitizeThumbnailImageStyle(style) {
+  try {
+    if (isEmptyStyleInput(style)) {
+      return {
+        style: {},
+        diagnostics: []
+      };
+    }
+    if (typeof style !== 'object' && typeof style !== 'number') {
+      return invalidStyle();
+    }
+    const flattened = StyleSheet.flatten(style);
+    if (flattened === undefined || flattened === null || flattened === false) {
+      return invalidStyle();
+    }
+    if (typeof flattened !== 'object' || Array.isArray(flattened)) {
+      return invalidStyle();
+    }
+    const source = flattened;
+    const reserved = new Set(RESERVED_IMAGE_STYLE_KEYS);
+    const foundReserved = new Set();
+    const sanitized = {};
+    for (const [key, value] of Object.entries(source)) {
+      if (reserved.has(key)) {
+        foundReserved.add(key);
+      } else {
+        sanitized[key] = value;
+      }
+    }
+    return {
+      style: sanitized,
+      diagnostics: RESERVED_IMAGE_STYLE_KEYS.filter(key => foundReserved.has(key))
+    };
+  } catch {
+    return invalidStyle();
+  }
+}
+//# sourceMappingURL=normalize.js.map

package/lib/module/components/ui/Thumbnail/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["StyleSheet","RESERVED_IMAGE_STYLE_KEYS","invalidStyle","style","diagnostics","isEmptyStyleInput","value","undefined","Array","isArray","every","sanitizeThumbnailImageStyle","flattened","flatten","source","reserved","Set","foundReserved","sanitized","key","Object","entries","has","add","filter"],"sourceRoot":"../../../../../src","sources":["components/ui/Thumbnail/normalize.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AAIzC,MAAMC,yBAAyB,GAAG,CAChC,UAAU,EACV,KAAK,EACL,OAAO,EACP,QAAQ,EACR,MAAM,EACN,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,CACH;AAOV,SAASC,YAAYA,CAAA,EAAiC;EACpD,OAAO;IAAEC,KAAK,EAAE,CAAC,CAAC;IAAEC,WAAW,EAAE,CAAC,OAAO;EAAE,CAAC;AAC9C;AAEA,SAASC,iBAAiBA,CAACC,KAAc,EAAW;EAClD,IAAIA,KAAK,KAAKC,SAAS,IAAID,KAAK,KAAK,IAAI,IAAIA,KAAK,KAAK,KAAK,EAAE,OAAO,IAAI;EACzE,IAAI,CAACE,KAAK,CAACC,OAAO,CAACH,KAAK,CAAC,EAAE,OAAO,KAAK;EACvC,OAAOA,KAAK,CAACI,KAAK,CAACL,iBAAiB,CAAC;AACvC;;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASM,2BAA2BA,CACzCR,KAAiD,EACnB;EAC9B,IAAI;IACF,IAAIE,iBAAiB,CAACF,KAAK,CAAC,EAAE;MAC5B,OAAO;QAAEA,KAAK,EAAE,CAAC,CAAC;QAAEC,WAAW,EAAE;MAAG,CAAC;IACvC;IACA,IAAI,OAAOD,KAAK,KAAK,QAAQ,IAAI,OAAOA,KAAK,KAAK,QAAQ,EAAE;MAC1D,OAAOD,YAAY,CAAC,CAAC;IACvB;IAEA,MAAMU,SAAS,GAAGZ,UAAU,CAACa,OAAO,CAACV,KAAK,CAAY;IACtD,IAAIS,SAAS,KAAKL,SAAS,IAAIK,SAAS,KAAK,IAAI,IAAIA,SAAS,KAAK,KAAK,EAAE;MACxE,OAAOV,YAAY,CAAC,CAAC;IACvB;IACA,IAAI,OAAOU,SAAS,KAAK,QAAQ,IAAIJ,KAAK,CAACC,OAAO,CAACG,SAAS,CAAC,EAAE;MAC7D,OAAOV,YAAY,CAAC,CAAC;IACvB;IAEA,MAAMY,MAAM,GAAGF,SAAoC;IACnD,MAAMG,QAAQ,GAAG,IAAIC,GAAG,CAASf,yBAAyB,CAAC;IAC3D,MAAMgB,aAAa,GAAG,IAAID,GAAG,CAAS,CAAC;IACvC,MAAME,SAAkC,GAAG,CAAC,CAAC;IAC7C,KAAK,MAAM,CAACC,GAAG,EAAEb,KAAK,CAAC,IAAIc,MAAM,CAACC,OAAO,CAACP,MAAM,CAAC,EAAE;MACjD,IAAIC,QAAQ,CAACO,GAAG,CAACH,GAAG,CAAC,EAAE;QACrBF,aAAa,CAACM,GAAG,CAACJ,GAAG,CAAC;MACxB,CAAC,MAAM;QACLD,SAAS,CAACC,GAAG,CAAC,GAAGb,KAAK;MACxB;IACF;IAEA,OAAO;MACLH,KAAK,EAAEe,SAAgC;MACvCd,WAAW,EAAEH,yBAAyB,CAACuB,MAAM,CAAEL,GAAG,IAChDF,aAAa,CAACK,GAAG,CAACH,GAAG,CACvB;IACF,CAAC;EACH,CAAC,CAAC,MAAM;IACN,OAAOjB,YAAY,CAAC,CAAC;EACvB;AACF","ignoreList":[]}

package/lib/module/components/ui/Thumbnail/styles.js

@@ -2,21 +2,16 @@
 
 import { StyleSheet } from 'react-native';
 import { r } from "../../../theme/index.js";
-/** [L-94] ring 圆角外展量:border(2) + padding(1) = 3pt,让外圈圆角贴合内圆角。
- *  Thumbnail.tsx 侧用此常量替代魔数 `+ 3`。 */
-export const RING_EXTRA_RADIUS = r(2) + r(1); // border + padding
-
 /** Thumbnail 静态样式 ——
- *  - `base`:Image 占位色,加载中 / 失败时不至于空白
- *  - `ring`:`selected` 态的外圈品牌色描边,padding 抵消 ring 与 image 之间留 1pt gap */
+ *  - `visualFrame`:固定尺寸、裁切、加载失败 placeholder
+ *  - `ring`:始终存在的 2pt visual overlay，selected 只切颜色 */
 export const makeStyles = c => StyleSheet.create({
-  base: {
-    backgroundColor: c.surfaceContainer
+  visualFrame: {
+    backgroundColor: c.surfaceContainer,
+    overflow: 'hidden'
   },
   ring: {
-    borderWidth: r(2),
-    borderColor: c.primary,
-    padding: r(1)
+    borderWidth: 2
   }
 });
 

package/lib/module/components/ui/Thumbnail/styles.js.map

@@ -1 +1 @@
-{"version":3,"names":["StyleSheet","r","RING_EXTRA_RADIUS","makeStyles","c","create","base","backgroundColor","surfaceContainer","ring","borderWidth","borderColor","primary","padding","sizingFor","size","width","height","borderRadius"],"sourceRoot":"../../../../../src","sources":["components/ui/Thumbnail/styles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,CAAC,QAA0B,yBAAgB;AAGpD;AACA;AACA,OAAO,MAAMC,iBAAiB,GAAGD,CAAC,CAAC,CAAC,CAAC,GAAGA,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;;AAE9C;AACA;AACA;AACA,OAAO,MAAME,UAAU,GAAIC,CAAc,IACvCJ,UAAU,CAACK,MAAM,CAAC;EAChBC,IAAI,EAAE;IACJC,eAAe,EAAEH,CAAC,CAACI;EACrB,CAAC;EACDC,IAAI,EAAE;IACJC,WAAW,EAAET,CAAC,CAAC,CAAC,CAAC;IACjBU,WAAW,EAAEP,CAAC,CAACQ,OAAO;IACtBC,OAAO,EAAEZ,CAAC,CAAC,CAAC;EACd;AACF,CAAC,CAAC;;AAEJ;AACA;AACA,OAAO,MAAMa,SAAS,GAAIC,IAAmB,IAAK;EAChD,QAAQA,IAAI;IACV,KAAK,IAAI;MACP,OAAO;QAAEC,KAAK,EAAEf,CAAC,CAAC,EAAE,CAAC;QAAEgB,MAAM,EAAEhB,CAAC,CAAC,EAAE,CAAC;QAAEiB,YAAY,EAAEjB,CAAC,CAAC,CAAC;MAAE,CAAC;IAC5D,KAAK,IAAI;MACP,OAAO;QAAEe,KAAK,EAAEf,CAAC,CAAC,GAAG,CAAC;QAAEgB,MAAM,EAAEhB,CAAC,CAAC,EAAE,CAAC;QAAEiB,YAAY,EAAEjB,CAAC,CAAC,EAAE;MAAE,CAAC;IAC9D,KAAK,IAAI;IACT;MACE;MACA,OAAO;QAAEe,KAAK,EAAEf,CAAC,CAAC,GAAG,CAAC;QAAEgB,MAAM,EAAEhB,CAAC,CAAC,EAAE,CAAC;QAAEiB,YAAY,EAAEjB,CAAC,CAAC,CAAC;MAAE,CAAC;EAC/D;AACF,CAAC","ignoreList":[]}
+{"version":3,"names":["StyleSheet","r","makeStyles","c","create","visualFrame","backgroundColor","surfaceContainer","overflow","ring","borderWidth","sizingFor","size","width","height","borderRadius"],"sourceRoot":"../../../../../src","sources":["components/ui/Thumbnail/styles.ts"],"mappings":";;AAAA,SAASA,UAAU,QAAQ,cAAc;AACzC,SAASC,CAAC,QAA0B,yBAAgB;AAGpD;AACA;AACA;AACA,OAAO,MAAMC,UAAU,GAAIC,CAAc,IACvCH,UAAU,CAACI,MAAM,CAAC;EAChBC,WAAW,EAAE;IACXC,eAAe,EAAEH,CAAC,CAACI,gBAAgB;IACnCC,QAAQ,EAAE;EACZ,CAAC;EACDC,IAAI,EAAE;IACJC,WAAW,EAAE;EACf;AACF,CAAC,CAAC;;AAEJ;AACA;AACA,OAAO,MAAMC,SAAS,GAAIC,IAAmB,IAAK;EAChD,QAAQA,IAAI;IACV,KAAK,IAAI;MACP,OAAO;QAAEC,KAAK,EAAEZ,CAAC,CAAC,EAAE,CAAC;QAAEa,MAAM,EAAEb,CAAC,CAAC,EAAE,CAAC;QAAEc,YAAY,EAAEd,CAAC,CAAC,CAAC;MAAE,CAAC;IAC5D,KAAK,IAAI;MACP,OAAO;QAAEY,KAAK,EAAEZ,CAAC,CAAC,GAAG,CAAC;QAAEa,MAAM,EAAEb,CAAC,CAAC,EAAE,CAAC;QAAEc,YAAY,EAAEd,CAAC,CAAC,EAAE;MAAE,CAAC;IAC9D,KAAK,IAAI;IACT;MACE;MACA,OAAO;QAAEY,KAAK,EAAEZ,CAAC,CAAC,GAAG,CAAC;QAAEa,MAAM,EAAEb,CAAC,CAAC,EAAE,CAAC;QAAEc,YAAY,EAAEd,CAAC,CAAC,CAAC;MAAE,CAAC;EAC/D;AACF,CAAC","ignoreList":[]}