@open-slide/core 1.6.0 → 1.8.0

package/dist/{build-tLrkKUHr.js → build-CCZDC8eF.js}

@@ -1,5 +1,5 @@
 import "./design-cpzS8aud.js";
-import { createViteConfig } from "./config-PwUHqZ_X.js";
+import { createViteConfig } from "./config-C7sZtiY2.js";
 import path from "node:path";
 import { build as build$1, mergeConfig } from "vite";
 

package/dist/cli/bin.js

@@ -57,15 +57,15 @@ async function run(argv) {
 	program.name("open-slide").description("Author slides — we handle the Vite/React stack.").version(version, "-v, --version", "print version").helpOption("-h, --help", "show help").showHelpAfterError(chalk.dim("(run `open-slide --help` for usage)"));
 	program.command("dev").description("Start the dev server").addOption(new Option("-p, --port <port>", "port to listen on").argParser(parsePort)).addOption(new Option("--host [host]", "expose on the network (optional host)")).option("--open", "open the browser on start").option("--no-skills-check", "skip the built-in skills drift check").action(async (flags) => {
 		if (flags.skillsCheck !== false) await runSkillsDriftCheck(resolveBuiltinSkillsDir());
-		const { dev } = await import("../dev-DpCIRbhT.js");
+		const { dev } = await import("../dev-kLS_4CAI.js");
 		await dev(flags);
 	});
 	program.command("build").description("Build a static site").option("--out-dir <dir>", "output directory (defaults to `dist`)").action(async (flags) => {
-		const { build } = await import("../build-tLrkKUHr.js");
+		const { build } = await import("../build-CCZDC8eF.js");
 		await build(flags);
 	});
 	program.command("preview").description("Preview the production build").addOption(new Option("-p, --port <port>", "port to listen on").argParser(parsePort)).addOption(new Option("--host [host]", "expose on the network (optional host)")).option("--open", "open the browser on start").action(async (flags) => {
-		const { preview } = await import("../preview-BSGlM6Se.js");
+		const { preview } = await import("../preview-DUkOjOx8.js");
 		await preview(flags);
 	});
 	program.command("sync:skills").description("Sync built-in skills from @open-slide/core into this workspace").option("--dry-run", "show what would change without writing").action(async (flags) => {

package/dist/{config-PwUHqZ_X.js → config-C7sZtiY2.js}

@@ -1157,21 +1157,20 @@ function findReferencedAssets(source, assetPaths) {
 	if (!ast) return referenced;
 	const wanted = new Set(assetPaths);
 	const identToPath = new Map();
+	const importLocals = new Set();
 	for (const imp of findImports$1(ast)) {
 		if (!imp.defaultIdent) continue;
-		if (wanted.has(imp.source)) identToPath.set(imp.defaultIdent, imp.source);
+		if (!wanted.has(imp.source)) continue;
+		identToPath.set(imp.defaultIdent, imp.source);
+		for (const spec of imp.node.specifiers) if (t$3.isImportDefaultSpecifier(spec) && spec.local.name === imp.defaultIdent) importLocals.add(spec.local);
 	}
 	if (identToPath.size === 0) return referenced;
-	walkJsx(ast, (n) => {
-		if (!t$3.isJSXElement(n)) return;
-		const opening = n.openingElement;
-		if (!t$3.isJSXIdentifier(opening.name) || opening.name.name !== "img") return;
-		const src = findJsxAttr(opening, "src");
-		if (!src?.value || !t$3.isJSXExpressionContainer(src.value)) return;
-		const expr = src.value.expression;
-		if (!t$3.isIdentifier(expr)) return;
-		const p = identToPath.get(expr.name);
-		if (p) referenced.add(p);
+	walkAll(ast, (n) => {
+		if (!t$3.isIdentifier(n)) return;
+		const p = identToPath.get(n.name);
+		if (!p) return;
+		if (importLocals.has(n)) return;
+		referenced.add(p);
 	});
 	return referenced;
 }
@@ -2446,6 +2445,19 @@ function validateName(v) {
 	if (trimmed.length < 1 || trimmed.length > 40) return null;
 	return trimmed;
 }
+function validateReorder(v, current) {
+	if (!Array.isArray(v) || v.length !== current.length) return null;
+	const known = new Set(current.map((f) => f.id));
+	const seen = new Set();
+	const out = [];
+	for (const id of v) {
+		if (typeof id !== "string" || !FOLDER_ID_RE.test(id)) return null;
+		if (!known.has(id) || seen.has(id)) return null;
+		seen.add(id);
+		out.push(id);
+	}
+	return out;
+}
 function validateIcon(v) {
 	if (!v || typeof v !== "object") return null;
 	const icon = v;
@@ -2513,6 +2525,18 @@ function registerFolderRoutes(server, ctx) {
 				await writeManifest(ctx.manifestPath, manifest);
 				return json$2(res, 200, { ok: true });
 			}
+			if (method === "PUT" && url.pathname === "/reorder") {
+				const requestCheck = validateMutationRequest(req, { requireJsonBody: true });
+				if (!requestCheck.ok) return json$2(res, requestCheck.status, { error: requestCheck.error });
+				const body = await readBody$2(req);
+				const manifest = await readManifest(ctx.manifestPath);
+				const ids = validateReorder(body.ids, manifest.folders);
+				if (!ids) return json$2(res, 400, { error: "invalid ids" });
+				const byId = new Map(manifest.folders.map((f) => [f.id, f]));
+				manifest.folders = ids.map((id) => byId.get(id));
+				await writeManifest(ctx.manifestPath, manifest);
+				return json$2(res, 200, { ok: true });
+			}
 			const idMatch = url.pathname.match(/^\/([^/]+)$/);
 			if (idMatch) {
 				const id = idMatch[1];
@@ -3334,19 +3358,22 @@ function injectLocTags(code) {
 	for (const ins of insertions) next = next.slice(0, ins.offset) + ins.text + next.slice(ins.offset);
 	return next;
 }
+function isSlideSourceFile(id, slidesRootPosix) {
+	const filePath = id.split(/[?#]/)[0].replace(/\\/g, "/");
+	if (!filePath.startsWith(`${slidesRootPosix}/`)) return false;
+	if (!filePath.endsWith(".tsx")) return false;
+	if (filePath.endsWith(".d.ts") || filePath.endsWith(".test.tsx")) return false;
+	const rel = filePath.slice(slidesRootPosix.length + 1);
+	return rel.includes("/");
+}
 function locTagsPlugin(opts) {
-	const slidesRoot = path.resolve(opts.userCwd, opts.slidesDir ?? "slides");
+	const slidesRoot = path.resolve(opts.userCwd, opts.slidesDir ?? "slides").replace(/\\/g, "/");
 	return {
 		name: "open-slide:loc-tags",
 		apply: "serve",
 		enforce: "pre",
 		transform(code, id) {
-			const filePath = id.split("?")[0];
-			if (!filePath.startsWith(slidesRoot + path.sep)) return null;
-			if (!filePath.endsWith(".tsx")) return null;
-			if (filePath.endsWith(".d.ts") || filePath.endsWith(".test.tsx")) return null;
-			const rel = filePath.slice(slidesRoot.length + path.sep.length);
-			if (!rel.includes(path.sep)) return null;
+			if (!isSlideSourceFile(id, slidesRoot)) return null;
 			const next = injectLocTags(code);
 			if (next === null) return null;
 			return {

package/dist/{config-CfMThYN9.d.ts → config-D1bANimZ.d.ts}

@@ -1,4 +1,4 @@
-import { Locale } from "./types-B-KrjgX8.js";
+import { Locale } from "./types-Bvk1pM70.js";
 
 //#region src/config.d.ts
 type OpenSlideBuildConfig = {

package/dist/{dev-DpCIRbhT.js → dev-kLS_4CAI.js}

@@ -1,5 +1,5 @@
 import "./design-cpzS8aud.js";
-import { createViteConfig } from "./config-PwUHqZ_X.js";
+import { createViteConfig } from "./config-C7sZtiY2.js";
 import { createServer, mergeConfig } from "vite";
 
 //#region src/cli/dev.ts

package/dist/{en-BDnM5zKJ.js → en-hyGpmL1O.js}

@@ -82,6 +82,7 @@ const en = {
 		toastSlideMoveFailed: "Failed to move slide",
 		toastFolderDeleted: "Deleted folder “{name}”",
 		toastFolderDeleteFailed: "Failed to delete folder",
+		toastFolderReorderFailed: "Failed to reorder folders",
 		pickIcon: "Pick icon"
 	},
 	slide: {
@@ -337,10 +338,6 @@ const en = {
 		dark: "Dark",
 		system: "System"
 	},
-	clickNav: {
-		prevAria: "Previous page",
-		nextAria: "Next page"
-	},
 	imagePlaceholder: {
 		dropOverlay: "Drop image to use here",
 		uploading: "Uploading…",

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { Locale, Plural } from "./types-B-KrjgX8.js";
-import { OpenSlideConfig } from "./config-CfMThYN9.js";
+import { Locale, Plural } from "./types-Bvk1pM70.js";
+import { OpenSlideConfig } from "./config-D1bANimZ.js";
 import { CSSProperties, ComponentType, HTMLAttributes } from "react";
 import * as react_jsx_runtime0 from "react/jsx-runtime";
 
@@ -52,9 +52,26 @@ declare function useSlidePageNumber(): {
   total: number;
 };
 
+//#endregion
+//#region src/app/lib/transition.d.ts
+type TransitionPhase = {
+  keyframes: Keyframe[] | PropertyIndexedKeyframes;
+  easing?: string;
+  duration?: number;
+  delay?: number;
+};
+type SlideTransition = {
+  duration: number;
+  easing?: string;
+  enter?: TransitionPhase;
+  exit?: TransitionPhase;
+};
+
 //#endregion
 //#region src/app/lib/sdk.d.ts
-type Page = ComponentType;
+type Page = ComponentType & {
+  transition?: SlideTransition;
+};
 type SlideMeta = {
   title?: string;
   theme?: string;
@@ -66,9 +83,10 @@ type SlideModule = {
   meta?: SlideMeta;
   design?: DesignSystem;
   notes?: (string | undefined)[];
+  transition?: SlideTransition;
 };
 declare const CANVAS_WIDTH = 1920;
 declare const CANVAS_HEIGHT = 1080;
 
 //#endregion
-export { CANVAS_HEIGHT, CANVAS_WIDTH, DesignFonts, DesignPalette, DesignSystem, DesignTypeScale, ImagePlaceholder, ImagePlaceholderProps, Locale, OpenSlideConfig, Page, Plural, SlideMeta, SlideModule, cssVarsToString, defaultDesign, designToCssVars, useSlidePageNumber };
+export { CANVAS_HEIGHT, CANVAS_WIDTH, DesignFonts, DesignPalette, DesignSystem, DesignTypeScale, ImagePlaceholder, ImagePlaceholderProps, Locale, OpenSlideConfig, Page, Plural, SlideMeta, SlideModule, SlideTransition, TransitionPhase, cssVarsToString, defaultDesign, designToCssVars, useSlidePageNumber };

package/dist/index.js

@@ -1,4 +1,4 @@
-import { en } from "./en-BDnM5zKJ.js";
+import { en } from "./en-hyGpmL1O.js";
 import { cssVarsToString, defaultDesign, designToCssVars } from "./design-cpzS8aud.js";
 import { createContext, useContext, useRef, useState } from "react";
 import { toast } from "sonner";

package/dist/locale/index.d.ts

@@ -1,4 +1,4 @@
-import { Locale, Plural } from "../types-B-KrjgX8.js";
+import { Locale, Plural } from "../types-Bvk1pM70.js";
 
 //#region src/locale/en.d.ts
 declare const en: Locale;

package/dist/locale/index.js

@@ -1,4 +1,4 @@
-import { en } from "../en-BDnM5zKJ.js";
+import { en } from "../en-hyGpmL1O.js";
 
 //#region src/locale/format.ts
 function format(template, vars) {
@@ -96,6 +96,7 @@ const ja = {
 		toastSlideMoveFailed: "スライドの移動に失敗しました",
 		toastFolderDeleted: "フォルダ「{name}」を削除しました",
 		toastFolderDeleteFailed: "フォルダの削除に失敗しました",
+		toastFolderReorderFailed: "フォルダの並び替えに失敗しました",
 		pickIcon: "アイコンを選択"
 	},
 	slide: {
@@ -351,10 +352,6 @@ const ja = {
 		dark: "ダーク",
 		system: "システム"
 	},
-	clickNav: {
-		prevAria: "前のページ",
-		nextAria: "次のページ"
-	},
 	imagePlaceholder: {
 		dropOverlay: "ここにドロップして使用",
 		uploading: "アップロード中…",
@@ -473,6 +470,7 @@ const zhCN = {
 		toastSlideMoveFailed: "移动幻灯片失败",
 		toastFolderDeleted: "已删除文件夹\"{name}\"",
 		toastFolderDeleteFailed: "删除文件夹失败",
+		toastFolderReorderFailed: "文件夹排序失败",
 		pickIcon: "选择图标"
 	},
 	slide: {
@@ -728,10 +726,6 @@ const zhCN = {
 		dark: "深色",
 		system: "系统"
 	},
-	clickNav: {
-		prevAria: "上一页",
-		nextAria: "下一页"
-	},
 	imagePlaceholder: {
 		dropOverlay: "拖入图片以使用",
 		uploading: "上传中…",
@@ -850,6 +844,7 @@ const zhTW = {
 		toastSlideMoveFailed: "移動投影片失敗",
 		toastFolderDeleted: "已刪除資料夾「{name}」",
 		toastFolderDeleteFailed: "刪除資料夾失敗",
+		toastFolderReorderFailed: "資料夾排序失敗",
 		pickIcon: "選擇圖示"
 	},
 	slide: {
@@ -1105,10 +1100,6 @@ const zhTW = {
 		dark: "深色",
 		system: "系統"
 	},
-	clickNav: {
-		prevAria: "上一頁",
-		nextAria: "下一頁"
-	},
 	imagePlaceholder: {
 		dropOverlay: "拖入圖片以使用",
 		uploading: "上傳中…",

package/dist/{preview-BSGlM6Se.js → preview-DUkOjOx8.js}

@@ -1,5 +1,5 @@
 import "./design-cpzS8aud.js";
-import { createViteConfig } from "./config-PwUHqZ_X.js";
+import { createViteConfig } from "./config-C7sZtiY2.js";
 import { mergeConfig, preview as preview$1 } from "vite";
 
 //#region src/cli/preview.ts

package/dist/{types-B-KrjgX8.d.ts → types-Bvk1pM70.d.ts}

@@ -90,6 +90,7 @@ type Locale = {
     /** template: "Deleted folder “{name}”" */
     toastFolderDeleted: string;
     toastFolderDeleteFailed: string;
+    toastFolderReorderFailed: string;
     pickIcon: string;
   };
   slide: {
@@ -365,10 +366,6 @@ type Locale = {
     dark: string;
     system: string;
   };
-  clickNav: {
-    prevAria: string;
-    nextAria: string;
-  };
   imagePlaceholder: {
     dropOverlay: string;
     uploading: string;

package/dist/vite/index.d.ts

@@ -1,5 +1,5 @@
-import "../types-B-KrjgX8.js";
-import { OpenSlideConfig } from "../config-CfMThYN9.js";
+import "../types-Bvk1pM70.js";
+import { OpenSlideConfig } from "../config-D1bANimZ.js";
 import { InlineConfig } from "vite";
 
 //#region src/vite/config.d.ts

package/dist/vite/index.js

@@ -1,4 +1,4 @@
 import "../design-cpzS8aud.js";
-import { createViteConfig } from "../config-PwUHqZ_X.js";
+import { createViteConfig } from "../config-C7sZtiY2.js";
 
 export { createViteConfig };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@open-slide/core",
-  "version": "1.6.0",
+  "version": "1.8.0",
   "description": "Runtime and CLI for open-slide — write slides in slides/, we handle the rest.",
   "type": "module",
   "exports": {

package/skills/create-theme/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: create-theme
-description: Use this skill when the user wants to create, draft, author, or extract a slide theme in this open-slide repo. Triggers on phrases like "create a theme", "make a theme called X", "extract a theme from <slide>", "build a theme from these images". Produces two paired files under `themes/`: `<id>.md` (palette, typography, layout, fixed Title/Footer components, motion) and `<id>.demo.tsx` (a runnable demo slide that the dev-UI Themes panel previews). Do NOT use for editing real slides — only for authoring the theme bundle.
+description: Use this skill when the user wants to create, draft, author, or extract a slide theme in this open-slide repo. Triggers on phrases like "create a theme", "make a theme called X", "extract a theme from <slide>", "build a theme from these images". Produces two paired files under `themes/` — `<id>.md` (palette, typography, layout, fixed Title/Footer components, motion) and `<id>.demo.tsx` (a runnable demo slide that the dev-UI Themes panel previews). Do NOT use for editing real slides — only for authoring the theme bundle.
 ---
 
 # Create a slide theme

package/skills/slide-authoring/SKILL.md

@@ -308,6 +308,174 @@ const Footer = () => {
 
 `current` is 1-indexed (matches what readers see) and `total` is the slide's page count. The hook works in every render context (main viewer, thumbnails, overview grid, present mode, presenter window, HTML/PDF export) — the same `<Footer />` JSX is correct everywhere. Call the hook inside a component that's used **per page**; don't try to call it at module top level.
 
+## Page transitions
+
+The framework can run an enter/exit animation between every slide change. There's **no default** — pages snap unless you declare a `SlideTransition`. Snap-swap is a perfectly tasteful default; only opt in when motion adds something.
+
+`prefers-reduced-motion: reduce` is honored automatically. You don't write a fallback.
+
+### Contract
+
+Module-level for the whole deck; per-page to override. The **incoming page wins**: navigating A → B uses `pages[B].transition ?? module.transition`. Its `exit` plays on A, its `enter` plays on B. Going back B → A uses A's transition.
+
+```tsx
+import type { Page, SlideTransition } from '@open-slide/core';
+
+const Cover: Page = () => <section>…</section>;
+const Body:  Page = () => <section>…</section>;
+
+// Module-level default — every page inherits unless it overrides.
+export const transition: SlideTransition = { /* … */ };
+
+// Per-page override.
+Cover.transition = { /* … */ };
+
+export default [Cover, Body];
+```
+
+```ts
+type TransitionPhase = {
+  keyframes: Keyframe[] | PropertyIndexedKeyframes;  // WAAPI keyframes
+  duration?: number;  // ms (falls back to top-level duration)
+  easing?: string;    // CSS easing
+  delay?: number;     // ms — use to overlap exit + enter
+};
+type SlideTransition = {
+  duration: number;          // top-level fallback
+  easing?: string;           // top-level fallback
+  enter?: TransitionPhase;   // runs on incoming page
+  exit?:  TransitionPhase;   // runs on outgoing page
+};
+```
+
+The framework also exposes `--osd-dir` (`1` forward, `-1` backward) and `data-osd-dir` on the wrapper, so a single keyframe can mirror direction without a JS callback.
+
+### Design principles (hold the line)
+
+The single loudest signal of "made in PowerPoint" is six different transitions in one deck. Restraint is the rhythm.
+
+- **Pick one DNA, hold it across the deck.** Same duration band, same easing pair, same out-then-in stagger. Variation lives only in *which property* gets the small nudge — Y, X, opacity, scale, blur.
+- **Duration: 140–280 ms.** Exit 140–180 ms, enter 200–280 ms, enter delayed ~80 ms so they overlap but don't fight. Past 350 ms is video-editor territory; reserve for genuine state changes.
+- **Magnitude ceiling: 12 px or 3% scale.** A 6 px Y-rise reads as "next thought." A 1920 px translateX reads as "different document." Premium tools move barely enough to register.
+- **Opacity is always part of it.** Pure-transform transitions look stiff; pure-opacity transitions are the safest possible default.
+- **Easing: ease-in for exit, ease-out for enter.** `cubic-bezier(0.4, 0, 1, 1)` going out, `cubic-bezier(0, 0, 0.2, 1)` coming in. Never `linear` (feels like a slideshow). Reserve symmetric `ease-in-out` for state-anchored morphs only.
+
+### Tasteful family — six members, one DNA
+
+Use this set as a starting point. Pick one as the deck's house transition; optionally reserve a second for hero/cover slides and a third for genuine section breaks. The CSS-`calc` + `--osd-dir` trick lets a single definition mirror itself on backward navigation when needed.
+
+```tsx
+const EASE_OUT = 'cubic-bezier(0, 0, 0.2, 1)';
+const EASE_IN  = 'cubic-bezier(0.4, 0, 1, 1)';
+
+// RISE — house quiet. 6 px Y. Use as module default.
+export const transition: SlideTransition = {
+  duration: 200,
+  exit:  { duration: 140, easing: EASE_IN,
+           keyframes: [
+             { opacity: 1, transform: 'translateY(0)' },
+             { opacity: 0, transform: 'translateY(-4px)' },
+           ] },
+  enter: { duration: 200, delay: 80, easing: EASE_OUT,
+           keyframes: [
+             { opacity: 0, transform: 'translateY(6px)' },
+             { opacity: 1, transform: 'translateY(0)' },
+           ] },
+};
+
+// DISSOLVE — pure opacity. The quietest possible.
+const dissolve: SlideTransition = {
+  duration: 240,
+  exit:  { duration: 200, easing: EASE_IN,
+           keyframes: [{ opacity: 1 }, { opacity: 0 }] },
+  enter: { duration: 240, delay: 40, easing: EASE_OUT,
+           keyframes: [{ opacity: 0 }, { opacity: 1 }] },
+};
+
+// SETTLE — cover-grade. Rise + a hair of blur on enter only.
+Cover.transition = {
+  duration: 280,
+  exit:  { duration: 160, easing: EASE_IN,
+           keyframes: [
+             { opacity: 1, transform: 'translateY(0)' },
+             { opacity: 0, transform: 'translateY(-6px)' },
+           ] },
+  enter: { duration: 280, delay: 100, easing: EASE_OUT,
+           keyframes: [
+             { opacity: 0, transform: 'translateY(12px)', filter: 'blur(4px)' },
+             { opacity: 1, transform: 'translateY(0)',    filter: 'blur(0)'   },
+           ] },
+};
+
+// BLOOM — scale 0.97 → 1, no translate. Materializes in place.
+const bloom: SlideTransition = {
+  duration: 240,
+  exit:  { duration: 160, easing: EASE_IN,
+           keyframes: [
+             { opacity: 1, transform: 'scale(1)' },
+             { opacity: 0, transform: 'scale(1.01)' },
+           ] },
+  enter: { duration: 240, delay: 80, easing: EASE_OUT,
+           keyframes: [
+             { opacity: 0, transform: 'scale(0.97)' },
+             { opacity: 1, transform: 'scale(1)' },
+           ] },
+};
+
+// FALL — mirrored Rise. Incoming page comes down from above.
+const fall: SlideTransition = {
+  duration: 200,
+  exit:  { duration: 140, easing: EASE_IN,
+           keyframes: [
+             { opacity: 1, transform: 'translateY(0)' },
+             { opacity: 0, transform: 'translateY(4px)' },
+           ] },
+  enter: { duration: 200, delay: 80, easing: EASE_OUT,
+           keyframes: [
+             { opacity: 0, transform: 'translateY(-6px)' },
+             { opacity: 1, transform: 'translateY(0)' },
+           ] },
+};
+
+// BREATH — section break. Exit fully, hold 120 ms, then enter.
+// Reserve for genuine chapter dividers; use at most 1–2× per deck.
+const breath: SlideTransition = {
+  duration: 460,
+  exit:  { duration: 180, easing: EASE_IN,
+           keyframes: [{ opacity: 1 }, { opacity: 0 }] },
+  enter: { duration: 240, delay: 300, easing: EASE_OUT,
+           keyframes: [
+             { opacity: 0, transform: 'translateY(8px)' },
+             { opacity: 1, transform: 'translateY(0)' },
+           ] },
+};
+```
+
+All six share the same DNA — they only differ in which property carries the small nudge. The reader perceives variety; the eye still reads one consistent hand.
+
+### Direction-aware keyframes (use sparingly)
+
+Most tasteful tools don't mirror on backward navigation. When you genuinely need to — e.g. a horizontal slide that should reverse — use `--osd-dir` inside `calc()`:
+
+```tsx
+{ transform: 'translateX(calc(var(--osd-dir, 1) * 8px))' },
+{ transform: 'translateX(0)' },
+```
+
+If you find yourself reaching for this on every transition, you're probably over-designing. Forward = backward is the more refined default.
+
+### Transition anti-patterns
+
+- ❌ Six different transitions across six pages — the single loudest "made in PowerPoint" tell.
+- ❌ `translateX(100%)` slide-from-side — iOS modal / PowerPoint Push; not a slide change.
+- ❌ Aggressive scale-pop (e.g. `0.85 → 1`) + blur — lightbox / photo-viewer vocabulary; implies zooming *into* something.
+- ❌ `clip-path: inset(…)` reveals — After Effects vocabulary; theatrical.
+- ❌ Parallel blur on both layers at once — visual mush; the eye can't fixate.
+- ❌ Duration > 350 ms for a standard slide change — drags.
+- ❌ Translate > 12 px or scale > 3% — reads as rupture, not continuity.
+- ❌ `linear` easing — feels like a slideshow, not a product.
+- ❌ Declaring a transition on every deck. **If you don't have a clear reason, omit it.** Snap-swap is fine.
+
 ## Repeated elements: component, not `map`
 
 When a page has visually repeated items — cards, logo rows, gallery tiles, list rows, step indicators — **define a small component and instantiate it once per item**. Do **not** render the group with `array.map` over a data array.
@@ -373,6 +541,7 @@ This applies whenever the *visual element* repeats, not whenever the *data* does
 - [ ] Visually repeated elements (cards, tiles, logo rows) are rendered as explicit `<Component />` instances, not via `array.map` over a data list.
 - [ ] All imported assets exist on disk — slide-local under `slides/<id>/assets/`, or global under `assets/` (imported via `@assets/...`).
 - [ ] Every `<ImagePlaceholder>` corresponds to a real image the user must supply — not decorative filler. If it could be replaced by typography or layout, it should be.
+- [ ] If a `SlideTransition` is declared, every page sits in one family — same duration band (140–280 ms), same easing pair, same out-then-in stagger, magnitude under 12 px / 3%. No six-different-vocabularies decks. When in doubt, omit transitions entirely.
 - [ ] Nothing outside `slides/<id>/` was edited.
 
 ## Anti-patterns