chat-layout 1.1.2 → 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.
@@ -139,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;
 }
 /**