@hyperframes/studio 0.8.40 → 0.8.42

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio",
-  "version": "0.8.40",
+  "version": "0.8.42",
   "description": "",
   "repository": {
     "type": "git",
@@ -48,11 +48,11 @@
     "gsap": "^3.13.0",
     "marked": "^14.1.4",
     "mediabunny": "^1.45.3",
-    "@hyperframes/core": "0.8.40",
-    "@hyperframes/parsers": "0.8.40",
-    "@hyperframes/player": "0.8.40",
-    "@hyperframes/sdk": "0.8.40",
-    "@hyperframes/studio-server": "0.8.40"
+    "@hyperframes/core": "0.8.42",
+    "@hyperframes/player": "0.8.42",
+    "@hyperframes/sdk": "0.8.42",
+    "@hyperframes/studio-server": "0.8.42",
+    "@hyperframes/parsers": "0.8.42"
   },
   "devDependencies": {
     "@types/react": "19",
@@ -69,7 +69,7 @@
     "vite": "^6.4.2",
     "vitest": "^4.1.11",
     "zustand": "^5.0.0",
-    "@hyperframes/producer": "0.8.40"
+    "@hyperframes/producer": "0.8.42"
   },
   "peerDependencies": {
     "react": "19",

package/src/player/components/timelineRowVirtualizationFlag.test.ts

@@ -1,3 +1,4 @@
+import { readFileSync } from "node:fs";
 import { afterEach, describe, expect, it, vi } from "vitest";
 
 afterEach(() => {
@@ -20,4 +21,20 @@ describe("timeline row virtualization flag", () => {
 
     expect(STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED).toBe(false);
   });
+
+  it("guards the import.meta.env read so it evaluates outside Vite", () => {
+    // `import.meta.env` is a Vite-only extension and is undefined in a non-Vite
+    // ESM host (e.g. @hyperframes/studio embedded in Turbopack/Next.js), where
+    // an unguarded `import.meta.env.VITE_*` read crashes module evaluation. The
+    // vitest runtime always provides a real `import.meta.env` object, so this
+    // hazard can't be reproduced behaviorally in-environment; assert on the
+    // source that the optional-chaining guard is present, matching the repo's
+    // existing source-inspection tests (see timelineMotionStyles.test.ts).
+    const source = readFileSync(
+      new URL("./timelineRowVirtualizationFlag.ts", import.meta.url),
+      "utf8",
+    );
+    expect(source).toContain("import.meta.env?.VITE_STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED");
+    expect(source).not.toMatch(/import\.meta\.env\.\w/);
+  });
 });

package/src/player/components/timelineRowVirtualizationFlag.ts

@@ -7,4 +7,4 @@
  * type back, which would close an import cycle.
  */
 export const STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED =
-  import.meta.env.VITE_STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED !== "0";
+  import.meta.env?.VITE_STUDIO_TIMELINE_ROW_VIRTUALIZATION_ENABLED !== "0";

package/src/player/lib/thumbnailPolicy.test.ts

@@ -1,3 +1,4 @@
+import { readFileSync } from "node:fs";
 import { describe, expect, it } from "vitest";
 import { defaultThumbnailMode, effectiveThumbnailMode } from "./thumbnailPolicy";
 
@@ -11,4 +12,17 @@ describe("thumbnail runtime policy", () => {
     expect(effectiveThumbnailMode("adaptive", "force-hidden")).toBe("hidden");
     expect(effectiveThumbnailMode("adaptive", "follow-preference")).toBe("adaptive");
   });
+
+  it("guards the import.meta.env read so it evaluates outside Vite", () => {
+    // `import.meta.env` is a Vite-only extension and is undefined in a non-Vite
+    // ESM host (e.g. @hyperframes/studio embedded in Turbopack/Next.js), where
+    // an unguarded `import.meta.env.VITE_*` read crashes module evaluation. The
+    // vitest runtime always provides a real `import.meta.env` object, so this
+    // hazard can't be reproduced behaviorally in-environment; assert on the
+    // source that the optional-chaining guard is present, matching the repo's
+    // existing source-inspection tests (see timelineMotionStyles.test.ts).
+    const source = readFileSync(new URL("./thumbnailPolicy.ts", import.meta.url), "utf8");
+    expect(source).toContain("import.meta.env?.VITE_STUDIO_TIMELINE_THUMBNAIL_POLICY");
+    expect(source).not.toMatch(/import\.meta\.env\.\w/);
+  });
 });

package/src/player/lib/thumbnailPolicy.ts

@@ -4,7 +4,7 @@ export type ThumbnailRuntimePolicy = "follow-preference" | "force-hidden" | "leg
 // "Adaptive" currently means the scheduler pauses rich work while scrolling.
 // The mode name leaves room for finer-grained runtime heuristics later.
 
-const rawPolicy = import.meta.env.VITE_STUDIO_TIMELINE_THUMBNAIL_POLICY;
+const rawPolicy = import.meta.env?.VITE_STUDIO_TIMELINE_THUMBNAIL_POLICY;
 
 const studioThumbnailRuntimePolicy: ThumbnailRuntimePolicy =
   rawPolicy === "force-hidden" || rawPolicy === "legacy-default" ? rawPolicy : "follow-preference";