@seed-design/lynx-react 0.3.1 → 0.4.1

package/lib/components/Field/Field.d.ts

@@ -0,0 +1,47 @@
+import { NodesRef } from '@lynx-js/types';
+import { FieldVariantProps } from '@seed-design/lynx-css/recipes/field';
+import { FieldLabelVariantProps } from '@seed-design/lynx-css/recipes/field-label';
+import { LynxStyledElementProps } from '../../types';
+import * as React from "@lynx-js/react";
+/**
+ * @platform Lynx
+ *
+ * 웹 대비 미지원 기능:
+ * - HTML label의 `for` 연결과 native form의 `name` 제출 모델
+ * - DOM ARIA id 연결. 입력 컴포넌트에서 `accessibility-label`을 사용해야 함
+ */
+export interface FieldRootProps extends Omit<FieldVariantProps, "empty">, LynxStyledElementProps {
+    required?: boolean;
+    disabled?: boolean;
+    readOnly?: boolean;
+}
+export declare const FieldRoot: React.ForwardRefExoticComponent<FieldRootProps & React.RefAttributes<NodesRef>>;
+export interface FieldHeaderProps extends LynxStyledElementProps {
+}
+export declare const FieldHeader: React.ForwardRefExoticComponent<FieldHeaderProps & React.RefAttributes<unknown>>;
+export interface FieldLabelProps extends FieldLabelVariantProps, LynxStyledElementProps {
+}
+export declare const FieldLabel: React.ForwardRefExoticComponent<FieldLabelProps & React.RefAttributes<unknown>>;
+export interface FieldIndicatorTextProps extends LynxStyledElementProps {
+}
+export declare const FieldIndicatorText: React.ForwardRefExoticComponent<FieldIndicatorTextProps & React.RefAttributes<unknown>>;
+export interface FieldRequiredIndicatorProps extends LynxStyledElementProps {
+}
+export declare const FieldRequiredIndicator: React.ForwardRefExoticComponent<FieldRequiredIndicatorProps & React.RefAttributes<unknown>>;
+export interface FieldFooterProps extends LynxStyledElementProps {
+}
+export declare const FieldFooter: React.ForwardRefExoticComponent<FieldFooterProps & React.RefAttributes<unknown>>;
+export interface FieldDescriptionProps extends LynxStyledElementProps {
+}
+export declare const FieldDescription: React.ForwardRefExoticComponent<FieldDescriptionProps & React.RefAttributes<unknown>>;
+export interface FieldErrorMessageProps extends LynxStyledElementProps {
+}
+export declare const FieldErrorMessage: React.ForwardRefExoticComponent<FieldErrorMessageProps & React.RefAttributes<unknown>>;
+export interface FieldCharacterCountProps extends LynxStyledElementProps {
+    /** 현재 문자 또는 grapheme 수 */
+    current: number;
+    /** 허용하는 최대 문자 또는 grapheme 수 */
+    max: number;
+}
+export declare const FieldCharacterCount: React.ForwardRefExoticComponent<FieldCharacterCountProps & React.RefAttributes<unknown>>;
+//# sourceMappingURL=Field.d.ts.map

package/lib/components/Field/Field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.d.ts","sourceRoot":"","sources":["../../../src/components/Field/Field.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC/C,OAAO,EAAS,KAAK,iBAAiB,EAAE,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAc,KAAK,sBAAsB,EAAE,MAAM,2CAA2C,CAAC;AAGpG,OAAO,KAAK,EAAE,sBAAsB,EAA4B,MAAM,aAAa,CAAC;AAWpF;;;;;;GAMG;AACH,MAAM,WAAW,cAAe,SAAQ,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,EAAE,sBAAsB;IAC9F,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,eAAO,MAAM,SAAS,iFAmDpB,CAAC;AAKH,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;CAAG;AAEnE,eAAO,MAAM,WAAW,kFAatB,CAAC;AAGH,MAAM,WAAW,eAAgB,SAAQ,sBAAsB,EAAE,sBAAsB;CAAG;AAE1F,eAAO,MAAM,UAAU,iFAgBrB,CAAC;AAGH,MAAM,WAAW,uBAAwB,SAAQ,sBAAsB;CAAG;AAE1E,eAAO,MAAM,kBAAkB,yFAgB9B,CAAC;AAGF,MAAM,WAAW,2BAA4B,SAAQ,sBAAsB;CAAG;AAE9E,eAAO,MAAM,sBAAsB,6FAiBlC,CAAC;AAKF,MAAM,WAAW,gBAAiB,SAAQ,sBAAsB;CAAG;AAEnE,eAAO,MAAM,WAAW,kFAatB,CAAC;AAGH,MAAM,WAAW,qBAAsB,SAAQ,sBAAsB;CAAG;AAExE,eAAO,MAAM,gBAAgB,uFAa3B,CAAC;AAGH,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;CAAG;AAEzE,eAAO,MAAM,iBAAiB,wFAa5B,CAAC;AAKH,MAAM,WAAW,wBAAyB,SAAQ,sBAAsB;IACtE,0BAA0B;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,+BAA+B;IAC/B,GAAG,EAAE,MAAM,CAAC;CACb;AAED,eAAO,MAAM,mBAAmB,0FAiB/B,CAAC"}

