Open source CapCut alternative.
TypeScript
refactor(site): the polygon tracer lives in its own kit module [rebuild]
David Le4b0d70a8232c
diff --git a/site/packages/effects-kit/src/index.ts b/site/packages/effects-kit/src/index.tsindex b30b9cad..0d3faf6b 100644--- a/site/packages/effects-kit/src/index.ts+++ b/site/packages/effects-kit/src/index.ts@@ -6,6 +6,7 @@ export * from "./motion/evaluate";export * from "./motion/catalog";export * from "./keys";export * from "./mask";+export * from "./shapePath";export * from "./render";export * from "./registry";export * from "./cutout";diff --git a/site/packages/effects-kit/src/render.ts b/site/packages/effects-kit/src/render.tsindex bfdcbba2..e9838ec3 100644--- a/site/packages/effects-kit/src/render.ts+++ b/site/packages/effects-kit/src/render.ts@@ -20,6 +20,7 @@ import {import { presetExtent } from "./motion/evaluate";import { evalOverlayFrame, hasOverlayKeys, poseAt, poseExtent, sortedKeys } from "./keys";import { applyMaskToCanvas, isMaskAnimated } from "./mask";+import { tracePolyShape } from "./shapePath";import type { LottieHandle } from "./lottie";import { elementPlugin } from "./registry";import { kitCanvas } from "./surface";@@ -27,7 +28,6 @@ import {lineLikeShape,textStretch,type Overlay,- type ShapeKind,type ShapeOverlay,type StickerOverlay,type TextOverlay,@@ -166,103 +166,6 @@ export function shapeMetrics(o: ShapeOverlay, frame: PaintFrame) {};}-/** A path consumer — a canvas context is one, and `shapePathD` builds SVG- * path data through the same calls, so both draw identical geometry. */-export interface ShapePathSink {- moveTo(x: number, y: number): void;- lineTo(x: number, y: number): void;- bezierCurveTo(c1x: number, c1y: number, c2x: number, c2y: number, x: number, y: number): void;- closePath(): void;-}--/** Trace a polygon shape's outline into a w×h box whose top-left corner sits- * at (dx, dy). Covers the filled kinds beyond rect and ellipse. */-export function tracePolyShape(- p: ShapePathSink,- kind: ShapeKind,- w: number,- h: number,- dx = 0,- dy = 0-) {- const X = (f: number) => dx + f * w;- const Y = (f: number) => dy + f * h;- if (kind === "triangle") {- p.moveTo(X(0.5), Y(0));- p.lineTo(X(1), Y(1));- p.lineTo(X(0), Y(1));- } else if (kind === "diamond") {- p.moveTo(X(0.5), Y(0));- p.lineTo(X(1), Y(0.5));- p.lineTo(X(0.5), Y(1));- p.lineTo(X(0), Y(0.5));- } else if (kind === "hexagon") {- // Lucide's hexagon stands on a point: vertices top and bottom, straight- // vertical sides.- p.moveTo(X(0.5), Y(0));- p.lineTo(X(1), Y(0.25));- p.lineTo(X(1), Y(0.75));- p.lineTo(X(0.5), Y(1));- p.lineTo(X(0), Y(0.75));- p.lineTo(X(0), Y(0.25));- } else if (kind === "star") {- // Lucide's star: the inner ring at half the outer radius so the points- // read full-bodied, and rounded corners — a soft round in each inner- // notch, a slight one at each tip. Each corner is cut short along its- // two edges and bridged by a cubic whose controls sit on the vertex.- const pts: [number, number][] = [];- for (let i = 0; i < 10; i++) {- const r = i % 2 ? 0.5 : 1;- const a = -Math.PI / 2 + (i * Math.PI) / 5;- pts.push([0.5 + 0.5 * r * Math.cos(a), 0.5 + 0.5 * r * Math.sin(a)]);- }- for (let i = 0; i < 10; i++) {- const [px, py] = pts[(i + 9) % 10];- const [cx, cy] = pts[i];- const [nx, ny] = pts[(i + 1) % 10];- const cut = i % 2 ? 0.35 : 0.15;- const ex = cx + (px - cx) * cut;- const ey = cy + (py - cy) * cut;- const lx = cx + (nx - cx) * cut;- const ly = cy + (ny - cy) * cut;- if (i === 0) p.moveTo(X(ex), Y(ey));- else p.lineTo(X(ex), Y(ey));- p.bezierCurveTo(X(cx), Y(cy), X(cx), Y(cy), X(lx), Y(ly));- }- } else if (kind === "heart") {- // Lucide's heart, normalized to the unit box (its arcs as cubics):- // straight sides down to the tip, round quarter-circle lobes on top.- p.moveTo(X(0.5), Y(1));- p.lineTo(X(0.15), Y(0.611));- p.bezierCurveTo(X(0.075), Y(0.531), X(0), Y(0.433), X(0), Y(0.306));- p.bezierCurveTo(X(0), Y(0.137), X(0.123), Y(0), X(0.275), Y(0));- p.bezierCurveTo(X(0.363), Y(0), X(0.425), Y(0.028), X(0.5), Y(0.111));- p.bezierCurveTo(X(0.575), Y(0.028), X(0.637), Y(0), X(0.725), Y(0));- p.bezierCurveTo(X(0.877), Y(0), X(1), Y(0.137), X(1), Y(0.306));- p.bezierCurveTo(X(1), Y(0.433), X(0.925), Y(0.531), X(0.85), Y(0.611));- }- p.closePath();-}--/** A polygon shape as SVG path data for a w×h box, for the DOM preview. */-export function shapePathD(kind: ShapeKind, w: number, h: number): string {- const parts: string[] = [];- const n = (v: number) => String(+v.toFixed(2));- tracePolyShape(- {- moveTo: (x, y) => parts.push(`M${n(x)} ${n(y)}`),- lineTo: (x, y) => parts.push(`L${n(x)} ${n(y)}`),- bezierCurveTo: (c1x, c1y, c2x, c2y, x, y) =>- parts.push(`C${n(c1x)} ${n(c1y)} ${n(c2x)} ${n(c2y)} ${n(x)} ${n(y)}`),- closePath: () => parts.push("Z"),- },- kind,- w,- h- );- return parts.join(" ");-}-function paintShape(ctx: CanvasRenderingContext2D, o: ShapeOverlay, frame: PaintFrame) {const m = shapeMetrics(o, frame);const alpha = ctx.globalAlpha;diff --git a/site/packages/effects-kit/src/shapePath.ts b/site/packages/effects-kit/src/shapePath.tsnew file mode 100644index 00000000..43d2fd9a--- /dev/null+++ b/site/packages/effects-kit/src/shapePath.ts@@ -0,0 +1,107 @@+/**+ * Polygon outlines shared by every painter: shape elements, their DOM+ * previews, and mask coverage all trace the same geometry through one sink,+ * so a heart drawn as a shape and a heart cut as a mask are the same heart.+ */++import type { ShapeKind } from "./types";++/** A path consumer — a canvas context is one, and `shapePathD` builds SVG+ * path data through the same calls, so both draw identical geometry. */+export interface ShapePathSink {+ moveTo(x: number, y: number): void;+ lineTo(x: number, y: number): void;+ bezierCurveTo(c1x: number, c1y: number, c2x: number, c2y: number, x: number, y: number): void;+ closePath(): void;+}++/** Trace a polygon shape's outline into a w×h box whose top-left corner sits+ * at (dx, dy). Covers the filled kinds beyond rect and ellipse. */+export function tracePolyShape(+ p: ShapePathSink,+ kind: ShapeKind,+ w: number,+ h: number,+ dx = 0,+ dy = 0+) {+ const X = (f: number) => dx + f * w;+ const Y = (f: number) => dy + f * h;+ if (kind === "triangle") {+ p.moveTo(X(0.5), Y(0));+ p.lineTo(X(1), Y(1));+ p.lineTo(X(0), Y(1));+ } else if (kind === "diamond") {+ p.moveTo(X(0.5), Y(0));+ p.lineTo(X(1), Y(0.5));+ p.lineTo(X(0.5), Y(1));+ p.lineTo(X(0), Y(0.5));+ } else if (kind === "hexagon") {+ // Lucide's hexagon stands on a point: vertices top and bottom, straight+ // vertical sides.+ p.moveTo(X(0.5), Y(0));+ p.lineTo(X(1), Y(0.25));+ p.lineTo(X(1), Y(0.75));+ p.lineTo(X(0.5), Y(1));+ p.lineTo(X(0), Y(0.75));+ p.lineTo(X(0), Y(0.25));+ } else if (kind === "star") {+ // Lucide's star: the inner ring at half the outer radius so the points+ // read full-bodied, and rounded corners — a soft round in each inner+ // notch, a slight one at each tip. Each corner is cut short along its+ // two edges and bridged by a cubic whose controls sit on the vertex.+ const pts: [number, number][] = [];+ for (let i = 0; i < 10; i++) {+ const r = i % 2 ? 0.5 : 1;+ const a = -Math.PI / 2 + (i * Math.PI) / 5;+ pts.push([0.5 + 0.5 * r * Math.cos(a), 0.5 + 0.5 * r * Math.sin(a)]);+ }+ for (let i = 0; i < 10; i++) {+ const [px, py] = pts[(i + 9) % 10];+ const [cx, cy] = pts[i];+ const [nx, ny] = pts[(i + 1) % 10];+ const cut = i % 2 ? 0.35 : 0.15;+ const ex = cx + (px - cx) * cut;+ const ey = cy + (py - cy) * cut;+ const lx = cx + (nx - cx) * cut;+ const ly = cy + (ny - cy) * cut;+ if (i === 0) p.moveTo(X(ex), Y(ey));+ else p.lineTo(X(ex), Y(ey));+ p.bezierCurveTo(X(cx), Y(cy), X(cx), Y(cy), X(lx), Y(ly));+ }+ } else if (kind === "heart") {+ // Lucide's heart, normalized to the unit box (its arcs as cubics):+ // straight sides down to the tip, round quarter-circle lobes on top.+ p.moveTo(X(0.5), Y(1));+ p.lineTo(X(0.15), Y(0.611));+ p.bezierCurveTo(X(0.075), Y(0.531), X(0), Y(0.433), X(0), Y(0.306));+ p.bezierCurveTo(X(0), Y(0.137), X(0.123), Y(0), X(0.275), Y(0));+ p.bezierCurveTo(X(0.363), Y(0), X(0.425), Y(0.028), X(0.5), Y(0.111));+ p.bezierCurveTo(X(0.575), Y(0.028), X(0.637), Y(0), X(0.725), Y(0));+ p.bezierCurveTo(X(0.877), Y(0), X(1), Y(0.137), X(1), Y(0.306));+ p.bezierCurveTo(X(1), Y(0.433), X(0.925), Y(0.531), X(0.85), Y(0.611));+ }+ p.closePath();+}++/** A polygon shape as SVG path data for a w×h box whose top-left corner+ * sits at (dx, dy), for the DOM preview. */+export function shapePathD(kind: ShapeKind, w: number, h: number, dx = 0, dy = 0): string {+ const parts: string[] = [];+ const n = (v: number) => String(+v.toFixed(2));+ tracePolyShape(+ {+ moveTo: (x, y) => parts.push(`M${n(x)} ${n(y)}`),+ lineTo: (x, y) => parts.push(`L${n(x)} ${n(y)}`),+ bezierCurveTo: (c1x, c1y, c2x, c2y, x, y) =>+ parts.push(`C${n(c1x)} ${n(c1y)} ${n(c2x)} ${n(c2y)} ${n(x)} ${n(y)}`),+ closePath: () => parts.push("Z"),+ },+ kind,+ w,+ h,+ dx,+ dy+ );+ return parts.join(" ");+}