mirror of
https://github.com/zebrajr/react.git
synced 2025-12-07 00:20:28 +01:00
ffd8423356
* Refactor Flight to require a module reference to be brand checked This exposes a host environment (bundler) specific hook to check if an object is a module reference. This will be used so that they can be passed directly into Flight without needing additional wrapper objects. * Emit module references as a special type of value We already have JSON and errors as special types of "rows". This encodes module references as a special type of row value. This was always the intention because it allows those values to be emitted first in the stream so that as a large models stream down, we can start preloading as early as possible. We preload the module when they resolve but we lazily require them as they are referenced. * Emit module references where ever they occur This emits module references where ever they occur. In blocks or even directly in elements. * Don't special case the root row I originally did this so that a simple stream is also just plain JSON. However, since we might want to emit things like modules before the root module in the stream, this gets unnecessarily complicated. We could add this back as a special case if it's the first byte written but meh. * Update the protocol * Add test for using a module reference as a client component * Relax element type check Since Flight now accepts a module reference as returned by any bundler system, depending on the renderer running. We need to drastically relax the check to include all of them. We can add more as we discover them. * Move flow annotation Seems like our compiler is not happy with stripping this. * Some bookkeeping bug * Can't use the private field to check
66 lines
1.6 KiB
JavaScript
66 lines
1.6 KiB
JavaScript
/**
|
|
* 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.
|
|
*
|
|
* @flow
|
|
*/
|
|
|
|
type JSONValue =
|
|
| string
|
|
| boolean
|
|
| number
|
|
| null
|
|
| {+[key: string]: JSONValue}
|
|
| $ReadOnlyArray<JSONValue>;
|
|
|
|
declare class JSResourceReference<T> {
|
|
_moduleId: T;
|
|
}
|
|
|
|
declare module 'JSResourceReference' {
|
|
declare export default typeof JSResourceReference;
|
|
}
|
|
|
|
declare module 'ReactFlightDOMRelayServerIntegration' {
|
|
declare export opaque type Destination;
|
|
declare export opaque type BundlerConfig;
|
|
declare export function emitModel(
|
|
destination: Destination,
|
|
id: number,
|
|
json: JSONValue,
|
|
): void;
|
|
declare export function emitModule(
|
|
destination: Destination,
|
|
id: number,
|
|
json: ModuleMetaData,
|
|
): void;
|
|
declare export function emitError(
|
|
destination: Destination,
|
|
id: number,
|
|
message: string,
|
|
stack: string,
|
|
): void;
|
|
declare export function close(destination: Destination): void;
|
|
|
|
declare export type ModuleMetaData = JSONValue;
|
|
declare export function resolveModuleMetaData<T>(
|
|
config: BundlerConfig,
|
|
resourceReference: JSResourceReference<T>,
|
|
): ModuleMetaData;
|
|
}
|
|
|
|
declare module 'ReactFlightDOMRelayClientIntegration' {
|
|
declare export opaque type ModuleMetaData;
|
|
declare export function resolveModuleReference<T>(
|
|
moduleData: ModuleMetaData,
|
|
): JSResourceReference<T>;
|
|
declare export function preloadModule<T>(
|
|
moduleReference: JSResourceReference<T>,
|
|
): void;
|
|
declare export function requireModule<T>(
|
|
moduleReference: JSResourceReference<T>,
|
|
): T;
|
|
}
|