package/lib/components/Field/Field.jsx

@@ -0,0 +1,121 @@
+import { createSlotRecipeContext } from "../../utils/create-slot-recipe-context.jsx";
+import { FieldContext, useFieldContext } from "./context.js";
+import clsx from "clsx";
+import * as React from "@lynx-js/react";
+import { field } from "@seed-design/lynx-css/recipes/field";
+import { fieldLabel } from "@seed-design/lynx-css/recipes/field-label";
+//#region src/components/Field/Field.tsx
+var { ClassNamesProvider: FieldClassNamesProvider, useClassNames: useFieldClassNames } = createSlotRecipeContext(field);
+var { ClassNamesProvider: FieldLabelClassNamesProvider, useClassNames: useFieldLabelClassNames } = createSlotRecipeContext(fieldLabel);
+var FieldRoot = React.forwardRef((props, forwardedRef) => {
+	const [variantProps, otherProps] = field.splitVariantProps(props);
+	const { children, className, required = false, disabled = false, readOnly = false, ...nativeProps } = otherProps;
+	const invalid = variantProps.invalid ?? false;
+	const [focused, setFocused] = React.useState(false);
+	const rootRef = React.useRef(null);
+	const classes = field({ invalid });
+	const mergedRef = React.useCallback((node) => {
+		"background only";
+		rootRef.current = node;
+		if (typeof forwardedRef === "function") forwardedRef(node);
+		else if (forwardedRef) forwardedRef.current = node;
+	}, [forwardedRef]);
+	const contextValue = React.useMemo(() => ({
+		rootRef,
+		disabled,
+		invalid,
+		readOnly,
+		required,
+		focused,
+		setFocused
+	}), [
+		disabled,
+		focused,
+		invalid,
+		readOnly,
+		required
+	]);
+	return <FieldContext.Provider value={contextValue}>
+      <FieldClassNamesProvider value={classes}>
+        <view ref={mergedRef} className={clsx(classes.root, className)} {...nativeProps}>
+          {children}
+        </view>
+      </FieldClassNamesProvider>
+    </FieldContext.Provider>;
+});
+FieldRoot.displayName = "FieldRoot";
+var FieldHeader = React.forwardRef((props, ref) => {
+	const classes = useFieldClassNames();
+	const { children, className, ...nativeProps } = props;
+	return <view {...ref ? { ref } : {}} className={clsx(classes.header, className)} {...nativeProps}>
+      {children}
+    </view>;
+});
+FieldHeader.displayName = "FieldHeader";
+var FieldLabel = React.forwardRef((props, ref) => {
+	const [variantProps, otherProps] = fieldLabel.splitVariantProps(props);
+	const { children, className, ...nativeProps } = otherProps;
+	const classes = fieldLabel(variantProps);
+	return <FieldLabelClassNamesProvider value={classes}>
+      <text {...ref ? { ref } : {}} className={clsx(classes.root, className)} {...nativeProps}>
+        {children}
+      </text>
+    </FieldLabelClassNamesProvider>;
+});
+FieldLabel.displayName = "FieldLabel";
+var FieldIndicatorText = React.forwardRef((props, ref) => {
+	const classes = useFieldLabelClassNames();
+	const { children, className, ...nativeProps } = props;
+	return <text {...ref ? { ref } : {}} className={clsx(classes.indicatorText, className)} {...nativeProps}>
+        {"\xA0"}
+        {children}
+      </text>;
+});
+FieldIndicatorText.displayName = "FieldIndicatorText";
+var FieldRequiredIndicator = React.forwardRef((props, ref) => {
+	const classes = useFieldLabelClassNames();
+	const { children = "*", className, ...nativeProps } = props;
+	return <text {...ref ? { ref } : {}} accessibility-elements-hidden={true} className={clsx(classes.indicatorIcon, className)} {...nativeProps}>
+        {" "}
+        {children}
+      </text>;
+});
+FieldRequiredIndicator.displayName = "FieldRequiredIndicator";
+var FieldFooter = React.forwardRef((props, ref) => {
+	const classes = useFieldClassNames();
+	const { children, className, ...nativeProps } = props;
+	return <view {...ref ? { ref } : {}} className={clsx(classes.footer, className)} {...nativeProps}>
+      {children}
+    </view>;
+});
+FieldFooter.displayName = "FieldFooter";
+var FieldDescription = React.forwardRef((props, ref) => {
+	const classes = useFieldClassNames();
+	const { children, className, ...nativeProps } = props;
+	return <text {...ref ? { ref } : {}} className={clsx(classes.description, className)} {...nativeProps}>
+      {children}
+    </text>;
+});
+FieldDescription.displayName = "FieldDescription";
+var FieldErrorMessage = React.forwardRef((props, ref) => {
+	const classes = useFieldClassNames();
+	const { children, className, ...nativeProps } = props;
+	return <text {...ref ? { ref } : {}} className={clsx(classes.errorMessage, className)} {...nativeProps}>
+      {children}
+    </text>;
+});
+FieldErrorMessage.displayName = "FieldErrorMessage";
+var FieldCharacterCount = React.forwardRef((props, ref) => {
+	const { current, max, children: _children, className, ...nativeProps } = props;
+	const classes = field({
+		invalid: useFieldContext({ strict: true }).invalid,
+		empty: current === 0
+	});
+	return <view {...ref ? { ref } : {}} className={clsx(classes.characterCountArea, className)} {...nativeProps}>
+        <text className={classes.characterCount}>{current}</text>
+        <text className={classes.maxCharacterCount}>/{max}</text>
+      </view>;
+});
+FieldCharacterCount.displayName = "FieldCharacterCount";
+//#endregion
+export { FieldCharacterCount, FieldDescription, FieldErrorMessage, FieldFooter, FieldHeader, FieldIndicatorText, FieldLabel, FieldRequiredIndicator, FieldRoot };

