@_tc/template-core 0.2.11 → 0.3.0

package/fe/ssr/components/StreamingRender/StreamingScript.js

@@ -0,0 +1,58 @@
+import { useEffect, useState } from "react";
+import { jsx } from "react/jsx-runtime";
+//#region ssr/components/StreamingRender/StreamingScript.tsx
+var STREAMING_RENDER_SCRIPT_KEY = "S_E_S_K";
+var getStreamingRenderGetDataScriptId = (key) => STREAMING_RENDER_SCRIPT_KEY + key;
+/**
+*
+* 注入脚本 dom
+*/
+var StreamingRenderGetDataScript = (props) => {
+	const { keyName, data } = props;
+	const [hidden, setHidden] = useState(false);
+	useEffect(() => {
+		const timer = setTimeout(() => setHidden(true), 3e3);
+		return () => clearTimeout(timer);
+	}, []);
+	const json = JSON.stringify(data);
+	return !hidden && /* @__PURE__ */ jsx("script", {
+		type: "application/json",
+		id: getStreamingRenderGetDataScriptId(keyName),
+		dangerouslySetInnerHTML: { __html: (json ?? "null").replace(/</g, "\\u003c") }
+	});
+};
+var clientDataCache = /* @__PURE__ */ new Map();
+/**
+*  client 获取 流式数据
+*/
+var readClientStreamData = (key) => {
+	if (typeof window === "undefined") return {
+		found: false,
+		data: null
+	};
+	if (clientDataCache.has(key)) return {
+		found: true,
+		data: clientDataCache.get(key)
+	};
+	const sDom = document.getElementById(getStreamingRenderGetDataScriptId(key));
+	let scriptData;
+	let found = false;
+	try {
+		if (!sDom) return {
+			found: false,
+			data: null
+		};
+		const dataStr = sDom.textContent;
+		scriptData = JSON.parse(dataStr);
+		found = true;
+		clientDataCache.set(key, scriptData);
+	} catch (error) {
+		scriptData = null;
+	}
+	return {
+		found,
+		data: scriptData
+	};
+};
+//#endregion
+export { StreamingRenderGetDataScript, readClientStreamData };

package/fe/ssr/components/StreamingRender/index.d.ts

@@ -0,0 +1,4 @@
+import StreamingRender from "./StreamingRender";
+export { StreamingRender };
+export type { RenderProp, StateParams, StreamingRenderProps } from "./type";
+export default StreamingRender;

package/fe/ssr/components/StreamingRender/index.js

@@ -0,0 +1,5 @@
+import StreamingRender from "./StreamingRender.js";
+//#region ssr/components/StreamingRender/index.tsx
+var StreamingRender_default = StreamingRender;
+//#endregion
+export { StreamingRender, StreamingRender_default as default };

package/fe/ssr/components/StreamingRender/type.d.ts

@@ -0,0 +1,9 @@
+import { ReactNode, SuspenseProps } from "react";
+export type RenderProp<T> = (data: T) => ReactNode;
+export type StateParams<T> = {
+    getData: () => Promise<T>;
+    keyName: string;
+};
+export interface StreamingRenderProps<T> extends Omit<SuspenseProps, "children">, StateParams<T> {
+    children: RenderProp<T>;
+}

package/fe/ssr/components/index.d.ts

@@ -0,0 +1,2 @@
+export { default as StreamingRender } from "./StreamingRender";
+export type { RenderProp, StateParams, StreamingRenderProps } from "./StreamingRender";

package/fe/ssr/components/index.js

@@ -0,0 +1,2 @@
+import StreamingRender_default from "./StreamingRender/index.js";
+export { StreamingRender_default as StreamingRender };

package/fe/ssr/createSSREntry.d.ts

@@ -0,0 +1,6 @@
+import { type SSRHydrationData } from "../packages/common/index";
+import { type ComponentType } from "react";
+export declare function createSSREntry<Props extends Record<string, unknown>>(Component: ComponentType<Props>, options?: {
+    rootId?: string;
+    onHydrated?: (data: SSRHydrationData<Props> | null) => void;
+}): void;

