@apple-pie/slice 0.1.6 → 0.1.8

package/dist/types/components/Button/Button.d.ts

@@ -1,7 +1,7 @@
 import React from 'react';
 import type { ToolTip } from '../sharedTypes';
 import type { ButtonHandle } from './_types';
-export declare const Button: React.NamedExoticComponent<Omit<React.HTMLAttributes<HTMLDivElement>, keyof {
+export declare const Button: React.NamedExoticComponent<Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof {
     size?: "large" | "medium" | "text";
     variant?: "solid" | "outline" | "text";
     state?: "normal" | "hover" | "disabled";
@@ -35,7 +35,7 @@ export declare const Button: React.NamedExoticComponent<Omit<React.HTMLAttribute
     paddingRight?: number;
     paddingLeft?: number;
     onToolTip?: (tip: ToolTip | null) => void;
-    onClick?: (e: React.MouseEvent<HTMLDivElement, MouseEvent> | undefined) => void;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement, MouseEvent> | undefined) => void;
 }> & {
     size?: "large" | "medium" | "text";
     variant?: "solid" | "outline" | "text";
@@ -70,5 +70,5 @@ export declare const Button: React.NamedExoticComponent<Omit<React.HTMLAttribute
     paddingRight?: number;
     paddingLeft?: number;
     onToolTip?: (tip: ToolTip | null) => void;
-    onClick?: (e: React.MouseEvent<HTMLDivElement, MouseEvent> | undefined) => void;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement, MouseEvent> | undefined) => void;
 } & React.RefAttributes<ButtonHandle>>;

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

@@ -35,9 +35,9 @@ type ButtonBaseProps = {
     paddingRight?: number;
     paddingLeft?: number;
     onToolTip?: (tip: ToolTip | null) => void;
-    onClick?: (e: React.MouseEvent<HTMLDivElement, MouseEvent> | undefined) => void;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement, MouseEvent> | undefined) => void;
 };
-export type ButtonProps = Omit<React.HTMLAttributes<HTMLDivElement>, keyof ButtonBaseProps> & ButtonBaseProps;
+export type ButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof ButtonBaseProps> & ButtonBaseProps;
 export interface ButtonHandle {
     triggerClick: () => void;
 }

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

@@ -62,6 +62,7 @@ export interface BaseCameraProps {
     videoFit?: 'fill' | 'contain' | 'cover' | 'none' | 'scale-down';
     startCameraOff?: boolean;
     startAudioMuted?: boolean;
+    playLocalAudio?: boolean;
     userProfile?: UserProfile;
     sessionSettings?: Settings;
     onVideoStream?: (stream: MediaStream) => void;

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

@@ -10,5 +10,5 @@ type CardBaseProps = {
         command?: string;
     }) => void;
 };
-export type CardProps = Omit<React.HTMLAttributes<HTMLDivElement>, keyof CardBaseProps> & CardBaseProps;
+export type CardProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof CardBaseProps> & CardBaseProps;
 export {};

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

@@ -1,9 +1,8 @@
 import type React from 'react';
