@make-pictures/kits 0.0.0-stage → 2.0.1

package/dist/motion-diagrams-2d/index.d.ts

@@ -0,0 +1,5 @@
+export * from './CameraRig';
+export * from './NodeBox';
+export * from './SystemNode';
+export * from './DataFlowEdge';
+export * from './CodePayloadToast';

package/dist/motion-diagrams-2d/index.mjs

@@ -0,0 +1,28 @@
+import {
+  CameraRig,
+  CodePayloadToast,
+  DataFlowEdge,
+  FlowCurve,
+  SystemNode,
+  WorldBox,
+  evaluateCameraState,
+  evaluateCubicBezier,
+  portBottom,
+  portLeft,
+  portRight,
+  portTop
+} from "../chunk-CW623YVB.mjs";
+export {
+  CameraRig,
+  CodePayloadToast,
+  DataFlowEdge,
+  FlowCurve,
+  SystemNode,
+  WorldBox,
+  evaluateCameraState,
+  evaluateCubicBezier,
+  portBottom,
+  portLeft,
+  portRight,
+  portTop
+};

package/dist/paper-diorama-3d/ImageCutout3D.d.ts

@@ -0,0 +1,47 @@
+import React from 'react';
+export interface ImageCutout3DProps {
+    /** Image URL (`staticFile(...)`, HTTP(S), or `data:` URI) */
+    src: string;
+    /** Optional cache key override (defaults to hashed `src`) */
+    cacheKey?: string;
+    /** World width in 3D units */
+    width: number;
+    /** World height in 3D units */
+    height: number;
+    /** Offscreen canvas pixel width (default 512) */
+    pixelWidth?: number;
+    /** Offscreen canvas pixel height (default 512) */
+    pixelHeight?: number;
+    /** Thickness of the cream-white Paper Mario die-cut border in pixels (default 14) */
+    whiteBorderPx?: number;
+    /** Safe margin around the image so the dilated die-cut border never clips at canvas edges */
+    paddingPx?: number;
+    /** How the image fits inside the padded cutout bounds (default 'contain') */
+    objectFit?: 'contain' | 'cover' | 'fill';
+    /** 3D position [x, y, z] */
+    position?: [number, number, number];
+    /** 3D rotation [rx, ry, rz] in radians */
+    rotation?: [number, number, number];
+    /** 3D scale (number or [sx, sy, sz]) */
+    scale?: number | [number, number, number];
+    /** Anchor point ('bottom' | 'center' | 'top', default 'bottom') */
+    anchor?: 'bottom' | 'center' | 'top';
+    /** Cardboard thickness in 3D units (default 0.038) */
+    thickness?: number;
+    /** Cast 3D silhouette shadow (default true) */
+    castShadow?: boolean;
+    /** Receive 3D shadow (default true) */
+    receiveShadow?: boolean;
+    /** Emissive color for glowing paper elements */
+    emissive?: string;
+    emissiveIntensity?: number;
+    /** Opacity (default 1) */
+    opacity?: number;
+}
+/**
+ * ImageCutout3D — Loads any transparent PNG/SVG/WebP/Data-URI image safely via
+ * Remotion `delayRender` / `continueRender` and passes it through `PaperCutout3D`,
+ * automatically generating the tactile cream-white dilated die-cut border,
+ * kraft cardboard edge, handmade fiber grain, and 3D silhouette shadow casting.
+ */
+export declare const ImageCutout3D: React.FC<ImageCutout3DProps>;

package/dist/paper-diorama-3d/PaperCutout3D.d.ts