package/lib/components/Field/Field.namespace.d.ts

@@ -0,0 +1,2 @@
+export { FieldCharacterCount as CharacterCount, FieldDescription as Description, FieldErrorMessage as ErrorMessage, FieldFooter as Footer, FieldHeader as Header, FieldIndicatorText as IndicatorText, FieldLabel as Label, FieldRequiredIndicator as RequiredIndicator, FieldRoot as Root, type FieldCharacterCountProps as CharacterCountProps, type FieldDescriptionProps as DescriptionProps, type FieldErrorMessageProps as ErrorMessageProps, type FieldFooterProps as FooterProps, type FieldHeaderProps as HeaderProps, type FieldIndicatorTextProps as IndicatorTextProps, type FieldLabelProps as LabelProps, type FieldRootProps as RootProps, } from './Field';
+//# sourceMappingURL=Field.namespace.d.ts.map

package/lib/components/Field/Field.namespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Field.namespace.d.ts","sourceRoot":"","sources":["../../../src/components/Field/Field.namespace.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,IAAI,cAAc,EACrC,gBAAgB,IAAI,WAAW,EAC/B,iBAAiB,IAAI,YAAY,EACjC,WAAW,IAAI,MAAM,EACrB,WAAW,IAAI,MAAM,EACrB,kBAAkB,IAAI,aAAa,EACnC,UAAU,IAAI,KAAK,EACnB,sBAAsB,IAAI,iBAAiB,EAC3C,SAAS,IAAI,IAAI,EACjB,KAAK,wBAAwB,IAAI,mBAAmB,EACpD,KAAK,qBAAqB,IAAI,gBAAgB,EAC9C,KAAK,sBAAsB,IAAI,iBAAiB,EAChD,KAAK,gBAAgB,IAAI,WAAW,EACpC,KAAK,gBAAgB,IAAI,WAAW,EACpC,KAAK,uBAAuB,IAAI,kBAAkB,EAClD,KAAK,eAAe,IAAI,UAAU,EAClC,KAAK,cAAc,IAAI,SAAS,GACjC,MAAM,SAAS,CAAC"}

package/lib/components/Field/Field.namespace.js

@@ -0,0 +1,16 @@
+import { __exportAll } from "../../_virtual/_rolldown/runtime.js";
+import { FieldCharacterCount, FieldDescription, FieldErrorMessage, FieldFooter, FieldHeader, FieldIndicatorText, FieldLabel, FieldRequiredIndicator, FieldRoot } from "./Field.jsx";
+//#region src/components/Field/Field.namespace.ts
+var Field_namespace_exports = /* @__PURE__ */ __exportAll({
+	CharacterCount: () => FieldCharacterCount,
+	Description: () => FieldDescription,
+	ErrorMessage: () => FieldErrorMessage,
+	Footer: () => FieldFooter,
+	Header: () => FieldHeader,
+	IndicatorText: () => FieldIndicatorText,
+	Label: () => FieldLabel,
+	RequiredIndicator: () => FieldRequiredIndicator,
+	Root: () => FieldRoot
+});
+//#endregion
+export { Field_namespace_exports };