-import type { IconNames } from '../Icon/_types';
 import type { ToolTip } from '../sharedTypes';
 type ChipBaseProps = {
     label?: string;
-    icon?: IconNames | string;
+    icon?: string;
     disabled?: boolean;
     focused?: boolean;
     tooltip?: string;

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

@@ -16,5 +16,5 @@ type GrouperBaseProps = {
     onChange?: (state: boolean) => void;
     onClick?: () => void;
 };
-export type GrouperProps = Omit<React.HTMLAttributes<HTMLDivElement>, keyof GrouperBaseProps> & GrouperBaseProps;
+export type GrouperProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof GrouperBaseProps> & GrouperBaseProps;
 export {};

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

@@ -12,87 +12,120 @@ type IconBaseProps = {
     onClick?: (e: React.MouseEvent<SVGElement, MouseEvent>) => void;
 };
 export type IconProps = Omit<React.SVGAttributes<SVGSVGElement>, keyof IconBaseProps> & IconBaseProps;
-export declare enum IconNames {
-    target = "target",
-    video = "video",
-    mic = "mic",
-    micMuted = "mic muted",
-    camera = "camera",
-    videoOff = "video off",
-    home = "home",
-    inbox = "inbox",
-    sparkle = "sparkle",
-    people = "people",
-    wallet = "wallet",
-    invoice = "invoice",
-    payment = "payment",
-    heart = "heart",
-    clock = "clock",
-    book = "book",
-    search = "search",
-    filter = "filter",
-    more = "more",
-    checkbox = "checkbox",
-    checkboxChecked = "checkbox checked",
-    checkboxPartial = "checkbox partial",
-    chevronDown = "chevron down",
-    chevronUp = "chevron up",
-    plus = "plus",
-    plusCircle = "plus circle",
-    x = "x",
-    upload = "upload",
-    download = "download",
-    share = "share",
-    checkCircle = "check circle",
-    circle = "circle",
-    circleFill = "circle fill",
-    person = "person",
-    attach = "attach",
-    menu = "menu",
-    help = "help",
-    blank = "blank",
-    check = "check",
-    message = "message",
-    info = "info",
-    alert = "alert",
-    notification = "notification",
-    arrowUp = "arrow up",
-    arrowLeft = "arrow left",
-    arrowRight = "arrow right",
-    navigate = "navigate",
-    document = "document",
-    refresh = "refresh",
-    recentChats = "recent chats",
-    trashBin = "trash bin",
-    dollar = "dollar",
-    apple = "apple",
-    view = "view",
-    openCircle = "open circle",
-    expanded = "expanded",
-    concise = "concise",
-    moderate = "moderate",
-    mail = "mail",
-    textDocument = "text document",
-    edit = "edit",
-    characterBeam = "character beam",
-    undo = "undo",
-    chat = "chat",
-    exclamation = "exclamation",
-    chart = "chart",
-    lightBulb = "light bulb",
-    settings = "settings",
-    documentEditor = "document editor",
-    chartArrow = "chart arrow",
-    focus = "focus",
-    briefcase = "briefcase",
-    globeLocation = "globe location",
-    barChart = "bar chart",
-    fontSmaller = "font smaller",
-    fontLarger = "font larger",
-    copy = "copy",
-    stop = "stop",
-    like = "like",
-    unlike = "unlike",
-    highlight = "highlight"
-}
+export declare const SliceIcons: {
+    readonly arrows: {
+        readonly arrowLeft: "arrow left";
+        readonly arrowRight: "arrow right";
+        readonly arrowUp: "arrow up";
+        readonly arrowDown: "arrow down";
+        readonly chevronDown: "chevron down";
+        readonly chevronUp: "chevron up";
+        readonly navigateRight: "navigate right";
+        readonly navigateLeft: "navigate left";
+        readonly share: "share";
+    };
+    readonly selection: {
+        readonly check: "check";
+        readonly checkCircle: "check circle";
+        readonly checkbox: "checkbox";
+        readonly checkboxChecked: "checkbox checked";
+        readonly checkboxPartial: "checkbox partial";
+        readonly circle: "circle";
+        readonly circleFill: "circle fill";
+        readonly plus: "plus";
+        readonly plusCircle: "plus circle";
+    };
+    readonly Messaging: {
+        readonly chat: "chat";
+        readonly mail: "mail";
+        readonly notification: "notification";
+        readonly inbox: "inbox";
+        readonly like: "like";
+        readonly unlike: "unlike";
+    };
+    readonly media: {
+        readonly camera: "camera";
+        readonly focus: "focus";
+        readonly mic: "mic";
+        readonly micMuted: "mic muted";
+        readonly video: "video";
+        readonly videoOff: "video off";
+        readonly download: "download";
+        readonly upload: "upload";
+    };
+    readonly files: {
+        readonly document: "document";
+        readonly documentEditor: "document editor";
+        readonly textDocument: "text document";
+    };
+    readonly people: {
+        readonly people: "people";
+        readonly person: "person";
+    };
+    readonly business: {
+        readonly briefcase: "briefcase";
+        readonly dollar: "dollar";
+        readonly invoice: "invoice";
+        readonly payment: "payment";
+        readonly wallet: "wallet";
+    };
+    readonly charts: {
+        readonly barChart: "bar chart";
+        readonly chart: "chart";
+        readonly chartArrow: "chart arrow";
+    };
+    readonly status: {
+        readonly alert: "alert";
+        readonly exclamation: "exclamation";
+        readonly help: "help";
+        readonly info: "info";
+        readonly issue: "issue";
+        readonly lightBulb: "light bulb";
+        readonly target: "target";
+        readonly openCircle: "open circle";
+    };
+    readonly brands: {
+        readonly apple: "apple";
+        readonly google: "google";
+        readonly googleMono: "google mono";
+        readonly linkedin: "linkedin";
+    };
+    readonly edit: {
+        readonly edit: "edit";
+        readonly trashBin: "trash bin";
+        readonly copy: "copy";
+        readonly filter: "filter";
+        readonly highlight: "highlight";
+        readonly undo: "undo";
+        readonly concise: "concise";
+        readonly expanded: "expanded";
+        readonly moderate: "moderate";
+        readonly recent: "recent";
+    };
+    readonly typography: {
+        readonly fontLarger: "font larger";
+        readonly fontSmaller: "font smaller";
+        readonly characterBeam: "character beam";
+    };
+    readonly ai: {
+        readonly sparkle: "sparkle";
+        readonly wand: "wand";
+    };
+    readonly ui: {
+        readonly attach: "attach";
+        readonly blank: "blank";
+        readonly book: "book";
+        readonly globeLocation: "globe location";
+        readonly heart: "heart";
+        readonly stop: "stop";
+        readonly search: "search";
+        readonly settings: "settings";
+        readonly view: "view";
+        readonly refresh: "refresh";
+        readonly home: "home";
+        readonly menu: "menu";
+        readonly more: "more";
+        readonly x: "x";
+    };
+};
 export {};

package/dist/types/components/Icon/index.d.ts

@@ -1,2 +1,2 @@
 export { Icon } from './Icon';
-export { IconNames } from './_types';
+export { SliceIcons } from './_types';

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

@@ -27,8 +27,8 @@ type IconButtonBaseProps = {
     animate?: string;
     exit?: string;
     borderRadius?: number;
-    onClick?: (e: React.MouseEvent<HTMLDivElement, MouseEvent>) => void;
+    onClick?: (e: React.MouseEvent<HTMLButtonElement, MouseEvent>) => void;
     onToolTip?: (tip: ToolTip | null) => void;
 };
-export type IconButtonProps = Omit<React.HTMLAttributes<HTMLDivElement>, keyof IconButtonBaseProps> & IconButtonBaseProps;
+export type IconButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof IconButtonBaseProps> & IconButtonBaseProps;
 export {};

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

@@ -12,5 +12,5 @@ type LabelBaseProps = {
     size?: 's' | 'm' | 'l';
     onClick?: (e: React.MouseEvent<any>) => void;
 };
-export type LabelProps = Omit<React.HTMLAttributes<HTMLDivElement>, keyof LabelBaseProps> & LabelBaseProps;
+export type LabelProps = Omit<React.HTMLAttributes<HTMLElement>, keyof LabelBaseProps> & LabelBaseProps;
 export {};

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

@@ -9,6 +9,7 @@ export type RadioButtonOption = {
 type RadioButtonBaseProps = {
     selected?: boolean;
     option: RadioButtonOption;
+    controlType?: 'radio' | 'checkbox';
     deselect?: boolean;
     tabIndex?: number;
     wrap?: boolean;
@@ -21,5 +22,5 @@ type RadioButtonBaseProps = {
     checkedIcon?: 'check circle' | 'circle fill';
     onChange?: (option: RadioButtonOption, state: boolean) => void;
 };
-export type RadioButtonProps = Omit<React.HTMLAttributes<HTMLDivElement>, keyof RadioButtonBaseProps> & RadioButtonBaseProps;
+export type RadioButtonProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof RadioButtonBaseProps> & RadioButtonBaseProps;
 export {};

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

@@ -9,5 +9,5 @@ type SwitchBaseProps = {
     padding?: number;
     onChange?: (state: boolean) => void;
 };
-export type SwitchProps = Omit<React.HTMLAttributes<HTMLDivElement>, keyof SwitchBaseProps> & SwitchBaseProps;
+export type SwitchProps = Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, keyof SwitchBaseProps> & SwitchBaseProps;
 export {};

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

@@ -45,6 +45,8 @@ export interface TabOptionProps {
     tabWidth?: 'min-content' | 'distribute' | number;
     underline?: boolean;
     onClick?: (value: number) => void;
+    onKeyDown?: (event: React.KeyboardEvent<HTMLButtonElement>, value: number) => void;
     onToolTip?: (tip: ToolTip | null) => void;
+    buttonRef?: (element: HTMLButtonElement | null) => void;
 }
 export {};

package/dist/types/index.d.ts

@@ -65,7 +65,7 @@ export { Chip } from './components/Chip';
 export type { ChipProps } from './components/Chip';
 export { FileIcon, FileIconNames } from './components/FileIcon';
 export type { FileIconProps } from './components/FileIcon/_types';
-export { Icon, IconNames } from './components/Icon';
+export { Icon, SliceIcons } from './components/Icon';
 export type { IconProps } from './components/Icon/_types';
 export { ButtonBar } from './components/ButtonBar';
 export type { BarButton, ButtonBarProps } from './components/ButtonBar/_types';

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

@@ -1,8 +1,8 @@
 /**
- * Create a tint value from a hex color
+ * Lighten or darken a hex color by mixing it toward white or black.
  */
 export declare const tintFromColor: (hex: string, percent: number) => string;
 /**
- * Adds the desired opacity level to a hex or RGB color string
+ * Convert a hex or RGB color into an RGBA string with the requested opacity.
  */
 export declare const addOpacity: (color: string, opacity: number) => string;

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

@@ -4,7 +4,6 @@ export interface DebouncedFunction<T extends (...args: any[]) => any> {
     flush: () => void;
 }
 /**
- * General debounce utility with delay setting and cancel/flush methods
- * to clear a "debounce" or immediately "execute" the debounced function
+ * Delay a function call until activity stops, with cancel and flush helpers.
  */
 export declare function debounce<T extends (...args: any[]) => any>(func: T, delay: number): DebouncedFunction<T>;

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

@@ -1,9 +1,15 @@
+/**
+ * Split a file name into its display name and extension.
+ */
 export declare function nameAndExtension(fileName: string): {
     name: string;
     ext: string;
 };
+/**
+ * Map a file extension to the corresponding file icon name.
+ */
 export declare function fileIconName(extension: string): "other" | "text" | "sheet" | "image" | "video" | "audio" | "pdf" | "code" | "md" | "preso" | "clipboard";
 /**
- * Create a text file from clipboard content placing a clipboard file extension
+ * Create a clipboard-text file with a guaranteed `.clipboard` extension.
  */
 export declare function clipboardTextToFile(content: string, fileName?: string): File;

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

@@ -1,53 +1,61 @@
 import type React from 'react';
+/**
+ * Convert a numeric or string size into a CSS-ready size value.
+ */
 export declare function setSizeStyle(size: string | number | undefined): string;
 /**
- * Clean up string with html
+ * Remove scripts, invisible characters, and optional HTML tags from a string.
  */
 export declare function cleanString(input: string, removeInvisible?: boolean, removeHtml?: boolean): string;
 /**
- * Check set theme
+ * Check whether the active document theme is currently dark.
  */
 export declare function isDarkMode(): boolean;
 /**
- * Debug component rendering
- * Code removed when built / deployed
+ * Log mount, unmount, and prop-change reasons for debug render tracking.
  */
 export declare function debug(previous: any, updated: any, name?: string): {
     props: any;
     mount: boolean;
     unmount: boolean;
 } | undefined;
+/**
+ * Build a readable list of prop changes between two prop snapshots.
+ */
 export declare function createPropChangeArray(props: any, updated: any): string[];
+/**
+ * Capture props and lifecycle flags for the render debug helpers.
+ */
 export declare function setProps(props: any, mount?: boolean, unmount?: boolean): {
     props: any;
     mount: boolean;
     unmount: boolean;
 } | undefined;
 /**
- * convert hex to rgb
+ * Convert a hex color into an RGB string literal.
  */
 export declare const hexToRgb: (hex: string | undefined) => string | undefined;
 /**
- * Utility to accessibility - mimics click event with designated keys event
+ * Trigger a click-like callback when one of the configured keys is pressed.
  */
 export declare function accessibleKeyDown(e: React.KeyboardEvent<any>, clickFunction: () => void, keys?: string[]): void;
 /**
- * Get the pointer position from a DOM touch or mouse event
+ * Read the horizontal pointer position from a mouse or touch event.
  */
 export declare function pointerPosition(e: MouseEvent | TouchEvent): number;
 /**
- * Filter and trim class name array
+ * Remove empty class names and join the remainder into one class string.
  */
 export declare function filterClasses(classNames: string[]): string;
 /**
- * Takes a style string or number and returns a valid CSS style string
+ * Normalize a style value or fallback into a CSS-ready string.
  */
 export declare function setStyle(value: string | number | undefined, defaultVal?: number | string | undefined): string;
 /**
- * Copy to clipboard
+ * Copy text to the clipboard using a temporary hidden textarea.
  */
 export declare const copyToClipboard: (rawContent: string) => Promise<boolean>;
 /**
- * Get normalized percent value from number or string
+ * Convert numeric or string percentage input into a normalized number.
  */
 export declare function normalizedPercent(value: number | string): number;

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

@@ -1,4 +1,5 @@
-export { copyToClipboard } from './functions/misc';
-export { tintFromColor, addOpacity } from './functions/colors';
+export { copyToClipboard, hexToRgb } from './functions/misc';
+export { debounce } from './functions/debounce';
+export * from './functions/colors';
 export { SSEConnection, WSConnection } from './objects';
 export type { SSECustomEvent, SSEConnectionCloseOption, SSEConnectionOptions, SSEEventMap, SSEUnifiedBuiltInMessage, SSEUnifiedCustomMessage, SSEUnifiedMessage, UnifiedMessageEvent, WSConnectionOptions, } from './objects';

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

@@ -96,6 +96,9 @@ interface SSEConnectionStandardOptions<TMessage = unknown, TCustomEvents extends
  * callback signature is valid.
  */
 export type SSEConnectionOptions<TMessage = unknown, TCustomEvents extends SSEEventMap = Record<string, never>> = SSEConnectionStandardOptions<TMessage, TCustomEvents> | SSEConnectionUnifiedOptions<TMessage, TCustomEvents>;
+/**
+ * Manage an EventSource connection with optional unified callbacks and typed custom events.
+ */
 export declare class SSEConnection<TMessage = unknown, TCustomEvents extends SSEEventMap = Record<string, never>> {
     private readonly url;
     private readonly options;
@@ -117,7 +120,7 @@ export declare class SSEConnection<TMessage = unknown, TCustomEvents extends SSE
      */
     get connection(): EventSource | null;
     /**
-     * Create an SEE connection instance
+     * Create the EventSource connection and attach its initial listeners.
      */
     constructor(options?: SSEConnectionOptions<TMessage, TCustomEvents>);
     /**
@@ -125,37 +128,55 @@ export declare class SSEConnection<TMessage = unknown, TCustomEvents extends SSE
      */
     private parseEventData;
     /**
-     * Attach default SEE events
+     * Attach the default EventSource listeners for message, error, and open events.
      */
     private attachDefaultEventListeners;
+    /**
+     * Emit parsed message data when standard callback mode is enabled.
+     */
     private emitParsedMessage;
+    /**
+     * Emit a unified message object when unified callback mode is enabled.
+     */
     private emitUnifiedMessage;
+    /**
+     * Emit the close callback and unified close event.
+     */
     private emitCloseEvent;
+    /**
+     * Close the connection in response to an SSE-level close condition.
+     */
     private closeFromConnectionEvent;
+    /**
+     * Check whether an incoming message should close the connection.
+     */
     private shouldCloseFromMessage;
+    /**
+     * Emit one custom event through unified callback mode.
+     */
     private emitUnifiedCustomMessage;
     /**
-     * Attach custom event listeners to the SSE connection
+     * Attach one typed custom event listener to the SSE connection.
      */
     private attachCustomEventListener;
     /**
-     * Attach custom event listeners to the SSE connection
+     * Attach all configured custom event listeners to the SSE connection.
      */
     private attachCustomEventListeners;
     /**
-     * Clean up listeners
+     * Detach every default and custom listener from the current EventSource.
      */
     private detachAllEventListeners;
     /**
-     * One message received
+     * Parse and emit the default `message` event payload.
      */
     onMessage: (event: MessageEvent) => void;
     /**
-     * On error event
+     * Forward EventSource errors through the configured callbacks.
      */
     onError: (event: Event) => void;
     /**
-     * On open event
+     * Forward EventSource open events through the configured callbacks.
      */
     onOpen: (event: Event) => void;
     /**