@apple-pie/slice 0.1.31 → 0.1.32

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

@@ -6,6 +6,8 @@ export { type KeyboardShortcut, type KeyboardShortcuts, useKeyboardShortcuts, }
 export { useLastUpdated } from './useLastUpdated/useLastUpdated';
 export { useLocalStore } from './useLocalStore/useLocalStore';
 export { useMDStreamBuffer } from './useMdStreamBuffer/useMdStreamBuffer';
+export type { UseMDStreamBufferOptions } from './useMdStreamBuffer/useMdStreamBuffer';
+export { useBindWebRTC, type UseBindWebRTCOptions, type UseBindWebRTCReturn, } from './useBindWebRTC/useBindWebRTC';
 export { useMicrophone } from './useMicrophone/useMicrophone';
 export type { MicOption, UseMicrophoneReturn, } from './useMicrophone/useMicrophone';
 export { useAudioRecorder } from './useAudioRecorder/useAudioRecorder';

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

@@ -0,0 +1 @@
+export * from './useBindWebRTC';

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

@@ -0,0 +1,15 @@
+import type { WebRTCStoreConnectionOptions } from '../../stores/WebRTC';
+import type { WebRTCConnection } from '../../utils';
+export type UseBindWebRTCOptions = {
+    connectionName: string;
+    offerOptions?: RTCOfferOptions;
+    bearerToken?: string;
+} & Omit<WebRTCStoreConnectionOptions, 'micStream' | 'micTrack' | 'volume'>;
+export type UseBindWebRTCReturn = {
+    connection: WebRTCConnection | null;
+    error: Error | null;
+    bind: () => Promise<WebRTCConnection | null>;
+    unbind: () => void;
+    bound: boolean;
+};
+export declare function useBindWebRTC(options: UseBindWebRTCOptions): UseBindWebRTCReturn;

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

@@ -1 +1 @@
-export declare function useLocalStore<T>(key: string, value: T): readonly [T, (data: T) => void];
+export declare function useLocalStore<T>(key: string, value: T): readonly [T, (data: T) => void, boolean];

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

@@ -1,8 +1,13 @@
 import type { MarkdownStreamBufferOptions, MarkdownStreamBufferSnapshot } from '../../utils';
