Create polished demo videos without editing skills. Mac/Windows/Linux
refactor(export): add lightning route policy plan
wiiiii123d9e1f05b952b
diff --git a/src/lib/exporter/backendPolicy.test.ts b/src/lib/exporter/backendPolicy.test.tsindex 7c532a18..9a33701c 100644--- a/src/lib/exporter/backendPolicy.test.ts+++ b/src/lib/exporter/backendPolicy.test.ts@@ -3,7 +3,9 @@ import { describe, expect, it } from "vitest";import {getDefaultLightningRenderBackend,normalizeLightningRuntimePlatform,+ planLightningExportRoutes,shouldPreferNativeAutoBackend,+ shouldPreferNativeStaticLayoutBeforeBreeze,} from "./backendPolicy";describe("backendPolicy", () => {@@ -24,4 +26,54 @@ describe("backendPolicy", () => {it("keeps Lightning exports on the stable WebGL renderer by default", () => {expect(getDefaultLightningRenderBackend()).toBe("webgl");});++ it("puts visually compatible Windows auto exports on native static layout before Breeze", () => {+ expect(shouldPreferNativeStaticLayoutBeforeBreeze("win32", "auto")).toBe(true);+ expect(shouldPreferNativeStaticLayoutBeforeBreeze("darwin", "auto")).toBe(false);++ expect(+ planLightningExportRoutes({+ backendPreference: "auto",+ platform: "win32",+ nativeStaticLayoutAvailable: true,+ }),+ ).toMatchObject({+ selectedRoute: "native-static-layout",+ decisions: [+ { route: "native-static-layout", status: "selected" },+ { route: "breeze-stream", status: "fallback" },+ { route: "webcodecs", status: "fallback" },+ ],+ });+ });++ it("documents the Breeze fallback when Windows static native is rejected", () => {+ expect(+ planLightningExportRoutes({+ backendPreference: "auto",+ platform: "win32",+ nativeStaticLayoutAvailable: true,+ nativeStaticLayoutSkipReasons: ["unsupported-frame-overlay"],+ }),+ ).toEqual({+ selectedRoute: "breeze-stream",+ decisions: [+ {+ route: "native-static-layout",+ status: "rejected",+ reasons: ["unsupported-frame-overlay"],+ },+ {+ route: "breeze-stream",+ status: "selected",+ reasons: ["windows-native-static-fallback"],+ },+ {+ route: "webcodecs",+ status: "fallback",+ reasons: ["breeze-unavailable-fallback"],+ },+ ],+ });+ });});diff --git a/src/lib/exporter/backendPolicy.ts b/src/lib/exporter/backendPolicy.tsindex 60f4f509..85be5209 100644--- a/src/lib/exporter/backendPolicy.ts+++ b/src/lib/exporter/backendPolicy.ts@@ -1,4 +1,4 @@-import type { ExportRenderBackend } from "./types";+import type { ExportBackendPreference, ExportRenderBackend } from "./types";export type LightningRuntimePlatform = "darwin" | "win32" | "linux" | "unknown";@@ -28,6 +28,111 @@ export function shouldPreferNativeAutoBackend(_platform: LightningRuntimePlatforreturn _platform === "darwin" || _platform === "win32";}+export type LightningExportRoute = "native-static-layout" | "breeze-stream" | "webcodecs";++export interface LightningExportRouteDecision {+ route: LightningExportRoute;+ status: "selected" | "fallback" | "rejected";+ reasons: string[];+}++export interface LightningExportRoutePlan {+ selectedRoute: LightningExportRoute;+ decisions: LightningExportRouteDecision[];+}++export function shouldPreferNativeStaticLayoutBeforeBreeze(+ platform: LightningRuntimePlatform,+ backendPreference: ExportBackendPreference,+): boolean {+ return backendPreference === "auto" && platform === "win32";+}++export function planLightningExportRoutes(options: {+ backendPreference: ExportBackendPreference;+ platform: LightningRuntimePlatform;+ nativeStaticLayoutAvailable: boolean;+ nativeStaticLayoutSkipReasons?: string[];+}): LightningExportRoutePlan {+ const decisions: LightningExportRouteDecision[] = [];+ const nativeStaticLayoutSkipReasons = options.nativeStaticLayoutSkipReasons ?? [];+ const canUseNativeStaticLayout =+ options.nativeStaticLayoutAvailable && nativeStaticLayoutSkipReasons.length === 0;++ const addNativeStaticLayoutDecision = (status: LightningExportRouteDecision["status"]) => {+ decisions.push({+ route: "native-static-layout",+ status,+ reasons: canUseNativeStaticLayout+ ? ["visually-compatible"]+ : nativeStaticLayoutSkipReasons.length > 0+ ? nativeStaticLayoutSkipReasons+ : ["native-static-unavailable"],+ });+ };++ if (options.backendPreference === "webcodecs") {+ decisions.push({+ route: "webcodecs",+ status: "selected",+ reasons: ["user-selected-webcodecs"],+ });+ return { selectedRoute: "webcodecs", decisions };+ }++ const preferStaticFirst =+ options.backendPreference === "breeze" ||+ shouldPreferNativeStaticLayoutBeforeBreeze(options.platform, options.backendPreference);++ if (preferStaticFirst) {+ addNativeStaticLayoutDecision(canUseNativeStaticLayout ? "selected" : "rejected");+ decisions.push({+ route: "breeze-stream",+ status: canUseNativeStaticLayout ? "fallback" : "selected",+ reasons: [+ options.backendPreference === "breeze"+ ? "user-selected-breeze"+ : "windows-native-static-fallback",+ ],+ });+ decisions.push({+ route: "webcodecs",+ status: "fallback",+ reasons: ["breeze-unavailable-fallback"],+ });+ return {+ selectedRoute: canUseNativeStaticLayout ? "native-static-layout" : "breeze-stream",+ decisions,+ };+ }++ if (options.backendPreference === "auto" && shouldPreferNativeAutoBackend(options.platform)) {+ decisions.push({+ route: "breeze-stream",+ status: "selected",+ reasons: ["platform-prefers-native-streaming"],+ });+ decisions.push({+ route: "webcodecs",+ status: "fallback",+ reasons: ["breeze-unavailable-fallback"],+ });+ return { selectedRoute: "breeze-stream", decisions };+ }++ decisions.push({+ route: "webcodecs",+ status: "selected",+ reasons: ["default-webcodecs-first"],+ });+ decisions.push({+ route: "breeze-stream",+ status: "fallback",+ reasons: ["webcodecs-software-or-unavailable-fallback"],+ });+ return { selectedRoute: "webcodecs", decisions };+}+export function getDefaultLightningRenderBackend(): ExportRenderBackend {return "webgl";}