@neta-art/cohub 11.1.0 → 11.2.0

package/dist/board/render/renderers/task-card-renderer.js

@@ -1,16 +1,16 @@
 import { BOARD_FONT_STACK, BOARD_MONO_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { featuredTaskArtifact } from "../../../protocol/dist/board-task.js";
+import { fitTextToLines } from "../text-fit.js";
+import { boardCardDetailed, syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
+import { createCardTag, formatBoardDuration, syncCardTag, zoomCardTag } from "../card-tag.js";
 import { drawAudioWaveform } from "../audio-waveform.js";
-import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
+import { cardElevation, containRect, drawCardSurface, traceCardOutline } from "../surface.js";
 import { positionShell } from "./base-card-renderer.js";
 import { drawFarPlate } from "./far-plate.js";
-import { fitTextToLines } from "./file-card-renderer.js";
 import { Container, FillGradient, Graphics, Sprite, Text } from "pixi.js";
 //#region src/board/render/renderers/task-card-renderer.ts
-const RADIUS = 4;
 const PADDING = 12;
 const META_HEIGHT = 28;
-const TASK_CARD_FULL_DETAIL_ZOOM = .55;
 const PLAY_BADGE_RADIUS = 15;
 const SHIMMER_PERIOD_MS = 1600;
 const SHIMMER_FRAME_MS = 33;
@@ -62,30 +62,6 @@ function statusColor(status, context) {
 	if (status === "running") return context.colors.brand.stroke;
 	return context.colors.neutral.stroke;
 }
-function formatTaskElapsed(ms) {
-	const total = Math.max(0, Math.floor(ms / SECOND));
-	const hours = Math.floor(total / 3600);
-	const minutes = Math.floor(total % 3600 / 60);
-	const seconds = String(total % 60).padStart(2, "0");
-	return hours > 0 ? `${hours}:${String(minutes).padStart(2, "0")}:${seconds}` : `${minutes}:${seconds}`;
-}
-function containTaskPreviewRect(width, height, imageWidth, imageHeight) {
-	if (width <= 0 || height <= 0 || imageWidth <= 0 || imageHeight <= 0) return {
-		x: 0,
-		y: 0,
-		width: 0,
-		height: 0
-	};
-	const scale = Math.min(width / imageWidth, height / imageHeight);
-	const renderedWidth = imageWidth * scale;
-	const renderedHeight = imageHeight * scale;
-	return {
-		x: (width - renderedWidth) / 2,
-		y: (height - renderedHeight) / 2,
-		width: renderedWidth,
-		height: renderedHeight
-	};
-}
 function drawPlayBadge(graphics, rect, context) {
 	const radius = Math.min(PLAY_BADGE_RADIUS, Math.max(8, Math.min(rect.width, rect.height) * .16));
 	const cx = rect.x + rect.width / 2;
@@ -208,17 +184,46 @@ function drawShimmerBand(graphics, width, height, color) {
 	const band = Math.max(48, width * .45);
 	graphics.clear().rect(-band, 0, band, height).fill(shimmerGradient(color));
 }
+const MOSAIC_FRAME_MS = 160;
+const MOSAIC_CELL = 8;
+function drawMosaic(graphics, width, height, color, frame) {
+	const columns = Math.max(1, Math.floor(width / MOSAIC_CELL));
+	const rows = Math.max(1, Math.floor(height / MOSAIC_CELL));
+	const left = (width - columns * MOSAIC_CELL) / 2;
+	const top = (height - rows * MOSAIC_CELL) / 2;
+	graphics.clear();
+	for (const [threshold, alpha] of [[.08, .16], [.02, .3]]) {
+		for (let row = 0; row < rows; row += 1) for (let column = 0; column < columns; column += 1) {
+			let hash = Math.imul(column + 1, 2654435761) ^ Math.imul(row + 1, 2246822507) ^ Math.imul(frame + 1, 3266489909);
+			hash ^= hash >>> 15;
+			hash = Math.imul(hash, 739982445);
+			hash ^= hash >>> 12;
+			if ((hash >>> 0) / 4294967295 < threshold) graphics.rect(left + column * MOSAIC_CELL + 1, top + row * MOSAIC_CELL + 1, 6, 6);
+		}
+		graphics.fill({
+			color,
+			alpha
+		});
+	}
+}
 function advance(parts, clock) {
 	const { motion } = parts;
 	let next = null;
-	if (motion.shimmer) {
+	if (motion.mosaic) {
+		const frame = Math.floor(clock / MOSAIC_FRAME_MS);
+		if (frame !== motion.mosaic.step) {
+			motion.mosaic.step = frame;
+			drawMosaic(parts.shimmer, motion.width, motion.mosaic.height, motion.mosaic.color, frame);
+		}
+		next = MOSAIC_FRAME_MS - clock % MOSAIC_FRAME_MS;
+	} else if (motion.shimmer) {
 		const travel = motion.width + parts.shimmer.width;
 		parts.shimmer.x = clock % SHIMMER_PERIOD_MS / SHIMMER_PERIOD_MS * travel;
 		next = SHIMMER_FRAME_MS;
 	}
 	if (motion.startedAt !== null) {
 		const elapsedMs = Date.now() - motion.startedAt;
-		const elapsed = formatTaskElapsed(elapsedMs);
+		const elapsed = formatBoardDuration(elapsedMs);
 		if (elapsed !== motion.elapsed) {
 			motion.elapsed = elapsed;
 			parts.body.text = `${motion.label} · ${elapsed}`;
@@ -241,9 +246,13 @@ function sync(container, item, context) {
 	const { width, height } = item.frame;
 	const { snapshot } = item.props;
 	const { status, startedAt } = liveStatus(item, context);
-	const selected = context.selectedIds.has(item.id);
-	const hovered = context.hoveredId === item.id;
-	const full = context.zoom >= TASK_CARD_FULL_DETAIL_ZOOM;
+	const full = boardCardDetailed(context.zoom);
+	const elevation = cardElevation(context, item.id);
+	syncCardTag(parts.tag, {
+		glyph: "task",
+		text: snapshot.title,
+		width
+	}, context);
 	const working = status === "pending" || status === "running";
 	const color = statusColor(status, context);
 	const key = context.assetKey(item);
@@ -270,7 +279,7 @@ function sync(container, item, context) {
 	const showBadge = full && Boolean(count);
 	const label = stateLabel(surface, context);
 	const counting = full && working && startedAt !== null && surface !== null;
-	const elapsed = counting ? formatTaskElapsed(Date.now() - startedAt) : "";
+	const elapsed = counting ? formatBoardDuration(Date.now() - startedAt) : "";
 	const detailText = !full || !surface ? "" : status === "failed" ? snapshot.errorExcerpt ?? "" : working ? snapshot.promptExcerpt ?? "" : "";
 	const textArtifact = kind === "text" && artifact?.type === "text";
 	const bodyText = textArtifact ? artifact.textExcerpt : counting ? `${label} · ${elapsed}` : label;
@@ -290,10 +299,13 @@ function sync(container, item, context) {
 		height,
 		color,
 		context.palette.text,
-		context.palette.muted
+		context.palette.muted,
+		context.style.font
 	].join("|");
 	if (textSig !== parts.textSig) {
 		parts.textSig = textSig;
+		parts.body.style.fontFamily = context.style.font;
+		parts.detail.style.fontFamily = context.style.font;
 		const wrap = Math.max(24, width - 24);
 		parts.body.style.fill = surface === "failed" ? color : context.palette.text;
 		parts.body.anchor.set(textArtifact ? 0 : .5, 0);
@@ -309,9 +321,8 @@ function sync(container, item, context) {
 	const visualSig = [
 		width,
 		height,
-		selected,
-		hovered,
 		full,
+		elevation,
 		color,
 		kind,
 		surface,
@@ -322,30 +333,30 @@ function sync(container, item, context) {
 		artifact?.id ?? "none",
 		item.props.taskRunId,
 		texture ? `${texture.width}x${texture.height}` : "none",
-		context.palette.surface,
-		context.palette.hover,
-		context.palette.border,
-		context.palette.bg,
-		context.palette.text
+		context.themeKey
 	].join("|");
 	if (visualSig !== parts.visualSig) {
 		parts.visualSig = visualSig;
-		parts.plate.clear().roundRect(0, 0, width, height, RADIUS).fill({
-			color: context.palette.surface,
-			alpha: .98
-		}).roundRect(0, 0, width, height, RADIUS).stroke({
-			color: selected ? context.palette.brand : hovered ? context.palette.muted : context.palette.border,
-			width: selected ? 2 : 1,
-			alpha: selected ? .96 : .82
+		const rect = {
+			x: 0,
+			y: 0,
+			width,
+			height
+		};
+		drawCardSurface(parts.plate.clear(), rect, context.style, {
+			fill: context.palette.surface,
+			border: context.palette.border,
+			borderAlpha: .82,
+			elevation
 		});
-		parts.clip.clear().roundRect(1, 1, frame.width, frame.height, 3).fill({ color: 16777215 });
+		traceCardOutline(parts.clip.clear(), rect, context.style, -1).fill({ color: 16777215 });
 		parts.previewBg.clear().rect(frame.x, frame.y, frame.width, frame.height).fill({
 			color: context.palette.hover,
 			alpha: .5
 		});
 		parts.previewMask.clear().rect(frame.x, frame.y, frame.width, frame.height).fill({ color: 16777215 });
-		drawShimmerBand(parts.shimmer, frame.width, frame.height, context.palette.text);
-		parts.shimmer.y = frame.y;
+		if (context.style.progress === "shimmer") drawShimmerBand(parts.shimmer, frame.width, frame.height, context.palette.text);
+		parts.shimmer.position.set(context.style.progress === "shimmer" ? 0 : frame.x, frame.y);
 		parts.previewArt.clear();
 		if (kind === "waveform") {
 			const bottomInset = showMeta ? META_HEIGHT : 0;
@@ -384,7 +395,7 @@ function sync(container, item, context) {
 	parts.preview.visible = showPreview;
 	if (showPreview && texture) {
 		if (parts.preview.texture !== texture) parts.preview.texture = texture;
-		const fitted = containTaskPreviewRect(frame.width, frame.height, texture.width, texture.height);
+		const fitted = containRect(frame.width, frame.height, texture.width, texture.height);
 		parts.preview.position.set(frame.x + fitted.x, frame.y + fitted.y);
 		parts.preview.width = fitted.width;
 		parts.preview.height = fitted.height;
@@ -400,6 +411,12 @@ function sync(container, item, context) {
 	parts.badge.position.set(width - 8 - badgeWidth / 2, 18);
 	parts.motion.width = frame.width;
 	parts.motion.shimmer = full && working && kind !== "texture" && !context.reducedMotion;
+	const mosaic = parts.motion.shimmer && context.style.progress === "mosaic";
+	parts.motion.mosaic = mosaic ? {
+		color: context.palette.brand,
+		height: frame.height,
+		step: -1
+	} : null;
 	parts.shimmer.visible = parts.motion.shimmer;
 	parts.motion.startedAt = counting ? startedAt : null;
 	parts.motion.label = label;
@@ -439,10 +456,14 @@ const taskCardRenderer = {
 		detail.anchor.set(.5, 0);
 		detail.style.align = "center";
 		preview.mask = previewMask;
-		root.mask = clip;
-		root.addChild(plate, clip, previewBg, shimmer, preview, previewMask, previewArt, body, detail, meta, badge);
+		const content = new Container();
+		content.mask = clip;
+		content.addChild(previewBg, shimmer, preview, previewMask, previewArt, body, detail, meta, badge);
+		const tag = createCardTag();
+		root.addChild(plate, content, clip, tag.root);
 		partsByContainer.set(root, {
 			root,
+			tag,
 			plate,
 			clip,
 			previewBg,
@@ -462,6 +483,7 @@ const taskCardRenderer = {
 				itemId: "",
 				width: 0,
 				shimmer: false,
+				mosaic: null,
 				startedAt: null,
 				label: "",
 				elapsed: "",
@@ -479,6 +501,10 @@ const taskCardRenderer = {
 		const parts = partsByContainer.get(container);
 		return parts ? advance(parts, clock) : null;
 	},
+	zoom: (container, zoom) => {
+		const tag = partsByContainer.get(container)?.tag;
+		if (tag) zoomCardTag(tag, zoom);
+	},
 	renderFar: (graphics, item, context) => {
 		if (item.type !== "task") return;
 		const { status } = liveStatus(item, context);
@@ -500,4 +526,4 @@ const taskCardRenderer = {
 	}
 };
 //#endregion
-export { TASK_CARD_FULL_DETAIL_ZOOM, containTaskPreviewRect, formatTaskElapsed, taskCardRenderer };
+export { taskCardRenderer };

package/dist/board/render/renderers/unknown-card-renderer.js

@@ -1,40 +1,41 @@
 import { BOARD_MONO_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { syncTextResolution, textResolutionForZoom } from "../text-resolution.js";
+import { cardElevation, drawCardSurface, traceCardOutline } from "../surface.js";
 import { positionShell } from "./base-card-renderer.js";
 import { drawFarPlate } from "./far-plate.js";
 import { Container, Graphics, Text } from "pixi.js";
 //#region src/board/render/renderers/unknown-card-renderer.ts
-const RADIUS = 10;
 const partsByContainer = /* @__PURE__ */ new WeakMap();
 function sync(container, item, context) {
 	const parts = partsByContainer.get(container);
 	if (!parts) return;
 	positionShell(parts.root, item);
 	const { width, height } = item.frame;
-	const selected = context.selectedIds.has(item.id);
 	const realType = item.type;
 	syncTextResolution(parts.label, parts, context.zoom);
+	const elevation = cardElevation(context, item.id);
 	const visualSig = [
 		width,
 		height,
-		selected,
-		context.palette.surface,
-		context.palette.brand,
-		context.palette.border,
-		context.palette.muted
+		elevation,
+		context.themeKey
 	].join("|");
 	if (visualSig !== parts.visualSig) {
 		parts.visualSig = visualSig;
-		parts.box.clear();
-		parts.box.roundRect(0, 0, width, height, RADIUS).fill({
-			color: context.palette.surface,
-			alpha: .7
-		}).roundRect(0, 0, width, height, RADIUS).stroke({
-			color: selected ? context.palette.brand : context.palette.border,
-			width: selected ? 2 : 1,
-			alpha: .8
+		const rect = {
+			x: 0,
+			y: 0,
+			width,
+			height
+		};
+		drawCardSurface(parts.box.clear(), rect, context.style, {
+			fill: context.palette.surface,
+			fillAlpha: .7,
+			border: context.palette.border,
+			borderAlpha: .8,
+			elevation
 		});
-		parts.box.roundRect(6, 6, width - 12, height - 12, 6).stroke({
+		traceCardOutline(parts.box, rect, context.style, -6).stroke({
 			color: context.palette.muted,
 			width: 1,
 			alpha: .4

package/dist/board/render/renderers/video-card-renderer.js

@@ -1,91 +1,94 @@
-import { BOARD_FONT_STACK } from "../../../protocol/dist/board-constants.js";
 import { getMediaResourceTitle } from "../../model/media.js";
-import { syncTextResolution, syncTextWrapWidth, textResolutionForZoom } from "../text-resolution.js";
+import { boardCardDetailed } from "../text-resolution.js";
+import { createCardTag, formatBoardDuration, syncCardTag, zoomCardTag } from "../card-tag.js";
+import { cardElevation, containRect, drawCardSurface, traceCardOutline } from "../surface.js";
 import { positionShell } from "./base-card-renderer.js";
 import { drawFarPlate } from "./far-plate.js";
-import { Container, Graphics, Sprite, Text, Texture } from "pixi.js";
+import { drawMediaPlayKey } from "./media-key.js";
+import { Container, Graphics, Sprite, Texture } from "pixi.js";
 //#region src/board/render/renderers/video-card-renderer.ts
 const partsByContainer = /* @__PURE__ */ new WeakMap();
-const RADIUS = 4;
-function layoutContain(sprite, width, height) {
-	const texture = sprite.texture;
-	if (!texture.width || !texture.height) return;
-	const scale = Math.min(width / texture.width, height / texture.height);
-	sprite.width = texture.width * scale;
-	sprite.height = texture.height * scale;
-	sprite.x = (width - sprite.width) / 2;
-	sprite.y = (height - sprite.height) / 2;
+const FILM_RAIL = 10;
+const FILM_HOLE = 4;
+function videoTitle(item) {
+	return item.props.snapshot?.title ?? getMediaResourceTitle(item.props.src);
 }
 function sync(container, item, context) {
 	const parts = partsByContainer.get(container);
 	if (!parts) return;
 	positionShell(parts.root, item);
 	const { width, height } = item.frame;
-	const selected = context.selectedIds.has(item.id);
-	const hovered = context.hoveredId === item.id;
-	const resizing = context.resizingIds.has(item.id);
-	const title = item.props.snapshot?.title ?? getMediaResourceTitle(item.props.src);
+	const title = videoTitle(item);
+	const durationMs = item.props.snapshot?.durationMs;
+	const duration = durationMs ? formatBoardDuration(durationMs) : "";
+	syncCardTag(parts.tag, {
+		glyph: "video",
+		text: duration ? `${title} · ${duration}` : title,
+		width
+	}, context);
 	const key = context.assetKey(item);
 	const texture = key ? context.getTexture(key) : null;
-	const failed = Boolean(key && !texture && context.hasError(key));
-	syncTextResolution(parts.label, parts, context.zoom);
-	if (parts.label.text !== title) parts.label.text = title;
-	syncTextWrapWidth(parts.label, parts, Math.max(1, width - 16), resizing);
-	parts.label.position.set(8, Math.max(8, height - parts.label.height - 8));
+	const elevation = cardElevation(context, item.id);
 	const sig = [
 		key ?? "",
 		texture ? `${texture.width}x${texture.height}` : "none",
 		width,
 		height,
-		selected,
-		hovered,
-		failed,
-		title,
-		item.props.time ?? 0,
-		parts.label.height,
-		context.palette.surface,
-		context.palette.brand,
-		context.palette.muted,
-		context.palette.border,
-		context.palette.hover,
-		context.palette.text
+		elevation,
+		boardCardDetailed(context.zoom),
+		context.themeKey
 	].join("|");
 	if (sig === parts.sig) return;
 	parts.sig = sig;
+	const framed = context.style.media === "framed";
+	const rect = {
+		x: 0,
+		y: 0,
+		width,
+		height
+	};
+	const rail = framed ? Math.min(FILM_RAIL, height / 6) : 0;
+	const screen = {
+		x: framed ? rail * .6 : 0,
+		y: rail,
+		width: width - (framed ? rail * 1.2 : 0),
+		height: height - rail * 2
+	};
+	drawCardSurface(parts.plate.clear(), rect, context.style, {
+		fill: framed ? context.palette.text : context.palette.surface,
+		border: framed ? null : context.palette.border,
+		borderAlpha: .85,
+		elevation
+	});
+	if (framed) drawFilmRails(parts.plate, width, height, rail, context.palette.bg);
+	traceCardOutline(parts.mask.clear(), framed ? screen : rect, framed ? {
+		corner: "round",
+		radius: 1
+	} : context.style).fill({ color: 16777215 });
 	if (texture && parts.sprite.texture !== texture) parts.sprite.texture = texture;
 	parts.sprite.visible = Boolean(texture);
-	if (texture) layoutContain(parts.sprite, width, height);
-	parts.mask.clear().roundRect(0, 0, width, height, RADIUS).fill({ color: 16777215 });
-	parts.plate.clear().roundRect(0, 0, width, height, RADIUS).fill({
-		color: context.palette.surface,
-		alpha: .96
-	});
-	parts.chrome.clear();
 	if (texture) {
-		const bandHeight = Math.min(height, parts.label.height + 16);
-		parts.chrome.rect(0, height - bandHeight, width, bandHeight).fill({
-			color: context.palette.surface,
-			alpha: .78
-		});
+		const fitted = containRect(screen.width, screen.height, texture.width, texture.height);
+		parts.sprite.position.set(screen.x + fitted.x, screen.y + fitted.y);
+		parts.sprite.width = fitted.width;
+		parts.sprite.height = fitted.height;
 	}
-	const cx = width / 2;
-	const cy = height / 2;
-	const radius = Math.min(22, Math.min(width, height) * .18);
-	parts.chrome.circle(cx, cy, radius).fill({
-		color: selected ? context.palette.brand : context.palette.surface,
-		alpha: texture ? .88 : .96
-	});
-	const triangle = radius * .55;
-	parts.chrome.moveTo(cx - triangle * .35, cy - triangle * .6).lineTo(cx - triangle * .35, cy + triangle * .6).lineTo(cx + triangle * .7, cy).closePath().fill({
-		color: context.palette.text,
-		alpha: .94
-	});
-	parts.chrome.roundRect(0, 0, width, height, RADIUS).stroke({
-		color: selected ? context.palette.brand : hovered ? context.palette.muted : context.palette.border,
-		width: selected ? 2 : 1,
-		alpha: selected ? .95 : .85
+	parts.chrome.clear();
+	if (boardCardDetailed(context.zoom)) drawMediaPlayKey(parts.chrome, screen.x + screen.width / 2, screen.y + screen.height / 2, Math.min(18, Math.min(screen.width, screen.height) * .16), context);
+}
+function drawFilmRails(graphics, width, height, rail, hole) {
+	const size = Math.min(FILM_HOLE, rail * .45);
+	const step = size * 2.5;
+	const count = Math.max(1, Math.floor((width - step) / step));
+	const start = (width - (count - 1) * step - size) / 2;
+	for (let index = 0; index < count; index += 1) {
+		const x = start + index * step;
+		graphics.rect(x, (rail - size) / 2, size, size).rect(x, height - rail + (rail - size) / 2, size, size);
+	}
+	graphics.fill({
+		color: hole,
+		alpha: .9
 	});
-	parts.label.style.fill = texture ? context.palette.text : context.palette.muted;
 }
 const videoCardRenderer = {
 	id: "video-card",
@@ -96,20 +99,8 @@ const videoCardRenderer = {
 		const sprite = new Sprite(Texture.EMPTY);
 		const mask = new Graphics();
 		const chrome = new Graphics();
-		const resolution = textResolutionForZoom(context.zoom);
-		const label = new Text({
-			text: "",
-			style: {
-				fill: context.palette.muted,
-				fontFamily: BOARD_FONT_STACK,
-				fontSize: 12,
-				fontWeight: "500",
-				wordWrap: true
-			},
-			resolution,
-			roundPixels: true
-		});
-		root.addChild(plate, sprite, mask, chrome, label);
+		const tag = createCardTag();
+		root.addChild(plate, sprite, mask, chrome, tag.root);
 		sprite.mask = mask;
 		partsByContainer.set(root, {
 			root,
@@ -117,10 +108,8 @@ const videoCardRenderer = {
 			sprite,
 			mask,
 			chrome,
-			label,
-			sig: "",
-			wrapWidth: 0,
-			resolution
+			tag,
+			sig: ""
 		});
 		if (item.type === "video") sync(root, item, context);
 		return root;
@@ -128,6 +117,10 @@ const videoCardRenderer = {
 	update: (container, item, context) => {
 		if (item.type === "video") sync(container, item, context);
 	},
+	zoom: (container, zoom) => {
+		const tag = partsByContainer.get(container)?.tag;
+		if (tag) zoomCardTag(tag, zoom);
+	},
 	renderFar: (graphics, item, context) => {
 		drawFarPlate(graphics, item.frame, {
 			fill: context.palette.surface,

package/dist/board/render/stroke.d.ts

@@ -5,7 +5,7 @@ import { Graphics } from "pixi.js";
 //#region src/board/render/stroke.d.ts
 declare function dashPattern(dash: BoardDash | undefined, width: number): [number, number] | null;
 declare function trimPolyline(path: readonly WorldPoint[], trim: number | undefined): readonly WorldPoint[];
-declare function tracePolyline(graphics: Graphics, path: readonly WorldPoint[], pattern: [number, number] | null, closed?: boolean): void;
+declare function tracePolyline(graphics: Graphics, path: readonly WorldPoint[], pattern: [number, number] | null, closed?: boolean, offset?: number): void;
 declare function traceArrowhead(graphics: Graphics, tip: WorldPoint, angle: number, size: number): void;
 declare function endAngle(path: readonly WorldPoint[], atStart: boolean): number | null;
 declare function roundRectPoints(width: number, height: number, radius: number): WorldPoint[];

package/dist/board/render/stroke.js

@@ -31,7 +31,7 @@ function trimPolyline(path, trim) {
 	}
 	return out;
 }
-function tracePolyline(graphics, path, pattern, closed = false) {
+function tracePolyline(graphics, path, pattern, closed = false, offset = 0) {
 	const points = closed && path.length > 2 ? [...path, path[0]] : path;
 	if (points.length < 2) return;
 	if (!pattern) {
@@ -45,9 +45,10 @@ function tracePolyline(graphics, path, pattern, closed = false) {
 		return;
 	}
 	const [dash, gap] = pattern;
-	let penDown = true;
-	let fresh = true;
-	let remaining = dash;
+	const phase = Math.max(0, offset) % (dash + gap);
+	let penDown = phase < dash;
+	let fresh = penDown;
+	let remaining = penDown ? dash - phase : dash + gap - phase;
 	for (let index = 1; index < points.length; index += 1) {
 		const a = points[index - 1];
 		const b = points[index];

package/dist/board/render/style.d.ts

@@ -0,0 +1,29 @@
+//#region src/board/render/style.d.ts
+type BoardRenderStyle = {
+  corner: "round" | "pixel";
+  radius: number;
+  shadow: BoardShadowStyle | null;
+  selection: BoardSelectionStyle;
+  media: "plain" | "framed";
+  progress: "shimmer" | "mosaic";
+  icons: "line" | "pixel";
+  motion: "smooth" | "stepped";
+  font: string;
+};
+type BoardShadowStyle = {
+  color: number;
+  alpha: number;
+  blur: number;
+  y: number;
+};
+type BoardSelectionStyle = {
+  width: number;
+  outset: number;
+  dash: number;
+  handle: "circle" | "square";
+  handleSize: number;
+};
+declare function defaultBoardRenderStyle(mode: "dark" | "light"): BoardRenderStyle;
+declare function resolveBoardRenderStyle(mode: "dark" | "light", style?: Partial<BoardRenderStyle>): BoardRenderStyle;
+//#endregion
+export { BoardRenderStyle, BoardSelectionStyle, BoardShadowStyle, defaultBoardRenderStyle, resolveBoardRenderStyle };

package/dist/board/render/style.js

@@ -0,0 +1,54 @@
+import { BOARD_FONT_STACK } from "../../protocol/dist/board-constants.js";
+//#region src/board/render/style.ts
+const BASE = {
+	corner: "round",
+	radius: 6,
+	selection: {
+		width: 1.5,
+		outset: 3,
+		dash: 0,
+		handle: "square",
+		handleSize: 8
+	},
+	media: "plain",
+	progress: "shimmer",
+	icons: "line",
+	motion: "smooth",
+	font: BOARD_FONT_STACK
+};
+const SHADOW = {
+	light: {
+		color: 1447704,
+		alpha: .06,
+		blur: 12,
+		y: 2
+	},
+	dark: {
+		color: 0,
+		alpha: .24,
+		blur: 12,
+		y: 2
+	}
+};
+function defaultBoardRenderStyle(mode) {
+	return {
+		...BASE,
+		selection: { ...BASE.selection },
+		shadow: { ...SHADOW[mode] }
+	};
+}
+function resolveBoardRenderStyle(mode, style) {
+	const base = defaultBoardRenderStyle(mode);
+	if (!style) return base;
+	return {
+		...base,
+		...style,
+		selection: {
+			...base.selection,
+			...style.selection
+		},
+		shadow: style.shadow === void 0 ? base.shadow : style.shadow
+	};
+}
+//#endregion
+export { defaultBoardRenderStyle, resolveBoardRenderStyle };

package/dist/board/render/surface.d.ts

@@ -0,0 +1,34 @@
+import { WorldPoint } from "../model/geometry.js";
+import { BoardRenderStyle, BoardShadowStyle } from "./style.js";
+import { Graphics } from "pixi.js";
+//#region src/board/render/surface.d.ts
+declare const PIXEL_STEP = 2;
+type CardRect = {
+  x: number;
+  y: number;
+  width: number;
+  height: number;
+};
+declare function traceCardOutline(graphics: Graphics, rect: CardRect, style: Pick<BoardRenderStyle, "corner" | "radius">, grow?: number): Graphics;
+declare function tracePixelRect(graphics: Graphics, x: number, y: number, width: number, height: number, step: number): Graphics;
+declare function cardOutlinePoints(rect: CardRect, style: Pick<BoardRenderStyle, "corner" | "radius">, grow?: number): WorldPoint[];
+declare function drawCardShadow(graphics: Graphics, rect: CardRect, style: Pick<BoardRenderStyle, "corner" | "radius">, shadow: BoardShadowStyle | null): void;
+type CardSurface = {
+  fill: number;
+  fillAlpha?: number;
+  border?: number | null;
+  borderAlpha?: number;
+  elevation?: CardElevation;
+};
+type CardElevation = 0 | 1 | 2;
+declare function cardShadow(style: BoardRenderStyle, elevation: CardElevation): BoardShadowStyle | null;
+declare function drawCardSurface(graphics: Graphics, rect: CardRect, style: BoardRenderStyle, surface: CardSurface): Graphics;
+declare function containRect(width: number, height: number, imageWidth: number, imageHeight: number): CardRect;
+declare function cardElevation(context: {
+  liftedIds: ReadonlySet<string>;
+}, id: string): CardElevation;
+declare function isBoardCard(item: {
+  type: string;
+}): boolean;
+//#endregion
+export { CardElevation, CardRect, CardSurface, PIXEL_STEP, cardElevation, cardOutlinePoints, cardShadow, containRect, drawCardShadow, drawCardSurface, isBoardCard, traceCardOutline, tracePixelRect };