@xiao-ying/miniapp-hooks 1.1.0

package/LICENSE

@@ -0,0 +1,35 @@
+Shanghai Plum Technology Ltd. Software License Agreement
+
+This License Agreement ("Agreement") is a legal agreement between you (either an individual or a single entity, hereafter "Licensee") and Shanghai Plum Technology Ltd. ("Plum") for the software product accompanying this Agreement, which includes computer software and may include associated media, printed materials, and "online" or electronic documentation ("Software").
+
+BY INSTALLING, COPYING, OR OTHERWISE USING THE SOFTWARE, YOU AGREE TO BE BOUND BY THE TERMS OF THIS AGREEMENT. IF YOU DO NOT AGREE TO THE TERMS OF THIS AGREEMENT, DO NOT INSTALL OR USE THE SOFTWARE.
+
+1. Grant of License. Plum grants Licensee a non-exclusive, non-transferable, limited license to use the Software solely for Licensee's internal business purposes, subject to the terms and conditions of this Agreement. THIS LICENSE IS GRANTED ONLY TO ENTITIES OR INDIVIDUALS WHO HAVE OBTAINED AN OFFICIAL SERVICE AGREEMENT OR WRITTEN AUTHORIZATION FROM PLUM.
+
+2. Ownership. The Software is owned and copyrighted by Plum or its suppliers. Your license confers no title or ownership in the Software and is not a sale of any rights in the Software. All rights not expressly granted to you are reserved by Plum.
+
+3. Restrictions. You may not:
+    * Reverse engineer, decompile, or disassemble the Software, except and only to the extent that such activity is expressly permitted by applicable law notwithstanding this limitation.
+    * Modify, translate, or create derivative works based on the Software.
+    * Rent, lease, lend, or provide commercial hosting services with the Software.
+    * Transfer the Software or this license to any third party.
+    * Remove or alter any copyright notices or other proprietary markings on or in the Software.
+    * Use the software in any way that violates applicable laws or regulations.
+
+4. Termination. Without prejudice to any other rights, Plum may terminate this Agreement if you fail to comply with any of the terms and conditions of this Agreement. In such event, you must destroy all copies of the Software and all of its component parts.
+
+5. Limited Warranty. Plum warrants that the media on which the Software is distributed (if any) will be free from defects in materials and workmanship for a period of thirty (30) days from the date of delivery. Plum's entire liability and your exclusive remedy for any breach of this limited warranty shall be, at Plum's option, either (a) return of the price paid, or (b) replacement of the defective media.
+
+6. Disclaimer of Warranties. EXCEPT AS PROVIDED ABOVE, THE SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. PLUM DISCLAIMS ALL OTHER WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+7. Limitation of Liability. IN NO EVENT SHALL PLUM BE LIABLE FOR ANY DAMAGES WHATSOEVER (INCLUDING, WITHOUT LIMITATION, DAMAGES FOR LOSS OF BUSINESS PROFIT, BUSINESS INTERRUPTION, LOSS OF BUSINESS INFORMATION, OR ANY OTHER PECUNIARY LOSS) ARISING OUT OF THE USE OF OR INABILITY TO USE THE SOFTWARE, EVEN IF PLUM HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES.
+
+8. Governing Law. This Agreement shall be governed by and construed in accordance with the laws of the People's Republic of China, without regard to its conflict of law principles.
+
+9. Entire Agreement. This Agreement constitutes the entire agreement between the parties with respect to the subject matter hereof and supersedes all prior or contemporaneous communications and proposals, whether oral or written.
+
+10. Severability. If any provision of this Agreement is held to be invalid or unenforceable, the remaining provisions of this Agreement will remain in full force and effect.
+
+Shanghai Plum Technology Ltd.
+Address: Shanghai, China.
+Email: liplum@liplum.net

package/README.md

