@plasmicapp/react-web 0.2.250 → 0.2.252

package/dist/all.d.ts

@@ -12,11 +12,17 @@ import React__default, { AriaAttributes, DOMAttributes as DOMAttributes$1, AriaR
 //   Michal Adamczyk <https://github.com/mradamczyk>
 //   Marvin Hagemeister <https://github.com/marvinhagemeister>
 
-type Value = string | number | boolean | undefined | null;
-type Mapping = { [key: string]: any };
-type Argument = Value | Mapping | Argument[];
+declare namespace classNames$1 {
+  type Value = string | number | boolean | undefined | null;
+  type Mapping = Record<string, unknown>;
+  interface ArgumentArray extends Array<Argument> {}
+  type Argument = Value | Mapping | ArgumentArray;
+}
 
-declare function classNames$1(...args: Argument[]): string;
+/**
+ * A simple JavaScript utility for conditionally joining classNames together.
+ */
+declare function classNames$1(...args: classNames$1.ArgumentArray): string;
 
 interface PlasmicPageGuardProps {
     appId: string;
@@ -26,7 +32,7 @@ interface PlasmicPageGuardProps {
     children: React__default.ReactNode;
     unauthorizedComp?: React__default.ReactNode;
 }
-declare function PlasmicPageGuard(props: PlasmicPageGuardProps): JSX.Element | null;
+declare function PlasmicPageGuard(props: PlasmicPageGuardProps): React__default.JSX.Element | null;
 declare function withPlasmicPageGuard<P extends object>(WrappedComponent: React__default.ComponentType<P>, options: Omit<PlasmicPageGuardProps, "children">): React__default.FC<P>;
 
 declare function pick<T extends {}>(obj: T, ...keys: (string | number | symbol)[]): Partial<T>;
@@ -11183,6 +11189,11 @@ interface ComponentTemplates<P> {
 }
 type StateSpec = {
     onChangeProp: string;
+    /**
+     * If true, will hide the state in a collapsed section; good for states that
+     * should not usually be used.
+     */
+    advanced?: boolean;
 } & ({
     type: "readonly";
     variableType: "text";
@@ -12061,7 +12072,7 @@ type PlasmicHeadProps = {
     image?: string;
     canonical?: string;
 };
-declare function PlasmicHead(props: PlasmicHeadProps): JSX.Element | null;
+declare function PlasmicHead(props: PlasmicHeadProps): React$1.JSX.Element | null;
 declare const plasmicHeadMeta: {
     name: string;
     displayName: string;
@@ -12092,7 +12103,7 @@ declare const plasmicHeadMeta: {
 
 declare function PlasmicIcon(props: React$1.ComponentProps<"svg"> & {
     PlasmicIconType: React$1.ComponentType;
-}): JSX.Element;
+}): React$1.JSX.Element;
 
 /**
  * Responsive `<img/>` replacement, based on `next/image`
@@ -12175,18 +12186,18 @@ interface PlasmicImgProps extends ImgTagProps {
 }
 declare const PlasmicImg: React__default.ForwardRefExoticComponent<PlasmicImgProps & React__default.RefAttributes<HTMLElement>>;
 
-declare const PlasmicLink: React__default.ForwardRefExoticComponent<Pick<any, string | number | symbol> & React__default.RefAttributes<any>>;
+declare const PlasmicLink: React__default.ForwardRefExoticComponent<Omit<any, "ref"> & React__default.RefAttributes<any>>;
 
 declare function PlasmicSlot<T extends keyof JSX.IntrinsicElements = "div">(props: React$1.ComponentProps<T> & {
     as?: T;
     defaultContents?: React$1.ReactNode;
     value?: React$1.ReactNode;
-}): JSX.Element | null;
+}): React$1.JSX.Element | null;
 declare function renderPlasmicSlot<T extends keyof JSX.IntrinsicElements = "div">(opts: {
     as?: T;
     defaultContents?: React$1.ReactNode;
     value?: React$1.ReactNode;
-}): JSX.Element | null;
+}): React$1.JSX.Element | null;
 
 type Queries = {
     [name: string]: string;
@@ -12263,7 +12274,7 @@ interface PlasmicRootProviderProps extends PlasmicDataSourceContextValue {
     disableLoadingBoundary?: boolean;
     suspenseFallback?: React$1.ReactNode;
 }
-declare function PlasmicRootProvider(props: PlasmicRootProviderProps): JSX.Element;
+declare function PlasmicRootProvider(props: PlasmicRootProviderProps): React$1.JSX.Element;
 declare const useIsSSR: typeof useIsSSR$1;
 
 declare const Stack: (<T extends keyof JSX.IntrinsicElements = "div">(props: {
@@ -12380,6 +12391,13 @@ interface FocusableDOMProps extends DOMProps {
   excludeFromTabOrder?: boolean
 }
 
+interface InputDOMProps {
+  /**
+   * The name of the input element, used when submitting an HTML form. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#htmlattrdefname).
+   */
+  name?: string
+}
+
 /** Any focusable element, including both HTML and SVG elements. */
 interface FocusableElement extends Element, HTMLOrSVGElement {}
 
@@ -12409,13 +12427,12 @@ interface DOMAttributes<T = FocusableElement> extends AriaAttributes, DOMAttribu
 type ValidationState = 'valid' | 'invalid';
 
 interface Validation {
-  /** Whether the input should display its "valid" or "invalid" visual styling. */
-  validationState?: ValidationState,
-  /**
-   * Whether user input is required on the input before form submission.
-   * Often paired with the `necessityIndicator` prop to add a visual indicator to the input.
-   */
-  isRequired?: boolean
+  /** Whether user input is required on the input before form submission. */
+  isRequired?: boolean,
+  /** Whether the input value is invalid. */
+  isInvalid?: boolean,
+  /** @deprecated Use `isInvalid` instead. */
+  validationState?: ValidationState
 }
 
 interface InputBase {
@@ -12472,10 +12489,10 @@ interface Collection<T> extends Iterable<T> {
   getKeys(): Iterable<Key>,
 
   /** Get an item by its key. */
-  getItem(key: Key): T,
+  getItem(key: Key): T | null,
 
   /** Get an item by the index of its key. */
-  at(idx: number): T,
+  at(idx: number): T | null,
 
   /** Get the key that comes before the given key in the collection. */
   getKeyBefore(key: Key): Key | null,
@@ -12487,7 +12504,13 @@ interface Collection<T> extends Iterable<T> {
   getFirstKey(): Key | null,
 
   /** Get the last key in the collection. */
-  getLastKey(): Key | null
+  getLastKey(): Key | null,
+
+  /** Iterate over the child items of the given key. */
+  getChildren?(key: Key): Iterable<T>,
+
+  /** Returns a string representation of the item's contents. */
+  getTextValue?(key: Key): string
 }
 
 interface Node<T> {
@@ -12496,12 +12519,15 @@ interface Node<T> {
   /** A unique key for the node. */
   key: Key,
   /** The object value the node was created from. */
-  value: T,
+  value: T | null,
   /** The level of depth this node is at in the heirarchy. */
   level: number,
   /** Whether this item has children, even if not loaded yet. */
   hasChildNodes: boolean,
-  /** The loaded children of this node. */
+  /**
+   * The loaded children of this node.
+   * @deprecated Use `collection.getChildren(node.key)` instead.
+   */
   childNodes: Iterable<Node<T>>,
   /** The rendered contents of this node (e.g. JSX). */
   rendered: ReactNode,
@@ -12514,11 +12540,11 @@ interface Node<T> {
   /** A function that should be called to wrap the rendered node. */
   wrapper?: (element: ReactElement) => ReactElement,
   /** The key of the parent node. */
-  parentKey?: Key,
+  parentKey?: Key | null,
   /** The key of the node before this node. */
-  prevKey?: Key,
+  prevKey?: Key | null,
   /** The key of the node after this node. */
-  nextKey?: Key,
+  nextKey?: Key | null,
   /** Additional properties specific to a particular node type. */
   props?: any,
   /** @private */
@@ -12542,7 +12568,9 @@ interface Node<T> {
 // Event bubbling can be problematic in real-world applications, so the default for React Spectrum components
 // is not to propagate. This can be overridden by calling continuePropagation() on the event.
 type BaseEvent<T extends SyntheticEvent> = T & {
-  /** @deprecated Use continuePropagation. */
+  /**
+   * Use continuePropagation.
+   * @deprecated */
   stopPropagation(): void,
   continuePropagation(): void
 }
@@ -12565,10 +12593,16 @@ interface PressEvent {
   /** Whether the meta keyboard modifier was held during the press event. */
   metaKey: boolean,
   /** Whether the alt keyboard modifier was held during the press event. */
-  altKey: boolean
+  altKey: boolean,
+  /**
+   * By default, press events stop propagation to parent elements.
+   * In cases where a handler decides not to handle a specific event,
+   * it can call `continuePropagation()` to allow a parent to handle it.
+   */
+  continuePropagation(): void
 }
 
-interface LongPressEvent extends Omit<PressEvent, 'type'> {
+interface LongPressEvent extends Omit<PressEvent, 'type' | 'continuePropagation'> {
   /** The type of long press event being fired. */
   type: 'longpressstart' | 'longpressend' | 'longpress'
 }
@@ -12580,16 +12614,16 @@ interface KeyboardEvents {
   onKeyUp?: (e: KeyboardEvent) => void
 }
 
-interface FocusEvents {
+interface FocusEvents<Target = Element> {
   /** Handler that is called when the element receives focus. */
-  onFocus?: (e: FocusEvent) => void,
+  onFocus?: (e: FocusEvent<Target>) => void,
   /** Handler that is called when the element loses focus. */
-  onBlur?: (e: FocusEvent) => void,
+  onBlur?: (e: FocusEvent<Target>) => void,
   /** Handler that is called when the element's focus status changes. */
   onFocusChange?: (isFocused: boolean) => void
 }
 
-interface FocusableProps extends FocusEvents, KeyboardEvents {
+interface FocusableProps<Target = Element> extends FocusEvents<Target>, KeyboardEvents {
   /** Whether the element should receive focus on render. */
   autoFocus?: boolean
 }
@@ -12740,14 +12774,10 @@ interface ToggleProps extends InputBase, Validation, FocusableProps {
   /**
    * The value of the input element, used when submitting an HTML form. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#htmlattrdefvalue).
    */
-  value?: string,
-  /**
-   * The name of the input element, used when submitting an HTML form. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#htmlattrdefname).
-   */
-  name?: string
+  value?: string
 }
 
-interface AriaToggleProps extends ToggleProps, FocusableDOMProps, AriaLabelingProps, AriaValidationProps {
+interface AriaToggleProps extends ToggleProps, FocusableDOMProps, AriaLabelingProps, AriaValidationProps, InputDOMProps {
   /**
    * Identifies the element (or elements) whose contents or presence are controlled by the current element.
    */
@@ -13053,7 +13083,7 @@ interface DropdownMenuProps {
      */
     onOpenChange?: (isOpen: boolean) => void;
 }
-declare function DropdownMenu(props: DropdownMenuProps): JSX.Element;
+declare function DropdownMenu(props: DropdownMenuProps): React$1.JSX.Element;
 
 interface BaseMenuButtonProps extends DOMProps, FocusableProps, StyleProps, Pick<React$1.ComponentProps<"button">, "title"> {
     /**
@@ -13387,7 +13417,7 @@ declare class SelectionManager implements MultipleSelectionManager {
     /**
      * Sets the focused key.
      */
-    setFocusedKey(key: Key, childFocusStrategy?: FocusStrategy): void;
+    setFocusedKey(key: Key | null, childFocusStrategy?: FocusStrategy): void;
     /**
      * The currently selected keys in the collection.
      */
@@ -13495,14 +13525,10 @@ interface SwitchBase extends InputBase, FocusableProps {
   /**
    * The value of the input element, used when submitting an HTML form. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#htmlattrdefvalue).
    */
-  value?: string,
-  /**
-   * The name of the input element, used when submitting an HTML form. See [MDN](https://developer.mozilla.org/en-US/docs/Web/HTML/Element/input#htmlattrdefname).
-   */
-  name?: string
+  value?: string
 }
 interface SwitchProps$1 extends SwitchBase {}
-interface AriaSwitchBase extends SwitchBase, FocusableDOMProps, AriaLabelingProps {
+interface AriaSwitchBase extends SwitchBase, FocusableDOMProps, InputDOMProps, AriaLabelingProps {
   /**
    * Identifies the element (or elements) whose contents or presence are controlled by the current element.
    */

package/dist/auth/PlasmicPageGuard.d.ts

@@ -7,6 +7,6 @@ interface PlasmicPageGuardProps {
     children: React.ReactNode;
     unauthorizedComp?: React.ReactNode;
 }
-export declare function PlasmicPageGuard(props: PlasmicPageGuardProps): JSX.Element | null;
+export declare function PlasmicPageGuard(props: PlasmicPageGuardProps): React.JSX.Element | null;
 export declare function withPlasmicPageGuard<P extends object>(WrappedComponent: React.ComponentType<P>, options: Omit<PlasmicPageGuardProps, "children">): React.FC<P>;
 export {};

package/dist/index.cjs.js

@@ -61,7 +61,7 @@ LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
 OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
 PERFORMANCE OF THIS SOFTWARE.
 ***************************************************************************** */
-/* global Reflect, Promise */
+/* global Reflect, Promise, SuppressedError, Symbol */
 
 var extendStatics = function(d, b) {
     extendStatics = Object.setPrototypeOf ||
@@ -176,7 +176,12 @@ function __spreadArray(to, from, pack) {
         }
     }
     return to.concat(ar || Array.prototype.slice.call(from));
-}
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
 
 // https://stackoverflow.com/a/2117523
 function uuidv4() {