diff --git a/.changeset/browser-hook-return-shapes.md b/.changeset/browser-hook-return-shapes.md
new file mode 100644
index 00000000..54a12c06
--- /dev/null
+++ b/.changeset/browser-hook-return-shapes.md
@@ -0,0 +1,5 @@
+---
+'react-simplikit': major
+---
+
+`useKeyboardHeight`, `useVisualViewport`, and `useAvoidKeyboard` now return their single value directly instead of wrapping it in an object.
diff --git a/AGENTS.md b/AGENTS.md
index 4e92374c..2957bc36 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -118,7 +118,7 @@ Never initialize state with browser API calls (causes hydration mismatch).
 - **Single value**: `useDebounce<T>(value, delay): T`
 - **Tuple** (2 items): `useToggle(init): [boolean, () => void]`
 - **Object** (3+ items): `usePagination(): { page, nextPage, prevPage }`
-- **Object** also when the shape is expected to grow: `useKeyboardHeight(): { keyboardHeight }`
+- **Single value** for browser measurements: `useKeyboardHeight(): number`
 
 ## Testing
 
diff --git a/CLAUDE.md b/CLAUDE.md
index 2809c868..a85581a3 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -91,7 +91,7 @@ Never initialize state with browser API calls (causes hydration mismatch).
 - **Single value**: `useDebounce<T>(value, delay): T`
 - **Tuple** (state + action, 2 items): `useToggle(init): [boolean, () => void]`
 - **Object** (3+ items): `usePagination(): { page, nextPage, prevPage }`
-- **Object** also when the shape is expected to grow: browser measurements such as `useKeyboardHeight(): { keyboardHeight }`
+- **Single value** for browser measurements: `useKeyboardHeight(): number`
 
 ### Performance Patterns
 