@@ -0,0 +1,47 @@
+# @xiao-ying/miniapp-hooks
+
+基于 `@xiao-ying/miniapp-sdk` 的通用 React hooks（不包含 cloud/snapshot）。
+
+## 安装
+
+```bash
+pnpm add @xiao-ying/miniapp-hooks @xiao-ying/miniapp-sdk react
+```
+
+## Hook 列表
+
+- `useBrightness()`：订阅原生/浏览器亮度变化，返回 `{ brightness, isDark }`。
+- `useForeground()`：订阅前后台变化，返回 `{ isForeground }`。
+- `useMediaQuery()`：暴露注入的 `mediaQuery`（安全区、DPR、尺寸）。
+- `useStorage(key, options?)`：与 `xy.onStorageChange` 同步，提供 `value`、`loading`、`error` 以及 `setValue/remove/refresh`。
+- `useShare(input?)`：注册分享处理器，自动补齐默认 path/title。
+- `useHapticFeedback(options?)`（别名 `useHapticPress`）：封装 `xy.vibrate`。
+- `useSdkError(options?)`：订阅 `xy.onError`，缓存过滤后的错误并返回 `latest`、`errors`、`clear`。
+- `useAuthState()`：订阅登录态变化，返回 `{ authState, hasAuthPermission, isSignedIn, userId }`。
+
+> cloud/snapshot hooks 已迁移到：
+> - `@xiao-ying/miniapp-cloud-kit`（core API）
+> - `@xiao-ying/miniapp-cloud-hooks`（SWR hooks）
+
+## 快速示例
+
+```tsx
+import { useBrightness, useStorage } from '@xiao-ying/miniapp-hooks'
+
+const Preferences = () => {
+  const { brightness, isDark } = useBrightness()
+  const theme = isDark ? 'dark' : 'light'
+  const storage = useStorage<string>('nickname', { defaultValue: '游客' })
+
+  return (
+    <div data-theme={theme}>
+      <p>当前模式: {brightness}</p>
+      <input
+        value={storage.value ?? ''}
+        onChange={(e) => storage.setValue(e.target.value)}
+        placeholder="输入昵称"
+      />
+    </div>
+  )
+}
+```

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { useBrightness } from './use-brightness.js';
+export { useForeground } from './use-foreground.js';
+export { useMediaQuery, type UseMediaQueryResult } from './use-media-query.js';
+export { useStorage, type UseStorageOptions, type UseStorageResult } from './use-storage.js';
+export { useShare } from './use-share.js';
+export { useHapticFeedback, type UseHapticFeedbackOptions } from './use-haptic-feedback.js';
+export { useSdkError, type UseSdkErrorOptions, type UseSdkErrorResult, type UseSdkErrorFilter } from './use-sdk-error.js';
+export { useHapticFeedback as useHapticPress } from './use-haptic-feedback.js';
+export { useAuthState } from './use-auth-state.js';
+export type { XYSdk, XYMediaQuery, XYSafeAreaInsets, XYViewportSize, XYBrightnessEvent, XYStorageEvent, XyShareData, XyShareHandlerPayload, MaybePromise } from '@xiao-ying/miniapp-sdk';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EACL,aAAa,EACb,KAAK,mBAAmB,EACzB,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,UAAU,EACV,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACtB,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAE,KAAK,wBAAwB,EAAE,MAAM,0BAA0B,CAAA;AAC3F,OAAO,EACL,WAAW,EACX,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACvB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EAAE,iBAAiB,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA;AAElD,YAAY,EACV,KAAK,EACL,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,qBAAqB,EACrB,YAAY,EACb,MAAM,wBAAwB,CAAA"}

package/dist/index.js

@@ -0,0 +1,12 @@
+'use client';
+export { useBrightness } from './use-brightness.js';
+export { useForeground } from './use-foreground.js';
+export { useMediaQuery } from './use-media-query.js';
+export { useStorage } from './use-storage.js';
+export { useShare } from './use-share.js';
+export { useHapticFeedback } from './use-haptic-feedback.js';
+export { useSdkError } from './use-sdk-error.js';
+// Backward compatibility
+export { useHapticFeedback as useHapticPress } from './use-haptic-feedback.js';
+export { useAuthState } from './use-auth-state.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AAEZ,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAA;AACnD,OAAO,EACL,aAAa,EAEd,MAAM,sBAAsB,CAAA;AAC7B,OAAO,EACL,UAAU,EAGX,MAAM,kBAAkB,CAAA;AACzB,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AACzC,OAAO,EAAE,iBAAiB,EAAiC,MAAM,0BAA0B,CAAA;AAC3F,OAAO,EACL,WAAW,EAIZ,MAAM,oBAAoB,CAAA;AAC3B,yBAAyB;AACzB,OAAO,EAAE,iBAAiB,IAAI,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAC9E,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAA"}

package/dist/use-auth-state.d.ts

