@guksu/wvkit-vue 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Guksu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,183 @@
+'use strict';
+
+var vue = require('vue');
+var wvkitCore = require('@guksu/wvkit-core');
+
+// src/components/safe-area/use-safe-area.ts
+function useSafeArea() {
+  const insets = vue.ref({ top: 0, right: 0, bottom: 0, left: 0 });
+  let instance = null;
+  vue.onMounted(() => {
+    instance = wvkitCore.createSafeArea({
+      onChange: (newInsets) => {
+        insets.value = newInsets;
+      }
+    });
+    insets.value = instance.getInsets();
+  });
+  vue.onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  return insets;
+}
+function useScrollLock() {
+  const isLocked = vue.ref(false);
+  let instance = null;
+  vue.onMounted(() => {
+    instance = wvkitCore.createScrollLock({
+      onLock: () => {
+        isLocked.value = true;
+      },
+      onUnlock: () => {
+        isLocked.value = false;
+      }
+    });
+  });
+  vue.onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  function lock() {
+    instance?.lock();
+  }
+  function unlock() {
+    instance?.unlock();
+  }
+  return { lock, unlock, isLocked };
+}
+function useVirtualKeyboard(options = {}) {
+  const isOpen = vue.ref(false);
+  const keyboardHeight = vue.ref(0);
+  let instance = null;
+  vue.onMounted(() => {
+    instance = wvkitCore.createVirtualKeyboard({
+      ...options.threshold !== void 0 && { threshold: options.threshold },
+      onChange: ({ isOpen: open, keyboardHeight: height }) => {
+        isOpen.value = open;
+        keyboardHeight.value = height;
+      }
+    });
+  });
+  vue.onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  return { isOpen, keyboardHeight };
+}
+function useStableInput(options = {}) {
+  const containerRef = vue.ref(null);
+  let instance = null;
+  vue.onMounted(() => {
+    if (!containerRef.value) return;
+    instance = wvkitCore.createStableInput(containerRef.value, {
+      ...options.type !== void 0 && { type: options.type },
+      ...options.placeholder !== void 0 && { placeholder: options.placeholder },
+      ...options.inputMode !== void 0 && { inputMode: options.inputMode },
+      ...options.autocomplete !== void 0 && { autocomplete: options.autocomplete },
+      ...options.suppressLayoutShift !== void 0 && { suppressLayoutShift: options.suppressLayoutShift },
+      ...options.scrollAnchor !== void 0 && { scrollAnchor: options.scrollAnchor },
+      onChange: (v) => options.onChange?.(v),
+      onFocus: () => options.onFocus?.(),
+      onBlur: () => options.onBlur?.(),
+      onSubmit: (v) => options.onSubmit?.(v)
+    });
+  });
+  vue.onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  function focus() {
+    instance?.focus();
+  }
+  function blur() {
+    instance?.blur();
+  }
+  function setValue(v) {
+    instance?.setValue(v);
+  }
+  function getValue() {
+    return instance?.getValue() ?? "";
+  }
+  return { containerRef, focus, blur, setValue, getValue };
+}
+function useScrollContainer(options) {
+  const containerRef = vue.ref(null);
+  const activeIndex = vue.ref(options.initialIndex ?? 0);
+  const activeZoom = vue.ref(1);
+  let instance = null;
+  vue.onMounted(() => {
+    if (!containerRef.value) return;
+    const wrappedOptions = {
+      ...options,
+      onIndexChange: (index) => {
+        activeIndex.value = index;
+        options.onIndexChange?.(index);
+      },
+      onZoomChange: (zoom) => {
+        activeZoom.value = zoom;
+        options.onZoomChange?.(zoom);
+      }
+    };
+    instance = wvkitCore.createScrollContainer(containerRef.value, wrappedOptions);
+    activeIndex.value = instance.getActiveIndex();
+    activeZoom.value = instance.getZoom();
+  });
+  vue.onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  function scrollTo(index, opts) {
+    instance?.scrollTo(index, opts);
+  }
+  function zoomTo(level, opts) {
+    instance?.zoomTo(level, opts);
+  }
+  return { containerRef, activeIndex, activeZoom, scrollTo, zoomTo };
+}
+function usePullToRefresh(options) {
+  const containerRef = vue.ref(null);
+  const state = vue.ref("idle");
+  const distance = vue.ref(0);
+  const progress = vue.ref(0);
+  let instance = null;
+  vue.onMounted(() => {
+    if (!containerRef.value) return;
+    const wrappedOptions = {
+      ...options,
+      // onRefresh는 wrap 불필요 — options 클로저가 setup 시점 고정이라 stale 없음
+      onRefresh: () => options.onRefresh(),
+      onStateChange: (s) => {
+        state.value = s;
+        options.onStateChange?.(s);
+      },
+      onPull: (d, p) => {
+        distance.value = d;
+        progress.value = p;
+        options.onPull?.(d, p);
+      }
+    };
+    instance = wvkitCore.createPullToRefresh(containerRef.value, wrappedOptions);
+    state.value = instance.getState();
+  });
+  vue.onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  function trigger() {
+    return instance?.trigger() ?? Promise.resolve();
+  }
+  function setEnabled(enabled) {
+    instance?.setEnabled(enabled);
+  }
+  return { containerRef, state, distance, progress, trigger, setEnabled };
+}
+
+exports.usePullToRefresh = usePullToRefresh;
+exports.useSafeArea = useSafeArea;
+exports.useScrollContainer = useScrollContainer;
+exports.useScrollLock = useScrollLock;
+exports.useStableInput = useStableInput;
+exports.useVirtualKeyboard = useVirtualKeyboard;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/safe-area/use-safe-area.ts","../src/components/scroll-lock/use-scroll-lock.ts","../src/components/virtual-keyboard/use-virtual-keyboard.ts","../src/components/stable-input/use-stable-input.ts","../src/components/scroll-container/use-scroll-container.ts","../src/components/pull-to-refresh/use-pull-to-refresh.ts"],"names":["ref","onMounted","createSafeArea","onUnmounted","createScrollLock","createVirtualKeyboard","createStableInput","createScrollContainer","createPullToRefresh"],"mappings":"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","file":"index.cjs","sourcesContent":["import { ref, onMounted, onUnmounted } from 'vue';\nimport { createSafeArea } from '@guksu/wvkit-core';\nimport type { SafeAreaInsets, SafeAreaInstance } from '@guksu/wvkit-core';\n\nexport function useSafeArea() {\n  const insets = ref<SafeAreaInsets>({ top: 0, right: 0, bottom: 0, left: 0 });\n  let instance: SafeAreaInstance | null = null;\n\n  onMounted(() => {\n    instance = createSafeArea({\n      onChange: (newInsets) => {\n        insets.value = newInsets;\n      },\n    });\n    insets.value = instance.getInsets();\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  return insets;\n}\n","import { ref, onMounted, onUnmounted } from 'vue';\nimport { createScrollLock } from '@guksu/wvkit-core';\nimport type { ScrollLockInstance } from '@guksu/wvkit-core';\n\nexport function useScrollLock() {\n  const isLocked = ref(false);\n  let instance: ScrollLockInstance | null = null;\n\n  onMounted(() => {\n    instance = createScrollLock({\n      onLock: () => { isLocked.value = true; },\n      onUnlock: () => { isLocked.value = false; },\n    });\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  function lock() { instance?.lock(); }\n  function unlock() { instance?.unlock(); }\n\n  return { lock, unlock, isLocked };\n}\n","import { ref, onMounted, onUnmounted } from 'vue';\nimport { createVirtualKeyboard } from '@guksu/wvkit-core';\nimport type { VirtualKeyboardInstance } from '@guksu/wvkit-core';\n\ninterface UseVirtualKeyboardOptions {\n  threshold?: number;\n}\n\nexport function useVirtualKeyboard(options: UseVirtualKeyboardOptions = {}) {\n  const isOpen = ref(false);\n  const keyboardHeight = ref(0);\n  let instance: VirtualKeyboardInstance | null = null;\n\n  onMounted(() => {\n    instance = createVirtualKeyboard({\n      ...(options.threshold !== undefined && { threshold: options.threshold }),\n      onChange: ({ isOpen: open, keyboardHeight: height }) => {\n        isOpen.value = open;\n        keyboardHeight.value = height;\n      },\n    });\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  return { isOpen, keyboardHeight };\n}\n","import { ref, onMounted, onUnmounted } from 'vue';\nimport { createStableInput } from '@guksu/wvkit-core';\nimport type { StableInputOptions, StableInputInstance } from '@guksu/wvkit-core';\n\nexport function useStableInput(options: StableInputOptions = {}) {\n  const containerRef = ref<HTMLElement | null>(null);\n  let instance: StableInputInstance | null = null;\n\n  onMounted(() => {\n    if (!containerRef.value) return;\n    instance = createStableInput(containerRef.value, {\n      ...(options.type !== undefined && { type: options.type }),\n      ...(options.placeholder !== undefined && { placeholder: options.placeholder }),\n      ...(options.inputMode !== undefined && { inputMode: options.inputMode }),\n      ...(options.autocomplete !== undefined && { autocomplete: options.autocomplete }),\n      ...(options.suppressLayoutShift !== undefined && { suppressLayoutShift: options.suppressLayoutShift }),\n      ...(options.scrollAnchor !== undefined && { scrollAnchor: options.scrollAnchor }),\n      onChange: (v) => options.onChange?.(v),\n      onFocus: () => options.onFocus?.(),\n      onBlur: () => options.onBlur?.(),\n      onSubmit: (v) => options.onSubmit?.(v),\n    });\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  function focus() { instance?.focus(); }\n  function blur() { instance?.blur(); }\n  function setValue(v: string) { instance?.setValue(v); }\n  function getValue() { return instance?.getValue() ?? ''; }\n\n  return { containerRef, focus, blur, setValue, getValue };\n}\n","import { onMounted, onUnmounted, ref, type Ref } from 'vue';\nimport { createScrollContainer } from '@guksu/wvkit-core';\nimport type { ScrollContainerInstance, ScrollContainerOptions } from '@guksu/wvkit-core';\n\n/**\n * Vue 3 어댑터 — core `createScrollContainer`를 감싸는 컴포저블.\n *\n * 사용 패턴:\n * ```vue\n * <script setup>\n * const { containerRef, activeIndex, activeZoom, scrollTo, zoomTo } =\n *   useScrollContainer({ direction: 'horizontal', panels });\n * </script>\n * <template>\n *   <div ref=\"containerRef\" style=\"position: relative; width: 400px; height: 600px\" />\n * </template>\n * ```\n *\n * 규칙:\n *  - SSR 안전: `createScrollContainer`는 `onMounted` 안에서만 호출\n *  - 사용자 콜백 wrap: state ref 갱신 + 사용자 콜백 호출 (Vue 클로저는 재호출되지 않으므로\n *    React와 달리 stale closure 이슈 없음 — options는 setup 시점에 고정)\n *  - destroy 멱등성에 의존해 HMR/언마운트 안전 (#4에서 보장)\n */\nexport function useScrollContainer(options: ScrollContainerOptions): {\n  containerRef: Ref<HTMLElement | null>;\n  activeIndex: Ref<number>;\n  activeZoom: Ref<number>;\n  scrollTo: (index: number, opts?: { animated?: boolean }) => void;\n  zoomTo: (level: number, opts?: { animated?: boolean }) => void;\n} {\n  const containerRef = ref<HTMLElement | null>(null);\n  const activeIndex = ref<number>(options.initialIndex ?? 0);\n  const activeZoom = ref<number>(1);\n\n  let instance: ScrollContainerInstance | null = null;\n\n  onMounted(() => {\n    if (!containerRef.value) return;\n\n    // 사용자 콜백 wrap: Vue ref 갱신 + 사용자 콜백 호출\n    const wrappedOptions: ScrollContainerOptions = {\n      ...options,\n      onIndexChange: (index) => {\n        activeIndex.value = index;\n        options.onIndexChange?.(index);\n      },\n      onZoomChange: (zoom) => {\n        activeZoom.value = zoom;\n        options.onZoomChange?.(zoom);\n      },\n    };\n\n    instance = createScrollContainer(containerRef.value, wrappedOptions);\n    // core가 클램프/정규화한 초기 값으로 ref 동기화\n    activeIndex.value = instance.getActiveIndex();\n    activeZoom.value = instance.getZoom();\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  function scrollTo(index: number, opts?: { animated?: boolean }): void {\n    instance?.scrollTo(index, opts);\n  }\n\n  function zoomTo(level: number, opts?: { animated?: boolean }): void {\n    instance?.zoomTo(level, opts);\n  }\n\n  return { containerRef, activeIndex, activeZoom, scrollTo, zoomTo };\n}\n","import { onMounted, onUnmounted, ref, type Ref } from 'vue';\nimport { createPullToRefresh } from '@guksu/wvkit-core';\nimport type {\n  PullToRefreshInstance,\n  PullToRefreshOptions,\n  PullToRefreshState,\n} from '@guksu/wvkit-core';\n\n/**\n * Vue 3 어댑터 — core `createPullToRefresh`를 감싸는 컴포저블.\n *\n * 사용 패턴:\n * ```vue\n * <script setup>\n * const { containerRef, state, distance, progress, trigger } = usePullToRefresh({\n *   onRefresh: async () => { await fetchData(); },\n * });\n * </script>\n * <template>\n *   <div ref=\"containerRef\" style=\"overflow-y: auto; height: 400px\">{...}</div>\n * </template>\n * ```\n *\n * 규칙 (useScrollContainer #7 패턴 그대로):\n *  - SSR 안전: `createPullToRefresh`는 `onMounted` 안에서만 호출\n *  - 사용자 콜백 wrap: state ref 갱신 + 사용자 콜백 호출 (Vue 클로저는 재호출되지 않으므로\n *    React와 달리 stale closure 이슈 없음 — options는 setup 시점에 고정)\n *  - destroy 멱등성에 의존해 HMR/언마운트 안전 (#18에서 보장)\n */\nexport function usePullToRefresh(options: PullToRefreshOptions): {\n  containerRef: Ref<HTMLElement | null>;\n  state: Ref<PullToRefreshState>;\n  distance: Ref<number>;\n  progress: Ref<number>;\n  trigger: () => Promise<void>;\n  setEnabled: (enabled: boolean) => void;\n} {\n  const containerRef = ref<HTMLElement | null>(null);\n  const state = ref<PullToRefreshState>('idle');\n  const distance = ref<number>(0);\n  const progress = ref<number>(0);\n\n  let instance: PullToRefreshInstance | null = null;\n\n  onMounted(() => {\n    if (!containerRef.value) return;\n\n    // 사용자 콜백 wrap: Vue ref 갱신 + 사용자 콜백 호출\n    const wrappedOptions: PullToRefreshOptions = {\n      ...options,\n      // onRefresh는 wrap 불필요 — options 클로저가 setup 시점 고정이라 stale 없음\n      onRefresh: () => options.onRefresh(),\n      onStateChange: (s) => {\n        state.value = s;\n        options.onStateChange?.(s);\n      },\n      onPull: (d, p) => {\n        distance.value = d;\n        progress.value = p;\n        options.onPull?.(d, p);\n      },\n    };\n\n    instance = createPullToRefresh(containerRef.value, wrappedOptions);\n    // core가 정규화한 초기 상태 반영\n    state.value = instance.getState();\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  function trigger(): Promise<void> {\n    return instance?.trigger() ?? Promise.resolve();\n  }\n\n  function setEnabled(enabled: boolean): void {\n    instance?.setEnabled(enabled);\n  }\n\n  return { containerRef, state, distance, progress, trigger, setEnabled };\n}\n"]}

package/dist/index.d.cts

@@ -0,0 +1,102 @@
+import * as vue from 'vue';
+import { Ref } from 'vue';
+import { SafeAreaInsets, StableInputOptions, ScrollContainerOptions, PullToRefreshOptions, PullToRefreshState } from '@guksu/wvkit-core';
+export { PullToRefreshInstance, PullToRefreshOptions, PullToRefreshState, ScrollContainerDirection, ScrollContainerInstance, ScrollContainerOptions } from '@guksu/wvkit-core';
+
+declare function useSafeArea(): vue.Ref<{
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}, SafeAreaInsets | {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}>;
+
+declare function useScrollLock(): {
+    lock: () => void;
+    unlock: () => void;
+    isLocked: vue.Ref<boolean, boolean>;
+};
+
+interface UseVirtualKeyboardOptions {
+    threshold?: number;
+}
+declare function useVirtualKeyboard(options?: UseVirtualKeyboardOptions): {
+    isOpen: vue.Ref<boolean, boolean>;
+    keyboardHeight: vue.Ref<number, number>;
+};
+
+declare function useStableInput(options?: StableInputOptions): {
+    containerRef: vue.Ref<HTMLElement | null, HTMLElement | null>;
+    focus: () => void;
+    blur: () => void;
+    setValue: (v: string) => void;
+    getValue: () => string;
+};
+
+/**
+ * Vue 3 어댑터 — core `createScrollContainer`를 감싸는 컴포저블.
+ *
+ * 사용 패턴:
+ * ```vue
+ * <script setup>
+ * const { containerRef, activeIndex, activeZoom, scrollTo, zoomTo } =
+ *   useScrollContainer({ direction: 'horizontal', panels });
+ * </script>
+ * <template>
+ *   <div ref="containerRef" style="position: relative; width: 400px; height: 600px" />
+ * </template>
+ * ```
+ *
+ * 규칙:
+ *  - SSR 안전: `createScrollContainer`는 `onMounted` 안에서만 호출
+ *  - 사용자 콜백 wrap: state ref 갱신 + 사용자 콜백 호출 (Vue 클로저는 재호출되지 않으므로
+ *    React와 달리 stale closure 이슈 없음 — options는 setup 시점에 고정)
+ *  - destroy 멱등성에 의존해 HMR/언마운트 안전 (#4에서 보장)
+ */
+declare function useScrollContainer(options: ScrollContainerOptions): {
+    containerRef: Ref<HTMLElement | null>;
+    activeIndex: Ref<number>;
+    activeZoom: Ref<number>;
+    scrollTo: (index: number, opts?: {
+        animated?: boolean;
+    }) => void;
+    zoomTo: (level: number, opts?: {
+        animated?: boolean;
+    }) => void;
+};
+
+/**
+ * Vue 3 어댑터 — core `createPullToRefresh`를 감싸는 컴포저블.
+ *
+ * 사용 패턴:
+ * ```vue
+ * <script setup>
+ * const { containerRef, state, distance, progress, trigger } = usePullToRefresh({
+ *   onRefresh: async () => { await fetchData(); },
+ * });
+ * </script>
+ * <template>
+ *   <div ref="containerRef" style="overflow-y: auto; height: 400px">{...}</div>
+ * </template>
+ * ```
+ *
+ * 규칙 (useScrollContainer #7 패턴 그대로):
+ *  - SSR 안전: `createPullToRefresh`는 `onMounted` 안에서만 호출
+ *  - 사용자 콜백 wrap: state ref 갱신 + 사용자 콜백 호출 (Vue 클로저는 재호출되지 않으므로
+ *    React와 달리 stale closure 이슈 없음 — options는 setup 시점에 고정)
+ *  - destroy 멱등성에 의존해 HMR/언마운트 안전 (#18에서 보장)
+ */
+declare function usePullToRefresh(options: PullToRefreshOptions): {
+    containerRef: Ref<HTMLElement | null>;
+    state: Ref<PullToRefreshState>;
+    distance: Ref<number>;
+    progress: Ref<number>;
+    trigger: () => Promise<void>;
+    setEnabled: (enabled: boolean) => void;
+};
+
+export { usePullToRefresh, useSafeArea, useScrollContainer, useScrollLock, useStableInput, useVirtualKeyboard };

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+import * as vue from 'vue';
+import { Ref } from 'vue';
+import { SafeAreaInsets, StableInputOptions, ScrollContainerOptions, PullToRefreshOptions, PullToRefreshState } from '@guksu/wvkit-core';
+export { PullToRefreshInstance, PullToRefreshOptions, PullToRefreshState, ScrollContainerDirection, ScrollContainerInstance, ScrollContainerOptions } from '@guksu/wvkit-core';
+
+declare function useSafeArea(): vue.Ref<{
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}, SafeAreaInsets | {
+    top: number;
+    right: number;
+    bottom: number;
+    left: number;
+}>;
+
+declare function useScrollLock(): {
+    lock: () => void;
+    unlock: () => void;
+    isLocked: vue.Ref<boolean, boolean>;
+};
+
+interface UseVirtualKeyboardOptions {
+    threshold?: number;
+}
+declare function useVirtualKeyboard(options?: UseVirtualKeyboardOptions): {
+    isOpen: vue.Ref<boolean, boolean>;
+    keyboardHeight: vue.Ref<number, number>;
+};
+
+declare function useStableInput(options?: StableInputOptions): {
+    containerRef: vue.Ref<HTMLElement | null, HTMLElement | null>;
+    focus: () => void;
+    blur: () => void;
+    setValue: (v: string) => void;
+    getValue: () => string;
+};
+
+/**
+ * Vue 3 어댑터 — core `createScrollContainer`를 감싸는 컴포저블.
+ *
+ * 사용 패턴:
+ * ```vue
+ * <script setup>
+ * const { containerRef, activeIndex, activeZoom, scrollTo, zoomTo } =
+ *   useScrollContainer({ direction: 'horizontal', panels });
+ * </script>
+ * <template>
+ *   <div ref="containerRef" style="position: relative; width: 400px; height: 600px" />
+ * </template>
+ * ```
+ *
+ * 규칙:
+ *  - SSR 안전: `createScrollContainer`는 `onMounted` 안에서만 호출
+ *  - 사용자 콜백 wrap: state ref 갱신 + 사용자 콜백 호출 (Vue 클로저는 재호출되지 않으므로
+ *    React와 달리 stale closure 이슈 없음 — options는 setup 시점에 고정)
+ *  - destroy 멱등성에 의존해 HMR/언마운트 안전 (#4에서 보장)
+ */
+declare function useScrollContainer(options: ScrollContainerOptions): {
+    containerRef: Ref<HTMLElement | null>;
+    activeIndex: Ref<number>;
+    activeZoom: Ref<number>;
+    scrollTo: (index: number, opts?: {
+        animated?: boolean;
+    }) => void;
+    zoomTo: (level: number, opts?: {
+        animated?: boolean;
+    }) => void;
+};
+
+/**
+ * Vue 3 어댑터 — core `createPullToRefresh`를 감싸는 컴포저블.
+ *
+ * 사용 패턴:
+ * ```vue
+ * <script setup>
+ * const { containerRef, state, distance, progress, trigger } = usePullToRefresh({
+ *   onRefresh: async () => { await fetchData(); },
+ * });
+ * </script>
+ * <template>
+ *   <div ref="containerRef" style="overflow-y: auto; height: 400px">{...}</div>
+ * </template>
+ * ```
+ *
+ * 규칙 (useScrollContainer #7 패턴 그대로):
+ *  - SSR 안전: `createPullToRefresh`는 `onMounted` 안에서만 호출
+ *  - 사용자 콜백 wrap: state ref 갱신 + 사용자 콜백 호출 (Vue 클로저는 재호출되지 않으므로
+ *    React와 달리 stale closure 이슈 없음 — options는 setup 시점에 고정)
+ *  - destroy 멱등성에 의존해 HMR/언마운트 안전 (#18에서 보장)
+ */
+declare function usePullToRefresh(options: PullToRefreshOptions): {
+    containerRef: Ref<HTMLElement | null>;
+    state: Ref<PullToRefreshState>;
+    distance: Ref<number>;
+    progress: Ref<number>;
+    trigger: () => Promise<void>;
+    setEnabled: (enabled: boolean) => void;
+};
+
+export { usePullToRefresh, useSafeArea, useScrollContainer, useScrollLock, useStableInput, useVirtualKeyboard };

package/dist/index.js

@@ -0,0 +1,176 @@
+import { ref, onMounted, onUnmounted } from 'vue';
+import { createSafeArea, createScrollLock, createVirtualKeyboard, createStableInput, createScrollContainer, createPullToRefresh } from '@guksu/wvkit-core';
+
+// src/components/safe-area/use-safe-area.ts
+function useSafeArea() {
+  const insets = ref({ top: 0, right: 0, bottom: 0, left: 0 });
+  let instance = null;
+  onMounted(() => {
+    instance = createSafeArea({
+      onChange: (newInsets) => {
+        insets.value = newInsets;
+      }
+    });
+    insets.value = instance.getInsets();
+  });
+  onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  return insets;
+}
+function useScrollLock() {
+  const isLocked = ref(false);
+  let instance = null;
+  onMounted(() => {
+    instance = createScrollLock({
+      onLock: () => {
+        isLocked.value = true;
+      },
+      onUnlock: () => {
+        isLocked.value = false;
+      }
+    });
+  });
+  onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  function lock() {
+    instance?.lock();
+  }
+  function unlock() {
+    instance?.unlock();
+  }
+  return { lock, unlock, isLocked };
+}
+function useVirtualKeyboard(options = {}) {
+  const isOpen = ref(false);
+  const keyboardHeight = ref(0);
+  let instance = null;
+  onMounted(() => {
+    instance = createVirtualKeyboard({
+      ...options.threshold !== void 0 && { threshold: options.threshold },
+      onChange: ({ isOpen: open, keyboardHeight: height }) => {
+        isOpen.value = open;
+        keyboardHeight.value = height;
+      }
+    });
+  });
+  onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  return { isOpen, keyboardHeight };
+}
+function useStableInput(options = {}) {
+  const containerRef = ref(null);
+  let instance = null;
+  onMounted(() => {
+    if (!containerRef.value) return;
+    instance = createStableInput(containerRef.value, {
+      ...options.type !== void 0 && { type: options.type },
+      ...options.placeholder !== void 0 && { placeholder: options.placeholder },
+      ...options.inputMode !== void 0 && { inputMode: options.inputMode },
+      ...options.autocomplete !== void 0 && { autocomplete: options.autocomplete },
+      ...options.suppressLayoutShift !== void 0 && { suppressLayoutShift: options.suppressLayoutShift },
+      ...options.scrollAnchor !== void 0 && { scrollAnchor: options.scrollAnchor },
+      onChange: (v) => options.onChange?.(v),
+      onFocus: () => options.onFocus?.(),
+      onBlur: () => options.onBlur?.(),
+      onSubmit: (v) => options.onSubmit?.(v)
+    });
+  });
+  onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  function focus() {
+    instance?.focus();
+  }
+  function blur() {
+    instance?.blur();
+  }
+  function setValue(v) {
+    instance?.setValue(v);
+  }
+  function getValue() {
+    return instance?.getValue() ?? "";
+  }
+  return { containerRef, focus, blur, setValue, getValue };
+}
+function useScrollContainer(options) {
+  const containerRef = ref(null);
+  const activeIndex = ref(options.initialIndex ?? 0);
+  const activeZoom = ref(1);
+  let instance = null;
+  onMounted(() => {
+    if (!containerRef.value) return;
+    const wrappedOptions = {
+      ...options,
+      onIndexChange: (index) => {
+        activeIndex.value = index;
+        options.onIndexChange?.(index);
+      },
+      onZoomChange: (zoom) => {
+        activeZoom.value = zoom;
+        options.onZoomChange?.(zoom);
+      }
+    };
+    instance = createScrollContainer(containerRef.value, wrappedOptions);
+    activeIndex.value = instance.getActiveIndex();
+    activeZoom.value = instance.getZoom();
+  });
+  onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  function scrollTo(index, opts) {
+    instance?.scrollTo(index, opts);
+  }
+  function zoomTo(level, opts) {
+    instance?.zoomTo(level, opts);
+  }
+  return { containerRef, activeIndex, activeZoom, scrollTo, zoomTo };
+}
+function usePullToRefresh(options) {
+  const containerRef = ref(null);
+  const state = ref("idle");
+  const distance = ref(0);
+  const progress = ref(0);
+  let instance = null;
+  onMounted(() => {
+    if (!containerRef.value) return;
+    const wrappedOptions = {
+      ...options,
+      // onRefresh는 wrap 불필요 — options 클로저가 setup 시점 고정이라 stale 없음
+      onRefresh: () => options.onRefresh(),
+      onStateChange: (s) => {
+        state.value = s;
+        options.onStateChange?.(s);
+      },
+      onPull: (d, p) => {
+        distance.value = d;
+        progress.value = p;
+        options.onPull?.(d, p);
+      }
+    };
+    instance = createPullToRefresh(containerRef.value, wrappedOptions);
+    state.value = instance.getState();
+  });
+  onUnmounted(() => {
+    instance?.destroy();
+    instance = null;
+  });
+  function trigger() {
+    return instance?.trigger() ?? Promise.resolve();
+  }
+  function setEnabled(enabled) {
+    instance?.setEnabled(enabled);
+  }
+  return { containerRef, state, distance, progress, trigger, setEnabled };
+}
+
+export { usePullToRefresh, useSafeArea, useScrollContainer, useScrollLock, useStableInput, useVirtualKeyboard };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/safe-area/use-safe-area.ts","../src/components/scroll-lock/use-scroll-lock.ts","../src/components/virtual-keyboard/use-virtual-keyboard.ts","../src/components/stable-input/use-stable-input.ts","../src/components/scroll-container/use-scroll-container.ts","../src/components/pull-to-refresh/use-pull-to-refresh.ts"],"names":["ref","onMounted","onUnmounted"],"mappings":"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","file":"index.js","sourcesContent":["import { ref, onMounted, onUnmounted } from 'vue';\nimport { createSafeArea } from '@guksu/wvkit-core';\nimport type { SafeAreaInsets, SafeAreaInstance } from '@guksu/wvkit-core';\n\nexport function useSafeArea() {\n  const insets = ref<SafeAreaInsets>({ top: 0, right: 0, bottom: 0, left: 0 });\n  let instance: SafeAreaInstance | null = null;\n\n  onMounted(() => {\n    instance = createSafeArea({\n      onChange: (newInsets) => {\n        insets.value = newInsets;\n      },\n    });\n    insets.value = instance.getInsets();\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  return insets;\n}\n","import { ref, onMounted, onUnmounted } from 'vue';\nimport { createScrollLock } from '@guksu/wvkit-core';\nimport type { ScrollLockInstance } from '@guksu/wvkit-core';\n\nexport function useScrollLock() {\n  const isLocked = ref(false);\n  let instance: ScrollLockInstance | null = null;\n\n  onMounted(() => {\n    instance = createScrollLock({\n      onLock: () => { isLocked.value = true; },\n      onUnlock: () => { isLocked.value = false; },\n    });\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  function lock() { instance?.lock(); }\n  function unlock() { instance?.unlock(); }\n\n  return { lock, unlock, isLocked };\n}\n","import { ref, onMounted, onUnmounted } from 'vue';\nimport { createVirtualKeyboard } from '@guksu/wvkit-core';\nimport type { VirtualKeyboardInstance } from '@guksu/wvkit-core';\n\ninterface UseVirtualKeyboardOptions {\n  threshold?: number;\n}\n\nexport function useVirtualKeyboard(options: UseVirtualKeyboardOptions = {}) {\n  const isOpen = ref(false);\n  const keyboardHeight = ref(0);\n  let instance: VirtualKeyboardInstance | null = null;\n\n  onMounted(() => {\n    instance = createVirtualKeyboard({\n      ...(options.threshold !== undefined && { threshold: options.threshold }),\n      onChange: ({ isOpen: open, keyboardHeight: height }) => {\n        isOpen.value = open;\n        keyboardHeight.value = height;\n      },\n    });\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  return { isOpen, keyboardHeight };\n}\n","import { ref, onMounted, onUnmounted } from 'vue';\nimport { createStableInput } from '@guksu/wvkit-core';\nimport type { StableInputOptions, StableInputInstance } from '@guksu/wvkit-core';\n\nexport function useStableInput(options: StableInputOptions = {}) {\n  const containerRef = ref<HTMLElement | null>(null);\n  let instance: StableInputInstance | null = null;\n\n  onMounted(() => {\n    if (!containerRef.value) return;\n    instance = createStableInput(containerRef.value, {\n      ...(options.type !== undefined && { type: options.type }),\n      ...(options.placeholder !== undefined && { placeholder: options.placeholder }),\n      ...(options.inputMode !== undefined && { inputMode: options.inputMode }),\n      ...(options.autocomplete !== undefined && { autocomplete: options.autocomplete }),\n      ...(options.suppressLayoutShift !== undefined && { suppressLayoutShift: options.suppressLayoutShift }),\n      ...(options.scrollAnchor !== undefined && { scrollAnchor: options.scrollAnchor }),\n      onChange: (v) => options.onChange?.(v),\n      onFocus: () => options.onFocus?.(),\n      onBlur: () => options.onBlur?.(),\n      onSubmit: (v) => options.onSubmit?.(v),\n    });\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  function focus() { instance?.focus(); }\n  function blur() { instance?.blur(); }\n  function setValue(v: string) { instance?.setValue(v); }\n  function getValue() { return instance?.getValue() ?? ''; }\n\n  return { containerRef, focus, blur, setValue, getValue };\n}\n","import { onMounted, onUnmounted, ref, type Ref } from 'vue';\nimport { createScrollContainer } from '@guksu/wvkit-core';\nimport type { ScrollContainerInstance, ScrollContainerOptions } from '@guksu/wvkit-core';\n\n/**\n * Vue 3 어댑터 — core `createScrollContainer`를 감싸는 컴포저블.\n *\n * 사용 패턴:\n * ```vue\n * <script setup>\n * const { containerRef, activeIndex, activeZoom, scrollTo, zoomTo } =\n *   useScrollContainer({ direction: 'horizontal', panels });\n * </script>\n * <template>\n *   <div ref=\"containerRef\" style=\"position: relative; width: 400px; height: 600px\" />\n * </template>\n * ```\n *\n * 규칙:\n *  - SSR 안전: `createScrollContainer`는 `onMounted` 안에서만 호출\n *  - 사용자 콜백 wrap: state ref 갱신 + 사용자 콜백 호출 (Vue 클로저는 재호출되지 않으므로\n *    React와 달리 stale closure 이슈 없음 — options는 setup 시점에 고정)\n *  - destroy 멱등성에 의존해 HMR/언마운트 안전 (#4에서 보장)\n */\nexport function useScrollContainer(options: ScrollContainerOptions): {\n  containerRef: Ref<HTMLElement | null>;\n  activeIndex: Ref<number>;\n  activeZoom: Ref<number>;\n  scrollTo: (index: number, opts?: { animated?: boolean }) => void;\n  zoomTo: (level: number, opts?: { animated?: boolean }) => void;\n} {\n  const containerRef = ref<HTMLElement | null>(null);\n  const activeIndex = ref<number>(options.initialIndex ?? 0);\n  const activeZoom = ref<number>(1);\n\n  let instance: ScrollContainerInstance | null = null;\n\n  onMounted(() => {\n    if (!containerRef.value) return;\n\n    // 사용자 콜백 wrap: Vue ref 갱신 + 사용자 콜백 호출\n    const wrappedOptions: ScrollContainerOptions = {\n      ...options,\n      onIndexChange: (index) => {\n        activeIndex.value = index;\n        options.onIndexChange?.(index);\n      },\n      onZoomChange: (zoom) => {\n        activeZoom.value = zoom;\n        options.onZoomChange?.(zoom);\n      },\n    };\n\n    instance = createScrollContainer(containerRef.value, wrappedOptions);\n    // core가 클램프/정규화한 초기 값으로 ref 동기화\n    activeIndex.value = instance.getActiveIndex();\n    activeZoom.value = instance.getZoom();\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  function scrollTo(index: number, opts?: { animated?: boolean }): void {\n    instance?.scrollTo(index, opts);\n  }\n\n  function zoomTo(level: number, opts?: { animated?: boolean }): void {\n    instance?.zoomTo(level, opts);\n  }\n\n  return { containerRef, activeIndex, activeZoom, scrollTo, zoomTo };\n}\n","import { onMounted, onUnmounted, ref, type Ref } from 'vue';\nimport { createPullToRefresh } from '@guksu/wvkit-core';\nimport type {\n  PullToRefreshInstance,\n  PullToRefreshOptions,\n  PullToRefreshState,\n} from '@guksu/wvkit-core';\n\n/**\n * Vue 3 어댑터 — core `createPullToRefresh`를 감싸는 컴포저블.\n *\n * 사용 패턴:\n * ```vue\n * <script setup>\n * const { containerRef, state, distance, progress, trigger } = usePullToRefresh({\n *   onRefresh: async () => { await fetchData(); },\n * });\n * </script>\n * <template>\n *   <div ref=\"containerRef\" style=\"overflow-y: auto; height: 400px\">{...}</div>\n * </template>\n * ```\n *\n * 규칙 (useScrollContainer #7 패턴 그대로):\n *  - SSR 안전: `createPullToRefresh`는 `onMounted` 안에서만 호출\n *  - 사용자 콜백 wrap: state ref 갱신 + 사용자 콜백 호출 (Vue 클로저는 재호출되지 않으므로\n *    React와 달리 stale closure 이슈 없음 — options는 setup 시점에 고정)\n *  - destroy 멱등성에 의존해 HMR/언마운트 안전 (#18에서 보장)\n */\nexport function usePullToRefresh(options: PullToRefreshOptions): {\n  containerRef: Ref<HTMLElement | null>;\n  state: Ref<PullToRefreshState>;\n  distance: Ref<number>;\n  progress: Ref<number>;\n  trigger: () => Promise<void>;\n  setEnabled: (enabled: boolean) => void;\n} {\n  const containerRef = ref<HTMLElement | null>(null);\n  const state = ref<PullToRefreshState>('idle');\n  const distance = ref<number>(0);\n  const progress = ref<number>(0);\n\n  let instance: PullToRefreshInstance | null = null;\n\n  onMounted(() => {\n    if (!containerRef.value) return;\n\n    // 사용자 콜백 wrap: Vue ref 갱신 + 사용자 콜백 호출\n    const wrappedOptions: PullToRefreshOptions = {\n      ...options,\n      // onRefresh는 wrap 불필요 — options 클로저가 setup 시점 고정이라 stale 없음\n      onRefresh: () => options.onRefresh(),\n      onStateChange: (s) => {\n        state.value = s;\n        options.onStateChange?.(s);\n      },\n      onPull: (d, p) => {\n        distance.value = d;\n        progress.value = p;\n        options.onPull?.(d, p);\n      },\n    };\n\n    instance = createPullToRefresh(containerRef.value, wrappedOptions);\n    // core가 정규화한 초기 상태 반영\n    state.value = instance.getState();\n  });\n\n  onUnmounted(() => {\n    instance?.destroy();\n    instance = null;\n  });\n\n  function trigger(): Promise<void> {\n    return instance?.trigger() ?? Promise.resolve();\n  }\n\n  function setEnabled(enabled: boolean): void {\n    instance?.setEnabled(enabled);\n  }\n\n  return { containerRef, state, distance, progress, trigger, setEnabled };\n}\n"]}

package/package.json

@@ -0,0 +1,78 @@
+{
+  "name": "@guksu/wvkit-vue",
+  "version": "0.2.0",
+  "description": "Headless UI primitives for WebView — Vue 3 adapter (composables + renderless components)",
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "license": "MIT",
+  "author": {
+    "name": "Guksu",
+    "url": "https://github.com/Guksu"
+  },
+  "homepage": "https://github.com/Guksu/wvkit#readme",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Guksu/wvkit.git",
+    "directory": "packages/vue"
+  },
+  "bugs": {
+    "url": "https://github.com/Guksu/wvkit/issues"
+  },
+  "keywords": [
+    "webview",
+    "headless",
+    "vue",
+    "vue3",
+    "composables",
+    "scroll",
+    "pull-to-refresh",
+    "stable-input",
+    "safe-area",
+    "virtual-keyboard",
+    "ios",
+    "android",
+    "wkwebview",
+    "typescript"
+  ],
+  "dependencies": {
+    "@guksu/wvkit-core": "0.2.0"
+  },
+  "peerDependencies": {
+    "vue": ">=3.4.0"
+  },
+  "devDependencies": {
+    "@vitejs/plugin-vue": "^5.2.1",
+    "@vitest/coverage-v8": "^2.1.8",
+    "@vue/test-utils": "^2.4.6",
+    "happy-dom": "^15.11.7",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8",
+    "vue": "^3.5.13"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  }
+}