@react-types/shared 3.11.2 → 3.13.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@react-types/shared",
-  "version": "3.11.2",
+  "version": "3.13.1",
   "description": "Spectrum UI components in React",
   "license": "Apache-2.0",
   "types": "src/index.d.ts",
@@ -9,10 +9,10 @@
     "url": "https://github.com/adobe/react-spectrum"
   },
   "peerDependencies": {
-    "react": "^16.8.0 || ^17.0.0-rc.1"
+    "react": "^16.8.0 || ^17.0.0-rc.1 || ^18.0.0"
   },
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "ed8d8d984c2f7f2c31e8b18795b97858a95e4729"
+  "gitHead": "715c3f563ccf8c2e0102d3e18403d9db21a05a71"
 }

package/src/collections.d.ts

@@ -89,31 +89,31 @@ export type SortDirection = 'ascending' | 'descending';
 
 export interface KeyboardDelegate {
   /** Returns the key visually below the given one, or `null` for none. */
-  getKeyBelow?(key: Key): Key,
+  getKeyBelow?(key: Key): Key | null,
 
   /** Returns the key visually above the given one, or `null` for none. */
-  getKeyAbove?(key: Key): Key,
+  getKeyAbove?(key: Key): Key | null,
 
   /** Returns the key visually to the left of the given one, or `null` for none. */
-  getKeyLeftOf?(key: Key): Key,
+  getKeyLeftOf?(key: Key): Key | null,
 
   /** Returns the key visually to the right of the given one, or `null` for none. */
-  getKeyRightOf?(key: Key): Key,
+  getKeyRightOf?(key: Key): Key | null,
 
   /** Returns the key visually one page below the given one, or `null` for none. */
-  getKeyPageBelow?(key: Key): Key,
+  getKeyPageBelow?(key: Key): Key | null,
 
   /** Returns the key visually one page above the given one, or `null` for none. */
-  getKeyPageAbove?(key: Key): Key,
+  getKeyPageAbove?(key: Key): Key | null,
 
   /** Returns the first key, or `null` for none. */
-  getFirstKey?(key?: Key, global?: boolean): Key,
+  getFirstKey?(key?: Key, global?: boolean): Key | null,
 
   /** Returns the last key, or `null` for none. */
-  getLastKey?(key?: Key, global?: boolean): Key,
+  getLastKey?(key?: Key, global?: boolean): Key | null,
 
   /** Returns the next key after `fromKey` that matches the given search string, or `null` for none. */
-  getKeyForSearch?(search: string, fromKey?: Key): Key
+  getKeyForSearch?(search: string, fromKey?: Key): Key | null
 }
 
 /**

package/src/dnd.d.ts

@@ -10,7 +10,7 @@
  * governing permissions and limitations under the License.
  */
 
