three-text 0.2.9 → 0.2.11

package/README.md

@@ -396,7 +396,7 @@ The Knuth-Plass algorithm provides extensive control over line breaking quality:
 - **emergencyStretch** (0): Additional stretchability for difficult paragraphs
 - **autoEmergencyStretch** (0.1): Emergency stretch as percentage of line width (e.g., 0.1 = 10%). Defaults to 10% for non-hyphenated text
 - **disableShortLineDetection** (false): Disable automatic prevention of short lines
-- **shortLineThreshold** (0.5): Width ratio threshold for short line detection (0.0 to 1.0)
+- **shortLineThreshold** (0.7): Width ratio threshold for short line detection (0.0 to 1.0)
 
 #### Advanced parameters
 
@@ -419,7 +419,7 @@ Lower penalty/tolerance values produce tighter spacing but may fail to find acce
 
 #### Short line detection
 
-By default, the library detects and prevents short lines (lines occupying less than 50% of the target width on non-final lines) by iteratively applying emergency stretch. This can be customized or disabled:
+By default, the library detects and prevents short lines (lines occupying less than 70% of the target width on non-final lines) by iteratively applying emergency stretch. This can be customized or disabled:
 
 ```javascript
 const text = await Text.create({
@@ -701,7 +701,9 @@ mesh.geometry.dispose();
 mesh.geometry = updated.geometry;
 ```
 
-The method preserves custom cache instances if `maxCacheSizeMB` was specified. For most use cases, this is primarily an API convenience.
+The method preserves custom cache instances if `maxCacheSizeMB` was specified. For most use cases, this is primarily an API convenience
+
+Options merge at the top level - to remove a nested property like `layout.width`, pass `{ layout: { width: undefined } }`
 
 ##### `Text.setHarfBuzzPath(path: string): void`
 
@@ -781,7 +783,7 @@ interface LayoutOptions {
   emergencyStretch?: number; // Additional stretchability for difficult paragraphs
   autoEmergencyStretch?: number; // Emergency stretch as percentage of line width (defaults to 10% for non-hyphenated)
   disableShortLineDetection?: boolean; // Disable automatic short line prevention (default: false)
-  shortLineThreshold?: number; // Width ratio threshold for short line detection (default: 0.5)
+  shortLineThreshold?: number; // Width ratio threshold for short line detection (default: 0.7)
   lefthyphenmin?: number; // Minimum characters before hyphen (default: 2)
   righthyphenmin?: number; // Minimum characters after hyphen (default: 4)
   linepenalty?: number; // Base penalty per line (default: 10)

package/dist/index.cjs

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.9
+ * three-text v0.2.11
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -155,7 +155,7 @@ const perfLogger = new PerformanceLogger();
 // TeX defaults
 const FITNESS_TIGHT_THRESHOLD = 12; // if badness > 12 when shrinking -> tight_fit
 const FITNESS_NORMAL_THRESHOLD = 99; // if badness > 99 when stretching -> loose_fit
-const DEFAULT_TOLERANCE = 200;
+const DEFAULT_TOLERANCE = 800;
 const DEFAULT_PRETOLERANCE = 100;
 const DEFAULT_EMERGENCY_STRETCH = 0;
 // In TeX, interword spacing is defined by font parameters (fontdimen):
@@ -258,7 +258,7 @@ const INF_BAD = 10000;
 // Non TeX default: emergency stretch for non-hyphenated text (10% of line width)
 const DEFAULT_EMERGENCY_STRETCH_NO_HYPHEN = 0.1;
 // Another non TeX default: Short line detection thresholds
-const SHORT_LINE_WIDTH_THRESHOLD = 0.5; // Lines < 50% of width are problematic
+const SHORT_LINE_WIDTH_THRESHOLD = 0.7; // Lines < 70% of width are problematic
 const SHORT_LINE_EMERGENCY_STRETCH_INCREMENT = 0.1; // Add 10% per iteration
 class LineBreak {
     // Calculate badness according to TeX's formula (tex.web line 2337)
@@ -1006,6 +1006,7 @@ class LineBreak {
             // Artificial demerits: in final pass with no feasible solution yet
             // and only one active node left, force this break as a last resort
             const isLastResort = isFinalPass &&
+                isForcedBreak &&
                 minimumDemerits.value === Infinity &&
                 allActiveNodes.length === 1 &&
                 node.active;

package/dist/index.js

@@ -1,5 +1,5 @@
 /*!
- * three-text v0.2.9
+ * three-text v0.2.11
  * Copyright (C) 2025 Countertype LLC
  * 
  * This program is free software: you can redistribute it and/or modify
@@ -152,7 +152,7 @@ const perfLogger = new PerformanceLogger();
 // TeX defaults
 const FITNESS_TIGHT_THRESHOLD = 12; // if badness > 12 when shrinking -> tight_fit
 const FITNESS_NORMAL_THRESHOLD = 99; // if badness > 99 when stretching -> loose_fit
-const DEFAULT_TOLERANCE = 200;
+const DEFAULT_TOLERANCE = 800;
 const DEFAULT_PRETOLERANCE = 100;
 const DEFAULT_EMERGENCY_STRETCH = 0;
 // In TeX, interword spacing is defined by font parameters (fontdimen):
@@ -255,7 +255,7 @@ const INF_BAD = 10000;
 // Non TeX default: emergency stretch for non-hyphenated text (10% of line width)
 const DEFAULT_EMERGENCY_STRETCH_NO_HYPHEN = 0.1;
 // Another non TeX default: Short line detection thresholds
-const SHORT_LINE_WIDTH_THRESHOLD = 0.5; // Lines < 50% of width are problematic
+const SHORT_LINE_WIDTH_THRESHOLD = 0.7; // Lines < 70% of width are problematic
 const SHORT_LINE_EMERGENCY_STRETCH_INCREMENT = 0.1; // Add 10% per iteration
 class LineBreak {
     // Calculate badness according to TeX's formula (tex.web line 2337)
@@ -1003,6 +1003,7 @@ class LineBreak {
             // Artificial demerits: in final pass with no feasible solution yet
             // and only one active node left, force this break as a last resort
             const isLastResort = isFinalPass &&
+                isForcedBreak &&
                 minimumDemerits.value === Infinity &&
                 allActiveNodes.length === 1 &&
                 node.active;