@office-iss/react-native-win32 0.71.4 → 0.72.0-preview.1

package/Libraries/Lists/ChildListCollection.js

@@ -1,72 +0,0 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * @flow strict
- * @format
- */
-
-import invariant from 'invariant';
-
-export default class ChildListCollection<TList> {
-  _cellKeyToChildren: Map<string, Set<TList>> = new Map();
-  _childrenToCellKey: Map<TList, string> = new Map();
-
-  add(list: TList, cellKey: string): void {
-    invariant(
-      !this._childrenToCellKey.has(list),
-      'Trying to add already present child list',
-    );
-
-    const cellLists = this._cellKeyToChildren.get(cellKey) ?? new Set();
-    cellLists.add(list);
-    this._cellKeyToChildren.set(cellKey, cellLists);
-
-    this._childrenToCellKey.set(list, cellKey);
-  }
-
-  remove(list: TList): void {
-    const cellKey = this._childrenToCellKey.get(list);
-    invariant(cellKey != null, 'Trying to remove non-present child list');
-    this._childrenToCellKey.delete(list);
-
-    const cellLists = this._cellKeyToChildren.get(cellKey);
-    invariant(cellLists, '_cellKeyToChildren should contain cellKey');
-    cellLists.delete(list);
-
-    if (cellLists.size === 0) {
-      this._cellKeyToChildren.delete(cellKey);
-    }
-  }
-
-  forEach(fn: TList => void): void {
-    for (const listSet of this._cellKeyToChildren.values()) {
-      for (const list of listSet) {
-        fn(list);
-      }
-    }
-  }
-
-  forEachInCell(cellKey: string, fn: TList => void): void {
-    const listSet = this._cellKeyToChildren.get(cellKey) ?? [];
-    for (const list of listSet) {
-      fn(list);
-    }
-  }
-
-  anyInCell(cellKey: string, fn: TList => boolean): boolean {
-    const listSet = this._cellKeyToChildren.get(cellKey) ?? [];
-    for (const list of listSet) {
-      if (fn(list)) {
-        return true;
-      }
-    }
-    return false;
-  }
-
-  size(): number {
-    return this._childrenToCellKey.size;
-  }
-}

package/Libraries/Lists/StateSafePureComponent.js

@@ -1,85 +0,0 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * @flow strict
- * @format
- */
-
-import invariant from 'invariant';
-import * as React from 'react';
-
-/**
- * `setState` is called asynchronously, and should not rely on the value of
- * `this.props` or `this.state`:
- * https://reactjs.org/docs/state-and-lifecycle.html#state-updates-may-be-asynchronous
- *
- * SafePureComponent adds runtime enforcement, to catch cases where these
- * variables are read in a state updater function, instead of the ones passed
- * in.
- */
-export default class StateSafePureComponent<
-  Props,
-  State: interface {},
-> extends React.PureComponent<Props, State> {
-  _inAsyncStateUpdate = false;
-
-  constructor(props: Props) {
-    super(props);
-    this._installSetStateHooks();
-  }
-
-  setState(
-    partialState: ?($Shape<State> | ((State, Props) => ?$Shape<State>)),
-    callback?: () => mixed,
-  ): void {
-    if (typeof partialState === 'function') {
-      super.setState((state, props) => {
-        this._inAsyncStateUpdate = true;
-        let ret;
-        try {
-          ret = partialState(state, props);
-        } catch (err) {
-          throw err;
-        } finally {
-          this._inAsyncStateUpdate = false;
-        }
-        return ret;
-      }, callback);
-    } else {
-      super.setState(partialState, callback);
-    }
-  }
-
-  _installSetStateHooks() {
-    const that = this;
-    let {props, state} = this;
-
-    Object.defineProperty(this, 'props', {
-      get() {
-        invariant(
-          !that._inAsyncStateUpdate,
-          '"this.props" should not be accessed during state updates',
-        );
-        return props;
-      },
-      set(newProps: Props) {
-        props = newProps;
-      },
-    });
-    Object.defineProperty(this, 'state', {
-      get() {
-        invariant(
-          !that._inAsyncStateUpdate,
-          '"this.state" should not be acceessed during state updates',
-        );
-        return state;
-      },
-      set(newState: State) {
-        state = newState;
-      },
-    });
-  }
-}

