@unif/react-native-design 0.20.0 → 0.21.1

package/lib/module/utils/imageSource.js

@@ -0,0 +1,198 @@
+"use strict";
+
+const hasOwn = (value, key) => Object.prototype.hasOwnProperty.call(value, key);
+function valid(snapshot, canonical) {
+  return {
+    valid: true,
+    snapshot,
+    canonical
+  };
+}
+function invalid(kind) {
+  return {
+    valid: false,
+    canonical: `invalid:${kind}`
+  };
+}
+function visitArray(value, keys, seen) {
+  if (!keys.includes('length')) return invalid('descriptor');
+  const lengthDescriptor = Reflect.getOwnPropertyDescriptor(value, 'length');
+  if (lengthDescriptor === undefined || lengthDescriptor.enumerable || !hasOwn(lengthDescriptor, 'value') || typeof lengthDescriptor.value !== 'number' || !Number.isInteger(lengthDescriptor.value) || lengthDescriptor.value < 0) {
+    return invalid('descriptor');
+  }
+  const length = lengthDescriptor.value;
+  if (keys.length !== length + 1) return invalid('descriptor');
+  const keySet = new Set(keys);
+  const parts = [];
+  const snapshot = [];
+  let allValid = true;
+  for (let index = 0; index < length; index += 1) {
+    const key = String(index);
+    if (!keySet.has(key)) return invalid('descriptor');
+    const descriptor = Reflect.getOwnPropertyDescriptor(value, key);
+    if (descriptor === undefined || !descriptor.enumerable || !hasOwn(descriptor, 'value')) {
+      return invalid('descriptor');
+    }
+    const item = visit(descriptor.value, seen);
+    parts.push(item.canonical);
+    if (item.valid) {
+      snapshot.push(item.snapshot);
+    } else {
+      allValid = false;
+    }
+  }
+  const canonical = `array:[${parts.join(',')}]`;
+  return allValid ? valid(Object.freeze(snapshot), canonical) : {
+    valid: false,
+    canonical
+  };
+}
+function visitObject(value, keys, seen) {
+  const snapshot = {};
+  const parts = [];
+  let allValid = true;
+  for (const key of [...keys].sort()) {
+    const descriptor = Reflect.getOwnPropertyDescriptor(value, key);
+    if (descriptor === undefined) return invalid('descriptor');
+    if (!descriptor.enumerable) return invalid('non-enumerable');
+    if (!hasOwn(descriptor, 'value')) return invalid('accessor');
+    const item = visit(descriptor.value, seen);
+    parts.push(`${JSON.stringify(key)}:${item.canonical}`);
+    if (item.valid) {
+      Object.defineProperty(snapshot, key, {
+        configurable: false,
+        enumerable: true,
+        value: item.snapshot,
+        writable: false
+      });
+    } else {
+      allValid = false;
+    }
+  }
+  const canonical = `object:{${parts.join(',')}}`;
+  return allValid ? valid(Object.freeze(snapshot), canonical) : {
+    valid: false,
+    canonical
+  };
+}
+
+/**
+ * 只从 own data descriptor 读取一次，绝不执行 getter。snapshot 与 canonical
+ * key 因而来自同一份值；任何 descriptor / Proxy 异常都失败关闭。
+ */
+function visit(value, seen) {
+  if (value === undefined) return valid(undefined, 'undefined:');
+  if (value === null) return valid(null, 'null:');
+  switch (typeof value) {
+    case 'string':
+      return valid(value, `string:${JSON.stringify(value)}`);
+    case 'number':
+      return Number.isFinite(value) ? valid(value, `number:${value}`) : invalid('number');
+    case 'boolean':
+      return valid(value, `boolean:${String(value)}`);
+    case 'function':
+    case 'symbol':
+    case 'bigint':
+      return invalid(typeof value);
+    case 'object':
+      break;
+    case 'undefined':
+      return valid(undefined, 'undefined:');
+  }
+  try {
+    if (seen.has(value)) return invalid('cycle');
+    const isArray = Array.isArray(value);
+    const ownKeys = Reflect.ownKeys(value);
+    const keys = [];
+    for (const key of ownKeys) {
+      if (typeof key === 'symbol') return invalid('symbol-key');
+      keys.push(key);
+    }
+    seen.add(value);
+    try {
+      return isArray ? visitArray(value, keys, seen) : visitObject(value, keys, seen);
+    } finally {
+      seen.delete(value);
+    }
+  } catch {
+    return invalid('exception');
+  }
+}
+function snapshotValue(value) {
+  try {
+    return visit(value, new WeakSet());
+  } catch {
+    return invalid('exception');
+  }
+}
+export function canonicalSourceValue(value) {
+  return snapshotValue(value).canonical;
+}
+const URI_STRING_FIELDS = ['bundle', 'method', 'body'];
+const CACHE_POLICIES = new Set(['default', 'reload', 'force-cache', 'only-if-cached']);
+function isSnapshotObject(value) {
+  return value !== null && typeof value === 'object' && !Array.isArray(value);
+}
+function isValidHeaders(value) {
+  if (value === undefined) return true;
+  if (!isSnapshotObject(value)) return false;
+  return Object.keys(value).every(key => typeof value[key] === 'string');
+}
+function isValidUriSource(value) {
+  if (!isSnapshotObject(value) || !hasOwn(value, 'uri')) return false;
+  const uri = value.uri;
+  if (typeof uri !== 'string' || uri.trim().length === 0) return false;
+  for (const field of URI_STRING_FIELDS) {
+    const fieldValue = value[field];
+    if (fieldValue !== undefined && typeof fieldValue !== 'string') {
+      return false;
+    }
+  }
+  if (!isValidHeaders(value.headers)) return false;
+  const cache = value.cache;
+  if (cache !== undefined && !CACHE_POLICIES.has(cache)) return false;
+  for (const field of ['width', 'height', 'scale']) {
+    const fieldValue = value[field];
+    if (fieldValue !== undefined && (typeof fieldValue !== 'number' || !Number.isFinite(fieldValue))) {
+      return false;
+    }
+  }
+  return true;
+}
+function asImageSource(snapshot) {
+  if (typeof snapshot === 'number') {
+    return Number.isFinite(snapshot) && snapshot > 0 && Number.isInteger(snapshot) ? snapshot : undefined;
+  }
+  if (Array.isArray(snapshot)) {
+    return snapshot.length > 0 && snapshot.every(isValidUriSource) ? snapshot : undefined;
+  }
+  return isValidUriSource(snapshot) ? snapshot : undefined;
+}
+
+/**
+ * 组件唯一入口：一次读取完成 runtime validation、deep-frozen plain snapshot
+ * 与 semantic key。调用方必须把同一返回值里的 source / key 一起交给 attempt。
+ */
+export function resolveImageSource(source) {
+  const result = snapshotValue(source);
+  if (!result.valid) return undefined;
+  const snapshot = asImageSource(result.snapshot);
+  if (snapshot === undefined) return undefined;
+  return Object.freeze({
+    source: snapshot,
+    key: `image-source:${result.canonical}`
+  });
+}
+export function imageSourceKey(source) {
+  return `image-source:${snapshotValue(source).canonical}`;
+}
+
+/**
+ * JS 消费者可能绕过类型系统。只有能安全 snapshot 的 asset id、URI object 或
+ * URI object 数组能进入 Image；accessor、异常 descriptor 与非法 nested value
+ * 一律失败关闭。
+ */
+export function isValidImageSource(source) {
+  return resolveImageSource(source) !== undefined;
+}
+//# sourceMappingURL=imageSource.js.map

