@itwin/core-backend 4.8.0-dev.3 → 4.8.0-dev.31

package/lib/cjs/TextAnnotationGeometry.d.ts

@@ -12,6 +12,10 @@ export interface ProduceTextAnnotationGeometryArgs {
     annotation: TextAnnotation;
     /** The iModel from which to obtain fonts and text styles. */
     iModel: IModelDb;
+    /** For debugging purposes only, whether to include geometry representing the bounding box and anchor point of the annotation.
+     * If true, two red lines indicating the horizontal and vertical extents of the bounding box will be included, intersecting at the anchor point.
+     */
+    debugAnchorPointAndRange?: boolean;
     /** @internal chiefly for tests */
     computeTextRange?: ComputeRangesForTextLayout;
     /** @internal chiefly for tests */
@@ -19,7 +23,7 @@ export interface ProduceTextAnnotationGeometryArgs {
     /** @internal chiefly for tests */
     findFontId?: FindFontId;
 }
-/** Produce a geometric representation of a text annotation.
+/** Produce a geometric representation of a text annotation, with the annotation's anchor point at the origin.
  * The result can be supplied to [GeometryStreamBuilder.appendTextBlock]($common).
  * @see [[TextAnnotation2d.setAnnotation]] and [[TextAnnotation3d.setAnnotation]] to update the annotation, geometry, and placement of an annotation element.
  * @beta

package/lib/cjs/TextAnnotationGeometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextAnnotationGeometry.d.ts","sourceRoot":"","sources":["../../src/TextAnnotationGeometry.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAY,cAAc,EAAE,sBAAsB,EAA2D,MAAM,oBAAoB,CAAC;AAC/I,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,aAAa,EAA+C,MAAM,wBAAwB,CAAC;AAG5I,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AA8JtC;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,yDAAyD;IACzD,UAAU,EAAE,cAAc,CAAC;IAC3B,6DAA6D;IAC7D,MAAM,EAAE,QAAQ,CAAC;IACjB,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,kCAAkC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kCAAkC;IAClC,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,iCAAiC,GAAG,sBAAsB,CAY7G"}
+{"version":3,"file":"TextAnnotationGeometry.d.ts","sourceRoot":"","sources":["../../src/TextAnnotationGeometry.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAY,cAAc,EAAE,sBAAsB,EAA2D,MAAM,oBAAoB,CAAC;AAC/I,OAAO,EAAE,0BAA0B,EAAE,UAAU,EAAE,aAAa,EAA+C,MAAM,wBAAwB,CAAC;AAG5I,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAmKtC;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,yDAAyD;IACzD,UAAU,EAAE,cAAc,CAAC;IAC3B,6DAA6D;IAC7D,MAAM,EAAE,QAAQ,CAAC;IACjB;;OAEG;IACH,wBAAwB,CAAC,EAAE,OAAO,CAAC;IACnC,kCAAkC;IAClC,gBAAgB,CAAC,EAAE,0BAA0B,CAAC;IAC9C,kCAAkC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,kCAAkC;IAClC,UAAU,CAAC,EAAE,UAAU,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,IAAI,EAAE,iCAAiC,GAAG,sBAAsB,CAW7G"}

package/lib/cjs/TextAnnotationGeometry.js

@@ -120,22 +120,26 @@ function produceTextBlockGeometry(layout, documentTransform, debugAnchorPt) {
         context.entries.push({
             color: core_common_1.ColorDef.red.toJSON(),
         });
+        const lx = layout.range.low.x - debugAnchorPt.x;
+        const ly = layout.range.low.y - debugAnchorPt.y;
+        const hx = layout.range.high.x - debugAnchorPt.x;
+        const hy = layout.range.high.y - debugAnchorPt.y;
         context.entries.push({
             separator: {
-                startPoint: [layout.range.low.x, debugAnchorPt.y, 0],
-                endPoint: [layout.range.high.x, debugAnchorPt.y, 0],
+                startPoint: [lx, 0, 0],
+                endPoint: [hx, 0, 0],
             },
         });
         context.entries.push({
             separator: {
-                startPoint: [debugAnchorPt.x, layout.range.low.y, 0],
-                endPoint: [debugAnchorPt.x, layout.range.high.y, 0],
+                startPoint: [0, ly, 0],
+                endPoint: [0, hy, 0],
             },
         });
     }
     return { entries: context.entries };
 }
-/** Produce a geometric representation of a text annotation.
+/** Produce a geometric representation of a text annotation, with the annotation's anchor point at the origin.
  * The result can be supplied to [GeometryStreamBuilder.appendTextBlock]($common).
  * @see [[TextAnnotation2d.setAnnotation]] and [[TextAnnotation3d.setAnnotation]] to update the annotation, geometry, and placement of an annotation element.
  * @beta
@@ -145,10 +149,9 @@ function produceTextAnnotationGeometry(args) {
         ...args,
         textBlock: args.annotation.textBlock,
     });
-    const dimensions = layout.range.diagonal();
+    const dimensions = layout.range;
     const transform = args.annotation.computeTransform(dimensions);
-    const debugAnchorPointAndRange = false;
-    const anchorPoint = debugAnchorPointAndRange ? args.annotation.computeAnchorPoint(dimensions) : undefined;
+    const anchorPoint = args.debugAnchorPointAndRange ? args.annotation.computeAnchorPoint(dimensions) : undefined;
     return produceTextBlockGeometry(layout, transform, anchorPoint);
 }
 exports.produceTextAnnotationGeometry = produceTextAnnotationGeometry;

package/lib/cjs/TextAnnotationGeometry.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextAnnotationGeometry.js","sourceRoot":"","sources":["../../src/TextAnnotationGeometry.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,oDAA+I;AAC/I,iEAA4I;AAC5I,wDAA4F;AAC5F,sDAA6C;AAQ7C,SAAS,QAAQ,CAAC,KAAqB,EAAE,OAAwB;IAC/D,IAAI,KAAK,KAAK,OAAO,CAAC,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,QAAQ,GAAG,KAAK,CAAC;QACzB,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED,SAAS,gBAAgB,CAAC,IAAY,EAAE,GAAc,EAAE,MAAgB;IACtE,IAAA,qBAAM,EAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAExB,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC;IAE9E,OAAO,IAAI,wBAAU,CAAC;QACpB,IAAI;QACJ,IAAI,EAAE,GAAG,CAAC,MAAM;QAChB,MAAM,EAAE,UAAU;QAClB,WAAW;QACX,IAAI,EAAE,MAAM;QACZ,MAAM,EAAE,QAAQ;QAChB,SAAS,EAAE,YAAY;QACvB,MAAM;KACP,CAAC,CAAC;AACL,CAAC;AAED,SAAS,cAAc,CAAC,GAAc,EAAE,SAAoB,EAAE,OAAwB;IACpF,IAAA,qBAAM,EAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,QAAQ,CAAC,CAAC;IACzF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO;IACT,CAAC;IAED,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACvC,IAAI,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;QACxC,MAAM,KAAK,GAAG,WAAW,KAAK,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC;QACvD,MAAM,YAAY,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC;QAC5F,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAEvE,EAAE,CAAC,MAAM,CAAC,CAAC,IAAI,YAAY,GAAG,EAAE,CAAC,MAAM,CAAC;QACxC,EAAE,CAAC,MAAM,IAAI,KAAK,CAAC;IACrB,CAAC;IAED,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAE/B,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAC,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,wBAAwB,CAAC,IAAY,EAAE,GAAc,EAAE,MAAe,EAAE,SAAoB;IACnG,MAAM,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAA,qBAAM,EAAC,SAAS,KAAK,EAAE,CAAC,WAAW,CAAC,CAAC;IAErC,EAAE,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,oBAAoB,CAAC;IAE5C,EAAE,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAE/B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,SAAS,kBAAkB,CAAC,GAAc,EAAE,SAAoB,EAAE,OAAwB;IACxF,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC;IAC1B,IAAA,qBAAM,EAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IAEnC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrE,OAAO;IACT,CAAC;IAED,IAAA,qBAAM,EAAC,SAAS,KAAK,GAAG,CAAC,cAAc,IAAI,SAAS,KAAK,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAE/E,MAAM,QAAQ,GAAG,IAAI,wBAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC,KAAK,CAAC,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,oBAAoB,EAAE,QAAQ,CAAC,CAAC;IAEzD,MAAM,eAAe,GAAG,IAAI,uBAAO,CAAC,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC3F,MAAM,iBAAiB,GAAG,IAAI,uBAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEjG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IAEnC,IAAI,MAAM,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC,SAAS,EAAE,GAAG,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAC9G,CAAC;IAED,MAAM,cAAc,GAAG,uBAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;IAC5D,MAAM,gBAAgB,GAAG,uBAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEhE,IAAI,SAAwB,CAAC;IAC7B,IAAI,GAAG,CAAC,KAAK,CAAC,mBAAmB,KAAK,YAAY,EAAE,CAAC;QACnD,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,cAAc,CAAC,OAAO,EAAE,EAAE,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;QACrF,MAAM,CAAC,GAAG,IAAI,GAAG,gBAAgB,CAAC,OAAO,EAAE,CAAC;QAC5C,SAAS,GAAG,6BAAa,CAAC,UAAU,CAAC,CAAC,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,CAAC,CAAC;IAC/D,CAAC;SAAM,CAAC;QACN,MAAM,EAAE,GAAG,IAAI,uBAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,EAAE,gBAAgB,CAAC,GAAG,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClH,MAAM,EAAE,GAAG,IAAI,uBAAO,CAAC,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC;QACtE,SAAS,GAAG,6BAAa,CAAC,aAAa,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;IAClD,CAAC;IAED,SAAS,CAAC,mBAAmB,CAAC,SAAS,CAAC,CAAC;IAEzC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;QACnB,SAAS,EAAE;YACT,UAAU,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE;YACxC,QAAQ,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE;SACvC;KACF,CAAC,CAAC;IAEH,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,wBAAwB,CAAC,MAAM,CAAC,WAAW,EAAE,GAAG,EAAC,iBAAiB,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACjH,CAAC;AACH,CAAC;AAED,SAAS,wBAAwB,CAAC,MAAuB,EAAE,iBAA4B,EAAE,aAAuB;IAC9G,MAAM,OAAO,GAAoB,EAAE,OAAO,EAAE,EAAE,EAAE,CAAC;IACjD,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAChC,MAAM,SAAS,GAAG,yBAAS,CAAC,oBAAoB,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC1G,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,WAAW,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBACpC,SAAS;YACX,CAAC;YAED,MAAM,QAAQ,GAAG,yBAAS,CAAC,oBAAoB,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,EAAE,GAAG,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAC/F,SAAS,CAAC,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACzD,iBAAiB,CAAC,0BAA0B,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;YACjE,IAAI,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;gBAC/B,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,kBAAkB,CAAC,GAAG,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;YAC7C,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,gGAAgG;QAChG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YACnB,KAAK,EAAE,sBAAQ,CAAC,GAAG,CAAC,MAAM,EAAE;SAC7B,CAAC,CAAC;QAEH,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YACnB,SAAS,EAAE;gBACT,UAAU,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpD,QAAQ,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;aACpD;SACF,CAAC,CAAC;QACH,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC;YACnB,SAAS,EAAE;gBACT,UAAU,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;gBACpD,QAAQ,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;aACpD;SACF,CAAC,CAAC;IACL,CAAC;IAED,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;AACtC,CAAC;AAkBD;;;;GAIG;AACH,SAAgB,6BAA6B,CAAC,IAAuC;IACnF,MAAM,MAAM,GAAG,IAAA,sCAAe,EAAC;QAC7B,GAAG,IAAI;QACP,SAAS,EAAE,IAAI,CAAC,UAAU,CAAC,SAAS;KACrC,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAE/D,MAAM,wBAAwB,GAAG,KAAK,CAAC;IACvC,MAAM,WAAW,GAAG,wBAAwB,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1G,OAAO,wBAAwB,CAAC,MAAM,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AAClE,CAAC;AAZD,sEAYC","sourcesContent":["/*---------------------------------------------------------------------------------------------\r\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\r\n* See LICENSE.md in the project root for license terms and full copyright notice.\r\n*--------------------------------------------------------------------------------------------*/\r\n/** @packageDocumentation\r\n * @module ElementGeometry\r\n */\r\n\r\nimport { ColorDef, TextAnnotation, TextBlockGeometryProps, TextBlockGeometryPropsEntry, TextString, TextStyleColor } from \"@itwin/core-common\";\r\nimport { ComputeRangesForTextLayout, FindFontId, FindTextStyle, layoutTextBlock, RunLayout, TextBlockLayout } from \"./TextAnnotationLayout\";\r\nimport { LineSegment3d, Point3d, Range2d, Transform, Vector2d } from \"@itwin/core-geometry\";\r\nimport { assert } from \"@itwin/core-bentley\";\r\nimport { IModelDb } from \"./IModelDb\";\r\n\r\ninterface GeometryContext {\r\n  curColor?: TextStyleColor;\r\n  entries: TextBlockGeometryPropsEntry[];\r\n}\r\n\r\nfunction setColor(color: TextStyleColor, context: GeometryContext): void {\r\n  if (color !== context.curColor) {\r\n    context.curColor = color;\r\n    context.entries.push({ color });\r\n  }\r\n}\r\n\r\nfunction createTextString(text: string, run: RunLayout, origin?: Point3d): TextString {\r\n  assert(text.length > 0);\r\n\r\n  const { lineHeight, widthFactor, isBold, isItalic, isUnderlined } = run.style;\r\n\r\n  return new TextString({\r\n    text,\r\n    font: run.fontId,\r\n    height: lineHeight,\r\n    widthFactor,\r\n    bold: isBold,\r\n    italic: isItalic,\r\n    underline: isUnderlined,\r\n    origin,\r\n  });\r\n}\r\n\r\nfunction processTextRun(run: RunLayout, transform: Transform, context: GeometryContext): void {\r\n  assert(run.source.type === \"text\");\r\n  const text = run.source.content.substring(run.charOffset, run.charOffset + run.numChars);\r\n  if (text.length === 0) {\r\n    return;\r\n  }\r\n\r\n  const ts = createTextString(text, run);\r\n  if (\"none\" !== run.source.baselineShift) {\r\n    const isSub = \"subscript\" === run.source.baselineShift;\r\n    const offsetFactor = run.style[isSub ? \"subScriptOffsetFactor\" : \"superScriptOffsetFactor\"];\r\n    const scale = run.style[isSub ? \"subScriptScale\" : \"superScriptScale\"];\r\n\r\n    ts.origin.y += offsetFactor * ts.height;\r\n    ts.height *= scale;\r\n  }\r\n\r\n  ts.transformInPlace(transform);\r\n\r\n  setColor(run.style.color, context);\r\n  context.entries.push({ text: ts});\r\n}\r\n\r\nfunction createFractionTextString(text: string, run: RunLayout, origin: Point3d, transform: Transform): TextString {\r\n  const ts = createTextString(text, run, origin);\r\n  assert(undefined !== ts.widthFactor);\r\n\r\n  ts.height *= run.style.stackedFractionScale;\r\n\r\n  ts.transformInPlace(transform);\r\n\r\n  return ts;\r\n}\r\n\r\nfunction processFractionRun(run: RunLayout, transform: Transform, context: GeometryContext): void {\r\n  const source = run.source;\r\n  assert(source.type === \"fraction\");\r\n\r\n  if (source.numerator.length === 0 && source.denominator.length === 0) {\r\n    return;\r\n  }\r\n\r\n  assert(undefined !== run.numeratorRange && undefined !== run.denominatorRange);\r\n\r\n  const fontSize = new Vector2d(run.style.lineHeight * run.style.widthFactor, run.style.lineHeight);\r\n  fontSize.scale(run.style.stackedFractionScale, fontSize);\r\n\r\n  const numeratorOffset = new Point3d(run.numeratorRange.low.x, run.numeratorRange.low.y, 0);\r\n  const denominatorOffset = new Point3d(run.denominatorRange.low.x, run.denominatorRange.low.y, 0);\r\n\r\n  setColor(run.style.color, context);\r\n\r\n  if (source.numerator.length > 0) {\r\n    context.entries.push({ text: createFractionTextString(source.numerator, run, numeratorOffset, transform) });\r\n  }\r\n\r\n  const numeratorRange = Range2d.fromJSON(run.numeratorRange);\r\n  const denominatorRange = Range2d.fromJSON(run.denominatorRange);\r\n\r\n  let separator: LineSegment3d;\r\n  if (run.style.stackedFractionType === \"horizontal\") {\r\n    const fractionWidth = Math.max(numeratorRange.xLength(), denominatorRange.xLength());\r\n    const y = 1.25 * denominatorRange.yLength();\r\n    separator = LineSegment3d.createXYXY(0, y, fractionWidth, y);\r\n  } else {\r\n    const p0 = new Point3d(denominatorRange.low.x - fontSize.x / 2, denominatorRange.low.y + fontSize.y * (1 / 3), 0);\r\n    const p1 = new Point3d(p0.x + fontSize.x, p0.y + fontSize.y * 1.5, 0);\r\n    separator = LineSegment3d.createCapture(p0, p1);\r\n  }\r\n\r\n  separator.tryTransformInPlace(transform);\r\n\r\n  context.entries.push({\r\n    separator: {\r\n      startPoint: separator.point0Ref.toJSON(),\r\n      endPoint: separator.point1Ref.toJSON(),\r\n    },\r\n  });\r\n\r\n  if (source.denominator.length > 0) {\r\n    context.entries.push({ text: createFractionTextString(source.denominator, run,denominatorOffset, transform) });\r\n  }\r\n}\r\n\r\nfunction produceTextBlockGeometry(layout: TextBlockLayout, documentTransform: Transform, debugAnchorPt?: Point3d): TextBlockGeometryProps {\r\n  const context: GeometryContext = { entries: [] };\r\n  for (const line of layout.lines) {\r\n    const lineTrans = Transform.createTranslationXYZ(line.offsetFromDocument.x, line.offsetFromDocument.y, 0);\r\n    for (const run of line.runs) {\r\n      if (\"linebreak\" === run.source.type) {\r\n        continue;\r\n      }\r\n\r\n      const runTrans = Transform.createTranslationXYZ(run.offsetFromLine.x, run.offsetFromLine.y, 0);\r\n      lineTrans.multiplyTransformTransform(runTrans, runTrans);\r\n      documentTransform.multiplyTransformTransform(runTrans, runTrans);\r\n      if (\"text\" === run.source.type) {\r\n        processTextRun(run, runTrans, context);\r\n      } else {\r\n        processFractionRun(run, runTrans, context);\r\n      }\r\n    }\r\n  }\r\n\r\n  if (debugAnchorPt) {\r\n    // Draw lines representing the horizontal and vertical ranges, intersecting at the anchor point.\r\n    context.entries.push({\r\n      color: ColorDef.red.toJSON(),\r\n    });\r\n\r\n    context.entries.push({\r\n      separator: {\r\n        startPoint: [layout.range.low.x, debugAnchorPt.y, 0],\r\n        endPoint: [layout.range.high.x, debugAnchorPt.y, 0],\r\n      },\r\n    });\r\n    context.entries.push({\r\n      separator: {\r\n        startPoint: [debugAnchorPt.x, layout.range.low.y, 0],\r\n        endPoint: [debugAnchorPt.x, layout.range.high.y, 0],\r\n      },\r\n    });\r\n  }\r\n\r\n  return { entries: context.entries };\r\n}\r\n\r\n/** Arguments supplied to [[produceTextAnnotationGeometry]].\r\n * @beta\r\n */\r\nexport interface ProduceTextAnnotationGeometryArgs {\r\n  /** The annotation from which to produce the geometry. */\r\n  annotation: TextAnnotation;\r\n  /** The iModel from which to obtain fonts and text styles. */\r\n  iModel: IModelDb;\r\n  /** @internal chiefly for tests */\r\n  computeTextRange?: ComputeRangesForTextLayout;\r\n  /** @internal chiefly for tests */\r\n  findTextStyle?: FindTextStyle;\r\n  /** @internal chiefly for tests */\r\n  findFontId?: FindFontId;\r\n}\r\n\r\n/** Produce a geometric representation of a text annotation.\r\n * The result can be supplied to [GeometryStreamBuilder.appendTextBlock]($common).\r\n * @see [[TextAnnotation2d.setAnnotation]] and [[TextAnnotation3d.setAnnotation]] to update the annotation, geometry, and placement of an annotation element.\r\n * @beta\r\n */\r\nexport function produceTextAnnotationGeometry(args: ProduceTextAnnotationGeometryArgs): TextBlockGeometryProps {\r\n  const layout = layoutTextBlock({\r\n    ...args,\r\n    textBlock: args.annotation.textBlock,\r\n  });\r\n\r\n  const dimensions = layout.range.diagonal();\r\n  const transform = args.annotation.computeTransform(dimensions);\r\n\r\n  const debugAnchorPointAndRange = false;\r\n  const anchorPoint = debugAnchorPointAndRange ? args.annotation.computeAnchorPoint(dimensions) : undefined;\r\n  return produceTextBlockGeometry(layout, transform, anchorPoint);\r\n}\r\n"]}
+{"version":3,"file":"TextAnnotationGeometry.js","sourceRoot":"","sources":["../../src/TextAnnotationGeometry.ts"],"names":[],"mappings":"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","sourcesContent":["/*---------------------------------------------------------------------------------------------\n* Copyright (c) Bentley Systems, Incorporated. All rights reserved.\n* See LICENSE.md in the project root for license terms and full copyright notice.\n*--------------------------------------------------------------------------------------------*/\n/** @packageDocumentation\n * @module ElementGeometry\n */\n\nimport { ColorDef, TextAnnotation, TextBlockGeometryProps, TextBlockGeometryPropsEntry, TextString, TextStyleColor } from \"@itwin/core-common\";\nimport { ComputeRangesForTextLayout, FindFontId, FindTextStyle, layoutTextBlock, RunLayout, TextBlockLayout } from \"./TextAnnotationLayout\";\nimport { LineSegment3d, Point3d, Range2d, Transform, Vector2d } from \"@itwin/core-geometry\";\nimport { assert } from \"@itwin/core-bentley\";\nimport { IModelDb } from \"./IModelDb\";\n\ninterface GeometryContext {\n  curColor?: TextStyleColor;\n  entries: TextBlockGeometryPropsEntry[];\n}\n\nfunction setColor(color: TextStyleColor, context: GeometryContext): void {\n  if (color !== context.curColor) {\n    context.curColor = color;\n    context.entries.push({ color });\n  }\n}\n\nfunction createTextString(text: string, run: RunLayout, origin?: Point3d): TextString {\n  assert(text.length > 0);\n\n  const { lineHeight, widthFactor, isBold, isItalic, isUnderlined } = run.style;\n\n  return new TextString({\n    text,\n    font: run.fontId,\n    height: lineHeight,\n    widthFactor,\n    bold: isBold,\n    italic: isItalic,\n    underline: isUnderlined,\n    origin,\n  });\n}\n\nfunction processTextRun(run: RunLayout, transform: Transform, context: GeometryContext): void {\n  assert(run.source.type === \"text\");\n  const text = run.source.content.substring(run.charOffset, run.charOffset + run.numChars);\n  if (text.length === 0) {\n    return;\n  }\n\n  const ts = createTextString(text, run);\n  if (\"none\" !== run.source.baselineShift) {\n    const isSub = \"subscript\" === run.source.baselineShift;\n    const offsetFactor = run.style[isSub ? \"subScriptOffsetFactor\" : \"superScriptOffsetFactor\"];\n    const scale = run.style[isSub ? \"subScriptScale\" : \"superScriptScale\"];\n\n    ts.origin.y += offsetFactor * ts.height;\n    ts.height *= scale;\n  }\n\n  ts.transformInPlace(transform);\n\n  setColor(run.style.color, context);\n  context.entries.push({ text: ts});\n}\n\nfunction createFractionTextString(text: string, run: RunLayout, origin: Point3d, transform: Transform): TextString {\n  const ts = createTextString(text, run, origin);\n  assert(undefined !== ts.widthFactor);\n\n  ts.height *= run.style.stackedFractionScale;\n\n  ts.transformInPlace(transform);\n\n  return ts;\n}\n\nfunction processFractionRun(run: RunLayout, transform: Transform, context: GeometryContext): void {\n  const source = run.source;\n  assert(source.type === \"fraction\");\n\n  if (source.numerator.length === 0 && source.denominator.length === 0) {\n    return;\n  }\n\n  assert(undefined !== run.numeratorRange && undefined !== run.denominatorRange);\n\n  const fontSize = new Vector2d(run.style.lineHeight * run.style.widthFactor, run.style.lineHeight);\n  fontSize.scale(run.style.stackedFractionScale, fontSize);\n\n  const numeratorOffset = new Point3d(run.numeratorRange.low.x, run.numeratorRange.low.y, 0);\n  const denominatorOffset = new Point3d(run.denominatorRange.low.x, run.denominatorRange.low.y, 0);\n\n  setColor(run.style.color, context);\n\n  if (source.numerator.length > 0) {\n    context.entries.push({ text: createFractionTextString(source.numerator, run, numeratorOffset, transform) });\n  }\n\n  const numeratorRange = Range2d.fromJSON(run.numeratorRange);\n  const denominatorRange = Range2d.fromJSON(run.denominatorRange);\n\n  let separator: LineSegment3d;\n  if (run.style.stackedFractionType === \"horizontal\") {\n    const fractionWidth = Math.max(numeratorRange.xLength(), denominatorRange.xLength());\n    const y = 1.25 * denominatorRange.yLength();\n    separator = LineSegment3d.createXYXY(0, y, fractionWidth, y);\n  } else {\n    const p0 = new Point3d(denominatorRange.low.x - fontSize.x / 2, denominatorRange.low.y + fontSize.y * (1 / 3), 0);\n    const p1 = new Point3d(p0.x + fontSize.x, p0.y + fontSize.y * 1.5, 0);\n    separator = LineSegment3d.createCapture(p0, p1);\n  }\n\n  separator.tryTransformInPlace(transform);\n\n  context.entries.push({\n    separator: {\n      startPoint: separator.point0Ref.toJSON(),\n      endPoint: separator.point1Ref.toJSON(),\n    },\n  });\n\n  if (source.denominator.length > 0) {\n    context.entries.push({ text: createFractionTextString(source.denominator, run,denominatorOffset, transform) });\n  }\n}\n\nfunction produceTextBlockGeometry(layout: TextBlockLayout, documentTransform: Transform, debugAnchorPt?: Point3d): TextBlockGeometryProps {\n  const context: GeometryContext = { entries: [] };\n  for (const line of layout.lines) {\n    const lineTrans = Transform.createTranslationXYZ(line.offsetFromDocument.x, line.offsetFromDocument.y, 0);\n    for (const run of line.runs) {\n      if (\"linebreak\" === run.source.type) {\n        continue;\n      }\n\n      const runTrans = Transform.createTranslationXYZ(run.offsetFromLine.x, run.offsetFromLine.y, 0);\n      lineTrans.multiplyTransformTransform(runTrans, runTrans);\n      documentTransform.multiplyTransformTransform(runTrans, runTrans);\n      if (\"text\" === run.source.type) {\n        processTextRun(run, runTrans, context);\n      } else {\n        processFractionRun(run, runTrans, context);\n      }\n    }\n  }\n\n  if (debugAnchorPt) {\n    // Draw lines representing the horizontal and vertical ranges, intersecting at the anchor point.\n    context.entries.push({\n      color: ColorDef.red.toJSON(),\n    });\n\n    const lx = layout.range.low.x - debugAnchorPt.x;\n    const ly = layout.range.low.y - debugAnchorPt.y;\n    const hx = layout.range.high.x - debugAnchorPt.x;\n    const hy = layout.range.high.y - debugAnchorPt.y;\n\n    context.entries.push({\n      separator: {\n        startPoint: [lx, 0, 0],\n        endPoint: [hx, 0, 0],\n      },\n    });\n    context.entries.push({\n      separator: {\n        startPoint: [0, ly, 0],\n        endPoint: [0, hy, 0],\n      },\n    });\n  }\n\n  return { entries: context.entries };\n}\n\n/** Arguments supplied to [[produceTextAnnotationGeometry]].\n * @beta\n */\nexport interface ProduceTextAnnotationGeometryArgs {\n  /** The annotation from which to produce the geometry. */\n  annotation: TextAnnotation;\n  /** The iModel from which to obtain fonts and text styles. */\n  iModel: IModelDb;\n  /** For debugging purposes only, whether to include geometry representing the bounding box and anchor point of the annotation.\n   * If true, two red lines indicating the horizontal and vertical extents of the bounding box will be included, intersecting at the anchor point.\n   */\n  debugAnchorPointAndRange?: boolean;\n  /** @internal chiefly for tests */\n  computeTextRange?: ComputeRangesForTextLayout;\n  /** @internal chiefly for tests */\n  findTextStyle?: FindTextStyle;\n  /** @internal chiefly for tests */\n  findFontId?: FindFontId;\n}\n\n/** Produce a geometric representation of a text annotation, with the annotation's anchor point at the origin.\n * The result can be supplied to [GeometryStreamBuilder.appendTextBlock]($common).\n * @see [[TextAnnotation2d.setAnnotation]] and [[TextAnnotation3d.setAnnotation]] to update the annotation, geometry, and placement of an annotation element.\n * @beta\n */\nexport function produceTextAnnotationGeometry(args: ProduceTextAnnotationGeometryArgs): TextBlockGeometryProps {\n  const layout = layoutTextBlock({\n    ...args,\n    textBlock: args.annotation.textBlock,\n  });\n\n  const dimensions = layout.range;\n  const transform = args.annotation.computeTransform(dimensions);\n\n  const anchorPoint = args.debugAnchorPointAndRange ? args.annotation.computeAnchorPoint(dimensions) : undefined;\n  return produceTextBlockGeometry(layout, transform, anchorPoint);\n}\n"]}

