visualfries 0.1.10120 → 0.3.2

package/dist/schemas/scene/core.d.ts

@@ -1347,6 +1347,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -2494,6 +2500,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -3648,6 +3660,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -4800,6 +4818,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -6022,6 +6046,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -7184,6 +7214,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -8237,6 +8273,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -9289,6 +9331,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -10463,6 +10511,12 @@ export declare const SceneLayerShape: z.ZodObject<{
                     lowercase: "lowercase";
                     capitalize: "capitalize";
                 }>>;
+                padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                    top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                }, z.core.$strip>]>>;
                 shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                     enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                     preset: z.ZodOptional<z.ZodString>;
@@ -10698,13 +10752,9 @@ export declare const SceneTransitionShape: z.ZodObject<{
  * Schema for the main scene structure in v2.0
  */
 export declare const SceneShape: z.ZodObject<{
-    /** Unique identifier for the scene */
     id: z.ZodString;
-    /** Schema version */
     version: z.ZodOptional<z.ZodCoercedString<unknown>>;
-    /** Optional name for the scene */
     name: z.ZodOptional<z.ZodString>;
-    /** Scene settings */
     settings: z.ZodObject<{
         width: z.ZodNumber;
         height: z.ZodNumber;
@@ -10816,7 +10866,6 @@ export declare const SceneShape: z.ZodObject<{
             }, z.core.$strip>]>>>>>;
         }, z.core.$strip>>;
     }, z.core.$strip>;
-    /** Assets registry */
     assets: z.ZodPrefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         type: z.ZodEnum<{
@@ -10902,7 +10951,6 @@ export declare const SceneShape: z.ZodObject<{
             }, z.core.$strip>>>;
         }, z.core.$strip>>>;
     }, z.core.$strip>>>;
-    /** Layers in the scene */
     layers: z.ZodPrefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -11891,6 +11939,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -13038,6 +13092,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -14192,6 +14252,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -15344,6 +15410,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -16566,6 +16638,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -17728,6 +17806,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -18781,6 +18865,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -19833,6 +19923,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -21007,6 +21103,12 @@ export declare const SceneShape: z.ZodObject<{
                         lowercase: "lowercase";
                         capitalize: "capitalize";
                     }>>;
+                    padding: z.ZodOptional<z.ZodUnion<readonly [z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>, z.ZodObject<{
+                        top: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        right: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        bottom: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                        left: z.ZodPipe<z.ZodTransform<unknown, unknown>, z.ZodCoercedNumber<unknown>>;
+                    }, z.core.$strip>]>>;
                     shadow: z.ZodOptional<z.ZodNullable<z.ZodObject<{
                         enabled: z.ZodOptional<z.ZodPrefault<z.ZodBoolean>>;
                         preset: z.ZodOptional<z.ZodString>;
@@ -21213,7 +21315,6 @@ export declare const SceneShape: z.ZodObject<{
             }, z.core.$strip>;
         }, z.core.$strict>], "type">>>;
     }, z.core.$strip>>>;
-    /** Scene transitions */
     transitions: z.ZodPrefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -21224,7 +21325,6 @@ export declare const SceneShape: z.ZodObject<{
         duration: z.ZodPipe<z.ZodNumber, z.ZodTransform<number, number>>;
         parameters: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
     }, z.core.$strip>>>;
-    /** Audio tracks */
     audioTracks: z.ZodPrefault<z.ZodArray<z.ZodObject<{
         id: z.ZodString;
         name: z.ZodOptional<z.ZodString>;
@@ -21234,9 +21334,8 @@ export declare const SceneShape: z.ZodObject<{
         endAt: z.ZodPipe<z.ZodOptional<z.ZodNumber>, z.ZodTransform<number | undefined, number | undefined>>;
         muted: z.ZodPrefault<z.ZodBoolean>;
     }, z.core.$strip>>>;
-    /** Optional checksum */
     checksum: z.ZodOptional<z.ZodString>;
-}, z.core.$strict>;
+}, z.core.$strip>;
 export type SceneAssetMetadata = z.infer<typeof SceneAssetMetadataShape>;
 export type SceneAsset = z.infer<typeof SceneAssetShape>;
 export type SceneSettings = z.infer<typeof SceneSettingsShape>;

package/dist/schemas/scene/core.js

