@unif/react-native-design 0.20.0 → 0.21.0

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

@@ -1,112 +1,157 @@
 "use strict";
 
-import React, { forwardRef, useState } from 'react';
-import { Text, TextInput, View } from 'react-native';
-import { control, r, space, useColors, useThemedStyles } from "../../../theme/index.js";
+import React, { forwardRef, useEffect, useImperativeHandle, useState } from 'react';
+import { Platform, Text, TextInput, View } from 'react-native';
+import { fixed, space, useColors, useThemedStyles } from "../../../theme/index.js";
 import { childTestID } from "../../../utils/testID/index.js";
+import { createLogger } from "../../../utils/logger/index.js";
+import { normalizeInputHeight, normalizeTextareaHeights, sanitizeTextFieldContainerStyle } from "./normalize.js";
 import { makeStyles } from "./styles.js";
-
-/** `TextInput` 在 react-native-strict-api 下是组件类型(`TextInputType`),
- *  ref 实例类型走 `ComponentRef<typeof TextInput>`(对应内部 `_TextInputInstance`)。 */
+import { TextFieldSlot } from "./TextFieldSlot.js";
+import { useErrorAnnouncement } from "./useErrorAnnouncement.js";
+import { useTextFieldValue } from "./useTextFieldValue.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/**
- * Input / Textarea 共享 primitive —— internal,不在主 barrel 导出。
- *
- * 行为:
- * - 视觉 4 态:idle(浅灰)/ focus(白底 brand 边)/ filled(白底 outline 边)/ error
- * - leading / trailing 左右 slot
- * - disabled 优先于 editable
- * - multiline=false → 单行 fixed height(默认 control.lg)
- * - multiline=true → 多行 minHeight/maxHeight,文字顶对齐,wrap 上下加 padding
- * - forwardRef<TextInput> —— 业务表单 inputRef.current?.focus() 聚焦
- *
- * 公开 API 是 Input / Textarea(本组件不直接给业务用)。
- */
-export const TextFieldBase = /*#__PURE__*/forwardRef(function TextFieldBase({
-  multiline = false,
-  height = control.lg,
-  // [L-81] multiline minHeight 裸 96 → r(96),随设备缩放
-  minHeight = r(96),
-  maxHeight,
-  leading,
-  trailing,
-  error,
-  disabled,
-  editable,
-  containerStyle,
-  value,
-  onFocus,
-  onBlur,
-  onChangeText,
-  testID,
-  ...rest
-}, ref) {
-  const c = useColors();
+const log = createLogger('TextField');
+
+/** internal native ref type;公开 ref 一律用 TextFieldHandle。 */
+
+/** Input / Textarea / Search 共享的严格输入 primitive — internal,不进公共 barrel。 */
+export const TextFieldBase = /*#__PURE__*/forwardRef(function TextFieldBase(props, forwardedRef) {
+  const {
+    multiline,
+    height,
+    minHeight,
+    maxHeight,
+    searchLayout,
+    leading,
+    trailing,
+    error,
+    disabled,
+    editable,
+    containerStyle,
+    value,
+    defaultValue,
+    onChangeText,
+    accessibilityState,
+    accessibilityRole,
+    placeholderTextColor: callerPlaceholder,
+    onFocus,
+    onBlur,
+    testID,
+    style: _style,
+    numberOfLines: _numberOfLines,
+    ['aria-disabled']: _ariaDisabled,
+    readOnly: _readOnly,
+    role: _role,
+    enterKeyHint: _enterKeyHint,
+    clearTextOnFocus: _clearTextOnFocus,
+    ...allowedNativeProps
+  } = props;
+  const removedNativeAliasKey = Object.entries({
+    'style': _style,
+    'numberOfLines': _numberOfLines,
+    'aria-disabled': _ariaDisabled,
+    'readOnly': _readOnly,
+    'role': _role,
+    'enterKeyHint': _enterKeyHint,
+    'clearTextOnFocus': _clearTextOnFocus
+  }).filter(([, entry]) => entry !== undefined).map(([name]) => name).join(',');
+  const colors = useColors();
   const styles = useThemedStyles(makeStyles);
   const [focused, setFocused] = useState(false);
-  // [M-9] 内部镜像 state:非受控场景 value 不传,用 _mirror 做 hasValue 判断
-  const [_mirror, setMirror] = useState('');
-  // [M-9] filled 在受控 value 和内部镜像 state 之间取 hasValue,
-  // 保证非受控场景 filled 视觉态能正确响应用户输入,且受控用法行为不变
-  const filled = value != null ? String(value).length > 0 : _mirror.length > 0;
-  const isEditable = disabled ? false : editable;
-  // [L-31] editable=false(非 disabled)时也应进入 disabled a11y state
-  const isDisabledA11y = disabled || editable === false;
-
-  // 视觉态优先级:error > focused > filled > idle。
-  // active 三态(focus/filled/error)共享 wrapActive 白底,各自只覆 borderColor 差量。
+  const nativeRef = React.useRef(null);
+  const scope = multiline ? 'Textarea' : 'Input';
+  const controller = useTextFieldValue({
+    value,
+    defaultValue,
+    onChangeText: typeof onChangeText === 'function' ? onChangeText : undefined
+  }, scope);
+  const normalizedInputHeight = normalizeInputHeight(height === undefined ? fixed.hitTarget : height);
+  const normalizedTextareaHeights = normalizeTextareaHeights(minHeight, maxHeight);
+  const sanitizedContainer = sanitizeTextFieldContainerStyle(containerStyle);
+  const effectiveEditable = disabled !== true && editable !== false;
+  const mergedAccessibilityState = {
+    ...accessibilityState,
+    disabled: !effectiveEditable
+  };
+  const normalizedHeight = multiline ? normalizedTextareaHeights.minHeight : normalizedInputHeight.value;
+  const filled = controller.value.length > 0;
+  const diagnostics = [...normalizedInputHeight.diagnostics, ...normalizedTextareaHeights.diagnostics, ...sanitizedContainer.diagnostics];
+  const diagnosticKey = diagnostics.join(',');
+  useEffect(() => {
+    if (diagnosticKey.length > 0) {
+      log.warn(`${scope}: 非法布局值(${diagnosticKey})已回退。`);
+    }
+  }, [diagnosticKey, scope]);
+  useEffect(() => {
+    if (removedNativeAliasKey.length > 0) {
+      log.warn(`${scope}: 已忽略受管原生 props(${removedNativeAliasKey})。`);
+    }
+  }, [removedNativeAliasKey, scope]);
+  useErrorAnnouncement(error);
+  useImperativeHandle(forwardedRef, () => ({
+    focus: () => nativeRef.current?.focus(),
+    blur: () => nativeRef.current?.blur()
+  }), []);
   const wrapStateStyles = error ? [styles.wrapActive, styles.wrapError] : focused ? [styles.wrapActive, styles.wrapFocus] : filled ? [styles.wrapActive, styles.wrapFilled] : [styles.wrapIdle];
+  const interactiveHeight = searchLayout?.interactiveHeight ?? normalizedHeight;
   return /*#__PURE__*/_jsxs(View, {
-    style: [containerStyle, disabled && styles.containerDisabled],
+    style: [sanitizedContainer.style, !effectiveEditable && styles.containerDisabled, searchLayout !== undefined && !multiline && styles.rootCentered, {
+      minWidth: fixed.hitTarget,
+      minHeight: normalizedHeight
+    }],
     testID: testID,
     children: [/*#__PURE__*/_jsxs(View, {
-      style: [styles.wrap, multiline && styles.wrapMultiline, ...wrapStateStyles, multiline ? {
-        minHeight,
-        ...(maxHeight != null && {
-          maxHeight
+      style: [styles.wrap, multiline && styles.wrapMultiline, searchLayout === undefined && wrapStateStyles, searchLayout !== undefined && styles.searchInteractiveRow, multiline ? {
+        minHeight: normalizedHeight,
+        ...(normalizedTextareaHeights.maxHeight !== undefined && {
+          maxHeight: normalizedTextareaHeights.maxHeight
         })
       } : {
-        height
+        height: interactiveHeight
       }],
-      children: [leading != null ? /*#__PURE__*/_jsx(View, {
-        children: leading
-      }) : null, /*#__PURE__*/_jsx(TextInput, {
-        ref: ref,
-        ...rest,
-        editable: isEditable,
-        value: value,
-        onChangeText: text => {
-          // [M-9] 同步内部镜像,非受控场景 filled 视觉态依赖此 state
-          setMirror(text);
-          onChangeText?.(text);
-        },
+      children: [searchLayout ? /*#__PURE__*/_jsx(View, {
+        pointerEvents: "none",
+        style: [styles.searchVisibleSurface, ...wrapStateStyles, {
+          top: searchLayout.verticalInset,
+          bottom: searchLayout.verticalInset
+        }]
+      }) : null, /*#__PURE__*/_jsx(TextFieldSlot, {
+        slot: leading,
+        effectiveEditable: effectiveEditable,
+        testID: childTestID(testID, 'leading')
+      }), /*#__PURE__*/_jsx(TextInput, {
+        ref: nativeRef,
+        ...allowedNativeProps,
+        value: controller.value,
+        onChangeText: controller.onChangeText,
+        editable: effectiveEditable,
         multiline: multiline,
-        onFocus: e => {
+        onFocus: event => {
           setFocused(true);
-          onFocus?.(e);
+          onFocus?.(event);
         },
-        onBlur: e => {
+        onBlur: event => {
           setFocused(false);
-          onBlur?.(e);
+          onBlur?.(event);
         },
-        style: [styles.input, multiline && styles.inputMultiline,
-        // multiline:wrap 上下 padding 为 space[4]*2=20,input 内部 minHeight 减掉避免溢出
-        multiline && {
-          minHeight: Math.max(0, minHeight - space[4] * 2)
+        style: [styles.input, multiline && styles.inputMultiline, multiline && {
+          minHeight: Math.max(0, normalizedHeight - space[4] * 2)
+        }, searchLayout !== undefined && {
+          minHeight: searchLayout.interactiveHeight
         }],
-        placeholderTextColor: c.foregroundSubtle
-        // [L-31] editable=false 并入 disabled a11y state,SR 能正确播报不可编辑
-        ,
-        accessibilityState: isDisabledA11y ? {
-          disabled: true
-        } : undefined,
+        placeholderTextColor: callerPlaceholder ?? colors.foregroundSubtle,
+        accessibilityRole: accessibilityRole,
+        accessibilityState: mergedAccessibilityState,
         testID: childTestID(testID, 'input')
-      }), trailing != null ? /*#__PURE__*/_jsx(View, {
-        children: trailing
-      }) : null]
+      }), /*#__PURE__*/_jsx(TextFieldSlot, {
+        slot: trailing,
+        effectiveEditable: effectiveEditable,
+        testID: childTestID(testID, 'trailing')
+      })]
     }), error ? /*#__PURE__*/_jsx(Text, {
       style: styles.errorMsg,
-      accessibilityLiveRegion: "polite",
+      accessibilityLiveRegion: Platform.OS === 'android' ? 'polite' : undefined,
       testID: childTestID(testID, 'error'),
       children: error
     }) : null]

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

@@ -1 +1 @@
-{"version":3,"names":["React","forwardRef","useState","Text","TextInput","View","control","r","space","useColors","useThemedStyles","childTestID","makeStyles","jsx","_jsx","jsxs","_jsxs","TextFieldBase","multiline","height","lg","minHeight","maxHeight","leading","trailing","error","disabled","editable","containerStyle","value","onFocus","onBlur","onChangeText","testID","rest","ref","c","styles","focused","setFocused","_mirror","setMirror","filled","String","length","isEditable","isDisabledA11y","wrapStateStyles","wrapActive","wrapError","wrapFocus","wrapFilled","wrapIdle","style","containerDisabled","children","wrap","wrapMultiline","text","e","input","inputMultiline","Math","max","placeholderTextColor","foregroundSubtle","accessibilityState","undefined","errorMsg","accessibilityLiveRegion","displayName"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/TextFieldBase.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","forwardRef","useEffect","useImperativeHandle","useState","Platform","Text","TextInput","View","fixed","space","useColors","useThemedStyles","childTestID","createLogger","normalizeInputHeight","normalizeTextareaHeights","sanitizeTextFieldContainerStyle","makeStyles","TextFieldSlot","useErrorAnnouncement","useTextFieldValue","jsx","_jsx","jsxs","_jsxs","log","TextFieldBase","props","forwardedRef","multiline","height","minHeight","maxHeight","searchLayout","leading","trailing","error","disabled","editable","containerStyle","value","defaultValue","onChangeText","accessibilityState","accessibilityRole","placeholderTextColor","callerPlaceholder","onFocus","onBlur","testID","style","_style","numberOfLines","_numberOfLines","_ariaDisabled","readOnly","_readOnly","role","_role","enterKeyHint","_enterKeyHint","clearTextOnFocus","_clearTextOnFocus","allowedNativeProps","removedNativeAliasKey","Object","entries","filter","entry","undefined","map","name","join","colors","styles","focused","setFocused","nativeRef","useRef","scope","controller","normalizedInputHeight","hitTarget","normalizedTextareaHeights","sanitizedContainer","effectiveEditable","mergedAccessibilityState","normalizedHeight","filled","length","diagnostics","diagnosticKey","warn","focus","current","blur","wrapStateStyles","wrapActive","wrapError","wrapFocus","wrapFilled","wrapIdle","interactiveHeight","containerDisabled","rootCentered","minWidth","children","wrap","wrapMultiline","searchInteractiveRow","pointerEvents","searchVisibleSurface","top","verticalInset","bottom","slot","ref","event","input","inputMultiline","Math","max","foregroundSubtle","errorMsg","accessibilityLiveRegion","OS","displayName"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/TextFieldBase.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,82 @@
+"use strict";
+
+import { useEffect } from 'react';
+import { Text, View } from 'react-native';
+import { Pressable } from 'react-native-gesture-handler';
+import { useColors, useThemedStyles } from "../../../theme/index.js";
+import { createLogger } from "../../../utils/logger/index.js";
+import { A11Y_HIDDEN_PROPS } from "../shared/a11y.js";
+import { Icon } from "../Icon/index.js";
+import { normalizeSlotIconSize, normalizeTextFieldSlot } from "./normalize.js";
+import { makeStyles } from "./styles.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const log = createLogger('TextFieldSlot');
+/**
+ * 受控 slot renderer。展示内容与真实操作在这里分叉,避免未知 ReactNode 绕过
+ * 44pt action frame 或可访问名称约束。
+ */
+export function TextFieldSlot({
+  slot,
+  effectiveEditable,
+  testID
+}) {
+  const colors = useColors();
+  const styles = useThemedStyles(makeStyles);
+  const normalizedSlot = normalizeTextFieldSlot(slot);
+  const safeSlot = normalizedSlot.slot;
+  const iconSize = safeSlot?.kind === 'icon' ? normalizeSlotIconSize(safeSlot.size) : undefined;
+  const iconDiagnosticKey = iconSize?.diagnostics.join(',') ?? '';
+  const slotDiagnosticKey = normalizedSlot.diagnostics.join(',');
+  useEffect(() => {
+    if (iconDiagnosticKey.length > 0) {
+      log.warn('slot.icon.size 非法，已回退为 18。');
+    }
+  }, [iconDiagnosticKey]);
+  useEffect(() => {
+    if (slotDiagnosticKey.length > 0) {
+      log.warn(`非法 TextField slot(${slotDiagnosticKey})已移除。`);
+    }
+  }, [slotDiagnosticKey]);
+  if (!safeSlot) return null;
+  switch (safeSlot.kind) {
+    case 'icon':
+      return /*#__PURE__*/_jsx(View, {
+        ...A11Y_HIDDEN_PROPS,
+        style: styles.slotDisplay,
+        testID: testID,
+        children: /*#__PURE__*/_jsx(Icon, {
+          name: safeSlot.icon,
+          size: iconSize?.value ?? 18,
+          color: safeSlot.color ?? colors.foregroundMuted
+        })
+      });
+    case 'text':
+      return /*#__PURE__*/_jsx(Text, {
+        ...A11Y_HIDDEN_PROPS,
+        style: [styles.slotDisplay, styles.slotText],
+        testID: testID,
+        children: safeSlot.value
+      });
+    case 'action':
+      {
+        const disabled = !effectiveEditable || safeSlot.disabled === true;
+        return /*#__PURE__*/_jsx(Pressable, {
+          onPress: disabled ? undefined : safeSlot.onPress,
+          disabled: disabled,
+          accessibilityRole: "button",
+          accessibilityLabel: safeSlot.accessibilityLabel,
+          accessibilityState: {
+            disabled
+          },
+          style: styles.actionFrame,
+          testID: testID,
+          children: /*#__PURE__*/_jsx(Icon, {
+            name: safeSlot.icon,
+            size: 18,
+            color: colors.foregroundMuted
+          })
+        });
+      }
+  }
+}
+//# sourceMappingURL=TextFieldSlot.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["useEffect","Text","View","Pressable","useColors","useThemedStyles","createLogger","A11Y_HIDDEN_PROPS","Icon","normalizeSlotIconSize","normalizeTextFieldSlot","makeStyles","jsx","_jsx","log","TextFieldSlot","slot","effectiveEditable","testID","colors","styles","normalizedSlot","safeSlot","iconSize","kind","size","undefined","iconDiagnosticKey","diagnostics","join","slotDiagnosticKey","length","warn","style","slotDisplay","children","name","icon","value","color","foregroundMuted","slotText","disabled","onPress","accessibilityRole","accessibilityLabel","accessibilityState","actionFrame"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/TextFieldSlot.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -0,0 +1,238 @@
+"use strict";
+
+import { StyleSheet } from 'react-native';
+import { fixed } from "../../../theme/index.js";
+import { ICONS } from "../../../icons/index.js";
+import { normalizeNonBlankText } from "../shared/accessibilityName.js";
+/**
+ * TextField 家族的**纯布局归一化** —— 无 React 依赖,可直接单测。
+ *
+ * 纪律与 Pulse 一致:非法值**整体回退默认值并记诊断**,不做 clamp、不做取整。
+ * 悄悄把 `height: 20` 夹成 44 会让调用方永远发现不了自己传了一个碰不到的输入框。
+ */
+
+/** slot 图标的默认与合法上界。18 是 body 字号下视觉平衡的取值;>32 会撑破 44pt frame。 */
+const DEFAULT_SLOT_ICON_SIZE = 18;
+const MAX_SLOT_ICON_SIZE = 32;
+/** Textarea 默认最小高度(约 5 行)。 */
+const DEFAULT_TEXTAREA_MIN_HEIGHT = 96;
+const DEFAULT_SEARCH_VISIBLE_HEIGHT = 36;
+
+/** 这六个字段会破坏 TextField 自持的最小命中框,一律从 containerStyle 剥离。 */
+const RESERVED_CONTAINER_KEYS = ['height', 'minHeight', 'maxHeight', 'minWidth', 'maxWidth', 'overflow'];
+const isFiniteAtLeast = (value, min) => typeof value === 'number' && Number.isFinite(value) && value >= min;
+const isFiniteWithin = (value, min, max) => typeof value === 'number' && Number.isFinite(value) && value >= min && value <= max;
+/** 单行高度 —— 不得低于 `fixed.hitTarget`(44pt),否则整行都碰不满一个手指。 */
+export function normalizeInputHeight(value) {
+  return isFiniteAtLeast(value, fixed.hitTarget) ? {
+    value,
+    diagnostics: []
+  } : {
+    value: fixed.hitTarget,
+    diagnostics: ['height']
+  };
+}
+/** 多行高度 —— `maxHeight` 只有在有限且不小于归一化后的 `minHeight` 时才保留。 */
+export function normalizeTextareaHeights(minHeight, maxHeight) {
+  const diagnostics = [];
+  let safeMin;
+  if (minHeight === undefined) {
+    safeMin = DEFAULT_TEXTAREA_MIN_HEIGHT;
+  } else if (isFiniteAtLeast(minHeight, fixed.hitTarget)) {
+    safeMin = minHeight;
+  } else {
+    safeMin = DEFAULT_TEXTAREA_MIN_HEIGHT;
+    diagnostics.push('minHeight');
+  }
+  if (maxHeight === undefined) {
+    return {
+      minHeight: safeMin,
+      maxHeight: undefined,
+      diagnostics
+    };
+  }
+  // 注意用**归一化后**的 min 比较:min 被回退时 max 必须跟着重新判定,
+  // 否则会留下一个比实际 min 还小的 max,直接把内容压没。
+  if (isFiniteAtLeast(maxHeight, safeMin)) {
+    return {
+      minHeight: safeMin,
+      maxHeight,
+      diagnostics
+    };
+  }
+  diagnostics.push('maxHeight');
+  return {
+    minHeight: safeMin,
+    maxHeight: undefined,
+    diagnostics
+  };
+}
+
+/** slot 图标尺寸 —— 只接受有限的 `[1, 32]`。 */
+export function normalizeSlotIconSize(value) {
+  return isFiniteWithin(value, 1, MAX_SLOT_ICON_SIZE) ? {
+    value,
+    diagnostics: []
+  } : {
+    value: DEFAULT_SLOT_ICON_SIZE,
+    diagnostics: ['slot.size']
+  };
+}
+function isIconName(value) {
+  return typeof value === 'string' && Object.prototype.hasOwnProperty.call(ICONS, value);
+}
+
+/** 未类型化 JS 必须完整匹配一个受支持分支，不能靠 discriminant 后 cast 绕过校验。 */
+export function normalizeTextFieldSlot(slot) {
+  if (slot === undefined) {
+    return {
+      slot: undefined,
+      diagnostics: []
+    };
+  }
+  if (typeof slot !== 'object' || slot === null) {
+    return {
+      slot: undefined,
+      diagnostics: ['slot']
+    };
+  }
+  const candidate = slot;
+  switch (candidate.kind) {
+    case 'icon':
+      {
+        const size = typeof candidate.size === 'number' && Number.isFinite(candidate.size) ? candidate.size : undefined;
+        const color = typeof candidate.color === 'string' ? candidate.color : undefined;
+        const hasValidSize = candidate.size === undefined || size !== undefined;
+        const hasValidColor = candidate.color === undefined || color !== undefined;
+        if (!isIconName(candidate.icon) || !hasValidSize || !hasValidColor) {
+          return {
+            slot: undefined,
+            diagnostics: ['slot.icon']
+          };
+        }
+        return {
+          slot: {
+            kind: 'icon',
+            icon: candidate.icon,
+            ...(size !== undefined && {
+              size
+            }),
+            ...(color !== undefined && {
+              color
+            })
+          },
+          diagnostics: []
+        };
+      }
+    case 'text':
+      if (typeof candidate.value !== 'string' && typeof candidate.value !== 'number') {
+        return {
+          slot: undefined,
+          diagnostics: ['slot.text']
+        };
+      }
+      return {
+        slot: {
+          kind: 'text',
+          value: candidate.value
+        },
+        diagnostics: []
+      };
+    case 'action':
+      {
+        const accessibilityLabel = normalizeNonBlankText(candidate.accessibilityLabel);
+        const hasValidDisabled = candidate.disabled === undefined || typeof candidate.disabled === 'boolean';
+        const slotDisabled = typeof candidate.disabled === 'boolean' ? candidate.disabled : undefined;
+        if (!isIconName(candidate.icon) || typeof candidate.onPress !== 'function' || accessibilityLabel === undefined || !hasValidDisabled) {
+          return {
+            slot: undefined,
+            diagnostics: ['slot.action']
+          };
+        }
+        return {
+          slot: {
+            kind: 'action',
+            icon: candidate.icon,
+            onPress: candidate.onPress,
+            accessibilityLabel,
+            ...(slotDisabled !== undefined && {
+              disabled: slotDisabled
+            })
+          },
+          diagnostics: []
+        };
+      }
+    default:
+      return {
+        slot: undefined,
+        diagnostics: ['slot.kind']
+      };
+  }
+}
+/** 搜索框的可见面可为 36pt,但承载输入/操作的实际行永远不得小于 44pt。 */
+export function normalizeSearchLayout(interactiveHeight, visibleHeight) {
+  const diagnostics = [];
+  const safeInteractive = isFiniteAtLeast(interactiveHeight, fixed.hitTarget) ? interactiveHeight : fixed.hitTarget;
+  if (safeInteractive !== interactiveHeight) {
+    diagnostics.push('interactiveHeight');
+  }
+  const safeVisible = typeof visibleHeight === 'number' && Number.isFinite(visibleHeight) && visibleHeight > 0 && visibleHeight <= safeInteractive ? visibleHeight : DEFAULT_SEARCH_VISIBLE_HEIGHT;
+  if (safeVisible !== visibleHeight) {
+    diagnostics.push('visibleHeight');
+  }
+  return {
+    interactiveHeight: safeInteractive,
+    visibleHeight: safeVisible,
+    verticalInset: (safeInteractive - safeVisible) / 2,
+    diagnostics
+  };
+}
+/**
+ * 公开 Input / Textarea 不允许未类型化 JS 覆盖内部 layout 开关。
+ *
+ * 返回新对象而不是 delete 原 props，既不改变调用方对象，也让 wrapper 能在安全 spread
+ * 后由可信边界写入自己的 `multiline`。
+ */
+export function sanitizeTextFieldWrapperProps(props) {
+  const {
+    multiline,
+    searchLayout,
+    ...safeProps
+  } = props;
+  const diagnostics = [];
+  if (multiline !== undefined) {
+    diagnostics.push('multiline');
+  }
+  if (searchLayout !== undefined) {
+    diagnostics.push('searchLayout');
+  }
+  return {
+    props: safeProps,
+    diagnostics
+  };
+}
+
+/**
+ * 剥掉 containerStyle 里会覆盖最小 frame 的六个字段。
+ *
+ * 先 `StyleSheet.flatten` 再解构到新对象 —— 绝不原地修改调用方对象或已注册的
+ * StyleSheet 条目(那会污染同一 sheet 的其他使用者)。
+ */
+export function sanitizeTextFieldContainerStyle(style) {
+  const flattened = StyleSheet.flatten(style) ?? {};
+  const reserved = RESERVED_CONTAINER_KEYS;
+  const sanitized = {};
+  const diagnostics = [];
+  for (const [key, entry] of Object.entries(flattened)) {
+    if (reserved.includes(key)) {
+      diagnostics.push(key);
+      continue;
+    }
+    sanitized[key] = entry;
+  }
+  return {
+    style: sanitized,
+    diagnostics
+  };
+}
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"names":["StyleSheet","fixed","ICONS","normalizeNonBlankText","DEFAULT_SLOT_ICON_SIZE","MAX_SLOT_ICON_SIZE","DEFAULT_TEXTAREA_MIN_HEIGHT","DEFAULT_SEARCH_VISIBLE_HEIGHT","RESERVED_CONTAINER_KEYS","isFiniteAtLeast","value","min","Number","isFinite","isFiniteWithin","max","normalizeInputHeight","hitTarget","diagnostics","normalizeTextareaHeights","minHeight","maxHeight","safeMin","undefined","push","normalizeSlotIconSize","isIconName","Object","prototype","hasOwnProperty","call","normalizeTextFieldSlot","slot","candidate","kind","size","color","hasValidSize","hasValidColor","icon","accessibilityLabel","hasValidDisabled","disabled","slotDisabled","onPress","normalizeSearchLayout","interactiveHeight","visibleHeight","safeInteractive","safeVisible","verticalInset","sanitizeTextFieldWrapperProps","props","multiline","searchLayout","safeProps","sanitizeTextFieldContainerStyle","style","flattened","flatten","reserved","sanitized","key","entry","entries","includes"],"sourceRoot":"../../../../../src","sources":["components/ui/TextField/normalize.ts"],"mappings":"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","ignoreList":[]}