@itwin/core-common 5.1.0-dev.60 → 5.1.0-dev.62

package/lib/cjs/annotation/TextBlock.d.ts

@@ -1,28 +1,23 @@
 /** @packageDocumentation
  * @module Annotation
  */
+import { Id64String } from "@itwin/core-bentley";
 import { TextStyleSettingsProps } from "./TextStyle";
-/** Options supplied to [[TextBlockComponent.applyStyle]] to control how the style is applied to the component and its child components.
+/** Options supplied to [[TextBlockComponent.clearStyleOverrides]] to control how the style overrides are cleared on the component and its child components.
  * @beta
  */
-export interface ApplyTextStyleOptions {
-    /** Controls whether any deviations from the style's settings stored in [[TextBlockComponent.styleOverrides]] are retained.
+export interface ClearTextStyleOptions {
+    /** Controls whether the styleOverrides of any child components are retained.
      * By default, all overrides are cleared.
      */
-    preserveOverrides?: boolean;
-    /** Controls whether the style should be recursively applied to the [[Paragraph]]s belonging to a [[TextBlock]] and the [[Run]]s belonging to a [[Paragraph]].
-     * By default, the style change propagates to child components.
-     */
-    preventPropagation?: boolean;
+    preserveChildrenOverrides?: boolean;
 }
 /** The JSON representation of a [[TextBlockComponent]].
  * @beta
  */
 export interface TextBlockComponentProps {
-    /** The name of a [[TextStyle]] stored in a [Workspace]($backend) from which the base [[TextStyleSettings]] applied to the component originates. */
-    styleName: string;
-    /** Deviations from the base [[TextStyleSettings]] defined by the [[TextStyle]] applied to this component.
-     * This permits you to, e.g., create a [[TextRun]] using "Arial" font and override it to use "Comic Sans" instead.
+    /** Deviations from the base [[TextStyleSettings]] defined by the [AnnotationTextStyle]($backend) applied to this component.
+     * This permits you to, e.g., create a [[TextBlock]] using "Arial" font and override one of its [[TextRun]]s to use "Comic Sans" instead.
      */
     styleOverrides?: TextStyleSettingsProps;
 }