@@ -0,0 +1,18 @@
+import type { XYAuthState } from '@xiao-ying/miniapp-sdk';
+type AuthState = XYAuthState | undefined;
+/**
+ * 获取并订阅宿主认证状态，提供常用派生字段。
+ *
+ * @returns `{ authState, hasAuthPermission, isSignedIn, userId }`
+ *
+ * @example
+ * const { isSignedIn } = useAuthState()
+ */
+export declare const useAuthState: () => {
+    authState: AuthState;
+    hasAuthPermission: boolean;
+    isSignedIn: boolean;
+    userId: string | undefined;
+};
+export {};
+//# sourceMappingURL=use-auth-state.d.ts.map

package/dist/use-auth-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-auth-state.d.ts","sourceRoot":"","sources":["../src/use-auth-state.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAGzD,KAAK,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;AAYxC;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY;;;;;CA0BxB,CAAA"}

package/dist/use-auth-state.js

@@ -0,0 +1,44 @@
+import { useEffect, useMemo, useState } from 'react';
+const readAuthState = () => {
+    try {
+        const current = xy.getAuthState();
+        if (typeof current === 'undefined')
+            return undefined;
+        return current ?? { state: 'notSignedIn' };
+    }
+    catch (_) {
+        return { state: 'notSignedIn' };
+    }
+};
+/**
+ * 获取并订阅宿主认证状态，提供常用派生字段。
+ *
+ * @returns `{ authState, hasAuthPermission, isSignedIn, userId }`
+ *
+ * @example
+ * const { isSignedIn } = useAuthState()
+ */
+export const useAuthState = () => {
+    const [authState, setAuthState] = useState(() => readAuthState());
+    useEffect(() => {
+        if (typeof xy.onAuthStateChange !== 'function')
+            return;
+        const unsubscribe = xy.onAuthStateChange((next) => {
+            if (typeof next === 'undefined') {
+                setAuthState(undefined);
+            }
+            else {
+                setAuthState(next ?? { state: 'notSignedIn' });
+            }
+        });
+        return unsubscribe;
+    }, []);
+    const derived = useMemo(() => ({
+        authState,
+        hasAuthPermission: typeof authState !== 'undefined',
+        isSignedIn: authState?.state === 'signedIn',
+        userId: authState?.state === 'signedIn' ? authState.userId : undefined,
+    }), [authState]);
+    return derived;
+};
+//# sourceMappingURL=use-auth-state.js.map

package/dist/use-auth-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-auth-state.js","sourceRoot":"","sources":["../src/use-auth-state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAMpD,MAAM,aAAa,GAAG,GAAc,EAAE;IACpC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,EAAE,CAAA;QACjC,IAAI,OAAO,OAAO,KAAK,WAAW;YAAE,OAAO,SAAS,CAAA;QACpD,OAAO,OAAO,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA;IAC5C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,KAAK,EAAE,aAAa,EAAE,CAAA;IACjC,CAAC;AACH,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE;IAC/B,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAY,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC,CAAA;IAE5E,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,CAAC,iBAAiB,KAAK,UAAU;YAAE,OAAM;QACtD,MAAM,WAAW,GAAG,EAAE,CAAC,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE;YAChD,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;gBAChC,YAAY,CAAC,SAAS,CAAC,CAAA;YACzB,CAAC;iBAAM,CAAC;gBACN,YAAY,CAAC,IAAI,IAAI,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAA;YAChD,CAAC;QACH,CAAC,CAAC,CAAA;QACF,OAAO,WAAW,CAAA;IACpB,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,CAAC;QACL,SAAS;QACT,iBAAiB,EAAE,OAAO,SAAS,KAAK,WAAW;QACnD,UAAU,EAAE,SAAS,EAAE,KAAK,KAAK,UAAU;QAC3C,MAAM,EAAE,SAAS,EAAE,KAAK,KAAK,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;KACvE,CAAC,EACF,CAAC,SAAS,CAAC,CACZ,CAAA;IAED,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA"}

package/dist/use-brightness.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 订阅宿主亮度变化并返回当前亮度信息。
+ *
+ * @returns `{ brightness, isDark }`，亮度变化会触发重新渲染。
+ *
+ * @example
+ * const { brightness, isDark } = useBrightness()
+ */
+export declare const useBrightness: () => {
+    brightness: "light" | "dark";
+    isDark: boolean;
+};
+//# sourceMappingURL=use-brightness.d.ts.map

package/dist/use-brightness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brightness.d.ts","sourceRoot":"","sources":["../src/use-brightness.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAAO;IAAE,UAAU,EAAE,OAAO,GAAG,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAiC/E,CAAA"}

