@ubean/ssr 0.1.2 → 0.1.3

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { Component } from "vue";
+import { renderToString } from "@vue/server-renderer";
+import { PageRenderer } from "@ubean/pages";
+import { ResolvedAppConfig } from "@ubean/runtime/define-app";
+import { RouteRecordRaw } from "vue-router";
+//#region src/index.d.ts
+interface VueRendererSimpleOptions {
+  resolvePageComponent: (path: string) => Promise<Component | null>;
+  resolveLayoutComponent: (name: string | false | null | undefined) => Promise<Component | null>;
+  defaultLayout?: string | null;
+  /**
+   * Resolves the user's `defineApp` config for the server side.
+   * When provided, plugins / globalComponents / provides / head / onAppCreated
+   * will be applied to each SSR app instance.
+   */
+  resolveAppConfig?: () => ResolvedAppConfig | Promise<ResolvedAppConfig>;
+}
+interface VueRendererRouterOptions {
+  routes: RouteRecordRaw[];
+  resolveLayoutComponent: (name: string | false | null | undefined) => Promise<Component | null>;
+  defaultLayout?: string | null;
+  /**
+   * Resolves the user's `defineApp` config for the server side.
+   * When provided, plugins / globalComponents / provides / head / onAppCreated
+   * will be applied to each SSR app instance.
+   */
+  resolveAppConfig?: () => ResolvedAppConfig | Promise<ResolvedAppConfig>;
+}
+type VueRendererOptions = VueRendererSimpleOptions | VueRendererRouterOptions;
+declare function createVueRenderer(options: VueRendererOptions): PageRenderer;
+//#endregion
+export { VueRendererOptions, VueRendererRouterOptions, VueRendererSimpleOptions, createVueRenderer, renderToString };

package/dist/index.js

@@ -0,0 +1,99 @@
+import { createSSRApp, defineComponent, h, provide, reactive } from "vue";
+import { renderToString, renderToString as renderToString$1 } from "@vue/server-renderer";
+import { getIslandsBootstrapScript } from "@ubean/islands";
+import { SSR_CONTENT_MARKER } from "@ubean/pages";
+import { applyAppConfig } from "@ubean/runtime/define-app";
+import { createHead, transformHtmlTemplate } from "@unhead/vue/server";
+//#region src/index.ts
+/**
+* Push a `PageHead` (from `defineApp` or page-level `head`) into an @unhead head instance.
+* Extracted so both the global app head and per-page head use the same mapping.
+*/
+function pushPageHead(head, pageHead) {
+	const headInput = {};
+	if (pageHead.title) headInput.title = pageHead.title;
+	if (pageHead.htmlAttrs) headInput.htmlAttrs = pageHead.htmlAttrs;
+	if (pageHead.bodyAttrs) headInput.bodyAttrs = pageHead.bodyAttrs;
+	if (pageHead.meta) headInput.meta = pageHead.meta;
+	if (pageHead.link) headInput.link = pageHead.link;
+	if (pageHead.script) headInput.script = pageHead.script;
+	head.push(headInput);
+}
+/**
+* Apply user's `defineApp` config (plugins, globalComponents, provides) and
+* invoke `onAppCreated` on a freshly created SSR app instance.
+*/
+async function applyServerAppConfig(app, appConfig) {
+	applyAppConfig(app, appConfig, "server");
+	if (appConfig.onAppCreated) await appConfig.onAppCreated(app);
+}
+function isSimpleOptions(opts) {
+	return "resolvePageComponent" in opts;
+}
+/**
+* Resolve a single layout component by name.
+* Returns `null` when layout is `false`, `null`, or not found.
+* ubean uses flat single-layer layout (no nesting), matching the
+* `layout: string | false` field on each page route.
+*/
+async function resolveSingleLayout(layoutName, defaultLayout, resolveLayoutComponent) {
+	const resolved = layoutName === void 0 ? defaultLayout : layoutName;
+	if (resolved === false || resolved == null) return null;
+	return resolveLayoutComponent(resolved);
+}
+function createSimpleApp(pageObj, PageComp, layout, head) {
+	const pageData = reactive({ ...pageObj });
+	const PAGE_KEY = Symbol("ubean-page");
+	const app = createSSRApp(defineComponent({
+		name: "UbeanSimpleApp",
+		setup() {
+			provide(PAGE_KEY, pageData);
+			return () => {
+				const inner = h(PageComp, pageObj.props || {});
+				if (!layout) return inner;
+				return h(layout, {}, { default: () => inner });
+			};
+		}
+	}));
+	app.use(head);
+	return app;
+}
+function createVueRenderer(options) {
+	const render = async (pageObj, shellHtml, _assetTags, renderContext) => {
+		const head = createHead();
+		const appConfig = options.resolveAppConfig ? await options.resolveAppConfig() : null;
+		if (appConfig?.head) pushPageHead(head, appConfig.head);
+		if (renderContext?.locale) head.push({ htmlAttrs: {
+			lang: renderContext.locale,
+			dir: renderContext.localeDir || "ltr"
+		} });
+		if (pageObj.head) pushPageHead(head, pageObj.head);
+		let appHtml;
+		if (isSimpleOptions(options)) {
+			const pageComponent = await options.resolvePageComponent(pageObj.component);
+			if (!pageComponent) throw new Error(`[ubean] Could not resolve page component: ${pageObj.component}`);
+			const app = createSimpleApp(pageObj, pageComponent, pageObj.layout === false ? null : await resolveSingleLayout(pageObj.layout, options.defaultLayout || null, options.resolveLayoutComponent), head);
+			if (appConfig) await applyServerAppConfig(app, appConfig);
+			appHtml = await renderToString$1(app);
+		} else {
+			const { createUbeanSSRApp } = await import("@ubean/runtime/app");
+			const { app: createdApp, router } = createUbeanSSRApp(pageObj, {
+				routes: options.routes,
+				resolveLayoutComponent: options.resolveLayoutComponent,
+				defaultLayout: options.defaultLayout,
+				head
+			});
+			if (appConfig) await applyServerAppConfig(createdApp, appConfig);
+			await router.isReady();
+			appHtml = await renderToString$1(createdApp);
+		}
+		if (!shellHtml) return appHtml;
+		return transformHtmlTemplate(head, shellHtml.replace(SSR_CONTENT_MARKER, appHtml));
+	};
+	return {
+		render,
+		preambleScript: getIslandsBootstrapScript()
+	};
+}
+//#endregion
+export { createVueRenderer, renderToString };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ubean/ssr",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "Vue SSR renderer for ubean (createVueRenderer, renderToString, applyServerAppConfig)",
   "files": [
     "dist"
@@ -20,9 +20,9 @@
     "@vue/server-renderer": "^3.5.40",
     "vue": "^3.5.40",
     "vue-router": "^5.2.0",
-    "@ubean/islands": "0.1.2",
-    "@ubean/runtime": "0.1.2",
-    "@ubean/pages": "0.1.2"
+    "@ubean/runtime": "0.1.3",
+    "@ubean/islands": "0.1.3",
+    "@ubean/pages": "0.1.3"
   },
   "devDependencies": {
     "@types/node": "^26.1.1",