@itwin/presentation-common 3.4.2 → 3.4.4

package/lib/esm/presentation-common/content/Editor.js

@@ -1,9 +1,9 @@
-/*---------------------------------------------------------------------------------------------
-* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
-* See LICENSE.md in the project root for license terms and full copyright notice.
-*--------------------------------------------------------------------------------------------*/
-/** @packageDocumentation
- * @module Content
- */
-export {};
+/*---------------------------------------------------------------------------------------------
+* Copyright (c) Bentley Systems, Incorporated. All rights reserved.
+* See LICENSE.md in the project root for license terms and full copyright notice.
+*--------------------------------------------------------------------------------------------*/
+/** @packageDocumentation
+ * @module Content
+ */
+export {};
 //# sourceMappingURL=Editor.js.map

package/lib/esm/presentation-common/content/Editor.js.map

@@ -1 +1 @@
-{"version":3,"file":"Editor.js","sourceRoot":"","sources":["../../../../src/presentation-common/content/Editor.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 Content\r\n */\r\n\r\n/**\r\n * A data structure which describes property editor used\r\n * for a content [[Field]].\r\n *\r\n * @public\r\n */\r\nexport interface EditorDescription {\r\n  /** Unique name */\r\n  name: string;\r\n  /** Editor-specific parameters */\r\n  params?: any;\r\n}\r\n"]}
+{"version":3,"file":"Editor.js","sourceRoot":"","sources":["../../../../src/presentation-common/content/Editor.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 Content\n */\n\n/**\n * A data structure which describes property editor used\n * for a content [[Field]].\n *\n * @public\n */\nexport interface EditorDescription {\n  /** Unique name */\n  name: string;\n  /** Editor-specific parameters */\n  params?: any;\n}\n"]}

package/lib/esm/presentation-common/content/Fields.d.ts

