kt-forpro-tools 1.1.1 → 1.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "kt-forpro-tools",
-    "version": "1.1.1",
+    "version": "1.1.3",
     "description": "",
     "author": "Miguel de Mendoza",
     "main": "src/index.ts",

package/src/slides.ts

@@ -3,6 +3,8 @@ import { KT_Layers } from "kt-ae-tools-layers";
 import { KT_AeIs as is } from "kt-ae-is-checkers";
 import { IO } from "kt-io";
 
+const BACKGROUND_LABEL = 13;
+
 const colorSelector = () => {
     let lastColorIndex = -1;
     const numColors = 16;
@@ -10,6 +12,9 @@ const colorSelector = () => {
 
     // ✅ Pre-generar pool de colores disponibles
     for (let i = 0; i < numColors; i++) {
+        if (i === BACKGROUND_LABEL) {
+            continue;
+        }
         colorPool.push(i);
     }
 
@@ -33,6 +38,7 @@ export type KT_SlidesOptions = {
     comp?: CompItem;
     slideMultiplier?: number;
     slideDistance?: number;
+    lazyInit?: boolean;
 };
 
 class KT_Slides {
@@ -43,7 +49,7 @@ class KT_Slides {
     backgroundComp!: CompItem;
     compedSlidesFolder!: FolderItem;
     duration: number = 30;
-    masterComp: CompItem;
+    masterComp!: CompItem;
     slidesFootage: FootageItem[] = [];
     width: number = 1920;
     height: number = 1080;
@@ -55,6 +61,8 @@ class KT_Slides {
     slideMultiplier: number = 1;
     backgroundColor: [number, number, number] = [1, 1, 1];
     backgroundPivotPrefix: string = "_BG_";
+    private initialized: boolean = false;
+    private initialComp?: CompItem;
     private getNextColor = colorSelector();
 
     constructor(options: KT_SlidesOptions = {}) {
@@ -68,6 +76,7 @@ class KT_Slides {
             comp,
             slideMultiplier,
             slideDistance,
+            lazyInit = true,
         } = options;
         this.name = name || this.name;
         this.duration = duration || this.duration;
@@ -77,14 +86,27 @@ class KT_Slides {
         this.inDuration = inDuration || this.inDuration;
         this.slideMultiplier = slideMultiplier || this.slideMultiplier;
         this.slideDistance = slideDistance || this.slideDistance;
+
+        this.initialComp = comp;
+        if (lazyInit === false) {
+            this.ensureInitialized();
+        }
+    }
+
+    private ensureInitialized = () => {
+        if (this.initialized) {
+            return;
+        }
+
         this.initFolders();
         const compExists = KT_Project.find.comps({ name: this.name + " Master" });
         if (compExists && compExists.length > 0) {
             this.masterComp = compExists[0] as CompItem;
+            this.initialized = true;
             return;
         }
         this.masterComp =
-            comp ||
+            this.initialComp ||
             (KT_Project.add.comp({
                 name: this.name + " Master",
                 width: this.width,
@@ -92,7 +114,8 @@ class KT_Slides {
                 duration: this.duration,
                 parentFolder: this.rootFolder,
             }) as CompItem);
-    }
+        this.initialized = true;
+    };
 
     initFolders = (options: KT_SlidesOptions = {}): void => {
         const rootFolder = KT_Project.find.folders({ name: this.name + " Project" });
@@ -170,10 +193,6 @@ class KT_Slides {
     };
 
     import = (slideMultiplier?: number) => {
-        if (!this.masterComp) {
-            $.writeln("Master comp not found");
-            return;
-        }
         this.slideMultiplier = slideMultiplier || this.slideMultiplier;
         const path = IO.fs.openFolderDialog("Select Slides Folder");
         if (!path) {
@@ -181,6 +200,13 @@ class KT_Slides {
             return;
         }
 
+        this.ensureInitialized();
+
+        if (!this.masterComp) {
+            $.writeln("Master comp not found");
+            return;
+        }
+
         let footage = KT_Project.import.images({
             path: path.fsName,
             footageFolder: this.footageFolder,
@@ -217,6 +243,7 @@ class KT_Slides {
                     this.inDuration * 2,
                     this.masterComp,
                     (index * this.slideMultiplier + i) * this.inDuration * 2,
+                    i !== 0,
                 );
                 this.enableTimeRemap(layer as AVLayer);
                 layer.outPoint = this.masterComp.duration;
@@ -233,7 +260,7 @@ class KT_Slides {
             bgPivot.name = this.backgroundPivotPrefix + item.name.split("-")[0];
             bgPivot.startTime = groupStartTime;
             bgPivot.outPoint = this.masterComp.duration;
-            bgPivot.label = randomColorIndex;
+            bgPivot.label = BACKGROUND_LABEL;
             this.enableTimeRemap(bgPivot as AVLayer);
             if (lowerGroupLayer) {
                 bgPivot.moveAfter(lowerGroupLayer);
@@ -304,7 +331,7 @@ class KT_Slides {
             bgPivot.name = this.backgroundPivotPrefix + firstLayer.name.split("-")[0];
             bgPivot.startTime = firstLayer.startTime;
             bgPivot.outPoint = this.masterComp.duration;
-            bgPivot.label = firstLayer.label;
+            bgPivot.label = BACKGROUND_LABEL;
             this.enableTimeRemap(bgPivot as AVLayer);
             bgPivot.moveAfter(lowerGroupLayer);
             addedPivots += 1;
@@ -473,13 +500,16 @@ class KT_Slides {
         duration: number,
         comp: CompItem = app.project.activeItem as CompItem,
         startTime?: number,
+        animate: boolean = true,
     ) {
         const layer = comp.layers.add(source);
         layer.startTime = 0;
         layer.outPoint = duration;
         this.fitLayerToComp(layer, comp);
-        this.slideUp(layer);
-        this.disolveIn(layer);
+        if (animate) {
+            this.slideUp(layer);
+            this.disolveIn(layer);
+        }
         layer.startTime = startTime || 0;
         return layer;
     }
@@ -541,11 +571,11 @@ class KT_Slides {
         const currentScale = layer.scale.value as number[];
         const newScale: number[] = [scalePercent, scalePercent];
         if (currentScale.length > 2) newScale.push(currentScale[2]);
-        layer.scale.setValue(newScale);
+        layer.scale.setValue(newScale as any);
         const center: number[] = [comp.width / 2, comp.height / 2];
         const currentPos = layer.position.value as number[];
         if (currentPos.length > 2) center.push(currentPos[2]);
-        layer.position.setValue(center);
+        layer.position.setValue(center as any);
         return layer;
     };
 
@@ -568,27 +598,42 @@ export { KT_Slides };
 class __KT_SlidesAPI {
     private slidesInstance: KT_Slides | null = null;
     static import = (options: KT_SlidesOptions = {}) => {
-        const slides = new KT_Slides(options);
+        const slides = new KT_Slides({
+            ...options,
+            lazyInit: true,
+        });
         slides.import(options.slideMultiplier);
         return slides;
     };
 
     static refreshAll = (options: KT_SlidesOptions) => {
-        const slidesInstance = new KT_Slides(options);
+        const slidesInstance = new KT_Slides({
+            ...options,
+            lazyInit: false,
+        });
         slidesInstance.batchSplitSlides();
     };
 
     static refreshSelected = (options: KT_SlidesOptions) => {
-        const slidesInstance = new KT_Slides(options);
+        const slidesInstance = new KT_Slides({
+            ...options,
+            lazyInit: false,
+        });
         slidesInstance.splitSlides();
     };
     static cleanUp = (options: KT_SlidesOptions) => {
-        const slidesInstance = new KT_Slides(options);
+        const slidesInstance = new KT_Slides({
+            ...options,
+            lazyInit: false,
+        });
         slidesInstance.cleanUp();
     };
 
     static migrate = (options: KT_SlidesOptions) => {
-        const slidesInstance = new KT_Slides(options);
+        const slidesInstance = new KT_Slides({
+            ...options,
+            lazyInit: false,
+        });
         return slidesInstance.migrateBackgroundPivots();
     };
 }

package/src/tests/index.test.ts

@@ -10,9 +10,9 @@ import {
 } from "kt-testing-suite-core";
 import { KT_Slides, KT_ForproTools, KT_SlidesFreeze } from "../index";
 // import "./freezer.test";
-// import "./slides.test";
+import "./slides.test";
 // import "./batchSplitSlides.test";
-import "./splitSlides.test";
+// import "./splitSlides.test";
 
 // describe("KtForproTools Tests", () => {
 //     it("should import the slides module", () => {