@itwin/core-common 5.5.0-dev.2 → 5.5.0-dev.5

package/lib/cjs/ViewProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"ViewProps.js","sourceRoot":"","sources":["../../src/ViewProps.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AA4OH;;;GAGG;AACH,IAAiB,YAAY,CA0W5B;AA1WD,WAAiB,YAAY;IAE3B;;;;OAIG;IACU,oBAAO,GAAG,OAAO,CAAC;IAkC/B,qGAAqG;IACxF,0BAAa,GAAG,CAAC,EAAiB,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;AAgUnF,CAAC,EA1WgB,YAAY,4BAAZ,YAAY,QA0W5B","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 Views\n */\n\nimport { CompressedId64Set, Id64Array, Id64String } from \"@itwin/core-bentley\";\nimport { AngleProps, Range3dProps, TransformProps, XYProps, XYZProps, YawPitchRollProps } from \"@itwin/core-geometry\";\nimport { CameraProps } from \"./Camera\";\nimport { DisplayStyleProps, DisplayStyleSettingsProps } from \"./DisplayStyleSettings\";\nimport { DefinitionElementProps, DisplayStyleLoadProps, ElementProps, RenderTimelineProps, SheetProps, ViewAttachmentProps } from \"./ElementProps\";\nimport { EntityQueryParams } from \"./EntityProps\";\nimport { ModelProps } from \"./ModelProps\";\nimport { SubCategoryAppearance } from \"./SubCategoryAppearance\";\nimport { ViewDetails3dProps, ViewDetailsProps } from \"./ViewDetails\";\nimport { ThumbnailProps } from \"./Thumbnail\";\nimport { RenderSchedule } from \"./RenderSchedule\";\n\n/** The id of either an element or an entry in a ViewStore.\n * @public\n */\nexport type ViewIdString = Id64String; // should also include ViewStoreRpc.IdString when that's @public\n\n/** As part of a [[ViewStateProps]], describes the [[SpatialViewDefinition]] from which a [SectionDrawing]($backend) was generated.\n * @see [[SectionDrawingProps]]\n * @public\n * @extensions\n */\nexport interface SectionDrawingViewProps {\n  /** The Id of the spatial view from which the SectionDrawing was generated. */\n  spatialView: Id64String;\n  /** If true, the spatial view should be displayed in the context of the drawing view. */\n  displaySpatialView: boolean;\n  /** Transform from drawing coordinates to spatial coordinates. If undefined, use identity transform. */\n  drawingToSpatialTransform?: TransformProps;\n}\n\n/** The response props from the getCustomViewState3dData RPC endpoint\n * @internal\n */\nexport interface CustomViewState3dProps {\n  modelIds: CompressedId64Set;\n  modelExtents: Range3dProps;\n  categoryIds: CompressedId64Set;\n}\n\n/**\n * The options passed to the getCustomViewState3dData RPC endpoint.\n * @internal\n */\nexport interface CustomViewState3dCreatorOptions {\n  modelIds?: CompressedId64Set;\n}\n\n/**\n * A result row from querying for subcategories\n * @internal\n */\nexport interface SubCategoryResultRow {\n  parentId: Id64String;\n  id: Id64String;\n  appearance: SubCategoryAppearance.Props;\n}\n\n/**\n * Request props for the hydrateViewState RPC endpoint.\n * @internal\n */\nexport interface HydrateViewStateRequestProps {\n  acsId?: string;\n  notLoadedModelSelectorStateModels?: CompressedId64Set;\n  sheetViewAttachmentIds?: CompressedId64Set;\n  viewStateLoadProps?: ViewStateLoadProps;\n  baseModelId?: Id64String;\n  spatialViewId?: Id64String;\n}\n\n/** Response props from the hydrateViewState RPC endpoint.\n * @internal\n */\nexport interface HydrateViewStateResponseProps {\n  acsElementProps?: ElementProps;\n  modelSelectorStateModels?: ModelProps[];\n  // cast this to viewAttachmentInfo[] on the frontend.\n  sheetViewAttachmentProps?: ViewAttachmentProps[];\n  sheetViewViews?: (ViewStateProps | undefined)[];\n  baseModelProps?: ModelProps;\n  spatialViewProps?: ViewStateProps;\n}\n\n/** Returned from [IModelDb.Views.getViewStateProps]($backend).\n * @public\n * @extensions\n */\nexport interface ViewStateProps {\n  viewDefinitionProps: ViewDefinitionProps;\n  categorySelectorProps: CategorySelectorProps;\n  modelSelectorProps?: ModelSelectorProps;\n  displayStyleProps: DisplayStyleProps;\n  /** Sheet-specific properties, if this is a view of a [SheetModel]($backend). */\n  sheetProps?: SheetProps;\n  /** The Ids of the [ViewAttachment]($backend)s contained within the [SheetModel]($backend), if this is a sheet view. */\n  sheetAttachments?: Id64Array;\n  /** For a [DrawingViewState]($frontend), the extents of the [DrawingModel]($backend), used for determining the upper limits of the view's extents. */\n  modelExtents?: Range3dProps;\n  /** Information about the [SectionDrawing]($backend) relevant to displaying a drawing view. */\n  sectionDrawing?: SectionDrawingViewProps;\n}\n\n/** Options for loading a [[ViewStateProps]] via [IModelConnection.Views.load]($frontend) or [IModelDb.Views.getViewStateProps]($backend).\n * @public\n * @extensions\n */\nexport interface ViewStateLoadProps {\n  /** Options for loading the view's [[DisplayStyleProps]]. */\n  displayStyle?: DisplayStyleLoadProps;\n\n  /**\n   * bindings for query-based selectors\n   * @beta\n   */\n  queryBindings?: {\n    modelSelector?: ViewStoreRpc.QueryBindings;\n    categorySelector?: ViewStoreRpc.QueryBindings;\n  };\n}\n\n/** Properties that define a ModelSelector\n * @public\n * @extensions\n */\nexport interface ModelSelectorProps extends DefinitionElementProps {\n  models: Id64Array;\n}\n\n/** Properties that define a CategorySelector\n * @public\n * @extensions\n */\nexport interface CategorySelectorProps extends DefinitionElementProps {\n  categories: Id64Array;\n}\n\n/** Parameters for performing a query on [ViewDefinition]($backend) classes.\n * @public\n * @extensions\n */\nexport interface ViewQueryParams extends EntityQueryParams {\n  wantPrivate?: boolean;\n}\n\n/** Parameters used to construct a ViewDefinition\n * @public\n * @extensions\n */\nexport interface ViewDefinitionProps extends DefinitionElementProps {\n  categorySelectorId: ViewIdString;\n  displayStyleId: ViewIdString;\n  description?: string;\n  jsonProperties?: {\n    /** Additional properties of the view. */\n    viewDetails?: ViewDetailsProps;\n  };\n}\n\n/** Parameters to construct a ViewDefinition3d\n * @public\n * @extensions\n */\nexport interface ViewDefinition3dProps extends ViewDefinitionProps {\n  /** if true, camera is valid. */\n  cameraOn: boolean;\n  /** The lower left back corner of the view frustum. */\n  origin: XYZProps;\n  /** The extent of the view frustum. */\n  extents: XYZProps;\n  /** Rotation of the view frustum (could be undefined if going Matrix3d -> YawPitchRoll). */\n  angles?: YawPitchRollProps;\n  /** The camera used for this view. */\n  camera: CameraProps;\n  jsonProperties?: {\n    /** Additional properties of the view. */\n    viewDetails?: ViewDetails3dProps;\n  };\n}\n\n/** Parameters to construct a SpatialViewDefinition\n * @public\n * @extensions\n */\nexport interface SpatialViewDefinitionProps extends ViewDefinition3dProps {\n  modelSelectorId: ViewIdString;\n}\n\n/** Parameters used to construct a ViewDefinition2d\n * @public\n * @extensions\n */\nexport interface ViewDefinition2dProps extends ViewDefinitionProps {\n  baseModelId: Id64String;\n  origin: XYProps;\n  delta: XYProps;\n  angle: AngleProps;\n}\n\n/**\n * @public\n * @extensions\n */\nexport interface AuxCoordSystemProps extends ElementProps {\n  type?: number;\n  description?: string;\n}\n\n/**  Properties of AuxCoordSystem2d\n * @public\n * @extensions\n */\nexport interface AuxCoordSystem2dProps extends AuxCoordSystemProps {\n  /** Origin of the AuxCoordSystem2d */\n  origin?: XYProps;\n  /** Rotation angle */\n  angle?: AngleProps;\n}\n\n/** Properties of AuxCoordSystem3d\n * @public\n * @extensions\n */\nexport interface AuxCoordSystem3dProps extends AuxCoordSystemProps {\n  /** Origin of the AuxCoordSystem3d */\n  origin?: XYZProps;\n  /** Yaw angle */\n  yaw?: AngleProps;\n  /** Pitch angle */\n  pitch?: AngleProps;\n  /** Roll angle */\n  roll?: AngleProps;\n}\n\n/**\n * Access to a ViewStore from the frontend.\n * @beta\n */\nexport namespace ViewStoreRpc {\n\n  /**\n   * Version of the Rpc interface. If any methods or interfaces of this API change, this number should\n   * be incremented according to the rules of semantic versioning. See .\\rpc\\README-RpcInterfaceVersioning.md for more information.\n   *  @internal\n   */\n  export const version = \"4.0.0\";\n\n  /** an Id of a View, DisplayStyle, ModelSelector, CategorySelector, or Timeline in a ViewStore.\n   * Will be a base-36 number with a leading \"@\".\n   * @public\n   */\n  export type IdString = string;\n\n  /**\n   * A string identifying a group. This may either be a \"group name path\" or the RowString of a group (e.g. either \"group1/design/issues\" or \"@4e3\")\n   * The syntax is not ambiguous because ViewStoreIdStrings always start with \"@\" and  Group names can never contain \"@\".\n   */\n  export type ViewGroupSpec = IdString | ViewGroupPath;\n\n  /** The name for a view. */\n  export type ViewName = string;\n\n  /** The name for a Tag. */\n  export type TagName = string;\n\n  /** The name of an \"owner\". Should come from the authentication system, so it will be guaranteed unique.\n   * This name should be chosen by the user rather than their email address.\n   */\n  export type OwnerName = string;\n\n  /** The path name of a view group (e.g. \"group1/design/issues\"). Does not include the \"root\" group. */\n  export type ViewGroupPath = string;\n\n  /** The name for a view group.  */\n  export type ViewGroupName = string;\n\n  /** The name for a view group.  */\n  export type ClassFullName = string;\n\n  /** Determine if a string is an Id of an entry in a ViewStore (base-36 integer with a leading \"@\") */\n  export const isViewStoreId = (id?: ViewIdString) => true === id?.startsWith(\"@\");\n\n  /** Parameters for querying for views in a ViewStore. */\n  export interface QueryParams {\n    /** a list of classFullNames to accept. If not present, all classes are returned. */\n    readonly classNames?: ClassFullName[];\n    /** Optional \"LIMIT\" clause to limit the number of views returned. */\n    readonly limit?: number;\n    /** Optional \"OFFSET\" clause. Only valid if Limit is also present. */\n    readonly offset?: number;\n    /** A string to filter view names. May include wildcards if the `nameCompare` uses LIKE or GLOB (see SQLite documentation for LIKE and GLOB). */\n    readonly nameSearch?: string;\n    /** The comparison operator for `nameSearch`. Default is `=` */\n    readonly nameCompare?: \"GLOB\" | \"LIKE\" | \"NOT GLOB\" | \"NOT LIKE\" | \"=\" | \"<\" | \">\";\n    /* the Id of the view group to query. If not present, the root group is used. There is no way to query for views from multiple view groups in one request. */\n    readonly group?: IdString;\n    /** A list of tags to filter views. If present, only views that have one or more of the tags will be returned. */\n    readonly tags?: TagName[];\n    /* The name of an owner for private views. If present, private views owned by the owner will also be returned. Shared views are always returned. */\n    readonly owner?: OwnerName;\n  }\n\n  /** Parameters for specifying a Query to select Categories or Models. */\n  export interface SelectorQuery {\n    /**\n     * The full ClassName from which to select. If this SelectorQuery is for Categories, this must be or derive from \"BisCore:Category\".\n     * If this SelectorQuery is for Models, this must be or derive from \"BisCore:Model\".\n     */\n    from: ClassFullName;\n    /** If true, only return instances of `from`. Otherwise, return instances of `from` and any subclasses of `from`. */\n    only?: boolean;\n    /**\n     * filter for query. If present, only instances of `from` that satisfy the filter will be returned.\n     * If not supplied, all instances of `from` are returned.\n     * @note\n     * This value is used into the ECQuery:`SELECT ECInstanceId FROM ${query.from} WHERE ${query.where}`.\n     */\n    where?: string;\n    /** List of Model or Category ids to add to the query results.\n     * @note This is only valid if there is a `where` clause. Otherwise all instances of `from` will be returned so there is no value in adding ids.\n    */\n    adds?: Id64Array | CompressedId64Set;\n    /** List of Model or Category Ids to remove from the query results. */\n    removes?: Id64Array | CompressedId64Set;\n  }\n\n  /** A Model or Category selector may either be a query or a list of Ids. */\n  export type SelectorProps = { query: SelectorQuery, ids?: never } | { query?: never, ids: Id64Array | CompressedId64Set };\n\n  /** Information about a View in a ViewStore. */\n  export interface ViewInfo {\n    /** The Id of the view. */\n    id: IdString;\n    /** The name of the view. */\n    name?: ViewName;\n    /** The name of the owner of the view. */\n    owner?: OwnerName;\n    /** The className of the view. */\n    className: ClassFullName;\n    /** The Id of the view group containing the view. */\n    groupId: IdString;\n    /** If true, the view is private (unshared) and will only be returned by queries that specify the owner's name. */\n    isPrivate: boolean;\n    /** The Id of a ModelSelector, if the view has one. */\n    modelSelectorId?: IdString;\n    /** The Id of the CategorySelector for this view. */\n    categorySelectorId: IdString;\n    /** The Id of a DisplayStyle for the view. */\n    displayStyleId: IdString;\n    /** a list of tags for the view. */\n    tags?: TagName[];\n  }\n\n  /** Information about a ViewGroup in a ViewStore. */\n  export interface ViewGroupInfo {\n    /** The Id of this view group. */\n    id: IdString;\n    /** The name of this view group. */\n    name: ViewGroupName;\n    /** The Id of the parent of this view group. If undefined, this is the root group. */\n    parent?: IdString;\n    /** The Id of the default view for this view group. */\n    defaultView?: IdString;\n  }\n\n  /** Arguments for adding a new view to a ViewStore. */\n  export interface AddViewArgs {\n    /** the properties of the ViewDefinition for the new view. */\n    readonly viewDefinition: ViewDefinitionProps;\n\n    /**\n     * The properties of a category selector for the new view.\n     * @note This value is only used, and should only be present if `viewDefinition.categorySelectorId` **not** a valid\n     * `IdString`. In that case, a new category selector will be created with these properties and its Id will be used.\n     * Otherwise, the categorySelectorId from the ViewDefinition is used. If it does not represent a valid category\n     * selector, an error is thrown.\n     */\n    readonly categorySelectorProps?: CategorySelectorProps;\n\n    /** The properties of a model selector for the new view.\n     * @note This value is only used, and should only be present if `viewDefinition.modelSelectorId` **not** a valid\n     * `IdString`. In that case, a new model selector will be created with these properties and its Id will be used.\n     * Otherwise, the modelSelectorId from the ViewDefinition is used. If it does not represent a valid model selector,\n     * an error is thrown.\n     */\n    readonly modelSelectorProps?: ModelSelectorProps;\n\n    /** The properties of a display style for the new view.\n     * @note This value is only used, and should only be present if `viewDefinition.displayStyleId` **not** a valid\n     * `IdString`. In that case, a new display style will be created with these properties and its Id will be used.\n     * Otherwise, the displayStyleId from the ViewDefinition is used. If it does not represent a valid display style, an\n     * error is thrown.\n     */\n    readonly displayStyleProps?: DisplayStyleProps;\n\n    /* the owner of the view. Must be present if isPrivate is true. */\n    readonly owner?: OwnerName;\n\n    /* the Id of the view group for the view. If not present, the view is added to the root group. */\n    readonly group?: IdString;\n\n    /* if true, the view is private (unshared). */\n    readonly isPrivate?: boolean;\n\n    /* an optional list of tags for the view. */\n    readonly tags?: TagName[];\n\n    /** optional thumbnail for the view. */\n    readonly thumbnail?: ThumbnailProps;\n  }\n\n  /** Argument for finding a category selector, model selector, display style, or timeline by name or Id. */\n  export type NameOrId = { name: string, id?: never } | { id: IdString, name?: never };\n\n  /** Bindings for parameterized values in where clause of SelectorQuery\n   * @see[[ECSqlStatement.bindValues]]\n   */\n  export interface QueryBindings {\n    bindings?: any[] | object;\n  }\n\n  /**\n   * Methods for reading from a ViewStore via Rpc from a frontend via `IModelConnection.views.viewsStoreReader`. These\n   * methods use the *current* ViewStore for the iModel, and attempt to load the default ViewStore if no ViewStore is\n   * currently loaded. They will throw exceptions if the request cannot be fulfilled.\n   * @note The user's accessToken is validated against the ViewStore for every request. For each of these methods, the\n   * user only needs read permission to the ViewStore.\n   */\n  export interface Reader {\n    /** Find all views owned by the supplied owner name. */\n    findViewsByOwner(args: { owner: OwnerName }): Promise<ViewInfo[]>;\n\n    /** Get a category selector by Id. Throws if it does not exist. */\n    getCategorySelector(args: NameOrId & QueryBindings): Promise<CategorySelectorProps>;\n\n    /** Get a display style by Id. Throws if it does not exist. */\n    getDisplayStyle(args: NameOrId & { opts?: DisplayStyleLoadProps }): Promise<DisplayStyleProps>;\n\n    /** Get a model selector by Id. Throws if it does not exist. */\n    getModelSelector(args: NameOrId & QueryBindings): Promise<ModelSelectorProps>;\n\n    /** Get a thumbnail for a view. */\n    getThumbnail(args: { viewId: IdString }): Promise<ThumbnailProps | undefined>;\n\n    /** Get a render timeline by Id. Throws if it does not exist. */\n    getTimeline(args: NameOrId): Promise<RenderTimelineProps>;\n\n    /** Get a view by name. The name can include the *view group path*, if no `groupId` is supplied. */\n    getViewByName(arg: { name: ViewName, groupId?: IdString }): Promise<ViewInfo | undefined>;\n\n    /** Get a view definition by viewId. Throws if it does not exist. */\n    getViewDefinition(args: { viewId: IdString }): Promise<ViewDefinitionProps>;\n\n    /** get the properties of a ViewGroup by id. This will include the defaultViewId, if one exists. */\n    getViewGroupInfo(args: { groupId?: IdString }): Promise<ViewGroupInfo | undefined>;\n\n    /** Get a list of ViewGroups that are children of the supplied parent. If no parent is supplied, the root group is used.\n     * Each entry in the list includes the id and name of the ViewGroup.\n     */\n    getViewGroups(args: { parent?: ViewGroupSpec }): Promise<{ id: IdString, name: string }[]>;\n\n    /** Get the ViewInfo for a view by Id. Returns undefined if the view does not exist. */\n    getViewInfo(args: { viewId: IdString }): Promise<ViewInfo | undefined>;\n\n    /** Query for a list of ViewInfos for views that match the supplied [[QueryParams]].\n     * @note The array will be sorted by name, ascending. To limit the size of the array, supply `limit` and `offset` in the QueryParams.\n     */\n    queryViews(queryParams: QueryParams): Promise<ViewInfo[]>;\n  }\n\n  /**\n   * Methods for writing to a ViewStore via Rpc from a frontend via `IModelConnection.views.viewsStoreWriter`. These\n   * methods use the *current* ViewStore for the iModel, and attempt to load the default ViewStore if no ViewStore is\n   * currently loaded. They will throw exceptions if the request cannot be fulfilled.\n   * @note The user's accessToken is validated against the ViewStore for every request. For each of these methods, the\n   * user must have write permission to the ViewStore.\n   */\n  export interface Writer {\n    /**\n     * Add a category selector to a ViewStore.\n     * @returns The IdString of the new category selector.\n     */\n    addCategorySelector(args: { name?: string, selector: SelectorProps, owner?: OwnerName }): Promise<IdString>;\n\n    /** Add a display style to a ViewStore.\n     * @returns The IdString of the new display style.\n     */\n    addDisplayStyle(args: { name?: string, className: string, settings: DisplayStyleSettingsProps, owner?: OwnerName }): Promise<IdString>;\n\n    /**\n     *  Add a model selector to a ViewStore.\n     * @returns The IdString of the new model selector.\n     */\n    addModelSelector(args: { name?: string, selector: SelectorProps, owner?: OwnerName }): Promise<IdString>;\n\n    /**\n     * Add a thumbnail for a view. If the view already has a thumbnail, it is replaced.\n     * If a view is deleted, its thumbnail is also deleted.\n     * @note The thumbnail must be a valid image in PNG or JPEG format.\n     */\n    addOrReplaceThumbnail(args: { viewId: IdString, thumbnail: ThumbnailProps }): Promise<void>;\n\n    /** Add tags to a view. If the view already has tags, the new tags are appended to the existing tags. */\n    addTagsToView(args: { viewId: IdString, tags: TagName[] }): Promise<void>;\n\n    /** Add a render timeline to a ViewStore.\n     * @returns The IdString of the new timeline.\n     */\n    addTimeline(args: { name?: string, timeline: RenderSchedule.ScriptProps, owner?: OwnerName }): Promise<IdString>;\n\n    /** Add a view to a ViewStore. If no group is supplied, the new view is added to the root view group.\n     * @returns The IdString of the new view\n     */\n    addView(args: AddViewArgs): Promise<IdString>;\n\n    /** Add a view group to a ViewStore. If no parent is supplied, the new group is added to the root view group.\n     * @returns the IdString of new view group\n     */\n    addViewGroup(args: { name: string, parentId?: IdString, owner?: OwnerName }): Promise<IdString>;\n\n    /** Change the default view for a view group. If no group is supplied, this changes the default view for the root view group. */\n    changeDefaultViewId(args: { defaultView: IdString, group?: ViewGroupSpec }): Promise<void>;\n\n    /** Delete the thumbnail for a view. */\n    deleteThumbnail(args: { viewId: IdString }): Promise<void>;\n\n    /**\n     * Delete a view from a ViewStore. If this is the default view for a view group, it cannot be deleted until another\n     * view is set as the default.\n     * @note If this view references a category selector, model selector, or display style that is not referenced by any\n     * other view, *and do not have a name*, they will each also be deleted. If the view has a thumbnail, it is also\n     * deleted.\n     */\n    deleteView(args: { viewId: IdString }): Promise<void>;\n\n    /** Delete a view group from a ViewStore. This will also delete all views in the group. */\n    deleteViewGroup(args: { name: ViewGroupSpec }): Promise<void>;\n\n    /** Delete a display style from a ViewStore. If the display style is referenced by any view, it cannot be deleted\n     * and an exception will be thrown.\n     */\n    deleteDisplayStyle(args: { id: IdString }): Promise<void>;\n\n    /** Delete a model selector from a ViewStore. If the model selector is referenced by any view, it cannot be deleted\n     * and an exception will be thrown. */\n    deleteModelSelector(args: { id: IdString }): Promise<void>;\n\n    /** Delete a category selector from a ViewStore. If the category selector is referenced by any view, it cannot be\n     * deleted and an exception will be thrown.\n     */\n    deleteCategorySelector(args: { id: IdString }): Promise<void>;\n\n    /** Delete a render timeline from a ViewStore. */\n    deleteTimeline(args: { id: IdString }): Promise<void>;\n\n    /** Delete a tag. This removes it from all views where it was used. */\n    deleteTag(args: { name: TagName }): Promise<void>;\n\n    /** remove a tag from a view. */\n    removeTagFromView(args: { viewId: IdString, tag: TagName }): Promise<void>;\n\n    /** Update the properties of a category selector. */\n    updateCategorySelector(args: NameOrId & { selector: SelectorProps }): Promise<void>;\n\n    /** Update the properties of a display style. */\n    updateDisplayStyle(args: NameOrId & { className: string, settings: DisplayStyleSettingsProps }): Promise<void>;\n\n    /** Update the properties of a model selector. */\n    updateModelSelector(args: NameOrId & { selector: SelectorProps }): Promise<void>;\n\n    /** Update the properties of a render timeline. */\n    updateTimeline(args: NameOrId & { timeline: RenderSchedule.ScriptProps }): Promise<void>;\n\n    /** Update the properties of a view definition. */\n    updateViewDefinition(args: { viewId: IdString, viewDefinition: ViewDefinitionProps }): Promise<void>;\n\n    /** Change a view from shared to private, or vice versa. If changing to private, the owner must be supplied. */\n    updateViewShared(arg: { viewId: IdString, isShared: boolean, owner?: string }): Promise<void>;\n\n    /** Set the name of a category selector. */\n    renameCategorySelector(args: { id: IdString, name?: string }): Promise<void>;\n\n    /** Set the name of a display style. */\n    renameDisplayStyle(args: { id: IdString, name?: string }): Promise<void>;\n\n    /** Set the name of a model selector. */\n    renameModelSelector(args: { id: IdString, name?: string }): Promise<void>;\n\n    /** Set the name of a render timeline. */\n    renameTimeline(args: { id: IdString, name?: string }): Promise<void>;\n\n    /** Set the name of a view. */\n    renameView(args: { viewId: IdString, name: string }): Promise<void>;\n\n    /** Set the name of a view group. */\n    renameViewGroup(args: { groupId: IdString, name: string }): Promise<void>;\n\n    /** rename an existing tag. */\n    renameTag(args: { oldName: TagName, newName: TagName }): Promise<void>;\n  }\n}\n"]}
+{"version":3,"file":"ViewProps.js","sourceRoot":"","sources":["../../src/ViewProps.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AA4OH;;;GAGG;AACH,IAAiB,YAAY,CA0W5B;AA1WD,WAAiB,YAAY;IAE3B;;;;OAIG;IACU,oBAAO,GAAG,OAAO,CAAC;IAkC/B,qGAAqG;IACxF,0BAAa,GAAG,CAAC,EAAiB,EAAE,EAAE,CAAC,IAAI,KAAK,EAAE,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC;AAgUnF,CAAC,EA1WgB,YAAY,4BAAZ,YAAY,QA0W5B","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 Views\r\n */\r\n\r\nimport { CompressedId64Set, Id64Array, Id64String } from \"@itwin/core-bentley\";\r\nimport { AngleProps, Range3dProps, TransformProps, XYProps, XYZProps, YawPitchRollProps } from \"@itwin/core-geometry\";\r\nimport { CameraProps } from \"./Camera\";\r\nimport { DisplayStyleProps, DisplayStyleSettingsProps } from \"./DisplayStyleSettings\";\r\nimport { DefinitionElementProps, DisplayStyleLoadProps, ElementProps, RenderTimelineProps, SheetProps, ViewAttachmentProps } from \"./ElementProps\";\r\nimport { EntityQueryParams } from \"./EntityProps\";\r\nimport { ModelProps } from \"./ModelProps\";\r\nimport { SubCategoryAppearance } from \"./SubCategoryAppearance\";\r\nimport { ViewDetails3dProps, ViewDetailsProps } from \"./ViewDetails\";\r\nimport { ThumbnailProps } from \"./Thumbnail\";\r\nimport { RenderSchedule } from \"./RenderSchedule\";\r\n\r\n/** The id of either an element or an entry in a ViewStore.\r\n * @public\r\n */\r\nexport type ViewIdString = Id64String; // should also include ViewStoreRpc.IdString when that's @public\r\n\r\n/** As part of a [[ViewStateProps]], describes the [[SpatialViewDefinition]] from which a [SectionDrawing]($backend) was generated.\r\n * @see [[SectionDrawingProps]]\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SectionDrawingViewProps {\r\n  /** The Id of the spatial view from which the SectionDrawing was generated. */\r\n  spatialView: Id64String;\r\n  /** If true, the spatial view should be displayed in the context of the drawing view. */\r\n  displaySpatialView: boolean;\r\n  /** Transform from drawing coordinates to spatial coordinates. If undefined, use identity transform. */\r\n  drawingToSpatialTransform?: TransformProps;\r\n}\r\n\r\n/** The response props from the getCustomViewState3dData RPC endpoint\r\n * @internal\r\n */\r\nexport interface CustomViewState3dProps {\r\n  modelIds: CompressedId64Set;\r\n  modelExtents: Range3dProps;\r\n  categoryIds: CompressedId64Set;\r\n}\r\n\r\n/**\r\n * The options passed to the getCustomViewState3dData RPC endpoint.\r\n * @internal\r\n */\r\nexport interface CustomViewState3dCreatorOptions {\r\n  modelIds?: CompressedId64Set;\r\n}\r\n\r\n/**\r\n * A result row from querying for subcategories\r\n * @internal\r\n */\r\nexport interface SubCategoryResultRow {\r\n  parentId: Id64String;\r\n  id: Id64String;\r\n  appearance: SubCategoryAppearance.Props;\r\n}\r\n\r\n/**\r\n * Request props for the hydrateViewState RPC endpoint.\r\n * @internal\r\n */\r\nexport interface HydrateViewStateRequestProps {\r\n  acsId?: string;\r\n  notLoadedModelSelectorStateModels?: CompressedId64Set;\r\n  sheetViewAttachmentIds?: CompressedId64Set;\r\n  viewStateLoadProps?: ViewStateLoadProps;\r\n  baseModelId?: Id64String;\r\n  spatialViewId?: Id64String;\r\n}\r\n\r\n/** Response props from the hydrateViewState RPC endpoint.\r\n * @internal\r\n */\r\nexport interface HydrateViewStateResponseProps {\r\n  acsElementProps?: ElementProps;\r\n  modelSelectorStateModels?: ModelProps[];\r\n  // cast this to viewAttachmentInfo[] on the frontend.\r\n  sheetViewAttachmentProps?: ViewAttachmentProps[];\r\n  sheetViewViews?: (ViewStateProps | undefined)[];\r\n  baseModelProps?: ModelProps;\r\n  spatialViewProps?: ViewStateProps;\r\n}\r\n\r\n/** Returned from [IModelDb.Views.getViewStateProps]($backend).\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewStateProps {\r\n  viewDefinitionProps: ViewDefinitionProps;\r\n  categorySelectorProps: CategorySelectorProps;\r\n  modelSelectorProps?: ModelSelectorProps;\r\n  displayStyleProps: DisplayStyleProps;\r\n  /** Sheet-specific properties, if this is a view of a [SheetModel]($backend). */\r\n  sheetProps?: SheetProps;\r\n  /** The Ids of the [ViewAttachment]($backend)s contained within the [SheetModel]($backend), if this is a sheet view. */\r\n  sheetAttachments?: Id64Array;\r\n  /** For a [DrawingViewState]($frontend), the extents of the [DrawingModel]($backend), used for determining the upper limits of the view's extents. */\r\n  modelExtents?: Range3dProps;\r\n  /** Information about the [SectionDrawing]($backend) relevant to displaying a drawing view. */\r\n  sectionDrawing?: SectionDrawingViewProps;\r\n}\r\n\r\n/** Options for loading a [[ViewStateProps]] via [IModelConnection.Views.load]($frontend) or [IModelDb.Views.getViewStateProps]($backend).\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewStateLoadProps {\r\n  /** Options for loading the view's [[DisplayStyleProps]]. */\r\n  displayStyle?: DisplayStyleLoadProps;\r\n\r\n  /**\r\n   * bindings for query-based selectors\r\n   * @beta\r\n   */\r\n  queryBindings?: {\r\n    modelSelector?: ViewStoreRpc.QueryBindings;\r\n    categorySelector?: ViewStoreRpc.QueryBindings;\r\n  };\r\n}\r\n\r\n/** Properties that define a ModelSelector\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ModelSelectorProps extends DefinitionElementProps {\r\n  models: Id64Array;\r\n}\r\n\r\n/** Properties that define a CategorySelector\r\n * @public\r\n * @extensions\r\n */\r\nexport interface CategorySelectorProps extends DefinitionElementProps {\r\n  categories: Id64Array;\r\n}\r\n\r\n/** Parameters for performing a query on [ViewDefinition]($backend) classes.\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewQueryParams extends EntityQueryParams {\r\n  wantPrivate?: boolean;\r\n}\r\n\r\n/** Parameters used to construct a ViewDefinition\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewDefinitionProps extends DefinitionElementProps {\r\n  categorySelectorId: ViewIdString;\r\n  displayStyleId: ViewIdString;\r\n  description?: string;\r\n  jsonProperties?: {\r\n    /** Additional properties of the view. */\r\n    viewDetails?: ViewDetailsProps;\r\n  };\r\n}\r\n\r\n/** Parameters to construct a ViewDefinition3d\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewDefinition3dProps extends ViewDefinitionProps {\r\n  /** if true, camera is valid. */\r\n  cameraOn: boolean;\r\n  /** The lower left back corner of the view frustum. */\r\n  origin: XYZProps;\r\n  /** The extent of the view frustum. */\r\n  extents: XYZProps;\r\n  /** Rotation of the view frustum (could be undefined if going Matrix3d -> YawPitchRoll). */\r\n  angles?: YawPitchRollProps;\r\n  /** The camera used for this view. */\r\n  camera: CameraProps;\r\n  jsonProperties?: {\r\n    /** Additional properties of the view. */\r\n    viewDetails?: ViewDetails3dProps;\r\n  };\r\n}\r\n\r\n/** Parameters to construct a SpatialViewDefinition\r\n * @public\r\n * @extensions\r\n */\r\nexport interface SpatialViewDefinitionProps extends ViewDefinition3dProps {\r\n  modelSelectorId: ViewIdString;\r\n}\r\n\r\n/** Parameters used to construct a ViewDefinition2d\r\n * @public\r\n * @extensions\r\n */\r\nexport interface ViewDefinition2dProps extends ViewDefinitionProps {\r\n  baseModelId: Id64String;\r\n  origin: XYProps;\r\n  delta: XYProps;\r\n  angle: AngleProps;\r\n}\r\n\r\n/**\r\n * @public\r\n * @extensions\r\n */\r\nexport interface AuxCoordSystemProps extends ElementProps {\r\n  type?: number;\r\n  description?: string;\r\n}\r\n\r\n/**  Properties of AuxCoordSystem2d\r\n * @public\r\n * @extensions\r\n */\r\nexport interface AuxCoordSystem2dProps extends AuxCoordSystemProps {\r\n  /** Origin of the AuxCoordSystem2d */\r\n  origin?: XYProps;\r\n  /** Rotation angle */\r\n  angle?: AngleProps;\r\n}\r\n\r\n/** Properties of AuxCoordSystem3d\r\n * @public\r\n * @extensions\r\n */\r\nexport interface AuxCoordSystem3dProps extends AuxCoordSystemProps {\r\n  /** Origin of the AuxCoordSystem3d */\r\n  origin?: XYZProps;\r\n  /** Yaw angle */\r\n  yaw?: AngleProps;\r\n  /** Pitch angle */\r\n  pitch?: AngleProps;\r\n  /** Roll angle */\r\n  roll?: AngleProps;\r\n}\r\n\r\n/**\r\n * Access to a ViewStore from the frontend.\r\n * @beta\r\n */\r\nexport namespace ViewStoreRpc {\r\n\r\n  /**\r\n   * Version of the Rpc interface. If any methods or interfaces of this API change, this number should\r\n   * be incremented according to the rules of semantic versioning. See .\\rpc\\README-RpcInterfaceVersioning.md for more information.\r\n   *  @internal\r\n   */\r\n  export const version = \"4.0.0\";\r\n\r\n  /** an Id of a View, DisplayStyle, ModelSelector, CategorySelector, or Timeline in a ViewStore.\r\n   * Will be a base-36 number with a leading \"@\".\r\n   * @public\r\n   */\r\n  export type IdString = string;\r\n\r\n  /**\r\n   * A string identifying a group. This may either be a \"group name path\" or the RowString of a group (e.g. either \"group1/design/issues\" or \"@4e3\")\r\n   * The syntax is not ambiguous because ViewStoreIdStrings always start with \"@\" and  Group names can never contain \"@\".\r\n   */\r\n  export type ViewGroupSpec = IdString | ViewGroupPath;\r\n\r\n  /** The name for a view. */\r\n  export type ViewName = string;\r\n\r\n  /** The name for a Tag. */\r\n  export type TagName = string;\r\n\r\n  /** The name of an \"owner\". Should come from the authentication system, so it will be guaranteed unique.\r\n   * This name should be chosen by the user rather than their email address.\r\n   */\r\n  export type OwnerName = string;\r\n\r\n  /** The path name of a view group (e.g. \"group1/design/issues\"). Does not include the \"root\" group. */\r\n  export type ViewGroupPath = string;\r\n\r\n  /** The name for a view group.  */\r\n  export type ViewGroupName = string;\r\n\r\n  /** The name for a view group.  */\r\n  export type ClassFullName = string;\r\n\r\n  /** Determine if a string is an Id of an entry in a ViewStore (base-36 integer with a leading \"@\") */\r\n  export const isViewStoreId = (id?: ViewIdString) => true === id?.startsWith(\"@\");\r\n\r\n  /** Parameters for querying for views in a ViewStore. */\r\n  export interface QueryParams {\r\n    /** a list of classFullNames to accept. If not present, all classes are returned. */\r\n    readonly classNames?: ClassFullName[];\r\n    /** Optional \"LIMIT\" clause to limit the number of views returned. */\r\n    readonly limit?: number;\r\n    /** Optional \"OFFSET\" clause. Only valid if Limit is also present. */\r\n    readonly offset?: number;\r\n    /** A string to filter view names. May include wildcards if the `nameCompare` uses LIKE or GLOB (see SQLite documentation for LIKE and GLOB). */\r\n    readonly nameSearch?: string;\r\n    /** The comparison operator for `nameSearch`. Default is `=` */\r\n    readonly nameCompare?: \"GLOB\" | \"LIKE\" | \"NOT GLOB\" | \"NOT LIKE\" | \"=\" | \"<\" | \">\";\r\n    /* the Id of the view group to query. If not present, the root group is used. There is no way to query for views from multiple view groups in one request. */\r\n    readonly group?: IdString;\r\n    /** A list of tags to filter views. If present, only views that have one or more of the tags will be returned. */\r\n    readonly tags?: TagName[];\r\n    /* The name of an owner for private views. If present, private views owned by the owner will also be returned. Shared views are always returned. */\r\n    readonly owner?: OwnerName;\r\n  }\r\n\r\n  /** Parameters for specifying a Query to select Categories or Models. */\r\n  export interface SelectorQuery {\r\n    /**\r\n     * The full ClassName from which to select. If this SelectorQuery is for Categories, this must be or derive from \"BisCore:Category\".\r\n     * If this SelectorQuery is for Models, this must be or derive from \"BisCore:Model\".\r\n     */\r\n    from: ClassFullName;\r\n    /** If true, only return instances of `from`. Otherwise, return instances of `from` and any subclasses of `from`. */\r\n    only?: boolean;\r\n    /**\r\n     * filter for query. If present, only instances of `from` that satisfy the filter will be returned.\r\n     * If not supplied, all instances of `from` are returned.\r\n     * @note\r\n     * This value is used into the ECQuery:`SELECT ECInstanceId FROM ${query.from} WHERE ${query.where}`.\r\n     */\r\n    where?: string;\r\n    /** List of Model or Category ids to add to the query results.\r\n     * @note This is only valid if there is a `where` clause. Otherwise all instances of `from` will be returned so there is no value in adding ids.\r\n    */\r\n    adds?: Id64Array | CompressedId64Set;\r\n    /** List of Model or Category Ids to remove from the query results. */\r\n    removes?: Id64Array | CompressedId64Set;\r\n  }\r\n\r\n  /** A Model or Category selector may either be a query or a list of Ids. */\r\n  export type SelectorProps = { query: SelectorQuery, ids?: never } | { query?: never, ids: Id64Array | CompressedId64Set };\r\n\r\n  /** Information about a View in a ViewStore. */\r\n  export interface ViewInfo {\r\n    /** The Id of the view. */\r\n    id: IdString;\r\n    /** The name of the view. */\r\n    name?: ViewName;\r\n    /** The name of the owner of the view. */\r\n    owner?: OwnerName;\r\n    /** The className of the view. */\r\n    className: ClassFullName;\r\n    /** The Id of the view group containing the view. */\r\n    groupId: IdString;\r\n    /** If true, the view is private (unshared) and will only be returned by queries that specify the owner's name. */\r\n    isPrivate: boolean;\r\n    /** The Id of a ModelSelector, if the view has one. */\r\n    modelSelectorId?: IdString;\r\n    /** The Id of the CategorySelector for this view. */\r\n    categorySelectorId: IdString;\r\n    /** The Id of a DisplayStyle for the view. */\r\n    displayStyleId: IdString;\r\n    /** a list of tags for the view. */\r\n    tags?: TagName[];\r\n  }\r\n\r\n  /** Information about a ViewGroup in a ViewStore. */\r\n  export interface ViewGroupInfo {\r\n    /** The Id of this view group. */\r\n    id: IdString;\r\n    /** The name of this view group. */\r\n    name: ViewGroupName;\r\n    /** The Id of the parent of this view group. If undefined, this is the root group. */\r\n    parent?: IdString;\r\n    /** The Id of the default view for this view group. */\r\n    defaultView?: IdString;\r\n  }\r\n\r\n  /** Arguments for adding a new view to a ViewStore. */\r\n  export interface AddViewArgs {\r\n    /** the properties of the ViewDefinition for the new view. */\r\n    readonly viewDefinition: ViewDefinitionProps;\r\n\r\n    /**\r\n     * The properties of a category selector for the new view.\r\n     * @note This value is only used, and should only be present if `viewDefinition.categorySelectorId` **not** a valid\r\n     * `IdString`. In that case, a new category selector will be created with these properties and its Id will be used.\r\n     * Otherwise, the categorySelectorId from the ViewDefinition is used. If it does not represent a valid category\r\n     * selector, an error is thrown.\r\n     */\r\n    readonly categorySelectorProps?: CategorySelectorProps;\r\n\r\n    /** The properties of a model selector for the new view.\r\n     * @note This value is only used, and should only be present if `viewDefinition.modelSelectorId` **not** a valid\r\n     * `IdString`. In that case, a new model selector will be created with these properties and its Id will be used.\r\n     * Otherwise, the modelSelectorId from the ViewDefinition is used. If it does not represent a valid model selector,\r\n     * an error is thrown.\r\n     */\r\n    readonly modelSelectorProps?: ModelSelectorProps;\r\n\r\n    /** The properties of a display style for the new view.\r\n     * @note This value is only used, and should only be present if `viewDefinition.displayStyleId` **not** a valid\r\n     * `IdString`. In that case, a new display style will be created with these properties and its Id will be used.\r\n     * Otherwise, the displayStyleId from the ViewDefinition is used. If it does not represent a valid display style, an\r\n     * error is thrown.\r\n     */\r\n    readonly displayStyleProps?: DisplayStyleProps;\r\n\r\n    /* the owner of the view. Must be present if isPrivate is true. */\r\n    readonly owner?: OwnerName;\r\n\r\n    /* the Id of the view group for the view. If not present, the view is added to the root group. */\r\n    readonly group?: IdString;\r\n\r\n    /* if true, the view is private (unshared). */\r\n    readonly isPrivate?: boolean;\r\n\r\n    /* an optional list of tags for the view. */\r\n    readonly tags?: TagName[];\r\n\r\n    /** optional thumbnail for the view. */\r\n    readonly thumbnail?: ThumbnailProps;\r\n  }\r\n\r\n  /** Argument for finding a category selector, model selector, display style, or timeline by name or Id. */\r\n  export type NameOrId = { name: string, id?: never } | { id: IdString, name?: never };\r\n\r\n  /** Bindings for parameterized values in where clause of SelectorQuery\r\n   * @see[[ECSqlStatement.bindValues]]\r\n   */\r\n  export interface QueryBindings {\r\n    bindings?: any[] | object;\r\n  }\r\n\r\n  /**\r\n   * Methods for reading from a ViewStore via Rpc from a frontend via `IModelConnection.views.viewsStoreReader`. These\r\n   * methods use the *current* ViewStore for the iModel, and attempt to load the default ViewStore if no ViewStore is\r\n   * currently loaded. They will throw exceptions if the request cannot be fulfilled.\r\n   * @note The user's accessToken is validated against the ViewStore for every request. For each of these methods, the\r\n   * user only needs read permission to the ViewStore.\r\n   */\r\n  export interface Reader {\r\n    /** Find all views owned by the supplied owner name. */\r\n    findViewsByOwner(args: { owner: OwnerName }): Promise<ViewInfo[]>;\r\n\r\n    /** Get a category selector by Id. Throws if it does not exist. */\r\n    getCategorySelector(args: NameOrId & QueryBindings): Promise<CategorySelectorProps>;\r\n\r\n    /** Get a display style by Id. Throws if it does not exist. */\r\n    getDisplayStyle(args: NameOrId & { opts?: DisplayStyleLoadProps }): Promise<DisplayStyleProps>;\r\n\r\n    /** Get a model selector by Id. Throws if it does not exist. */\r\n    getModelSelector(args: NameOrId & QueryBindings): Promise<ModelSelectorProps>;\r\n\r\n    /** Get a thumbnail for a view. */\r\n    getThumbnail(args: { viewId: IdString }): Promise<ThumbnailProps | undefined>;\r\n\r\n    /** Get a render timeline by Id. Throws if it does not exist. */\r\n    getTimeline(args: NameOrId): Promise<RenderTimelineProps>;\r\n\r\n    /** Get a view by name. The name can include the *view group path*, if no `groupId` is supplied. */\r\n    getViewByName(arg: { name: ViewName, groupId?: IdString }): Promise<ViewInfo | undefined>;\r\n\r\n    /** Get a view definition by viewId. Throws if it does not exist. */\r\n    getViewDefinition(args: { viewId: IdString }): Promise<ViewDefinitionProps>;\r\n\r\n    /** get the properties of a ViewGroup by id. This will include the defaultViewId, if one exists. */\r\n    getViewGroupInfo(args: { groupId?: IdString }): Promise<ViewGroupInfo | undefined>;\r\n\r\n    /** Get a list of ViewGroups that are children of the supplied parent. If no parent is supplied, the root group is used.\r\n     * Each entry in the list includes the id and name of the ViewGroup.\r\n     */\r\n    getViewGroups(args: { parent?: ViewGroupSpec }): Promise<{ id: IdString, name: string }[]>;\r\n\r\n    /** Get the ViewInfo for a view by Id. Returns undefined if the view does not exist. */\r\n    getViewInfo(args: { viewId: IdString }): Promise<ViewInfo | undefined>;\r\n\r\n    /** Query for a list of ViewInfos for views that match the supplied [[QueryParams]].\r\n     * @note The array will be sorted by name, ascending. To limit the size of the array, supply `limit` and `offset` in the QueryParams.\r\n     */\r\n    queryViews(queryParams: QueryParams): Promise<ViewInfo[]>;\r\n  }\r\n\r\n  /**\r\n   * Methods for writing to a ViewStore via Rpc from a frontend via `IModelConnection.views.viewsStoreWriter`. These\r\n   * methods use the *current* ViewStore for the iModel, and attempt to load the default ViewStore if no ViewStore is\r\n   * currently loaded. They will throw exceptions if the request cannot be fulfilled.\r\n   * @note The user's accessToken is validated against the ViewStore for every request. For each of these methods, the\r\n   * user must have write permission to the ViewStore.\r\n   */\r\n  export interface Writer {\r\n    /**\r\n     * Add a category selector to a ViewStore.\r\n     * @returns The IdString of the new category selector.\r\n     */\r\n    addCategorySelector(args: { name?: string, selector: SelectorProps, owner?: OwnerName }): Promise<IdString>;\r\n\r\n    /** Add a display style to a ViewStore.\r\n     * @returns The IdString of the new display style.\r\n     */\r\n    addDisplayStyle(args: { name?: string, className: string, settings: DisplayStyleSettingsProps, owner?: OwnerName }): Promise<IdString>;\r\n\r\n    /**\r\n     *  Add a model selector to a ViewStore.\r\n     * @returns The IdString of the new model selector.\r\n     */\r\n    addModelSelector(args: { name?: string, selector: SelectorProps, owner?: OwnerName }): Promise<IdString>;\r\n\r\n    /**\r\n     * Add a thumbnail for a view. If the view already has a thumbnail, it is replaced.\r\n     * If a view is deleted, its thumbnail is also deleted.\r\n     * @note The thumbnail must be a valid image in PNG or JPEG format.\r\n     */\r\n    addOrReplaceThumbnail(args: { viewId: IdString, thumbnail: ThumbnailProps }): Promise<void>;\r\n\r\n    /** Add tags to a view. If the view already has tags, the new tags are appended to the existing tags. */\r\n    addTagsToView(args: { viewId: IdString, tags: TagName[] }): Promise<void>;\r\n\r\n    /** Add a render timeline to a ViewStore.\r\n     * @returns The IdString of the new timeline.\r\n     */\r\n    addTimeline(args: { name?: string, timeline: RenderSchedule.ScriptProps, owner?: OwnerName }): Promise<IdString>;\r\n\r\n    /** Add a view to a ViewStore. If no group is supplied, the new view is added to the root view group.\r\n     * @returns The IdString of the new view\r\n     */\r\n    addView(args: AddViewArgs): Promise<IdString>;\r\n\r\n    /** Add a view group to a ViewStore. If no parent is supplied, the new group is added to the root view group.\r\n     * @returns the IdString of new view group\r\n     */\r\n    addViewGroup(args: { name: string, parentId?: IdString, owner?: OwnerName }): Promise<IdString>;\r\n\r\n    /** Change the default view for a view group. If no group is supplied, this changes the default view for the root view group. */\r\n    changeDefaultViewId(args: { defaultView: IdString, group?: ViewGroupSpec }): Promise<void>;\r\n\r\n    /** Delete the thumbnail for a view. */\r\n    deleteThumbnail(args: { viewId: IdString }): Promise<void>;\r\n\r\n    /**\r\n     * Delete a view from a ViewStore. If this is the default view for a view group, it cannot be deleted until another\r\n     * view is set as the default.\r\n     * @note If this view references a category selector, model selector, or display style that is not referenced by any\r\n     * other view, *and do not have a name*, they will each also be deleted. If the view has a thumbnail, it is also\r\n     * deleted.\r\n     */\r\n    deleteView(args: { viewId: IdString }): Promise<void>;\r\n\r\n    /** Delete a view group from a ViewStore. This will also delete all views in the group. */\r\n    deleteViewGroup(args: { name: ViewGroupSpec }): Promise<void>;\r\n\r\n    /** Delete a display style from a ViewStore. If the display style is referenced by any view, it cannot be deleted\r\n     * and an exception will be thrown.\r\n     */\r\n    deleteDisplayStyle(args: { id: IdString }): Promise<void>;\r\n\r\n    /** Delete a model selector from a ViewStore. If the model selector is referenced by any view, it cannot be deleted\r\n     * and an exception will be thrown. */\r\n    deleteModelSelector(args: { id: IdString }): Promise<void>;\r\n\r\n    /** Delete a category selector from a ViewStore. If the category selector is referenced by any view, it cannot be\r\n     * deleted and an exception will be thrown.\r\n     */\r\n    deleteCategorySelector(args: { id: IdString }): Promise<void>;\r\n\r\n    /** Delete a render timeline from a ViewStore. */\r\n    deleteTimeline(args: { id: IdString }): Promise<void>;\r\n\r\n    /** Delete a tag. This removes it from all views where it was used. */\r\n    deleteTag(args: { name: TagName }): Promise<void>;\r\n\r\n    /** remove a tag from a view. */\r\n    removeTagFromView(args: { viewId: IdString, tag: TagName }): Promise<void>;\r\n\r\n    /** Update the properties of a category selector. */\r\n    updateCategorySelector(args: NameOrId & { selector: SelectorProps }): Promise<void>;\r\n\r\n    /** Update the properties of a display style. */\r\n    updateDisplayStyle(args: NameOrId & { className: string, settings: DisplayStyleSettingsProps }): Promise<void>;\r\n\r\n    /** Update the properties of a model selector. */\r\n    updateModelSelector(args: NameOrId & { selector: SelectorProps }): Promise<void>;\r\n\r\n    /** Update the properties of a render timeline. */\r\n    updateTimeline(args: NameOrId & { timeline: RenderSchedule.ScriptProps }): Promise<void>;\r\n\r\n    /** Update the properties of a view definition. */\r\n    updateViewDefinition(args: { viewId: IdString, viewDefinition: ViewDefinitionProps }): Promise<void>;\r\n\r\n    /** Change a view from shared to private, or vice versa. If changing to private, the owner must be supplied. */\r\n    updateViewShared(arg: { viewId: IdString, isShared: boolean, owner?: string }): Promise<void>;\r\n\r\n    /** Set the name of a category selector. */\r\n    renameCategorySelector(args: { id: IdString, name?: string }): Promise<void>;\r\n\r\n    /** Set the name of a display style. */\r\n    renameDisplayStyle(args: { id: IdString, name?: string }): Promise<void>;\r\n\r\n    /** Set the name of a model selector. */\r\n    renameModelSelector(args: { id: IdString, name?: string }): Promise<void>;\r\n\r\n    /** Set the name of a render timeline. */\r\n    renameTimeline(args: { id: IdString, name?: string }): Promise<void>;\r\n\r\n    /** Set the name of a view. */\r\n    renameView(args: { viewId: IdString, name: string }): Promise<void>;\r\n\r\n    /** Set the name of a view group. */\r\n    renameViewGroup(args: { groupId: IdString, name: string }): Promise<void>;\r\n\r\n    /** rename an existing tag. */\r\n    renameTag(args: { oldName: TagName, newName: TagName }): Promise<void>;\r\n  }\r\n}\r\n"]}