package/lib/components/Field/context.d.ts

@@ -0,0 +1,19 @@
+import { NodesRef } from '@lynx-js/types';
+import * as React from "@lynx-js/react";
+export interface FieldContextValue {
+    rootRef: React.RefObject<NodesRef | null>;
+    disabled: boolean;
+    invalid: boolean;
+    readOnly: boolean;
+    required: boolean;
+    focused: boolean;
+    setFocused: (focused: boolean) => void;
+}
+export declare const FieldContext: React.Context<FieldContextValue | null>;
+export declare function useFieldContext(options: {
+    strict: true;
+}): FieldContextValue;
+export declare function useFieldContext(options?: {
+    strict?: false;
+}): FieldContextValue | null;
+//# sourceMappingURL=context.d.ts.map

package/lib/components/Field/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/components/Field/context.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,gBAAgB,CAAC;AACxC,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,KAAK,CAAC,SAAS,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC1C,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,CAAC,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,YAAY,yCAAsD,CAAC;AAEhF,wBAAgB,eAAe,CAAC,OAAO,EAAE;IAAE,MAAM,EAAE,IAAI,CAAA;CAAE,GAAG,iBAAiB,CAAC;AAC9E,wBAAgB,eAAe,CAAC,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,KAAK,CAAA;CAAE,GAAG,iBAAiB,GAAG,IAAI,CAAC"}

package/lib/components/Field/context.js

@@ -0,0 +1,10 @@
+import * as React from "@lynx-js/react";
+//#region src/components/Field/context.ts
+var FieldContext = React.createContext(null);
+function useFieldContext(options = {}) {
+	const context = React.useContext(FieldContext);
+	if (options.strict && !context) throw new Error("Field compound components must be rendered inside <Field.Root>.");
+	return context;
+}
+//#endregion
+export { FieldContext, useFieldContext };

package/lib/components/Field/index.d.ts

@@ -0,0 +1,3 @@
+export { FieldCharacterCount, FieldDescription, FieldErrorMessage, FieldFooter, FieldHeader, FieldIndicatorText, FieldLabel, FieldRequiredIndicator, FieldRoot, type FieldCharacterCountProps, type FieldDescriptionProps, type FieldErrorMessageProps, type FieldFooterProps, type FieldHeaderProps, type FieldIndicatorTextProps, type FieldLabelProps, type FieldRootProps, } from './Field';
+export * as Field from './Field.namespace';
+//# sourceMappingURL=index.d.ts.map

package/lib/components/Field/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/Field/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,kBAAkB,EAClB,UAAU,EACV,sBAAsB,EACtB,SAAS,EACT,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,uBAAuB,EAC5B,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB,MAAM,SAAS,CAAC;AAEjB,OAAO,KAAK,KAAK,MAAM,mBAAmB,CAAC"}

package/lib/components/KeyboardAvoidingScrollView/KeyboardAvoidingScrollView.d.ts

