@framefields/node-compositor 0.0.0-stage → 2.0.3

package/dist/index.d.mts

@@ -0,0 +1,230 @@
+import { a as Point3D, c as Transform3DPropsLike, i as Point2D, l as has3DTransform, n as Layer3DMatrixConfig, o as Quad2D, r as Matrix4x4, s as Transform3DMath, u as solveHomography } from "./index-B0ir9Z7o.mjs";
+import * as _framefields_compositions_program0 from "@framefields/compositions/program";
+import { AnimationTrack, CompositorProgramConfig, EaseRef, LayerAnimationSpec } from "@framefields/compositions/program";
+import * as _framefields_core0 from "@framefields/core";
+import { VirtualMediaData } from "@framefields/core";
+import { z } from "zod";
+
+//#region src/shared/compiler.d.ts
+interface LayerStub {
+  id: string;
+  inputHandleId: string;
+  trackId?: string;
+  x: number;
+  y: number;
+  scale: number;
+  rotation: number;
+  opacity: number;
+  volume: number;
+  width?: number;
+  height?: number;
+  hidden: boolean;
+  muted: boolean;
+  text?: number;
+  fontSize?: number;
+  fill?: string;
+  borderColor?: string;
+  backgroundColor?: string;
+  rotateX?: number;
+  rotateY?: number;
+  rotateZ?: number;
+  perspective?: number;
+  perspectiveOriginX?: number;
+  perspectiveOriginY?: number;
+  translateZ?: number;
+  backfaceVisibility?: "visible" | "hidden";
+  transformStyle?: "flat" | "preserve-3d";
+  is3D?: boolean;
+  z?: number;
+  scaleZ?: number;
+  twoSided?: boolean;
+  material?: "lit" | "unlit" | "toon";
+  shininess?: number;
+  roughness?: number;
+  specularIntensity?: number;
+  ambientIntensity?: number;
+  metallic?: number;
+  cameraX?: number;
+  cameraY?: number;
+  cameraZ?: number;
+  targetX?: number;
+  targetY?: number;
+  targetZ?: number;
+  cameraPitch?: number;
+  cameraYaw?: number;
+  cameraRoll?: number;
+  cameraFov?: number;
+  cameraZoom?: number;
+  focalLength?: number;
+  focusDistance?: number;
+  fStop?: number;
+  maxBlurRadius?: number;
+  shakeTranslation?: number;
+  shakeRotation?: number;
+  orbitRadius?: number;
+  orbitAzimuth?: number;
+  orbitElevation?: number;
+  animationProgress?: number;
+  animationTime?: number;
+  animationSpeed?: number;
+  wireframe?: boolean;
+  scaleX?: number;
+  scaleY?: number;
+  lightType?: string;
+  intensity?: number;
+  radius?: number;
+  angle?: number;
+  penumbra?: number;
+  decay?: number;
+  [key: string]: unknown;
+}
+type CompilerVirtualMedia = {
+  metadata?: Partial<VirtualMediaData["metadata"]>;
+  operation?: Partial<VirtualMediaData["operation"]> & Record<string, any>;
+  children?: CompilerNodeVM[];
+};
+/** A node op inside the render tree (CompositorLayer). */
+type CompilerNodeVM = CompilerVirtualMedia;
+interface CompileResult {
+  tl: gsap.core.Timeline;
+  targetsById: Record<string, LayerStub>;
+  /** Node ops the timeline was compiled from (tree order). */
+  nodes: CompilerNodeVM[];
+}
+declare function getCachedTimeline(cacheKey: string): CompileResult | undefined;
+declare function setCachedTimeline(cacheKey: string, value: CompileResult): void;
+declare function mappedEase(ease?: EaseRef, durationFrames?: number, fps?: number): string | ((p: number) => number);
+interface TruncationInfo {
+  layerId: string;
+  trackId: string;
+  prop: string;
+  dropped: number;
+  maxAuthoredFrame: number;
+}
+declare function compileTimeline(renderId: string, virtualMedia: CompilerVirtualMedia | null | undefined, options: {
+  fps: number;
+  durationSec: number;
+}): CompileResult;
+declare function compileLayerTimeline(layerId: string, animation: LayerAnimationSpec | undefined, baseVolume: number, baseMuted: boolean, fps: number): {
+  tl: gsap.core.Timeline;
+  stub: {
+    volume: number;
+    muted: boolean;
+  };
+};
+//#endregion
+//#region src/shared/config.d.ts
+/**
+ * v2 config — THE document (spec: SKILL.md).
+ * No `layers`, no `layerUpdates`, no aliases. The node config IS the
+ * composition program: strict zod, validated by the E-code pre-parse scan
+ * in `@framefields/compositions/program/validate`.
+ */
+declare const CompositorNodeConfigSchema: z.ZodObject<{
+  width: z.ZodNumber;
+  height: z.ZodNumber;
+  backgroundColor: z.ZodOptional<z.ZodString>;
+  volume: z.ZodDefault<z.ZodNumber>;
+  fps: z.ZodDefault<z.ZodNumber>;
+  mode: z.ZodDefault<z.ZodEnum<{
+    Image: "Image";
+    Video: "Video";
+  }>>;
+  antialias3d: z.ZodOptional<z.ZodBoolean>;
+  layout: z.ZodDefault<z.ZodArray<z.ZodType<_framefields_compositions_program0.LayoutNode, unknown, z.core.$ZodTypeInternals<_framefields_compositions_program0.LayoutNode, unknown>>>>;
+  fonts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  signals: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  effects: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+  vision: z.ZodOptional<z.ZodUnknown>;
+  onRequestFrame: z.ZodOptional<z.ZodCustom<unknown, unknown>>;
+}, z.core.$strict>;
+type CompositorNodeConfig = CompositorProgramConfig;
+/** Data types accepted by the variable composer inputs. */
+declare const VariableInputDataTypes: readonly ["Text", "Image", "Video", "Audio", "Caption", "SVG", "GIF", "Lottie", "Signal"];
+type VariableInputDataType = (typeof VariableInputDataTypes)[number];
+/** The Compositor op framing (used in the render tree, per processCompositor). */
+declare const CompositorOperationSchema: z.ZodObject<{
+  width: z.ZodNumber;
+  height: z.ZodNumber;
+  backgroundColor: z.ZodOptional<z.ZodString>;
+  volume: z.ZodDefault<z.ZodNumber>;
+  fps: z.ZodDefault<z.ZodNumber>;
+  mode: z.ZodDefault<z.ZodEnum<{
+    Image: "Image";
+    Video: "Video";
+  }>>;
+  antialias3d: z.ZodOptional<z.ZodBoolean>;
+  layout: z.ZodDefault<z.ZodArray<z.ZodType<_framefields_compositions_program0.LayoutNode, unknown, z.core.$ZodTypeInternals<_framefields_compositions_program0.LayoutNode, unknown>>>>;
+  fonts: z.ZodOptional<z.ZodArray<z.ZodString>>;
+  signals: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+  effects: z.ZodOptional<z.ZodArray<z.ZodUnknown>>;
+  vision: z.ZodOptional<z.ZodUnknown>;
+  onRequestFrame: z.ZodOptional<z.ZodCustom<unknown, unknown>>;
+  op: z.ZodLiteral<"Compositor">;
+  dataType: z.ZodOptional<z.ZodEnum<{
+    Image: "Image";
+    Video: "Video";
+  }>>;
+  metadata: z.ZodOptional<z.ZodObject<{
+    width: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    height: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    fps: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    durationMs: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    sampleRate: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    channels: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    bitDepth: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+    audioCodec: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    audioBitrate: z.ZodNullable<z.ZodOptional<z.ZodNumber>>;
+  }, z.core.$strip>>;
+}, z.core.$strict>;
+type CompositorOperation = z.infer<typeof CompositorOperationSchema>;
+declare const CompositorResultSchema: z.ZodUnion<readonly [z.ZodObject<{
+  selectedOutputIndex: z.ZodLiteral<0>;
+  outputs: z.ZodTuple<[z.ZodObject<{
+    items: z.ZodTuple<[z.ZodType<_framefields_core0.OutputItem<"Video">, unknown, z.core.$ZodTypeInternals<_framefields_core0.OutputItem<"Video">, unknown>>], null>;
+  }, z.core.$strip>], null>;
+}, z.core.$strip>, z.ZodObject<{
+  selectedOutputIndex: z.ZodLiteral<0>;
+  outputs: z.ZodTuple<[z.ZodObject<{
+    items: z.ZodTuple<[z.ZodType<_framefields_core0.OutputItem<"Image">, unknown, z.core.$ZodTypeInternals<_framefields_core0.OutputItem<"Image">, unknown>>], null>;
+  }, z.core.$strip>], null>;
+}, z.core.$strip>]>;
+//#endregion
+//#region src/shared/presets.d.ts
+interface LayerBase {
+  x: number;
+  y: number;
+  scale: number;
+  rotation: number;
+  opacity: number;
+  width?: number;
+  height?: number;
+  durationFrames: number;
+}
+interface PresetChip {
+  groupId: string;
+  presetType: string;
+  kind: "entrance" | "exit" | "emphasis";
+  label: string;
+  durationFrames: number;
+  ease?: EaseRef;
+}
+declare function getPresetDetails(presetType: string): {
+  kind: "entrance" | "exit" | "emphasis";
+  label: string;
+};
+declare function chipsForLayer(layer: {
+  animation?: {
+    tracks?: AnimationTrack[];
+  };
+} | null | undefined): PresetChip[];
+declare function materializePreset(layerBase: LayerBase, presetType: string, options: {
+  width: number;
+  height: number;
+  fps: number;
+  presetGroupId?: string;
+  durationFrames?: number;
+}): AnimationTrack[];
+//#endregion
+export { CompileResult, CompilerNodeVM, CompilerVirtualMedia, CompositorNodeConfig, CompositorNodeConfigSchema, CompositorOperation, CompositorOperationSchema, CompositorResultSchema, Layer3DMatrixConfig, LayerBase, LayerStub, Matrix4x4, Point2D, Point3D, PresetChip, Quad2D, Transform3DMath, Transform3DPropsLike, TruncationInfo, VariableInputDataType, VariableInputDataTypes, chipsForLayer, compileLayerTimeline, compileTimeline, getCachedTimeline, getPresetDetails, has3DTransform, mappedEase, materializePreset, setCachedTimeline, solveHomography };
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/shared/compiler.ts","../src/shared/config.ts","../src/shared/presets.ts"],"sourcesContent":[],"mappings":";;;;;;;;UAqBiB,SAAA;;;;;;EAAA,KAAA,EAAA,MAAS;EA8Ed,QAAA,EAAA,MAAA;EACQ,OAAA,EAAA,MAAA;EAAR,MAAA,EAAA,MAAA;EACS,KAAA,CAAA,EAAA,MAAA;EAAR,MAAA,CAAA,EAAA,MAAA;EAAyC,MAAA,EAAA,OAAA;EAC1C,KAAA,EAAA,OAAA;EAAc,IAAA,CAAA,EAAA,MAAA;EAId,QAAA,CAAA,EAAA,MAAc;EAET,IAAA,CAAA,EAAA,MAAA;EACZ,WAAU,CAAA,EAAA,MAAA;EACc,eAAA,CAAA,EAAA,MAAA;EAAf,OAAA,CAAA,EAAA,MAAA;EAEN,OAAA,CAAA,EAAA,MAAA;EAAc,OAAA,CAAA,EAAA,MAAA;EA2HN,WAAA,CAAA,EAAA,MAAiB;EAgBjB,kBAAA,CAAA,EAAiB,MAAA;EAKjB,kBAAU,CAAA,EAAA,MAClB;EAiRS,UAAA,CAAA,EAAA,MAAc;EAqIf,kBAAe,CAAA,EAAA,SAEhB,GAAA,QAAA;EA4RC,cAAA,CAAA,EAAA,MAAoB,GAAA,aAExB;;;;ECz6BC,QAAA,CAAA,EAAA,OAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAA0B,SAAA,CAAA,EAAA,MAAA;EAAA,MAAA,CAAA,EAAA,MAAA;EAC3B,KAAA,CAAA,EAAA,MAAA;EAGC,QAAA,CAAA,EAAA,MAAA;EAWD,KAAA,CAAA,EAAA,MAAA;EAGC,CAAA,GAAA,EAAA,MAAA,CAAA,EAAA,OAAA;;KDmED,oBAAA;aACA,QAAQ;cACP,QAAQ,iCAAiC;aAC1C;;;KAIA,cAAA,GAAiB;UAEZ,aAAA;MACZ,IAAA,CAAK,IAAA,CAAK;eACD,eAAe;;SAErB;;iBA2HQ,iBAAA,oBAAqC;iBAgBrC,iBAAA,0BAA2C;iBAK3C,UAAA,QACR;UAiRS,cAAA;;;;;;;iBAqID,eAAA,iCAED;;;IAEZ;iBA0Ra,oBAAA,6BAEJ;MAIH,IAAA,CAAK,IAAA,CAAK;;;;;;;;;;;;;;AAt6BF,cCPJ,0BDOa,ECPa,CAAA,CAAA,SDOb,CAAA;EA8Ed,KAAA,aAAA;EACQ,MAAA,aAAA;EAAR,eAAA,eAAA,YAAA,CAAA;EACS,MAAA,cAAA,YAAA,CAAA;EAAR,GAAA,cAAA,YAAA,CAAA;EAAyC,IAAA,cAAA,UAAA,CAAA;IAC1C,KAAA,EAAA,OAAA;IAAc,KAAA,EAAA,OAAA;EAId,CAAA,CAAA,CAAA;EAEK,WAAA,eAAa,aAAA,CAAA;EACzB,MAAK,cAAK,WAAA,UAAA,gDAAA,OAAA,0BAAA,gDAAA,OAAA,CAAA,CAAA,CAAA,CAAA;EACc,KAAA,eAAA,WAAA,YAAA,CAAA,CAAA;EAAf,OAAA,eAAA,YAAA,YAAA,cAAA,CAAA,CAAA;EAEN,OAAA,eAAA,WAAA,aAAA,CAAA,CAAA;EAAc,MAAA,eAAA,aAAA,CAAA;EA2HN,cAAA,eAAiB,YAAoB,CAAA,OAAa,EAAA,OAAA,CAAA,CAAA;AAgBlE,CAAA,gBAAgB,CAAA;AAKA,KCjPJ,oBAAA,GAAuB,uBDkPpB;AAiRf;AAqIgB,cCroBH,sBDuoBE,EAAA,SAAA,CAAA,MAEZ,EAAA,OAAa,EAAA,OAAA,EAAA,OAAA,EAAA,SAAA,EAAA,KAAA,EAAA,KAAA,EAAA,QAAA,EAAA,QAAA,CAAA;AA0RA,KCx5BJ,qBAAA,GDw5BwB,CAAA,OCx5BQ,sBD85B9B,CAAA,CAAA,MAAK,CAAA;;cC35BN,2BAAyB,CAAA,CAAA;;EAlBzB,MAAA,aAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAwBD,mBAAA,GAAsB,CAAA,CAAE,aAAa;cAEpC,wBAAsB,CAAA,CAAA,mBAAA,CAAA,CAAA;EA1BI,mBAAA,cAAA,CAAA,CAAA,CAAA;EAAA,OAAA,YAAA,CAAA,YAAA,CAAA;IAC3B,KAAA,YAAA,CAAA,UAAoB,8BAA0B,CAAA,OAAA,CAAA,EAAA,OAAA,0BAAA,8BAAA,CAAA,OAAA,CAAA,EAAA,OAAA,CAAA,CAAA,CAAA,EAAA,IAAA,CAAA;EAG7C,CAAA,eAAA,CAAA,CAAA,EAAA,IAAA,CAUH;AACV,CAAA,eAAY,CAAA,aAAqB,CAAA;EAGpB,mBAAA,cAIF,CAAA,CAAA,CAAA;;;;;;;UC7BM,SAAA;;;;;;;EFcA,MAAA,CAAA,EAAA,MAAS;EA8Ed,cAAA,EAAA,MAAA;;AACA,UElFK,UAAA,CFkFL;EACS,OAAA,EAAA,MAAA;EAAR,UAAA,EAAA,MAAA;EAAyC,IAAA,EAAA,UAAA,GAAA,MAAA,GAAA,UAAA;EAC1C,KAAA,EAAA,MAAA;EAAc,cAAA,EAAA,MAAA;EAId,IAAA,CAAA,EElFJ,OFkFI;AAEZ;AACU,iBE9EM,gBAAA,CF8ED,UAAA,EAAA,MAAA,CAAA,EAAA;EACc,IAAA,EAAA,UAAA,GAAA,MAAA,GAAA,UAAA;EAAf,KAAA,EAAA,MAAA;CAEN;AAAc,iBEjBN,aAAA,CFiBM,KAAA,EAAA;EA2HN,SAAA,CAAA,EAAA;IAgBA,MAAA,CAAA,EEzJW,cFyJM,EAAA;EAKjB,CAAA;AAkRhB,CAAA,GAAiB,IAAA,GAAA,SAAA,CAAc,EE5a5B,UF4a4B,EAAA;AAqIf,iBE3fA,iBAAA,CF6fD,SAAA,EE5fH,SF8fT,EAAA,UAAa,EAAA,MAAA,EAAA,OAAA,EAAA;EA0RA,KAAA,EAAA,MAAA;;;;ECv6BH,cAAA,CAAA,EAAA,MAAA;ICwJV"}