visualfries 0.1.10120 → 0.3.2

package/dist/managers/TimeManager.svelte.js

@@ -1,15 +1,31 @@
 export class TimeManager {
     fps = $state(30); // Default
     duration = $state(0);
-    transformTime(time, skipDurationCheck = false) {
-        // Round to nearest frame boundary (1/fps seconds)
-        let frameAdjustedTime = Math.round(time * this.fps) / this.fps;
-        frameAdjustedTime = Math.max(frameAdjustedTime, 0);
+    static FRAME_EPSILON = 1e-4;
+    getFrameIndex(time, mode = 'nearest', skipDurationCheck = false) {
+        let adjustedTime = Math.max(time, 0);
+        if (!skipDurationCheck) {
+            adjustedTime = Math.min(adjustedTime, this.duration);
+        }
+        const scaledTime = adjustedTime * this.fps;
+        if (mode === 'current') {
+            return Math.max(0, Math.floor(scaledTime + TimeManager.FRAME_EPSILON));
+        }
+        return Math.max(0, Math.round(scaledTime));
+    }
+    getTimeForFrame(frame, skipDurationCheck = false) {
+        const frameTime = Math.max(0, frame) / this.fps;
         if (!skipDurationCheck) {
-            // Keep duration check since endTime is always <= duration
-            return frameAdjustedTime > this.duration ? this.duration : frameAdjustedTime;
+            return frameTime > this.duration ? this.duration : frameTime;
         }
-        return frameAdjustedTime;
+        return frameTime;
+    }
+    transformTime(time, skipDurationCheck = false) {
+        const frame = this.getFrameIndex(time, 'current', skipDurationCheck);
+        return this.getTimeForFrame(frame, skipDurationCheck);
+    }
+    getCurrentFrameTime(time, skipDurationCheck = false) {
+        return this.transformTime(time, skipDurationCheck);
     }
     updateTimeConfig(newFps, newDuration) {
         this.fps = newFps;

package/dist/schemas/runtime/deterministic.js

@@ -8,7 +8,11 @@ export const DeterministicMediaConfigShape = z.object({
     loadingMaxAttempts: z.number().int().positive().prefault(2),
     readyYieldMs: z.number().int().nonnegative().prefault(0),
     blurDownscale: z.number().positive().max(1).prefault(0.33),
-    provider: z.custom().optional()
+    provider: z
+        .custom((value) => typeof value === 'object' &&
+        value !== null &&
+        typeof value.getFrame === 'function', 'provider must implement getFrame(request)')
+        .optional()
 }).prefault({});
 export const defaultDeterministicMediaConfig = DeterministicMediaConfigShape.parse(undefined);
 export class DeterministicRenderError extends Error {

package/dist/schemas/runtime/types.d.ts

@@ -4,6 +4,7 @@ import type { ComponentsManager } from '../../managers/ComponentsManager.svelte.
 import type { LayersManager } from '../../managers/LayersManager.svelte.js';
 import type { SubtitlesManager } from '../../managers/SubtitlesManager.svelte.js';
 import type { EventManager } from '../../managers/EventManager.js';
+import type { PixiAnimationTarget } from '../../animations/PixiAnimationTarget.js';
 import type { Component as SceneLayerComponent, ComponentBase, AppearanceInput, Scene, RenderEnvironment, ComponentInput, SceneLayerInput, SceneLayer, VideoComponentShape, ImageComponentShape, GifComponentShape, Subtitle } from '../..';
 import type { DeterministicMediaConfig, DeterministicFrameProvider, DeterministicDiagnosticsReport, FrameImageEncodingOptions, RenderFrameRangeOptions, RenderFrameRangeSummary } from './deterministic.js';
 declare const SCENE_LAYER_COMPONENT_TYPE: readonly ["IMAGE", "GIF", "VIDEO", "TEXT", "SHAPE", "AUDIO", "COLOR", "GRADIENT", "SUBTITLES"];
@@ -88,7 +89,7 @@ export interface ResourceManager<T, D, F> {
     get(id: string): T | undefined;
     getAll(): T[];
     update(id: string, data: Partial<F>, refreshType?: ComponentRefreshType): void;
-    delete(id: string): void;
+    delete(id: string): void | Promise<void>;
     create(data: D): Promise<T | null>;
     setOrder(id: string, newOrder: number): void;
     moveUp(id: string): void;
@@ -99,7 +100,7 @@ export interface ResourceManager<T, D, F> {
         id: string;
         data: Partial<F>;
     }>): void;
-    bulkDelete(ids: string[]): void;
+    bulkDelete(ids: string[]): void | Promise<void>;
     hide(id: string): void;
     show(id: string): void;
     toggle(id: string): void;
@@ -109,14 +110,16 @@ export type ComponentData = SceneLayerComponent;
 export type ComponentProps = ComponentBase & {
     checksum: string;
     duration: number;
+    sourceUrl?: string | undefined;
+    sourceStartAt?: number | undefined;
     setStart(start: number): void;
     setEnd(end: number): void;
     getData(): ComponentData;
     update(data: Partial<AppearanceInput>): void;
-    updateText(text: string): Promise<void>;
-    updateAppearance(appearance: Partial<AppearanceInput>): Promise<void>;
-    setVisible(visible: boolean): Promise<void>;
-    setOrder(order: number): Promise<void>;
+    updateText(text: string): void;
+    updateAppearance(appearance: Partial<AppearanceInput>): void;
+    setVisible(visible: boolean): void;
+    setOrder(order: number): void;
 };
 export interface PixiComponent {
     displayObject: Container;
@@ -131,6 +134,7 @@ export interface ComponentBuilder {
     withHtmlText(): ComponentBuilder;
     withHtmlAnimation(): ComponentBuilder;
     withAnimation(): ComponentBuilder;
+    withPixiAnimationTarget(): ComponentBuilder;
     withSubtitles(): ComponentBuilder;
     withDisplayObject(): ComponentBuilder;
     withTexture(): ComponentBuilder;
@@ -139,6 +143,7 @@ export interface ComponentBuilder {
     withGif(): ComponentBuilder;
     withShape(): ComponentBuilder;
     withCanvasShape(): ComponentBuilder;
+    withCanvasFill(): ComponentBuilder;
     withProgressShape(): ComponentBuilder;
     withHtmlToCanvasHook(): ComponentBuilder;
 }
@@ -155,14 +160,14 @@ export interface Component {
     setup(): void;
     update(): void;
     refresh(type?: ComponentRefreshType): void;
-    destroy(): void;
+    destroy(): Promise<void>;
     setStart(start: number): Component;
     setEnd(end: number): Component;
-    updateAppearance(appearance: Partial<AppearanceInput>): Promise<Component>;
-    updateText(text: string): Promise<Component>;
-    setText(text: string): Promise<Component>;
-    setVisible(visible: boolean): Promise<Component>;
-    setOrder(order: number): Promise<Component>;
+    updateAppearance(appearance: Partial<AppearanceInput>): Component;
+    updateText(text: string): Component;
+    setText(text: string): Component;
+    setVisible(visible: boolean): Component;
+    setOrder(order: number): Component;
     onChange(callback: (changes: ComponentData) => void): () => void;
     onTimelineChange(callback: (time: number) => void): () => void;
 }
@@ -193,7 +198,7 @@ export interface ResourceTypes {
     pixiContainer: Container | undefined;
     wrapperHtmlEl: HTMLElement | undefined;
     htmlEl: HTMLElement | undefined;
-    animationTarget: HTMLElement | Container | undefined;
+    animationTarget: HTMLElement | Container | PixiAnimationTarget | undefined;
     animationData: Record<string, any> | undefined;
     pixiRenderObject: Container | undefined;
     htmlRenderObject: HTMLDivElement | undefined;
@@ -228,6 +233,21 @@ type Zone = {
     start: number;
     end: number;
 };
+export type ComponentAnimationExplanation = {
+    componentId: string;
+    type: ComponentData['type'];
+    time: number;
+    active: boolean;
+    relativeTime: number;
+    targetKind: 'html' | 'pixi' | 'none';
+    targetOwner: 'wrapper' | 'element' | 'pixi' | 'none';
+    computed: Record<string, number | string>;
+    animations: Array<{
+        id: string;
+        enabled: boolean;
+        startAt: number;
+    }>;
+};
 export interface SceneBuilder {
     readonly sceneData: Scene;
     readonly environment: RenderEnvironment;
@@ -245,7 +265,7 @@ export interface SceneBuilder {
     readonly components: ComponentsManager;
     readonly subtitles: SubtitlesManager;
     readonly htmlContainer: HTMLElement;
-    readonly canvasContainer: HTMLElement;
+    readonly canvasContainer: HTMLCanvasElement;
     readonly disabledTimeZones: Zone[];
     syncChanges: () => void;
     addExcludedTimestamp(start: number, end: number): void;
@@ -259,6 +279,7 @@ export interface SceneBuilder {
     markDirty(): void;
     initialize(): Promise<void>;
     seek(time: number): Promise<void>;
+    explainComponentState(componentId: string): ComponentAnimationExplanation | null;
     replaceSourceOnTime(time: number, componentId: string, base64data: string): Promise<void>;
     setDeterministicFrameProvider(provider: DeterministicFrameProvider | null): void;
     getDeterministicFrameProvider(): DeterministicFrameProvider | null;
@@ -276,7 +297,7 @@ export interface SceneBuilder {
     removeLoadingComponent(componentId: string): void;
     buildCharactersList(): void;
     render(): void;
-    destroy(): void;
+    destroy(): Promise<void>;
     addComponent(componentData: ComponentInput): Promise<ComponentData | undefined>;
     addLayer(layerInput: SceneLayerInput): Promise<Layer | undefined>;
     addNewLayerWithComponents(components: ComponentInput[]): Promise<Layer | undefined>;

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

@@ -133,6 +133,12 @@ export declare const TextAppearanceShape: 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>;
@@ -532,6 +538,12 @@ export declare const AppearanceShape: 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>;
@@ -2542,6 +2554,12 @@ export declare const ComponentBaseShape: 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>;
@@ -3678,6 +3696,12 @@ export declare const TextComponentShape: 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>;
@@ -4829,6 +4853,12 @@ export declare const ImageComponentShape: 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>;
@@ -5987,6 +6017,12 @@ export declare const GifComponentShape: 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>;
@@ -7143,6 +7179,12 @@ export declare const VideoComponentShape: 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>;
@@ -8497,6 +8539,12 @@ export declare const ShapeComponentShape: 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>;
@@ -9663,6 +9711,12 @@ export declare const AudioComponentShape: 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>;
@@ -10720,6 +10774,12 @@ export declare const ColorComponentShape: 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>;
@@ -11776,6 +11836,12 @@ export declare const GradientComponentShape: 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>;
@@ -12954,6 +13020,12 @@ export declare const SubtitleComponentShape: 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>;
@@ -14144,6 +14216,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;
@@ -15291,6 +15369,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;
@@ -16445,6 +16529,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;
@@ -17597,6 +17687,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;
@@ -18819,6 +18915,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;
@@ -19981,6 +20083,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;
@@ -21034,6 +21142,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;
@@ -22086,6 +22200,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;
@@ -23260,6 +23380,12 @@ export declare const ComponentShape: z.ZodDiscriminatedUnion<[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>;

package/dist/schemas/scene/components.js

@@ -67,6 +67,17 @@ export const TextAppearanceShape = z.object({
     color: ColorTypeShape,
     textAlign: z.enum(['left', 'center', 'right', 'justify']),
     textTransform: z.enum(['none', 'uppercase', 'lowercase', 'capitalize']).optional(),
+    padding: z
+        .union([
+        coerceNonNegativeNumber(),
+        z.object({
+            top: coerceNonNegativeNumber(),
+            right: coerceNonNegativeNumber(),
+            bottom: coerceNonNegativeNumber(),
+            left: coerceNonNegativeNumber()
+        })
+    ])
+        .optional(),
     shadow: StructuredShadowShape.nullable().optional(),
     outline: StructuredOutlineShape.nullable().optional(),
     activeLine: z