package/lib/cjs/WhiteOnWhiteReversalSettings.js.map

@@ -1 +1 @@
-{"version":3,"file":"WhiteOnWhiteReversalSettings.js","sourceRoot":"","sources":["../../src/WhiteOnWhiteReversalSettings.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAaH;;;;;;GAMG;AACH,MAAa,4BAA4B;IACvC;;;OAGG;IACa,qBAAqB,CAAU;IAE/C,YAAoB,gBAAyB;QAC3C,IAAI,CAAC,qBAAqB,GAAG,gBAAgB,CAAC;IAChD,CAAC;IAEO,MAAM,CAAC,SAAS,GAAG,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,GAAG,IAAI,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAEjE,uCAAuC;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAiC;QACtD,OAAO,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACtE,CAAC;IAED,mHAAmH;IAC5G,MAAM;QACX,OAAO,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,CAAC;IAED,uDAAuD;IAChD,MAAM,CAAC,KAAmC;QAC/C,OAAO,IAAI,KAAK,KAAK,CAAC;IACxB,CAAC;;AA3BH,oEA4BC","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 DisplayStyles\n */\n\n/** JSON representation of a [[WhiteOnWhiteReversalSettings]].\n * @public\n * @extensions\n */\nexport interface WhiteOnWhiteReversalProps {\n  /** Default: false.\n   * @see [[WhiteOnWhiteReversalSettings.ignoreBackgroundColor]].\n   */\n  ignoreBackgroundColor?: boolean;\n}\n\n/** As part of a [[DisplayStyleSettings]], controls how white-on-white reversal is applied to make white geometry more\n * visible in the view.\n * By default, pure white geometry is displayed as black instead if the [[DisplayStyleSettings.backgroundColor]] is also pure white.\n * These settings are only applied if the display style's [[ViewFlags.whiteOnWhiteReversal]] flag is enabled.\n * @see [[DisplayStyleSettings.whiteOnWhiteReversal]] to change these settings for a display style.\n * @public\n */\nexport class WhiteOnWhiteReversalSettings {\n  /** If true, white-on-white reversal ignores the display style's background color; otherwise, white-on-white reversal applies only\n   * if the background color is pure white.\n   * @see [[DisplayStyleSettings.backgroundColor]] to change the background color.\n   */\n  public readonly ignoreBackgroundColor: boolean;\n\n  private constructor(ignoreBackground: boolean) {\n    this.ignoreBackgroundColor = ignoreBackground;\n  }\n\n  private static _noIgnore = new WhiteOnWhiteReversalSettings(true);\n  private static _ignore = new WhiteOnWhiteReversalSettings(false);\n\n  /** Create from JSON representation. */\n  public static fromJSON(props?: WhiteOnWhiteReversalProps): WhiteOnWhiteReversalSettings {\n    return props?.ignoreBackgroundColor ? this._noIgnore : this._ignore;\n  }\n\n  /** Convert to JSON representation. The JSON representation is `undefined` if these settings match the defaults. */\n  public toJSON(): WhiteOnWhiteReversalProps | undefined {\n    return this.ignoreBackgroundColor ? { ignoreBackgroundColor: true } : undefined;\n  }\n\n  /** Returns true if `this` is equivalent to `other`. */\n  public equals(other: WhiteOnWhiteReversalSettings): boolean {\n    return this === other;\n  }\n}\n"]}
+{"version":3,"file":"WhiteOnWhiteReversalSettings.js","sourceRoot":"","sources":["../../src/WhiteOnWhiteReversalSettings.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAaH;;;;;;GAMG;AACH,MAAa,4BAA4B;IACvC;;;OAGG;IACa,qBAAqB,CAAU;IAE/C,YAAoB,gBAAyB;QAC3C,IAAI,CAAC,qBAAqB,GAAG,gBAAgB,CAAC;IAChD,CAAC;IAEO,MAAM,CAAC,SAAS,GAAG,IAAI,4BAA4B,CAAC,IAAI,CAAC,CAAC;IAC1D,MAAM,CAAC,OAAO,GAAG,IAAI,4BAA4B,CAAC,KAAK,CAAC,CAAC;IAEjE,uCAAuC;IAChC,MAAM,CAAC,QAAQ,CAAC,KAAiC;QACtD,OAAO,KAAK,EAAE,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC;IACtE,CAAC;IAED,mHAAmH;IAC5G,MAAM;QACX,OAAO,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC,EAAE,qBAAqB,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAClF,CAAC;IAED,uDAAuD;IAChD,MAAM,CAAC,KAAmC;QAC/C,OAAO,IAAI,KAAK,KAAK,CAAC;IACxB,CAAC;;AA3BH,oEA4BC","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 DisplayStyles\r\n */\r\n\r\n/** JSON representation of a [[WhiteOnWhiteReversalSettings]].\r\n * @public\r\n * @extensions\r\n */\r\nexport interface WhiteOnWhiteReversalProps {\r\n  /** Default: false.\r\n   * @see [[WhiteOnWhiteReversalSettings.ignoreBackgroundColor]].\r\n   */\r\n  ignoreBackgroundColor?: boolean;\r\n}\r\n\r\n/** As part of a [[DisplayStyleSettings]], controls how white-on-white reversal is applied to make white geometry more\r\n * visible in the view.\r\n * By default, pure white geometry is displayed as black instead if the [[DisplayStyleSettings.backgroundColor]] is also pure white.\r\n * These settings are only applied if the display style's [[ViewFlags.whiteOnWhiteReversal]] flag is enabled.\r\n * @see [[DisplayStyleSettings.whiteOnWhiteReversal]] to change these settings for a display style.\r\n * @public\r\n */\r\nexport class WhiteOnWhiteReversalSettings {\r\n  /** If true, white-on-white reversal ignores the display style's background color; otherwise, white-on-white reversal applies only\r\n   * if the background color is pure white.\r\n   * @see [[DisplayStyleSettings.backgroundColor]] to change the background color.\r\n   */\r\n  public readonly ignoreBackgroundColor: boolean;\r\n\r\n  private constructor(ignoreBackground: boolean) {\r\n    this.ignoreBackgroundColor = ignoreBackground;\r\n  }\r\n\r\n  private static _noIgnore = new WhiteOnWhiteReversalSettings(true);\r\n  private static _ignore = new WhiteOnWhiteReversalSettings(false);\r\n\r\n  /** Create from JSON representation. */\r\n  public static fromJSON(props?: WhiteOnWhiteReversalProps): WhiteOnWhiteReversalSettings {\r\n    return props?.ignoreBackgroundColor ? this._noIgnore : this._ignore;\r\n  }\r\n\r\n  /** Convert to JSON representation. The JSON representation is `undefined` if these settings match the defaults. */\r\n  public toJSON(): WhiteOnWhiteReversalProps | undefined {\r\n    return this.ignoreBackgroundColor ? { ignoreBackgroundColor: true } : undefined;\r\n  }\r\n\r\n  /** Returns true if `this` is equivalent to `other`. */\r\n  public equals(other: WhiteOnWhiteReversalSettings): boolean {\r\n    return this === other;\r\n  }\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"TextAnnotation.js","sourceRoot":"","sources":["../../../src/annotation/TextAnnotation.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 { Point3d, Range2d, Transform, XYZProps, YawPitchRollAngles, YawPitchRollProps } from \"@itwin/core-geometry\";\nimport { TextBlock, TextBlockProps } from \"./TextBlock\";\nimport { TextStyleSettingsProps } from \"./TextStyle\";\n\n/** Describes how to compute the \"anchor point\" for a [[TextAnnotation]].\n * The anchor point is a point on or inside of the 2d bounding box enclosing the contents of the annotation's [[TextBlock]].\n * The annotation can be rotated and translated relative to the anchor point. The anchor point also serves as the snap point\n * when [AccuSnap]($frontend) is set to [SnapMode.Origin]($frontend).\n * [[TextAnnotation.computeTransform]] will align the anchor point with (0, 0).\n * @see [[TextAnnotation]] for a description of how the anchor point is computed.\n * @beta\n */\nexport interface TextAnnotationAnchor {\n  /**\n   * The vertical alignment of the anchor point.\n   * \"top\" aligns the anchor point with the top of the text's bounding box.\n   * \"middle\" aligns the anchor point with the middle of the text's bounding box.\n   * \"bottom\" aligns the anchor point with the bottom of the text's bounding box.\n   */\n  vertical: \"top\" | \"middle\" | \"bottom\";\n\n  /**\n   * The horizontal alignment of the anchor point.\n   * \"left\" aligns the anchor point with left side of the text's bounding box.\n   * \"center\" aligns the anchor point with center of the text with's bounding box.\n   * \"right\" aligns the anchor point with right side of the text's bounding box.\n   */\n  horizontal: \"left\" | \"center\" | \"right\";\n}\n\n/**\n * Describes how to attach a [[TextAnnotationLeader]] to the frame around a [[TextBlock]].\n * Leader can be attached using one of the three modes:\n * - KeyPoint: attach to a point on the frame specified by the given curveIndex and fractional position.\n * - TextPoint: attach to a point that is projected on to the frame from the point on a particular line of text specified by [[LeaderTextPointOptions]].\n * - Nearest: attach to the point on frame that is nearest to [[TextAnnotationLeader.startPoint]].\n * @beta\n */\nexport type LeaderAttachment =\n  | { mode: \"KeyPoint\"; curveIndex: number; fraction: number }\n  | { mode: \"TextPoint\"; position: LeaderTextPointOptions }\n  | { mode: \"Nearest\" };\n\n/**\n * Specifies the possible positions to attach a leader on the frame around a [[TextBlock]]\n * when [[TextAnnotationLeader.attachment.mode]] is set to TextPoint.\n * TopLeft : attach to a point projected onto the frame from the point on the left side of the first line of text.\n * TopRight : attach to a point projected onto the frame from the point on the right side of the first line of text.\n * BottomLeft : attach to a point projected onto the frame from the point on the left side of the last line of text.\n * BottomRight : attach to a point projected onto the frame from the point on the right side of the last line of text.\n * @beta\n */\nexport type LeaderTextPointOptions = \"TopLeft\" | \"TopRight\" | \"BottomLeft\" | \"BottomRight\"\n\n/**\n * A line that connects a [[TextAnnotation]] to a point in space relative to another element in the iModel.\n * A leader is always attached to the frame around the annotation's [[TextBlock]].\n * If the frame is not visible, the leader attaches to an invisible rectangular frame around the text block.\n * @see [[TextAnnotation.leaders]] for the leaders associated with an annotation.\n * @see [[TextStyleSettings.leader]] and [[styleOverrides]] to customize the appearance of leaders.\n * @beta\n*/\nexport interface TextAnnotationLeader {\n  /** The point where the leader starts.\n   * This is the point on another element where the leader points to */\n  startPoint: Point3d;\n  /** Describes how to attach the leader to the frame around [[textBlock]].*/\n  attachment: LeaderAttachment;\n  /** Optional intermediate points that the leader should pass through.\n   * If not specified, the leader will be a straight line from startPoint to the point on the frame.\n   * For now, intermediate points are a set of points which create additional LineSegments in the leader, but there could be intermediate shapes instead of straight LineSegments in future*/\n  intermediatePoints?: Point3d[];\n  /** Optional style overrides for the leader. If not specified, the leader will use the style defined by [[TextBlock.styleName]] as it is.\n   * If specified, these overrides will be applied to the style.\n   */\n  styleOverrides?: TextStyleSettingsProps;\n}\n/**\n * JSON representation of a [[TextAnnotationLeader]].\n * @beta\n */\nexport interface TextAnnotationLeaderProps {\n  /** See [[TextAnnotationLeader.startPoint]]. */\n  startPoint: XYZProps;\n  /** See [[TextAnnotationLeader.attachment]]. */\n  attachment: LeaderAttachment;\n  /** See [[TextAnnotationLeader.intermediatePoints]]. Default: no intermediate points. */\n  intermediatePoints?: XYZProps[];\n  /** See [[TextAnnotationLeader.styleOverrides]]. Default: no style overrides. */\n  styleOverrides?: TextStyleSettingsProps;\n}\n\n/**\n * JSON representation of a [[TextAnnotation]].\n * @beta\n */\nexport interface TextAnnotationProps {\n  /** See [[TextAnnotation.offset]]. Default: [0, 0, 0]. */\n  offset?: XYZProps;\n  /** See [[TextAnnotation.orientation]]. Default: no rotation. */\n  orientation?: YawPitchRollProps;\n  /** See [[TextAnnotation.textBlock]]. Default: an empty text block. */\n  textBlock?: TextBlockProps;\n  /** See [[TextAnnotation.anchor]]. Default: top-left. */\n  anchor?: TextAnnotationAnchor;\n  /** See [[TextAnnotation.leader]]. Default: an empty leader array  */\n  leaders?: TextAnnotationLeaderProps[];\n}\n\n/** Arguments supplied to [[TextAnnotation.create]].\n * @beta\n */\nexport interface TextAnnotationCreateArgs {\n  /** See [[TextAnnotation.offset]]. Default: (0, 0, 0). */\n  offset?: Point3d;\n  /** See [[TextAnnotation.orientation]]. Default: no rotation. */\n  orientation?: YawPitchRollAngles;\n  /** See [[TextAnnotation.textBlock]]. Default: an empty text block. */\n  textBlock?: TextBlock;\n  /** See [[TextAnnotation.anchor]]. Default: top-left. */\n  anchor?: TextAnnotationAnchor;\n  /** See [[TextAnnotation.leader]]. Default: an empty leader array  */\n  leaders?: TextAnnotationLeader[];\n}\n\n/**\n * Represents a formatted block of text positioned in 2d or 3d space.\n * [TextAnnotation2d]($backend) and [TextAnnotation3d]($backend) elements store a single TextAnnotation from which their geometric representation is generated.\n * Other types of elements may store multiple TextAnnotations, positioned relative to one another.\n * The annotation's position and orientation relative to the host element's [Placement]($common) is determined as follows:\n * - First, a bounding box is computed enclosing the contents of the [[textBlock].\n * - Then, an \"anchor point\" is computed based on the bounding box and the [[anchor]] property. The anchor point can be at one of the four corners of the box, in the middle of one of its four\n * edges, or in the center of the box.\n * - The [[orientation]] is applied to rotate the box around the anchor point.\n * - Finally, the [[offset]] is added to the anchor point to apply translation.\n * @see [appendTextAnnotationGeometry]($backend) to construct the geometry and append it to an [[ElementGeometry.Builder]].\n * @beta\n */\nexport class TextAnnotation {\n  /** The rotation of the annotation.\n   * @note When defining an annotation for a [TextAnnotation2d]($backend), only the `yaw` component (rotation around the Z axis) is used.\n   */\n  public orientation: YawPitchRollAngles;\n  /** The formatted document. */\n  public textBlock: TextBlock;\n  /** Describes how to compute the [[textBlock]]'s anchor point. */\n  public anchor: TextAnnotationAnchor;\n  /** An offset applied to the anchor point that can be used to position annotations within the same geometry stream relative to one another. */\n  public offset: Point3d;\n  /** The leaders of the text annotation. */\n  public leaders?: TextAnnotationLeader[];\n\n  private constructor(offset: Point3d, angles: YawPitchRollAngles, textBlock: TextBlock, anchor: TextAnnotationAnchor, leaders?: TextAnnotationLeader[]) {\n    this.offset = offset;\n    this.orientation = angles;\n    this.textBlock = textBlock;\n    this.anchor = anchor;\n    this.leaders = leaders;\n  }\n\n  /** Creates a new TextAnnotation. */\n  public static create(args?: TextAnnotationCreateArgs): TextAnnotation {\n    const offset = args?.offset ?? new Point3d();\n    const angles = args?.orientation ?? new YawPitchRollAngles();\n    const textBlock = args?.textBlock ?? TextBlock.create();\n    const anchor = args?.anchor ?? { vertical: \"top\", horizontal: \"left\" };\n    const leaders = args?.leaders ?? undefined;\n    return new TextAnnotation(offset, angles, textBlock, anchor, leaders);\n  }\n\n  /**\n   * Creates a new TextAnnotation instance from its JSON representation.\n   */\n  public static fromJSON(props?: TextAnnotationProps): TextAnnotation {\n    return TextAnnotation.create({\n      offset: props?.offset ? Point3d.fromJSON(props.offset) : undefined,\n      orientation: props?.orientation ? YawPitchRollAngles.fromJSON(props.orientation) : undefined,\n      textBlock: props?.textBlock ? TextBlock.create(props.textBlock) : undefined,\n      anchor: props?.anchor ? { ...props.anchor } : undefined,\n      leaders: props?.leaders ? props.leaders.map((leader) => ({\n        startPoint: Point3d.fromJSON(leader.startPoint),\n        attachment: leader.attachment,\n        styleOverrides: leader.styleOverrides ?? undefined,\n        intermediatePoints: leader.intermediatePoints ? leader.intermediatePoints.map((point) => Point3d.fromJSON(point)) : undefined,\n      })) : undefined,\n    });\n  }\n\n  /**\n   * Converts this annotation to its JSON representation.\n   */\n  public toJSON(): TextAnnotationProps {\n    const props: TextAnnotationProps = {};\n\n    // Even if the text block is empty, we want to record its style ID and overrides, e.g.,\n    // so the user can pick up where they left off editing it next time.\n    props.textBlock = this.textBlock.toJSON();\n\n    if (!this.offset.isZero) {\n      props.offset = this.offset.toJSON();\n    }\n\n    if (!this.orientation.isIdentity()) {\n      props.orientation = this.orientation.toJSON();\n    }\n\n    if (this.anchor.vertical !== \"top\" || this.anchor.horizontal !== \"left\") {\n      props.anchor = { ...this.anchor };\n    }\n\n    props.leaders = this.leaders?.map((leader) => ({\n      startPoint: leader.startPoint.toJSON(),\n      attachment: leader.attachment,\n      styleOverrides: leader.styleOverrides ?? undefined,\n      intermediatePoints: leader.intermediatePoints ? leader.intermediatePoints.map((point) => point.toJSON()) : undefined,\n    })) ?? undefined;\n\n    return props;\n  }\n\n  /** Compute the transform that positions and orients this annotation relative to its anchor point, based on the [[textBlock]]'s computed bounding box.\n   * The anchor point is computed as specified by this annotation's [[anchor]] setting. For example, if the text block is anchored\n   * at the bottom left, then the transform will be relative to the bottom-left corner of `textBlockExtents`.\n   * The text block will be rotated around the fixed anchor point according to [[orientation]], then translated by [[offset]].\n   * The anchor point will coincide with (0, 0, 0) unless an [[offset]] is present.\n   * If a scale factor is specified, the transform will also scale the annotation by that factor. Usually, this should come from the [[Drawing]] containing the annotation.\n   * @param boundingBox A box fully containing the [[textBlock]]. This range should include the margins.\n   * @param scaleFactor A factor by which to scale the annotation. Default: 1 (no scaling).\n   * @see [[computeAnchorPoint]] to compute the transform's anchor point.\n   * @see [computeLayoutTextBlockResult]($backend) to lay out a `TextBlock`.\n   */\n  public computeTransform(boundingBox: Range2d, scaleFactor: number = 1): Transform {\n    const anchorPt = this.computeAnchorPoint(boundingBox);\n    const matrix = this.orientation.toMatrix3d();\n\n    const transform = Transform.createIdentity();\n    const translation = Transform.createTranslation(this.offset.minus(anchorPt));\n    const scaleTransform = Transform.createScaleAboutPoint(anchorPt, scaleFactor);\n    const rotation = Transform.createFixedPointAndMatrix(anchorPt, matrix);\n    transform.multiplyTransformTransform(translation, transform);\n    transform.multiplyTransformTransform(scaleTransform, transform);\n    transform.multiplyTransformTransform(rotation, transform);\n    return transform;\n  }\n\n  /** Compute the anchor point of this annotation as specified by [[anchor]].\n   * @param boundingBox A box fully containing the [[textBlock]].\n   * @see [[computeTransform]] to compute the transform relative to the anchor point.\n   */\n  public computeAnchorPoint(boundingBox: Range2d): Point3d {\n    let x = boundingBox.low.x;\n    let y = boundingBox.high.y;\n\n    switch (this.anchor.horizontal) {\n      case \"center\":\n        x += boundingBox.xLength() / 2;\n        break;\n      case \"right\":\n        x += boundingBox.xLength();\n        break;\n    }\n\n    switch (this.anchor.vertical) {\n      case \"middle\":\n        y -= boundingBox.yLength() / 2;\n        break;\n      case \"bottom\":\n        y -= boundingBox.yLength();\n        break;\n    }\n\n    return new Point3d(x, y, 0);\n  }\n\n  /** Returns true if the leaders of this annotation are equal to the leaders of `other`. */\n  private areLeadersEqual(leadersA?: TextAnnotationLeader[], leadersB?: TextAnnotationLeader[]): boolean {\n    if (leadersA === leadersB) return true;\n    if (!leadersA || !leadersB || leadersA.length !== leadersB.length) return false;\n\n    for (let i = 0; i < leadersA.length; ++i) {\n      const a = leadersA[i];\n      const b = leadersB[i];\n\n      if (!a.startPoint.isAlmostEqual(b.startPoint)) return false;\n      if (JSON.stringify(a.attachment) !== JSON.stringify(b.attachment)) return false;\n      if (JSON.stringify(a.styleOverrides) !== JSON.stringify(b.styleOverrides)) return false;\n\n      const pointsA = a.intermediatePoints ?? [];\n      const pointsB = b.intermediatePoints ?? [];\n      if (pointsA.length !== pointsB.length) return false;\n      for (let j = 0; j < pointsA.length; ++j) {\n        if (!pointsA[j].isAlmostEqual(pointsB[j])) return false;\n      }\n    }\n    return true;\n  }\n\n  /** Returns true if this annotation is logically equivalent to `other`. */\n  public equals(other: TextAnnotation): boolean {\n    if (this.anchor.horizontal !== other.anchor.horizontal ||\n      this.anchor.vertical !== other.anchor.vertical ||\n      !this.orientation.isAlmostEqual(other.orientation) ||\n      !this.offset.isAlmostEqual(other.offset) ||\n      !this.textBlock.equals(other.textBlock))\n      return false;\n\n    return this.areLeadersEqual(this.leaders, other.leaders);\n\n  }\n}"]}
+{"version":3,"file":"TextAnnotation.js","sourceRoot":"","sources":["../../../src/annotation/TextAnnotation.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG;;;AAEH,wDAAoH;AACpH,2CAAwD;AA4HxD;;;;;;;;;;;;GAYG;AACH,MAAa,cAAc;IACzB;;OAEG;IACI,WAAW,CAAqB;IACvC,8BAA8B;IACvB,SAAS,CAAY;IAC5B,iEAAiE;IAC1D,MAAM,CAAuB;IACpC,8IAA8I;IACvI,MAAM,CAAU;IACvB,0CAA0C;IACnC,OAAO,CAA0B;IAExC,YAAoB,MAAe,EAAE,MAA0B,EAAE,SAAoB,EAAE,MAA4B,EAAE,OAAgC;QACnJ,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,oCAAoC;IAC7B,MAAM,CAAC,MAAM,CAAC,IAA+B;QAClD,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,IAAI,uBAAO,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,IAAI,EAAE,WAAW,IAAI,IAAI,kCAAkB,EAAE,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,EAAE,SAAS,IAAI,qBAAS,CAAC,MAAM,EAAE,CAAC;QACxD,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;QACvE,MAAM,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,SAAS,CAAC;QAC3C,OAAO,IAAI,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,CAAC;IACxE,CAAC;IAED;;OAEG;IACI,MAAM,CAAC,QAAQ,CAAC,KAA2B;QAChD,OAAO,cAAc,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,uBAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;YAClE,WAAW,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,kCAAkB,CAAC,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS;YAC5F,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,qBAAS,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS;YAC3E,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,SAAS;YACvD,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBACvD,UAAU,EAAE,uBAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC;gBAC/C,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,SAAS;gBAClD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;aAC9H,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACI,MAAM;QACX,MAAM,KAAK,GAAwB,EAAE,CAAC;QAEtC,uFAAuF;QACvF,oEAAoE;QACpE,KAAK,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;QAE1C,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;YACxB,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QACtC,CAAC;QAED,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,EAAE,CAAC;YACnC,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,CAAC;QAChD,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,MAAM,EAAE,CAAC;YACxE,KAAK,CAAC,MAAM,GAAG,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC;QACpC,CAAC;QAED,KAAK,CAAC,OAAO,GAAG,IAAI,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC7C,UAAU,EAAE,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE;YACtC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,cAAc,EAAE,MAAM,CAAC,cAAc,IAAI,SAAS;YAClD,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS;SACrH,CAAC,CAAC,IAAI,SAAS,CAAC;QAEjB,OAAO,KAAK,CAAC;IACf,CAAC;IAED;;;;;;;;;;OAUG;IACI,gBAAgB,CAAC,WAAoB,EAAE,cAAsB,CAAC;QACnE,MAAM,QAAQ,GAAG,IAAI,CAAC,kBAAkB,CAAC,WAAW,CAAC,CAAC;QACtD,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,UAAU,EAAE,CAAC;QAE7C,MAAM,SAAS,GAAG,yBAAS,CAAC,cAAc,EAAE,CAAC;QAC7C,MAAM,WAAW,GAAG,yBAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;QAC7E,MAAM,cAAc,GAAG,yBAAS,CAAC,qBAAqB,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;QAC9E,MAAM,QAAQ,GAAG,yBAAS,CAAC,yBAAyB,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;QACvE,SAAS,CAAC,0BAA0B,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;QAC7D,SAAS,CAAC,0BAA0B,CAAC,cAAc,EAAE,SAAS,CAAC,CAAC;QAChE,SAAS,CAAC,0BAA0B,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;QAC1D,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;;OAGG;IACI,kBAAkB,CAAC,WAAoB;QAC5C,IAAI,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC;QAE3B,QAAQ,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC/B,KAAK,QAAQ;gBACX,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,OAAO;gBACV,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM;QACV,CAAC;QAED,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;YAC7B,KAAK,QAAQ;gBACX,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;gBAC/B,MAAM;YACR,KAAK,QAAQ;gBACX,CAAC,IAAI,WAAW,CAAC,OAAO,EAAE,CAAC;gBAC3B,MAAM;QACV,CAAC;QAED,OAAO,IAAI,uBAAO,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,0FAA0F;IAClF,eAAe,CAAC,QAAiC,EAAE,QAAiC;QAC1F,IAAI,QAAQ,KAAK,QAAQ;YAAE,OAAO,IAAI,CAAC;QACvC,IAAI,CAAC,QAAQ,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM;YAAE,OAAO,KAAK,CAAC;QAEhF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;YACzC,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YACtB,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;YAEtB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CAAC,UAAU,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC5D,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;gBAAE,OAAO,KAAK,CAAC;YAChF,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC;gBAAE,OAAO,KAAK,CAAC;YAExF,MAAM,OAAO,GAAG,CAAC,CAAC,kBAAkB,IAAI,EAAE,CAAC;YAC3C,MAAM,OAAO,GAAG,CAAC,CAAC,kBAAkB,IAAI,EAAE,CAAC;YAC3C,IAAI,OAAO,CAAC,MAAM,KAAK,OAAO,CAAC,MAAM;gBAAE,OAAO,KAAK,CAAC;YACpD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;gBACxC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;oBAAE,OAAO,KAAK,CAAC;YAC1D,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,0EAA0E;IACnE,MAAM,CAAC,KAAqB;QACjC,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,KAAK,KAAK,CAAC,MAAM,CAAC,UAAU;YACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,KAAK,KAAK,CAAC,MAAM,CAAC,QAAQ;YAC9C,CAAC,IAAI,CAAC,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC;YAClD,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,MAAM,CAAC;YACxC,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;YACvC,OAAO,KAAK,CAAC;QAEf,OAAO,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;IAE3D,CAAC;CACF;AA3KD,wCA2KC","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 Annotation\r\n */\r\n\r\nimport { Point3d, Range2d, Transform, XYZProps, YawPitchRollAngles, YawPitchRollProps } from \"@itwin/core-geometry\";\r\nimport { TextBlock, TextBlockProps } from \"./TextBlock\";\r\nimport { TextStyleSettingsProps } from \"./TextStyle\";\r\n\r\n/** Describes how to compute the \"anchor point\" for a [[TextAnnotation]].\r\n * The anchor point is a point on or inside of the 2d bounding box enclosing the contents of the annotation's [[TextBlock]].\r\n * The annotation can be rotated and translated relative to the anchor point. The anchor point also serves as the snap point\r\n * when [AccuSnap]($frontend) is set to [SnapMode.Origin]($frontend).\r\n * [[TextAnnotation.computeTransform]] will align the anchor point with (0, 0).\r\n * @see [[TextAnnotation]] for a description of how the anchor point is computed.\r\n * @beta\r\n */\r\nexport interface TextAnnotationAnchor {\r\n  /**\r\n   * The vertical alignment of the anchor point.\r\n   * \"top\" aligns the anchor point with the top of the text's bounding box.\r\n   * \"middle\" aligns the anchor point with the middle of the text's bounding box.\r\n   * \"bottom\" aligns the anchor point with the bottom of the text's bounding box.\r\n   */\r\n  vertical: \"top\" | \"middle\" | \"bottom\";\r\n\r\n  /**\r\n   * The horizontal alignment of the anchor point.\r\n   * \"left\" aligns the anchor point with left side of the text's bounding box.\r\n   * \"center\" aligns the anchor point with center of the text with's bounding box.\r\n   * \"right\" aligns the anchor point with right side of the text's bounding box.\r\n   */\r\n  horizontal: \"left\" | \"center\" | \"right\";\r\n}\r\n\r\n/**\r\n * Describes how to attach a [[TextAnnotationLeader]] to the frame around a [[TextBlock]].\r\n * Leader can be attached using one of the three modes:\r\n * - KeyPoint: attach to a point on the frame specified by the given curveIndex and fractional position.\r\n * - TextPoint: attach to a point that is projected on to the frame from the point on a particular line of text specified by [[LeaderTextPointOptions]].\r\n * - Nearest: attach to the point on frame that is nearest to [[TextAnnotationLeader.startPoint]].\r\n * @beta\r\n */\r\nexport type LeaderAttachment =\r\n  | { mode: \"KeyPoint\"; curveIndex: number; fraction: number }\r\n  | { mode: \"TextPoint\"; position: LeaderTextPointOptions }\r\n  | { mode: \"Nearest\" };\r\n\r\n/**\r\n * Specifies the possible positions to attach a leader on the frame around a [[TextBlock]]\r\n * when [[TextAnnotationLeader.attachment.mode]] is set to TextPoint.\r\n * TopLeft : attach to a point projected onto the frame from the point on the left side of the first line of text.\r\n * TopRight : attach to a point projected onto the frame from the point on the right side of the first line of text.\r\n * BottomLeft : attach to a point projected onto the frame from the point on the left side of the last line of text.\r\n * BottomRight : attach to a point projected onto the frame from the point on the right side of the last line of text.\r\n * @beta\r\n */\r\nexport type LeaderTextPointOptions = \"TopLeft\" | \"TopRight\" | \"BottomLeft\" | \"BottomRight\"\r\n\r\n/**\r\n * A line that connects a [[TextAnnotation]] to a point in space relative to another element in the iModel.\r\n * A leader is always attached to the frame around the annotation's [[TextBlock]].\r\n * If the frame is not visible, the leader attaches to an invisible rectangular frame around the text block.\r\n * @see [[TextAnnotation.leaders]] for the leaders associated with an annotation.\r\n * @see [[TextStyleSettings.leader]] and [[styleOverrides]] to customize the appearance of leaders.\r\n * @beta\r\n*/\r\nexport interface TextAnnotationLeader {\r\n  /** The point where the leader starts.\r\n   * This is the point on another element where the leader points to */\r\n  startPoint: Point3d;\r\n  /** Describes how to attach the leader to the frame around [[textBlock]].*/\r\n  attachment: LeaderAttachment;\r\n  /** Optional intermediate points that the leader should pass through.\r\n   * If not specified, the leader will be a straight line from startPoint to the point on the frame.\r\n   * For now, intermediate points are a set of points which create additional LineSegments in the leader, but there could be intermediate shapes instead of straight LineSegments in future*/\r\n  intermediatePoints?: Point3d[];\r\n  /** Optional style overrides for the leader. If not specified, the leader will use the style defined by [[TextBlock.styleName]] as it is.\r\n   * If specified, these overrides will be applied to the style.\r\n   */\r\n  styleOverrides?: TextStyleSettingsProps;\r\n}\r\n/**\r\n * JSON representation of a [[TextAnnotationLeader]].\r\n * @beta\r\n */\r\nexport interface TextAnnotationLeaderProps {\r\n  /** See [[TextAnnotationLeader.startPoint]]. */\r\n  startPoint: XYZProps;\r\n  /** See [[TextAnnotationLeader.attachment]]. */\r\n  attachment: LeaderAttachment;\r\n  /** See [[TextAnnotationLeader.intermediatePoints]]. Default: no intermediate points. */\r\n  intermediatePoints?: XYZProps[];\r\n  /** See [[TextAnnotationLeader.styleOverrides]]. Default: no style overrides. */\r\n  styleOverrides?: TextStyleSettingsProps;\r\n}\r\n\r\n/**\r\n * JSON representation of a [[TextAnnotation]].\r\n * @beta\r\n */\r\nexport interface TextAnnotationProps {\r\n  /** See [[TextAnnotation.offset]]. Default: [0, 0, 0]. */\r\n  offset?: XYZProps;\r\n  /** See [[TextAnnotation.orientation]]. Default: no rotation. */\r\n  orientation?: YawPitchRollProps;\r\n  /** See [[TextAnnotation.textBlock]]. Default: an empty text block. */\r\n  textBlock?: TextBlockProps;\r\n  /** See [[TextAnnotation.anchor]]. Default: top-left. */\r\n  anchor?: TextAnnotationAnchor;\r\n  /** See [[TextAnnotation.leader]]. Default: an empty leader array  */\r\n  leaders?: TextAnnotationLeaderProps[];\r\n}\r\n\r\n/** Arguments supplied to [[TextAnnotation.create]].\r\n * @beta\r\n */\r\nexport interface TextAnnotationCreateArgs {\r\n  /** See [[TextAnnotation.offset]]. Default: (0, 0, 0). */\r\n  offset?: Point3d;\r\n  /** See [[TextAnnotation.orientation]]. Default: no rotation. */\r\n  orientation?: YawPitchRollAngles;\r\n  /** See [[TextAnnotation.textBlock]]. Default: an empty text block. */\r\n  textBlock?: TextBlock;\r\n  /** See [[TextAnnotation.anchor]]. Default: top-left. */\r\n  anchor?: TextAnnotationAnchor;\r\n  /** See [[TextAnnotation.leader]]. Default: an empty leader array  */\r\n  leaders?: TextAnnotationLeader[];\r\n}\r\n\r\n/**\r\n * Represents a formatted block of text positioned in 2d or 3d space.\r\n * [TextAnnotation2d]($backend) and [TextAnnotation3d]($backend) elements store a single TextAnnotation from which their geometric representation is generated.\r\n * Other types of elements may store multiple TextAnnotations, positioned relative to one another.\r\n * The annotation's position and orientation relative to the host element's [Placement]($common) is determined as follows:\r\n * - First, a bounding box is computed enclosing the contents of the [[textBlock].\r\n * - Then, an \"anchor point\" is computed based on the bounding box and the [[anchor]] property. The anchor point can be at one of the four corners of the box, in the middle of one of its four\r\n * edges, or in the center of the box.\r\n * - The [[orientation]] is applied to rotate the box around the anchor point.\r\n * - Finally, the [[offset]] is added to the anchor point to apply translation.\r\n * @see [appendTextAnnotationGeometry]($backend) to construct the geometry and append it to an [[ElementGeometry.Builder]].\r\n * @beta\r\n */\r\nexport class TextAnnotation {\r\n  /** The rotation of the annotation.\r\n   * @note When defining an annotation for a [TextAnnotation2d]($backend), only the `yaw` component (rotation around the Z axis) is used.\r\n   */\r\n  public orientation: YawPitchRollAngles;\r\n  /** The formatted document. */\r\n  public textBlock: TextBlock;\r\n  /** Describes how to compute the [[textBlock]]'s anchor point. */\r\n  public anchor: TextAnnotationAnchor;\r\n  /** An offset applied to the anchor point that can be used to position annotations within the same geometry stream relative to one another. */\r\n  public offset: Point3d;\r\n  /** The leaders of the text annotation. */\r\n  public leaders?: TextAnnotationLeader[];\r\n\r\n  private constructor(offset: Point3d, angles: YawPitchRollAngles, textBlock: TextBlock, anchor: TextAnnotationAnchor, leaders?: TextAnnotationLeader[]) {\r\n    this.offset = offset;\r\n    this.orientation = angles;\r\n    this.textBlock = textBlock;\r\n    this.anchor = anchor;\r\n    this.leaders = leaders;\r\n  }\r\n\r\n  /** Creates a new TextAnnotation. */\r\n  public static create(args?: TextAnnotationCreateArgs): TextAnnotation {\r\n    const offset = args?.offset ?? new Point3d();\r\n    const angles = args?.orientation ?? new YawPitchRollAngles();\r\n    const textBlock = args?.textBlock ?? TextBlock.create();\r\n    const anchor = args?.anchor ?? { vertical: \"top\", horizontal: \"left\" };\r\n    const leaders = args?.leaders ?? undefined;\r\n    return new TextAnnotation(offset, angles, textBlock, anchor, leaders);\r\n  }\r\n\r\n  /**\r\n   * Creates a new TextAnnotation instance from its JSON representation.\r\n   */\r\n  public static fromJSON(props?: TextAnnotationProps): TextAnnotation {\r\n    return TextAnnotation.create({\r\n      offset: props?.offset ? Point3d.fromJSON(props.offset) : undefined,\r\n      orientation: props?.orientation ? YawPitchRollAngles.fromJSON(props.orientation) : undefined,\r\n      textBlock: props?.textBlock ? TextBlock.create(props.textBlock) : undefined,\r\n      anchor: props?.anchor ? { ...props.anchor } : undefined,\r\n      leaders: props?.leaders ? props.leaders.map((leader) => ({\r\n        startPoint: Point3d.fromJSON(leader.startPoint),\r\n        attachment: leader.attachment,\r\n        styleOverrides: leader.styleOverrides ?? undefined,\r\n        intermediatePoints: leader.intermediatePoints ? leader.intermediatePoints.map((point) => Point3d.fromJSON(point)) : undefined,\r\n      })) : undefined,\r\n    });\r\n  }\r\n\r\n  /**\r\n   * Converts this annotation to its JSON representation.\r\n   */\r\n  public toJSON(): TextAnnotationProps {\r\n    const props: TextAnnotationProps = {};\r\n\r\n    // Even if the text block is empty, we want to record its style ID and overrides, e.g.,\r\n    // so the user can pick up where they left off editing it next time.\r\n    props.textBlock = this.textBlock.toJSON();\r\n\r\n    if (!this.offset.isZero) {\r\n      props.offset = this.offset.toJSON();\r\n    }\r\n\r\n    if (!this.orientation.isIdentity()) {\r\n      props.orientation = this.orientation.toJSON();\r\n    }\r\n\r\n    if (this.anchor.vertical !== \"top\" || this.anchor.horizontal !== \"left\") {\r\n      props.anchor = { ...this.anchor };\r\n    }\r\n\r\n    props.leaders = this.leaders?.map((leader) => ({\r\n      startPoint: leader.startPoint.toJSON(),\r\n      attachment: leader.attachment,\r\n      styleOverrides: leader.styleOverrides ?? undefined,\r\n      intermediatePoints: leader.intermediatePoints ? leader.intermediatePoints.map((point) => point.toJSON()) : undefined,\r\n    })) ?? undefined;\r\n\r\n    return props;\r\n  }\r\n\r\n  /** Compute the transform that positions and orients this annotation relative to its anchor point, based on the [[textBlock]]'s computed bounding box.\r\n   * The anchor point is computed as specified by this annotation's [[anchor]] setting. For example, if the text block is anchored\r\n   * at the bottom left, then the transform will be relative to the bottom-left corner of `textBlockExtents`.\r\n   * The text block will be rotated around the fixed anchor point according to [[orientation]], then translated by [[offset]].\r\n   * The anchor point will coincide with (0, 0, 0) unless an [[offset]] is present.\r\n   * If a scale factor is specified, the transform will also scale the annotation by that factor. Usually, this should come from the [[Drawing]] containing the annotation.\r\n   * @param boundingBox A box fully containing the [[textBlock]]. This range should include the margins.\r\n   * @param scaleFactor A factor by which to scale the annotation. Default: 1 (no scaling).\r\n   * @see [[computeAnchorPoint]] to compute the transform's anchor point.\r\n   * @see [computeLayoutTextBlockResult]($backend) to lay out a `TextBlock`.\r\n   */\r\n  public computeTransform(boundingBox: Range2d, scaleFactor: number = 1): Transform {\r\n    const anchorPt = this.computeAnchorPoint(boundingBox);\r\n    const matrix = this.orientation.toMatrix3d();\r\n\r\n    const transform = Transform.createIdentity();\r\n    const translation = Transform.createTranslation(this.offset.minus(anchorPt));\r\n    const scaleTransform = Transform.createScaleAboutPoint(anchorPt, scaleFactor);\r\n    const rotation = Transform.createFixedPointAndMatrix(anchorPt, matrix);\r\n    transform.multiplyTransformTransform(translation, transform);\r\n    transform.multiplyTransformTransform(scaleTransform, transform);\r\n    transform.multiplyTransformTransform(rotation, transform);\r\n    return transform;\r\n  }\r\n\r\n  /** Compute the anchor point of this annotation as specified by [[anchor]].\r\n   * @param boundingBox A box fully containing the [[textBlock]].\r\n   * @see [[computeTransform]] to compute the transform relative to the anchor point.\r\n   */\r\n  public computeAnchorPoint(boundingBox: Range2d): Point3d {\r\n    let x = boundingBox.low.x;\r\n    let y = boundingBox.high.y;\r\n\r\n    switch (this.anchor.horizontal) {\r\n      case \"center\":\r\n        x += boundingBox.xLength() / 2;\r\n        break;\r\n      case \"right\":\r\n        x += boundingBox.xLength();\r\n        break;\r\n    }\r\n\r\n    switch (this.anchor.vertical) {\r\n      case \"middle\":\r\n        y -= boundingBox.yLength() / 2;\r\n        break;\r\n      case \"bottom\":\r\n        y -= boundingBox.yLength();\r\n        break;\r\n    }\r\n\r\n    return new Point3d(x, y, 0);\r\n  }\r\n\r\n  /** Returns true if the leaders of this annotation are equal to the leaders of `other`. */\r\n  private areLeadersEqual(leadersA?: TextAnnotationLeader[], leadersB?: TextAnnotationLeader[]): boolean {\r\n    if (leadersA === leadersB) return true;\r\n    if (!leadersA || !leadersB || leadersA.length !== leadersB.length) return false;\r\n\r\n    for (let i = 0; i < leadersA.length; ++i) {\r\n      const a = leadersA[i];\r\n      const b = leadersB[i];\r\n\r\n      if (!a.startPoint.isAlmostEqual(b.startPoint)) return false;\r\n      if (JSON.stringify(a.attachment) !== JSON.stringify(b.attachment)) return false;\r\n      if (JSON.stringify(a.styleOverrides) !== JSON.stringify(b.styleOverrides)) return false;\r\n\r\n      const pointsA = a.intermediatePoints ?? [];\r\n      const pointsB = b.intermediatePoints ?? [];\r\n      if (pointsA.length !== pointsB.length) return false;\r\n      for (let j = 0; j < pointsA.length; ++j) {\r\n        if (!pointsA[j].isAlmostEqual(pointsB[j])) return false;\r\n      }\r\n    }\r\n    return true;\r\n  }\r\n\r\n  /** Returns true if this annotation is logically equivalent to `other`. */\r\n  public equals(other: TextAnnotation): boolean {\r\n    if (this.anchor.horizontal !== other.anchor.horizontal ||\r\n      this.anchor.vertical !== other.anchor.vertical ||\r\n      !this.orientation.isAlmostEqual(other.orientation) ||\r\n      !this.offset.isAlmostEqual(other.offset) ||\r\n      !this.textBlock.equals(other.textBlock))\r\n      return false;\r\n\r\n    return this.areLeadersEqual(this.leaders, other.leaders);\r\n\r\n  }\r\n}"]}

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 { ListMarker, ListMarkerEnumerator, TextStyleSettings, TextStyleSettingsProps } from \"./TextStyle\";\nimport { FieldFormatOptions, FieldPropertyHost, FieldPropertyPath } from \"./TextField\";\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  /** A string to insert in between the list marker and the list item.\n   * Default: \" \" - a single space.\n   */\n  listMarkerBreak?: string;\n}\n\n/**\n * Context information that may be useful when converting a [[TextBlock]] to a string.\n * @beta\n */\nexport interface TextBlockStringifyContext {\n  /** The current depth of the text block in the document structure. */\n  depth: number;\n}\n\nfunction clearStyleOverrides(component: StructuralTextBlockComponent, options?: ClearTextStyleOptions): void {\n  component.styleOverrides = {};\n  if (!options?.preserveChildrenOverrides) {\n    for (const child of component.children) {\n      child.clearStyleOverrides(options);\n    }\n  }\n}\n\n/**\n * Abstract representation of any of the building blocks that make up a [[TextBlock]] document - namely [[Run]]s and [[StructuralTextBlockComponent]]s.\n * The [[TextBlock]] can specify an [AnnotationTextStyle]($backend) that formats its contents.\n * 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 = structuredClone(props?.styleOverrides ?? {});\n  }\n\n  /** Deviations in individual properties of the [[TextStyleSettings]] in the [AnnotationTextStyle]($backend).\n   * For example, if the style uses the \"Arial\" font, you can override that by settings `styleOverrides.font.name` 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 = structuredClone(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, context?: TextBlockStringifyContext): string;\n\n  /** Returns true if this component has no content or children. */\n  public abstract get isEmpty(): boolean;\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: structuredClone(this.styleOverrides),\n    };\n  }\n\n  /** Returns true if `this` is equivalent to `other`. */\n  public equals(other: TextBlockComponent): boolean {\n    const mySettings = TextStyleSettings.fromJSON(this.styleOverrides);\n    const otherSettings = TextStyleSettings.fromJSON(other.styleOverrides);\n    return mySettings.equals(otherSettings);\n  }\n}\n\n/** [[TextBlockComponent]]s contained within a [[Paragraph]].\n * @beta\n */\nexport type Run = TextRun | FractionRun | TabRun | LineBreakRun | FieldRun;\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 | FieldRunProps;\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]], [[FieldRun.create]], [[TabRun.create]], and [[LineBreakRun.create]] to create a run directly.\n   */\n  export function fromJSON(props: RunProps): Run {\n    switch (props.type) {\n      case \"field\": return FieldRun.create(props);\n      case \"fraction\": return FractionRun.create(props);\n      case \"linebreak\": return LineBreakRun.create(props);\n      case \"tab\": return TabRun.create(props);\n      case \"text\": return TextRun.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: TextRunProps) {\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, type: \"text\" });\n  }\n\n  public override get isEmpty(): boolean {\n    return this.stringify().length === 0;\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: FractionRunProps) {\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, type: \"fraction\" });\n  }\n\n  public override get isEmpty(): boolean {\n    return this.stringify().length === 0;\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: LineBreakRunProps) {\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?: Omit<LineBreakRunProps, \"type\">) {\n    return new LineBreakRun({ ...props, type: \"linebreak\" });\n  }\n\n  public override clone(): LineBreakRun {\n    return new LineBreakRun(this.toJSON());\n  }\n\n  public override get isEmpty(): boolean {\n    return this.stringify().length === 0;\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  public override get isEmpty(): boolean {\n    return this.stringify().length === 0;\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 [[FieldRun]].\n * @beta\n */\nexport interface FieldRunProps extends TextBlockComponentProps {\n  /** Discriminator field for the [[RunProps]] union. */\n  readonly type: \"field\";\n  /** The element and BIS class containing the property described by [[propertyPath]]. */\n  propertyHost: FieldPropertyHost;\n  /** Describes how to obtain the property value from [[propertyHost]]. */\n  propertyPath: FieldPropertyPath;\n  /** Specifies how to format the property value obtained from [[propertyPath]] into a string to be stored in [[cachedContent]].\n   * The specific options used depend upon the field's [[propertyType]].\n   */\n  formatOptions?: FieldFormatOptions;\n  /** The field's most recently evaluated display string.\n   * @note It is unnecessary to specify this when creating a field as part of an element like a [[TextAnnotation2d]], because\n   * all of the element's fields will be re-evaluated when inserting or updating the element in the iModel.\n   */\n  cachedContent?: string;\n}\n\n/** A [[Run]] that displays the formatted value of a property of some [Element]($backend).\n * When a [[TextBlock]] containing a [[FieldRun]] is written into the iModel as an [ITextAnnotation]($backend) element,\n * a dependency is established between the two elements via the [ElementDrivesTextAnnotation]($backend) relationship such that\n * whenever the source element specified by [[propertyHost]] is modified or the `ITextAnnotation` element is inserted or updated in the iModel,\n * the field(s) in the `ITextAnnotation` element are automatically\n * recalculated, causing their [[cachedContent]] to update. If the field's display string cannot be evaluated (for example, because the specified element or\n * property does not exist), then its cached content is set to [[FieldRun.invalidContentIndicator]].\n * A [[FieldRun]] displays its [[cachedContent]] in the same way that [[TextRun]]s display their `content`, including word wrapping where appropriate.\n * @beta\n */\nexport class FieldRun extends TextBlockComponent {\n  /** Display string used to signal an error in computing the field's value. */\n  public static invalidContentIndicator = \"####\";\n\n  /** Discriminator field for the [[Run]] union. */\n  public readonly type = \"field\";\n  /** The element and BIS class containing the property described by [[propertyPath]]. */\n  public propertyHost: FieldPropertyHost;\n  /** Describes how to obtain the property value from [[propertyHost]]. */\n  public propertyPath: FieldPropertyPath;\n  /** Specifies how to format the property value obtained from [[propertyPath]] into a string to be stored in [[cachedContent]].\n   * The specific options used depend upon the [[FieldPropertyType]].\n   */\n  public formatOptions?: FieldFormatOptions;\n  private _cachedContent: string;\n\n  /** The field's most recently evaluated display string. */\n  public get cachedContent(): string {\n    return this._cachedContent;\n  }\n\n  /** @internal Used by core-backend when re-evaluating field content. */\n  public setCachedContent(content: string | undefined): void {\n    this._cachedContent = content ?? FieldRun.invalidContentIndicator;\n  }\n\n  private constructor(props: FieldRunProps) {\n    super(props);\n\n    this._cachedContent = props.cachedContent ?? FieldRun.invalidContentIndicator;\n    this.propertyHost = props.propertyHost\n    this.propertyPath = props.propertyPath;\n    this.formatOptions = props.formatOptions;\n  }\n\n  /** Create a FieldRun from its JSON representation. */\n  public static create(props: Omit<FieldRunProps, \"type\">): FieldRun {\n    return new FieldRun({\n      ...props,\n      propertyHost: { ...props.propertyHost },\n      propertyPath: structuredClone(props.propertyPath),\n      formatOptions: structuredClone(props.formatOptions),\n      type: \"field\",\n    });\n  }\n\n  /** Convert the FieldRun to its JSON representation. */\n  public override toJSON(): FieldRunProps {\n    const json: FieldRunProps = {\n      ...super.toJSON(),\n      type: \"field\",\n      propertyHost: { ...this.propertyHost },\n      propertyPath: structuredClone(this.propertyPath),\n    };\n\n    if (this.cachedContent !== FieldRun.invalidContentIndicator) {\n      json.cachedContent = this.cachedContent;\n    }\n\n    if (this.formatOptions) {\n      json.formatOptions = structuredClone(this.formatOptions);\n    }\n\n    return json;\n  }\n\n  /** Create a deep copy of this FieldRun. */\n  public override clone(): FieldRun {\n    return new FieldRun(this.toJSON());\n  }\n\n  public override get isEmpty(): boolean {\n    return this.stringify().length === 0;\n  }\n\n  /** Convert this FieldRun to a simple string representation. */\n  public override stringify(): string {\n    return this.cachedContent;\n  }\n\n  /** Returns true if `this` is equivalent to `other`. */\n  public override equals(other: TextBlockComponent): boolean {\n    if (!(other instanceof FieldRun) || !super.equals(other)) {\n      return false;\n    }\n\n    if (\n      this.propertyHost.elementId !== other.propertyHost.elementId ||\n      this.propertyHost.className !== other.propertyHost.className ||\n      this.propertyHost.schemaName !== other.propertyHost.schemaName\n    ) {\n      return false;\n    }\n\n    if (this.propertyPath.propertyName !== other.propertyPath.propertyName) {\n      return false;\n    }\n\n    const thisAccessors = this.propertyPath.accessors ?? [];\n    const otherAccessors = other.propertyPath.accessors ?? [];\n\n    if (thisAccessors.length !== otherAccessors.length) {\n      return false;\n    }\n\n    if (!thisAccessors.every((value, index) => value === otherAccessors[index])) {\n      return false;\n    }\n\n    if (this.formatOptions && other.formatOptions) {\n      // We anticipate new formatting options being added in the future.\n      // So to account for properties we don't know about, just compare the string representations.\n      if (JSON.stringify(this.formatOptions) !== JSON.stringify(other.formatOptions)) {\n        return false;\n      }\n    } else if (this.formatOptions || other.formatOptions) {\n      return false;\n    }\n\n    return true;\n  }\n}\n\n/** JSON representation of a [[Paragraph]].\n * @beta\n */\nexport interface ParagraphProps extends TextBlockComponentProps {\n  children?: Array<ListProps | RunProps>;\n}\n\n/** A collection of [[Run]]s and [[List]]s. Paragraphs can be appended to [[List]]s and [[TextBlock]]s.\n * Each paragraph is laid out on a separate line. If included in a [[List]], the paragraph will be treated as a list item.\n * @beta\n */\nexport class Paragraph extends TextBlockComponent {\n  public readonly type = \"paragraph\";\n  public readonly children: Array<List | Run>;\n\n  private constructor(props?: ParagraphProps) {\n    super(props);\n\n    this.children = props?.children?.map((child) =>\n      child.type === \"list\" ? List.create(child) : Run.fromJSON(child)\n    ) ?? [];\n  }\n\n  /** Create a paragraph from its JSON representation. */\n  public static create(props?: Omit<ParagraphProps, \"type\">): Paragraph {\n    return new Paragraph(props);\n  }\n\n  public override clearStyleOverrides(options?: ClearTextStyleOptions): void {\n    clearStyleOverrides(this, options);\n  }\n\n  public override get isEmpty() {\n    return this.children.length === 0;\n  }\n\n  public override clone(): Paragraph {\n    return new Paragraph(this.toJSON());\n  }\n\n  public override toJSON(): ParagraphProps {\n    return {\n      ...super.toJSON(),\n      children: this.children.map((child) => child.toJSON()),\n    };\n  }\n\n  /** Compute a string representation of this paragraph by concatenating the string representations of all of its children. */\n  public override stringify(options?: TextBlockStringifyOptions, context?: TextBlockStringifyContext): string {\n    return this.children.map((x, index) => (index > 0 && x.type === \"list\") ? `${options?.paragraphBreak ?? \" \"}${x.stringify(options, context)}` : x.stringify(options, context)).join(\"\") ?? \"\";\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return (other instanceof Paragraph) && super.equals(other);\n  }\n}\n\n/** JSON representation of a [[List]].\n * @beta\n */\nexport interface ListProps extends TextBlockComponentProps {\n  readonly type: \"list\";\n  children?: ParagraphProps[];\n}\n\n/** A collection of list items ([[Paragraph]]s). Lists can be appended to [[Paragraph]]s.\n * Lists will be laid out on a new line. Each item in a list is laid out on a separate line.\n * @beta\n */\nexport class List extends TextBlockComponent {\n  public readonly type = \"list\";\n  public readonly children: Paragraph[];\n\n  protected constructor(props?: ListProps) {\n    super(props);\n\n    this.children = props?.children?.map((child) => Paragraph.create(child)) ?? [];\n  }\n\n  /** Create a list from its JSON representation. */\n  public static create(props?: Omit<ListProps, \"type\">): List {\n    return new List({ ...props, type: \"list\" });\n  }\n\n  public override clearStyleOverrides(options?: ClearTextStyleOptions): void {\n    clearStyleOverrides(this, options);\n  }\n\n  public override get isEmpty() {\n    return this.children.length === 0;\n  }\n\n  public override clone(): List {\n    return new List(this.toJSON());\n  }\n\n  public override toJSON(): ListProps {\n    return {\n      ...super.toJSON(),\n      type: \"list\",\n      children: this.children.map((run) => run.toJSON()),\n    };\n  }\n\n  /** Compute a string representation of this list by concatenating the string representations of all of its [[children]]. */\n  public override stringify(options?: TextBlockStringifyOptions, context?: TextBlockStringifyContext): string {\n    const children = this.children.map((x, index) => {\n      const depth = context?.depth ?? 0;\n      const marker = getMarkerText(this.styleOverrides.listMarker ?? TextStyleSettings.defaultProps.listMarker, index + 1);\n      const tab = (options?.tabsAsSpaces ? \" \".repeat(options.tabsAsSpaces) : \"\\t\").repeat(depth);\n      return `${tab}${marker}${options?.listMarkerBreak ?? \" \"}${x.stringify(options, { depth: depth + 1 })}`;\n    });\n    return children.join(options?.paragraphBreak ?? \" \") ?? \"\";\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    return (other instanceof List) && super.equals(other);\n  }\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  children?: 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.\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  public readonly children: Paragraph[];\n\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\n  private constructor(props: TextBlockProps) {\n    super(props);\n    this.width = props.width ?? 0;\n\n    this.children = props?.children?.map((para) => Paragraph.create(para)) ?? [];\n  }\n\n  public override clearStyleOverrides(options?: ClearTextStyleOptions): void {\n    clearStyleOverrides(this, options);\n  }\n\n  public override toJSON(): TextBlockProps {\n    return {\n      ...super.toJSON(),\n      width: this.width,\n      children: this.children.map((x) => x.toJSON()),\n    };\n  }\n\n  /** Create a text block from its JSON representation. */\n  public static create(props?: Omit<TextBlockProps, \"type\">): TextBlock {\n    return new TextBlock(props ?? {});\n  }\n\n  /** Returns true if every paragraph in this text block is empty. */\n  public override get isEmpty(): boolean {\n    return !this.children || this.children.every((child) => child.isEmpty);\n  }\n\n  public override clone(): TextBlock {\n    return new TextBlock(this.toJSON());\n  }\n\n  /** Compute a string representation of the document's contents by concatenating the string representations of each of its [[children]], separated by [[TextBlockStringifyOptions.paragraphBreak]]. */\n  public stringify(options?: TextBlockStringifyOptions): string {\n    return this.children.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 [[children]] is not empty, the new paragraph will inherit the style overrides of the last child in this block.\n   * @note Be sure you pass in [[ParagraphProps]] and not [[Paragraph]] or style overrides will be ignored.\n   */\n  public appendParagraph(props?: ParagraphProps, seedFromLast = false): Paragraph {\n    const seed = seedFromLast ? this.children[this.children.length - 1] : undefined;\n    const styleOverrides = { ...seed?.styleOverrides, ...props?.styleOverrides };\n    const paragraph = Paragraph.create({ ...props, styleOverrides });\n    this.children.push(paragraph);\n    return paragraph;\n  }\n\n  /** Append a run to the last [[Paragraph]] in this block.\n   * If the block contains no [[children]], a new [[Paragraph]] will first be created using [[appendParagraph]].\n   */\n  public appendRun(run: Run): void {\n    const paragraph = this.children[this.children.length - 1] ?? this.appendParagraph();\n    paragraph.children.push(run);\n  }\n\n  public override equals(other: TextBlockComponent): boolean {\n    if (!(other instanceof TextBlock)) {\n      return false;\n    }\n\n    if (!super.equals(other)) {\n      return false;\n    }\n\n    if (this.width !== other.width) {\n      return false;\n    }\n\n    if (this.children && other.children) {\n      if (this.children.length !== other.children.length) {\n        return false;\n      }\n\n      return this.children.every((child, index) => other.children && child.equals(other.children[index]));\n    }\n\n    return true;\n  }\n}\n\n/**\n * A union of all the [[TextBlockComponent]]s that can contain other components.\n * @beta\n */\nexport type StructuralTextBlockComponent = List | Paragraph | TextBlock;\n\n/**\n * Recursively traverses a [[StructuralTextBlockComponent]] tree, yielding each child component along with its parent container.\n * This generator enables depth-first iteration over all components in a text block structure, including paragraphs, lists, and runs.\n *\n * @param parent The root container whose children should be traversed.\n * @returns An IterableIterator yielding objects with the child component and its parent container.\n * @beta\n */\nexport function* traverseTextBlockComponent(parent: StructuralTextBlockComponent): IterableIterator<{ parent: StructuralTextBlockComponent, child: List | Paragraph | Run }> {\n  for (const child of parent.children) {\n    yield { parent, child };\n    if (child.type === \"list\" || child.type === \"paragraph\") {\n      yield* traverseTextBlockComponent(child);\n    }\n  }\n}\n\n/**\n * Returns the formatted marker text for a list item based on the marker type and item number.\n * Supports ordered and unordered list markers, including alphabetic, Roman numeral, and numeric formats.\n * @param marker The type of list marker to use.\n * @param num The item number in the list.\n * @returns The formatted marker string for the list item.\n * @beta\n */\nexport function getMarkerText(marker: ListMarker, num: number): string {\n  let markerString = \"\";\n\n  switch (marker.enumerator) {\n    case undefined:\n    case ListMarkerEnumerator.Number:\n      markerString = `${num}`;\n      break;\n    case ListMarkerEnumerator.Letter:\n      markerString = integerToAlpha(num);\n      break;\n    case ListMarkerEnumerator.RomanNumeral:\n      markerString = integerToRoman(num);\n      break;\n    default:\n      markerString = marker.enumerator;\n      break;\n  }\n\n  if (marker.case) {\n    markerString = marker.case === \"upper\" ? markerString.toUpperCase() : markerString.toLowerCase();\n  }\n\n  const terminator = marker.terminator === \"period\" ? \".\" : marker.terminator === \"parenthesis\" ? \")\" : \"\";\n\n  return `${markerString}${terminator}`;\n}\n\n/**\n * Converts an integer to its Roman numeral representation.\n * Supports numbers from 1 and above.\n * @param num The integer to convert.\n * @returns The Roman numeral string.\n */\nfunction integerToRoman(num: number): string {\n  const values =\n    [1000, 900, 500, 400, 100, 90, 50, 40, 10, 9, 5, 4, 1];\n  const symbols =\n    ['M', 'CM', 'D', 'CD', 'C', 'XC', 'L', 'XL', 'X', 'IX', 'V', 'IV', 'I'];\n  let roman = '';\n  for (let i = 0; i < values.length; i++) {\n    while (num >= values[i]) {\n      roman += symbols[i];\n      num -= values[i];\n    }\n  }\n\n  return roman;\n}\n\n/**\n * Converts an integer to its alphabetic representation (A-Z, AA-ZZ, etc.).\n * Used for ordered list markers with alphabetic styles.\n * @param num The integer to convert (1-based).\n * @returns The alphabetic string for the given number.\n */\nfunction integerToAlpha(num: number): string {\n  const letterOffset = (num - 1) % 26;\n  const letter = String.fromCharCode(65 + letterOffset);\n  const depth = Math.ceil(num / 26);\n  return letter.repeat(depth);\n}\n"]}
+{"version":3,"file":"TextBlock.js","sourceRoot":"","sources":["../../../src/annotation/TextBlock.ts"],"names":[],"mappings":"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","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 Annotation\r\n */\r\n\r\nimport { ListMarker, ListMarkerEnumerator, TextStyleSettings, TextStyleSettingsProps } from \"./TextStyle\";\r\nimport { FieldFormatOptions, FieldPropertyHost, FieldPropertyPath } from \"./TextField\";\r\n\r\n/** Options supplied to [[TextBlockComponent.clearStyleOverrides]] to control how the style overrides are cleared on the component and its child components.\r\n * @beta\r\n */\r\nexport interface ClearTextStyleOptions {\r\n  /** Controls whether the styleOverrides of any child components are retained.\r\n   * By default, all overrides are cleared.\r\n   */\r\n  preserveChildrenOverrides?: boolean;\r\n}\r\n\r\n/** The JSON representation of a [[TextBlockComponent]].\r\n * @beta\r\n */\r\nexport interface TextBlockComponentProps {\r\n  /** Deviations from the base [[TextStyleSettings]] defined by the [AnnotationTextStyle]($backend) applied to this component.\r\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.\r\n   */\r\n  styleOverrides?: TextStyleSettingsProps;\r\n}\r\n\r\n/** Options supplied to [[TextBlockComponent.stringify]] to control how the content is formatted.\r\n * @beta\r\n */\r\nexport interface TextBlockStringifyOptions {\r\n  /** A string to insert in between each [[Paragraph]].\r\n   * Default: \" \" - a single space.\r\n   */\r\n  paragraphBreak?: string;\r\n  /** A string to insert for each [[LineBreakRun]].\r\n   * Default: \" \" - a single space.\r\n   */\r\n  lineBreak?: string;\r\n  /** A string to insert between the numerator and denominator of each [[FractionRun]].\r\n   * Default: \"/\"\r\n   */\r\n  fractionSeparator?: string;\r\n  /** The number of spaces to use for tabs. If not provided, tabs will be represented by a tab character: \"\\t\".\r\n   * Default: \"undefined\" - use \"\\t\".\r\n   */\r\n  tabsAsSpaces?: number;\r\n  /** A string to insert in between the list marker and the list item.\r\n   * Default: \" \" - a single space.\r\n   */\r\n  listMarkerBreak?: string;\r\n}\r\n\r\n/**\r\n * Context information that may be useful when converting a [[TextBlock]] to a string.\r\n * @beta\r\n */\r\nexport interface TextBlockStringifyContext {\r\n  /** The current depth of the text block in the document structure. */\r\n  depth: number;\r\n}\r\n\r\nfunction clearStyleOverrides(component: StructuralTextBlockComponent, options?: ClearTextStyleOptions): void {\r\n  component.styleOverrides = {};\r\n  if (!options?.preserveChildrenOverrides) {\r\n    for (const child of component.children) {\r\n      child.clearStyleOverrides(options);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Abstract representation of any of the building blocks that make up a [[TextBlock]] document - namely [[Run]]s and [[StructuralTextBlockComponent]]s.\r\n * The [[TextBlock]] can specify an [AnnotationTextStyle]($backend) that formats its contents.\r\n * Each component can specify an optional [[styleOverrides]] to customize that formatting.\r\n * @beta\r\n */\r\nexport abstract class TextBlockComponent {\r\n  private _styleOverrides: TextStyleSettingsProps;\r\n\r\n  /** @internal */\r\n  protected constructor(props?: TextBlockComponentProps) {\r\n    this._styleOverrides = structuredClone(props?.styleOverrides ?? {});\r\n  }\r\n\r\n  /** Deviations in individual properties of the [[TextStyleSettings]] in the [AnnotationTextStyle]($backend).\r\n   * For example, if the style uses the \"Arial\" font, you can override that by settings `styleOverrides.font.name` to \"Comic Sans\".\r\n   * @see [[clearStyleOverrides]] to reset this to an empty object.\r\n   */\r\n  public get styleOverrides(): TextStyleSettingsProps {\r\n    return this._styleOverrides;\r\n  }\r\n\r\n  public set styleOverrides(overrides: TextStyleSettingsProps) {\r\n    this._styleOverrides = structuredClone(overrides);\r\n  }\r\n\r\n  /** Reset any [[styleOverrides]] applied to this component. */\r\n  public clearStyleOverrides(_options?: ClearTextStyleOptions): void {\r\n    this.styleOverrides = {};\r\n  }\r\n\r\n  /** Returns true if [[styleOverrides]] specifies any deviations from the [[TextBlock]]'s [AnnotationTextStyle]($backend). */\r\n  public get overridesStyle(): boolean {\r\n    return Object.keys(this.styleOverrides).length > 0;\r\n  }\r\n\r\n  /** Create a deep copy of this component. */\r\n  public abstract clone(): TextBlockComponent;\r\n\r\n  /** Compute a string representation of the contents of this component and all of its sub-components. */\r\n  public abstract stringify(options?: TextBlockStringifyOptions, context?: TextBlockStringifyContext): string;\r\n\r\n  /** Returns true if this component has no content or children. */\r\n  public abstract get isEmpty(): boolean;\r\n\r\n  /**\r\n  * Returns true if the string representation of this component consists only of whitespace characters.\r\n  * Useful for checking if the component is visually empty (producing no graphics) or contains only spaces, tabs, or line breaks.\r\n  */\r\n  public get isWhitespace(): boolean {\r\n    return /^\\s*$/g.test(this.stringify());\r\n  };\r\n\r\n  /** Convert this component to its JSON representation. */\r\n  public toJSON(): TextBlockComponentProps {\r\n    return {\r\n      styleOverrides: structuredClone(this.styleOverrides),\r\n    };\r\n  }\r\n\r\n  /** Returns true if `this` is equivalent to `other`. */\r\n  public equals(other: TextBlockComponent): boolean {\r\n    const mySettings = TextStyleSettings.fromJSON(this.styleOverrides);\r\n    const otherSettings = TextStyleSettings.fromJSON(other.styleOverrides);\r\n    return mySettings.equals(otherSettings);\r\n  }\r\n}\r\n\r\n/** [[TextBlockComponent]]s contained within a [[Paragraph]].\r\n * @beta\r\n */\r\nexport type Run = TextRun | FractionRun | TabRun | LineBreakRun | FieldRun;\r\n\r\n/** The JSON representation of a [[Run]].\r\n * Use the `type` field to discriminate between the different kinds of runs.\r\n * @beta\r\n */\r\nexport type RunProps = TextRunProps | FractionRunProps | TabRunProps | LineBreakRunProps | FieldRunProps;\r\n\r\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\r\n * multiple lines, but it will never contain different styling.\r\n * Use the `type` field to discriminate between the different kinds of runs.\r\n * @beta\r\n */\r\nexport namespace Run { // eslint-disable-line @typescript-eslint/no-redeclare\r\n  /** Create a run from its JSON representation.\r\n   * @see [[TextRun.create]], [[FractionRun.create]], [[FieldRun.create]], [[TabRun.create]], and [[LineBreakRun.create]] to create a run directly.\r\n   */\r\n  export function fromJSON(props: RunProps): Run {\r\n    switch (props.type) {\r\n      case \"field\": return FieldRun.create(props);\r\n      case \"fraction\": return FractionRun.create(props);\r\n      case \"linebreak\": return LineBreakRun.create(props);\r\n      case \"tab\": return TabRun.create(props);\r\n      case \"text\": return TextRun.create(props);\r\n    }\r\n  }\r\n}\r\n\r\n/** Describes whether the characters of a [[TextRun]] should be displayed normally, in subscript, or in superscript.\r\n * [[TextStyleSettings.superScriptScale]], [[TextStyleSettings.subScriptScale]], [[TextStyleSettings.superScriptOffsetFactor]], and [[TextStyleSettings.subScriptOffsetFactor]]\r\n * affect how the content is rendered.\r\n * @beta\r\n */\r\nexport type BaselineShift = \"subscript\" | \"superscript\" | \"none\";\r\n\r\n/** JSON representation of a [[TextRun]].\r\n * @beta\r\n */\r\nexport interface TextRunProps extends TextBlockComponentProps {\r\n  /** Discriminator field for the [[RunProps]] union. */\r\n  readonly type: \"text\";\r\n  /** The characters displayed by the run.\r\n   * Default: an empty string.\r\n   */\r\n  content?: string;\r\n  /** Whether to display [[content]] as a subscript, superscript, or normally.\r\n   * Default: \"none\"\r\n   */\r\n  baselineShift?: BaselineShift;\r\n}\r\n\r\n/** The most common type of [[Run]], containing a sequence of characters to be displayed using a single style.\r\n * @beta\r\n */\r\nexport class TextRun extends TextBlockComponent {\r\n  /** Discriminator field for the [[Run]] union. */\r\n  public readonly type = \"text\";\r\n  /** The sequence of characters to be displayed by the run. */\r\n  public content: string;\r\n  /** Whether to display [[content]] as a subscript, superscript, or normally. */\r\n  public baselineShift: BaselineShift;\r\n\r\n  private constructor(props: TextRunProps) {\r\n    super(props);\r\n    this.content = props?.content ?? \"\";\r\n    this.baselineShift = props?.baselineShift ?? \"none\";\r\n  }\r\n\r\n  public override clone(): TextRun {\r\n    return new TextRun(this.toJSON());\r\n  }\r\n\r\n  public override toJSON(): TextRunProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      type: \"text\",\r\n      content: this.content,\r\n      baselineShift: this.baselineShift,\r\n    };\r\n  }\r\n\r\n  public static create(props?: Omit<TextRunProps, \"type\">): TextRun {\r\n    return new TextRun({ ...props, type: \"text\" });\r\n  }\r\n\r\n  public override get isEmpty(): boolean {\r\n    return this.stringify().length === 0;\r\n  }\r\n\r\n  /** Simply returns [[content]]. */\r\n  public override stringify(): string {\r\n    return this.content;\r\n  }\r\n\r\n  public override equals(other: TextBlockComponent): boolean {\r\n    return other instanceof TextRun && this.content === other.content && this.baselineShift === other.baselineShift && super.equals(other);\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[FractionRun]].\r\n * @beta\r\n */\r\nexport interface FractionRunProps extends TextBlockComponentProps {\r\n  /** Discriminator field for the [[RunProps]] union. */\r\n  readonly type: \"fraction\";\r\n  /** The text displayed before or above the fraction separator, depending on [[TextStyleSettings.stackedFractionType]]. Default: an empty string. */\r\n  numerator?: string;\r\n  /** The text displayed after or below the fraction separator, depending on [[TextStyleSettings.stackedFractionType]]. Default: an empty string. */\r\n  denominator?: string;\r\n}\r\n\r\n/** A [[Run]] containing a numeric ratio to be displayed as a numerator and denominator separated by a horizontal or diagonal bar.\r\n * @note The [[numerator]] and [[denominator]] are stored as strings. They are not technically required to contain a numeric representation.\r\n * @beta\r\n */\r\nexport class FractionRun extends TextBlockComponent {\r\n  /** Discriminator field for the [[Run]] union. */\r\n  public readonly type = \"fraction\";\r\n  /** The fraction's numerator. */\r\n  public numerator: string;\r\n  /** The fraction's denominator. */\r\n  public denominator: string;\r\n\r\n  private constructor(props: FractionRunProps) {\r\n    super(props);\r\n    this.numerator = props?.numerator ?? \"\";\r\n    this.denominator = props?.denominator ?? \"\";\r\n  }\r\n\r\n  public override toJSON(): FractionRunProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      type: \"fraction\",\r\n      numerator: this.numerator,\r\n      denominator: this.denominator,\r\n    };\r\n  }\r\n\r\n  public override clone(): FractionRun {\r\n    return new FractionRun(this.toJSON());\r\n  }\r\n\r\n  public static create(props?: Omit<FractionRunProps, \"type\">): FractionRun {\r\n    return new FractionRun({ ...props, type: \"fraction\" });\r\n  }\r\n\r\n  public override get isEmpty(): boolean {\r\n    return this.stringify().length === 0;\r\n  }\r\n\r\n  /** Formats the fraction as a string with the [[numerator]] and [[denominator]] separated by [[TextBlockStringifyOptions.fractionSeparator]]. */\r\n  public override stringify(options?: TextBlockStringifyOptions): string {\r\n    const sep = options?.fractionSeparator ?? \"/\";\r\n    return `${this.numerator}${sep}${this.denominator}`;\r\n  }\r\n\r\n  public override equals(other: TextBlockComponent): boolean {\r\n    return other instanceof FractionRun && this.numerator === other.numerator && this.denominator === other.denominator && super.equals(other);\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[LineBreakRun]].\r\n * @beta\r\n */\r\nexport interface LineBreakRunProps extends TextBlockComponentProps {\r\n  /** Discriminator field for the [[RunProps]] union. */\r\n  readonly type: \"linebreak\";\r\n}\r\n\r\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.\r\n * @beta\r\n */\r\nexport class LineBreakRun extends TextBlockComponent {\r\n  /** Discriminator field for the [[Run]] union. */\r\n  public readonly type = \"linebreak\";\r\n\r\n  private constructor(props: LineBreakRunProps) {\r\n    super(props);\r\n  }\r\n\r\n  public override toJSON(): LineBreakRunProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      type: \"linebreak\",\r\n    };\r\n  }\r\n\r\n  public static create(props?: Omit<LineBreakRunProps, \"type\">) {\r\n    return new LineBreakRun({ ...props, type: \"linebreak\" });\r\n  }\r\n\r\n  public override clone(): LineBreakRun {\r\n    return new LineBreakRun(this.toJSON());\r\n  }\r\n\r\n  public override get isEmpty(): boolean {\r\n    return this.stringify().length === 0;\r\n  }\r\n\r\n  /** Simply returns [[TextBlockStringifyOptions.lineBreak]]. */\r\n  public override stringify(options?: TextBlockStringifyOptions): string {\r\n    return options?.lineBreak ?? \" \";\r\n  }\r\n\r\n  public override equals(other: TextBlockComponent): boolean {\r\n    return other instanceof LineBreakRun && super.equals(other);\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[TabRun]].\r\n * @beta\r\n */\r\nexport interface TabRunProps extends TextBlockComponentProps {\r\n  /** Discriminator field for the [[RunProps]] union. */\r\n  readonly type: \"tab\";\r\n}\r\n\r\n/** A [[TabRun]] is used to shift the next tab stop.\r\n * @note Only left-justified tabs are supported at this tab.\r\n * @beta\r\n */\r\nexport class TabRun extends TextBlockComponent {\r\n  /** Discriminator field for the [[Run]] union. */\r\n  public readonly type = \"tab\";\r\n\r\n  public override toJSON(): TabRunProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      type: \"tab\",\r\n    };\r\n  }\r\n\r\n  public override clone(): TabRun {\r\n    return new TabRun(this.toJSON());\r\n  }\r\n\r\n  public static create(props?: Omit<TabRunProps, \"type\">): TabRun {\r\n    return new TabRun(props);\r\n  }\r\n\r\n  public override get isEmpty(): boolean {\r\n    return this.stringify().length === 0;\r\n  }\r\n\r\n  /**\r\n * Converts a [[TabRun]] to its string representation.\r\n * If the `tabsAsSpaces` option is provided, returns a string of spaces of the specified length.\r\n * Otherwise, returns a tab character (\"\\t\").\r\n */\r\n  public override stringify(options?: TextBlockStringifyOptions): string {\r\n    if (options?.tabsAsSpaces) {\r\n      return \" \".repeat(options.tabsAsSpaces);\r\n    }\r\n\r\n    return \"\\t\";\r\n  }\r\n\r\n  public override equals(other: TextBlockComponent): boolean {\r\n    return other instanceof TabRun && super.equals(other);\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[FieldRun]].\r\n * @beta\r\n */\r\nexport interface FieldRunProps extends TextBlockComponentProps {\r\n  /** Discriminator field for the [[RunProps]] union. */\r\n  readonly type: \"field\";\r\n  /** The element and BIS class containing the property described by [[propertyPath]]. */\r\n  propertyHost: FieldPropertyHost;\r\n  /** Describes how to obtain the property value from [[propertyHost]]. */\r\n  propertyPath: FieldPropertyPath;\r\n  /** Specifies how to format the property value obtained from [[propertyPath]] into a string to be stored in [[cachedContent]].\r\n   * The specific options used depend upon the field's [[propertyType]].\r\n   */\r\n  formatOptions?: FieldFormatOptions;\r\n  /** The field's most recently evaluated display string.\r\n   * @note It is unnecessary to specify this when creating a field as part of an element like a [[TextAnnotation2d]], because\r\n   * all of the element's fields will be re-evaluated when inserting or updating the element in the iModel.\r\n   */\r\n  cachedContent?: string;\r\n}\r\n\r\n/** A [[Run]] that displays the formatted value of a property of some [Element]($backend).\r\n * When a [[TextBlock]] containing a [[FieldRun]] is written into the iModel as an [ITextAnnotation]($backend) element,\r\n * a dependency is established between the two elements via the [ElementDrivesTextAnnotation]($backend) relationship such that\r\n * whenever the source element specified by [[propertyHost]] is modified or the `ITextAnnotation` element is inserted or updated in the iModel,\r\n * the field(s) in the `ITextAnnotation` element are automatically\r\n * recalculated, causing their [[cachedContent]] to update. If the field's display string cannot be evaluated (for example, because the specified element or\r\n * property does not exist), then its cached content is set to [[FieldRun.invalidContentIndicator]].\r\n * A [[FieldRun]] displays its [[cachedContent]] in the same way that [[TextRun]]s display their `content`, including word wrapping where appropriate.\r\n * @beta\r\n */\r\nexport class FieldRun extends TextBlockComponent {\r\n  /** Display string used to signal an error in computing the field's value. */\r\n  public static invalidContentIndicator = \"####\";\r\n\r\n  /** Discriminator field for the [[Run]] union. */\r\n  public readonly type = \"field\";\r\n  /** The element and BIS class containing the property described by [[propertyPath]]. */\r\n  public propertyHost: FieldPropertyHost;\r\n  /** Describes how to obtain the property value from [[propertyHost]]. */\r\n  public propertyPath: FieldPropertyPath;\r\n  /** Specifies how to format the property value obtained from [[propertyPath]] into a string to be stored in [[cachedContent]].\r\n   * The specific options used depend upon the [[FieldPropertyType]].\r\n   */\r\n  public formatOptions?: FieldFormatOptions;\r\n  private _cachedContent: string;\r\n\r\n  /** The field's most recently evaluated display string. */\r\n  public get cachedContent(): string {\r\n    return this._cachedContent;\r\n  }\r\n\r\n  /** @internal Used by core-backend when re-evaluating field content. */\r\n  public setCachedContent(content: string | undefined): void {\r\n    this._cachedContent = content ?? FieldRun.invalidContentIndicator;\r\n  }\r\n\r\n  private constructor(props: FieldRunProps) {\r\n    super(props);\r\n\r\n    this._cachedContent = props.cachedContent ?? FieldRun.invalidContentIndicator;\r\n    this.propertyHost = props.propertyHost\r\n    this.propertyPath = props.propertyPath;\r\n    this.formatOptions = props.formatOptions;\r\n  }\r\n\r\n  /** Create a FieldRun from its JSON representation. */\r\n  public static create(props: Omit<FieldRunProps, \"type\">): FieldRun {\r\n    return new FieldRun({\r\n      ...props,\r\n      propertyHost: { ...props.propertyHost },\r\n      propertyPath: structuredClone(props.propertyPath),\r\n      formatOptions: structuredClone(props.formatOptions),\r\n      type: \"field\",\r\n    });\r\n  }\r\n\r\n  /** Convert the FieldRun to its JSON representation. */\r\n  public override toJSON(): FieldRunProps {\r\n    const json: FieldRunProps = {\r\n      ...super.toJSON(),\r\n      type: \"field\",\r\n      propertyHost: { ...this.propertyHost },\r\n      propertyPath: structuredClone(this.propertyPath),\r\n    };\r\n\r\n    if (this.cachedContent !== FieldRun.invalidContentIndicator) {\r\n      json.cachedContent = this.cachedContent;\r\n    }\r\n\r\n    if (this.formatOptions) {\r\n      json.formatOptions = structuredClone(this.formatOptions);\r\n    }\r\n\r\n    return json;\r\n  }\r\n\r\n  /** Create a deep copy of this FieldRun. */\r\n  public override clone(): FieldRun {\r\n    return new FieldRun(this.toJSON());\r\n  }\r\n\r\n  public override get isEmpty(): boolean {\r\n    return this.stringify().length === 0;\r\n  }\r\n\r\n  /** Convert this FieldRun to a simple string representation. */\r\n  public override stringify(): string {\r\n    return this.cachedContent;\r\n  }\r\n\r\n  /** Returns true if `this` is equivalent to `other`. */\r\n  public override equals(other: TextBlockComponent): boolean {\r\n    if (!(other instanceof FieldRun) || !super.equals(other)) {\r\n      return false;\r\n    }\r\n\r\n    if (\r\n      this.propertyHost.elementId !== other.propertyHost.elementId ||\r\n      this.propertyHost.className !== other.propertyHost.className ||\r\n      this.propertyHost.schemaName !== other.propertyHost.schemaName\r\n    ) {\r\n      return false;\r\n    }\r\n\r\n    if (this.propertyPath.propertyName !== other.propertyPath.propertyName) {\r\n      return false;\r\n    }\r\n\r\n    const thisAccessors = this.propertyPath.accessors ?? [];\r\n    const otherAccessors = other.propertyPath.accessors ?? [];\r\n\r\n    if (thisAccessors.length !== otherAccessors.length) {\r\n      return false;\r\n    }\r\n\r\n    if (!thisAccessors.every((value, index) => value === otherAccessors[index])) {\r\n      return false;\r\n    }\r\n\r\n    if (this.formatOptions && other.formatOptions) {\r\n      // We anticipate new formatting options being added in the future.\r\n      // So to account for properties we don't know about, just compare the string representations.\r\n      if (JSON.stringify(this.formatOptions) !== JSON.stringify(other.formatOptions)) {\r\n        return false;\r\n      }\r\n    } else if (this.formatOptions || other.formatOptions) {\r\n      return false;\r\n    }\r\n\r\n    return true;\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[Paragraph]].\r\n * @beta\r\n */\r\nexport interface ParagraphProps extends TextBlockComponentProps {\r\n  children?: Array<ListProps | RunProps>;\r\n}\r\n\r\n/** A collection of [[Run]]s and [[List]]s. Paragraphs can be appended to [[List]]s and [[TextBlock]]s.\r\n * Each paragraph is laid out on a separate line. If included in a [[List]], the paragraph will be treated as a list item.\r\n * @beta\r\n */\r\nexport class Paragraph extends TextBlockComponent {\r\n  public readonly type = \"paragraph\";\r\n  public readonly children: Array<List | Run>;\r\n\r\n  private constructor(props?: ParagraphProps) {\r\n    super(props);\r\n\r\n    this.children = props?.children?.map((child) =>\r\n      child.type === \"list\" ? List.create(child) : Run.fromJSON(child)\r\n    ) ?? [];\r\n  }\r\n\r\n  /** Create a paragraph from its JSON representation. */\r\n  public static create(props?: Omit<ParagraphProps, \"type\">): Paragraph {\r\n    return new Paragraph(props);\r\n  }\r\n\r\n  public override clearStyleOverrides(options?: ClearTextStyleOptions): void {\r\n    clearStyleOverrides(this, options);\r\n  }\r\n\r\n  public override get isEmpty() {\r\n    return this.children.length === 0;\r\n  }\r\n\r\n  public override clone(): Paragraph {\r\n    return new Paragraph(this.toJSON());\r\n  }\r\n\r\n  public override toJSON(): ParagraphProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      children: this.children.map((child) => child.toJSON()),\r\n    };\r\n  }\r\n\r\n  /** Compute a string representation of this paragraph by concatenating the string representations of all of its children. */\r\n  public override stringify(options?: TextBlockStringifyOptions, context?: TextBlockStringifyContext): string {\r\n    return this.children.map((x, index) => (index > 0 && x.type === \"list\") ? `${options?.paragraphBreak ?? \" \"}${x.stringify(options, context)}` : x.stringify(options, context)).join(\"\") ?? \"\";\r\n  }\r\n\r\n  public override equals(other: TextBlockComponent): boolean {\r\n    return (other instanceof Paragraph) && super.equals(other);\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[List]].\r\n * @beta\r\n */\r\nexport interface ListProps extends TextBlockComponentProps {\r\n  readonly type: \"list\";\r\n  children?: ParagraphProps[];\r\n}\r\n\r\n/** A collection of list items ([[Paragraph]]s). Lists can be appended to [[Paragraph]]s.\r\n * Lists will be laid out on a new line. Each item in a list is laid out on a separate line.\r\n * @beta\r\n */\r\nexport class List extends TextBlockComponent {\r\n  public readonly type = \"list\";\r\n  public readonly children: Paragraph[];\r\n\r\n  protected constructor(props?: ListProps) {\r\n    super(props);\r\n\r\n    this.children = props?.children?.map((child) => Paragraph.create(child)) ?? [];\r\n  }\r\n\r\n  /** Create a list from its JSON representation. */\r\n  public static create(props?: Omit<ListProps, \"type\">): List {\r\n    return new List({ ...props, type: \"list\" });\r\n  }\r\n\r\n  public override clearStyleOverrides(options?: ClearTextStyleOptions): void {\r\n    clearStyleOverrides(this, options);\r\n  }\r\n\r\n  public override get isEmpty() {\r\n    return this.children.length === 0;\r\n  }\r\n\r\n  public override clone(): List {\r\n    return new List(this.toJSON());\r\n  }\r\n\r\n  public override toJSON(): ListProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      type: \"list\",\r\n      children: this.children.map((run) => run.toJSON()),\r\n    };\r\n  }\r\n\r\n  /** Compute a string representation of this list by concatenating the string representations of all of its [[children]]. */\r\n  public override stringify(options?: TextBlockStringifyOptions, context?: TextBlockStringifyContext): string {\r\n    const children = this.children.map((x, index) => {\r\n      const depth = context?.depth ?? 0;\r\n      const marker = getMarkerText(this.styleOverrides.listMarker ?? TextStyleSettings.defaultProps.listMarker, index + 1);\r\n      const tab = (options?.tabsAsSpaces ? \" \".repeat(options.tabsAsSpaces) : \"\\t\").repeat(depth);\r\n      return `${tab}${marker}${options?.listMarkerBreak ?? \" \"}${x.stringify(options, { depth: depth + 1 })}`;\r\n    });\r\n    return children.join(options?.paragraphBreak ?? \" \") ?? \"\";\r\n  }\r\n\r\n  public override equals(other: TextBlockComponent): boolean {\r\n    return (other instanceof List) && super.equals(other);\r\n  }\r\n}\r\n\r\n/** JSON representation of a [[TextBlock]].\r\n * @beta\r\n */\r\nexport interface TextBlockProps extends TextBlockComponentProps {\r\n  /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.\r\n   * A value less than or equal to zero indicates no wrapping is to be applied.\r\n   * Default: 0\r\n   */\r\n  width?: number;\r\n  children?: ParagraphProps[];\r\n}\r\n\r\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.\r\n * No word-wrapping is applied to the document unless a [[width]] greater than zero is specified.\r\n * @see [[TextAnnotation]] to position a text block as an annotation in 2d or 3d space.\r\n * @beta\r\n */\r\nexport class TextBlock extends TextBlockComponent {\r\n  public readonly children: Paragraph[];\r\n\r\n  /** The width of the document in meters. Lines that would exceed this width are instead wrapped around to the next line if possible.\r\n   * A value less than or equal to zero indicates no wrapping is to be applied.\r\n   * Default: 0\r\n   */\r\n  public width: number;\r\n\r\n  private constructor(props: TextBlockProps) {\r\n    super(props);\r\n    this.width = props.width ?? 0;\r\n\r\n    this.children = props?.children?.map((para) => Paragraph.create(para)) ?? [];\r\n  }\r\n\r\n  public override clearStyleOverrides(options?: ClearTextStyleOptions): void {\r\n    clearStyleOverrides(this, options);\r\n  }\r\n\r\n  public override toJSON(): TextBlockProps {\r\n    return {\r\n      ...super.toJSON(),\r\n      width: this.width,\r\n      children: this.children.map((x) => x.toJSON()),\r\n    };\r\n  }\r\n\r\n  /** Create a text block from its JSON representation. */\r\n  public static create(props?: Omit<TextBlockProps, \"type\">): TextBlock {\r\n    return new TextBlock(props ?? {});\r\n  }\r\n\r\n  /** Returns true if every paragraph in this text block is empty. */\r\n  public override get isEmpty(): boolean {\r\n    return !this.children || this.children.every((child) => child.isEmpty);\r\n  }\r\n\r\n  public override clone(): TextBlock {\r\n    return new TextBlock(this.toJSON());\r\n  }\r\n\r\n  /** Compute a string representation of the document's contents by concatenating the string representations of each of its [[children]], separated by [[TextBlockStringifyOptions.paragraphBreak]]. */\r\n  public stringify(options?: TextBlockStringifyOptions): string {\r\n    return this.children.map((x) => x.stringify(options)).join(options?.paragraphBreak ?? \" \") || \"\";\r\n  }\r\n\r\n  /** Add and return a new paragraph.\r\n   * By default, the paragraph will be created with no [[styleOverrides]], so that it inherits the style of this block.\r\n   * @param seedFromLast If true and [[children]] is not empty, the new paragraph will inherit the style overrides of the last child in this block.\r\n   * @note Be sure you pass in [[ParagraphProps]] and not [[Paragraph]] or style overrides will be ignored.\r\n   */\r\n  public appendParagraph(props?: ParagraphProps, seedFromLast = false): Paragraph {\r\n    const seed = seedFromLast ? this.children[this.children.length - 1] : undefined;\r\n    const styleOverrides = { ...seed?.styleOverrides, ...props?.styleOverrides };\r\n    const paragraph = Paragraph.create({ ...props, styleOverrides });\r\n    this.children.push(paragraph);\r\n    return paragraph;\r\n  }\r\n\r\n  /** Append a run to the last [[Paragraph]] in this block.\r\n   * If the block contains no [[children]], a new [[Paragraph]] will first be created using [[appendParagraph]].\r\n   */\r\n  public appendRun(run: Run): void {\r\n    const paragraph = this.children[this.children.length - 1] ?? this.appendParagraph();\r\n    paragraph.children.push(run);\r\n  }\r\n\r\n  public override equals(other: TextBlockComponent): boolean {\r\n    if (!(other instanceof TextBlock)) {\r\n      return false;\r\n    }\r\n\r\n    if (!super.equals(other)) {\r\n      return false;\r\n    }\r\n\r\n    if (this.width !== other.width) {\r\n      return false;\r\n    }\r\n\r\n    if (this.children && other.children) {\r\n      if (this.children.length !== other.children.length) {\r\n        return false;\r\n      }\r\n\r\n      return this.children.every((child, index) => other.children && child.equals(other.children[index]));\r\n    }\r\n\r\n    return true;\r\n  }\r\n}\r\n\r\n/**\r\n * A union of all the [[TextBlockComponent]]s that can contain other components.\r\n * @beta\r\n */\r\nexport type StructuralTextBlockComponent = List | Paragraph | TextBlock;\r\n\r\n/**\r\n * Recursively traverses a [[StructuralTextBlockComponent]] tree, yielding each child component along with its parent container.\r\n * This generator enables depth-first iteration over all components in a text block structure, including paragraphs, lists, and runs.\r\n *\r\n * @param parent The root container whose children should be traversed.\r\n * @returns An IterableIterator yielding objects with the child component and its parent container.\r\n * @beta\r\n */\r\nexport function* traverseTextBlockComponent(parent: StructuralTextBlockComponent): IterableIterator<{ parent: StructuralTextBlockComponent, child: List | Paragraph | Run }> {\r\n  for (const child of parent.children) {\r\n    yield { parent, child };\r\n    if (child.type === \"list\" || child.type === \"paragraph\") {\r\n      yield* traverseTextBlockComponent(child);\r\n    }\r\n  }\r\n}\r\n\r\n/**\r\n * Returns the formatted marker text for a list item based on the marker type and item number.\r\n * Supports ordered and unordered list markers, including alphabetic, Roman numeral, and numeric formats.\r\n * @param marker The type of list marker to use.\r\n * @param num The item number in the list.\r\n * @returns The formatted marker string for the list item.\r\n * @beta\r\n */\r\nexport function getMarkerText(marker: ListMarker, num: number): string {\r\n  let markerString = \"\";\r\n\r\n  switch (marker.enumerator) {\r\n    case undefined:\r\n    case ListMarkerEnumerator.Number:\r\n      markerString = `${num}`;\r\n      break;\r\n    case ListMarkerEnumerator.Letter:\r\n      markerString = integerToAlpha(num);\r\n      break;\r\n    case ListMarkerEnumerator.RomanNumeral:\r\n      markerString = integerToRoman(num);\r\n      break;\r\n    default:\r\n      markerString = marker.enumerator;\r\n      break;\r\n  }\r\n\r\n  if (marker.case) {\r\n    markerString = marker.case === \"upper\" ? markerString.toUpperCase() : markerString.toLowerCase();\r\n  }\r\n\r\n  const terminator = marker.terminator === \"period\" ? \".\" : marker.terminator === \"parenthesis\" ? \")\" : \"\";\r\n\r\n  return `${markerString}${terminator}`;\r\n}\r\n\r\n/**\r\n * Converts an integer to its Roman numeral representation.\r\n * Supports numbers from 1 and above.\r\n * @param num The integer to convert.\r\n * @returns The Roman numeral string.\r\n */\r\nfunction integerToRoman(num: number): string {\r\n  const values =\r\n    [1000, 900, 500, 400, 100, 90, 50, 40, 10, 9, 5, 4, 1];\r\n  const symbols =\r\n    ['M', 'CM', 'D', 'CD', 'C', 'XC', 'L', 'XL', 'X', 'IX', 'V', 'IV', 'I'];\r\n  let roman = '';\r\n  for (let i = 0; i < values.length; i++) {\r\n    while (num >= values[i]) {\r\n      roman += symbols[i];\r\n      num -= values[i];\r\n    }\r\n  }\r\n\r\n  return roman;\r\n}\r\n\r\n/**\r\n * Converts an integer to its alphabetic representation (A-Z, AA-ZZ, etc.).\r\n * Used for ordered list markers with alphabetic styles.\r\n * @param num The integer to convert (1-based).\r\n * @returns The alphabetic string for the given number.\r\n */\r\nfunction integerToAlpha(num: number): string {\r\n  const letterOffset = (num - 1) % 26;\r\n  const letter = String.fromCharCode(65 + letterOffset);\r\n  const depth = Math.ceil(num / 26);\r\n  return letter.repeat(depth);\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"TextBlockGeometryProps.js","sourceRoot":"","sources":["../../../src/annotation/TextBlockGeometryProps.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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 { XYZProps } from \"@itwin/core-geometry\";\nimport { TextStringProps } from \"../geometry/TextString\";\nimport { TextStyleColor } from \"./TextStyle\";\n\n/**\n * A single entry in a [[TextBlockGeometryProps]], representing one of the following primitive types:\n * - A [[TextString]],\n * - A fraction separator described by a [LineSegment3d]($geometry), or\n * - A change in color, to be applied to all subsequent primitives.\n * @beta\n */\nexport type TextBlockGeometryPropsEntry = {\n  text: TextStringProps;\n  separator?: never;\n  color?: never;\n} | {\n  text?: never;\n  separator: {\n    startPoint: XYZProps;\n    endPoint: XYZProps;\n  };\n  color?: never;\n} | {\n  text?: never;\n  separator?: never;\n  color: TextStyleColor;\n};\n\n/**\n * JSON representation of the geometric primitives that can be used to display a [[TextBlock]].\n * @see [appendTextAnnotationGeometry]($backend) to convert an annotation to its geometric representation.\n * @see [[GeometryStreamBuilder.appendTextBlock]] to add a block of text to a [GeometryStream]($docs/learning/common/GeometryStream.md).\n * @beta\n */\nexport interface TextBlockGeometryProps {\n  /** The set of geometric primitives representing the contents of the [[TextBlock]]. */\n  entries: TextBlockGeometryPropsEntry[];\n}\n"]}
+{"version":3,"file":"TextBlockGeometryProps.js","sourceRoot":"","sources":["../../../src/annotation/TextBlockGeometryProps.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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 Annotation\r\n */\r\n\r\nimport { XYZProps } from \"@itwin/core-geometry\";\r\nimport { TextStringProps } from \"../geometry/TextString\";\r\nimport { TextStyleColor } from \"./TextStyle\";\r\n\r\n/**\r\n * A single entry in a [[TextBlockGeometryProps]], representing one of the following primitive types:\r\n * - A [[TextString]],\r\n * - A fraction separator described by a [LineSegment3d]($geometry), or\r\n * - A change in color, to be applied to all subsequent primitives.\r\n * @beta\r\n */\r\nexport type TextBlockGeometryPropsEntry = {\r\n  text: TextStringProps;\r\n  separator?: never;\r\n  color?: never;\r\n} | {\r\n  text?: never;\r\n  separator: {\r\n    startPoint: XYZProps;\r\n    endPoint: XYZProps;\r\n  };\r\n  color?: never;\r\n} | {\r\n  text?: never;\r\n  separator?: never;\r\n  color: TextStyleColor;\r\n};\r\n\r\n/**\r\n * JSON representation of the geometric primitives that can be used to display a [[TextBlock]].\r\n * @see [appendTextAnnotationGeometry]($backend) to convert an annotation to its geometric representation.\r\n * @see [[GeometryStreamBuilder.appendTextBlock]] to add a block of text to a [GeometryStream]($docs/learning/common/GeometryStream.md).\r\n * @beta\r\n */\r\nexport interface TextBlockGeometryProps {\r\n  /** The set of geometric primitives representing the contents of the [[TextBlock]]. */\r\n  entries: TextBlockGeometryPropsEntry[];\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"TextBlockLayoutResult.js","sourceRoot":"","sources":["../../../src/annotation/TextBlockLayoutResult.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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 { Range2dProps, XAndY } from \"@itwin/core-geometry\";\nimport { FontId } from \"../Fonts\";\nimport { TextStyleSettingsProps } from \"./TextStyle\";\n\n/**\n * Represents a single run in a [[LineLayoutResult]].\n * @note Get the text content of the RunLayoutResult using a combination of the `sourceRunIndex`, `characterOffset`, and `characterCount`.\n * @beta\n */\nexport interface RunLayoutResult {\n  /** The ID of the font for the run. */\n  fontId: FontId;\n  /**\n   * The number of characters from the source [[Run]] that have already appeared in the layout.\n   * @note A single source [[TextRun]] can be split into multiple lines to respect the [[TextBlock.width]].\n  */\n  characterOffset: number;\n  /** The number of characters in the RunLayoutResult. */\n  characterCount: number;\n  /** The offset of the RunLayoutResult from the top and left of the [[LineLayoutResult]] */\n  offsetFromLine: XAndY;\n  /** Bounding box enclosing this RunLayoutResult's content. */\n  range: Range2dProps;\n  /** The resolved [[TextStyleSettings]] for the run. Takes into account overrides and styles on the parent classes. */\n  textStyle: TextStyleSettingsProps;\n  /** Bounding box used when justifying the run. This may be smaller than [[range]]. */\n  justificationRange?: Range2dProps;\n  /** The range containing the contents of the [[FractionRun]]'s numerator. */\n  numeratorRange?: Range2dProps;\n  /** The range containing the contents of the [[FractionRun]]'s denominator. */\n  denominatorRange?: Range2dProps;\n}\n\n/**\n * Represents a single line in a [[TextBlockLayoutResult]].\n * @beta\n */\nexport interface LineLayoutResult {\n  /** The runs contained in the line. */\n  runs: RunLayoutResult[];\n  /** The marker run for the line, if any */\n  marker: RunLayoutResult | undefined;\n  /** The range of all the runs (including the marker) contained in the line. */\n  range: Range2dProps;\n  /** Bounding box used when justifying the line. This may be smaller than [[range]]. */\n  justificationRange: Range2dProps;\n  /** The offset of the line from the top and left of the [[TextBlock]]. */\n  offsetFromDocument: XAndY;\n}\n\n/**\n * Represents the result of laying out a [[TextBlock]]'s contents into a series of lines containing runs.\n * @see [computeLayoutTextBlockResult]($backend) to lay out a `TextBlock`.\n * @beta\n */\nexport interface TextBlockLayoutResult {\n  /** The laid out lines of a [[TextBlock]]. */\n  lines: LineLayoutResult[];\n  /** The range containing the contents of a [[TextBlock]]. */\n  range: Range2dProps;\n}\n"]}
+{"version":3,"file":"TextBlockLayoutResult.js","sourceRoot":"","sources":["../../../src/annotation/TextBlockLayoutResult.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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 Annotation\r\n */\r\n\r\nimport { Range2dProps, XAndY } from \"@itwin/core-geometry\";\r\nimport { FontId } from \"../Fonts\";\r\nimport { TextStyleSettingsProps } from \"./TextStyle\";\r\n\r\n/**\r\n * Represents a single run in a [[LineLayoutResult]].\r\n * @note Get the text content of the RunLayoutResult using a combination of the `sourceRunIndex`, `characterOffset`, and `characterCount`.\r\n * @beta\r\n */\r\nexport interface RunLayoutResult {\r\n  /** The ID of the font for the run. */\r\n  fontId: FontId;\r\n  /**\r\n   * The number of characters from the source [[Run]] that have already appeared in the layout.\r\n   * @note A single source [[TextRun]] can be split into multiple lines to respect the [[TextBlock.width]].\r\n  */\r\n  characterOffset: number;\r\n  /** The number of characters in the RunLayoutResult. */\r\n  characterCount: number;\r\n  /** The offset of the RunLayoutResult from the top and left of the [[LineLayoutResult]] */\r\n  offsetFromLine: XAndY;\r\n  /** Bounding box enclosing this RunLayoutResult's content. */\r\n  range: Range2dProps;\r\n  /** The resolved [[TextStyleSettings]] for the run. Takes into account overrides and styles on the parent classes. */\r\n  textStyle: TextStyleSettingsProps;\r\n  /** Bounding box used when justifying the run. This may be smaller than [[range]]. */\r\n  justificationRange?: Range2dProps;\r\n  /** The range containing the contents of the [[FractionRun]]'s numerator. */\r\n  numeratorRange?: Range2dProps;\r\n  /** The range containing the contents of the [[FractionRun]]'s denominator. */\r\n  denominatorRange?: Range2dProps;\r\n}\r\n\r\n/**\r\n * Represents a single line in a [[TextBlockLayoutResult]].\r\n * @beta\r\n */\r\nexport interface LineLayoutResult {\r\n  /** The runs contained in the line. */\r\n  runs: RunLayoutResult[];\r\n  /** The marker run for the line, if any */\r\n  marker: RunLayoutResult | undefined;\r\n  /** The range of all the runs (including the marker) contained in the line. */\r\n  range: Range2dProps;\r\n  /** Bounding box used when justifying the line. This may be smaller than [[range]]. */\r\n  justificationRange: Range2dProps;\r\n  /** The offset of the line from the top and left of the [[TextBlock]]. */\r\n  offsetFromDocument: XAndY;\r\n}\r\n\r\n/**\r\n * Represents the result of laying out a [[TextBlock]]'s contents into a series of lines containing runs.\r\n * @see [computeLayoutTextBlockResult]($backend) to lay out a `TextBlock`.\r\n * @beta\r\n */\r\nexport interface TextBlockLayoutResult {\r\n  /** The laid out lines of a [[TextBlock]]. */\r\n  lines: LineLayoutResult[];\r\n  /** The range containing the contents of a [[TextBlock]]. */\r\n  range: Range2dProps;\r\n}\r\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"TextField.js","sourceRoot":"","sources":["../../../src/annotation/TextField.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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\";\n\n/** Enumerates the different kinds of [Property]($ecschema-metadata) values that can be used as the basis for a [[FieldRun]]'s display string.\n * A field's property type is derived from the property's [PrimitiveType]($ecschema-metadata) and other attributes like its [PrimitiveOrEnumPropertyBase.extendedTypeName]($ecschema-metadata).\n * The conversion of the raw property value into a display string can be customized by different [[FieldFormatOptions]] based on its type.\n * The following types are currently recognized:\n *  - \"quantity\": an often-unitized scalar value like a distance or area, formatted using a quantity [Format]($core-quantity).\n *  - \"coordinate\": a 2- or 3-dimensional point, with each component formatted as a \"quantity\".\n *  - \"boolean\": a true or false value.\n *  - \"datetime\": an ECMAScript [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date).\n *  - \"int-enum\": an integer [EnumerationProperty]($ecschema-metadata) formatted using the enum value's display label.\n *  - \"string-enum\": a string [EnumerationProperty]($ecschema-metadata) formatted using the enum value's display label.\n *  - \"string\": a value convertible to a string.\n * @note Currently, only formatting of \"string\" and \"datetime\" types is implemented. Other types are converted to and formatted as \"string\".\n * @beta\n */\nexport type FieldPropertyType = \"quantity\" | \"coordinate\" | \"string\" | \"boolean\" | \"datetime\" | \"int-enum\" | \"string-enum\";\n\n/** A chain of property accesses that resolves to a primitive value that forms the basis of the displayed content\n * of a [[FieldRun]].\n   * The simplest property paths consist of a [[propertyName]] and nothing else, where `propertyName` identifies\n   * a primitive property.\n   * If `propertyName` identifies a struct or array property, then additional [[accessors]] are required to identify the specific value.\n   * Some examples:\n   * ```\n   * | Access String | propertyName | accessors |\n   * | ------------- | ------------ | --------- |\n   * | name          | \"name\"       | undefined |\n   * | spouse.name   | \"spouse\"     | [name]    |\n   * | colors[2]     | \"colors\"     | [2]       |\n   * | spouse.favoriteRestaurants[1].address | \"spouse\" | [\"favoriteRestaurants\", 1, \"address\"] |\n   * ```\n * @beta\n */\nexport interface FieldPropertyPath {\n  /** The name of the BIS property of the [[FieldPropertyHost]] that serves as the root of the path. */\n  propertyName: string;\n  /** Property names and/or array indices describing the path from [[propertyName]] to the ultimate BIS property. */\n  accessors?: Array<string | number>;\n}\n\n/** Describes the source of the property value against which a [[FieldPropertyPath]] is evaluated.\n * A field property is always hosted by an [Element]($backend). It may refer to a property belonging to any of the following:\n * - The element's BIS class itself;\n * - One of the element's [ElementAspect]($backend)s;\n * - Or an [EC view]($docs/learning/ECSqlReference/Views.md) with the same ECInstanceId as the element.\n * The [[schemaName]] and [[className]] should always identify the exact class that contains [[FieldPropertyPath.propertyName]] - not a subclass thereof.\n * @beta\n */\nexport interface FieldPropertyHost {\n  /** The Id of the [Element]($backend) that hosts the property. */\n  elementId: Id64String;\n  /** The name of the schema containing the class identified by [[className]]. */\n  schemaName: string;\n  /** The name of the exact class (not a subclass) containing the property identified by [[FieldPropertyPath.propertyName]]. */\n  className: string;\n}\n\n/** As part of [[FieldFormatOptions]], specifies how to modify the case of the display string.\n * \"as-is\" leaves it unmodified. \"upper\" and \"lower\" convert it to all upper-case or all lower-case, respectively.\n * @beta\n */\nexport type FieldCase = \"as-is\" | \"upper\" | \"lower\";\n\n/** As part of a [[FieldFormatOptions]], specifies how to format properties of [[FieldPropertyType]] \"datetime\".\n * @beta\n */\nexport interface DateTimeFieldFormatOptions {\n  /** The locale with which to localize the display string.\n   * Default: \"en-US\".\n   */\n  locale?: Intl.UnicodeBCP47LocaleIdentifier;\n  /** Describes how to produce the display string. */\n  formatOptions?: Intl.DateTimeFormatOptions;\n}\n\n/** Customizes how to format the raw property value resolved by a [[FieldPropertyPath]] into a [[FieldRun]]'s display string.\n * The exact options used depend upon the [[FieldPropertyType]].\n * @beta\n */\nexport interface FieldFormatOptions {\n  /** A string inserted before the formatted string. This string is not affected by [[case]]. */\n  prefix?: string;\n  /** A string inserted after the formatted string. This string is not affected by [[case]]. */\n  suffix?: string;\n  /** Modifies the case of the formatted string. */\n  case?: FieldCase;\n  /** Formatting options for [[FieldPropertyType]] \"datetime\". */\n  dateTime?: DateTimeFieldFormatOptions;\n}\n"]}
+{"version":3,"file":"TextField.js","sourceRoot":"","sources":["../../../src/annotation/TextField.ts"],"names":[],"mappings":";AAAA;;;+FAG+F;AAC/F;;GAEG","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 Annotation\r\n */\r\n\r\nimport { Id64String } from \"@itwin/core-bentley\";\r\n\r\n/** Enumerates the different kinds of [Property]($ecschema-metadata) values that can be used as the basis for a [[FieldRun]]'s display string.\r\n * A field's property type is derived from the property's [PrimitiveType]($ecschema-metadata) and other attributes like its [PrimitiveOrEnumPropertyBase.extendedTypeName]($ecschema-metadata).\r\n * The conversion of the raw property value into a display string can be customized by different [[FieldFormatOptions]] based on its type.\r\n * The following types are currently recognized:\r\n *  - \"quantity\": an often-unitized scalar value like a distance or area, formatted using a quantity [Format]($core-quantity).\r\n *  - \"coordinate\": a 2- or 3-dimensional point, with each component formatted as a \"quantity\".\r\n *  - \"boolean\": a true or false value.\r\n *  - \"datetime\": an ECMAScript [Date](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Date).\r\n *  - \"int-enum\": an integer [EnumerationProperty]($ecschema-metadata) formatted using the enum value's display label.\r\n *  - \"string-enum\": a string [EnumerationProperty]($ecschema-metadata) formatted using the enum value's display label.\r\n *  - \"string\": a value convertible to a string.\r\n * @note Currently, only formatting of \"string\" and \"datetime\" types is implemented. Other types are converted to and formatted as \"string\".\r\n * @beta\r\n */\r\nexport type FieldPropertyType = \"quantity\" | \"coordinate\" | \"string\" | \"boolean\" | \"datetime\" | \"int-enum\" | \"string-enum\";\r\n\r\n/** A chain of property accesses that resolves to a primitive value that forms the basis of the displayed content\r\n * of a [[FieldRun]].\r\n   * The simplest property paths consist of a [[propertyName]] and nothing else, where `propertyName` identifies\r\n   * a primitive property.\r\n   * If `propertyName` identifies a struct or array property, then additional [[accessors]] are required to identify the specific value.\r\n   * Some examples:\r\n   * ```\r\n   * | Access String | propertyName | accessors |\r\n   * | ------------- | ------------ | --------- |\r\n   * | name          | \"name\"       | undefined |\r\n   * | spouse.name   | \"spouse\"     | [name]    |\r\n   * | colors[2]     | \"colors\"     | [2]       |\r\n   * | spouse.favoriteRestaurants[1].address | \"spouse\" | [\"favoriteRestaurants\", 1, \"address\"] |\r\n   * ```\r\n * @beta\r\n */\r\nexport interface FieldPropertyPath {\r\n  /** The name of the BIS property of the [[FieldPropertyHost]] that serves as the root of the path. */\r\n  propertyName: string;\r\n  /** Property names and/or array indices describing the path from [[propertyName]] to the ultimate BIS property. */\r\n  accessors?: Array<string | number>;\r\n}\r\n\r\n/** Describes the source of the property value against which a [[FieldPropertyPath]] is evaluated.\r\n * A field property is always hosted by an [Element]($backend). It may refer to a property belonging to any of the following:\r\n * - The element's BIS class itself;\r\n * - One of the element's [ElementAspect]($backend)s;\r\n * - Or an [EC view]($docs/learning/ECSqlReference/Views.md) with the same ECInstanceId as the element.\r\n * The [[schemaName]] and [[className]] should always identify the exact class that contains [[FieldPropertyPath.propertyName]] - not a subclass thereof.\r\n * @beta\r\n */\r\nexport interface FieldPropertyHost {\r\n  /** The Id of the [Element]($backend) that hosts the property. */\r\n  elementId: Id64String;\r\n  /** The name of the schema containing the class identified by [[className]]. */\r\n  schemaName: string;\r\n  /** The name of the exact class (not a subclass) containing the property identified by [[FieldPropertyPath.propertyName]]. */\r\n  className: string;\r\n}\r\n\r\n/** As part of [[FieldFormatOptions]], specifies how to modify the case of the display string.\r\n * \"as-is\" leaves it unmodified. \"upper\" and \"lower\" convert it to all upper-case or all lower-case, respectively.\r\n * @beta\r\n */\r\nexport type FieldCase = \"as-is\" | \"upper\" | \"lower\";\r\n\r\n/** As part of a [[FieldFormatOptions]], specifies how to format properties of [[FieldPropertyType]] \"datetime\".\r\n * @beta\r\n */\r\nexport interface DateTimeFieldFormatOptions {\r\n  /** The locale with which to localize the display string.\r\n   * Default: \"en-US\".\r\n   */\r\n  locale?: Intl.UnicodeBCP47LocaleIdentifier;\r\n  /** Describes how to produce the display string. */\r\n  formatOptions?: Intl.DateTimeFormatOptions;\r\n}\r\n\r\n/** Customizes how to format the raw property value resolved by a [[FieldPropertyPath]] into a [[FieldRun]]'s display string.\r\n * The exact options used depend upon the [[FieldPropertyType]].\r\n * @beta\r\n */\r\nexport interface FieldFormatOptions {\r\n  /** A string inserted before the formatted string. This string is not affected by [[case]]. */\r\n  prefix?: string;\r\n  /** A string inserted after the formatted string. This string is not affected by [[case]]. */\r\n  suffix?: string;\r\n  /** Modifies the case of the formatted string. */\r\n  case?: FieldCase;\r\n  /** Formatting options for [[FieldPropertyType]] \"datetime\". */\r\n  dateTime?: DateTimeFieldFormatOptions;\r\n}\r\n"]}