@@ -0,0 +1,42 @@
+import { ForwardRefExoticComponent, PropsWithoutRef, RefAttributes } from '@lynx-js/react';
+import { IntrinsicElements, NodesRef } from '@lynx-js/types';
+import { LynxAccessibilityProps, LynxStyledElementProps, LynxTouchProps } from '../../types';
+type NativeScrollViewProps = IntrinsicElements["scroll-view"];
+type LynxForwardRefComponent<T, P> = ForwardRefExoticComponent<PropsWithoutRef<P> & RefAttributes<T>>;
+export type KeyboardAvoidingScrollBehavior = "smooth" | "instant";
+/**
+ * @platform Lynx
+ *
+ * 세로 `<scroll-view>` 안의 활성 입력 요소가 키보드에 가려지지 않도록 한다.
+ * `TextField.Input`과 `TextField.Textarea`는 focus 시 자동으로 이 컴포넌트에 등록된다.
+ *
+ * 현재 미지원 기능:
+ * - 가로 스크롤과 중첩 스크롤
+ * - 키보드 툴바 높이 반영
+ * - 큰 Textarea의 caret 단위 회피
+ */
+export interface KeyboardAvoidingScrollViewProps extends LynxStyledElementProps, LynxAccessibilityProps, LynxTouchProps {
+    id?: NativeScrollViewProps["id"];
+    hidden?: NativeScrollViewProps["hidden"];
+    focusable?: NativeScrollViewProps["focusable"];
+    bounces?: NativeScrollViewProps["bounces"];
+    "enable-scroll"?: NativeScrollViewProps["enable-scroll"];
+    "scroll-bar-enable"?: NativeScrollViewProps["scroll-bar-enable"];
+    "upper-threshold"?: NativeScrollViewProps["upper-threshold"];
+    "lower-threshold"?: NativeScrollViewProps["lower-threshold"];
+    "initial-scroll-offset"?: NativeScrollViewProps["initial-scroll-offset"];
+    "initial-scroll-to-index"?: NativeScrollViewProps["initial-scroll-to-index"];
+    bindlayoutchange?: NativeScrollViewProps["bindlayoutchange"];
+    bindscrolltoupper?: NativeScrollViewProps["bindscrolltoupper"];
+    bindscrolltolower?: NativeScrollViewProps["bindscrolltolower"];
+    bindscroll?: NativeScrollViewProps["bindscroll"];
+    bindscrollend?: NativeScrollViewProps["bindscrollend"];
+    bindcontentsizechanged?: NativeScrollViewProps["bindcontentsizechanged"];
+    /** 키보드와 활성 입력 요소 사이에 확보할 간격(px). @defaultValue 24 */
+    keyboardGap?: number;
+    /** 회피 위치로 이동할 때 사용할 스크롤 방식. @defaultValue "smooth" */
+    scrollBehavior?: KeyboardAvoidingScrollBehavior;
+}
+export declare const KeyboardAvoidingScrollView: LynxForwardRefComponent<NodesRef, KeyboardAvoidingScrollViewProps>;
+export {};
+//# sourceMappingURL=KeyboardAvoidingScrollView.d.ts.map

package/lib/components/KeyboardAvoidingScrollView/KeyboardAvoidingScrollView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KeyboardAvoidingScrollView.d.ts","sourceRoot":"","sources":["../../../src/components/KeyboardAvoidingScrollView/KeyboardAvoidingScrollView.tsx"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,yBAAyB,EAC9B,KAAK,eAAe,EACpB,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAElE,OAAO,KAAK,EACV,sBAAsB,EACtB,sBAAsB,EACtB,cAAc,EAGf,MAAM,aAAa,CAAC;AAMrB,KAAK,qBAAqB,GAAG,iBAAiB,CAAC,aAAa,CAAC,CAAC;AAO9D,KAAK,uBAAuB,CAAC,CAAC,EAAE,CAAC,IAAI,yBAAyB,CAC5D,eAAe,CAAC,CAAC,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CACtC,CAAC;AAEF,MAAM,MAAM,8BAA8B,GAAG,QAAQ,GAAG,SAAS,CAAC;AAoClE;;;;;;;;;;GAUG;AACH,MAAM,WAAW,+BACf,SAAQ,sBAAsB,EAC5B,sBAAsB,EACtB,cAAc;IAChB,EAAE,CAAC,EAAE,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;IAC/C,OAAO,CAAC,EAAE,qBAAqB,CAAC,SAAS,CAAC,CAAC;IAC3C,eAAe,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACzD,mBAAmB,CAAC,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;IACjE,iBAAiB,CAAC,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IAC7D,iBAAiB,CAAC,EAAE,qBAAqB,CAAC,iBAAiB,CAAC,CAAC;IAC7D,uBAAuB,CAAC,EAAE,qBAAqB,CAAC,uBAAuB,CAAC,CAAC;IACzE,yBAAyB,CAAC,EAAE,qBAAqB,CAAC,yBAAyB,CAAC,CAAC;IAC7E,gBAAgB,CAAC,EAAE,qBAAqB,CAAC,kBAAkB,CAAC,CAAC;IAC7D,iBAAiB,CAAC,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;IAC/D,iBAAiB,CAAC,EAAE,qBAAqB,CAAC,mBAAmB,CAAC,CAAC;IAC/D,UAAU,CAAC,EAAE,qBAAqB,CAAC,YAAY,CAAC,CAAC;IACjD,aAAa,CAAC,EAAE,qBAAqB,CAAC,eAAe,CAAC,CAAC;IACvD,sBAAsB,CAAC,EAAE,qBAAqB,CAAC,wBAAwB,CAAC,CAAC;IACzE,qDAAqD;IACrD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,sDAAsD;IACtD,cAAc,CAAC,EAAE,8BAA8B,CAAC;CACjD;AAED,eAAO,MAAM,0BAA0B,EAAE,uBAAuB,CAC9D,QAAQ,EACR,+BAA+B,CA2L/B,CAAC"}