-import {Key} from 'react';
+import {Key, RefObject} from 'react';
 
 export interface DragDropEvent {
   // Relative to the target element's position
@@ -139,12 +139,13 @@ interface DraggableCollectionEndEvent extends DragEndEvent {
   keys: Set<Key>
 }
 
+export type DragPreviewRenderer = (items: DragItem[], callback: (node: HTMLElement) => void) => void;
+
 export interface DraggableCollectionProps {
   onDragStart?: (e: DraggableCollectionStartEvent) => void,
   onDragMove?: (e: DraggableCollectionMoveEvent) => void,
   onDragEnd?: (e: DraggableCollectionEndEvent) => void,
   getItems: (keys: Set<Key>) => DragItem[],
-  renderPreview?: (selectedKeys: Set<Key>, draggedKey: Key) => JSX.Element,
-  getAllowedDropOperations?: () => DropOperation[],
-  allowsDraggingItem?: (key: Key) => boolean
+  preview?: RefObject<DragPreviewRenderer>,
+  getAllowedDropOperations?: () => DropOperation[]
 }

package/src/dom.d.ts

@@ -66,9 +66,60 @@ export interface FocusableDOMProps extends DOMProps {
   excludeFromTabOrder?: boolean
 }
 
+
+export interface TextInputDOMEvents {
+  // Clipboard events
+  /**
+   * Handler that is called when the user copies text. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/oncopy).
+   */
+   onCopy?: ClipboardEventHandler<HTMLInputElement>,
+
+   /**
+    * Handler that is called when the user cuts text. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/oncut).
+    */
+   onCut?: ClipboardEventHandler<HTMLInputElement>,
+
+   /**
+    * Handler that is called when the user pastes text. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/onpaste).
+    */
+   onPaste?: ClipboardEventHandler<HTMLInputElement>,
+
+   // Composition events
+   /**
+    * Handler that is called when a text composition system starts a new text composition session. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionstart_event).
+    */
+   onCompositionStart?: CompositionEventHandler<HTMLInputElement>,
+
+   /**
+    * Handler that is called when a text composition system completes or cancels the current text composition session. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionend_event).
+    */
+   onCompositionEnd?: CompositionEventHandler<HTMLInputElement>,
+
+   /**
+    * Handler that is called when a new character is received in the current text composition session. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionupdate_event).
+    */
+   onCompositionUpdate?: CompositionEventHandler<HTMLInputElement>,
+
+   // Selection events
+   /**
+    * Handler that is called when text in the input is selected. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/select_event).
+    */
+   onSelect?: ReactEventHandler<HTMLInputElement>,
+
+   // Input events
+   /**
+    * Handler that is called when the input value is about to be modified. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/beforeinput_event).
+    */
+   onBeforeInput?: FormEventHandler<HTMLInputElement>,
+   /**
+    * Handler that is called when the input value is modified. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event).
+    */
+   onInput?: FormEventHandler<HTMLInputElement>
+}
+
 // DOM props that apply to all text inputs
 // Ensure this is synced with useTextField
-export interface TextInputDOMProps extends DOMProps {
+export interface TextInputDOMProps extends DOMProps, TextInputDOMEvents {
   /**
    * Describes the type of autocomplete functionality the input should provide if any. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#htmlattrdefautocomplete).
    */
@@ -107,53 +158,5 @@ export interface TextInputDOMProps extends DOMProps {
   /**
    * Hints at the type of data that might be entered by the user while editing the element or its contents. See [MDN](https://html.spec.whatwg.org/multipage/interaction.html#input-modalities:-the-inputmode-attribute).
    */
-  inputMode?: 'none' | 'text' | 'tel' | 'url' | 'email' | 'numeric' | 'decimal' | 'search',
-
-  // Clipboard events
-  /**
-   * Handler that is called when the user copies text. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/oncopy).
-   */
-  onCopy?: ClipboardEventHandler<HTMLInputElement>,
-
-  /**
-   * Handler that is called when the user cuts text. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/oncut).
-   */
-  onCut?: ClipboardEventHandler<HTMLInputElement>,
-
-  /**
-   * Handler that is called when the user pastes text. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/onpaste).
-   */
-  onPaste?: ClipboardEventHandler<HTMLInputElement>,
-
-  // Composition events
-  /**
-   * Handler that is called when a text composition system starts a new text composition session. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionstart_event).
-   */
-  onCompositionStart?: CompositionEventHandler<HTMLInputElement>,
-
-  /**
-   * Handler that is called when a text composition system completes or cancels the current text composition session. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionend_event).
-   */
-  onCompositionEnd?: CompositionEventHandler<HTMLInputElement>,
-
-  /**
-   * Handler that is called when a new character is received in the current text composition session. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/compositionupdate_event).
-   */
-  onCompositionUpdate?: CompositionEventHandler<HTMLInputElement>,
-
-  // Selection events
-  /**
-   * Handler that is called when text in the input is selected. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/Element/select_event).
-   */
-  onSelect?: ReactEventHandler<HTMLInputElement>,
-
-  // Input events
-  /**
-   * Handler that is called when the input value is about to be modified. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/beforeinput_event).
-   */
-  onBeforeInput?: FormEventHandler<HTMLInputElement>,
-  /**
-   * Handler that is called when the input value is modified. See [MDN](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/input_event).
-   */
-  onInput?: FormEventHandler<HTMLInputElement>
+  inputMode?: 'none' | 'text' | 'tel' | 'url' | 'email' | 'numeric' | 'decimal' | 'search'
 }

package/src/inputs.d.ts

@@ -45,6 +45,15 @@ export interface TextInputBase {
   placeholder?: string
 }
 
+export interface SpectrumTextInputBase {
+  /**
+   * Temporary text that occupies the text input when it is empty.
+   * Please use help text instead.
+   * @deprecated
+   **/
+  placeholder?: string
+}
+
 export interface RangeValue<T> {
   /** The start value of the range. */
   start: T,

package/src/selection.d.ts

@@ -47,3 +47,4 @@ export interface SpectrumSelectionProps {
 }
 
 export type FocusStrategy = 'first' | 'last';
+export type DisabledBehavior = 'selection' | 'all';