@apple-pie/slice 0.1.45 → 0.1.46

package/dist/types/hooks/index.d.ts

@@ -14,3 +14,4 @@ export { useAudioRecorder } from './useAudioRecorder/useAudioRecorder';
 export { useWindow, FormFactor, type BreakPoints, type WindowGeolocation, type WindowGeolocationError, } from './useWindow/useWindow';
 export { useObserveResize } from './useObserveResize/useObserveResize';
 export { useIntersecting, type IntersectContainer, type IntersectEntry, type IntersectMargin, type IntersectOptions, type IntersectResult, type IntersectResultList, type ResolvedEntries, defaultOptions as defaultIntersectingOptions, } from './useIntersecting/useIntersecting';
+export { useClipboard, type ClipboardPermissionState, type ClipboardPasteResult, type UseClipboardOptions, type UseClipboardReturn, type UseClipboardTarget, } from './useClipboard/useClipboard';

package/dist/types/hooks/useClipboard/useClipboard.d.ts

@@ -0,0 +1,40 @@
+import type { RefObject } from 'react';
+export type ClipboardPermissionState = 'granted' | 'denied' | 'prompt' | 'unsupported';
+export type ClipboardPasteResult = {
+    text: string;
+    files: File[];
+    items: DataTransferItem[];
+    nativeEvent: ClipboardEvent;
+};
+export type UseClipboardTarget = RefObject<HTMLElement | null> | Document | HTMLElement;
+export type UseClipboardOptions = {
+    /** Element (or ref to one) to listen for native `paste` events on. Defaults to `document`. */
+    target?: UseClipboardTarget;
+    /** Called whenever a native paste event fires on the target, with the pasted text, files, and raw items. */
+    onPaste?: (result: ClipboardPasteResult) => void;
+    /** How long `isCopied` stays `true` after a successful `copy()`, in ms. Pass `0` to disable the auto-reset. */
+    copiedResetDelay?: number;
+    /** Query and subscribe to clipboard-read/clipboard-write permission state on mount. Defaults to `true`. */
+    watchPermissions?: boolean;
+};
+export type UseClipboardReturn = {
+    /** Most recently read or pasted clipboard text. `null` until a `read()` or observed paste populates it. */
+    text: string | null;
+    /** Whether the async Clipboard API (`navigator.clipboard`) is available in this environment. */
+    isSupported: boolean;
+    /** Briefly `true` after a successful `copy()` call. Handy for "Copied!" affordances. */
+    isCopied: boolean;
+    /** Whether a `copy()` or `read()` call is currently in flight. */
+    isRequesting: boolean;
+    /** Last error raised by `copy()` or `read()`. */
+    error: Error | null;
+    /** Current `clipboard-read` permission state, or `unsupported` when the Permissions API can't report it. */
+    readPermission: ClipboardPermissionState;
+    /** Current `clipboard-write` permission state, or `unsupported` when the Permissions API can't report it. */
+    writePermission: ClipboardPermissionState;
+    /** Write text to the clipboard. Falls back to a hidden-textarea `execCommand` copy when the Clipboard API is unavailable or denied. */
+    copy: (value: string) => Promise<boolean>;
+    /** Read text from the clipboard via the async Clipboard API. Resolves to `null` on unsupported browsers or denied permission. */
+    read: () => Promise<string | null>;
+};
+export declare function useClipboard(options?: UseClipboardOptions): UseClipboardReturn;

package/dist/types/hooks/useClipboard/useClipboard.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -3,7 +3,7 @@ export type { ToolTip, ToolTipInfo } from './components/sharedTypes';
 export { ToolTipType } from './components/sharedTypes';
 export { light, dark, lightTheme, darkTheme, motion, elevations, Elevation, } from './theme';
 export type { SliceTheme, Colors, Type, Corners, Elevations, } from './theme';
-export { type KeyboardShortcut, type KeyboardShortcuts, type BreakPoints, type WindowGeolocation, type WindowGeolocationError, type MicOption, type UseBindWebRTCOptions, type UseBindWebRTCReturn, type UseMDStreamBufferOptions, type UseMicrophoneReturn, useBindWebRTC, useKeyboardShortcuts, useTheme, useObserveTheme, useToolTip, useLastUpdated, useLocalStore, useMDStreamBuffer, useAudioRecorder, useMicrophone, useWindow, useDoubleClick, useObserveResize, } from './hooks';
+export { type KeyboardShortcut, type KeyboardShortcuts, type BreakPoints, type WindowGeolocation, type WindowGeolocationError, type MicOption, type UseBindWebRTCOptions, type UseBindWebRTCReturn, type UseMDStreamBufferOptions, type UseMicrophoneReturn, type ClipboardPermissionState, type ClipboardPasteResult, type UseClipboardOptions, type UseClipboardReturn, type UseClipboardTarget, useBindWebRTC, useKeyboardShortcuts, useTheme, useObserveTheme, useToolTip, useLastUpdated, useLocalStore, useMDStreamBuffer, useAudioRecorder, useMicrophone, useWindow, useDoubleClick, useObserveResize, useClipboard, } from './hooks';
 export { AudioBubble } from './components/AudioBubble/index';
 export type { AudioBubbleProps } from './components/AudioBubble/index';
 export { Avatar } from './components/Avatar/index';

package/dist/types/stores/toast/_types.d.ts

@@ -7,6 +7,7 @@ export type Toast = {
     close?: boolean;
     position?: 'top' | 'bottom';
     progress?: boolean;
+    container?: 'parent' | 'window';
 };
 export interface ToastStore {
     toast: Toast | null;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@apple-pie/slice",
-	"version": "0.1.45",
+	"version": "0.1.46",
 	"main": "dist/cjs/index.js",
 	"module": "dist/esm/index.mjs",
 	"exports": {