heliumts 0.10.2 → 0.11.0
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/README.md +45 -46
- package/dist/bin/helium.js +117 -172
- package/dist/bin/helium.js.map +1 -1
- package/dist/bin/projectCommands.d.ts +59 -0
- package/dist/bin/projectCommands.d.ts.map +1 -0
- package/dist/bin/projectCommands.js +103 -0
- package/dist/bin/projectCommands.js.map +1 -0
- package/dist/bin/publicApi.d.ts +30 -0
- package/dist/bin/publicApi.d.ts.map +1 -0
- package/dist/bin/publicApi.js +155 -0
- package/dist/bin/publicApi.js.map +1 -0
- package/dist/client/Router.d.ts.map +1 -1
- package/dist/client/Router.js +5 -1
- package/dist/client/Router.js.map +1 -1
- package/dist/client/callMethod.d.ts +2 -2
- package/dist/client/callMethod.d.ts.map +1 -1
- package/dist/client/callMethod.js +3 -2
- package/dist/client/callMethod.js.map +1 -1
- package/dist/client/index.d.ts +3 -1
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +1 -2
- package/dist/client/index.js.map +1 -1
- package/dist/client/pageModules.d.ts +18 -0
- package/dist/client/pageModules.d.ts.map +1 -0
- package/dist/client/pageModules.js +3 -0
- package/dist/client/pageModules.js.map +1 -0
- package/dist/client/routerManifest.d.ts +2 -11
- package/dist/client/routerManifest.d.ts.map +1 -1
- package/dist/client/routerManifest.js +15 -187
- package/dist/client/routerManifest.js.map +1 -1
- package/dist/client/types.d.ts +12 -12
- package/dist/client/types.d.ts.map +1 -1
- package/dist/client/types.js +8 -1
- package/dist/client/types.js.map +1 -1
- package/dist/client/useCall.d.ts +20 -9
- package/dist/client/useCall.d.ts.map +1 -1
- package/dist/client/useCall.js +21 -6
- package/dist/client/useCall.js.map +1 -1
- package/dist/client/useFetch.d.ts +3 -3
- package/dist/client/useFetch.d.ts.map +1 -1
- package/dist/client/useFetch.js +8 -5
- package/dist/client/useFetch.js.map +1 -1
- package/dist/client/useStreaming.d.ts +3 -3
- package/dist/client/useStreaming.d.ts.map +1 -1
- package/dist/client/useStreaming.js +9 -7
- package/dist/client/useStreaming.js.map +1 -1
- package/dist/internal/index.d.ts +4 -0
- package/dist/internal/index.d.ts.map +1 -0
- package/dist/internal/index.js +4 -0
- package/dist/internal/index.js.map +1 -0
- package/dist/runtime/pageRoutes.d.ts +11 -0
- package/dist/runtime/pageRoutes.d.ts.map +1 -0
- package/dist/runtime/pageRoutes.js +50 -0
- package/dist/runtime/pageRoutes.js.map +1 -0
- package/dist/server/defineMethod.d.ts +16 -2
- package/dist/server/defineMethod.d.ts.map +1 -1
- package/dist/server/defineMethod.js +27 -3
- package/dist/server/defineMethod.js.map +1 -1
- package/dist/server/defineWorker.d.ts.map +1 -1
- package/dist/server/defineWorker.js +4 -6
- package/dist/server/defineWorker.js.map +1 -1
- package/dist/server/devServer.d.ts +2 -1
- package/dist/server/devServer.d.ts.map +1 -1
- package/dist/server/devServer.js +6 -9
- package/dist/server/devServer.js.map +1 -1
- package/dist/server/index.d.ts +16 -9
- package/dist/server/index.d.ts.map +1 -1
- package/dist/server/index.js +9 -12
- package/dist/server/index.js.map +1 -1
- package/dist/server/prodServer.d.ts +2 -0
- package/dist/server/prodServer.d.ts.map +1 -1
- package/dist/server/prodServer.js +7 -5
- package/dist/server/prodServer.js.map +1 -1
- package/dist/server/ssr.d.ts +4 -1
- package/dist/server/ssr.d.ts.map +1 -1
- package/dist/server/ssr.js +27 -61
- package/dist/server/ssr.js.map +1 -1
- package/dist/vite/heliumPlugin.d.ts +0 -14
- package/dist/vite/heliumPlugin.d.ts.map +1 -1
- package/dist/vite/heliumPlugin.js +68 -294
- package/dist/vite/heliumPlugin.js.map +1 -1
- package/dist/vite/paths.d.ts +0 -2
- package/dist/vite/paths.d.ts.map +1 -1
- package/dist/vite/paths.js +0 -2
- package/dist/vite/paths.js.map +1 -1
- package/dist/vite/rpcDiscovery.d.ts +10 -0
- package/dist/vite/rpcDiscovery.d.ts.map +1 -0
- package/dist/vite/rpcDiscovery.js +237 -0
- package/dist/vite/rpcDiscovery.js.map +1 -0
- package/dist/vite/rpcModule.d.ts +4 -0
- package/dist/vite/rpcModule.d.ts.map +1 -0
- package/dist/vite/rpcModule.js +64 -0
- package/dist/vite/rpcModule.js.map +1 -0
- package/dist/vite/scanner.d.ts +14 -4
- package/dist/vite/scanner.d.ts.map +1 -1
- package/dist/vite/scanner.js +130 -236
- package/dist/vite/scanner.js.map +1 -1
- package/dist/vite/serverClientAdapter.d.ts +103 -0
- package/dist/vite/serverClientAdapter.d.ts.map +1 -0
- package/dist/vite/serverClientAdapter.js +139 -0
- package/dist/vite/serverClientAdapter.js.map +1 -0
- package/dist/vite/ssg.d.ts +5 -8
- package/dist/vite/ssg.d.ts.map +1 -1
- package/dist/vite/ssg.js +32 -263
- package/dist/vite/ssg.js.map +1 -1
- package/dist/vite/virtualServerModule.d.ts +4 -4
- package/dist/vite/virtualServerModule.d.ts.map +1 -1
- package/dist/vite/virtualServerModule.js +18 -62
- package/dist/vite/virtualServerModule.js.map +1 -1
- package/docs/agent/api-reference.md +45 -0
- package/docs/agent/editable-forms.md +37 -0
- package/docs/agent/guide-get.md +13 -0
- package/docs/agent/guide-index.md +15 -0
- package/docs/agent/http-handlers.md +9 -0
- package/docs/agent/imports.md +16 -0
- package/docs/agent/index.md +48 -0
- package/docs/agent/input-validation.md +9 -0
- package/docs/agent/measuring.md +7 -0
- package/docs/agent/mutations.md +11 -0
- package/docs/agent/operations.md +9 -0
- package/docs/agent/query-params.md +28 -0
- package/docs/agent/rendering.md +9 -0
- package/docs/agent/request-context.md +13 -0
- package/docs/agent/routing.md +11 -0
- package/docs/agent/scaffold.md +15 -0
- package/docs/agent/security.md +9 -0
- package/docs/agent/server-files.md +9 -0
- package/docs/agent/streaming.md +9 -0
- package/docs/agent/validation-page.md +21 -0
- package/docs/agent/validation.md +33 -0
- package/docs/agent/verify.md +19 -0
- package/docs/agent/workflow.md +11 -0
- package/docs/agent-guide.md +266 -0
- package/docs/agent-start.md +87 -0
- package/docs/migration-0.11.md +15 -0
- package/package.json +20 -5
- package/dist/server/handlerLoader.d.ts +0 -1
- package/dist/server/handlerLoader.d.ts.map +0 -1
- package/dist/server/handlerLoader.js +0 -2
- package/dist/server/handlerLoader.js.map +0 -1
- package/dist/server/ipExtractor.d.ts +0 -48
- package/dist/server/ipExtractor.d.ts.map +0 -1
- package/dist/server/ipExtractor.js +0 -96
- package/dist/server/ipExtractor.js.map +0 -1
- package/dist/server/requestRouting.d.ts +0 -4
- package/dist/server/requestRouting.d.ts.map +0 -1
- package/dist/server/requestRouting.js +0 -67
- package/dist/server/requestRouting.js.map +0 -1
- package/dist/utils/deepEqual.d.ts +0 -1
- package/dist/utils/deepEqual.d.ts.map +0 -1
- package/dist/utils/deepEqual.js +0 -2
- package/dist/utils/deepEqual.js.map +0 -1
- package/dist/utils/formatError.d.ts +0 -2
- package/dist/utils/formatError.d.ts.map +0 -1
- package/dist/utils/formatError.js +0 -18
- package/dist/utils/formatError.js.map +0 -1
|
@@ -0,0 +1,103 @@
|
|
|
1
|
+
import type React from "react";
|
|
2
|
+
import type { useCall as clientUseCall } from "../client/useCall.js";
|
|
3
|
+
import type { useFetch as clientUseFetch, UseFetchOptions } from "../client/useFetch.js";
|
|
4
|
+
import type { useStreaming as clientUseStreaming } from "../client/useStreaming.js";
|
|
5
|
+
import type { RpcStats } from "../runtime/protocol.js";
|
|
6
|
+
export type ServerRenderMode = "ssr" | "ssg";
|
|
7
|
+
/**
|
|
8
|
+
* Shared server-rendering implementation. Keep runtime dependencies inside this
|
|
9
|
+
* factory: its compiled JavaScript is embedded into Vite virtual modules and
|
|
10
|
+
* standalone production/SSG builds, using each application's React instance.
|
|
11
|
+
*/
|
|
12
|
+
export declare function createServerClientAdapter(react: typeof React, mode: ServerRenderMode): {
|
|
13
|
+
RouterContext: React.Context<{
|
|
14
|
+
path: string;
|
|
15
|
+
params: Record<string, string | string[]>;
|
|
16
|
+
searchParams: URLSearchParams;
|
|
17
|
+
push: (href: string, options?: import("../client/Router.js").RouterNavigationOptions) => void;
|
|
18
|
+
replace: (href: string, options?: import("../client/Router.js").RouterNavigationOptions) => void;
|
|
19
|
+
on: (event: "navigation" | "before-navigation", listener: (event: {
|
|
20
|
+
from: string;
|
|
21
|
+
to: string;
|
|
22
|
+
preventDefault?: () => void;
|
|
23
|
+
}) => void) => () => void;
|
|
24
|
+
status: 200 | 404;
|
|
25
|
+
isNavigating: boolean;
|
|
26
|
+
isPending: boolean;
|
|
27
|
+
} | null>;
|
|
28
|
+
useRouter: () => {
|
|
29
|
+
path: string;
|
|
30
|
+
params: Record<string, string | string[]>;
|
|
31
|
+
searchParams: URLSearchParams;
|
|
32
|
+
push: (href: string, options?: import("../client/Router.js").RouterNavigationOptions) => void;
|
|
33
|
+
replace: (href: string, options?: import("../client/Router.js").RouterNavigationOptions) => void;
|
|
34
|
+
on: (event: "navigation" | "before-navigation", listener: (event: {
|
|
35
|
+
from: string;
|
|
36
|
+
to: string;
|
|
37
|
+
preventDefault?: () => void;
|
|
38
|
+
}) => void) => () => void;
|
|
39
|
+
status: 200 | 404;
|
|
40
|
+
isNavigating: boolean;
|
|
41
|
+
isPending: boolean;
|
|
42
|
+
};
|
|
43
|
+
Link: (props: {
|
|
44
|
+
href?: string;
|
|
45
|
+
children?: React.ReactNode;
|
|
46
|
+
prefetch?: unknown;
|
|
47
|
+
} & Record<string, unknown>) => React.ReactElement<{
|
|
48
|
+
href: string | undefined;
|
|
49
|
+
}, string | React.JSXElementConstructor<any>>;
|
|
50
|
+
Redirect: () => null;
|
|
51
|
+
AppRouter: ({ children }?: {
|
|
52
|
+
children?: React.ReactNode;
|
|
53
|
+
}) => React.FunctionComponentElement<React.FragmentProps> | null;
|
|
54
|
+
Router: ({ children }?: {
|
|
55
|
+
children?: React.ReactNode;
|
|
56
|
+
}) => React.FunctionComponentElement<React.FragmentProps> | null;
|
|
57
|
+
callMethod: () => Promise<never>;
|
|
58
|
+
streamRpc: () => Promise<never>;
|
|
59
|
+
useCall: () => ReturnType<typeof clientUseCall>;
|
|
60
|
+
useFetch: (_method?: unknown, _args?: unknown, options?: UseFetchOptions) => ReturnType<typeof clientUseFetch>;
|
|
61
|
+
useStreaming: () => ReturnType<typeof clientUseStreaming>;
|
|
62
|
+
RpcError: {
|
|
63
|
+
new (message: string, stats?: RpcStats | null): {
|
|
64
|
+
readonly stats: RpcStats | null;
|
|
65
|
+
name: string;
|
|
66
|
+
message: string;
|
|
67
|
+
stack?: string;
|
|
68
|
+
};
|
|
69
|
+
captureStackTrace(targetObject: object, constructorOpt?: Function): void;
|
|
70
|
+
prepareStackTrace(err: Error, stackTraces: NodeJS.CallSite[]): any;
|
|
71
|
+
stackTraceLimit: number;
|
|
72
|
+
};
|
|
73
|
+
getPublicEnv: () => Record<string, string>;
|
|
74
|
+
getPublicEnvValue: (key: string) => string;
|
|
75
|
+
isDevEnvironment: () => boolean;
|
|
76
|
+
isSSR: () => boolean;
|
|
77
|
+
useDeferredNavigation: () => {
|
|
78
|
+
path: string;
|
|
79
|
+
deferredPath: string;
|
|
80
|
+
isStale: boolean;
|
|
81
|
+
isPending: boolean;
|
|
82
|
+
isTransitioning: boolean;
|
|
83
|
+
};
|
|
84
|
+
PageTransition: ({ children, fallback }: {
|
|
85
|
+
children?: React.ReactNode;
|
|
86
|
+
fallback?: React.ReactNode;
|
|
87
|
+
}) => React.DetailedReactHTMLElement<{
|
|
88
|
+
style: {
|
|
89
|
+
opacity: number;
|
|
90
|
+
transition: "opacity 150ms ease";
|
|
91
|
+
};
|
|
92
|
+
}, HTMLElement>;
|
|
93
|
+
cache: {
|
|
94
|
+
get: () => null;
|
|
95
|
+
set: () => void;
|
|
96
|
+
delete: () => void;
|
|
97
|
+
clear: () => void;
|
|
98
|
+
};
|
|
99
|
+
};
|
|
100
|
+
export declare function generateServerClientModule(mode: ServerRenderMode): string;
|
|
101
|
+
export declare function generateServerTransitionsModule(mode: ServerRenderMode): string;
|
|
102
|
+
export declare function generateServerPrefetchModule(): string;
|
|
103
|
+
//# sourceMappingURL=serverClientAdapter.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serverClientAdapter.d.ts","sourceRoot":"","sources":["../../src/vite/serverClientAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAG/B,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,KAAK,EAAE,QAAQ,IAAI,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACzF,OAAO,KAAK,EAAE,YAAY,IAAI,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,KAAK,CAAC;AAE7C;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,KAAK,EAAE,IAAI,EAAE,gBAAgB;;;;;oCA8I0zD,CAAC;uCAAuE,CAAC;;;;0BAzGt6D,CAAC;;;;;;;;;;oCAyG41D,CAAC;uCAAuE,CAAC;;;;0BAzGt6D,CAAC;;;;;;kBAR1B;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;+BAI/E;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE;4BAA9B;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE;sBAGlC,OAAO,CAAC,KAAK,CAAC;qBAGf,OAAO,CAAC,KAAK,CAAC;mBAGtB,UAAU,CAAC,OAAO,aAAa,CAAC;yBAUxB,OAAO,UAAU,OAAO,YAAY,eAAe,KAAG,UAAU,CAAC,OAAO,cAAc,CAAC;wBAQ1F,UAAU,CAAC,OAAO,kBAAkB,CAAC;;sBAgBrC,MAAM,UAAU,QAAQ,GAAG,IAAI;4BAD7B,QAAQ,GAAG,IAAI;;;;;;;;;wBAOjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;6BAwBlB,MAAM;;;;;;;;;;6CAjBoB;QAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE;;;;;;;;;;;;EAwBpH;AAED,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAOzE;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,gBAAgB,GAAG,MAAM,CAa9E;AAED,wBAAgB,4BAA4B,IAAI,MAAM,CAErD"}
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Shared server-rendering implementation. Keep runtime dependencies inside this
|
|
3
|
+
* factory: its compiled JavaScript is embedded into Vite virtual modules and
|
|
4
|
+
* standalone production/SSG builds, using each application's React instance.
|
|
5
|
+
*/
|
|
6
|
+
export function createServerClientAdapter(react, mode) {
|
|
7
|
+
const noop = () => { };
|
|
8
|
+
function routerState() {
|
|
9
|
+
const snapshot = globalThis.__HELIUM_SSR_ROUTER__;
|
|
10
|
+
return {
|
|
11
|
+
path: mode === "ssr" && typeof snapshot?.path === "string" ? snapshot.path : "/",
|
|
12
|
+
params: mode === "ssr" && snapshot?.params && typeof snapshot.params === "object" ? snapshot.params : {},
|
|
13
|
+
searchParams: new URLSearchParams(mode === "ssr" && typeof snapshot?.search === "string" ? snapshot.search : ""),
|
|
14
|
+
push: noop,
|
|
15
|
+
replace: noop,
|
|
16
|
+
on: () => noop,
|
|
17
|
+
status: 200,
|
|
18
|
+
isNavigating: false,
|
|
19
|
+
isPending: false,
|
|
20
|
+
};
|
|
21
|
+
}
|
|
22
|
+
const RouterContext = react.createContext(mode === "ssg" ? routerState() : null);
|
|
23
|
+
function useRouter() {
|
|
24
|
+
// SSR reads the per-request snapshot; SSG installs a provider for each page.
|
|
25
|
+
if (mode === "ssr") {
|
|
26
|
+
return routerState();
|
|
27
|
+
}
|
|
28
|
+
return react.useContext(RouterContext) ?? routerState();
|
|
29
|
+
}
|
|
30
|
+
function Link(props) {
|
|
31
|
+
const { href = mode === "ssr" ? "#" : undefined, children, prefetch: _prefetch, ...rest } = props;
|
|
32
|
+
return react.createElement("a", { href, ...rest }, children);
|
|
33
|
+
}
|
|
34
|
+
function AppRouter({ children } = {}) {
|
|
35
|
+
return mode === "ssg" ? react.createElement(react.Fragment, null, children) : null;
|
|
36
|
+
}
|
|
37
|
+
async function callMethod() {
|
|
38
|
+
throw new Error("callMethod is only available in the browser. Load server data with getServerSideProps instead.");
|
|
39
|
+
}
|
|
40
|
+
async function streamRpc() {
|
|
41
|
+
throw new Error("streamRpc is only available in the browser. Load server data with getServerSideProps instead.");
|
|
42
|
+
}
|
|
43
|
+
function useCall() {
|
|
44
|
+
return {
|
|
45
|
+
data: undefined,
|
|
46
|
+
call: async () => undefined,
|
|
47
|
+
submit: async () => ({ status: "error", error: new RpcError("useCall.submit is only available in the browser. Load server data with getServerSideProps instead.") }),
|
|
48
|
+
isCalling: false,
|
|
49
|
+
error: null,
|
|
50
|
+
stats: null,
|
|
51
|
+
};
|
|
52
|
+
}
|
|
53
|
+
function useFetch(_method, _args, options) {
|
|
54
|
+
if (mode === "ssg") {
|
|
55
|
+
console.warn("useFetch called during SSG - returning undefined");
|
|
56
|
+
}
|
|
57
|
+
// Server rendering has no browser cache or effects. Match a fresh client
|
|
58
|
+
// render while leaving all fetching to the browser after hydration.
|
|
59
|
+
return { data: undefined, isLoading: options?.enabled ?? true, error: null, stats: null, refetch: async () => undefined };
|
|
60
|
+
}
|
|
61
|
+
function useStreaming() {
|
|
62
|
+
return {
|
|
63
|
+
chunks: [],
|
|
64
|
+
text: "",
|
|
65
|
+
isStreaming: false,
|
|
66
|
+
error: null,
|
|
67
|
+
stats: null,
|
|
68
|
+
start: async () => {
|
|
69
|
+
throw new Error("useStreaming.start is only available in the browser. Load server data with getServerSideProps instead.");
|
|
70
|
+
},
|
|
71
|
+
cancel: noop,
|
|
72
|
+
reset: noop,
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
class RpcError extends Error {
|
|
76
|
+
constructor(message, stats) {
|
|
77
|
+
super(message);
|
|
78
|
+
this.name = "RpcError";
|
|
79
|
+
this.stats = stats ?? null;
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
function getPublicEnv() {
|
|
83
|
+
return Object.fromEntries(Object.entries(process.env).filter((entry) => entry[0].startsWith("HELIUM_PUBLIC_") && typeof entry[1] === "string"));
|
|
84
|
+
}
|
|
85
|
+
function useDeferredNavigation() {
|
|
86
|
+
const { path } = useRouter();
|
|
87
|
+
return { path, deferredPath: path, isStale: false, isPending: false, isTransitioning: false };
|
|
88
|
+
}
|
|
89
|
+
function PageTransition({ children, fallback = null }) {
|
|
90
|
+
return react.createElement("div", { style: { opacity: 1, transition: "opacity 150ms ease" } }, react.createElement(react.Suspense, { fallback }, children));
|
|
91
|
+
}
|
|
92
|
+
return {
|
|
93
|
+
RouterContext,
|
|
94
|
+
useRouter,
|
|
95
|
+
Link,
|
|
96
|
+
Redirect: () => null,
|
|
97
|
+
AppRouter,
|
|
98
|
+
Router: AppRouter,
|
|
99
|
+
callMethod,
|
|
100
|
+
streamRpc,
|
|
101
|
+
useCall,
|
|
102
|
+
useFetch,
|
|
103
|
+
useStreaming,
|
|
104
|
+
RpcError,
|
|
105
|
+
getPublicEnv,
|
|
106
|
+
getPublicEnvValue: (key) => getPublicEnv()[key],
|
|
107
|
+
isDevEnvironment: () => false,
|
|
108
|
+
isSSR: () => true,
|
|
109
|
+
useDeferredNavigation,
|
|
110
|
+
PageTransition,
|
|
111
|
+
cache: { get: () => null, set: noop, delete: noop, clear: noop },
|
|
112
|
+
};
|
|
113
|
+
}
|
|
114
|
+
export function generateServerClientModule(mode) {
|
|
115
|
+
return `import React from 'react';
|
|
116
|
+
const adapter = (${createServerClientAdapter.toString()})(React, ${JSON.stringify(mode)});
|
|
117
|
+
export const { RouterContext, useRouter, Link, Redirect, AppRouter, callMethod, streamRpc,
|
|
118
|
+
useCall, useFetch, useStreaming, RpcError, getPublicEnv, getPublicEnvValue,
|
|
119
|
+
isDevEnvironment, isSSR${mode === "ssg" ? ", Router, cache, useDeferredNavigation, PageTransition" : ""} } = adapter;
|
|
120
|
+
`;
|
|
121
|
+
}
|
|
122
|
+
export function generateServerTransitionsModule(mode) {
|
|
123
|
+
return `import React from 'react';
|
|
124
|
+
import { useRouter } from 'heliumts/client';
|
|
125
|
+
export function useDeferredNavigation() {
|
|
126
|
+
const { path } = useRouter();
|
|
127
|
+
return { path, deferredPath: path, isStale: false, isPending: false, isTransitioning: false };
|
|
128
|
+
}
|
|
129
|
+
export function PageTransition({ children, fallback = null }) {
|
|
130
|
+
return React.createElement('div', { style: { opacity: 1, transition: 'opacity 150ms ease' } },
|
|
131
|
+
React.createElement(React.Suspense, { fallback }, children));
|
|
132
|
+
}
|
|
133
|
+
${mode === "ssg" ? "export default { useDeferredNavigation, PageTransition };" : ""}
|
|
134
|
+
`;
|
|
135
|
+
}
|
|
136
|
+
export function generateServerPrefetchModule() {
|
|
137
|
+
return "export function prefetchRoute() {}\nexport function clearPrefetchCache() {}\n";
|
|
138
|
+
}
|
|
139
|
+
//# sourceMappingURL=serverClientAdapter.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"serverClientAdapter.js","sourceRoot":"","sources":["../../src/vite/serverClientAdapter.ts"],"names":[],"mappings":"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","sourcesContent":["import type React from \"react\";\n\nimport type { useRouter as clientUseRouter } from \"../client/Router.js\";\nimport type { useCall as clientUseCall } from \"../client/useCall.js\";\nimport type { useFetch as clientUseFetch, UseFetchOptions } from \"../client/useFetch.js\";\nimport type { useStreaming as clientUseStreaming } from \"../client/useStreaming.js\";\nimport type { RpcStats } from \"../runtime/protocol.js\";\n\nexport type ServerRenderMode = \"ssr\" | \"ssg\";\n\n/**\n * Shared server-rendering implementation. Keep runtime dependencies inside this\n * factory: its compiled JavaScript is embedded into Vite virtual modules and\n * standalone production/SSG builds, using each application's React instance.\n */\nexport function createServerClientAdapter(react: typeof React, mode: ServerRenderMode) {\n type RouterState = ReturnType<typeof clientUseRouter>;\n const noop = () => {};\n function routerState(): RouterState {\n const snapshot = (\n globalThis as typeof globalThis & {\n __HELIUM_SSR_ROUTER__?: { path?: string; params?: RouterState[\"params\"]; search?: string };\n }\n ).__HELIUM_SSR_ROUTER__;\n return {\n path: mode === \"ssr\" && typeof snapshot?.path === \"string\" ? snapshot.path : \"/\",\n params: mode === \"ssr\" && snapshot?.params && typeof snapshot.params === \"object\" ? snapshot.params : {},\n searchParams: new URLSearchParams(mode === \"ssr\" && typeof snapshot?.search === \"string\" ? snapshot.search : \"\"),\n push: noop,\n replace: noop,\n on: () => noop,\n status: 200,\n isNavigating: false,\n isPending: false,\n };\n }\n const RouterContext = react.createContext<RouterState | null>(mode === \"ssg\" ? routerState() : null);\n function useRouter(): RouterState {\n // SSR reads the per-request snapshot; SSG installs a provider for each page.\n if (mode === \"ssr\") {\n return routerState();\n }\n return react.useContext(RouterContext) ?? routerState();\n }\n function Link(props: { href?: string; children?: React.ReactNode; prefetch?: unknown } & Record<string, unknown>) {\n const { href = mode === \"ssr\" ? \"#\" : undefined, children, prefetch: _prefetch, ...rest } = props;\n return react.createElement(\"a\", { href, ...rest }, children);\n }\n function AppRouter({ children }: { children?: React.ReactNode } = {}) {\n return mode === \"ssg\" ? react.createElement(react.Fragment, null, children) : null;\n }\n async function callMethod(): Promise<never> {\n throw new Error(\"callMethod is only available in the browser. Load server data with getServerSideProps instead.\");\n }\n async function streamRpc(): Promise<never> {\n throw new Error(\"streamRpc is only available in the browser. Load server data with getServerSideProps instead.\");\n }\n function useCall(): ReturnType<typeof clientUseCall> {\n return {\n data: undefined,\n call: async () => undefined,\n submit: async () => ({ status: \"error\", error: new RpcError(\"useCall.submit is only available in the browser. Load server data with getServerSideProps instead.\") }),\n isCalling: false,\n error: null,\n stats: null,\n };\n }\n function useFetch(_method?: unknown, _args?: unknown, options?: UseFetchOptions): ReturnType<typeof clientUseFetch> {\n if (mode === \"ssg\") {\n console.warn(\"useFetch called during SSG - returning undefined\");\n }\n // Server rendering has no browser cache or effects. Match a fresh client\n // render while leaving all fetching to the browser after hydration.\n return { data: undefined, isLoading: options?.enabled ?? true, error: null, stats: null, refetch: async () => undefined };\n }\n function useStreaming(): ReturnType<typeof clientUseStreaming> {\n return {\n chunks: [],\n text: \"\",\n isStreaming: false,\n error: null,\n stats: null,\n start: async () => {\n throw new Error(\"useStreaming.start is only available in the browser. Load server data with getServerSideProps instead.\");\n },\n cancel: noop,\n reset: noop,\n };\n }\n class RpcError extends Error {\n public readonly stats: RpcStats | null;\n constructor(message: string, stats?: RpcStats | null) {\n super(message);\n this.name = \"RpcError\";\n this.stats = stats ?? null;\n }\n }\n function getPublicEnv(): Record<string, string> {\n return Object.fromEntries(Object.entries(process.env).filter((entry): entry is [string, string] => entry[0].startsWith(\"HELIUM_PUBLIC_\") && typeof entry[1] === \"string\"));\n }\n function useDeferredNavigation() {\n const { path } = useRouter();\n return { path, deferredPath: path, isStale: false, isPending: false, isTransitioning: false };\n }\n function PageTransition({ children, fallback = null }: { children?: React.ReactNode; fallback?: React.ReactNode }) {\n return react.createElement(\"div\", { style: { opacity: 1, transition: \"opacity 150ms ease\" } }, react.createElement(react.Suspense, { fallback }, children));\n }\n return {\n RouterContext,\n useRouter,\n Link,\n Redirect: () => null,\n AppRouter,\n Router: AppRouter,\n callMethod,\n streamRpc,\n useCall,\n useFetch,\n useStreaming,\n RpcError,\n getPublicEnv,\n getPublicEnvValue: (key: string) => getPublicEnv()[key],\n isDevEnvironment: () => false,\n isSSR: () => true,\n useDeferredNavigation,\n PageTransition,\n cache: { get: () => null, set: noop, delete: noop, clear: noop },\n };\n}\n\nexport function generateServerClientModule(mode: ServerRenderMode): string {\n return `import React from 'react';\nconst adapter = (${createServerClientAdapter.toString()})(React, ${JSON.stringify(mode)});\nexport const { RouterContext, useRouter, Link, Redirect, AppRouter, callMethod, streamRpc,\nuseCall, useFetch, useStreaming, RpcError, getPublicEnv, getPublicEnvValue,\nisDevEnvironment, isSSR${mode === \"ssg\" ? \", Router, cache, useDeferredNavigation, PageTransition\" : \"\"} } = adapter;\n`;\n}\n\nexport function generateServerTransitionsModule(mode: ServerRenderMode): string {\n return `import React from 'react';\nimport { useRouter } from 'heliumts/client';\nexport function useDeferredNavigation() {\n const { path } = useRouter();\n return { path, deferredPath: path, isStale: false, isPending: false, isTransitioning: false };\n}\nexport function PageTransition({ children, fallback = null }) {\n return React.createElement('div', { style: { opacity: 1, transition: 'opacity 150ms ease' } },\n React.createElement(React.Suspense, { fallback }, children));\n}\n${mode === \"ssg\" ? \"export default { useDeferredNavigation, PageTransition };\" : \"\"}\n`;\n}\n\nexport function generateServerPrefetchModule(): string {\n return \"export function prefetchRoute() {}\\nexport function clearPrefetchCache() {}\\n\";\n}\n"]}
|
package/dist/vite/ssg.d.ts
CHANGED
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
import { findLayoutPathsForPage, type PageManifestEntry } from "./scanner.js";
|
|
2
|
+
export { findLayoutPathsForPage };
|
|
1
3
|
/**
|
|
2
4
|
* SSG (Static Site Generation) implementation for Helium
|
|
3
5
|
*
|
|
@@ -9,6 +11,7 @@ interface SSGPage {
|
|
|
9
11
|
urlPath: string;
|
|
10
12
|
relativePath: string;
|
|
11
13
|
warnings: string[];
|
|
14
|
+
layouts?: readonly string[];
|
|
12
15
|
}
|
|
13
16
|
interface SSGValidation {
|
|
14
17
|
hasHooks: boolean;
|
|
@@ -31,7 +34,7 @@ export declare function validateSSGPage(filePath: string): SSGValidation;
|
|
|
31
34
|
/**
|
|
32
35
|
* Scan pages directory and find all pages with "use ssg" directive
|
|
33
36
|
*/
|
|
34
|
-
export declare function scanSSGPages(root: string): SSGPage[];
|
|
37
|
+
export declare function scanSSGPages(root: string, manifest?: readonly PageManifestEntry[]): SSGPage[];
|
|
35
38
|
/**
|
|
36
39
|
* Convert file path to URL path
|
|
37
40
|
* pages/index.tsx -> /
|
|
@@ -50,11 +53,6 @@ export declare function filePathToUrlPath(relativePath: string): string;
|
|
|
50
53
|
* @internal Exported for testing
|
|
51
54
|
*/
|
|
52
55
|
export declare function urlPathToOutputPath(urlPath: string): string;
|
|
53
|
-
/**
|
|
54
|
-
* Find all layout file paths for a given page path (from root to leaf)
|
|
55
|
-
* @internal Exported for testing
|
|
56
|
-
*/
|
|
57
|
-
export declare function findLayoutPathsForPage(pagePath: string, root: string): string[];
|
|
58
56
|
/**
|
|
59
57
|
* Render a page component to static HTML using Vite SSR with timeout
|
|
60
58
|
*/
|
|
@@ -62,6 +60,5 @@ export declare function renderPageToHTML(page: SSGPage, root: string, htmlTempla
|
|
|
62
60
|
/**
|
|
63
61
|
* Generate static HTML files for all SSG pages
|
|
64
62
|
*/
|
|
65
|
-
export declare function generateStaticPages(context: any, root: string, htmlTemplate: string, distDir: string): Promise<void>;
|
|
66
|
-
export {};
|
|
63
|
+
export declare function generateStaticPages(context: any, root: string, htmlTemplate: string, distDir: string, manifest?: readonly PageManifestEntry[]): Promise<void>;
|
|
67
64
|
//# sourceMappingURL=ssg.d.ts.map
|
package/dist/vite/ssg.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ssg.d.ts","sourceRoot":"","sources":["../../src/vite/ssg.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"ssg.d.ts","sourceRoot":"","sources":["../../src/vite/ssg.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,sBAAsB,EAAE,KAAK,iBAAiB,EAAkC,MAAM,cAAc,CAAC;AAG9G,OAAO,EAAE,sBAAsB,EAAE,CAAC;AAElC;;;;;GAKG;AAEH,UAAU,OAAO;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC/B;AAED,UAAU,aAAa;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,QAAQ,EAAE,MAAM,EAAE,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkB3D;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,aAAa,CAoC/D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,GAAE,SAAS,iBAAiB,EAA2B,GAAG,OAAO,EAAE,CAqBrH;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAG9D;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAQ3D;AAuBD;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAkFnJ;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,SAAS,iBAAiB,EAAE,iBA4JnJ"}
|