@dev.fast/whiteboard 0.5.1 → 0.5.2-preview.20261104.146

package/dist/{src-B2b8cCoI.js → src-BQDlJXkG.js}

@@ -298,6 +298,8 @@ const animationScenarioSchema = z.strictObject({
 	label: z.string().min(1).max(32).describe("What the reader picks above the animation, e.g. Retried request. Keep it short."),
 	frames: z.array(handle).min(1).max(60).describe("The frame keys this scenario plays, in order.")
 });
+/** One named source range of an animation or clip: an anchor, or one with
+* the label it opens under. */
 const animationCodeSchema = z.union([anchorSchema, z.strictObject({
 	source: anchorSchema,
 	label: z.string().min(1).max(48).describe("What the range is, e.g. checkoutAnimation.")
@@ -505,6 +507,40 @@ const callout = {
 	schema: calloutSchema
 };
 //#endregion
+//#region ../whiteboard-document/src/blocks/clip.ts
+const clipMarkerSchema = z.strictObject({
+	key: handle.describe("Names the marker for the html: clip.marker(key) places it in time, and whiteboard.on(key, ...) runs as the playhead reaches it."),
+	title: label$1.describe("What the step strip under the clip shows for this marker, e.g. Lock taken. Keep it to a few words."),
+	caption: text$1.optional().describe("One or two short sentences shown under the clip."),
+	code: z.array(handle).min(1).max(8).optional().describe("The code this moment shows, by name in the block's code. The tour stops here with it.")
+});
+const clipScenarioSchema = z.strictObject({
+	key: handle.describe("Names the scenario: whiteboard.clip(key) builds its timeline."),
+	label: z.string().min(1).max(32).describe("What the reader picks above the clip, e.g. Slow replica. Keep it short.")
+});
+const clip = {
+	type: "clip",
+	reference: ["- clip {title, html, markers: {key, title (a few words), caption?, code? ([names in code] this moment shows)}[] (1 to 60), scenarios?: {key, label}[] (2 to 8, each a timeline the script builds), code?: {name: anchor | {source: anchor, label}}, height?: \"auto\" (default) | number (120 to 1200 CSS px), pins?}; the script places every marker in time", "Use a clip for continuous motion where the timing itself is the point: a token crossing a system, a race, a queue draining. The reader plays it, pauses it and jumps between its markers. Use an animation instead when the reader needs to compare discrete states. Read session_get_instructions({topic:\"animation\"}) before writing one."],
+	schema: defineBlock("clip", {
+		title: label$1,
+		html: text$1.min(1).max(2e5).describe("The clip's body markup: elements, <style> and <script>. Its script builds the timeline with whiteboard.clip() in a sandboxed iframe; see session_get_instructions({topic:\"animation\"})."),
+		markers: z.array(clipMarkerSchema).min(1).max(60).describe("The named moments the reader jumps between, with unique, stable keys. The script places each one in time."),
+		scenarios: z.array(clipScenarioSchema).min(2).max(8).optional().describe("Alternate timelines the script builds, one per key. The whiteboard draws a labelled scenario picker above the clip and starts on the first one."),
+		code: z.record(handle, animationCodeSchema).default({}).describe("Source ranges by name, each an anchor or {source, label}: the label names the range where it opens. Elements with data-wb-open open them; data-wb-code shows one inline."),
+		height: z.union([z.literal("auto"), z.number().int().min(120).max(1200)]).default("auto").describe("Fit the clip to its content by default, or set a fixed height in CSS pixels."),
+		pins: elementPins
+	}),
+	check(block) {
+		if (new Set(block.markers.map((marker) => marker.key)).size !== block.markers.length) throw new ReviewInputError("Clip marker keys must be unique within the clip.");
+		for (const marker of block.markers) {
+			const unknown = marker.code?.find((name) => !(name in block.code));
+			if (unknown) throw new ReviewInputError(`Marker "${marker.key}" lists code "${unknown}", which the clip's code does not name.`);
+		}
+		const scenarios = block.scenarios ?? [];
+		if (new Set(scenarios.map((scenario) => scenario.key)).size !== scenarios.length) throw new ReviewInputError("Clip scenario keys must be unique within the clip.");
+	}
+};
+//#endregion
 //#region ../whiteboard-document/src/blocks/code.ts
 /** Shared with sequence steps. */
 const codeFields = {
@@ -769,7 +805,8 @@ const leafSchema = z.discriminatedUnion("type", [
 	trace_quote.schema,
 	software_map.schema,
 	flow_diagram.schema,
-	animation.schema
+	animation.schema,
+	clip.schema
 ]);
 /** Every block kind, keyed by type. A kind without a definition is a compile error. */
 const blocks = {
@@ -785,6 +822,7 @@ const blocks = {
 	software_map,
 	flow_diagram,
 	animation,
+	clip,
 	section,
 	callout
 };
@@ -804,7 +842,8 @@ const referenceOrder = [
 	"flow_diagram",
 	"call_stack_diff",
 	"database_lens",
-	"animation"
+	"animation",
+	"clip"
 ];
 /** The selected blocks' fields, for agent guidance. */
 function componentReference(types = writableBlockTypes) {
@@ -1736,8 +1775,8 @@ const unitTypes = /* @__PURE__ */ new Set([
 	"flow_edge"
 ]);
 const isUnit = (element) => unitTypes.has(element.type);
-/** The reference id of a code peek an animation names: the canvas finds the
-* peek's resolved anchor by it. */
+/** The reference id of a code peek an animation or clip names: the canvas
+* finds the peek's resolved anchor by it. */
 const animationCodeId = (blockId, name) => `${blockId}:code:${name}`;
 /** Rewrites old review-source: and review-trace: links to their whiteboard: form. */
 function canonicalLink(href) {
@@ -1921,7 +1960,7 @@ function documentReferences(document, { tolerant = false, markdown = true, repos
 			label: attachment.label,
 			peek: true
 		})))));
-		if (element.type === "animation") return Object.entries(element.code).flatMap(([name, entry]) => {
+		if (element.type === "animation" || element.type === "clip") return Object.entries(element.code).flatMap(([name, entry]) => {
 			const code = animationCode(entry);
 			return select(code.source, element.pins).map((source) => ({
 				id: animationCodeId(element.id, name),

package/dist/{src-DLWol7GZ.js → src-CrrW7lcY.js}

@@ -285,6 +285,13 @@ const loopbackOriginSchema = urlSchema("origin", (url) => url.protocol === "http
 const REVIEW_DIFF_LAYOUTS = ["split", "unified"];
 const REVIEW_DIFF_LAYOUT_SCOPES = ["diff", "peek"];
 const REVIEW_COLOR_THEME_KINDS = ["dark", "light"];
+const REVIEW_OPEN_FILES_IN_CHOICES = [
+	"whiteboard",
+	"vscode",
+	"cursor",
+	"zed",
+	"application"
+];
 const reviewDiffrLoginsSchema = z.record(z.string(), z.object({
 	ready: z.boolean(),
 	message: z.string().optional()
@@ -834,6 +841,14 @@ const ReviewVerbRequestSchema = z.discriminatedUnion("name", [
 			reviewId: apiReviewIdSchema,
 			version: z.number().int().nonnegative().optional()
 		})
+	}),
+	z.strictObject({
+		name: z.literal("renderAnimation"),
+		args: z.strictObject({
+			reviewId: apiReviewIdSchema,
+			targetId: requiredString$1,
+			frame: requiredString$1
+		})
 	})
 ]);
 const ReviewVerbResponseSchema = z.discriminatedUnion("ok", [z.strictObject({
@@ -1189,4 +1204,4 @@ function formatIssuePath(path) {
 	return output;
 }
 //#endregion
-export { ReviewGatewayHostSchema as A, REVIEW_REMOTE_INSTALL_LOCK as C, ReviewConnectRequestSchema as D, ReviewCliInstallStampSchema as E, applyStructuralUpdate as F, decodeStructuralDiffEvent as I, structuralChangeCounts as L, ReviewSelectedDiffSchema as M, reviewDiffrLoginsSchema as N, ReviewFeedbackContactSchema as O, reviewDiffrSummarizerInputSchema as P, REVIEW_REMOTE_ATTACH_END as S, ReviewApiSelectionSourceSchema as T, REVIEW_DIFF_LAYOUTS as _, parseReviewVerbRequest as a, REVIEW_REMOTE_AGENT_IDS as b, boardIconKind as c, ReviewBugReportRequestSchema as d, parseReviewBugReportResponse as f, REVIEW_COLOR_THEME_KINDS as g, REVIEW_CLI_INSTALL_TARGET_LABELS as h, parseReviewDesktopVerbResult as i, ReviewOnboardingRunRequestSchema as j, ReviewFeedbackSchema as k, boardTitle as l, REVIEW_CLIENT_REMOTE as m, parseReviewDesktopDiscovery as n, parseReviewVerbResponse as o, REVIEW_CLIENT_HEADER as p, parseReviewDesktopVerbFrame as r, parseZod as s, parseReviewCliInstallApplyRequest as t, ReviewBugReportMetaV2Schema as u, REVIEW_DIFF_LAYOUT_SCOPES as v, REVIEW_REMOTE_WRAPPER_MARK as w, REVIEW_REMOTE_ATTACH_BEGIN as x, REVIEW_HOST_HEADER as y };
+export { ReviewFeedbackSchema as A, REVIEW_REMOTE_ATTACH_END as C, ReviewCliInstallStampSchema as D, ReviewApiSelectionSourceSchema as E, reviewDiffrSummarizerInputSchema as F, applyStructuralUpdate as I, decodeStructuralDiffEvent as L, ReviewOnboardingRunRequestSchema as M, ReviewSelectedDiffSchema as N, ReviewConnectRequestSchema as O, reviewDiffrLoginsSchema as P, structuralChangeCounts as R, REVIEW_REMOTE_ATTACH_BEGIN as S, REVIEW_REMOTE_WRAPPER_MARK as T, REVIEW_DIFF_LAYOUTS as _, parseReviewVerbRequest as a, REVIEW_OPEN_FILES_IN_CHOICES as b, boardIconKind as c, ReviewBugReportRequestSchema as d, parseReviewBugReportResponse as f, REVIEW_COLOR_THEME_KINDS as g, REVIEW_CLI_INSTALL_TARGET_LABELS as h, parseReviewDesktopVerbResult as i, ReviewGatewayHostSchema as j, ReviewFeedbackContactSchema as k, boardTitle as l, REVIEW_CLIENT_REMOTE as m, parseReviewDesktopDiscovery as n, parseReviewVerbResponse as o, REVIEW_CLIENT_HEADER as p, parseReviewDesktopVerbFrame as r, parseZod as s, parseReviewCliInstallApplyRequest as t, ReviewBugReportMetaV2Schema as u, REVIEW_DIFF_LAYOUT_SCOPES as v, REVIEW_REMOTE_INSTALL_LOCK as w, REVIEW_REMOTE_AGENT_IDS as x, REVIEW_HOST_HEADER as y };

package/dist/{stored-document-migration-iwIQ4l5G.js → stored-document-migration-D1wK4yID.js}

@@ -1,8 +1,8 @@
 import { C as renderVcsArgs, v as parseGitRemote, w as runVcs } from "./src-Y30gweiK.js";
 import { d as isBooleanValue, f as isNumberValue, l as jsonValueSchema, m as isStringValue, n as isJsonObject } from "./src-X9phtB2j.js";
-import { C as respellLinks, H as lensTargetsSchema, W as label, at as unionIntervals, et as formatAnchor, ot as ReviewInputError } from "./src-B2b8cCoI.js";
-import "./src-DLWol7GZ.js";
-import "./review-home-paths-LdGS4SpR.js";
+import { C as respellLinks, H as lensTargetsSchema, W as label, at as unionIntervals, et as formatAnchor, ot as ReviewInputError } from "./src-BQDlJXkG.js";
+import "./src-CrrW7lcY.js";
+import "./review-home-paths-BmZX2qiz.js";
 import { t as errorMessage } from "./error-message-OtiDonty.js";
 import { randomUUID } from "node:crypto";
 import { z } from "zod";

package/dist/{thread-state-B7L1mpN_.js → thread-state-WTqSborE.js}

@@ -1,4 +1,4 @@
-import { M as ReviewSelectedDiffSchema, T as ReviewApiSelectionSourceSchema } from "./src-DLWol7GZ.js";
+import { E as ReviewApiSelectionSourceSchema, N as ReviewSelectedDiffSchema } from "./src-CrrW7lcY.js";
 import { z } from "zod";
 import { stat } from "node:fs/promises";
 //#region src/fs-utils.ts