package/fe/ssr/createSSREntry.js

@@ -0,0 +1,42 @@
+import { clearHydrationData, peekHydrationData } from "../packages/common/ssr/hydration.js";
+import { useEffect } from "react";
+import { jsx } from "react/jsx-runtime";
+import { hydrateRoot } from "react-dom/client";
+//#region ssr/createSSREntry.tsx
+/**
+* SSR 页面客户端入口工厂
+*
+* 用法：
+* ```tsx
+* // ssr/apps/demo/demo.entry.tsx
+* import { createSSREntry } from '../../createSSREntry'
+* import App from './App'
+*
+* export default App
+* export const hydrate = createSSREntry(App)
+* ```
+*
+* 服务端只使用 default export 做 React SSR 渲染。
+* 客户端执行 hydrate 完成注水。
+*/
+function createSSREntry(Component, options) {
+	if (typeof window === "undefined") return;
+	const { rootId = "root", onHydrated } = options ?? {};
+	const container = document.getElementById(rootId);
+	if (!container) {
+		console.error(`[SSR] Root element #${rootId} not found`);
+		return;
+	}
+	const data = peekHydrationData();
+	const props = data?.props ?? {};
+	const HydrationBoundary = () => {
+		useEffect(() => {
+			clearHydrationData();
+			onHydrated?.(data);
+		}, []);
+		return /* @__PURE__ */ jsx(Component, { ...props });
+	};
+	hydrateRoot(container, /* @__PURE__ */ jsx(HydrationBoundary, {}));
+}
+//#endregion
+export { createSSREntry };

package/fe/ssr/hooks/index.d.ts

@@ -0,0 +1 @@
+export { useSuspensePromise } from "./useSuspensePromise";

package/fe/ssr/hooks/index.js

@@ -0,0 +1,2 @@
+import { useSuspensePromise } from "./useSuspensePromise.js";
+export { useSuspensePromise };

package/fe/ssr/hooks/useSuspensePromise.d.ts

@@ -0,0 +1 @@
+export declare function useSuspensePromise<T>(promise: Promise<T>): T;

package/fe/ssr/hooks/useSuspensePromise.js

@@ -0,0 +1,31 @@
+import * as React$1 from "react";
+//#region ssr/hooks/useSuspensePromise.ts
+var promiseStateCache = /* @__PURE__ */ new WeakMap();
+function readPromiseFallback(promise) {
+	let state = promiseStateCache.get(promise);
+	if (!state) {
+		state = { status: "pending" };
+		promiseStateCache.set(promise, state);
+		promise.then((value) => {
+			promiseStateCache.set(promise, {
+				status: "resolved",
+				value
+			});
+		}, (error) => {
+			promiseStateCache.set(promise, {
+				status: "rejected",
+				error
+			});
+		});
+	}
+	if (state.status === "pending") throw promise;
+	if (state.status === "rejected") throw state.error;
+	return state.value;
+}
+function useSuspensePromise(promise) {
+	const reactUse = React$1.use;
+	if (typeof reactUse === "function") return reactUse(promise);
+	return readPromiseFallback(promise);
+}
+//#endregion
+export { useSuspensePromise };

package/fe/ssr/index.d.ts

@@ -0,0 +1,4 @@
+export { createSSREntry } from "./createSSREntry";
+export * from "./components";
+export * from "./hooks";
+export type { SSRPageMetaContext, SSRPageMetaResolver, SSRPageMetaValue, SSRPropsContext } from "./types";

package/fe/ssr/index.js

@@ -0,0 +1,6 @@
+import { createSSREntry } from "./createSSREntry.js";
+import { useSuspensePromise } from "./hooks/useSuspensePromise.js";
+import StreamingRender_default from "./components/StreamingRender/index.js";
+import "./components/index.js";
+import "./hooks/index.js";
+export { StreamingRender_default as StreamingRender, createSSREntry, useSuspensePromise };

