chat-layout 1.1.1 → 1.2.0-0

package/README.md

@@ -49,7 +49,7 @@ See [example/chat.ts](./example/chat.ts) for a full chat example.
 - `Place` is the simplest way to align a single bubble left, center, or right.
 - `MultilineText.align` uses logical values: `start`, `center`, `end`.
 - `MultilineText.physicalAlign` uses physical values: `left`, `center`, `right`.
-- `Text` and `MultilineText` default to `whiteSpace: "normal"`, matching pretext and CSS-style collapsible whitespace.
+- `Text` and `MultilineText` default to `whiteSpace: "normal"`, using the library's canvas-first collapsible whitespace behavior.
 - Use `whiteSpace: "pre-wrap"` when blank lines, hard breaks, or edge spaces must stay visible.
 - `Text` and `MultilineText` default to `overflowWrap: "break-word"`, which preserves compatibility-first min-content sizing for shrink layouts.
 - Use `overflowWrap: "anywhere"` when long unspaced strings should contribute grapheme-level breakpoints to min-content sizing.
@@ -108,6 +108,7 @@ Notes:
 ## Migration notes
 
 - Use `memoRenderItemBy(keyOf, renderItem)` when list items are primitives.
+- `memoRenderItemBy()` now uses a bounded LRU cache by default; pass `{ maxEntries: Infinity }` to keep the old unbounded behavior explicitly.
 - `FlexItem` exposes `grow`, `shrink`, and `alignSelf`; `basis` is no longer public.
 - `MultilineText` now uses `align` / `physicalAlign` instead of `alignment`.
 - `ListState.position` uses `undefined` for the renderer default anchor.
@@ -138,3 +139,5 @@ Build the chat example:
 ```bash
 bun run example
 ```
+
+文本性能观测基线见 `docs/text-performance.md`。

package/index.d.mts

@@ -53,7 +53,7 @@ type TextWhiteSpaceMode = "normal" | "pre-wrap";
  */
 type TextOverflowMode = "clip" | "ellipsis";
 /**
- * Word breaking mode used by pretext during segmentation and line breaking.
+ * Word breaking mode used by the internal canvas text layout engine.
  */
 type TextWordBreakMode = "normal" | "keep-all";
 /**
@@ -74,9 +74,9 @@ interface TextStyleOptions<C extends CanvasRenderingContext2D> {
   font: string;
   /** Color or resolver used when drawing the text. */
   color: DynValue<C, string>;
-  /** Default: normal; matches pretext and CSS-style collapsible whitespace behavior. */
+  /** Default: normal; uses canvas-first CSS-style collapsible whitespace behavior. */
   whiteSpace?: TextWhiteSpaceMode;
-  /** Default: normal; use keep-all to match pretext's CJK-friendly line breaking mode. */
+  /** Default: normal; use keep-all for CJK-friendly line breaking. */
   wordBreak?: TextWordBreakMode;
   /** Default: break-word; use anywhere when min-content should honor grapheme break opportunities. */
   overflowWrap?: TextOverflowWrapMode;
@@ -91,9 +91,9 @@ interface InlineSpan<C extends CanvasRenderingContext2D> {
   font?: string;
   /** Color override for this fragment. Falls back to the node-level color. */
   color?: DynValue<C, string>;
-  /** Optional break hint forwarded to pretext rich-inline layout. */
+  /** Optional break hint for atomic inline spans. */
   break?: "normal" | "never";
-  /** Optional extra occupied width forwarded to pretext rich-inline layout. */
+  /** Optional extra occupied width appended after the span's rendered text. */
   extraWidth?: number;
 }
 /**
@@ -518,7 +518,9 @@ declare function memoRenderItem<C extends CanvasRenderingContext2D, T extends ob
 /**
  * Memoizes `renderItem` by a caller-provided cache key.
  */
-declare function memoRenderItemBy<C extends CanvasRenderingContext2D, T, K>(keyOf: (item: T) => K, renderItem: (item: T) => Node<C>): ((item: T) => Node<C>) & {
+declare function memoRenderItemBy<C extends CanvasRenderingContext2D, T, K>(keyOf: (item: T) => K, renderItem: (item: T) => Node<C>, options?: {
+  maxEntries?: number;
+}): ((item: T) => Node<C>) & {
   reset: (item: T) => boolean;
   resetKey: (key: K) => boolean;
 };