package/dist/use-brightness.js

@@ -0,0 +1,38 @@
+import { useEffect, useMemo, useState } from 'react';
+/**
+ * 订阅宿主亮度变化并返回当前亮度信息。
+ *
+ * @returns `{ brightness, isDark }`，亮度变化会触发重新渲染。
+ *
+ * @example
+ * const { brightness, isDark } = useBrightness()
+ */
+export const useBrightness = () => {
+    const [brightness, setBrightness] = useState(() => {
+        try {
+            return xy.brightness() === 'dark' ? 'dark' : 'light';
+        }
+        catch (_) {
+            return 'light';
+        }
+    });
+    useEffect(() => {
+        if (typeof xy.onBrightnessChange !== 'function') {
+            return;
+        }
+        const unsubscribe = xy.onBrightnessChange((event) => {
+            const next = event?.brightness === 'dark' ? 'dark' : 'light';
+            setBrightness(next);
+        });
+        return () => {
+            if (typeof unsubscribe === 'function') {
+                unsubscribe();
+            }
+        };
+    }, [xy]);
+    return useMemo(() => ({
+        brightness,
+        isDark: brightness === 'dark'
+    }), [brightness]);
+};
+//# sourceMappingURL=use-brightness.js.map

package/dist/use-brightness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-brightness.js","sourceRoot":"","sources":["../src/use-brightness.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAEpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAsD,EAAE;IACnF,MAAM,CAAC,UAAU,EAAE,aAAa,CAAC,GAAG,QAAQ,CAAmB,GAAG,EAAE;QAClE,IAAI,CAAC;YACH,OAAO,EAAE,CAAC,UAAU,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;QACtD,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,OAAO,CAAA;QAChB,CAAC;IACH,CAAC,CAAC,CAAA;IAEF,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,OAAO,EAAE,CAAC,kBAAkB,KAAK,UAAU,EAAE,CAAC;YAChD,OAAM;QACR,CAAC;QAED,MAAM,WAAW,GAAG,EAAE,CAAC,kBAAkB,CAAC,CAAC,KAAK,EAAE,EAAE;YAClD,MAAM,IAAI,GAAG,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAA;YAC5D,aAAa,CAAC,IAAI,CAAC,CAAA;QACrB,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE;YACV,IAAI,OAAO,WAAW,KAAK,UAAU,EAAE,CAAC;gBACtC,WAAW,EAAE,CAAA;YACf,CAAC;QACH,CAAC,CAAA;IACH,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAA;IAER,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,UAAU;QACV,MAAM,EAAE,UAAU,KAAK,MAAM;KAC9B,CAAC,EACF,CAAC,UAAU,CAAC,CACb,CAAA;AACH,CAAC,CAAA"}

package/dist/use-foreground.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 订阅前后台状态变化并返回当前前台状态。
+ *
+ * @returns `{ isForeground }`。
+ *
+ * @example
+ * const { isForeground } = useForeground()
+ */
+export declare const useForeground: () => {
+    isForeground: boolean;
+};
+//# sourceMappingURL=use-foreground.d.ts.map

package/dist/use-foreground.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-foreground.d.ts","sourceRoot":"","sources":["../src/use-foreground.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAAO;IAAE,YAAY,EAAE,OAAO,CAAA;CAkBvD,CAAA"}

package/dist/use-foreground.js

@@ -0,0 +1,24 @@
+import { useEffect, useMemo, useState } from 'react';
+/**
+ * 订阅前后台状态变化并返回当前前台状态。
+ *
+ * @returns `{ isForeground }`。
+ *
+ * @example
+ * const { isForeground } = useForeground()
+ */
+export const useForeground = () => {
+    const [isForeground, setIsForeground] = useState(() => !!xy.isForeground());
+    useEffect(() => {
+        const offBg = xy.onBackground(() => setIsForeground(false));
+        const offFg = xy.onForeground(() => setIsForeground(true));
+        return () => {
+            offBg();
+            offFg();
+        };
+    }, []);
+    return useMemo(() => ({
+        isForeground
+    }), [isForeground]);
+};
+//# sourceMappingURL=use-foreground.js.map