@@ -0,0 +1,62 @@
+import React from 'react';
+export type PaperCutoutDep = string | number | boolean | null | undefined;
+export interface PaperCutout3DProps {
+    /** Base identifier for this cutout texture */
+    cacheKey: string;
+    /**
+     * Optional reactive values captured inside `draw` (e.g. colors, dynamic labels from PropsInspector)
+     * so live prop changes invalidate the cached CanvasTexture immediately in 0ms.
+     */
+    cacheDeps?: ReadonlyArray<PaperCutoutDep>;
+    /** Canvas width in pixels (default 512) */
+    pixelWidth?: number;
+    /** Canvas height in pixels (default 512) */
+    pixelHeight?: number;
+    /** World width in 3D units */
+    width: number;
+    /** World height in 3D units */
+    height: number;
+    /** Drawing callback in pixel coordinates (0..pixelWidth, 0..pixelHeight) */
+    draw: (ctx: CanvasRenderingContext2D, w: number, h: number) => void;
+    /** Thickness of the white Paper Mario die-cut border in pixels (default 14) */
+    whiteBorderPx?: number;
+    /** 3D position [x, y, z] */
+    position?: [number, number, number];
+    /** 3D rotation [rx, ry, rz] in radians */
+    rotation?: [number, number, number];
+    /** 3D scale (number or [sx, sy, sz]) */
+    scale?: number | [number, number, number];
+    /** Anchor point: 'bottom' puts y=0 at bottom edge (default for standing cutouts), 'center' puts (0,0) at center */
+    anchor?: 'bottom' | 'center' | 'top';
+    /** Cardboard thickness in 3D units (default 0.038) */
+    thickness?: number;
+    /** Cast 3D silhouette shadow (default true) */
+    castShadow?: boolean;
+    /** Receive 3D shadow (default true) */
+    receiveShadow?: boolean;
+    /** Emissive color for glowing paper elements (e.g. lasers, neon, golden ribbon) */
+    emissive?: string;
+    emissiveIntensity?: number;
+    /** Opacity (default 1) */
+    opacity?: number;
+}
+export declare function prunePaperTextureCache(maxEntries?: number): number;
+export declare function getPaperTextureCacheStats(): {
+    size: number;
+    activeCount: number;
+    maxEntries: number;
+};
+export declare function serializePaperCutoutDeps(cacheDeps?: ReadonlyArray<PaperCutoutDep>): string;
+export declare function buildPaperCutoutCompositeKey(cacheKey: string, pixelWidth: number, pixelHeight: number, whiteBorderPx: number, fontRevision: number, draw: (ctx: CanvasRenderingContext2D, w: number, h: number) => void, cacheDeps?: ReadonlyArray<PaperCutoutDep>): string;
+export declare const PaperCutout3D: React.FC<PaperCutout3DProps>;
+/**
+ * PopUpHinge3D — Folds any 3D paper diorama element up from flat on the book page
+ * (foldProgress: 0 = folded flat at -88 deg, 1 = standing upright at 0 deg)
+ */
+export declare const PopUpHinge3D: React.FC<{
+    foldProgress: number;
+    position?: [number, number, number];
+    rotationY?: number;
+    foldDirection?: 1 | -1;
+    children: React.ReactNode;
+}>;

package/dist/paper-diorama-3d/PaperPopUpBook3D.d.ts

@@ -0,0 +1,51 @@
+import React from 'react';
+import * as THREE from 'three';
+export type FloorTheme = 'mint-plains' | 'checkerboard-tile' | 'warm-parquet' | 'valley-terrace';
+export declare function getFloorTexture(theme: FloorTheme): THREE.CanvasTexture;
+export interface PaperBookPageTurn3DProps {
+    /** Progress (0..1) of an active page sheet transition from right (0) to left (1) */
+    pageTurnProgress: number;
+    /** Floor theme of the newly revealed spread */
+    nextFloorTheme: FloorTheme;
+    /** Spread width in 3D units (default 23.4) */
+    spreadWidth?: number;
+    /** Spread depth in 3D units (default 15.4) */
+    spreadDepth?: number;
+}
+/**
+ * PaperBookPageTurn3D — Flat-sliding 3D paper sheet transition across the Pop-Up Book stage.
+ */
+export declare const PaperBookPageTurn3D: React.FC<PaperBookPageTurn3DProps>;
+/**
+ * The 3D Hardcover Pop-Up Book Base & Active Spread Floor
+ */
+export declare const PopUpBookBase3D: React.FC<{
+    floorTheme: FloorTheme;
+    nextFloorTheme?: FloorTheme;
+    /** Progress (0..1) of an active page roll/turn from right (0) to left (1) */
+    pageTurnProgress?: number;
+}>;
+/**
+ * 3D Paper Cloud Cutout with Thick White Paper Border & Shadow Casting
+ */
+export declare const PaperCloudCutout3D: React.FC<{
+    position: [number, number, number];
+    scale?: number;
+    tint?: string;
+    idSuffix?: string;
+}>;
+/**
+ * 3D Paper Pine Tree Cutout (For multi-plane valley parallax & shadows)
+ */
+export declare const PaperPineTree3D: React.FC<{
+    position: [number, number, number];
+    scale?: number;
+    foldProgress?: number;
+}>;
+/**
+ * Multi-Plane 3D Paper Cutout Mountain Backdrop
+ */
+export declare const PaperMountainBackdrop3D: React.FC<{
+    position?: [number, number, number];
+    scale?: number;
+}>;

package/dist/paper-diorama-3d/PaperStageLighting3D.d.ts

@@ -0,0 +1,12 @@
+import React from 'react';
+export interface PaperCameraRig3DProps {
+    cameraPos: [number, number, number];
+    lookAt: [number, number, number];
+    fov?: number;
+}
+export declare const PaperCameraRig3D: React.FC<PaperCameraRig3DProps>;
+export interface PaperStageLighting3DProps {
+    preset?: 'daylight' | 'golden-hour' | 'indoor-study' | 'spotlight';
+    sunPosition?: [number, number, number];
+}
+export declare const PaperStageLighting3D: React.FC<PaperStageLighting3DProps>;