@adea-ai/ui 0.66.1 → 0.67.0

package/README.md

@@ -373,6 +373,15 @@ imports and a 3 KiB gzip model budget (measured baseline: 2,455 bytes). This is
 model-subpath evidence; it does not waive UI #16's package attribution/conditional
 export corrections or the separate root compatibility gate.
 
+`bun run check:packed-paste-model` installs the actual archive with peer and
+optional packages omitted. It verifies the direct
+`@adea-ai/ui/components/conversation/paste-tokens` entry in native Node and the
+Solid source condition, a strict clean TypeScript consumer without ambient types,
+round-trip/range/pruning and invalid-metadata behavior, and exact packed
+LICENSE/NOTICE fidelity. The pure compiled module retains zero runtime imports
+and stays within a 3 KiB gzip budget. This gate runs in local verification, CI
+and publication; textarea editing and production adoption remain separate gates.
+
 ### Controlled appearance editor
 
 `AppearanceEditor` and `AppearancePopover` retain the accepted Zeron-derived
@@ -422,3 +431,15 @@ not just the editor primitive.
 Local packed interaction gates require `bunx playwright install chromium webkit`
 after dependency installation. On Linux, use `--with-deps` when the required
 system libraries are absent. All automation runs headless with disposable profiles.
+
+## Paste-token model (issue #532 selected unit)
+
+`@adea-ai/ui/components/conversation` also exports the pure paste-token model:
+`PasteBlock`, `isPasteBlock`, `countLines`, `shouldCollapse`, `nextSeq`,
+`formatToken`, `findTokenRanges`, `tokenRangeAt`, `pruneBlocks`, `expandAll`,
+`recollapsePastes`, `remapCarriedBlocks`, `stripTrailingBlankLines`, and the
+threshold and marker constants. Hosts provide stable, bounded ASCII block IDs and own
+draft state, persistence, message reconciliation and editor behavior. The model
+does not read storage or the clipboard, upload files, edit a textarea, or
+provide undo/history, previews or chips. Its selected source and Apache-2.0
+attribution are recorded in the issue #532 entry in `NOTICE`.

package/dist/NOTICE

@@ -267,3 +267,27 @@ pane-title gesture, replacing plaintext leaf IDs and string casts with typed
 intent, an instance-local active drag payload, and cancellation/removal checks.
 Header action composition injects application keyboard controls without owning
 shortcuts or domain transitions. No new upstream source or license is introduced.