package/lib/components/KeyboardAvoidingScrollView/KeyboardAvoidingScrollView.jsx

@@ -0,0 +1,140 @@
+import { KeyboardAvoidanceActionsContext } from "./context.js";
+import { createKeyboardAvoidingEngine } from "./engine.js";
+import { lynxKeyboardEventSource } from "./keyboard-event-source.js";
+import { lynxKeyboardAvoidingNativeDriver } from "./native-driver.js";
+import { forwardRef, useCallback, useEffect, useMemo, useRef } from "@lynx-js/react";
+//#region src/components/KeyboardAvoidingScrollView/KeyboardAvoidingScrollView.tsx
+var lynxKeyboardAvoidingScheduler = {
+	scheduleFrame(callback) {
+		"background only";
+		const frame = requestAnimationFrame(() => {
+			"background only";
+			callback();
+		});
+		return () => {
+			"background only";
+			cancelAnimationFrame(frame);
+		};
+	},
+	scheduleTimer(callback, delayMs) {
+		"background only";
+		const timer = setTimeout(() => {
+			"background only";
+			callback();
+		}, delayMs);
+		return () => {
+			"background only";
+			clearTimeout(timer);
+		};
+	}
+};
+var spacerProps = {
+	"accessibility-elements-hidden": true,
+	flatten: false
+};
+var KeyboardAvoidingScrollView = forwardRef((props, forwardedRef) => {
+	const { children, keyboardGap = 24, scrollBehavior = "smooth", bindlayoutchange: userBindLayoutChange, bindscroll: userBindScroll, bindscrollend: userBindScrollEnd, bindtouchstart: userBindTouchStart, bindtouchend: userBindTouchEnd, bindtouchcancel: userBindTouchCancel, ...nativeProps } = props;
+	const scrollRef = useRef(null);
+	const spacerRef = useRef(null);
+	const keyboardGapRef = useRef(keyboardGap);
+	const committedKeyboardGapRef = useRef(keyboardGap);
+	const scrollBehaviorRef = useRef(scrollBehavior);
+	const touchActiveRef = useRef(false);
+	const didScrollDuringTouchRef = useRef(false);
+	keyboardGapRef.current = keyboardGap;
+	scrollBehaviorRef.current = scrollBehavior;
+	const engine = useMemo(() => createKeyboardAvoidingEngine({
+		driver: lynxKeyboardAvoidingNativeDriver,
+		scheduler: lynxKeyboardAvoidingScheduler,
+		getScrollNode: () => scrollRef.current,
+		getSpacerNode: () => spacerRef.current,
+		getKeyboardGap: () => keyboardGapRef.current,
+		getToolbarHeight: () => 0,
+		getSmooth: () => scrollBehaviorRef.current === "smooth"
+	}), []);
+	const mergedRef = useCallback((node) => {
+		"background only";
+		scrollRef.current = node;
+		if (typeof forwardedRef === "function") forwardedRef(node);
+		else if (forwardedRef) forwardedRef.current = node;
+	}, [forwardedRef]);
+	const actions = useMemo(() => ({
+		focus(registration) {
+			"background only";
+			engine.focus(registration);
+		},
+		blur(owner) {
+			"background only";
+			engine.blur(owner);
+		},
+		layoutChanged(owner) {
+			"background only";
+			engine.layoutChanged(owner);
+		},
+		unregister(owner) {
+			"background only";
+			engine.unregister(owner);
+		}
+	}), [engine]);
+	useEffect(() => {
+		const unsubscribe = lynxKeyboardEventSource.subscribe((state) => {
+			"background only";
+			engine.keyboardChanged(state);
+		});
+		return () => {
+			unsubscribe();
+			engine.dispose();
+		};
+	}, [engine]);
+	useEffect(() => {
+		if (Object.is(committedKeyboardGapRef.current, keyboardGap)) return;
+		committedKeyboardGapRef.current = keyboardGap;
+		engine.viewportChanged();
+	}, [engine, keyboardGap]);
+	const handleLayoutChange = useCallback((...args) => {
+		"background only";
+		engine.viewportChanged();
+		userBindLayoutChange?.(...args);
+	}, [engine, userBindLayoutChange]);
+	const handleTouchStart = useCallback((...args) => {
+		"background only";
+		touchActiveRef.current = true;
+		didScrollDuringTouchRef.current = false;
+		engine.userScrollStarted();
+		userBindTouchStart?.(...args);
+	}, [engine, userBindTouchStart]);
+	const handleScroll = useCallback((...args) => {
+		"background only";
+		if (touchActiveRef.current) didScrollDuringTouchRef.current = true;
+		userBindScroll?.(...args);
+	}, [userBindScroll]);
+	const handleTouchEnd = useCallback((...args) => {
+		"background only";
+		touchActiveRef.current = false;
+		if (!didScrollDuringTouchRef.current) engine.userScrollEnded();
+		userBindTouchEnd?.(...args);
+	}, [engine, userBindTouchEnd]);
+	const handleTouchCancel = useCallback((...args) => {
+		"background only";
+		touchActiveRef.current = false;
+		didScrollDuringTouchRef.current = false;
+		engine.userScrollEnded();
+		userBindTouchCancel?.(...args);
+	}, [engine, userBindTouchCancel]);
+	const handleScrollEnd = useCallback((...args) => {
+		"background only";
+		touchActiveRef.current = false;
+		didScrollDuringTouchRef.current = false;
+		engine.userScrollEnded();
+		userBindScrollEnd?.(...args);
+	}, [engine, userBindScrollEnd]);
+	return <KeyboardAvoidanceActionsContext.Provider value={actions}>
+      <scroll-view {...nativeProps} ref={mergedRef} scroll-orientation="vertical" flatten={false} bindlayoutchange={handleLayoutChange} bindtouchstart={handleTouchStart} bindtouchend={handleTouchEnd} bindtouchcancel={handleTouchCancel} bindscroll={handleScroll} bindscrollend={handleScrollEnd}>
+        {children}
+        <view {...{ ref: spacerRef }} {...spacerProps} />
+      </scroll-view>
+    </KeyboardAvoidanceActionsContext.Provider>;
+});
+KeyboardAvoidingScrollView.displayName = "KeyboardAvoidingScrollView";
+//#endregion
+export { KeyboardAvoidingScrollView };