@@ -48,31 +43,22 @@ export interface TextBlockStringifyOptions {
     tabsAsSpaces?: number;
 }
 /** Abstract representation of any of the building blocks that make up a [[TextBlock]] document - namely [[Run]]s, [[Paragraph]]s, and [[TextBlock]] itself.
- * Each component can specify a [[TextStyle]] that formats its contents and optional [[styleOverrides]] to customize that formatting.
+ * The [[TextBlock]] can specify an [AnnotationTextStyle]($backend) that formats its contents. Each component can specify an optional [[styleOverrides]] to customize that formatting.
  * @beta
  */
 export declare abstract class TextBlockComponent {
-    private _styleName;
     private _styleOverrides;
     /** @internal */
-    protected constructor(props: TextBlockComponentProps);
-    /** The name of the [[TextStyle]] that provides the base formatting for the contents of this component.
-     * @note Assigning to this property is equivalent to calling [[applyStyle]] with default [[ApplyTextStyleOptions]], which propagates the style change to all of
-     * the components sub-components and clears any [[styleOverrides]].
-     */
-    get styleName(): string;
-    set styleName(styleName: string);
-    /** Deviations in individual properties of the [[TextStyle]] specified by [[styleName]].
+    protected constructor(props?: TextBlockComponentProps);
+    /** Deviations in individual properties of the [[TextStyleSettings]] in the [AnnotationTextStyle]($backend) specified by `styleId` on the [[TextBlock]].
      * For example, if the style uses the "Arial" font, you can override that by settings `styleOverrides.fontName` to "Comic Sans".
      * @see [[clearStyleOverrides]] to reset this to an empty object.
      */
     get styleOverrides(): TextStyleSettingsProps;
     set styleOverrides(overrides: TextStyleSettingsProps);
-    /** Reset any [[styleOverrides]] applied to this component's [[TextStyle]]. */
-    clearStyleOverrides(): void;
-    /** Apply the [[TextStyle]] specified by `styleName` to this component, optionally preserving [[styleOverrides]] and/or preventing propagation to sub-components. */
-    applyStyle(styleName: string, options?: ApplyTextStyleOptions): void;
-    /** Returns true if [[styleOverrides]] specifies any deviations from this component's base [[TextStyle]]. */
+    /** Reset any [[styleOverrides]] applied to this component. */
+    clearStyleOverrides(_options?: ClearTextStyleOptions): void;
+    /** Returns true if [[styleOverrides]] specifies any deviations from the [[TextBlock]]'s [AnnotationTextStyle]($backend). */
     get overridesStyle(): boolean;
     /** Create a deep copy of this component. */
     abstract clone(): TextBlockComponent;
@@ -142,7 +128,7 @@ export declare class TextRun extends TextBlockComponent {
     private constructor();
     clone(): TextRun;
     toJSON(): TextRunProps;
-    static create(props: Omit<TextRunProps, "type">): TextRun;
+    static create(props?: Omit<TextRunProps, "type">): TextRun;
     /** Simply returns [[content]]. */
     stringify(): string;
     equals(other: TextBlockComponent): boolean;
@@ -153,9 +139,9 @@ export declare class TextRun extends TextBlockComponent {
 export interface FractionRunProps extends TextBlockComponentProps {
     /** Discriminator field for the [[RunProps]] union. */
     readonly type: "fraction";
-    /** The text displayed before or above the fraction separator, depending on [[TextStyle.stackedFractionType]]. Default: an empty string. */
+    /** The text displayed before or above the fraction separator, depending on [[TextStyleSettings.stackedFractionType]]. Default: an empty string. */
     numerator?: string;
-    /** The text displayed after or below the fraction separator, depending on [[TextStyle.stackedFractionType]]. Default: an empty string. */
+    /** The text displayed after or below the fraction separator, depending on [[TextStyleSettings.stackedFractionType]]. Default: an empty string. */
     denominator?: string;
 }
 /** A [[Run]] containing a numeric ratio to be displayed as a numerator and denominator separated by a horizontal or diagonal bar.
@@ -172,7 +158,7 @@ export declare class FractionRun extends TextBlockComponent {
     private constructor();
     toJSON(): FractionRunProps;
     clone(): FractionRun;
-    static create(props: Omit<FractionRunProps, "type">): FractionRun;
+    static create(props?: Omit<FractionRunProps, "type">): FractionRun;
     /** Formats the fraction as a string with the [[numerator]] and [[denominator]] separated by [[TextBlockStringifyOptions.fractionSeparator]]. */
     stringify(options?: TextBlockStringifyOptions): string;
     equals(other: TextBlockComponent): boolean;
@@ -192,7 +178,7 @@ export declare class LineBreakRun extends TextBlockComponent {
     readonly type = "linebreak";
     private constructor();
     toJSON(): LineBreakRunProps;
-    static create(props: TextBlockComponentProps): LineBreakRun;
+    static create(props?: TextBlockComponentProps): LineBreakRun;
     clone(): LineBreakRun;
     /** Simply returns [[TextBlockStringifyOptions.lineBreak]]. */
     stringify(options?: TextBlockStringifyOptions): string;
@@ -214,7 +200,7 @@ export declare class TabRun extends TextBlockComponent {
     readonly type = "tab";
     toJSON(): TabRunProps;
     clone(): TabRun;
-    static create(props: Omit<TabRunProps, "type">): TabRun;
+    static create(props?: Omit<TabRunProps, "type">): TabRun;
     /**
    * Converts a [[TabRun]] to its string representation.
    * If the `tabsAsSpaces` option is provided, returns a string of spaces of the specified length.
@@ -241,10 +227,13 @@ export declare class Paragraph extends TextBlockComponent {
     private constructor();
     toJSON(): ParagraphProps;
     /** Create a paragraph from its JSON representation. */
-    static create(props: ParagraphProps): Paragraph;
+    static create(props?: ParagraphProps): Paragraph;
     clone(): Paragraph;
-    /** Apply the specified style to this [[Paragraph]], and - unless [[ApplyTextStyleOptions.preventPropagation]] is `true` - to all of its [[runs]]. */
-    applyStyle(styleName: string, options?: ApplyTextStyleOptions): void;
+    /**
+     * Clears any [[styleOverrides]] applied to this Paragraph.
+     * Will also clear [[styleOverrides]] from all child components unless [[ClearTextStyleOptions.preserveChildrenOverrides]] is `true`.
+     */
+    clearStyleOverrides(options?: ClearTextStyleOptions): void;
     /** Compute a string representation of this paragraph by concatenating the string representations of all of its [[runs]]. */
     stringify(options?: TextBlockStringifyOptions): string;
     equals(other: TextBlockComponent): boolean;
@@ -270,6 +259,8 @@ export interface TextBlockMargins {
  * @beta
  */
 export interface TextBlockProps extends TextBlockComponentProps {
+    /** The ID of an [AnnotationTextStyle]($backend) stored in the iModel from which the base [[TextStyleSettings]] applied to the [[TextBlock]] originates. */
+    styleId: Id64String;
     /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.
      * A value less than or equal to zero indicates no wrapping is to be applied.
      * Default: 0
@@ -289,6 +280,11 @@ export interface TextBlockProps extends TextBlockComponentProps {
  * @beta
  */
 export declare class TextBlock extends TextBlockComponent {
+    /** The ID of the [AnnotationTextStyle]($backend) that provides the base formatting for the contents of this TextBlock.
+     * @note Assigning to this property retains all style overrides on the TextBlock and its child components.
+     * Call [[clearStyleOverrides]] to clear the TextBlock's and optionally all children's style overrides.
+     */
+    styleId: Id64String;
     /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.
      * A value less than or equal to zero indicates no wrapping is to be applied.
      * Default: 0
@@ -304,20 +300,23 @@ export declare class TextBlock extends TextBlockComponent {
     toJSON(): TextBlockProps;
     /** Create a text block from its JSON representation. */
     static create(props: TextBlockProps): TextBlock;
-    /** Create an empty text block containing no [[paragraphs]] and an empty [[styleName]]. */
+    /** Create an empty text block containing no [[paragraphs]] and an empty [[styleId]]. */
     static createEmpty(): TextBlock;
     /** Returns true if every paragraph in this text block is empty. */
     get isEmpty(): boolean;
     clone(): TextBlock;
-    /** Apply the specified style to this block and - unless [[ApplyTextStyleOptions.preventPropagation]] is `true` - to all of its [[paragraphs]]. */
-    applyStyle(styleName: string, options?: ApplyTextStyleOptions): void;
+    /**
+     * Clears any [[styleOverrides]] applied to this TextBlock.
+     * Will also clear [[styleOverrides]] from all child components unless [[ClearTextStyleOptions.preserveChildrenOverrides]] is `true`.
+     */
+    clearStyleOverrides(options?: ClearTextStyleOptions): void;
     /** Compute a string representation of the document's contents by concatenating the string representations of each of its [[paragraphs]], separated by [[TextBlockStringifyOptions.paragraphBreak]]. */
     stringify(options?: TextBlockStringifyOptions): string;
     /** Add and return a new paragraph.
-     * If [[paragraphs]] is not empty, the style and overrides of the last [[Paragraph]] in the block will be applied to the new paragraph; otherwise,
-     * the paragraph will inherit this block's style with no overrides.
+     * By default, the paragraph will be created with no [[styleOverrides]], so that it inherits the style of this block.
+     * @param seedFromLast If true and [[paragraphs]] is not empty, the new paragraph will inherit the style overrides of the last [[Paragraph]] in this block.
      */
-    appendParagraph(): Paragraph;
+    appendParagraph(seedFromLast?: boolean): Paragraph;
     /** Append a run to the last [[Paragraph]] in this block.
      * If the block contains no [[paragraphs]], a new one will first be created using [[appendParagraph]].
      */

package/lib/cjs/annotation/TextBlock.d.ts.map

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

package/lib/cjs/annotation/TextBlock.js

@@ -8,29 +8,18 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TextBlock = exports.Paragraph = exports.TabRun = exports.LineBreakRun = exports.FractionRun = exports.TextRun = exports.Run = exports.TextBlockComponent = void 0;
+const TextStyle_1 = require("./TextStyle");
 /** Abstract representation of any of the building blocks that make up a [[TextBlock]] document - namely [[Run]]s, [[Paragraph]]s, and [[TextBlock]] itself.
- * Each component can specify a [[TextStyle]] that formats its contents and optional [[styleOverrides]] to customize that formatting.
+ * The [[TextBlock]] can specify an [AnnotationTextStyle]($backend) that formats its contents. Each component can specify an optional [[styleOverrides]] to customize that formatting.
  * @beta
  */
 class TextBlockComponent {
-    _styleName;
     _styleOverrides;
     /** @internal */
     constructor(props) {
-        this._styleName = props.styleName;
-        this._styleOverrides = { ...props.styleOverrides };
+        this._styleOverrides = TextStyle_1.TextStyleSettings.cloneProps(props?.styleOverrides ?? {});
     }
-    /** The name of the [[TextStyle]] that provides the base formatting for the contents of this component.
-     * @note Assigning to this property is equivalent to calling [[applyStyle]] with default [[ApplyTextStyleOptions]], which propagates the style change to all of
-     * the components sub-components and clears any [[styleOverrides]].
-     */
-    get styleName() {
-        return this._styleName;
-    }
-    set styleName(styleName) {
-        this.applyStyle(styleName);
-    }
-    /** Deviations in individual properties of the [[TextStyle]] specified by [[styleName]].
+    /** Deviations in individual properties of the [[TextStyleSettings]] in the [AnnotationTextStyle]($backend) specified by `styleId` on the [[TextBlock]].
      * For example, if the style uses the "Arial" font, you can override that by settings `styleOverrides.fontName` to "Comic Sans".
      * @see [[clearStyleOverrides]] to reset this to an empty object.
      */
@@ -38,20 +27,13 @@ class TextBlockComponent {
         return this._styleOverrides;
     }
     set styleOverrides(overrides) {
-        this._styleOverrides = { ...overrides };
+        this._styleOverrides = TextStyle_1.TextStyleSettings.cloneProps(overrides);
     }
-    /** Reset any [[styleOverrides]] applied to this component's [[TextStyle]]. */
-    clearStyleOverrides() {
+    /** Reset any [[styleOverrides]] applied to this component. */
+    clearStyleOverrides(_options) {
         this.styleOverrides = {};
     }
-    /** Apply the [[TextStyle]] specified by `styleName` to this component, optionally preserving [[styleOverrides]] and/or preventing propagation to sub-components. */
-    applyStyle(styleName, options) {
-        this._styleName = styleName;
-        if (!(options?.preserveOverrides)) {
-            this.clearStyleOverrides();
-        }
-    }
-    /** Returns true if [[styleOverrides]] specifies any deviations from this component's base [[TextStyle]]. */
+    /** Returns true if [[styleOverrides]] specifies any deviations from the [[TextBlock]]'s [AnnotationTextStyle]($backend). */
     get overridesStyle() {
         return Object.keys(this.styleOverrides).length > 0;
     }
@@ -66,15 +48,14 @@ class TextBlockComponent {
     /** Convert this component to its JSON representation. */
     toJSON() {
         return {
-            styleName: this.styleName,
-            styleOverrides: { ...this.styleOverrides },
+            styleOverrides: TextStyle_1.TextStyleSettings.cloneProps(this.styleOverrides),
         };
     }
     /** Returns true if `this` is equivalent to `other`. */
     equals(other) {
         const myKeys = Object.keys(this.styleOverrides);
         const yrKeys = Object.keys(other._styleOverrides);
-        if (this.styleName !== other.styleName || myKeys.length !== yrKeys.length) {
+        if (myKeys.length !== yrKeys.length) {
             return false;
         }
         for (const name of myKeys) {
@@ -119,8 +100,8 @@ class TextRun extends TextBlockComponent {
     baselineShift;
     constructor(props) {
         super(props);
-        this.content = props.content ?? "";
-        this.baselineShift = props.baselineShift ?? "none";
+        this.content = props?.content ?? "";
+        this.baselineShift = props?.baselineShift ?? "none";
     }
     clone() {
         return new TextRun(this.toJSON());
@@ -158,8 +139,8 @@ class FractionRun extends TextBlockComponent {
     denominator;
     constructor(props) {
         super(props);
-        this.numerator = props.numerator ?? "";
-        this.denominator = props.denominator ?? "";
+        this.numerator = props?.numerator ?? "";
+        this.denominator = props?.denominator ?? "";
     }
     toJSON() {
         return {
@@ -258,7 +239,7 @@ class Paragraph extends TextBlockComponent {
     runs;
     constructor(props) {
         super(props);
-        this.runs = props.runs?.map((run) => Run.fromJSON(run)) ?? [];
+        this.runs = props?.runs?.map((run) => Run.fromJSON(run)) ?? [];
     }
     toJSON() {
         return {
@@ -273,13 +254,16 @@ class Paragraph extends TextBlockComponent {
     clone() {
         return new Paragraph(this.toJSON());
     }
-    /** Apply the specified style to this [[Paragraph]], and - unless [[ApplyTextStyleOptions.preventPropagation]] is `true` - to all of its [[runs]]. */
-    applyStyle(styleName, options) {
-        super.applyStyle(styleName, options);
-        if (!(options?.preventPropagation)) {
-            for (const run of this.runs) {
-                run.applyStyle(styleName, options);
-            }
+    /**
+     * Clears any [[styleOverrides]] applied to this Paragraph.
+     * Will also clear [[styleOverrides]] from all child components unless [[ClearTextStyleOptions.preserveChildrenOverrides]] is `true`.
+     */
+    clearStyleOverrides(options) {
+        super.clearStyleOverrides();
+        if (options?.preserveChildrenOverrides)
+            return;
+        for (const run of this.runs) {
+            run.clearStyleOverrides();
         }
     }
     /** Compute a string representation of this paragraph by concatenating the string representations of all of its [[runs]]. */
@@ -305,6 +289,11 @@ exports.Paragraph = Paragraph;
  * @beta
  */
 class TextBlock extends TextBlockComponent {
+    /** The ID of the [AnnotationTextStyle]($backend) that provides the base formatting for the contents of this TextBlock.
+     * @note Assigning to this property retains all style overrides on the TextBlock and its child components.
+     * Call [[clearStyleOverrides]] to clear the TextBlock's and optionally all children's style overrides.
+     */
+    styleId;
     /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.
      * A value less than or equal to zero indicates no wrapping is to be applied.
      * Default: 0
@@ -318,6 +307,7 @@ class TextBlock extends TextBlockComponent {
     paragraphs;
     constructor(props) {
         super(props);
+        this.styleId = props.styleId;
         this.width = props.width ?? 0;
         this.justification = props.justification ?? "left";
         // Assign default margins if not provided
@@ -332,6 +322,7 @@ class TextBlock extends TextBlockComponent {
     toJSON() {
         return {
             ...super.toJSON(),
+            styleId: this.styleId,
             width: this.width,
             justification: this.justification,
             margins: this.margins,
@@ -342,9 +333,9 @@ class TextBlock extends TextBlockComponent {
     static create(props) {
         return new TextBlock(props);
     }
-    /** Create an empty text block containing no [[paragraphs]] and an empty [[styleName]]. */
+    /** Create an empty text block containing no [[paragraphs]] and an empty [[styleId]]. */
     static createEmpty() {
-        return TextBlock.create({ styleName: "" });
+        return TextBlock.create({ styleId: "" });
     }
     /** Returns true if every paragraph in this text block is empty. */
     get isEmpty() {
@@ -353,13 +344,16 @@ class TextBlock extends TextBlockComponent {
     clone() {
         return new TextBlock(this.toJSON());
     }
-    /** Apply the specified style to this block and - unless [[ApplyTextStyleOptions.preventPropagation]] is `true` - to all of its [[paragraphs]]. */
-    applyStyle(styleName, options) {
-        super.applyStyle(styleName, options);
-        if (!(options?.preventPropagation)) {
-            for (const paragraph of this.paragraphs) {
-                paragraph.applyStyle(styleName, options);
-            }
+    /**
+     * Clears any [[styleOverrides]] applied to this TextBlock.
+     * Will also clear [[styleOverrides]] from all child components unless [[ClearTextStyleOptions.preserveChildrenOverrides]] is `true`.
+     */
+    clearStyleOverrides(options) {
+        super.clearStyleOverrides();
+        if (options?.preserveChildrenOverrides)
+            return;
+        for (const paragraph of this.paragraphs) {
+            paragraph.clearStyleOverrides();
         }
     }
     /** Compute a string representation of the document's contents by concatenating the string representations of each of its [[paragraphs]], separated by [[TextBlockStringifyOptions.paragraphBreak]]. */
@@ -367,14 +361,17 @@ class TextBlock extends TextBlockComponent {
         return this.paragraphs.map((x) => x.stringify(options)).join(options?.paragraphBreak ?? " ");
     }
     /** Add and return a new paragraph.
-     * If [[paragraphs]] is not empty, the style and overrides of the last [[Paragraph]] in the block will be applied to the new paragraph; otherwise,
-     * the paragraph will inherit this block's style with no overrides.
+     * By default, the paragraph will be created with no [[styleOverrides]], so that it inherits the style of this block.
+     * @param seedFromLast If true and [[paragraphs]] is not empty, the new paragraph will inherit the style overrides of the last [[Paragraph]] in this block.
      */
-    appendParagraph() {
-        const seed = this.paragraphs[0];
+    appendParagraph(seedFromLast = false) {
+        let styleOverrides = {};
+        if (seedFromLast && this.paragraphs.length > 0) {
+            const seed = this.paragraphs[this.paragraphs.length - 1];
+            styleOverrides = { ...seed.styleOverrides };
+        }
         const paragraph = Paragraph.create({
-            styleName: seed?.styleName ?? this.styleName,
-            styleOverrides: seed?.styleOverrides ?? undefined,
+            styleOverrides
         });
         this.paragraphs.push(paragraph);
         return paragraph;
@@ -390,6 +387,9 @@ class TextBlock extends TextBlockComponent {
         if (!(other instanceof TextBlock)) {
             return false;
         }
+        if (this.styleId !== other.styleId || !super.equals(other)) {
+            return false;
+        }
         if (this.width !== other.width || this.justification !== other.justification || this.paragraphs.length !== other.paragraphs.length) {
             return false;
         }

package/lib/cjs/annotation/TextBlock.js.map

@@ -1 +1 @@
-{"version":3,"file":"TextBlock.js","sourceRoot":"","sources":["../../../src/annotation/TextBlock.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 Annotation\n */\n\nimport { TextStyleSettingsProps } from \"./TextStyle\";\n\n/** Options supplied to [[TextBlockComponent.applyStyle]] to control how the style is applied to the component and its child components.\n * @beta\n */\nexport interface ApplyTextStyleOptions {\n  /** Controls whether any deviations from the style's settings stored in [[TextBlockComponent.styleOverrides]] are retained.\n   * By default, all overrides are cleared.\n   */\n  preserveOverrides?: boolean;\n  /** Controls whether the style should be recursively applied to the [[Paragraph]]s belonging to a [[TextBlock]] and the [[Run]]s belonging to a [[Paragraph]].\n   * By default, the style change propagates to child components.\n   */\n  preventPropagation?: boolean;\n}\n\n/** The JSON representation of a [[TextBlockComponent]].\n * @beta\n */\nexport interface TextBlockComponentProps {\n  /** The name of a [[TextStyle]] stored in a [Workspace]($backend) from which the base [[TextStyleSettings]] applied to the component originates. */\n  styleName: string;\n  /** Deviations from the base [[TextStyleSettings]] defined by the [[TextStyle]] applied to this component.\n   * This permits you to, e.g., create a [[TextRun]] using \"Arial\" font and override it to use \"Comic Sans\" instead.\n   */\n  styleOverrides?: TextStyleSettingsProps;\n}\n\n/** Options supplied to [[TextBlockComponent.stringify]] to control how the content is formatted.\n * @beta\n */\nexport interface TextBlockStringifyOptions {\n  /** A string to insert in between each [[Paragraph]].\n   * Default: \" \" - a single space.\n   */\n  paragraphBreak?: string;\n  /** A string to insert for each [[LineBreakRun]].\n   * Default: \" \" - a single space.\n   */\n  lineBreak?: string;\n  /** A string to insert between the numerator and denominator of each [[FractionRun]].\n   * Default: \"/\"\n   */\n  fractionSeparator?: string;\n  /** The number of spaces to use for tabs. If not provided, tabs will be represented by a tab character: \"\\t\".\n   * Default: \"undefined\" - use \"\\t\".\n   */\n  tabsAsSpaces?: number;\n}\n\n/** Abstract representation of any of the building blocks that make up a [[TextBlock]] document - namely [[Run]]s, [[Paragraph]]s, and [[TextBlock]] itself.\n * Each component can specify a [[TextStyle]] that formats its contents and optional [[styleOverrides]] to customize that formatting.\n * @beta\n */\nexport abstract class TextBlockComponent {\n  private _styleName: string;\n  private _styleOverrides: TextStyleSettingsProps;\n\n  /** @internal */\n  protected constructor(props: TextBlockComponentProps) {\n    this._styleName = props.styleName;\n    this._styleOverrides = { ...props.styleOverrides };\n  }\n\n  /** The name of the [[TextStyle]] that provides the base formatting for the contents of this component.\n   * @note Assigning to this property is equivalent to calling [[applyStyle]] with default [[ApplyTextStyleOptions]], which propagates the style change to all of\n   * the components sub-components and clears any [[styleOverrides]].\n   */\n  public get styleName(): string {\n    return this._styleName;\n  }\n\n  public set styleName(styleName: string) {\n    this.applyStyle(styleName);\n  }\n\n  /** Deviations in individual properties of the [[TextStyle]] specified by [[styleName]].\n   * For example, if the style uses the \"Arial\" font, you can override that by settings `styleOverrides.fontName` to \"Comic Sans\".\n   * @see [[clearStyleOverrides]] to reset this to an empty object.\n   */\n  public get styleOverrides(): TextStyleSettingsProps {\n    return this._styleOverrides;\n  }\n\n  public set styleOverrides(overrides: TextStyleSettingsProps) {\n    this._styleOverrides = { ...overrides };\n  }\n\n  /** Reset any [[styleOverrides]] applied to this component's [[TextStyle]]. */\n  public clearStyleOverrides(): void {\n    this.styleOverrides = { };\n  }\n\n  /** Apply the [[TextStyle]] specified by `styleName` to this component, optionally preserving [[styleOverrides]] and/or preventing propagation to sub-components. */\n  public applyStyle(styleName: string, options?: ApplyTextStyleOptions): void {\n    this._styleName = styleName;\n\n    if (!(options?.preserveOverrides)) {\n      this.clearStyleOverrides();\n    }\n  }\n\n  /** Returns true if [[styleOverrides]] specifies any deviations from this component's base [[TextStyle]]. */\n  public get overridesStyle(): boolean {\n    return Object.keys(this.styleOverrides).length > 0;\n  }\n\n  /** Create a deep copy of this component. */\n  public abstract clone(): TextBlockComponent;\n\n  /** Compute a string representation of the contents of this component and all of its sub-components. */\n  public abstract stringify(options?: TextBlockStringifyOptions): string;\n\n  /**\n  * Returns true if the string representation of this component consists only of whitespace characters.\n  * Useful for checking if the component is visually empty (producing no graphics) or contains only spaces, tabs, or line breaks.\n  */\n  public get isWhitespace(): boolean {\n    return /^\\s*$/g.test(this.stringify());\n  };\n\n  /** Convert this component to its JSON representation. */\n  public toJSON(): TextBlockComponentProps {\n    return {\n      styleName: this.styleName,\n      styleOverrides: { ...this.styleOverrides },\n    };\n  }\n\n  /** Returns true if `this` is equivalent to `other`. */\n  public equals(other: TextBlockComponent): boolean {\n    const myKeys = Object.keys(this.styleOverrides);\n    const yrKeys = Object.keys(other._styleOverrides);\n    if (this.styleName !== other.styleName || myKeys.length !== yrKeys.length) {\n      return false;\n    }\n\n    for (const name of myKeys) {\n      const key = name as keyof TextStyleSettingsProps;\n      if (this.styleOverrides[key] !== other.styleOverrides[key]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n\n/**\n * @beta\n */\nexport type Run = TextRun | FractionRun | TabRun | LineBreakRun;\n\n/** The JSON representation of a [[Run]].\n * Use the `type` field to discriminate between the different kinds of runs.\n * @beta\n */\nexport type RunProps = TextRunProps | FractionRunProps | TabRunProps | LineBreakRunProps;\n\n/** A sequence of characters within a [[Paragraph]] that share a single style. Runs are the leaf nodes of a [[TextBlock]] document. When laid out for display, a single run may span\n * multiple lines, but it will never contain different styling.\n * Use the `type` field to discriminate between the different kinds of runs.\n * @beta\n */\nexport namespace Run { // eslint-disable-line @typescript-eslint/no-redeclare\n  /** Create a run from its JSON representation.\n   * @see [[TextRun.create]], [[FractionRun.create]], and [[LineBreakRun.create]] to create a run directly.\n   */\n  export function fromJSON(props: RunProps): Run {\n    switch (props.type) {\n      case \"text\": return TextRun.create(props);\n      case \"fraction\": return FractionRun.create(props);\n      case \"tab\": return TabRun.create(props);\n      case \"linebreak\": return LineBreakRun.create(props);\n    }\n  }\n}\n\n/** Describes whether the characters of a [[TextRun]] should be displayed normally, in subscript, or in superscript.\n * [[TextStyleSettings.superScriptScale]], [[TextStyleSettings.subScriptScale]], [[TextStyleSettings.superScriptOffsetFactor]], and [[TextStyleSettings.subScriptOffsetFactor]]\n * affect how the content is rendered.\n * @beta\n */\nexport type BaselineShift = \"subscript\" | \"superscript\" | \"none\";\n\n/** JSON representation of a [[TextRun]].\n * @beta\n */\nexport interface TextRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"text\";\n  /** The characters displayed by the run.\n   * Default: an empty string.\n   */\n  content?: string;\n  /** Whether to display [[content]] as a subscript, superscript, or normally.\n   * Default: \"none\"\n   */\n  baselineShift?: BaselineShift;\n}\n\n/** The most common type of [[Run]], containing a sequence of characters to be displayed using a single style.\n * @beta\n */\nexport class TextRun extends TextBlockComponent {\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"text\";\n  /** The sequence of characters to be displayed by the run. */\n  public content: string;\n  /** Whether to display [[content]] as a subscript, superscript, or normally. */\n  public baselineShift: BaselineShift;\n\n  private constructor(props: Omit<TextRunProps, \"type\">) {\n    super(props);\n    this.content = props.content ?? \"\";\n    this.baselineShift = props.baselineShift ?? \"none\";\n  }\n\n  public override clone(): TextRun {\n    return new TextRun(this.toJSON());\n  }\n\n  public override toJSON(): TextRunProps {\n    return {\n      ...super.toJSON(),\n      type: \"text\",\n      content: this.content,\n      baselineShift: this.baselineShift,\n    };\n  }\n\n  public static create(props: Omit<TextRunProps, \"type\">): TextRun {\n    return new TextRun(props);\n  }\n\n  /** Simply returns [[content]]. */\n  public override stringify(): string {\n    return this.content;\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return other instanceof TextRun && this.content === other.content && this.baselineShift === other.baselineShift && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[FractionRun]].\n * @beta\n */\nexport interface FractionRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"fraction\";\n  /** The text displayed before or above the fraction separator, depending on [[TextStyle.stackedFractionType]]. Default: an empty string. */\n  numerator?: string;\n  /** The text displayed after or below the fraction separator, depending on [[TextStyle.stackedFractionType]]. Default: an empty string. */\n  denominator?: string;\n}\n\n/** A [[Run]] containing a numeric ratio to be displayed as a numerator and denominator separated by a horizontal or diagonal bar.\n * @note The [[numerator]] and [[denominator]] are stored as strings. They are not technically required to contain a numeric representation.\n * @beta\n */\nexport class FractionRun extends TextBlockComponent {\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"fraction\";\n  /** The fraction's numerator. */\n  public numerator: string;\n  /** The fraction's denominator. */\n  public denominator: string;\n\n  private constructor(props: Omit<FractionRunProps, \"type\">) {\n    super(props);\n    this.numerator = props.numerator ?? \"\";\n    this.denominator = props.denominator ?? \"\";\n  }\n\n  public override toJSON(): FractionRunProps {\n    return {\n      ...super.toJSON(),\n      type: \"fraction\",\n      numerator: this.numerator,\n      denominator: this.denominator,\n    };\n  }\n\n  public override clone(): FractionRun {\n    return new FractionRun(this.toJSON());\n  }\n\n  public static create(props: Omit<FractionRunProps, \"type\">): FractionRun {\n    return new FractionRun(props);\n  }\n\n  /** Formats the fraction as a string with the [[numerator]] and [[denominator]] separated by [[TextBlockStringifyOptions.fractionSeparator]]. */\n  public override stringify(options?: TextBlockStringifyOptions): string {\n    const sep = options?.fractionSeparator ?? \"/\";\n    return `${this.numerator}${sep}${this.denominator}`;\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return other instanceof FractionRun && this.numerator === other.numerator && this.denominator === other.denominator && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[LineBreakRun]].\n * @beta\n */\nexport interface LineBreakRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"linebreak\";\n}\n\n/** A [[Run]] that represents the end of a line of text within a [[Paragraph]]. It contains no content of its own - it simply causes subsequent content to display on a new line.\n * @beta\n */\nexport class LineBreakRun extends TextBlockComponent {\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"linebreak\";\n\n  private constructor(props: TextBlockComponentProps) {\n    super(props);\n  }\n\n  public override toJSON(): LineBreakRunProps {\n    return {\n      ...super.toJSON(),\n      type: \"linebreak\",\n    };\n  }\n\n  public static create(props: TextBlockComponentProps) {\n    return new LineBreakRun(props);\n  }\n\n  public override clone(): LineBreakRun {\n    return new LineBreakRun(this.toJSON());\n  }\n\n  /** Simply returns [[TextBlockStringifyOptions.lineBreak]]. */\n  public override stringify(options?: TextBlockStringifyOptions): string {\n    return options?.lineBreak ?? \" \";\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return other instanceof LineBreakRun && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[TabRun]].\n * @beta\n */\nexport interface TabRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"tab\";\n}\n\n/** A [[TabRun]] is used to shift the next tab stop.\n * @note Only left-justified tabs are supported at this tab.\n * @beta\n */\nexport class TabRun extends TextBlockComponent {\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"tab\";\n\n  public override toJSON(): TabRunProps {\n    return {\n      ...super.toJSON(),\n      type: \"tab\",\n    };\n  }\n\n  public override clone(): TabRun {\n    return new TabRun(this.toJSON());\n  }\n\n  public static create(props: Omit<TabRunProps, \"type\">): TabRun {\n    return new TabRun(props);\n  }\n\n    /**\n   * Converts a [[TabRun]] to its string representation.\n   * If the `tabsAsSpaces` option is provided, returns a string of spaces of the specified length.\n   * Otherwise, returns a tab character (\"\\t\").\n   */\n  public override stringify(options?: TextBlockStringifyOptions): string {\n    if (options?.tabsAsSpaces) {\n      return \" \".repeat(options.tabsAsSpaces);\n    }\n\n    return \"\\t\";\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return other instanceof TabRun && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[Paragraph]].\n * @beta\n */\nexport interface ParagraphProps extends TextBlockComponentProps {\n  /** The collection of [[Run]]s within the paragraph.\n   * Default: an empty array.\n   */\n  runs?: RunProps[];\n}\n\n/** A collection of [[Run]]s within a [[TextBlock]]. Each paragraph within a text block is laid out on a separate line.\n * @beta\n */\nexport class Paragraph extends TextBlockComponent {\n  /** The runs within the paragraph. You can modify the contents of this array to change the content of the paragraph. */\n  public readonly runs: Run[];\n\n  private constructor(props: ParagraphProps) {\n    super(props);\n    this.runs = props.runs?.map((run) => Run.fromJSON(run)) ?? [];\n  }\n\n  public override toJSON(): ParagraphProps {\n    return {\n      ...super.toJSON(),\n      runs: this.runs.map((run) => run.toJSON()),\n    };\n  }\n\n  /** Create a paragraph from its JSON representation. */\n  public static create(props: ParagraphProps): Paragraph {\n    return new Paragraph(props);\n  }\n\n  public override clone(): Paragraph {\n    return new Paragraph(this.toJSON());\n  }\n\n  /** Apply the specified style to this [[Paragraph]], and - unless [[ApplyTextStyleOptions.preventPropagation]] is `true` - to all of its [[runs]]. */\n  public override applyStyle(styleName: string, options?: ApplyTextStyleOptions): void {\n    super.applyStyle(styleName, options);\n    if (!(options?.preventPropagation)) {\n      for (const run of this.runs) {\n        run.applyStyle(styleName, options);\n      }\n    }\n  }\n\n  /** Compute a string representation of this paragraph by concatenating the string representations of all of its [[runs]]. */\n  public override stringify(options?: TextBlockStringifyOptions): string {\n    return this.runs.map((x) => x.stringify(options)).join(\"\");\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    if (!(other instanceof Paragraph)) {\n      return false;\n    }\n\n    if (this.runs.length !== other.runs.length || !super.equals(other)) {\n      return false;\n    }\n\n    return this.runs.every((run, index) => run.equals(other.runs[index]));\n  }\n}\n\n/** Describes the relative alignment of the content of a [[TextBlock]].\n * @beta\n */\nexport type TextBlockJustification = \"left\" | \"center\" | \"right\";\n\n/** Describes the margins around the content inside a [[TextBlock]]. It's measured in meters.\n * @beta\n */\nexport interface TextBlockMargins {\n  /** The left margin measured in meters. Must be a positive number >= 0. Negative values are disregarded */\n  left: number;\n  /** The right margin measured in meters. Must be a positive number >= 0. Negative values are disregarded */\n  right: number;\n  /** The top margin measured in meters. Must be a positive number >= 0. Negative values are disregarded */\n  top: number;\n  /** The bottom margin measured in meters. Must be a positive number >= 0. Negative values are disregarded */\n  bottom: number;\n};\n\n/** JSON representation of a [[TextBlock]].\n * @beta\n */\nexport interface TextBlockProps extends TextBlockComponentProps {\n  /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.\n   * A value less than or equal to zero indicates no wrapping is to be applied.\n   * Default: 0\n   */\n  width?: number;\n  /** The alignment of the document content. Default: \"left\". */\n  justification?: TextBlockJustification;\n  /** The margins to surround the document content. Default: 0 margins on all sides */\n  margins?: Partial<TextBlockMargins>;\n  /** The paragraphs within the text block. Default: an empty array. */\n  paragraphs?: ParagraphProps[];\n}\n\n/** Represents a formatted text document consisting of a series of [[Paragraph]]s, each laid out on a separate line and containing their own content in the form of [[Run]]s.\n * You can change the content of the document by directly modifying the contents of its [[paragraphs]], or via [[appendParagraph]] and [[appendRun]].\n * No word-wrapping is applied to the document unless a [[width]] greater than zero is specified.\n * @see [[TextAnnotation]] to position a text block as an annotation in 2d or 3d space.\n * @beta\n */\nexport class TextBlock extends TextBlockComponent {\n  /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.\n   * A value less than or equal to zero indicates no wrapping is to be applied.\n   * Default: 0\n   */\n  public width: number;\n  /** The alignment of the document's content. */\n  public justification: TextBlockJustification;\n  /** The margins of the document. */\n  public margins: TextBlockMargins;\n  /** The ordered list of paragraphs within the document. */\n  public readonly paragraphs: Paragraph[];\n\n  private constructor(props: TextBlockProps) {\n    super(props);\n    this.width = props.width ?? 0;\n    this.justification = props.justification ?? \"left\";\n\n    // Assign default margins if not provided\n    this.margins = {\n      left: props.margins?.left ?? 0,\n      right: props.margins?.right ?? 0,\n      top: props.margins?.top ?? 0,\n      bottom: props.margins?.bottom ?? 0,\n    };\n\n    this.paragraphs = props.paragraphs?.map((x) => Paragraph.create(x)) ?? [];\n  }\n\n  public override toJSON(): TextBlockProps {\n    return {\n      ...super.toJSON(),\n      width: this.width,\n      justification: this.justification,\n      margins: this.margins,\n      paragraphs: this.paragraphs.map((x) => x.toJSON()),\n    };\n  }\n\n  /** Create a text block from its JSON representation. */\n  public static create(props: TextBlockProps): TextBlock {\n    return new TextBlock(props);\n  }\n\n  /** Create an empty text block containing no [[paragraphs]] and an empty [[styleName]]. */\n  public static createEmpty(): TextBlock {\n    return TextBlock.create({ styleName: \"\" });\n  }\n\n  /** Returns true if every paragraph in this text block is empty. */\n  public get isEmpty(): boolean {\n    return this.paragraphs.every((p) => p.runs.length === 0);\n  }\n\n  public override clone(): TextBlock {\n    return new TextBlock(this.toJSON());\n  }\n\n  /** Apply the specified style to this block and - unless [[ApplyTextStyleOptions.preventPropagation]] is `true` - to all of its [[paragraphs]]. */\n  public override applyStyle(styleName: string, options?: ApplyTextStyleOptions): void {\n    super.applyStyle(styleName, options);\n    if (!(options?.preventPropagation)) {\n      for (const paragraph of this.paragraphs) {\n        paragraph.applyStyle(styleName, options);\n      }\n    }\n  }\n\n  /** Compute a string representation of the document's contents by concatenating the string representations of each of its [[paragraphs]], separated by [[TextBlockStringifyOptions.paragraphBreak]]. */\n  public stringify(options?: TextBlockStringifyOptions): string {\n    return this.paragraphs.map((x) => x.stringify(options)).join(options?.paragraphBreak ?? \" \");\n  }\n\n  /** Add and return a new paragraph.\n   * If [[paragraphs]] is not empty, the style and overrides of the last [[Paragraph]] in the block will be applied to the new paragraph; otherwise,\n   * the paragraph will inherit this block's style with no overrides.\n   */\n  public appendParagraph(): Paragraph {\n    const seed = this.paragraphs[0];\n    const paragraph = Paragraph.create({\n      styleName: seed?.styleName ?? this.styleName,\n      styleOverrides: seed?.styleOverrides ?? undefined,\n    });\n\n    this.paragraphs.push(paragraph);\n    return paragraph;\n  }\n\n  /** Append a run to the last [[Paragraph]] in this block.\n   * If the block contains no [[paragraphs]], a new one will first be created using [[appendParagraph]].\n   */\n  public appendRun(run: Run): void {\n    const paragraph = this.paragraphs[this.paragraphs.length - 1] ?? this.appendParagraph();\n    paragraph.runs.push(run);\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    if (!(other instanceof TextBlock)) {\n      return false;\n    }\n\n    if (this.width !== other.width || this.justification !== other.justification || this.paragraphs.length !== other.paragraphs.length) {\n      return false;\n    }\n\n    const marginsAreEqual = Object.entries(this.margins).every(([key, value]) =>\n      value === (other.margins as any)[key]\n    );\n\n    if (!marginsAreEqual) return false;\n\n    return this.paragraphs.every((paragraph, index) => paragraph.equals(other.paragraphs[index]));\n  }\n}\n"]}
+{"version":3,"file":"TextBlock.js","sourceRoot":"","sources":["../../../src/annotation/TextBlock.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 Annotation\n */\n\nimport { Id64String } from \"@itwin/core-bentley\";\nimport { TextStyleSettings, TextStyleSettingsProps } from \"./TextStyle\";\n\n/** Options supplied to [[TextBlockComponent.clearStyleOverrides]] to control how the style overrides are cleared on the component and its child components.\n * @beta\n */\nexport interface ClearTextStyleOptions {\n  /** Controls whether the styleOverrides of any child components are retained.\n   * By default, all overrides are cleared.\n   */\n  preserveChildrenOverrides?: boolean;\n}\n\n/** The JSON representation of a [[TextBlockComponent]].\n * @beta\n */\nexport interface TextBlockComponentProps {\n  /** Deviations from the base [[TextStyleSettings]] defined by the [AnnotationTextStyle]($backend) applied to this component.\n   * This permits you to, e.g., create a [[TextBlock]] using \"Arial\" font and override one of its [[TextRun]]s to use \"Comic Sans\" instead.\n   */\n  styleOverrides?: TextStyleSettingsProps;\n}\n\n/** Options supplied to [[TextBlockComponent.stringify]] to control how the content is formatted.\n * @beta\n */\nexport interface TextBlockStringifyOptions {\n  /** A string to insert in between each [[Paragraph]].\n   * Default: \" \" - a single space.\n   */\n  paragraphBreak?: string;\n  /** A string to insert for each [[LineBreakRun]].\n   * Default: \" \" - a single space.\n   */\n  lineBreak?: string;\n  /** A string to insert between the numerator and denominator of each [[FractionRun]].\n   * Default: \"/\"\n   */\n  fractionSeparator?: string;\n  /** The number of spaces to use for tabs. If not provided, tabs will be represented by a tab character: \"\\t\".\n   * Default: \"undefined\" - use \"\\t\".\n   */\n  tabsAsSpaces?: number;\n}\n\n/** Abstract representation of any of the building blocks that make up a [[TextBlock]] document - namely [[Run]]s, [[Paragraph]]s, and [[TextBlock]] itself.\n * The [[TextBlock]] can specify an [AnnotationTextStyle]($backend) that formats its contents. Each component can specify an optional [[styleOverrides]] to customize that formatting.\n * @beta\n */\nexport abstract class TextBlockComponent {\n  private _styleOverrides: TextStyleSettingsProps;\n\n  /** @internal */\n  protected constructor(props?: TextBlockComponentProps) {\n    this._styleOverrides = TextStyleSettings.cloneProps(props?.styleOverrides ?? {});\n  }\n\n  /** Deviations in individual properties of the [[TextStyleSettings]] in the [AnnotationTextStyle]($backend) specified by `styleId` on the [[TextBlock]].\n   * For example, if the style uses the \"Arial\" font, you can override that by settings `styleOverrides.fontName` to \"Comic Sans\".\n   * @see [[clearStyleOverrides]] to reset this to an empty object.\n   */\n  public get styleOverrides(): TextStyleSettingsProps {\n    return this._styleOverrides;\n  }\n\n  public set styleOverrides(overrides: TextStyleSettingsProps) {\n    this._styleOverrides = TextStyleSettings.cloneProps(overrides);\n  }\n\n  /** Reset any [[styleOverrides]] applied to this component. */\n  public clearStyleOverrides(_options?: ClearTextStyleOptions): void {\n    this.styleOverrides = { };\n  }\n\n  /** Returns true if [[styleOverrides]] specifies any deviations from the [[TextBlock]]'s [AnnotationTextStyle]($backend). */\n  public get overridesStyle(): boolean {\n    return Object.keys(this.styleOverrides).length > 0;\n  }\n\n  /** Create a deep copy of this component. */\n  public abstract clone(): TextBlockComponent;\n\n  /** Compute a string representation of the contents of this component and all of its sub-components. */\n  public abstract stringify(options?: TextBlockStringifyOptions): string;\n\n  /**\n  * Returns true if the string representation of this component consists only of whitespace characters.\n  * Useful for checking if the component is visually empty (producing no graphics) or contains only spaces, tabs, or line breaks.\n  */\n  public get isWhitespace(): boolean {\n    return /^\\s*$/g.test(this.stringify());\n  };\n\n  /** Convert this component to its JSON representation. */\n  public toJSON(): TextBlockComponentProps {\n    return {\n      styleOverrides: TextStyleSettings.cloneProps(this.styleOverrides),\n    };\n  }\n\n  /** Returns true if `this` is equivalent to `other`. */\n  public equals(other: TextBlockComponent): boolean {\n    const myKeys = Object.keys(this.styleOverrides);\n    const yrKeys = Object.keys(other._styleOverrides);\n    if (myKeys.length !== yrKeys.length) {\n      return false;\n    }\n\n    for (const name of myKeys) {\n      const key = name as keyof TextStyleSettingsProps;\n      if (this.styleOverrides[key] !== other.styleOverrides[key]) {\n        return false;\n      }\n    }\n\n    return true;\n  }\n}\n\n/**\n * @beta\n */\nexport type Run = TextRun | FractionRun | TabRun | LineBreakRun;\n\n/** The JSON representation of a [[Run]].\n * Use the `type` field to discriminate between the different kinds of runs.\n * @beta\n */\nexport type RunProps = TextRunProps | FractionRunProps | TabRunProps | LineBreakRunProps;\n\n/** A sequence of characters within a [[Paragraph]] that share a single style. Runs are the leaf nodes of a [[TextBlock]] document. When laid out for display, a single run may span\n * multiple lines, but it will never contain different styling.\n * Use the `type` field to discriminate between the different kinds of runs.\n * @beta\n */\nexport namespace Run { // eslint-disable-line @typescript-eslint/no-redeclare\n  /** Create a run from its JSON representation.\n   * @see [[TextRun.create]], [[FractionRun.create]], and [[LineBreakRun.create]] to create a run directly.\n   */\n  export function fromJSON(props: RunProps): Run {\n    switch (props.type) {\n      case \"text\": return TextRun.create(props);\n      case \"fraction\": return FractionRun.create(props);\n      case \"tab\": return TabRun.create(props);\n      case \"linebreak\": return LineBreakRun.create(props);\n    }\n  }\n}\n\n/** Describes whether the characters of a [[TextRun]] should be displayed normally, in subscript, or in superscript.\n * [[TextStyleSettings.superScriptScale]], [[TextStyleSettings.subScriptScale]], [[TextStyleSettings.superScriptOffsetFactor]], and [[TextStyleSettings.subScriptOffsetFactor]]\n * affect how the content is rendered.\n * @beta\n */\nexport type BaselineShift = \"subscript\" | \"superscript\" | \"none\";\n\n/** JSON representation of a [[TextRun]].\n * @beta\n */\nexport interface TextRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"text\";\n  /** The characters displayed by the run.\n   * Default: an empty string.\n   */\n  content?: string;\n  /** Whether to display [[content]] as a subscript, superscript, or normally.\n   * Default: \"none\"\n   */\n  baselineShift?: BaselineShift;\n}\n\n/** The most common type of [[Run]], containing a sequence of characters to be displayed using a single style.\n * @beta\n */\nexport class TextRun extends TextBlockComponent {\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"text\";\n  /** The sequence of characters to be displayed by the run. */\n  public content: string;\n  /** Whether to display [[content]] as a subscript, superscript, or normally. */\n  public baselineShift: BaselineShift;\n\n  private constructor(props?: Omit<TextRunProps, \"type\">) {\n    super(props);\n    this.content = props?.content ?? \"\";\n    this.baselineShift = props?.baselineShift ?? \"none\";\n  }\n\n  public override clone(): TextRun {\n    return new TextRun(this.toJSON());\n  }\n\n  public override toJSON(): TextRunProps {\n    return {\n      ...super.toJSON(),\n      type: \"text\",\n      content: this.content,\n      baselineShift: this.baselineShift,\n    };\n  }\n\n  public static create(props?: Omit<TextRunProps, \"type\">): TextRun {\n    return new TextRun(props);\n  }\n\n  /** Simply returns [[content]]. */\n  public override stringify(): string {\n    return this.content;\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return other instanceof TextRun && this.content === other.content && this.baselineShift === other.baselineShift && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[FractionRun]].\n * @beta\n */\nexport interface FractionRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"fraction\";\n  /** The text displayed before or above the fraction separator, depending on [[TextStyleSettings.stackedFractionType]]. Default: an empty string. */\n  numerator?: string;\n  /** The text displayed after or below the fraction separator, depending on [[TextStyleSettings.stackedFractionType]]. Default: an empty string. */\n  denominator?: string;\n}\n\n/** A [[Run]] containing a numeric ratio to be displayed as a numerator and denominator separated by a horizontal or diagonal bar.\n * @note The [[numerator]] and [[denominator]] are stored as strings. They are not technically required to contain a numeric representation.\n * @beta\n */\nexport class FractionRun extends TextBlockComponent {\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"fraction\";\n  /** The fraction's numerator. */\n  public numerator: string;\n  /** The fraction's denominator. */\n  public denominator: string;\n\n  private constructor(props?: Omit<FractionRunProps, \"type\">) {\n    super(props);\n    this.numerator = props?.numerator ?? \"\";\n    this.denominator = props?.denominator ?? \"\";\n  }\n\n  public override toJSON(): FractionRunProps {\n    return {\n      ...super.toJSON(),\n      type: \"fraction\",\n      numerator: this.numerator,\n      denominator: this.denominator,\n    };\n  }\n\n  public override clone(): FractionRun {\n    return new FractionRun(this.toJSON());\n  }\n\n  public static create(props?: Omit<FractionRunProps, \"type\">): FractionRun {\n    return new FractionRun(props);\n  }\n\n  /** Formats the fraction as a string with the [[numerator]] and [[denominator]] separated by [[TextBlockStringifyOptions.fractionSeparator]]. */\n  public override stringify(options?: TextBlockStringifyOptions): string {\n    const sep = options?.fractionSeparator ?? \"/\";\n    return `${this.numerator}${sep}${this.denominator}`;\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return other instanceof FractionRun && this.numerator === other.numerator && this.denominator === other.denominator && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[LineBreakRun]].\n * @beta\n */\nexport interface LineBreakRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"linebreak\";\n}\n\n/** A [[Run]] that represents the end of a line of text within a [[Paragraph]]. It contains no content of its own - it simply causes subsequent content to display on a new line.\n * @beta\n */\nexport class LineBreakRun extends TextBlockComponent {\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"linebreak\";\n\n  private constructor(props?: TextBlockComponentProps) {\n    super(props);\n  }\n\n  public override toJSON(): LineBreakRunProps {\n    return {\n      ...super.toJSON(),\n      type: \"linebreak\",\n    };\n  }\n\n  public static create(props?: TextBlockComponentProps) {\n    return new LineBreakRun(props);\n  }\n\n  public override clone(): LineBreakRun {\n    return new LineBreakRun(this.toJSON());\n  }\n\n  /** Simply returns [[TextBlockStringifyOptions.lineBreak]]. */\n  public override stringify(options?: TextBlockStringifyOptions): string {\n    return options?.lineBreak ?? \" \";\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return other instanceof LineBreakRun && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[TabRun]].\n * @beta\n */\nexport interface TabRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"tab\";\n}\n\n/** A [[TabRun]] is used to shift the next tab stop.\n * @note Only left-justified tabs are supported at this tab.\n * @beta\n */\nexport class TabRun extends TextBlockComponent {\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"tab\";\n\n  public override toJSON(): TabRunProps {\n    return {\n      ...super.toJSON(),\n      type: \"tab\",\n    };\n  }\n\n  public override clone(): TabRun {\n    return new TabRun(this.toJSON());\n  }\n\n  public static create(props?: Omit<TabRunProps, \"type\">): TabRun {\n    return new TabRun(props);\n  }\n\n    /**\n   * Converts a [[TabRun]] to its string representation.\n   * If the `tabsAsSpaces` option is provided, returns a string of spaces of the specified length.\n   * Otherwise, returns a tab character (\"\\t\").\n   */\n  public override stringify(options?: TextBlockStringifyOptions): string {\n    if (options?.tabsAsSpaces) {\n      return \" \".repeat(options.tabsAsSpaces);\n    }\n\n    return \"\\t\";\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return other instanceof TabRun && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[Paragraph]].\n * @beta\n */\nexport interface ParagraphProps extends TextBlockComponentProps {\n  /** The collection of [[Run]]s within the paragraph.\n   * Default: an empty array.\n   */\n  runs?: RunProps[];\n}\n\n/** A collection of [[Run]]s within a [[TextBlock]]. Each paragraph within a text block is laid out on a separate line.\n * @beta\n */\nexport class Paragraph extends TextBlockComponent {\n  /** The runs within the paragraph. You can modify the contents of this array to change the content of the paragraph. */\n  public readonly runs: Run[];\n\n  private constructor(props?: ParagraphProps) {\n    super(props);\n    this.runs = props?.runs?.map((run) => Run.fromJSON(run)) ?? [];\n  }\n\n  public override toJSON(): ParagraphProps {\n    return {\n      ...super.toJSON(),\n      runs: this.runs.map((run) => run.toJSON()),\n    };\n  }\n\n  /** Create a paragraph from its JSON representation. */\n  public static create(props?: ParagraphProps): Paragraph {\n    return new Paragraph(props);\n  }\n\n  public override clone(): Paragraph {\n    return new Paragraph(this.toJSON());\n  }\n\n  /**\n   * Clears any [[styleOverrides]] applied to this Paragraph.\n   * Will also clear [[styleOverrides]] from all child components unless [[ClearTextStyleOptions.preserveChildrenOverrides]] is `true`.\n   */\n  public override clearStyleOverrides(options?: ClearTextStyleOptions): void {\n    super.clearStyleOverrides();\n    if (options?.preserveChildrenOverrides)\n      return;\n\n    for (const run of this.runs) {\n      run.clearStyleOverrides();\n    }\n  }\n\n  /** Compute a string representation of this paragraph by concatenating the string representations of all of its [[runs]]. */\n  public override stringify(options?: TextBlockStringifyOptions): string {\n    return this.runs.map((x) => x.stringify(options)).join(\"\");\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    if (!(other instanceof Paragraph)) {\n      return false;\n    }\n\n    if (this.runs.length !== other.runs.length || !super.equals(other)) {\n      return false;\n    }\n\n    return this.runs.every((run, index) => run.equals(other.runs[index]));\n  }\n}\n\n/** Describes the relative alignment of the content of a [[TextBlock]].\n * @beta\n */\nexport type TextBlockJustification = \"left\" | \"center\" | \"right\";\n\n/** Describes the margins around the content inside a [[TextBlock]]. It's measured in meters.\n * @beta\n */\nexport interface TextBlockMargins {\n  /** The left margin measured in meters. Must be a positive number >= 0. Negative values are disregarded */\n  left: number;\n  /** The right margin measured in meters. Must be a positive number >= 0. Negative values are disregarded */\n  right: number;\n  /** The top margin measured in meters. Must be a positive number >= 0. Negative values are disregarded */\n  top: number;\n  /** The bottom margin measured in meters. Must be a positive number >= 0. Negative values are disregarded */\n  bottom: number;\n};\n\n/** JSON representation of a [[TextBlock]].\n * @beta\n */\nexport interface TextBlockProps extends TextBlockComponentProps {\n  /** The ID of an [AnnotationTextStyle]($backend) stored in the iModel from which the base [[TextStyleSettings]] applied to the [[TextBlock]] originates. */\n  styleId: Id64String;\n  /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.\n   * A value less than or equal to zero indicates no wrapping is to be applied.\n   * Default: 0\n   */\n  width?: number;\n  /** The alignment of the document content. Default: \"left\". */\n  justification?: TextBlockJustification;\n  /** The margins to surround the document content. Default: 0 margins on all sides */\n  margins?: Partial<TextBlockMargins>;\n  /** The paragraphs within the text block. Default: an empty array. */\n  paragraphs?: ParagraphProps[];\n}\n\n/** Represents a formatted text document consisting of a series of [[Paragraph]]s, each laid out on a separate line and containing their own content in the form of [[Run]]s.\n * You can change the content of the document by directly modifying the contents of its [[paragraphs]], or via [[appendParagraph]] and [[appendRun]].\n * No word-wrapping is applied to the document unless a [[width]] greater than zero is specified.\n * @see [[TextAnnotation]] to position a text block as an annotation in 2d or 3d space.\n * @beta\n */\nexport class TextBlock extends TextBlockComponent {\n  /** The ID of the [AnnotationTextStyle]($backend) that provides the base formatting for the contents of this TextBlock.\n   * @note Assigning to this property retains all style overrides on the TextBlock and its child components.\n   * Call [[clearStyleOverrides]] to clear the TextBlock's and optionally all children's style overrides.\n   */\n  public styleId: Id64String;\n  /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.\n   * A value less than or equal to zero indicates no wrapping is to be applied.\n   * Default: 0\n   */\n  public width: number;\n  /** The alignment of the document's content. */\n  public justification: TextBlockJustification;\n  /** The margins of the document. */\n  public margins: TextBlockMargins;\n  /** The ordered list of paragraphs within the document. */\n  public readonly paragraphs: Paragraph[];\n\n  private constructor(props: TextBlockProps) {\n    super(props);\n    this.styleId = props.styleId;\n    this.width = props.width ?? 0;\n    this.justification = props.justification ?? \"left\";\n\n    // Assign default margins if not provided\n    this.margins = {\n      left: props.margins?.left ?? 0,\n      right: props.margins?.right ?? 0,\n      top: props.margins?.top ?? 0,\n      bottom: props.margins?.bottom ?? 0,\n    };\n\n    this.paragraphs = props.paragraphs?.map((x) => Paragraph.create(x)) ?? [];\n  }\n\n  public override toJSON(): TextBlockProps {\n    return {\n      ...super.toJSON(),\n      styleId: this.styleId,\n      width: this.width,\n      justification: this.justification,\n      margins: this.margins,\n      paragraphs: this.paragraphs.map((x) => x.toJSON()),\n    };\n  }\n\n  /** Create a text block from its JSON representation. */\n  public static create(props: TextBlockProps): TextBlock {\n    return new TextBlock(props);\n  }\n\n  /** Create an empty text block containing no [[paragraphs]] and an empty [[styleId]]. */\n  public static createEmpty(): TextBlock {\n    return TextBlock.create({ styleId: \"\" });\n  }\n\n  /** Returns true if every paragraph in this text block is empty. */\n  public get isEmpty(): boolean {\n    return this.paragraphs.every((p) => p.runs.length === 0);\n  }\n\n  public override clone(): TextBlock {\n    return new TextBlock(this.toJSON());\n  }\n\n  /**\n   * Clears any [[styleOverrides]] applied to this TextBlock.\n   * Will also clear [[styleOverrides]] from all child components unless [[ClearTextStyleOptions.preserveChildrenOverrides]] is `true`.\n   */\n  public override clearStyleOverrides(options?: ClearTextStyleOptions): void {\n    super.clearStyleOverrides();\n    if (options?.preserveChildrenOverrides)\n      return;\n\n    for (const paragraph of this.paragraphs) {\n      paragraph.clearStyleOverrides();\n    }\n  }\n\n  /** Compute a string representation of the document's contents by concatenating the string representations of each of its [[paragraphs]], separated by [[TextBlockStringifyOptions.paragraphBreak]]. */\n  public stringify(options?: TextBlockStringifyOptions): string {\n    return this.paragraphs.map((x) => x.stringify(options)).join(options?.paragraphBreak ?? \" \");\n  }\n\n  /** Add and return a new paragraph.\n   * By default, the paragraph will be created with no [[styleOverrides]], so that it inherits the style of this block.\n   * @param seedFromLast If true and [[paragraphs]] is not empty, the new paragraph will inherit the style overrides of the last [[Paragraph]] in this block.\n   */\n  public appendParagraph(seedFromLast: boolean = false): Paragraph {\n    let styleOverrides: TextStyleSettingsProps = {};\n\n    if (seedFromLast && this.paragraphs.length > 0) {\n      const seed = this.paragraphs[this.paragraphs.length - 1];\n      styleOverrides = { ...seed.styleOverrides };\n    }\n\n    const paragraph = Paragraph.create({\n      styleOverrides\n    });\n\n    this.paragraphs.push(paragraph);\n    return paragraph;\n  }\n\n  /** Append a run to the last [[Paragraph]] in this block.\n   * If the block contains no [[paragraphs]], a new one will first be created using [[appendParagraph]].\n   */\n  public appendRun(run: Run): void {\n    const paragraph = this.paragraphs[this.paragraphs.length - 1] ?? this.appendParagraph();\n    paragraph.runs.push(run);\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    if (!(other instanceof TextBlock)) {\n      return false;\n    }\n\n    if (this.styleId !== other.styleId || !super.equals(other)) {\n      return false;\n    }\n\n    if (this.width !== other.width || this.justification !== other.justification || this.paragraphs.length !== other.paragraphs.length) {\n      return false;\n    }\n\n    const marginsAreEqual = Object.entries(this.margins).every(([key, value]) =>\n      value === (other.margins as any)[key]\n    );\n\n    if (!marginsAreEqual) return false;\n\n    return this.paragraphs.every((paragraph, index) => paragraph.equals(other.paragraphs[index]));\n  }\n}\n"]}

package/lib/cjs/annotation/TextBlockLayoutResult.d.ts

@@ -25,7 +25,7 @@ export interface RunLayoutResult {
     offsetFromLine: XAndY;
     /** Bounding box enclosing this RunLayoutResult's content. */
     range: Range2dProps;
-    /** The [[TextStyleSettings]] for the run. */
+    /** The resolved [[TextStyleSettings]] for the run. Takes into account overrides and styles on the parent classes. */
     textStyle: TextStyleSettingsProps;
     /** Bounding box used when justifying the run. This may be smaller than [[range]]. */
     justificationRange?: Range2dProps;

package/lib/cjs/annotation/TextBlockLayoutResult.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"TextBlockLayoutResult.d.ts","sourceRoot":"","sources":["../../../src/annotation/TextBlockLayoutResult.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf;;;MAGE;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,cAAc,EAAE,KAAK,CAAC;IACtB,6DAA6D;IAC7D,KAAK,EAAE,YAAY,CAAC;IACpB,6CAA6C;IAC7C,SAAS,EAAE,sBAAsB,CAAC;IAClC,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,YAAY,CAAC;IAClC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,YAAY,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uGAAuG;IACvG,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,qDAAqD;IACrD,KAAK,EAAE,YAAY,CAAC;IACpB,sFAAsF;IACtF,kBAAkB,EAAE,YAAY,CAAC;IACjC,yEAAyE;IACzE,kBAAkB,EAAE,KAAK,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,4DAA4D;IAC5D,KAAK,EAAE,YAAY,CAAC;CACrB"}
+{"version":3,"file":"TextBlockLayoutResult.d.ts","sourceRoot":"","sources":["../../../src/annotation/TextBlockLayoutResult.ts"],"names":[],"mappings":"AAIA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B,0FAA0F;IAC1F,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf;;;MAGE;IACF,eAAe,EAAE,MAAM,CAAC;IACxB,uDAAuD;IACvD,cAAc,EAAE,MAAM,CAAC;IACvB,0FAA0F;IAC1F,cAAc,EAAE,KAAK,CAAC;IACtB,6DAA6D;IAC7D,KAAK,EAAE,YAAY,CAAC;IACpB,qHAAqH;IACrH,SAAS,EAAE,sBAAsB,CAAC;IAClC,qFAAqF;IACrF,kBAAkB,CAAC,EAAE,YAAY,CAAC;IAClC,4EAA4E;IAC5E,cAAc,CAAC,EAAE,YAAY,CAAC;IAC9B,8EAA8E;IAC9E,gBAAgB,CAAC,EAAE,YAAY,CAAC;CACjC;AAED;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uGAAuG;IACvG,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sCAAsC;IACtC,IAAI,EAAE,eAAe,EAAE,CAAC;IACxB,qDAAqD;IACrD,KAAK,EAAE,YAAY,CAAC;IACpB,sFAAsF;IACtF,kBAAkB,EAAE,YAAY,CAAC;IACjC,yEAAyE;IACzE,kBAAkB,EAAE,KAAK,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,qBAAqB;IACpC,6CAA6C;IAC7C,KAAK,EAAE,gBAAgB,EAAE,CAAC;IAC1B,4DAA4D;IAC5D,KAAK,EAAE,YAAY,CAAC;CACrB"}