+## Paste-token model translated from KiroCrew (issue #532)
+
+`packages/ui/src/components/conversation/paste-tokens.ts` translates the pure
+block and text transformations from `website/src/utils/pasteTokens.ts`, plus
+the trailing-blank-line policy from `website/src/components/composerPastePolicy.ts`,
+at KiroCrew revision `283e136c0f902e965a535a7c9548c57c7504fed0`.
+
+    Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+    This product includes software developed at Amazon.com, Inc.
+    (https://www.amazon.com/). Licensed under the Apache License, Version 2.0.
+
+Retained: the three-line/200-character collapse thresholds; canonical marker
+formatting and ranges; monotonic sequence allocation and collision remapping;
+token pruning, expansion and content-based re-collapse, including the
+trailing-whitespace fallback; and the linear trailing-blank-line scan. Bun unit
+cases adapt the pure expectations from `website/src/test/pasteTokens.test.ts` and
+the trailing-text policy from `website/src/test/ChatInput.paste.test.tsx`.
+
+The host supplies stable block IDs. Invalid IDs/sequences, duplicate identities,
+ambiguous sequence mappings and noncanonical or line-mismatched markers are
+refused. React, Lexical, browser clipboard/File handling, localStorage side-table
+recovery, backend message reconciliation, uploads, textarea editing, previews,
+chips, undo/history and submit/persistence authority are not included. This
+selected model is not rich editing, complete Chat, or application adoption.

package/dist/components/conversation/index.d.ts

@@ -5,4 +5,5 @@ export { ConversationSurface, type ConversationSurfaceProps } from './conversati
 export { ComposerAttachmentButton, ComposerHint, MessageComposer, type MessageComposerProps, } from './message-composer';
 export { MessageBody, MessageDayDivider, MessageGroup, MessageRow, type MessageRowProps, } from './message-row';
 export { AttachmentCard, ThreadPanel, type AttachmentCardProps, type ThreadPanelProps, } from './thread-panel';
+export { countLines, expandAll, findTokenRanges, formatToken, isPasteBlock, nextSeq, pruneBlocks, recollapsePastes, remapCarriedBlocks, shouldCollapse, stripTrailingBlankLines, tokenRangeAt, PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, type PasteBlock, } from './paste-tokens';
 //# sourceMappingURL=index.d.ts.map

package/dist/components/conversation/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAChG,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,EACL,kBAAkB,EAClB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAChG,OAAO,EAAE,cAAc,EAAE,KAAK,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAChG,OAAO,EACL,kBAAkB,EAClB,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,GAC7B,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,mBAAmB,EAAE,KAAK,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAC3F,OAAO,EACL,wBAAwB,EACxB,YAAY,EACZ,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,WAAW,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,KAAK,eAAe,GACrB,MAAM,eAAe,CAAA;AACtB,OAAO,EACL,cAAc,EACd,WAAW,EACX,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,UAAU,EACV,SAAS,EACT,eAAe,EACf,WAAW,EACX,YAAY,EACZ,OAAO,EACP,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,uBAAuB,EACvB,YAAY,EACZ,qBAAqB,EACrB,qBAAqB,EACrB,iBAAiB,EACjB,KAAK,UAAU,GAChB,MAAM,gBAAgB,CAAA"}

package/dist/components/conversation/index.js

@@ -5,4 +5,5 @@ import { ConversationSurface } from "./conversation-surface.js";
 import { ComposerAttachmentButton, ComposerHint, MessageComposer } from "./message-composer.js";
 import { MessageBody, MessageDayDivider, MessageGroup, MessageRow } from "./message-row.js";
 import { AttachmentCard, ThreadPanel } from "./thread-panel.js";
-export { AttachmentCard, BusySendButton, ChatComposer, ComposerAttachmentButton, ComposerHint, ConversationAvatar, ConversationSurface, MessageBody, MessageComposer, MessageDayDivider, MessageGroup, MessageRow, ThreadPanel };
+import { PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, countLines, expandAll, findTokenRanges, formatToken, isPasteBlock, nextSeq, pruneBlocks, recollapsePastes, remapCarriedBlocks, shouldCollapse, stripTrailingBlankLines, tokenRangeAt } from "./paste-tokens.js";
+export { AttachmentCard, BusySendButton, ChatComposer, ComposerAttachmentButton, ComposerHint, ConversationAvatar, ConversationSurface, MessageBody, MessageComposer, MessageDayDivider, MessageGroup, MessageRow, PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, ThreadPanel, countLines, expandAll, findTokenRanges, formatToken, isPasteBlock, nextSeq, pruneBlocks, recollapsePastes, remapCarriedBlocks, shouldCollapse, stripTrailingBlankLines, tokenRangeAt };

package/dist/components/conversation/paste-tokens.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Pure paste-token transformations translated and hardened from KiroCrew's
+ * `website/src/utils/pasteTokens.ts` at revision
+ * `283e136c0f902e965a535a7c9548c57c7504fed0` (Apache-2.0). See the #532 entry
+ * in the repository NOTICE. Paste identity is supplied by the host; this module
+ * does not access storage, clipboard APIs, message services, or editor state.
+ */
+/** A collapsed paste block stored alongside input or a message. */
+export interface PasteBlock {
+    /** A stable host-provided ASCII identifier; never included in visible token text. */
+    id: string;
+    /** Positive safe integer, unique among blocks in the same text value. */
+    seq: number;
+    /** Positive safe integer displayed in the token. */
+    lines: number;
+    /** Original pasted text, retained verbatim. */
+    content: string;
+}
+export declare const PASTE_THRESHOLD_LINES = 3;
+export declare const PASTE_THRESHOLD_CHARS = 200;
+/** Canonical token pattern. Internal scans always use a fresh RegExp instance. */
+export declare const PASTE_TOKEN_REGEX: RegExp;
+/** Check data received from a host before using it as a paste-token block. */
+export declare function isPasteBlock(value: unknown): value is PasteBlock;
+export declare function formatToken(block: PasteBlock): string;
+export declare function shouldCollapse(text: string): boolean;
+export declare function countLines(text: string): number;
+/** Next sequence for a new paste = max existing + 1, starting at 1. */
+export declare function nextSeq(blocks: readonly PasteBlock[]): number;
+/**
+ * Re-sequence `carried` blocks whose sequence is already taken by `used`, and
+ * rewrite their markers in one right-to-left pass. Carried block IDs and
+ * sequences must be unique so a visible marker always has one backing block.
+ * `used` is mutated to include the assigned sequences.
+ */
+export declare function remapCarriedBlocks(text: string, carried: readonly PasteBlock[], used: Set<number>): {
+    text: string;
+    blocks: PasteBlock[];
+};
+/** Ranges for canonical tokens whose sequence and line count match one block. */
+export declare function findTokenRanges(text: string, blocks: readonly PasteBlock[]): Array<{
+    start: number;
+    end: number;
+    block: PasteBlock;
+}>;
+export declare function tokenRangeAt(text: string, blocks: readonly PasteBlock[], caret: number): {
+    start: number;
+    end: number;
+    block: PasteBlock;
+} | null;
+export declare function pruneBlocks(text: string, blocks: PasteBlock[]): PasteBlock[];
+export declare function expandAll(text: string, blocks: readonly PasteBlock[]): string;
+/** Inverse of `expandAll`: replace each first non-overlapping verbatim block. */
+export declare function recollapsePastes(content: string, blocks: readonly PasteBlock[]): string;
+/** Strip a trailing whitespace run only when that run contains a newline. */
+export declare function stripTrailingBlankLines(value: string): string;
+//# sourceMappingURL=paste-tokens.d.ts.map

package/dist/components/conversation/paste-tokens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paste-tokens.d.ts","sourceRoot":"","sources":["../../../src/components/conversation/paste-tokens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,mEAAmE;AACnE,MAAM,WAAW,UAAU;IACzB,qFAAqF;IACrF,EAAE,EAAE,MAAM,CAAA;IACV,yEAAyE;IACzE,GAAG,EAAE,MAAM,CAAA;IACX,oDAAoD;IACpD,KAAK,EAAE,MAAM,CAAA;IACb,+CAA+C;IAC/C,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,eAAO,MAAM,qBAAqB,IAAI,CAAA;AACtC,eAAO,MAAM,qBAAqB,MAAM,CAAA;AAMxC,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAsC,CAAA;AAMpE,8EAA8E;AAC9E,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,UAAU,CAUhE;AAaD,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAGrD;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAG/C;AAED,uEAAuE;AACvE,wBAAgB,OAAO,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAO7D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,UAAU,EAAE,EAC9B,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,UAAU,EAAE,CAAA;CAAE,CAiDxC;AAED,iFAAiF;AACjF,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,UAAU,EAAE,GAC5B,KAAK,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC,CAkB1D;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,SAAS,UAAU,EAAE,EAC7B,KAAK,EAAE,MAAM,GACZ;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GAAG,IAAI,CAM1D;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAQ5E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAU7E;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAgDvF;AAED,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAiB7D"}

package/dist/components/conversation/paste-tokens.js

@@ -0,0 +1,216 @@
+//#region src/components/conversation/paste-tokens.ts
+var PASTE_THRESHOLD_LINES = 3;
+var PASTE_THRESHOLD_CHARS = 200;
+var PASTE_ID_PATTERN = /^[A-Za-z0-9._:-]{1,128}$/;
+var MAX_SAFE_SEQUENCE_TEXT_LENGTH = String(Number.MAX_SAFE_INTEGER).length;
+var PASTE_TOKEN_SOURCE = String.raw`\[ Paste #([1-9]\d{0,${MAX_SAFE_SEQUENCE_TEXT_LENGTH - 1}}) · ([1-9]\d{0,${MAX_SAFE_SEQUENCE_TEXT_LENGTH - 1}}) lines \]`;
+/** Canonical token pattern. Internal scans always use a fresh RegExp instance. */
+var PASTE_TOKEN_REGEX = new RegExp(PASTE_TOKEN_SOURCE, "g");
+function isPositiveSafeInteger(value) {
+	return Number.isSafeInteger(value) && value > 0;
+}
+/** Check data received from a host before using it as a paste-token block. */
+function isPasteBlock(value) {
+	if (typeof value !== "object" || value === null || Array.isArray(value)) return false;
+	const candidate = value;
+	return typeof candidate.id === "string" && PASTE_ID_PATTERN.test(candidate.id) && isPositiveSafeInteger(candidate.seq) && isPositiveSafeInteger(candidate.lines) && typeof candidate.content === "string";
+}
+function unambiguousBlocks(blocks) {
+	const valid = blocks.filter(isPasteBlock);
+	const seqCounts = /* @__PURE__ */ new Map();
+	const idCounts = /* @__PURE__ */ new Map();
+	for (const block of valid) {
+		seqCounts.set(block.seq, (seqCounts.get(block.seq) ?? 0) + 1);
+		idCounts.set(block.id, (idCounts.get(block.id) ?? 0) + 1);
+	}
+	return valid.filter((block) => seqCounts.get(block.seq) === 1 && idCounts.get(block.id) === 1);
+}
+function formatToken(block) {
+	if (!isPasteBlock(block)) throw new TypeError("Cannot format an invalid paste block");
+	return `[ Paste #${block.seq} · ${block.lines} lines ]`;
+}
+function shouldCollapse(text) {
+	if (!text) return false;
+	return countLines(text) >= 3 || text.length >= 200;
+}
+function countLines(text) {
+	if (!text) return 0;
+	return text.split("\n").length;
+}
+/** Next sequence for a new paste = max existing + 1, starting at 1. */
+function nextSeq(blocks) {
+	let max = 0;
+	for (const block of blocks) if (isPasteBlock(block) && block.seq > max) max = block.seq;
+	if (max === Number.MAX_SAFE_INTEGER) throw new RangeError("Paste sequence space is exhausted");
+	return max + 1;
+}
+/**
+* Re-sequence `carried` blocks whose sequence is already taken by `used`, and
+* rewrite their markers in one right-to-left pass. Carried block IDs and
+* sequences must be unique so a visible marker always has one backing block.
+* `used` is mutated to include the assigned sequences.
+*/
+function remapCarriedBlocks(text, carried, used) {
+	const seenSeqs = /* @__PURE__ */ new Set();
+	const seenIds = /* @__PURE__ */ new Set();
+	for (const block of carried) {
+		if (!isPasteBlock(block)) throw new TypeError("Cannot remap an invalid paste block");
+		if (seenSeqs.has(block.seq) || seenIds.has(block.id)) throw new TypeError("Carried paste block IDs and sequences must be unique");
+		seenSeqs.add(block.seq);
+		seenIds.add(block.id);
+	}
+	let maxUsed = 0;
+	for (const value of used) if (isPositiveSafeInteger(value) && value > maxUsed) maxUsed = value;
+	let free = maxUsed < Number.MAX_SAFE_INTEGER ? maxUsed + 1 : 1;
+	const allocateFree = () => {
+		while (used.has(free)) free = free < Number.MAX_SAFE_INTEGER ? free + 1 : 1;
+		const assigned = free;
+		used.add(assigned);
+		free = assigned < Number.MAX_SAFE_INTEGER ? assigned + 1 : 1;
+		return assigned;
+	};
+	const remap = /* @__PURE__ */ new Map();
+	const blocks = carried.map((block) => {
+		if (!used.has(block.seq)) {
+			used.add(block.seq);
+			return block;
+		}
+		const seq = allocateFree();
+		remap.set(block.seq, seq);
+		return {
+			...block,
+			seq
+		};
+	});
+	if (!remap.size) return {
+		text,
+		blocks
+	};
+	let out = text;
+	const ranges = findTokenRanges(text, carried);
+	for (let index = ranges.length - 1; index >= 0; index -= 1) {
+		const { start, end, block } = ranges[index];
+		const mapped = remap.get(block.seq);
+		if (mapped === void 0) continue;
+		out = out.slice(0, start) + formatToken({
+			...block,
+			seq: mapped
+		}) + out.slice(end);
+	}
+	return {
+		text: out,
+		blocks
+	};
+}
+/** Ranges for canonical tokens whose sequence and line count match one block. */
+function findTokenRanges(text, blocks) {
+	if (!text || !blocks.length) return [];
+	const bySeq = new Map(unambiguousBlocks(blocks).map((block) => [block.seq, block]));
+	if (!bySeq.size) return [];
+	const tokenRegex = new RegExp(PASTE_TOKEN_SOURCE, "g");
+	const ranges = [];
+	let match;
+	while ((match = tokenRegex.exec(text)) !== null) {
+		const seq = Number(match[1]);
+		const lines = Number(match[2]);
+		if (!isPositiveSafeInteger(seq) || !isPositiveSafeInteger(lines)) continue;
+		const block = bySeq.get(seq);
+		if (block && block.lines === lines) ranges.push({
+			start: match.index,
+			end: match.index + match[0].length,
+			block
+		});
+	}
+	return ranges;
+}
+function tokenRangeAt(text, blocks, caret) {
+	if (!Number.isSafeInteger(caret) || caret < 0 || caret > text.length) return null;
+	for (const range of findTokenRanges(text, blocks)) if (caret >= range.start && caret <= range.end) return range;
+	return null;
+}
+function pruneBlocks(text, blocks) {
+	if (!blocks.length) return blocks;
+	const usable = unambiguousBlocks(blocks);
+	const survivors = new Set(findTokenRanges(text, usable).map((range) => range.block.id));
+	const next = usable.filter((block) => survivors.has(block.id));
+	return next.length === blocks.length && next.every((block, index) => block === blocks[index]) ? blocks : next;
+}
+function expandAll(text, blocks) {
+	if (!text || !blocks.length) return text;
+	const ranges = findTokenRanges(text, blocks);
+	if (!ranges.length) return text;
+	let out = text;
+	for (let index = ranges.length - 1; index >= 0; index -= 1) {
+		const range = ranges[index];
+		out = out.slice(0, range.start) + range.block.content + out.slice(range.end);
+	}
+	return out;
+}
+/** Inverse of `expandAll`: replace each first non-overlapping verbatim block. */
+function recollapsePastes(content, blocks) {
+	if (!content || !blocks.length) return content;
+	const hits = [];
+	const claimed = [];
+	const firstUnclaimed = (needle) => {
+		if (!needle) return -1;
+		let from = 0;
+		while (from <= content.length) {
+			const index = content.indexOf(needle, from);
+			if (index < 0) return -1;
+			if (!claimed.some(([start, end]) => index < end && index + needle.length > start)) return index;
+			from = index + 1;
+		}
+		return -1;
+	};
+	for (const block of unambiguousBlocks(blocks)) {
+		if (!block.content) continue;
+		const trimmed = block.content.trimEnd();
+		let needle = block.content;
+		let index = firstUnclaimed(needle);
+		if (index < 0 && trimmed && trimmed !== block.content) {
+			needle = trimmed;
+			index = firstUnclaimed(needle);
+		}
+		if (index < 0) continue;
+		const end = index + needle.length;
+		hits.push({
+			start: index,
+			end,
+			block
+		});
+		claimed.push([index, end]);
+	}
+	if (!hits.length) return content;
+	hits.sort((left, right) => left.start - right.start);
+	let out = "";
+	let position = 0;
+	for (const hit of hits) {
+		if (hit.start < position) continue;
+		out += content.slice(position, hit.start) + formatToken(hit.block);
+		position = hit.end;
+	}
+	return out + content.slice(position);
+}
+/** Strip a trailing whitespace run only when that run contains a newline. */
+function stripTrailingBlankLines(value) {
+	let index = value.length - 1;
+	let sawNewline = false;
+	while (index >= 0) {
+		const code = value.charCodeAt(index);
+		if (code === 10 || code === 13) {
+			sawNewline = true;
+			index -= 1;
+			continue;
+		}
+		if (code === 32 || code === 9) {
+			index -= 1;
+			continue;
+		}
+		break;
+	}
+	return sawNewline ? value.slice(0, index + 1) : value;
+}
+//#endregion
+export { PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, countLines, expandAll, findTokenRanges, formatToken, isPasteBlock, nextSeq, pruneBlocks, recollapsePastes, remapCarriedBlocks, shouldCollapse, stripTrailingBlankLines, tokenRangeAt };
+
+//# sourceMappingURL=paste-tokens.js.map

package/dist/components/conversation/paste-tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"paste-tokens.js","names":[],"sources":["../../../src/components/conversation/paste-tokens.ts"],"sourcesContent":["/**\n * Pure paste-token transformations translated and hardened from KiroCrew's\n * `website/src/utils/pasteTokens.ts` at revision\n * `283e136c0f902e965a535a7c9548c57c7504fed0` (Apache-2.0). See the #532 entry\n * in the repository NOTICE. Paste identity is supplied by the host; this module\n * does not access storage, clipboard APIs, message services, or editor state.\n */\n\n/** A collapsed paste block stored alongside input or a message. */\nexport interface PasteBlock {\n  /** A stable host-provided ASCII identifier; never included in visible token text. */\n  id: string\n  /** Positive safe integer, unique among blocks in the same text value. */\n  seq: number\n  /** Positive safe integer displayed in the token. */\n  lines: number\n  /** Original pasted text, retained verbatim. */\n  content: string\n}\n\nexport const PASTE_THRESHOLD_LINES = 3\nexport const PASTE_THRESHOLD_CHARS = 200\n\nconst PASTE_ID_PATTERN = /^[A-Za-z0-9._:-]{1,128}$/\nconst MAX_SAFE_SEQUENCE_TEXT_LENGTH = String(Number.MAX_SAFE_INTEGER).length\nconst PASTE_TOKEN_SOURCE = String.raw`\\[ Paste #([1-9]\\d{0,${MAX_SAFE_SEQUENCE_TEXT_LENGTH - 1}}) · ([1-9]\\d{0,${MAX_SAFE_SEQUENCE_TEXT_LENGTH - 1}}) lines \\]`\n\n/** Canonical token pattern. Internal scans always use a fresh RegExp instance. */\nexport const PASTE_TOKEN_REGEX = new RegExp(PASTE_TOKEN_SOURCE, 'g')\n\nfunction isPositiveSafeInteger(value: unknown): value is number {\n  return Number.isSafeInteger(value) && (value as number) > 0\n}\n\n/** Check data received from a host before using it as a paste-token block. */\nexport function isPasteBlock(value: unknown): value is PasteBlock {\n  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false\n  const candidate = value as Record<string, unknown>\n  return (\n    typeof candidate.id === 'string' &&\n    PASTE_ID_PATTERN.test(candidate.id) &&\n    isPositiveSafeInteger(candidate.seq) &&\n    isPositiveSafeInteger(candidate.lines) &&\n    typeof candidate.content === 'string'\n  )\n}\n\nfunction unambiguousBlocks(blocks: readonly PasteBlock[]): PasteBlock[] {\n  const valid = blocks.filter(isPasteBlock)\n  const seqCounts = new Map<number, number>()\n  const idCounts = new Map<string, number>()\n  for (const block of valid) {\n    seqCounts.set(block.seq, (seqCounts.get(block.seq) ?? 0) + 1)\n    idCounts.set(block.id, (idCounts.get(block.id) ?? 0) + 1)\n  }\n  return valid.filter((block) => seqCounts.get(block.seq) === 1 && idCounts.get(block.id) === 1)\n}\n\nexport function formatToken(block: PasteBlock): string {\n  if (!isPasteBlock(block)) throw new TypeError('Cannot format an invalid paste block')\n  return `[ Paste #${block.seq} · ${block.lines} lines ]`\n}\n\nexport function shouldCollapse(text: string): boolean {\n  if (!text) return false\n  return countLines(text) >= PASTE_THRESHOLD_LINES || text.length >= PASTE_THRESHOLD_CHARS\n}\n\nexport function countLines(text: string): number {\n  if (!text) return 0\n  return text.split('\\n').length\n}\n\n/** Next sequence for a new paste = max existing + 1, starting at 1. */\nexport function nextSeq(blocks: readonly PasteBlock[]): number {\n  let max = 0\n  for (const block of blocks) {\n    if (isPasteBlock(block) && block.seq > max) max = block.seq\n  }\n  if (max === Number.MAX_SAFE_INTEGER) throw new RangeError('Paste sequence space is exhausted')\n  return max + 1\n}\n\n/**\n * Re-sequence `carried` blocks whose sequence is already taken by `used`, and\n * rewrite their markers in one right-to-left pass. Carried block IDs and\n * sequences must be unique so a visible marker always has one backing block.\n * `used` is mutated to include the assigned sequences.\n */\nexport function remapCarriedBlocks(\n  text: string,\n  carried: readonly PasteBlock[],\n  used: Set<number>\n): { text: string; blocks: PasteBlock[] } {\n  const seenSeqs = new Set<number>()\n  const seenIds = new Set<string>()\n  for (const block of carried) {\n    if (!isPasteBlock(block)) throw new TypeError('Cannot remap an invalid paste block')\n    if (seenSeqs.has(block.seq) || seenIds.has(block.id)) {\n      throw new TypeError('Carried paste block IDs and sequences must be unique')\n    }\n    seenSeqs.add(block.seq)\n    seenIds.add(block.id)\n  }\n\n  let maxUsed = 0\n  for (const value of used) {\n    if (isPositiveSafeInteger(value) && value > maxUsed) maxUsed = value\n  }\n  let free = maxUsed < Number.MAX_SAFE_INTEGER ? maxUsed + 1 : 1\n  const allocateFree = (): number => {\n    while (used.has(free)) {\n      free = free < Number.MAX_SAFE_INTEGER ? free + 1 : 1\n    }\n    const assigned = free\n    used.add(assigned)\n    free = assigned < Number.MAX_SAFE_INTEGER ? assigned + 1 : 1\n    return assigned\n  }\n\n  const remap = new Map<number, number>()\n  const blocks = carried.map((block) => {\n    if (!used.has(block.seq)) {\n      used.add(block.seq)\n      return block\n    }\n    const seq = allocateFree()\n    remap.set(block.seq, seq)\n    return { ...block, seq }\n  })\n\n  if (!remap.size) return { text, blocks }\n\n  let out = text\n  const ranges = findTokenRanges(text, carried)\n  for (let index = ranges.length - 1; index >= 0; index -= 1) {\n    const { start, end, block } = ranges[index]!\n    const mapped = remap.get(block.seq)\n    if (mapped === undefined) continue\n    out = out.slice(0, start) + formatToken({ ...block, seq: mapped }) + out.slice(end)\n  }\n  return { text: out, blocks }\n}\n\n/** Ranges for canonical tokens whose sequence and line count match one block. */\nexport function findTokenRanges(\n  text: string,\n  blocks: readonly PasteBlock[]\n): Array<{ start: number; end: number; block: PasteBlock }> {\n  if (!text || !blocks.length) return []\n  const bySeq = new Map(unambiguousBlocks(blocks).map((block) => [block.seq, block]))\n  if (!bySeq.size) return []\n\n  const tokenRegex = new RegExp(PASTE_TOKEN_SOURCE, 'g')\n  const ranges: Array<{ start: number; end: number; block: PasteBlock }> = []\n  let match: RegExpExecArray | null\n  while ((match = tokenRegex.exec(text)) !== null) {\n    const seq = Number(match[1])\n    const lines = Number(match[2])\n    if (!isPositiveSafeInteger(seq) || !isPositiveSafeInteger(lines)) continue\n    const block = bySeq.get(seq)\n    if (block && block.lines === lines) {\n      ranges.push({ start: match.index, end: match.index + match[0].length, block })\n    }\n  }\n  return ranges\n}\n\nexport function tokenRangeAt(\n  text: string,\n  blocks: readonly PasteBlock[],\n  caret: number\n): { start: number; end: number; block: PasteBlock } | null {\n  if (!Number.isSafeInteger(caret) || caret < 0 || caret > text.length) return null\n  for (const range of findTokenRanges(text, blocks)) {\n    if (caret >= range.start && caret <= range.end) return range\n  }\n  return null\n}\n\nexport function pruneBlocks(text: string, blocks: PasteBlock[]): PasteBlock[] {\n  if (!blocks.length) return blocks\n  const usable = unambiguousBlocks(blocks)\n  const survivors = new Set(findTokenRanges(text, usable).map((range) => range.block.id))\n  const next = usable.filter((block) => survivors.has(block.id))\n  return next.length === blocks.length && next.every((block, index) => block === blocks[index])\n    ? blocks\n    : next\n}\n\nexport function expandAll(text: string, blocks: readonly PasteBlock[]): string {\n  if (!text || !blocks.length) return text\n  const ranges = findTokenRanges(text, blocks)\n  if (!ranges.length) return text\n  let out = text\n  for (let index = ranges.length - 1; index >= 0; index -= 1) {\n    const range = ranges[index]!\n    out = out.slice(0, range.start) + range.block.content + out.slice(range.end)\n  }\n  return out\n}\n\n/** Inverse of `expandAll`: replace each first non-overlapping verbatim block. */\nexport function recollapsePastes(content: string, blocks: readonly PasteBlock[]): string {\n  if (!content || !blocks.length) return content\n\n  interface Hit {\n    start: number\n    end: number\n    block: PasteBlock\n  }\n  const hits: Hit[] = []\n  const claimed: Array<[number, number]> = []\n  const firstUnclaimed = (needle: string): number => {\n    if (!needle) return -1\n    let from = 0\n    while (from <= content.length) {\n      const index = content.indexOf(needle, from)\n      if (index < 0) return -1\n      if (!claimed.some(([start, end]) => index < end && index + needle.length > start))\n        return index\n      from = index + 1\n    }\n    return -1\n  }\n\n  for (const block of unambiguousBlocks(blocks)) {\n    if (!block.content) continue\n    const trimmed = block.content.trimEnd()\n    let needle = block.content\n    let index = firstUnclaimed(needle)\n    if (index < 0 && trimmed && trimmed !== block.content) {\n      needle = trimmed\n      index = firstUnclaimed(needle)\n    }\n    if (index < 0) continue\n    const end = index + needle.length\n    hits.push({ start: index, end, block })\n    claimed.push([index, end])\n  }\n\n  if (!hits.length) return content\n  hits.sort((left, right) => left.start - right.start)\n  let out = ''\n  let position = 0\n  for (const hit of hits) {\n    if (hit.start < position) continue\n    out += content.slice(position, hit.start) + formatToken(hit.block)\n    position = hit.end\n  }\n  return out + content.slice(position)\n}\n\n/** Strip a trailing whitespace run only when that run contains a newline. */\nexport function stripTrailingBlankLines(value: string): string {\n  let index = value.length - 1\n  let sawNewline = false\n  while (index >= 0) {\n    const code = value.charCodeAt(index)\n    if (code === 10 || code === 13) {\n      sawNewline = true\n      index -= 1\n      continue\n    }\n    if (code === 32 || code === 9) {\n      index -= 1\n      continue\n    }\n    break\n  }\n  return sawNewline ? value.slice(0, index + 1) : value\n}\n"],"mappings":"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"}

