@shotstack/shotstack-studio 1.2.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
- import { type Size, type Vector } from "../layouts/geometry";
2
- import { type Clip } from "../schemas/clip";
3
- import { type Edit } from "./edit";
1
+ import { type Size, type Vector } from "../../layouts/geometry";
2
+ import { type Clip } from "../../schemas/clip";
3
+ import { type Edit } from "../system/edit";
4
4
  import { Entity } from "./entity";
5
5
  /**
6
6
  * TODO: Move handles on UI level (screen space)
@@ -0,0 +1,14 @@
1
+ export { Entity } from './base/entity';
2
+ export { Player } from './base/player';
3
+ export { AudioPlayer } from './players/audio-player';
4
+ export { HtmlPlayer } from './players/html-player';
5
+ export { ImagePlayer } from './players/image-player';
6
+ export { LumaPlayer } from './players/luma-player';
7
+ export { ShapePlayer } from './players/shape-player';
8
+ export { TextPlayer } from './players/text-player';
9
+ export { VideoPlayer } from './players/video-player';
10
+ export { TextCursor } from './text/text-cursor';
11
+ export { TextEditor } from './text/text-editor';
12
+ export { TextInputHandler } from './text/text-input-handler';
13
+ export { Edit } from './system/edit';
14
+ export { Inspector } from './system/inspector';
@@ -1,7 +1,7 @@
1
- import { type Size } from "../layouts/geometry";
2
- import { type Clip } from "../schemas/clip";
3
- import type { Edit } from "./edit";
4
- import { Player } from "./player";
1
+ import { type Size } from "../../layouts/geometry";
2
+ import { type Clip } from "../../schemas/clip";
3
+ import { Player } from "../base/player";
4
+ import type { Edit } from "../system/edit";
5
5
  export declare class AudioPlayer extends Player {
6
6
  private audioResource;
7
7
  private isPlaying;
@@ -1,7 +1,7 @@
1
- import { type Size } from "../layouts/geometry";
2
- import { type Clip } from "../schemas/clip";
3
- import type { Edit } from "./edit";
4
- import { Player } from "./player";
1
+ import { type Size } from "../../layouts/geometry";
2
+ import { type Clip } from "../../schemas/clip";
3
+ import { Player } from "../base/player";
4
+ import type { Edit } from "../system/edit";
5
5
  export declare class HtmlPlayer extends Player {
6
6
  private background;
7
7
  private text;
@@ -1,7 +1,7 @@
1
- import { type Size } from "../layouts/geometry";
2
- import { type Clip } from "../schemas/clip";
3
- import type { Edit } from "./edit";
4
- import { Player } from "./player";
1
+ import { type Size } from "../../layouts/geometry";
2
+ import { type Clip } from "../../schemas/clip";
3
+ import { Player } from "../base/player";
4
+ import type { Edit } from "../system/edit";
5
5
  export declare class ImagePlayer extends Player {
6
6
  private texture;
7
7
  private sprite;
@@ -1,8 +1,8 @@
1
1
  import * as pixi from "pixi.js";
2
- import { type Size } from "../layouts/geometry";
3
- import { type Clip } from "../schemas/clip";
4
- import type { Edit } from "./edit";
5
- import { Player } from "./player";
2
+ import { type Size } from "../../layouts/geometry";
3
+ import { type Clip } from "../../schemas/clip";
4
+ import { Player } from "../base/player";
5
+ import type { Edit } from "../system/edit";
6
6
  export declare class LumaPlayer extends Player {
7
7
  private texture;
8
8
  private sprite;
@@ -1,7 +1,7 @@
1
- import { type Size } from "../layouts/geometry";
2
- import { type Clip } from "../schemas/clip";
3
- import type { Edit } from "./edit";
4
- import { Player } from "./player";
1
+ import { type Size } from "../../layouts/geometry";
2
+ import { type Clip } from "../../schemas/clip";
3
+ import { Player } from "../base/player";
4
+ import type { Edit } from "../system/edit";
5
5
  export declare class ShapePlayer extends Player {
6
6
  private shape;
7
7
  private shapeBackground;
@@ -0,0 +1,19 @@
1
+ import { Player } from "@entities/base/player";
2
+ import { type Size } from "@layouts/geometry";
3
+ import { type Clip } from "@schemas/clip";
4
+ /**
5
+ * TextPlayer renders and manages editable text elements in the canvas
6
+ */
7
+ export declare class TextPlayer extends Player {
8
+ private background;
9
+ private text;
10
+ private textEditor;
11
+ load(): Promise<void>;
12
+ update(deltaTime: number, elapsed: number): void;
13
+ dispose(): void;
14
+ getSize(): Size;
15
+ protected getFitScale(): number;
16
+ private createTextStyle;
17
+ private positionText;
18
+ updateTextContent(newText: string, initialConfig: Clip): void;
19
+ }
@@ -1,7 +1,7 @@
1
- import { type Size } from "../layouts/geometry";
2
- import { type Clip } from "../schemas/clip";
3
- import type { Edit } from "./edit";
4
- import { Player } from "./player";
1
+ import { type Size } from "../../layouts/geometry";
2
+ import { type Clip } from "../../schemas/clip";
3
+ import { Player } from "../base/player";
4
+ import type { Edit } from "../system/edit";
5
5
  export declare class VideoPlayer extends Player {
6
6
  private texture;
7
7
  private sprite;
@@ -1,11 +1,11 @@
1
1
  import { z } from "zod";
2
- import { EventEmitter } from "../events/event-emitter";
3
- import type { Size } from "../layouts/geometry";
4
- import { AssetLoader } from "../loaders/asset-loader";
5
- import { ClipSchema } from "../schemas/clip";
6
- import { EditSchema } from "../schemas/edit";
7
- import { TrackSchema } from "../schemas/track";
8
- import { Entity } from "./entity";
2
+ import { EventEmitter } from "../../events/event-emitter";
3
+ import type { Size } from "../../layouts/geometry";
4
+ import { AssetLoader } from "../../loaders/asset-loader";
5
+ import { ClipSchema } from "../../schemas/clip";
6
+ import { EditSchema } from "../../schemas/edit";
7
+ import { TrackSchema } from "../../schemas/track";
8
+ import { Entity } from "../base/entity";
9
9
  type EditType = z.infer<typeof EditSchema>;
10
10
  type ClipType = z.infer<typeof ClipSchema>;
11
11
  type TrackType = z.infer<typeof TrackSchema>;
@@ -1,4 +1,4 @@
1
- import { Entity } from "./entity";
1
+ import { Entity } from "../base/entity";
2
2
  export declare class Inspector extends Entity {
3
3
  private static readonly Width;
4
4
  private static readonly Height;
@@ -0,0 +1,47 @@
1
+ import { type Clip } from "@schemas/clip";
2
+ import * as pixi from "pixi.js";
3
+ type TextCursorOptions = {
4
+ width?: number;
5
+ color?: number;
6
+ blinkInterval?: number;
7
+ };
8
+ export declare class TextCursor {
9
+ private static readonly DEFAULT_BLINK_INTERVAL_MS;
10
+ private static readonly DEFAULT_CURSOR_WIDTH_PX;
11
+ private static readonly DEFAULT_CURSOR_COLOR;
12
+ private cursor;
13
+ private parent;
14
+ private textElement;
15
+ private clipConfig;
16
+ private textPosition;
17
+ private pixelX;
18
+ private pixelY;
19
+ private currentLine;
20
+ private isBlinking;
21
+ private blinkInterval;
22
+ private blinkIntervalMs;
23
+ private width;
24
+ private color;
25
+ private isVisible;
26
+ constructor(parent: pixi.Container, textElement: pixi.Text, clipConfig: Clip, options?: TextCursorOptions);
27
+ updatePosition(textPosition: number): void;
28
+ setPosition(x: number, y: number): void;
29
+ show(): void;
30
+ hide(): void;
31
+ setVisible(visible: boolean): void;
32
+ startBlinking(): void;
33
+ stopBlinking(): void;
34
+ setBlinkInterval(intervalMs: number): void;
35
+ dispose(): void;
36
+ private createCursor;
37
+ private validateTextPosition;
38
+ private calculateAndApplyPixelPosition;
39
+ private calculatePixelPositionFromText;
40
+ private updateGraphicsPosition;
41
+ private startBlinkingAnimation;
42
+ private stopBlinkingAnimation;
43
+ private measureText;
44
+ isInitialized(): boolean;
45
+ getState(): object;
46
+ }
47
+ export {};
@@ -0,0 +1,43 @@
1
+ import type { TextPlayer } from "@entities/players/text-player";
2
+ import { type Clip } from "@schemas/clip";
3
+ import * as pixi from "pixi.js";
4
+ export declare enum HorizontalAlignment {
5
+ LEFT = "left",
6
+ CENTER = "center",
7
+ RIGHT = "right"
8
+ }
9
+ export declare enum VerticalAlignment {
10
+ TOP = "top",
11
+ CENTER = "center",
12
+ BOTTOM = "bottom"
13
+ }
14
+ export declare class TextEditor {
15
+ private static readonly DOUBLE_CLICK_THRESHOLD_MS;
16
+ private static readonly EDITING_BG_PADDING_PX;
17
+ private static readonly EDITING_BG_ALPHA;
18
+ private static readonly CLICK_HANDLER_DELAY_MS;
19
+ private parent;
20
+ private targetText;
21
+ private clipConfig;
22
+ private isEditing;
23
+ private lastClickTime;
24
+ private editingContainer;
25
+ private editableText;
26
+ private textCursor;
27
+ private textInputHandler;
28
+ private outsideClickHandler;
29
+ constructor(parent: TextPlayer, targetText: pixi.Text, clipConfig: Clip);
30
+ dispose(): void;
31
+ private startEditing;
32
+ private stopEditing;
33
+ private checkForDoubleClick;
34
+ private setupOutsideClickHandler;
35
+ private createEditingEnvironment;
36
+ private setupEditingContainer;
37
+ private setupTextInputHandler;
38
+ private updateTextAlignment;
39
+ private calculateHorizontalPosition;
40
+ private calculateVerticalPosition;
41
+ private getContainerDimensions;
42
+ private getAlignmentSettings;
43
+ }
@@ -0,0 +1,54 @@
1
+ type TextInputHandlerOptions = {
2
+ initialText?: string;
3
+ autoFocus?: boolean;
4
+ focusDelay?: number;
5
+ };
6
+ type TextChangeCallback = (text: string, cursorPosition: number) => void;
7
+ type KeyboardEventHandlers = {
8
+ onTextInput?: TextChangeCallback;
9
+ onCursorMove?: (direction: "left" | "right" | "up" | "down", event: KeyboardEvent) => void;
10
+ onEnter?: (event: KeyboardEvent) => void;
11
+ onEscape?: (event: KeyboardEvent) => void;
12
+ onDelete?: (type: "backspace" | "delete", event: KeyboardEvent) => void;
13
+ onFocus?: (event: FocusEvent) => void;
14
+ onBlur?: (event: FocusEvent) => void;
15
+ onTabNavigation?: (direction: "forward" | "backward") => void;
16
+ onCustomKey?: (key: string, event: KeyboardEvent) => boolean;
17
+ };
18
+ export declare class TextInputHandler {
19
+ private static readonly DEFAULT_FOCUS_DELAY_MS;
20
+ private hiddenInput;
21
+ private isFocused;
22
+ private focusRetryCount;
23
+ private maxFocusRetries;
24
+ private focusDelay;
25
+ private eventHandlers;
26
+ private abortController;
27
+ private textChangeCallback;
28
+ private lastSyncedText;
29
+ private isComposing;
30
+ setupInput(initialText: string, options?: TextInputHandlerOptions): void;
31
+ updateInputValue(text: string): void;
32
+ focusInput(): void;
33
+ blurInput(): void;
34
+ setSelectionRange(start: number, end: number): void;
35
+ getCursorPosition(): number;
36
+ getValue(): string;
37
+ setTextInputHandler(callback: TextChangeCallback): void;
38
+ setEventHandlers(handlers: Partial<KeyboardEventHandlers>): void;
39
+ isFocusedInput(): boolean;
40
+ dispose(): void;
41
+ private createHiddenTextarea;
42
+ private setupEventListeners;
43
+ private removeAllEventListeners;
44
+ private handleTextInput;
45
+ private handleKeyDown;
46
+ private handleKeyboardShortcuts;
47
+ private handleCompositionStart;
48
+ private handleCompositionEnd;
49
+ private handleFocus;
50
+ private handleBlur;
51
+ private handlePaste;
52
+ private selectAll;
53
+ }
54
+ export {};
@@ -1,4 +1,4 @@
1
- import { Edit } from "../entities/edit";
1
+ import { Edit } from "@entities/system/edit";
2
2
  import { Canvas } from "../shotstack-canvas";
3
3
  export declare class VideoExporter {
4
4
  private readonly ffmpeg;
@@ -1,4 +1,4 @@
1
- import { Edit } from "../entities/edit";
1
+ import { Edit } from "@entities/system/edit";
2
2
  export declare class Controls {
3
3
  private edit;
4
4
  private seekDistance;
@@ -11,6 +11,7 @@ export declare class AssetLoader {
11
11
  private getContentType;
12
12
  private canPlayVideo;
13
13
  private isPlayableVideo;
14
- private loadVideoTexture;
14
+ private shouldUseSafariVideoLoader;
15
+ private loadVideoForSafari;
15
16
  private updateAssetLoadMetadata;
16
17
  }
@@ -1,4 +1,4 @@
1
- import { Edit } from "./entities/edit";
1
+ import { Edit } from "@entities/system/edit";
2
2
  import { type Size } from "./layouts/geometry";
3
3
  export declare class Canvas {
4
4
  private static extensionsRegistered;
package/dist/index.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- export { Edit } from "./core/entities/edit";
1
+ export { Edit } from "@entities/system/edit";
2
2
  export { Canvas } from "./core/shotstack-canvas";
3
3
  export { Controls } from "./core/inputs/controls";
4
4
  export { VideoExporter } from "./core/export/video-exporter";