UNPKG

one

Version:

One is a new React Framework that makes Vite serve both native and web.

1,515 lines (1,303 loc) 100 kB
/** * @license React * react.development.js * * Copyright (c) Facebook, Inc. and its affiliates. * * This source code is licensed under the MIT license found in the * LICENSE file in the root directory of this source tree. */ 'use strict' if (process.env.NODE_ENV !== 'production') { ;(function () { 'use strict' /* global __REACT_DEVTOOLS_GLOBAL_HOOK__ */ if ( typeof __REACT_DEVTOOLS_GLOBAL_HOOK__ !== 'undefined' && typeof __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart === 'function' ) { __REACT_DEVTOOLS_GLOBAL_HOOK__.registerInternalModuleStart(new Error()) } var ReactVersion = '18.3.1' // ATTENTION // When adding new symbols to this file, // Please consider also adding to 'react-devtools-shared/src/backend/ReactSymbols' // The Symbol used to tag the ReactElement-like types. var REACT_ELEMENT_TYPE = Symbol.for('react.element') var REACT_PORTAL_TYPE = Symbol.for('react.portal') var REACT_FRAGMENT_TYPE = Symbol.for('react.fragment') var REACT_STRICT_MODE_TYPE = Symbol.for('react.strict_mode') var REACT_PROFILER_TYPE = Symbol.for('react.profiler') var REACT_PROVIDER_TYPE = Symbol.for('react.provider') var REACT_CONTEXT_TYPE = Symbol.for('react.context') var REACT_FORWARD_REF_TYPE = Symbol.for('react.forward_ref') var REACT_SUSPENSE_TYPE = Symbol.for('react.suspense') var REACT_SUSPENSE_LIST_TYPE = Symbol.for('react.suspense_list') var REACT_MEMO_TYPE = Symbol.for('react.memo') var REACT_LAZY_TYPE = Symbol.for('react.lazy') var REACT_OFFSCREEN_TYPE = Symbol.for('react.offscreen') var MAYBE_ITERATOR_SYMBOL = Symbol.iterator var FAUX_ITERATOR_SYMBOL = '@@iterator' function getIteratorFn(maybeIterable) { if (maybeIterable === null || typeof maybeIterable !== 'object') { return null } var maybeIterator = (MAYBE_ITERATOR_SYMBOL && maybeIterable[MAYBE_ITERATOR_SYMBOL]) || maybeIterable[FAUX_ITERATOR_SYMBOL] if (typeof maybeIterator === 'function') { return maybeIterator } return null } /** * Keeps track of the current dispatcher. */ var ReactCurrentDispatcher = { /** * @internal * @type {ReactComponent} */ current: null, } /** * Keeps track of the current batch's configuration such as how long an update * should suspend for if it needs to. */ var ReactCurrentBatchConfig = { transition: null, } var ReactCurrentActQueue = { current: null, // Used to reproduce behavior of `batchedUpdates` in legacy mode. isBatchingLegacy: false, didScheduleLegacyUpdate: false, } /** * Keeps track of the current owner. * * The current owner is the component who should own any components that are * currently being constructed. */ var ReactCurrentOwner = { /** * @internal * @type {ReactComponent} */ current: null, } var ReactDebugCurrentFrame = {} var currentExtraStackFrame = null function setExtraStackFrame(stack) { { currentExtraStackFrame = stack } } { ReactDebugCurrentFrame.setExtraStackFrame = function (stack) { { currentExtraStackFrame = stack } } // Stack implementation injected by the current renderer. ReactDebugCurrentFrame.getCurrentStack = null ReactDebugCurrentFrame.getStackAddendum = function () { var stack = '' // Add an extra top frame while an element is being validated if (currentExtraStackFrame) { stack += currentExtraStackFrame } // Delegate to the injected renderer-specific implementation var impl = ReactDebugCurrentFrame.getCurrentStack if (impl) { stack += impl() || '' } return stack } } // ----------------------------------------------------------------------------- var enableScopeAPI = false // Experimental Create Event Handle API. var enableCacheElement = false var enableTransitionTracing = false // No known bugs, but needs performance testing var enableLegacyHidden = false // Enables unstable_avoidThisFallback feature in Fiber // stuff. Intended to enable React core members to more easily debug scheduling // issues in DEV builds. var enableDebugTracing = false // Track which Fiber(s) schedule render work. var ReactSharedInternals = { ReactCurrentDispatcher: ReactCurrentDispatcher, ReactCurrentBatchConfig: ReactCurrentBatchConfig, ReactCurrentOwner: ReactCurrentOwner, } { ReactSharedInternals.ReactDebugCurrentFrame = ReactDebugCurrentFrame ReactSharedInternals.ReactCurrentActQueue = ReactCurrentActQueue } // by calls to these methods by a Babel plugin. // // In PROD (or in packages without access to React internals), // they are left as they are instead. function warn(format) { { { for ( var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++ ) { args[_key - 1] = arguments[_key] } printWarning('warn', format, args) } } } function error(format) { { { for ( var _len2 = arguments.length, args = new Array(_len2 > 1 ? _len2 - 1 : 0), _key2 = 1; _key2 < _len2; _key2++ ) { args[_key2 - 1] = arguments[_key2] } printWarning('error', format, args) } } } function printWarning(level, format, args) { // When changing this logic, you might want to also // update consoleWithStackDev.www.js as well. { var ReactDebugCurrentFrame = ReactSharedInternals.ReactDebugCurrentFrame var stack = ReactDebugCurrentFrame.getStackAddendum() if (stack !== '') { format += '%s' args = args.concat([stack]) } // eslint-disable-next-line react-internal/safe-string-coercion var argsWithFormat = args.map(function (item) { return String(item) }) // Careful: RN currently depends on this prefix argsWithFormat.unshift('Warning: ' + format) // We intentionally don't use spread (or .apply) directly because it // breaks IE9: https://github.com/facebook/react/issues/13610 // eslint-disable-next-line react-internal/no-production-logging Function.prototype.apply.call(console[level], console, argsWithFormat) } } var didWarnStateUpdateForUnmountedComponent = {} function warnNoop(publicInstance, callerName) { { var _constructor = publicInstance.constructor var componentName = (_constructor && (_constructor.displayName || _constructor.name)) || 'ReactClass' var warningKey = componentName + '.' + callerName if (didWarnStateUpdateForUnmountedComponent[warningKey]) { return } error( "Can't call %s on a component that is not yet mounted. " + 'This is a no-op, but it might indicate a bug in your application. ' + 'Instead, assign to `this.state` directly or define a `state = {};` ' + 'class property with the desired state in the %s component.', callerName, componentName ) didWarnStateUpdateForUnmountedComponent[warningKey] = true } } /** * This is the abstract API for an update queue. */ var ReactNoopUpdateQueue = { /** * Checks whether or not this composite component is mounted. * @param {ReactClass} publicInstance The instance we want to test. * @return {boolean} True if mounted, false otherwise. * @protected * @final */ isMounted: function (publicInstance) { return false }, /** * Forces an update. This should only be invoked when it is known with * certainty that we are **not** in a DOM transaction. * * You may want to call this when you know that some deeper aspect of the * component's state has changed but `setState` was not called. * * This will not invoke `shouldComponentUpdate`, but it will invoke * `componentWillUpdate` and `componentDidUpdate`. * * @param {ReactClass} publicInstance The instance that should rerender. * @param {?function} callback Called after component is updated. * @param {?string} callerName name of the calling function in the public API. * @internal */ enqueueForceUpdate: function (publicInstance, callback, callerName) { warnNoop(publicInstance, 'forceUpdate') }, /** * Replaces all of the state. Always use this or `setState` to mutate state. * You should treat `this.state` as immutable. * * There is no guarantee that `this.state` will be immediately updated, so * accessing `this.state` after calling this method may return the old value. * * @param {ReactClass} publicInstance The instance that should rerender. * @param {object} completeState Next state. * @param {?function} callback Called after component is updated. * @param {?string} callerName name of the calling function in the public API. * @internal */ enqueueReplaceState: function ( publicInstance, completeState, callback, callerName ) { warnNoop(publicInstance, 'replaceState') }, /** * Sets a subset of the state. This only exists because _pendingState is * internal. This provides a merging strategy that is not available to deep * properties which is confusing. TODO: Expose pendingState or don't use it * during the merge. * * @param {ReactClass} publicInstance The instance that should rerender. * @param {object} partialState Next partial state to be merged with state. * @param {?function} callback Called after component is updated. * @param {?string} Name of the calling function in the public API. * @internal */ enqueueSetState: function (publicInstance, partialState, callback, callerName) { warnNoop(publicInstance, 'setState') }, } var assign = Object.assign var emptyObject = {} { Object.freeze(emptyObject) } /** * Base class helpers for the updating state of a component. */ function Component(props, context, updater) { this.props = props this.context = context // If a component has string refs, we will assign a different object later. this.refs = emptyObject // We initialize the default updater but the real one gets injected by the // renderer. this.updater = updater || ReactNoopUpdateQueue } Component.prototype.isReactComponent = {} /** * Sets a subset of the state. Always use this to mutate * state. You should treat `this.state` as immutable. * * There is no guarantee that `this.state` will be immediately updated, so * accessing `this.state` after calling this method may return the old value. * * There is no guarantee that calls to `setState` will run synchronously, * as they may eventually be batched together. You can provide an optional * callback that will be executed when the call to setState is actually * completed. * * When a function is provided to setState, it will be called at some point in * the future (not synchronously). It will be called with the up to date * component arguments (state, props, context). These values can be different * from this.* because your function may be called after receiveProps but before * shouldComponentUpdate, and this new state, props, and context will not yet be * assigned to this. * * @param {object|function} partialState Next partial state or function to * produce next partial state to be merged with current state. * @param {?function} callback Called after state is updated. * @final * @protected */ Component.prototype.setState = function (partialState, callback) { if ( typeof partialState !== 'object' && typeof partialState !== 'function' && partialState != null ) { throw new Error( 'setState(...): takes an object of state variables to update or a ' + 'function which returns an object of state variables.' ) } this.updater.enqueueSetState(this, partialState, callback, 'setState') } /** * Forces an update. This should only be invoked when it is known with * certainty that we are **not** in a DOM transaction. * * You may want to call this when you know that some deeper aspect of the * component's state has changed but `setState` was not called. * * This will not invoke `shouldComponentUpdate`, but it will invoke * `componentWillUpdate` and `componentDidUpdate`. * * @param {?function} callback Called after update is complete. * @final * @protected */ Component.prototype.forceUpdate = function (callback) { this.updater.enqueueForceUpdate(this, callback, 'forceUpdate') } /** * Deprecated APIs. These APIs used to exist on classic React classes but since * we would like to deprecate them, we're not going to move them over to this * modern base class. Instead, we define a getter that warns if it's accessed. */ { var deprecatedAPIs = { isMounted: [ 'isMounted', 'Instead, make sure to clean up subscriptions and pending requests in ' + 'componentWillUnmount to prevent memory leaks.', ], replaceState: [ 'replaceState', 'Refactor your code to use setState instead (see ' + 'https://github.com/facebook/react/issues/3236).', ], } var defineDeprecationWarning = function (methodName, info) { Object.defineProperty(Component.prototype, methodName, { get: function () { warn( '%s(...) is deprecated in plain JavaScript React classes. %s', info[0], info[1] ) return undefined }, }) } for (var fnName in deprecatedAPIs) { if (deprecatedAPIs.hasOwnProperty(fnName)) { defineDeprecationWarning(fnName, deprecatedAPIs[fnName]) } } } function ComponentDummy() {} ComponentDummy.prototype = Component.prototype /** * Convenience component with default shallow equality check for sCU. */ function PureComponent(props, context, updater) { this.props = props this.context = context // If a component has string refs, we will assign a different object later. this.refs = emptyObject this.updater = updater || ReactNoopUpdateQueue } var pureComponentPrototype = (PureComponent.prototype = new ComponentDummy()) pureComponentPrototype.constructor = PureComponent // Avoid an extra prototype jump for these methods. assign(pureComponentPrototype, Component.prototype) pureComponentPrototype.isPureReactComponent = true // an immutable object with a single mutable value function createRef() { var refObject = { current: null, } { Object.seal(refObject) } return refObject } var isArrayImpl = Array.isArray // eslint-disable-next-line no-redeclare function isArray(a) { return isArrayImpl(a) } /* * The `'' + value` pattern (used in in perf-sensitive code) throws for Symbol * and Temporal.* types. See https://github.com/facebook/react/pull/22064. * * The functions in this module will throw an easier-to-understand, * easier-to-debug exception with a clear errors message message explaining the * problem. (Instead of a confusing exception thrown inside the implementation * of the `value` object). */ // $FlowFixMe only called in DEV, so void return is not possible. function typeName(value) { { // toStringTag is needed for namespaced types like Temporal.Instant var hasToStringTag = typeof Symbol === 'function' && Symbol.toStringTag var type = (hasToStringTag && value[Symbol.toStringTag]) || value.constructor.name || 'Object' return type } } // $FlowFixMe only called in DEV, so void return is not possible. function willCoercionThrow(value) { { try { testStringCoercion(value) return false } catch (e) { return true } } } function testStringCoercion(value) { // If you ended up here by following an exception call stack, here's what's // happened: you supplied an object or symbol value to React (as a prop, key, // DOM attribute, CSS property, string ref, etc.) and when React tried to // coerce it to a string using `'' + value`, an exception was thrown. // // The most common types that will cause this exception are `Symbol` instances // and Temporal objects like `Temporal.Instant`. But any object that has a // `valueOf` or `[Symbol.toPrimitive]` method that throws will also cause this // exception. (Library authors do this to prevent users from using built-in // numeric operators like `+` or comparison operators like `>=` because custom // methods are needed to perform accurate arithmetic or comparison.) // // To fix the problem, coerce this object or symbol value to a string before // passing it to React. The most reliable way is usually `String(value)`. // // To find which value is throwing, check the browser or debugger console. // Before this exception was thrown, there should be `console.error` output // that shows the type (Symbol, Temporal.PlainDate, etc.) that caused the // problem and how that type was used: key, atrribute, input value prop, etc. // In most cases, this console output also shows the component and its // ancestor components where the exception happened. // // eslint-disable-next-line react-internal/safe-string-coercion return '' + value } function checkKeyStringCoercion(value) { { if (willCoercionThrow(value)) { error( 'The provided key is an unsupported type %s.' + ' This value must be coerced to a string before before using it here.', typeName(value) ) return testStringCoercion(value) // throw (to help callers find troubleshooting comments) } } } function getWrappedName(outerType, innerType, wrapperName) { var displayName = outerType.displayName if (displayName) { return displayName } var functionName = innerType.displayName || innerType.name || '' return functionName !== '' ? wrapperName + '(' + functionName + ')' : wrapperName } // Keep in sync with react-reconciler/getComponentNameFromFiber function getContextName(type) { return type.displayName || 'Context' } // Note that the reconciler package should generally prefer to use getComponentNameFromFiber() instead. function getComponentNameFromType(type) { if (type == null) { // Host root, text node or just invalid type. return null } { if (typeof type.tag === 'number') { error( 'Received an unexpected object in getComponentNameFromType(). ' + 'This is likely a bug in React. Please file an issue.' ) } } if (typeof type === 'function') { return type.displayName || type.name || null } if (typeof type === 'string') { return type } switch (type) { case REACT_FRAGMENT_TYPE: return 'Fragment' case REACT_PORTAL_TYPE: return 'Portal' case REACT_PROFILER_TYPE: return 'Profiler' case REACT_STRICT_MODE_TYPE: return 'StrictMode' case REACT_SUSPENSE_TYPE: return 'Suspense' case REACT_SUSPENSE_LIST_TYPE: return 'SuspenseList' } if (typeof type === 'object') { switch (type.$$typeof) { case REACT_CONTEXT_TYPE: var context = type return getContextName(context) + '.Consumer' case REACT_PROVIDER_TYPE: var provider = type return getContextName(provider._context) + '.Provider' case REACT_FORWARD_REF_TYPE: return getWrappedName(type, type.render, 'ForwardRef') case REACT_MEMO_TYPE: var outerName = type.displayName || null if (outerName !== null) { return outerName } return getComponentNameFromType(type.type) || 'Memo' case REACT_LAZY_TYPE: { var lazyComponent = type var payload = lazyComponent._payload var init = lazyComponent._init try { return getComponentNameFromType(init(payload)) } catch (x) { return null } } // eslint-disable-next-line no-fallthrough } } return null } var hasOwnProperty = Object.prototype.hasOwnProperty var RESERVED_PROPS = { key: true, ref: true, __self: true, __source: true, } var specialPropKeyWarningShown, specialPropRefWarningShown, didWarnAboutStringRefs { didWarnAboutStringRefs = {} } function hasValidRef(config) { { if (hasOwnProperty.call(config, 'ref')) { var getter = Object.getOwnPropertyDescriptor(config, 'ref').get if (getter && getter.isReactWarning) { return false } } } return config.ref !== undefined } function hasValidKey(config) { { if (hasOwnProperty.call(config, 'key')) { var getter = Object.getOwnPropertyDescriptor(config, 'key').get if (getter && getter.isReactWarning) { return false } } } return config.key !== undefined } function defineKeyPropWarningGetter(props, displayName) { var warnAboutAccessingKey = function () { { if (!specialPropKeyWarningShown) { specialPropKeyWarningShown = true error( '%s: `key` is not a prop. Trying to access it will result ' + 'in `undefined` being returned. If you need to access the same ' + 'value within the child component, you should pass it as a different ' + 'prop. (https://reactjs.org/link/special-props)', displayName ) } } } warnAboutAccessingKey.isReactWarning = true Object.defineProperty(props, 'key', { get: warnAboutAccessingKey, configurable: true, }) } function defineRefPropWarningGetter(props, displayName) { var warnAboutAccessingRef = function () { { if (!specialPropRefWarningShown) { specialPropRefWarningShown = true error( '%s: `ref` is not a prop. Trying to access it will result ' + 'in `undefined` being returned. If you need to access the same ' + 'value within the child component, you should pass it as a different ' + 'prop. (https://reactjs.org/link/special-props)', displayName ) } } } warnAboutAccessingRef.isReactWarning = true Object.defineProperty(props, 'ref', { get: warnAboutAccessingRef, configurable: true, }) } function warnIfStringRefCannotBeAutoConverted(config) { { if ( typeof config.ref === 'string' && ReactCurrentOwner.current && config.__self && ReactCurrentOwner.current.stateNode !== config.__self ) { var componentName = getComponentNameFromType(ReactCurrentOwner.current.type) if (!didWarnAboutStringRefs[componentName]) { error( 'Component "%s" contains the string ref "%s". ' + 'Support for string refs will be removed in a future major release. ' + 'This case cannot be automatically converted to an arrow function. ' + 'We ask you to manually fix this case by using useRef() or createRef() instead. ' + 'Learn more about using refs safely here: ' + 'https://reactjs.org/link/strict-mode-string-ref', componentName, config.ref ) didWarnAboutStringRefs[componentName] = true } } } } /** * Factory method to create a new React element. This no longer adheres to * the class pattern, so do not use new to call it. Also, instanceof check * will not work. Instead test $$typeof field against Symbol.for('react.element') to check * if something is a React Element. * * @param {*} type * @param {*} props * @param {*} key * @param {string|object} ref * @param {*} owner * @param {*} self A *temporary* helper to detect places where `this` is * different from the `owner` when React.createElement is called, so that we * can warn. We want to get rid of owner and replace string `ref`s with arrow * functions, and as long as `this` and owner are the same, there will be no * change in behavior. * @param {*} source An annotation object (added by a transpiler or otherwise) * indicating filename, line number, and/or other information. * @internal */ var ReactElement = function (type, key, ref, self, source, owner, props) { var element = { // This tag allows us to uniquely identify this as a React Element $$typeof: REACT_ELEMENT_TYPE, // Built-in properties that belong on the element type: type, key: key, ref: ref, props: props, // Record the component responsible for creating this element. _owner: owner, } { // The validation flag is currently mutative. We put it on // an external backing store so that we can freeze the whole object. // This can be replaced with a WeakMap once they are implemented in // commonly used development environments. element._store = {} // To make comparing ReactElements easier for testing purposes, we make // the validation flag non-enumerable (where possible, which should // include every environment we run tests in), so the test framework // ignores it. Object.defineProperty(element._store, 'validated', { configurable: false, enumerable: false, writable: true, value: false, }) // self and source are DEV only properties. Object.defineProperty(element, '_self', { configurable: false, enumerable: false, writable: false, value: self, }) // Two elements created in two different places should be considered // equal for testing purposes and therefore we hide it from enumeration. Object.defineProperty(element, '_source', { configurable: false, enumerable: false, writable: false, value: source, }) if (Object.freeze) { Object.freeze(element.props) Object.freeze(element) } } return element } /** * Create and return a new ReactElement of the given type. * See https://reactjs.org/docs/react-api.html#createelement */ function createElement(type, config, children) { var propName // Reserved names are extracted var props = {} var key = null var ref = null var self = null var source = null if (config != null) { if (hasValidRef(config)) { ref = config.ref { warnIfStringRefCannotBeAutoConverted(config) } } if (hasValidKey(config)) { { checkKeyStringCoercion(config.key) } key = '' + config.key } self = config.__self === undefined ? null : config.__self source = config.__source === undefined ? null : config.__source // Remaining properties are added to a new props object for (propName in config) { if ( hasOwnProperty.call(config, propName) && !RESERVED_PROPS.hasOwnProperty(propName) ) { props[propName] = config[propName] } } } // Children can be more than one argument, and those are transferred onto // the newly allocated props object. var childrenLength = arguments.length - 2 if (childrenLength === 1) { props.children = children } else if (childrenLength > 1) { var childArray = Array(childrenLength) for (var i = 0; i < childrenLength; i++) { childArray[i] = arguments[i + 2] } { if (Object.freeze) { Object.freeze(childArray) } } props.children = childArray } // Resolve default props if (type && type.defaultProps) { var defaultProps = type.defaultProps for (propName in defaultProps) { if (props[propName] === undefined) { props[propName] = defaultProps[propName] } } } { if (key || ref) { var displayName = typeof type === 'function' ? type.displayName || type.name || 'Unknown' : type if (key) { defineKeyPropWarningGetter(props, displayName) } if (ref) { defineRefPropWarningGetter(props, displayName) } } } return ReactElement(type, key, ref, self, source, ReactCurrentOwner.current, props) } function cloneAndReplaceKey(oldElement, newKey) { var newElement = ReactElement( oldElement.type, newKey, oldElement.ref, oldElement._self, oldElement._source, oldElement._owner, oldElement.props ) return newElement } /** * Clone and return a new ReactElement using element as the starting point. * See https://reactjs.org/docs/react-api.html#cloneelement */ function cloneElement(element, config, children) { if (element === null || element === undefined) { throw new Error( 'React.cloneElement(...): The argument must be a React element, but you passed ' + element + '.' ) } var propName // Original props are copied var props = assign({}, element.props) // Reserved names are extracted var key = element.key var ref = element.ref // Self is preserved since the owner is preserved. var self = element._self // Source is preserved since cloneElement is unlikely to be targeted by a // transpiler, and the original source is probably a better indicator of the // true owner. var source = element._source // Owner will be preserved, unless ref is overridden var owner = element._owner if (config != null) { if (hasValidRef(config)) { // Silently steal the ref from the parent. ref = config.ref owner = ReactCurrentOwner.current } if (hasValidKey(config)) { { checkKeyStringCoercion(config.key) } key = '' + config.key } // Remaining properties override existing props var defaultProps if (element.type && element.type.defaultProps) { defaultProps = element.type.defaultProps } for (propName in config) { if ( hasOwnProperty.call(config, propName) && !RESERVED_PROPS.hasOwnProperty(propName) ) { if (config[propName] === undefined && defaultProps !== undefined) { // Resolve default props props[propName] = defaultProps[propName] } else { props[propName] = config[propName] } } } } // Children can be more than one argument, and those are transferred onto // the newly allocated props object. var childrenLength = arguments.length - 2 if (childrenLength === 1) { props.children = children } else if (childrenLength > 1) { var childArray = Array(childrenLength) for (var i = 0; i < childrenLength; i++) { childArray[i] = arguments[i + 2] } props.children = childArray } return ReactElement(element.type, key, ref, self, source, owner, props) } /** * Verifies the object is a ReactElement. * See https://reactjs.org/docs/react-api.html#isvalidelement * @param {?object} object * @return {boolean} True if `object` is a ReactElement. * @final */ function isValidElement(object) { return ( typeof object === 'object' && object !== null && object.$$typeof === REACT_ELEMENT_TYPE ) } var SEPARATOR = '.' var SUBSEPARATOR = ':' /** * Escape and wrap key so it is safe to use as a reactid * * @param {string} key to be escaped. * @return {string} the escaped key. */ function escape(key) { var escapeRegex = /[=:]/g var escaperLookup = { '=': '=0', ':': '=2', } var escapedString = key.replace(escapeRegex, function (match) { return escaperLookup[match] }) return '$' + escapedString } /** * TODO: Test that a single child and an array with one item have the same key * pattern. */ var didWarnAboutMaps = false var userProvidedKeyEscapeRegex = /\/+/g function escapeUserProvidedKey(text) { return text.replace(userProvidedKeyEscapeRegex, '$&/') } /** * Generate a key string that identifies a element within a set. * * @param {*} element A element that could contain a manual key. * @param {number} index Index that is used if a manual key is not provided. * @return {string} */ function getElementKey(element, index) { // Do some typechecking here since we call this blindly. We want to ensure // that we don't block potential future ES APIs. if (typeof element === 'object' && element !== null && element.key != null) { // Explicit key { checkKeyStringCoercion(element.key) } return escape('' + element.key) } // Implicit key determined by the index in the set return index.toString(36) } function mapIntoArray(children, array, escapedPrefix, nameSoFar, callback) { var type = typeof children if (type === 'undefined' || type === 'boolean') { // All of the above are perceived as null. children = null } var invokeCallback = false if (children === null) { invokeCallback = true } else { switch (type) { case 'string': case 'number': invokeCallback = true break case 'object': switch (children.$$typeof) { case REACT_ELEMENT_TYPE: case REACT_PORTAL_TYPE: invokeCallback = true } } } if (invokeCallback) { var _child = children var mappedChild = callback(_child) // If it's the only child, treat the name as if it was wrapped in an array // so that it's consistent if the number of children grows: var childKey = nameSoFar === '' ? SEPARATOR + getElementKey(_child, 0) : nameSoFar if (isArray(mappedChild)) { var escapedChildKey = '' if (childKey != null) { escapedChildKey = escapeUserProvidedKey(childKey) + '/' } mapIntoArray(mappedChild, array, escapedChildKey, '', function (c) { return c }) } else if (mappedChild != null) { if (isValidElement(mappedChild)) { { // The `if` statement here prevents auto-disabling of the safe // coercion ESLint rule, so we must manually disable it below. // $FlowFixMe Flow incorrectly thinks React.Portal doesn't have a key if (mappedChild.key && (!_child || _child.key !== mappedChild.key)) { checkKeyStringCoercion(mappedChild.key) } } mappedChild = cloneAndReplaceKey( mappedChild, // Keep both the (mapped) and old keys if they differ, just as // traverseAllChildren used to do for objects as children escapedPrefix + // $FlowFixMe Flow incorrectly thinks React.Portal doesn't have a key (mappedChild.key && (!_child || _child.key !== mappedChild.key) // $FlowFixMe Flow incorrectly thinks existing element's key can be a number ? // eslint-disable-next-line react-internal/safe-string-coercion escapeUserProvidedKey('' + mappedChild.key) + '/' : '') + childKey ) } array.push(mappedChild) } return 1 } var child var nextName var subtreeCount = 0 // Count of children found in the current subtree. var nextNamePrefix = nameSoFar === '' ? SEPARATOR : nameSoFar + SUBSEPARATOR if (isArray(children)) { for (var i = 0; i < children.length; i++) { child = children[i] nextName = nextNamePrefix + getElementKey(child, i) subtreeCount += mapIntoArray(child, array, escapedPrefix, nextName, callback) } } else { var iteratorFn = getIteratorFn(children) if (typeof iteratorFn === 'function') { var iterableChildren = children { // Warn about using Maps as children if (iteratorFn === iterableChildren.entries) { if (!didWarnAboutMaps) { warn( 'Using Maps as children is not supported. ' + 'Use an array of keyed ReactElements instead.' ) } didWarnAboutMaps = true } } var iterator = iteratorFn.call(iterableChildren) var step var ii = 0 while (!(step = iterator.next()).done) { child = step.value nextName = nextNamePrefix + getElementKey(child, ii++) subtreeCount += mapIntoArray(child, array, escapedPrefix, nextName, callback) } } else if (type === 'object') { // eslint-disable-next-line react-internal/safe-string-coercion var childrenString = String(children) throw new Error( 'Objects are not valid as a React child (found: ' + (childrenString === '[object Object]' ? 'object with keys {' + Object.keys(children).join(', ') + '}' : childrenString) + '). ' + 'If you meant to render a collection of children, use an array ' + 'instead.' ) } } return subtreeCount } /** * Maps children that are typically specified as `props.children`. * * See https://reactjs.org/docs/react-api.html#reactchildrenmap * * The provided mapFunction(child, index) will be called for each * leaf child. * * @param {?*} children Children tree container. * @param {function(*, int)} func The map function. * @param {*} context Context for mapFunction. * @return {object} Object containing the ordered map of results. */ function mapChildren(children, func, context) { if (children == null) { return children } var result = [] var count = 0 mapIntoArray(children, result, '', '', function (child) { return func.call(context, child, count++) }) return result } /** * Count the number of children that are typically specified as * `props.children`. * * See https://reactjs.org/docs/react-api.html#reactchildrencount * * @param {?*} children Children tree container. * @return {number} The number of children. */ function countChildren(children) { var n = 0 mapChildren(children, function () { n++ // Don't return anything }) return n } /** * Iterates through children that are typically specified as `props.children`. * * See https://reactjs.org/docs/react-api.html#reactchildrenforeach * * The provided forEachFunc(child, index) will be called for each * leaf child. * * @param {?*} children Children tree container. * @param {function(*, int)} forEachFunc * @param {*} forEachContext Context for forEachContext. */ function forEachChildren(children, forEachFunc, forEachContext) { mapChildren( children, function () { forEachFunc.apply(this, arguments) // Don't return anything. }, forEachContext ) } /** * Flatten a children object (typically specified as `props.children`) and * return an array with appropriately re-keyed children. * * See https://reactjs.org/docs/react-api.html#reactchildrentoarray */ function toArray(children) { return ( mapChildren(children, function (child) { return child }) || [] ) } /** * Returns the first child in a collection of children and verifies that there * is only one child in the collection. * * See https://reactjs.org/docs/react-api.html#reactchildrenonly * * The current implementation of this function assumes that a single child gets * passed without a wrapper, but the purpose of this helper function is to * abstract away the particular structure of children. * * @param {?object} children Child collection structure. * @return {ReactElement} The first and only `ReactElement` contained in the * structure. */ function onlyChild(children) { if (!isValidElement(children)) { throw new Error( 'React.Children.only expected to receive a single React element child.' ) } return children } function createContext(defaultValue) { // TODO: Second argument used to be an optional `calculateChangedBits` // function. Warn to reserve for future use? var context = { $$typeof: REACT_CONTEXT_TYPE, // As a workaround to support multiple concurrent renderers, we categorize // some renderers as primary and others as secondary. We only expect // there to be two concurrent renderers at most: React Native (primary) and // Fabric (secondary); React DOM (primary) and React ART (secondary). // Secondary renderers store their context values on separate fields. _currentValue: defaultValue, _currentValue2: defaultValue, // Used to track how many concurrent renderers this context currently // supports within in a single renderer. Such as parallel server rendering. _threadCount: 0, // These are circular Provider: null, Consumer: null, // Add these to use same hidden class in VM as ServerContext _defaultValue: null, _globalName: null, } context.Provider = { $$typeof: REACT_PROVIDER_TYPE, _context: context, } var hasWarnedAboutUsingNestedContextConsumers = false var hasWarnedAboutUsingConsumerProvider = false var hasWarnedAboutDisplayNameOnConsumer = false { // A separate object, but proxies back to the original context object for // backwards compatibility. It has a different $$typeof, so we can properly // warn for the incorrect usage of Context as a Consumer. var Consumer = { $$typeof: REACT_CONTEXT_TYPE, _context: context, } // $FlowFixMe: Flow complains about not setting a value, which is intentional here Object.defineProperties(Consumer, { Provider: { get: function () { if (!hasWarnedAboutUsingConsumerProvider) { hasWarnedAboutUsingConsumerProvider = true error( 'Rendering <Context.Consumer.Provider> is not supported and will be removed in ' + 'a future major release. Did you mean to render <Context.Provider> instead?' ) } return context.Provider }, set: function (_Provider) { context.Provider = _Provider }, }, _currentValue: { get: function () { return context._currentValue }, set: function (_currentValue) { context._currentValue = _currentValue }, }, _currentValue2: { get: function () { return context._currentValue2 }, set: function (_currentValue2) { context._currentValue2 = _currentValue2 }, }, _threadCount: { get: function () { return context._threadCount }, set: function (_threadCount) { context._threadCount = _threadCount }, }, Consumer: { get: function () { if (!hasWarnedAboutUsingNestedContextConsumers) { hasWarnedAboutUsingNestedContextConsumers = true error( 'Rendering <Context.Consumer.Consumer> is not supported and will be removed in ' + 'a future major release. Did you mean to render <Context.Consumer> instead?' ) } return context.Consumer }, }, displayName: { get: function () { return context.displayName }, set: function (displayName) { if (!hasWarnedAboutDisplayNameOnConsumer) { warn( 'Setting `displayName` on Context.Consumer has no effect. ' + "You should set it directly on the context with Context.displayName = '%s'.", displayName ) hasWarnedAboutDisplayNameOnConsumer = true } }, }, }) // $FlowFixMe: Flow complains about missing properties because it doesn't understand defineProperty context.Consumer = Consumer } { context._currentRenderer = null context._currentRenderer2 = null } return context } var Uninitialized = -1 var Pending = 0 var Resolved = 1 var Rejected = 2 function lazyInitializer(payload) { if (payload._status === Uninitialized) { var ctor = payload._result var thenable = ctor() // Transition to the next state. // This might throw either because it's missing or throws. If so, we treat it // as still uninitialized and try again next time. Which is the same as what // happens if the ctor or any wrappers processing the ctor throws. This might // end up fixing it if the resolution was a concurrency bug. thenable.then( function (moduleObject) { if (payload._status === Pending || payload._status === Uninitialized) { // Transition to the next state. var resolved = payload resolved._status = Resolved resolved._result = moduleObject } }, function (error) { if (payload._status === Pending || payload._status === Uninitialized) { // Transition to the next state. var rejected = payload rejected._status = Rejected rejected._result = error } } ) if (payload._status === Uninitialized) { // In case, we're still uninitialized, then we're waiting for the thenable // to resolve. Set it as pending in the meantime. var pending = payload pending._status = Pending pending._result = thenable } } if (payload._status === Resolved) { var moduleObject = payload._result { if (moduleObject === undefined) { error( 'lazy: Expected the result of a dynamic imp' + 'ort() call. ' + 'Instead received: %s\n\nYour code should look like: \n ' + // Break up imports to avoid accidentally parsing them as dependencies. 'const MyComponent = lazy(() => imp' + "ort('./MyComponent'))\n\n" + 'Did you accidentally put curly brac