package/fe/ssr/types.d.ts

@@ -0,0 +1,13 @@
+import type { Ctx, KoaApp } from "@_tc/template-core";
+export interface SSRPropsContext {
+    params: Record<string, string>;
+    query: Record<string, unknown>;
+    path: string;
+    app: KoaApp;
+    ctx: Ctx;
+}
+export interface SSRPageMetaContext<Props = Record<string, unknown>> extends SSRPropsContext {
+    props: Props;
+}
+export type SSRPageMetaResolver<Props = Record<string, unknown>> = (context: SSRPageMetaContext<Props>) => string | null | undefined | Promise<string | null | undefined>;
+export type SSRPageMetaValue<Props = Record<string, unknown>> = string | null | undefined | SSRPageMetaResolver<Props>;

package/{model → models}/frontend/src/typing/window.d.ts

@@ -4,5 +4,7 @@ declare global {
         _basePath: string;
         _projKey: string;
         _signKey: string;
+        _renderMode: 'csr' | 'ssr';
+        _isSSR: boolean;
     }
 }

package/{model → models}/packages/common/i18n/types.d.ts

@@ -29,6 +29,7 @@ export interface I18nAddResourcesOptions {
 export type I18nTranslator = <T = string>(key: string, fillingData?: I18nInterpolationValues, options?: I18nTranslateOptions) => T | string;
 export interface I18nActions {
     setLanguage: (language: I18nLanguage) => void;
+    hydrateStoredLanguage: () => void;
     setFallbackLanguage: (language: I18nLanguage) => void;
     setResources: (resources: I18nResources, options?: I18nSetResourcesOptions) => void;
     addResources: (language: I18nLanguage, messages: I18nDictionary, options?: I18nAddResourcesOptions) => void;

package/{model → models}/packages/common/index.d.ts

@@ -7,5 +7,6 @@ export * from "./log";
 export * from "./number";
 export * from "./object";
 export * from "./rafTimer";
+export * from "./ssr";
 export * from "./string";
 export * from "./types";

package/models/packages/common/ssr/hydration.d.ts

@@ -0,0 +1,23 @@
+export interface SSRHydrationData<Props = Record<string, unknown>, State = Record<string, unknown>> {
+    props: Props;
+    state: State;
+    meta: SSRPageMeta;
+}
+export interface SSRPageMeta {
+    title?: string;
+    description?: string;
+    renderedAt: number;
+    pathname: string;
+}
+export declare const SSR_DATA_KEY = "__SSR_DATA__";
+declare global {
+    interface Window {
+        [SSR_DATA_KEY]?: SSRHydrationData | string;
+    }
+}
+export declare function serializeHydrationDataScriptContent(data: SSRHydrationData): string;
+export declare function serializeHydrationData(data: SSRHydrationData): string;
+export declare function peekHydrationData<Props = Record<string, unknown>, State = Record<string, unknown>>(): SSRHydrationData<Props, State> | null;
+export declare function clearHydrationData(): void;
+export declare function readHydrationData<Props = Record<string, unknown>, State = Record<string, unknown>>(): SSRHydrationData<Props, State> | null;
+export declare function createHydrationData<Props = Record<string, unknown>, State = Record<string, unknown>>(props: Props, meta: Omit<SSRPageMeta, 'renderedAt'>, state?: State): SSRHydrationData<Props, State>;

package/models/packages/common/ssr/index.d.ts

@@ -0,0 +1,8 @@
+export declare const isBrowser: boolean;
+export declare const isServer: boolean;
+export declare function clientOnly<T>(fn: () => T, fallback: T): T;
+export declare function safeWindow(): Window | undefined;
+export declare function safeDocument(): Document | undefined;
+export declare function safeLocalStorage(key: string, fallback?: string): string;
+export declare function safeSetLocalStorage(key: string, value: string): void;
+export * from "./hydration";

package/{model → models}/packages/react/ui/components/Form/SchemaForm/data.d.ts

@@ -26,8 +26,9 @@ export type ExtendedFieldType = Extract<keyof SchemaFormNamespace.FieldTypes | k
 export type SchemaFormAllFieldType = SchemaFormFieldType | ExtendedFieldType;
 export type SchemaFormAllPropsMap = SchemaFormComponentPropsMap & SchemaFormNamespace.PropsMap;
 export type SchemaFormComponent = React.ComponentType<any> | React.LazyExoticComponent<React.ComponentType<any>>;
-export declare const componentsMap: Record<SchemaFormAllFieldType, SchemaFormComponent>;
-export type SchemaFormComponentsMap = Partial<Record<ExtendedFieldType, SchemaFormComponent>>;
+export declare const componentsMap: Partial<Record<SchemaFormAllFieldType, SchemaFormComponent>>;
+export type SchemaFormComponentsMap = Partial<Record<string, SchemaFormComponent>>;
+export declare const registerSchemaFormComponents: (map: SchemaFormComponentsMap) => void;
 export type FieldProps = {
     [K in SchemaFormAllFieldType]: {
         type: K;

package/{model → models}/packages/react/ui/components/Form/SchemaForm/index.d.ts

@@ -6,6 +6,7 @@ import { type FormProps } from "..";
 import { type ButtonElementProps } from "../../Button";
 import type { LabelLayout } from "../../Label";
 import { type FieldProps, type SchemaFormAllFieldType } from "./data";
+export { registerSchemaFormComponents } from "./data";
 export type { FieldProps, SchemaFormAllFieldType, SchemaFormAllPropsMap, SchemaFormComponent, SchemaFormComponentsMap, SchemaFormComponentPropsMap, SchemaFormFieldType, SchemaFormNamespace, } from "./data";
 export type FormFieldType = SchemaFormAllFieldType;
 type BaseField<T> = {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@_tc/template-core",
-  "version": "0.2.11",
-  "description": "A full-stack TypeScript admin framework powered by Koa, React, and Vite - monorepo root",
+  "version": "0.3.0",
+  "description": "A full-stack TypeScript admin framework package powered by Koa, React, and Vite",
   "types": "./types/index.d.ts",
   "exports": {
     ".": {
@@ -29,6 +29,41 @@
       "require": "./fe/frontend/src/common/request.js",
       "types": "./fe/frontend/src/common/request.d.ts"
     },
+    "./ssr": {
+      "import": "./fe/ssr/index.js",
+      "require": "./fe/ssr/index.js",
+      "types": "./fe/ssr/index.d.ts"
+    },
+    "./ssr/createSSREntry": {
+      "import": "./fe/ssr/createSSREntry.js",
+      "require": "./fe/ssr/createSSREntry.js",
+      "types": "./fe/ssr/createSSREntry.d.ts"
+    },
+    "./ssr/types": {
+      "import": "./fe/ssr/types.js",
+      "require": "./fe/ssr/types.js",
+      "types": "./fe/ssr/types.d.ts"
+    },
+    "./ssr/components": {
+      "import": "./fe/ssr/components/index.js",
+      "require": "./fe/ssr/components/index.js",
+      "types": "./fe/ssr/components/index.d.ts"
+    },
+    "./ssr/components/StreamingRender": {
+      "import": "./fe/ssr/components/StreamingRender/index.js",
+      "require": "./fe/ssr/components/StreamingRender/index.js",
+      "types": "./fe/ssr/components/StreamingRender/index.d.ts"
+    },
+    "./ssr/hooks": {
+      "import": "./fe/ssr/hooks/index.js",
+      "require": "./fe/ssr/hooks/index.js",
+      "types": "./fe/ssr/hooks/index.d.ts"
+    },
+    "./ssr/hooks/useSuspensePromise": {
+      "import": "./fe/ssr/hooks/useSuspensePromise.js",
+      "require": "./fe/ssr/hooks/useSuspensePromise.js",
+      "types": "./fe/ssr/hooks/useSuspensePromise.d.ts"
+    },
     "./fe/rc": {
       "import": "./fe/packages/react/ui/index.js",
       "require": "./fe/packages/react/ui/index.js",
@@ -50,8 +85,8 @@
       "types": "./fe/frontend/src/*"
     },
     "./fe/tailwind_ui.css": "./fe/frontend/src/main.css",
-    "./model": {
-      "types": "./model/model/index.d.ts"
+    "./models": {
+      "types": "./models/models/index.d.ts"
     }
   },
   "dependencies": {
@@ -95,8 +130,10 @@
     "koa",
     "framework",
     "typescript",
-    "template",
-    "monorepo"
+    "admin",
+    "react",
+    "vite",
+    "schema"
   ],
   "author": "",
   "license": "ISC",

package/types/app/controller/ssr.d.ts

@@ -0,0 +1,14 @@
+import type Koa from "koa";
+import type { Ctx, KoaApp } from "../type";
+/**
+ * 创建 SSR controller，负责把 SSR 页面请求渲染成完整 HTML。
+ */
+declare const getSSRController: (app: KoaApp) => {
+    new (): {
+        /**
+         * 渲染单个 SSR 页面请求。
+         */
+        renderSSRPage(ctx: Ctx, _next: Koa.Next): Promise<void>;
+    };
+};
+export default getSSRController;

package/types/app/html/shell.d.ts

@@ -0,0 +1,101 @@
+/**
+ * CSR entry.tpl 中由构建器展开的共享 shell 标记。
+ */
+export declare const sharedCSRShellMarkers: {
+    readonly head: "<!-- TC_SHARED_HEAD -->";
+    readonly runtimeContext: "<!-- TC_RUNTIME_CONTEXT -->";
+};
+/**
+ * document head 公共片段渲染参数。
+ */
+export interface DocumentHeadHtmlOptions {
+    /**
+     * 已转义或模板侧保证安全的 title 文本 HTML。
+     */
+    titleHtml: string;
+    /**
+     * 已转义的 description attribute 值；不传则不输出 description meta。
+     */
+    descriptionAttr?: string;
+    /**
+     * SSR manifest 生成的 preload/link HTML。
+     */
+    preloadLinks?: string;
+}
+/**
+ * runtime context script 中需要直接写入 JavaScript 的表达式。
+ */
+export interface RuntimeContextScriptExpressionOptions {
+    /**
+     * window._basePath 的 JavaScript 表达式。
+     */
+    basePathExpression: string;
+    /**
+     * window._FEBasePage 的 JavaScript 表达式。
+     */
+    feBasePageExpression: string;
+    /**
+     * window._projKey 的 JavaScript 表达式。
+     */
+    projKeyExpression: string;
+    /**
+     * window._signKey 的 JavaScript 表达式。
+     */
+    signKeyExpression: string;
+    /**
+     * window._renderMode 的 JavaScript 表达式。
+     */
+    renderModeExpression: string;
+    /**
+     * app-options-data script 的安全 JSON 文本。
+     */
+    optionsJsonHtml: string;
+}
+/**
+ * 将任意值序列化成可安全放入 inline script 或 JSON script 的字符串。
+ */
+export declare const serializeForHtmlScript: (value: unknown) => string;
+/**
+ * 转义 HTML 文本节点内容。
+ */
+export declare function escapeHtml(value: unknown): string;
+/**
+ * 转义 HTML attribute 值。
+ */
+export declare function escapeHtmlAttr(value: unknown): string;
+/**
+ * 渲染与 CSR/SSR shell 共用的主题初始化脚本内容。
+ */
+export declare function renderThemeScriptContent(): string;
+/**
+ * 渲染与 CSR/SSR shell 共用的主题初始化 script 标签。
+ */
+export declare function renderThemeScript(): string;
+/**
+ * 渲染 CSR/SSR 共用的 document head 基础 HTML。
+ */
+export declare function renderDocumentHeadHtml({ titleHtml, descriptionAttr, preloadLinks, }: DocumentHeadHtmlOptions): string;
+/**
+ * 渲染 CSR entry.tpl 使用的共享 head 模板片段。
+ */
+export declare function renderCSRDocumentHeadTemplate(): string;
+/**
+ * 渲染注入前端运行时全局变量的 input script 内容。
+ */
+export declare function renderRuntimeInputScriptContentFromExpressions({ basePathExpression, feBasePageExpression, projKeyExpression, signKeyExpression, renderModeExpression, }: RuntimeContextScriptExpressionOptions): string;
+/**
+ * 渲染解析 app-options-data 的 script 内容。
+ */
+export declare function renderAppOptionsScriptContent(): string;
+/**
+ * 渲染 CSR/SSR 共用的运行时上下文 script 标签。
+ */
+export declare function renderRuntimeContextScriptsFromExpressions(options: RuntimeContextScriptExpressionOptions): string;
+/**
+ * 渲染 CSR entry.tpl 使用的运行时上下文模板片段。
+ */
+export declare function renderCSRRuntimeContextScriptsTemplate(): string;
+/**
+ * 将 app/view/entry.tpl 的共享 shell marker 展开为真实 CSR 模板片段。
+ */
+export declare function applySharedCSRShellTemplate(templateHtml: string): string;

package/types/app/router/ssr.d.ts

@@ -0,0 +1,6 @@
+import type { KoaApp, KoaRouter } from "../type";
+/**
+ * 注册 SSR 页面路由。
+ */
+declare const _default: (app: KoaApp, router: KoaRouter) => void;
+export default _default;

package/types/app/ssr/html.d.ts

@@ -0,0 +1,53 @@
+import type { Ctx, KoaApp } from "../type";
+export { escapeHtml, escapeHtmlAttr, serializeForHtmlScript } from "../html/shell";
+type ReactModule = typeof import('react');
+type ReactElement = import('react').ReactElement;
+type ReactNode = import('react').ReactNode;
+export interface SSRHtmlShellOptions {
+    app: KoaApp;
+    ctx: Ctx;
+    page: string;
+    title: string;
+    description?: string;
+    appHtml: string;
+    preloadLinks?: string;
+    hydrationScript?: string;
+    clientScript?: string;
+}
+export type SSRHtmlShellPartsOptions = Omit<SSRHtmlShellOptions, 'appHtml'>;
+export interface SSRHtmlShellParts {
+    beforeAppHtml: string;
+    afterAppHtml: string;
+}
+export interface SSRDocumentElementOptions extends SSRHtmlShellPartsOptions {
+    appNode: ReactNode;
+    hydrationScriptContent?: string;
+}
+export interface SSRErrorHtmlOptions {
+    app: KoaApp;
+    ctx: Ctx;
+    page: string;
+    status: number;
+    title: string;
+    message: string;
+    error?: unknown;
+}
+/**
+ * 渲染 SSR 页面 HTML shell 两侧片段，用于流式写入 React app HTML。
+ */
+export declare function renderSSRHtmlShellParts(options: SSRHtmlShellPartsOptions): SSRHtmlShellParts;
+/**
+ * 创建 React 可流式渲染的完整 SSR document。
+ *
+ * React 负责输出完整 document 时，bootstrap script 会位于 #root 之后、
+ * pending Suspense chunks 之前，从而允许客户端入口提前启动 selective hydration。
+ */
+export declare function createSSRDocumentElement(React: ReactModule, options: SSRDocumentElementOptions): ReactElement;
+/**
+ * 渲染 SSR 页面完整 HTML shell。
+ */
+export declare function renderSSRHtmlShell(options: SSRHtmlShellOptions): string;
+/**
+ * 渲染 SSR fallback 错误页。
+ */
+export declare function renderSSRErrorHtml(options: SSRErrorHtmlOptions): string;

package/types/app/ssr/manifest.d.ts

@@ -0,0 +1,17 @@
+export type SSRManifestEntry = {
+    file?: string;
+    name?: string;
+    src?: string;
+    isEntry?: boolean;
+    css?: string[];
+    imports?: string[];
+};
+export type SSRManifest = Record<string, SSRManifestEntry>;
+/**
+ * 从 client manifest 中找到指定 SSR page 的浏览器入口。
+ */
+export declare function findSSRClientEntry(manifest: SSRManifest | null, page: string): SSRManifestEntry | null;
+/**
+ * 为 SSR client 入口及其静态 imports 生成 preload/link 标签。
+ */
+export declare function generateSSRPreloadLinks(manifest: SSRManifest | null, entry: SSRManifestEntry | null): string;

package/types/app/typings.d.ts

@@ -1,6 +1,7 @@
 import type { FrameworkAugment, KoaApp, KoaAppExtensions, KoaRouter } from "../packages/core/index";
 import type { DefaultAppConfig } from "../config/config.default";
 import type getProjectController from "./controller/project";
+import type getSSRController from "./controller/ssr";
 import type getViewController from "./controller/view";
 import type getFetch from "./extends/$fetch";
 import type getCrypto from "./extends/crypto";
@@ -20,6 +21,7 @@ declare module '../packages/core/index' {
         }
         interface IControllerAugmented {
             project: GetInstance<typeof getProjectController>;
+            ssr: GetInstance<typeof getSSRController>;
             view: GetInstance<typeof getViewController>;
         }
         interface IExtendsAugmented {

package/types/bundler/buildSSR.d.ts

@@ -0,0 +1,56 @@
+import type { FSWatcher } from "chokidar";
+import { type ResolveFEOutDirOptions } from "../ssrSharedData/outputPaths";
+import type { SSREntriesConfig, SSREntriesMode } from "./entryCollect";
+export interface BuildSSROptions extends ResolveFEOutDirOptions {
+    /**
+     * Additional or replacement SSR entry map.
+     *
+     * By default entries are merged with auto-discovered frame/business ssr/apps entries,
+     * and configured keys override scanned entries with the same name.
+     */
+    ssrEntries?: SSREntriesConfig;
+    /**
+     * - merge: auto-discovered entries + configured entries, configured wins.
+     * - replace: only configured entries are used.
+     */
+    ssrEntriesMode?: SSREntriesMode;
+    /**
+     * Additional packages that should be bundled into the SSR server output.
+     */
+    ssrNoExternal?: string[];
+    /**
+     * Compress CSR html when buildSSR has to rebuild the shared browser client.
+     * Defaults to the current buildFE setting when buildFE was called earlier in the same process.
+     */
+    minifyHtml?: boolean;
+}
+export interface WatchSSRFilesOptions extends BuildSSROptions {
+    debounceMs?: number;
+}
+/**
+ * 扫描业务和框架 ssr/apps/ 下的 .entry.* 文件。
+ * 默认同时合并框架和业务入口；重名时业务优先。
+ * 显式 ssrEntries 默认继续合并，并覆盖同名自动入口；ssrEntriesMode: 'replace' 时只使用显式入口。
+ */
+export declare function ssrEntries(options?: BuildSSROptions): Record<string, string>;
+/**
+ * SSR server bundle 输出目录
+ */
+export declare function ssrServerOutDir(options?: BuildSSROptions): string;
+/**
+ * SSR client bundle 输出目录
+ */
+export declare function ssrClientOutDir(options?: BuildSSROptions): string;
+/**
+ * SSR client manifest 私有输出目录
+ */
+export declare function ssrManifestOutDir(options?: BuildSSROptions): string;
+/**
+ * SSR 完整构建流程
+ */
+export declare function buildSSR(options?: BuildSSROptions): Promise<void>;
+/**
+ * 开发态监听 SSR 入口目录。
+ * Vite build 串行执行；构建期间的新变更会在当前构建结束后补跑一次。
+ */
+export declare function watchSSRFiles(options?: WatchSSRFilesOptions): Promise<FSWatcher>;