package/dist/use-foreground.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-foreground.js","sourceRoot":"","sources":["../src/use-foreground.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAA8B,EAAE;IAC3D,MAAM,CAAC,YAAY,EAAE,eAAe,CAAC,GAAG,QAAQ,CAAU,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,CAAA;IAEpF,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAA;QAC3D,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAA;QAC1D,OAAO,GAAG,EAAE;YACV,KAAK,EAAE,CAAA;YACP,KAAK,EAAE,CAAA;QACT,CAAC,CAAA;IACH,CAAC,EAAE,EAAE,CAAC,CAAA;IAEN,OAAO,OAAO,CACZ,GAAG,EAAE,CAAC,CAAC;QACL,YAAY;KACb,CAAC,EACF,CAAC,YAAY,CAAC,CACf,CAAA;AACH,CAAC,CAAA"}

package/dist/use-haptic-feedback.d.ts

@@ -0,0 +1,20 @@
+import type { XYVibrateImpact } from '@xiao-ying/miniapp-sdk';
+/**
+ * 触感反馈 Hook 的配置项。
+ *
+ * @param impact - 震动强度；传 `false` 禁用。
+ * @param disabled - 是否禁用。
+ */
+export interface UseHapticFeedbackOptions {
+    impact?: XYVibrateImpact | false;
+    disabled?: boolean;
+}
+/**
+ * 返回可复用的触感反馈触发函数；禁用或不支持时为空操作。
+ *
+ * @example
+ * const haptic = useHapticFeedback({ impact: 'medium' })
+ * <button onClick={haptic}>Click</button>
+ */
+export declare const useHapticFeedback: (options?: UseHapticFeedbackOptions) => (() => void);
+//# sourceMappingURL=use-haptic-feedback.d.ts.map

package/dist/use-haptic-feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-haptic-feedback.d.ts","sourceRoot":"","sources":["../src/use-haptic-feedback.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAA;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,wBAAwB;IACvC,MAAM,CAAC,EAAE,eAAe,GAAG,KAAK,CAAA;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,GAAI,UAAS,wBAA6B,KAAG,CAAC,MAAM,IAAI,CAUrF,CAAA"}

package/dist/use-haptic-feedback.js

@@ -0,0 +1,21 @@
+import { useCallback } from 'react';
+/**
+ * 返回可复用的触感反馈触发函数；禁用或不支持时为空操作。
+ *
+ * @example
+ * const haptic = useHapticFeedback({ impact: 'medium' })
+ * <button onClick={haptic}>Click</button>
+ */
+export const useHapticFeedback = (options = {}) => {
+    const { impact = 'selection', disabled = false } = options;
+    return useCallback(() => {
+        if (disabled || impact === false)
+            return;
+        if (typeof xy.vibrate !== 'function')
+            return;
+        void xy.vibrate({ impact }).catch(() => {
+            /* best-effort */
+        });
+    }, [disabled, impact, xy]);
+};
+//# sourceMappingURL=use-haptic-feedback.js.map

package/dist/use-haptic-feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-haptic-feedback.js","sourceRoot":"","sources":["../src/use-haptic-feedback.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,OAAO,CAAA;AAcnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,UAAoC,EAAE,EAAgB,EAAE;IACxF,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,QAAQ,GAAG,KAAK,EAAE,GAAG,OAAO,CAAA;IAE1D,OAAO,WAAW,CAAC,GAAG,EAAE;QACtB,IAAI,QAAQ,IAAI,MAAM,KAAK,KAAK;YAAE,OAAM;QACxC,IAAI,OAAO,EAAE,CAAC,OAAO,KAAK,UAAU;YAAE,OAAM;QAC5C,KAAK,EAAE,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE;YACrC,iBAAiB;QACnB,CAAC,CAAC,CAAA;IACJ,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,CAAA;AAC5B,CAAC,CAAA"}

package/dist/use-media-query.d.ts

@@ -0,0 +1,20 @@
+import type { XYMediaQuery } from '@xiao-ying/miniapp-sdk';
+/**
+ * useMediaQuery 的返回结果（安全区、尺寸、DPR 等）。
+ *
+ * @property safeAreaInsets - 安全区内边距（px）。
+ * @property size - 视口尺寸（px）。
+ * @property devicePixelRatio - 设备 DPR。
+ */
+export interface UseMediaQueryResult extends XYMediaQuery {
+}
+/**
+ * 获取媒体查询信息（安全区/尺寸/DPR），基于当前 `xy.mediaQuery` 快照。
+ *
+ * @returns 规范化后的媒体查询信息（数值兜底）。
+ *
+ * @example
+ * const { safeAreaInsets } = useMediaQuery()
+ */
+export declare const useMediaQuery: () => UseMediaQueryResult;
+//# sourceMappingURL=use-media-query.d.ts.map