package/lib/components/KeyboardAvoidingScrollView/context.d.ts

@@ -0,0 +1,17 @@
+import { Context } from '@lynx-js/react';
+import { NodesRef } from '@lynx-js/types';
+import { KeyboardAvoidanceRegistration as EngineRegistration } from './engine';
+export type KeyboardAvoidanceRegistration = EngineRegistration<NodesRef>;
+export interface KeyboardAvoidanceActions {
+    focus(registration: KeyboardAvoidanceRegistration): void;
+    blur(owner: object): void;
+    layoutChanged(owner: object): void;
+    unregister(owner: object): void;
+}
+export declare const KeyboardAvoidanceActionsContext: Context<KeyboardAvoidanceActions | null>;
+/**
+ * Lynx TextField가 선택적으로 소비하는 내부 연결점이다.
+ * Provider 밖에서는 `null`을 반환해 TextField 자체 동작을 방해하지 않는다.
+ */
+export declare function useKeyboardAvoidanceActions(): KeyboardAvoidanceActions | null;
+//# sourceMappingURL=context.d.ts.map

package/lib/components/KeyboardAvoidingScrollView/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/components/KeyboardAvoidingScrollView/context.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,KAAK,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,OAAO,KAAK,EAAE,6BAA6B,IAAI,kBAAkB,EAAE,MAAM,UAAU,CAAC;AAEpF,MAAM,MAAM,6BAA6B,GAAG,kBAAkB,CAAC,QAAQ,CAAC,CAAC;AAEzE,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,YAAY,EAAE,6BAA6B,GAAG,IAAI,CAAC;IACzD,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACjC;AAED,eAAO,MAAM,+BAA+B,EAAE,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAC/B,CAAC;AAEvD;;;GAGG;AACH,wBAAgB,2BAA2B,IAAI,wBAAwB,GAAG,IAAI,CAE7E"}

package/lib/components/KeyboardAvoidingScrollView/context.js

@@ -0,0 +1,12 @@
+import { createContext, useContext } from "@lynx-js/react";
+//#region src/components/KeyboardAvoidingScrollView/context.ts
+var KeyboardAvoidanceActionsContext = createContext(null);
+/**
+* Lynx TextField가 선택적으로 소비하는 내부 연결점이다.
+* Provider 밖에서는 `null`을 반환해 TextField 자체 동작을 방해하지 않는다.
+*/
+function useKeyboardAvoidanceActions() {
+	return useContext(KeyboardAvoidanceActionsContext);
+}
+//#endregion
+export { KeyboardAvoidanceActionsContext, useKeyboardAvoidanceActions };

package/lib/components/KeyboardAvoidingScrollView/engine.d.ts