@@ -140,7 +140,7 @@ export const SceneTransitionShape = z.object({
 /**
  * Schema for the main scene structure in v2.0
  */
-export const SceneShape = z.strictObject({
+export const SceneShape = z.object({
     /** Unique identifier for the scene */
     id: z.string(),
     /** Schema version */

package/dist/utils/mediaWindow.d.ts

@@ -0,0 +1,13 @@
+import type { ComponentData } from '..';
+export declare const DEFAULT_MEDIA_PREROLL_SECONDS = 0.75;
+export declare const STREAMING_MEDIA_PREROLL_SECONDS = 2;
+export declare const DEFAULT_MEDIA_POSTROLL_SECONDS = 0.25;
+type MediaWindowComponent = Pick<ComponentData, 'type' | 'visible' | 'timeline'> & {
+    source?: {
+        url?: string | null;
+    };
+};
+export declare function isMediaWindowComponent(data: MediaWindowComponent | undefined): data is MediaWindowComponent;
+export declare function getMediaPrerollSeconds(data: MediaWindowComponent | undefined): number;
+export declare function shouldPrepareMediaAtTime(data: MediaWindowComponent | undefined, currentTime: number): boolean;
+export {};

package/dist/utils/mediaWindow.js

@@ -0,0 +1,25 @@
+export const DEFAULT_MEDIA_PREROLL_SECONDS = 0.75;
+export const STREAMING_MEDIA_PREROLL_SECONDS = 2;
+export const DEFAULT_MEDIA_POSTROLL_SECONDS = 0.25;
+export function isMediaWindowComponent(data) {
+    return data?.type === 'VIDEO' || data?.type === 'AUDIO';
+}
+export function getMediaPrerollSeconds(data) {
+    if (!isMediaWindowComponent(data)) {
+        return 0;
+    }
+    const url = data.source?.url ?? '';
+    return /\.m3u8(?:$|[?#])/i.test(url)
+        ? STREAMING_MEDIA_PREROLL_SECONDS
+        : DEFAULT_MEDIA_PREROLL_SECONDS;
+}
+export function shouldPrepareMediaAtTime(data, currentTime) {
+    if (!isMediaWindowComponent(data) || data.visible === false) {
+        return false;
+    }
+    const startAt = data.timeline.startAt ?? 0;
+    const endAt = data.timeline.endAt ?? startAt;
+    const prerollSeconds = getMediaPrerollSeconds(data);
+    return (currentTime >= startAt - prerollSeconds &&
+        currentTime <= endAt + DEFAULT_MEDIA_POSTROLL_SECONDS);
+}

package/dist/utils/svgGenerator.js

@@ -26,7 +26,7 @@ export class SVGGenerator {
         const isEmoji = /^(\p{Emoji_Presentation}|\p{Emoji}\uFE0F|\p{Emoji_Modifier_Base}\p{Emoji_Modifier}?|\s)+$/u.test(el.textContent || '');
         const getFontText = isEmoji ? 'a' : fontText || el.textContent;
         let fontData = null;
-        if (fontFamily && !isEmoji) {
+        if (fontFamily && !isEmoji && config.fontSource?.source === 'google') {
             const cacheKey = `${fontFamily + weightAppend}_${getFontText}`;
             if (cacheKey in this.fontDataBase64Cache) {
                 fontData = this.fontDataBase64Cache[cacheKey];

package/dist/utils/timelineWindow.d.ts

@@ -0,0 +1,2 @@
+export declare const TIMELINE_BOUNDARY_EPSILON = 1e-7;
+export declare function isTimeWithinTimeline(currentTime: number, startAt: number, endAt: number, epsilon?: number): boolean;

package/dist/utils/timelineWindow.js

@@ -0,0 +1,7 @@
+export const TIMELINE_BOUNDARY_EPSILON = 1e-7;
+export function isTimeWithinTimeline(currentTime, startAt, endAt, epsilon = TIMELINE_BOUNDARY_EPSILON) {
+    if (endAt - startAt <= epsilon) {
+        return currentTime >= startAt - epsilon && currentTime <= endAt + epsilon;
+    }
+    return currentTime >= startAt - epsilon && currentTime < endAt - epsilon;
+}

package/dist/utils/utils.js

@@ -41,9 +41,7 @@ export const buildCharactersListFromComponentsAndSubtitles = function (layers, s
             const c = component;
             const text = c.text;
             if (text) {
-                // Use Array.from to properly handle multi-codepoint characters (emojis, etc.)
-                // This prevents splitting emojis into unpaired surrogates
-                const textList = Array.from(text);
+                const textList = text.split('');
                 const missingChars = textList.filter((char) => {
                     // Check if the character is not whitespace, not in the characters list,
                     // is a Unicode letter or number, and is NOT an emoji
@@ -108,7 +106,7 @@ export const setPlacementAndOpacity = function (obj, c) {
     obj.y = config.y;
     obj.width = config.width;
     obj.height = config.height;
-    obj.alpha = config.opacity || 1;
+    obj.alpha = config.opacity ?? 1;
     if (config.rotation) {
         obj.angle = config.rotation;
     }

package/docs/AGENT_PATTERNS.md

@@ -0,0 +1,243 @@
+# VisualFries Agent Patterns
+
+Reusable building blocks for agents that need short-form videos without writing raw scene JSON from scratch.
+
+## New Agent Package
+
+Use when starting a self-contained work folder:
+
+```bash
+visualfries init ./video-package \
+  --video ./input.mp4 \
+  --transcript ./transcript.srt \
+  --preset hidden-engine-center \
+  --cue-preset hidden-engine-dynamic
+```
+
+Generated structure:
+
+```text
+video-package/
+  scene.json
+  cues.json
+  assets/
+  qa/
+    inspect.json
+    frames/
+  notes.md
+  transcript.example.json
+```
+
+`cues.json` is generated from the selected cue preset and should be treated as the visual timeline map for the video.
+
+## Captioned Video
+
+Use when the base asset already contains the main story or voiceover.
+
+Fastest preview path:
+
+```bash
+visualfries compose \
+  --video ./input.mp4 \
+  --transcript ./transcript.srt \
+  --cue-preset hidden-engine-dynamic \
+  --cues ./cues.json \
+  --scene-output ./scene.json \
+  --qa-output ./qa/frames \
+  --render-mode preview \
+  --output ./out.mp4
+```
+
+Use `compose` for routine agent previews. Use the step-by-step commands when debugging a scene. Final output for scenes with `VIDEO` or `GIF` components uses the local deterministic renderer path, which predecodes media into exact frame images before the browser compositor sees the scene. Browser media rendering is intentionally treated as preview-only.
+
+```bash
+visualfries caption-scene \
+  --video ./input.mp4 \
+  --transcript ./transcript.srt \
+  --preset hidden-engine-center \
+  --output ./scene.json
+```
+
+`--transcript` accepts JSON, SRT, or VTT. Prefer SRT/VTT when the agent already has timed subtitles from another tool.
+
+Then QA:
+
+```bash
+visualfries inspect ./scene.json --screenshots --samples 3 --output ./qa/frames --json
+```
+
+## Cue File Application
+
+Use when an agent has a timeline map and should not write custom JavaScript.
+
+```bash
+visualfries preset-cues --duration 45 \
+  --preset hidden-engine-dynamic \
+  --output ./cues.json
+
+visualfries apply-cues ./scene.json \
+  --cues ./cues.json \
+  --output ./scene.with-cues.json
+```
+
+Cue file:
+
+```json
+{
+  "broll": [
+    { "url": "./assets/profile-scroll.mp4", "start": 2, "end": 5, "type": "VIDEO" }
+  ],
+  "overlays": [
+    { "text": "LOVE THIS 😍", "start": 0.4, "end": 1.1, "style": "hook-punch" },
+    { "text": "your move", "start": 41.5, "end": 43, "style": "cta-card" }
+  ],
+  "transitions": [
+    { "time": 2, "style": "dip-to-black" }
+  ]
+}
+```
+
+Use this as the normal agent path:
+
+```text
+compose
+```
+
+For debugging:
+
+```text
+caption-scene -> preset-cues -> edit cues -> apply-cues -> inspect --screenshots -> render
+```
+
+Available starter presets:
+
+- `hidden-engine-dynamic`: cue skeleton for 40-60s story-driven shorts with hook/proof/mechanism/choice/CTA overlay beats.
+- `captioned-clean`: minimal transition cues for caption-first videos.
+
+## Timed Text Overlays
+
+Use for quick reaction beats, keyword shocks, proof callouts, and hook emphasis.
+
+```ts
+import { addAgentTextOverlays } from 'visualfries/agent';
+
+const withOverlays = addAgentTextOverlays({
+  scene,
+  overlays: [
+    { text: 'LOVE THIS 😍', start: 0.4, end: 1.1, style: 'pop-label' },
+    { text: 'NECK 🤯', start: 1.1, end: 1.7, style: 'shock-word' },
+    { text: '1M PROFIT', start: 2.0, end: 3.0, style: 'metric-badge' }
+  ]
+});
+```
+
+Overlay styles:
+
+- `hook-punch`: loud yellow hook label for the first second.
+- `shock-word`: large keyword reveal.
+- `metric-badge`: big number/proof badge.
+- `proof-pill`: smaller credibility/proof pill.
+- `danger-crossout`: negative beat / wrong path callout.
+- `cta-card`: final question or choice card.
+- `pop-label`: generic fast reaction label.
+- `soft-card`: calmer context card.
+
+Rules:
+
+- one overlay idea per beat,
+- 0.4-1.4 seconds per overlay,
+- keep captions readable,
+- render sampled screenshots before final MP4.
+
+## B-roll Sequence
+
+Use when an agent has portrait stock footage, generated images, screen recordings, or proof visuals.
+
+```ts
+import { addAgentBrollSequence } from 'visualfries/agent';
+
+const withBroll = addAgentBrollSequence({
+  scene,
+  cues: [
+    { url: './broll/profile.mp4', start: 2.0, end: 5.0, type: 'VIDEO' },
+    { url: './broll/chart.png', start: 5.0, end: 7.0, type: 'IMAGE', motion: 'slow-zoom-in' }
+  ]
+});
+```
+
+Layer defaults:
+
+- b-roll layer order: `5`
+- captions layer from `caption-scene`: `10`
+- text overlay layer: `90`
+
+This means b-roll naturally replaces/augments the base media while captions and overlays stay visible.
+
+Image motion:
+
+- `slow-zoom-in` default for images,
+- `slow-zoom-out`,
+- `drift-up`,
+- `none`.
+
+## Beat Transitions
+
+Use when a hard cut between b-roll/avatar/proof visuals needs a small cover at an exact beat.
+
+```ts
+import { addAgentTransitions } from 'visualfries/agent';
+
+const withTransitions = addAgentTransitions({
+  scene,
+  transitions: [
+    { time: 2.0, style: 'dip-to-black' },
+    { time: 5.0, style: 'swipe-left', color: '#04483D' }
+  ]
+});
+```
+
+Available styles:
+
+- `dip-to-black` for invisible cuts,
+- `flash` for punchy hook beats,
+- `swipe-left` for editorial movement,
+- `swipe-up` for vertical short-form movement.
+
+Keep transition durations short, usually `0.18-0.32s`. Overusing them makes the edit feel templated.
+
+## Agent QA Loop
+
+For every non-trivial scene:
+
+```bash
+visualfries doctor --json
+visualfries catalog --json
+visualfries validate-cues ./cues.json --duration 45 --json
+visualfries validate ./scene.json
+visualfries qa ./scene.json --output ./qa
+visualfries render ./scene.json --render-mode preview --output ./preview.mp4
+ffprobe -v error -show_entries stream=codec_type,width,height -of json ./preview.mp4
+```
+
+If `visualfries render` blocks a final VIDEO/GIF scene, that is expected. Do not bypass it for shipped output. The scene needs deterministic predecoded media frames before final encode.
+
+For final contiguous MP4 renders, prefer streaming encode after QA:
+
+```bash
+visualfries render ./scene.with-cues.json \
+  --stream-encode \
+  --image-format jpg \
+  --output ./out.mp4
+```
+
+This avoids writing every final frame to disk before encode.
+
+For static-heavy agent videos, add `--skip-duplicates` after QA:
+
+```bash
+visualfries render ./scene.json --output ./out.mp4 --skip-duplicates
+```
+
+The CLI uses VisualFries `renderFrameRange()` for contiguous frame ranges. Sparse QA screenshots still use direct sampled frame renders.
+
+If screenshot samples show overlap, fix the scene JSON or cue timing before encoding the full video.