package/dist/use-media-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.d.ts","sourceRoot":"","sources":["../src/use-media-query.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAA;AAE1D;;;;;;GAMG;AACH,MAAM,WAAW,mBAAoB,SAAQ,YAAY;CACxD;AAOD;;;;;;;GAOG;AACH,eAAO,MAAM,aAAa,QAAO,mBAqBhC,CAAA"}

package/dist/use-media-query.js

@@ -0,0 +1,36 @@
+import { useMemo } from 'react';
+const clampInset = (value) => {
+    if (typeof value !== 'number' || !Number.isFinite(value))
+        return 0;
+    return Math.max(0, value);
+};
+/**
+ * 获取媒体查询信息（安全区/尺寸/DPR），基于当前 `xy.mediaQuery` 快照。
+ *
+ * @returns 规范化后的媒体查询信息（数值兜底）。
+ *
+ * @example
+ * const { safeAreaInsets } = useMediaQuery()
+ */
+export const useMediaQuery = () => {
+    return useMemo(() => {
+        const mediaQuery = (xy.mediaQuery ?? {});
+        const insets = mediaQuery.safeAreaInsets ?? {};
+        const statusBarHeight = clampInset(mediaQuery.statusBarHeight);
+        const devicePixelRatio = typeof mediaQuery.devicePixelRatio === 'number' && Number.isFinite(mediaQuery.devicePixelRatio)
+            ? mediaQuery.devicePixelRatio
+            : 1;
+        return {
+            statusBarHeight,
+            safeAreaInsets: {
+                top: clampInset(insets.top),
+                bottom: clampInset(insets.bottom),
+                left: clampInset(insets.left),
+                right: clampInset(insets.right)
+            },
+            size: mediaQuery.size,
+            devicePixelRatio
+        };
+    }, [xy.mediaQuery]);
+};
+//# sourceMappingURL=use-media-query.js.map

package/dist/use-media-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-media-query.js","sourceRoot":"","sources":["../src/use-media-query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,OAAO,CAAA;AAa/B,MAAM,UAAU,GAAG,CAAC,KAAc,EAAU,EAAE;IAC5C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,CAAC,CAAA;IAClE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AAC3B,CAAC,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,GAAwB,EAAE;IACrD,OAAO,OAAO,CAAC,GAAG,EAAE;QAClB,MAAM,UAAU,GAAG,CAAC,EAAE,CAAC,UAAU,IAAI,EAAE,CAA0B,CAAA;QACjE,MAAM,MAAM,GAAG,UAAU,CAAC,cAAc,IAAI,EAAE,CAAA;QAC9C,MAAM,eAAe,GAAG,UAAU,CAAC,UAAU,CAAC,eAAe,CAAC,CAAA;QAC9D,MAAM,gBAAgB,GACpB,OAAO,UAAU,CAAC,gBAAgB,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,gBAAgB,CAAC;YAC7F,CAAC,CAAC,UAAU,CAAC,gBAAgB;YAC7B,CAAC,CAAC,CAAC,CAAA;QACP,OAAO;YACL,eAAe;YACf,cAAc,EAAE;gBACd,GAAG,EAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC;gBAC3B,MAAM,EAAE,UAAU,CAAC,MAAM,CAAC,MAAM,CAAC;gBACjC,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC;gBAC7B,KAAK,EAAE,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC;aAChC;YACD,IAAI,EAAE,UAAU,CAAC,IAAI;YACrB,gBAAgB;SACjB,CAAA;IACH,CAAC,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAA;AACrB,CAAC,CAAA"}

package/dist/use-sdk-error.d.ts

