@apple-pie/slice 0.1.44 → 0.1.46

package/dist/types/components/DataTable/_data.d.ts

@@ -9,4 +9,5 @@ export type SampleTableData = {
 };
 export declare const sampleTableData: SampleTableData[];
 export declare const moreSampleData: () => SampleTableData[];
+export declare const manyRows: (count: number) => SampleTableData[];
 export declare const sampleTableColumnDefinitions: ColumnDefinition<SampleTableData>[];

package/dist/types/components/DataTable/_resolveVirtualizeRows.d.ts

@@ -0,0 +1 @@
+export declare function resolveVirtualizeRows(explicit: boolean | undefined, rowCount: number, threshold: number): boolean;

package/dist/types/components/DataTable/_resolveVirtualizeRows.test.d.ts

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

package/dist/types/components/DataTable/_types.d.ts

@@ -63,6 +63,10 @@ export interface DataTableProps<T> {
     onDoubleClick?: (col: ColumnDefinition<T>, colId: number, row: T, rowIndex: number) => void;
     onMouseOver?: (col: ColumnDefinition<T>, colId: number, row: T, rowIndex: number) => void;
     onMouseOut?: (col: ColumnDefinition<T>, colId: number, row: T, rowIndex: number) => void;
+    virtualizeRows?: boolean;
+    virtualizeRowThreshold?: number;
+    rowHeight?: number;
+    overscanRows?: number;
 }
 export type SortKey<T> = {
     key?: keyof T;

package/dist/types/components/DataTable/_useRowWindow.d.ts

@@ -0,0 +1,15 @@
+import type React from 'react';
+export type RowWindow = {
+    enabled: boolean;
+    startIndex: number;
+    endIndex: number;
+    topSpacerHeight: number;
+    bottomSpacerHeight: number;
+    handleScroll: (scrollTop: number) => void;
+};
+export type UseRowWindowOptions = {
+    enabled: boolean;
+    rowHeight: number;
+    overscan?: number;
+};
+export declare function useRowWindow(wrapperRef: React.RefObject<HTMLElement | null>, rowCount: number, options: UseRowWindowOptions): RowWindow;

package/dist/types/components/DataTable/_useRowWindow.test.d.ts

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

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/dist/types/utils/functions/rafThrottle.d.ts

@@ -0,0 +1,13 @@
+export interface RafThrottledFunction<T extends (...args: any[]) => void> {
+    (...args: Parameters<T>): void;
+    cancel: () => void;
+}
+/**
+ * Coalesce rapid calls (scroll, pointermove, resize) down to at most one
+ * invocation per animation frame, always using the most recently passed
+ * arguments. Unlike `debounce`, this never waits for activity to stop - the
+ * first call in a frame schedules the frame, every call after that until the
+ * frame fires just updates the pending args, and dropped intermediate calls
+ * never run at all.
+ */
+export declare function rafThrottle<T extends (...args: any[]) => void>(func: T): RafThrottledFunction<T>;

package/dist/types/utils/functions/rafThrottle.test.d.ts

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

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

@@ -1,5 +1,6 @@
 export { copyToClipboard, hexToRgb } from './functions/misc';
 export { debounce } from './functions/debounce';
+export { rafThrottle } from './functions/rafThrottle';
 export * from './functions/colors';
 export { AudioVisualizer, IndexedDB, MdBuffer, SSEConnection, WebRTCConnection, WSConnection, } from './objects';
 export type { AudioVisualizerOptions, AudioVisualizerSource, IndexedDBOptions, MarkdownAutoCloseRule, MarkdownStreamBufferOptions, MarkdownStreamBufferSnapshot, SSECustomEvent, SSEConnectionCloseOption, SSEConnectionOptions, SSEEventMap, SSEUnifiedBuiltInMessage, SSEUnifiedCustomMessage, SSEUnifiedMessage, UnifiedMessageEvent, WebRTCConnectionOptions, WSConnectionOptions, } from './objects';

package/package.json

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