[CS] Persistent Updates (#11260)
* Update build size
* [CS] Clone container instead of new root concept
The extra "root" concept is kind of unnecessary. Instead of having a
mutable container even in the persistent mode, I'll instead make the
container be immutable too and be cloned. Then the "commit" just becomes
swapping the previous container for the new one.
* Change the signature or persistence again
We may need to clone without any updates, e.g. when the children are changed.
Passing in the previous node is not enough to recycle since it won't have the
up-to-date props and children. It's really only useful to for allocation pooling.
* Implement persistent updates
This forks the update path for host fibers. For mutation mode we mark
them as having an effect. For persistence mode, we clone the stateNode with
new props/children.
Next I'll do HostRoot and HostPortal.
* Refine protocol into a complete and commit phase
finalizeContainerChildren will get called at the complete phase.
replaceContainer will get called at commit.
Also, drop the keepChildren flag. We'll never keep children as we'll never
update a container if none of the children has changed.
* Implement persistent updates of roots and portals
These are both "containers". Normally we rely on placement/deletion effects
to deal with insertions into the containers. In the persistent mode we need
to clone the container and append all the changed children to it.
I needed somewhere to store these new containers before they're committed
so I added another field.
* Commit persistent work at the end by swapping out the container
* Unify cloneOrRecycle
Originally I tried to make the recyclable instance nullable but Flow didn't
like that and it's kind of sketchy since the instance type might not be
nullable.
However, the real difference which one we call is depending on whether they
are equal. We can just offload that to the renderer. Most of them won't
need to know about this at all since they'll always clone or just create
new.
The ones that do know now have to be careful to compare them so they don't
reuse an existing instance but that's probably fine to simplify the
implementation and API.
* Add persistent noop renderer for testing
* Add basic persistent tree test
* Test bail out
This adds a test for bailouts. This revealed a subtle bug. We don't set the
return pointer when stepping into newly created fibers because there
can only be one. However, since I'm reusing this mechanism for persistent
updates, I'll need to set the return pointer because a bailed out tree
won't have the right return pointer.
* Test persistent text nodes
Found another bug.
* Add persistent portal test
This creates a bit of an unfortunate feature testing in the unmount
branch.
That's because we want to trigger nested host deletions in portals in the
mutation mode.
* Don't consider container when determining portal identity
Basically, we can't use the container to determine if we should keep
identity and update an existing portal instead of recreate it. Because
for persistent containers, there is no permanent identity.
This makes it kind of strange to even use portals in this mode. It's
probably more ideal to have another concept that has permanent identity
rather than trying to swap out containers.
* Clear portals when the portal is deleted
When a portal gets deleted we need to create a new empty container and
replace the current one with the empty one.
* Add renderer mode flags for dead code elimination
* Simplify ReactNoop fix
* Add new type to the host config for persistent configs
We need container to stay as the persistent identity of the root atom.
So that we can refer to portals over time.
Instead, I'll introduce a new type just to temporarily hold the children
of a container until they're ready to be committed into the permanent
container. Essentially, this is just a fancy array that is not an array
so that the host can choose data structure/allocation for it.
* Implement new hooks
Now containers are singletons and instead their children swap. That way
portals can use the container as part of their identity again.
* Update build size and error codes
* Address comment
* Move new files to new location
2017-10-19 09:28:23 +08:00
|
|
|
/**
|
2022-10-18 23:19:24 +08:00
|
|
|
* Copyright (c) Meta Platforms, Inc. and affiliates.
|
[CS] Persistent Updates (#11260)
* Update build size
* [CS] Clone container instead of new root concept
The extra "root" concept is kind of unnecessary. Instead of having a
mutable container even in the persistent mode, I'll instead make the
container be immutable too and be cloned. Then the "commit" just becomes
swapping the previous container for the new one.
* Change the signature or persistence again
We may need to clone without any updates, e.g. when the children are changed.
Passing in the previous node is not enough to recycle since it won't have the
up-to-date props and children. It's really only useful to for allocation pooling.
* Implement persistent updates
This forks the update path for host fibers. For mutation mode we mark
them as having an effect. For persistence mode, we clone the stateNode with
new props/children.
Next I'll do HostRoot and HostPortal.
* Refine protocol into a complete and commit phase
finalizeContainerChildren will get called at the complete phase.
replaceContainer will get called at commit.
Also, drop the keepChildren flag. We'll never keep children as we'll never
update a container if none of the children has changed.
* Implement persistent updates of roots and portals
These are both "containers". Normally we rely on placement/deletion effects
to deal with insertions into the containers. In the persistent mode we need
to clone the container and append all the changed children to it.
I needed somewhere to store these new containers before they're committed
so I added another field.
* Commit persistent work at the end by swapping out the container
* Unify cloneOrRecycle
Originally I tried to make the recyclable instance nullable but Flow didn't
like that and it's kind of sketchy since the instance type might not be
nullable.
However, the real difference which one we call is depending on whether they
are equal. We can just offload that to the renderer. Most of them won't
need to know about this at all since they'll always clone or just create
new.
The ones that do know now have to be careful to compare them so they don't
reuse an existing instance but that's probably fine to simplify the
implementation and API.
* Add persistent noop renderer for testing
* Add basic persistent tree test
* Test bail out
This adds a test for bailouts. This revealed a subtle bug. We don't set the
return pointer when stepping into newly created fibers because there
can only be one. However, since I'm reusing this mechanism for persistent
updates, I'll need to set the return pointer because a bailed out tree
won't have the right return pointer.
* Test persistent text nodes
Found another bug.
* Add persistent portal test
This creates a bit of an unfortunate feature testing in the unmount
branch.
That's because we want to trigger nested host deletions in portals in the
mutation mode.
* Don't consider container when determining portal identity
Basically, we can't use the container to determine if we should keep
identity and update an existing portal instead of recreate it. Because
for persistent containers, there is no permanent identity.
This makes it kind of strange to even use portals in this mode. It's
probably more ideal to have another concept that has permanent identity
rather than trying to swap out containers.
* Clear portals when the portal is deleted
When a portal gets deleted we need to create a new empty container and
replace the current one with the empty one.
* Add renderer mode flags for dead code elimination
* Simplify ReactNoop fix
* Add new type to the host config for persistent configs
We need container to stay as the persistent identity of the root atom.
So that we can refer to portals over time.
Instead, I'll introduce a new type just to temporarily hold the children
of a container until they're ready to be committed into the permanent
container. Essentially, this is just a fancy array that is not an array
so that the host can choose data structure/allocation for it.
* Implement new hooks
Now containers are singletons and instead their children swap. That way
portals can use the container as part of their identity again.
* Update build size and error codes
* Address comment
* Move new files to new location
2017-10-19 09:28:23 +08:00
|
|
|
*
|
|
|
|
|
* This source code is licensed under the MIT license found in the
|
|
|
|
|
* LICENSE file in the root directory of this source tree.
|
|
|
|
|
*
|
|
|
|
|
* @flow
|
|
|
|
|
*/
|
|
|
|
|
|
2017-11-06 22:14:48 +08:00
|
|
|
import typeof * as FeatureFlagsType from 'shared/ReactFeatureFlags';
|
2020-02-14 04:33:53 +08:00
|
|
|
import typeof * as ExportsType from './ReactFeatureFlags.native-oss';
|
[CS] Persistent Updates (#11260)
* Update build size
* [CS] Clone container instead of new root concept
The extra "root" concept is kind of unnecessary. Instead of having a
mutable container even in the persistent mode, I'll instead make the
container be immutable too and be cloned. Then the "commit" just becomes
swapping the previous container for the new one.
* Change the signature or persistence again
We may need to clone without any updates, e.g. when the children are changed.
Passing in the previous node is not enough to recycle since it won't have the
up-to-date props and children. It's really only useful to for allocation pooling.
* Implement persistent updates
This forks the update path for host fibers. For mutation mode we mark
them as having an effect. For persistence mode, we clone the stateNode with
new props/children.
Next I'll do HostRoot and HostPortal.
* Refine protocol into a complete and commit phase
finalizeContainerChildren will get called at the complete phase.
replaceContainer will get called at commit.
Also, drop the keepChildren flag. We'll never keep children as we'll never
update a container if none of the children has changed.
* Implement persistent updates of roots and portals
These are both "containers". Normally we rely on placement/deletion effects
to deal with insertions into the containers. In the persistent mode we need
to clone the container and append all the changed children to it.
I needed somewhere to store these new containers before they're committed
so I added another field.
* Commit persistent work at the end by swapping out the container
* Unify cloneOrRecycle
Originally I tried to make the recyclable instance nullable but Flow didn't
like that and it's kind of sketchy since the instance type might not be
nullable.
However, the real difference which one we call is depending on whether they
are equal. We can just offload that to the renderer. Most of them won't
need to know about this at all since they'll always clone or just create
new.
The ones that do know now have to be careful to compare them so they don't
reuse an existing instance but that's probably fine to simplify the
implementation and API.
* Add persistent noop renderer for testing
* Add basic persistent tree test
* Test bail out
This adds a test for bailouts. This revealed a subtle bug. We don't set the
return pointer when stepping into newly created fibers because there
can only be one. However, since I'm reusing this mechanism for persistent
updates, I'll need to set the return pointer because a bailed out tree
won't have the right return pointer.
* Test persistent text nodes
Found another bug.
* Add persistent portal test
This creates a bit of an unfortunate feature testing in the unmount
branch.
That's because we want to trigger nested host deletions in portals in the
mutation mode.
* Don't consider container when determining portal identity
Basically, we can't use the container to determine if we should keep
identity and update an existing portal instead of recreate it. Because
for persistent containers, there is no permanent identity.
This makes it kind of strange to even use portals in this mode. It's
probably more ideal to have another concept that has permanent identity
rather than trying to swap out containers.
* Clear portals when the portal is deleted
When a portal gets deleted we need to create a new empty container and
replace the current one with the empty one.
* Add renderer mode flags for dead code elimination
* Simplify ReactNoop fix
* Add new type to the host config for persistent configs
We need container to stay as the persistent identity of the root atom.
So that we can refer to portals over time.
Instead, I'll introduce a new type just to temporarily hold the children
of a container until they're ready to be committed into the permanent
container. Essentially, this is just a fancy array that is not an array
so that the host can choose data structure/allocation for it.
* Implement new hooks
Now containers are singletons and instead their children swap. That way
portals can use the container as part of their identity again.
* Update build size and error codes
* Address comment
* Move new files to new location
2017-10-19 09:28:23 +08:00
|
|
|
|
2018-01-26 06:30:53 +08:00
|
|
|
export const debugRenderPhaseSideEffectsForStrictMode = false;
|
2020-04-16 10:10:15 +08:00
|
|
|
export const enableDebugTracing = false;
|
2020-07-08 22:36:02 +08:00
|
|
|
export const enableSchedulingProfiler = false;
|
2018-04-19 04:16:50 +08:00
|
|
|
export const replayFailedUnitOfWorkWithInvokeGuardedCallback = __DEV__;
|
2019-03-28 07:30:49 +08:00
|
|
|
export const warnAboutDeprecatedLifecycles = true;
|
2018-06-12 04:16:27 +08:00
|
|
|
export const enableProfilerTimer = __PROFILE__;
|
2021-05-26 05:32:14 +08:00
|
|
|
export const enableProfilerCommitHooks = __PROFILE__;
|
|
|
|
|
export const enableProfilerNestedUpdatePhase = __PROFILE__;
|
2020-11-12 22:31:27 +08:00
|
|
|
export const enableProfilerNestedUpdateScheduledHook = false;
|
2021-05-26 05:41:19 +08:00
|
|
|
export const enableUpdaterTracking = __PROFILE__;
|
2020-12-03 11:44:56 +08:00
|
|
|
export const enableCache = false;
|
2022-10-24 11:20:52 +08:00
|
|
|
export const enableLegacyCache = false;
|
2022-03-21 11:41:02 +08:00
|
|
|
export const enableCacheElement = false;
|
2022-10-20 06:37:00 +08:00
|
|
|
export const enableFetchInstrumentation = false;
|
2019-03-12 07:39:49 +08:00
|
|
|
export const disableJavaScriptURLs = false;
|
2022-02-18 05:44:22 +08:00
|
|
|
export const disableCommentsAsDOMContainers = true;
|
2018-09-13 02:29:23 +08:00
|
|
|
export const disableInputAttributeSyncing = false;
|
2018-12-07 05:57:23 +08:00
|
|
|
export const enableSchedulerDebugging = false;
|
2019-08-29 19:06:51 +08:00
|
|
|
export const enableScopeAPI = false;
|
2020-05-13 02:01:12 +08:00
|
|
|
export const enableCreateEventHandleAPI = false;
|
2019-07-24 08:13:46 +08:00
|
|
|
export const enableSuspenseCallback = false;
|
2022-11-18 01:22:23 +08:00
|
|
|
export const warnAboutDefaultPropsOnFunctionComponents = true;
|
2022-11-17 08:15:57 +08:00
|
|
|
export const warnAboutStringRefs = true;
|
2019-08-02 08:21:32 +08:00
|
|
|
export const disableLegacyContext = false;
|
2019-08-03 08:52:32 +08:00
|
|
|
export const disableSchedulerTimeoutBasedOnReactExpirationTime = false;
|
2019-09-16 20:43:22 +08:00
|
|
|
export const enableTrustedTypesIntegration = false;
|
2020-01-20 23:12:30 +08:00
|
|
|
export const disableTextareaChildren = false;
|
2020-03-07 02:46:32 +08:00
|
|
|
export const disableModulePatternComponents = false;
|
2022-11-17 07:57:50 +08:00
|
|
|
export const warnAboutSpreadingKeyToJSX = true;
|
2021-09-21 03:44:48 +08:00
|
|
|
export const enableSuspenseAvoidThisFallback = false;
|
2022-02-02 07:22:04 +08:00
|
|
|
export const enableSuspenseAvoidThisFallbackFizz = false;
|
2022-03-08 14:33:52 +08:00
|
|
|
export const enableCPUSuspense = false;
|
2022-10-24 11:20:52 +08:00
|
|
|
export const enableUseHook = true;
|
2022-08-23 16:36:02 +08:00
|
|
|
export const enableUseMemoCacheHook = false;
|
2022-09-15 02:39:06 +08:00
|
|
|
export const enableUseEventHook = false;
|
2022-04-20 05:34:30 +08:00
|
|
|
export const enableCapturePhaseSelectiveHydrationWithoutDiscreteEventReplay = true;
|
2022-06-16 23:38:37 +08:00
|
|
|
export const enableClientRenderFallbackOnTextMismatch = true;
|
2020-04-07 06:43:39 +08:00
|
|
|
export const enableComponentStackLocations = false;
|
2020-03-19 21:22:36 +08:00
|
|
|
export const enableLegacyFBSupport = false;
|
2020-07-31 22:01:27 +08:00
|
|
|
export const enableFilterEmptyStringAttributesDOM = false;
|
2020-12-02 23:25:55 +08:00
|
|
|
export const disableNativeComponentFrames = false;
|
2022-03-01 00:14:30 +08:00
|
|
|
export const skipUnmountedBoundaries = false;
|
2021-06-15 03:10:24 +08:00
|
|
|
export const deletedTreeCleanUpLevel = 3;
|
2021-07-26 21:56:59 +08:00
|
|
|
export const enableGetInspectorDataForInstanceInProduction = false;
|
2021-06-03 02:28:06 +08:00
|
|
|
export const deferRenderPhaseUpdateToNextBatch = false;
|
2020-03-13 02:38:32 +08:00
|
|
|
|
2021-02-25 05:14:14 +08:00
|
|
|
export const createRootStrictEffectsByDefault = false;
|
2020-10-20 04:05:00 +08:00
|
|
|
export const enableUseRefAccessWarning = false;
|
2020-09-25 04:42:17 +08:00
|
|
|
|
2020-12-18 06:17:23 +08:00
|
|
|
export const disableSchedulerTimeoutInWorkLoop = false;
|
2021-02-26 06:42:11 +08:00
|
|
|
export const enableLazyContextPropagation = false;
|
2022-03-10 00:48:03 +08:00
|
|
|
export const enableLegacyHidden = false;
|
2021-04-10 07:50:09 +08:00
|
|
|
export const enableSyncDefaultUpdates = true;
|
2021-04-29 04:09:30 +08:00
|
|
|
export const allowConcurrentByDefault = false;
|
2021-12-08 23:11:42 +08:00
|
|
|
export const enableCustomElementPropertySupport = false;
|
2020-10-28 03:02:19 +08:00
|
|
|
|
2021-09-02 02:56:52 +08:00
|
|
|
export const consoleManagedByDevToolsDuringStrictMode = false;
|
2022-10-24 11:20:52 +08:00
|
|
|
export const enableServerContext = true;
|
2021-11-01 12:39:51 +08:00
|
|
|
export const enableUseMutableSource = false;
|
2021-09-02 02:56:52 +08:00
|
|
|
|
2022-01-11 04:32:40 +08:00
|
|
|
export const enableTransitionTracing = false;
|
|
|
|
|
|
2022-10-24 11:20:52 +08:00
|
|
|
export const enableFloat = true;
|
|
|
|
|
export const enableHostSingletons = true;
|
2022-10-01 00:06:11 +08:00
|
|
|
|
|
|
|
|
export const useModernStrictMode = false;
|
2022-10-18 05:57:59 +08:00
|
|
|
export const enableFizzExternalRuntime = false;
|
2022-10-05 01:25:17 +08:00
|
|
|
|
2017-11-06 22:14:48 +08:00
|
|
|
// Flow magic to verify the exports of this file match the original version.
|
2022-10-05 01:25:17 +08:00
|
|
|
((((null: any): ExportsType): FeatureFlagsType): ExportsType);
|