package/lib/module/utils/imageSource.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["hasOwn","value","key","Object","prototype","hasOwnProperty","call","valid","snapshot","canonical","invalid","kind","visitArray","keys","seen","includes","lengthDescriptor","Reflect","getOwnPropertyDescriptor","undefined","enumerable","Number","isInteger","length","keySet","Set","parts","allValid","index","String","has","descriptor","item","visit","push","join","freeze","visitObject","sort","JSON","stringify","defineProperty","configurable","writable","isFinite","isArray","Array","ownKeys","add","delete","snapshotValue","WeakSet","canonicalSourceValue","URI_STRING_FIELDS","CACHE_POLICIES","isSnapshotObject","isValidHeaders","every","isValidUriSource","uri","trim","field","fieldValue","headers","cache","asImageSource","resolveImageSource","source","result","imageSourceKey","isValidImageSource"],"sourceRoot":"../../../src","sources":["utils/imageSource.ts"],"mappings":"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","ignoreList":[]}

package/lib/typescript/manual-tests/runtime-api/RuntimeApiScreen.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+/**
+ * Runtime API 人工验证屏 —— 由 `yarn create:runtime-harness` 拷进临时的
+ * RN 0.86.2 app 里跑,**不属于任何自动化测试**。
+ *
+ * 它只 import 包根 barrel(与真实消费者一致),用来验证 Jest 覆盖不到的部分:
+ * 真实 native / Web 结构、44pt 命中框、a11y tree、reduced motion 和竞态。
+ *
+ * 每个交互结果都渲染成可见文本 —— 人工验收时逐条对照 verification matrix 记录。
+ */
+export declare function RuntimeApiScreen(): React.JSX.Element;
+//# sourceMappingURL=RuntimeApiScreen.d.ts.map