package/Libraries/Lists/VirtualizedList.d.ts

@@ -1,347 +0,0 @@
-/**
- * Copyright (c) Meta Platforms, Inc. and affiliates.
- *
- * This source code is licensed under the MIT license found in the
- * LICENSE file in the root directory of this source tree.
- *
- * @format
- */
-
-import type * as React from 'react';
-import type {LayoutChangeEvent} from '../../types';
-import {StyleProp} from '../StyleSheet/StyleSheet';
-import {ViewStyle} from '../StyleSheet/StyleSheetTypes';
-import type {
-  ScrollResponderMixin,
-  ScrollView,
-  ScrollViewProps,
-} from '../Components/ScrollView/ScrollView';
-import type {View} from '../Components/View/View';
-
-export interface ViewToken {
-  item: any;
-  key: string;
-  index: number | null;
-  isViewable: boolean;
-  section?: any;
-}
-
-export interface ViewabilityConfig {
-  /**
-   * Minimum amount of time (in milliseconds) that an item must be physically viewable before the
-   * viewability callback will be fired. A high number means that scrolling through content without
-   * stopping will not mark the content as viewable.
-   */
-  minimumViewTime?: number | undefined;
-
-  /**
-   * Percent of viewport that must be covered for a partially occluded item to count as
-   * "viewable", 0-100. Fully visible items are always considered viewable. A value of 0 means
-   * that a single pixel in the viewport makes the item viewable, and a value of 100 means that
-   * an item must be either entirely visible or cover the entire viewport to count as viewable.
-   */
-  viewAreaCoveragePercentThreshold?: number | undefined;
-
-  /**
-   * Similar to `viewAreaCoveragePercentThreshold`, but considers the percent of the item that is visible,
-   * rather than the fraction of the viewable area it covers.
-   */
-  itemVisiblePercentThreshold?: number | undefined;
-
-  /**
-   * Nothing is considered viewable until the user scrolls or `recordInteraction` is called after
-   * render.
-   */
-  waitForInteraction?: boolean | undefined;
-}
-
-export interface ViewabilityConfigCallbackPair {
-  viewabilityConfig: ViewabilityConfig;
-  onViewableItemsChanged:
-    | ((info: {
-        viewableItems: Array<ViewToken>;
-        changed: Array<ViewToken>;
-      }) => void)
-    | null;
-}
-
-export type ViewabilityConfigCallbackPairs = ViewabilityConfigCallbackPair[];
-
-/**
- * @see https://reactnative.dev/docs/flatlist#props
- */
-
-export interface ListRenderItemInfo<ItemT> {
-  item: ItemT;
-
-  index: number;
-
-  separators: {
-    highlight: () => void;
-    unhighlight: () => void;
-    updateProps: (select: 'leading' | 'trailing', newProps: any) => void;
-  };
-}
-
-export type ListRenderItem<ItemT> = (
-  info: ListRenderItemInfo<ItemT>,
-) => React.ReactElement | null;
-
-/**
- * @see https://reactnative.dev/docs/virtualizedlist
- */
-export class VirtualizedList<ItemT> extends React.Component<
-  VirtualizedListProps<ItemT>
-> {
-  scrollToEnd: (params?: {animated?: boolean | undefined}) => void;
-  scrollToIndex: (params: {
-    animated?: boolean | undefined;
-    index: number;
-    viewOffset?: number | undefined;
-    viewPosition?: number | undefined;
-  }) => void;
-  scrollToItem: (params: {
-    animated?: boolean | undefined;
-    item: ItemT;
-    viewOffset?: number | undefined;
-    viewPosition?: number | undefined;
-  }) => void;
-
-  /**
-   * Scroll to a specific content pixel offset in the list.
-   * Param `offset` expects the offset to scroll to. In case of horizontal is true, the
-   * offset is the x-value, in any other case the offset is the y-value.
-   * Param `animated` (true by default) defines whether the list should do an animation while scrolling.
-   */
-  scrollToOffset: (params: {
-    animated?: boolean | undefined;
-    offset: number;
-  }) => void;
-
-  recordInteraction: () => void;
-
-  getScrollRef: () =>
-    | React.ElementRef<typeof ScrollView>
-    | React.ElementRef<typeof View>
-    | null;
-
-  getScrollResponder: () => ScrollResponderMixin | null;
-}
-
-/**
- * @see https://reactnative.dev/docs/virtualizedlist#props
- */
-
-export interface VirtualizedListProps<ItemT>
-  extends VirtualizedListWithoutRenderItemProps<ItemT> {
-  renderItem: ListRenderItem<ItemT> | null | undefined;
-}
-
-export interface VirtualizedListWithoutRenderItemProps<ItemT>
-  extends ScrollViewProps {
-  /**
-   * Rendered in between each item, but not at the top or bottom
-   */
-  ItemSeparatorComponent?: React.ComponentType<any> | null | undefined;
-
-  /**
-   * Rendered when the list is empty. Can be a React Component Class, a render function, or
-   * a rendered element.
-   */
-  ListEmptyComponent?:
-    | React.ComponentType<any>
-    | React.ReactElement
-    | null
-    | undefined;
-
-  /**
-   * Rendered at the bottom of all the items. Can be a React Component Class, a render function, or
-   * a rendered element.
-   */
-  ListFooterComponent?:
-    | React.ComponentType<any>
-    | React.ReactElement
-    | null
-    | undefined;
-
-  /**
-   * Styling for internal View for ListFooterComponent
-   */
-  ListFooterComponentStyle?: StyleProp<ViewStyle> | undefined;
-
-  /**
-   * Rendered at the top of all the items. Can be a React Component Class, a render function, or
-   * a rendered element.
-   */
-  ListHeaderComponent?:
-    | React.ComponentType<any>
-    | React.ReactElement
-    | null
-    | undefined;
-
-  /**
-   * Styling for internal View for ListHeaderComponent
-   */
-  ListHeaderComponentStyle?: StyleProp<ViewStyle> | undefined;
-
-  /**
-   * The default accessor functions assume this is an Array<{key: string}> but you can override
-   * getItem, getItemCount, and keyExtractor to handle any type of index-based data.
-   */
-  data?: any;
-
-  /**
-   * `debug` will turn on extra logging and visual overlays to aid with debugging both usage and
-   * implementation, but with a significant perf hit.
-   */
-  debug?: boolean | undefined;
-
-  /**
-   * DEPRECATED: Virtualization provides significant performance and memory optimizations, but fully
-   * unmounts react instances that are outside of the render window. You should only need to disable
-   * this for debugging purposes.
-   */
-  disableVirtualization?: boolean | undefined;
-
-  /**
-   * A marker property for telling the list to re-render (since it implements `PureComponent`). If
-   * any of your `renderItem`, Header, Footer, etc. functions depend on anything outside of the
-   * `data` prop, stick it here and treat it immutably.
-   */
-  extraData?: any;
-
-  /**
-   * A generic accessor for extracting an item from any sort of data blob.
-   */
-  getItem?: ((data: any, index: number) => ItemT) | undefined;
-
-  /**
-   * Determines how many items are in the data blob.
-   */
-  getItemCount?: ((data: any) => number) | undefined;
-
-  getItemLayout?:
-    | ((
-        data: any,
-        index: number,
-      ) => {
-        length: number;
-        offset: number;
-        index: number;
-      })
-    | undefined;
-
-  horizontal?: boolean | null | undefined;
-
-  /**
-   * How many items to render in the initial batch. This should be enough to fill the screen but not
-   * much more. Note these items will never be unmounted as part of the windowed rendering in order
-   * to improve perceived performance of scroll-to-top actions.
-   */
-  initialNumToRender?: number | undefined;
-
-  /**
-   * Instead of starting at the top with the first item, start at `initialScrollIndex`. This
-   * disables the "scroll to top" optimization that keeps the first `initialNumToRender` items
-   * always rendered and immediately renders the items starting at this initial index. Requires
-   * `getItemLayout` to be implemented.
-   */
-  initialScrollIndex?: number | null | undefined;
-
-  /**
-   * Reverses the direction of scroll. Uses scale transforms of -1.
-   */
-  inverted?: boolean | null | undefined;
-
-  keyExtractor?: ((item: ItemT, index: number) => string) | undefined;
-
-  /**
-   * The maximum number of items to render in each incremental render batch. The more rendered at
-   * once, the better the fill rate, but responsiveness my suffer because rendering content may
-   * interfere with responding to button taps or other interactions.
-   */
-  maxToRenderPerBatch?: number | undefined;
-
-  onEndReached?: ((info: {distanceFromEnd: number}) => void) | null | undefined;
-
-  onEndReachedThreshold?: number | null | undefined;
-
-  onLayout?: ((event: LayoutChangeEvent) => void) | undefined;
-
-  /**
-   * If provided, a standard RefreshControl will be added for "Pull to Refresh" functionality. Make
-   * sure to also set the `refreshing` prop correctly.
-   */
-  onRefresh?: (() => void) | null | undefined;
-
-  /**
-   * Used to handle failures when scrolling to an index that has not been measured yet.
-   * Recommended action is to either compute your own offset and `scrollTo` it, or scroll as far
-   * as possible and then try again after more items have been rendered.
-   */
-  onScrollToIndexFailed?:
-    | ((info: {
-        index: number;
-        highestMeasuredFrameIndex: number;
-        averageItemLength: number;
-      }) => void)
-    | undefined;
-
-  /**
-   * Called when the viewability of rows changes, as defined by the
-   * `viewabilityConfig` prop.
-   */
-  onViewableItemsChanged?:
-    | ((info: {
-        viewableItems: Array<ViewToken>;
-        changed: Array<ViewToken>;
-      }) => void)
-    | null
-    | undefined;
-
-  /**
-   * Set this when offset is needed for the loading indicator to show correctly.
-   * @platform android
-   */
-  progressViewOffset?: number | undefined;
-
-  /**
-   * Set this true while waiting for new data from a refresh.
-   */
-  refreshing?: boolean | null | undefined;
-
-  /**
-   * Note: may have bugs (missing content) in some circumstances - use at your own risk.
-   *
-   * This may improve scroll performance for large lists.
-   */
-  removeClippedSubviews?: boolean | undefined;
-
-  /**
-   * Render a custom scroll component, e.g. with a differently styled `RefreshControl`.
-   */
-  renderScrollComponent?:
-    | ((props: ScrollViewProps) => React.ReactElement<ScrollViewProps>)
-    | undefined;
-
-  /**
-   * Amount of time between low-pri item render batches, e.g. for rendering items quite a ways off
-   * screen. Similar fill rate/responsiveness tradeoff as `maxToRenderPerBatch`.
-   */
-  updateCellsBatchingPeriod?: number | undefined;
-
-  viewabilityConfig?: ViewabilityConfig | undefined;
-
-  viewabilityConfigCallbackPairs?: ViewabilityConfigCallbackPairs | undefined;
-
-  /**
-   * Determines the maximum number of items rendered outside of the visible area, in units of
-   * visible lengths. So if your list fills the screen, then `windowSize={21}` (the default) will
-   * render the visible screen area plus up to 10 screens above and 10 below the viewport. Reducing
-   * this number will reduce memory consumption and may improve performance, but will increase the
-   * chance that fast scrolling may reveal momentary blank areas of unrendered content.
-   */
-  windowSize?: number | undefined;
-
-  CellRendererComponent?: React.ComponentType<any> | undefined;
-}