src/preact/compat/internal.js - main - githubmirror/amphtml

src/preact/compat/internal.js
105 строк3 KB
Scott Rippey
✨ [bento-mega-menu] Implemented bento mega menu (#38197)
24 май 2022, 01:25
24 май 2022, 01:25ed0c674
import {options, toChildArray} from /*OK*/ 'preact';

import * as mode from '#core/mode';

export {memo} from './memo';

const REACT_FORWARD_SYMBOL =
  (typeof Symbol !== 'undefined' && Symbol.for?.('react.forward_ref')) || 0xf47;

/**
 * @type {*}
 * `__b` is the known mangled name exported by preact. This is called during
 * the diffing algorithm with the constructed VNode, before the vnode is
 * actually used to diff.
 *
 */
const diffKey = '__b';
const oldDiff = /** @type {*} */ (options)[diffKey];
/** @type {*} */ (options)[diffKey] = newDiff;

/**
 * Checks if our VNode type has a `forwardRef_` sigil, in which case it was created by our forwardRef implementation.
 * If so, we move the VNode's ref to it's props, which will be passed to the Component as its props.
 *
 * See VNode type at https://github.com/preactjs/preact/blob/55ee4bc069f84cf5e3af8f2e2f338f4e74aca4d8/src/create-element.js#L58-L76
 *
 * @param {*} vnode
 */
function newDiff(vnode) {
  if (vnode['type']?.forwardRef_ && vnode['ref']) {
    vnode['props']['ref'] = vnode['ref'];
    vnode['ref'] = null;
  }
  oldDiff?.(vnode);
}

/**
 * Reimplements forwardRef without dragging in everything from preact/compat.
 * See https://github.com/preactjs/preact/issues/3295
 *
 * @type {import('preact/compat').forwardRef}
 */
export const forwardRef = function (Component) {
  /**
   * @param {*} props
   * @return {*}
   */
  function Forward(props) {
    const {ref, ...clone} = props;
    return Component(clone, ref);
  }

  // Is faithful react support necessary? This file should only be used in Preact mode,
  // importers will directly import `React.forwardRef` in React builds.
  Forward.$$typeof = REACT_FORWARD_SYMBOL;

  // Preact pretends functional components are classical component instances,
  // which are expected to have a render method.
  Forward.render = Forward;

  // https://github.com/preactjs/preact/blob/d78746c96245b70a83514a69ba4047e5dd0c7f54/compat/src/render.js#L26-L27
  // Some libraries like `react-virtualized` explicitly check for this.
  Forward.prototype.isReactComponent = true;

  Forward.forwardRef_ = true;

  if (!mode.isProd()) {
    Forward.displayName = `ForwardRef(${
      Component.displayName || Component.name
    })`;
  }

  return /** @type {*} */ (Forward);
};

/**
 * @type {typeof import('preact').toChildArray} children
 */
function toArray(children) {
  return toChildArray(children);
}

/**
 * @param {import('preact').ComponentChildren} children
 * @param {function(import('preact').ComponentChildren, number):R} fn
 * @return {Array<R>}
 * @template R
 */
function map(children, fn) {
  return toChildArray(children).map(fn);
}

/**
 * @param {import('preact').ComponentChildren} children
 * @return {number}
 */
function count(children) {
  return toChildArray(children).length;
}

export const Children = {
  toArray,
  map,
  count,
};