@prisma/orm-toolchain 8.0.0-rc.1-dev.28 → 8.0.0-rc.1-dev.30

package/dist/{migration-graph-command-render-BKrg6BPv-BP8Pfj4J.mjs → migration-graph-command-render-CgdHruiZ-B6V4gmUe.mjs}

@@ -3,125 +3,152 @@ import { ifDefined } from "@prisma/orm-framework/utils/defined";
 import { InternalError } from "@prisma/orm-framework/utils/internal-error";
 import { bold, createColors, cyan, cyanBright, dim, green, yellow } from "colorette";
 import stringWidth from "string-width";
-//#region ../../../1-framework/3-tooling/cli/dist/migration-graph-command-render-BKrg6BPv.mjs
+//#region ../../../1-framework/3-tooling/cli/dist/migration-graph-command-render-CgdHruiZ.mjs
 /**
-* Occlusion renderer for the line/plane/occlusion migration-graph.
+* The drawing formatters compose one string per line, measuring display widths
+* with `string-width` as they go. To carry colour through that pipeline without
+* disturbing a single width, a tone is marked with an SGR escape sequence:
+* `string-width` and `strip-ansi` already treat those as zero-width, so every
+* existing width calculation keeps its answer.
 *
-* Per cell: pick the topmost-plane line (lowest plane number = drawn on top),
-* look up its glyph, apply colour from the line's lane or role. Lower-plane
-* lines are occluded (not drawn).
-*
-* Colour is forced via createColors({ useColor: true }) regardless of NO_COLOR.
+* The marks are a transport, not output. {@link toneDrawing} turns a marked
+* string into the engine's spans, and it drops every escape sequence it sees —
+* so no escape sequence can reach the engine, which does the painting itself.
+*/
+const TONE_MARK_BASE = 900;
+/** The escape character every SGR sequence opens with. */
+const ESCAPE = String.fromCharCode(27);
+/** Ends the innermost open mark. */
+const TONE_MARK_END = `${ESCAPE}[${TONE_MARK_BASE}m`;
+/**
+* Every tone, in the order their marks are numbered. Exported so a test can
+* hold it against a compiler-checked list of the engine's tones: a tone
+* missing from here would silently lose its colour.
 */