@@ -1,283 +1,283 @@
-/** @packageDocumentation
- * @module Content
- */
-import { Id64String } from "@itwin/core-bentley";
-import { ClassInfo, ClassInfoJSON, CompressedClassInfoJSON, RelationshipPath, RelationshipPathJSON, StrippedRelationshipPath } from "../EC";
-import { RelationshipMeaning } from "../rules/content/modifiers/RelatedPropertiesSpecification";
-import { CategoryDescription } from "./Category";
-import { EditorDescription } from "./Editor";
-import { Property, PropertyJSON } from "./Property";
-import { RendererDescription } from "./Renderer";
-import { TypeDescription } from "./TypeDescription";
-/**
- * Data structure for a [[Field]] serialized to JSON.
- * @public
- */
-export interface BaseFieldJSON {
-    category: string;
-    name: string;
-    label: string;
-    type: TypeDescription;
-    isReadonly: boolean;
-    priority: number;
-    renderer?: RendererDescription;
-    editor?: EditorDescription;
-}
-/**
- * Data structure for a [[PropertiesField]] serialized to JSON.
- * @public
- */
-export interface PropertiesFieldJSON<TClassInfoJSON = ClassInfoJSON> extends BaseFieldJSON {
-    properties: PropertyJSON<TClassInfoJSON>[];
-}
-/**
- * Data structure for a [[NestedContentField]] serialized to JSON.
- * @public
- */
-export interface NestedContentFieldJSON<TClassInfoJSON = ClassInfoJSON> extends BaseFieldJSON {
-    contentClassInfo: TClassInfoJSON;
-    pathToPrimaryClass: RelationshipPathJSON<TClassInfoJSON>;
-    /** @alpha */
-    relationshipMeaning?: RelationshipMeaning;
-    /** @alpha */
-    actualPrimaryClassIds?: Id64String[];
-    autoExpand?: boolean;
-    nestedFields: FieldJSON<TClassInfoJSON>[];
-}
-/**
- * JSON representation of a [[Field]]
- * @public
- */
-export declare type FieldJSON<TClassInfoJSON = ClassInfoJSON> = BaseFieldJSON | PropertiesFieldJSON<TClassInfoJSON> | NestedContentFieldJSON<TClassInfoJSON>;
-/**
- * Describes a single content field. A field is usually represented as a grid column
- * or a property pane row.
- *
- * @public
- */
-export declare class Field {
-    /** Category information */
-    category: CategoryDescription;
-    /** Unique name */
-    name: string;
-    /** Display label */
-    label: string;
-    /** Description of this field's values data type */
-    type: TypeDescription;
-    /** Are values in this field read-only */
-    isReadonly: boolean;
-    /** Priority of the field. Higher priority fields should appear first in the UI */
-    priority: number;
-    /** Property renderer used to render values of this field */
-    renderer?: RendererDescription;
-    /** Property editor used to edit values of this field */
-    editor?: EditorDescription;
-    /** Parent field */
-    private _parent?;
-    /**
-     * Creates an instance of Field.
-     * @param category Category information
-     * @param name Unique name
-     * @param label Display label
-     * @param type Description of this field's values data type
-     * @param isReadonly Are values in this field read-only
-     * @param priority Priority of the field
-     * @param editor Property editor used to edit values of this field
-     * @param renderer Property renderer used to render values of this field
-     */
-    constructor(category: CategoryDescription, name: string, label: string, type: TypeDescription, isReadonly: boolean, priority: number, editor?: EditorDescription, renderer?: RendererDescription);
-    /**
-     * Is this a [[PropertiesField]]
-     */
-    isPropertiesField(): this is PropertiesField;
-    /**
-     * Is this a [[NestedContentField]]
-     */
-    isNestedContentField(): this is NestedContentField;
-    /**
-     * Get parent
-     */
-    get parent(): NestedContentField | undefined;
-    clone(): Field;
-    /** Serialize this object to JSON */
-    toJSON(): FieldJSON;
-    /** Serialize this object to compressed JSON */
-    toCompressedJSON(classesMap: {
-        [id: string]: CompressedClassInfoJSON;
-    }): FieldJSON<string>;
-    /** Deserialize [[Field]] from JSON */
-    static fromJSON(json: FieldJSON | undefined, categories: CategoryDescription[]): Field | undefined;
-    /**
-     * Deserialize a [[Field]] from compressed JSON.
-     * @public
-     */
-    static fromCompressedJSON(json: FieldJSON<string> | undefined, classesMap: {
-        [id: string]: CompressedClassInfoJSON;
-    }, categories: CategoryDescription[]): Field | undefined;
-    protected static getCategoryFromFieldJson(fieldJson: FieldJSON, categories: CategoryDescription[]): CategoryDescription;
-    /** @internal */
-    resetParentship(): void;
-    /** @internal */
-    rebuildParentship(parentField?: NestedContentField): void;
-    /**
-     * Get descriptor for this field.
-     * @public
-     */
-    getFieldDescriptor(): FieldDescriptor;
-}
-/**
- * Describes a content field that's based on one or more similar
- * EC properties.
- *
- * @public
- */
-export declare class PropertiesField extends Field {
-    /** A list of properties this field is created from */
-    properties: Property[];
-    /**
-     * Creates an instance of PropertiesField.
-     * @param category Category information
-     * @param name Unique name
-     * @param label Display label
-     * @param type Description of this field's values data type
-     * @param isReadonly Are values in this field read-only
-     * @param priority Priority of the field
-     * @param properties A list of properties this field is created from
-     * @param editor Property editor used to edit values of this field
-     * @param renderer Property renderer used to render values of this field
-     */
-    constructor(category: CategoryDescription, name: string, label: string, description: TypeDescription, isReadonly: boolean, priority: number, properties: Property[], editor?: EditorDescription, renderer?: RendererDescription);
-    clone(): PropertiesField;
-    /** Serialize this object to JSON */
-    toJSON(): PropertiesFieldJSON;
-    /** Deserialize [[PropertiesField]] from JSON */
-    static fromJSON(json: PropertiesFieldJSON | undefined, categories: CategoryDescription[]): PropertiesField | undefined;
-    /**
-     * Deserialize a [[PropertiesField]] from compressed JSON.
-     * @public
-     */
-    static fromCompressedJSON(json: PropertiesFieldJSON<Id64String>, classesMap: {
-        [id: string]: CompressedClassInfoJSON;
-    }, categories: CategoryDescription[]): PropertiesField | undefined;
-    /**
-     * Get descriptor for this field.
-     * @public
-     */
-    getFieldDescriptor(): FieldDescriptor;
-}
-/**
- * Describes a content field that contains [Nested content]($docs/presentation/content/Terminology#nested-content).
- *
- * @public
- */
-export declare class NestedContentField extends Field {
-    /** Information about an ECClass whose properties are nested inside this field */
-    contentClassInfo: ClassInfo;
-    /** Relationship path to [Primary class]($docs/presentation/content/Terminology#primary-class) */
-    pathToPrimaryClass: RelationshipPath;
-    /** @alpha */
-    relationshipMeaning: RelationshipMeaning;
-    /** @alpha */
-    actualPrimaryClassIds: Id64String[];
-    /** Contained nested fields */
-    nestedFields: Field[];
-    /** Flag specifying whether field should be expanded */
-    autoExpand?: boolean;
-    /**
-     * Creates an instance of NestedContentField.
-     * @param category Category information
-     * @param name Unique name
-     * @param label Display label
-     * @param type Description of this field's values data type
-     * @param isReadonly Are values in this field read-only
-     * @param priority Priority of the field
-     * @param contentClassInfo Information about an ECClass whose properties are nested inside this field
-     * @param pathToPrimaryClass Relationship path to [Primary class]($docs/presentation/content/Terminology#primary-class)
-     * @param nestedFields Contained nested fields
-     * @param editor Property editor used to edit values of this field
-     * @param autoExpand Flag specifying whether field should be expanded
-     * @param relationshipMeaning RelationshipMeaning of the field
-     * @param renderer Property renderer used to render values of this field
-     */
-    constructor(category: CategoryDescription, name: string, label: string, description: TypeDescription, isReadonly: boolean, priority: number, contentClassInfo: ClassInfo, pathToPrimaryClass: RelationshipPath, nestedFields: Field[], editor?: EditorDescription, autoExpand?: boolean, renderer?: RendererDescription);
-    clone(): NestedContentField;
-    /**
-     * Get field by its name
-     * @param name Name of the field to find
-     * @param recurse Recurse into nested fields
-     */
-    getFieldByName(name: string, recurse?: boolean): Field | undefined;
-    /** Serialize this object to JSON */
-    toJSON(): NestedContentFieldJSON;
-    /** Deserialize [[NestedContentField]] from JSON */
-    static fromJSON(json: NestedContentFieldJSON | undefined, categories: CategoryDescription[]): NestedContentField | undefined;
-    /**
-     * Deserialize a [[NestedContentField]] from compressed JSON.
-     * @public
-     */
-    static fromCompressedJSON(json: NestedContentFieldJSON<Id64String>, classesMap: {
-        [id: string]: CompressedClassInfoJSON;
-    }, categories: CategoryDescription[]): any;
-    private static fromCommonJSON;
-    /** @internal */
-    resetParentship(): void;
-    /** @internal */
-    rebuildParentship(parentField?: NestedContentField): void;
-}
-/** @internal */
-export declare const getFieldByName: (fields: Field[], name: string | undefined, recurse?: boolean | undefined) => Field | undefined;
-/**
- * Types of different field descriptors.
- * @public
- */
-export declare enum FieldDescriptorType {
-    Name = "name",
-    Properties = "properties"
-}
-/**
- * Base for a field descriptor
- * @public
- */
-export interface FieldDescriptorBase {
-    type: FieldDescriptorType;
-}
-/**
- * A union of all possible field descriptor types
- * @public
- */
-export declare type FieldDescriptor = NamedFieldDescriptor | PropertiesFieldDescriptor;
-/** @public */
-export declare namespace FieldDescriptor {
-    /** Is this a named field descriptor */
-    function isNamed(d: FieldDescriptor): d is NamedFieldDescriptor;
-    /** Is this a properties field descriptor */
-    function isProperties(d: FieldDescriptor): d is PropertiesFieldDescriptor;
-}
-/**
- * Field descriptor that identifies a content field by its unique name.
- * @public
- */
-export interface NamedFieldDescriptor extends FieldDescriptorBase {
-    type: FieldDescriptorType.Name;
-    fieldName: string;
-}
-/**
- * Field descriptor that identifies a properties field using a list of
- * properties that the field contains.
- * @public
- */
-export interface PropertiesFieldDescriptor extends FieldDescriptorBase {
-    type: FieldDescriptorType.Properties;
-    pathFromSelectToPropertyClass: StrippedRelationshipPath;
-    /**
-     * A list of properties that describe the field. At least one property in the list must
-     * match at least one property in the field for the descriptor to be considered matching.
-     */
-    properties: Array<{
-        /** Full class name */
-        class: string;
-        /** Property name */
-        name: string;
-    }>;
-}
+/** @packageDocumentation
+ * @module Content
+ */
+import { Id64String } from "@itwin/core-bentley";
+import { ClassInfo, ClassInfoJSON, CompressedClassInfoJSON, RelationshipPath, RelationshipPathJSON, StrippedRelationshipPath } from "../EC";
+import { RelationshipMeaning } from "../rules/content/modifiers/RelatedPropertiesSpecification";
+import { CategoryDescription } from "./Category";
+import { EditorDescription } from "./Editor";
+import { Property, PropertyJSON } from "./Property";
+import { RendererDescription } from "./Renderer";
+import { TypeDescription } from "./TypeDescription";
+/**
+ * Data structure for a [[Field]] serialized to JSON.
+ * @public
+ */
+export interface BaseFieldJSON {
+    category: string;
+    name: string;
+    label: string;
+    type: TypeDescription;
+    isReadonly: boolean;
+    priority: number;
+    renderer?: RendererDescription;
+    editor?: EditorDescription;
+}
+/**
+ * Data structure for a [[PropertiesField]] serialized to JSON.
+ * @public
+ */
+export interface PropertiesFieldJSON<TClassInfoJSON = ClassInfoJSON> extends BaseFieldJSON {
+    properties: PropertyJSON<TClassInfoJSON>[];
+}
+/**
+ * Data structure for a [[NestedContentField]] serialized to JSON.
+ * @public
+ */
+export interface NestedContentFieldJSON<TClassInfoJSON = ClassInfoJSON> extends BaseFieldJSON {
+    contentClassInfo: TClassInfoJSON;
+    pathToPrimaryClass: RelationshipPathJSON<TClassInfoJSON>;
+    /** @alpha */
+    relationshipMeaning?: RelationshipMeaning;
+    /** @alpha */
+    actualPrimaryClassIds?: Id64String[];
+    autoExpand?: boolean;
+    nestedFields: FieldJSON<TClassInfoJSON>[];
+}
+/**
+ * JSON representation of a [[Field]]
+ * @public
+ */
+export declare type FieldJSON<TClassInfoJSON = ClassInfoJSON> = BaseFieldJSON | PropertiesFieldJSON<TClassInfoJSON> | NestedContentFieldJSON<TClassInfoJSON>;
+/**
+ * Describes a single content field. A field is usually represented as a grid column
+ * or a property pane row.
+ *
+ * @public
+ */
+export declare class Field {
+    /** Category information */
+    category: CategoryDescription;
+    /** Unique name */
+    name: string;
+    /** Display label */
+    label: string;
+    /** Description of this field's values data type */
+    type: TypeDescription;
+    /** Are values in this field read-only */
+    isReadonly: boolean;
+    /** Priority of the field. Higher priority fields should appear first in the UI */
+    priority: number;
+    /** Property renderer used to render values of this field */
+    renderer?: RendererDescription;
+    /** Property editor used to edit values of this field */
+    editor?: EditorDescription;
+    /** Parent field */
+    private _parent?;
+    /**
+     * Creates an instance of Field.
+     * @param category Category information
+     * @param name Unique name
+     * @param label Display label
+     * @param type Description of this field's values data type
+     * @param isReadonly Are values in this field read-only
+     * @param priority Priority of the field
+     * @param editor Property editor used to edit values of this field
+     * @param renderer Property renderer used to render values of this field
+     */
+    constructor(category: CategoryDescription, name: string, label: string, type: TypeDescription, isReadonly: boolean, priority: number, editor?: EditorDescription, renderer?: RendererDescription);
+    /**
+     * Is this a [[PropertiesField]]
+     */
+    isPropertiesField(): this is PropertiesField;
+    /**
+     * Is this a [[NestedContentField]]
+     */
+    isNestedContentField(): this is NestedContentField;
+    /**
+     * Get parent
+     */
+    get parent(): NestedContentField | undefined;
+    clone(): Field;
+    /** Serialize this object to JSON */
+    toJSON(): FieldJSON;
+    /** Serialize this object to compressed JSON */
+    toCompressedJSON(classesMap: {
+        [id: string]: CompressedClassInfoJSON;
+    }): FieldJSON<string>;
+    /** Deserialize [[Field]] from JSON */
+    static fromJSON(json: FieldJSON | undefined, categories: CategoryDescription[]): Field | undefined;
+    /**
+     * Deserialize a [[Field]] from compressed JSON.
+     * @public
+     */
+    static fromCompressedJSON(json: FieldJSON<string> | undefined, classesMap: {
+        [id: string]: CompressedClassInfoJSON;
+    }, categories: CategoryDescription[]): Field | undefined;
+    protected static getCategoryFromFieldJson(fieldJson: FieldJSON, categories: CategoryDescription[]): CategoryDescription;
+    /** @internal */
+    resetParentship(): void;
+    /** @internal */
+    rebuildParentship(parentField?: NestedContentField): void;
+    /**
+     * Get descriptor for this field.
+     * @public
+     */
+    getFieldDescriptor(): FieldDescriptor;
+}
+/**
+ * Describes a content field that's based on one or more similar
+ * EC properties.
+ *
+ * @public
+ */
+export declare class PropertiesField extends Field {
+    /** A list of properties this field is created from */
+    properties: Property[];
+    /**
+     * Creates an instance of PropertiesField.
+     * @param category Category information
+     * @param name Unique name
+     * @param label Display label
+     * @param type Description of this field's values data type
+     * @param isReadonly Are values in this field read-only
+     * @param priority Priority of the field
+     * @param properties A list of properties this field is created from
+     * @param editor Property editor used to edit values of this field
+     * @param renderer Property renderer used to render values of this field
+     */
+    constructor(category: CategoryDescription, name: string, label: string, description: TypeDescription, isReadonly: boolean, priority: number, properties: Property[], editor?: EditorDescription, renderer?: RendererDescription);
+    clone(): PropertiesField;
+    /** Serialize this object to JSON */
+    toJSON(): PropertiesFieldJSON;
+    /** Deserialize [[PropertiesField]] from JSON */
+    static fromJSON(json: PropertiesFieldJSON | undefined, categories: CategoryDescription[]): PropertiesField | undefined;
+    /**
+     * Deserialize a [[PropertiesField]] from compressed JSON.
+     * @public
+     */
+    static fromCompressedJSON(json: PropertiesFieldJSON<Id64String>, classesMap: {
+        [id: string]: CompressedClassInfoJSON;
+    }, categories: CategoryDescription[]): PropertiesField | undefined;
+    /**
+     * Get descriptor for this field.
+     * @public
+     */
+    getFieldDescriptor(): FieldDescriptor;
+}
+/**
+ * Describes a content field that contains [Nested content]($docs/presentation/content/Terminology#nested-content).
+ *
+ * @public
+ */
+export declare class NestedContentField extends Field {
+    /** Information about an ECClass whose properties are nested inside this field */
+    contentClassInfo: ClassInfo;
+    /** Relationship path to [Primary class]($docs/presentation/content/Terminology#primary-class) */
+    pathToPrimaryClass: RelationshipPath;
+    /** @alpha */
+    relationshipMeaning: RelationshipMeaning;
+    /** @alpha */
+    actualPrimaryClassIds: Id64String[];
+    /** Contained nested fields */
+    nestedFields: Field[];
+    /** Flag specifying whether field should be expanded */
+    autoExpand?: boolean;
+    /**
+     * Creates an instance of NestedContentField.
+     * @param category Category information
+     * @param name Unique name
+     * @param label Display label
+     * @param type Description of this field's values data type
+     * @param isReadonly Are values in this field read-only
+     * @param priority Priority of the field
+     * @param contentClassInfo Information about an ECClass whose properties are nested inside this field
+     * @param pathToPrimaryClass Relationship path to [Primary class]($docs/presentation/content/Terminology#primary-class)
+     * @param nestedFields Contained nested fields
+     * @param editor Property editor used to edit values of this field
+     * @param autoExpand Flag specifying whether field should be expanded
+     * @param relationshipMeaning RelationshipMeaning of the field
+     * @param renderer Property renderer used to render values of this field
+     */
+    constructor(category: CategoryDescription, name: string, label: string, description: TypeDescription, isReadonly: boolean, priority: number, contentClassInfo: ClassInfo, pathToPrimaryClass: RelationshipPath, nestedFields: Field[], editor?: EditorDescription, autoExpand?: boolean, renderer?: RendererDescription);
+    clone(): NestedContentField;
+    /**
+     * Get field by its name
+     * @param name Name of the field to find
+     * @param recurse Recurse into nested fields
+     */
+    getFieldByName(name: string, recurse?: boolean): Field | undefined;
+    /** Serialize this object to JSON */
+    toJSON(): NestedContentFieldJSON;
+    /** Deserialize [[NestedContentField]] from JSON */
+    static fromJSON(json: NestedContentFieldJSON | undefined, categories: CategoryDescription[]): NestedContentField | undefined;
+    /**
+     * Deserialize a [[NestedContentField]] from compressed JSON.
+     * @public
+     */
+    static fromCompressedJSON(json: NestedContentFieldJSON<Id64String>, classesMap: {
+        [id: string]: CompressedClassInfoJSON;
+    }, categories: CategoryDescription[]): any;
+    private static fromCommonJSON;
+    /** @internal */
+    resetParentship(): void;
+    /** @internal */
+    rebuildParentship(parentField?: NestedContentField): void;
+}
+/** @internal */
+export declare const getFieldByName: (fields: Field[], name: string | undefined, recurse?: boolean | undefined) => Field | undefined;
+/**
+ * Types of different field descriptors.
+ * @public
+ */
+export declare enum FieldDescriptorType {
+    Name = "name",
+    Properties = "properties"
+}
+/**
+ * Base for a field descriptor
+ * @public
+ */
+export interface FieldDescriptorBase {
+    type: FieldDescriptorType;
+}
+/**
+ * A union of all possible field descriptor types
+ * @public
+ */
+export declare type FieldDescriptor = NamedFieldDescriptor | PropertiesFieldDescriptor;
+/** @public */
+export declare namespace FieldDescriptor {
+    /** Is this a named field descriptor */
+    function isNamed(d: FieldDescriptor): d is NamedFieldDescriptor;
+    /** Is this a properties field descriptor */
+    function isProperties(d: FieldDescriptor): d is PropertiesFieldDescriptor;
+}
+/**
+ * Field descriptor that identifies a content field by its unique name.
+ * @public
+ */
+export interface NamedFieldDescriptor extends FieldDescriptorBase {
+    type: FieldDescriptorType.Name;
+    fieldName: string;
+}
+/**
+ * Field descriptor that identifies a properties field using a list of
+ * properties that the field contains.
+ * @public
+ */
+export interface PropertiesFieldDescriptor extends FieldDescriptorBase {
+    type: FieldDescriptorType.Properties;
+    pathFromSelectToPropertyClass: StrippedRelationshipPath;
+    /**
+     * A list of properties that describe the field. At least one property in the list must
+     * match at least one property in the field for the descriptor to be considered matching.
+     */
+    properties: Array<{
+        /** Full class name */
+        class: string;
+        /** Property name */
+        name: string;
+    }>;
+}
 //# sourceMappingURL=Fields.d.ts.map