package/lib/cjs/TextAnnotationLayout.d.ts

@@ -1,8 +1,8 @@
 /** @packageDocumentation
  * @module ElementGeometry
  */
-import { BaselineShift, FontId, FractionRun, Paragraph, Run, TextBlock, TextRun, TextStyleSettings } from "@itwin/core-common";
-import { Range2d, XAndY } from "@itwin/core-geometry";
+import { BaselineShift, FontId, FractionRun, LineLayoutResult, Paragraph, Run, RunLayoutResult, TextBlock, TextBlockLayoutResult, TextRun, TextStyleSettings } from "@itwin/core-common";
+import { Range2d } from "@itwin/core-geometry";
 import { IModelDb } from "./IModelDb";
 /** @internal */
 export interface TextLayoutRanges {
@@ -29,17 +29,15 @@ export type ComputeRangesForTextLayout = (args: ComputeRangesForTextLayoutArgs)
 export type FindFontId = (name: string) => FontId;
 /** @internal */
 export type FindTextStyle = (name: string) => TextStyleSettings;
-/** Arguments supplied to [[computeTextBlockExtents]].
+/**
+ * Arguments supplied to [[computeLayoutTextBlockResult]].
  * @beta
  */
-export interface ComputeTextBlockExtentsArgs {
+export interface LayoutTextBlockArgs {
     /** The text block whose extents are to be computed. */
     textBlock: TextBlock;
     /** The iModel from which to obtain fonts and [TextStyle]($common)s when laying out glyphs. */
     iModel: IModelDb;
-}
-/** @internal */
-export interface LayoutTextBlockArgs extends ComputeTextBlockExtentsArgs {
     /** @internal chiefly for tests, by default uses IModelJsNative.DgnDb.computeRangesForText. */
     computeTextRange?: ComputeRangesForTextLayout;
     /** @internal chiefly for tests, by default looks up styles from a workspace. */
@@ -53,16 +51,17 @@ export interface LayoutTextBlockArgs extends ComputeTextBlockExtentsArgs {
  * Each series of consecutive non-linebreak runs within a paragraph is concatenated into one line.
  * If the document specifies a width > 0, individual lines are split to try to avoid exceeding that width.
  * Individual TextRuns can be split onto multiple lines at word boundaries if necessary. Individual FractionRuns are never split.
+ * @see [[computeLayoutTextBlockResult]]
  * @internal
  */
 export declare function layoutTextBlock(args: LayoutTextBlockArgs): TextBlockLayout;
-/** Compute the bounding box containing the contents of a [TextBlock]($common).
- * This process converts each [Paragraph]($common) into a set of lines of text, laying out the glyphs of individual
- * [Run]($common)s based on their [TextStyle]($common)s and fonts, and applying work-wrapping based on [TextBlock.width]($common).
- * The resultant extents can be supplied to [TextAnnotation.computeTransform]($common) and [TextAnnotation.computeAnchorPoint]($common).
+/**
+ * Gets the result of laying out the the contents of a TextBlock into a series of lines containing runs.
+ * The visual layout accounts for the [TextStyle]($common)s, fonts, and [TextBlock.width]($common). It applies word-wrapping if needed.
+ * The layout returned matches the visual layout of the geometry produced by [[produceTextAnnotationGeometry]].
  * @beta
  */
-export declare function computeTextBlockExtents(args: ComputeTextBlockExtentsArgs): XAndY;
+export declare function computeLayoutTextBlockResult(args: LayoutTextBlockArgs): TextBlockLayoutResult;
 declare class LayoutContext {
     private readonly _computeTextRange;
     private readonly _findTextStyle;
@@ -99,11 +98,14 @@ export declare class RunLayout {
     fontId: FontId;
     private constructor();
     static create(source: Run, context: LayoutContext): RunLayout;
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify(): string;
     canWrap(): this is {
         source: TextRun;
     };
     private cloneForWrap;
-    wrap(availableWidth: number, shouldForceLeadingUnit: boolean, context: LayoutContext): RunLayout | undefined;
+    split(context: LayoutContext): RunLayout[];
+    toResult(paragraph: Paragraph): RunLayoutResult;
 }
 /** @internal */
 export declare class LineLayout {
@@ -116,12 +118,15 @@ export declare class LineLayout {
     };
     private _runs;
     constructor(source: Paragraph);
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify(): string;
     get runs(): ReadonlyArray<RunLayout>;
     get isEmpty(): boolean;
     get back(): RunLayout;
     append(run: RunLayout): void;
     /** Invoked every time a run is appended,. */
     private computeRanges;
+    toResult(textBlock: TextBlock): LineLayoutResult;
 }
 /**
  * Describes the layout of a text block as a collection of lines containing runs.
@@ -132,6 +137,9 @@ export declare class TextBlockLayout {
     range: Range2d;
     lines: LineLayout[];
     constructor(source: TextBlock, context: LayoutContext);
+    toResult(): TextBlockLayoutResult;
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify(): string;
     private get _back();
     private populateLines;
     private justifyLines;

package/lib/cjs/TextAnnotationLayout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextAnnotationLayout.d.ts","sourceRoot":"","sources":["../../src/TextAnnotationLayout.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"TextAnnotationLayout.d.ts","sourceRoot":"","sources":["../../src/TextAnnotationLayout.ts"],"names":[],"mappings":"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"}

package/lib/cjs/TextAnnotationLayout.js

@@ -7,16 +7,18 @@
  * @module ElementGeometry
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TextBlockLayout = exports.LineLayout = exports.RunLayout = exports.computeTextBlockExtents = exports.layoutTextBlock = void 0;
+exports.TextBlockLayout = exports.LineLayout = exports.RunLayout = exports.computeLayoutTextBlockResult = exports.layoutTextBlock = void 0;
 const core_common_1 = require("@itwin/core-common");
 const core_geometry_1 = require("@itwin/core-geometry");
 const core_bentley_1 = require("@itwin/core-bentley");
+const LineBreaker = require("linebreak");
 /**
  * Lays out the contents of a TextBlock into a series of lines containing runs.
  * Each paragraph is decomposed into a series of lines.
  * Each series of consecutive non-linebreak runs within a paragraph is concatenated into one line.
  * If the document specifies a width > 0, individual lines are split to try to avoid exceeding that width.
  * Individual TextRuns can be split onto multiple lines at word boundaries if necessary. Individual FractionRuns are never split.
+ * @see [[computeLayoutTextBlockResult]]
  * @internal
  */
 function layoutTextBlock(args) {
@@ -27,18 +29,17 @@ function layoutTextBlock(args) {
     return new TextBlockLayout(args.textBlock, new LayoutContext(args.textBlock, computeTextRange, findTextStyle, findFontId));
 }
 exports.layoutTextBlock = layoutTextBlock;
-/** Compute the bounding box containing the contents of a [TextBlock]($common).
- * This process converts each [Paragraph]($common) into a set of lines of text, laying out the glyphs of individual
- * [Run]($common)s based on their [TextStyle]($common)s and fonts, and applying work-wrapping based on [TextBlock.width]($common).
- * The resultant extents can be supplied to [TextAnnotation.computeTransform]($common) and [TextAnnotation.computeAnchorPoint]($common).
+/**
+ * Gets the result of laying out the the contents of a TextBlock into a series of lines containing runs.
+ * The visual layout accounts for the [TextStyle]($common)s, fonts, and [TextBlock.width]($common). It applies word-wrapping if needed.
+ * The layout returned matches the visual layout of the geometry produced by [[produceTextAnnotationGeometry]].
  * @beta
  */
-function computeTextBlockExtents(args) {
-    const range = layoutTextBlock(args).range;
-    (0, core_bentley_1.assert)(range.low.isZero);
-    return { x: range.high.x, y: range.high.y };
+function computeLayoutTextBlockResult(args) {
+    const layout = layoutTextBlock(args);
+    return layout.toResult();
 }
-exports.computeTextBlockExtents = computeTextBlockExtents;
+exports.computeLayoutTextBlockResult = computeLayoutTextBlockResult;
 function scaleRange(range, scale) {
     range.low.scaleInPlace(scale);
     range.high.scaleInPlace(scale);
@@ -147,6 +148,22 @@ class LayoutContext {
         return { layout, numerator, denominator };
     }
 }
+function split(source) {
+    if (source.length === 0) {
+        return [];
+    }
+    let index = 0;
+    const segments = [];
+    const breaker = new LineBreaker(source);
+    for (let brk = breaker.nextBreak(); brk; brk = breaker.nextBreak()) {
+        segments.push({
+            segment: source.slice(index, brk.position),
+            index,
+        });
+        index = brk.position;
+    }
+    return segments;
+}
 /** @internal */
 class RunLayout {
     constructor(props) {
@@ -192,6 +209,10 @@ class RunLayout {
         }
         return new RunLayout({ source, charOffset, numChars, range, justificationRange, denominatorRange, numeratorRange, offsetFromLine, style, fontId });
     }
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify() {
+        return this.source.type === "text" ? this.source.content.substring(this.charOffset, this.charOffset + this.numChars) : this.source.stringify();
+    }
     canWrap() {
         return this.source.type === "text";
     }
@@ -206,48 +227,44 @@ class RunLayout {
             offsetFromLine: { ...this.offsetFromLine },
         });
     }
-    wrap(availableWidth, shouldForceLeadingUnit, context) {
-        if (!this.canWrap()) {
-            return undefined;
+    split(context) {
+        (0, core_bentley_1.assert)(this.charOffset === 0, "cannot re-split a run");
+        if (!this.canWrap() || this.charOffset > 0) {
+            return [this];
         }
-        // An optimization that tracks the computed width so far so we don't have to repeatedly recompute preceding character ranges.
-        // Assumes (to the best of Jeff's knowledge) that characters before a break point can't affect the shaping of subsequent characters.
-        let runningWidth = 0;
-        let breakPos = 0;
-        // ###TODO TypeScript only provides type declarations for Intl.Segmenter if targeting ES2022+.
-        // But doing so causes inexplicable issues with initialization of Model.modeledElement.
-        // So until that's resolved, access it via cast to any.
-        const segmenter = new global.Intl.Segmenter(undefined, { granularity: "word" });
         const myText = this.source.content.substring(this.charOffset, this.charOffset + this.numChars);
-        if (myText.length === 0) {
-            return undefined;
+        const segments = split(myText);
+        if (segments.length <= 1) {
+            return [this];
         }
-        for (const segment of segmenter.segment(myText)) {
-            const testContent = segment.segment;
-            const forceCurrentUnit = shouldForceLeadingUnit && (0 === breakPos);
-            // If we don't fit, the previous break position is the split point.
-            const ranges = context.computeRangeForText(testContent, this.style, this.source.baselineShift);
-            if (!forceCurrentUnit && (runningWidth + ranges.justification.xLength()) > availableWidth) {
-                break;
-            }
-            // Otherwise, we fit; keep trying.
-            runningWidth += ranges.layout.xLength();
-            breakPos = segment.index + testContent.length;
+        return segments.map((segment) => {
+            return this.cloneForWrap({
+                ranges: context.computeRangeForText(segment.segment, this.style, this.source.baselineShift),
+                charOffset: segment.index,
+                numChars: segment.segment.length,
+            });
+        });
+    }
+    toResult(paragraph) {
+        const result = {
+            sourceRunIndex: paragraph.runs.indexOf(this.source),
+            fontId: this.fontId,
+            characterOffset: this.charOffset,
+            characterCount: this.numChars,
+            range: this.range.toJSON(),
+            offsetFromLine: this.offsetFromLine,
+            textStyle: this.style.toJSON(),
+        };
+        if (this.justificationRange) {
+            result.justificationRange = this.justificationRange.toJSON();
         }
-        // If the whole thing fits, we don't have to wrap (i.e., we just wasted a bunch of time).
-        if (breakPos >= myText.length) {
-            return undefined;
+        if (this.numeratorRange) {
+            result.numeratorRange = this.numeratorRange.toJSON();
         }
-        // Trim this run and return the remainder.
-        const charOffset = this.charOffset + breakPos;
-        const numChars = this.numChars - breakPos;
-        this.numChars = breakPos;
-        const leftover = this.source.content.substring(charOffset, charOffset + numChars);
-        return this.cloneForWrap({
-            ranges: context.computeRangeForText(leftover, this.style, this.source.baselineShift),
-            charOffset,
-            numChars,
-        });
+        if (this.denominatorRange) {
+            result.denominatorRange = this.denominatorRange.toJSON();
+        }
+        return result;
     }
 }
 exports.RunLayout = RunLayout;
@@ -260,6 +277,11 @@ class LineLayout {
         this._runs = [];
         this.source = source;
     }
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify() {
+        const runs = this._runs.map((run) => run.stringify());
+        return `${runs.join("")}`;
+    }
     get runs() { return this._runs; }
     get isEmpty() { return this._runs.length === 0; }
     get back() {
@@ -274,8 +296,15 @@ class LineLayout {
     computeRanges() {
         this.range.low.setZero();
         this.range.high.setZero();
+        // Some runs (fractions) are taller than others.
+        // We want to center each run vertically inside the line.
+        let lineHeight = 0;
         for (const run of this._runs) {
-            const runOffset = { x: this.range.high.x, y: 0 };
+            lineHeight = Math.max(lineHeight, run.range.yLength());
+        }
+        for (const run of this._runs) {
+            const runHeight = run.range.yLength();
+            const runOffset = { x: this.range.high.x, y: (lineHeight - runHeight) / 2 };
             run.offsetFromLine = runOffset;
             const runLayoutRange = run.range.cloneTranslated(runOffset);
             this.range.extendRange(runLayoutRange);
@@ -285,6 +314,15 @@ class LineLayout {
             }
         }
     }
+    toResult(textBlock) {
+        return {
+            sourceParagraphIndex: textBlock.paragraphs.indexOf(this.source),
+            runs: this.runs.map((x) => x.toResult(this.source)),
+            range: this.range.toJSON(),
+            justificationRange: this.justificationRange.toJSON(),
+            offsetFromDocument: this.offsetFromDocument,
+        };
+    }
 }
 exports.LineLayout = LineLayout;
 /**
@@ -296,9 +334,23 @@ class TextBlockLayout {
         this.range = new core_geometry_1.Range2d();
         this.lines = [];
         this.source = source;
+        if (source.width > 0) {
+            this.range.low.x = 0;
+            this.range.high.x = source.width;
+        }
         this.populateLines(context);
         this.justifyLines();
     }
+    toResult() {
+        return {
+            lines: this.lines.map((x) => x.toResult(this.source)),
+            range: this.range.toJSON(),
+        };
+    }
+    /** Compute a string representation, primarily for debugging purposes. */
+    stringify() {
+        return this.lines.map((line) => line.stringify()).join("\n");
+    }
     get _back() {
         (0, core_bentley_1.assert)(this.lines.length > 0);
         return this.lines[this.lines.length - 1];
@@ -308,66 +360,53 @@ class TextBlockLayout {
         if (doc.paragraphs.length === 0) {
             return;
         }
-        const isWrapped = doc.width > 0;
-        let line = new LineLayout(doc.paragraphs[0]);
+        const doWrap = doc.width > 0;
+        let curLine = new LineLayout(doc.paragraphs[0]);
         for (let i = 0; i < doc.paragraphs.length; i++) {
             const paragraph = doc.paragraphs[i];
             if (i > 0) {
-                line = this.flushLine(context, line, paragraph);
+                curLine = this.flushLine(context, curLine, paragraph);
+            }
+            let runs = paragraph.runs.map((run) => RunLayout.create(run, context));
+            if (doWrap) {
+                runs = runs.map((run) => run.split(context)).flat();
             }
-            for (const run of paragraph.runs) {
-                let layoutRun = RunLayout.create(run, context);
-                // Line break? It always "fits" and causes us to flush the line.
-                if ("linebreak" === run.type) {
-                    line.append(layoutRun);
-                    line = this.flushLine(context, line);
+            for (const run of runs) {
+                if ("linebreak" === run.source.type) {
+                    curLine.append(run);
+                    curLine = this.flushLine(context, curLine);
                     continue;
                 }
-                const effectiveRunWidth = isWrapped ? layoutRun.range.xLength() : 0;
-                let effectiveRemainingWidth = isWrapped ? doc.width - line.range.xLength() : Number.MAX_VALUE;
-                // Do we fit (no wrapping or narrow enough)? Append and go around to the next run.
-                if (effectiveRunWidth < effectiveRemainingWidth) {
-                    line.append(layoutRun);
+                if (!doWrap) {
+                    curLine.append(run);
                     continue;
                 }
-                // Can't fit, but can't wrap? Force on the line if it's the first thing; otherwise flush and add to the next line.
-                let leftOver = layoutRun.wrap(effectiveRemainingWidth, line.runs.length === 0, context);
-                if (!leftOver) {
-                    if (line.runs.length === 0) {
-                        line.append(layoutRun);
-                        line = this.flushLine(context, line);
-                    }
-                    else {
-                        line = this.flushLine(context, line);
-                        line.append(layoutRun);
-                    }
+                const runWidth = run.range.xLength();
+                const lineWidth = curLine.range.xLength();
+                if (runWidth + lineWidth <= doc.width) {
+                    curLine.append(run);
                     continue;
                 }
-                // Otherwise, keep splitting the run into lines until the whole thing is appended.
-                do {
-                    line.append(layoutRun);
-                    line = this.flushLine(context, line);
-                    effectiveRemainingWidth = doc.width;
-                    layoutRun = leftOver;
-                } while (leftOver = layoutRun.wrap(effectiveRemainingWidth, line.runs.length === 0, context));
-                line.append(layoutRun);
+                if (curLine.runs.length === 0) {
+                    curLine.append(run);
+                    curLine = this.flushLine(context, curLine);
+                }
+                else {
+                    curLine = this.flushLine(context, curLine);
+                    curLine.append(run);
+                }
             }
         }
-        if (line.runs.length > 0) {
-            this.flushLine(context, line);
+        if (curLine.runs.length > 0) {
+            this.flushLine(context, curLine);
         }
     }
     justifyLines() {
         if (this.lines.length <= 1 || "left" === this.source.justification) {
             return;
         }
-        let docWidth = this.source.width;
-        if (docWidth <= 0) {
-            for (const line of this.lines) {
-                const lineWidth = line.justificationRange.xLength();
-                docWidth = Math.max(docWidth, lineWidth);
-            }
-        }
+        // This is the minimum width of the document's bounding box.
+        const docWidth = this.source.width;
         let minOffset = Number.MAX_VALUE;
         for (const line of this.lines) {
             const lineWidth = line.justificationRange.xLength();
@@ -378,8 +417,11 @@ class TextBlockLayout {
             line.offsetFromDocument.x += offset;
             minOffset = Math.min(offset, minOffset);
         }
-        this.range.low.x += minOffset;
-        this.range.high.x += minOffset;
+        if (minOffset < 0) {
+            // Shift left to accomodate lines that exceeded the document's minimum width.
+            this.range.low.x += minOffset;
+            this.range.high.x += minOffset;
+        }
     }
     flushLine(context, line, nextParagraph) {
         nextParagraph = nextParagraph ?? line.source;