@@ -0,0 +1,50 @@
+import { VerticalRect } from './geometry';
+import { KeyboardOcclusion, RawKeyboardState, ScrollMetrics } from './native-driver';
+export interface RefLike<Node> {
+    current: Node | null;
+}
+export interface KeyboardAvoidanceRegistration<Node> {
+    owner: object;
+    nativeRef: RefLike<Node>;
+    controlRef?: RefLike<Node>;
+    fieldRef?: RefLike<Node>;
+    anchorRef?: RefLike<Node>;
+    enabled?: boolean;
+}
+export interface KeyboardAvoidingNativeDriver<Node> {
+    measure(node: Node): Promise<VerticalRect | null>;
+    resolveKeyboardOcclusion(state: RawKeyboardState): Promise<KeyboardOcclusion | null>;
+    setSpacerHeight(node: Node, height: number): void;
+    waitForLayout(): Promise<void>;
+    getScrollMetrics(node: Node, viewportHeight: number): Promise<ScrollMetrics | null>;
+    scrollTo(node: Node, offset: number, smooth: boolean): void;
+}
+type ScheduledCallback = () => void | Promise<void>;
+type CancelScheduledCallback = () => void;
+export interface KeyboardAvoidingScheduler {
+    scheduleFrame(callback: ScheduledCallback): CancelScheduledCallback;
+    scheduleTimer(callback: ScheduledCallback, delayMs: number): CancelScheduledCallback;
+}
+export interface KeyboardAvoidingEngineOptions<Node> {
+    driver: KeyboardAvoidingNativeDriver<Node>;
+    scheduler: KeyboardAvoidingScheduler;
+    getScrollNode(): Node | null;
+    getSpacerNode(): Node | null;
+    getKeyboardGap(): number;
+    getToolbarHeight(): number;
+    getSmooth(): boolean;
+}
+export interface KeyboardAvoidingEngine<Node> {
+    focus(registration: KeyboardAvoidanceRegistration<Node>): void;
+    blur(owner: object): void;
+    layoutChanged(owner: object): void;
+    unregister(owner: object): void;
+    keyboardChanged(state: RawKeyboardState): void;
+    viewportChanged(): void;
+    userScrollStarted(): void;
+    userScrollEnded(): void;
+    dispose(): void;
+}
+export declare function createKeyboardAvoidingEngine<Node>(options: KeyboardAvoidingEngineOptions<Node>): KeyboardAvoidingEngine<Node>;
+export {};
+//# sourceMappingURL=engine.d.ts.map

package/lib/components/KeyboardAvoidingScrollView/engine.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.d.ts","sourceRoot":"","sources":["../../../src/components/KeyboardAvoidingScrollView/engine.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,YAAY,EAClB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAI1F,MAAM,WAAW,OAAO,CAAC,IAAI;IAC3B,OAAO,EAAE,IAAI,GAAG,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,6BAA6B,CAAC,IAAI;IACjD,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,UAAU,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3B,QAAQ,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACzB,SAAS,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,4BAA4B,CAAC,IAAI;IAChD,OAAO,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAClD,wBAAwB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAAC;IACrF,eAAe,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAClD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IACpF,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,IAAI,CAAC;CAC7D;AAED,KAAK,iBAAiB,GAAG,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AACpD,KAAK,uBAAuB,GAAG,MAAM,IAAI,CAAC;AAE1C,MAAM,WAAW,yBAAyB;IACxC,aAAa,CAAC,QAAQ,EAAE,iBAAiB,GAAG,uBAAuB,CAAC;IACpE,aAAa,CAAC,QAAQ,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,GAAG,uBAAuB,CAAC;CACtF;AAED,MAAM,WAAW,6BAA6B,CAAC,IAAI;IACjD,MAAM,EAAE,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAC3C,SAAS,EAAE,yBAAyB,CAAC;IACrC,aAAa,IAAI,IAAI,GAAG,IAAI,CAAC;IAC7B,aAAa,IAAI,IAAI,GAAG,IAAI,CAAC;IAC7B,cAAc,IAAI,MAAM,CAAC;IACzB,gBAAgB,IAAI,MAAM,CAAC;IAC3B,SAAS,IAAI,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB,CAAC,IAAI;IAC1C,KAAK,CAAC,YAAY,EAAE,6BAA6B,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,eAAe,CAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAC/C,eAAe,IAAI,IAAI,CAAC;IACxB,iBAAiB,IAAI,IAAI,CAAC;IAC1B,eAAe,IAAI,IAAI,CAAC;IACxB,OAAO,IAAI,IAAI,CAAC;CACjB;AA4VD,wBAAgB,4BAA4B,CAAC,IAAI,EAC/C,OAAO,EAAE,6BAA6B,CAAC,IAAI,CAAC,GAC3C,sBAAsB,CAAC,IAAI,CAAC,CAE9B"}