paperlab 0.5.2 → 0.7.0

package/dist/stage.js

@@ -16,7 +16,8 @@ import {
   resolveLighting,
   usePrefersReducedMotion,
   walkPathSchema
-} from "./chunk-HRXQTJFS.js";
+} from "./chunk-MZCAN3AR.js";
+import "./chunk-7TLIWPGM.js";
 
 // src/stage/PaperStage.tsx
 import * as THREE6 from "three";
@@ -789,50 +790,28 @@ function Suspension({
   ] });
 }
 
-// src/stage/Grade.tsx
-import {
-  EffectComposer,
-  Bloom,
-  DepthOfField,
-  Vignette,
-  Noise,
-  ToneMapping
-} from "@react-three/postprocessing";
-import { BlendFunction, ToneMappingMode } from "postprocessing";
-import { jsx as jsx6, jsxs as jsxs5 } from "react/jsx-runtime";
-var toneMappingModes = {
-  agx: ToneMappingMode.AGX,
-  neutral: ToneMappingMode.NEUTRAL,
-  filmic: ToneMappingMode.ACES_FILMIC
-};
-function Grade({ grade, film }) {
-  const bloom = grade.bloom > 0;
-  const depth = grade.depth > 0;
-  const vignette = grade.vignette > 0;
-  const grain = grade.grain > 0;
-  if (!bloom && !depth && !vignette && !grain) return null;
-  return /* @__PURE__ */ jsxs5(EffectComposer, { children: [
-    bloom ? /* @__PURE__ */ jsx6(
-      Bloom,
-      {
-        intensity: grade.bloom,
-        luminanceThreshold: grade.threshold,
-        luminanceSmoothing: 0.22,
-        mipmapBlur: true
-      }
-    ) : null,
-    depth ? /* @__PURE__ */ jsx6(
-      DepthOfField,
-      {
-        focusDistance: 8e-3,
-        focalLength: 0.02 + grade.depth * 0.04,
-        bokehScale: grade.depth * 2.5
-      }
-    ) : null,
-    /* @__PURE__ */ jsx6(ToneMapping, { mode: toneMappingModes[film] }),
-    vignette ? /* @__PURE__ */ jsx6(Vignette, { offset: 0.32, darkness: grade.vignette }) : null,
-    grain ? /* @__PURE__ */ jsx6(Noise, { opacity: grade.grain, blendFunction: BlendFunction.OVERLAY }) : null
-  ] });
+// src/stage/GradeLazy.tsx
+import { Suspense as Suspense2, lazy } from "react";
+import { jsx as jsx6 } from "react/jsx-runtime";
+var Grade = lazy(
+  () => import("./Grade-SBGYELKV.js").then((m) => ({ default: m.Grade })).catch((error) => {
+    warnOnce(error);
+    return { default: (() => null) };
+  })
+);
+var warned = false;
+function warnOnce(cause) {
+  if (warned) return;
+  warned = true;
+  console.warn(
+    "[paperlab/stage] Rendering without the print pass \u2014 tone curve, bloom, vignette and grain are off.\nThey need two optional peers:\n  npm i @react-three/postprocessing postprocessing\nSet `grade` to all zeros to turn the pass off deliberately and silence this.",
+    ...cause === void 0 ? [] : [cause]
+  );
+}
+function GradePass(props) {
+  const { bloom, depth, vignette, grain } = props.grade;
+  if (!(bloom > 0 || depth > 0 || vignette > 0 || grain > 0)) return null;
+  return /* @__PURE__ */ jsx6(Suspense2, { fallback: null, children: /* @__PURE__ */ jsx6(Grade, { ...props }) });
 }
 
 // src/stage/schema.ts
@@ -958,9 +937,9 @@ var stageRoomSchema = z3.object({
   height: z3.number().min(1).max(6).default(2.2),
   color: z3.string().default("#171310").describe("color"),
   /** Columns flanking the walk — see `stageColumnsSchema`. */
-  columns: stageColumnsSchema.default({}),
+  columns: stageColumnsSchema.prefault({}),
   /** A wall at the end of the walk with the source in it. */
-  doorway: stageDoorwaySchema.default({})
+  doorway: stageDoorwaySchema.prefault({})
 });
 var stageGradeSchema = z3.object({
   /**
@@ -1014,9 +993,9 @@ var stageGradeSchema = z3.object({
   grain: z3.number().min(0).max(0.5).default(0.022)
 });
 var stageSchema = z3.object({
-  path: walkPathSchema.default({}),
-  shot: shotSchema.default({}),
-  figure: figureSchema.default({}),
+  path: walkPathSchema.prefault({}),
+  shot: shotSchema.prefault({}),
+  figure: figureSchema.prefault({}),
   /** Stage mode is built for `nave`; the others are all front-lit. */
   lighting: z3.enum(lightingNames).default("nave"),
   /**
@@ -1043,12 +1022,12 @@ var stageSchema = z3.object({
    * Still one flag away for anyone who wants it.
    */
   showFigure: z3.boolean().default(false),
-  source: stageSourceSchema.default({}),
-  ground: stageGroundSchema.default({}),
+  source: stageSourceSchema.prefault({}),
+  ground: stageGroundSchema.prefault({}),
   /** Ceiling and the architecture around the walk — see `stageRoomSchema`. */
-  room: stageRoomSchema.default({}),
+  room: stageRoomSchema.prefault({}),
   /** Thread and clips — see `stageSuspensionSchema`. */
-  suspension: stageSuspensionSchema.default({}),
+  suspension: stageSuspensionSchema.prefault({}),
   /**
    * The print — bloom, vignette, grain.
    *
@@ -1060,7 +1039,7 @@ var stageSchema = z3.object({
    * behaviour: a stage silently losing its grade would be worse than a
    * missing-module error that names the package.
    */
-  grade: stageGradeSchema.default({})
+  grade: stageGradeSchema.prefault({})
 });
 
 // src/stage/navigate.ts
@@ -1389,7 +1368,7 @@ function settleTier(tier, fps, failed) {
 }
 
 // src/stage/PaperStage.tsx
-import { jsx as jsx7, jsxs as jsxs6 } from "react/jsx-runtime";
+import { jsx as jsx7, jsxs as jsxs5 } from "react/jsx-runtime";
 var stageBanner = {
   sheet: { width: 1.5, height: 8.5, segments: "auto" },
   stock: "vellum",
@@ -1589,7 +1568,7 @@ function PaperStageScene({
     const size = paperHeight * stage.source.spread;
     return { position: [x, size * 0.35, z6], yaw: Math.atan2(-tx, -tz), size };
   }, [path, stage.source.beyond, stage.source.spread, paperHeight]);
-  return /* @__PURE__ */ jsxs6(LightRig, { rig, children: [
+  return /* @__PURE__ */ jsxs5(LightRig, { rig, children: [
     /* @__PURE__ */ jsx7(ShotRig, { stage, paperHeight, walk: walk.walk }),
     /* @__PURE__ */ jsx7(
       PaperLighting,
@@ -1680,12 +1659,12 @@ function PaperStageScene({
         frozen: reducedMotion
       }
     ),
-    settings.grade && /* @__PURE__ */ jsx7(Grade, { grade: stage.grade, film: rig.film })
+    settings.grade && /* @__PURE__ */ jsx7(GradePass, { grade: stage.grade, film: rig.film })
   ] });
 }
 function PaperStage({ children, className, style, ...sceneProps }) {
   const dpr = qualityFor(sceneProps.quality ?? "auto").dpr;
-  return /* @__PURE__ */ jsx7("div", { className, style: { width: "100%", height: "100%", ...style }, children: /* @__PURE__ */ jsxs6(
+  return /* @__PURE__ */ jsx7("div", { className, style: { width: "100%", height: "100%", ...style }, children: /* @__PURE__ */ jsxs5(
     Canvas,
     {
       shadows: true,
@@ -2187,8 +2166,9 @@ function buildStageAgentPayload(input) {
    npm i paperlab three @react-three/fiber gsap @react-three/postprocessing postprocessing
 
    The last two are only needed by stage mode \u2014 <Paper> and <PaperField> do
-   not use them \u2014 but <PaperStage> imports the print pass (bloom, tone curve,
-   vignette, grain), so a stage will not build without them.
+   not use them \u2014 and they are optional even here: <PaperStage> loads the
+   print pass on demand, so a stage without them renders, just without the
+   tone curve, bloom, vignette and grain. Install them to get the grade.
 
 2. Create the component below as \`components/${name}.tsx\` (or the project's
    component convention). It is self-contained \u2014 it owns its own <Canvas>,