package/lib/typescript/manual-tests/runtime-api/RuntimeApiScreen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuntimeApiScreen.d.ts","sourceRoot":"","sources":["../../../../manual-tests/runtime-api/RuntimeApiScreen.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgD,MAAM,OAAO,CAAC;AA0DrE;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,IAAI,KAAK,CAAC,GAAG,CAAC,OAAO,CAgYpD"}

package/lib/typescript/src/components/business/AvatarWithRing/AvatarWithRing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AvatarWithRing.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/AvatarWithRing/AvatarWithRing.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAWvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,IAAS,EACT,SAAS,EACT,KAAK,EACL,MAAM,GACP,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAwCzC"}
+{"version":3,"file":"AvatarWithRing.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/AvatarWithRing/AvatarWithRing.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AAWvC,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAEnD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAC7B,KAAK,EACL,IAAS,EACT,SAAS,EACT,KAAK,EACL,MAAM,GACP,EAAE,mBAAmB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+CzC"}

package/lib/typescript/src/components/business/AvatarWithRing/styles.d.ts

@@ -1,15 +1,16 @@
 import { type ViewStyle } from 'react-native';
 import { type ColorTokens } from '../../../theme';
 /**
- * 头像样式工厂 —— **非标 maker 签名**:`(size, ringColor, shadowStyle, c)` 4 参,
+ * 头像样式工厂 —— **非标 maker 签名**:`(size, ringColor, shadowStyle, c,
+ * fontScale)` 5 参,
  * 而非项目通用 `(c: ColorTokens, s: ShadowTokens) => StyleSheet` 2 参。
  *
  * **为何破例**:`size` / `ringColor` 是 **props 派生**(每次调用值不同,如 ring 宽度
  * = `size * 0.0625`、label 字号 = `size * 0.40`、inner 直径 = `size - ringWidth*2`),
- * 标准 `useThemedStyles(maker)` 按 `[colors, shadow]` memo 假设 maker 是模块顶层
- * 常量,无法承接 props 变化。改走调用点自带 `useMemo([size, ringColor, c,
- * shadow.brandAvatar])` 精确缓存,signature 因此带上 size/ringColor/shadow 三个
- * 运行期入参,c 仍传入用于 label 文字色。
+ * 标准 `useThemedStyles(maker)` 按 `[colors, shadow, fontScale, maker]` memo,且假设 maker
+ * 是模块顶层常量,无法承接 props 变化。改走调用点自带 `useMemo([size, ringColor, c,
+ * shadow.brandAvatar, fontScale])` 精确缓存,signature 因此带上
+ * size/ringColor/shadow/fontScale 四个运行期入参,c 仍传入用于 label 文字色。
  *
  * **不用 borderWidth + borderColor 实现 ring**:RN new arch (Fabric) 在
  * iOS 上对 `borderColor: rgba alpha + borderRadius: width/2`(完全圆)的组合
@@ -19,7 +20,7 @@ import { type ColorTokens } from '../../../theme';
  * - shell:size×size 圆,backgroundColor = ringColor(承担 ring 视觉)+ shadow
  * - avatarCore:inner×inner 圆,在 shell 内 flex center,内部放 SVG 渐变 + label
  */