@@ -0,0 +1,47 @@
+import type { XYErrorInfo } from '@xiao-ying/miniapp-sdk';
+type XYRuntime = XYErrorInfo['runtime'];
+/**
+ * SDK 错误过滤条件。
+ *
+ * - `method`: 过滤指定方法名
+ * - `code`: 过滤指定错误码
+ * - `runtime`: 过滤运行时（app/browser/unknown）
+ */
+export interface UseSdkErrorFilter {
+    method?: string | string[];
+    code?: string | string[];
+    runtime?: XYRuntime | XYRuntime[];
+}
+/**
+ * useSdkError 配置项。
+ *
+ * @param enabled - 是否启用订阅（默认 `true`）。
+ * @param limit - 缓存的错误数量上限（默认 `8`）。
+ * @param filter - 过滤条件。
+ */
+export interface UseSdkErrorOptions {
+    enabled?: boolean;
+    limit?: number;
+    filter?: UseSdkErrorFilter;
+}
+/**
+ * useSdkError 返回值。
+ *
+ * - `latest`: 最新错误
+ * - `errors`: 错误列表
+ * - `clear`: 清空错误
+ */
+export interface UseSdkErrorResult {
+    latest?: XYErrorInfo;
+    errors: XYErrorInfo[];
+    clear: () => void;
+}
+/**
+ * 订阅 SDK 错误并在组件内维护错误列表。
+ *
+ * @example
+ * const { latest, errors, clear } = useSdkError({ filter: { method: 'request' } })
+ */
+export declare const useSdkError: (options?: UseSdkErrorOptions) => UseSdkErrorResult;
+export {};
+//# sourceMappingURL=use-sdk-error.d.ts.map

package/dist/use-sdk-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sdk-error.d.ts","sourceRoot":"","sources":["../src/use-sdk-error.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,KAAK,SAAS,GAAG,WAAW,CAAC,SAAS,CAAC,CAAA;AAEvC;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IACxB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,EAAE,CAAA;CAClC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,CAAC,EAAE,iBAAiB,CAAA;CAC3B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,WAAW,EAAE,CAAA;IACrB,KAAK,EAAE,MAAM,IAAI,CAAA;CAClB;AAUD;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,UAAS,kBAAuB,KAAG,iBAmD9D,CAAA"}

package/dist/use-sdk-error.js

@@ -0,0 +1,60 @@
+import { useCallback, useEffect, useMemo, useState } from 'react';
+const normalizeFilterSet = (value) => {
+    if (typeof value === 'undefined')
+        return undefined;
+    const items = Array.isArray(value) ? value : [value];
+    const normalized = items.filter((item) => typeof item === 'string' && item.length > 0);
+    if (normalized.length === 0)
+        return undefined;
+    return new Set(normalized);
+};
+/**
+ * 订阅 SDK 错误并在组件内维护错误列表。
+ *
+ * @example
+ * const { latest, errors, clear } = useSdkError({ filter: { method: 'request' } })
+ */
+export const useSdkError = (options = {}) => {
+    const { enabled = true, limit = 8, filter } = options;
+    const resolvedLimit = Number.isFinite(limit) ? limit : 8;
+    const methodSet = useMemo(() => normalizeFilterSet(filter?.method), [filter?.method]);
+    const codeSet = useMemo(() => normalizeFilterSet(filter?.code), [filter?.code]);
+    const runtimeSet = useMemo(() => normalizeFilterSet(filter?.runtime), [filter?.runtime]);
+    const matchesFilter = useCallback((info) => {
+        if (methodSet && !methodSet.has(info.method))
+            return false;
+        if (codeSet && !codeSet.has(info.code))
+            return false;
+        if (runtimeSet && !runtimeSet.has(info.runtime))
+            return false;
+        return true;
+    }, [methodSet, codeSet, runtimeSet]);
+    const [errors, setErrors] = useState([]);
+    useEffect(() => {
+        if (!enabled || typeof xy.onError !== 'function') {
+            return;
+        }
+        const unsubscribe = xy.onError((info) => {
+            if (!matchesFilter(info))
+                return;
+            setErrors((prev) => {
+                const next = [info, ...prev];
+                if (resolvedLimit <= 0)
+                    return next;
+                return next.slice(0, resolvedLimit);
+            });
+        });
+        return () => {
+            if (typeof unsubscribe === 'function') {
+                unsubscribe();
+            }
+        };
+    }, [enabled, matchesFilter, resolvedLimit, xy]);
+    const clear = useCallback(() => setErrors([]), []);
+    return useMemo(() => ({
+        latest: errors[0],
+        errors,
+        clear
+    }), [errors, clear]);
+};
+//# sourceMappingURL=use-sdk-error.js.map

package/dist/use-sdk-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-sdk-error.js","sourceRoot":"","sources":["../src/use-sdk-error.ts"],"names":[],"mappings":"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"}

package/dist/use-share.d.ts

