@unif/react-native-design 0.20.0 → 0.21.0

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

@@ -1,32 +1,31 @@
 "use strict";
 
-import React from 'react';
+import React, { useEffect, useRef } from 'react';
 import { Text, View } from 'react-native';
 import { useColors, useThemedStyles } from "../../../theme/index.js";
+import { createLogger } from "../../../utils/logger/index.js";
 import { IconButton } from "../IconButton/index.js";
-import { isSlot } from "./isSlot.js";
+import { classifyNavBarSlot } from "./isSlot.js";
 import { makeStyles } from "./styles.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-/** NavBarSlotConfig → IconButton(variant='ghost' + 外部 tint)。 */
+const log = createLogger('NavBar');
+
+/** NavBarAction → IconButton(variant='ghost' + 外部 tint)。 */
 function renderSlot(slot, tint) {
-  // [L-50] 缺 accessibilityLabel 时 dev 告警 —— 回退读英文 icon 名(如 "menu")体验不佳。
-  if (!slot.accessibilityLabel && typeof __DEV__ !== 'undefined' && __DEV__) {
-    console.warn(`NavBar slot(icon="${slot.icon}")未传 accessibilityLabel,SR 将读出 icon 名,请传人类可读短语。`);
-  }
   return /*#__PURE__*/_jsx(IconButton, {
     icon: slot.icon,
     onPress: slot.onPress,
     variant: "ghost",
     color: tint,
-    accessibilityLabel: slot.accessibilityLabel ?? slot.icon
+    accessibilityLabel: slot.accessibilityLabel
   });
 }
 
-/** left / right slot:NavBarSlotConfig → IconButton,ReactNode → 原样。 */
+/** left / right slot:NavBarAction → IconButton,已归一化 display node → 原样。 */
 function resolveSlot(slot, tint) {
-  if (!slot) return null;
-  if (isSlot(slot)) return renderSlot(slot, tint);
-  return slot;
+  if (slot.kind === 'action') return renderSlot(slot.action, tint);
+  if (slot.kind === 'node') return slot.node;
+  return null;
 }
 
 /**
@@ -49,6 +48,16 @@ export function NavBar({
   const styles = useThemedStyles(makeStyles);
   const isBrand = variant === 'brand';
   const isTransparent = variant === 'transparent';
+  const leftSlot = classifyNavBarSlot(left);
+  const rightSlot = classifyNavBarSlot(right);
+  const warnedInvalidSlot = useRef(false);
+  const hasInvalidSlot = leftSlot.kind === 'invalid' || rightSlot.kind === 'invalid';
+  useEffect(() => {
+    if (hasInvalidSlot && !warnedInvalidSlot.current) {
+      warnedInvalidSlot.current = true;
+      log.warn('忽略无效的 NavBar action；请传 NavBarAction 或 ReactNode');
+    }
+  }, [hasInvalidSlot]);
   // brand 实底白字;default + transparent 都走深字(transparent 用在浅色
   // hero 渐变之上,白字看不清)。后续若有"相机 / 地图"等深色浮层场景需要
   // 白字 transparent navbar,再加 'transparentLight' variant。
@@ -59,7 +68,7 @@ export function NavBar({
     testID: testID,
     children: [/*#__PURE__*/_jsx(View, {
       style: styles.side,
-      children: resolveSlot(left, tint)
+      children: resolveSlot(leftSlot, tint)
     }), /*#__PURE__*/_jsxs(View, {
       style: styles.center,
       children: [/*#__PURE__*/_jsx(Text, {
@@ -77,7 +86,7 @@ export function NavBar({
       }) : null]
     }), /*#__PURE__*/_jsx(View, {
       style: [styles.side, styles.sideRight],
-      children: resolveSlot(right, tint)
+      children: resolveSlot(rightSlot, tint)
     })]
   });
 }

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