-export declare const makeAvatarStyles: (size: number, ringColor: string, shadowStyle: ViewStyle, c: ColorTokens) => {
+export declare const makeAvatarStyles: (size: number, ringColor: string, shadowStyle: ViewStyle, c: ColorTokens, fontScale: number) => {
     ringWidth: number;
     dim: number;
     inner: number;
@@ -108,7 +109,7 @@ export declare const makeAvatarStyles: (size: number, ringColor: string, shadowS
             pointerEvents?: "auto" | "none" | "box-none" | "box-only";
             cursor?: import("react-native").CursorValue;
             boxShadow?: ReadonlyArray<import("react-native").BoxShadowValue> | string;
-            mixBlendMode?: "color" | "normal" | "multiply" | "screen" | "overlay" | "darken" | "lighten" | "color-dodge" | "color-burn" | "hard-light" | "soft-light" | "difference" | "exclusion" | "hue" | "saturation" | "luminosity";
+            mixBlendMode?: "color" | "normal" | "multiply" | "screen" | "overlay" | "darken" | "lighten" | "color-dodge" | "color-burn" | "hard-light" | "soft-light" | "difference" | "exclusion" | "hue" | "saturation" | "luminosity" | "plus-lighter";
             experimental_backgroundImage?: ReadonlyArray<import("react-native/types_generated/Libraries/StyleSheet/StyleSheetTypes").BackgroundImageValue> | string;
             experimental_backgroundSize?: ReadonlyArray<import("react-native/types_generated/Libraries/StyleSheet/StyleSheetTypes").BackgroundSizeValue> | string;
             experimental_backgroundPosition?: ReadonlyArray<import("react-native/types_generated/Libraries/StyleSheet/StyleSheetTypes").BackgroundPositionValue> | string;

package/lib/typescript/src/components/business/AvatarWithRing/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/AvatarWithRing/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAS,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAKzD;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,WAAW,MAAM,EACjB,aAAa,SAAS,EACtB,GAAG,WAAW;;;;;;;;;;;qBAkDu9tB,CAAC;sBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAD5/tB,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/AvatarWithRing/styles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAA0B,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAK1E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,gBAAgB,GAC3B,MAAM,MAAM,EACZ,WAAW,MAAM,EACjB,aAAa,SAAS,EACtB,GAAG,WAAW,EACd,WAAW,MAAM;;;;;;;;;;;qBAkDk0tB,CAAC;sBAAoB,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAD12tB,CAAC"}

package/lib/typescript/src/components/business/VersionPill/VersionPill.d.ts

@@ -1,5 +1,5 @@
 import React from 'react';
 import type { VersionPillProps } from './types';
 /** 版本徽章胶囊 —— success dot + 版本 + 分点 + build mono。 */
-export declare function VersionPill({ version, build, statusColor, versionPrefix, buildPrefix, style, testID, }: VersionPillProps): React.JSX.Element;
+export declare function VersionPill({ version, build, status, versionPrefix, buildPrefix, style, testID, }: VersionPillProps): React.JSX.Element;
 //# sourceMappingURL=VersionPill.d.ts.map

package/lib/typescript/src/components/business/VersionPill/VersionPill.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"VersionPill.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/VersionPill.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAEhD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,WAAW,EACX,aAAqB,EACrB,WAAsB,EACtB,KAAK,EACL,MAAM,GACP,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqDtC"}
+{"version":3,"file":"VersionPill.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/VersionPill.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAOzC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAIhD,oDAAoD;AACpD,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EACP,KAAK,EACL,MAAM,EACN,aAAqB,EACrB,WAAsB,EACtB,KAAK,EACL,MAAM,GACP,EAAE,gBAAgB,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAsDtC"}

package/lib/typescript/src/components/business/VersionPill/content.d.ts

@@ -0,0 +1,19 @@
+import type { ColorTokens } from '../../../theme';
+import type { VersionStatus } from './types';
+type VersionStatusColors = Pick<ColorTokens, 'foregroundMuted' | 'success'>;
+type ResolvedVersionStatus = {
+    label: string;
+    color: string;
+    diagnostics: readonly string[];
+};
+export declare function resolveVersionStatus(status: VersionStatus | undefined, colors: VersionStatusColors): ResolvedVersionStatus;
+type VersionPillLabelContent = {
+    version: string;
+    build: string | null | undefined;
+    statusLabel: string;
+    versionPrefix: string;
+    buildPrefix: string;
+};
+export declare function buildVersionPillLabel({ version, build, statusLabel, versionPrefix, buildPrefix, }: VersionPillLabelContent): string;
+export {};
+//# sourceMappingURL=content.d.ts.map

package/lib/typescript/src/components/business/VersionPill/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/content.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C,KAAK,mBAAmB,GAAG,IAAI,CAAC,WAAW,EAAE,iBAAiB,GAAG,SAAS,CAAC,CAAC;AAE5E,KAAK,qBAAqB,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,GAAG,SAAS,EACjC,MAAM,EAAE,mBAAmB,GAC1B,qBAAqB,CAUvB;AAED,KAAK,uBAAuB,GAAG;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,EACpC,OAAO,EACP,KAAK,EACL,WAAW,EACX,aAAa,EACb,WAAW,GACZ,EAAE,uBAAuB,GAAG,MAAM,CAKlC"}

package/lib/typescript/src/components/business/VersionPill/index.d.ts

@@ -1,3 +1,3 @@
 export { VersionPill } from './VersionPill';
-export type { VersionPillProps } from './types';
+export type { VersionPillProps, VersionStatus } from './types';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/business/VersionPill/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC"}

package/lib/typescript/src/components/business/VersionPill/styles.d.ts

@@ -18,6 +18,10 @@ export declare const makeVersionPillStyles: (c: ColorTokens) => Readonly<{
         height: number;
         borderRadius: 999;
     };
+    status: {
+        fontSize: number;
+        color: string;
+    };
     version: {
         fontSize: number;
         color: string;

package/lib/typescript/src/components/business/VersionPill/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/styles.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAExB;oDACoD;AACpD,eAAO,MAAM,qBAAqB,GAAI,GAAG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAiChD,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/styles.ts"],"names":[],"mappings":"AACA,OAAO,EAML,KAAK,WAAW,EACjB,MAAM,gBAAgB,CAAC;AAExB;oDACoD;AACpD,eAAO,MAAM,qBAAqB,GAAI,GAAG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAqChD,CAAC"}

package/lib/typescript/src/components/business/VersionPill/types.d.ts

@@ -1,11 +1,15 @@
 import type { StyleProp, ViewStyle } from 'react-native';
+export type VersionStatus = {
+    label: string;
+    color?: string;
+};
 export type VersionPillProps = {
     /** 版本号,如 "2.8.0"。 */
     version: string;
     /** 可选 build 号;值为 null/undefined/"" 时省略分点与 build 字。 */
     build?: string;
-    /** 状态点颜色,默认 c.success。 */
-    statusColor?: string;
+    /** 可见状态；缺省为 success 色的“正常”。 */
+    status?: VersionStatus;
     /**
      * 版本号前缀文案,默认 "版本 "。
      * 消费者可传 "v" / "Version " 等覆盖(含末尾空格)。

package/lib/typescript/src/components/business/VersionPill/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/business/VersionPill/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzD,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB;IAChB,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/lib/typescript/src/components/business/index.d.ts

@@ -6,5 +6,5 @@ export type { GlassStatsProps, GlassStatItem } from './GlassStats';
 export { AvatarWithRing } from './AvatarWithRing';
 export type { AvatarWithRingProps } from './AvatarWithRing';
 export { VersionPill } from './VersionPill';
-export type { VersionPillProps } from './VersionPill';
+export type { VersionPillProps, VersionStatus } from './VersionPill';
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/components/business/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/business/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/components/business/index.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACzE,YAAY,EACV,YAAY,EACZ,iBAAiB,EACjB,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAIvB,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAEnE,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,YAAY,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC"}

package/lib/typescript/src/components/business/useSvgId.d.ts

@@ -1,12 +1,13 @@
+export declare function sanitizeSvgIdPart(value: string): string;
+export declare function buildSvgId(prefix: string, override: string | undefined, reactId: string): string;
 /**
- * SVG 渐变 id 生成 hook —— 消毒 React 19 useId 中的冒号字符。
+ * SVG 渐变 id 生成 hook —— 消毒 prefix、override 与 React useId。
  *
- * Why:React 19 的 useId() 返回含冒号(`:r0:`)的字符串,不是合法的 SVG id 字符
- * (XML NCName 规则),直接用在 `<LinearGradient id>` / `<RadialGradient id>`
- * 会导致 SVG 引用失败。sanitize 后拼上 prefix 保证唯一且合法。
+ * Why:useId() 的字符串格式由 renderer 决定，caller 传入的 prefix 与 override
+ * 也可能包含空白或标点；统一消毒并保证合法首字符后，SVG 引用才能跨平台稳定。
  *
  * @param prefix  短前缀,区分同屏多 gradient(如 "gw" / "rh" / "av")。
- * @param override 可选:外部传入的 gradientId;有值时直接返回,跳过 useId 分配。
+ * @param override 可选:外部传入的 gradientId;消毒后非空时优先使用。
  */
 export declare function useSvgId(prefix: string, override?: string): string;
 //# sourceMappingURL=useSvgId.d.ts.map

package/lib/typescript/src/components/business/useSvgId.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useSvgId.d.ts","sourceRoot":"","sources":["../../../../../src/components/business/useSvgId.ts"],"names":[],"mappings":"AAEA;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAIlE"}
+{"version":3,"file":"useSvgId.d.ts","sourceRoot":"","sources":["../../../../../src/components/business/useSvgId.ts"],"names":[],"mappings":"AAEA,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,wBAAgB,UAAU,CACxB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,OAAO,EAAE,MAAM,GACd,MAAM,CAWR;AAED;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlE"}

package/lib/typescript/src/components/ui/Avatar/Avatar.d.ts

@@ -3,8 +3,8 @@ import type { AvatarProps } from './types';
 /**
  * 圆形头像 —— 5 档尺寸 × 4 种配色 × 可选图片 source。
  *
- * 传 source 且未失败时渲染 Image(onError 后自动 fallback 到 label 文字),
- * 否则渲染 label + variant 背景色。
+ * 合法 source 由 keyed ImageAttempt 独立持有失败状态；非法 source 或加载失败
+ * 时渲染 label + variant 背景色。
  */
 export declare function Avatar({ label, size, variant, source, style, testID, }: AvatarProps): React.JSX.Element;
 //# sourceMappingURL=Avatar.d.ts.map

package/lib/typescript/src/components/ui/Avatar/Avatar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA8B,MAAM,OAAO,CAAC;AAInD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,IAAW,EACX,OAAmB,EACnB,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAwDjC"}
+{"version":3,"file":"Avatar.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/Avatar.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,IAAW,EACX,OAAmB,EACnB,MAAM,EACN,KAAK,EACL,MAAM,GACP,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA6CjC"}

package/lib/typescript/src/components/ui/Avatar/types.d.ts

@@ -20,8 +20,12 @@ export type AvatarProps = {
     /** 配色变体，默认 'neutral' */
     variant?: AvatarVariant;
     /**
-     * 真实头像图片（URL `{ uri: '...' }` 或 `require(...)`）。
-     * 提供时优先渲染 image；onError 触发后自动 fallback 到 label。
+     * 真实头像图片（URL `{ uri: '...' }`、URI source 数组或 `require(...)`）。
+     * 运行时先校验并生成 immutable semantic snapshot；非法 source 直接 fallback。
+     * Web 对 URI source 数组明确使用首个 candidate，native 保留完整数组。
+     * class / custom prototype 只读取 own enumerable data，继承属性与 accessor 无效。
+     * 等价 source 沿用同一 keyed attempt，真实字段变化才重试；失败 state 不跨
+     * attempt 共享。
      */
     source?: ImageSourcePropType;
     /** 容器附加样式(margin / position 等布局微调)。 */

package/lib/typescript/src/components/ui/Avatar/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9E,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,wBAAwB;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;OAGG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,uCAAuC;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Avatar/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAE9E,mEAAmE;AACnE,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1D;;;;;;GAMG;AACH,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAElE,MAAM,MAAM,WAAW,GAAG;IACxB;;;OAGG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,iBAAiB;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,wBAAwB;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,uCAAuC;IACvC,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC"}

package/lib/typescript/src/components/ui/Button/Button.d.ts

@@ -7,5 +7,5 @@ import type { ButtonProps } from './types';
  *
  * `loading=true` 时 ButtonBase 把 children render prop 短路为 ActivityIndicator。
  */
-export declare function Button({ label, onPress, size, variant, block, disabled, loading, leftIcon, rightIcon, style, testID, accessibilityHint, }: ButtonProps): React.JSX.Element;
+export declare function Button({ label, onPress, size, variant, block, disabled, loading, leftIcon, rightIcon, style, testID, accessibilityHint, accessibilityState, }: ButtonProps): React.JSX.Element;
 //# sourceMappingURL=Button.d.ts.map

package/lib/typescript/src/components/ui/Button/Button.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAM1B,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAE3C;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,iBAAiB,GAClB,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAiCjC"}
+{"version":3,"file":"Button.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Button/Button.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAQzC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAI3C;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,EACrB,KAAK,EACL,OAAO,EACP,IAAI,EACJ,OAAO,EACP,KAAK,EACL,QAAQ,EACR,OAAO,EACP,QAAQ,EACR,SAAS,EACT,KAAK,EACL,MAAM,EACN,iBAAiB,EACjB,kBAAkB,GACnB,EAAE,WAAW,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA+CjC"}

package/lib/typescript/src/components/ui/Button/ButtonBase.d.ts

@@ -1,8 +1,8 @@
 import React from 'react';
-import { type AccessibilityRole, type StyleProp, type ViewStyle } from 'react-native';
+import { type AccessibilityRole, type AccessibilityState, type StyleProp, type ViewStyle } from 'react-native';
 import type { ButtonBaseRenderContext, ButtonSize, ButtonVariant } from './types';
 export type ButtonBaseProps = {
-    onPress?: () => void;
+    onPress: () => void;
     size?: ButtonSize;
     variant?: ButtonVariant;
     disabled?: boolean;
@@ -14,6 +14,8 @@ export type ButtonBaseProps = {
     accessibilityRole?: AccessibilityRole;
     /** SR 朗读 label 后的行为说明 hint。仅在"行为不显然"时加。 */
     accessibilityHint?: string;
+    /** 调用方附加状态；disabled / busy 由内部状态机控制，不能被覆盖。 */
+    accessibilityState?: Omit<AccessibilityState, 'disabled' | 'busy'>;
     style?: StyleProp<ViewStyle>;
     testID?: string;
     /** 强制函数形态 — 消费者通过 ctx.sizing / ctx.palette 渲染内容,
@@ -23,5 +25,5 @@ export type ButtonBaseProps = {
 /** ButtonBase —— Button / IconButton 共享的 internal primitive。
  *  职责:Pressable / sizing / palette / 视觉态 / a11y / text variant 特殊处理 /
  *  block / square。children 强制 render prop,sizingFor / paletteFor 在 styles.ts。 */
-export declare function ButtonBase({ onPress, size, variant, disabled, loading, block, square, accessibilityLabel, accessibilityRole, accessibilityHint, style, testID, children, }: ButtonBaseProps): React.JSX.Element;
+export declare function ButtonBase({ onPress, size, variant, disabled, loading, block, square, accessibilityLabel, accessibilityRole, accessibilityHint, accessibilityState, style, testID, children, }: ButtonBaseProps): React.JSX.Element;
 //# sourceMappingURL=ButtonBase.d.ts.map

package/lib/typescript/src/components/ui/Button/ButtonBase.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ButtonBase.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Button/ButtonBase.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAStB,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;+CAC2C;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC7D,CAAC;AAEF;;iFAEiF;AACjF,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,IAAW,EACX,OAAmB,EACnB,QAAQ,EACR,OAAO,EACP,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,iBAA4B,EAC5B,iBAAiB,EACjB,KAAK,EACL,MAAM,EACN,QAAQ,GACT,EAAE,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CAqErC"}
+{"version":3,"file":"ButtonBase.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Button/ButtonBase.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAkB,MAAM,OAAO,CAAC;AACvC,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,SAAS,EACf,MAAM,cAAc,CAAC;AAStB,OAAO,KAAK,EACV,uBAAuB,EACvB,UAAU,EACV,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,iBAAiB,CAAC;IACtC,2CAA2C;IAC3C,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;IACnE,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;+CAC2C;IAC3C,QAAQ,EAAE,CAAC,GAAG,EAAE,uBAAuB,KAAK,KAAK,CAAC,SAAS,CAAC;CAC7D,CAAC;AAEF;;iFAEiF;AACjF,wBAAgB,UAAU,CAAC,EACzB,OAAO,EACP,IAAW,EACX,OAAmB,EACnB,QAAQ,EACR,OAAO,EACP,KAAK,EACL,MAAM,EACN,kBAAkB,EAClB,iBAA4B,EAC5B,iBAAiB,EACjB,kBAAkB,EAClB,KAAK,EACL,MAAM,EACN,QAAQ,GACT,EAAE,eAAe,GAAG,KAAK,CAAC,GAAG,CAAC,OAAO,CA0ErC"}

package/lib/typescript/src/components/ui/Button/types.d.ts

@@ -1,4 +1,4 @@
-import type { StyleProp, ViewStyle } from 'react-native';
+import type { AccessibilityState, StyleProp, ViewStyle } from 'react-native';
 import type { IconName } from '../Icon';
 /** Button 尺寸：sm=28 / md=36 / lg=44（对应 control.sm/md/lg） */
 export type ButtonSize = 'sm' | 'md' | 'lg';
@@ -18,12 +18,12 @@ export type ButtonProps = {
     /** 按钮文案；icon-only 场景请用 IconButton */
     label: string;
     /** 点击回调；disabled / loading 时不触发 */
-    onPress?: () => void;
+    onPress: () => void;
     /** 尺寸，默认 'md' */
     size?: ButtonSize;
     /** 视觉变体，默认 'primary' */
     variant?: ButtonVariant;
-    /** 撑满父容器宽度（alignSelf: stretch + flexGrow: 1） */
+    /** 撑满父容器交叉轴宽度（alignSelf: stretch） */
     block?: boolean;
     /** 整体禁用：透明度 0.5 + 不响应 onPress */
     disabled?: boolean;
@@ -39,6 +39,8 @@ export type ButtonProps = {
     testID?: string;
     /** SR 朗读 label 后的行为说明 hint。仅在"行为不显然"时加(如 "切换主题")。 */
     accessibilityHint?: string;
+    /** 额外 a11y 状态；disabled / busy 由组件根据 disabled / loading 统一上报。 */
+    accessibilityState?: Omit<AccessibilityState, 'disabled' | 'busy'>;
 };
 /** ButtonBase 内部根据 size 算出的视觉参数集合,通过 render prop 暴露给消费者。 */
 export type ButtonSizing = {

package/lib/typescript/src/components/ui/Button/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Button/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG;IACxB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,iBAAiB;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,wBAAwB;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,gDAAgD;IAChD,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mBAAmB;IACnB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG;IACzB,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Button/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC7E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAExC,2DAA2D;AAC3D,MAAM,MAAM,UAAU,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAE5C;;;;;;;;;;GAUG;AACH,MAAM,MAAM,aAAa,GACrB,SAAS,GACT,WAAW,GACX,OAAO,GACP,SAAS,GACT,SAAS,GACT,QAAQ,GACR,MAAM,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG;IACxB,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,mCAAmC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,iBAAiB;IACjB,IAAI,CAAC,EAAE,UAAU,CAAC;IAClB,wBAAwB;IACxB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,qCAAqC;IACrC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,oDAAoD;IACpD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,mBAAmB;IACnB,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,mBAAmB;IACnB,SAAS,CAAC,EAAE,QAAQ,CAAC;IACrB,6CAA6C;IAC7C,KAAK,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7B,iBAAiB;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qDAAqD;IACrD,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,IAAI,CAAC,kBAAkB,EAAE,UAAU,GAAG,MAAM,CAAC,CAAC;CACpE,CAAC;AAEF,4DAA4D;AAC5D,MAAM,MAAM,YAAY,GAAG;IACzB,8BAA8B;IAC9B,CAAC,EAAE,MAAM,CAAC;IACV,sDAAsD;IACtD,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,eAAe;IACf,GAAG,EAAE,MAAM,CAAC;CACb,CAAC;AAEF,2CAA2C;AAC3C,MAAM,MAAM,aAAa,GAAG;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,8CAA8C;AAC9C,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,YAAY,CAAC;IACrB,OAAO,EAAE,aAAa,CAAC;CACxB,CAAC"}

package/lib/typescript/src/components/ui/Carousel/Carousel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Carousel.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/Carousel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAS1B,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAwG1D,eAAO,MAAM,QAAQ,EAAsC,CAAC,CAAC,EAC3D,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;CAAE,KACvD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}
+{"version":3,"file":"Carousel.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/Carousel.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAqBzC,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AA0J1D,eAAO,MAAM,QAAQ,EAAsC,CAAC,CAAC,EAC3D,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;CAAE,KACvD,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC"}

package/lib/typescript/src/components/ui/Carousel/behavior.d.ts

@@ -0,0 +1,25 @@
+/** 系统请求减弱动效时，Carousel 不得启动计时 autoplay。 */
+export declare const effectiveCarouselAutoplay: (autoplay: boolean | undefined, reducedMotion: boolean) => boolean;
+/** 单页不需要视觉页码，也不应为其保留布局高度。 */
+export declare const shouldRenderCarouselPagination: (showIndicator: boolean, itemCount: number) => boolean;
+type CarouselPressHandler<T> = (item: T, index: number) => void;
+type CarouselLabelGetter<T> = (item: T, index: number) => unknown;
+export type NormalizedCarouselAction<T> = {
+    kind: 'display';
+    diagnostics: readonly string[];
+} | {
+    kind: 'action';
+    onPressItem: CarouselPressHandler<T>;
+    getAccessibilityLabel: CarouselLabelGetter<T>;
+    diagnostics: readonly string[];
+};
+/** 只有两个函数同时存在才形成 action；任何半配置/未类型化值都失败关闭为展示。 */
+export declare function normalizeCarouselAction<T>(onPressItem: unknown, getAccessibilityLabel: unknown): NormalizedCarouselAction<T>;
+export type CarouselItemAccessibility = {
+    label: string | undefined;
+    diagnostics: readonly string[];
+};
+/** getter 的异常和非法返回值都只影响当前 item，不能让整个 Carousel render 崩溃。 */
+export declare function resolveCarouselItemAccessibility<T>(getAccessibilityLabel: CarouselLabelGetter<T>, item: T, index: number, itemCount: number): CarouselItemAccessibility;
+export {};
+//# sourceMappingURL=behavior.d.ts.map

package/lib/typescript/src/components/ui/Carousel/behavior.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"behavior.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/Carousel/behavior.ts"],"names":[],"mappings":"AAEA,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB,GACpC,UAAU,OAAO,GAAG,SAAS,EAC7B,eAAe,OAAO,KACrB,OAA8C,CAAC;AAElD,6BAA6B;AAC7B,eAAO,MAAM,8BAA8B,GACzC,eAAe,OAAO,EACtB,WAAW,MAAM,KAChB,OAAyC,CAAC;AAE7C,KAAK,oBAAoB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;AAChE,KAAK,mBAAmB,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,OAAO,CAAC;AAElE,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAClC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACnD;IACE,IAAI,EAAE,QAAQ,CAAC;IACf,WAAW,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC;IACrC,qBAAqB,EAAE,mBAAmB,CAAC,CAAC,CAAC,CAAC;IAC9C,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEN,gDAAgD;AAChD,wBAAgB,uBAAuB,CAAC,CAAC,EACvC,WAAW,EAAE,OAAO,EACpB,qBAAqB,EAAE,OAAO,GAC7B,wBAAwB,CAAC,CAAC,CAAC,CAgB7B;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,4DAA4D;AAC5D,wBAAgB,gCAAgC,CAAC,CAAC,EAChD,qBAAqB,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC7C,IAAI,EAAE,CAAC,EACP,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,GAChB,yBAAyB,CAkB3B"}