diff --git a/README-es.md b/README-es.md
index 453cd87b..d8504889 100644
--- a/README-es.md
+++ b/README-es.md
@@ -66,7 +66,7 @@ Aplica el estilo que devuelve `useAvoidKeyboard` para mover un campo de entrada
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div style={{ position: 'fixed', bottom: 0, left: 0, right: 0, ...style }}>
diff --git a/README-ja_jp.md b/README-ja_jp.md
index db011d3a..860aa283 100644
--- a/README-ja_jp.md
+++ b/README-ja_jp.md
@@ -66,7 +66,7 @@ function SearchInput() {
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div style={{ position: 'fixed', bottom: 0, left: 0, right: 0, ...style }}>
diff --git a/README-ko_kr.md b/README-ko_kr.md
index ddf50d89..bca8dc52 100644
--- a/README-ko_kr.md
+++ b/README-ko_kr.md
@@ -66,7 +66,7 @@ function SearchInput() {
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div style={{ position: 'fixed', bottom: 0, left: 0, right: 0, ...style }}>
diff --git a/README-zh_hans.md b/README-zh_hans.md
index cd39697c..e0e3ead2 100644
--- a/README-zh_hans.md
+++ b/README-zh_hans.md
@@ -66,7 +66,7 @@ function SearchInput() {
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div style={{ position: 'fixed', bottom: 0, left: 0, right: 0, ...style }}>
diff --git a/README.md b/README.md
index 5f317b5e..b6c4b2bd 100644
--- a/README.md
+++ b/README.md
@@ -66,7 +66,7 @@ Use the style returned by `useAvoidKeyboard` to move a fixed input above the on-
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div style={{ position: 'fixed', bottom: 0, left: 0, right: 0, ...style }}>
diff --git a/docs/es/mobile-web.md b/docs/es/mobile-web.md
index 4684f0e1..7e3c9b2a 100644
--- a/docs/es/mobile-web.md
+++ b/docs/es/mobile-web.md
@@ -34,7 +34,7 @@ Este ejemplo mantiene un botón fijado en la parte inferior por encima del tecla
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -61,7 +61,7 @@ import { useState } from 'react';
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
   const [message, setMessage] = useState('');
 
   return (
@@ -98,7 +98,7 @@ En los dispositivos con indicador de inicio (como el iPhone), puedes añadir un
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/docs/ja/mobile-web.md b/docs/ja/mobile-web.md
index c012888e..29442ce6 100644
--- a/docs/ja/mobile-web.md
+++ b/docs/ja/mobile-web.md
@@ -34,7 +34,7 @@ npm install react-simplikit
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -61,7 +61,7 @@ import { useState } from 'react';
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
   const [message, setMessage] = useState('');
 
   return (
@@ -98,7 +98,7 @@ function ChatInput() {
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/docs/ko/mobile-web.md b/docs/ko/mobile-web.md
index 10d16ead..8d785837 100644
--- a/docs/ko/mobile-web.md
+++ b/docs/ko/mobile-web.md
@@ -34,7 +34,7 @@ npm install react-simplikit
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -61,7 +61,7 @@ import { useState } from 'react';
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
   const [message, setMessage] = useState('');
 
   return (
@@ -98,7 +98,7 @@ function ChatInput() {
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/docs/mobile-web.md b/docs/mobile-web.md
index a93490b8..f69d4ef5 100644
--- a/docs/mobile-web.md
+++ b/docs/mobile-web.md
@@ -34,7 +34,7 @@ This example keeps a fixed bottom button above the keyboard.
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -61,7 +61,7 @@ import { useState } from 'react';
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
   const [message, setMessage] = useState('');
 
   return (
@@ -98,7 +98,7 @@ For devices with home indicators (like iPhone), you can add a safe area offset:
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/docs/zh-Hans/mobile-web.md b/docs/zh-Hans/mobile-web.md
index 15e03d7f..2c1f5f39 100644
--- a/docs/zh-Hans/mobile-web.md
+++ b/docs/zh-Hans/mobile-web.md
@@ -34,7 +34,7 @@ npm install react-simplikit
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -61,7 +61,7 @@ import { useState } from 'react';
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function ChatInput() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
   const [message, setMessage] = useState('');
 
   return (
@@ -98,7 +98,7 @@ function ChatInput() {
 import { useAvoidKeyboard } from 'react-simplikit';
 
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/examples/with-vite/src/pages/demos/UseVisualViewportDemo.tsx b/examples/with-vite/src/pages/demos/UseVisualViewportDemo.tsx
index d67defd2..1a6d26ed 100644
--- a/examples/with-vite/src/pages/demos/UseVisualViewportDemo.tsx
+++ b/examples/with-vite/src/pages/demos/UseVisualViewportDemo.tsx
@@ -7,7 +7,7 @@ import { DemoLayout } from '../../components/DemoLayout.tsx';
 const EXAMPLE_CODE = `import { useVisualViewport } from 'react-simplikit';
 
 function CustomLayout() {
-  const { viewport } = useVisualViewport();
+  const viewport = useVisualViewport();
 
   if (!viewport) {
     return <div>Not supported</div>;
@@ -28,7 +28,7 @@ function CustomLayout() {
 }`;
 
 export function UseVisualViewportDemo() {
-  const { viewport } = useVisualViewport();
+  const viewport = useVisualViewport();
   const [inputValue, setInputValue] = useState('');
 
   if (!viewport) {
diff --git a/packages/plugin/skills/react-simplikit/references/useAvoidKeyboard.md b/packages/plugin/skills/react-simplikit/references/useAvoidKeyboard.md
index 9f3cc571..927842b5 100644
--- a/packages/plugin/skills/react-simplikit/references/useAvoidKeyboard.md
+++ b/packages/plugin/skills/react-simplikit/references/useAvoidKeyboard.md
@@ -7,9 +7,7 @@ to smoothly move them above the keyboard when it appears.
 ## Interface
 
 ```ts
-function useAvoidKeyboard(
-  options?: UseAvoidKeyboardOptions
-): UseAvoidKeyboardResult;
+function useAvoidKeyboard(options?: UseAvoidKeyboardOptions): CSSProperties;
 ```
 
 ### Parameters
@@ -55,24 +53,15 @@ function useAvoidKeyboard(
 
 <Interface
   name=""
-  type="UseAvoidKeyboardResult"
-  description="An object containing the CSS style for keyboard avoidance."
-  :nested="[
-    {
-      name: 'style',
-      type: 'CSSProperties',
-      required: false,
-      description:
-        'CSS style object to apply to the fixed bottom element. Contains <code>transform</code> and <code>transition</code> properties.',
-    },
-  ]"
+  type="CSSProperties"
+  description="The CSS style to apply to the fixed bottom element. Contains <code>transform</code> and <code>transition</code> properties."
 />
 
 ## Example
 
 ```tsx
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -93,7 +82,7 @@ function FixedBottomCTA() {
 ```tsx
 // With safe area bottom offset (e.g., for iPhone home indicator)
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/packages/plugin/skills/react-simplikit/references/useKeyboardHeight.md b/packages/plugin/skills/react-simplikit/references/useKeyboardHeight.md
index 09d3618a..47fd8ddb 100644
--- a/packages/plugin/skills/react-simplikit/references/useKeyboardHeight.md
+++ b/packages/plugin/skills/react-simplikit/references/useKeyboardHeight.md
@@ -7,9 +7,7 @@ when the keyboard appears, disappears, or changes size.
 ## Interface
 
 ```ts
-function useKeyboardHeight(
-  options?: UseKeyboardHeightOptions
-): UseKeyboardHeightResult;
+function useKeyboardHeight(options?: UseKeyboardHeightOptions): number;
 ```
 
 ### Parameters
@@ -33,24 +31,15 @@ function useKeyboardHeight(
 
 <Interface
   name=""
-  type="UseKeyboardHeightResult"
-  description="An object containing the current keyboard height."
-  :nested="[
-    {
-      name: 'keyboardHeight',
-      type: 'number',
-      required: false,
-      description:
-        'The current keyboard height in pixels. 0 when the keyboard is hidden.',
-    },
-  ]"
+  type="number"
+  description="The current keyboard height in pixels. 0 when the keyboard is hidden."
 />
 
 ## Example
 
 ```tsx
 function ChatInput() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div style={{ paddingBottom: `${keyboardHeight}px` }}>
@@ -62,7 +51,7 @@ function ChatInput() {
 
 ```tsx
 function KeyboardStatus() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div>
diff --git a/packages/plugin/skills/react-simplikit/references/useVisualViewport.md b/packages/plugin/skills/react-simplikit/references/useVisualViewport.md
index ad328709..7581371e 100644
--- a/packages/plugin/skills/react-simplikit/references/useVisualViewport.md
+++ b/packages/plugin/skills/react-simplikit/references/useVisualViewport.md
@@ -7,7 +7,7 @@ the keyboard appears or the user zooms/scrolls.
 ## Interface
 
 ```ts
-function useVisualViewport(): { viewport: VisualViewportState | null };
+function useVisualViewport(): VisualViewportState | null;
 ```
 
 ### Parameters
@@ -18,44 +18,37 @@ This function does not accept any parameters.
 
 <Interface
   name=""
-  type="{ viewport: VisualViewportState | null }"
-  description="An object containing the Visual Viewport state."
+  type="VisualViewportState | null"
+  description="The Visual Viewport state, or <code>null</code> if not supported (SSR or browsers without the Visual Viewport API);"
   :nested="[
     {
-      name: 'viewport',
-      type: 'VisualViewportState | null',
-      required: false,
-      description:
-        'Visual Viewport state object, or <code>null</code> if not supported (SSR or browsers without the Visual Viewport API).',
-    },
-    {
-      name: 'viewport.width',
+      name: 'width',
       type: 'number',
       required: false,
       description: 'Viewport width in pixels.',
     },
     {
-      name: 'viewport.height',
+      name: 'height',
       type: 'number',
       required: false,
       description: 'Viewport height in pixels.',
     },
     {
-      name: 'viewport.offsetLeft',
+      name: 'offsetLeft',
       type: 'number',
       required: false,
       description:
         'Viewport left offset in pixels from the layout viewport. Typically 0 unless horizontal scrolling or panning occurs.',
     },
     {
-      name: 'viewport.offsetTop',
+      name: 'offsetTop',
       type: 'number',
       required: false,
       description:
         'Viewport top offset in pixels from the layout viewport. Becomes negative on iOS when the keyboard appears (e.g., -300px means a 300px keyboard), so use <code>-offsetTop</code> for the keyboard height. Typically remains 0 on Android.',
     },
     {
-      name: 'viewport.scale',
+      name: 'scale',
       type: 'number',
       required: false,
       description:
@@ -68,7 +61,7 @@ This function does not accept any parameters.
 
 ```tsx
 function CustomLayout() {
-  const { viewport } = useVisualViewport();
+  const viewport = useVisualViewport();
 
   // Always check for null first
   if (!viewport) {
@@ -92,7 +85,7 @@ function CustomLayout() {
 ### Detecting zoom
 
 ```tsx
-const { viewport } = useVisualViewport();
+const viewport = useVisualViewport();
 if (viewport && viewport.scale > 1.3) {
   // Hide floating UI when user zooms in
   setShowFloatingButton(false);
diff --git a/packages/react-simplikit/src/hooks/useAvoidKeyboard/es/useAvoidKeyboard.md b/packages/react-simplikit/src/hooks/useAvoidKeyboard/es/useAvoidKeyboard.md
index 86b14d1c..84162ccd 100644
--- a/packages/react-simplikit/src/hooks/useAvoidKeyboard/es/useAvoidKeyboard.md
+++ b/packages/react-simplikit/src/hooks/useAvoidKeyboard/es/useAvoidKeyboard.md
@@ -7,9 +7,7 @@ para desplazarlos suavemente por encima del teclado cuando aparece.
 ## Interfaz
 
 ```ts
-function useAvoidKeyboard(
-  options?: UseAvoidKeyboardOptions
-): UseAvoidKeyboardResult;
+function useAvoidKeyboard(options?: UseAvoidKeyboardOptions): CSSProperties;
 ```
 
 ### Parámetros
@@ -55,24 +53,15 @@ function useAvoidKeyboard(
 
 <Interface
   name=""
-  type="UseAvoidKeyboardResult"
-  description="Un objeto que contiene el estilo CSS para evitar que el teclado cubra el elemento."
-  :nested="[
-    {
-      name: 'style',
-      type: 'CSSProperties',
-      required: false,
-      description:
-        'Objeto de estilo CSS que puedes aplicar al elemento fijo en la parte inferior. Contiene las propiedades <code>transform</code> y <code>transition</code>.',
-    },
-  ]"
+  type="CSSProperties"
+  description="Objeto de estilo CSS que puedes aplicar al elemento fijo en la parte inferior. Contiene las propiedades <code>transform</code> y <code>transition</code>."
 />
 
 ## Ejemplo
 
 ```tsx
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -93,7 +82,7 @@ function FixedBottomCTA() {
 ```tsx
 // Con desplazamiento inferior del área segura (p. ej., para el indicador de inicio del iPhone)
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/packages/react-simplikit/src/hooks/useAvoidKeyboard/ja/useAvoidKeyboard.md b/packages/react-simplikit/src/hooks/useAvoidKeyboard/ja/useAvoidKeyboard.md
index 2da266b3..1ddfbde1 100644
--- a/packages/react-simplikit/src/hooks/useAvoidKeyboard/ja/useAvoidKeyboard.md
+++ b/packages/react-simplikit/src/hooks/useAvoidKeyboard/ja/useAvoidKeyboard.md
@@ -7,9 +7,7 @@
 ## インターフェース
 
 ```ts
-function useAvoidKeyboard(
-  options?: UseAvoidKeyboardOptions
-): UseAvoidKeyboardResult;
+function useAvoidKeyboard(options?: UseAvoidKeyboardOptions): CSSProperties;
 ```
 
 ### パラメータ
@@ -55,24 +53,15 @@ function useAvoidKeyboard(
 
 <Interface
   name=""
-  type="UseAvoidKeyboardResult"
-  description="キーボードとの重なりを避けるための CSS スタイルを含むオブジェクト。"
-  :nested="[
-    {
-      name: 'style',
-      type: 'CSSProperties',
-      required: false,
-      description:
-        '画面下部に固定された要素に適用する CSS スタイルオブジェクトです。<code>transform</code> と <code>transition</code> プロパティを含みます。',
-    },
-  ]"
+  type="CSSProperties"
+  description="画面下部に固定された要素に適用する CSS スタイルオブジェクトです。<code>transform</code> と <code>transition</code> プロパティを含みます。"
 />
 
 ## 使用例
 
 ```tsx
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -93,7 +82,7 @@ function FixedBottomCTA() {
 ```tsx
 // セーフエリアの下端オフセットを指定する場合（例：iPhone のホームインジケーター）
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/packages/react-simplikit/src/hooks/useAvoidKeyboard/ko/useAvoidKeyboard.md b/packages/react-simplikit/src/hooks/useAvoidKeyboard/ko/useAvoidKeyboard.md
index 70807a75..10700b1c 100644
--- a/packages/react-simplikit/src/hooks/useAvoidKeyboard/ko/useAvoidKeyboard.md
+++ b/packages/react-simplikit/src/hooks/useAvoidKeyboard/ko/useAvoidKeyboard.md
@@ -5,9 +5,7 @@
 ## 인터페이스
 
 ```ts
-function useAvoidKeyboard(
-  options?: UseAvoidKeyboardOptions
-): UseAvoidKeyboardResult;
+function useAvoidKeyboard(options?: UseAvoidKeyboardOptions): CSSProperties;
 ```
 
 ### 파라미터
@@ -54,24 +52,15 @@ function useAvoidKeyboard(
 
 <Interface
   name=""
-  type="UseAvoidKeyboardResult"
-  description="키보드 회피를 위한 CSS 스타일을 담은 객체예요."
-  :nested="[
-    {
-      name: 'style',
-      type: 'CSSProperties',
-      required: false,
-      description:
-        '하단 고정 요소에 적용할 CSS 스타일 객체예요. <code>transform</code>과 <code>transition</code> 속성을 포함해요.',
-    },
-  ]"
+  type="CSSProperties"
+  description="하단 고정 요소에 적용할 CSS 스타일 객체예요. <code>transform</code>과 <code>transition</code> 속성을 포함해요."
 />
 
 ## 예시
 
 ```tsx
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -92,7 +81,7 @@ function FixedBottomCTA() {
 ```tsx
 // iPhone 홈 인디케이터 오프셋을 포함한 예시
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.md b/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.md
index 9f3cc571..927842b5 100644
--- a/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.md
+++ b/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.md
@@ -7,9 +7,7 @@ to smoothly move them above the keyboard when it appears.
 ## Interface
 
 ```ts
-function useAvoidKeyboard(
-  options?: UseAvoidKeyboardOptions
-): UseAvoidKeyboardResult;
+function useAvoidKeyboard(options?: UseAvoidKeyboardOptions): CSSProperties;
 ```
 
 ### Parameters
@@ -55,24 +53,15 @@ function useAvoidKeyboard(
 
 <Interface
   name=""
-  type="UseAvoidKeyboardResult"
-  description="An object containing the CSS style for keyboard avoidance."
-  :nested="[
-    {
-      name: 'style',
-      type: 'CSSProperties',
-      required: false,
-      description:
-        'CSS style object to apply to the fixed bottom element. Contains <code>transform</code> and <code>transition</code> properties.',
-    },
-  ]"
+  type="CSSProperties"
+  description="The CSS style to apply to the fixed bottom element. Contains <code>transform</code> and <code>transition</code> properties."
 />
 
 ## Example
 
 ```tsx
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -93,7 +82,7 @@ function FixedBottomCTA() {
 ```tsx
 // With safe area bottom offset (e.g., for iPhone home indicator)
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.test.ts b/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.test.ts
index 7be61af9..38ae9330 100644
--- a/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.test.ts
+++ b/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.test.ts
@@ -5,7 +5,7 @@ import { useAvoidKeyboard } from './useAvoidKeyboard.ts';
 
 // Mock useKeyboardHeight hook
 vi.mock('../useKeyboardHeight/useKeyboardHeight.ts', () => ({
-  useKeyboardHeight: vi.fn(() => ({ keyboardHeight: 0 })),
+  useKeyboardHeight: vi.fn(() => 0),
 }));
 
 // Get reference to the mocked function
@@ -14,7 +14,7 @@ const mockUseKeyboardHeight = vi.mocked(useKeyboardHeight);
 
 describe('useAvoidKeyboard', () => {
   beforeEach(() => {
-    mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 0 });
+    mockUseKeyboardHeight.mockReturnValue(0);
   });
 
   afterEach(() => {
@@ -25,7 +25,7 @@ describe('useAvoidKeyboard', () => {
     it('should return initial style with keyboard hidden', () => {
       const { result } = renderHook(() => useAvoidKeyboard());
 
-      expect(result.current.style).toEqual({
+      expect(result.current).toEqual({
         transform: 'translateY(0px)',
         transition: 'transform 200ms ease-out',
       });
@@ -34,22 +34,22 @@ describe('useAvoidKeyboard', () => {
 
   describe('style generation', () => {
     it('should generate correct transform when keyboard is visible', () => {
-      mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 300 });
+      mockUseKeyboardHeight.mockReturnValue(300);
 
       const { result } = renderHook(() => useAvoidKeyboard());
 
-      expect(result.current.style).toEqual({
+      expect(result.current).toEqual({
         transform: 'translateY(-300px)',
         transition: 'transform 200ms ease-out',
       });
     });
 
     it('should include safeAreaBottom in transform calculation', () => {
-      mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 300 });
+      mockUseKeyboardHeight.mockReturnValue(300);
 
       const { result } = renderHook(() => useAvoidKeyboard({ safeAreaBottom: 20 }));
 
-      expect(result.current.style).toEqual({
+      expect(result.current).toEqual({
         transform: 'translateY(-320px)',
         transition: 'transform 200ms ease-out',
       });
@@ -58,7 +58,7 @@ describe('useAvoidKeyboard', () => {
     it('should apply custom transition duration', () => {
       const { result } = renderHook(() => useAvoidKeyboard({ transitionDuration: 300 }));
 
-      expect(result.current.style.transition).toBe('transform 300ms ease-out');
+      expect(result.current.transition).toBe('transform 300ms ease-out');
     });
 
     it('should apply custom transition timing function', () => {
@@ -66,11 +66,11 @@ describe('useAvoidKeyboard', () => {
         useAvoidKeyboard({ transitionTimingFunction: 'cubic-bezier(0.4, 0, 0.2, 1)' })
       );
 
-      expect(result.current.style.transition).toBe('transform 200ms cubic-bezier(0.4, 0, 0.2, 1)');
+      expect(result.current.transition).toBe('transform 200ms cubic-bezier(0.4, 0, 0.2, 1)');
     });
 
     it('should apply all custom options together', () => {
-      mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 250 });
+      mockUseKeyboardHeight.mockReturnValue(250);
 
       const { result } = renderHook(() =>
         useAvoidKeyboard({
@@ -80,7 +80,7 @@ describe('useAvoidKeyboard', () => {
         })
       );
 
-      expect(result.current.style).toEqual({
+      expect(result.current).toEqual({
         transform: 'translateY(-280px)',
         transition: 'transform 150ms linear',
       });
@@ -91,17 +91,17 @@ describe('useAvoidKeyboard', () => {
     it('should update style when keyboard height changes', () => {
       const { result, rerender } = renderHook(() => useAvoidKeyboard());
 
-      expect(result.current.style.transform).toBe('translateY(0px)');
+      expect(result.current.transform).toBe('translateY(0px)');
 
-      mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 350 });
+      mockUseKeyboardHeight.mockReturnValue(350);
       rerender();
 
-      expect(result.current.style.transform).toBe('translateY(-350px)');
+      expect(result.current.transform).toBe('translateY(-350px)');
 
-      mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 0 });
+      mockUseKeyboardHeight.mockReturnValue(0);
       rerender();
 
-      expect(result.current.style.transform).toBe('translateY(0px)');
+      expect(result.current.transform).toBe('translateY(0px)');
     });
   });
 
@@ -121,7 +121,7 @@ describe('useAvoidKeyboard', () => {
 
   describe('use cases', () => {
     it('should provide style for fixed bottom CTA', () => {
-      mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 300 });
+      mockUseKeyboardHeight.mockReturnValue(300);
 
       const { result } = renderHook(() => useAvoidKeyboard());
 
@@ -130,7 +130,7 @@ describe('useAvoidKeyboard', () => {
         bottom: 0,
         left: 0,
         right: 0,
-        ...result.current.style,
+        ...result.current,
       };
 
       expect(elementStyle.transform).toBe('translateY(-300px)');
@@ -138,11 +138,11 @@ describe('useAvoidKeyboard', () => {
     });
 
     it('should handle safe area with safeAreaBottom', () => {
-      mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 300 });
+      mockUseKeyboardHeight.mockReturnValue(300);
 
       const { result } = renderHook(() => useAvoidKeyboard({ safeAreaBottom: 34 }));
 
-      expect(result.current.style.transform).toBe('translateY(-334px)');
+      expect(result.current.transform).toBe('translateY(-334px)');
     });
   });
 
@@ -150,22 +150,22 @@ describe('useAvoidKeyboard', () => {
     it('should return same style object when values do not change', () => {
       const { result, rerender } = renderHook(() => useAvoidKeyboard());
 
-      const firstStyle = result.current.style;
+      const firstStyle = result.current;
 
       rerender();
 
-      expect(result.current.style).toBe(firstStyle);
+      expect(result.current).toBe(firstStyle);
     });
 
     it('should return new style object when keyboard height changes', () => {
       const { result, rerender } = renderHook(() => useAvoidKeyboard());
 
-      const firstStyle = result.current.style;
+      const firstStyle = result.current;
 
-      mockUseKeyboardHeight.mockReturnValue({ keyboardHeight: 100 });
+      mockUseKeyboardHeight.mockReturnValue(100);
       rerender();
 
-      expect(result.current.style).not.toBe(firstStyle);
+      expect(result.current).not.toBe(firstStyle);
     });
   });
 });
diff --git a/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.ts b/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.ts
index bb9d8736..7e6a6305 100644
--- a/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.ts
+++ b/packages/react-simplikit/src/hooks/useAvoidKeyboard/useAvoidKeyboard.ts
@@ -26,14 +26,6 @@ type UseAvoidKeyboardOptions = {
   immediate?: boolean;
 };
 
-type UseAvoidKeyboardResult = {
-  /**
-   * CSS style object to apply to the fixed bottom element.
-   * Contains transform and transition properties.
-   */
-  style: CSSProperties;
-};
-
 /**
  * @description
  * `useAvoidKeyboard` is a React hook that helps fixed-bottom elements avoid the on-screen keyboard.
@@ -46,12 +38,11 @@ type UseAvoidKeyboardResult = {
  * @param {CSSProperties['transitionTimingFunction']} [options.transitionTimingFunction='ease-out'] - Transition timing function for the animation.
  * @param {boolean} [options.immediate=true] - If true, gets the initial keyboard height on mount.
  *
- * @returns {UseAvoidKeyboardResult} An object containing the CSS style for keyboard avoidance.
- * - style `CSSProperties` - CSS style object to apply to the fixed bottom element. Contains `transform` and `transition` properties;
+ * @returns {CSSProperties} The CSS style to apply to the fixed bottom element. Contains `transform` and `transition` properties.
  *
  * @example
  * function FixedBottomCTA() {
- *   const { style } = useAvoidKeyboard();
+ *   const style = useAvoidKeyboard();
  *
  *   return (
  *     <div
@@ -71,7 +62,7 @@ type UseAvoidKeyboardResult = {
  * @example
  * // With safe area bottom offset (e.g., for iPhone home indicator)
  * function FixedBottomCTA() {
- *   const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+ *   const style = useAvoidKeyboard({ safeAreaBottom: 34 });
  *
  *   return (
  *     <div
@@ -88,7 +79,7 @@ type UseAvoidKeyboardResult = {
  *   );
  * }
  */
-export function useAvoidKeyboard(options: UseAvoidKeyboardOptions = {}): UseAvoidKeyboardResult {
+export function useAvoidKeyboard(options: UseAvoidKeyboardOptions = {}): CSSProperties {
   const {
     safeAreaBottom = 0,
     transitionDuration = 200,
@@ -96,7 +87,7 @@ export function useAvoidKeyboard(options: UseAvoidKeyboardOptions = {}): UseAvoi
     immediate = true,
   } = options;
 
-  const { keyboardHeight } = useKeyboardHeight({ immediate });
+  const keyboardHeight = useKeyboardHeight({ immediate });
 
   const style = useMemo<CSSProperties>(() => {
     const translateY = keyboardHeight > 0 ? -(keyboardHeight + safeAreaBottom) : 0;
@@ -107,5 +98,5 @@ export function useAvoidKeyboard(options: UseAvoidKeyboardOptions = {}): UseAvoi
     };
   }, [keyboardHeight, safeAreaBottom, transitionDuration, transitionTimingFunction]);
 
-  return { style };
+  return style;
 }
diff --git a/packages/react-simplikit/src/hooks/useAvoidKeyboard/zh-Hans/useAvoidKeyboard.md b/packages/react-simplikit/src/hooks/useAvoidKeyboard/zh-Hans/useAvoidKeyboard.md
index 86bb71d1..f5f2feb1 100644
--- a/packages/react-simplikit/src/hooks/useAvoidKeyboard/zh-Hans/useAvoidKeyboard.md
+++ b/packages/react-simplikit/src/hooks/useAvoidKeyboard/zh-Hans/useAvoidKeyboard.md
@@ -5,9 +5,7 @@
 ## 接口
 
 ```ts
-function useAvoidKeyboard(
-  options?: UseAvoidKeyboardOptions
-): UseAvoidKeyboardResult;
+function useAvoidKeyboard(options?: UseAvoidKeyboardOptions): CSSProperties;
 ```
 
 ### 参数
@@ -53,24 +51,15 @@ function useAvoidKeyboard(
 
 <Interface
   name=""
-  type="UseAvoidKeyboardResult"
-  description="一个包含键盘避让 CSS 样式的对象。"
-  :nested="[
-    {
-      name: 'style',
-      type: 'CSSProperties',
-      required: false,
-      description:
-        '应用到固定底部元素上的 CSS 样式对象。包含 <code>transform</code> 和 <code>transition</code> 属性。',
-    },
-  ]"
+  type="CSSProperties"
+  description="应用到固定底部元素上的 CSS 样式对象。包含 <code>transform</code> 和 <code>transition</code> 属性。"
 />
 
 ## 示例
 
 ```tsx
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard();
+  const style = useAvoidKeyboard();
 
   return (
     <div
@@ -91,7 +80,7 @@ function FixedBottomCTA() {
 ```tsx
 // With safe area bottom offset (e.g., for iPhone home indicator)
 function FixedBottomCTA() {
-  const { style } = useAvoidKeyboard({ safeAreaBottom: 34 });
+  const style = useAvoidKeyboard({ safeAreaBottom: 34 });
 
   return (
     <div
diff --git a/packages/react-simplikit/src/hooks/useKeyboardHeight/es/useKeyboardHeight.md b/packages/react-simplikit/src/hooks/useKeyboardHeight/es/useKeyboardHeight.md
index 82249d4a..e798da4c 100644
--- a/packages/react-simplikit/src/hooks/useKeyboardHeight/es/useKeyboardHeight.md
+++ b/packages/react-simplikit/src/hooks/useKeyboardHeight/es/useKeyboardHeight.md
@@ -7,9 +7,7 @@ cuando el teclado aparece, desaparece o cambia de tamaño.
 ## Interfaz
 
 ```ts
-function useKeyboardHeight(
-  options?: UseKeyboardHeightOptions
-): UseKeyboardHeightResult;
+function useKeyboardHeight(options?: UseKeyboardHeightOptions): number;
 ```
 
 ### Parámetros
@@ -33,24 +31,15 @@ function useKeyboardHeight(
 
 <Interface
   name=""
-  type="UseKeyboardHeightResult"
-  description="Un objeto que contiene la altura actual del teclado."
-  :nested="[
-    {
-      name: 'keyboardHeight',
-      type: 'number',
-      required: false,
-      description:
-        'La altura actual del teclado en píxeles. Es 0 cuando el teclado está oculto.',
-    },
-  ]"
+  type="number"
+  description="La altura actual del teclado en píxeles. Es 0 cuando el teclado está oculto."
 />
 
 ## Ejemplo
 
 ```tsx
 function ChatInput() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div style={{ paddingBottom: `${keyboardHeight}px` }}>
@@ -62,7 +51,7 @@ function ChatInput() {
 
 ```tsx
 function KeyboardStatus() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div>
diff --git a/packages/react-simplikit/src/hooks/useKeyboardHeight/ja/useKeyboardHeight.md b/packages/react-simplikit/src/hooks/useKeyboardHeight/ja/useKeyboardHeight.md
index e97c3152..8f517342 100644
--- a/packages/react-simplikit/src/hooks/useKeyboardHeight/ja/useKeyboardHeight.md
+++ b/packages/react-simplikit/src/hooks/useKeyboardHeight/ja/useKeyboardHeight.md
@@ -7,9 +7,7 @@
 ## インターフェース
 
 ```ts
-function useKeyboardHeight(
-  options?: UseKeyboardHeightOptions
-): UseKeyboardHeightResult;
+function useKeyboardHeight(options?: UseKeyboardHeightOptions): number;
 ```
 
 ### パラメータ
@@ -33,24 +31,15 @@ function useKeyboardHeight(
 
 <Interface
   name=""
-  type="UseKeyboardHeightResult"
-  description="現在のキーボードの高さを含むオブジェクトです。"
-  :nested="[
-    {
-      name: 'keyboardHeight',
-      type: 'number',
-      required: false,
-      description:
-        '現在のキーボードの高さ（ピクセル）です。キーボードが非表示のときは 0 です。',
-    },
-  ]"
+  type="number"
+  description="現在のキーボードの高さ（ピクセル）です。キーボードが非表示のときは 0 です。"
 />
 
 ## 使用例
 
 ```tsx
 function ChatInput() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div style={{ paddingBottom: `${keyboardHeight}px` }}>
@@ -62,7 +51,7 @@ function ChatInput() {
 
 ```tsx
 function KeyboardStatus() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div>
diff --git a/packages/react-simplikit/src/hooks/useKeyboardHeight/ko/useKeyboardHeight.md b/packages/react-simplikit/src/hooks/useKeyboardHeight/ko/useKeyboardHeight.md
index cc941d67..93ea82c7 100644
--- a/packages/react-simplikit/src/hooks/useKeyboardHeight/ko/useKeyboardHeight.md
+++ b/packages/react-simplikit/src/hooks/useKeyboardHeight/ko/useKeyboardHeight.md
@@ -5,9 +5,7 @@
 ## 인터페이스
 
 ```ts
-function useKeyboardHeight(
-  options?: UseKeyboardHeightOptions
-): UseKeyboardHeightResult;
+function useKeyboardHeight(options?: UseKeyboardHeightOptions): number;
 ```
 
 ### 파라미터
@@ -32,23 +30,15 @@ function useKeyboardHeight(
 
 <Interface
   name=""
-  type="UseKeyboardHeightResult"
-  description="키보드 높이 정보를 담은 객체예요."
-  :nested="[
-    {
-      name: 'keyboardHeight',
-      type: 'number',
-      description:
-        '현재 키보드 높이(px)예요. 키보드가 닫혀 있으면 <code>0</code>이에요.',
-    },
-  ]"
+  type="number"
+  description="현재 키보드 높이(px)예요. 키보드가 닫혀 있으면 <code>0</code>이에요."
 />
 
 ## 예시
 
 ```tsx
 function ChatInput() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div style={{ paddingBottom: `${keyboardHeight}px` }}>
@@ -60,7 +50,7 @@ function ChatInput() {
 
 ```tsx
 function KeyboardStatus() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div>
diff --git a/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.md b/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.md
index 09d3618a..47fd8ddb 100644
--- a/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.md
+++ b/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.md
@@ -7,9 +7,7 @@ when the keyboard appears, disappears, or changes size.
 ## Interface
 
 ```ts
-function useKeyboardHeight(
-  options?: UseKeyboardHeightOptions
-): UseKeyboardHeightResult;
+function useKeyboardHeight(options?: UseKeyboardHeightOptions): number;
 ```
 
 ### Parameters
@@ -33,24 +31,15 @@ function useKeyboardHeight(
 
 <Interface
   name=""
-  type="UseKeyboardHeightResult"
-  description="An object containing the current keyboard height."
-  :nested="[
-    {
-      name: 'keyboardHeight',
-      type: 'number',
-      required: false,
-      description:
-        'The current keyboard height in pixels. 0 when the keyboard is hidden.',
-    },
-  ]"
+  type="number"
+  description="The current keyboard height in pixels. 0 when the keyboard is hidden."
 />
 
 ## Example
 
 ```tsx
 function ChatInput() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div style={{ paddingBottom: `${keyboardHeight}px` }}>
@@ -62,7 +51,7 @@ function ChatInput() {
 
 ```tsx
 function KeyboardStatus() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div>
diff --git a/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.test.ts b/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.test.ts
index 694d367d..546f6b18 100644
--- a/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.test.ts
+++ b/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.test.ts
@@ -27,7 +27,7 @@ describe('useKeyboardHeight', () => {
     it('should return 0 as initial keyboard height', () => {
       const { result } = renderHook(() => useKeyboardHeight());
 
-      expect(result.current.keyboardHeight).toBe(0);
+      expect(result.current).toBe(0);
     });
   });
 
@@ -58,7 +58,7 @@ describe('useKeyboardHeight', () => {
 
       const { result } = renderHook(() => useKeyboardHeight());
 
-      expect(result.current.keyboardHeight).toBe(300);
+      expect(result.current).toBe(300);
     });
   });
 
@@ -98,19 +98,19 @@ describe('useKeyboardHeight', () => {
 
       const { result } = renderHook(() => useKeyboardHeight());
 
-      expect(result.current.keyboardHeight).toBe(0);
+      expect(result.current).toBe(0);
 
       await act(async () => {
         capturedCallback?.(250);
       });
 
-      expect(result.current.keyboardHeight).toBe(250);
+      expect(result.current).toBe(250);
 
       await act(async () => {
         capturedCallback?.(0);
       });
 
-      expect(result.current.keyboardHeight).toBe(0);
+      expect(result.current).toBe(0);
     });
 
     it('should handle various keyboard heights', () => {
@@ -124,7 +124,7 @@ describe('useKeyboardHeight', () => {
 
         const { result } = renderHook(() => useKeyboardHeight());
 
-        expect(result.current.keyboardHeight).toBe(expectedHeight);
+        expect(result.current).toBe(expectedHeight);
       }
     });
   });
@@ -138,7 +138,7 @@ describe('useKeyboardHeight', () => {
 
       const { result } = renderHook(() => useKeyboardHeight());
 
-      const paddingBottom = `${result.current.keyboardHeight}px`;
+      const paddingBottom = `${result.current}px`;
       expect(paddingBottom).toBe('300px');
     });
 
@@ -150,7 +150,7 @@ describe('useKeyboardHeight', () => {
 
       const { result } = renderHook(() => useKeyboardHeight());
 
-      const isKeyboardVisible = result.current.keyboardHeight > 0;
+      const isKeyboardVisible = result.current > 0;
       expect(isKeyboardVisible).toBe(true);
     });
 
@@ -162,7 +162,7 @@ describe('useKeyboardHeight', () => {
 
       const { result } = renderHook(() => useKeyboardHeight());
 
-      const isKeyboardVisible = result.current.keyboardHeight > 0;
+      const isKeyboardVisible = result.current > 0;
       expect(isKeyboardVisible).toBe(false);
     });
   });
@@ -190,8 +190,8 @@ describe('useKeyboardHeight', () => {
         callback2?.(200);
       });
 
-      expect(result1.current.keyboardHeight).toBe(200);
-      expect(result2.current.keyboardHeight).toBe(200);
+      expect(result1.current).toBe(200);
+      expect(result2.current).toBe(200);
     });
   });
 });
diff --git a/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.ts b/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.ts
index c5b501b3..1cd21559 100644
--- a/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.ts
+++ b/packages/react-simplikit/src/hooks/useKeyboardHeight/useKeyboardHeight.ts
@@ -10,13 +10,6 @@ type UseKeyboardHeightOptions = {
   immediate?: boolean;
 };
 
-type UseKeyboardHeightResult = {
-  /**
-   * The current keyboard height in pixels.
-   */
-  keyboardHeight: number;
-};
-
 /**
  * @description
  * `useKeyboardHeight` is a React hook that tracks the on-screen keyboard height.
@@ -26,12 +19,11 @@ type UseKeyboardHeightResult = {
  * @param {UseKeyboardHeightOptions} [options] - Configuration options.
  * @param {boolean} [options.immediate=true] - If true, gets the initial keyboard height on mount.
  *
- * @returns {UseKeyboardHeightResult} An object containing the current keyboard height.
- * - keyboardHeight `number` - The current keyboard height in pixels. 0 when the keyboard is hidden;
+ * @returns {number} The current keyboard height in pixels. 0 when the keyboard is hidden.
  *
  * @example
  * function ChatInput() {
- *   const { keyboardHeight } = useKeyboardHeight();
+ *   const keyboardHeight = useKeyboardHeight();
  *
  *   return (
  *     <div style={{ paddingBottom: `${keyboardHeight}px` }}>
@@ -42,7 +34,7 @@ type UseKeyboardHeightResult = {
  *
  * @example
  * function KeyboardStatus() {
- *   const { keyboardHeight } = useKeyboardHeight();
+ *   const keyboardHeight = useKeyboardHeight();
  *
  *   return (
  *     <div>
@@ -53,7 +45,7 @@ type UseKeyboardHeightResult = {
  *   );
  * }
  */
-export function useKeyboardHeight(options: UseKeyboardHeightOptions = {}): UseKeyboardHeightResult {
+export function useKeyboardHeight(options: UseKeyboardHeightOptions = {}): number {
   const { immediate = true } = options;
 
   const [keyboardHeight, setKeyboardHeight] = useState(0);
@@ -70,5 +62,5 @@ export function useKeyboardHeight(options: UseKeyboardHeightOptions = {}): UseKe
     [immediate]
   );
 
-  return { keyboardHeight };
+  return keyboardHeight;
 }
diff --git a/packages/react-simplikit/src/hooks/useKeyboardHeight/zh-Hans/useKeyboardHeight.md b/packages/react-simplikit/src/hooks/useKeyboardHeight/zh-Hans/useKeyboardHeight.md
index 5ad41445..1705a16c 100644
--- a/packages/react-simplikit/src/hooks/useKeyboardHeight/zh-Hans/useKeyboardHeight.md
+++ b/packages/react-simplikit/src/hooks/useKeyboardHeight/zh-Hans/useKeyboardHeight.md
@@ -5,9 +5,7 @@
 ## 接口
 
 ```ts
-function useKeyboardHeight(
-  options?: UseKeyboardHeightOptions
-): UseKeyboardHeightResult;
+function useKeyboardHeight(options?: UseKeyboardHeightOptions): number;
 ```
 
 ### 参数
@@ -31,24 +29,15 @@ function useKeyboardHeight(
 
 <Interface
   name=""
-  type="UseKeyboardHeightResult"
-  description="一个包含当前键盘高度的对象。"
-  :nested="[
-    {
-      name: 'keyboardHeight',
-      type: 'number',
-      required: false,
-      description:
-        '当前键盘高度（像素）。键盘隐藏时为 0。',
-    },
-  ]"
+  type="number"
+  description="当前键盘高度（像素）。键盘隐藏时为 0。"
 />
 
 ## 示例
 
 ```tsx
 function ChatInput() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div style={{ paddingBottom: `${keyboardHeight}px` }}>
@@ -60,7 +49,7 @@ function ChatInput() {
 
 ```tsx
 function KeyboardStatus() {
-  const { keyboardHeight } = useKeyboardHeight();
+  const keyboardHeight = useKeyboardHeight();
 
   return (
     <div>
diff --git a/packages/react-simplikit/src/hooks/useVisualViewport/es/useVisualViewport.md b/packages/react-simplikit/src/hooks/useVisualViewport/es/useVisualViewport.md
index 10742913..1638fd24 100644
--- a/packages/react-simplikit/src/hooks/useVisualViewport/es/useVisualViewport.md
+++ b/packages/react-simplikit/src/hooks/useVisualViewport/es/useVisualViewport.md
@@ -7,7 +7,7 @@ aparece el teclado o el usuario ajusta el zoom o se desplaza.
 ## Interfaz
 
 ```ts
-function useVisualViewport(): { viewport: VisualViewportState | null };
+function useVisualViewport(): VisualViewportState | null;
 ```
 
 ### Parámetros
@@ -18,44 +18,37 @@ Esta función no acepta parámetros.
 
 <Interface
   name=""
-  type="{ viewport: VisualViewportState | null }"
+  type="VisualViewportState | null"
   description="Un objeto que contiene el estado del área visible."
   :nested="[
     {
-      name: 'viewport',
-      type: 'VisualViewportState | null',
-      required: false,
-      description:
-        'Objeto de estado del área visible, o <code>null</code> si no está disponible (SSR o navegadores sin la API Visual Viewport).',
-    },
-    {
-      name: 'viewport.width',
+      name: 'width',
       type: 'number',
       required: false,
       description: 'Ancho del área de visualización en píxeles.',
     },
     {
-      name: 'viewport.height',
+      name: 'height',
       type: 'number',
       required: false,
       description: 'Altura del área de visualización en píxeles.',
     },
     {
-      name: 'viewport.offsetLeft',
+      name: 'offsetLeft',
       type: 'number',
       required: false,
       description:
         'Desplazamiento del borde izquierdo del área visible con respecto al área de diseño (layout viewport), en píxeles. Normalmente es 0, salvo cuando hay desplazamiento horizontal o un gesto de arrastre.',
     },
     {
-      name: 'viewport.offsetTop',
+      name: 'offsetTop',
       type: 'number',
       required: false,
       description:
         'Desplazamiento del borde superior del área visible con respecto al área de diseño (layout viewport), en píxeles. En iOS pasa a ser negativo cuando aparece el teclado (por ejemplo, -300px indica un teclado de 300px), así que usa <code>-offsetTop</code> para obtener la altura del teclado. En Android normalmente permanece en 0.',
     },
     {
-      name: 'viewport.scale',
+      name: 'scale',
       type: 'number',
       required: false,
       description:
@@ -68,7 +61,7 @@ Esta función no acepta parámetros.
 
 ```tsx
 function CustomLayout() {
-  const { viewport } = useVisualViewport();
+  const viewport = useVisualViewport();
 
   // Comprueba siempre null primero
   if (!viewport) {
@@ -92,7 +85,7 @@ function CustomLayout() {
 ### Detección del zoom
 
 ```tsx
-const { viewport } = useVisualViewport();
+const viewport = useVisualViewport();
 if (viewport && viewport.scale > 1.3) {
   // Oculta la interfaz flotante cuando el usuario amplía el zoom
   setShowFloatingButton(false);
diff --git a/packages/react-simplikit/src/hooks/useVisualViewport/ja/useVisualViewport.md b/packages/react-simplikit/src/hooks/useVisualViewport/ja/useVisualViewport.md
index 9a8a6443..41f0ed51 100644
--- a/packages/react-simplikit/src/hooks/useVisualViewport/ja/useVisualViewport.md
+++ b/packages/react-simplikit/src/hooks/useVisualViewport/ja/useVisualViewport.md
@@ -6,7 +6,7 @@
 ## インターフェース
 
 ```ts
-function useVisualViewport(): { viewport: VisualViewportState | null };
+function useVisualViewport(): VisualViewportState | null;
 ```
 
 ### パラメータ
@@ -17,44 +17,37 @@ function useVisualViewport(): { viewport: VisualViewportState | null };
 
 <Interface
   name=""
-  type="{ viewport: VisualViewportState | null }"
+  type="VisualViewportState | null"
   description="Visual Viewport の状態を含むオブジェクト。"
   :nested="[
     {
-      name: 'viewport',
-      type: 'VisualViewportState | null',
-      required: false,
-      description:
-        'Visual Viewport の状態オブジェクト。非対応の環境（SSR、または Visual Viewport API 非対応のブラウザー）では <code>null</code> です。',
-    },
-    {
-      name: 'viewport.width',
+      name: 'width',
       type: 'number',
       required: false,
       description: 'ビューポートの幅（ピクセル単位）。',
     },
     {
-      name: 'viewport.height',
+      name: 'height',
       type: 'number',
       required: false,
       description: 'ビューポートの高さ（ピクセル単位）。',
     },
     {
-      name: 'viewport.offsetLeft',
+      name: 'offsetLeft',
       type: 'number',
       required: false,
       description:
         'レイアウトビューポートを基準とした、ビューポート左端のオフセット（ピクセル単位）。通常、水平スクロールやパン操作がなければ 0 です。',
     },
     {
-      name: 'viewport.offsetTop',
+      name: 'offsetTop',
       type: 'number',
       required: false,
       description:
         'レイアウトビューポートを基準とした、ビューポート上端のオフセット（ピクセル単位）。iOS ではキーボードが表示されると負の値になります（例：-300px はキーボードの高さが 300px であることを表します）。そのため、キーボードの高さには <code>-offsetTop</code> を使ってください。Android では通常 0 のままです。',
     },
     {
-      name: 'viewport.scale',
+      name: 'scale',
       type: 'number',
       required: false,
       description:
@@ -67,7 +60,7 @@ function useVisualViewport(): { viewport: VisualViewportState | null };
 
 ```tsx
 function CustomLayout() {
-  const { viewport } = useVisualViewport();
+  const viewport = useVisualViewport();
 
   // 必ず最初に null かどうかを確認します
   if (!viewport) {
@@ -91,7 +84,7 @@ function CustomLayout() {
 ### ズームを検出する
 
 ```tsx
-const { viewport } = useVisualViewport();
+const viewport = useVisualViewport();
 if (viewport && viewport.scale > 1.3) {
   // ユーザーがズームインしたときにフローティング UI を非表示にします
   setShowFloatingButton(false);
diff --git a/packages/react-simplikit/src/hooks/useVisualViewport/ko/useVisualViewport.md b/packages/react-simplikit/src/hooks/useVisualViewport/ko/useVisualViewport.md
index a33f9a64..fe020fe8 100644
--- a/packages/react-simplikit/src/hooks/useVisualViewport/ko/useVisualViewport.md
+++ b/packages/react-simplikit/src/hooks/useVisualViewport/ko/useVisualViewport.md
@@ -7,7 +7,7 @@ Visual Viewport 변경사항을 추적하는 React 훅이에요.
 ## 인터페이스
 
 ```ts
-function useVisualViewport(): { viewport: VisualViewportState | null };
+function useVisualViewport(): VisualViewportState | null;
 ```
 
 ### 파라미터
@@ -18,42 +18,35 @@ function useVisualViewport(): { viewport: VisualViewportState | null };
 
 <Interface
   name=""
-  type="{ viewport: VisualViewportState | null }"
+  type="VisualViewportState | null"
   description="Visual Viewport 상태를 담은 객체예요."
   :nested="[
     {
-      name: 'viewport',
-      type: 'VisualViewportState | null',
-      required: false,
-      description:
-        'Visual Viewport 상태 객체예요. 지원하지 않는 환경(SSR 또는 Visual Viewport API 미지원 브라우저)에서는 <code>null</code>이에요.',
-    },
-    {
-      name: 'viewport.width',
+      name: 'width',
       type: 'number',
       required: false,
       description: '뷰포트 너비 (픽셀)',
     },
     {
-      name: 'viewport.height',
+      name: 'height',
       type: 'number',
       required: false,
       description: '뷰포트 높이 (픽셀)',
     },
     {
-      name: 'viewport.offsetLeft',
+      name: 'offsetLeft',
       type: 'number',
       required: false,
       description: '레이아웃 뷰포트로부터의 왼쪽 오프셋 (픽셀). 일반적으로 0이며, 가로 스크롤이나 패닝이 발생할 때만 변경돼요',
     },
     {
-      name: 'viewport.offsetTop',
+      name: 'offsetTop',
       type: 'number',
       required: false,
       description: '레이아웃 뷰포트로부터의 상단 오프셋(픽셀)이에요. iOS에서는 키보드가 나타날 때 음수가 되므로(예: -300px는 키보드 높이 300px를 의미) 키보드 높이는 <code>-offsetTop</code>으로 구하세요. Android에서는 일반적으로 0으로 유지돼요.',
     },
     {
-      name: 'viewport.scale',
+      name: 'scale',
       type: 'number',
       required: false,
       description: '핀치 줌 배율이에요. 1.0은 줌 없음, 1.0보다 크면 확대, 1.0보다 작으면 축소(드물며, 뷰포트 설정에 따라 달라요)예요.',
@@ -65,7 +58,7 @@ function useVisualViewport(): { viewport: VisualViewportState | null };
 
 ```tsx
 function CustomLayout() {
-  const { viewport } = useVisualViewport();
+  const viewport = useVisualViewport();
 
   // 항상 null부터 확인해요
   if (!viewport) {
@@ -89,7 +82,7 @@ function CustomLayout() {
 ### 줌 감지하기
 
 ```tsx
-const { viewport } = useVisualViewport();
+const viewport = useVisualViewport();
 if (viewport && viewport.scale > 1.3) {
   // 사용자가 확대하면 플로팅 UI를 숨겨요
   setShowFloatingButton(false);
diff --git a/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.md b/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.md
index ad328709..7581371e 100644
--- a/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.md
+++ b/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.md
@@ -7,7 +7,7 @@ the keyboard appears or the user zooms/scrolls.
 ## Interface
 
 ```ts
-function useVisualViewport(): { viewport: VisualViewportState | null };
+function useVisualViewport(): VisualViewportState | null;
 ```
 
 ### Parameters
@@ -18,44 +18,37 @@ This function does not accept any parameters.
 
 <Interface
   name=""
-  type="{ viewport: VisualViewportState | null }"
-  description="An object containing the Visual Viewport state."
+  type="VisualViewportState | null"
+  description="The Visual Viewport state, or <code>null</code> if not supported (SSR or browsers without the Visual Viewport API);"
   :nested="[
     {
-      name: 'viewport',
-      type: 'VisualViewportState | null',
-      required: false,
-      description:
-        'Visual Viewport state object, or <code>null</code> if not supported (SSR or browsers without the Visual Viewport API).',
-    },
-    {
-      name: 'viewport.width',
+      name: 'width',
       type: 'number',
       required: false,
       description: 'Viewport width in pixels.',
     },
     {
-      name: 'viewport.height',
+      name: 'height',
       type: 'number',
       required: false,
       description: 'Viewport height in pixels.',
     },
     {
-      name: 'viewport.offsetLeft',
+      name: 'offsetLeft',
       type: 'number',
       required: false,
       description:
         'Viewport left offset in pixels from the layout viewport. Typically 0 unless horizontal scrolling or panning occurs.',
     },
     {
-      name: 'viewport.offsetTop',
+      name: 'offsetTop',
       type: 'number',
       required: false,
       description:
         'Viewport top offset in pixels from the layout viewport. Becomes negative on iOS when the keyboard appears (e.g., -300px means a 300px keyboard), so use <code>-offsetTop</code> for the keyboard height. Typically remains 0 on Android.',
     },
     {
-      name: 'viewport.scale',
+      name: 'scale',
       type: 'number',
       required: false,
       description:
@@ -68,7 +61,7 @@ This function does not accept any parameters.
 
 ```tsx
 function CustomLayout() {
-  const { viewport } = useVisualViewport();
+  const viewport = useVisualViewport();
 
   // Always check for null first
   if (!viewport) {
@@ -92,7 +85,7 @@ function CustomLayout() {
 ### Detecting zoom
 
 ```tsx
-const { viewport } = useVisualViewport();
+const viewport = useVisualViewport();
 if (viewport && viewport.scale > 1.3) {
   // Hide floating UI when user zooms in
   setShowFloatingButton(false);
diff --git a/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.test.ts b/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.test.ts
index 2eb9554b..a59c6789 100644
--- a/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.test.ts
+++ b/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.test.ts
@@ -41,8 +41,8 @@ describe('useVisualViewport', () => {
   it('should return initial viewport state', () => {
     const { result } = renderHook(() => useVisualViewport());
 
-    expect(result.current.viewport).not.toBeNull();
-    expect(result.current.viewport).toEqual({
+    expect(result.current).not.toBeNull();
+    expect(result.current).toEqual({
       width: 375,
       height: 667,
       offsetLeft: 0,
@@ -74,8 +74,8 @@ describe('useVisualViewport', () => {
       await new Promise(resolve => setTimeout(resolve, 0));
     });
 
-    expect(result.current.viewport).not.toBeNull();
-    expect(result.current.viewport).toEqual({
+    expect(result.current).not.toBeNull();
+    expect(result.current).toEqual({
       width: 375,
       height: 400,
       offsetLeft: 0,
@@ -99,8 +99,8 @@ describe('useVisualViewport', () => {
       await new Promise(resolve => setTimeout(resolve, 0));
     });
 
-    expect(result.current.viewport).not.toBeNull();
-    expect(result.current.viewport).toEqual({
+    expect(result.current).not.toBeNull();
+    expect(result.current).toEqual({
       width: 375,
       height: 667,
       offsetLeft: 10,
@@ -124,10 +124,10 @@ describe('useVisualViewport', () => {
       await new Promise(resolve => setTimeout(resolve, 0));
     });
 
-    expect(result.current.viewport).not.toBeNull();
-    expect(result.current.viewport?.scale).toBe(2.0);
-    expect(result.current.viewport?.width).toBe(187);
-    expect(result.current.viewport?.height).toBe(333);
+    expect(result.current).not.toBeNull();
+    expect(result.current?.scale).toBe(2.0);
+    expect(result.current?.width).toBe(187);
+    expect(result.current?.height).toBe(333);
   });
 
   it('should remove event listeners on unmount', () => {
@@ -149,7 +149,7 @@ describe('useVisualViewport', () => {
 
     const { result } = renderHook(() => useVisualViewport());
 
-    expect(result.current.viewport).toBeNull();
+    expect(result.current).toBeNull();
   });
 
   it('should handle null visualViewport', () => {
@@ -161,13 +161,13 @@ describe('useVisualViewport', () => {
 
     const { result } = renderHook(() => useVisualViewport());
 
-    expect(result.current.viewport).toBeNull();
+    expect(result.current).toBeNull();
   });
 
   it('is safe on server side rendering', () => {
     const result = renderHookSSR.serverOnly(() => useVisualViewport());
 
-    expect(result.current.viewport).toBeNull();
+    expect(result.current).toBeNull();
   });
 
   it('should return null when visualViewport disappears before an update', async () => {
@@ -186,7 +186,7 @@ describe('useVisualViewport', () => {
       await new Promise(resolve => setTimeout(resolve, 0));
     });
 
-    expect(result.current.viewport).toBeNull();
+    expect(result.current).toBeNull();
   });
 
   it('should handle multiple rapid updates correctly', async () => {
@@ -206,8 +206,8 @@ describe('useVisualViewport', () => {
     });
 
     // Should reflect the last update
-    expect(result.current.viewport).not.toBeNull();
-    expect(result.current.viewport?.height).toBe(400);
+    expect(result.current).not.toBeNull();
+    expect(result.current?.height).toBe(400);
   });
 
   it('should handle edge case with zero dimensions', async () => {
@@ -223,8 +223,8 @@ describe('useVisualViewport', () => {
       await new Promise(resolve => setTimeout(resolve, 0));
     });
 
-    expect(result.current.viewport).not.toBeNull();
-    expect(result.current.viewport).toEqual({
+    expect(result.current).not.toBeNull();
+    expect(result.current).toEqual({
       width: 0,
       height: 0,
       offsetLeft: 0,
@@ -247,9 +247,9 @@ describe('useVisualViewport', () => {
       await new Promise(resolve => setTimeout(resolve, 0));
     });
 
-    expect(result.current.viewport).not.toBeNull();
-    expect(result.current.viewport?.offsetTop).toBe(-300);
-    expect(result.current.viewport?.height).toBe(367);
+    expect(result.current).not.toBeNull();
+    expect(result.current?.offsetTop).toBe(-300);
+    expect(result.current?.height).toBe(367);
   });
 
   it('should handle zoom out scenario (scale < 1)', async () => {
@@ -267,8 +267,8 @@ describe('useVisualViewport', () => {
       await new Promise(resolve => setTimeout(resolve, 0));
     });
 
-    expect(result.current.viewport).not.toBeNull();
-    expect(result.current.viewport?.scale).toBe(0.5);
-    expect(result.current.viewport?.width).toBe(750);
+    expect(result.current).not.toBeNull();
+    expect(result.current?.scale).toBe(0.5);
+    expect(result.current?.width).toBe(750);
   });
 });
diff --git a/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.ts b/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.ts
index 90975db3..7b999e44 100644
--- a/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.ts
+++ b/packages/react-simplikit/src/hooks/useVisualViewport/useVisualViewport.ts
@@ -31,7 +31,7 @@ type VisualViewportState = {
    *
    * @example
    * ```tsx
-   * const { viewport } = useVisualViewport();
+   * const viewport = useVisualViewport();
    * if (viewport && viewport.scale > 1.3) {
    *   // Hide floating UI when user zooms in
    *   setShowFloatingButton(false);
@@ -47,19 +47,18 @@ type VisualViewportState = {
  * It returns the actual visible area in mobile WebView, which changes when
  * the keyboard appears or the user zooms/scrolls.
  *
- * @returns {{ viewport: VisualViewportState | null }} An object containing the Visual Viewport state.
- * - viewport `VisualViewportState | null` - Visual Viewport state object, or `null` if not supported (SSR or browsers without the Visual Viewport API);
- * - viewport.width `number` - Viewport width in pixels;
- * - viewport.height `number` - Viewport height in pixels;
- * - viewport.offsetLeft `number` - Viewport left offset in pixels from the layout viewport. Typically 0 unless horizontal scrolling or panning occurs;
- * - viewport.offsetTop `number` - Viewport top offset in pixels from the layout viewport. Becomes negative on iOS when the keyboard appears (e.g., -300px means a 300px keyboard), so use `-offsetTop` for the keyboard height. Typically remains 0 on Android;
- * - viewport.scale `number` - Pinch-zoom scaling factor. 1.0 means no zoom, greater than 1.0 means zoomed in, and less than 1.0 means zoomed out (rare, depends on viewport settings);
+ * @returns {VisualViewportState | null} The Visual Viewport state, or `null` if not supported (SSR or browsers without the Visual Viewport API);
+ * - width `number` - Viewport width in pixels;
+ * - height `number` - Viewport height in pixels;
+ * - offsetLeft `number` - Viewport left offset in pixels from the layout viewport. Typically 0 unless horizontal scrolling or panning occurs;
+ * - offsetTop `number` - Viewport top offset in pixels from the layout viewport. Becomes negative on iOS when the keyboard appears (e.g., -300px means a 300px keyboard), so use `-offsetTop` for the keyboard height. Typically remains 0 on Android;
+ * - scale `number` - Pinch-zoom scaling factor. 1.0 means no zoom, greater than 1.0 means zoomed in, and less than 1.0 means zoomed out (rare, depends on viewport settings);
  *
  * @see {@link useKeyboardHeight} - Simpler hook for keyboard height only
  *
  * @example
  * function CustomLayout() {
- *   const { viewport } = useVisualViewport();
+ *   const viewport = useVisualViewport();
  *
  *   // Always check for null first
  *   if (!viewport) {
@@ -81,7 +80,7 @@ type VisualViewportState = {
  *
  * @example
  * <caption>Detecting zoom</caption>
- * const { viewport } = useVisualViewport();
+ * const viewport = useVisualViewport();
  * if (viewport && viewport.scale > 1.3) {
  *   // Hide floating UI when user zooms in
  *   setShowFloatingButton(false);
@@ -95,7 +94,7 @@ type VisualViewportState = {
  * - **Platform differences**: On iOS `offsetTop` becomes negative when the keyboard appears; on Android it typically stays at 0.
  * - **Use cases**: Detecting the keyboard, reacting to pinch-zoom gestures, building viewport-aware layouts, and showing or hiding UI by zoom level.
  */
-export function useVisualViewport(): { viewport: VisualViewportState | null } {
+export function useVisualViewport(): VisualViewportState | null {
   const visualViewport = isServer() ? null : window.visualViewport;
 
   const [viewport, setViewport] = useState<VisualViewportState | null>(() =>
@@ -121,7 +120,7 @@ export function useVisualViewport(): { viewport: VisualViewportState | null } {
     [updateViewportState]
   );
 
-  return { viewport };
+  return viewport;
 }
 
 function getVisualViewportState(visualViewport: VisualViewport): VisualViewportState {
diff --git a/packages/react-simplikit/src/hooks/useVisualViewport/zh-Hans/useVisualViewport.md b/packages/react-simplikit/src/hooks/useVisualViewport/zh-Hans/useVisualViewport.md
index b1619a00..a9661999 100644
--- a/packages/react-simplikit/src/hooks/useVisualViewport/zh-Hans/useVisualViewport.md
+++ b/packages/react-simplikit/src/hooks/useVisualViewport/zh-Hans/useVisualViewport.md
@@ -5,7 +5,7 @@
 ## 接口
 
 ```ts
-function useVisualViewport(): { viewport: VisualViewportState | null };
+function useVisualViewport(): VisualViewportState | null;
 ```
 
 ### 参数
@@ -16,44 +16,37 @@ function useVisualViewport(): { viewport: VisualViewportState | null };
 
 <Interface
   name=""
-  type="{ viewport: VisualViewportState | null }"
+  type="VisualViewportState | null"
   description="包含 Visual Viewport 状态的对象。"
   :nested="[
     {
-      name: 'viewport',
-      type: 'VisualViewportState | null',
-      required: false,
-      description:
-        'Visual Viewport 状态对象，如果不支持则为 <code>null</code>（服务端渲染或没有 Visual Viewport API 的浏览器）。',
-    },
-    {
-      name: 'viewport.width',
+      name: 'width',
       type: 'number',
       required: false,
       description: '视口宽度（像素）。',
     },
     {
-      name: 'viewport.height',
+      name: 'height',
       type: 'number',
       required: false,
       description: '视口高度（像素）。',
     },
     {
-      name: 'viewport.offsetLeft',
+      name: 'offsetLeft',
       type: 'number',
       required: false,
       description:
         '视口相对于布局视口的左侧偏移（像素）。通常为 0，除非发生水平滚动或平移。',
     },
     {
-      name: 'viewport.offsetTop',
+      name: 'offsetTop',
       type: 'number',
       required: false,
       description:
         '视口相对于布局视口的顶部偏移（像素）。在 iOS 上当键盘出现时会变为负值（例如 -300px 表示 300px 高的键盘），因此可使用 <code>-offsetTop</code> 作为键盘高度。在 Android 上通常保持为 0。',
     },
     {
-      name: 'viewport.scale',
+      name: 'scale',
       type: 'number',
       required: false,
       description:
@@ -66,7 +59,7 @@ function useVisualViewport(): { viewport: VisualViewportState | null };
 
 ```tsx
 function CustomLayout() {
-  const { viewport } = useVisualViewport();
+  const viewport = useVisualViewport();
 
   // 始终先检查是否为 null
   if (!viewport) {
@@ -90,7 +83,7 @@ function CustomLayout() {
 ### 检测缩放
 
 ```tsx
-const { viewport } = useVisualViewport();
+const viewport = useVisualViewport();
 if (viewport && viewport.scale > 1.3) {
   // 当用户放大时隐藏浮动 UI
   setShowFloatingButton(false);