@live-react-islands/core 0.1.0 → 0.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +1 -1
- package/README.md +454 -0
- package/dist/createHooks.d.ts +3 -1
- package/dist/createHooks.d.ts.map +1 -1
- package/dist/index.esm.js +9 -2
- package/dist/index.esm.js.map +1 -1
- package/dist/index.js +9 -2
- package/dist/index.js.map +1 -1
- package/dist/ssr.esm.js.map +1 -1
- package/dist/ssr.js.map +1 -1
- package/package.json +21 -15
- package/src/createHooks.ts +12 -3
- package/dist/IslandRenderer.d.ts +0 -11
- package/dist/IslandRenderer.d.ts.map +0 -1
- package/dist/client/IndividualIslandRenderer.d.ts +0 -14
- package/dist/client/IndividualIslandRenderer.d.ts.map +0 -1
- package/dist/client/PortalIslandsRenderer.d.ts +0 -4
- package/dist/client/PortalIslandsRenderer.d.ts.map +0 -1
- package/dist/client/islandsManager.d.ts +0 -23
- package/dist/client/islandsManager.d.ts.map +0 -1
- package/dist/client.d.ts +0 -23
- package/dist/client.d.ts.map +0 -1
- package/dist/island-manager.d.ts +0 -59
- package/dist/island-manager.d.ts.map +0 -1
- package/dist/server.d.ts +0 -18
- package/dist/server.d.ts.map +0 -1
- package/dist/useIslandStream.d.ts +0 -15
- package/dist/useIslandStream.d.ts.map +0 -1
package/dist/client.d.ts.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAuB,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,KAAK,EACV,UAAU,EAGV,wBAAwB,EAEzB,MAAM,SAAS,CAAC;AAMjB,UAAU,YAAY;IACpB,EAAE,EAAE,WAAW,CAAC;IAChB,SAAS,EAAE,CACT,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,GAAG,EACZ,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,KAAK,IAAI,KACtC,IAAI,CAAC;IACV,WAAW,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,KAAK,IAAI,CAAC;IACnE,WAAW,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,KAAK,IAAI,CAAC;CACrE;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,UAAU,CAAC;IACpB,qBAAqB,CAAC,EAAE,wBAAwB,CAAC;IACjD,kBAAkB,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI,CAAC,GAAG,IAAI,CAAC;IAClD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAiDD,wBAAgB,WAAW,CAAC,EAC1B,OAAO,EAAE,UAAe,EACxB,qBAA2C,EAC3C,kBAAyB,EACzB,OAAwB,GACzB,EAAE,kBAAkB;;iBAOR,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI;kBAC3B,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI;mBAC3B,CAAC,IAAI,EAAE,YAAY,KAAK,IAAI;;EA0F1C"}
|
package/dist/island-manager.d.ts
DELETED
|
@@ -1,59 +0,0 @@
|
|
|
1
|
-
import React, { ComponentType } from "react";
|
|
2
|
-
import ReactDOM from "react-dom/client";
|
|
3
|
-
export * from "./types";
|
|
4
|
-
import type { IslandsMap, IslandComponent, State, MountIslandParams, PushEventFn, UnmountIslandParams } from "./types";
|
|
5
|
-
export interface MountResult {
|
|
6
|
-
rootType: "shared" | "individual";
|
|
7
|
-
root?: ReactDOM.Root;
|
|
8
|
-
}
|
|
9
|
-
export declare const SHARED_ROOT_ID = "__live_react_islands_root__";
|
|
10
|
-
export declare const needsHydration: (element: HTMLElement) => boolean;
|
|
11
|
-
export declare const extractIslandConfig: (islandComponents: IslandsMap, componentName: string) => {
|
|
12
|
-
Component: IslandComponent;
|
|
13
|
-
ContextProvider?: ComponentType<{
|
|
14
|
-
children: React.ReactNode;
|
|
15
|
-
}>;
|
|
16
|
-
} | null;
|
|
17
|
-
export declare const createSharedRootWithPortals: (ContextProvider: ComponentType<{
|
|
18
|
-
children: React.ReactNode;
|
|
19
|
-
}>, globalState: State, IslandsRootComponent: ComponentType<any>, registryRef: React.RefObject<any>) => ReactDOM.Root;
|
|
20
|
-
export declare const getOrCreateSharedRoot: (ContextProvider: ComponentType<{
|
|
21
|
-
children: React.ReactNode;
|
|
22
|
-
}>, globalState: State, IslandsRootComponent: ComponentType<any>, registryRef: React.RefObject<any>) => ReactDOM.Root;
|
|
23
|
-
export declare const createIndividualRoot: (element: HTMLElement, IndividualRendererComponent: ComponentType<any>, rendererProps: any) => ReactDOM.Root;
|
|
24
|
-
export declare const enableRendering: (state: State) => void;
|
|
25
|
-
export declare const mountSharedIsland: (element: HTMLElement, Component: IslandComponent, props: Record<string, any>, pushEvent: PushEventFn, state: State) => void;
|
|
26
|
-
export declare const mountIndividualIsland: (element: HTMLElement, Component: IslandComponent, props: Record<string, any>, ContextProvider: ComponentType<{
|
|
27
|
-
children: React.ReactNode;
|
|
28
|
-
}>, pushEvent: PushEventFn, IndividualRendererComponent: ComponentType<any>) => ReactDOM.Root;
|
|
29
|
-
export declare const mountIsland: (params: MountIslandParams) => MountResult | null;
|
|
30
|
-
export declare const unmountIsland: (params: UnmountIslandParams) => void;
|
|
31
|
-
export declare const updateSharedIslandProps: (elementId: string, props: Record<string, any>, state: State) => void;
|
|
32
|
-
export declare const cleanupAllRoots: (state: State) => void;
|
|
33
|
-
export declare const handleNavigation: (currentNavigationCounter: number, globalState: State) => boolean;
|
|
34
|
-
export declare const createState: () => State;
|
|
35
|
-
export declare const initializeSharedRoot: (ContextProvider: ComponentType<{
|
|
36
|
-
children: React.ReactNode;
|
|
37
|
-
}>, globalState: State, IslandsRootComponent: ComponentType<any>, registryRef: React.RefObject<any>) => void;
|
|
38
|
-
export interface HookMountParams {
|
|
39
|
-
element: HTMLElement;
|
|
40
|
-
componentName: string;
|
|
41
|
-
islandComponents: IslandsMap;
|
|
42
|
-
defaultContextProvider: ComponentType<{
|
|
43
|
-
children: React.ReactNode;
|
|
44
|
-
}>;
|
|
45
|
-
pushEvent: PushEventFn;
|
|
46
|
-
globalState: State;
|
|
47
|
-
navigationCounter: number;
|
|
48
|
-
globalsRequested: boolean;
|
|
49
|
-
globalStoreHandler: ((data: any) => void) | null;
|
|
50
|
-
onGlobalsRequest: (handler: (data: any) => void, onUpdate: (data: any) => void) => void;
|
|
51
|
-
}
|
|
52
|
-
export interface HookMountResult {
|
|
53
|
-
mountResult: MountResult | null;
|
|
54
|
-
navigationDetected: boolean;
|
|
55
|
-
globalsNowRequested: boolean;
|
|
56
|
-
}
|
|
57
|
-
export declare const mountIslandAndHandleNavigation: (params: HookMountParams) => HookMountResult;
|
|
58
|
-
export declare const updateIslandProps: (elementId: string, props: Record<string, any>, rootType: "shared" | "individual", globalState: State) => void;
|
|
59
|
-
//# sourceMappingURL=island-manager.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"island-manager.d.ts","sourceRoot":"","sources":["../src/island-manager.ts"],"names":[],"mappings":"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"}
|
package/dist/server.d.ts
DELETED
|
@@ -1,18 +0,0 @@
|
|
|
1
|
-
import type { IslandsMap, ContextProviderComponent } from "./types";
|
|
2
|
-
/**
|
|
3
|
-
* Server-side rendering function for React islands.
|
|
4
|
-
*
|
|
5
|
-
* This function creates SSR renderers for your island components.
|
|
6
|
-
* It works in any JavaScript runtime: Deno, Node, Bun, etc.
|
|
7
|
-
*
|
|
8
|
-
* @param islands - Map of island components and optional dedicated conext providers
|
|
9
|
-
* @param SharedContextProvider - Optional React context provider to wrap components
|
|
10
|
-
* @param onHydrateLiveStore - Optional callback for handling global state during SSR
|
|
11
|
-
*/
|
|
12
|
-
export declare function exposeSSR(islands: IslandsMap, SharedContextProvider?: ContextProviderComponent, onHydrateLiveStore?: (data: any) => void): Promise<{
|
|
13
|
-
renderSSRIslandStatic: (key: string, id: string, props?: Record<string, any>, globalState?: any) => string;
|
|
14
|
-
renderers: {
|
|
15
|
-
[k: string]: (id: string, props?: Record<string, any>, globalState?: any) => string;
|
|
16
|
-
};
|
|
17
|
-
}>;
|
|
18
|
-
//# sourceMappingURL=server.d.ts.map
|
package/dist/server.d.ts.map
DELETED
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,wBAAwB,EAAE,MAAM,SAAS,CAAC;AAEpE;;;;;;;;;GASG;AACH,wBAAsB,SAAS,CAC7B,OAAO,EAAE,UAAU,EACnB,qBAAqB,GAAE,wBAAqD,EAC5E,kBAAkB,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,KAAK,IAAI;iCA2CjC,MAAM,MACP,MAAM,UACH,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,gBACb,GAAG,KACf,MAAM;;0BAzCF,MAAM,UAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,gBAAoB,GAAG;;GAiDjE"}
|
|
@@ -1,15 +0,0 @@
|
|
|
1
|
-
import type { IslandStoreAccess, StreamHandle } from "./types";
|
|
2
|
-
interface IslandContext {
|
|
3
|
-
id: string;
|
|
4
|
-
storeAccess: IslandStoreAccess;
|
|
5
|
-
}
|
|
6
|
-
export declare const IslandContextProvider: import("react").Context<IslandContext | null>;
|
|
7
|
-
export interface UseIslandStreamOptions<T> {
|
|
8
|
-
limit?: number;
|
|
9
|
-
sort?: (a: T, b: T) => number;
|
|
10
|
-
}
|
|
11
|
-
export declare function useIslandStream<T extends {
|
|
12
|
-
id: string | number;
|
|
13
|
-
}>(handle: StreamHandle, options?: UseIslandStreamOptions<T>): T[];
|
|
14
|
-
export {};
|
|
15
|
-
//# sourceMappingURL=useIslandStream.d.ts.map
|
|
@@ -1 +0,0 @@
|
|
|
1
|
-
{"version":3,"file":"useIslandStream.d.ts","sourceRoot":"","sources":["../src/useIslandStream.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE/D,UAAU,aAAa;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,iBAAiB,CAAC;CAChC;AAED,eAAO,MAAM,qBAAqB,+CAA4C,CAAC;AAE/E,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,KAAK,MAAM,CAAC;CAC/B;AAED,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,EAC/D,MAAM,EAAE,YAAY,EACpB,OAAO,CAAC,EAAE,sBAAsB,CAAC,CAAC,CAAC,GAClC,CAAC,EAAE,CA2BL"}
|