@unif/react-native-design 0.20.0 → 0.21.0

package/lib/typescript/src/components/ui/TextField/normalize.d.ts

@@ -0,0 +1,51 @@
+import type { StyleProp, ViewStyle } from 'react-native';
+import type { SearchFieldLayout, TextFieldContainerStyle, TextFieldSlot } from './types';
+export type NormalizedNumber = {
+    value: number;
+    diagnostics: readonly string[];
+};
+/** 单行高度 —— 不得低于 `fixed.hitTarget`(44pt),否则整行都碰不满一个手指。 */
+export declare function normalizeInputHeight(value: unknown): NormalizedNumber;
+export type NormalizedTextareaHeights = {
+    minHeight: number;
+    maxHeight: number | undefined;
+    diagnostics: readonly string[];
+};
+/** 多行高度 —— `maxHeight` 只有在有限且不小于归一化后的 `minHeight` 时才保留。 */
+export declare function normalizeTextareaHeights(minHeight: unknown, maxHeight: unknown): NormalizedTextareaHeights;
+/** slot 图标尺寸 —— 只接受有限的 `[1, 32]`。 */
+export declare function normalizeSlotIconSize(value: unknown): NormalizedNumber;
+export type NormalizedTextFieldSlot = {
+    slot: TextFieldSlot | undefined;
+    diagnostics: readonly string[];
+};
+/** 未类型化 JS 必须完整匹配一个受支持分支，不能靠 discriminant 后 cast 绕过校验。 */
+export declare function normalizeTextFieldSlot(slot: unknown): NormalizedTextFieldSlot;
+export type NormalizedSearchLayout = SearchFieldLayout & {
+    diagnostics: readonly string[];
+};
+/** 搜索框的可见面可为 36pt,但承载输入/操作的实际行永远不得小于 44pt。 */
+export declare function normalizeSearchLayout(interactiveHeight: unknown, visibleHeight: unknown): NormalizedSearchLayout;
+export type SanitizedContainerStyle = {
+    style: TextFieldContainerStyle;
+    diagnostics: readonly string[];
+};
+export type SanitizedTextFieldWrapperProps = {
+    props: Record<string, unknown>;
+    diagnostics: readonly string[];
+};
+/**
+ * 公开 Input / Textarea 不允许未类型化 JS 覆盖内部 layout 开关。
+ *
+ * 返回新对象而不是 delete 原 props，既不改变调用方对象，也让 wrapper 能在安全 spread
+ * 后由可信边界写入自己的 `multiline`。
+ */
+export declare function sanitizeTextFieldWrapperProps(props: Record<string, unknown>): SanitizedTextFieldWrapperProps;
+/**
+ * 剥掉 containerStyle 里会覆盖最小 frame 的六个字段。
+ *
+ * 先 `StyleSheet.flatten` 再解构到新对象 —— 绝不原地修改调用方对象或已注册的
+ * StyleSheet 条目(那会污染同一 sheet 的其他使用者)。
+ */
+export declare function sanitizeTextFieldContainerStyle(style: StyleProp<ViewStyle> | undefined): SanitizedContainerStyle;
+//# sourceMappingURL=normalize.d.ts.map

package/lib/typescript/src/components/ui/TextField/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/TextField/normalize.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAIzD,OAAO,KAAK,EACV,iBAAiB,EACjB,uBAAuB,EACvB,aAAa,EACd,MAAM,SAAS,CAAC;AAuCjB,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAIrE;AAED,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,2DAA2D;AAC3D,wBAAgB,wBAAwB,CACtC,SAAS,EAAE,OAAO,EAClB,SAAS,EAAE,OAAO,GACjB,yBAAyB,CAqB3B;AAED,qCAAqC;AACrC,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAItE;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,IAAI,EAAE,aAAa,GAAG,SAAS,CAAC;IAChC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AASF,0DAA0D;AAC1D,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,CA4E7E;AAED,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,GAAG;IACvD,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,8CAA8C;AAC9C,wBAAgB,qBAAqB,CACnC,iBAAiB,EAAE,OAAO,EAC1B,aAAa,EAAE,OAAO,GACrB,sBAAsB,CAwBxB;AAED,MAAM,MAAM,uBAAuB,GAAG;IACpC,KAAK,EAAE,uBAAuB,CAAC;IAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG;IAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;CAChC,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,8BAA8B,CAUhC;AAED;;;;;GAKG;AACH,wBAAgB,+BAA+B,CAC7C,KAAK,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,SAAS,GACtC,uBAAuB,CAgBzB"}