package/dist/index.js

@@ -77,6 +77,7 @@ import { ConversationSurface } from "./components/conversation/conversation-surf
 import { ComposerAttachmentButton, ComposerHint, MessageComposer } from "./components/conversation/message-composer.js";
 import { MessageBody, MessageDayDivider, MessageGroup, MessageRow } from "./components/conversation/message-row.js";
 import { AttachmentCard, ThreadPanel } from "./components/conversation/thread-panel.js";
+import { PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, countLines, expandAll, findTokenRanges, formatToken, isPasteBlock, nextSeq, pruneBlocks, recollapsePastes, remapCarriedBlocks, shouldCollapse, stripTrailingBlankLines, tokenRangeAt } from "./components/conversation/paste-tokens.js";
 import { accentPresets, allTokens, colorTokens, densityTokens, designTokens, elevationTokens, fontOptions, motionTokens, radiusTokens, typographyTokens, undocumentedTokenAliases, zIndexTokens } from "./lib/tokens.js";
 import { builtinThemes, contrastRatio, defaultDarkThemeId, defaultLightThemeId, themeById, themeCssVariables, themeFamilies, themesForAppearance, validateTheme, validateThemeRegistry } from "./lib/themes.js";
 import { ThemePicker, ThemePreview, ThemeSwatch } from "./components/theme/theme-picker.js";