@@ -0,0 +1,23 @@
+import type { MaybePromise, XyShareData, XyShareHandlerPayload } from '@xiao-ying/miniapp-sdk';
+type SharePayload = Omit<XyShareHandlerPayload, 'path'> & {
+    path?: string;
+};
+type ShareHandler = () => MaybePromise<SharePayload | XyShareData | null | undefined>;
+/**
+ * 注册分享处理器，自动补齐默认 path 与 title。
+ *
+ * - 传入函数：自定义动态返回分享数据
+ * - 传入对象：作为静态配置
+ * - 不传：使用默认配置（自动 path/title）
+ *
+ * @param input - 处理器函数或静态分享对象。
+ *
+ * @example
+ * useShare(() => ({
+ *   title: '示例',
+ *   path: '/home'
+ * }))
+ */
+export declare const useShare: (input?: ShareHandler | SharePayload | XyShareData | null) => void;
+export {};
+//# sourceMappingURL=use-share.d.ts.map

package/dist/use-share.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-share.d.ts","sourceRoot":"","sources":["../src/use-share.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAE9F,KAAK,YAAY,GAAG,IAAI,CAAC,qBAAqB,EAAE,MAAM,CAAC,GAAG;IACxD,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAgCD,KAAK,YAAY,GAAG,MAAM,YAAY,CAAC,YAAY,GAAG,WAAW,GAAG,IAAI,GAAG,SAAS,CAAC,CAAA;AAErF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,QAAQ,GAAI,QAAQ,YAAY,GAAG,YAAY,GAAG,WAAW,GAAG,IAAI,KAAG,IA6BnF,CAAA"}

package/dist/use-share.js

@@ -0,0 +1,72 @@
+import { useEffect, useMemo } from 'react';
+const buildDefaultSharePath = () => {
+    if (typeof window === 'undefined' || typeof window.location === 'undefined')
+        return undefined;
+    const { hash, pathname, search } = window.location;
+    // Hash Router：使用 hash 部分作为真实路径（包含查询）
+    if (hash && hash !== '#') {
+        const hashBody = hash.slice(1); // 去掉开头的 #
+        const normalized = hashBody.startsWith('/') ? hashBody : `/${hashBody}`;
+        return `/#${normalized}`;
+    }
+    // 非 hash：直接使用 pathname + search
+    const safePath = pathname && pathname.startsWith('/') ? pathname : `/${pathname ?? ''}`;
+    const safeSearch = typeof search === 'string' ? search : '';
+    return `${safePath || '/'}${safeSearch}`;
+};
+const normalizeSharePath = (path) => {
+    const hashIndex = path.indexOf('#');
+    if (hashIndex === -1)
+        return path;
+    const afterHash = path.slice(hashIndex + 1);
+    if (!afterHash)
+        return '/';
+    return afterHash.startsWith('/') ? afterHash : `/${afterHash}`;
+};
+const buildDefaultShareTitle = () => {
+    const name = typeof xy.manifest?.name === 'string' ? xy.manifest.name.trim() : '';
+    return name || '小应生活';
+};
+/**
+ * 注册分享处理器，自动补齐默认 path 与 title。
+ *
+ * - 传入函数：自定义动态返回分享数据
+ * - 传入对象：作为静态配置
+ * - 不传：使用默认配置（自动 path/title）
+ *
+ * @param input - 处理器函数或静态分享对象。
+ *
+ * @example
+ * useShare(() => ({
+ *   title: '示例',
+ *   path: '/home'
+ * }))
+ */
+export const useShare = (input) => {
+    const resolveHandler = useMemo(() => {
+        if (typeof input === 'function')
+            return input;
+        if (!input)
+            return () => ({});
+        const payload = input;
+        return () => payload;
+    }, [input]);
+    const wrappedHandler = useMemo(() => async () => {
+        const res = await resolveHandler();
+        if (!res || typeof res !== 'object')
+            return res;
+        let path = res.path ?? buildDefaultSharePath();
+        const title = res.title ?? buildDefaultShareTitle();
+        if (!path)
+            return null;
+        path = normalizeSharePath(path);
+        // 返回符合 XyShareData 的结构，确保 path 为 string
+        const { path: _ignoredPath, title: _ignoredTitle, ...rest } = res;
+        return { ...rest, path, title };
+    }, [resolveHandler]);
+    useEffect(() => {
+        xy.setShareHandler(wrappedHandler);
+        return () => xy.setShareHandler(null);
+    }, [wrappedHandler, xy]);
+};
+//# sourceMappingURL=use-share.js.map