package/lib/typescript/src/components/ui/TextField/styles.d.ts

@@ -13,6 +13,17 @@ export declare const makeStyles: (c: ColorTokens) => Readonly<{
         paddingVertical: number;
         alignItems: "flex-start";
     };
+    /** Search 的可见底色/边框绝不承载命中区域。 */
+    searchInteractiveRow: {
+        borderWidth: number;
+    };
+    searchVisibleSurface: {
+        position: "absolute";
+        left: number;
+        right: number;
+        borderRadius: number;
+        borderWidth: number;
+    };
     wrapIdle: {
         backgroundColor: string;
         borderColor: string;
@@ -43,6 +54,22 @@ export declare const makeStyles: (c: ColorTokens) => Readonly<{
     inputMultiline: {
         textAlignVertical: "top";
     };
+    slotDisplay: {
+        alignItems: "center";
+        justifyContent: "center";
+        minWidth: number;
+        minHeight: number;
+    };
+    slotText: {
+        color: string;
+        fontSize: number;
+    };
+    actionFrame: {
+        width: number;
+        height: number;
+        alignItems: "center";
+        justifyContent: "center";
+    };
     errorMsg: {
         fontSize: number;
         color: string;
@@ -53,5 +80,8 @@ export declare const makeStyles: (c: ColorTokens) => Readonly<{
     containerDisabled: {
         opacity: number;
     };
+    rootCentered: {
+        justifyContent: "center";
+    };
 }>;
 //# sourceMappingURL=styles.d.ts.map

package/lib/typescript/src/components/ui/TextField/styles.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/TextField/styles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,yDAAyD;AACzD,eAAO,MAAM,UAAU,GAAI,GAAG,WAAW;;;;;;;;;;;;;;;;;IAkBrC,qEAAqE;;;;;;;;;;;;;;;;;;;;;;IAuBrE,sCAAsC;;;;;;;;;;;;;;EActC,CAAC"}
+{"version":3,"file":"styles.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/TextField/styles.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAElD,yDAAyD;AACzD,eAAO,MAAM,UAAU,GAAI,GAAG,WAAW;;;;;;;;;;;;;IAcrC,+BAA+B;;;;;;;;;;;;;;;IAe/B,qEAAqE;;;;;;;;;;;;;;;;;;;;;;IAuBrE,sCAAsC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAkCtC,CAAC"}

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

@@ -1,27 +1,101 @@
-import type { ReactNode } from 'react';
 import type { StyleProp, TextInputProps, ViewStyle } from 'react-native';
-/** internal — Input / Textarea 共享 props。
- *  caller 不直接消费,通过 InputProps / TextareaProps 间接传入。 */
-export type TextFieldBaseProps = TextInputProps & {
-    /** false(默认)= Input 行为(单行,固定 height);true = Textarea 行为
-     *  (multiline,minHeight/maxHeight 控高,文字顶对齐) */
-    multiline?: boolean;
+import type { IconName } from '../Icon';
+/**
+ * 受控:必须同时给 `value` 和 `onChangeText`。
+ *
+ * `defaultValue?: never` 让「同时传 value 和 defaultValue」在类型层就报错 ——
+ * 那是最常见的受控/非受控混用写法,运行时表现为「defaultValue 被静默忽略」。
+ */
+export type ControlledTextValueProps = {
+    value: string;
+    onChangeText: (value: string) => void;
+    defaultValue?: never;
+};
+/** 非受控:内部持值,`defaultValue` 只在首次 render 读一次。 */
+export type UncontrolledTextValueProps = {
+    value?: never;
+    defaultValue?: string;
+    onChangeText?: (value: string) => void;
+};
+/** internal —— 由 InputProps / TextareaProps / SearchProps 组合进公共类型。 */
+export type TextFieldValueProps = ControlledTextValueProps | UncontrolledTextValueProps;
+/**
+ * 输入类组件对外暴露的 ref。**只有** focus / blur。
+ *
+ * 为什么不暴露原生 TextInput —— `clear()` 会绕过值状态机(受控下把 UI 清空但调用方
+ * state 不变),`setNativeProps()` 能直接改任意原生属性,两者都会让公共契约失效。
+ */
+export type TextFieldHandle = {
+    focus: () => void;
+    blur: () => void;
+};
+/**
+ * 左右 slot 的可验证配置。**不接受任意 ReactNode** ——
+ * 任意节点意味着库无法判断它是装饰还是操作,也无法保证它有可访问名称与 44pt 命中框。
+ */
+export type TextFieldSlot = {
+    kind: 'icon';
+    icon: IconName;
+    size?: number;
+    color?: string;
+} | {
+    kind: 'text';
+    value: string | number;
+} | {
+    kind: 'action';
+    icon: IconName;
+    onPress: () => void;
+    accessibilityLabel: string;
+    disabled?: boolean;
+};
+/**
+ * containerStyle 的可用字段。六个尺寸/裁剪字段被排除 ——
+ * 它们会覆盖 TextField 自持的最小命中框,让输入框缩到碰不到。
+ */
+export type TextFieldContainerStyle = Omit<ViewStyle, 'height' | 'minHeight' | 'maxHeight' | 'minWidth' | 'maxWidth' | 'overflow'>;
+/** internal:Search 把真实交互行与仅作视觉的 surface 明确分层。 */
+export type SearchFieldLayout = {
+    interactiveHeight: number;
+    visibleHeight: number;
+    verticalInset: number;
+};
+/** TextField 家族共享的非值 props(内部)。 */
+export type TextFieldCommonProps = {
+    /** 左侧 slot —— 图标 / 文本 / 带 handler 与名称的操作 */
+    leading?: TextFieldSlot;
+    /** 右侧 slot —— 图标 / 文本 / 带 handler 与名称的操作 */
+    trailing?: TextFieldSlot;
+    /** 错误文案 —— 非空字符串时进入 error 态并在下方显示 */
+    error?: string;
+    /** 整体禁用 —— opacity 0.5 + 不可编辑,优先级高于原生 `editable` */
+    disabled?: boolean;
+    /** 外层容器样式;不接受会破坏最小 frame 的尺寸字段 */
+    containerStyle?: StyleProp<TextFieldContainerStyle>;
+};
+/**
+ * 这些原生 TextInput props 从公共类型删除:
+ * - `style` / `multiline` / `numberOfLines`:由组件自己决定,单行多行分属 Input / Textarea
+ * - `value` / `defaultValue` / `onChangeText`:改由严格判别联合提供
+ * - `aria-disabled` / `readOnly` / `role`:与 `disabled` / `editable` / `accessibilityRole` 重复,
+ *   两条入口同时存在时优先级不可预测
+ * - `enterKeyHint`:与 `returnKeyType` 重复
+ * - `clearTextOnFocus`:绕过值状态机静默清值
+ */
+export type RemovedTextInputProps = 'style' | 'multiline' | 'numberOfLines' | 'value' | 'defaultValue' | 'onChangeText' | 'aria-disabled' | 'readOnly' | 'role' | 'enterKeyHint' | 'clearTextOnFocus';
+/**
+ * internal — TextFieldBase 的严格形状。公开组件在此基础上固定单/多行布局,
+ * 因此不能由未类型化的 native prop 反向覆盖 value、slot 或命中框规则。
+ */
+export type TextFieldBaseProps = Omit<TextInputProps, RemovedTextInputProps> & TextFieldCommonProps & TextFieldValueProps & {
+    /** internal:由 Input / Textarea / Search 固定,不作为公共可选入口。 */
+    multiline: boolean;
     /** 单行 height(multiline=false 时生效),默认 control.lg */
     height?: number;
     /** 最小高度(multiline=true 时生效),默认 96 */
     minHeight?: number;
     /** 最大高度(multiline=true 时生效);超出 ScrollView 内滚 */
     maxHeight?: number;
-    /** 左侧 slot —— Icon / 装饰 */
-    leading?: ReactNode;
-    /** 右侧 slot —— Icon / 操作按钮 */
-    trailing?: ReactNode;
-    /** 错误文案 —— 非空字符串时 wrap border 切 error 色,下方显示文本。
-     *  空串 `""` / undefined 都不进 error 态(truthy 判定)。 */
-    error?: string;
-    /** 整体禁用 —— opacity 0.5 + TextInput editable=false,优先级高于 editable */
-    disabled?: boolean;
-    /** 外层 View 附加 style */
-    containerStyle?: StyleProp<ViewStyle>;
+    /** internal:Search 的 44pt interactive row + 36pt decorative surface。 */
+    searchLayout?: SearchFieldLayout;
 };
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/TextField/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEzE;uDACuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,cAAc,GAAG;IAChD;mDAC+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qCAAqC;IACrC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,2BAA2B;IAC3B,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB;sDACkD;IAClD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,uBAAuB;IACvB,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;CACvC,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/TextField/types.ts"],"names":[],"mappings":"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"}

package/lib/typescript/src/components/ui/TextField/useErrorAnnouncement.d.ts

@@ -0,0 +1,3 @@
+/** iOS 不会像 Android live region 一样自动播报动态错误,仅播报真实的后续变更。 */
+export declare function useErrorAnnouncement(error: string | undefined): void;
+//# sourceMappingURL=useErrorAnnouncement.d.ts.map

package/lib/typescript/src/components/ui/TextField/useErrorAnnouncement.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useErrorAnnouncement.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/TextField/useErrorAnnouncement.ts"],"names":[],"mappings":"AAGA,yDAAyD;AACzD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAsBpE"}

package/lib/typescript/src/components/ui/TextField/useTextFieldValue.d.ts

@@ -0,0 +1,18 @@
+import type { TextFieldValueController } from './valueState';
+export type UseTextFieldValueInput = {
+    value?: unknown;
+    defaultValue?: unknown;
+    onChangeText?: ((value: string) => void) | undefined;
+};
+/**
+ * 把纯值状态机接到 React 上。
+ *
+ * state 放在 ref 而不是 useState:mode 与受控值必须在**本次 render 内**就正确,
+ * 不能等下一次提交 —— 否则受控组件会先渲染一帧旧值。非受控写入用一个递增 tick
+ * 触发重渲染,值本身仍以 ref 为准。
+ *
+ * 诊断只在 effect 里打:render 期打日志在 StrictMode 双调用下会重复,
+ * 且违反 render 必须纯净的约束。
+ */
+export declare function useTextFieldValue({ value, defaultValue, onChangeText }: UseTextFieldValueInput, scope: string): TextFieldValueController;
+//# sourceMappingURL=useTextFieldValue.d.ts.map

package/lib/typescript/src/components/ui/TextField/useTextFieldValue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTextFieldValue.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/TextField/useTextFieldValue.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EACV,wBAAwB,EAGzB,MAAM,cAAc,CAAC;AAatB,MAAM,MAAM,sBAAsB,GAAG;IACnC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,CAAC;CACtD,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,sBAAsB,EAC7D,KAAK,EAAE,MAAM,GACZ,wBAAwB,CAiD1B"}

package/lib/typescript/src/components/ui/TextField/valueState.d.ts

@@ -0,0 +1,50 @@
+/**
+ * TextField 家族的**纯值状态机** —— 无 React 依赖,可直接单测。
+ *
+ * 核心规则:**mode 在首次 render 锁定,之后永不切换**。
+ *
+ * 为什么 —— 受控 / 非受控中途互换是 React 里最难查的一类 bug:光标跳位、输入被回滚、
+ * 表单提交拿到过期值。与其在每次 render 猜测调用方意图,不如锁定一次并在偏离时报诊断。
+ *
+ * mode 判据是 `value !== undefined`,**不是** `'value' in props` 也不是
+ * `typeof value === 'string'`:前者会把 `<Input value={maybeUndefined} />` 这种
+ * 常见写法误判为受控(值一旦为 undefined 就锁死输入),后者对显式 `undefined` 与
+ * 缺省无法区分。显式 `undefined` 一律按非受控处理。
+ */
+export type ValueState = {
+    mode: 'controlled';
+    value: string;
+    /** controlled 下 value 短暂变成 undefined 时用来兜底的最后一个合法字符串。 */
+    lastValidControlledValue: string;
+} | {
+    mode: 'uncontrolled';
+    value: string;
+    lastValidControlledValue?: never;
+};
+export type ValueDiagnostic = 'controlled-to-uncontrolled' | 'uncontrolled-to-controlled' | 'invalid-controlled-value';
+export type ValueTransition = {
+    state: ValueState;
+    value: string;
+    diagnostic?: ValueDiagnostic;
+};
+export type TextFieldValueController = {
+    mode: ValueState['mode'];
+    value: string;
+    /** 是否存在真正能落地的更新入口;false 时 onChangeText 是 no-op。 */
+    canUpdate: boolean;
+    onChangeText: (value: string) => void;
+};
+export declare function createValueState(value: unknown, defaultValue: unknown): ValueState;
+/**
+ * 用本轮 render 的 `value` 与已锁定的 state 对账。返回新 state(不原地修改)、
+ * 本轮应当显示的值,以及偏离锁定 mode 时的诊断。
+ */
+export declare function reconcileValueState(state: ValueState, incomingValue: unknown): ValueTransition;
+/** 用户输入。只有非受控才写内部值;受控的值永远来自调用方。 */
+export declare function applyTextChange(state: ValueState, text: string): ValueState;
+/**
+ * 非受控恒可更新(内部持值);受控只有拿到 `onChangeText` 才可更新 ——
+ * 类型层已要求受控必须带回调,这里兜住未走类型的 JS 调用方。
+ */
+export declare function resolveCanUpdate(mode: ValueState['mode'], onChangeText: ((value: string) => void) | undefined): boolean;
+//# sourceMappingURL=valueState.d.ts.map

package/lib/typescript/src/components/ui/TextField/valueState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valueState.d.ts","sourceRoot":"","sources":["../../../../../../src/components/ui/TextField/valueState.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,MAAM,MAAM,UAAU,GAClB;IACE,IAAI,EAAE,YAAY,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,yDAAyD;IACzD,wBAAwB,EAAE,MAAM,CAAC;CAClC,GACD;IACE,IAAI,EAAE,cAAc,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,wBAAwB,CAAC,EAAE,KAAK,CAAC;CAClC,CAAC;AAEN,MAAM,MAAM,eAAe,GACvB,4BAA4B,GAC5B,4BAA4B,GAC5B,0BAA0B,CAAC;AAE/B,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,SAAS,EAAE,OAAO,CAAC;IACnB,YAAY,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CACvC,CAAC;AAEF,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,YAAY,EAAE,OAAO,GACpB,UAAU,CAaZ;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,UAAU,EACjB,aAAa,EAAE,OAAO,GACrB,eAAe,CAoCjB;AAED,mCAAmC;AACnC,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAG3E;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,EACxB,YAAY,EAAE,CAAC,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS,GAClD,OAAO,CAET"}