@@ -93,4 +94,4 @@ import { formatBytes, formatReleaseDate, plainTextFromMarkdown } from "./lib/ver
 import { UpdateDialog } from "./components/composites/update-dialog/update-dialog.js";
 import { WorkspaceMark } from "./components/composites/workspace-mark/workspace-mark.js";
 import { keyedRows } from "./lib/keyed-rows.js";
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, AccountMenu, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppShell, AppShellBody, AppShellContent, AppShellMain, AppearanceEditor, AppearancePanel, AppearancePopover, AspectRatio, AttachmentCard, Avatar, AvatarFallback, AvatarImage, Badge, Board, BoardCardBody, BoardCardTitle, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbSeparator, BusySendButton, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CalendarSurface, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, ChatComposer, Checkbox, CheckboxDescription, CheckboxLabel, CodeBlock, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxClear, ComboboxContent, ComboboxControl, ComboboxInput, ComboboxItem, ComboboxSection, ComboboxTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandLoading, CommandSeparator, CommandShortcut, ComposerAttachmentButton, ComposerHint, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ConversationAvatar, ConversationSurface, DatePicker, DetailPanel, DetailPanelBody, DetailPanelField, DetailPanelHeader, DetailPanelSection, Dialog, DialogClose, DialogCloseButton, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiffBlock, DiffSummary, Drawer, DrawerBody, DrawerCloseButton, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, EntityIcon, Field, FieldDescription, FieldError, FieldInput, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTextArea, HoverCard, HoverCardContent, HoverCardTrigger, InlineCode, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputOtp, InputOtpCaret, Item, ItemDescription, ItemEmpty, ItemGroup, ItemGroupEntry, ItemTitle, Kbd, KbdGroup, Label, ListGroup, ListRow, MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MessageBody, MessageComposer, MessageDayDivider, MessageGroup, MessageRow, ModalDialog, Motion, NavigationMenu, NavigationMenuContent, NavigationMenuGroup, NavigationMenuGroupLabel, NavigationMenuItem, NavigationMenuMenu, NavigationMenuSeparator, NavigationMenuTrigger, NavigationMenuViewport, Page, PageHeader, PageHeaderActions, PageHeaderContent, PageHeaderDescription, PageHeaderTitle, PageSection, Pagination, PaginationEllipsis, PaginationItem, PaginationNext, PaginationPrevious, PalettePreview, Panel, PanelActions, PanelBody, PanelCard, PanelDescription, PanelFooter, PanelHeader, PanelPlaceholder, PanelTitle, PanelToolbar, Popover, PopoverAnchor, PopoverCloseButton, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger, Presence, Progress, PropertyList, PropertyRow, PropertyTerm, PropertyValue, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, Select, SelectChevronsUpDown, SelectContent, SelectItem, SelectLabel, SelectSection, SelectTrigger, SelectValue, Separator, SettingsField, SettingsPage, SettingsRow, SettingsSection, Sheet, SheetBody, SheetCloseButton, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, SideRail, SideRailButton, SideRailContent, SideRailFooter, SideRailHeader, SideRailItem, SideRailSection, SidebarNav, SidebarNavButton, SidebarNavContent, SidebarNavFooter, SidebarNavHeader, SidebarNavItem, SidebarNavSection, SidebarNavTitle, Skeleton, Slider, Spinner, SplitLayout, Stat, StatGroup, StatusBar, StatusBarItem, StatusBarSpacer, StatusChip, StatusList, Switch, SwitchDescription, SwitchLabel, TALL_CODE_BLOCK_PX, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableNumericCell, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, ThemeMiniature, ThemeMiniatureSplit, ThemePicker, ThemePreview, ThemeProvider, ThemeSwatch, ThemeToggle, ThreadPanel, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopBar, TopBarBreadcrumb, TopBarPill, TopBarSearch, TopBarSection, TopBarTitle, UpdateDialog, WorkspaceMark, accentPresets, alertVariants, allTokens, badgeVariants, boardCardTitleVariants, builtinThemes, buttonVariants, closePane, cn, colorTokens, computeLayoutFrames, contrastRatio, controlInteractive, controlSize, controlSizeIcon, controlSizes, countLeaves, createLayoutState, cva, defaultDarkThemeId, defaultLightThemeId, defaultThemeSelection, densityTokens, designTokens, diffLineVariants, diffStats, diffTargetPath, elevationTokens, entityIconVariants, focusPane, fontOptions, formatBytes, formatReleaseDate, initialsFrom, inlineScriptLiteral, itemVariants, keyedRows, layoutDepth, listLeaves, monogram, motionTokens, movePane, neighborLeaf, normalizeLayout, parseDiff, plainTextFromMarkdown, radiusTokens, resizeSplit, resolvedDensity, sheetVariants, sidebarNavItemClass, sidebarNavItemStateClass, splitPane, statusDotVariants, surfaceInteractive, swapPanes, themeById, themeCssVariables, themeFamilies, themeScript, themesForAppearance, toast, toaster, toggleVariants, typographyTokens, undoClosePane, undocumentedTokenAliases, useSideRail, useTheme, validateTheme, validateThemeRegistry, zIndexTokens };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, AccountMenu, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AppShell, AppShellBody, AppShellContent, AppShellMain, AppearanceEditor, AppearancePanel, AppearancePopover, AspectRatio, AttachmentCard, Avatar, AvatarFallback, AvatarImage, Badge, Board, BoardCardBody, BoardCardTitle, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbSeparator, BusySendButton, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CalendarSurface, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, ChatComposer, Checkbox, CheckboxDescription, CheckboxLabel, CodeBlock, Collapsible, CollapsibleContent, CollapsibleTrigger, Combobox, ComboboxClear, ComboboxContent, ComboboxControl, ComboboxInput, ComboboxItem, ComboboxSection, ComboboxTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandLoading, CommandSeparator, CommandShortcut, ComposerAttachmentButton, ComposerHint, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, ConversationAvatar, ConversationSurface, DatePicker, DetailPanel, DetailPanelBody, DetailPanelField, DetailPanelHeader, DetailPanelSection, Dialog, DialogClose, DialogCloseButton, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DiffBlock, DiffSummary, Drawer, DrawerBody, DrawerCloseButton, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, EntityIcon, Field, FieldDescription, FieldError, FieldInput, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTextArea, HoverCard, HoverCardContent, HoverCardTrigger, InlineCode, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputOtp, InputOtpCaret, Item, ItemDescription, ItemEmpty, ItemGroup, ItemGroupEntry, ItemTitle, Kbd, KbdGroup, Label, ListGroup, ListRow, MAX_LAYOUT_DEPTH, MAX_LAYOUT_LEAVES, MAX_SPLIT_RATIO, MIN_SPLIT_RATIO, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, MessageBody, MessageComposer, MessageDayDivider, MessageGroup, MessageRow, ModalDialog, Motion, NavigationMenu, NavigationMenuContent, NavigationMenuGroup, NavigationMenuGroupLabel, NavigationMenuItem, NavigationMenuMenu, NavigationMenuSeparator, NavigationMenuTrigger, NavigationMenuViewport, PASTE_THRESHOLD_CHARS, PASTE_THRESHOLD_LINES, PASTE_TOKEN_REGEX, Page, PageHeader, PageHeaderActions, PageHeaderContent, PageHeaderDescription, PageHeaderTitle, PageSection, Pagination, PaginationEllipsis, PaginationItem, PaginationNext, PaginationPrevious, PalettePreview, Panel, PanelActions, PanelBody, PanelCard, PanelDescription, PanelFooter, PanelHeader, PanelPlaceholder, PanelTitle, PanelToolbar, Popover, PopoverAnchor, PopoverCloseButton, PopoverContent, PopoverDescription, PopoverTitle, PopoverTrigger, Presence, Progress, PropertyList, PropertyRow, PropertyTerm, PropertyValue, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScrollArea, Select, SelectChevronsUpDown, SelectContent, SelectItem, SelectLabel, SelectSection, SelectTrigger, SelectValue, Separator, SettingsField, SettingsPage, SettingsRow, SettingsSection, Sheet, SheetBody, SheetCloseButton, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, SideRail, SideRailButton, SideRailContent, SideRailFooter, SideRailHeader, SideRailItem, SideRailSection, SidebarNav, SidebarNavButton, SidebarNavContent, SidebarNavFooter, SidebarNavHeader, SidebarNavItem, SidebarNavSection, SidebarNavTitle, Skeleton, Slider, Spinner, SplitLayout, Stat, StatGroup, StatusBar, StatusBarItem, StatusBarSpacer, StatusChip, StatusList, Switch, SwitchDescription, SwitchLabel, TALL_CODE_BLOCK_PX, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableNumericCell, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, ThemeMiniature, ThemeMiniatureSplit, ThemePicker, ThemePreview, ThemeProvider, ThemeSwatch, ThemeToggle, ThreadPanel, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, TopBar, TopBarBreadcrumb, TopBarPill, TopBarSearch, TopBarSection, TopBarTitle, UpdateDialog, WorkspaceMark, accentPresets, alertVariants, allTokens, badgeVariants, boardCardTitleVariants, builtinThemes, buttonVariants, closePane, cn, colorTokens, computeLayoutFrames, contrastRatio, controlInteractive, controlSize, controlSizeIcon, controlSizes, countLeaves, countLines, createLayoutState, cva, defaultDarkThemeId, defaultLightThemeId, defaultThemeSelection, densityTokens, designTokens, diffLineVariants, diffStats, diffTargetPath, elevationTokens, entityIconVariants, expandAll, findTokenRanges, focusPane, fontOptions, formatBytes, formatReleaseDate, formatToken, initialsFrom, inlineScriptLiteral, isPasteBlock, itemVariants, keyedRows, layoutDepth, listLeaves, monogram, motionTokens, movePane, neighborLeaf, nextSeq, normalizeLayout, parseDiff, plainTextFromMarkdown, pruneBlocks, radiusTokens, recollapsePastes, remapCarriedBlocks, resizeSplit, resolvedDensity, sheetVariants, shouldCollapse, sidebarNavItemClass, sidebarNavItemStateClass, splitPane, statusDotVariants, stripTrailingBlankLines, surfaceInteractive, swapPanes, themeById, themeCssVariables, themeFamilies, themeScript, themesForAppearance, toast, toaster, toggleVariants, tokenRangeAt, typographyTokens, undoClosePane, undocumentedTokenAliases, useSideRail, useTheme, validateTheme, validateThemeRegistry, zIndexTokens };