-export declare function useMDStreamBuffer(options?: MarkdownStreamBufferOptions): {
+export type UseMDStreamBufferOptions = MarkdownStreamBufferOptions & {
+    paceDelayMs?: number;
+    paceChunkSize?: number;
+};
+export declare function useMDStreamBuffer(options?: UseMDStreamBufferOptions): {
     raw: string;
     healthy: string;
     isComplete: boolean;
+    pendingCharacters: number;
     append: (value: string) => void;
     flush: () => MarkdownStreamBufferSnapshot | undefined;
     complete: () => MarkdownStreamBufferSnapshot | undefined;

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 UseMicrophoneReturn, 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, useBindWebRTC, useKeyboardShortcuts, useTheme, useObserveTheme, useToolTip, useLastUpdated, useLocalStore, useMDStreamBuffer, useAudioRecorder, useMicrophone, useWindow, useDoubleClick, useObserveResize, } from './hooks';
 export { AudioBubble } from './components/AudioBubble/index';
 export type { AudioBubbleProps } from './components/AudioBubble/index';
 export { Avatar } from './components/Avatar/index';
@@ -79,6 +79,8 @@ export type { BarButton, ButtonBarProps } from './components/ButtonBar/_types';
 export { Label } from './components/Label';
 export { LabelBackground } from './components/Label';
 export type { LabelProps } from './components/Label';
+export { Level } from './components/Level';
+export type { LevelProps } from './components/Level';
 export { UploadArea } from './components/UploadArea';
 export type { UploadAreaProps } from './components/UploadArea/_types';
 export { imageTypes, videoTypes, documentTypes, audioTypes, textTypes, allTypes, } from './components/UploadArea/_types';

package/dist/types/providers/ThemeProvider.d.ts

@@ -3,6 +3,7 @@ interface ThemeProviderProps {
     children?: React.ReactNode;
     theme?: string;
     initialTheme?: string;
+    initialSystem?: boolean;
     system?: boolean;
     global?: boolean;
 }

package/dist/types/providers/themeServer.d.ts

@@ -1,14 +1,18 @@
 export type SliceThemeName = 'lightMode' | 'darkMode';
 type ResolveInitialThemeOptions = {
     theme?: string | null;
-    cookieTheme?: string | null;
+    systemTheme?: boolean;
+    activeTheme?: string | null;
     fallbackTheme?: SliceThemeName;
 };
 /**
  * Resolve the startup Slice theme from an explicit theme value, cookie value,
- * or fallback theme in that order.
+ * or fallback theme in that order. Resolves a system to true if undefined.
  */
-export declare function resolveInitialTheme(options?: ResolveInitialThemeOptions): SliceThemeName;
+export declare function resolveInitialTheme(options?: ResolveInitialThemeOptions): {
+    initialTheme: SliceThemeName;
+    initialSystem: boolean;
+};
 /**
  * Return the root HTML attributes needed to render the active Slice theme
  * before client hydration.

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

@@ -0,0 +1,16 @@
+import type { WebRTCConnection, WebRTCConnectionOptions } from '../../utils';
+export type WebRTCStoreConnectionOptions = WebRTCConnectionOptions;
+export interface WebRTCStoreConnection {
+    name: string;
+    connection: WebRTCConnection;
+}
+export interface WebRTCStore {
+    connections: WebRTCStoreConnection[];
+    actions: {
+        addConnection: (name: string, options: WebRTCStoreConnectionOptions) => WebRTCStoreConnection;
+        initializeConnection: (name: string, offerOptions?: RTCOfferOptions, bearerToken?: string) => Promise<void>;
+        removeConnection: (name: string) => void;
+        setMicStream: (name: string, stream: MediaStream | null) => Promise<void>;
+        setVolume: (name: string, volume: number) => void;
+    };
+}

package/dist/types/stores/WebRTC/index.d.ts

@@ -0,0 +1,2 @@
+export * from './_types';
+export * from './webRTCStore';

package/dist/types/stores/WebRTC/webRTCStore.d.ts

@@ -0,0 +1,21 @@
+import type { WebRTCStore, WebRTCStoreConnectionOptions } from './_types';
+export declare const useWebRTCStore: import("zustand").UseBoundStore<import("zustand").StoreApi<WebRTCStore>>;
+export declare const useWebRTC: () => {
+    addConnection: (name: string, options: WebRTCStoreConnectionOptions) => import("./_types").WebRTCStoreConnection;
+    initializeConnection: (name: string, offerOptions?: RTCOfferOptions, bearerToken?: string) => Promise<void>;
+    removeConnection: (name: string) => void;
+    setMicStream: (name: string, stream: MediaStream | null) => Promise<void>;
+    setVolume: (name: string, volume: number) => void;
+};
+export declare const useWebRTCConnections: () => import("./_types").WebRTCStoreConnection[];
+export declare const useWebRTCConnection: (name: string) => import("./_types").WebRTCStoreConnection | null;
+export declare const useWebRTCConnected: (name?: string) => boolean;
+export declare const useWebRTCActions: {
+    addConnection: (name: string, options: WebRTCStoreConnectionOptions) => import("./_types").WebRTCStoreConnection;
+    initializeConnection: (name: string, offerOptions?: RTCOfferOptions, bearerToken?: string) => Promise<void>;
+    removeConnection: (name: string) => void;
+    setMicStream: (name: string, stream: MediaStream | null) => Promise<void>;
+    setVolume: (name: string, volume: number) => void;
+};
+export declare function getWebRTCConnections(): ReturnType<typeof useWebRTCStore.getState>['connections'];
+export declare function getWebRTCConnections(name: string): ReturnType<typeof useWebRTCStore.getState>['connections'][number] | null;

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

@@ -6,4 +6,5 @@ export * from './toast';
 export * from './tip';
 export * from './uploads';
 export * from './volume';
+export * from './WebRTC';
 export * from './window';

package/dist/types/stores/microphone/index.d.ts

@@ -1,2 +1,2 @@
-export { useMicrophoneStore, useSyncMicrophoneStore, useMicStream, useProcessedMicStream, useMicTrack, useCurrentMicDeviceId, useMicActive, useMicInputVolume, useMicMuted, useMicSupported, useMicRequesting, useMicError, useMicrophones, useMicOptions, useMicrophoneStoreActions, microphoneActions, getMicrophoneState, } from './microphoneStore';
+export { useMicrophoneStore, useSyncMicrophoneStore, useMicStream, useProcessedMicStream, useMicTrack, useCurrentMicDeviceId, useCurrentMicDeviceLabel, useMicActive, useMicInputVolume, useMicMuted, useMicSupported, useMicRequesting, useMicError, useMicrophones, useMicOptions, useMicrophoneStoreActions, microphoneActions, getMicrophoneState, getCurrentMicDeviceLabel, } from './microphoneStore';
 export type { MicrophoneStore, MicrophoneStoreActions, MicrophoneStoreState, } from './_types';

package/dist/types/stores/microphone/microphoneStore.d.ts

@@ -14,6 +14,7 @@ export declare const useMicStream: () => RefObject<MediaStream | null>;
 export declare const useProcessedMicStream: () => RefObject<MediaStream | null>;
 export declare const useMicTrack: () => RefObject<MediaStreamTrack | null>;
 export declare const useCurrentMicDeviceId: () => string | null;
+export declare const useCurrentMicDeviceLabel: () => string | null;
 export declare const useMicActive: () => boolean;
 export declare const useMicInputVolume: () => number;
 export declare const useMicMuted: () => boolean;
@@ -23,5 +24,17 @@ export declare const useMicError: () => Error | null;
 export declare const useMicrophones: () => MediaDeviceInfo[];
 export declare const useMicOptions: () => DropDownOption<MicOption>[];
 export declare const useMicrophoneStoreActions: () => MicrophoneStoreActions;
-export declare const microphoneActions: MicrophoneStoreActions;
+export declare const microphoneActions: {
+    sync: (microphone: UseMicrophoneReturn | null) => void;
+    clear: () => void;
+    requestMicrophone: () => Promise<MediaStream | null>;
+    stopMicrophone: () => void;
+    muteMic: () => boolean;
+    unmuteMic: () => boolean;
+    toggleMute: () => void;
+    setInputVolume: (volume: number) => number;
+    refreshMicrophones: () => Promise<MediaDeviceInfo[]>;
+    setMicrophone: (deviceId: string | DropDownOption<MicOption>) => Promise<void>;
+};
 export declare const getMicrophoneState: () => MicrophoneStore;
+export declare const getCurrentMicDeviceLabel: () => string | null;

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

@@ -1,5 +1,6 @@
 import type { ToastType } from '../../components/Toast';
 export type Toast = {
+    notifId?: string;
     message: string | null;
     duration?: number | 'Infinite';
     type?: ToastType;

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

@@ -10,7 +10,9 @@ export type VolumeStore = {
         attachFeedbackElement: (element: AudioElement) => void;
         detachFeedbackElement: (element: AudioElement) => void;
         playFeedback: (volume?: number) => Promise<void>;
-        setVolume: (volume: number) => void;
+        setVolume: (volume: number, options?: {
+            playFeedback?: boolean;
+        }) => void;
         mute: () => Promise<void>;
         unmute: () => Promise<void>;
         clearMedia: () => void;

package/dist/types/stores/volume/volumeStore.d.ts

@@ -10,7 +10,9 @@ export declare const useVolumeActions: () => {
     attachFeedbackElement: (element: AudioElement) => void;
     detachFeedbackElement: (element: AudioElement) => void;
     playFeedback: (volume?: number) => Promise<void>;
-    setVolume: (volume: number) => void;
+    setVolume: (volume: number, options?: {
+        playFeedback?: boolean;
+    }) => void;
     mute: () => Promise<void>;
     unmute: () => Promise<void>;
     clearMedia: () => void;
@@ -21,7 +23,9 @@ export declare const volumeActions: {
     attachFeedbackElement: (element: AudioElement) => void;
     detachFeedbackElement: (element: AudioElement) => void;
     playFeedback: (volume?: number) => Promise<void>;
-    setVolume: (volume: number) => void;
+    setVolume: (volume: number, options?: {
+        playFeedback?: boolean;
+    }) => void;
     mute: () => Promise<void>;
     unmute: () => Promise<void>;
     clearMedia: () => void;

package/dist/types/utils/functions/files.d.ts

@@ -8,7 +8,7 @@ export declare function nameAndExtension(fileName: string): {
 /**
  * Map a file extension to the corresponding file icon name.
  */
-export declare function fileIconName(extension: string): "other" | "video" | "text" | "sheet" | "image" | "audio" | "md" | "code" | "preso" | "pdf" | "clipboard";
+export declare function fileIconName(extension: string): "other" | "audio" | "video" | "text" | "sheet" | "image" | "md" | "code" | "preso" | "pdf" | "clipboard";
 /**
  * Create a clipboard-text file with a guaranteed `.clipboard` extension.
  */

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

@@ -1,5 +1,5 @@
 export { copyToClipboard, hexToRgb } from './functions/misc';
 export { debounce } from './functions/debounce';
 export * from './functions/colors';
-export { AudioVisualizer, IndexedDB, MdBuffer, SSEConnection, WSConnection, } from './objects';
-export type { AudioVisualizerOptions, AudioVisualizerSource, IndexedDBOptions, MarkdownAutoCloseRule, MarkdownStreamBufferOptions, MarkdownStreamBufferSnapshot, SSECustomEvent, SSEConnectionCloseOption, SSEConnectionOptions, SSEEventMap, SSEUnifiedBuiltInMessage, SSEUnifiedCustomMessage, SSEUnifiedMessage, UnifiedMessageEvent, WSConnectionOptions, } from './objects';
+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/dist/types/utils/objects/MDStreamBuffer/MdStreamBuffer.d.ts

@@ -7,6 +7,7 @@ export declare class MdBuffer {
     private readonly healthyEndMarker?;
     private readonly htmlHandling;
     private readonly includeLinksAndImages;
+    private readonly flushDelayMs;
     private readonly onFlush?;
     private readonly requestFrame;
     private readonly cancelFrame;
@@ -14,6 +15,9 @@ export declare class MdBuffer {
     private committedRaw;
     private activeRaw;
     private frameHandle;
+    private flushTimer;
+    private lastFlushAt;
+    private lastFlushedRawLength;
     private completeSignal;
     constructor(options?: MarkdownStreamBufferOptions);
     /**
@@ -24,6 +28,10 @@ export declare class MdBuffer {
      * The current parser-safe preview derived from the raw buffer.
      */
     get healthy(): string;
+    /**
+     * Characters appended since the last emitted snapshot.
+     */
+    get pendingCharacters(): number;
     /**
      * Append a streamed Markdown token and schedule a frame flush.
      */
@@ -46,6 +54,8 @@ export declare class MdBuffer {
     dispose(): void;
     private handleEndOfStreamToken;
     private scheduleFlush;
+    private getRemainingFlushDelay;
+    private clearScheduledFlush;
     private commitStableLines;
     private buildHealthyOutput;
     private applyHealthyEndMarker;

package/dist/types/utils/objects/MDStreamBuffer/_types.d.ts

@@ -3,6 +3,7 @@ export interface MarkdownStreamBufferSnapshot {
     healthy: string;
     reason: 'raf' | 'manual' | 'complete';
     isComplete: boolean;
+    pendingCharacters: number;
 }
 export interface MarkdownAutoCloseRule {
     name?: string;
@@ -19,6 +20,7 @@ export interface MarkdownStreamBufferOptions {
     healthyEndMarker?: string;
     htmlHandling?: 'ignore' | 'strip';
     includeLinksAndImages?: boolean;
+    flushDelayMs?: number;
     onFlush?: (snapshot: MarkdownStreamBufferSnapshot) => void;
     requestFrame?: (callback: FrameRequestCallback) => number;
     cancelFrame?: (handle: number) => void;

package/dist/types/utils/objects/WebRTCConnection/WebRTCConnection.d.ts

@@ -1,8 +1,10 @@
 import type { WebRTCConnectionOptions } from './_types';
 export declare class WebRTCConnection {
     private readonly peerConnection;
-    private readonly RTCSenderAudioTrack?;
+    private RTCSenderAudioTrack;
     private readonly RTCSenderVideoTrack?;
+    private RTCSenderAudioSender;
+    private readonly RTCSenderAudioStream;
     private RTCScreenShareTrack;
     private RTCScreenShareSender;
     private readonly RTCReceiverAudioStream;
@@ -11,7 +13,7 @@ export declare class WebRTCConnection {
     private readonly RTCDataChannels;
     private readonly connectionUrl;
     private connectionOffer;
-    private audioElement;
+    private readonly audioElement;
     private readonly autoPlayAudio;
     private readonly onRemoteAudioStream?;
     private readonly onRemoteVideoStream?;
@@ -19,6 +21,22 @@ export declare class WebRTCConnection {
     private iceTimer?;
     private offerOptions?;
     private bearerToken?;
+    /**
+     * Report whether the peer connection is currently connected
+     */
+    get connected(): boolean;
+    /**
+     * Report whether the connection currently has an audio path attached
+     */
+    get audioConnected(): boolean;
+    /**
+     * Report whether the connection currently has a video path attached
+     */
+    get videoConnected(): boolean;
+    /**
+     * Report whether any data channel is currently open
+     */
+    get dataConnected(): boolean;
     /**
      * Create the base instance
      */
@@ -54,7 +72,19 @@ export declare class WebRTCConnection {
     /**
      * Set the playback volume for the incoming audio element
      */
-    setAudioVolume(volume: number): void;
+    setVolume(volume: number): void;
+    /**
+     * Replace the outgoing audio source with the first track from a stream
+     */
+    setOutgoingAudioStream(stream: MediaStream | null): Promise<void>;
+    /**
+     * Replace the outgoing audio track without rebuilding the peer connection
+     */
+    replaceAudioTrack(track: MediaStreamTrack | null): Promise<void>;
+    /**
+     * Close the peer connection and release local media bindings
+     */
+    close(): void;
     /**
      * Create an audio source node from the unified incoming audio stream
      */
@@ -71,6 +101,10 @@ export declare class WebRTCConnection {
      * Set up a local stream with mic and video tracks and add to peer connection
      */
     private setupOutgoingMediaStream;
+    /**
+     * Keep the sender stream aligned to the current local audio track
+     */
+    private syncSenderAudioStream;
     /**
      * Setup data channels
      */

package/dist/types/utils/objects/WebRTCConnection/_types.d.ts

@@ -1,11 +1,20 @@
-export interface WebRTCConnectionOptions {
+type WebRTCMicStreamOption = {
+    micStream: MediaStream;
+    micTrack?: MediaStreamTrack | null;
+};
+type WebRTCMicTrackOption = {
+    micStream?: MediaStream | null;
+    micTrack: MediaStreamTrack;
+};
+export type WebRTCConnectionOptions = (WebRTCMicStreamOption | WebRTCMicTrackOption) & {
     connectionUrl?: string;
     audioElement?: HTMLAudioElement;
     autoPlayAudio?: boolean;
+    volume?: number;
     dataChannels?: string | string[];
-    micMediaTrack: MediaStreamTrack;
-    videoMediaTrack?: MediaStreamTrack;
+    videoTrack?: MediaStreamTrack | null;
     onRemoteVideoStream?: (streams: Map<string, MediaStream>) => void;
     onRemoteAudioStream?: (streams: Map<string, MediaStream>) => void;
     onDataChannelEvent?: (channel: string, eventType: 'message' | 'open' | 'close' | 'error', eventData: MessageEvent | Event | RTCErrorEvent) => void;
-}
+};
+export {};

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

@@ -8,3 +8,5 @@ export { SSEConnection } from './SSEConnection/SSEConnection';
 export { WSConnection } from './WSConnection/WSConnection';
 export type { SSECustomEvent, SSEConnectionCloseOption, SSEConnectionOptions, SSEEventMap, SSEUnifiedBuiltInMessage, SSEUnifiedCustomMessage, SSEUnifiedMessage, } from './SSEConnection/SSEConnection';
 export type { UnifiedMessageEvent, WSConnectionOptions, } from './WSConnection/WSConnection';
+export { WebRTCConnection } from './WebRTCConnection/WebRTCConnection';
+export type { WebRTCConnectionOptions } from './WebRTCConnection/_types';

package/package.json

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