-const palette = createColors({ useColor: true });
-const LANE_COLORIZERS = [
-	palette.white,
-	palette.cyan,
-	palette.yellow,
-	palette.blueBright,
-	palette.magenta,
-	palette.green
+const TONE_ORDER = [
+	"ok",
+	"warn",
+	"error",
+	"info",
+	"heading",
+	"identifier",
+	"ref",
+	"placeholder",
+	"link",
+	"emphasis",
+	"muted",
+	"structure",
+	"highlight",
+	"color-1",
+	"color-2",
+	"color-3",
+	"color-4",
+	"color-5",
+	"color-6"
 ];
-function laneColor(lane) {
-	return LANE_COLORIZERS[lane % LANE_COLORIZERS.length] ?? ((t) => t);
+const MARK_BY_TONE = new Map(TONE_ORDER.map((tone, index) => [tone, TONE_MARK_BASE + index + 1]));
+const TONE_BY_MARK = new Map(TONE_ORDER.map((tone, index) => [TONE_MARK_BASE + index + 1, tone]));
+/** Marks `text` as carrying `tone`. Marks nest; the innermost one wins. */
+function toned(tone, text) {
+	return `${ESCAPE}[${MARK_BY_TONE.get(tone)}m${text}${TONE_MARK_END}`;
+}
+/** The painter shape the formatters take, bound to one tone. */
+function tonePainter(tone) {
+	return (text) => toned(tone, text);
+}
+const SGR_SEQUENCE = new RegExp(`${ESCAPE}\\[([\\d;]*)m`, "g");
+function pushSpan(spans, text, tone) {
+	if (text.length === 0) return;
+	const previous = spans.at(-1);
+	if (previous !== void 0 && previous.tone === tone) {
+		spans[spans.length - 1] = {
+			text: previous.text + text,
+			...tone === void 0 ? {} : { tone }
+		};
+		return;
+	}
+	spans.push({
+		text,
+		...tone === void 0 ? {} : { tone }
+	});
+}
+/** One marked line as spans. Text carrying no mark becomes an untoned span. */
+function toneSpans(line) {
+	const spans = [];
+	const open = [];
+	let cursor = 0;
+	SGR_SEQUENCE.lastIndex = 0;
+	for (let match = SGR_SEQUENCE.exec(line); match !== null; match = SGR_SEQUENCE.exec(line)) {
+		pushSpan(spans, line.slice(cursor, match.index), open.at(-1));
+		cursor = match.index + match[0].length;
+		for (const parameter of (match[1] ?? "").split(";")) {
+			const code = Number(parameter);
+			if (code === TONE_MARK_BASE) {
+				open.pop();
+				continue;
+			}
+			const tone = TONE_BY_MARK.get(code);
+			if (tone !== void 0) open.push(tone);
+		}
+	}
+	pushSpan(spans, line.slice(cursor), open.at(-1));
+	return spans;
 }
 /**
-* The colourizer for a lane's hue (lane0 = white, lane1 = cyan, …). Exported
-* so the per-row LABEL renderer can tint a migration name in its lane's colour,
-* matching the node `○`, the edges, and the arrows drawn in the gutter — one
-* colour per lane across glyph and text.
+* A marked block as the lines of a `drawing` block. A line with no marks stays
+* a plain string, which is what the engine's `Text` wants for untoned text.
 */
-function laneColorizer(lane) {
-	return laneColor(lane);
-}
-function roleColor(role) {
-	return role === "on-path" ? palette.greenBright : palette.dim;
+function toneDrawing(block) {
+	return block.split("\n").map((line) => {
+		const spans = toneSpans(line);
+		if (spans.length === 0) return "";
+		const only = spans.length === 1 ? spans[0] : void 0;
+		return only !== void 0 && only.tone === void 0 ? only.text : spans;
+	});
 }
-const UNICODE_ALPHABET = {
-	vertical: "│",
-	horizontal: "─",
-	cornerUpRight: "╰",
-	cornerDownRight: "╭",
-	cornerUpLeft: "╯",
-	cornerDownLeft: "╮",
-	arrowUp: "↑",
-	arrowDown: "↓",
-	node: "○",
-	selfLoop: "⟲",
-	landingArrow: "◂",
-	fallback: "?"
-};
-const ASCII_ALPHABET = {
-	vertical: "|",
-	horizontal: "-",
-	cornerUpRight: "\\",
-	cornerDownRight: "/",
-	cornerUpLeft: "/",
-	cornerDownLeft: "\\",
-	arrowUp: "^",
-	arrowDown: "v",
-	node: "*",
-	selfLoop: "@",
-	landingArrow: "<",
-	fallback: "?"
+const LANE_COUNT = 6;
+const forced = createColors({ useColor: true });
+const ANSI_LANES = [
+	forced.white,
+	forced.cyan,
+	forced.yellow,
+	forced.blueBright,
+	forced.magenta,
+	forced.green
+];
+/** The palette the commander CLI paints with: ANSI SGR straight into the line. */
+const ANSI_MIGRATION_GRAPH_PALETTE = {
+	lane: (lane, text) => (ANSI_LANES[lane % LANE_COUNT] ?? ((value) => value))(text),
+	role: (role, text) => role === "on-path" ? forced.greenBright(text) : forced.dim(text),
+	emphasis: (text) => bold(text),
+	status: (status, text) => status === "applied" ? green(text) : yellow(text)
 };
-function alphabetFor(mode) {
-	return mode === "ascii" ? ASCII_ALPHABET : UNICODE_ALPHABET;
-}
-function glyphFor(dirs, alphabet) {
-	const has = (d) => dirs.has(d);
-	if (has("up") && has("down") && !has("left") && !has("right")) return alphabet.vertical;
-	if (has("left") && has("right") && !has("up") && !has("down")) return alphabet.horizontal;
-	if (has("up") && has("right") && !has("down") && !has("left")) return alphabet.cornerUpRight;
-	if (has("down") && has("right") && !has("up") && !has("left")) return alphabet.cornerDownRight;
-	if (has("up") && has("left") && !has("down") && !has("right")) return alphabet.cornerUpLeft;
-	if (has("down") && has("left") && !has("up") && !has("right")) return alphabet.cornerDownLeft;
-	if (has("up") && !has("down") && !has("left") && !has("right")) return alphabet.arrowUp;
-	if (has("down") && !has("up") && !has("left") && !has("right")) return alphabet.arrowDown;
-	return alphabet.fallback;
-}
-const NO_COLOR = (t) => t;
-function renderCell(cell, colorEnabled, alphabet) {
-	if (cell.node !== void 0) return (!colorEnabled ? NO_COLOR : cell.node.role !== void 0 ? roleColor(cell.node.role) : laneColor(cell.node.lane))(alphabet.node);
-	if (cell.lines.length === 0) return " ";
-	const topLine = cell.lines.reduce((best, current) => {
-		if (current.plane < best.plane) return current;
-		if (current.plane > best.plane) return best;
-		if (current.line.role === "on-path" && best.line.role !== "on-path") return current;
-		return best;
-	}, cell.lines[0]);
-	const glyph = topLine.selfLoop === true ? alphabet.selfLoop : topLine.landingArrow === true ? alphabet.landingArrow : glyphFor(topLine.directions, alphabet);
-	return (!colorEnabled ? NO_COLOR : topLine.line.role !== void 0 ? roleColor(topLine.line.role) : laneColor(topLine.line.lane))(glyph);
-}
+const TONE_LANES = [
+	"color-1",
+	"color-2",
+	"color-3",
+	"color-4",
+	"color-5",
+	"color-6"
+];
 /**
-* Render a single grid row to a coloured string. A completely empty row returns
-* the empty string (the row is NOT dropped) so callers that pair grid rows with
-* an external per-row label list keep a 1:1 index correspondence. `renderGrid`
-* itself drops empty rows for its standalone output (but preserves separator rows).
+* The palette the engine shell marks with: each run of text carries the tone
+* it means, and the engine chooses the bytes. The lane series maps onto the
+* engine's indexed colours in order, which is the same rotation.
 */
-function renderGridRow(row, opts = {}) {
-	if (row[0]?.separator === true) return "";
-	let lastNonEmpty = -1;
-	for (let i = row.length - 1; i >= 0; i--) {
-		const cell = row[i];
-		if (cell !== void 0 && (cell.lines.length > 0 || cell.node !== void 0)) {
-			lastNonEmpty = i;
-			break;
-		}
-	}
-	if (lastNonEmpty < 0) return "";
-	const colsPerLane = opts.colsPerLane ?? 2;
-	const colorEnabled = opts.colorize ?? true;
-	const alphabet = alphabetFor(opts.glyphMode ?? "unicode");
-	const lastConnectorCol = Math.floor(lastNonEmpty / colsPerLane) * colsPerLane + (colsPerLane - 1);
-	const renderThrough = Math.max(lastNonEmpty, lastConnectorCol);
-	let line = "";
-	for (let col = 0; col <= Math.min(renderThrough, row.length - 1); col++) {
-		const cell = row[col];
-		line += cell === void 0 ? " " : renderCell(cell, colorEnabled, alphabet);
-	}
-	return line;
-}
+const TONE_MIGRATION_GRAPH_PALETTE = {
+	lane: (lane, text) => tonePainter(TONE_LANES[lane % LANE_COUNT] ?? "color-1")(text),
+	role: (role, text) => tonePainter(role === "on-path" ? "highlight" : "muted")(text),
+	emphasis: tonePainter("emphasis"),
+	status: (status, text) => tonePainter(status === "applied" ? "ok" : "warn")(text)
+};
+/** The palette a plain, uncoloured render uses: none of it. */
+const PLAIN_MIGRATION_GRAPH_PALETTE = {
+	lane: (_lane, text) => text,
+	role: (_role, text) => text,
+	emphasis: (text) => text,
+	status: (_status, text) => text
+};
 function migrationListForwardArrow(glyphMode) {
 	return glyphMode === "ascii" ? "->" : "→";
 }
@@ -1332,6 +1359,7 @@ function renderMigrationGraphSpaceTreeInternal(input) {
 		refsByHash: input.refsByHash ?? buildRefsByHashFromListEntries(input.migrations),
 		...input.dbHash !== void 0 ? { dbHash: input.dbHash } : {},
 		...input.styler !== void 0 ? { styler: input.styler } : {},
+		...input.palette !== void 0 ? { palette: input.palette } : {},
 		...input.globalMaxEdgeTreePrefixWidth !== void 0 ? { globalLabelColumn: input.globalMaxEdgeTreePrefixWidth } : {},
 		...input.globalMaxDirNameWidth !== void 0 ? { globalMaxDirNameWidth: input.globalMaxDirNameWidth } : {}
 	});
@@ -1407,7 +1435,8 @@ function buildRefsByHashFromListEntries(entries) {
 function formatEmptyStateLine(spaceId, style) {
 	return style.emptyState(`There are no migrations in migrations/${spaceId}/ yet`);
 }
-function renderSpaceTreeBlock(spaceId, migrations, multiSpace, glyphMode, style, colorize, liveContractHash, graphForSpace, appSpaceId, globalMaxEdgeTreePrefixWidth, globalMaxDirNameWidth) {
+function renderSpaceTreeBlock(input) {
+	const { spaceId, migrations, multiSpace, glyphMode, style, colorize, liveContractHash, graphForSpace, appSpaceId, palette, globalMaxEdgeTreePrefixWidth, globalMaxDirNameWidth } = input;
 	if (migrations.length === 0) {
 		const emptyLine = formatEmptyStateLine(spaceId, style);
 		if (!multiSpace) return [emptyLine];
@@ -1423,6 +1452,7 @@ function renderSpaceTreeBlock(spaceId, migrations, multiSpace, glyphMode, style,
 		colorize,
 		refsByHash: buildRefsByHashFromListEntries(migrations),
 		styler: style,
+		...palette !== void 0 ? { palette } : {},
 		...isAppSpace !== void 0 ? { isAppSpace } : {},
 		...globalMaxEdgeTreePrefixWidth !== void 0 ? { globalMaxEdgeTreePrefixWidth } : {},
 		...globalMaxDirNameWidth !== void 0 ? { globalMaxDirNameWidth } : {}
@@ -1455,7 +1485,20 @@ function renderMigrationListWithStyle(result, style, glyphMode = "unicode", opti
 	for (let index = 0; index < result.spaces.length; index++) {
 		const space = result.spaces[index];
 		if (index > 0) lines.push("");
-		lines.push(...renderSpaceTreeBlock(space.space, space.migrations, multiSpace, glyphMode, style, colorize, liveContractHash, graphForSpace, appSpaceId, globalMaxEdgeTreePrefixWidth, globalMaxDirNameWidth));
+		lines.push(...renderSpaceTreeBlock({
+			spaceId: space.space,
+			migrations: space.migrations,
+			multiSpace,
+			glyphMode,
+			style,
+			colorize,
+			liveContractHash,
+			graphForSpace,
+			appSpaceId,
+			palette: options.palette,
+			globalMaxEdgeTreePrefixWidth,
+			globalMaxDirNameWidth
+		}));
 	}
 	if (result.spaces.reduce((count, space) => count + space.migrations.length, 0) > 0) {
 		lines.push("");
@@ -1540,6 +1583,32 @@ function createAnsiMigrationListStyler(opts) {
 	};
 }
 /**
+* The same vocabulary, said as meaning rather than as colour: each token is
+* marked with the tone it carries and the CLI engine chooses the bytes.
+*
+* Two distinctions the ANSI styler draws by shade do not survive, because a
+* span carries exactly one tone: the source and destination hashes are both
+* `identifier` (the ANSI styler dims the source and brightens the
+* destination), and the `contract` marker is `emphasis` rather than bold
+* green, which is what tells it apart from a plain marker such as `db`.
+*/
+function createToneMigrationListStyler() {
+	return {
+		kind: (text) => text,
+		dirName: (text) => toned("emphasis", text),
+		sourceHash: (text) => toned("identifier", text),
+		destHash: (text) => toned("identifier", text),
+		glyph: (text) => toned("structure", text),
+		lane: (text) => toned("structure", text),
+		invariants: (ids) => toned("warn", `{${ids.join(", ")}}`),
+		markers: (names) => names.map((name) => toned("ref", "@") + (name === "contract" ? toned("emphasis", name) : toned("ref", name))).join(" "),
+		refs: (names) => toned("ref", `(${names.join(", ")})`),
+		spaceHeading: (text) => toned("heading", text),
+		summary: (text) => toned("muted", text),
+		emptyState: (text) => toned("muted", text)
+	};
+}
+/**
 * Per-row label formatting for the command graph renderer.
 *
 * The command graph renderer ({@link renderMigrationGraphCommand}) derives the
@@ -1559,34 +1628,35 @@ function createAnsiMigrationListStyler(opts) {
 * desired-state marker (see {@link CONTRACT_MARKER_NAME}).
 */
 const DB_MARKER_NAME = "db";
-/**
-* Forced-color functions that always emit ANSI regardless of the ambient TTY
-* environment (NO_COLOR, piped output). Used so on-path green / off-path dim are
-* deterministically emitted in tests that request colour while NO_COLOR is set.
-*/
-const { dim: forcedDim } = createColors({ useColor: true });
-const { greenBright: forcedGreen } = createColors({ useColor: true });
+function paletteFor(opts) {
+	return opts.palette ?? ANSI_MIGRATION_GRAPH_PALETTE;
+}
+const identity = (text) => text;
+/** A palette painter bound to a path role, or a no-op when colour is off. */
+function rolePainter(palette, colorize, role) {
+	return colorize ? (text) => palette.role(role, text) : identity;
+}
 /**
 * The two label styles used in `migrate --show` path-highlight mode.
 *
-* - `onPath`: bold name, neutral hashes (the on-path lane glyphs are coloured
-*   green by the grid renderer, not here).
-* - `offPath`: uniform dim grey on the name and the whole hash column.
+* - `onPath`: emphasized name, neutral hashes (the on-path lane glyphs are
+*   coloured by the grid renderer, not here).
+* - `offPath`: the off-path role reaches the name and the whole hash field.
 *
 * To change the on-path / off-path label colour in future, edit this object.
 */
 const PATH_HIGHLIGHT_STYLES = {
-	onPath: (_style, colorize) => ({
-		lane: colorize ? forcedGreen : (text) => text,
-		arrow: (text) => text,
-		dirName: (text) => bold(text),
+	onPath: (_style, colorize, palette = ANSI_MIGRATION_GRAPH_PALETTE) => ({
+		lane: rolePainter(palette, colorize, "on-path"),
+		arrow: identity,
+		dirName: colorize ? (text) => palette.emphasis(text) : identity,
 		hashOverride: void 0
 	}),
-	offPath: (colorize) => ({
-		lane: colorize ? forcedDim : (text) => text,
-		arrow: colorize ? forcedDim : (text) => text,
-		dirName: colorize ? forcedDim : (text) => text,
-		hashOverride: colorize ? forcedDim : void 0
+	offPath: (colorize, palette = ANSI_MIGRATION_GRAPH_PALETTE) => ({
+		lane: rolePainter(palette, colorize, "off-path"),
+		arrow: rolePainter(palette, colorize, "off-path"),
+		dirName: rolePainter(palette, colorize, "off-path"),
+		hashOverride: colorize ? rolePainter(palette, colorize, "off-path") : void 0
 	})
 };
 function abbreviateHash(hash, hashLength, emptySource) {
@@ -1614,10 +1684,11 @@ function createLabelStyler(opts) {
 	const base = opts.styler ?? createAnsiMigrationListStyler({ useColor: opts.colorize });
 	const activeRefName = opts.activeRefName;
 	if (!opts.colorize || activeRefName === void 0) return base;
+	const palette = paletteFor(opts);
 	return {
 		...base,
 		refs: (names) => {
-			const styledNames = names.map((name) => name === activeRefName ? bold(name) : name);
+			const styledNames = names.map((name) => name === activeRefName ? palette.emphasis(name) : name);
 			return base.refs(styledNames);
 		}
 	};
@@ -1644,10 +1715,7 @@ function formatEdgeAnnotationSuffix(migrationHash, opts, style) {
 		const glyph = status === "applied" ? glyphs.applied : glyphs.pending;
 		const label = status === "applied" ? "applied" : "pending";
 		if (!opts.colorize) segments.push(`${glyph} ${label}`);
-		else {
-			const styler = status === "applied" ? green : yellow;
-			segments.push(styler(`${glyph} ${label}`));
-		}
+		else segments.push(paletteFor(opts).status(status, `${glyph} ${label}`));
 	}
 	if (annotation.pathHighlight === "on-path") {
 		const glyph = opts.glyphMode === "ascii" ? ">" : "↑";
@@ -1655,7 +1723,7 @@ function formatEdgeAnnotationSuffix(migrationHash, opts, style) {
 	}
 	if (segments.length === 0) return "";
 	const suffix = `  ${segments.join("  ")}`;
-	return opts.colorize && isOffPath ? forcedDim(suffix) : suffix;
+	return opts.colorize && isOffPath ? paletteFor(opts).role("off-path", suffix) : suffix;
 }
 /**
 * Format the `from → to` hash data column for an edge row.
@@ -1687,7 +1755,8 @@ function formatNodeLabel(contractHash, opts, nodeHighlight) {
 	const overlays = overlayNamesForContract(contractHash, opts);
 	const hasOverlays = overlays.markers.length > 0 || overlays.refs.length > 0;
 	const offPath = nodeHighlight === "off-path" && opts.colorize;
-	const hashText = contractHash === "empty" ? (offPath ? forcedDim : style.glyph)(emptySource) : (offPath ? forcedDim : style.sourceHash)(abbreviateHash(contractHash, hashLength, emptySource));
+	const dimmed = (text) => paletteFor(opts).role("off-path", text);
+	const hashText = contractHash === "empty" ? (offPath ? dimmed : style.glyph)(emptySource) : (offPath ? dimmed : style.sourceHash)(abbreviateHash(contractHash, hashLength, emptySource));
 	if (!hasOverlays) return hashText;
 	return `${hashText}  ${formatContractNodeOverlays(style, overlays.markers, overlays.refs)}`;
 }
@@ -1705,16 +1774,17 @@ function formatMigrationLabel(edge, dirNameWidth, opts, lane) {
 	const hashLength = opts.hashLength ?? 7;
 	const glyphMode = opts.glyphMode ?? "unicode";
 	const highlight = opts.edgeAnnotationsByHash?.get(edge.migrationHash)?.pathHighlight;
+	const palette = paletteFor(opts);
 	let dirNameStyler;
 	let hashOverride;
 	if (highlight === "on-path") {
-		dirNameStyler = opts.colorize ? forcedGreen : (text) => text;
+		dirNameStyler = rolePainter(palette, opts.colorize, "on-path");
 		hashOverride = void 0;
 	} else if (highlight === "off-path") {
-		dirNameStyler = opts.colorize ? forcedDim : style.dirName;
-		hashOverride = opts.colorize ? forcedDim : void 0;
+		dirNameStyler = opts.colorize ? rolePainter(palette, true, "off-path") : style.dirName;
+		hashOverride = opts.colorize ? rolePainter(palette, true, "off-path") : void 0;
 	} else if (opts.colorize && lane !== void 0) {
-		dirNameStyler = (text) => laneColorizer(lane)(text);
+		dirNameStyler = (text) => palette.lane(lane, text);
 		hashOverride = void 0;
 	} else {
 		dirNameStyler = style.dirName;
@@ -1751,11 +1821,6 @@ function legendGlyphs(mode) {
 		self: "⟲"
 	};
 }
-function formatLegendExampleMarkers(colorize) {
-	if (!colorize) return "@contract @db";
-	const sigil = green("@");
-	return `${sigil + bold(green("contract"))} ${sigil}${green("db")}`;
-}
 /**
 * A compact key for the tree visual language: the contract node glyph, the
 * in-lane direction arrows, the empty baseline, the system-marker `@…` and
@@ -1763,15 +1828,18 @@ function formatLegendExampleMarkers(colorize) {
 */
 function renderMigrationGraphLegend(opts) {
 	const glyphMode = opts.glyphMode ?? "unicode";
-	const style = createAnsiMigrationListStyler({ useColor: opts.colorize });
+	const style = opts.styler ?? createAnsiMigrationListStyler({ useColor: opts.colorize });
+	const palette = opts.palette ?? ANSI_MIGRATION_GRAPH_PALETTE;
 	const glyphs = legendGlyphs(glyphMode);
 	const emptySource = migrationListEmptySource(glyphMode);
 	const forwardArrow = migrationListForwardArrow(glyphMode);
 	const sampleArrow = `${style.sourceHash("aaaaaa")} ${style.glyph(forwardArrow)} ${style.destHash("bbbbbb")}`;
 	const statusGlyphs = overlayStatusGlyphs(glyphMode);
-	const appliedPending = opts.colorize ? `  ${green(statusGlyphs.applied)} ${style.summary("applied")}   ${yellow(statusGlyphs.pending)} ${style.summary("pending")}` : `  ${statusGlyphs.applied} ${style.summary("applied")}   ${statusGlyphs.pending} ${style.summary("pending")}`;
-	const exampleMarkers = formatLegendExampleMarkers(opts.colorize);
-	const exampleRefs = opts.colorize ? style.refs(["prod", "staging"]) : "(prod, staging)";
+	const appliedGlyph = opts.colorize ? palette.status("applied", statusGlyphs.applied) : statusGlyphs.applied;
+	const pendingGlyph = opts.colorize ? palette.status("pending", statusGlyphs.pending) : statusGlyphs.pending;
+	const appliedPending = `  ${appliedGlyph} ${style.summary("applied")}   ${pendingGlyph} ${style.summary("pending")}`;
+	const exampleMarkers = style.markers([CONTRACT_MARKER_NAME, DB_MARKER_NAME]);
+	const exampleRefs = style.refs(["prod", "staging"]);
 	return [
 		"Legend:",
 		`  ${style.kind(glyphs.node)} ${style.summary("contract")}   ${style.kind(glyphs.forward)} ${style.summary("forward")}   ${style.kind(glyphs.rollback)} ${style.summary("rollback")}`,
@@ -1784,6 +1852,104 @@ function renderMigrationGraphLegend(opts) {
 	].join("\n");
 }
 /**
+* Occlusion renderer for the line/plane/occlusion migration-graph.
+*
+* Per cell: pick the topmost-plane line (lowest plane number = drawn on top),
+* look up its glyph, apply colour from the line's lane or role. Lower-plane
+* lines are occluded (not drawn).
+*
+* Colour comes from the palette the caller hands in; see migration-graph-palette.
+*/
+const UNICODE_ALPHABET = {
+	vertical: "│",
+	horizontal: "─",
+	cornerUpRight: "╰",
+	cornerDownRight: "╭",
+	cornerUpLeft: "╯",
+	cornerDownLeft: "╮",
+	arrowUp: "↑",
+	arrowDown: "↓",
+	node: "○",
+	selfLoop: "⟲",
+	landingArrow: "◂",
+	fallback: "?"
+};
+const ASCII_ALPHABET = {
+	vertical: "|",
+	horizontal: "-",
+	cornerUpRight: "\\",
+	cornerDownRight: "/",
+	cornerUpLeft: "/",
+	cornerDownLeft: "\\",
+	arrowUp: "^",
+	arrowDown: "v",
+	node: "*",
+	selfLoop: "@",
+	landingArrow: "<",
+	fallback: "?"
+};
+function alphabetFor(mode) {
+	return mode === "ascii" ? ASCII_ALPHABET : UNICODE_ALPHABET;
+}
+function glyphFor(dirs, alphabet) {
+	const has = (d) => dirs.has(d);
+	if (has("up") && has("down") && !has("left") && !has("right")) return alphabet.vertical;
+	if (has("left") && has("right") && !has("up") && !has("down")) return alphabet.horizontal;
+	if (has("up") && has("right") && !has("down") && !has("left")) return alphabet.cornerUpRight;
+	if (has("down") && has("right") && !has("up") && !has("left")) return alphabet.cornerDownRight;
+	if (has("up") && has("left") && !has("down") && !has("right")) return alphabet.cornerUpLeft;
+	if (has("down") && has("left") && !has("up") && !has("right")) return alphabet.cornerDownLeft;
+	if (has("up") && !has("down") && !has("left") && !has("right")) return alphabet.arrowUp;
+	if (has("down") && !has("up") && !has("left") && !has("right")) return alphabet.arrowDown;
+	return alphabet.fallback;
+}
+/** A line or node is painted by its path role when it has one, else by its lane. */
+function paintByRoleOrLane(palette, role, lane) {
+	return role === void 0 ? (text) => palette.lane(lane, text) : (text) => palette.role(role, text);
+}
+function renderCell(cell, palette, alphabet) {
+	const node = cell.node;
+	if (node !== void 0) return paintByRoleOrLane(palette, node.role, node.lane)(alphabet.node);
+	if (cell.lines.length === 0) return " ";
+	const topLine = cell.lines.reduce((best, current) => {
+		if (current.plane < best.plane) return current;
+		if (current.plane > best.plane) return best;
+		if (current.line.role === "on-path" && best.line.role !== "on-path") return current;
+		return best;
+	}, cell.lines[0]);
+	const glyph = topLine.selfLoop === true ? alphabet.selfLoop : topLine.landingArrow === true ? alphabet.landingArrow : glyphFor(topLine.directions, alphabet);
+	return paintByRoleOrLane(palette, topLine.line.role, topLine.line.lane)(glyph);
+}
+/**
+* Render a single grid row to a coloured string. A completely empty row returns
+* the empty string (the row is NOT dropped) so callers that pair grid rows with
+* an external per-row label list keep a 1:1 index correspondence. `renderGrid`
+* itself drops empty rows for its standalone output (but preserves separator rows).
+*/
+function renderGridRow(row, opts = {}) {
+	if (row[0]?.separator === true) return "";
+	let lastNonEmpty = -1;
+	for (let i = row.length - 1; i >= 0; i--) {
+		const cell = row[i];
+		if (cell !== void 0 && (cell.lines.length > 0 || cell.node !== void 0)) {
+			lastNonEmpty = i;
+			break;
+		}
+	}
+	if (lastNonEmpty < 0) return "";
+	const colsPerLane = opts.colsPerLane ?? 2;
+	const palette = opts.colorize ?? true ? opts.palette ?? ANSI_MIGRATION_GRAPH_PALETTE : PLAIN_MIGRATION_GRAPH_PALETTE;
+	const alphabet = alphabetFor(opts.glyphMode ?? "unicode");
+	const lastConnectorCol = Math.floor(lastNonEmpty / colsPerLane) * colsPerLane + (colsPerLane - 1);
+	const renderThrough = Math.max(lastNonEmpty, lastConnectorCol);
+	let line = "";
+	for (let col = 0; col <= Math.min(renderThrough, row.length - 1); col++) {
+		const cell = row[col];
+		line += cell === void 0 ? " " : renderCell(cell, palette, alphabet);
+	}
+	return line;
+}
+/**
 * Command graph renderer: composes the gutter (from the grid) with per-row labels.
 *
 * Pipeline: buildMigrationGraphRows → buildGrid → renderMigrationGraphCommand
@@ -1911,7 +2077,8 @@ function renderMigrationGraphCommand(input) {
 		...ifDefined("contractHash", input.contractHash),
 		...ifDefined("isAppSpace", input.isAppSpace),
 		...ifDefined("activeRefName", input.activeRefName),
-		...ifDefined("styler", input.styler)
+		...ifDefined("styler", input.styler),
+		...ifDefined("palette", input.palette)
 	};
 	const nodeHighlights = resolveNodeHighlights(rowModel, input.edgeAnnotationsByHash);
 	const labelColumn = input.globalLabelColumn ?? computeLabelColumn(grid, glyphMode);
@@ -1921,7 +2088,8 @@ function renderMigrationGraphCommand(input) {
 	for (const row of grid) {
 		const gutter = renderGridRow(row, {
 			colorize: input.colorize,
-			glyphMode
+			glyphMode,
+			...ifDefined("palette", input.palette)
 		});
 		const identity = classifyRow(row, edgesByHash);
 		if (identity.kind === "none") {
@@ -1940,6 +2108,6 @@ function renderMigrationGraphCommand(input) {
 	return lines.join("\n");
 }
 //#endregion
-export { renderMigrationGraphSpaceTree as _, computeGlobalMaxDirNameWidth as a, computeMaxDirNameWidth as c, highlightFromEdgeAnnotations as d, indentMigrationGraphTreeBlock as f, renderMigrationGraphLegend as g, renderMigrationGraphCommand as h, buildMigrationGraphRows as i, createAnsiMigrationListStyler as l, migrationListForwardArrow as m, abbreviateContractHash as n, computeGlobalMaxEdgeTreePrefixWidth as o, migrationListEmptySource as p, buildGrid as r, computeLabelColumn as s, IDENTITY_MIGRATION_LIST_STYLER as t, formatOnPathMigrationRow as u, renderMigrationListWithStyle as v };
+export { toneSpans as S, renderMigrationGraphCommand as _, buildMigrationGraphRows as a, renderMigrationListWithStyle as b, computeLabelColumn as c, createToneMigrationListStyler as d, formatOnPathMigrationRow as f, migrationListForwardArrow as g, migrationListEmptySource as h, buildGrid as i, computeMaxDirNameWidth as l, indentMigrationGraphTreeBlock as m, TONE_MIGRATION_GRAPH_PALETTE as n, computeGlobalMaxDirNameWidth as o, highlightFromEdgeAnnotations as p, abbreviateContractHash as r, computeGlobalMaxEdgeTreePrefixWidth as s, IDENTITY_MIGRATION_LIST_STYLER as t, createAnsiMigrationListStyler as u, renderMigrationGraphLegend as v, toneDrawing as x, renderMigrationGraphSpaceTree as y };
 
-//# sourceMappingURL=migration-graph-command-render-BKrg6BPv-BP8Pfj4J.mjs.map
+//# sourceMappingURL=migration-graph-command-render-CgdHruiZ-B6V4gmUe.mjs.map