package/dist/r/conversation.json

@@ -57,6 +57,11 @@
       "type": "registry:ui",
       "target": "components/conversation/message-row.tsx"
     },
+    {
+      "path": "src/components/conversation/paste-tokens.ts",
+      "type": "registry:ui",
+      "target": "components/conversation/paste-tokens.ts"
+    },
     {
       "path": "src/components/conversation/scroll-follow-core.ts",
       "type": "registry:ui",

package/dist/r/registry.json

@@ -1871,6 +1871,11 @@
           "type": "registry:ui",
           "target": "components/conversation/message-row.tsx"
         },
+        {
+          "path": "src/components/conversation/paste-tokens.ts",
+          "type": "registry:ui",
+          "target": "components/conversation/paste-tokens.ts"
+        },
         {
           "path": "src/components/conversation/scroll-follow-core.ts",
           "type": "registry:ui",

package/dist/r/src/components/conversation/index.ts

@@ -25,3 +25,22 @@ export {
   type AttachmentCardProps,
   type ThreadPanelProps,
 } from './thread-panel'
+// Issue #532 selected pure paste-token model.
+export {
+  countLines,
+  expandAll,
+  findTokenRanges,
+  formatToken,
+  isPasteBlock,
+  nextSeq,
+  pruneBlocks,
+  recollapsePastes,
+  remapCarriedBlocks,
+  shouldCollapse,
+  stripTrailingBlankLines,
+  tokenRangeAt,
+  PASTE_THRESHOLD_CHARS,
+  PASTE_THRESHOLD_LINES,
+  PASTE_TOKEN_REGEX,
+  type PasteBlock,
+} from './paste-tokens'

package/dist/r/src/components/conversation/paste-tokens.ts

@@ -0,0 +1,272 @@
+/**
+ * Pure paste-token transformations translated and hardened from KiroCrew's
+ * `website/src/utils/pasteTokens.ts` at revision
+ * `283e136c0f902e965a535a7c9548c57c7504fed0` (Apache-2.0). See the #532 entry
+ * in the repository NOTICE. Paste identity is supplied by the host; this module
+ * does not access storage, clipboard APIs, message services, or editor state.
+ */
+
+/** A collapsed paste block stored alongside input or a message. */
+export interface PasteBlock {
+  /** A stable host-provided ASCII identifier; never included in visible token text. */
+  id: string
+  /** Positive safe integer, unique among blocks in the same text value. */
+  seq: number
+  /** Positive safe integer displayed in the token. */
+  lines: number
+  /** Original pasted text, retained verbatim. */
+  content: string
+}
+
+export const PASTE_THRESHOLD_LINES = 3
+export const PASTE_THRESHOLD_CHARS = 200
+
+const PASTE_ID_PATTERN = /^[A-Za-z0-9._:-]{1,128}$/
+const MAX_SAFE_SEQUENCE_TEXT_LENGTH = String(Number.MAX_SAFE_INTEGER).length
+const PASTE_TOKEN_SOURCE = String.raw`\[ Paste #([1-9]\d{0,${MAX_SAFE_SEQUENCE_TEXT_LENGTH - 1}}) · ([1-9]\d{0,${MAX_SAFE_SEQUENCE_TEXT_LENGTH - 1}}) lines \]`
+
+/** Canonical token pattern. Internal scans always use a fresh RegExp instance. */
+export const PASTE_TOKEN_REGEX = new RegExp(PASTE_TOKEN_SOURCE, 'g')
+
+function isPositiveSafeInteger(value: unknown): value is number {
+  return Number.isSafeInteger(value) && (value as number) > 0
+}
+
+/** Check data received from a host before using it as a paste-token block. */
+export function isPasteBlock(value: unknown): value is PasteBlock {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false
+  const candidate = value as Record<string, unknown>
+  return (
+    typeof candidate.id === 'string' &&
+    PASTE_ID_PATTERN.test(candidate.id) &&
+    isPositiveSafeInteger(candidate.seq) &&
+    isPositiveSafeInteger(candidate.lines) &&
+    typeof candidate.content === 'string'
+  )
+}
+
+function unambiguousBlocks(blocks: readonly PasteBlock[]): PasteBlock[] {
+  const valid = blocks.filter(isPasteBlock)
+  const seqCounts = new Map<number, number>()
+  const idCounts = new Map<string, number>()
+  for (const block of valid) {
+    seqCounts.set(block.seq, (seqCounts.get(block.seq) ?? 0) + 1)
+    idCounts.set(block.id, (idCounts.get(block.id) ?? 0) + 1)
+  }
+  return valid.filter((block) => seqCounts.get(block.seq) === 1 && idCounts.get(block.id) === 1)
+}
+
+export function formatToken(block: PasteBlock): string {
+  if (!isPasteBlock(block)) throw new TypeError('Cannot format an invalid paste block')
+  return `[ Paste #${block.seq} · ${block.lines} lines ]`
+}
+
+export function shouldCollapse(text: string): boolean {
+  if (!text) return false
+  return countLines(text) >= PASTE_THRESHOLD_LINES || text.length >= PASTE_THRESHOLD_CHARS
+}
+
+export function countLines(text: string): number {
+  if (!text) return 0
+  return text.split('\n').length
+}
+
+/** Next sequence for a new paste = max existing + 1, starting at 1. */
+export function nextSeq(blocks: readonly PasteBlock[]): number {
+  let max = 0
+  for (const block of blocks) {
+    if (isPasteBlock(block) && block.seq > max) max = block.seq
+  }
+  if (max === Number.MAX_SAFE_INTEGER) throw new RangeError('Paste sequence space is exhausted')
+  return max + 1
+}
+
+/**
+ * Re-sequence `carried` blocks whose sequence is already taken by `used`, and
+ * rewrite their markers in one right-to-left pass. Carried block IDs and
+ * sequences must be unique so a visible marker always has one backing block.
+ * `used` is mutated to include the assigned sequences.
+ */
+export function remapCarriedBlocks(
+  text: string,
+  carried: readonly PasteBlock[],
+  used: Set<number>
+): { text: string; blocks: PasteBlock[] } {
+  const seenSeqs = new Set<number>()
+  const seenIds = new Set<string>()
+  for (const block of carried) {
+    if (!isPasteBlock(block)) throw new TypeError('Cannot remap an invalid paste block')
+    if (seenSeqs.has(block.seq) || seenIds.has(block.id)) {
+      throw new TypeError('Carried paste block IDs and sequences must be unique')
+    }
+    seenSeqs.add(block.seq)
+    seenIds.add(block.id)
+  }
+
+  let maxUsed = 0
+  for (const value of used) {
+    if (isPositiveSafeInteger(value) && value > maxUsed) maxUsed = value
+  }
+  let free = maxUsed < Number.MAX_SAFE_INTEGER ? maxUsed + 1 : 1
+  const allocateFree = (): number => {
+    while (used.has(free)) {
+      free = free < Number.MAX_SAFE_INTEGER ? free + 1 : 1
+    }
+    const assigned = free
+    used.add(assigned)
+    free = assigned < Number.MAX_SAFE_INTEGER ? assigned + 1 : 1
+    return assigned
+  }
+
+  const remap = new Map<number, number>()
+  const blocks = carried.map((block) => {
+    if (!used.has(block.seq)) {
+      used.add(block.seq)
+      return block
+    }
+    const seq = allocateFree()
+    remap.set(block.seq, seq)
+    return { ...block, seq }
+  })
+
+  if (!remap.size) return { text, blocks }
+
+  let out = text
+  const ranges = findTokenRanges(text, carried)
+  for (let index = ranges.length - 1; index >= 0; index -= 1) {
+    const { start, end, block } = ranges[index]!
+    const mapped = remap.get(block.seq)
+    if (mapped === undefined) continue
+    out = out.slice(0, start) + formatToken({ ...block, seq: mapped }) + out.slice(end)
+  }
+  return { text: out, blocks }
+}
+
+/** Ranges for canonical tokens whose sequence and line count match one block. */
+export function findTokenRanges(
+  text: string,
+  blocks: readonly PasteBlock[]
+): Array<{ start: number; end: number; block: PasteBlock }> {
+  if (!text || !blocks.length) return []
+  const bySeq = new Map(unambiguousBlocks(blocks).map((block) => [block.seq, block]))
+  if (!bySeq.size) return []
+
+  const tokenRegex = new RegExp(PASTE_TOKEN_SOURCE, 'g')
+  const ranges: Array<{ start: number; end: number; block: PasteBlock }> = []
+  let match: RegExpExecArray | null
+  while ((match = tokenRegex.exec(text)) !== null) {
+    const seq = Number(match[1])
+    const lines = Number(match[2])
+    if (!isPositiveSafeInteger(seq) || !isPositiveSafeInteger(lines)) continue
+    const block = bySeq.get(seq)
+    if (block && block.lines === lines) {
+      ranges.push({ start: match.index, end: match.index + match[0].length, block })
+    }
+  }
+  return ranges
+}
+
+export function tokenRangeAt(
+  text: string,
+  blocks: readonly PasteBlock[],
+  caret: number
+): { start: number; end: number; block: PasteBlock } | null {
+  if (!Number.isSafeInteger(caret) || caret < 0 || caret > text.length) return null
+  for (const range of findTokenRanges(text, blocks)) {
+    if (caret >= range.start && caret <= range.end) return range
+  }
+  return null
+}
+
+export function pruneBlocks(text: string, blocks: PasteBlock[]): PasteBlock[] {
+  if (!blocks.length) return blocks
+  const usable = unambiguousBlocks(blocks)
+  const survivors = new Set(findTokenRanges(text, usable).map((range) => range.block.id))
+  const next = usable.filter((block) => survivors.has(block.id))
+  return next.length === blocks.length && next.every((block, index) => block === blocks[index])
+    ? blocks
+    : next
+}
+
+export function expandAll(text: string, blocks: readonly PasteBlock[]): string {
+  if (!text || !blocks.length) return text
+  const ranges = findTokenRanges(text, blocks)
+  if (!ranges.length) return text
+  let out = text
+  for (let index = ranges.length - 1; index >= 0; index -= 1) {
+    const range = ranges[index]!
+    out = out.slice(0, range.start) + range.block.content + out.slice(range.end)
+  }
+  return out
+}
+
+/** Inverse of `expandAll`: replace each first non-overlapping verbatim block. */
+export function recollapsePastes(content: string, blocks: readonly PasteBlock[]): string {
+  if (!content || !blocks.length) return content
+
+  interface Hit {
+    start: number
+    end: number
+    block: PasteBlock
+  }
+  const hits: Hit[] = []
+  const claimed: Array<[number, number]> = []
+  const firstUnclaimed = (needle: string): number => {
+    if (!needle) return -1
+    let from = 0
+    while (from <= content.length) {
+      const index = content.indexOf(needle, from)
+      if (index < 0) return -1
+      if (!claimed.some(([start, end]) => index < end && index + needle.length > start))
+        return index
+      from = index + 1
+    }
+    return -1
+  }
+
+  for (const block of unambiguousBlocks(blocks)) {
+    if (!block.content) continue
+    const trimmed = block.content.trimEnd()
+    let needle = block.content
+    let index = firstUnclaimed(needle)
+    if (index < 0 && trimmed && trimmed !== block.content) {
+      needle = trimmed
+      index = firstUnclaimed(needle)
+    }
+    if (index < 0) continue
+    const end = index + needle.length
+    hits.push({ start: index, end, block })
+    claimed.push([index, end])
+  }
+
+  if (!hits.length) return content
+  hits.sort((left, right) => left.start - right.start)
+  let out = ''
+  let position = 0
+  for (const hit of hits) {
+    if (hit.start < position) continue
+    out += content.slice(position, hit.start) + formatToken(hit.block)
+    position = hit.end
+  }
+  return out + content.slice(position)
+}
+
+/** Strip a trailing whitespace run only when that run contains a newline. */
+export function stripTrailingBlankLines(value: string): string {
+  let index = value.length - 1
+  let sawNewline = false
+  while (index >= 0) {
+    const code = value.charCodeAt(index)
+    if (code === 10 || code === 13) {
+      sawNewline = true
+      index -= 1
+      continue
+    }
+    if (code === 32 || code === 9) {
+      index -= 1
+      continue
+    }
+    break
+  }
+  return sawNewline ? value.slice(0, index + 1) : value
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adea-ai/ui",
-  "version": "0.66.1",
+  "version": "0.67.0",
   "description": "The Adea design system: Kobalte-backed Solid components, semantic OKLCH tokens, and the app-shell layout primitives shared by Adea and Cortana.",
   "keywords": [
     "adea",
@@ -70,6 +70,12 @@
       "solid": "./src/components/layout/split-layout/model.ts",
       "development": "./src/components/layout/split-layout/model.ts",
       "import": "./dist/components/layout/split-layout/model.js"
+    },
+    "./components/conversation/paste-tokens": {
+      "types": "./dist/components/conversation/paste-tokens.d.ts",
+      "solid": "./src/components/conversation/paste-tokens.ts",
+      "development": "./src/components/conversation/paste-tokens.ts",
+      "import": "./dist/components/conversation/paste-tokens.js"
     }
   },
   "scripts": {
@@ -88,7 +94,8 @@
     "check:packed-consumer": "bun scripts/check-packed-consumer.ts",
     "check:packed-conversation": "bun scripts/check-packed-conversation.ts",
     "check:packed-layout-renderer": "bun scripts/check-packed-layout-renderer.ts",
-    "check:packed-appearance": "bun scripts/check-packed-appearance.ts"
+    "check:packed-appearance": "bun scripts/check-packed-appearance.ts",
+    "check:packed-paste-model": "node scripts/check-packed-paste-model.mjs"
   },
   "dependencies": {
     "@adea-ai/themes": "^0.5.0",

package/registry.json

@@ -1871,6 +1871,11 @@
           "type": "registry:ui",
           "target": "components/conversation/message-row.tsx"
         },
+        {
+          "path": "src/components/conversation/paste-tokens.ts",
+          "type": "registry:ui",
+          "target": "components/conversation/paste-tokens.ts"
+        },
         {
           "path": "src/components/conversation/scroll-follow-core.ts",
           "type": "registry:ui",

package/src/components/conversation/index.ts

@@ -25,3 +25,22 @@ export {
   type AttachmentCardProps,
   type ThreadPanelProps,
 } from './thread-panel'
+// Issue #532 selected pure paste-token model.
+export {
+  countLines,
+  expandAll,
+  findTokenRanges,
+  formatToken,
+  isPasteBlock,
+  nextSeq,
+  pruneBlocks,
+  recollapsePastes,
+  remapCarriedBlocks,
+  shouldCollapse,
+  stripTrailingBlankLines,
+  tokenRangeAt,
+  PASTE_THRESHOLD_CHARS,
+  PASTE_THRESHOLD_LINES,
+  PASTE_TOKEN_REGEX,
+  type PasteBlock,
+} from './paste-tokens'

package/src/components/conversation/paste-tokens.ts

@@ -0,0 +1,272 @@
+/**
+ * Pure paste-token transformations translated and hardened from KiroCrew's
+ * `website/src/utils/pasteTokens.ts` at revision
+ * `283e136c0f902e965a535a7c9548c57c7504fed0` (Apache-2.0). See the #532 entry
+ * in the repository NOTICE. Paste identity is supplied by the host; this module
+ * does not access storage, clipboard APIs, message services, or editor state.
+ */
+
+/** A collapsed paste block stored alongside input or a message. */
+export interface PasteBlock {
+  /** A stable host-provided ASCII identifier; never included in visible token text. */
+  id: string
+  /** Positive safe integer, unique among blocks in the same text value. */
+  seq: number
+  /** Positive safe integer displayed in the token. */
+  lines: number
+  /** Original pasted text, retained verbatim. */
+  content: string
+}
+
+export const PASTE_THRESHOLD_LINES = 3
+export const PASTE_THRESHOLD_CHARS = 200
+
+const PASTE_ID_PATTERN = /^[A-Za-z0-9._:-]{1,128}$/
+const MAX_SAFE_SEQUENCE_TEXT_LENGTH = String(Number.MAX_SAFE_INTEGER).length
+const PASTE_TOKEN_SOURCE = String.raw`\[ Paste #([1-9]\d{0,${MAX_SAFE_SEQUENCE_TEXT_LENGTH - 1}}) · ([1-9]\d{0,${MAX_SAFE_SEQUENCE_TEXT_LENGTH - 1}}) lines \]`
+
+/** Canonical token pattern. Internal scans always use a fresh RegExp instance. */
+export const PASTE_TOKEN_REGEX = new RegExp(PASTE_TOKEN_SOURCE, 'g')
+
+function isPositiveSafeInteger(value: unknown): value is number {
+  return Number.isSafeInteger(value) && (value as number) > 0
+}
+
+/** Check data received from a host before using it as a paste-token block. */
+export function isPasteBlock(value: unknown): value is PasteBlock {
+  if (typeof value !== 'object' || value === null || Array.isArray(value)) return false
+  const candidate = value as Record<string, unknown>
+  return (
+    typeof candidate.id === 'string' &&
+    PASTE_ID_PATTERN.test(candidate.id) &&
+    isPositiveSafeInteger(candidate.seq) &&
+    isPositiveSafeInteger(candidate.lines) &&
+    typeof candidate.content === 'string'
+  )
+}
+
+function unambiguousBlocks(blocks: readonly PasteBlock[]): PasteBlock[] {
+  const valid = blocks.filter(isPasteBlock)
+  const seqCounts = new Map<number, number>()
+  const idCounts = new Map<string, number>()
+  for (const block of valid) {
+    seqCounts.set(block.seq, (seqCounts.get(block.seq) ?? 0) + 1)
+    idCounts.set(block.id, (idCounts.get(block.id) ?? 0) + 1)
+  }
+  return valid.filter((block) => seqCounts.get(block.seq) === 1 && idCounts.get(block.id) === 1)
+}
+
+export function formatToken(block: PasteBlock): string {
+  if (!isPasteBlock(block)) throw new TypeError('Cannot format an invalid paste block')
+  return `[ Paste #${block.seq} · ${block.lines} lines ]`
+}
+
+export function shouldCollapse(text: string): boolean {
+  if (!text) return false
+  return countLines(text) >= PASTE_THRESHOLD_LINES || text.length >= PASTE_THRESHOLD_CHARS
+}
+
+export function countLines(text: string): number {
+  if (!text) return 0
+  return text.split('\n').length
+}
+
+/** Next sequence for a new paste = max existing + 1, starting at 1. */
+export function nextSeq(blocks: readonly PasteBlock[]): number {
+  let max = 0
+  for (const block of blocks) {
+    if (isPasteBlock(block) && block.seq > max) max = block.seq
+  }
+  if (max === Number.MAX_SAFE_INTEGER) throw new RangeError('Paste sequence space is exhausted')
+  return max + 1
+}
+
+/**
+ * Re-sequence `carried` blocks whose sequence is already taken by `used`, and
+ * rewrite their markers in one right-to-left pass. Carried block IDs and
+ * sequences must be unique so a visible marker always has one backing block.
+ * `used` is mutated to include the assigned sequences.
+ */
+export function remapCarriedBlocks(
+  text: string,
+  carried: readonly PasteBlock[],
+  used: Set<number>
+): { text: string; blocks: PasteBlock[] } {
+  const seenSeqs = new Set<number>()
+  const seenIds = new Set<string>()
+  for (const block of carried) {
+    if (!isPasteBlock(block)) throw new TypeError('Cannot remap an invalid paste block')
+    if (seenSeqs.has(block.seq) || seenIds.has(block.id)) {
+      throw new TypeError('Carried paste block IDs and sequences must be unique')
+    }
+    seenSeqs.add(block.seq)
+    seenIds.add(block.id)
+  }
+
+  let maxUsed = 0
+  for (const value of used) {
+    if (isPositiveSafeInteger(value) && value > maxUsed) maxUsed = value
+  }
+  let free = maxUsed < Number.MAX_SAFE_INTEGER ? maxUsed + 1 : 1
+  const allocateFree = (): number => {
+    while (used.has(free)) {
+      free = free < Number.MAX_SAFE_INTEGER ? free + 1 : 1
+    }
+    const assigned = free
+    used.add(assigned)
+    free = assigned < Number.MAX_SAFE_INTEGER ? assigned + 1 : 1
+    return assigned
+  }
+
+  const remap = new Map<number, number>()
+  const blocks = carried.map((block) => {
+    if (!used.has(block.seq)) {
+      used.add(block.seq)
+      return block
+    }
+    const seq = allocateFree()
+    remap.set(block.seq, seq)
+    return { ...block, seq }
+  })
+
+  if (!remap.size) return { text, blocks }
+
+  let out = text
+  const ranges = findTokenRanges(text, carried)
+  for (let index = ranges.length - 1; index >= 0; index -= 1) {
+    const { start, end, block } = ranges[index]!
+    const mapped = remap.get(block.seq)
+    if (mapped === undefined) continue
+    out = out.slice(0, start) + formatToken({ ...block, seq: mapped }) + out.slice(end)
+  }
+  return { text: out, blocks }
+}
+
+/** Ranges for canonical tokens whose sequence and line count match one block. */
+export function findTokenRanges(
+  text: string,
+  blocks: readonly PasteBlock[]
+): Array<{ start: number; end: number; block: PasteBlock }> {
+  if (!text || !blocks.length) return []
+  const bySeq = new Map(unambiguousBlocks(blocks).map((block) => [block.seq, block]))
+  if (!bySeq.size) return []
+
+  const tokenRegex = new RegExp(PASTE_TOKEN_SOURCE, 'g')
+  const ranges: Array<{ start: number; end: number; block: PasteBlock }> = []
+  let match: RegExpExecArray | null
+  while ((match = tokenRegex.exec(text)) !== null) {
+    const seq = Number(match[1])
+    const lines = Number(match[2])
+    if (!isPositiveSafeInteger(seq) || !isPositiveSafeInteger(lines)) continue
+    const block = bySeq.get(seq)
+    if (block && block.lines === lines) {
+      ranges.push({ start: match.index, end: match.index + match[0].length, block })
+    }
+  }
+  return ranges
+}
+
+export function tokenRangeAt(
+  text: string,
+  blocks: readonly PasteBlock[],
+  caret: number
+): { start: number; end: number; block: PasteBlock } | null {
+  if (!Number.isSafeInteger(caret) || caret < 0 || caret > text.length) return null
+  for (const range of findTokenRanges(text, blocks)) {
+    if (caret >= range.start && caret <= range.end) return range
+  }
+  return null
+}
+
+export function pruneBlocks(text: string, blocks: PasteBlock[]): PasteBlock[] {
+  if (!blocks.length) return blocks
+  const usable = unambiguousBlocks(blocks)
+  const survivors = new Set(findTokenRanges(text, usable).map((range) => range.block.id))
+  const next = usable.filter((block) => survivors.has(block.id))
+  return next.length === blocks.length && next.every((block, index) => block === blocks[index])
+    ? blocks
+    : next
+}
+
+export function expandAll(text: string, blocks: readonly PasteBlock[]): string {
+  if (!text || !blocks.length) return text
+  const ranges = findTokenRanges(text, blocks)
+  if (!ranges.length) return text
+  let out = text
+  for (let index = ranges.length - 1; index >= 0; index -= 1) {
+    const range = ranges[index]!
+    out = out.slice(0, range.start) + range.block.content + out.slice(range.end)
+  }
+  return out
+}
+
+/** Inverse of `expandAll`: replace each first non-overlapping verbatim block. */
+export function recollapsePastes(content: string, blocks: readonly PasteBlock[]): string {
+  if (!content || !blocks.length) return content
+
+  interface Hit {
+    start: number
+    end: number
+    block: PasteBlock
+  }
+  const hits: Hit[] = []
+  const claimed: Array<[number, number]> = []
+  const firstUnclaimed = (needle: string): number => {
+    if (!needle) return -1
+    let from = 0
+    while (from <= content.length) {
+      const index = content.indexOf(needle, from)
+      if (index < 0) return -1
+      if (!claimed.some(([start, end]) => index < end && index + needle.length > start))
+        return index
+      from = index + 1
+    }
+    return -1
+  }
+
+  for (const block of unambiguousBlocks(blocks)) {
+    if (!block.content) continue
+    const trimmed = block.content.trimEnd()
+    let needle = block.content
+    let index = firstUnclaimed(needle)
+    if (index < 0 && trimmed && trimmed !== block.content) {
+      needle = trimmed
+      index = firstUnclaimed(needle)
+    }
+    if (index < 0) continue
+    const end = index + needle.length
+    hits.push({ start: index, end, block })
+    claimed.push([index, end])
+  }
+
+  if (!hits.length) return content
+  hits.sort((left, right) => left.start - right.start)
+  let out = ''
+  let position = 0
+  for (const hit of hits) {
+    if (hit.start < position) continue
+    out += content.slice(position, hit.start) + formatToken(hit.block)
+    position = hit.end
+  }
+  return out + content.slice(position)
+}
+
+/** Strip a trailing whitespace run only when that run contains a newline. */
+export function stripTrailingBlankLines(value: string): string {
+  let index = value.length - 1
+  let sawNewline = false
+  while (index >= 0) {
+    const code = value.charCodeAt(index)
+    if (code === 10 || code === 13) {
+      sawNewline = true
+      index -= 1
+      continue
+    }
+    if (code === 32 || code === 9) {
+      index -= 1
+      continue
+    }
+    break
+  }
+  return sawNewline ? value.slice(0, index + 1) : value
+}