@@ -1 +1 @@
-{"version":3,"names":["React","Text","View","useColors","useThemedStyles","IconButton","isSlot","makeStyles","jsx","_jsx","jsxs","_jsxs","renderSlot","slot","tint","accessibilityLabel","__DEV__","console","warn","icon","onPress","variant","color","resolveSlot","NavBar","title","subtitle","left","right","style","testID","c","styles","isBrand","isTransparent","onPrimary","foreground","subtint","onPrimaryMuted","foregroundSubtle","bar","barBrand","barTransparent","children","side","center","numberOfLines","sideRight"],"sourceRoot":"../../../../../src","sources":["components/ui/NavBar/NavBar.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["React","useEffect","useRef","Text","View","useColors","useThemedStyles","createLogger","IconButton","classifyNavBarSlot","makeStyles","jsx","_jsx","jsxs","_jsxs","log","renderSlot","slot","tint","icon","onPress","variant","color","accessibilityLabel","resolveSlot","kind","action","node","NavBar","title","subtitle","left","right","style","testID","c","styles","isBrand","isTransparent","leftSlot","rightSlot","warnedInvalidSlot","hasInvalidSlot","current","warn","onPrimary","foreground","subtint","onPrimaryMuted","foregroundSubtle","bar","barBrand","barTransparent","children","side","center","numberOfLines","sideRight"],"sourceRoot":"../../../../../src","sources":["components/ui/NavBar/NavBar.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAIC,SAAS,EAAEC,MAAM,QAAQ,OAAO;AAChD,SAASC,IAAI,EAAEC,IAAI,QAAQ,cAAc;AACzC,SAASC,SAAS,EAAEC,eAAe,QAAQ,yBAAgB;AAC3D,SAASC,YAAY,QAAQ,gCAAuB;AACpD,SAASC,UAAU,QAAQ,wBAAe;AAC1C,SAASC,kBAAkB,QAAuC,aAAU;AAC5E,SAASC,UAAU,QAAQ,aAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA,EAAAC,IAAA,IAAAC,KAAA;AAGtC,MAAMC,GAAG,GAAGR,YAAY,CAAC,QAAQ,CAAC;;AAElC;AACA,SAASS,UAAUA,CAACC,IAAkB,EAAEC,IAAY,EAAE;EACpD,oBACEN,IAAA,CAACJ,UAAU;IACTW,IAAI,EAAEF,IAAI,CAACE,IAAK;IAChBC,OAAO,EAAEH,IAAI,CAACG,OAAQ;IACtBC,OAAO,EAAC,OAAO;IACfC,KAAK,EAAEJ,IAAK;IACZK,kBAAkB,EAAEN,IAAI,CAACM;EAAmB,CAC7C,CAAC;AAEN;;AAEA;AACA,SAASC,WAAWA,CAClBP,IAA8B,EAC9BC,IAAY,EACK;EACjB,IAAID,IAAI,CAACQ,IAAI,KAAK,QAAQ,EAAE,OAAOT,UAAU,CAACC,IAAI,CAACS,MAAM,EAAER,IAAI,CAAC;EAChE,IAAID,IAAI,CAACQ,IAAI,KAAK,MAAM,EAAE,OAAOR,IAAI,CAACU,IAAI;EAC1C,OAAO,IAAI;AACb;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CAAC;EACrBC,KAAK;EACLC,QAAQ;EACRC,IAAI;EACJC,KAAK;EACLX,OAAO,GAAG,SAAS;EACnBY,KAAK;EACLC;AACW,CAAC,EAAE;EACd,MAAMC,CAAC,GAAG9B,SAAS,CAAC,CAAC;EACrB,MAAM+B,MAAM,GAAG9B,eAAe,CAACI,UAAU,CAAC;EAC1C,MAAM2B,OAAO,GAAGhB,OAAO,KAAK,OAAO;EACnC,MAAMiB,aAAa,GAAGjB,OAAO,KAAK,aAAa;EAC/C,MAAMkB,QAAQ,GAAG9B,kBAAkB,CAACsB,IAAI,CAAC;EACzC,MAAMS,SAAS,GAAG/B,kBAAkB,CAACuB,KAAK,CAAC;EAC3C,MAAMS,iBAAiB,GAAGvC,MAAM,CAAC,KAAK,CAAC;EACvC,MAAMwC,cAAc,GAClBH,QAAQ,CAACd,IAAI,KAAK,SAAS,IAAIe,SAAS,CAACf,IAAI,KAAK,SAAS;EAC7DxB,SAAS,CAAC,MAAM;IACd,IAAIyC,cAAc,IAAI,CAACD,iBAAiB,CAACE,OAAO,EAAE;MAChDF,iBAAiB,CAACE,OAAO,GAAG,IAAI;MAChC5B,GAAG,CAAC6B,IAAI,CAAC,iDAAiD,CAAC;IAC7D;EACF,CAAC,EAAE,CAACF,cAAc,CAAC,CAAC;EACpB;EACA;EACA;EACA,MAAMxB,IAAI,GAAGmB,OAAO,GAAGF,CAAC,CAACU,SAAS,GAAGV,CAAC,CAACW,UAAU;EACjD,MAAMC,OAAO,GAAGV,OAAO,GAAGF,CAAC,CAACa,cAAc,GAAGb,CAAC,CAACc,gBAAgB;EAC/D,oBACEnC,KAAA,CAACV,IAAI;IACH6B,KAAK,EAAE,CACLG,MAAM,CAACc,GAAG,EACVb,OAAO,IAAID,MAAM,CAACe,QAAQ,EAC1Bb,aAAa,IAAIF,MAAM,CAACgB,cAAc,EACtCnB,KAAK,CACL;IACFC,MAAM,EAAEA,MAAO;IAAAmB,QAAA,gBAEfzC,IAAA,CAACR,IAAI;MAAC6B,KAAK,EAAEG,MAAM,CAACkB,IAAK;MAAAD,QAAA,EAAE7B,WAAW,CAACe,QAAQ,EAAErB,IAAI;IAAC,CAAO,CAAC,eAC9DJ,KAAA,CAACV,IAAI;MAAC6B,KAAK,EAAEG,MAAM,CAACmB,MAAO;MAAAF,QAAA,gBACzBzC,IAAA,CAACT,IAAI;QAAC8B,KAAK,EAAE,CAACG,MAAM,CAACP,KAAK,EAAE;UAAEP,KAAK,EAAEJ;QAAK,CAAC,CAAE;QAACsC,aAAa,EAAE,CAAE;QAAAH,QAAA,EAC5DxB;MAAK,CACF,CAAC,EACNC,QAAQ,gBACPlB,IAAA,CAACT,IAAI;QAAC8B,KAAK,EAAE,CAACG,MAAM,CAACN,QAAQ,EAAE;UAAER,KAAK,EAAEyB;QAAQ,CAAC,CAAE;QAACS,aAAa,EAAE,CAAE;QAAAH,QAAA,EAClEvB;MAAQ,CACL,CAAC,GACL,IAAI;IAAA,CACJ,CAAC,eACPlB,IAAA,CAACR,IAAI;MAAC6B,KAAK,EAAE,CAACG,MAAM,CAACkB,IAAI,EAAElB,MAAM,CAACqB,SAAS,CAAE;MAAAJ,QAAA,EAC1C7B,WAAW,CAACgB,SAAS,EAAEtB,IAAI;IAAC,CACzB,CAAC;EAAA,CACH,CAAC;AAEX","ignoreList":[]}

package/lib/module/components/ui/NavBar/isSlot.js

@@ -1,10 +1,303 @@
 "use strict";
 
+import React from 'react';
+import { Text } from 'react-native';
+import { ICONS } from "../../../icons/index.js";
+const mappedThenables = new WeakMap();
+function isIconName(value) {
+  return typeof value === 'string' && Object.prototype.hasOwnProperty.call(ICONS, value);
+}
+
+/**
+ * Type guard：action 的 icon 必须真实存在于生成的 registry，且有 handler 与非空名称。
+ */
+export function isNavBarAction(v) {
+  if (typeof v !== 'object' || v === null) return false;
+  const slot = v;
+  return isIconName(slot.icon) && typeof slot.onPress === 'function' && typeof slot.accessibilityLabel === 'string' && slot.accessibilityLabel.trim().length > 0;
+}
+function hasElementShape(value) {
+  const element = value;
+  return Object.prototype.hasOwnProperty.call(value, 'type') && Object.prototype.hasOwnProperty.call(value, 'props') && element.type !== null && element.type !== undefined && typeof element.props === 'object' && element.props !== null;
+}
+function isThenable(value) {
+  if (typeof value !== 'object' || value === null) {
+    return false;
+  }
+  try {
+    return typeof value.then === 'function';
+  } catch {
+    return false;
+  }
+}
+function normalizeFragment(value, activeIterables, path, owner) {
+  try {
+    const props = value.props;
+    const normalized = normalizeReactNode(props.children, activeIterables, `${path}.fragment`, owner);
+    if (normalized.kind === 'invalid') return normalized;
+    return {
+      kind: 'node',
+      node: /*#__PURE__*/React.cloneElement(value, undefined, normalized.node)
+    };
+  } catch {
+    return {
+      kind: 'invalid'
+    };
+  }
+}
+function recordReaches(from, target, visited = new Set()) {
+  if (from === target) return true;
+  if (visited.has(from)) return false;
+  visited.add(from);
+  for (const dependency of from.dependencies) {
+    if (recordReaches(dependency, target, visited)) return true;
+  }
+  return false;
+}
+function addThenableDependency(owner, dependency) {
+  // dependency 已能走回 owner 时再加边会闭环；不加边并让当前 resolution 失败关闭。
+  if (recordReaches(dependency, owner)) return false;
+  owner.dependencies.add(dependency);
+  return true;
+}
+function createThenableRecord(value, path) {
+  let resolveMapped = () => {};
+  let rejectMapped = () => {};
+  const mappedPromise = new Promise((resolve, reject) => {
+    resolveMapped = resolve;
+    rejectMapped = reject;
+  });
+  const mappedNode = mappedPromise;
+  const record = {
+    node: mappedNode,
+    dependencies: new Set()
+  };
+  // 先入 cache 再调用用户 then：同步 thenable 可复用同一 record，并由依赖图识别闭环。
+  mappedThenables.set(value, record);
+  let claimed = false;
+  const resolveOnce = resolved => {
+    if (claimed) return;
+    claimed = true;
+    if (resolved === value || resolved === mappedPromise) {
+      resolveMapped(null);
+      return;
+    }
+    try {
+      const normalized = normalizeReactNode(resolved, new WeakSet(), `${path}.then`, record);
+      resolveMapped(normalized.kind === 'invalid' ? null : normalized.node);
+    } catch {
+      resolveMapped(null);
+    }
+  };
+  const rejectOnce = reason => {
+    if (claimed) return;
+    claimed = true;
+    rejectMapped(reason);
+  };
+  try {
+    const then = value.then;
+    if (typeof then !== 'function') {
+      resolveOnce(null);
+      return record;
+    }
+    then.call(value, resolveOnce, rejectOnce);
+  } catch (error) {
+    rejectOnce(error);
+  }
+  return record;
+}
+function normalizeThenable(value, path, owner) {
+  const record = mappedThenables.get(value) ?? createThenableRecord(value, path);
+  if (owner !== undefined && !addThenableDependency(owner, record)) {
+    return {
+      kind: 'invalid'
+    };
+  }
+  return {
+    kind: 'node',
+    node: record.node
+  };
+}
+function getIteratorFactory(value) {
+  try {
+    const iterator = value[Symbol.iterator];
+    if (iterator === undefined || iterator === null) return {
+      kind: 'none'
+    };
+    if (typeof iterator !== 'function') return {
+      kind: 'none'
+    };
+    return {
+      kind: 'factory',
+      factory: iterator
+    };
+  } catch {
+    return {
+      kind: 'invalid'
+    };
+  }
+}
+function isReactPortal(value) {
+  const portal = value;
+  const hasPortalShape = Object.prototype.hasOwnProperty.call(value, 'key') && Object.prototype.hasOwnProperty.call(value, 'children') && Object.prototype.hasOwnProperty.call(value, 'containerInfo') && Object.prototype.hasOwnProperty.call(value, 'implementation') && (portal.key === null || typeof portal.key === 'string') && portal.containerInfo !== null && portal.containerInfo !== undefined;
+  if (!hasPortalShape) return false;
+  try {
+    // React 没有公开 portal guard；只调用公开 Children API，且该分支已排除 iterable/
+    // thenable，避免消费 generator 或改变 Promise 语义。
+    return React.Children.count(value) === 1;
+  } catch {
+    return false;
+  }
+}
+function normalizeArray(value, activeIterables, path, owner) {
+  if (activeIterables.has(value)) return {
+    kind: 'invalid'
+  };
+  activeIterables.add(value);
+  try {
+    const nodes = [];
+    for (let index = 0; index < value.length; index += 1) {
+      const normalized = normalizeReactNode(value[index], activeIterables, `${path}.${index}`, owner);
+      if (normalized.kind === 'invalid') return normalized;
+      nodes.push(normalized.node);
+    }
+    return {
+      kind: 'node',
+      node: nodes
+    };
+  } catch {
+    return {
+      kind: 'invalid'
+    };
+  } finally {
+    activeIterables.delete(value);
+  }
+}
+function normalizeIterable(value, factory, activeIterables, path, owner) {
+  if (activeIterables.has(value)) return {
+    kind: 'invalid'
+  };
+  activeIterables.add(value);
+  let iterator;
+  let completed = false;
+  try {
+    const candidate = factory.call(value);
+    if (typeof candidate !== 'object' || candidate === null) {
+      return {
+        kind: 'invalid'
+      };
+    }
+    iterator = candidate;
+    const next = iterator.next;
+    if (typeof next !== 'function') return {
+      kind: 'invalid'
+    };
+    const nodes = [];
+    let index = 0;
+    for (;;) {
+      const step = next.call(iterator);
+      if (typeof step !== 'object' || step === null) {
+        return {
+          kind: 'invalid'
+        };
+      }
+      const result = step;
+      // Iterator protocol 的 done 走 ToBoolean，而不是限制为 boolean primitive。
+      if (result.done) {
+        completed = true;
+        return {
+          kind: 'node',
+          node: nodes
+        };
+      }
+      const normalized = normalizeReactNode(result.value, activeIterables, `${path}.${index}`, owner);
+      if (normalized.kind === 'invalid') return normalized;
+      nodes.push(normalized.node);
+      index += 1;
+    }
+  } catch {
+    return {
+      kind: 'invalid'
+    };
+  } finally {
+    if (!completed && iterator !== undefined) {
+      try {
+        const close = iterator.return;
+        if (typeof close === 'function') close.call(iterator);
+      } catch {
+        // 分类已失败；关闭时的异常不能逃逸到 NavBar render。
+      }
+    }
+    activeIterables.delete(value);
+  }
+}
+function normalizeReactNode(value, activeIterables, path, owner) {
+  if (typeof value === 'string' || typeof value === 'number' || typeof value === 'bigint') {
+    return {
+      kind: 'node',
+      node: /*#__PURE__*/React.createElement(Text, {
+        key: path
+      }, String(value))
+    };
+  }
+  if (value === undefined || value === null || typeof value === 'boolean') {
+    return {
+      kind: 'node',
+      node: value
+    };
+  }
+  if (/*#__PURE__*/React.isValidElement(value)) {
+    if (!hasElementShape(value)) return {
+      kind: 'invalid'
+    };
+    return value.type === React.Fragment ? normalizeFragment(value, activeIterables, path, owner) : {
+      kind: 'node',
+      node: value
+    };
+  }
+  if (typeof value !== 'object' || value === null) {
+    return {
+      kind: 'invalid'
+    };
+  }
+  if (Array.isArray(value)) {
+    return normalizeArray(value, activeIterables, path, owner);
+  }
+  const iterator = getIteratorFactory(value);
+  if (iterator.kind === 'invalid') return iterator;
+  if (iterator.kind === 'factory') {
+    return normalizeIterable(value, iterator.factory, activeIterables, path, owner);
+  }
+  if (isThenable(value)) return normalizeThenable(value, path, owner);
+  if (typeof value !== 'object') return {
+    kind: 'invalid'
+  };
+  return isReactPortal(value) ? {
+    kind: 'node',
+    node: value
+  } : {
+    kind: 'invalid'
+  };
+}
+
 /**
- * Type guard：判断 left/right 是否为 NavBarSlotConfig 对象（含 icon 字段）。
- * 不是的话视为 ReactNode 自定义内容。
+ * 未类型化边界的单一分类器。React 的公开 API 无法证明 object 不可伪造；这里拒绝
+ * 结构不成立的 marker-only element 与普通 plain object，同时保留 React 19 声明的
+ * bigint、Iterable、portal、Promise/thenable 等合法 ReactNode。Fragment/Iterable
+ * 会递归验证 primitive 叶子；thenable 映射按源对象缓存，避免每次 render 制造新的
+ * suspend identity；resolution record 的依赖可达性同时拦截 direct/indirect cycle，
+ * 并把 cycle 或非法 resolved value 确定性失败关闭为 null。
  */
-export function isSlot(v) {
-  return typeof v === 'object' && v !== null && 'icon' in v;
+export function classifyNavBarSlot(value) {
+  if (value === undefined || value === null || typeof value === 'boolean') {
+    return {
+      kind: 'empty'
+    };
+  }
+  if (isNavBarAction(value)) return {
+    kind: 'action',
+    action: value
+  };
+  return normalizeReactNode(value, new WeakSet(), 'slot');
 }
 //# sourceMappingURL=isSlot.js.map

package/lib/module/components/ui/NavBar/isSlot.js.map

@@ -1 +1 @@
-{"version":3,"names":["isSlot","v"],"sourceRoot":"../../../../../src","sources":["components/ui/NavBar/isSlot.ts"],"mappings":";;AAEA;AACA;AACA;AACA;AACA,OAAO,SAASA,MAAMA,CAACC,CAAU,EAAyB;EACxD,OAAO,OAAOA,CAAC,KAAK,QAAQ,IAAIA,CAAC,KAAK,IAAI,IAAI,MAAM,IAAIA,CAAC;AAC3D","ignoreList":[]}
+{"version":3,"names":["React","Text","ICONS","mappedThenables","WeakMap","isIconName","value","Object","prototype","hasOwnProperty","call","isNavBarAction","v","slot","icon","onPress","accessibilityLabel","trim","length","hasElementShape","element","type","undefined","props","isThenable","then","normalizeFragment","activeIterables","path","owner","normalized","normalizeReactNode","children","kind","node","cloneElement","recordReaches","from","target","visited","Set","has","add","dependency","dependencies","addThenableDependency","createThenableRecord","resolveMapped","rejectMapped","mappedPromise","Promise","resolve","reject","mappedNode","record","set","claimed","resolveOnce","resolved","WeakSet","rejectOnce","reason","error","normalizeThenable","get","getIteratorFactory","iterator","Symbol","factory","isReactPortal","portal","hasPortalShape","key","containerInfo","Children","count","normalizeArray","nodes","index","push","delete","normalizeIterable","completed","candidate","next","step","result","done","close","return","createElement","String","isValidElement","Fragment","Array","isArray","classifyNavBarSlot","action"],"sourceRoot":"../../../../../src","sources":["components/ui/NavBar/isSlot.ts"],"mappings":"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","ignoreList":[]}

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

@@ -1,78 +1,73 @@
 "use strict";
 
-import React, { forwardRef, useState } from 'react';
-import { Pressable } from 'react-native-gesture-handler';
-import { Icon } from "../Icon/index.js";
+import React, { forwardRef, useEffect, useState } from 'react';
 import { Input } from "../Input/index.js";
-import { control, fixed, r, useColors } from "../../../theme/index.js";
-import { childTestID } from "../../../utils/testID/index.js";
-import { styles } from "./styles.js";
+import { createLogger } from "../../../utils/logger/index.js";
 import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * 密码 Input —— Input + leading lock + trailing eye 切换明文 / 密文。
- *
- * [L-32] 增强:
- * - forwardRef<TextInput> —— 业务表单 focus() 聚焦
- * - inputProps 类型改为 Omit<TextInputProps,'secureTextEntry'>
- * - 补 textContentType='password' / autoComplete='current-password' / autoCapitalize='none' 默认值
- * - 暴露 error / disabled 透传给底层 Input
- *
- * showPw 内部 useState,caller 只关心 value/onChangeText。
- * a11y:label 已表达"显示/隐藏密码"意图,不再加 accessibilityHint(避免 SR 朗读 over-hint)。
- */
-export const PasswordInput = /*#__PURE__*/forwardRef(function PasswordInput({
-  value,
-  onChangeText,
-  placeholder = '请输入密码',
-  testID,
-  error,
-  disabled,
-  inputProps
-}, ref) {
-  const c = useColors();
-  const [showPw, setShowPw] = useState(false);
+const log = createLogger('PasswordInput');
+
+/** 密码输入:只切换 secureTextEntry,不改变调用方持有的受控文本或焦点。 */
+export const PasswordInput = /*#__PURE__*/forwardRef(function PasswordInput(props, ref) {
+  const {
+    textContentType: rawTextContentType,
+    autoComplete: rawAutoComplete,
+    autoCapitalize: rawAutoCapitalize,
+    value: rawValue,
+    onChangeText: rawOnChangeText,
+    disabled: rawDisabled,
+    editable: rawEditable,
+    placeholder: rawPlaceholder,
+    defaultValue: _defaultValue,
+    inputProps: _inputProps,
+    secureTextEntry: _secureTextEntry,
+    leading: _leading,
+    trailing: _trailing,
+    ...rest
+  } = props;
+  const value = typeof rawValue === 'string' ? rawValue : '';
+  const onChangeText = typeof rawOnChangeText === 'function' ? rawOnChangeText : undefined;
+  const disabled = rawDisabled === true;
+  const editable = rawEditable === false ? false : undefined;
+  const placeholder = typeof rawPlaceholder === 'string' ? rawPlaceholder : '请输入密码';
+  const removedNativeAliasKey = Object.entries({
+    defaultValue: _defaultValue,
+    inputProps: _inputProps,
+    secureTextEntry: _secureTextEntry,
+    leading: _leading,
+    trailing: _trailing
+  }).filter(([, entry]) => entry !== undefined).map(([name]) => name).join(',');
+  useEffect(() => {
+    if (removedNativeAliasKey.length > 0) {
+      log.warn(`已忽略 PasswordInput 自管 props(${removedNativeAliasKey})。`);
+    }
+  }, [removedNativeAliasKey]);
+  const [showPassword, setShowPassword] = useState(false);
+  const effectiveEditable = disabled !== true && editable !== false;
+  const trailing = {
+    kind: 'action',
+    icon: showPassword ? 'eye' : 'eye-off',
+    onPress: () => setShowPassword(visible => !visible),
+    accessibilityLabel: showPassword ? '隐藏密码' : '显示密码',
+    disabled: !effectiveEditable
+  };
   return /*#__PURE__*/_jsx(Input, {
     ref: ref,
-    testID: testID,
+    ...rest,
     value: value,
     onChangeText: onChangeText,
+    disabled: disabled,
+    editable: editable,
     placeholder: placeholder,
-    error: error,
-    disabled: disabled
-    // [L-32] 补 textContentType / autoComplete / autoCapitalize 默认值 —— 提升密码自动填充体验
-    ,
-    textContentType: "password",
-    autoComplete: "current-password",
-    autoCapitalize: "none",
-    ...inputProps,
-    // secureTextEntry 在 inputProps spread 之后覆盖,确保组件自管不被 caller 干扰
-    secureTextEntry: !showPw,
-    leading: /*#__PURE__*/_jsx(Icon, {
-      name: "lock",
-      size: r(18),
-      color: c.iconFaint40
-    }),
-    trailing: /*#__PURE__*/_jsx(Pressable, {
-      testID: childTestID(testID, 'toggle'),
-      style: styles.eyeBtn,
-      onPress: () => setShowPw(v => !v),
-      accessibilityRole: "button",
-      accessibilityLabel: showPw ? '隐藏密码' : '显示密码'
-      // [M-7] eye icon r(16)≈16pt;Input 高 control.md≈36pt 限制垂直扩展
-      // vertical 走 (44-control.md)/2≈4;horizontal 走 (44-16)/2=14
-      ,
-      hitSlop: {
-        top: Math.round((fixed.hitTarget - control.md) / 2),
-        bottom: Math.round((fixed.hitTarget - control.md) / 2),
-        left: Math.round((fixed.hitTarget - r(16)) / 2),
-        right: Math.round((fixed.hitTarget - r(16)) / 2)
-      },
-      children: /*#__PURE__*/_jsx(Icon, {
-        name: showPw ? 'eye' : 'eye-off',
-        size: r(16),
-        color: c.iconFaint40
-      })
-    })
+    textContentType: rawTextContentType ?? 'password',
+    autoComplete: rawAutoComplete ?? 'current-password',
+    autoCapitalize: rawAutoCapitalize ?? 'none',
+    secureTextEntry: !showPassword,
+    leading: {
+      kind: 'icon',
+      icon: 'lock',
+      size: 18
+    },
+    trailing: trailing
   });
 });
 PasswordInput.displayName = 'PasswordInput';

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

@@ -1 +1 @@
-{"version":3,"names":["React","forwardRef","useState","Pressable","Icon","Input","control","fixed","r","useColors","childTestID","styles","jsx","_jsx","PasswordInput","value","onChangeText","placeholder","testID","error","disabled","inputProps","ref","c","showPw","setShowPw","textContentType","autoComplete","autoCapitalize","secureTextEntry","leading","name","size","color","iconFaint40","trailing","style","eyeBtn","onPress","v","accessibilityRole","accessibilityLabel","hitSlop","top","Math","round","hitTarget","md","bottom","left","right","children","displayName"],"sourceRoot":"../../../../../src","sources":["components/ui/PasswordInput/PasswordInput.tsx"],"mappings":";;AAAA,OAAOA,KAAK,IAAIC,UAAU,EAAEC,QAAQ,QAAQ,OAAO;AACnD,SAASC,SAAS,QAAQ,8BAA8B;AACxD,SAASC,IAAI,QAAQ,kBAAS;AAC9B,SAASC,KAAK,QAAQ,mBAAU;AAChC,SAASC,OAAO,EAAEC,KAAK,EAAEC,CAAC,EAAEC,SAAS,QAAQ,yBAAgB;AAC7D,SAASC,WAAW,QAAQ,gCAAuB;AACnD,SAASC,MAAM,QAAQ,aAAU;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAIlC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,MAAMC,aAAa,gBAAGb,UAAU,CACrC,SAASa,aAAaA,CACpB;EACEC,KAAK;EACLC,YAAY;EACZC,WAAW,GAAG,OAAO;EACrBC,MAAM;EACNC,KAAK;EACLC,QAAQ;EACRC;AACF,CAAC,EACDC,GAAG,EACgB;EACnB,MAAMC,CAAC,GAAGd,SAAS,CAAC,CAAC;EACrB,MAAM,CAACe,MAAM,EAAEC,SAAS,CAAC,GAAGvB,QAAQ,CAAC,KAAK,CAAC;EAE3C,oBACEW,IAAA,CAACR,KAAK;IACJiB,GAAG,EAAEA,GAAI;IACTJ,MAAM,EAAEA,MAAO;IACfH,KAAK,EAAEA,KAAM;IACbC,YAAY,EAAEA,YAAa;IAC3BC,WAAW,EAAEA,WAAY;IACzBE,KAAK,EAAEA,KAAM;IACbC,QAAQ,EAAEA;IACV;IAAA;IACAM,eAAe,EAAC,UAAU;IAC1BC,YAAY,EAAC,kBAAkB;IAC/BC,cAAc,EAAC,MAAM;IAAA,GACjBP,UAAU;IACd;IACAQ,eAAe,EAAE,CAACL,MAAO;IACzBM,OAAO,eAAEjB,IAAA,CAACT,IAAI;MAAC2B,IAAI,EAAC,MAAM;MAACC,IAAI,EAAExB,CAAC,CAAC,EAAE,CAAE;MAACyB,KAAK,EAAEV,CAAC,CAACW;IAAY,CAAE,CAAE;IACjEC,QAAQ,eACNtB,IAAA,CAACV,SAAS;MACRe,MAAM,EAAER,WAAW,CAACQ,MAAM,EAAE,QAAQ,CAAE;MACtCkB,KAAK,EAAEzB,MAAM,CAAC0B,MAAO;MACrBC,OAAO,EAAEA,CAAA,KAAMb,SAAS,CAAEc,CAAC,IAAK,CAACA,CAAC,CAAE;MACpCC,iBAAiB,EAAC,QAAQ;MAC1BC,kBAAkB,EAAEjB,MAAM,GAAG,MAAM,GAAG;MACtC;MACA;MAAA;MACAkB,OAAO,EAAE;QACPC,GAAG,EAAEC,IAAI,CAACC,KAAK,CAAC,CAACtC,KAAK,CAACuC,SAAS,GAAGxC,OAAO,CAACyC,EAAE,IAAI,CAAC,CAAC;QACnDC,MAAM,EAAEJ,IAAI,CAACC,KAAK,CAAC,CAACtC,KAAK,CAACuC,SAAS,GAAGxC,OAAO,CAACyC,EAAE,IAAI,CAAC,CAAC;QACtDE,IAAI,EAAEL,IAAI,CAACC,KAAK,CAAC,CAACtC,KAAK,CAACuC,SAAS,GAAGtC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC;QAC/C0C,KAAK,EAAEN,IAAI,CAACC,KAAK,CAAC,CAACtC,KAAK,CAACuC,SAAS,GAAGtC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC;MACjD,CAAE;MAAA2C,QAAA,eAEFtC,IAAA,CAACT,IAAI;QACH2B,IAAI,EAAEP,MAAM,GAAG,KAAK,GAAG,SAAU;QACjCQ,IAAI,EAAExB,CAAC,CAAC,EAAE,CAAE;QACZyB,KAAK,EAAEV,CAAC,CAACW;MAAY,CACtB;IAAC,CACO;EACZ,CACF,CAAC;AAEN,CACF,CAAC;AAEDpB,aAAa,CAACsC,WAAW,GAAG,eAAe","ignoreList":[]}
+{"version":3,"names":["React","forwardRef","useEffect","useState","Input","createLogger","jsx","_jsx","log","PasswordInput","props","ref","textContentType","rawTextContentType","autoComplete","rawAutoComplete","autoCapitalize","rawAutoCapitalize","value","rawValue","onChangeText","rawOnChangeText","disabled","rawDisabled","editable","rawEditable","placeholder","rawPlaceholder","defaultValue","_defaultValue","inputProps","_inputProps","secureTextEntry","_secureTextEntry","leading","_leading","trailing","_trailing","rest","undefined","removedNativeAliasKey","Object","entries","filter","entry","map","name","join","length","warn","showPassword","setShowPassword","effectiveEditable","kind","icon","onPress","visible","accessibilityLabel","size","displayName"],"sourceRoot":"../../../../../src","sources":["components/ui/PasswordInput/PasswordInput.tsx"],"mappings":"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","ignoreList":[]}

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

@@ -2,7 +2,7 @@
 
 import React from 'react';
 import Animated from 'react-native-reanimated';
-import { usePulse } from './usePulse';
+import { usePulse } from "./usePulse.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 export function Pulse({
   children,

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

@@ -1 +1 @@
-{"version":3,"names":["React","Animated","usePulse","jsx","_jsx","Pulse","children","style","testID","opts","animatedStyle","View"],"sourceRoot":"../../../../../src","sources":["components/ui/Pulse/Pulse.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,OAAOC,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,QAAQ,QAAQ,YAAY;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAGtC,OAAO,SAASC,KAAKA,CAAC;EACpBC,QAAQ;EACRC,KAAK;EACLC,MAAM;EACN,GAAGC;AACuC,CAAC,EAAqB;EAChE,MAAMC,aAAa,GAAGR,QAAQ,CAACO,IAAI,CAAC;EACpC,oBACEL,IAAA,CAACH,QAAQ,CAACU,IAAI;IAACJ,KAAK,EAAE,CAACG,aAAa,EAAEH,KAAK,CAAE;IAACC,MAAM,EAAEA,MAAO;IAAAF,QAAA,EAC1DA;EAAQ,CACI,CAAC;AAEpB","ignoreList":[]}
+{"version":3,"names":["React","Animated","usePulse","jsx","_jsx","Pulse","children","style","testID","opts","animatedStyle","View"],"sourceRoot":"../../../../../src","sources":["components/ui/Pulse/Pulse.tsx"],"mappings":";;AAAA,OAAOA,KAAK,MAAM,OAAO;AACzB,OAAOC,QAAQ,MAAM,yBAAyB;AAC9C,SAASC,QAAQ,QAAQ,eAAY;AAAC,SAAAC,GAAA,IAAAC,IAAA;AAGtC,OAAO,SAASC,KAAKA,CAAC;EACpBC,QAAQ;EACRC,KAAK;EACLC,MAAM;EACN,GAAGC;AACuC,CAAC,EAAqB;EAChE,MAAMC,aAAa,GAAGR,QAAQ,CAACO,IAAI,CAAC;EACpC,oBACEL,IAAA,CAACH,QAAQ,CAACU,IAAI;IAACJ,KAAK,EAAE,CAACG,aAAa,EAAEH,KAAK,CAAE;IAACC,MAAM,EAAEA,MAAO;IAAAF,QAAA,EAC1DA;EAAQ,CACI,CAAC;AAEpB","ignoreList":[]}

package/lib/module/components/ui/Pulse/PulseDot.js

@@ -3,23 +3,21 @@
 import React from 'react';
 import Animated from 'react-native-reanimated';
 import { r, useColors } from "../../../theme/index.js";
-import { usePulse } from './usePulse';
+import { DOT_DEFAULTS, usePulseWithDefaults } from "./usePulse.js";
 import { jsx as _jsx } from "react/jsx-runtime";
 export function PulseDot({
   size = r(6),
   color,
-  from = 0.5,
   style,
   testID,
   ...opts
 } = {}) {
   const c = useColors();
   const fill = color ?? c.primary;
-  // [L-93] 只显式覆盖 from(默认 0.5 与 usePulse 的 0.6 不同),其余 opts 透传 usePulse。
-  const animatedStyle = usePulse({
-    from,
-    ...opts
-  });
+  // [L-93] 圆点的 from 默认 0.5(比 <Pulse> 的 0.6 更淡)。默认值交给共享的
+  // DOT_DEFAULTS,不再在解构里写 `from = 0.5` —— 那样 from 会先被默认值填满,
+  // 归一化层再也分不清「调用方没传」和「调用方传了 0.5」。
+  const animatedStyle = usePulseWithDefaults(opts, DOT_DEFAULTS, 'PulseDot');
   return /*#__PURE__*/_jsx(Animated.View, {
     style: [{
       width: size,