@quark-fw/plugin-react 0.1.18 → 0.1.20

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@quark-fw/plugin-react",
-	"version": "0.1.18",
+	"version": "0.1.20",
 	"main": "src/index.ts",
 	"types": "src/index.ts",
 	"type": "module",
@@ -22,8 +22,8 @@
 		"access": "public"
 	},
 	"dependencies": {
-		"@quark-fw/atom": "0.1.18",
-		"@quark-fw/plugin": "0.1.18",
+		"@quark-fw/atom": "0.1.20",
+		"@quark-fw/plugin": "0.1.20",
 		"@trpc/client": "^11.0.0",
 		"@types/react-dom": "^19.2.3",
 		"express": "^5.2.1",
@@ -36,8 +36,8 @@
 		"@mantine/dates": "^9.0.0",
 		"@mantine/modals": "^9.0.0",
 		"@mantine/notifications": "^9.0.0",
-		"@quark-fw/core": "0.1.18",
-		"@quark-fw/store": "0.1.18",
+		"@quark-fw/core": "0.1.20",
+		"@quark-fw/store": "0.1.20",
 		"@vitejs/plugin-react": "^5.1.0",
 		"react": "^19.2.4",
 		"react-dom": "^19.2.4",

package/src/index.ts

@@ -61,6 +61,11 @@ await quark.registerPlugin({
 			if (fs.existsSync(staticDir)) app.use(express.static(staticDir));
 			app.use(getRenderMiddleware({}));
 		} else {
+			// в dev каталог static/ никто не отдавал: запрос /fonts/... проваливался
+			// в SSR и получал редирект локали вместо файла. В проде то же самое
+			// делает express.static из build/static.
+			const staticDir = `${process.cwd()}/static`;
+			if (fs.existsSync(staticDir)) app.use(express.static(staticDir));
 			vite = await getVite({
 				root: appFrontendRoot(),
 				appPort: quark.react.port.value,

package/src/seo/SeoProvider.tsx

@@ -1,5 +1,5 @@
 import { ReactNode, useEffect, useMemo, useState } from "react";
-import { useLocation } from "react-router-dom";
+import { useLocation, useNavigate } from "react-router-dom";
 import { useStore } from "@quark-fw/store";
 import { matchPath } from "react-router-dom";
 import { getMatchedRoute } from "../Router/getMatchedRoute.js";
@@ -18,10 +18,19 @@ export function SeoProvider({
 }) {
 	const [seoObject, setSeoObject] = useState<SeoMap>(initial ?? {});
 	const { pathname } = useLocation();
+	const navigate = useNavigate();
 	const store = useStore();
 
 	const current = seoObject[pathname];
 
+	// редирект из меты при клиентской навигации (на SSR его сделала мидлвара)
+	useEffect(() => {
+		const target = current?.redirect?.to;
+		if (!target) return;
+		if (target.startsWith("/")) navigate(target, { replace: true });
+		else window.location.replace(target);
+	}, [current?.redirect?.to, navigate]);
+
 	// клиентская навигация: меты для нового пути ещё нет — резолвим её
 	// из модуля страницы (тот же resolveMeta, что и на сервере)
 	useEffect(() => {

package/src/seo/createPageMeta.test.ts

@@ -51,3 +51,11 @@ test("breadcrumbsJsonLd строит BreadcrumbList с абсолютными @i
 		],
 	});
 });
+
+test("resolveMeta резолвит redirect", async () => {
+	const seo = await resolveMeta(
+		{ redirect: async () => ({ to: "/listing/new", status: 301 }) },
+		{ store: {} as never, params: {} },
+	);
+	expect(seo.redirect).toEqual({ to: "/listing/new", status: 301 });
+});

package/src/seo/createPageMeta.ts

@@ -34,6 +34,9 @@ export type JsonLd = Record<string, unknown>;
 /** крошка навигации: подпись и путь относительно basename роутера */
 export type PageMetaBreadcrumb = { label: string; to: string };
 
+/** редирект вместо рендера: путь относительно basename (или абсолютный URL) и статус */
+export type PageMetaRedirect = { to: string; status?: 301 | 302 | 307 | 308 };
+
 export type PageMeta = {
 	title?: MetaValue<string>;
 	description?: MetaValue<string>;
@@ -49,6 +52,12 @@ export type PageMeta = {
 	breadcrumbs?: MetaValue<PageMetaBreadcrumb[] | undefined>;
 	/** HTTP-статус ответа (например 404 для «не найдено») */
 	status?: MetaValue<number>;
+	/**
+	 * Редирект: на SSR — ответ 30x до рендера, при клиентской навигации —
+	 * navigate(replace). Для перенесённых и схлопнутых страниц (дубликаты,
+	 * смена slug), чтобы не отдавать 404 по проиндексированным адресам.
+	 */
+	redirect?: MetaValue<PageMetaRedirect | undefined>;
 };
 
 export type ResolvedSeo = {
@@ -59,6 +68,7 @@ export type ResolvedSeo = {
 	jsonLD?: JsonLd[];
 	breadcrumbs?: PageMetaBreadcrumb[];
 	status?: number;
+	redirect?: PageMetaRedirect;
 };
 
 export function createPageMeta(meta: PageMeta): PageMeta {
@@ -82,17 +92,35 @@ export async function resolveMeta(
 	ctx: PageMetaContext,
 ): Promise<ResolvedSeo> {
 	if (!meta) return {};
-	const [title, description, robots, og, jsonLD, breadcrumbs, status] =
-		await Promise.all([
-			resolveValue(meta.title, ctx),
-			resolveValue(meta.description, ctx),
-			resolveValue(meta.robots, ctx),
-			resolveValue(meta.og, ctx),
-			resolveValue(meta.jsonLD, ctx),
-			resolveValue(meta.breadcrumbs, ctx),
-			resolveValue(meta.status, ctx),
-		]);
-	return { title, description, robots, og, jsonLD, breadcrumbs, status };
+	const [
+		title,
+		description,
+		robots,
+		og,
+		jsonLD,
+		breadcrumbs,
+		status,
+		redirect,
+	] = await Promise.all([
+		resolveValue(meta.title, ctx),
+		resolveValue(meta.description, ctx),
+		resolveValue(meta.robots, ctx),
+		resolveValue(meta.og, ctx),
+		resolveValue(meta.jsonLD, ctx),
+		resolveValue(meta.breadcrumbs, ctx),
+		resolveValue(meta.status, ctx),
+		resolveValue(meta.redirect, ctx),
+	]);
+	return {
+		title,
+		description,
+		robots,
+		og,
+		jsonLD,
+		breadcrumbs,
+		status,
+		redirect,
+	};
 }
 
 /** Узел BreadcrumbList для <head>; linkBase — origin + basename роутера. */

package/src/ssr/getRenderMiddleware.ts

@@ -110,6 +110,16 @@ export default function getRenderMiddleware({ vite }: GetRenderMiddlewareArgs) {
 				origin,
 			});
 
+			// редирект из меты: страница переехала или схлопнута — отвечаем
+			// 30x до рендера, относительный путь дополняется basename локали
+			if (seo.redirect) {
+				const target = seo.redirect.to.startsWith("/")
+					? basename + seo.redirect.to
+					: seo.redirect.to;
+				res.redirect(seo.redirect.status ?? 302, target);
+				return;
+			}
+
 			res.status(seo.status ?? (page ? 200 : 404));
 
 			// hreflang-кластер: каждая локаль + x-default на дефолтную