Open source CapCut alternative.
TypeScript
import { describe, expect, test } from "bun:test";
import { TEXT_SAFE_WIDTH, textRoom, textWrapRoom, wrapTextToRoom } from "./render";
// A stand-in face: every glyph ten units wide, spaces included. Enough to pin
// down where the breaks land without a canvas.
const measure = (line: string) => line.length * 10;
describe("textRoom", () => {
test("a centered anchor gets the whole safe width", () => {
expect(textRoom(0.5, 1080)).toBeCloseTo(TEXT_SAFE_WIDTH * 1080);
});
test("an anchor near an edge only gets as far as that edge", () => {
// 0.2 from the left: a centered box may reach 0.2 either way.
expect(textRoom(0.2, 1000)).toBeCloseTo(400);
expect(textRoom(0.8, 1000)).toBeCloseTo(400);
});
test("an anchor pinned to the edge keeps the promise the narrowing makes", () => {
// Whatever room is handed back, a box centered on the anchor has to sit
// inside the frame β there is no floor that quietly reaches past it.
for (const x of [0, 0.02, 0.05, 0.09, 0.95, 1]) {
const room = textRoom(x, 1000);
expect(x * 1000 - room / 2).toBeGreaterThanOrEqual(-1e-9);
expect(x * 1000 + room / 2).toBeLessThanOrEqual(1000 + 1e-9);
}
});
});
describe("textWrapRoom", () => {
test("a line turned to stand upright runs the frame's height, not its width", () => {
// A column word at the left edge reading bottom to top: its line runs
// down the frame, so the room is the height it can take from its anchor.
const column = { x: 0.095, y: 0.5, rotation: -90 };
expect(textWrapRoom(column, 1920, 1080)).toBeCloseTo(TEXT_SAFE_WIDTH * 1080);
expect(textWrapRoom({ ...column, rotation: 90 }, 1920, 1080)).toBeCloseTo(TEXT_SAFE_WIDTH * 1080);
// Upright, the same anchor has only the run to the near edge.
expect(textWrapRoom({ ...column, rotation: 0 }, 1920, 1080)).toBeCloseTo(0.19 * 1920);
});
test("a tilted line takes the shorter of its runs to the sides and to the top or bottom", () => {
const tilted = { x: 0.5, y: 0.5, rotation: 45 };
const across = (TEXT_SAFE_WIDTH * 1920) / Math.SQRT1_2;
const down = (TEXT_SAFE_WIDTH * 1080) / Math.SQRT1_2;
expect(textWrapRoom(tilted, 1920, 1080)).toBeCloseTo(Math.min(across, down));
});
test("a box with its own width wraps at it whatever its angle", () => {
expect(textWrapRoom({ x: 0.1, y: 0.5, rotation: -90, wrapWidth: 0.3 }, 1920, 1080)).toBeCloseTo(576);
});
});
describe("wrapTextToRoom", () => {
test("a line that fits stays on one line", () => {
expect(wrapTextToRoom("before going to", 400, measure)).toBe("before going to");
});
test("a line that does not fit breaks between words", () => {
expect(wrapTextToRoom("before going to bed", 100, measure)).toBe(
"before\ngoing to\nbed"
);
});
test("the author's own breaks survive", () => {
expect(wrapTextToRoom("one\ntwo", 1000, measure)).toBe("one\ntwo");
});
test("a word wider than the room is broken inside", () => {
// Every surface draws these lines as they are given and none of them
// reflow, so a word left whole here runs off the frame in the preview and
// in the rendered file alike.
expect(wrapTextToRoom("a supercalifragilistic b", 60, measure)).toBe(
"a\nsuperc\nalifra\ngilist\nic b"
);
});
test("no line comes back wider than the room", () => {
// The guarantee the caption box leans on: it draws with `max-content` and
// no wrapping, so anything over the room is pixels outside the frame.
const room = 60;
for (const text of [
"https://example.test/a/very/long/path/that/never/breaks",
"#oneenormoushashtagwithnospaces",
"short then aterriblylongcompoundword after",
"ππππππππππ",
]) {
for (const line of wrapTextToRoom(text, room, measure).split("\n")) {
expect(measure(line)).toBeLessThanOrEqual(room);
}
}
});
test("a break never lands inside an emoji", () => {
// Code points, not code units: half a surrogate pair draws as a tofu box.
for (const line of wrapTextToRoom("ππππ", 20, measure).split("\n")) {
expect(line).toBe(Array.from(line).join(""));
expect(line.includes("\uFFFD")).toBe(false);
}
});
test("a single character wider than the room stands alone", () => {
// Nothing narrower to fall back to; the alternative is a loop with no end.
expect(wrapTextToRoom("abc", 5, measure)).toBe("a\nb\nc");
});
test("no room to speak of leaves the text alone", () => {
expect(wrapTextToRoom("keep me", 0, measure)).toBe("keep me");
});
test("a line that fits keeps the spacing it was written with", () => {
expect(wrapTextToRoom("HELLO WORLD", 1000, measure)).toBe("HELLO WORLD");
expect(wrapTextToRoom(" indented", 1000, measure)).toBe(" indented");
});
});